@flyingrobots/graft 0.6.1 → 0.7.0

package/dist/operations/structural-blame.js

@@ -0,0 +1,111 @@
+// ---------------------------------------------------------------------------
+// Structural Blame — symbol-level blame: who last changed a symbol's
+// signature, when it was created, and its full change history.
+// ---------------------------------------------------------------------------
+import { toJsonObject } from "./result-dto.js";
+// ---- Implementation -------------------------------------------------------
+export function structuralBlame(input) {
+    const { symbolName, filePath, commits, commitMeta, symbolMeta, referenceCount, referencingFiles } = input;
+    if (commits.length === 0) {
+        return {
+            symbol: symbolName,
+            filePath,
+            kind: symbolMeta?.kind ?? "unknown",
+            exported: symbolMeta?.exported ?? false,
+            changeCount: 0,
+            referenceCount,
+            referencingFiles,
+            history: [],
+        };
+    }
+    // Find creation commit (first "added" entry)
+    const creationCommit = commits.find((c) => c.changeKind === "added");
+    // Find all "changed" commits
+    const changedCommits = commits.filter((c) => c.changeKind === "changed");
+    // Build created info
+    let created;
+    if (creationCommit !== undefined) {
+        const meta = commitMeta.get(creationCommit.sha);
+        if (meta !== undefined) {
+            created = { sha: creationCommit.sha, author: meta.author, date: meta.date, message: meta.message };
+        }
+    }
+    // Sort all commits by date (most recent first)
+    const sortedDesc = [...commits].sort((a, b) => {
+        const dateA = commitMeta.get(a.sha)?.date ?? "";
+        const dateB = commitMeta.get(b.sha)?.date ?? "";
+        return dateB.localeCompare(dateA);
+    });
+    // Sort all commits by date (oldest first)
+    const sortedAsc = [...commits].sort((a, b) => {
+        const dateA = commitMeta.get(a.sha)?.date ?? "";
+        const dateB = commitMeta.get(b.sha)?.date ?? "";
+        return dateA.localeCompare(dateB);
+    });
+    // Find last signature change — most recent by date among "changed" commits
+    let lastSignatureChange;
+    if (changedCommits.length > 0) {
+        const sorted = [...changedCommits].sort((a, b) => {
+            const dateA = commitMeta.get(a.sha)?.date ?? "";
+            const dateB = commitMeta.get(b.sha)?.date ?? "";
+            return dateB.localeCompare(dateA);
+        });
+        const lastChanged = sorted[0];
+        if (lastChanged !== undefined) {
+            const meta = commitMeta.get(lastChanged.sha);
+            if (meta !== undefined) {
+                // Find the previous signature from the commit just before this one
+                const changeIdx = sortedAsc.findIndex((c) => c.sha === lastChanged.sha);
+                let previousSignature;
+                for (let i = changeIdx - 1; i >= 0; i--) {
+                    const prev = sortedAsc[i];
+                    if (prev?.signature !== undefined) {
+                        previousSignature = prev.signature;
+                        break;
+                    }
+                }
+                lastSignatureChange = {
+                    sha: lastChanged.sha,
+                    author: meta.author,
+                    date: meta.date,
+                    message: meta.message,
+                    previousSignature,
+                };
+            }
+        }
+    }
+    // Get current signature from the most recent commit
+    const mostRecent = sortedDesc[0];
+    const currentSignature = mostRecent?.signature;
+    // Build history entries with metadata (most recent first)
+    const historyEntries = sortedDesc.map((c) => {
+        const meta = commitMeta.get(c.sha);
+        return {
+            sha: c.sha,
+            changeKind: c.changeKind,
+            date: meta?.date ?? "",
+            author: meta?.author ?? "",
+            signature: c.signature,
+        };
+    });
+    return {
+        symbol: symbolName,
+        filePath,
+        currentSignature,
+        kind: symbolMeta?.kind ?? "unknown",
+        exported: symbolMeta?.exported ?? false,
+        created,
+        lastSignatureChange,
+        changeCount: commits.length,
+        referenceCount,
+        referencingFiles,
+        history: historyEntries,
+    };
+}
+/**
+ * Convert a StructuralBlameResult to a plain JsonObject for MCP responses.
+ */
+export function structuralBlameToJson(result) {
+    return toJsonObject(result);
+}
+//# sourceMappingURL=structural-blame.js.map

