@flyingrobots/graft 0.5.0 → 0.6.0

package/dist/adapters/node-process-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-process-runner.js","sourceRoot":"","sources":["../../src/adapters/node-process-runner.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,MAAM,iBAAiB;IACrB,GAAG,CAAC,OAA0B;QAC5B,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE;YAC3D,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvF,CAAC,CAAC;QAEH,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YAC9D,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YAC9D,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/D,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAkB,IAAI,iBAAiB,EAAE,CAAC"}

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

@@ -0,0 +1,3 @@
+export declare function createRepoPathResolver(projectRoot: string): (input: string) => string;
+export declare function toRepoPolicyPath(projectRoot: string, filePath: string): string;
+//# sourceMappingURL=repo-paths.d.ts.map

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

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

package/dist/adapters/repo-paths.js

@@ -0,0 +1,22 @@
+import * as path from "node:path";
+export function createRepoPathResolver(projectRoot) {
+    return (input) => {
+        if (path.isAbsolute(input))
+            return input;
+        const resolved = path.resolve(projectRoot, input);
+        const relative = path.relative(projectRoot, resolved);
+        if (relative.startsWith("..")) {
+            throw new Error(`Path traversal blocked: ${input}`);
+        }
+        return resolved;
+    };
+}
+export function toRepoPolicyPath(projectRoot, filePath) {
+    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("/");
+}
+//# sourceMappingURL=repo-paths.js.map

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

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

package/dist/adapters/rotating-ndjson-log.d.ts

@@ -0,0 +1,18 @@
+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;
+}
+export declare class RotatingNdjsonLog {
+    private readonly fs;
+    private readonly codec;
+    private readonly logPath;
+    private readonly maxBytes;
+    constructor(options: RotatingNdjsonLogOptions);
+    append(entry: object): Promise<void>;
+    private rotateIfNeeded;
+}
+//# sourceMappingURL=rotating-ndjson-log.d.ts.map

package/dist/adapters/rotating-ndjson-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotating-ndjson-log.d.ts","sourceRoot":"","sources":["../../src/adapters/rotating-ndjson-log.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,wBAAwB;IAOvC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAQ5B,cAAc;CA+B7B"}

package/dist/adapters/rotating-ndjson-log.js

@@ -0,0 +1,48 @@
+import * as path from "node:path";
+const DEFAULT_MAX_BYTES = 1_048_576;
+export class RotatingNdjsonLog {
+    fs;
+    codec;
+    logPath;
+    maxBytes;
+    constructor(options) {
+        this.fs = options.fs;
+        this.codec = options.codec;
+        this.logPath = options.logPath;
+        this.maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+    }
+    async append(entry) {
+        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();
+    }
+    async rotateIfNeeded() {
+        let stat;
+        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");
+    }
+}
+//# sourceMappingURL=rotating-ndjson-log.js.map

package/dist/adapters/rotating-ndjson-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotating-ndjson-log.js","sourceRoot":"","sources":["../../src/adapters/rotating-ndjson-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAWlC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAEpC,MAAM,OAAO,iBAAiB;IACX,EAAE,CAAa;IACf,KAAK,CAAY;IACjB,OAAO,CAAS;IAChB,QAAQ,CAAS;IAElC,YAAY,OAAiC;QAC3C,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;IAC9B,CAAC;IAEO,KAAK,CAAC,cAAc;QAC1B,IAAI,IAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAEpD,2EAA2E;QAC3E,mDAAmD;QACnD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,IAAI,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAEpC,OAAO,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7E,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9C,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAClC,CAAC;QAED,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/api/index.d.ts

