@flyingrobots/graft 0.7.0 → 0.8.0

package/dist/warp/warp-structural-log.js.map

@@ -1 +1 @@
-{"version":3,"file":"warp-structural-log.js","sourceRoot":"","sources":["../../src/warp/warp-structural-log.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"warp-structural-log.js","sourceRoot":"","sources":["../../src/warp/warp-structural-log.ts"],"names":[],"mappings":"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"}

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/docs/SETUP.md

@@ -424,7 +424,7 @@ Add to `.claude/settings.json` in your project root:
         "hooks": [
           {
             "type": "command",
-            "command": "node --import tsx node_modules/@flyingrobots/graft/src/hooks/pretooluse-read.ts"
+            "command": "node node_modules/@flyingrobots/graft/dist/hooks/pretooluse-read.js"
           }
         ]
       }
@@ -435,7 +435,7 @@ Add to `.claude/settings.json` in your project root:
         "hooks": [
           {
             "type": "command",
-            "command": "node --import tsx node_modules/@flyingrobots/graft/src/hooks/posttooluse-read.ts"
+            "command": "node node_modules/@flyingrobots/graft/dist/hooks/posttooluse-read.js"
           }
         ]
       }
@@ -450,12 +450,16 @@ Project-local shortcut:
 npx @flyingrobots/graft init --write-claude-hooks
 ```
 
-If developing graft itself, replace the `node_modules/...` paths
-with local paths:
+Rerunning this command also upgrades generated v0.7.0 hook commands
+that pointed at `src/hooks/*.ts` to the published `dist/hooks/*.js`
+entry points.
 
-```
-src/hooks/pretooluse-read.ts    (PreToolUse)
-src/hooks/posttooluse-read.ts   (PostToolUse)
+If developing graft itself, run `pnpm build` and replace the
+`node_modules/...` paths with local paths:
+
+```text
+dist/hooks/pretooluse-read.js    (PreToolUse)
+dist/hooks/posttooluse-read.js   (PostToolUse)
 ```
 
 ### PreToolUse — ban enforcement

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "@flyingrobots/graft",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Context governor and between-commit activity surface for coding agents",
   "type": "module",
   "packageManager": "pnpm@10.30.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "sideEffects": [
+    "dist/parser/runtime.js",
+    "dist/operations/structured-buffer-model.js"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -20,7 +24,6 @@
   "files": [
     "bin/",
     "dist/",
-    "src/",
     "ADVANCED_GUIDE.md",
     "ARCHITECTURE.md",
     "CHANGELOG.md",
@@ -37,6 +40,7 @@
     "graft": "node ./bin/graft.js",
     "build": "tsc -p tsconfig.build.json",
     "prepack": "pnpm build",
+    "prepublishOnly": "pnpm release:check",
     "test": "tsx scripts/run-isolated-tests.ts",
     "test:local": "vitest run",
     "test:watch": "vitest",
@@ -86,8 +90,8 @@
     "@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",
-    "tsx": "^4.21.0",
     "web-tree-sitter": "^0.20.8",
     "zod": "4.3.6"
   },
@@ -97,6 +101,7 @@
     "@types/picomatch": "^4.0.2",
     "eslint": "^10.1.0",
     "globals": "^17.4.0",
+    "tsx": "^4.21.0",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.58.0",
     "vite": "^8.0.5",
@@ -106,7 +111,10 @@
     "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"
     }
   }
 }

package/src/adapters/canonical-json.ts

@@ -1,56 +0,0 @@
-// ---------------------------------------------------------------------------
-// CanonicalJsonCodec — deterministic JSON with sorted keys
-// ---------------------------------------------------------------------------
-//
-// Subset of RFC 8785 (JSON Canonicalization Scheme):
-//   - Object keys sorted lexicographically at every nesting level
-//   - Compact output (no whitespace)
-//   - Deterministic: same data always produces the same string
-//
-// Enables stable hashes, diffable logs, reproducible receipts.
-// ---------------------------------------------------------------------------
-
-import type { JsonCodec } from "../ports/codec.js";
-
-function isPlainObject(value: unknown): value is Record<string, unknown> {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) {
-    return false;
-  }
-  const proto = Object.getPrototypeOf(value) as unknown;
-  return proto === Object.prototype || proto === null;
-}
-
-function sortDeep(value: unknown, seen = new WeakSet()): unknown {
-  if (value === null || typeof value !== "object") {
-    return value;
-  }
-  if (!isPlainObject(value) && !Array.isArray(value)) {
-    return value;
-  }
-  if (seen.has(value)) {
-    throw new TypeError("Converting circular structure to JSON");
-  }
-  seen.add(value);
-  try {
-    if (Array.isArray(value)) {
-      return value.map((v) => sortDeep(v, seen));
-    }
-    const sorted: Record<string, unknown> = {};
-    for (const key of Object.keys(value).sort()) {
-      sorted[key] = sortDeep(value[key], seen);
-    }
-    return sorted;
-  } finally {
-    seen.delete(value);
-  }
-}
-
-export class CanonicalJsonCodec implements JsonCodec {
-  encode(value: unknown): string {
-    return JSON.stringify(sortDeep(value));
-  }
-
-  decode(data: string): unknown {
-    return JSON.parse(data) as unknown;
-  }
-}

package/src/adapters/json-text-decoder.ts

@@ -1,11 +0,0 @@
-import { type JsonObject, parseJsonObject } from "../contracts/json-object.js";
-
-export function parseJsonTextObject(text: string, label: string): JsonObject {
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(text) as unknown;
-  } catch {
-    throw new Error(`${label} was not valid JSON`);
-  }
-  return parseJsonObject(parsed, label);
-}

package/src/adapters/node-fs.ts

@@ -1,43 +0,0 @@
-// ---------------------------------------------------------------------------
-// Node.js filesystem adapter — implements the FileSystem port
-// ---------------------------------------------------------------------------
-
-import * as fs from "node:fs";
-import * as fsp from "node:fs/promises";
-import type { FileSystem } from "../ports/filesystem.js";
-
-class NodeFileSystem implements FileSystem {
-  readFile(path: string, encoding: "utf-8"): Promise<string>;
-  readFile(path: string): Promise<Buffer>;
-  readFile(path: string, encoding?: "utf-8"): Promise<string | Buffer> {
-    if (encoding !== undefined) return fsp.readFile(path, encoding);
-    return fsp.readFile(path);
-  }
-
-  readdir(path: string): Promise<string[]> {
-    return fsp.readdir(path);
-  }
-
-  writeFile(path: string, data: string, encoding: "utf-8"): Promise<void> {
-    return fsp.writeFile(path, data, encoding);
-  }
-
-  appendFile(path: string, data: string, encoding: "utf-8"): Promise<void> {
-    return fsp.appendFile(path, data, encoding);
-  }
-
-  async mkdir(path: string, options: { recursive: true }): Promise<void> {
-    await fsp.mkdir(path, options);
-  }
-
-  async stat(path: string): Promise<{ size: number }> {
-    const s = await fsp.stat(path);
-    return { size: s.size };
-  }
-
-  readFileSync(path: string, encoding: "utf-8"): string {
-    return fs.readFileSync(path, encoding);
-  }
-}
-
-export const nodeFs: FileSystem = new NodeFileSystem();

package/src/adapters/node-git.ts

@@ -1,47 +0,0 @@
-// ---------------------------------------------------------------------------
-// NodeGitClient — implements the GitClient port via GitPlumbing
-// ---------------------------------------------------------------------------
-
-import GitPlumbing from "@git-stunts/plumbing";
-import type { GitClient, GitRunRequest } from "../ports/git.js";
-
-class NodeGitClient implements GitClient {
-  private readonly clients = new Map<string, GitPlumbing>();
-
-  private resolveClient(cwd: string): GitPlumbing {
-    const cached = this.clients.get(cwd);
-    if (cached !== undefined) return cached;
-    const created = GitPlumbing.createDefault({ cwd });
-    this.clients.set(cwd, created);
-    return created;
-  }
-
-  async run(request: GitRunRequest) {
-    try {
-      const plumbing = this.resolveClient(request.cwd);
-      const stream = await plumbing.executeStream({ args: [...request.args] });
-      const stdout = await stream.collect({
-        asString: true,
-        ...(request.maxBufferBytes !== undefined ? { maxBytes: request.maxBufferBytes } : {}),
-      });
-      const finished = await stream.finished;
-      const error = "error" in finished && finished.error instanceof Error ? finished.error : undefined;
-      return {
-        status: finished.code,
-        stdout: typeof stdout === "string" ? stdout : new TextDecoder().decode(stdout),
-        stderr: finished.stderr,
-        ...(error !== undefined ? { error } : {}),
-      };
-    } catch (error: unknown) {
-      const normalized = error instanceof Error ? error : new Error(String(error));
-      return {
-        status: 1,
-        stdout: "",
-        stderr: normalized.message,
-        error: normalized,
-      };
-    }
-  }
-}
-
-export const nodeGit: GitClient = new NodeGitClient();

package/src/adapters/node-paths.ts

@@ -1,35 +0,0 @@
-// ---------------------------------------------------------------------------
-// Node PathOps adapter — implements PathOps using node:path
-// ---------------------------------------------------------------------------
-
-import * as path from "node:path";
-import type { PathOps } from "../ports/paths.js";
-
-function toForwardSlash(p: string): string {
-  return p.replaceAll("\\", "/");
-}
-
-function stripTrailingSlash(p: string): string {
-  if (p === "/") return p;
-  return p.endsWith("/") ? p.slice(0, -1) : p;
-}
-
-function normalizeImpl(p: string): string {
-  return stripTrailingSlash(toForwardSlash(path.normalize(p)));
-}
-
-export const nodePathOps: PathOps = {
-  normalize(p: string): string {
-    return normalizeImpl(p);
-  },
-
-  isWithin(filePath: string, directory: string): boolean {
-    const normFile = normalizeImpl(filePath);
-    const normDir = normalizeImpl(directory);
-    return normFile === normDir || normFile.startsWith(`${normDir}/`);
-  },
-
-  join(...segments: string[]): string {
-    return normalizeImpl(path.join(...segments));
-  },
-};

package/src/adapters/node-process-runner.ts

@@ -1,27 +0,0 @@
-// ---------------------------------------------------------------------------
-// NodeProcessRunner — implements the ProcessRunner port
-// ---------------------------------------------------------------------------
-
-import { spawnSync } from "node:child_process";
-import type { ProcessRunRequest, ProcessRunResult, ProcessRunner } from "../ports/process-runner.js";
-
-class NodeProcessRunner implements ProcessRunner {
-  run(request: ProcessRunRequest): ProcessRunResult {
-    const result = spawnSync(request.command, [...request.args], {
-      cwd: request.cwd,
-      encoding: "utf-8",
-      stdio: ["pipe", "pipe", "pipe"],
-      ...(request.timeoutMs !== undefined ? { timeout: request.timeoutMs } : {}),
-      ...(request.maxBufferBytes !== undefined ? { maxBuffer: request.maxBufferBytes } : {}),
-    });
-
-    return {
-      status: result.status,
-      stdout: typeof result.stdout === "string" ? result.stdout : "",
-      stderr: typeof result.stderr === "string" ? result.stderr : "",
-      ...(result.error !== undefined ? { error: result.error } : {}),
-    };
-  }
-}
-
-export const nodeProcessRunner: ProcessRunner = new NodeProcessRunner();

package/src/adapters/repo-paths.ts

@@ -1,63 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-
-function pathEscapesRoot(root: string, target: string): boolean {
-  const relative = path.relative(root, target);
-  return relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative);
-}
-
-function realPathOrSelf(target: string): string {
-  try {
-    return fs.realpathSync.native(target);
-  } catch {
-    return target;
-  }
-}
-
-function nearestExistingAncestor(target: string): string {
-  let current = target;
-  while (current.length > 0) {
-    try {
-      fs.lstatSync(current);
-      return current;
-    } catch {
-      const parent = path.dirname(current);
-      if (parent === current) {
-        return current;
-      }
-      current = parent;
-    }
-  }
-  return target;
-}
-
-export function createRepoPathResolver(projectRoot: string): (input: string) => string {
-  const normalizedRoot = path.resolve(projectRoot);
-  const realProjectRoot = realPathOrSelf(normalizedRoot);
-
-  return (input: string): string => {
-    const resolved = path.isAbsolute(input)
-      ? path.resolve(input)
-      : path.resolve(normalizedRoot, input);
-
-    if (pathEscapesRoot(normalizedRoot, resolved)) {
-      throw new Error(`Path traversal blocked: ${input}`);
-    }
-
-    const realAncestor = realPathOrSelf(nearestExistingAncestor(resolved));
-    if (pathEscapesRoot(realProjectRoot, realAncestor)) {
-      throw new Error(`Path traversal blocked: ${input}`);
-    }
-
-    return resolved;
-  };
-}
-
-export function toRepoPolicyPath(projectRoot: string, filePath: string): string {
-  const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(projectRoot, filePath);
-  const relativePath = path.relative(projectRoot, absolutePath);
-  if (relativePath.length === 0 || relativePath.startsWith("..") || path.isAbsolute(relativePath)) {
-    return absolutePath;
-  }
-  return relativePath.split(path.sep).join("/");
-}

package/src/adapters/rotating-ndjson-log.ts

@@ -1,66 +0,0 @@
-import * as path from "node:path";
-import type { JsonCodec } from "../ports/codec.js";
-import type { FileSystem } from "../ports/filesystem.js";
-
-export interface RotatingNdjsonLogOptions {
-  readonly fs: FileSystem;
-  readonly codec: JsonCodec;
-  readonly logPath: string;
-  readonly maxBytes?: number;
-}
-
-const DEFAULT_MAX_BYTES = 1_048_576;
-
-export class RotatingNdjsonLog {
-  private readonly fs: FileSystem;
-  private readonly codec: JsonCodec;
-  private readonly logPath: string;
-  private readonly maxBytes: number;
-
-  constructor(options: RotatingNdjsonLogOptions) {
-    this.fs = options.fs;
-    this.codec = options.codec;
-    this.logPath = options.logPath;
-    this.maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
-  }
-
-  async append(entry: object): Promise<void> {
-    const line = this.codec.encode(entry) + "\n";
-    const dir = path.dirname(this.logPath);
-    await this.fs.mkdir(dir, { recursive: true });
-    await this.fs.appendFile(this.logPath, line, "utf-8");
-    await this.rotateIfNeeded();
-  }
-
-  private async rotateIfNeeded(): Promise<void> {
-    let stat: { size: number };
-    try {
-      stat = await this.fs.stat(this.logPath);
-    } catch {
-      return;
-    }
-
-    if (stat.size <= this.maxBytes) {
-      return;
-    }
-
-    const content = await this.fs.readFile(this.logPath, "utf-8");
-    const lines = content.trimEnd().split("\n");
-    let kept = lines.slice(Math.ceil(lines.length / 2));
-
-    // If slicing left nothing (e.g. a single oversized entry), skip rotation —
-    // the file is already at minimum size (one entry).
-    if (kept.length === 0) {
-      return;
-    }
-
-    let result = kept.join("\n") + "\n";
-
-    while (Buffer.byteLength(result, "utf-8") > this.maxBytes && kept.length > 1) {
-      kept = kept.slice(Math.ceil(kept.length / 2));
-      result = kept.join("\n") + "\n";
-    }
-
-    await this.fs.writeFile(this.logPath, result, "utf-8");
-  }
-}