@flyingrobots/graft 0.4.0 → 0.6.0

package/dist/mcp/tools/file-outline.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { fileOutline } from "../../operations/file-outline.js";
+import { detectStructuredFormat } from "../../parser/lang.js";
+import { hashContent } from "../cache.js";
+import { toJsonObject } from "../../operations/result-dto.js";
+export const fileOutlineTool = {
+    name: "file_outline",
+    description: "Structural skeleton of a file \u2014 function signatures, class shapes, " +
+        "exports. Includes a jump table mapping each symbol to its line range " +
+        "for targeted read_range follow-ups.",
+    schema: { path: z.string() },
+    policyCheck: true,
+    createHandler() {
+        return async (args, ctx) => {
+            const filePath = ctx.resolvePath(args["path"]);
+            ctx.recordFootprint({ paths: [filePath] });
+            // Check cache
+            let rawContent = null;
+            try {
+                rawContent = await ctx.fs.readFile(filePath, "utf-8");
+            }
+            catch {
+                // proceed to fileOutline for error handling
+            }
+            const outlineSupported = detectStructuredFormat(filePath) !== null;
+            if (rawContent !== null && outlineSupported) {
+                const cacheResult = ctx.cache.check(filePath, rawContent);
+                if (cacheResult.hit) {
+                    cacheResult.obs.touch();
+                    ctx.metrics.recordCacheHit(cacheResult.obs.actual.bytes);
+                    ctx.recordFootprint({
+                        symbols: cacheResult.obs.outline.map((e) => e.name),
+                    });
+                    return ctx.respond("file_outline", {
+                        path: filePath,
+                        outline: cacheResult.obs.outline,
+                        jumpTable: cacheResult.obs.jumpTable,
+                        cacheHit: true,
+                    });
+                }
+                // If stale, fall through to fresh parse (no diff for file_outline)
+            }
+            const result = await fileOutline(filePath, { fs: ctx.fs });
+            ctx.metrics.recordOutline();
+            ctx.recordFootprint({ symbols: result.outline.map((e) => e.name) });
+            // Record observation
+            if (rawContent !== null && outlineSupported && result.reason !== "UNSUPPORTED_LANGUAGE") {
+                ctx.cache.record(filePath, hashContent(rawContent), result.outline, result.jumpTable, { lines: rawContent.split("\n").length, bytes: Buffer.byteLength(rawContent) });
+            }
+            return ctx.respond("file_outline", toJsonObject(result));
+        };
+    },
+};
+//# sourceMappingURL=file-outline.js.map

package/dist/mcp/tools/file-outline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-outline.js","sourceRoot":"","sources":["../../../src/mcp/tools/file-outline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,0EAA0E;QAC1E,uEAAuE;QACvE,qCAAqC;IACvC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;IAC5B,WAAW,EAAE,IAAI;IACjB,aAAa;QACX,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACzB,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAW,CAAC,CAAC;YACzD,GAAG,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAE3C,cAAc;YACd,IAAI,UAAU,GAAkB,IAAI,CAAC;YACrC,IAAI,CAAC;gBACH,UAAU,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;YAC9C,CAAC;YAED,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;YAEnE,IAAI,UAAU,KAAK,IAAI,IAAI,gBAAgB,EAAE,CAAC;gBAC5C,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBAC1D,IAAI,WAAW,CAAC,GAAG,EAAE,CAAC;oBACpB,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;oBACxB,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACzD,GAAG,CAAC,eAAe,CAAC;wBAClB,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;qBACpD,CAAC,CAAC;oBACH,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE;wBACjC,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,OAAO;wBAChC,SAAS,EAAE,WAAW,CAAC,GAAG,CAAC,SAAS;wBACpC,QAAQ,EAAE,IAAI;qBACf,CAAC,CAAC;gBACL,CAAC;gBACD,mEAAmE;YACrE,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3D,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC5B,GAAG,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAEpE,qBAAqB;YACrB,IAAI,UAAU,KAAK,IAAI,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,KAAK,sBAAsB,EAAE,CAAC;gBACxF,GAAG,CAAC,KAAK,CAAC,MAAM,CACd,QAAQ,EACR,WAAW,CAAC,UAAU,CAAC,EACvB,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,SAAS,EAChB,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAC/E,CAAC;YACJ,CAAC;YAED,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/git-files.d.ts

