phase0-D: add capabilities + manifest drift gate

.github/workflows/ci.yml

@@ -46,3 +46,13 @@ jobs:
 
       - name: Test with coverage
         run: uv run pytest --cov --cov-report=term-missing
+
+      - name: Manifest drift gate (Phase 0 / Track D)
+        # Regenerates dist/commands.json, dist/lint-rules.json,
+        # dist/fmt-rules.json from the live argparse / Rule / FmtRule
+        # registries and asserts the working tree is unchanged. If a
+        # contributor adds a subcommand or a rule but forgets to
+        # `make manifest`, this step fails the build. Invokes the
+        # Makefile directly — its targets call `.venv/bin/m`, which
+        # `uv sync --frozen` populated above.
+        run: make check-manifest

.gitignore

@@ -6,7 +6,14 @@ __pycache__/
 .env
 !.env.example
 *.log
-/dist/
+# Ignore generated dist/ contents broadly, but keep the tier-1
+# AI-discoverability manifest + its derived JSON artifacts under
+# version control (they are the contract surface for repo.meta.json).
+/dist/*
+!/dist/repo.meta.json
+!/dist/commands.json
+!/dist/lint-rules.json
+!/dist/fmt-rules.json
 /build/
 *.egg-info/
 .mypy_cache/

CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

Makefile

@@ -1,12 +1,21 @@
-.PHONY: install test test-lf watch lint format mypy cov check lint-modern lint-modern-baseline lint-modern-setup push pull hooks seed unseed test-vista engine-up engine-down engine-status
+.PHONY: install test test-lf watch lint format mypy cov check lint-modern lint-modern-baseline lint-modern-setup push pull hooks seed unseed test-vista engine-up engine-down engine-status manifest check-manifest
 
 PYTHON := .venv/bin/python
 PYTEST := .venv/bin/pytest
 PTW    := .venv/bin/ptw
 RUFF   := .venv/bin/ruff
 MYPY   := .venv/bin/mypy
+M      := .venv/bin/m
 PRECOMMIT := .venv/bin/pre-commit
 
+# Sources that drive each generated dist artifact. The capabilities tree
+# is built from every `cli.py` under src/m_cli/ (one per subcommand
+# package, plus the dispatcher itself), so any change there should
+# regenerate dist/commands.json.
+CLI_SOURCES := $(shell find src/m_cli -name cli.py -type f) src/m_cli/cli.py
+LINT_SOURCES := $(shell find src/m_cli/lint -name '*.py' -type f) src/m_cli/lint/list_rules.py
+FMT_SOURCES  := $(shell find src/m_cli/fmt  -name '*.py' -type f)
+
 # Default corpus for whole-corpus validation gates (round-trip, canonical,
 # lint). Override per-invocation: `make vista CORPUS=/path/to/other/corpus`,
 # or via environment: `CORPUS=... make vista`. Defaults to the in-org
@@ -79,6 +88,36 @@ lint-modern-setup:
 
 check: lint mypy cov
 
+# ── Tier-1 manifest artifacts (Phase 0 / Track D) ────────────────────
+#
+# `make manifest` regenerates every machine-readable view exposed by
+# dist/repo.meta.json. Each artifact is derived from a live registry —
+# capabilities from the argparse parser tree, lint-rules / fmt-rules
+# from the in-process Rule / FmtRule registries — so there is nothing
+# to hand-curate.
+#
+# `make check-manifest` is the drift gate: it regenerates everything
+# and asserts the working tree is clean. CI runs this on every push.
+
+dist/commands.json: $(CLI_SOURCES)
+	@mkdir -p dist
+	$(M) capabilities --json > $@
+
+dist/lint-rules.json: $(LINT_SOURCES)
+	@mkdir -p dist
+	$(M) lint --list-rules --json > $@
+
+dist/fmt-rules.json: $(FMT_SOURCES)
+	@mkdir -p dist
+	$(M) fmt --list-rules --json > $@
+
+manifest: dist/commands.json dist/lint-rules.json dist/fmt-rules.json
+
+check-manifest: manifest
+	git diff --exit-code dist/
+
+
+
 pull:
 	git pull origin main