package/dist/operations/structural-blame.js.map

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

package/dist/operations/structural-review.d.ts

@@ -0,0 +1,47 @@
+import type { FileSystem } from "../ports/filesystem.js";
+import type { GitClient } from "../ports/git.js";
+export interface ReferenceCountResult {
+    readonly referenceCount: number;
+    readonly referencingFiles: readonly string[];
+}
+export type ReferenceCounter = (symbolName: string, filePath: string) => Promise<ReferenceCountResult>;
+export type ReviewCategory = "structural" | "formatting" | "test" | "docs" | "config";
+export interface ReviewFile {
+    readonly path: string;
+    readonly category: ReviewCategory;
+    readonly structuralChanges?: {
+        added: number;
+        removed: number;
+        changed: number;
+    };
+}
+export interface BreakingChange {
+    readonly symbol: string;
+    readonly kind: string;
+    readonly filePath: string;
+    readonly changeType: "removed_export" | "signature_changed" | "type_changed";
+    readonly previousSignature?: string;
+    readonly newSignature?: string;
+    readonly impactedFiles: number;
+    readonly impactedFilePaths: readonly string[];
+}
+export interface StructuralReviewResult {
+    readonly base: string;
+    readonly head: string;
+    readonly totalFiles: number;
+    readonly categories: Record<ReviewCategory, number>;
+    readonly files: readonly ReviewFile[];
+    readonly breakingChanges: readonly BreakingChange[];
+    readonly summary: string;
+}
+export interface StructuralReviewOptions {
+    readonly cwd: string;
+    readonly fs: FileSystem;
+    readonly git: GitClient;
+    readonly resolveWorkingTreePath: (filePath: string) => string;
+    readonly base?: string | undefined;
+    readonly head?: string | undefined;
+    readonly countReferences: ReferenceCounter;
+}
+export declare function structuralReview(opts: StructuralReviewOptions): Promise<StructuralReviewResult>;
+//# sourceMappingURL=structural-review.d.ts.map

package/dist/operations/structural-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-review.d.ts","sourceRoot":"","sources":["../../src/operations/structural-review.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAMjD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAGnC,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAClF;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,cAAc,CAAC;IAC7E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,sBAAsB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;CAC5C;AAmKD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CA4FjC"}

package/dist/operations/structural-review.js

