Skip to content

v0.2.0

Choose a tag to compare

View all tags
@npxchaos npxchaos released this 01 Jul 14:35
v0.2.0
86ee8ab

[0.2.0] — 2026-07-01

Re-platforms Repospec from the single-file Python reference tool onto a TypeScript
monorepo with a real engine, CLI, and protocol packages. The .repospec/ directory
is still the human-authored source of truth; generation is now checksum-tracked and
ownership-aware.

Added

  • Monorepo (pnpm workspaces). Four published packages:
    • @repospec/protocol — zod schemas, frontmatter/parse, repository model,
      protocol versioning.
    • @repospec/engine — the init, generate, sync, and doctor operations,
      tool adapters (agents, claude), and an injectable filesystem.
    • @repospec/cli — the repospec command-line front end.
    • @repospec/templates — the scaffolds init seeds.
  • Idempotent, ownership-aware sync. Generated outputs carry a managed header
    with a sha256 checksum. sync will not overwrite a hand-edited output without
    --force; sync --check reports drift and exits non-zero (ADR-0004).
  • doctor. Validates .repospec/ and reports problems with path-first
    messages; detects drift and version mismatch.
  • Normative specification under spec/ (protocol, repository, lifecycle,
    workflow, configuration, versioning, RFC process) plus seven ADRs.
  • Two worked examples, both engine-generated and drift-guarded in CI:
    demo-service and a richer acme-billing (six roles, billing rules).
  • CI (.github/workflows/ci.yml): format, lint, build, typecheck, test, and an
    AGENTS.md drift-guard that runs repospec sync --check on every example.

Changed

  • Renamed the npm scope and CLI to @repospec/* / repospec and the convention
    directory to .repospec/, completing the move off forge (Foundry collision).
  • AGENTS.md is now generated by the TypeScript engine rather than the Python
    build tool, via the agents adapter.

Removed

  • The Python reference tool (tools/repospec_build.py) and its standalone
    workflow, superseded by @repospec/engine. It remains available at the v0.1.0
    tag for the zero-dependency path.

Known limitations (open problems)

  • Enforcement. AGENTS.md remains advisory to agents. CI now guards staleness
    (drift-guard) and validity (doctor); commit/merge-time gate hooks are future
    work.
  • Code ⇄ .repospec/ drift. sync/doctor detect drift between source and
    generated outputs, but divergence between the code and the .repospec/
    description it documents is still not automatically detected.
Assets 2
Loading