@rryando/arcs 3.0.0

package/dist/utils/diagram-generator.js

@@ -0,0 +1,38 @@
+/**
+ * Generates a skeleton Mermaid .mmd diagram from plan tasks.
+ * Node IDs assigned T001+ sorted by priority (high→medium→low) then id.localeCompare.
+ * No dependency edges — skeleton only. Use manage-diagram.mjs regenerate to add edges.
+ */
+export function generateDiagramFromTasks(planId, tasks) {
+    const priorityOrder = { high: 0, medium: 1, low: 2 };
+    const sorted = [...tasks].sort((a, b) => (priorityOrder[a.priority] ?? 1) - (priorityOrder[b.priority] ?? 1) ||
+        a.id.localeCompare(b.id));
+    const nodes = sorted.map((t, i) => ({
+        nodeId: `T${String(i + 1).padStart(3, "0")}`,
+        taskId: t.id,
+        title: t.title,
+    }));
+    const statusLine = nodes.map((n, i) => `${n.nodeId}=${sorted[i].status}`).join(", ");
+    const lines = [
+        `%% plan: ${planId}`,
+        `%% status: ${statusLine}`,
+        `%% ready: (run: arcs diagram ready ${planId})`,
+        `%% next-action: Start first backlog task`,
+        "",
+    ];
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        const t = sorted[i];
+        lines.push(`%% node: ${node.nodeId}`, `%% title: ${t.title}`, `%% status: ${t.status}`, `%% skill: quick-dev`, `%% scope: (TBD)`, `%% acceptance: (TBD)`, `%% verify: npm test`, "");
+    }
+    lines.push("flowchart TD", "    classDef done fill:#22c55e,color:#fff", "    classDef inProgress fill:#f59e0b,color:#fff", "    classDef blocked fill:#ef4444,color:#fff", "    classDef backlog fill:#94a3b8,color:#fff", "");
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        const t = sorted[i];
+        const cls = t.status === "in_progress" ? "inProgress" : t.status === "cancelled" ? "backlog" : t.status;
+        lines.push(`    ${node.nodeId}["${t.title.replace(/"/g, "'")}"]:::${cls}`);
+    }
+    lines.push("");
+    return { mmd: `${lines.join("\n")}\n`, nodes };
+}
+//# sourceMappingURL=diagram-generator.js.map

