@flyingrobots/graft 0.8.0 → 0.10.0

package/dist/warp/structural-reading-adapter.js

@@ -0,0 +1,98 @@
+import { countNamedImportReferencesAtRef as defaultCountNamedImportReferencesAtRef, } from "../operations/import-reference-impact.js";
+import { countSymbolReferencesFromGraph as defaultCountSymbolReferencesFromGraph, } from "./warp-reference-count.js";
+import { findDeadSymbols as defaultFindDeadSymbols, } from "./dead-symbols.js";
+function translatedGitWarpEvidence(deps, basis, evidence) {
+    return {
+        kind: "translated-substrate",
+        evidenceLabel: "fallback-translated",
+        substrate: "git-warp",
+        basis: {
+            kind: "git-committed-history",
+            projectRoot: deps.projectRoot,
+            ...(basis.ref !== undefined ? { ref: basis.ref } : {}),
+            ...(basis.maxCommits !== undefined ? { maxCommits: basis.maxCommits } : {}),
+        },
+        evidence,
+        nativeContinuumWitness: false,
+    };
+}
+function normalizeRefOrDefault(ref) {
+    const normalized = ref?.trim();
+    return normalized === undefined || normalized.length === 0 ? "HEAD" : normalized;
+}
+function symbolReferencePayload(symbolName, result) {
+    return {
+        symbol: "symbol" in result ? result.symbol : symbolName,
+        referenceCount: result.referenceCount,
+        referencingFiles: result.referencingFiles,
+    };
+}
+export function createGitWarpStructuralReadingPort(deps) {
+    const countSymbolReferencesFromGraph = deps.countSymbolReferencesFromGraph ?? defaultCountSymbolReferencesFromGraph;
+    const countNamedImportReferencesAtRef = deps.countNamedImportReferencesAtRef ?? defaultCountNamedImportReferencesAtRef;
+    const findDeadSymbols = deps.findDeadSymbols ?? defaultFindDeadSymbols;
+    return {
+        async countSymbolReferences(request) {
+            const ref = normalizeRefOrDefault(request.ref);
+            const warp = await deps.getWarp();
+            const graphResult = await countSymbolReferencesFromGraph(warp, request.symbolName, request.filePath);
+            let payload = symbolReferencePayload(request.symbolName, graphResult);
+            let source = "warp-graph";
+            let residualPosture = "complete";
+            if (graphResult.referenceCount === 0) {
+                try {
+                    const fallbackResult = await countNamedImportReferencesAtRef({
+                        cwd: deps.projectRoot,
+                        git: deps.git,
+                        pathOps: deps.pathOps,
+                        symbolName: request.symbolName,
+                        filePath: request.filePath,
+                        ref,
+                    });
+                    if (fallbackResult.referenceCount > 0) {
+                        payload = symbolReferencePayload(request.symbolName, fallbackResult);
+                        source = "committed-import-scan";
+                    }
+                }
+                catch {
+                    payload = symbolReferencePayload(request.symbolName, graphResult);
+                    residualPosture = "partial";
+                }
+            }
+            return {
+                kind: "symbol-reference-count",
+                freshness: "current",
+                residualPosture,
+                payload,
+                evidence: translatedGitWarpEvidence(deps, { ref }, {
+                    kind: "symbol-reference-count",
+                    source,
+                    symbolName: request.symbolName,
+                    filePath: request.filePath,
+                }),
+            };
+        },
+        async findDeadSymbols(request = {}) {
+            const warp = await deps.getWarp();
+            const options = request.maxCommits !== undefined
+                ? { maxCommits: request.maxCommits }
+                : undefined;
+            const symbols = await findDeadSymbols(warp, options);
+            return {
+                kind: "dead-symbols",
+                freshness: "current",
+                residualPosture: "complete",
+                payload: {
+                    symbols,
+                    total: symbols.length,
+                },
+                evidence: translatedGitWarpEvidence(deps, { maxCommits: request.maxCommits }, {
+                    kind: "dead-symbols",
+                    source: "warp-graph",
+                    ...(request.maxCommits !== undefined ? { maxCommits: request.maxCommits } : {}),
+                }),
+            };
+        },
+    };
+}
+//# sourceMappingURL=structural-reading-adapter.js.map

package/dist/warp/structural-reading-adapter.js.map

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

package/docs/CLI.md

@@ -125,10 +125,10 @@ 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.
+timeline-first human view over creation, signature-change, per-version
+path and line-range facts, 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

package/docs/MCP.md