@@ -0,0 +1,24 @@
+import type { GitClient } from "../../ports/git.js";
+type GitFileListMode = "tracked" | "project";
+export declare class GitFileQuery {
+    readonly cwd: string;
+    readonly dirPath: string;
+    readonly mode: GitFileListMode;
+    constructor(opts: {
+        cwd: string;
+        dirPath: string;
+        mode: GitFileListMode;
+    });
+    static tracked(cwd: string, dirPath: string): GitFileQuery;
+    static project(cwd: string, dirPath: string): GitFileQuery;
+    toArgs(): string[];
+}
+export declare class GitFileList {
+    readonly paths: readonly string[];
+    constructor(paths: readonly string[]);
+}
+export declare function listGitFiles(query: GitFileQuery, git: GitClient): Promise<GitFileList>;
+export declare function listTrackedFiles(dirPath: string, cwd: string, git: GitClient): Promise<string[]>;
+export declare function listProjectFiles(dirPath: string, cwd: string, git: GitClient): Promise<string[]>;
+export {};
+//# sourceMappingURL=git-files.d.ts.map

package/dist/mcp/tools/git-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-files.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/git-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,KAAK,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7C,qBAAa,YAAY;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;gBAEnB,IAAI,EAAE;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,eAAe,CAAC;KACvB;IAUD,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY;IAI1D,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY;IAI1D,MAAM,IAAI,MAAM,EAAE;CASnB;AAED,qBAAa,WAAW;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;gBAEtB,KAAK,EAAE,SAAS,MAAM,EAAE;CAIrC;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAa5F;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEtG;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEtG"}

package/dist/mcp/tools/git-files.js

@@ -0,0 +1,57 @@
+export class GitFileQuery {
+    cwd;
+    dirPath;
+    mode;
+    constructor(opts) {
+        if (opts.cwd.trim().length === 0) {
+            throw new Error("GitFileQuery: cwd must be non-empty");
+        }
+        this.cwd = opts.cwd;
+        this.dirPath = opts.dirPath.trim();
+        this.mode = opts.mode;
+        Object.freeze(this);
+    }
+    static tracked(cwd, dirPath) {
+        return new GitFileQuery({ cwd, dirPath, mode: "tracked" });
+    }
+    static project(cwd, dirPath) {
+        return new GitFileQuery({ cwd, dirPath, mode: "project" });
+    }
+    toArgs() {
+        if (this.mode === "tracked") {
+            return this.dirPath.length > 0 ? ["ls-files", "--", this.dirPath] : ["ls-files"];
+        }
+        return this.dirPath.length > 0
+            ? ["ls-files", "--cached", "--others", "--exclude-standard", "--", this.dirPath]
+            : ["ls-files", "--cached", "--others", "--exclude-standard"];
+    }
+}
+export class GitFileList {
+    paths;
+    constructor(paths) {
+        this.paths = Object.freeze([...paths]);
+        Object.freeze(this);
+    }
+}
+export async function listGitFiles(query, git) {
+    try {
+        const result = await git.run({ args: query.toArgs(), cwd: query.cwd });
+        if (result.error !== undefined || result.status !== 0) {
+            throw result.error ?? new Error(result.stderr.trim() || `git exited with status ${String(result.status)}`);
+        }
+        const output = result.stdout.trim();
+        const paths = output.length === 0 ? [] : output.split("\n");
+        return new GitFileList(paths);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`git file listing failed: ${message}`, { cause: err });
+    }
+}
+export async function listTrackedFiles(dirPath, cwd, git) {
+    return [...(await listGitFiles(GitFileQuery.tracked(cwd, dirPath), git)).paths];
+}
+export async function listProjectFiles(dirPath, cwd, git) {
+    return [...(await listGitFiles(GitFileQuery.project(cwd, dirPath), git)).paths];
+}
+//# sourceMappingURL=git-files.js.map