@@ -0,0 +1,225 @@
+// ---------------------------------------------------------------------------
+// Structural Review — zero-noise PR review separating signal from formatting
+// ---------------------------------------------------------------------------
+import { graftDiff } from "./graft-diff.js";
+import { getChangedFilesWithStatus } from "../git/diff.js";
+// ---- File categorization --------------------------------------------------
+const CONFIG_PATTERNS = [
+    "package.json",
+    "tsconfig",
+    "eslint",
+    ".prettierrc",
+    ".editorconfig",
+    "vitest.config",
+    "jest.config",
+    "rollup.config",
+    "vite.config",
+    "webpack.config",
+    "babel.config",
+    ".babelrc",
+    ".npmrc",
+    ".nvmrc",
+    ".gitignore",
+    ".gitattributes",
+    "pnpm-lock.yaml",
+    "pnpm-workspace.yaml",
+    "yarn.lock",
+    "package-lock.json",
+    "Makefile",
+    "Dockerfile",
+    "docker-compose",
+];
+const TEST_PATTERNS = [
+    "/test/",
+    "/tests/",
+    "/__tests__/",
+    ".test.",
+    ".spec.",
+    "_test.",
+];
+function isTestFile(filePath) {
+    return TEST_PATTERNS.some((p) => filePath.includes(p));
+}
+function isDocsFile(filePath) {
+    return filePath.endsWith(".md") || filePath.endsWith(".txt") || filePath.endsWith(".rst");
+}
+function isConfigFile(filePath) {
+    const lower = filePath.toLowerCase();
+    return CONFIG_PATTERNS.some((p) => lower.includes(p));
+}
+// ---- Breaking change detection --------------------------------------------
+async function detectBreakingChanges(structuralFiles, countReferences) {
+    const breaking = [];
+    for (const file of structuralFiles) {
+        // Removed exports → breaking
+        for (const removed of file.diff.removed) {
+            if (removed.exported !== true)
+                continue;
+            const refs = await countReferences(removed.name, file.path);
+            breaking.push({
+                symbol: removed.name,
+                kind: removed.kind,
+                filePath: file.path,
+                changeType: "removed_export",
+                ...(removed.signature !== undefined ? { previousSignature: removed.signature } : {}),
+                impactedFiles: refs.referenceCount,
+                impactedFilePaths: refs.referencingFiles,
+            });
+        }
+        // Changed exported symbol signatures → potentially breaking
+        for (const changed of file.diff.changed) {
+            if (changed.exported !== true)
+                continue;
+            if (changed.oldSignature !== undefined && changed.signature !== undefined &&
+                changed.oldSignature !== changed.signature) {
+                const refs = await countReferences(changed.name, file.path);
+                breaking.push({
+                    symbol: changed.name,
+                    kind: changed.kind,
+                    filePath: file.path,
+                    changeType: "signature_changed",
+                    previousSignature: changed.oldSignature,
+                    newSignature: changed.signature,
+                    impactedFiles: refs.referenceCount,
+                    impactedFilePaths: refs.referencingFiles,
+                });
+            }
+        }
+    }
+    return breaking;
+}
+// ---- Summary rendering ----------------------------------------------------
+function renderSummary(base, head, categories, breakingChanges, totalFiles, structuralFiles) {
+    const parts = [];
+    parts.push(`PR Review: ${base}..${head} — ${String(totalFiles)} files changed`);
+    parts.push("");
+    // Structural details
+    if (categories.structural > 0) {
+        const totalAdded = structuralFiles.reduce((n, f) => n + f.diff.added.length, 0);
+        const totalChanged = structuralFiles.reduce((n, f) => n + f.diff.changed.length, 0);
+        const totalRemoved = structuralFiles.reduce((n, f) => n + f.diff.removed.length, 0);
+        const details = [];
+        if (totalAdded > 0)
+            details.push(`${String(totalAdded)} new exports`);
+        if (totalChanged > 0)
+            details.push(`${String(totalChanged)} sig changes`);
+        if (totalRemoved > 0)
+            details.push(`${String(totalRemoved)} removed`);
+        const suffix = details.length > 0 ? ` (${details.join(", ")})` : "";
+        parts.push(`  Structural: ${String(categories.structural)} files${suffix}`);
+    }
+    if (categories.formatting > 0) {
+        parts.push(`  Formatting: ${String(categories.formatting)} files`);
+    }
+    if (categories.test > 0) {
+        parts.push(`  Tests: ${String(categories.test)} files`);
+    }
+    if (categories.docs > 0) {
+        parts.push(`  Docs: ${String(categories.docs)} files`);
+    }
+    if (categories.config > 0) {
+        parts.push(`  Config: ${String(categories.config)} files`);
+    }
+    // Breaking changes
+    for (const bc of breakingChanges) {
+        parts.push("");
+        if (bc.changeType === "removed_export") {
+            parts.push(`  ⚠ BREAKING: ${bc.symbol} — removed export`);
+            if (bc.previousSignature !== undefined) {
+                parts.push(`    Was: ${bc.previousSignature}`);
+            }
+        }
+        else {
+            parts.push(`  ⚠ BREAKING: ${bc.symbol} — signature changed`);
+            if (bc.previousSignature !== undefined) {
+                parts.push(`    Was: ${bc.previousSignature}`);
+            }
+            if (bc.newSignature !== undefined) {
+                parts.push(`    Now: ${bc.newSignature}`);
+            }
+        }
+        parts.push(`    Impact: referenced by ${String(bc.impactedFiles)} files`);
+    }
+    return parts.join("\n");
+}
+// ---- Public API -----------------------------------------------------------
+export async function structuralReview(opts) {
+    const base = opts.base ?? "main";
+    const head = opts.head ?? "HEAD";
+    // 1. Get structural diff
+    const diffOpts = {
+        cwd: opts.cwd,
+        fs: opts.fs,
+        git: opts.git,
+        resolveWorkingTreePath: opts.resolveWorkingTreePath,
+        base,
+        head,
+    };
+    const structDiff = await graftDiff(diffOpts);
+    // 2. Get ALL changed files with rename detection
+    const allChangedEntries = await getChangedFilesWithStatus({
+        cwd: opts.cwd,
+        git: opts.git,
+        base,
+        head,
+    });
+    const allChangedPaths = allChangedEntries.map((e) => e.path);
+    // 3. Build set of structurally-changed file paths
+    const structuralPaths = new Set(structDiff.files.map((f) => f.path));
+    // 4. Categorize each changed file
+    const files = [];
+    for (const filePath of allChangedPaths) {
+        // Check if the file has actual structural (symbol-level) changes
+        const fileDiff = structuralPaths.has(filePath)
+            ? structDiff.files.find((f) => f.path === filePath)
+            : undefined;
+        const diff = fileDiff?.diff;
+        const hasStructuralChanges = diff !== undefined &&
+            (diff.added.length > 0 || diff.removed.length > 0 || diff.changed.length > 0);
+        if (hasStructuralChanges) {
+            files.push({
+                path: filePath,
+                category: "structural",
+                structuralChanges: { added: diff.added.length, removed: diff.removed.length, changed: diff.changed.length },
+            });
+        }
+        else if (isTestFile(filePath)) {
+            files.push({ path: filePath, category: "test" });
+        }
+        else if (isDocsFile(filePath)) {
+            files.push({ path: filePath, category: "docs" });
+        }
+        else if (isConfigFile(filePath)) {
+            files.push({ path: filePath, category: "config" });
+        }
+        else {
+            files.push({ path: filePath, category: "formatting" });
+        }
+    }
+    // 5. Count categories
+    const categories = {
+        structural: 0,
+        formatting: 0,
+        test: 0,
+        docs: 0,
+        config: 0,
+    };
+    for (const file of files) {
+        categories[file.category]++;
+    }
+    // 6. Detect breaking changes in structural files
+    const structuralFileDiffs = structDiff.files.filter((f) => f.diff.removed.length > 0 || f.diff.changed.length > 0);
+    const breakingChanges = await detectBreakingChanges(structuralFileDiffs, opts.countReferences);
+    // 7. Render summary
+    const summary = renderSummary(base, head, categories, breakingChanges, allChangedPaths.length, structDiff.files);
+    return {
+        base,
+        head,
+        totalFiles: allChangedPaths.length,
+        categories,
+        files,
+        breakingChanges,
+        summary,
+    };
+}
+//# sourceMappingURL=structural-review.js.map

