@flyingrobots/graft 0.6.0 → 0.7.0

package/ADVANCED_GUIDE.md

@@ -0,0 +1,52 @@
+# Advanced Guide
+
+This guide is the release-facing signpost for operators and
+contributors who need more than setup instructions.
+
+## Use this guide for
+
+- understanding the same-user local daemon posture
+- understanding hook/bootstrap coverage and degraded footing
+- understanding the boundary between bounded local `artifact_history`
+  and canonical provenance
+- understanding why release prep pauses the repo after a cycle close
+
+## Current advanced topics
+
+### Daemon posture
+
+`graft daemon` is a same-user local runtime with explicit workspace
+authorization, session binding, monitor control, and bounded daemon
+inspection surfaces.
+
+### Reactive footing
+
+Checkout-boundary footing is explicit. Graft can report installed hook
+coverage, hook-observed transitions, and degraded posture when local
+edit watchers are absent.
+
+### Same-repo concurrency
+
+Graft now distinguishes bounded same-repo postures such as
+`exclusive`, `shared_repo_only`, `shared_worktree`,
+`overlapping_actors`, and `divergent_checkout` without pretending
+multi-writer provenance already exists.
+
+### Between-commit activity
+
+`activity_view` and `graft diag activity` expose bounded local
+between-commit `artifact_history`. This is not canonical provenance
+and not causal collapse.
+
+## Related docs
+
+- [README](./README.md)
+- [Guide](./GUIDE.md)
+- [Setup Guide](./docs/SETUP.md)
+- [CLI Guide](./docs/CLI.md)
+- [MCP Guide](./docs/MCP.md)
+- [Architecture](./ARCHITECTURE.md)
+- [Security Model](./docs/strategy/security-model.md)
+- [Causal Provenance](./docs/strategy/causal-provenance.md)
+- [Bearing](./docs/BEARING.md)
+- [Vision](./docs/VISION.md)

package/CHANGELOG.md