@@ -0,0 +1,27 @@
+import { startDaemonServer } from "../mcp/daemon-server.js";
+import { MCP_TOOL_NAMES } from "../contracts/capabilities.js";
+import { createGraftServer } from "../mcp/server.js";
+import { startStdioServer } from "../mcp/stdio-server.js";
+import { ObservationCache } from "../operations/observation-cache.js";
+import { RepoWorkspace } from "../operations/repo-workspace.js";
+import { StructuredBuffer } from "../operations/structured-buffer.js";
+import type { BufferRange, WarmProjectionBasis, WarmProjectionBundleResult } from "../operations/structured-buffer.js";
+import { GRAFT_VERSION } from "../version.js";
+export { createRepoLocalGraft, type CreateRepoLocalGraftOptions } from "./repo-local-graft.js";
+export { createRepoWorkspace, type CreateRepoWorkspaceOptions } from "./repo-workspace.js";
+export { callGraftTool, parseGraftToolPayload } from "./tool-bridge.js";
+export interface CreateStructuredBufferOptions {
+    readonly basis?: WarmProjectionBasis | undefined;
+}
+export interface CreateProjectionBundleOptions extends CreateStructuredBufferOptions {
+    readonly viewport?: BufferRange | undefined;
+}
+export declare function createStructuredBuffer(path: string, content: string, options?: CreateStructuredBufferOptions): StructuredBuffer;
+export declare function createProjectionBundle(path: string, content: string, options?: CreateProjectionBundleOptions): WarmProjectionBundleResult;
+export { GRAFT_VERSION, MCP_TOOL_NAMES, ObservationCache, RepoWorkspace, StructuredBuffer, createGraftServer, startDaemonServer, startStdioServer, };
+export type { AnchorAffinityResult, BufferDiagnostic, BufferOutlineResult, BufferPoint, BufferRange, BufferSelection, ChangedRegion, DiagnosticsResult, FoldRegion, FoldRegionsResult, InjectionRegion, InjectionResult, NodeLookupResult, NodeSummary, RenameEditPreview, RenamePreviewResult, SelectionStepResult, SemanticSummaryKind, SemanticSummaryResult, StructuredBufferDiffResult, SymbolOccurrence, SymbolOccurrencesResult, SyntaxClass, SyntaxSpan, SyntaxSpanResult, WarmProjectionBundleResult, WarmProjectionParseStatus, WarmProjectionBasis, } from "../operations/structured-buffer.js";
+export type { StartDaemonServerOptions, } from "../mcp/daemon-server.js";
+export type { CreateGraftServerOptions, GraftServer, McpToolResult, } from "../mcp/server.js";
+export type { McpToolName, } from "../contracts/capabilities.js";
+export type { RepoWorkspaceChangedSinceResult, RepoWorkspaceFileOutlineResult, RepoWorkspaceReadRangeResult, RepoWorkspaceRefusedResult, RepoWorkspaceSafeReadCacheHitResult, RepoWorkspaceSafeReadDiffResult, RepoWorkspaceSafeReadResult, } from "../operations/repo-workspace.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACvH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAExE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,6BAA8B,SAAQ,6BAA6B;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC7C;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,6BAAkC,GAC1C,gBAAgB,CAElB;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,6BAAkC,GAC1C,0BAA0B,CAO5B;AAED,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,CAAC;AAEF,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAE5C,YAAY,EACV,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,wBAAwB,EACxB,WAAW,EACX,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,WAAW,GACZ,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,+BAA+B,EAC/B,8BAA8B,EAC9B,4BAA4B,EAC5B,0BAA0B,EAC1B,mCAAmC,EACnC,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,iCAAiC,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,25 @@
+import { startDaemonServer } from "../mcp/daemon-server.js";
+import { MCP_TOOL_NAMES } from "../contracts/capabilities.js";
+import { createGraftServer } from "../mcp/server.js";
+import { startStdioServer } from "../mcp/stdio-server.js";
+import { ObservationCache } from "../operations/observation-cache.js";
+import { RepoWorkspace } from "../operations/repo-workspace.js";
+import { StructuredBuffer } from "../operations/structured-buffer.js";
+import { GRAFT_VERSION } from "../version.js";
+export { createRepoLocalGraft } from "./repo-local-graft.js";
+export { createRepoWorkspace } from "./repo-workspace.js";
+export { callGraftTool, parseGraftToolPayload } from "./tool-bridge.js";
+export function createStructuredBuffer(path, content, options = {}) {
+    return new StructuredBuffer({ path, content, basis: options.basis });
+}
+export function createProjectionBundle(path, content, options = {}) {
+    const buffer = new StructuredBuffer({ path, content, basis: options.basis });
+    try {
+        return buffer.projectionBundle({ viewport: options.viewport });
+    }
+    finally {
+        buffer.dispose();
+    }
+}
+export { GRAFT_VERSION, MCP_TOOL_NAMES, ObservationCache, RepoWorkspace, StructuredBuffer, createGraftServer, startDaemonServer, startStdioServer, };
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAoC,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAmC,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAUxE,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,OAAe,EACf,UAAyC,EAAE;IAE3C,OAAO,IAAI,gBAAgB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,OAAe,EACf,UAAyC,EAAE;IAE3C,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,gBAAgB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,GACjB,CAAC"}