package/dist/mcp/tools/git-files.js.map

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

package/dist/mcp/tools/graft-diff.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../context.js";
+export declare const graftDiffTool: ToolDefinition;
+//# sourceMappingURL=graft-diff.d.ts.map

package/dist/mcp/tools/graft-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graft-diff.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/graft-diff.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAC;AAGjE,eAAO,MAAM,aAAa,EAAE,cA6B3B,CAAC"}

package/dist/mcp/tools/graft-diff.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { graftDiff } from "../../operations/graft-diff.js";
+import { evaluateMcpRefusal } from "../policy.js";
+export const graftDiffTool = {
+    name: "graft_diff",
+    description: "Structural diff between two git refs. Shows added, removed, and " +
+        "changed symbols per file \u2014 not line hunks. Defaults to working " +
+        "tree vs HEAD.",
+    schema: { base: z.string().optional(), head: z.string().optional(), path: z.string().optional() },
+    createHandler() {
+        return async (args, ctx) => {
+            const head = args["head"];
+            const result = await graftDiff({
+                cwd: ctx.projectRoot,
+                fs: ctx.fs,
+                git: ctx.git,
+                resolveWorkingTreePath: (filePath) => ctx.resolvePath(filePath),
+                base: args["base"],
+                head,
+                path: args["path"],
+                refusalCheck: (filePath, actual) => evaluateMcpRefusal(ctx, filePath, actual),
+            });
+            ctx.recordFootprint({
+                paths: result.files.map((f) => f.path),
+            });
+            return ctx.respond("graft_diff", {
+                ...result,
+                layer: head === undefined ? "workspace_overlay" : "ref_view",
+            });
+        };
+    },
+};
+//# sourceMappingURL=graft-diff.js.map

package/dist/mcp/tools/graft-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graft-diff.js","sourceRoot":"","sources":["../../../src/mcp/tools/graft-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,kEAAkE;QAClE,sEAAsE;QACtE,eAAe;IACjB,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;IACjG,aAAa;QACX,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAuB,CAAC;YAChD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC;gBAC7B,GAAG,EAAE,GAAG,CAAC,WAAW;gBACpB,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,sBAAsB,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC;gBAC/D,IAAI,EAAE,IAAI,CAAC,MAAM,CAAuB;gBACxC,IAAI;gBACJ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAuB;gBACxC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC;aAC9E,CAAC,CAAC;YACH,GAAG,CAAC,eAAe,CAAC;gBAClB,KAAK,EAAG,MAAM,CAAC,KAAqC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aACxE,CAAC,CAAC;YACH,OAAO,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE;gBAC/B,GAAG,MAAM;gBACT,KAAK,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,UAAU;aAC7D,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/tools/map-collector.d.ts