package/dist/utils/diagram-generator.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Typed error helpers for consistent CLI command error responses.
+ */
+export declare class DagError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function projectNotFound(slug: string): DagError;
+export declare function projectAlreadyExists(slug: string): DagError;
+export declare function invalidDocType(doc: string): DagError;
+export declare function cycleDetected(fromSlug: string, toSlug: string): DagError;
+export declare function dependencyNotFound(ids: string[]): DagError;
+export declare function invalidPlanStatus(status: string): DagError;
+export declare function invalidTaskStatus(status: string): DagError;
+export declare function invalidTaskPriority(priority: string): DagError;
+export declare function invalidKnowledgeKind(kind: string): DagError;
+export declare function invalidKeyword(keyword: string): DagError;
+export declare function invalidFileRef(detail: string): DagError;
+export declare function normalizedIdCollision(kind: "plan" | "knowledge entry" | "task", requestedId: string, normalizedId: string): DagError;
+export declare function itemNotFound(kind: "plan" | "knowledge entry" | "task", id: string): DagError;
+export declare function planNotFound(slug: string, planId: string): DagError;
+export declare function invalidFileFormat(filePath: string, details: string): DagError;
+export declare function indexRebuildFailed(kind: "plans" | "knowledge", reason: string): DagError;
+export declare function noProjectMatch(workspacePath: string): DagError;
+export declare function ambiguousProjectMatch(workspacePath: string, slugs: string[]): DagError;
+export declare function invalidWorkspacePath(path: string): DagError;
+export declare function noWorkspacePaths(slug: string): DagError;
+/**
+ * Format a DagError into a CLI command error response.
+ * Delegates to the canonical `toolError` helper so all error responses
+ * share the same `[CODE] message` shape.
+ */
+export declare function formatError(err: DagError): {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError: true;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,qBAAa,QAAS,SAAQ,KAAK;aAEf,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;CAKlB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEtD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE3D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAKpD;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAKxE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,QAAQ,CAE1D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAE1D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAE9D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE3D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAExD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEvD;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,MAAM,EACzC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,QAAQ,CAKV;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,CAE5F;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAE7E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAExF;AAED,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,CAM9D;AAED,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,CAMtF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAK3D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAKvD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ;;;;;;EAExC"}

package/dist/utils/errors.js

@@ -0,0 +1,83 @@
+/**
+ * Typed error helpers for consistent CLI command error responses.
+ */
+import { toolError } from "./tool-response.js";
+export class DagError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "DagError";
+    }
+}
+export function projectNotFound(slug) {
+    return new DagError("PROJECT_NOT_FOUND", `Project "${slug}" does not exist.`);
+}
+export function projectAlreadyExists(slug) {
+    return new DagError("PROJECT_ALREADY_EXISTS", `Project "${slug}" already exists.`);
+}
+export function invalidDocType(doc) {
+    return new DagError("INVALID_DOC_TYPE", `Invalid document type "${doc}". Must be one of: overview, tasks, dependencies, knowledge.`);
+}
+export function cycleDetected(fromSlug, toSlug) {
+    return new DagError("CYCLE_DETECTED", `Adding dependency "${fromSlug}" → "${toSlug}" would create a cycle.`);
+}
+export function dependencyNotFound(ids) {
+    return new DagError("DEPENDENCY_NOT_FOUND", `Unknown dependency target(s): ${ids.join(", ")}`);
+}
+export function invalidPlanStatus(status) {
+    return new DagError("INVALID_PLAN_STATUS", `Invalid plan status "${status}".`);
+}
+export function invalidTaskStatus(status) {
+    return new DagError("INVALID_TASK_STATUS", `Invalid task status "${status}".`);
+}
+export function invalidTaskPriority(priority) {
+    return new DagError("INVALID_TASK_PRIORITY", `Invalid task priority "${priority}".`);
+}
+export function invalidKnowledgeKind(kind) {
+    return new DagError("INVALID_KNOWLEDGE_KIND", `Invalid knowledge kind "${kind}".`);
+}
+export function invalidKeyword(keyword) {
+    return new DagError("INVALID_KEYWORD", `Invalid keyword "${keyword}".`);
+}
+export function invalidFileRef(detail) {
+    return new DagError("INVALID_FILE_REF", `Invalid file reference: ${detail}`);
+}
+export function normalizedIdCollision(kind, requestedId, normalizedId) {
+    return new DagError("NORMALIZED_ID_COLLISION", `Cannot create ${kind} "${requestedId}" because normalized id "${normalizedId}" already exists.`);
+}
+export function itemNotFound(kind, id) {
+    return new DagError("ITEM_NOT_FOUND", `Could not find ${kind} "${id}".`);
+}
+export function planNotFound(slug, planId) {
+    return new DagError("PLAN_NOT_FOUND", `Plan "${planId}" does not exist in project "${slug}".`);
+}
+export function invalidFileFormat(filePath, details) {
+    return new DagError("INVALID_FILE_FORMAT", `Invalid file format in "${filePath}": ${details}`);
+}
+export function indexRebuildFailed(kind, reason) {
+    return new DagError("INDEX_REBUILD_FAILED", `Unable to rebuild ${kind} index: ${reason}`);
+}
+export function noProjectMatch(workspacePath) {
+    return new DagError("NO_PROJECT_MATCH", `No project found matching workspace path "${workspacePath}". ` +
+        `Register a workspace path using update_project_paths(slug, "add", [path]).`);
+}
+export function ambiguousProjectMatch(workspacePath, slugs) {
+    return new DagError("AMBIGUOUS_PROJECT_MATCH", `Multiple projects match workspace path "${workspacePath}" at the same depth: ${slugs.join(", ")}. ` +
+        `Use more specific workspace paths or remove duplicates with update_project_paths.`);
+}
+export function invalidWorkspacePath(path) {
+    return new DagError("INVALID_WORKSPACE_PATH", `Workspace path "${path}" is not absolute. Paths must start with "/".`);
+}
+export function noWorkspacePaths(slug) {
+    return new DagError("NO_WORKSPACE_PATHS", `No workspace paths registered for project "${slug}". Use update_project_paths to add paths first.`);
+}
+/**
+ * Format a DagError into a CLI command error response.
+ * Delegates to the canonical `toolError` helper so all error responses
+ * share the same `[CODE] message` shape.
+ */
+export function formatError(err) {
+    return toolError(err.code, err.message);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/file-lock.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Acquire an advisory lock on a file path.
+ * Returns a release function that must be called when done.
+ *
+ * @throws Error if lock cannot be acquired within timeout
+ */
+export declare function acquireLock(filePath: string): Promise<() => Promise<void>>;
+/**
+ * Execute a function while holding a lock on the given file path.
+ * The lock is released after the function returns (or throws).
+ */
+export declare function withLock<T>(filePath: string, fn: () => T | Promise<T>): Promise<T>;
+//# sourceMappingURL=file-lock.d.ts.map

package/dist/utils/file-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock.d.ts","sourceRoot":"","sources":["../../src/utils/file-lock.ts"],"names":[],"mappings":"AAkBA;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAmDhF;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOxF"}

package/dist/utils/file-lock.js

@@ -0,0 +1,80 @@
+/**
+ * Lightweight advisory file locking for concurrent write protection.
+ *
+ * Uses a .lock file alongside the target file. The lock file is created
+ * with O_EXCL (exclusive create) which is atomic on all platforms.
+ * Includes a stale lock timeout to prevent deadlocks from crashed processes.
+ */
+import { constants } from "node:fs";
+import { open, stat, unlink } from "node:fs/promises";
+const STALE_LOCK_MS = 10_000; // 10 seconds — locks older than this are considered stale
+const RETRY_INTERVAL_MS = 50;
+const MAX_RETRIES = 200; // 10 seconds total max wait
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Acquire an advisory lock on a file path.
+ * Returns a release function that must be called when done.
+ *
+ * @throws Error if lock cannot be acquired within timeout
+ */
+export async function acquireLock(filePath) {
+    const lockPath = `${filePath}.lock`;
+    for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+        try {
+            // O_CREAT | O_EXCL — atomic create, fails if exists
+            const handle = await open(lockPath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY);
+            await handle.close();
+            return async () => {
+                try {
+                    await unlink(lockPath);
+                }
+                catch {
+                    // Already removed — fine
+                }
+            };
+        }
+        catch (err) {
+            if (err &&
+                typeof err === "object" &&
+                "code" in err &&
+                err.code === "EEXIST") {
+                // Lock exists — check if stale
+                try {
+                    const lockStat = await stat(lockPath);
+                    if (Date.now() - lockStat.mtimeMs > STALE_LOCK_MS) {
+                        try {
+                            await unlink(lockPath);
+                        }
+                        catch {
+                            // Race with another cleaner — retry
+                        }
+                        continue; // Retry immediately after cleaning stale lock
+                    }
+                }
+                catch {
+                    // Lock gone, retry
+                }
+                await sleep(RETRY_INTERVAL_MS);
+                continue;
+            }
+            throw err; // Unexpected error
+        }
+    }
+    throw new Error(`Could not acquire lock on "${filePath}" after ${MAX_RETRIES * RETRY_INTERVAL_MS}ms`);
+}
+/**
+ * Execute a function while holding a lock on the given file path.
+ * The lock is released after the function returns (or throws).
+ */
+export async function withLock(filePath, fn) {
+    const release = await acquireLock(filePath);
+    try {
+        return await fn();
+    }
+    finally {
+        await release();
+    }
+}
+//# sourceMappingURL=file-lock.js.map

