Skip to content

CLAUDE.md

Latest commit

 

History

History
73 lines (49 loc) · 2.86 KB

CLAUDE.md

File metadata and controls

73 lines (49 loc) · 2.86 KB

OpenLaw-Git Pipeline - Claude Code Instructions

Tech Stack

  • Monorepo: Turborepo + pnpm workspaces
  • Language: TypeScript 5.8+ (strict mode, NodeNext)
  • Validation: Zod v3
  • Testing: Vitest
  • Web: Astro v5
  • CI: GitHub Actions (ubuntu-latest, Node 22)

Quick Commands

pnpm install        # Install all dependencies
pnpm build          # Build all packages (topological order)
pnpm test           # Run all tests
pnpm lint           # Lint all packages
pnpm typecheck      # Type-check all packages

# Historical import
npx tsx scripts/import-history.ts --repo /path/to/us-code                          # Full import
npx tsx scripts/import-history.ts --repo /path/to/us-code --start pl/119/1 --end pl/119/73  # Range
npx tsx scripts/import-history.ts --repo /path/to/us-code --title 18 --dry-run     # Single title dry run
npx tsx scripts/import-history.ts --repo /path/to/us-code --resume                 # Resume interrupted

Core Principles

correctness > simplicity > performance
  • TDD -- Write failing test first, then minimum code to pass, then refactor.
  • YAGNI -- Only implement what is needed now. No speculative abstractions.
  • DRY -- Extract shared logic at 3+ occurrences, not before.

Zero any Policy

any is banned. Use unknown and narrow with type guards or Zod.

Canonical Paths

Concern Package Entry Point
Shared types @civic-source/types src/index.ts
OLRC fetcher @civic-source/fetcher src/index.ts
XML transformer @civic-source/transformer src/index.ts
Web app @civic-source/web src/pages/

Self-Hosted Runner Policy

Cron and workflow_dispatch jobs may use self-hosted runners. Push/PR CI runs on ubuntu-latest only.

Commit Messages

Use conventional commits: type(scope): description

Types: feat, fix, refactor, docs, test, chore, perf

Enforced by commitlint in CI (on PRs) via commitlint.config.ts.

Releases

Semver policy: 0.x = pre-release (breaking changes allowed in minor bumps). 1.0 = first stable release.

Release flow: Automated by release-please. On every push to main, release-please.yml reads conventional commits since the last release and opens/updates a long-lived "Release PR" that bumps package.json + .release-please-manifest.json and updates CHANGELOG.md. Merging that PR creates the git tag (v0.x.y) and the GitHub Release.

Config: release-please-config.json + .release-please-manifest.json.

To trigger a release: merge the Release PR. To force a re-evaluation: gh workflow run release-please.yml --ref main.

Changelog: Maintained by release-please from conventional commits. The full history lives in CHANGELOG.md.