@interf/compiler 0.5.1 → 0.6.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@interf/compiler",
-  "version": "0.5.1",
-  "description": "Interf Compiler is a local runtime for data-processing workflows that prepare datasets for accurate local agent use.",
+  "version": "0.6.3",
+  "description": "Interf prepares task context for your agents by testing the files behind a task, building a local context folder, and using self-improving loops until checks pass.",
   "type": "module",
   "bin": {
     "interf": "dist/bin.js"
@@ -14,38 +14,63 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./compiler": {
+      "types": "./dist/packages/compiler/index.d.ts",
+      "import": "./dist/packages/compiler/index.js"
+    },
+    "./workflow-package": {
+      "types": "./dist/packages/workflow-package/index.d.ts",
+      "import": "./dist/packages/workflow-package/index.js"
+    },
+    "./workflow-authoring": {
+      "types": "./dist/packages/workflow-authoring/index.d.ts",
+      "import": "./dist/packages/workflow-authoring/index.js"
+    },
+    "./project-model": {
+      "types": "./dist/packages/project-model/index.d.ts",
+      "import": "./dist/packages/project-model/index.js"
+    },
+    "./agents": {
+      "types": "./dist/packages/agents/index.d.ts",
+      "import": "./dist/packages/agents/index.js"
+    },
+    "./testing": {
+      "types": "./dist/packages/testing/index.d.ts",
+      "import": "./dist/packages/testing/index.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
     "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc && chmod 755 dist/bin.js",
     "dev": "tsc --watch",
-    "refresh:bootstrap-mirror": "node scripts/sync-bootstrap-mirror.mjs",
-    "test:matrix": "npm run build && node scripts/test-matrix.mjs",
+    "refresh:bootstrap-mirror": "node scripts/docs/sync-bootstrap-mirror.mjs",
+    "test:matrix": "npm run build && node scripts/matrix/run.mjs",
     "test:smoke": "npm run build && node --test test/**/*.test.mjs",
     "test": "npm run test:smoke",
     "test:e2e": "npm run test:acceptance-live",
     "test:e2e:claude": "npm run test:acceptance-live -- --agent claude-code",
     "test:e2e:codex": "npm run test:acceptance-live -- --agent codex",
     "test:e2e:quick": "npm run test:e2e:quick:matrix",
-    "test:e2e:quick:agent": "node scripts/run-quick-e2e.mjs",
+    "test:e2e:quick:agent": "node scripts/acceptance/run-quick-e2e.mjs",
     "test:e2e:quick:claude": "npm run test:e2e:quick:agent -- --agent claude-code",
     "test:e2e:quick:codex": "npm run test:e2e:quick:agent -- --agent codex",
     "test:e2e:quick:matrix": "npm run test:e2e:quick:claude && npm run test:e2e:quick:codex",
-    "test:internal:cbre:fast": "npm run test:matrix -- --matrix internal/test-matrices/cbre-chart-sanity.json",
-    "test:internal:cbre:fast:keep": "npm run test:matrix -- --matrix internal/test-matrices/cbre-chart-sanity.json --keep-project-clones",
-    "test:internal:cbre:max": "npm run test:matrix -- --matrix internal/test-matrices/cbre-chart-tier1-max.json",
-    "test:internal:cbre:max:keep": "npm run test:matrix -- --matrix internal/test-matrices/cbre-chart-tier1-max.json --keep-project-clones",
+    "test:matrix:cbre:fast": "npm run test:matrix -- --matrix test/matrices/cbre-chart-sanity.json",
+    "test:matrix:cbre:fast:keep": "npm run test:matrix -- --matrix test/matrices/cbre-chart-sanity.json --keep-project-clones",
+    "test:matrix:cbre:max": "npm run test:matrix -- --matrix test/matrices/cbre-chart-tier1-max.json",
+    "test:matrix:cbre:max:keep": "npm run test:matrix -- --matrix test/matrices/cbre-chart-tier1-max.json --keep-project-clones",
     "test:full": "npm test && npm run test:e2e:quick:matrix",
-    "test:release:matrix": "npm run test:internal:cbre:max",
-    "test:release": "npm test && npm run test:acceptance-live -- --agent claude-code --with-test && npm run test:acceptance-live -- --agent codex --with-test",
-    "test:acceptance-live": "npm run build && node scripts/acceptance-live.mjs",
-    "test:acceptance-cache:refresh": "npm run test:acceptance-cache:refresh:claude && npm run test:acceptance-cache:refresh:codex",
-    "test:acceptance-cache:refresh:claude": "node scripts/acceptance-cache-refresh.mjs --agent claude-code",
-    "test:acceptance-cache:refresh:codex": "node scripts/acceptance-cache-refresh.mjs --agent codex",
-    "test:acceptance-quick:create-compiled": "npm run build && node scripts/acceptance-targeted.mjs create-compiled",
-    "test:acceptance-quick:compiled-query": "npm run build && node scripts/acceptance-targeted.mjs compiled-query",
-    "test:acceptance-quick:self-improving": "npm run build && node scripts/acceptance-targeted.mjs self-improving-compile",
-    "prepublishOnly": "node scripts/prepublish-gate.mjs"
+    "test:release:matrix": "npm run test:matrix:cbre:max",
+    "test:release": "npm test && npm run test:acceptance-quick:workflow-authoring -- --agent claude-code && npm run test:acceptance-live -- --agent claude-code --with-test && npm run test:acceptance-quick:workflow-authoring -- --agent codex && npm run test:acceptance-live -- --agent codex --with-test",
+    "test:acceptance-live": "npm run build && node scripts/acceptance/live.mjs",
+    "test:e2e:quick:refresh-cache": "npm run test:e2e:quick:refresh-cache:claude && npm run test:e2e:quick:refresh-cache:codex",
+    "test:e2e:quick:refresh-cache:claude": "node scripts/acceptance/refresh-quick-cache.mjs --agent claude-code",
+    "test:e2e:quick:refresh-cache:codex": "node scripts/acceptance/refresh-quick-cache.mjs --agent codex",
+    "test:acceptance-quick:create-compiled": "npm run build && node scripts/acceptance/targeted.mjs create-compiled",
+    "test:acceptance-quick:compiled-query": "npm run build && node scripts/acceptance/targeted.mjs compiled-query",
+    "test:acceptance-quick:workflow-authoring": "npm run build && node scripts/acceptance/targeted.mjs workflow-authoring",
+    "test:acceptance-quick:self-improving": "npm run build && node scripts/acceptance/targeted.mjs self-improving-compile",
+    "prepublishOnly": "node scripts/release/prepublish-gate.mjs"
   },
   "files": [
     "dist",
@@ -59,8 +84,6 @@
     "interf",
     "ai",
     "agent",
-    "knowledge",
-    "obsidian",
     "coding-agent",
     "claude",
     "codex"

package/dist/commands/compile.d.ts

@@ -1,15 +0,0 @@
-import type { SourceDatasetConfig } from "../lib/schema.js";
-import type { CommandModule } from "yargs";
-export { runConfiguredCompiledCompile } from "./compile-controller.js";
-export declare const compileCommand: CommandModule;
-export declare function runCompileCommand(argv?: Record<string, unknown>): Promise<void>;
-export declare function resolveInteractiveCompileLoopOverrides(options: {
-    compiledPath: string;
-    compiledConfig: SourceDatasetConfig | null;
-    maxAttemptsOverride: number | null;
-    maxLoopsOverride: number | null;
-}): Promise<{
-    compiledConfig: SourceDatasetConfig | null;
-    maxAttemptsOverride: number | null;
-    maxLoopsOverride: number | null;
-} | null>;

package/dist/commands/create-workflow-wizard.js

@@ -1,125 +0,0 @@
-import chalk from "chalk";
-import * as p from "@clack/prompts";
-import { listCompiledWorkflowChoices, } from "../lib/workflow-definitions.js";
-import { createLocalWorkflowPackageFromTemplate } from "../lib/interf-workflow-package.js";
-import { isWorkflowId, } from "../lib/local-workflows.js";
-import { slugify } from "../lib/util.js";
-export const clackWorkflowPrompts = {
-    intro: p.intro,
-    select: (options) => p.select(options),
-    text: (options) => p.text(options),
-    isCancel: p.isCancel,
-    log: {
-        info: p.log.info,
-    },
-};
-export function formatWorkflowLabel(workflow) {
-    return {
-        value: workflow.id,
-        label: workflow.scope === "local" ? `${workflow.label} (Local)` : workflow.label,
-        hint: workflow.hint,
-    };
-}
-export function buildCompiledWorkflowOptions(sourcePath) {
-    return listCompiledWorkflowChoices(sourcePath).map(formatWorkflowLabel);
-}
-export async function chooseCompiledWorkflow(sourcePath, options = {}) {
-    const currentWorkflowId = options.currentWorkflowId;
-    const workflowOptions = buildCompiledWorkflowOptions(sourcePath);
-    const orderedOptions = workflowOptions
-        .map((option) => option.value === currentWorkflowId
-        ? {
-            ...option,
-            label: `${option.label} (Current)`,
-            hint: option.hint,
-        }
-        : option)
-        .sort((left, right) => {
-        if (left.value === currentWorkflowId)
-            return -1;
-        if (right.value === currentWorkflowId)
-            return 1;
-        return 0;
-    });
-    if (orderedOptions.length === 1) {
-        return orderedOptions[0]?.value ?? "interf";
-    }
-    return p.select({
-        message: options.message ?? "Dataset workflow?",
-        options: orderedOptions,
-    });
-}
-export async function createWorkflowWizard(options = {}, prompts = clackWorkflowPrompts) {
-    if (options.intro !== false) {
-        prompts.intro(chalk.bold("Create a workflow"));
-    }
-    const sourcePath = options.sourcePath ?? process.cwd();
-    return createCompiledWorkflowWizard(sourcePath, prompts);
-}
-export async function createCompiledWorkflowWizard(sourcePath, prompts = clackWorkflowPrompts) {
-    const baseWorkflow = await prompts.select({
-        message: "Start from which existing workflow?",
-        options: listCompiledWorkflowChoices(sourcePath).map(formatWorkflowLabel),
-    });
-    if (prompts.isCancel(baseWorkflow))
-        return baseWorkflow;
-    const rawName = await prompts.text({
-        message: "New workflow name?",
-        placeholder: "founder-research",
-        validate: (value) => {
-            if (value.trim().length === 0)
-                return "Name is required";
-            const workflowId = slugify(value);
-            if (!isWorkflowId(workflowId))
-                return "Use letters, numbers, and dashes only";
-            if (listCompiledWorkflowChoices(sourcePath).some((workflow) => workflow.id === workflowId)) {
-                return "That workflow name already exists";
-            }
-            return undefined;
-        },
-    });
-    if (prompts.isCancel(rawName))
-        return rawName;
-    const workflowId = slugify(rawName);
-    const label = rawName.trim();
-    const hint = await prompts.text({
-        message: "One-line workflow description?",
-        placeholder: "Bias toward evidence-backed summaries and strong retrieval structure",
-        validate: (value) => (value.trim().length === 0 ? "Description is required" : undefined),
-    });
-    if (prompts.isCancel(hint))
-        return hint;
-    const summarizeBias = await prompts.text({
-        message: "What should summarize emphasize?",
-        placeholder: "Preserve evidence tiers, decision context, and source metadata",
-        validate: (value) => (value.trim().length === 0 ? "Summarize guidance is required" : undefined),
-    });
-    if (prompts.isCancel(summarizeBias))
-        return summarizeBias;
-    const structureBias = await prompts.text({
-        message: "What should structure emphasize?",
-        placeholder: "Build retrieval-ready entities, claims, timelines, and indexes",
-        validate: (value) => (value.trim().length === 0 ? "Structure guidance is required" : undefined),
-    });
-    if (prompts.isCancel(structureBias))
-        return structureBias;
-    const shapeBias = await prompts.text({
-        message: "What should shape emphasize?",
-        placeholder: "Bias home.md and navigation toward the questions this dataset should answer best",
-        validate: (value) => (value.trim().length === 0 ? "Shape guidance is required" : undefined),
-    });
-    if (prompts.isCancel(shapeBias))
-        return shapeBias;
-    const workflowPath = createLocalWorkflowPackageFromTemplate({
-        sourcePath,
-        baseWorkflowId: baseWorkflow,
-        workflowId,
-        label,
-        hint: hint.trim(),
-        summarizeBias: summarizeBias.trim(),
-        structureBias: structureBias.trim(),
-        shapeBias: shapeBias.trim(),
-    });
-    prompts.log.info(`Saved local workflow: ${workflowPath}`);
-    return workflowId;
-}

package/dist/commands/create.js

@@ -1,162 +0,0 @@
-import chalk from "chalk";
-import { basename } from "node:path";
-import * as p from "@clack/prompts";
-import { detectInterf, defaultCompiledNameForSource, listCompiledDatasetsForSourceFolder, } from "../lib/interf.js";
-import { slugify } from "../lib/util.js";
-import { addExecutionProfileOptions, executionProfileFromArgv, } from "../lib/execution-profile.js";
-import { listSourceDatasetConfigs, loadSourceFolderConfig, upsertSourceDatasetConfig, } from "../lib/source-config.js";
-import { createWorkflowWizard, } from "./create-workflow-wizard.js";
-import { ensureCompiledFromConfig, } from "./compiled-flow.js";
-import { DEFAULT_COMPILED_NAME, promptSingleCompiledConfig, } from "./source-config-wizard.js";
-import { resolveOrConfigureLocalExecutor } from "./executor-flow.js";
-import { runConfiguredCompiledCompile } from "./compile.js";
-function normalizeCreateTarget(value) {
-    if (!value)
-        return null;
-    switch (value) {
-        case "dataset":
-        case "ds":
-            return "dataset";
-        case "workflow":
-        case "wf":
-            return "workflow";
-        default:
-            return null;
-    }
-}
-async function selectCreateTarget() {
-    return p.select({
-        message: "Create what?",
-        options: [
-            {
-                value: "dataset",
-                label: "Dataset (Recommended)",
-                hint: "Add one dataset entry to this project",
-            },
-            {
-                value: "workflow",
-                label: "Workflow",
-                hint: "Create a reusable local workflow",
-            },
-        ],
-    });
-}
-export const createCommand = {
-    command: "create [type]",
-    describe: "Create a dataset entry or reusable workflow",
-    builder: (yargs) => addExecutionProfileOptions(yargs.positional("type", {
-        type: "string",
-        describe: "Type to create (`dataset` or `workflow`)",
-        default: undefined,
-    })),
-    handler: async (argv) => {
-        const rawType = argv.type;
-        let type = normalizeCreateTarget(rawType);
-        const executionProfile = executionProfileFromArgv(argv);
-        if (rawType && !type) {
-            process.exitCode = 1;
-            p.log.error(`Unknown create target: ${rawType}`);
-            return;
-        }
-        if (!type) {
-            const selected = await selectCreateTarget();
-            if (p.isCancel(selected))
-                return;
-            type = selected;
-        }
-        if (type === "workflow") {
-            await createWorkflowWizard({ sourcePath: process.cwd() });
-            return;
-        }
-        await createCompiledWizard({ executionProfile });
-    },
-};
-export async function createCompiledWizard(options = {}) {
-    if (options.intro !== false) {
-        p.intro(chalk.bold("Add a dataset"));
-    }
-    const cwd = process.cwd();
-    const detected = detectInterf(cwd);
-    if (detected) {
-        process.exitCode = 1;
-        p.log.error("You are already inside a compiled dataset.");
-        return;
-    }
-    const existing = listCompiledDatasetsForSourceFolder(cwd);
-    if (existing.length > 0) {
-        p.log.info(`This project already has ${existing.length} compiled dataset${existing.length === 1 ? "" : "s"}. Add another only when you need a separate folder, truth checks, or focus.`);
-    }
-    p.log.info("Interf Compiler measures one dataset at a time. Start with truth checks and a baseline, then build a compiled dataset only when you need it.");
-    const existingConfig = loadSourceFolderConfig(cwd);
-    const suggestedName = slugify(defaultCompiledNameForSource(cwd) || basename(cwd)) || DEFAULT_COMPILED_NAME;
-    const workflowId = "interf";
-    const draft = await promptSingleCompiledConfig({
-        projectPath: cwd,
-        initial: { name: suggestedName },
-        introStyle: existingConfig ? "additional" : "first",
-    });
-    if (!draft)
-        return;
-    const configToSave = {
-        ...draft,
-        workflow: workflowId,
-    };
-    const existingNames = new Set(listSourceDatasetConfigs(existingConfig).map((dataset) => dataset.name));
-    if (existingNames.has(configToSave.name)) {
-        process.exitCode = 1;
-        p.log.error(`Dataset "${configToSave.name}" already exists. Use \`interf\` or \`interf init\` to edit it.`);
-        return;
-    }
-    upsertSourceDatasetConfig(cwd, configToSave);
-    const compileNow = await p.confirm({
-        message: "Build the compiled dataset now? (Recommended)",
-        initialValue: true,
-    });
-    if (p.isCancel(compileNow) || !compileNow) {
-        p.outro(configToSave.checks.length > 0
-            ? "Next:\n  interf test\n  interf compile"
-            : "Next:\n  interf or interf init");
-        return;
-    }
-    const { executor, error } = await resolveOrConfigureLocalExecutor({
-        executionProfile: options.executionProfile,
-        purpose: "compile",
-    });
-    if (!executor && !error) {
-        return;
-    }
-    if (!executor) {
-        process.exitCode = 1;
-        p.log.error(error ?? "No coding agent detected.");
-        return;
-    }
-    const spinner = p.spinner();
-    spinner.start("Preparing compiled dataset...");
-    let compiledPath = "";
-    try {
-        compiledPath = ensureCompiledFromConfig(cwd, configToSave);
-        spinner.stop("Compiled dataset target ready.");
-    }
-    catch (error) {
-        spinner.stop("Compiled dataset target preparation failed.");
-        process.exitCode = 1;
-        p.log.error(error instanceof Error ? error.message : String(error));
-        return;
-    }
-    await compileCompiledAfterCreate(executor, cwd, configToSave, compiledPath, options.executionProfile);
-}
-async function compileCompiledAfterCreate(executor, sourcePath, datasetConfig, compiledPath, executionProfile) {
-    const compiled = await runConfiguredCompiledCompile({
-        executor,
-        compiledPath,
-        sourcePath,
-        compiledConfig: datasetConfig,
-        executionProfile,
-        maxAttemptsOverride: null,
-        maxLoopsOverride: null,
-    });
-    if (!compiled)
-        process.exitCode = 1;
-    return compiled;
-}
-export { formatWorkflowLabel, chooseCompiledWorkflow, createWorkflowWizard, createCompiledWorkflowWizard, } from "./create-workflow-wizard.js";

package/dist/commands/init.d.ts

@@ -1,3 +0,0 @@
-import type { CommandModule } from "yargs";
-export declare const initCommand: CommandModule;
-export declare function runInitCommand(): Promise<void>;

package/dist/commands/test.d.ts

@@ -1,9 +0,0 @@
-import type { CommandModule } from "yargs";
-import type { SourceDatasetConfig } from "../lib/schema.js";
-export declare function resolveConfiguredDatasetSelection(options: {
-    sourcePath: string;
-    requestedDatasetName?: string | null;
-    hintedDatasetConfig?: SourceDatasetConfig | null;
-}): SourceDatasetConfig | null;
-export declare const testCommand: CommandModule;
-export declare function runTestCommand(argv?: Record<string, unknown>): Promise<boolean>;

package/dist/lib/compiled-home.d.ts

@@ -1,5 +0,0 @@
-export declare const UNCOMPILED_COMPILED_HOME_NOTICE = "Not yet compiled. Run `interf compile` to build the compiled dataset.";
-export declare function renderUncompiledCompiledHome(compiledName: string, about?: string): string;
-export declare function compiledHomeHasCompilePlaceholder(content: string): boolean;
-export declare function readCompiledHomeContent(dirPath: string): string | null;
-export declare function compiledHomeIsShaped(dirPath: string): boolean;

package/dist/lib/compiled-home.js

@@ -1,32 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import { compiledHomePath } from "./compiled-schema.js";
-export const UNCOMPILED_COMPILED_HOME_NOTICE = "Not yet compiled. Run `interf compile` to build the compiled dataset.";
-export function renderUncompiledCompiledHome(compiledName, about) {
-    return [
-        `# ${compiledName} — Home`,
-        "",
-        UNCOMPILED_COMPILED_HOME_NOTICE,
-        ...(about ? ["", `About: ${about}`] : []),
-        "",
-    ].join("\n");
-}
-export function compiledHomeHasCompilePlaceholder(content) {
-    return content.includes(UNCOMPILED_COMPILED_HOME_NOTICE);
-}
-export function readCompiledHomeContent(dirPath) {
-    const homePath = compiledHomePath(dirPath);
-    if (!existsSync(homePath))
-        return null;
-    try {
-        return readFileSync(homePath, "utf8");
-    }
-    catch {
-        return null;
-    }
-}
-export function compiledHomeIsShaped(dirPath) {
-    const content = readCompiledHomeContent(dirPath);
-    if (content === null)
-        return false;
-    return !compiledHomeHasCompilePlaceholder(content);
-}

package/dist/lib/config.js

@@ -1,9 +0,0 @@
-import { homedir } from "node:os";
-import { join, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-// Package root (dist/lib/ → package root)
-export const PACKAGE_ROOT = join(__dirname, "..", "..");
-// User config
-export const INTERF_HOME = join(homedir(), ".interf");

package/dist/lib/obsidian.d.ts

@@ -1 +0,0 @@
-export declare function writeObsidianDefaults(dirPath: string, type: "compiled"): void;

package/dist/lib/obsidian.js

@@ -1,15 +0,0 @@
-import { mkdirSync, writeFileSync, } from "node:fs";
-import { join } from "node:path";
-export function writeObsidianDefaults(dirPath, type) {
-    const obsidianDir = join(dirPath, ".obsidian");
-    mkdirSync(obsidianDir, { recursive: true });
-    const graphSettings = {
-        "collapse-filter": true,
-        search: 'path:"summaries" OR path:"knowledge" OR path:"home"',
-        showTags: false,
-        showAttachments: false,
-        hideUnresolved: true,
-        showOrphans: false,
-    };
-    writeFileSync(join(obsidianDir, "graph.json"), JSON.stringify(graphSettings, null, 2) + "\n");
-}

package/dist/lib/summarize-plan.d.ts

@@ -1,17 +0,0 @@
-export interface SummarizeTarget {
-    source: string;
-    summary: string | null;
-    output: string;
-    reason: "pending" | "missing_synth" | "changed" | "full_pass";
-}
-export interface SummarizePlan {
-    generatedAt: string;
-    sourceCount: number;
-    summaryCount: number;
-    pendingCount: number;
-    targetCount: number;
-    targets: SummarizeTarget[];
-}
-export declare const SUMMARIZE_PLAN_RELATIVE_PATH: string;
-export declare function buildSummarizePlan(sourcePath: string, compiledPath: string, mode?: "pending" | "all"): SummarizePlan;
-export declare function writeSummarizePlan(compiledPath: string, plan: SummarizePlan): string;

package/dist/lib/summarize-plan.js

@@ -1,120 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
-import { join, relative } from "node:path";
-import { listFilesRecursive } from "./filesystem.js";
-import { builtinCompiledZoneRelativePath, compiledSummariesPath, BUILTIN_COMPILED_ZONE_IDS, } from "./compiled-schema.js";
-import { discoverSourceFiles } from "./discovery.js";
-import { loadState } from "./state.js";
-import { parseJsonFrontmatter } from "./parse.js";
-import { compiledRuntimeRoot } from "./compiled-paths.js";
-export const SUMMARIZE_PLAN_RELATIVE_PATH = join(".interf", "runtime", "summarize-targets.json");
-export function buildSummarizePlan(sourcePath, compiledPath, mode = "pending") {
-    const discovery = discoverSourceFiles(sourcePath, compiledPath);
-    const sourceFiles = discovery.sourceFiles;
-    const summariesDir = compiledSummariesPath(compiledPath);
-    const summaryFiles = listSummaryFiles(summariesDir, compiledPath);
-    const state = loadState(compiledPath);
-    const pending = new Set((state?.pending ?? []).filter((value) => typeof value === "string" && sourceFiles.includes(value)));
-    const summaryIndex = new Map();
-    for (const summary of summaryFiles) {
-        const source = readSourceReference(join(compiledPath, summary));
-        if (source)
-            summaryIndex.set(source, summary);
-    }
-    const targets = new Map();
-    if (mode === "all") {
-        for (const src of sourceFiles) {
-            targets.set(src, {
-                source: src,
-                summary: summaryIndex.get(src) ?? null,
-                output: defaultSummaryPath(src),
-                reason: "full_pass",
-            });
-        }
-        return {
-            generatedAt: new Date().toISOString(),
-            sourceCount: sourceFiles.length,
-            summaryCount: summaryFiles.length,
-            pendingCount: pending.size,
-            targetCount: targets.size,
-            targets: Array.from(targets.values()).sort((a, b) => a.source.localeCompare(b.source)),
-        };
-    }
-    for (const src of pending) {
-        targets.set(src, {
-            source: src,
-            summary: summaryIndex.get(src) ?? null,
-            output: defaultSummaryPath(src),
-            reason: "pending",
-        });
-    }
-    for (const src of sourceFiles) {
-        if (summaryIndex.has(src))
-            continue;
-        if (targets.has(src))
-            continue;
-        targets.set(src, {
-            source: src,
-            summary: null,
-            output: defaultSummaryPath(src),
-            reason: "missing_synth",
-        });
-    }
-    // Detect changed source files (source newer than its summary)
-    for (const [src, summary] of summaryIndex) {
-        if (targets.has(src))
-            continue;
-        const sourceFile = join(sourcePath, src);
-        const synthFile = join(compiledPath, summary);
-        if (!existsSync(sourceFile) || !existsSync(synthFile))
-            continue;
-        try {
-            const sourceMtime = statSync(sourceFile).mtimeMs;
-            const synthMtime = statSync(synthFile).mtimeMs;
-            if (sourceMtime > synthMtime) {
-                targets.set(src, {
-                    source: src,
-                    summary,
-                    output: defaultSummaryPath(src),
-                    reason: "changed",
-                });
-            }
-        }
-        catch {
-            continue;
-        }
-    }
-    return {
-        generatedAt: new Date().toISOString(),
-        sourceCount: sourceFiles.length,
-        summaryCount: summaryFiles.length,
-        pendingCount: pending.size,
-        targetCount: targets.size,
-        targets: Array.from(targets.values()).sort((a, b) => a.source.localeCompare(b.source)),
-    };
-}
-export function writeSummarizePlan(compiledPath, plan) {
-    const planPath = join(compiledPath, SUMMARIZE_PLAN_RELATIVE_PATH);
-    mkdirSync(compiledRuntimeRoot(compiledPath), { recursive: true });
-    writeFileSync(planPath, JSON.stringify(plan, null, 2) + "\n");
-    return planPath;
-}
-function listSummaryFiles(summariesDir, compiledPath) {
-    return listFilesRecursive(summariesDir, (filePath) => filePath.endsWith(".md")).map((filePath) => relative(compiledPath, filePath));
-}
-function readSourceReference(synthPath) {
-    if (!existsSync(synthPath))
-        return null;
-    const content = readFileSync(synthPath, "utf-8");
-    const parsed = parseJsonFrontmatter(content);
-    const source = typeof parsed?.frontmatter.source === "string"
-        ? parsed.frontmatter.source
-        : null;
-    return source?.trim() ?? null;
-}
-function defaultSummaryPath(sourcePath) {
-    const summariesRoot = builtinCompiledZoneRelativePath(BUILTIN_COMPILED_ZONE_IDS.SUMMARIES);
-    if (sourcePath.endsWith(".md"))
-        return `${summariesRoot}/${sourcePath}`;
-    const replaced = sourcePath.replace(/\.[^.]+$/, ".md");
-    return `${summariesRoot}/${replaced === sourcePath ? `${sourcePath}.md` : replaced}`;
-}