@@ -0,0 +1,85 @@
+import type { FileSystem } from "../../ports/filesystem.js";
+import type { GitClient } from "../../ports/git.js";
+import { GitFileQuery } from "./git-files.js";
+import type { McpPolicyRefusal } from "../policy.js";
+export declare class StructuralMapRequest {
+    readonly directory: string;
+    readonly depth: number | null;
+    readonly summary: boolean;
+    constructor(args: Record<string, unknown>, projectRoot: string);
+    toGitFileQuery(projectRoot: string): GitFileQuery;
+}
+export declare class StructuralMapSymbol {
+    readonly name: string;
+    readonly kind: string;
+    readonly signature?: string;
+    readonly exported: boolean;
+    readonly startLine?: number;
+    readonly endLine?: number;
+    constructor(opts: {
+        name: string;
+        kind: string;
+        signature?: string;
+        exported: boolean;
+        startLine?: number;
+        endLine?: number;
+    });
+}
+export declare class StructuralMapFile {
+    readonly path: string;
+    readonly lang: string;
+    readonly symbolCount: number;
+    readonly summaryOnly: boolean;
+    readonly symbols?: readonly StructuralMapSymbol[];
+    constructor(opts: {
+        path: string;
+        lang: string;
+        symbolCount: number;
+        summaryOnly: boolean;
+        symbols?: readonly StructuralMapSymbol[];
+    });
+}
+export declare class StructuralMapDirectory {
+    readonly path: string;
+    readonly fileCount: number;
+    readonly symbolCount: number;
+    readonly childDirectoryCount: number;
+    readonly summaryOnly: true;
+    constructor(opts: {
+        path: string;
+        fileCount: number;
+        symbolCount: number;
+        childDirectoryCount: number;
+    });
+}
+export declare class StructuralMapMode {
+    readonly depth: number | null;
+    readonly summary: boolean;
+    constructor(opts: {
+        depth: number | null;
+        summary: boolean;
+    });
+}
+export declare function buildSummary(opts: {
+    returnedFileCount: number;
+    totalSymbolCount: number;
+    summarizedDirectoryCount: number;
+    depth: number | null;
+    summary: boolean;
+}): string;
+export interface StructuralMapCollectionResult {
+    readonly files: StructuralMapFile[];
+    readonly directories: StructuralMapDirectory[];
+    readonly refused: McpPolicyRefusal[];
+    readonly totalSymbols: number;
+}
+export declare function collectStructuralMap(request: StructuralMapRequest, opts: {
+    readonly projectRoot: string;
+    readonly fs: FileSystem;
+    readonly git: GitClient;
+    readonly refusalCheck: (filePath: string, actual: {
+        lines: number;
+        bytes: number;
+    }) => McpPolicyRefusal | null;
+}): Promise<StructuralMapCollectionResult>;
+//# sourceMappingURL=map-collector.d.ts.map

package/dist/mcp/tools/map-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-collector.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/map-collector.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools/map-collector.js