@@ -7,6 +7,148 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-04-30
+
+### Added
+
+- **Sludge detector**: `doctor` can run an opt-in parser-backed
+  structural smell scan with `sludge: true` or `graft doctor --sludge`.
+  It reports typedef/class imbalance, JSDoc cast density, homeless
+  constructor functions, free functions operating on project types, and
+  high-symbol-count files.
+- **Refactor difficulty score**: `graft_difficulty` and
+  `graft symbol difficulty` report a scalar per-symbol refactor score
+  from WARP churn curvature and reference-edge friction.
+- **WARP snapshot indexing**: `indexHead` is now the canonical
+  snapshot-based indexing path and emits commit, file, directory,
+  symbol, and AST facts with tick metadata.
+- **Cross-file import resolution**: WARP now records import,
+  re-export, and namespace reference edges for graph-native reference
+  queries.
+- **Outline-diff commit trailer**: `formatStructuralDiffTrailer` +
+  `parseStructuralDiffTrailer` for embedding structural diffs in
+  git commit messages as machine-readable trailers.
+- **Background indexing with monitor_nudge**: `monitor_nudge` MCP
+  tool triggers immediate re-index for a running monitor. For
+  post-commit hooks to notify graft that HEAD changed.
+- **Structural drift detection**: `checkNumericClaim` and
+  `checkPatternProhibition` verify doc claims against reality —
+  numeric counts and pattern prohibitions.
+- **Drift sentinel**: `runDriftSentinel(ctx, options)` scans all
+  tracked markdown files for stale symbol references against the
+  WARP graph. Returns pass/fail verdict for pre-commit hook use.
+- **WARP-based reference counting for structural-review**: `graft_review`
+  now counts symbol references via WARP graph traversal instead of
+  ripgrep. More precise (actual imports) and faster (no subprocess).
+- **Stale docs checker**: `checkStaleDocs` cross-references markdown
+  symbol mentions against the WARP graph to detect outdated docs.
+  `checkVersionDrift` compares CHANGELOG vs package.json versions.
+- **Session knowledge map**: `knowledge_map` MCP tool answers "what
+  do I already know?" — observed files, symbols, staleness flags,
+  and per-directory coverage.
+- **Symbol history timeline**: `symbolTimeline(ctx, name, filePath?)`
+  returns every version of a symbol across commits — signature, line
+  range, presence, and change kind, ordered by tick.
+- **Dead symbol detection**: `findDeadSymbols(ctx, options?)` finds
+  symbols removed from the codebase and never re-added. Supports
+  `maxCommits` depth limiting. Uses WARP snapshot diffs, no grep.
+- **Monitor tick ceiling tracking**: `runMonitorTickJob` skips
+  `openWarp` and `indexHead` when HEAD hasn't changed since the last
+  indexed commit. Idle monitor ticks are now near-zero-cost.
+- **Daemon-backed stdio MCP runtime**: `graft serve --runtime daemon`
+  exposes the tested daemon bridge as a release-facing MCP runtime, and
+  `graft init --mcp-runtime daemon --write-*-mcp` can generate client
+  config for daemon-backed stdio instead of repo-local stdio.
+- **Read-only daemon status surface**: `graft daemon status
+  [--socket <path>]` renders daemon health, session counts, workspace
+  posture, monitor summary, scheduler pressure, and worker pressure
+  without adding daemon mutation actions.
+- **Git-facing enhance first slice**: `git graft enhance --since <ref>`
+  and `git-graft enhance --since <ref>` compose shipped structural
+  since and export-surface facts into a concise review summary, with
+  schema-validated JSON available through `--json`.
+- **Governed exact replacement edit**: `graft_edit` is a narrow MCP
+  edit tool for one exact replacement through Graft's path, policy,
+  schema, and filesystem-port boundaries.
+- **Agent drift advisory**: `graft_edit` responses can include optional
+  advisory `driftWarnings` when a same-session edit removes then later
+  reintroduces the narrow `jsdoc_typedef` structural pattern.
+
+### Changed
+
+- **WARP context boundary**: `WarpHandle` was removed in favor of
+  direct git-warp types carried through `WarpContext`, with fail-closed
+  strand routing hooks for future strand isolation.
+- **Structural query read paths**: structural queries now use
+  `traverse`, `QueryBuilder`, and tick receipts instead of broad
+  `getEdges()` scans.
+- **WARP-backed structural operations**: `graft_log`, `graft_churn`,
+  `graft_blame`, and `graft_review` now use WARP graph data for their
+  MCP execution paths.
+- **Aggregate-backed structural churn**: `graft_churn` now computes
+  live-symbol change counts with WARP `QueryBuilder.aggregate()`, while
+  preserving removed-symbol churn from tick receipt evidence.
+- **`graft_blame` output shape**: WARP-backed blame returns tick-aware
+  symbol timeline data and a simplified `createdInCommit` value. This
+  is a breaking pre-1.0 MCP schema change for consumers scraping the
+  old result shape.
+- **Daemon runtime selection**: repo-local `graft serve` remains
+  unchanged, while daemon-backed operation is now an explicit
+  `--runtime daemon` choice with clear setup docs.
+- **Release scope truth**: full LSP semantic enrichment and the
+  remaining medium-risk slice-first read sweep are preserved as
+  post-v0.7.0 follow-up cards instead of active release blockers.
+
+### Removed
+
+- **Legacy commit-walking indexer**: removed the old `indexCommits`
+  pipeline and related model/graph helpers. `indexHead` is the active
+  indexing path.
+
+### Fixed
+
+- **Agent worktree hygiene**: added `pnpm guard:agent-worktrees`,
+  wired it into release preflight and the repo-local pre-commit hook,
+  and covered forced embedded-repo gitlinks under `.claude/worktrees/`.
+- **Export surface semver impact**: `exportSurfaceDiff` now treats
+  breaking signature changes conservatively. Required parameter
+  additions, removed parameters, parameter type changes, and return
+  type changes are `major`; additive optional parameters are `minor`.
+- **Reference edge scan**: `referencesForSymbol` no longer scans all
+  graph edges; it traverses incoming `references` edges from the target
+  symbol/file node.
+- **Keep a Changelog version drift**: `checkVersionDrift` now accepts
+  bracketed headings such as `## [0.7.0] - YYYY-MM-DD`.
+- **Dockerized test isolation**: default `pnpm test` now runs in a
+  copy-in Docker container so validation cannot inherit the operator's
+  live checkout Git hooks or Git environment.
+- **Full-suite timeout nondeterminism**: test MCP servers and daemon
+  integration tests now use explicit temp-only Git/runtime seams to
+  avoid hidden WARP/server work under full-suite load.
+- **Repo path symlink-parent escape**: repo path resolution validates
+  the nearest existing ancestor so future create/write tools cannot
+  escape through an existing symlinked parent directory.
+- **Monitor indexing ceiling**: background monitor ticks now batch
+  explicit paths through the existing `indexHead` cap instead of
+  failing every tick for repos with more than 64 parseable files.
+- **WARP structural log metadata**: `indexHead` now persists commit
+  message, author, email, date, and timestamp on commit nodes so
+  `graft struct log` retains user-visible commit context.
+- **Cold WARP structural review impact**: `graft_review` now preserves
+  breaking-change impact counts on fresh worktrees by falling back to a
+  bounded import/re-export scan when graph reference edges are not
+  available yet.
+- **Backlog dependency DAG**: the checked-in DAG now renders
+  `blocked_by`, `blocking`, and `blocked_by_external` relationships
+  from backlog card frontmatter.
+
+## [0.6.1] - 2026-04-19
+
+### Fixed
+
+- **CI test fixes**: release gate test excludes build artifact `dist/`
+  from existence check. Package docs test updated for moved doc paths.
+
 ## [0.6.0] - 2026-04-18
 
 ### Added