package/dist/utils/file-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock.js","sourceRoot":"","sources":["../../src/utils/file-lock.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,0DAA0D;AACxF,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,WAAW,GAAG,GAAG,CAAC,CAAC,4BAA4B;AAErD,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,QAAQ,GAAG,GAAG,QAAQ,OAAO,CAAC;IAEpC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,oDAAoD;YACpD,MAAM,MAAM,GAAG,MAAM,IAAI,CACvB,QAAQ,EACR,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,QAAQ,CAC1D,CAAC;YACF,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YAErB,OAAO,KAAK,IAAI,EAAE;gBAChB,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACzB,CAAC;gBAAC,MAAM,CAAC;oBACP,yBAAyB;gBAC3B,CAAC;YACH,CAAC,CAAC;QACJ,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IACE,GAAG;gBACH,OAAO,GAAG,KAAK,QAAQ;gBACvB,MAAM,IAAI,GAAG;gBACZ,GAAwB,CAAC,IAAI,KAAK,QAAQ,EAC3C,CAAC;gBACD,+BAA+B;gBAC/B,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACtC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,GAAG,aAAa,EAAE,CAAC;wBAClD,IAAI,CAAC;4BACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;wBACzB,CAAC;wBAAC,MAAM,CAAC;4BACP,oCAAoC;wBACtC,CAAC;wBACD,SAAS,CAAC,8CAA8C;oBAC1D,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,mBAAmB;gBACrB,CAAC;gBAED,MAAM,KAAK,CAAC,iBAAiB,CAAC,CAAC;gBAC/B,SAAS;YACX,CAAC;YACD,MAAM,GAAG,CAAC,CAAC,mBAAmB;QAChC,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,8BAA8B,QAAQ,WAAW,WAAW,GAAG,iBAAiB,IAAI,CACrF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,QAAgB,EAAE,EAAwB;IAC1E,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/utils/git.d.ts