package/dist/api/repo-local-graft.d.ts

@@ -0,0 +1,7 @@
+import { type CreateGraftServerOptions, type GraftServer } from "../mcp/server.js";
+export interface CreateRepoLocalGraftOptions extends Omit<CreateGraftServerOptions, "mode" | "projectRoot" | "graftDir"> {
+    readonly cwd?: string | undefined;
+    readonly graftDir?: string | undefined;
+}
+export declare function createRepoLocalGraft(options?: CreateRepoLocalGraftOptions): GraftServer;
+//# sourceMappingURL=repo-local-graft.d.ts.map

package/dist/api/repo-local-graft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-local-graft.d.ts","sourceRoot":"","sources":["../../src/api/repo-local-graft.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,2BAA4B,SAAQ,IAAI,CAAC,wBAAwB,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC;IACtH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,2BAAgC,GAAG,WAAW,CAQ3F"}

package/dist/api/repo-local-graft.js

@@ -0,0 +1,12 @@
+import * as path from "node:path";
+import { createGraftServer, } from "../mcp/server.js";
+export function createRepoLocalGraft(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    return createGraftServer({
+        ...options,
+        mode: "repo_local",
+        projectRoot: cwd,
+        graftDir: options.graftDir ?? path.join(cwd, ".graft"),
+    });
+}
+//# sourceMappingURL=repo-local-graft.js.map

package/dist/api/repo-local-graft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-local-graft.js","sourceRoot":"","sources":["../../src/api/repo-local-graft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EACL,iBAAiB,GAGlB,MAAM,kBAAkB,CAAC;AAO1B,MAAM,UAAU,oBAAoB,CAAC,UAAuC,EAAE;IAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,OAAO,iBAAiB,CAAC;QACvB,GAAG,OAAO;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,GAAG;QAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC;KACvD,CAAC,CAAC;AACL,CAAC"}

package/dist/api/repo-workspace.d.ts

@@ -0,0 +1,15 @@
+import { ObservationCache } from "../operations/observation-cache.js";
+import { RepoWorkspace } from "../operations/repo-workspace.js";
+import { GovernorTracker } from "../session/tracker.js";
+import type { JsonCodec } from "../ports/codec.js";
+import type { FileSystem } from "../ports/filesystem.js";
+export interface CreateRepoWorkspaceOptions {
+    readonly cwd?: string | undefined;
+    readonly graftignorePatterns?: readonly string[] | undefined;
+    readonly fs?: FileSystem | undefined;
+    readonly codec?: JsonCodec | undefined;
+    readonly governor?: GovernorTracker | undefined;
+    readonly cache?: ObservationCache | undefined;
+}
+export declare function createRepoWorkspace(options?: CreateRepoWorkspaceOptions): Promise<RepoWorkspace>;
+//# sourceMappingURL=repo-workspace.d.ts.map

package/dist/api/repo-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-workspace.d.ts","sourceRoot":"","sources":["../../src/api/repo-workspace.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,EAAE,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CAC/C;AAED,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,OAAO,CAAC,aAAa,CAAC,CAc1G"}

package/dist/api/repo-workspace.js