package/GUIDE.md

@@ -0,0 +1,53 @@
+# Guide — Graft
+
+This is the developer-level operator guide for Graft. Use it for orientation, the productive-fast path, and to understand how the context governor orchestrates agentic reads.
+
+For deep-track doctrine, worldline internals, and repository-wide engineering standards, use [ADVANCED_GUIDE.md](./ADVANCED_GUIDE.md).
+
+## Choose Your Lane
+
+### 1. Initialize a Repository
+Bootstrap a new repo with read policies, git hooks, and agent instructions.
+- **Run**: `npx @flyingrobots/graft init`
+- **Read**: [Setup Guide](./docs/SETUP.md) (Detailed per-editor steps)
+
+### 2. Standalone CLI Usage
+Manually enforce policies or inspect structural history from your terminal.
+- **Read**: [CLI Signpost](./docs/CLI.md)
+
+### 3. Shared Daemon Mode
+Run the central execution authority for multi-repo work and persistent monitors.
+- **Run**: `npx @flyingrobots/graft daemon`
+- **Read**: [docs/SETUP.md](./docs/SETUP.md) (Daemon bootstrap and `workspace_authorize` / `workspace_bind`)
+- **Read**: [Architecture](./ARCHITECTURE.md) (Daemon section)
+
+## Big Picture: System Orchestration
+
+Graft is a tiered governor. It manages the context burden across three layers:
+
+1. **Graft Core (Policy)**: Pure TypeScript logic that evaluates file size, language support, and session budgets to decide *what* an agent should see.
+2. **Parser (Meaning)**: Uses Tree-Sitter WASM to extract structural outlines and compute diffs, turning raw files into actionable meaning.
+3. **WARP (Memory)**: The Structural Worldline Memory that tracks AST evolution across commits, providing a provenance-aware history of the repository.
+
+## Orientation Checklist
+
+- [ ] **I am setting up a new project**: Start with `README.md` Quick Start.
+- [ ] **I am configuring Claude Code**: Use `npx graft init --write-claude-hooks`.
+- [ ] **I am using daemon mode in a generic MCP client**: Read [docs/SETUP.md](./docs/SETUP.md) and expect explicit `workspace_authorize` then `workspace_bind`.
+- [ ] **I am debugging a structural diff**: Use `npx graft struct diff --json`.
+- [ ] **I am contributing to Graft**: Read `METHOD.md` and `docs/BEARING.md`.
+
+## Rule of Thumb
+
+If you need a comprehensive tool reference, use the [MCP Signpost](./docs/MCP.md).
+
+If you need the daemon trust boundary or handoff model, use
+[docs/strategy/security-model.md](./docs/strategy/security-model.md) and
+[docs/strategy/causal-provenance.md](./docs/strategy/causal-provenance.md).
+
+If you need to know "what's true right now," use [docs/BEARING.md](./docs/BEARING.md).
+
+If you are just starting, use the [README.md](./README.md) and the setup instructions in [docs/SETUP.md](./docs/SETUP.md).
+
+---
+**The goal is inevitably. Every feature is defined by its tests.**

package/README.md

@@ -1,6 +1,6 @@
 # Graft
 
-An industrial-grade context governor for coding agents. Graft enforces read policy so agents consume the smallest structurally correct view of a codebase instead of dumping raw files into their context window.
+A context governor for coding agents. Graft enforces read policy so agents consume the smallest structurally correct view of a codebase instead of dumping raw files into their context window.
 
 Graft is designed for the operator who demands precision and the architect who needs a stable foundation for agentic work. It scales from simple policy-aware reads to high-fidelity causal provenance tracking across multi-session worktrees.
 

