codesift-mcp 0.5.24 → 0.5.28

package/dist/tools/wiki-page-generators.d.ts

@@ -1,4 +1,5 @@
 import type { SurpriseScore, CommunityInfo } from "./wiki-surprise.js";
+import type { ModuleMetadata, ProjectOverview } from "./wiki-manifest.js";
 export type { CommunityInfo };
 export interface HubSymbol {
     name: string;
@@ -24,8 +25,23 @@ export interface CommunityPageData {
     hotspots: FileHotspot[];
     hub_symbols: HubSymbol[];
 }
-export declare function generateCommunityPage(data: CommunityPageData): string;
-export declare function generateCommunitySummary(data: CommunityPageData): string;
+/**
+ * Generate a community markdown page. When `module` is provided (v2 path),
+ * the page leads with Overview / Key Exports / Dependencies sections populated
+ * from structured metadata. When `module` is undefined (v1 rollback path),
+ * falls back to the legacy generic boilerplate.
+ */
+export declare function generateCommunityPage(data: CommunityPageData, module?: ModuleMetadata): string;
+/**
+ * Generate the 2500-char `.summary.md` injected by the PreToolUse hook.
+ * When `module` is provided, the summary leads with purpose + exports + deps;
+ * otherwise falls back to the legacy 4-line format.
+ */
+export declare function generateCommunitySummary(data: CommunityPageData, module?: ModuleMetadata): string;
+/** Project-overview landing page (new in v2). */
+export declare function generateOverviewPage(project: ProjectOverview, modules: ModuleMetadata[]): string;
+/** Architecture narrative page — module dependencies + roles. */
+export declare function generateArchitecturePage(modules: ModuleMetadata[]): string;
 export declare function generateHubsPage(hubs: HubSymbol[]): string;
 export declare function generateSurprisePage(surprises: SurpriseScore[]): string;
 export declare function generateHotspotsPage(hotspots: FileHotspot[]): string;
@@ -34,5 +50,5 @@ export declare function generateIndexPage(pages: Array<{
     slug: string;
     title: string;
     type: string;
-}>): string;
+}>, project?: ProjectOverview): string;
 //# sourceMappingURL=wiki-page-generators.d.ts.map