@@ -0,0 +1,23 @@
+import * as path from "node:path";
+import { CanonicalJsonCodec } from "../adapters/canonical-json.js";
+import { nodeFs } from "../adapters/node-fs.js";
+import { createRepoPathResolver, toRepoPolicyPath } from "../adapters/repo-paths.js";
+import { ObservationCache } from "../operations/observation-cache.js";
+import { RepoWorkspace } from "../operations/repo-workspace.js";
+import { GovernorTracker } from "../session/tracker.js";
+export async function createRepoWorkspace(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const fs = options.fs ?? nodeFs;
+    const codec = options.codec ?? new CanonicalJsonCodec();
+    return new RepoWorkspace({
+        projectRoot: cwd,
+        fs,
+        codec,
+        graftignorePatterns: options.graftignorePatterns ?? await RepoWorkspace.loadGraftignorePatterns(fs, cwd),
+        resolvePath: createRepoPathResolver(cwd),
+        toPolicyPath: (resolvedPath) => toRepoPolicyPath(cwd, resolvedPath),
+        ...(options.governor !== undefined ? { governor: options.governor } : {}),
+        ...(options.cache !== undefined ? { cache: options.cache } : {}),
+    });
+}
+//# sourceMappingURL=repo-workspace.js.map

package/dist/api/repo-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-workspace.js","sourceRoot":"","sources":["../../src/api/repo-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAaxD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAAsC,EAAE;IAChF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,MAAM,CAAC;IAChC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,kBAAkB,EAAE,CAAC;IACxD,OAAO,IAAI,aAAa,CAAC;QACvB,WAAW,EAAE,GAAG;QAChB,EAAE;QACF,KAAK;QACL,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,MAAM,aAAa,CAAC,uBAAuB,CAAC,EAAE,EAAE,GAAG,CAAC;QACxG,WAAW,EAAE,sBAAsB,CAAC,GAAG,CAAC;QACxC,YAAY,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,EAAE,YAAY,CAAC;QACnE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { McpToolName } from "../contracts/capabilities.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;
+export declare function callGraftTool<K extends McpToolName>(graft: GraftServer, name: K, args: JsonObject): Promise<McpOutputFor<K>>;
+//# sourceMappingURL=tool-bridge.d.ts.map

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

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

package/dist/api/tool-bridge.js

@@ -0,0 +1,14 @@
+import { parseJsonTextObject } from "../contracts/json-object.js";
+import { getMcpOutputSchema } from "../contracts/output-schemas.js";
+export function parseGraftToolPayload(result) {
+    const payload = result.content.find((item) => item.type === "text");
+    if (payload === undefined) {
+        throw new Error("Graft tool result did not contain a text payload");
+    }
+    return parseJsonTextObject(payload.text, "Graft tool result");
+}
+export async function callGraftTool(graft, name, args) {
+    const parsed = parseGraftToolPayload(await graft.callTool(name, args));
+    return getMcpOutputSchema(name).parse(parsed);
+}
+//# sourceMappingURL=tool-bridge.js.map

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

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

package/dist/cli/activity-render.d.ts

@@ -0,0 +1,2 @@
+export declare function renderActivityView(output: unknown): string;
+//# sourceMappingURL=activity-render.d.ts.map

package/dist/cli/activity-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-render.d.ts","sourceRoot":"","sources":["../../src/cli/activity-render.ts"],"names":[],"mappings":"AA2EA,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAoC1D"}

package/dist/cli/activity-render.js