package/dist/operations/structural-review.js.map

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

package/dist/operations/teaching-hints.d.ts

@@ -0,0 +1,18 @@
+/** Context about a projection decision for hint generation. */
+export interface ProjectionContext {
+    readonly projection: "content" | "outline" | "refused";
+    readonly reason: string;
+    readonly filePath: string;
+    readonly fileLines: number;
+    readonly fileBytes: number;
+    readonly readCount: number;
+    readonly changedSinceLastRead?: boolean;
+}
+/**
+ * Generate a teaching hint for a projection decision.
+ *
+ * Returns undefined when the decision was already optimal (no noise).
+ * Pure function — no I/O, no latency impact.
+ */
+export declare function generateTeachingHint(ctx: ProjectionContext): string | undefined;
+//# sourceMappingURL=teaching-hints.d.ts.map

package/dist/operations/teaching-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teaching-hints.d.ts","sourceRoot":"","sources":["../../src/operations/teaching-hints.ts"],"names":[],"mappings":"AAIA,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACzC;AAKD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CA2B/E"}

package/dist/operations/teaching-hints.js

@@ -0,0 +1,35 @@
+// ---------------------------------------------------------------------------
+// Teaching Hints — contextual guidance for suboptimal read decisions
+// ---------------------------------------------------------------------------
+const LARGE_FILE_THRESHOLD = 150;
+const BUILD_OUTPUT_DIRS = ["dist/", "build/", "out/", ".next/", "coverage/"];
+/**
+ * Generate a teaching hint for a projection decision.
+ *
+ * Returns undefined when the decision was already optimal (no noise).
+ * Pure function — no I/O, no latency impact.
+ */
+export function generateTeachingHint(ctx) {
+    // Refused — suggest the source location
+    if (ctx.projection === "refused") {
+        if (BUILD_OUTPUT_DIRS.some((dir) => ctx.filePath.startsWith(dir))) {
+            return `This build output was refused. Source lives in src/, not ${ctx.filePath.split("/")[0] ?? "dist"}/. Read the source instead.`;
+        }
+        return `This file was refused (${ctx.reason}). Check if the content you need lives elsewhere.`;
+    }
+    // Outline-projected — suggest file_outline + read_range
+    if (ctx.projection === "outline") {
+        return `This file was outline-projected (${ctx.reason}). Try file_outline first to see the jump table, then read_range for the specific symbol you need.`;
+    }
+    // Re-read of unchanged file
+    if (ctx.readCount > 1 && ctx.changedSinceLastRead === false) {
+        return `You already read this file ${String(ctx.readCount)} times and it hasn't changed. Use changed_since to check before re-reading.`;
+    }
+    // Large file that could benefit from outline-first
+    if (ctx.fileLines > LARGE_FILE_THRESHOLD) {
+        return `This file is ${String(ctx.fileLines)} lines. Consider file_outline first for orientation, then read_range for the specific section you need.`;
+    }
+    // Optimal decision — no hint needed
+    return undefined;
+}
+//# sourceMappingURL=teaching-hints.js.map

