ai-spector 0.3.0 → 0.3.2

package/dist/commands/init.js

@@ -1,17 +1,32 @@
-import { mkdir, writeFile } from "node:fs/promises";
+import { mkdir, readdir, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
-import { packageBundleRoot, scaffoldBundleRoot } from "../config/load.js";
+import { packageBundleRoot, scaffoldBundleRoot, scaffoldCursorBundleRoot, } from "../config/load.js";
 import { copyTree, pathExists, writeJson } from "../util/fs.js";
 import { ensureGraphifyMcpConfig } from "../util/mcp.js";
 import { ensureAiSpectorGitignore } from "../util/gitignore.js";
+/** Copy bundled `scaffold/cursor/` → project `.cursor/`. */
+export async function copyCursorToProject(projectRoot) {
+    await copyTree(scaffoldCursorBundleRoot(), join(projectRoot, ".cursor"));
+}
+/** Copy scaffold into project; `scaffold/cursor/` → `.cursor/` at project root. */
+export async function copyScaffoldToProject(projectRoot) {
+    const scaffold = scaffoldBundleRoot();
+    const entries = await readdir(scaffold, { withFileTypes: true });
+    for (const ent of entries) {
+        if (ent.name === "cursor") {
+            continue;
+        }
+        await copyTree(join(scaffold, ent.name), join(projectRoot, ent.name));
+    }
+    await copyCursorToProject(projectRoot);
+}
 export async function runInit(opts) {
     const root = resolve(opts.targetDir);
     const marker = join(root, ".ai-spector", "docflow.config.json");
     if (await pathExists(marker) && !opts.force) {
         throw new Error(`Project already initialized (${marker}). Use --force to overwrite scaffold files.`);
     }
-    const scaffold = scaffoldBundleRoot();
-    await copyTree(scaffold, root);
+    await copyScaffoldToProject(root);
     const projectTemplates = join(root, ".ai-spector", "templates");
     await mkdir(projectTemplates, { recursive: true });
     await copyTree(join(packageBundleRoot(), "templates"), projectTemplates);
@@ -47,13 +62,15 @@ export async function runInit(opts) {
     console.log(`  MCP       → ${mcpPath} (Graphify server added/updated)`);
     console.log(`  gitignore → ${gitignorePath} (ai-spector block added/updated)`);
     console.log(`  templates → ${projectTemplates} (SRS / basic / detail design)`);
+    console.log(`  cursor    → ${join(root, ".cursor")} (from scaffold/cursor/)`);
     console.log("");
     console.log("Next steps (Cursor):");
     console.log("  1. Open this folder in Cursor");
     console.log("  2. Reload MCP (Settings → MCP) or restart Cursor — needs uv + graphifyy");
-    console.log("  3. Enable the ai-spector skill (.cursor/skills/ai-spector/)");
+    console.log("  3. Enable ai-spector skills (.cursor/skills/ — see _skill-router.md)");
     console.log("  4. Add files under docs/data-source/");
     console.log("  5. Run /analyze  →  /validate-graph  →  /generate-srs");
+    console.log("     Or ask in chat: \"analyze data source\", \"generate SRS\", \"resolve comments\"");
     console.log("");
     console.log("See .cursor/commands/_workflow.md — you do not need other CLI commands.");
 }

package/dist/commands/init.js.map

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

package/dist/commands/sync-cursor.d.ts

@@ -0,0 +1,6 @@
+export interface SyncCursorOptions {
+    targetDir: string;
+}
+/** Refresh `.cursor/` commands and skills from bundled `scaffold/cursor/`. */
+export declare function runSyncCursor(opts: SyncCursorOptions): Promise<void>;
+//# sourceMappingURL=sync-cursor.d.ts.map

package/dist/commands/sync-cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-cursor.d.ts","sourceRoot":"","sources":["../../src/commands/sync-cursor.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,8EAA8E;AAC9E,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe1E"}

package/dist/commands/sync-cursor.js

@@ -0,0 +1,18 @@
+import { join, resolve } from "node:path";
+import { scaffoldCursorBundleRoot } from "../config/load.js";
+import { pathExists } from "../util/fs.js";
+import { copyCursorToProject } from "./init.js";
+/** Refresh `.cursor/` commands and skills from bundled `scaffold/cursor/`. */
+export async function runSyncCursor(opts) {
+    const root = resolve(opts.targetDir);
+    const marker = join(root, ".ai-spector", "docflow.config.json");
+    if (!(await pathExists(marker))) {
+        throw new Error(`Project not initialized (${marker}). Run: ai-spector init`);
+    }
+    await copyCursorToProject(root);
+    console.log(`Synced Cursor bundle at ${join(root, ".cursor")}`);
+    console.log(`  source → ${scaffoldCursorBundleRoot()}`);
+    console.log("");
+    console.log("Reload Cursor skills if needed; slash commands update on next use.");
+}
+//# sourceMappingURL=sync-cursor.js.map

package/dist/commands/sync-cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-cursor.js","sourceRoot":"","sources":["../../src/commands/sync-cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAMhD,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAuB;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,qBAAqB,CAAC,CAAC;IAChE,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,4BAA4B,MAAM,yBAAyB,CAC5D,CAAC;IACJ,CAAC;IAED,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAEhC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,cAAc,wBAAwB,EAAE,EAAE,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC;AACpF,CAAC"}

package/dist/comments/anchor.d.ts

@@ -0,0 +1,16 @@
+export interface DocAnchorContext {
+    docPath: string;
+    startLine: number;
+    endLine: number;
+    /** 1-based line range text from the document */
+    anchoredText: string;
+    /** Nearest markdown heading at or above startLine */
+    heading?: string;
+    /** Section anchor comment at or above startLine */
+    sectionAnchor?: string;
+    /** Total lines in document */
+    lineCount: number;
+}
+export declare function readDocAnchorContext(projectRoot: string, logicalPath: string, startLine: number, endLine: number): Promise<DocAnchorContext | null>;
+export declare function previewCommentBody(body: string, maxLen?: number): string;
+//# sourceMappingURL=anchor.d.ts.map

package/dist/comments/anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../src/comments/anchor.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA+ClC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CAMrE"}

package/dist/comments/anchor.js

@@ -0,0 +1,59 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { pathExists } from "../util/fs.js";
+import { logicalPathToDocPath } from "./paths.js";
+const SECTION_ANCHOR_RE = /<!--\s*section:\s*([^\s>]+)\s*-->/;
+const HEADING_RE = /^(#{1,6})\s+(.+)$/;
+export async function readDocAnchorContext(projectRoot, logicalPath, startLine, endLine) {
+    const docPath = logicalPathToDocPath(logicalPath);
+    if (!docPath) {
+        return null;
+    }
+    const abs = join(projectRoot, docPath);
+    if (!(await pathExists(abs))) {
+        return null;
+    }
+    const raw = await readFile(abs, "utf8");
+    const lines = raw.split("\n");
+    const start = Math.max(1, startLine);
+    const end = Math.min(lines.length, Math.max(endLine, startLine));
+    const slice = lines.slice(start - 1, end);
+    const anchoredText = slice.join("\n");
+    let heading;
+    let sectionAnchor;
+    for (let i = start - 1; i >= 0; i--) {
+        const line = lines[i] ?? "";
+        if (!sectionAnchor) {
+            const anchorMatch = line.match(SECTION_ANCHOR_RE);
+            if (anchorMatch) {
+                sectionAnchor = anchorMatch[1];
+            }
+        }
+        if (!heading) {
+            const h = line.match(HEADING_RE);
+            if (h) {
+                heading = h[2].trim();
+            }
+        }
+        if (heading && sectionAnchor) {
+            break;
+        }
+    }
+    return {
+        docPath,
+        startLine: start,
+        endLine: end,
+        anchoredText,
+        heading,
+        sectionAnchor,
+        lineCount: lines.length,
+    };
+}
+export function previewCommentBody(body, maxLen = 120) {
+    const oneLine = body.replace(/\s+/g, " ").trim();
+    if (oneLine.length <= maxLen) {
+        return oneLine;
+    }
+    return `${oneLine.slice(0, maxLen - 1)}…`;
+}
+//# sourceMappingURL=anchor.js.map

package/dist/comments/anchor.js.map

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

package/dist/comments/inbox.d.ts

@@ -0,0 +1,83 @@
+import type { ImpactResult } from "../graph/impact.js";
+import type { ThreadSummary } from "./types.js";
+export interface CommentInboxItem {
+    /** Short id for chat selection, e.g. C-001 */
+    pickId: string;
+    threadId: string;
+    filePath: string;
+    docPath: string | null;
+    status: string;
+    language: string;
+    lines: string;
+    startLine: number;
+    endLine: number;
+    excerpt?: string;
+    /** First comment in thread (reviewer ask) */
+    preview: string;
+    replyCount: number;
+    originBranch: string;
+    version: number;
+}
+export interface CommentInbox {
+    inbox: CommentInboxItem[];
+    count: number;
+    openCount: number;
+    prompt: string;
+    /** Pre-rendered pick list for IDE chat — agent should show this, not raw JSON or thread uuids */
+    idePresentation: {
+        mode: "thread_pick_list";
+        markdown: string;
+        rules: string[];
+    };
+}
+export declare function buildCommentInbox(threads: ThreadSummary[]): CommentInbox;
+export declare function enrichInboxPreviews(inbox: CommentInbox, firstComments: Map<string, string>): CommentInbox;
+export declare function formatInboxForChat(inbox: CommentInbox): string;
+export interface ImpactSummary {
+    regenerate: number;
+    review: number;
+    downstream: number;
+    originId?: string;
+    originType?: string;
+    topRegenerate: Array<{
+        id: string;
+        projectionPath?: string;
+    }>;
+    topReview: Array<{
+        id: string;
+        projectionPath?: string;
+    }>;
+}
+export declare function summarizeImpact(impact: ImpactResult | null): ImpactSummary | null;
+export interface CommentResolvePlan {
+    pickId?: string;
+    thread: import("./types.js").ThreadDetail;
+    anchor: import("./anchor.js").DocAnchorContext | null;
+    impact: ImpactResult | null;
+    impactSummary: ImpactSummary | null;
+    resolvedFrom?: {
+        id: string;
+        type: string;
+        reason: string;
+    };
+    workflow: {
+        phases: string[];
+        suggestEdit: {
+            docPath: string | null;
+            startLine: number;
+            endLine: number;
+            instruction: string;
+        };
+        afterApply: {
+            indexRefresh?: boolean;
+            regenerateCommands?: string[];
+        };
+    };
+}
+export declare function buildResolvePlan(thread: import("./types.js").ThreadDetail, anchor: import("./anchor.js").DocAnchorContext | null, impact: ImpactResult | null, resolvedFrom?: {
+    id: string;
+    type: string;
+    reason: string;
+}, pickId?: string): CommentResolvePlan;
+export declare function formatPlanForChat(plan: CommentResolvePlan): string;
+//# sourceMappingURL=inbox.d.ts.map

package/dist/comments/inbox.d.ts.map

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

package/dist/comments/inbox.js

@@ -0,0 +1,180 @@
+import { previewCommentBody } from "./anchor.js";
+export function buildCommentInbox(threads) {
+    const inbox = threads.map((t, index) => ({
+        pickId: `C-${String(index + 1).padStart(3, "0")}`,
+        threadId: t.threadId,
+        filePath: t.filePath,
+        docPath: t.docPath,
+        status: t.status,
+        language: t.anchor.language,
+        lines: `${t.anchor.startLine}-${t.anchor.endLine}`,
+        startLine: t.anchor.startLine,
+        endLine: t.anchor.endLine,
+        excerpt: t.anchor.lineExcerpt,
+        preview: "(loading…)",
+        replyCount: t.replyCount,
+        originBranch: t.originBranch,
+        version: t.version,
+    }));
+    return {
+        inbox,
+        count: inbox.length,
+        openCount: inbox.filter((i) => i.status === "open").length,
+        prompt: inbox.length === 0
+            ? "No open comment threads. Run git pull or check comments/."
+            : "Reply with a pick id (e.g. C-001) to start the resolve workflow.",
+        idePresentation: buildIdePresentation(inbox),
+    };
+}
+const IDE_PRESENTATION_RULES = [
+    "Show only the markdown table below — one row per open thread (not per reply).",
+    "Do not paste raw JSON or full thread uuids in chat.",
+    "Use pick ids (C-001) for user selection; keep threadId internal until running plan/resolve.",
+];
+function buildIdePresentation(inbox) {
+    if (inbox.length === 0) {
+        return {
+            mode: "thread_pick_list",
+            markdown: "_No open comment threads._",
+            rules: IDE_PRESENTATION_RULES,
+        };
+    }
+    const header = "| Pick | Document | Lines | Lang | Reviewer ask |";
+    const sep = "|------|----------|-------|------|--------------|";
+    const rows = inbox.map((item) => {
+        const doc = item.docPath ?? item.filePath;
+        const ask = item.preview.replace(/\|/g, "\\|").replace(/\n/g, " ");
+        const excerpt = item.excerpt && !ask.includes(item.excerpt.slice(0, 20))
+            ? ` _(${item.excerpt.replace(/\|/g, "\\|").slice(0, 60)}…)_`
+            : "";
+        return `| **${item.pickId}** | \`${doc}\` | ${item.lines} | ${item.language} | ${ask}${excerpt} |`;
+    });
+    return {
+        mode: "thread_pick_list",
+        markdown: [header, sep, ...rows].join("\n"),
+        rules: IDE_PRESENTATION_RULES,
+    };
+}
+export function enrichInboxPreviews(inbox, firstComments) {
+    const enrichedInbox = inbox.inbox.map((item) => {
+        const body = firstComments.get(item.threadId);
+        return body ? { ...item, preview: previewCommentBody(body) } : item;
+    });
+    return {
+        ...inbox,
+        inbox: enrichedInbox,
+        idePresentation: buildIdePresentation(enrichedInbox),
+    };
+}
+export function formatInboxForChat(inbox) {
+    if (inbox.count === 0) {
+        return "No open comment threads under comments/.";
+    }
+    return [
+        `Open comment threads (${inbox.openCount}) — pick one:`,
+        "",
+        inbox.idePresentation.markdown,
+        "",
+        inbox.prompt,
+    ].join("\n");
+}
+export function summarizeImpact(impact) {
+    if (!impact) {
+        return null;
+    }
+    return {
+        regenerate: impact.affected.regenerate.length,
+        review: impact.affected.review.length,
+        downstream: impact.affected.downstream.length,
+        originId: impact.origin.id,
+        originType: impact.origin.type,
+        topRegenerate: impact.affected.regenerate.slice(0, 8).map((e) => ({
+            id: e.id,
+            projectionPath: e.projectionPath,
+        })),
+        topReview: impact.affected.review.slice(0, 5).map((e) => ({
+            id: e.id,
+            projectionPath: e.projectionPath,
+        })),
+    };
+}
+export function buildResolvePlan(thread, anchor, impact, resolvedFrom, pickId) {
+    const firstComment = thread.comments.find((c) => !c.deletedAt);
+    const ask = firstComment?.body ?? "(no comment body)";
+    const regenerateCommands = impact && impact.affected.regenerate.length > 0
+        ? [
+            ...new Set(impact.affected.regenerate
+                .slice(0, 5)
+                .map((e) => `/generate-srs from ${e.id}`)),
+        ]
+        : [];
+    return {
+        pickId,
+        thread,
+        anchor,
+        impact,
+        impactSummary: summarizeImpact(impact),
+        resolvedFrom,
+        workflow: {
+            phases: [
+                "show_plan_in_chat",
+                "propose_doc_edit",
+                "user_approval",
+                "apply_edit_to_doc",
+                "git_commit_doc_then_resolve_meta",
+                "git_push",
+                "optional_index_or_regen",
+            ],
+            suggestEdit: {
+                docPath: anchor?.docPath ?? thread.docPath,
+                startLine: thread.anchor.startLine,
+                endLine: thread.anchor.endLine,
+                instruction: `Address reviewer comment at lines ${thread.anchor.startLine}-${thread.anchor.endLine}: ${previewCommentBody(ask, 200)}`,
+            },
+            afterApply: {
+                indexRefresh: impact != null && (impact.affected.regenerate.length > 0 || impact.affected.review.length > 0),
+                regenerateCommands,
+            },
+        },
+    };
+}
+export function formatPlanForChat(plan) {
+    const t = plan.thread;
+    const lines = [
+        plan.pickId ? `# ${plan.pickId} → ${t.threadId}` : `# Thread ${t.threadId}`,
+        "",
+        `**File:** ${t.filePath} → ${t.docPath ?? "(unknown)"}`,
+        `**Anchor:** lines ${t.anchor.startLine}-${t.anchor.endLine} (${t.anchor.language})`,
+    ];
+    if (t.anchor.lineExcerpt) {
+        lines.push(`**Excerpt:** ${t.anchor.lineExcerpt}`);
+    }
+    lines.push("", "**Comments:**");
+    for (const c of t.comments) {
+        if (c.deletedAt) {
+            continue;
+        }
+        lines.push(`- ${c.authorId}: ${c.body}`);
+    }
+    if (plan.anchor?.anchoredText) {
+        lines.push("", "**Current text at anchor:**", "```markdown", plan.anchor.anchoredText, "```");
+    }
+    if (plan.impactSummary) {
+        lines.push("", "**Impact if you change this section:**", `- Regenerate: ${plan.impactSummary.regenerate}`, `- Review: ${plan.impactSummary.review}`, `- Downstream: ${plan.impactSummary.downstream}`);
+        if (plan.resolvedFrom) {
+            lines.push(`- Graph seed: \`${plan.resolvedFrom.id}\` (${plan.resolvedFrom.reason})`);
+        }
+        if (plan.impactSummary.topRegenerate.length > 0) {
+            lines.push("", "Top regen targets:");
+            for (const e of plan.impactSummary.topRegenerate) {
+                lines.push(`- \`${e.id}\`${e.projectionPath ? ` → ${e.projectionPath}` : ""}`);
+            }
+        }
+    }
+    else {
+        lines.push("", "**Impact:** (graph unavailable — run /index or /validate-graph first)");
+    }
+    lines.push("", "**Next (IDE workflow):**", "1. Propose a concrete doc edit addressing the comment", "2. Wait for your approval", "3. Apply the edit", "4. Commit **doc + comment meta in one commit** (amend) → push");
+    return lines.join("\n");
+}
+//# sourceMappingURL=inbox.js.map

package/dist/comments/inbox.js.map

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

package/dist/comments/paths.d.ts

@@ -0,0 +1,12 @@
+/** Strip leading/trailing slashes and `docs/` prefix from logical paths. */
+export declare function normalizeLogicalPath(filePath: string): string;
+/**
+ * Map comment logical_path (e.g. `srs/01-overview`) to repo-relative doc file.
+ * Returns null when the prefix is unknown.
+ */
+export declare function logicalPathToDocPath(logicalPath: string): string | null;
+export declare function commentsRootRel(): string;
+export declare function threadDirRel(logicalPath: string, threadId: string): string;
+export declare function threadMetaRel(logicalPath: string, threadId: string): string;
+export declare function threadEventsRel(logicalPath: string, threadId: string): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/comments/paths.ts"],"names":[],"mappings":"AAIA,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU7D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBvE;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7E"}

package/dist/comments/paths.js

@@ -0,0 +1,54 @@
+import { join } from "node:path";
+const COMMENTS_ROOT = "comments";
+/** Strip leading/trailing slashes and `docs/` prefix from logical paths. */
+export function normalizeLogicalPath(filePath) {
+    let p = filePath.trim().replace(/\\/g, "/");
+    p = p.replace(/^\/+|\/+$/g, "");
+    if (p.startsWith("docs/")) {
+        p = p.slice("docs/".length);
+    }
+    if (p.endsWith(".md")) {
+        p = p.slice(0, -3);
+    }
+    return p;
+}
+/**
+ * Map comment logical_path (e.g. `srs/01-overview`) to repo-relative doc file.
+ * Returns null when the prefix is unknown.
+ */
+export function logicalPathToDocPath(logicalPath) {
+    const p = normalizeLogicalPath(logicalPath);
+    if (!p) {
+        return null;
+    }
+    if (p.startsWith("srs/") || p === "srs") {
+        return `docs/srs/${p === "srs" ? "" : p.slice("srs/".length)}.md`.replace(/\/\.md$/, ".md");
+    }
+    if (p.startsWith("basic-design/") || p.startsWith("bd/")) {
+        const rest = p.startsWith("basic-design/")
+            ? p.slice("basic-design/".length)
+            : p.slice("bd/".length);
+        return `docs/basic-design/${rest}.md`;
+    }
+    if (p.startsWith("detail-design/") || p.startsWith("dd/")) {
+        const rest = p.startsWith("detail-design/")
+            ? p.slice("detail-design/".length)
+            : p.slice("dd/".length);
+        return `docs/detail-design/${rest}.md`;
+    }
+    return null;
+}
+export function commentsRootRel() {
+    return COMMENTS_ROOT;
+}
+export function threadDirRel(logicalPath, threadId) {
+    const lp = normalizeLogicalPath(logicalPath);
+    return join(COMMENTS_ROOT, lp, threadId).replace(/\\/g, "/");
+}
+export function threadMetaRel(logicalPath, threadId) {
+    return `${threadDirRel(logicalPath, threadId)}/meta_data.json`;
+}
+export function threadEventsRel(logicalPath, threadId) {
+    return `${threadDirRel(logicalPath, threadId)}/events.jsonl`;
+}
+//# sourceMappingURL=paths.js.map

package/dist/comments/paths.js.map

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

package/dist/comments/plan.d.ts

@@ -0,0 +1,20 @@
+import type { CommentInboxItem } from "./inbox.js";
+import { type CommentInbox, type CommentResolvePlan } from "./inbox.js";
+export interface BuildInboxOptions {
+    projectRoot: string;
+    filePath?: string;
+    status?: "open" | "resolved" | "all";
+}
+export declare function buildCommentInboxPayload(opts: BuildInboxOptions): Promise<CommentInbox>;
+export interface BuildPlanOptions {
+    projectRoot: string;
+    graphPath: string;
+    rulesPath: string;
+    threadId: string;
+    filePath?: string;
+    pickId?: string;
+}
+export declare function buildCommentPlan(opts: BuildPlanOptions): Promise<CommentResolvePlan>;
+export declare function resolvePickId(inbox: CommentInbox, token: string): CommentInboxItem | undefined;
+export declare function pickIdForThread(inbox: CommentInbox, threadId: string): string | undefined;
+//# sourceMappingURL=plan.d.ts.map

package/dist/comments/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/comments/plan.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AASpB,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC;CACtC;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,YAAY,CAAC,CAUvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,kBAAkB,CAAC,CA+C7B;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,MAAM,GACZ,gBAAgB,GAAG,SAAS,CAS9B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzF"}

package/dist/comments/plan.js

@@ -0,0 +1,62 @@
+import { computeImpact, loadImpactRules } from "../graph/impact.js";
+import { loadInMemoryGraph } from "../graph/loadGraph.js";
+import { pickPrimaryImpactOrigin, resolveImpactOrigins, } from "../graph/resolve.js";
+import { readDocAnchorContext } from "./anchor.js";
+import { buildCommentInbox, buildResolvePlan, enrichInboxPreviews, } from "./inbox.js";
+import { normalizeLogicalPath } from "./paths.js";
+import { findThreadById, getThread, listThreads, loadCommentBodiesForThreads, } from "./storage.js";
+export async function buildCommentInboxPayload(opts) {
+    const threads = await listThreads({
+        projectRoot: opts.projectRoot,
+        filePath: opts.filePath,
+        status: opts.status ?? "open",
+    });
+    const firstComments = await loadCommentBodiesForThreads(opts.projectRoot, threads);
+    const base = buildCommentInbox(threads);
+    return enrichInboxPreviews(base, firstComments);
+}
+export async function buildCommentPlan(opts) {
+    const thread = opts.filePath
+        ? await getThread(opts.projectRoot, normalizeLogicalPath(opts.filePath), opts.threadId)
+        : await findThreadById(opts.projectRoot, opts.threadId);
+    if (!thread) {
+        throw new Error(opts.filePath
+            ? `Thread not found: ${opts.threadId} under ${normalizeLogicalPath(opts.filePath)}`
+            : `Thread not found: ${opts.threadId}`);
+    }
+    const anchor = await readDocAnchorContext(opts.projectRoot, thread.filePath, thread.anchor.startLine, thread.anchor.endLine);
+    let impact = null;
+    let resolvedFrom;
+    try {
+        const g = await loadInMemoryGraph(opts.graphPath);
+        const origins = resolveImpactOrigins(g, {
+            file: anchor?.docPath ?? thread.docPath ?? undefined,
+            heading: anchor?.heading,
+            sectionAnchor: anchor?.sectionAnchor,
+            text: thread.anchor.lineExcerpt,
+        });
+        const primary = pickPrimaryImpactOrigin(origins);
+        if (primary) {
+            resolvedFrom = primary;
+            const rules = await loadImpactRules(opts.rulesPath);
+            impact = computeImpact(g, primary.id, "content_change", rules);
+            impact.resolvedFrom = primary;
+        }
+    }
+    catch {
+        /* graph missing or invalid — plan still usable without impact */
+    }
+    return buildResolvePlan(thread, anchor, impact, resolvedFrom, opts.pickId);
+}
+export function resolvePickId(inbox, token) {
+    const t = token.trim();
+    const byPick = inbox.inbox.find((i) => i.pickId.toLowerCase() === t.toLowerCase());
+    if (byPick) {
+        return byPick;
+    }
+    return inbox.inbox.find((i) => i.threadId === t || i.threadId.startsWith(t));
+}
+export function pickIdForThread(inbox, threadId) {
+    return inbox.inbox.find((i) => i.threadId === threadId)?.pickId;
+}
+//# sourceMappingURL=plan.js.map