@@ -0,0 +1,90 @@
+import {} from "zod";
+import { DIAG_ACTIVITY_CLI_SCHEMA } from "../contracts/output-schemas.js";
+function trimId(value) {
+    if (value === null || value === undefined || value.length === 0) {
+        return "unknown";
+    }
+    const parts = value.split(":");
+    return parts.at(-1) ?? value;
+}
+function shortSha(value) {
+    return value === null ? "unknown" : value.slice(0, 7);
+}
+function actorLabel(attribution) {
+    const actorId = trimId(attribution.actor.actorId);
+    const actorKind = attribution.actor.actorKind;
+    return actorKind === "unknown" ? `actor:${actorId}` : `${actorKind}:${actorId}`;
+}
+function summarizePaths(paths) {
+    if (paths.length === 0) {
+        return "no paths";
+    }
+    if (paths.length === 1) {
+        return paths[0] ?? "no paths";
+    }
+    if (paths.length === 2) {
+        return `${paths[0] ?? ""}, ${paths[1] ?? ""}`;
+    }
+    return `${paths[0] ?? ""}, ${paths[1] ?? ""} +${String(paths.length - 2)} more`;
+}
+function formatContinuityItem(item) {
+    const origin = item.continuedFromCausalSessionId === null
+        ? ""
+        : ` from session:${trimId(item.continuedFromCausalSessionId)}`;
+    return `${item.occurredAt}  continuity:${item.operation}  ${actorLabel(item.attribution)}  session:${trimId(item.causalSessionId)}  strand:${trimId(item.strandId)}${origin}`;
+}
+function formatReadItem(item) {
+    return `${item.occurredAt}  read:${item.payload.surface}/${item.payload.projection}  ${actorLabel(item.attribution)}  ${summarizePaths(item.footprint.paths)}`;
+}
+function formatStageItem(item) {
+    return `${item.occurredAt}  stage:${item.payload.selectionKind}  ${actorLabel(item.attribution)}  ${summarizePaths(item.footprint.paths)}`;
+}
+function formatTransitionItem(item) {
+    return `${item.occurredAt}  transition  ${actorLabel(item.attribution)}  ${item.payload.summary}`;
+}
+function formatActivityItem(item) {
+    if ("itemKind" in item) {
+        return formatContinuityItem(item);
+    }
+    if (item.eventKind === "read") {
+        return formatReadItem(item);
+    }
+    if (item.eventKind === "stage") {
+        return formatStageItem(item);
+    }
+    return formatTransitionItem(item);
+}
+export function renderActivityView(output) {
+    const parsed = DIAG_ACTIVITY_CLI_SCHEMA.parse(output);
+    const lines = [
+        "Activity",
+        `repo: ${parsed.repoId ?? "unknown"}`,
+        `worktree: ${parsed.worktreeId ?? "unknown"}`,
+        `anchor: ${parsed.anchor.headRef ?? parsed.anchor.posture} @ ${shortSha(parsed.anchor.headSha)}`,
+        `truth: ${parsed.truthClass}`,
+        `next: ${parsed.nextAction}`,
+        `degraded: ${parsed.degradedReasons.length === 0 ? "none" : parsed.degradedReasons.join(", ")}`,
+        "",
+        parsed.summary.headline,
+        parsed.summary.anchor,
+        parsed.summary.workspace,
+    ];
+    if (parsed.activityWindow.returned === 0) {
+        lines.push("", "No activity items found in the requested window.");
+        return lines.join("\n");
+    }
+    lines.push("");
+    lines.push(`window: ${String(parsed.activityWindow.returned)} shown / ${String(parsed.activityWindow.totalMatchingItems)} matching${parsed.activityWindow.truncated ? " (truncated)" : ""}`);
+    lines.push("");
+    lines.push("Groups");
+    for (const group of parsed.activityWindow.groups) {
+        lines.push("");
+        lines.push(`${group.label} (${String(group.items.length)})`);
+        lines.push(group.summary);
+        for (const item of group.items) {
+            lines.push(`  ${formatActivityItem(item)}`);
+        }
+    }
+    return lines.join("\n").trimEnd();
+}
+//# sourceMappingURL=activity-render.js.map

package/dist/cli/activity-render.js.map

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

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

@@ -0,0 +1,10 @@
+import { type Writer } from "./peer-command.js";
+interface CliErrorDetails {
+    readonly usage?: string | undefined;
+    readonly nextSteps?: readonly string[] | undefined;
+    readonly docsPath?: string | undefined;
+}
+export declare function writeCliError(writer: Writer, message: string, details?: CliErrorDetails): void;
+export declare function describeCliFailure(argv: readonly string[]): CliErrorDetails;
+export {};
+//# sourceMappingURL=cli-error.d.ts.map

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

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

package/dist/cli/cli-error.js