package/dist/tools/wiki-page-generators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wiki-page-generators.d.ts","sourceRoot":"","sources":["../../src/tools/wiki-page-generators.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEvE,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,SAAS,EAAE,CAAC;CAC1B;AAKD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAsCrE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAYxE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAuB1D;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,MAAM,CAsBvE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAgBpE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAG7E;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1D,MAAM,CAuBR"}
+{"version":3,"file":"wiki-page-generators.d.ts","sourceRoot":"","sources":["../../src/tools/wiki-page-generators.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,SAAS,EAAE,CAAC;CAC1B;AAKD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,MAAM,CAAC,EAAE,cAAc,GACtB,MAAM,CAqER;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,iBAAiB,EACvB,MAAM,CAAC,EAAE,cAAc,GACtB,MAAM,CA2BR;AAED,iDAAiD;AACjD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,cAAc,EAAE,GACxB,MAAM,CAkER;AAED,iEAAiE;AACjE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAc1E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAuB1D;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,MAAM,CAsBvE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAgBpE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAG7E;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC3D,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CA4BR"}

package/dist/tools/wiki-page-generators.js

@@ -1,13 +1,35 @@
 import { escMd } from "./wiki-escape.js";
 const MAX_FILES_DISPLAY = 15;
 const SUMMARY_CHAR_BUDGET = 1600; // ~400 tokens at 4 chars/token
-export function generateCommunityPage(data) {
+/**
+ * Generate a community markdown page. When `module` is provided (v2 path),
+ * the page leads with Overview / Key Exports / Dependencies sections populated
+ * from structured metadata. When `module` is undefined (v1 rollback path),
+ * falls back to the legacy generic boilerplate.
+ */
+export function generateCommunityPage(data, module) {
     const { community, cohesion, internal_edges, external_edges, hotspots, hub_symbols } = data;
     const lines = [];
     lines.push(`# ${escMd(community.name)}`);
     lines.push("");
-    lines.push("> A **community** is a group of files that are more tightly connected to each other (via imports) than to the rest of the codebase. Detected automatically by the Louvain algorithm on the import graph.");
-    lines.push("");
+    if (module) {
+        lines.push("## Overview", "", escMd(module.description), "");
+        if (module.key_exports.length > 0) {
+            lines.push("## Key Exports", "");
+            if (module.key_exports_approximate) {
+                lines.push("> *Approximate list — regenerated after a full reindex will be more precise.*", "");
+            }
+            lines.push("| Name | Kind | File | Signature |", "| ---- | ---- | ---- | --------- |");
+            for (const k of module.key_exports) {
+                lines.push(`| \`${escMd(k.name)}\` | ${escMd(k.kind)} | \`${escMd(k.file)}\` | ${k.signature ? escMd(k.signature) : "—"} |`);
+            }
+            lines.push("");
+        }
+    }
+    else {
+        lines.push("> A **community** is a group of files that are more tightly connected to each other (via imports) than to the rest of the codebase. Detected automatically by the Louvain algorithm on the import graph.");
+        lines.push("");
+    }
     lines.push(`**Cohesion:** ${(cohesion * 100).toFixed(0)}% *(higher = files in this module import each other more than outsiders)*  |  ` +
         `**Internal edges:** ${internal_edges} *(imports within this module)*  |  ` +
         `**External edges:** ${external_edges} *(imports crossing module boundary)*  |  ` +
@@ -21,7 +43,17 @@ export function generateCommunityPage(data) {
         lines.push(`- *+${extra} more files (use \`codesift wiki-generate --focus\` to see all)*`);
     }
     lines.push("");
-    if (hub_symbols.length > 0) {
+    if (module && (module.depends_on.length > 0 || module.depended_by.length > 0)) {
+        lines.push("## Dependencies", "");
+        if (module.depends_on.length > 0) {
+            lines.push(`- **Depends on:** ${module.depends_on.map((s) => `[[${s}]]`).join(", ")}`);
+        }
+        if (module.depended_by.length > 0) {
+            lines.push(`- **Depended by:** ${module.depended_by.map((s) => `[[${s}]]`).join(", ")}`);
+        }
+        lines.push("");
+    }
+    if (hub_symbols.length > 0 && (!module || module.role !== "micro-module")) {
         lines.push("## Hub Symbols", "", "| Symbol | Role | Callers | Callees |", "| ------ | ---- | ------: | ------: |");
         for (const h of hub_symbols) {
             lines.push(`| ${escMd(h.name)} | ${escMd(h.role)} | ${h.callers} | ${h.callees} |`);
@@ -37,21 +69,118 @@ export function generateCommunityPage(data) {
     }
     return lines.join("\n");
 }
-export function generateCommunitySummary(data) {
+/**
+ * Generate the 2500-char `.summary.md` injected by the PreToolUse hook.
+ * When `module` is provided, the summary leads with purpose + exports + deps;
+ * otherwise falls back to the legacy 4-line format.
+ */
+export function generateCommunitySummary(data, module) {
     const { community, cohesion, hub_symbols } = data;
-    const lines = [
-        `**${escMd(community.name)}**`,
-        `Cohesion: ${(cohesion * 100).toFixed(0)}% | Files: ${community.size}`,
-    ];
-    const topFiles = community.files.slice(0, 3);
-    if (topFiles.length > 0)
-        lines.push(`Top files: ${topFiles.map(escMd).join(", ")}`);
-    const topHub = hub_symbols[0];
-    if (topHub !== undefined)
-        lines.push(`Top hub: ${escMd(topHub.name)} (${topHub.callers} callers)`);
+    const lines = [];
+    if (module) {
+        lines.push(`**${escMd(community.name)}** — ${escMd(module.role)}`);
+        lines.push(`Purpose: ${escMd(module.description)}`);
+        lines.push(`Cohesion: ${(cohesion * 100).toFixed(0)}% | Files: ${community.size}`);
+        if (module.key_exports.length > 0) {
+            const names = module.key_exports.slice(0, 5).map((k) => `${k.name} (${k.kind})`).join(", ");
+            lines.push(`Key exports: ${names}${module.key_exports_approximate ? " [approximate]" : ""}`);
+        }
+        if (module.depends_on.length > 0) {
+            lines.push(`Depends on: ${module.depends_on.slice(0, 5).join(", ")}`);
+        }
+        if (module.has_hotspot) {
+            lines.push(`⚠ Contains hotspot file — high churn + complexity.`);
+        }
+    }
+    else {
+        lines.push(`**${escMd(community.name)}**`);
+        lines.push(`Cohesion: ${(cohesion * 100).toFixed(0)}% | Files: ${community.size}`);
+        const topFiles = community.files.slice(0, 3);
+        if (topFiles.length > 0)
+            lines.push(`Top files: ${topFiles.map(escMd).join(", ")}`);
+        const topHub = hub_symbols[0];
+        if (topHub !== undefined)
+            lines.push(`Top hub: ${escMd(topHub.name)} (${topHub.callers} callers)`);
+    }
     const result = lines.join("\n");
     return result.length <= SUMMARY_CHAR_BUDGET ? result : result.slice(0, SUMMARY_CHAR_BUDGET);
 }
+/** Project-overview landing page (new in v2). */
+export function generateOverviewPage(project, modules) {
+    const lines = [
+        `# ${escMd(project.name)}`,
+        "",
+        `> Project overview — auto-generated from source.`,
+        "",
+        "## Stack",
+        "",
+        `- **Language:** ${escMd(project.stack.language)}${project.stack.language_version ? ` ${escMd(project.stack.language_version)}` : ""}`,
+    ];
+    if (project.stack.framework) {
+        lines.push(`- **Framework:** ${escMd(project.stack.framework)}${project.stack.framework_version ? ` ${escMd(project.stack.framework_version)}` : ""}`);
+    }
+    if (project.stack.test_runner)
+        lines.push(`- **Test runner:** ${escMd(project.stack.test_runner)}`);
+    if (project.stack.package_manager)
+        lines.push(`- **Package manager:** ${escMd(project.stack.package_manager)}`);
+    if (project.stack.build_tool)
+        lines.push(`- **Build tool:** ${escMd(project.stack.build_tool)}`);
+    lines.push("");
+    const scriptEntries = Object.entries(project.scripts);
+    if (scriptEntries.length > 0) {
+        lines.push("## Scripts", "", "| Script | Command |", "| ------ | ------- |");
+        for (const [name, cmd] of scriptEntries.slice(0, 10)) {
+            lines.push(`| \`${escMd(name)}\` | \`${escMd(cmd)}\` |`);
+        }
+        lines.push("");
+    }
+    if (project.entry_points.length > 0) {
+        lines.push("## Entry Points", "");
+        for (const ep of project.entry_points.slice(0, 10)) {
+            lines.push(`- \`${escMd(ep)}\``);
+        }
+        lines.push("");
+    }
+    if (project.dependencies.key.length > 0) {
+        lines.push("## Key Dependencies", "", `Total: ${project.dependencies.prod_total} prod, ${project.dependencies.dev_total} dev.`, "", "| Package | Version | Kind |", "| ------- | ------- | ---- |");
+        for (const d of project.dependencies.key.slice(0, 15)) {
+            lines.push(`| \`${escMd(d.name)}\` | ${escMd(d.version || "—")} | ${escMd(d.kind)} |`);
+        }
+        lines.push("");
+    }
+    if (project.known_gotchas.length > 0) {
+        lines.push("## Known Gotchas", "");
+        for (const g of project.known_gotchas.slice(0, 10)) {
+            lines.push(`- **[${escMd(g.severity)}]** ${escMd(g.gotcha)}`);
+        }
+        lines.push("");
+    }
+    if (modules.length > 0) {
+        lines.push("## Modules", "");
+        for (const m of modules.slice(0, 20)) {
+            lines.push(`- [[${m.slug}]] — *${escMd(m.role)}* · ${escMd(m.description)}`);
+        }
+        lines.push("");
+    }
+    lines.push("## Stats", "", `- Files: ${project.stats.total_files}`, project.stats.total_commits !== null ? `- Commits: ${project.stats.total_commits}` : "- Commits: *(shallow clone or no git history)*", project.stats.contributors !== null ? `- Contributors: ${project.stats.contributors}` : "- Contributors: *(shallow clone)*", "");
+    return lines.join("\n");
+}
+/** Architecture narrative page — module dependencies + roles. */
+export function generateArchitecturePage(modules) {
+    const lines = ["# Architecture", ""];
+    if (modules.length === 0) {
+        lines.push("*No modules detected.*", "");
+        return lines.join("\n");
+    }
+    lines.push("> Module roles and dependency structure derived from the import graph.", "");
+    lines.push("## Roles", "", "| Module | Role | Files | Cohesion | Depends on |", "| ------ | ---- | ----: | -------: | ---------- |");
+    for (const m of modules) {
+        const deps = m.depends_on.length === 0 ? "—" : m.depends_on.map((s) => `[[${s}]]`).join(", ");
+        lines.push(`| [[${m.slug}]] | ${escMd(m.role)} | ${m.files} | ${(m.cohesion * 100).toFixed(0)}% | ${deps} |`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
 export function generateHubsPage(hubs) {
     const lines = [
         "# Hub Symbols", "",
@@ -116,15 +245,20 @@ export function generateFrameworkPage(framework) {
         return "";
     return [`# Framework: ${escMd(framework.name)}`, "", escMd(framework.details), ""].join("\n");
 }
-export function generateIndexPage(pages) {
+export function generateIndexPage(pages, project) {
+    const heading = project ? `# ${escMd(project.name)} — Wiki` : "# Wiki Index";
+    const subtitle = project
+        ? `> **Stack:** ${escMd(project.stack.language)}${project.stack.framework ? ` · ${escMd(project.stack.framework)}` : ""} — ${project.stats.total_files} files.`
+        : "> This wiki was auto-generated from your codebase's structure using static analysis — no manual writing needed. It shows how your code is organized into modules (communities), which symbols are most critical (hubs), where hidden coupling exists (surprises), and which files are highest-risk (hotspots).";
     const lines = [
-        "# Wiki Index", "",
-        "> This wiki was auto-generated from your codebase's structure using static analysis — no manual writing needed. It shows how your code is organized into modules (communities), which symbols are most critical (hubs), where hidden coupling exists (surprises), and which files are highest-risk (hotspots).", "",
+        heading, "",
+        subtitle, "",
         "**How to read this wiki:**",
-        "- **Communities** = groups of files that import each other heavily (detected by Louvain algorithm)",
-        "- **Hubs** = functions/classes that many other files depend on (high fan-in)",
-        "- **Surprises** = unexpected connections between modules (may indicate missing abstractions)",
-        "- **Hotspots** = files with high churn + complexity (refactoring candidates)",
+        "- **Overview** = project stack, scripts, entry points, key dependencies",
+        "- **Communities** = groups of files that import each other heavily (Louvain)",
+        "- **Hubs** = functions/classes that many other files depend on (fan-in)",
+        "- **Surprises** = unexpected connections between modules",
+        "- **Hotspots** = files with high churn + complexity",
         "",
     ];
     const byType = new Map();

package/dist/tools/wiki-page-generators.js.map

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

package/dist/tools/wiki-tools.d.ts

@@ -10,5 +10,25 @@ export interface WikiResult {
 export declare function generateWiki(repo: string, options?: {
     focus?: string;
     output_dir?: string;
+    journal_mode?: "skip" | "refresh-overview" | "append" | "full";
+    journal_since_ref?: string;
+    journal_bulk_fill?: boolean;
 }): Promise<WikiResult>;
+/**
+ * Delete `.md` files under `outputDir` that are not part of the freshly generated
+ * page set, while skipping any entry protected by `protectedPrefixes`.
+ *
+ * Contract invariant — `protectedPrefixes` are plain path-prefix strings, NOT globs:
+ * - Skip `f` where `f === p` OR `f.startsWith(p + "/")` for any `p ∈ protectedPrefixes`.
+ * - Skip entries where `!f.endsWith(".md")` (directories and non-markdown files).
+ * - Skip entries present in `knownFiles`.
+ * - Everything else is `unlink()`-ed.
+ *
+ * Currently called with a non-recursive `readdir`, but the guard is defence-in-depth
+ * for any future refactor that surfaces nested paths such as `"journal/phases/x.md"`
+ * (see wiki-journal spec D1 failure mode).
+ *
+ * @returns absolute paths of the files that were deleted
+ */
+export declare function pruneStaleWikiFiles(outputDir: string, knownFiles: Set<string>, protectedPrefixes: string[]): Promise<string[]>;
 //# sourceMappingURL=wiki-tools.d.ts.map

package/dist/tools/wiki-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wiki-tools.d.ts","sourceRoot":"","sources":["../../src/tools/wiki-tools.ts"],"names":[],"mappings":"AA2DA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAkDD,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,UAAU,CAAC,CA6UrB"}
+{"version":3,"file":"wiki-tools.d.ts","sourceRoot":"","sources":["../../src/tools/wiki-tools.ts"],"names":[],"mappings":"AAgEA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAkDD,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GACA,OAAO,CAAC,UAAU,CAAC,CA2brB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,iBAAiB,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBnB"}

package/dist/tools/wiki-tools.js

@@ -8,9 +8,12 @@ import { analyzeHotspots } from "./hotspot-tools.js";
 import { analyzeProject } from "./project-tools.js";
 import { computeIndexHash } from "../storage/graph-store.js";
 import { computeSurpriseScores, } from "./wiki-surprise.js";
-import { generateCommunityPage, generateCommunitySummary, generateHubsPage, generateSurprisePage, generateHotspotsPage, generateFrameworkPage, generateIndexPage, } from "./wiki-page-generators.js";
+import { generateCommunityPage, generateCommunitySummary, generateHubsPage, generateSurprisePage, generateHotspotsPage, generateFrameworkPage, generateIndexPage, generateOverviewPage, generateArchitecturePage, } from "./wiki-page-generators.js";
 import { resolveWikiLinks } from "./wiki-links.js";
-import { buildWikiManifest, buildUniqueSlugs } from "./wiki-manifest.js";
+import { buildUniqueSlugs } from "./wiki-manifest.js";
+import { buildWikiManifestV1, buildWikiManifestV2, buildProjectOverview, buildModuleMetadata } from "./wiki-module-builder.js";
+import { rankHubsByPageRank } from "./wiki-hub-ranker.js";
+import { collectImportEdges } from "../utils/import-graph.js";
 const TIMEOUT_SENTINEL = { status: "timeout" };
 function withTimeout(promise, ms) {
     return Promise.race([
@@ -188,9 +191,63 @@ export async function generateWiki(repo, options) {
         // Compute surprise scores
         const globalDensity = index.files.length > 0 ? crossEdges.length / (index.files.length * index.files.length) : 0;
         const surprises = computeSurpriseScores(communities, crossEdges, coChangePairs, globalDensity);
+        // --- V2 data pipeline (Task 21) ---------------------------------------
+        const v1Mode = process.env.CODESIFT_WIKI_V1 === "1";
+        // Load the full ProjectProfile from disk — analyzeProject returns a summary,
+        // but module-builder + overview need the full shape (identity, stack details,
+        // dependency_health, git_health, known_gotchas).
+        let fullProfile = null;
+        if (projectResult.status === "fulfilled" && !isTimeout(projectResult.value)) {
+            try {
+                const profilePath = projectResult.value.profile_path;
+                const raw = await readFile(profilePath, "utf-8");
+                fullProfile = JSON.parse(raw);
+            }
+            catch (err) {
+                degradedReasons.push(`project_profile_read_error: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
         // Build unique slugs (collision-safe) before page generation.
-        // Shared with buildWikiManifest below to keep manifest + summary file slugs aligned.
-        const slugMap = buildUniqueSlugs(communities);
+        const isMonorepo = fullProfile?.identity?.project_type === "monorepo";
+        const workspaces = fullProfile?.stack?.monorepo?.workspaces ?? [];
+        const slugMap = buildUniqueSlugs(communities, { monorepo: isMonorepo, workspaces });
+        let importEdges = [];
+        try {
+            importEdges = await collectImportEdges(index);
+        }
+        catch (err) {
+            degradedReasons.push(`import_edges_error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // PageRank-ranked hubs with builtin blocklist. Falls back gracefully to the
+        // classifySymbolRoles-sorted hubs when the graph is empty.
+        const rankedResult = rankHubsByPageRank(importEdges, hubSymbols, { topK: 30 });
+        const rankedHubs = rankedResult.hubs;
+        if (rankedResult.degraded_reason) {
+            degradedReasons.push(`hub_ranker_${rankedResult.degraded_reason}`);
+        }
+        const effectiveHubs = rankedHubs.length > 0 ? rankedHubs : hubSymbols;
+        // Project overview + structured module metadata.
+        let projectOverview = null;
+        let modules = [];
+        if (!v1Mode && fullProfile) {
+            try {
+                const overview = buildProjectOverview(fullProfile, index);
+                const { _degraded, ...clean } = overview;
+                if (_degraded)
+                    degradedReasons.push(_degraded);
+                projectOverview = clean;
+            }
+            catch (err) {
+                degradedReasons.push(`project_overview_error: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            try {
+                modules = buildModuleMetadata(communities, fullProfile, index, importEdges, fileHotspots, rankedHubs);
+            }
+            catch (err) {
+                degradedReasons.push(`module_metadata_error: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        const slugToModule = new Map(modules.map((m) => [m.slug, m]));
         // Build community page data
         const communityPages = communities.map((comm) => {
             const slug = slugMap.get(comm.name) ?? comm.name;
@@ -207,7 +264,7 @@ export async function generateWiki(repo, options) {
                 hotspots: commHotspots,
                 hub_symbols: commHubs,
             };
-            const content = generateCommunityPage(data);
+            const content = generateCommunityPage(data, slugToModule.get(slug));
             return { slug, title: comm.name, type: "community", file: `${slug}.md`, content };
         });
         // Write community summary files for hook injection
@@ -234,11 +291,11 @@ export async function generateWiki(repo, options) {
                 hotspots: commHotspots,
                 hub_symbols: commHubs,
             };
-            const summary = generateCommunitySummary(summaryData);
+            const summary = generateCommunitySummary(summaryData, slugToModule.get(comm.slug));
             await writeFile(join(outputDir, `${comm.slug}.summary.md`), summary, "utf-8");
         }
-        // Hubs page
-        const hubsContent = generateHubsPage(hubSymbols);
+        // Hubs page — prefer PageRank-ranked hubs when available
+        const hubsContent = generateHubsPage(effectiveHubs);
         const hubsPage = { slug: "hubs", title: "Hub Symbols", type: "hubs", file: "hubs.md", content: hubsContent };
         // Surprises page
         const surprisesContent = generateSurprisePage(surprises);
@@ -254,16 +311,37 @@ export async function generateWiki(repo, options) {
                 frameworkPages.push({ slug: "framework", title: `Framework: ${frameworkInfo.name}`, type: "framework", file: "framework.md", content });
             }
         }
+        // Overview + architecture pages (v2 only, when overview is available)
+        const overviewPages = [];
+        if (projectOverview) {
+            overviewPages.push({
+                slug: "overview",
+                title: projectOverview.name,
+                type: "overview",
+                file: "overview.md",
+                content: generateOverviewPage(projectOverview, modules),
+            });
+        }
+        if (modules.length >= 3) {
+            overviewPages.push({
+                slug: "architecture",
+                title: "Architecture",
+                type: "architecture",
+                file: "architecture.md",
+                content: generateArchitecturePage(modules),
+            });
+        }
         // Collect all content pages (excluding index) for index generation
         const contentPages = [
+            ...overviewPages,
             ...communityPages,
             hubsPage,
             surprisesPage,
             hotspotsPage,
             ...frameworkPages,
         ];
-        // Index page
-        const indexContent = generateIndexPage(contentPages.map((p) => ({ slug: p.slug, title: p.title, type: p.type })));
+        // Index page (v2 uses project overview for tailored heading when available)
+        const indexContent = generateIndexPage(contentPages.map((p) => ({ slug: p.slug, title: p.title, type: p.type })), projectOverview ?? undefined);
         const indexPage = { slug: "index", title: "Wiki Index", type: "index", file: "index.md", content: indexContent };
         const allPages = [indexPage, ...contentPages];
         // Resolve wiki links (two-pass backlink injection)
@@ -277,19 +355,28 @@ export async function generateWiki(repo, options) {
         }));
         // Load old manifest for slug_redirects preservation
         const oldManifest = await loadOldManifest(outputDir);
-        // Build manifest
+        // Build manifest — v2 by default, v1 when CODESIFT_WIKI_V1=1 or no overview
         const indexHash = computeIndexHash(index.files);
-        const manifestOptions = {
-            index_hash: indexHash,
-            git_commit: "unknown",
-            pages: resolvedPageInfos,
-            communities,
-            degradedReasons,
-        };
-        if (oldManifest !== undefined) {
-            manifestOptions.oldManifest = oldManifest;
-        }
-        const manifest = buildWikiManifest(manifestOptions);
+        const useV2 = !v1Mode && projectOverview !== null;
+        const manifest = useV2
+            ? buildWikiManifestV2({
+                index_hash: indexHash,
+                git_commit: "unknown",
+                pages: resolvedPageInfos,
+                communities,
+                project: projectOverview,
+                modules,
+                degradedReasons,
+                ...(oldManifest !== undefined ? { oldManifest: oldManifest } : {}),
+            })
+            : buildWikiManifestV1({
+                index_hash: indexHash,
+                git_commit: "unknown",
+                pages: resolvedPageInfos,
+                communities,
+                degradedReasons,
+                ...(oldManifest !== undefined ? { oldManifest: oldManifest } : {}),
+            });
         // Add lens_data to manifest for dashboard visualization
         if (communities.length >= 2) {
             const lensComms = communities.map((c) => {
@@ -320,8 +407,9 @@ export async function generateWiki(repo, options) {
         for (const page of resolvedPageInfos) {
             await writeFile(join(outputDir, page.file), page.content, "utf-8");
         }
-        // Stale page cleanup: delete .md files from a previous run that are no longer generated
-        const existingFiles = await readdir(outputDir);
+        // Stale page cleanup: delete .md files from a previous run that are no longer generated.
+        // Protected prefixes are plain path-prefix strings (NOT globs) — see pruneStaleWikiFiles
+        // contract for exact semantics. "journal" protects the wiki journal (D1 safeguard).
         const newFiles = new Set(resolvedPageInfos.map((p) => p.file));
         newFiles.add("wiki-manifest.json");
         newFiles.add("wiki-manifest.json.tmp");
@@ -330,16 +418,40 @@ export async function generateWiki(repo, options) {
         for (const comm of communityPages) {
             newFiles.add(`${comm.slug}.summary.md`);
         }
-        for (const f of existingFiles) {
-            if (f.endsWith(".md") && !newFiles.has(f)) {
-                await unlink(join(outputDir, f));
-            }
-        }
+        await pruneStaleWikiFiles(outputDir, newFiles, ["journal"]);
         // Atomic manifest write: write to .tmp then rename
         const manifestPath = join(outputDir, "wiki-manifest.json");
         const tmpPath = manifestPath + ".tmp";
         await writeFile(tmpPath, JSON.stringify(manifest, null, 2));
         await rename(tmpPath, manifestPath);
+        // Journal dispatch (lazy import — no penalty when mode=skip)
+        const mode = options?.journal_mode ?? "skip";
+        if (mode !== "skip") {
+            const { runJournalInit, runJournalAppend, refreshOverviewAndRollup } = await import("./journal-generator.js");
+            const baseOpts = { cwd: process.cwd(), outputDir };
+            try {
+                if (mode === "refresh-overview") {
+                    await refreshOverviewAndRollup(baseOpts);
+                }
+                else if (mode === "append") {
+                    if (!options?.journal_since_ref) {
+                        degradedReasons.push("journal_since_ref required when journal_mode=append");
+                    }
+                    else {
+                        await runJournalAppend({ ...baseOpts, since: options.journal_since_ref });
+                    }
+                }
+                else if (mode === "full") {
+                    const r = await runJournalInit({ ...baseOpts, bulkFill: options?.journal_bulk_fill ?? false });
+                    if (r.phases.every((p) => p.costUsd === 0)) {
+                        degradedReasons.push("journal: no LLM API key, wrote scaffold");
+                    }
+                }
+            }
+            catch (err) {
+                degradedReasons.push(`journal dispatch: ${err.message}`);
+            }
+        }
         return {
             wiki_dir: outputDir,
             pages: resolvedPageInfos.length,
@@ -354,4 +466,44 @@ export async function generateWiki(repo, options) {
         await unlink(lockPath).catch(() => { });
     }
 }
+/**
+ * Delete `.md` files under `outputDir` that are not part of the freshly generated
+ * page set, while skipping any entry protected by `protectedPrefixes`.
+ *
+ * Contract invariant — `protectedPrefixes` are plain path-prefix strings, NOT globs:
+ * - Skip `f` where `f === p` OR `f.startsWith(p + "/")` for any `p ∈ protectedPrefixes`.
+ * - Skip entries where `!f.endsWith(".md")` (directories and non-markdown files).
+ * - Skip entries present in `knownFiles`.
+ * - Everything else is `unlink()`-ed.
+ *
+ * Currently called with a non-recursive `readdir`, but the guard is defence-in-depth
+ * for any future refactor that surfaces nested paths such as `"journal/phases/x.md"`
+ * (see wiki-journal spec D1 failure mode).
+ *
+ * @returns absolute paths of the files that were deleted
+ */
+export async function pruneStaleWikiFiles(outputDir, knownFiles, protectedPrefixes) {
+    const entries = await readdir(outputDir);
+    const deleted = [];
+    for (const f of entries) {
+        // Guard: plain path-prefix match (NOT glob). Exact match or "prefix/" descendant.
+        const isProtected = protectedPrefixes.some((p) => f === p || f.startsWith(p + "/"));
+        if (isProtected)
+            continue;
+        if (!f.endsWith(".md"))
+            continue;
+        if (knownFiles.has(f))
+            continue;
+        const full = join(outputDir, f);
+        try {
+            await unlink(full);
+            deleted.push(full);
+        }
+        catch (err) {
+            console.warn(`[wiki-cleanup] could not remove stale file ${full}: ${err instanceof Error ? err.message : String(err)}`);
+            // continue — best-effort cleanup; see D1 failure mode in spec
+        }
+    }
+    return deleted;
+}
 //# sourceMappingURL=wiki-tools.js.map