@flyingrobots/graft 0.7.1 → 0.8.0

package/docs/CLI.md

@@ -14,10 +14,12 @@ flowchart LR
     B --> B6[index]
     B --> B7[migrate local-history]
     B --> B8[enhance]
+    B --> B9[review]
     C --> C1[read]
     C --> C2[struct]
     C --> C3[symbol]
     C --> C4[diag]
+    C --> C5[review]
 ```
 
 ## What it is for
@@ -27,6 +29,10 @@ flowchart LR
 - read-only daemon status inspection via `graft daemon status`
 - bounded, lazy WARP refresh via `graft index --path <path>`
 - one-time legacy import via `graft migrate local-history`
+- human-facing structural review summaries via `graft review`
+- review-loop readiness via `graft review cooldown`
+- structural/reference test coverage maps via `graft struct test-coverage`
+- dead-symbol cleanup candidates via `graft struct dead-symbols`
 - Git-facing structural review summaries via `git graft enhance`
 - local debugging and dogfooding of MCP peer commands
 - human-facing inspection of bounded state such as:
@@ -35,12 +41,14 @@ flowchart LR
   - `graft diag doctor`
   - `graft doctor --sludge`
   - `graft diag stats`
+  - `graft symbol history`
   - `graft symbol difficulty`
 
 ## Core namespaces
 - `read` — bounded reads and change checks
-- `struct` — structural diff / since / map
-- `symbol` — precision show / find / blame / difficulty
+- `struct` — structural diff / since / map / review / test-coverage / dead-symbols
+- `symbol` — precision show / find / blame / history / difficulty
+- `review` — structural review and review-loop readiness
 - `diag` — activity, local-history-dag, doctor, explain, stats, capture
 
 ## Release-facing commands
@@ -55,9 +63,18 @@ graft diag activity --json
 graft diag local-history-dag --json
 graft diag doctor --json
 graft doctor --sludge --json
+graft review --base HEAD~1
+graft review --base origin/main --head HEAD --json
+graft review cooldown --pr 48
+graft review cooldown --comments-file comments.json --now 2026-05-05T15:10:00.000Z --json
 graft symbol find 'create*' --json
+graft symbol history createUser --path src/users.ts
 graft symbol difficulty createUser --path src/users.ts --json
 graft struct diff --json
+graft struct test-coverage --src src --tests test
+graft struct test-coverage --src src --tests test --json
+graft struct dead-symbols --limit 20
+graft struct dead-symbols --limit 20 --json
 git graft enhance --since HEAD~1
 git-graft enhance --since HEAD~1
 git-graft enhance --since HEAD~1 --json
@@ -73,14 +90,55 @@ pnpm graft diag activity
 
 Bare `graft ...` only works when the package is installed or linked onto your `PATH`.
 
+`graft review --base <ref> [--head <ref>] [--json]` renders the
+repo-local structural review summary backed by the same `graft_review`
+model as MCP and `graft struct review`. Human output separates
+structural files from formatting, test, docs, and config churn. JSON
+output keeps the schema-validated `graft.cli.struct_review` payload for
+agents. GitHub PR-number resolution and comment posting are intentionally
+outside this first slice; check out or fetch the PR branch and compare
+refs locally.
+
+`graft review cooldown [--pr <number>] [--comments-file <path>] [--now
+<iso>] [--json]` reads PR comments, detects CodeRabbit rate-limit
+markers, and reports whether another automated review request is ready,
+still cooling down, or unknown. Without `--comments-file` it shells out
+to `gh pr view [<number>] --json comments`; fixtures can use
+`--comments-file` to validate the same logic without network or GitHub
+state. Human output includes local timestamps; JSON output keeps the
+schema-validated `graft.cli.review_cooldown` payload.
+
+`graft struct test-coverage [--src <path>] [--tests <path>] [--json]`
+renders a structural/reference coverage map for exported source symbols.
+The default paths are `src` and `test`. Human output lists summary
+counts, limitations, and per-symbol `covered` / `uncovered` status.
+JSON output keeps the schema-validated
+`graft.cli.struct_test_coverage` payload. This command does not run
+tests or claim line, branch, statement, or execution coverage; imports
+and mentions in test files can count as structural references.
+
+`graft struct dead-symbols [--limit <n>] [--json]` lists symbols removed
+from indexed WARP history and not subsequently re-added. Human output is
+intended for cleanup and API-surface shrinkage review; JSON output keeps
+the schema-validated `graft.cli.struct_dead_symbols` payload backed by
+the `graft_dead_symbols` MCP peer.
+
+`graft symbol history <symbol> [--path <path>] [--json]` renders the
+same provenance-backed history as `graft symbol blame`, with a
+timeline-first human view over creation, signature-change, and reference
+facts. JSON output remains the schema-validated `graft.cli.symbol_blame`
+payload so the alias does not create a second wire shape for the same
+WARP truth.
+
 `git graft enhance --since <ref> [--head <ref>] [--json]` is the
 installed Git external-command form for the release-facing structural
 review aggregator. `git-graft enhance --since <ref>` is the direct
 package binary form. Both route through the same top-level `enhance`
 parser path. The command composes the shipped structural-since and
-export-surface facts into a concise review summary; it does not wrap
-arbitrary Git subcommands or expand into provenance, blame, reference, or
-write-tool behavior.
+export-surface facts into a concise review summary, plus bounded
+provenance hints for changed symbols when WARP blame data is available.
+It does not wrap arbitrary Git subcommands or expand into unbounded
+reference traversal or write-tool behavior.
 
 `graft diag activity` is the current human-facing between-commit surface. It reports bounded local `artifact_history`, not canonical provenance, and now renders a textual operator summary by default. Use `--json` when you want the structured machine-readable form.
 

package/docs/MCP.md

@@ -63,7 +63,8 @@ flow:
 ## Key Tool Groups
 - **Bounded Reads**: `safe_read`, `file_outline`, `read_range`, `changed_since`
 - **Governed Edits**: `graft_edit`
-- **Structural History**: `graft_diff`, `graft_since`, `graft_map`
+- **Structural History**: `graft_diff`, `graft_since`, `graft_map`,
+  `graft_review`, `graft_test_coverage`, `graft_dead_symbols`
 - **Structural Metrics**: `graft_churn`, `graft_difficulty`
 - **Precision**: `code_show`, `code_find`, `code_refs`
 - **Activity & Footing**: `activity_view`, `causal_status`, `causal_attach`, `doctor`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flyingrobots/graft",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Context governor and between-commit activity surface for coding agents",
   "type": "module",
   "packageManager": "pnpm@10.30.0",
@@ -90,6 +90,7 @@
     "@git-stunts/plumbing": "^2.8.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "picomatch": "^4.0.4",
+    "tree-sitter-graphql-grammar-wasm": "1.0.1",
     "tree-sitter-wasms": "0.1.13",
     "web-tree-sitter": "^0.20.8",
     "zod": "4.3.6"
@@ -110,7 +111,9 @@
     "onlyBuiltDependencies": [],
     "overrides": {
       "vite": "^8.0.5",
-      "hono": ">=4.12.14",
+      "hono": "4.12.18",
+      "fast-uri": "3.1.2",
+      "ip-address": "10.2.0",
       "postcss": "8.5.12"
     }
   }