package/dist/operations/teaching-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teaching-hints.js","sourceRoot":"","sources":["../../src/operations/teaching-hints.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qEAAqE;AACrE,8EAA8E;AAa9E,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACjC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAsB;IACzD,wCAAwC;IACxC,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAClE,OAAO,4DAA4D,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,6BAA6B,CAAC;QACvI,CAAC;QACD,OAAO,0BAA0B,GAAG,CAAC,MAAM,mDAAmD,CAAC;IACjG,CAAC;IAED,wDAAwD;IACxD,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,oCAAoC,GAAG,CAAC,MAAM,oGAAoG,CAAC;IAC5J,CAAC;IAGD,4BAA4B;IAC5B,IAAI,GAAG,CAAC,SAAS,GAAG,CAAC,IAAI,GAAG,CAAC,oBAAoB,KAAK,KAAK,EAAE,CAAC;QAC5D,OAAO,8BAA8B,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,6EAA6E,CAAC;IAC1I,CAAC;IAED,mDAAmD;IACnD,IAAI,GAAG,CAAC,SAAS,GAAG,oBAAoB,EAAE,CAAC;QACzC,OAAO,gBAAgB,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,yGAAyG,CAAC;IACxJ,CAAC;IAED,oCAAoC;IACpC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/parser/diff.d.ts

