@flyingrobots/graft 0.6.0 → 0.7.0

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

@@ -0,0 +1,104 @@
+// ---------------------------------------------------------------------------
+// WARP-based Structural Log — replaces git log SHA walking
+// ---------------------------------------------------------------------------
+import { observeGraph } from "./context.js";
+/**
+ * Produce a structural log entirely from the WARP graph.
+ *
+ * Walks commit nodes in reverse tick order (most recent first),
+ * traverses outgoing adds/changes/removes edges per commit to
+ * collect symbol changes. Zero git subprocess calls.
+ */
+export async function structuralLogFromGraph(ctx, options) {
+    const limit = options?.limit ?? 20;
+    const pathFilter = options?.path;
+    // Query all commit nodes
+    const obs = await observeGraph(ctx, {
+        match: ["commit:*", "sym:*"],
+        expose: ["sha", "tick", "message", "author", "date", "name", "kind", "signature", "exported"],
+    });
+    const commitResult = await obs.query()
+        .match("commit:*")
+        .select(["id", "props"])
+        .run();
+    const commits = [];
+    for (const node of commitResult.nodes) {
+        if (node.id === undefined)
+            continue;
+        const props = node.props ?? {};
+        commits.push({
+            id: node.id,
+            sha: typeof props["sha"] === "string" ? props["sha"] : node.id.slice("commit:".length),
+            tick: typeof props["tick"] === "number" ? props["tick"] : 0,
+            message: typeof props["message"] === "string" ? props["message"] : "",
+            author: typeof props["author"] === "string" ? props["author"] : "",
+            date: typeof props["date"] === "string" ? props["date"] : "",
+        });
+    }
+    if (commits.length === 0)
+        return [];
+    // Sort by tick descending (most recent first)
+    commits.sort((a, b) => b.tick - a.tick);
+    const scoped = commits.slice(0, limit);
+    // For each commit, traverse edges to get symbol changes
+    const edgeLabels = [
+        { label: "adds", key: "added" },
+        { label: "changes", key: "changed" },
+        { label: "removes", key: "removed" },
+    ];
+    const entries = [];
+    for (const commit of scoped) {
+        const added = [];
+        const changed = [];
+        const removed = [];
+        for (const { label, key } of edgeLabels) {
+            const symIds = await obs.traverse.bfs(commit.id, {
+                dir: "out",
+                labelFilter: label,
+                maxDepth: 1,
+            });
+            for (const symId of symIds) {
+                if (!symId.startsWith("sym:"))
+                    continue;
+                const withoutPrefix = symId.slice("sym:".length);
+                const lastColon = withoutPrefix.lastIndexOf(":");
+                if (lastColon === -1)
+                    continue;
+                const filePath = withoutPrefix.slice(0, lastColon);
+                const symbolName = withoutPrefix.slice(lastColon + 1);
+                if (pathFilter !== undefined && !filePath.startsWith(pathFilter))
+                    continue;
+                const symProps = await obs.getNodeProps(symId);
+                const kind = typeof symProps?.["kind"] === "string" ? symProps["kind"] : "unknown";
+                const signature = typeof symProps?.["signature"] === "string" ? symProps["signature"] : undefined;
+                const exported = typeof symProps?.["exported"] === "boolean" ? symProps["exported"] : false;
+                const change = {
+                    name: symbolName,
+                    kind,
+                    signature,
+                    exported,
+                    filePath,
+                };
+                if (key === "added")
+                    added.push(change);
+                else if (key === "changed")
+                    changed.push(change);
+                else
+                    removed.push(change);
+            }
+        }
+        const totalChanges = added.length + changed.length + removed.length;
+        entries.push({
+            sha: commit.sha,
+            author: commit.author,
+            date: commit.date,
+            message: commit.message,
+            symbols: { added, removed, changed },
+            summary: totalChanges === 0
+                ? "No structural changes."
+                : `${String(added.length)} added, ${String(changed.length)} changed, ${String(removed.length)} removed.`,
+        });
+    }
+    return entries;
+}
+//# sourceMappingURL=warp-structural-log.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -8,9 +8,12 @@ flowchart LR
     A --> C[Namespaces]
     B --> B1[init]
     B --> B2[serve]
-    B --> B3[daemon]
-    B --> B4[index]
-    B --> B5[migrate local-history]
+    B --> B3[serve --runtime daemon]
+    B --> B4[daemon]
+    B --> B5[daemon status]
+    B --> B6[index]
+    B --> B7[migrate local-history]
+    B --> B8[enhance]
     C --> C1[read]
     C --> C2[struct]
     C --> C3[symbol]
@@ -19,28 +22,45 @@ flowchart LR
 
 ## What it is for
 - bootstrap and setup via `graft init`