@@ -0,0 +1,130 @@
+import { writeLine } from "./peer-command.js";
+const CLI_DOCS_PATH = "docs/CLI.md";
+export function writeCliError(writer, message, details = {}) {
+    writeLine(writer, `Error: ${message}`);
+    if (details.usage !== undefined) {
+        writeLine(writer);
+        writeLine(writer, `Usage: ${details.usage}`);
+    }
+    const nextSteps = details.nextSteps ?? [];
+    if (nextSteps.length > 0) {
+        writeLine(writer);
+        for (const step of nextSteps) {
+            writeLine(writer, step);
+        }
+    }
+    writeLine(writer);
+    writeLine(writer, `See ${details.docsPath ?? CLI_DOCS_PATH} for grouped command help.`);
+}
+export function describeCliFailure(argv) {
+    const [group, subcommand] = argv;
+    if (group === undefined) {
+        return {
+            nextSteps: ["Run `graft help` to see the available command groups."],
+        };
+    }
+    if (group === "serve") {
+        return {
+            usage: "graft serve",
+            nextSteps: ["Run `graft help` to see the explicit transport entrypoints."],
+        };
+    }
+    if (group === "daemon") {
+        return {
+            usage: "graft daemon [--socket <path>]",
+            nextSteps: ["Run `graft help` to see the daemon and grouped command surfaces."],
+        };
+    }
+    if (group === "index") {
+        return {
+            usage: "graft index [<from-ref>] [--json]",
+            nextSteps: ["Use `--json` for machine-readable output."],
+        };
+    }
+    if (group === "init") {
+        return {
+            usage: "graft init [--json] [--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."],
+        };
+    }
+    if (group === "read") {
+        if (subcommand === "safe") {
+            return { usage: "graft read safe <path> [--json]" };
+        }
+        if (subcommand === "outline") {
+            return { usage: "graft read outline <path> [--json]" };
+        }
+        if (subcommand === "range") {
+            return { usage: "graft read range <path> --start <n> --end <n> [--json]" };
+        }
+        if (subcommand === "changed") {
+            return { usage: "graft read changed <path> [--consume] [--json]" };
+        }
+        return {
+            usage: "graft read <safe|outline|range|changed> ...",
+            nextSteps: ["Run `graft help` to see the available read subcommands."],
+        };
+    }
+    if (group === "struct") {
+        if (subcommand === "diff") {
+            return { usage: "graft struct diff [--base <ref>] [--head <ref>] [--path <path>] [--json]" };
+        }
+        if (subcommand === "since") {
+            return { usage: "graft struct since <base-ref> [--head <ref>] [--json]" };
+        }
+        if (subcommand === "map") {
+            return { usage: "graft struct map [<directory>] [--json]" };
+        }
+        return {
+            usage: "graft struct <diff|since|map> ...",
+            nextSteps: ["Run `graft help` to see the available structural subcommands."],
+        };
+    }
+    if (group === "symbol") {
+        if (subcommand === "find") {
+            return { usage: "graft symbol find <query> [--kind <kind>] [--path <path>] [--json]" };
+        }
+        if (subcommand === "show") {
+            return { usage: "graft symbol show <symbol> [--path <path>] [--ref <ref>] [--json]" };
+        }
+        return {
+            usage: "graft symbol <find|show> ...",
+            nextSteps: ["Run `graft help` to see the available symbol subcommands."],
+        };
+    }
+    if (group === "migrate") {
+        return {
+            usage: "graft migrate local-history [--json]",
+        };
+    }
+    if (group === "diag") {
+        if (subcommand === "activity") {
+            return { usage: "graft diag activity [--limit <n>] [--json]" };
+        }
+        if (subcommand === "local-history-dag") {
+            return { usage: "graft diag local-history-dag [--limit <n>] [--json]" };
+        }
+        if (subcommand === "doctor") {
+            return { usage: "graft diag doctor [--json]" };
+        }
+        if (subcommand === "explain") {
+            return { usage: "graft diag explain <reason-code> [--json]" };
+        }
+        if (subcommand === "stats") {
+            return { usage: "graft diag stats [--json]" };
+        }
+        if (subcommand === "capture") {
+            return { usage: "graft diag capture [--tail <n>] -- <shell command> [--json]" };
+        }
+        return {
+            usage: "graft diag <activity|local-history-dag|doctor|explain|stats|capture> ...",
+            nextSteps: ["Run `graft help` to see the available diagnostic subcommands."],
+        };
+    }
+    return {
+        nextSteps: ["Run `graft help` to see the available command groups."],
+    };
+}
+//# sourceMappingURL=cli-error.js.map

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

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

@@ -0,0 +1,17 @@
+import type { CliCommandName } from "../contracts/capabilities.js";
+export interface GlobalCliOptions {
+    cwd: string;
+    argv: string[];
+}
+export interface ParsedCommand {
+    command: CliCommandName;
+    json: boolean;
+    args: Record<string, unknown>;
+}
+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 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

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