@@ -29,6 +29,7 @@ export declare class DiffEntry {
     private readonly _brand;
     readonly name: string;
     readonly kind: OutlineEntry["kind"];
+    readonly exported?: boolean;
     readonly signature?: string;
     readonly oldSignature?: string;
     readonly childDiff?: OutlineDiff;
@@ -37,6 +38,7 @@ export declare class DiffEntry {
     constructor(opts: {
         name: string;
         kind: OutlineEntry["kind"];
+        exported?: boolean;
         signature?: string;
         oldSignature?: string;
         childDiff?: OutlineDiff;

package/dist/parser/diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/parser/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAC1C,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;AAChD,MAAM,MAAM,mBAAmB,GAC3B,0BAA0B,GAC1B,0BAA0B,CAAC;AAE/B,qBAAa,cAAc;IACzB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,IAAI,EAAE;QAChB,IAAI,EAAE,kBAAkB,CAAC;QACzB,UAAU,EAAE,wBAAwB,CAAC;QACrC,KAAK,EAAE,mBAAmB,CAAC;QAC3B,UAAU,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;CAcF;AAED,qBAAa,SAAS;IACpB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC;IACjC,qFAAqF;IACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,IAAI,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,WAAW,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;CAYF;AAED,qBAAa,WAAW;IACtB,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEpB,IAAI,EAAE;QAChB,KAAK,EAAE,SAAS,EAAE,CAAC;QACnB,OAAO,EAAE,SAAS,EAAE,CAAC;QACrB,OAAO,EAAE,SAAS,EAAE,CAAC;QACrB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;QAC9B,cAAc,EAAE,MAAM,CAAC;KACxB;CAWF;AA0HD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,SAAS,YAAY,EAAE,EACnC,UAAU,EAAE,SAAS,YAAY,EAAE,GAClC,WAAW,CAoFb"}
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/parser/diff.ts"],"names":[],"mappings":"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"}

package/dist/parser/diff.js

@@ -32,6 +32,7 @@ export class DiffEntry {
     _brand = "DiffEntry";
     name;
     kind;
+    exported;
     signature;
     oldSignature;
     childDiff;
@@ -43,6 +44,8 @@ export class DiffEntry {
         }
         this.name = opts.name.trim();
         this.kind = opts.kind;
+        if (opts.exported !== undefined)
+            this.exported = opts.exported;
         if (opts.signature !== undefined)
             this.signature = opts.signature;
         if (opts.oldSignature !== undefined)
@@ -198,6 +201,7 @@ export function diffOutlines(oldEntries, newEntries) {
             added.push(new DiffEntry({
                 name,
                 kind: newEntry.kind,
+                exported: newEntry.exported,
                 ...(newEntry.signature !== undefined ? { signature: newEntry.signature } : {}),
             }));
             addedEntries.push(newEntry);
@@ -209,6 +213,7 @@ export function diffOutlines(oldEntries, newEntries) {
                 changed.push(new DiffEntry({
                     name,
                     kind: newEntry.kind,
+                    exported: newEntry.exported,
                     oldSignature: entrySignature(oldEntry),
                     ...(newEntry.signature !== undefined ? { signature: newEntry.signature } : {}),
                 }));
@@ -221,6 +226,7 @@ export function diffOutlines(oldEntries, newEntries) {
                     const childDiff = diffOutlines(oldChildren, newChildren);
                     if (childDiff.added.length > 0 || childDiff.removed.length > 0 || childDiff.changed.length > 0) {
                         changed.push(new DiffEntry({
+                            exported: newEntry.exported,
                             name,
                             kind: newEntry.kind,
                             childDiff,
@@ -243,6 +249,7 @@ export function diffOutlines(oldEntries, newEntries) {
             removed.push(new DiffEntry({
                 name,
                 kind: oldEntry.kind,
+                exported: oldEntry.exported,
                 ...(oldEntry.signature !== undefined ? { signature: oldEntry.signature } : {}),
             }));
             removedEntries.push(oldEntry);

package/dist/parser/diff.js.map

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

package/dist/ports/paths.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Portable path operations. Core logic imports this port, not node:path.
+ * Node adapter implements it; tests can substitute a mock.
+ *
+ * All methods accept and return forward-slash paths. Normalization
+ * (collapsing `//`, resolving `..`, stripping trailing slashes) happens
+ * inside the adapter so callers never see raw platform paths.
+ */
+export interface PathOps {
+    /** Normalize a path: collapse `//`, resolve `..`, strip trailing `/`. */
+    normalize(p: string): string;
+    /** True when `filePath` is exactly `directory` or nested inside it. */
+    isWithin(filePath: string, directory: string): boolean;
+    /** Join path segments with forward slashes, normalized. */
+    join(...segments: string[]): string;
+}
+//# sourceMappingURL=paths.d.ts.map

package/dist/ports/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/ports/paths.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,yEAAyE;IACzE,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE7B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAEvD,2DAA2D;IAC3D,IAAI,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;CACrC"}

package/dist/ports/{warp.js → paths.js}

@@ -1,5 +1,5 @@
 // ---------------------------------------------------------------------------
-// WARP port — hexagonal boundary for graph reads and writes
+// PathOps port — hexagonal boundary for path operations
 // ---------------------------------------------------------------------------
 export {};
-//# sourceMappingURL=warp.js.map
+//# sourceMappingURL=paths.js.map

package/dist/ports/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/ports/paths.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E"}