@@ -0,0 +1,249 @@
+// ---------------------------------------------------------------------------
+// Structural map collector — models and collection logic for graft_map
+// ---------------------------------------------------------------------------
+import * as path from "node:path";
+import { extractOutline } from "../../parser/outline.js";
+import { detectLang } from "../../parser/lang.js";
+import { GitFileQuery, listGitFiles } from "./git-files.js";
+import { collectSymbols, normalizeRepoPath } from "./precision.js";
+// ---------------------------------------------------------------------------
+// Request model
+// ---------------------------------------------------------------------------
+export class StructuralMapRequest {
+    directory;
+    depth;
+    summary;
+    constructor(args, projectRoot) {
+        const rawPath = args["path"];
+        const rawDepth = args["depth"];
+        const rawSummary = args["summary"];
+        if (rawPath !== undefined && typeof rawPath !== "string") {
+            throw new Error("StructuralMapRequest: path must be a string when provided");
+        }
+        let depth = null;
+        if (rawDepth !== undefined) {
+            if (typeof rawDepth !== "number" || !Number.isInteger(rawDepth) || rawDepth < 0) {
+                throw new Error("StructuralMapRequest: depth must be a non-negative integer when provided");
+            }
+            depth = rawDepth;
+        }
+        if (rawSummary !== undefined && typeof rawSummary !== "boolean") {
+            throw new Error("StructuralMapRequest: summary must be a boolean when provided");
+        }
+        this.directory = rawPath !== undefined && rawPath.trim().length > 0
+            ? normalizeRepoPath(projectRoot, rawPath)
+            : ".";
+        this.depth = depth;
+        this.summary = rawSummary === true;
+        Object.freeze(this);
+    }
+    toGitFileQuery(projectRoot) {
+        return GitFileQuery.project(projectRoot, this.directory === "." ? "" : this.directory);
+    }
+}
+// ---------------------------------------------------------------------------
+// Result models
+// ---------------------------------------------------------------------------
+export class StructuralMapSymbol {
+    name;
+    kind;
+    signature;
+    exported;
+    startLine;
+    endLine;
+    constructor(opts) {
+        this.name = opts.name;
+        this.kind = opts.kind;
+        this.exported = opts.exported;
+        if (opts.signature !== undefined)
+            this.signature = opts.signature;
+        if (opts.startLine !== undefined)
+            this.startLine = opts.startLine;
+        if (opts.endLine !== undefined)
+            this.endLine = opts.endLine;
+        Object.freeze(this);
+    }
+}
+export class StructuralMapFile {
+    path;
+    lang;
+    symbolCount;
+    summaryOnly;
+    symbols;
+    constructor(opts) {
+        this.path = opts.path;
+        this.lang = opts.lang;
+        this.symbolCount = opts.symbolCount;
+        this.summaryOnly = opts.summaryOnly;
+        if (opts.symbols !== undefined) {
+            this.symbols = Object.freeze([...opts.symbols]);
+        }
+        Object.freeze(this);
+    }
+}
+export class StructuralMapDirectory {
+    path;
+    fileCount;
+    symbolCount;
+    childDirectoryCount;
+    summaryOnly;
+    constructor(opts) {
+        this.path = opts.path;
+        this.fileCount = opts.fileCount;
+        this.symbolCount = opts.symbolCount;
+        this.childDirectoryCount = opts.childDirectoryCount;
+        this.summaryOnly = true;
+        Object.freeze(this);
+    }
+}
+export class StructuralMapMode {
+    depth;
+    summary;
+    constructor(opts) {
+        this.depth = opts.depth;
+        this.summary = opts.summary;
+        Object.freeze(this);
+    }
+}
+// ---------------------------------------------------------------------------
+// Directory accumulation
+// ---------------------------------------------------------------------------
+class StructuralMapDirectoryAccumulator {
+    fileCount = 0;
+    symbolCount = 0;
+    childDirectories = new Set();
+    add(symbolCount, childDirectory) {
+        this.fileCount += 1;
+        this.symbolCount += symbolCount;
+        if (childDirectory !== null) {
+            this.childDirectories.add(childDirectory);
+        }
+    }
+    toDirectory(pathname) {
+        return new StructuralMapDirectory({
+            path: pathname,
+            fileCount: this.fileCount,
+            symbolCount: this.symbolCount,
+            childDirectoryCount: this.childDirectories.size,
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function relativeDirectorySegments(scopeDir, filePath) {
+    const relativeFilePath = scopeDir === "." ? filePath : path.posix.relative(scopeDir, filePath);
+    const relativeDirPath = path.posix.dirname(relativeFilePath);
+    return relativeDirPath === "." ? [] : relativeDirPath.split("/").filter((segment) => segment.length > 0);
+}
+function summarizedDirectoryPath(scopeDir, filePath, depth) {
+    if (depth === null)
+        return null;
+    const segments = relativeDirectorySegments(scopeDir, filePath);
+    if (segments.length <= depth)
+        return null;
+    const summarySegments = segments.slice(0, depth + 1);
+    return scopeDir === "." ? summarySegments.join("/") : path.posix.join(scopeDir, ...summarySegments);
+}
+function summarizedChildDirectory(scopeDir, filePath, depth) {
+    const segments = relativeDirectorySegments(scopeDir, filePath);
+    if (segments.length <= depth + 1)
+        return null;
+    return segments[depth + 1] ?? null;
+}
+function getOrCreateDirectoryAccumulator(accumulators, pathname) {
+    const existing = accumulators.get(pathname);
+    if (existing !== undefined)
+        return existing;
+    const created = new StructuralMapDirectoryAccumulator();
+    accumulators.set(pathname, created);
+    return created;
+}
+function buildStructuralMapFile(opts) {
+    return new StructuralMapFile({
+        path: opts.path,
+        lang: opts.lang,
+        symbolCount: opts.symbols.length,
+        summaryOnly: opts.summaryOnly,
+        ...(opts.summaryOnly ? {} : { symbols: opts.symbols }),
+    });
+}
+function sortByPath(entries) {
+    return [...entries].sort((a, b) => a.path.localeCompare(b.path));
+}
+export function buildSummary(opts) {
+    if (opts.depth === null && !opts.summary && opts.summarizedDirectoryCount === 0) {
+        return `${String(opts.returnedFileCount)} files, ${String(opts.totalSymbolCount)} symbols`;
+    }
+    const parts = [
+        `${String(opts.returnedFileCount)} files returned`,
+        `${String(opts.totalSymbolCount)} total symbols`,
+    ];
+    if (opts.summarizedDirectoryCount > 0) {
+        parts.push(`${String(opts.summarizedDirectoryCount)} summarized directories`);
+    }
+    if (opts.depth !== null) {
+        parts.push(`depth=${String(opts.depth)}`);
+    }
+    if (opts.summary) {
+        parts.push("summary mode");
+    }
+    return parts.join(", ");
+}
+export async function collectStructuralMap(request, opts) {
+    const filePaths = (await listGitFiles(request.toGitFileQuery(opts.projectRoot), opts.git)).paths;
+    const files = [];
+    const directories = new Map();
+    const refused = [];
+    let totalSymbols = 0;
+    for (const filePath of filePaths) {
+        let content;
+        try {
+            content = await opts.fs.readFile(path.join(opts.projectRoot, filePath), "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const actual = {
+            lines: content.split("\n").length,
+            bytes: Buffer.byteLength(content),
+        };
+        const refusal = opts.refusalCheck(filePath, actual);
+        if (refusal !== null) {
+            refused.push(refusal);
+            continue;
+        }
+        const lang = detectLang(filePath);
+        if (lang === null)
+            continue;
+        const result = extractOutline(content, lang);
+        const symbols = collectSymbols(result.entries, filePath, result.jumpTable ?? []).map((symbol) => new StructuralMapSymbol({
+            name: symbol.name,
+            kind: symbol.kind,
+            exported: symbol.exported,
+            ...(symbol.signature !== undefined ? { signature: symbol.signature } : {}),
+            ...(symbol.startLine !== undefined ? { startLine: symbol.startLine } : {}),
+            ...(symbol.endLine !== undefined ? { endLine: symbol.endLine } : {}),
+        }));
+        totalSymbols += symbols.length;
+        const clippedDirectoryPath = summarizedDirectoryPath(request.directory, filePath, request.depth);
+        if (clippedDirectoryPath !== null && request.depth !== null) {
+            const accumulator = getOrCreateDirectoryAccumulator(directories, clippedDirectoryPath);
+            accumulator.add(symbols.length, summarizedChildDirectory(request.directory, filePath, request.depth));
+            continue;
+        }
+        files.push(buildStructuralMapFile({
+            path: filePath,
+            lang,
+            symbols,
+            summaryOnly: request.summary,
+        }));
+    }
+    return {
+        files: sortByPath(files),
+        directories: sortByPath([...directories.entries()].map(([pathname, accumulator]) => accumulator.toDirectory(pathname))),
+        refused,
+        totalSymbols,
+    };
+}
+//# sourceMappingURL=map-collector.js.map

package/dist/mcp/tools/map-collector.js.map

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

package/dist/mcp/tools/map.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from "../context.js";
+/** Maximum files before auto-truncation to summary-only mode. */
+export declare const MAX_MAP_FILES = 100;
+/** Maximum response bytes before auto-truncation to summary-only mode. */
+export declare const MAX_MAP_BYTES = 50000;
+export declare const mapTool: ToolDefinition;
+//# sourceMappingURL=map.d.ts.map

package/dist/mcp/tools/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/map.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,eAAe,CAAC;AAKjE,iEAAiE;AACjE,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,0EAA0E;AAC1E,eAAO,MAAM,aAAa,QAAS,CAAC;AAgEpC,eAAO,MAAM,OAAO,EAAE,cA2GrB,CAAC"}