+- repo-local stdio MCP via `graft serve`
+- daemon-backed stdio MCP via `graft serve --runtime daemon`
+- 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`
+- 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:
   - `graft diag activity`
   - `graft diag local-history-dag`
   - `graft diag doctor`
+  - `graft doctor --sludge`
   - `graft diag stats`
+  - `graft symbol difficulty`
 
 ## Core namespaces
 - `read` — bounded reads and change checks
 - `struct` — structural diff / since / map
-- `symbol` — precision show / find
+- `symbol` — precision show / find / blame / difficulty
 - `diag` — activity, local-history-dag, doctor, explain, stats, capture
 
 ## Release-facing commands
 ```bash
+graft serve
+graft serve --runtime daemon
+graft daemon status
+graft daemon status --socket /path/to/mcp.sock
+graft index --path src/app.ts --json
 graft migrate local-history --json
 graft diag activity --json
 graft diag local-history-dag --json
 graft diag doctor --json
+graft doctor --sludge --json
 graft symbol find 'create*' --json
+graft symbol difficulty createUser --path src/users.ts --json
 graft struct diff --json
+git graft enhance --since HEAD~1
+git-graft enhance --since HEAD~1
+git-graft enhance --since HEAD~1 --json
 ```
 
 ## Repo-local invocation
@@ -53,10 +73,54 @@ pnpm graft diag activity
 
 Bare `graft ...` only works when the package is installed or linked onto your `PATH`.
 
+`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.
+
 `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.
 
 `graft diag local-history-dag` is a CLI-only debug surface over the repo-local WARP graph. It renders a bounded event-centric DAG for local history through Bijou's `dag()` component. In interactive terminals that means the Bijou DAG layout; in pipes or non-TTY contexts it degrades to Bijou's truthful pipe-mode graph listing.
 
+`graft daemon status` is the read-only daemon status surface. It connects
+to an already-running daemon, builds a deterministic status model from
+existing daemon read tools, and renders daemon health, sessions,
+workspace posture, monitors, scheduler pressure, and worker pressure.
+Use `--socket <path>` to inspect a non-default daemon socket. This first
+slice does not authorize, revoke, bind, rebind, pause, resume, start, or
+stop daemon resources.
+
+`graft index` follows the lazy-index policy. Use `--path <path>` to refresh a
+specific tracked source file at `HEAD`; read/search surfaces also opportunistically
+refresh the files they touch. Unbounded whole-repo indexing is guarded and returns
+a structured refusal when the request would write too many file patches at once.
+
+## MCP Runtime Selection
+
+`graft serve` is repo-local stdio MCP. The launched process owns one
+repo-local workspace rooted at the current checkout.
+
+`graft serve --runtime daemon` is daemon-backed stdio MCP. The launched
+process is a bridge to the local daemon `/mcp` surface. If the daemon is
+not already healthy, the bridge starts it and waits for readiness. Add
+`--no-autostart` to fail instead of starting a daemon, and add
+`--socket <path>` to target a non-default daemon socket.
+
+Generated MCP config uses the same distinction:
+
+```bash
+graft init --write-codex-mcp
+graft init --mcp-runtime daemon --write-codex-mcp
+```
+
+The first command emits `args = ["-y", "@flyingrobots/graft", "serve"]`.
+The second emits
+`args = ["-y", "@flyingrobots/graft", "serve", "--runtime", "daemon"]`.
+
 ## Related docs
 - [README](../README.md)
 - [Setup Guide](./SETUP.md)

package/docs/MCP.md

@@ -27,6 +27,25 @@ This is the default repo-local MCP posture. The current checkout is the
 active workspace, so there is no separate daemon authorization or
 binding step.
 
+### Daemon-backed stdio MCP
+```bash
+npx @flyingrobots/graft serve --runtime daemon
+```
+
+This keeps compatibility with MCP clients that can launch only a stdio
+command while routing MCP traffic to the local daemon `/mcp` surface.
+The bridge auto-starts the daemon when it is missing, waits for
+`/healthz`, then proxies stdio traffic to the daemon. Use
+`--no-autostart` to require an already-running daemon:
+
+```bash
+npx @flyingrobots/graft serve --runtime daemon --no-autostart
+```
+
+Daemon-backed sessions start unbound. Repository-scoped tools fail
+until the session is authorized and bound through the workspace control
+plane.
+
 ### Local Daemon
 ```bash
 npx @flyingrobots/graft daemon
@@ -43,13 +62,17 @@ 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 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_*`
 
 ## Current Truth
 - MCP is the primary agent surface.
+- `graft serve` is repo-local stdio; `graft serve --runtime daemon` is
+  the daemon-backed stdio bridge.
 - Responses carry versioned `_schema` metadata and `_receipt` decision data.
 - `activity_view` provides bounded local `artifact_history` anchored to Git `HEAD`.