package/dist/adapters/json-text-decoder.d.ts

@@ -0,0 +1,3 @@
+import { type JsonObject } from "../contracts/json-object.js";
+export declare function parseJsonTextObject(text: string, label: string): JsonObject;
+//# sourceMappingURL=json-text-decoder.d.ts.map

package/dist/adapters/json-text-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-text-decoder.d.ts","sourceRoot":"","sources":["../../src/adapters/json-text-decoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,6BAA6B,CAAC;AAE/E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAQ3E"}

package/dist/adapters/json-text-decoder.js

@@ -0,0 +1,12 @@
+import { parseJsonObject } from "../contracts/json-object.js";
+export function parseJsonTextObject(text, label) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`${label} was not valid JSON`);
+    }
+    return parseJsonObject(parsed, label);
+}
+//# sourceMappingURL=json-text-decoder.js.map

package/dist/adapters/json-text-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-text-decoder.js","sourceRoot":"","sources":["../../src/adapters/json-text-decoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE/E,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,KAAa;IAC7D,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qBAAqB,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/dist/adapters/node-paths.d.ts

@@ -0,0 +1,3 @@
+import type { PathOps } from "../ports/paths.js";
+export declare const nodePathOps: PathOps;
+//# sourceMappingURL=node-paths.d.ts.map

package/dist/adapters/node-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-paths.d.ts","sourceRoot":"","sources":["../../src/adapters/node-paths.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAejD,eAAO,MAAM,WAAW,EAAE,OAczB,CAAC"}

package/dist/adapters/node-paths.js

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

package/dist/adapters/node-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-paths.js","sourceRoot":"","sources":["../../src/adapters/node-paths.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4DAA4D;AAC5D,8EAA8E;AAE9E,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,kBAAkB,CAAC,CAAS;IACnC,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC;IACxB,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,aAAa,CAAC,CAAS;IAC9B,OAAO,kBAAkB,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAY;IAClC,SAAS,CAAC,CAAS;QACjB,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,QAAQ,CAAC,QAAgB,EAAE,SAAiB;QAC1C,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QACzC,OAAO,QAAQ,KAAK,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,CAAC,GAAG,QAAkB;QACxB,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC"}

package/dist/adapters/repo-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo-paths.d.ts","sourceRoot":"","sources":["../../src/adapters/repo-paths.ts"],"names":[],"mappings":"AAEA,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAUrF;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO9E"}
+{"version":3,"file":"repo-paths.d.ts","sourceRoot":"","sources":["../../src/adapters/repo-paths.ts"],"names":[],"mappings":"AAiCA,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAoBrF;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO9E"}

package/dist/adapters/repo-paths.js

@@ -1,11 +1,46 @@
+import * as fs from "node:fs";
 import * as path from "node:path";
