codesift-mcp 0.5.24 → 0.5.27

package/dist/tools/journal-generator-helpers.js

@@ -0,0 +1,250 @@
+import { readFile, writeFile, unlink, rename } from "node:fs/promises";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { execFileSync } from "node:child_process";
+import { parseSentinelBlocks } from "./journal-sentinel.js";
+const SAFE_SLUG_RE = /^[a-z0-9][a-z0-9-]{0,63}$/;
+export function assertSafeSlug(slug) {
+    if (!SAFE_SLUG_RE.test(slug))
+        throw new Error(`Unsafe journal slug "${slug}" (must match ${SAFE_SLUG_RE.source})`);
+}
+export class BlockChangedError extends Error {
+    blockKind;
+    constructor(kind) {
+        super(`Block ${kind} changed since read`);
+        this.name = "BlockChangedError";
+        this.blockKind = kind;
+    }
+}
+export class BudgetExceededError extends Error {
+    file;
+    sizeBytes;
+    limit;
+    constructor(file, sizeBytes, limit) {
+        super(`${file} is ${sizeBytes} bytes, exceeds ${limit}`);
+        this.name = "BudgetExceededError";
+        this.file = file;
+        this.sizeBytes = sizeBytes;
+        this.limit = limit;
+    }
+}
+export const BUDGETS = { "rollup.md": 12_000, "overview.md": 6_000 };
+export function assertBlockUnchanged(fileContent, blockKind, preHash) {
+    const block = parseSentinelBlocks(fileContent).find((b) => b.kind === blockKind);
+    if (!block || block.hash !== preHash)
+        throw new BlockChangedError(blockKind);
+}
+export async function acquireLock(lockPath) {
+    await writeFile(lockPath, String(process.pid), { flag: "wx" });
+}
+export async function releaseLock(lockPath) {
+    try {
+        await unlink(lockPath);
+    }
+    catch { /* best-effort */ }
+}
+export async function readCheckpoint(path) {
+    try {
+        return JSON.parse(await readFile(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeCheckpoint(path, state) {
+    await writeFile(path, JSON.stringify(state, null, 2), "utf-8");
+}
+export function enforceBudgets(files) {
+    for (const [name, content] of Object.entries(files)) {
+        const limit = BUDGETS[name];
+        if (limit === undefined)
+            continue;
+        const size = Buffer.byteLength(content, "utf-8");
+        if (size > limit)
+            throw new BudgetExceededError(name, size, limit);
+    }
+}
+export async function anyFileHasTodo(dir, files) {
+    for (const f of files) {
+        if (!f.endsWith(".md"))
+            continue;
+        try {
+            if ((await readFile(join(dir, f), "utf-8")).includes("TODO:"))
+                return true;
+        }
+        catch { /* ignore */ }
+    }
+    return false;
+}
+export async function readPhaseBlockHash(filePath, kind) {
+    try {
+        return parseSentinelBlocks(await readFile(filePath, "utf-8")).find((b) => b.kind === kind)?.hash;
+    }
+    catch {
+        return undefined;
+    }
+}
+// ─── Delta filtering (Phase A) ──────────────────────────────────────────────
+function resolveSinceCutoff(since, cwd) {
+    const direct = Date.parse(since);
+    if (!Number.isNaN(direct))
+        return direct;
+    try {
+        const raw = execFileSync("git", ["log", "-1", "--format=%aI", "--since", since], { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+        const parsed = Date.parse(raw);
+        if (!Number.isNaN(parsed))
+            return parsed;
+    }
+    catch { /* fall through */ }
+    return Number.NEGATIVE_INFINITY;
+}
+export function filterPhasesBySince(phases, since, cwd = process.cwd()) {
+    const cutoff = resolveSinceCutoff(since, cwd);
+    if (cutoff === Number.NEGATIVE_INFINITY)
+        return phases;
+    return phases.filter((p) => { const t = Date.parse(p.endDate); return !Number.isNaN(t) && t >= cutoff; });
+}
+export function filterPhasesByScope(phases, scope) {
+    if (scope.phase)
+        return phases.filter((p) => p.slug === scope.phase);
+    if (!scope.entry)
+        throw new Error("filterPhasesByScope requires entry or phase");
+    const e = scope.entry;
+    return phases.filter((p) => p.commits.some((c) => c.date.startsWith(e)) || (e >= p.startDate && e <= p.endDate));
+}
+const JOURNAL_KINDS = ["journal-phase", "journal-overview", "journal-rollup"];
+const isJournalPage = (p) => JOURNAL_KINDS.includes(p.type);
+/** True when !force AND manifest has a journal-* page w/ matching slug whose
+ *  journal_content_hashes["phase-summary"] equals currentHash. */
+export function shouldSkipPhaseByHash(slug, currentHash, opts = {}) {
+    if (opts.force || !opts.manifest)
+        return false;
+    const p = opts.manifest.pages.find((x) => x.slug === slug && isJournalPage(x));
+    return p?.journal_content_hashes?.["phase-summary"] === currentHash;
+}
+export function buildJournalManifestEntries(phaseWrites, overviewPresent) {
+    const entries = [];
+    if (overviewPresent)
+        entries.push({
+            slug: "journal-overview", title: "Journal — Overview", type: "journal-overview",
+            file: "journal/overview.md", outbound_links: [], source: "generated",
+        });
+    for (const w of phaseWrites)
+        entries.push({
+            slug: w.slug, title: w.title, type: "journal-phase",
+            file: w.file, outbound_links: [], source: "generated",
+            journal_content_hashes: { "phase-summary": w.hash },
+        });
+    return entries;
+}
+export function mergeJournalIntoManifest(existing, journalEntries) {
+    const base = existing ?? {
+        manifest_schema_version: "2.1.0", generated_at: new Date().toISOString(),
+        index_hash: "", git_commit: "", pages: [], slug_redirects: {},
+        token_estimates: {}, file_to_community: {}, degraded: false,
+    };
+    const kept = base.pages.filter((p) => !isJournalPage(p));
+    return { ...base, pages: [...kept, ...journalEntries], generated_at: new Date().toISOString() };
+}
+export function renderJournalSectionMd(entries) {
+    const overview = entries.find((e) => e.type === "journal-overview");
+    const phases = entries.filter((e) => e.type === "journal-phase").slice()
+        .sort((a, b) => a.slug.localeCompare(b.slug));
+    const lines = ["## journal", "",
+        "Weekly phase narratives auto-registered from journal-init / journal-append.", ""];
+    const bullet = (e, tail) => `- [${e.file.replace(/\.md$/, "")}](${e.file}) — ${tail}`;
+    if (overview)
+        lines.push(bullet(overview, "At a glance / Themes / Sources"));
+    for (const p of phases)
+        lines.push(bullet(p, p.title));
+    lines.push("");
+    return lines.join("\n");
+}
+export function insertJournalSectionIntoIndex(indexMd, sectionMd) {
+    const section = sectionMd.endsWith("\n") ? sectionMd : sectionMd + "\n";
+    const lines = indexMd.split("\n");
+    const sandwich = (startIdx, endIdx) => {
+        const before = lines.slice(0, startIdx).join("\n").replace(/\n+$/, "");
+        const after = lines.slice(endIdx).join("\n").replace(/^\n+/, "");
+        return (before.length > 0 ? before + "\n\n" : "") + section + (after.length > 0 ? "\n" + after : "");
+    };
+    const jIdx = lines.findIndex((l) => /^## journal\s*$/.test(l));
+    if (jIdx >= 0) {
+        let end = lines.length;
+        for (let i = jIdx + 1; i < lines.length; i++)
+            if (/^## /.test(lines[i])) {
+                end = i;
+                break;
+            }
+        return sandwich(jIdx, end);
+    }
+    const hubsIdx = lines.findIndex((l) => /^## hubs\s*$/.test(l));
+    if (hubsIdx >= 0)
+        return sandwich(hubsIdx, hubsIdx);
+    const trimmed = indexMd.replace(/\n+$/, "");
+    return (trimmed.length > 0 ? trimmed + "\n\n" : "") + section;
+}
+export async function readManifestIfExists(path) {
+    try {
+        return JSON.parse(await readFile(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+/** Atomic write with TOCTOU guard: re-read + hash-check before tmp→rename. */
+export async function writePhaseAtomic(filePath, content, preHash, force) {
+    if (preHash !== undefined) {
+        let latest = "";
+        try {
+            latest = await readFile(filePath, "utf-8");
+        }
+        catch { /* new file */ }
+        try {
+            assertBlockUnchanged(latest, "phase-summary", preHash);
+        }
+        catch (err) {
+            if (!(err instanceof BlockChangedError))
+                throw err;
+            if (!force)
+                throw err;
+            console.warn("WARN journal: forced overwrite");
+        }
+    }
+    const tmp = `${filePath}.${randomUUID()}.tmp`;
+    await writeFile(tmp, content, { encoding: "utf-8", flag: "wx" });
+    await rename(tmp, filePath);
+}
+// ─── Phase E: overview refresh helpers (pure functions) ─────────────────────
+const FOUR_BEAT = new Set(["Intent", "Reality", "Significance", "Lessons"]);
+export async function extractPhaseTitle(filePath, fallback) {
+    try {
+        const content = await readFile(filePath, "utf-8");
+        for (const m of content.matchAll(/^## (.+)$/gm)) {
+            const title = m[1].trim();
+            if (!FOUR_BEAT.has(title))
+                return title;
+        }
+        return fallback;
+    }
+    catch {
+        return fallback;
+    }
+}
+export function rewriteOverviewPhasesList(existing, phaseWrites) {
+    const listLines = phaseWrites.map((p) => `- [${p.title}](phases/${p.slug}.md)`);
+    const section = ["## Phases", "", ...listLines, "", "← back to [wiki index](../index.md)", ""].join("\n");
+    const phasesIdx = existing.search(/^## Phases$/m);
+    if (phasesIdx !== -1) {
+        // Strip from `## Phases` through end-of-file OR next `## ` (not ##Phases itself).
+        const after = existing.slice(phasesIdx + "## Phases".length);
+        const nextMatch = /\n## /m.exec(after);
+        const tailStart = nextMatch ? phasesIdx + "## Phases".length + nextMatch.index + 1 : existing.length;
+        return existing.slice(0, phasesIdx) + section + (tailStart < existing.length ? existing.slice(tailStart) : "");
+    }
+    if (existing.includes("<!-- manual:end migrated-overview -->")) {
+        return existing.replace("<!-- manual:end migrated-overview -->", "<!-- manual:end migrated-overview -->\n\n" + section);
+    }
+    return existing + (existing.endsWith("\n") ? "" : "\n") + "\n" + section;
+}
+//# sourceMappingURL=journal-generator-helpers.js.map

package/dist/tools/journal-generator-helpers.js.map

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

package/dist/tools/journal-generator.d.ts

@@ -0,0 +1,48 @@
+import { type PhasePlan } from "./journal-phase-detector.js";
+import { selectProvider } from "./journal-llm-client.js";
+export interface JournalRunOptions {
+    cwd: string;
+    outputDir: string;
+    dryRun?: boolean;
+    force?: boolean;
+    bulkFill?: boolean;
+    checkpointPath?: string;
+    lockPath?: string;
+    /** gitLog filter — git-relative string like "2 weeks ago" or ISO date. */
+    since?: string;
+    /** Regenerate only this entry date (YYYY-MM-DD); mutually exclusive with phase. */
+    entry?: string;
+    /** Regenerate only this phase slug; mutually exclusive with entry. */
+    phase?: string;
+}
+export interface JournalRunResult {
+    status: "ok" | "planned" | "locked" | "aborted" | "capped" | "skipped";
+    phases: Array<{
+        slug: string;
+        file: string;
+        costUsd: number;
+    }>;
+    reason?: string;
+}
+export interface ProcessContext {
+    provider: ReturnType<typeof selectProvider>;
+    outputDir: string;
+    force: boolean;
+}
+export interface PhaseWriteResult {
+    slug: string;
+    content: string;
+    hash: string;
+    costUsd: number;
+}
+/** Seam: per-phase LLM + validation (no fs). Exported for tests. */
+export declare function processPhase(phase: PhasePlan, ctx: ProcessContext): Promise<PhaseWriteResult>;
+export declare function runJournalInit(opts: JournalRunOptions): Promise<JournalRunResult>;
+export declare function runJournalAppend(opts: JournalRunOptions): Promise<JournalRunResult>;
+export declare function runJournalRegenerate(opts: JournalRunOptions): Promise<JournalRunResult>;
+/** Rewrite overview.md / index.md journal section from the current phase files
+ *  on disk — no LLM, no credentials needed. Preserves the
+ *  `<!-- manual:begin migrated-overview -->` block in overview.md verbatim,
+ *  regenerates the Phases list below it from the files in phases/. */
+export declare function refreshOverviewAndRollup(opts: JournalRunOptions): Promise<JournalRunResult>;
+//# sourceMappingURL=journal-generator.d.ts.map

package/dist/tools/journal-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-generator.d.ts","sourceRoot":"","sources":["../../src/tools/journal-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAwB,MAAM,yBAAyB,CAAC;AAkB/E,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvE,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAWD,oEAAoE;AACpE,wBAAsB,YAAY,CAChC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,cAAc,GACpC,OAAO,CAAC,gBAAgB,CAAC,CAM3B;AA0HD,wBAAsB,cAAc,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEvF;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAMzF;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQ7F;AAED;;;sEAGsE;AACtE,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2BjG"}

package/dist/tools/journal-generator.js

@@ -0,0 +1,204 @@
+import { readdir, readFile, writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { gitLog } from "./journal-git-client.js";
+import { detectPhases } from "./journal-phase-detector.js";
+import { selectProvider, CostCapExceededError } from "./journal-llm-client.js";
+import { buildScaffoldResponse, renderPhaseSummaryPrompt, validateLlmResponse } from "./journal-templates.js";
+import { computeBlockHash } from "./journal-sentinel.js";
+import { BlockChangedError, acquireLock, releaseLock, readCheckpoint, writeCheckpoint, enforceBudgets, anyFileHasTodo, readPhaseBlockHash, writePhaseAtomic, assertSafeSlug, filterPhasesBySince, filterPhasesByScope, buildJournalManifestEntries, mergeJournalIntoManifest, renderJournalSectionMd, insertJournalSectionIntoIndex, readManifestIfExists, shouldSkipPhaseByHash, extractPhaseTitle, rewriteOverviewPhasesList, } from "./journal-generator-helpers.js";
+function applyFilter(phases, filter, cwd) {
+    if (!filter)
+        return phases;
+    if (filter.kind === "since")
+        return filterPhasesBySince(phases, filter.value, cwd);
+    return filterPhasesByScope(phases, filter.kind === "entry" ? { entry: filter.value } : { phase: filter.value });
+}
+/** Seam: per-phase LLM + validation (no fs). Exported for tests. */
+export async function processPhase(phase, ctx) {
+    const prompt = renderPhaseSummaryPrompt(phase);
+    const model = process.env["CODESIFT_JOURNAL_MODEL"] ?? "claude-sonnet-4-6";
+    const r = await ctx.provider.generate(prompt, { model });
+    const content = validateLlmResponse(r.content).ok ? r.content : buildScaffoldResponse(phase);
+    return { slug: phase.slug, content, hash: computeBlockHash(content), costUsd: r.costUsd };
+}
+const PLACEHOLDER_COMMIT = {
+    sha: "0".repeat(40), date: "2026-04-01T00:00:00Z", authorName: "",
+    subject: "feat(init): init", parentShas: [], refs: [],
+};
+async function guardE8(phasesDir, cfg) {
+    let existing = [];
+    try {
+        existing = await readdir(phasesDir);
+    }
+    catch { /* not created yet */ }
+    if (existing.length === 0 || cfg.allowNonEmpty || cfg.bulkFill)
+        return null;
+    if (await anyFileHasTodo(phasesDir, existing))
+        return null;
+    return "phases/ is non-empty — use 'journal append' instead, or pass --bulk-fill";
+}
+async function runPipeline(opts, cfg) {
+    const journalDir = join(opts.outputDir, "journal");
+    const phasesDir = join(journalDir, "phases");
+    const lockPath = opts.lockPath ?? join(journalDir, ".init-lock");
+    const checkpointPath = opts.checkpointPath ?? join(journalDir, ".checkpoint.json");
+    await mkdir(phasesDir, { recursive: true }); // ensure dir exists before lockfile
+    try {
+        await acquireLock(lockPath);
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "EEXIST")
+            return { status: "locked", phases: [], reason: "journal operation already in progress" };
+        throw err;
+    }
+    try {
+        const commits = gitLog({ cwd: opts.cwd });
+        const allPhases = detectPhases(commits.length > 0 ? commits : [PLACEHOLDER_COMMIT], undefined, { minUnclassifiedCommits: 3 });
+        const phases = applyFilter(allPhases, cfg.filter, opts.cwd);
+        if (opts.dryRun) {
+            return {
+                status: "planned",
+                phases: phases.map((p) => {
+                    assertSafeSlug(p.slug);
+                    return { slug: p.slug, file: join(phasesDir, `${p.slug}.md`), costUsd: 0 };
+                }),
+            };
+        }
+        const abortReason = await guardE8(phasesDir, cfg);
+        if (abortReason)
+            return { status: "aborted", phases: [], reason: abortReason };
+        const cp = await readCheckpoint(checkpointPath);
+        const completed = new Set(cp?.completed ?? []);
+        let runningCost = cp?.costUsd ?? 0;
+        const startedAt = cp?.startedAt ?? new Date().toISOString();
+        const maxCost = Number(process.env["CODESIFT_JOURNAL_MAX_USD"] ?? 2.0);
+        const provider = selectProvider();
+        const results = [];
+        const phaseWrites = [];
+        const manifestPath = join(opts.outputDir, "wiki-manifest.json");
+        const existingManifest = await readManifestIfExists(manifestPath);
+        for (const phase of phases) {
+            assertSafeSlug(phase.slug);
+            if (completed.has(phase.slug))
+                continue;
+            const filePath = join(phasesDir, `${phase.slug}.md`);
+            const preHash = await readPhaseBlockHash(filePath, "phase-summary");
+            if (preHash !== undefined &&
+                shouldSkipPhaseByHash(phase.slug, preHash, { force: cfg.force, manifest: existingManifest })) {
+                continue;
+            }
+            try {
+                const r = await processPhase(phase, { provider, outputDir: opts.outputDir, force: cfg.force });
+                runningCost += r.costUsd;
+                if (runningCost > maxCost)
+                    throw new CostCapExceededError(runningCost, maxCost);
+                enforceBudgets({ [`${phase.slug}.md`]: r.content });
+                await writePhaseAtomic(filePath, r.content, preHash, cfg.force);
+                completed.add(phase.slug);
+                await writeCheckpoint(checkpointPath, { startedAt, completed: [...completed], costUsd: runningCost });
+                results.push({ slug: phase.slug, file: filePath, costUsd: r.costUsd });
+                phaseWrites.push({
+                    slug: phase.slug, title: phase.title,
+                    file: `journal/phases/${phase.slug}.md`, hash: r.hash,
+                });
+            }
+            catch (err) {
+                if (err instanceof CostCapExceededError) {
+                    await writeCheckpoint(checkpointPath, { startedAt, completed: [...completed], costUsd: runningCost });
+                    return { status: "capped", phases: results, reason: err.message };
+                }
+                if (err instanceof BlockChangedError) {
+                    return { status: "aborted", phases: results, reason: err.message };
+                }
+                throw err;
+            }
+        }
+        if (phaseWrites.length > 0) {
+            await updateManifestAndIndex(opts.outputDir, phaseWrites, journalDir);
+        }
+        return { status: "ok", phases: results };
+    }
+    finally {
+        await releaseLock(lockPath);
+    }
+}
+/** Best-effort manifest + index register; failures WARN only (CQ8). */
+async function updateManifestAndIndex(outputDir, phaseWrites, journalDir) {
+    const manifestPath = join(outputDir, "wiki-manifest.json");
+    const indexPath = join(outputDir, "index.md");
+    const overviewPresent = await readFile(join(journalDir, "overview.md"), "utf-8").then(() => true).catch(() => false);
+    const entries = buildJournalManifestEntries(phaseWrites, overviewPresent);
+    try {
+        const merged = mergeJournalIntoManifest(await readManifestIfExists(manifestPath), entries);
+        await writeFile(manifestPath, JSON.stringify(merged, null, 2), "utf-8");
+    }
+    catch (err) {
+        console.warn(`WARN journal: could not update wiki-manifest.json (${err.message})`);
+        return;
+    }
+    try {
+        const existingIndex = await readFile(indexPath, "utf-8").catch(() => "");
+        await writeFile(indexPath, insertJournalSectionIntoIndex(existingIndex, renderJournalSectionMd(entries)), "utf-8");
+    }
+    catch (err) {
+        console.warn(`WARN journal: could not update index.md (${err.message})`);
+    }
+}
+export async function runJournalInit(opts) {
+    return runPipeline(opts, { force: !!opts.force, bulkFill: !!opts.bulkFill, allowNonEmpty: false });
+}
+export async function runJournalAppend(opts) {
+    if (!opts.since)
+        return { status: "aborted", phases: [], reason: "runJournalAppend requires options.since" };
+    return runPipeline(opts, {
+        force: !!opts.force, bulkFill: true, allowNonEmpty: true,
+        filter: { kind: "since", value: opts.since },
+    });
+}
+export async function runJournalRegenerate(opts) {
+    if (!opts.entry && !opts.phase) {
+        return { status: "aborted", phases: [], reason: "runJournalRegenerate requires entry or phase" };
+    }
+    const filter = opts.entry
+        ? { kind: "entry", value: opts.entry }
+        : { kind: "phase", value: opts.phase };
+    return runPipeline(opts, { force: !!opts.force, bulkFill: true, allowNonEmpty: true, filter });
+}
+/** Rewrite overview.md / index.md journal section from the current phase files
+ *  on disk — no LLM, no credentials needed. Preserves the
+ *  `<!-- manual:begin migrated-overview -->` block in overview.md verbatim,
+ *  regenerates the Phases list below it from the files in phases/. */
+export async function refreshOverviewAndRollup(opts) {
+    const journalDir = join(opts.outputDir, "journal");
+    const phasesDir = join(journalDir, "phases");
+    const overviewPath = join(journalDir, "overview.md");
+    let phaseFiles = [];
+    try {
+        phaseFiles = (await readdir(phasesDir)).filter((f) => f.endsWith(".md")).sort();
+    }
+    catch {
+        return { status: "aborted", phases: [], reason: "no phases/ directory" };
+    }
+    const phaseWrites = [];
+    for (const f of phaseFiles) {
+        const slug = f.slice(0, -3); // strip .md
+        assertSafeSlug(slug);
+        const filePath = join(phasesDir, f);
+        const hash = (await readPhaseBlockHash(filePath, "phase-summary")) ?? "";
+        const title = await extractPhaseTitle(filePath, slug);
+        phaseWrites.push({ slug, title, file: `journal/phases/${f}`, hash });
+    }
+    // Rewrite overview.md preserving the manual block; append/replace the Phases list.
+    const existingOverview = await readFile(overviewPath, "utf-8").catch(() => "");
+    const updatedOverview = rewriteOverviewPhasesList(existingOverview, phaseWrites);
+    try {
+        await writeFile(overviewPath, updatedOverview, "utf-8");
+    }
+    catch (err) {
+        console.warn(`WARN journal: could not write overview.md (${err.message})`);
+    }
+    await updateManifestAndIndex(opts.outputDir, phaseWrites, journalDir);
+    return { status: "ok", phases: phaseWrites.map((p) => ({ slug: p.slug, file: join(phasesDir, `${p.slug}.md`), costUsd: 0 })) };
+}
+//# sourceMappingURL=journal-generator.js.map

package/dist/tools/journal-generator.js.map

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

package/dist/tools/journal-git-client.d.ts

@@ -0,0 +1,20 @@
+export declare const GIT_LOG_FORMAT = "%H%x1F%aI%x1F%an%x1F%s%x1F%P%x1F%D";
+export declare const GIT_TIMEOUT_MS = 10000;
+export interface GitLogOptions {
+    /** ISO date or git-relative string like "2 weeks ago" */
+    since?: string;
+    maxCount?: number;
+    cwd?: string;
+}
+export interface GitCommit {
+    sha: string;
+    /** ISO8601 author date */
+    date: string;
+    /** Author name only — no email (CQ5 privacy) */
+    authorName: string;
+    subject: string;
+    parentShas: string[];
+    refs: string[];
+}
+export declare function gitLog(opts?: GitLogOptions): GitCommit[];
+//# sourceMappingURL=journal-git-client.d.ts.map

package/dist/tools/journal-git-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-git-client.d.ts","sourceRoot":"","sources":["../../src/tools/journal-git-client.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,uCAAuC,CAAC;AACnE,eAAO,MAAM,cAAc,QAAS,CAAC;AAErC,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAgB,MAAM,CAAC,IAAI,GAAE,aAAkB,GAAG,SAAS,EAAE,CA2D5D"}

package/dist/tools/journal-git-client.js

@@ -0,0 +1,57 @@
+import { execFileSync } from "node:child_process";
+export const GIT_LOG_FORMAT = "%H%x1F%aI%x1F%an%x1F%s%x1F%P%x1F%D";
+export const GIT_TIMEOUT_MS = 10_000;
+export function gitLog(opts = {}) {
+    const { since, maxCount, cwd } = opts;
+    const args = [
+        "log",
+        `--pretty=format:${GIT_LOG_FORMAT}`,
+        "--all",
+    ];
+    if (maxCount !== undefined) {
+        args.push(`--max-count=${maxCount}`);
+    }
+    if (since !== undefined) {
+        args.push(`--since=${since}`);
+    }
+    let raw;
+    try {
+        raw = execFileSync("git", args, {
+            encoding: "utf-8",
+            timeout: GIT_TIMEOUT_MS,
+            cwd,
+        });
+    }
+    catch (err) {
+        const e = err;
+        if (e.status === 128) {
+            // Not a git repo or no commits yet — treat as empty history.
+            return [];
+        }
+        throw new Error(`gitLog failed: ${e.message ?? String(err)}`);
+    }
+    if (!raw.trim())
+        return [];
+    const commits = [];
+    let skipped = 0;
+    for (const line of raw.split("\n")) {
+        if (!line)
+            continue;
+        const fields = line.split("\x1F");
+        if (fields.length !== 6) {
+            skipped++;
+            continue;
+        }
+        const [sha, date, authorName, subject, parentsRaw, refsRaw] = fields;
+        commits.push({
+            sha, date, authorName, subject,
+            parentShas: parentsRaw.split(" ").filter((s) => s.length > 0),
+            refs: refsRaw.split(", ").filter((s) => s.length > 0),
+        });
+    }
+    if (skipped > 0) {
+        console.warn(`[journal-git-client] skipped ${skipped} malformed log line(s)`);
+    }
+    return commits;
+}
+//# sourceMappingURL=journal-git-client.js.map

package/dist/tools/journal-git-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-git-client.js","sourceRoot":"","sources":["../../src/tools/journal-git-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,MAAM,cAAc,GAAG,oCAAoC,CAAC;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AAoBrC,MAAM,UAAU,MAAM,CAAC,OAAsB,EAAE;IAC7C,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEtC,MAAM,IAAI,GAAa;QACrB,KAAK;QACL,mBAAmB,cAAc,EAAE;QACnC,OAAO;KACR,CAAC;IAEF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE;YAC9B,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,cAAc;YACvB,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,GAA4C,CAAC;QACvD,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACrB,6DAA6D;YAC7D,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,IAAI,KAAK,CACb,kBAAkB,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAC7C,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAE3B,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAAC,OAAO,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QAEjD,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,GACzD,MAA0D,CAAC;QAE7D,OAAO,CAAC,IAAI,CAAC;YACX,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO;YAC9B,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YAC7D,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,gCAAgC,OAAO,wBAAwB,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}