@@ -52,14 +52,18 @@ npx @flyingrobots/graft daemon
 ```
 
 Daemon sessions start `unbound`. Once a client is connected to the
-daemon MCP surface, repository-scoped work follows this control-plane
-flow:
+daemon MCP surface, repository-scoped work normally follows this
+agent-facing flow:
 
-1. `workspace_authorize` with the target `cwd`
-2. `workspace_bind` with the target `cwd`
+1. `workspace_open` with the target `cwd`
+2. optionally `workspace_list_opened` to inspect opened paths and the
+   active workspace
 3. then call repository-scoped tools such as `safe_read`, `graft_since`,
    or `code_show`
 
+`workspace_authorize` and `workspace_bind` remain available as lower-level
+daemon control-plane tools.
+
 ## Key Tool Groups
 - **Bounded Reads**: `safe_read`, `file_outline`, `read_range`, `changed_since`
 - **Governed Edits**: `graft_edit`
@@ -68,7 +72,8 @@ flow:
 - **Structural Metrics**: `graft_churn`, `graft_difficulty`
 - **Precision**: `code_show`, `code_find`, `code_refs`
 - **Activity & Footing**: `activity_view`, `causal_status`, `causal_attach`, `doctor`
-- **Daemon Control Plane**: `workspace_authorizations`, `workspace_authorize`, `workspace_bind`, `workspace_status`, `workspace_rebind`, `workspace_revoke`, `daemon_status`, `daemon_repos`, `daemon_sessions`, `daemon_monitors`, `monitor_*`
+- **Workspace Routing**: `workspace_open`, `workspace_list_opened`, `workspace_status`
+- **Daemon Control Plane**: `workspace_authorizations`, `workspace_authorize`, `workspace_bind`, `workspace_rebind`, `workspace_revoke`, `daemon_status`, `daemon_repos`, `daemon_sessions`, `daemon_monitors`, `monitor_*`
 
 ## Current Truth
 - MCP is the primary agent surface.

package/docs/SETUP.md

@@ -98,6 +98,8 @@ Daemon control-plane inspection now exists through MCP tools:
 - `monitor_stop`
 - `workspace_authorizations`
 - `workspace_authorize`
+- `workspace_open`
+- `workspace_list_opened`
 - `workspace_bind`
 - `workspace_status`
 - `workspace_rebind`
@@ -120,10 +122,14 @@ Practical daemon-backed MCP first-use sequence:
 
 1. configure your MCP client with `graft serve --runtime daemon`
 2. let the bridge auto-start the daemon, or start `npx @flyingrobots/graft daemon`
-3. call `workspace_authorize` with the target `cwd`
-4. call `workspace_bind` with the target `cwd`
+3. call `workspace_open` with the target `cwd`
+4. optionally call `workspace_list_opened` to inspect opened paths and the
+   active workspace
 5. then use repository-scoped tools such as `safe_read` or `graft_map`
 
+Use `workspace_authorize` plus `workspace_bind` when you need direct
+operator control over daemon authorization and binding state.
+
 ### MCP runtime selection
 
 Repo-local stdio is the default and remains the simplest path:
@@ -157,8 +163,7 @@ Use repo-local stdio when you want one MCP server bound directly to the
 current checkout. Use daemon-backed stdio when you want daemon-only
 capabilities such as shared worker pools, persistent monitors, and
 daemon control-plane inspection. Daemon-backed sessions start unbound;
-repository-scoped tools require `workspace_authorize` and
-`workspace_bind`.
+repository-scoped tools normally begin with `workspace_open`.
 
 ### One-step bootstrap
 
@@ -399,8 +404,9 @@ If your client doesn't support `npx`, install globally and use:
 
 This section shows the repo-local stdio path. If you connect through
 `graft daemon` instead, the MCP session starts `unbound` and needs
-`workspace_authorize` plus `workspace_bind` before repository-scoped
-tool calls.
+`workspace_open` before repository-scoped tool calls. The lower-level
+`workspace_authorize` and `workspace_bind` tools remain available for
+operator control-plane workflows.
 
 ## Claude Code Hooks
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flyingrobots/graft",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Context governor and between-commit activity surface for coding agents",
   "type": "module",
   "packageManager": "pnpm@10.30.0",
@@ -46,11 +46,15 @@
     "test:watch": "vitest",
     "lint": "eslint .",
     "typecheck": "tsc --noEmit",
+    "schema:structural-history:check": "tsx scripts/check-structural-history-schema-artifacts.ts && tsx scripts/check-structural-history-echo-package.ts",
     "pack:check": "pnpm pack --dry-run",
     "guard:agent-worktrees": "tsx scripts/check-agent-worktree-hygiene.ts",
     "security:check": "tsx scripts/check-release-security.ts",
     "release:surface-gate": "vitest run --run test/unit/release/package-library-surface.test.ts test/unit/release/three-surface-capability-posture.test.ts",
-    "release:check": "pnpm guard:agent-worktrees && pnpm lint && pnpm typecheck && pnpm release:surface-gate && pnpm test && pnpm security:check && pnpm pack:check"
+    "release:check": "pnpm guard:agent-worktrees && pnpm schema:structural-history:check && pnpm lint && pnpm typecheck && pnpm release:surface-gate && pnpm test && pnpm security:check && pnpm pack:check",
+    "gh:issues": "bash scripts/gh-issues.sh bootstrap",
+    "gh-issues": "bash scripts/gh-issues.sh bootstrap",
+    "gh-issues:check": "bash scripts/gh-issues-check.sh"
   },
   "engines": {
     "node": ">=20.11.0"
@@ -97,6 +101,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@git-stunts/alfred": "^0.10.3",
     "@types/node": "^25.5.0",
     "@types/picomatch": "^4.0.2",
     "eslint": "^10.1.0",
@@ -104,17 +109,19 @@
     "tsx": "^4.21.0",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.58.0",
-    "vite": "^8.0.5",
+    "vite": "8.0.16",
     "vitest": "^4.1.2"
   },
   "pnpm": {
     "onlyBuiltDependencies": [],
     "overrides": {
-      "vite": "^8.0.5",
-      "hono": "4.12.18",
+      "vite": "8.0.16",
+      "brace-expansion": "5.0.6",
+      "hono": "4.12.25",
       "fast-uri": "3.1.2",
       "ip-address": "10.2.0",
-      "postcss": "8.5.12"
+      "postcss": "8.5.12",
+      "qs": "6.15.2"
     }
   }
 }