+function pathEscapesRoot(root, target) {
+    const relative = path.relative(root, target);
+    return relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative);
+}
+function realPathOrSelf(target) {
+    try {
+        return fs.realpathSync.native(target);
+    }
+    catch {
+        return target;
+    }
+}
+function nearestExistingAncestor(target) {
+    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) {
+    const normalizedRoot = path.resolve(projectRoot);
+    const realProjectRoot = realPathOrSelf(normalizedRoot);
     return (input) => {
-        if (path.isAbsolute(input))
-            return input;
-        const resolved = path.resolve(projectRoot, input);
-        const relative = path.relative(projectRoot, resolved);
-        if (relative.startsWith("..")) {
+        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;

package/dist/adapters/repo-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"repo-paths.js","sourceRoot":"","sources":["../../src/adapters/repo-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,OAAO,CAAC,KAAa,EAAU,EAAE;QAC/B,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,QAAgB;IACpE,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAChG,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC9D,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAChG,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"repo-paths.js","sourceRoot":"","sources":["../../src/adapters/repo-paths.ts"],"names":[],"mappings":"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"}

package/dist/api/tool-bridge.d.ts

@@ -1,5 +1,5 @@
 import type { McpToolName } from "../contracts/capabilities.js";
-import { type JsonObject } from "../contracts/json-object.js";
+import type { JsonObject } from "../contracts/json-object.js";
 import { type McpOutputFor } from "../contracts/output-schemas.js";
 import type { GraftServer, McpToolResult } from "../mcp/server.js";
 export declare function parseGraftToolPayload(result: McpToolResult): JsonObject;

package/dist/api/tool-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-bridge.d.ts","sourceRoot":"","sources":["../../src/api/tool-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,KAAK,UAAU,EAAuB,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAMvE;AAED,wBAAsB,aAAa,CAAC,CAAC,SAAS,WAAW,EACvD,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAG1B"}
+{"version":3,"file":"tool-bridge.d.ts","sourceRoot":"","sources":["../../src/api/tool-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAMvE;AAED,wBAAsB,aAAa,CAAC,CAAC,SAAS,WAAW,EACvD,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAG1B"}

package/dist/api/tool-bridge.js

@@ -1,4 +1,4 @@
-import { parseJsonTextObject } from "../contracts/json-object.js";
+import { parseJsonTextObject } from "../adapters/json-text-decoder.js";
 import { getMcpOutputSchema } from "../contracts/output-schemas.js";
 export function parseGraftToolPayload(result) {
     const payload = result.content.find((item) => item.type === "text");

package/dist/api/tool-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-bridge.js","sourceRoot":"","sources":["../../src/api/tool-bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAqB,MAAM,gCAAgC,CAAC;AAGvF,MAAM,UAAU,qBAAqB,CAAC,MAAqB;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACpE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,mBAAmB,CAAC,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAkB,EAClB,IAAO,EACP,IAAgB;IAEhB,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACvE,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAoB,CAAC;AACnE,CAAC"}
+{"version":3,"file":"tool-bridge.js","sourceRoot":"","sources":["../../src/api/tool-bridge.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAqB,MAAM,gCAAgC,CAAC;AAGvF,MAAM,UAAU,qBAAqB,CAAC,MAAqB;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACpE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,mBAAmB,CAAC,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAkB,EAClB,IAAO,EACP,IAAgB;IAEhB,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACvE,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAoB,CAAC;AACnE,CAAC"}

package/dist/cli/cli-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-error.d.ts","sourceRoot":"","sources":["../../src/cli/cli-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3D,UAAU,eAAe;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,IAAI,CAeN;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAyH3E"}
+{"version":3,"file":"cli-error.d.ts","sourceRoot":"","sources":["../../src/cli/cli-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3D,UAAU,eAAe;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,IAAI,CAeN;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAgK3E"}

package/dist/cli/cli-error.js

@@ -25,25 +25,44 @@ export function describeCliFailure(argv) {
     }
     if (group === "serve") {
         return {
-            usage: "graft serve",
-            nextSteps: ["Run `graft help` to see the explicit transport entrypoints."],
+            usage: "graft serve [--runtime <repo-local|daemon>] [--socket <path>] [--no-autostart]",
+            nextSteps: [
+                "`graft serve` is repo-local stdio. Use `graft serve --runtime daemon` for the daemon-backed stdio bridge.",
+            ],
         };
     }
     if (group === "daemon") {
+        if (subcommand === "status") {
+            return {
+                usage: "graft daemon status [--socket <path>]",
+                nextSteps: ["Start the daemon with `graft daemon` or target another daemon with `--socket <path>`."],
+            };
+        }
         return {
-            usage: "graft daemon [--socket <path>]",
-            nextSteps: ["Run `graft help` to see the daemon and grouped command surfaces."],
+            usage: "graft daemon [--socket <path>] | graft daemon status [--socket <path>]",
+            nextSteps: ["Run `graft daemon status` to inspect an already-running daemon without mutating daemon state."],
         };
     }
+    if (group === "doctor") {
+        return { usage: "graft doctor [--sludge] [--path <path>] [--json]" };
+    }
     if (group === "index") {
         return {
-            usage: "graft index [<from-ref>] [--json]",
-            nextSteps: ["Use `--json` for machine-readable output."],
+            usage: "graft index [--path <path>] [--json]",
+            nextSteps: ["Use `--path <path>` for lazy per-file indexing and `--json` for machine-readable output."],
+        };
+    }
+    if (group === "enhance") {
+        return {
+            usage: "git-graft enhance --since <ref> [--head <ref>] [--json]",
+            nextSteps: [
+                "Use `git graft enhance --since <ref>` after package install, or `git-graft enhance --since <ref>` via the direct binary.",
+            ],
         };
     }
     if (group === "init") {
         return {
-            usage: "graft init [--json] [--write-claude-mcp] [--write-claude-hooks] "
+            usage: "graft init [--json] [--mcp-runtime <repo-local|daemon>] [--write-claude-mcp] [--write-claude-hooks] "
                 + "[--write-target-git-hooks] [--write-codex-mcp] [--write-cursor-mcp] "
                 + "[--write-windsurf-mcp] [--write-continue-mcp] [--write-cline-mcp]",
             nextSteps: ["Run `graft help` to confirm the repo-local bootstrap surfaces."],
@@ -77,8 +96,20 @@ export function describeCliFailure(argv) {
         if (subcommand === "map") {
             return { usage: "graft struct map [<directory>] [--json]" };
         }
+        if (subcommand === "churn") {
+            return { usage: "graft struct churn [--path <path>] [--limit <n>] [--json]" };
+        }
+        if (subcommand === "exports") {
+            return { usage: "graft struct exports [<base-ref> <head-ref>] [--json]" };
+        }
+        if (subcommand === "log") {
+            return { usage: "graft struct log [--path <path>] [--limit <n>] [--json]" };
+        }
+        if (subcommand === "review") {
+            return { usage: "graft struct review [--base <ref>] [--head <ref>] [--json]" };
+        }
         return {
-            usage: "graft struct <diff|since|map> ...",
+            usage: "graft struct <diff|since|map|churn|exports|log|review> ...",
             nextSteps: ["Run `graft help` to see the available structural subcommands."],
         };
     }
@@ -89,8 +120,14 @@ export function describeCliFailure(argv) {
         if (subcommand === "show") {
             return { usage: "graft symbol show <symbol> [--path <path>] [--ref <ref>] [--json]" };
         }
+        if (subcommand === "blame") {
+            return { usage: "graft symbol blame <symbol> [--path <path>] [--json]" };
+        }
+        if (subcommand === "difficulty") {
+            return { usage: "graft symbol difficulty <symbol> [--path <path>] [--limit <n>] [--json]" };
+        }
         return {
-            usage: "graft symbol <find|show> ...",
+            usage: "graft symbol <find|show|blame|difficulty> ...",
             nextSteps: ["Run `graft help` to see the available symbol subcommands."],
         };
     }
@@ -107,7 +144,7 @@ export function describeCliFailure(argv) {
             return { usage: "graft diag local-history-dag [--limit <n>] [--json]" };
         }
         if (subcommand === "doctor") {
-            return { usage: "graft diag doctor [--json]" };
+            return { usage: "graft diag doctor [--sludge] [--path <path>] [--json]" };
         }
         if (subcommand === "explain") {
             return { usage: "graft diag explain <reason-code> [--json]" };

package/dist/cli/cli-error.js.map

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

package/dist/cli/command-parser.d.ts

@@ -8,10 +8,19 @@ export interface ParsedCommand {
     json: boolean;
     args: Record<string, unknown>;
 }
+export type ServeRuntime = "repo-local" | "daemon";
+export interface ParsedServeCommand {
+    readonly runtime: ServeRuntime;
+    readonly socketPath?: string | undefined;
+    readonly spawnIfMissing?: boolean | undefined;
+}
+export interface ParsedDaemonCommand {
+    readonly action: "start" | "status";
+    readonly socketPath?: string | undefined;
+}
 export declare function resolveEntrypointArgs(args: readonly string[], stdinIsTTY: boolean | undefined, stdoutIsTTY: boolean | undefined): string[];
-export declare function parseDaemonCommand(cwd: string, argv: string[]): {
-    socketPath?: string;
-};
+export declare function parseDaemonCommand(cwd: string, argv: string[]): ParsedDaemonCommand;
+export declare function parseServeCommand(cwd: string, argv: string[]): ParsedServeCommand;
 export declare function parseGlobalOptions(cwd: string, args: readonly string[]): GlobalCliOptions;
 export declare function parseCommand(argv: string[]): ParsedCommand;
 //# sourceMappingURL=command-parser.d.ts.map

package/dist/cli/command-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-parser.d.ts","sourceRoot":"","sources":["../../src/cli/command-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,UAAU,EAAE,OAAO,GAAG,SAAS,EAC/B,WAAW,EAAE,OAAO,GAAG,SAAS,GAC/B,MAAM,EAAE,CAKV;AA4CD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAIvF;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,gBAAgB,CAOlB;AAgND,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAU1D"}
+{"version":3,"file":"command-parser.d.ts","sourceRoot":"","sources":["../../src/cli/command-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,UAAU,EAAE,OAAO,GAAG,SAAS,EAC/B,WAAW,EAAE,OAAO,GAAG,SAAS,GAC/B,MAAM,EAAE,CAKV;AA4CD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAWnF;AAYD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAqBjF;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,gBAAgB,CAOlB;AAkUD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAyB1D"}