@@ -0,0 +1,14 @@
+export interface GitLogEntry {
+    sha: string;
+    message: string;
+    date: string;
+    filesChanged: string[];
+}
+export declare function isGitRepo(cwd: string): boolean;
+export declare function getHeadCommit(cwd: string): string | null;
+export declare function getGitLog(cwd: string, options?: {
+    since?: string;
+    limit?: number;
+}): GitLogEntry[];
+export declare function getFilesChanged(cwd: string, fromCommit: string): string[];
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAcD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAExD;AAED,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,WAAW,EAAE,CAkCf;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAIzE"}

package/dist/utils/git.js

@@ -0,0 +1,56 @@
+import { execSync } from "node:child_process";
+function exec(cmd, cwd) {
+    try {
+        return execSync(cmd, {
+            encoding: "utf-8",
+            cwd,
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+export function isGitRepo(cwd) {
+    return exec("git rev-parse --is-inside-work-tree", cwd) === "true";
+}
+export function getHeadCommit(cwd) {
+    return exec("git rev-parse --short HEAD", cwd);
+}
+export function getGitLog(cwd, options) {
+    const limit = options?.limit ?? 50;
+    const since = options?.since;
+    let cmd = `git log --format=%H%n%s%n%aI -n ${limit}`;
+    if (since) {
+        // Try as ISO date first; if it looks like a SHA, use commit range
+        if (/^[a-f0-9]{4,40}$/.test(since)) {
+            cmd += ` ${since}..HEAD`;
+        }
+        else {
+            cmd += ` --since="${since}"`;
+        }
+    }
+    const output = exec(cmd, cwd);
+    if (!output)
+        return [];
+    const lines = output.split("\n");
+    const entries = [];
+    for (let i = 0; i + 2 < lines.length; i += 3) {
+        const fullSha = lines[i];
+        const message = lines[i + 1];
+        const date = lines[i + 2];
+        const shortSha = fullSha.slice(0, 7);
+        // Get files changed for this commit
+        const filesOutput = exec(`git diff-tree --no-commit-id --name-only -r ${fullSha}`, cwd);
+        const filesChanged = filesOutput ? filesOutput.split("\n").filter(Boolean) : [];
+        entries.push({ sha: shortSha, message, date, filesChanged });
+    }
+    return entries;
+}
+export function getFilesChanged(cwd, fromCommit) {
+    const output = exec(`git diff --name-only ${fromCommit} HEAD`, cwd);
+    if (!output)
+        return [];
+    return output.split("\n").filter(Boolean);
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAS9C,SAAS,IAAI,CAAC,GAAW,EAAE,GAAW;IACpC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,GAAG,EAAE;YACnB,QAAQ,EAAE,OAAO;YACjB,GAAG;YACH,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,IAAI,CAAC,qCAAqC,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,IAAI,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,GAAW,EACX,OAA4C;IAE5C,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;IAE7B,IAAI,GAAG,GAAG,mCAAmC,KAAK,EAAE,CAAC;IACrD,IAAI,KAAK,EAAE,CAAC;QACV,kEAAkE;QAClE,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,GAAG,IAAI,IAAI,KAAK,QAAQ,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,GAAG,IAAI,aAAa,KAAK,GAAG,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAErC,oCAAoC;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,+CAA+C,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;QACxF,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEhF,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,UAAkB;IAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,wBAAwB,UAAU,OAAO,EAAE,GAAG,CAAC,CAAC;IACpE,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/utils/graphify-knowledge.d.ts

@@ -0,0 +1,6 @@
+import type { KnowledgeProposal } from "./graphify.js";
+export declare function persistProposals(slug: string, proposals: KnowledgeProposal[]): Promise<{
+    created: number;
+    skipped: number;
+}>;
+//# sourceMappingURL=graphify-knowledge.d.ts.map

package/dist/utils/graphify-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphify-knowledge.d.ts","sourceRoot":"","sources":["../../src/utils/graphify-knowledge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAwCvD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,iBAAiB,EAAE,GAC7B,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAoD/C"}

package/dist/utils/graphify-knowledge.js

@@ -0,0 +1,60 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getProjectDir } from "./paths.js";
+function slugifyTitle(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+}
+async function readJsonSafe(filePath) {
+    try {
+        return JSON.parse(await readFile(filePath, "utf-8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeJson(filePath, data) {
+    await writeFile(filePath, JSON.stringify(data, null, 2), "utf-8");
+}
+export async function persistProposals(slug, proposals) {
+    const projectDir = getProjectDir(slug);
+    const knowledgeDir = join(projectDir, "knowledge");
+    await mkdir(knowledgeDir, { recursive: true });
+    const indexPath = join(knowledgeDir, "index.json");
+    const index = (await readJsonSafe(indexPath)) ?? { entries: [] };
+    const existingIds = new Set(index.entries.map((e) => e.id));
+    let created = 0;
+    let skipped = 0;
+    for (const proposal of proposals) {
+        const id = slugifyTitle(proposal.title);
+        if (existingIds.has(id)) {
+            skipped++;
+            continue;
+        }
+        const ts = new Date().toISOString();
+        const bodyFile = join("knowledge", `${id}.md`);
+        const meta = {
+            id,
+            normalizedId: id,
+            title: proposal.title,
+            kind: proposal.kind,
+            keywords: proposal.keywords,
+            summary: proposal.summary,
+            sourceFiles: proposal.sourceFiles,
+            file: bodyFile,
+            createdAt: ts,
+            updatedAt: ts,
+        };
+        await writeJson(join(knowledgeDir, `${id}.meta.json`), meta);
+        await writeFile(join(knowledgeDir, `${id}.md`), `# ${proposal.title}\n\n${proposal.summary}\n`, "utf-8");
+        index.entries.push(meta);
+        existingIds.add(id);
+        created++;
+    }
+    await writeJson(indexPath, index);
+    return { created, skipped };
+}
+//# sourceMappingURL=graphify-knowledge.js.map

package/dist/utils/graphify-knowledge.js.map

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

package/dist/utils/graphify.d.ts

@@ -0,0 +1,49 @@
+export interface GraphifyInfo {
+    available: boolean;
+    version?: string;
+    path?: string;
+}
+export declare function detectGraphify(): GraphifyInfo;
+export interface ExtractionResult {
+    success: true;
+    graphJsonPath: string;
+}
+export interface ExtractionError {
+    success: false;
+    error: string;
+    code?: string;
+}
+export type ExtractionOutcome = ExtractionResult | ExtractionError;
+export interface KnowledgeProposal {
+    title: string;
+    kind: "architecture" | "module" | "gotcha" | "pattern";
+    summary: string;
+    keywords: string[];
+    sourceFiles: Array<{
+        path: string;
+        anchor?: string;
+    }>;
+}
+export interface IngestionResult {
+    proposals: KnowledgeProposal[];
+    stats: {
+        godNodes: number;
+        communities: number;
+        crossModuleCouplings: number;
+        totalProposals: number;
+    };
+}
+export declare function ingestGraph(graphJsonPath: string, _slug: string): IngestionResult;
+export interface QueryResult {
+    success: true;
+    answer: string;
+}
+export interface QueryError {
+    success: false;
+    error: string;
+}
+export type QueryOutcome = QueryResult | QueryError;
+export declare function queryGraph(question: string, workspacePath: string): QueryOutcome;
+export declare function pathBetween(entityA: string, entityB: string, workspacePath: string): QueryOutcome;
+export declare function runExtraction(workspacePath: string): ExtractionOutcome;
+//# sourceMappingURL=graphify.d.ts.map

package/dist/utils/graphify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphify.d.ts","sourceRoot":"","sources":["../../src/utils/graphify.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,cAAc,IAAI,YAAY,CAyB7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,IAAI,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAInE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAsHD,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAwGjF;AAID,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,UAAU,CAAC;AAEpD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,CA0BhF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,CA0BjG;AAED,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,iBAAiB,CAsDtE"}