@interf/compiler 0.5.0 → 0.6.1

package/dist/lib/workflow-primitives.js

@@ -0,0 +1,5 @@
+export const COMPILED_ZONE_KINDS = [
+    "directory",
+    "file",
+    "runtime",
+];

package/dist/lib/workflow-stage-policy.d.ts

@@ -0,0 +1,5 @@
+export interface StagePolicyStageLike {
+    id: string;
+}
+export declare function normalizeStagePolicyNotes(value: unknown): Record<string, string[]> | undefined;
+export declare function mergeStagePolicyNotesForStages(stages: readonly StagePolicyStageLike[], baseNotes: unknown, overrideNotes: Record<string, string[]> | undefined): Record<string, string[]> | undefined;

package/dist/lib/workflow-stage-policy.js

@@ -0,0 +1,31 @@
+export function normalizeStagePolicyNotes(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const normalized = {};
+    for (const [stageId, notes] of Object.entries(value)) {
+        if (!Array.isArray(notes))
+            continue;
+        const cleaned = Array.from(new Set(notes
+            .filter((note) => typeof note === "string")
+            .map((note) => note.trim())
+            .filter((note) => note.length > 0)));
+        if (cleaned.length > 0) {
+            normalized[stageId] = cleaned;
+        }
+    }
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+}
+export function mergeStagePolicyNotesForStages(stages, baseNotes, overrideNotes) {
+    const normalizedBase = normalizeStagePolicyNotes(baseNotes);
+    const merged = {};
+    for (const stage of stages) {
+        const combined = Array.from(new Set([
+            ...(normalizedBase?.[stage.id] ?? []),
+            ...((overrideNotes?.[stage.id] ?? []).map((note) => note.trim()).filter((note) => note.length > 0)),
+        ]));
+        if (combined.length > 0) {
+            merged[stage.id] = combined;
+        }
+    }
+    return Object.keys(merged).length > 0 ? merged : undefined;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@interf/compiler",
-  "version": "0.5.0",
-  "description": "Interf Compiler is a local runtime for data-processing workflows that turn datasets into compiled datasets for local agents.",
+  "version": "0.6.1",
+  "description": "Interf helps make data ready for agent work. Measure raw files first, then prepare a compiled dataset when you need it.",
   "type": "module",
   "bin": {
     "interf": "dist/bin.js"
@@ -37,13 +37,14 @@
     "test:internal:cbre:max:keep": "npm run test:matrix -- --matrix internal/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:e2e:claude && npm run test:e2e:codex",
+    "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:acceptance-cache:refresh": "npm run test:acceptance-cache:refresh:claude",
-    "test:acceptance-cache:refresh:claude": "npm run build && node scripts/acceptance-live.mjs --agent claude-code --output-root .interf-test-cache/claude-code",
-    "test:acceptance-cache:refresh:codex": "npm run build && node scripts/acceptance-live.mjs --agent codex --output-root .interf-test-cache/codex",
+    "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: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/prepublish-gate.mjs"
   },
@@ -59,8 +60,6 @@
     "interf",
     "ai",
     "agent",
-    "knowledge",
-    "obsidian",
     "coding-agent",
     "claude",
     "codex"

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

@@ -1,2 +0,0 @@
-export declare function normalizeLegacyCompiledLayout(compiledPath: string): boolean;
-export declare function compiledNeedsLegacyLayoutNormalization(compiledPath: string): boolean;

package/dist/lib/compiled-layout.js

@@ -1,60 +0,0 @@
-import { existsSync, mkdirSync, readdirSync, renameSync, } from "node:fs";
-import { dirname, join } from "node:path";
-import { COMPILED_CONFIG_FILE, COMPILED_INTERF_DIR, COMPILED_RUNTIME_DIR, COMPILED_TEST_DIR, COMPILED_WORKFLOW_DIR, workflowPackagePathForCompiled, compiledInterfConfigPath, compiledInterfRoot, compiledRuntimeRoot, } from "./compiled-paths.js";
-const LEGACY_COMPILED_CONFIG_FILE = "interf.json";
-const LEGACY_WORKFLOW_DIR = "workflow";
-function movePathIfMissing(sourcePath, targetPath) {
-    if (!existsSync(sourcePath)) {
-        return false;
-    }
-    if (existsSync(targetPath)) {
-        return false;
-    }
-    mkdirSync(dirname(targetPath), { recursive: true });
-    renameSync(sourcePath, targetPath);
-    return true;
-}
-export function normalizeLegacyCompiledLayout(compiledPath) {
-    const interfRoot = compiledInterfRoot(compiledPath);
-    const runtimeRoot = compiledRuntimeRoot(compiledPath);
-    let changed = false;
-    changed = movePathIfMissing(join(compiledPath, LEGACY_COMPILED_CONFIG_FILE), compiledInterfConfigPath(compiledPath)) || changed;
-    changed = movePathIfMissing(join(compiledPath, LEGACY_WORKFLOW_DIR), workflowPackagePathForCompiled(compiledPath)) || changed;
-    if (!existsSync(interfRoot)) {
-        return changed;
-    }
-    for (const entry of readdirSync(interfRoot)) {
-        if (entry === COMPILED_RUNTIME_DIR ||
-            entry === COMPILED_TEST_DIR ||
-            entry === COMPILED_WORKFLOW_DIR ||
-            entry === COMPILED_CONFIG_FILE) {
-            continue;
-        }
-        changed = movePathIfMissing(join(interfRoot, entry), join(runtimeRoot, entry)) || changed;
-    }
-    return changed;
-}
-export function compiledNeedsLegacyLayoutNormalization(compiledPath) {
-    if (existsSync(join(compiledPath, LEGACY_COMPILED_CONFIG_FILE)) &&
-        !existsSync(compiledInterfConfigPath(compiledPath))) {
-        return true;
-    }
-    if (!existsSync(join(compiledPath, COMPILED_INTERF_DIR)))
-        return false;
-    if (existsSync(join(compiledPath, LEGACY_WORKFLOW_DIR)) &&
-        !existsSync(workflowPackagePathForCompiled(compiledPath))) {
-        return true;
-    }
-    for (const entry of readdirSync(join(compiledPath, COMPILED_INTERF_DIR))) {
-        if (entry === COMPILED_RUNTIME_DIR ||
-            entry === COMPILED_TEST_DIR ||
-            entry === COMPILED_WORKFLOW_DIR ||
-            entry === COMPILED_CONFIG_FILE) {
-            continue;
-        }
-        if (!existsSync(join(compiledRuntimeRoot(compiledPath), entry))) {
-            return true;
-        }
-    }
-    return false;
-}

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,124 +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
-        : typeof parsed?.frontmatter.source_file === "string"
-            ? parsed.frontmatter.source_file
-            : typeof parsed?.frontmatter.raw === "string"
-                ? parsed.frontmatter.raw
-                : 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}`;
-}

package/dist/lib/workflow-abi.d.ts

@@ -1,129 +0,0 @@
-export declare const COMPILED_CONTRACT_TYPES: readonly ["compiled-file-evidence", "compiled-knowledge-structure", "compiled-query-shape"];
-export type CompiledContractType = typeof COMPILED_CONTRACT_TYPES[number];
-export declare const COMPILED_ZONE_KINDS: readonly ["directory", "file", "runtime"];
-export type CompiledZoneKind = typeof COMPILED_ZONE_KINDS[number];
-export declare const COMPILED_CONTRACT_FAMILY_METADATA: {
-    readonly "compiled-file-evidence": {
-        readonly order: 0;
-        readonly bundledSkill: "compile/stages/summarize";
-    };
-    readonly "compiled-knowledge-structure": {
-        readonly order: 1;
-        readonly bundledSkill: "compile/stages/structure";
-    };
-    readonly "compiled-query-shape": {
-        readonly order: 2;
-        readonly bundledSkill: "compile/stages/shape";
-    };
-};
-export declare const BUILTIN_COMPILED_STAGE_IDS: {
-    readonly SUMMARIZE: "summarize";
-    readonly STRUCTURE: "structure";
-    readonly SHAPE: "shape";
-};
-export type BuiltinCompiledStageId = typeof BUILTIN_COMPILED_STAGE_IDS[keyof typeof BUILTIN_COMPILED_STAGE_IDS];
-export declare const BUILTIN_COMPILED_ZONE_IDS: {
-    readonly RAW: "raw";
-    readonly SUMMARIES: "summaries";
-    readonly KNOWLEDGE_ENTITIES: "knowledge-entities";
-    readonly KNOWLEDGE_CLAIMS: "knowledge-claims";
-    readonly KNOWLEDGE_INDEXES: "knowledge-indexes";
-    readonly HOME: "home";
-    readonly RUNTIME: "runtime";
-};
-export type BuiltinCompiledZoneId = typeof BUILTIN_COMPILED_ZONE_IDS[keyof typeof BUILTIN_COMPILED_ZONE_IDS];
-export interface BuiltinCompiledZoneSpec {
-    id: BuiltinCompiledZoneId;
-    path: string;
-    kind: CompiledZoneKind;
-    required: true;
-    description: string;
-}
-export declare const BUILTIN_COMPILED_ZONE_SPECS: readonly [{
-    readonly id: "raw";
-    readonly path: "raw";
-    readonly kind: "directory";
-    readonly required: true;
-    readonly description: "Compiled-local raw snapshot copied from the dataset for direct evidence and verification.";
-}, {
-    readonly id: "summaries";
-    readonly path: "summaries";
-    readonly kind: "directory";
-    readonly required: true;
-    readonly description: "Per-file evidence notes produced by file-evidence stages.";
-}, {
-    readonly id: "knowledge-entities";
-    readonly path: "knowledge/entities";
-    readonly kind: "directory";
-    readonly required: true;
-    readonly description: "Canonical entity notes produced by knowledge-structure stages.";
-}, {
-    readonly id: "knowledge-claims";
-    readonly path: "knowledge/claims";
-    readonly kind: "directory";
-    readonly required: true;
-    readonly description: "Claim notes produced by knowledge-structure stages.";
-}, {
-    readonly id: "knowledge-indexes";
-    readonly path: "knowledge/indexes";
-    readonly kind: "directory";
-    readonly required: true;
-    readonly description: "Retrieval indexes and navigation notes produced by structure and shape stages.";
-}, {
-    readonly id: "home";
-    readonly path: "home.md";
-    readonly kind: "file";
-    readonly required: true;
-    readonly description: "Primary entrypoint note for agents using the compiled dataset.";
-}, {
-    readonly id: "runtime";
-    readonly path: ".interf/runtime";
-    readonly kind: "runtime";
-    readonly required: true;
-    readonly description: "CLI-owned runtime state, health, stage contracts, and proof artifacts.";
-}];
-export interface BuiltinCompiledStageAccessPattern {
-    id: BuiltinCompiledStageId;
-    label: string;
-    description: string;
-    contractType: CompiledContractType;
-    skillDir: string;
-    reads: readonly BuiltinCompiledZoneId[];
-    writes: readonly BuiltinCompiledZoneId[];
-}
-export declare const BUILTIN_COMPILED_STAGE_ACCESS_PATTERNS: readonly [{
-    readonly id: "summarize";
-    readonly label: "Summarize";
-    readonly description: "Turn source files into per-file summaries.";
-    readonly contractType: "compiled-file-evidence";
-    readonly skillDir: "summarize";
-    readonly reads: readonly ["raw", "runtime"];
-    readonly writes: readonly ["summaries"];
-}, {
-    readonly id: "structure";
-    readonly label: "Structure";
-    readonly description: "Build the cross-file knowledge structure from the summaries.";
-    readonly contractType: "compiled-knowledge-structure";
-    readonly skillDir: "structure";
-    readonly reads: readonly ["summaries", "runtime"];
-    readonly writes: readonly ["knowledge-entities", "knowledge-claims", "knowledge-indexes"];
-}, {
-    readonly id: "shape";
-    readonly label: "Shape";
-    readonly description: "Shape the final compiled around the saved focus and truth checks.";
-    readonly contractType: "compiled-query-shape";
-    readonly skillDir: "shape";
-    readonly reads: readonly ["raw", "summaries", "knowledge-entities", "knowledge-claims", "knowledge-indexes", "runtime"];
-    readonly writes: readonly ["knowledge-indexes", "home"];
-}];
-export declare function listBuiltinCompiledZoneSpecs(): BuiltinCompiledZoneSpec[];
-export declare function listBuiltinCompiledFallbackStages(): Array<{
-    id: BuiltinCompiledStageId;
-    contract_type: CompiledContractType;
-    reads: BuiltinCompiledZoneId[];
-    writes: BuiltinCompiledZoneId[];
-}>;
-export declare function requiredCompiledZoneOwners<TStage extends {
-    id: string;
-    writes: readonly string[];
-}>(stages: readonly TStage[], zoneId: BuiltinCompiledZoneId): string[];

package/dist/lib/workflow-abi.js

@@ -1,156 +0,0 @@
-export const COMPILED_CONTRACT_TYPES = [
-    "compiled-file-evidence",
-    "compiled-knowledge-structure",
-    "compiled-query-shape",
-];
-export const COMPILED_ZONE_KINDS = [
-    "directory",
-    "file",
-    "runtime",
-];
-export const COMPILED_CONTRACT_FAMILY_METADATA = {
-    "compiled-file-evidence": {
-        order: 0,
-        bundledSkill: "compile/stages/summarize",
-    },
-    "compiled-knowledge-structure": {
-        order: 1,
-        bundledSkill: "compile/stages/structure",
-    },
-    "compiled-query-shape": {
-        order: 2,
-        bundledSkill: "compile/stages/shape",
-    },
-};
-export const BUILTIN_COMPILED_STAGE_IDS = {
-    SUMMARIZE: "summarize",
-    STRUCTURE: "structure",
-    SHAPE: "shape",
-};
-export const BUILTIN_COMPILED_ZONE_IDS = {
-    RAW: "raw",
-    SUMMARIES: "summaries",
-    KNOWLEDGE_ENTITIES: "knowledge-entities",
-    KNOWLEDGE_CLAIMS: "knowledge-claims",
-    KNOWLEDGE_INDEXES: "knowledge-indexes",
-    HOME: "home",
-    RUNTIME: "runtime",
-};
-export const BUILTIN_COMPILED_ZONE_SPECS = [
-    {
-        id: BUILTIN_COMPILED_ZONE_IDS.RAW,
-        path: "raw",
-        kind: "directory",
-        required: true,
-        description: "Compiled-local raw snapshot copied from the dataset for direct evidence and verification.",
-    },
-    {
-        id: BUILTIN_COMPILED_ZONE_IDS.SUMMARIES,
-        path: "summaries",
-        kind: "directory",
-        required: true,
-        description: "Per-file evidence notes produced by file-evidence stages.",
-    },
-    {
-        id: BUILTIN_COMPILED_ZONE_IDS.KNOWLEDGE_ENTITIES,
-        path: "knowledge/entities",
-        kind: "directory",
-        required: true,
-        description: "Canonical entity notes produced by knowledge-structure stages.",
-    },
-    {
-        id: BUILTIN_COMPILED_ZONE_IDS.KNOWLEDGE_CLAIMS,
-        path: "knowledge/claims",
-        kind: "directory",
-        required: true,
-        description: "Claim notes produced by knowledge-structure stages.",
-    },
-    {
-        id: BUILTIN_COMPILED_ZONE_IDS.KNOWLEDGE_INDEXES,
-        path: "knowledge/indexes",
-        kind: "directory",
-        required: true,
-        description: "Retrieval indexes and navigation notes produced by structure and shape stages.",
-    },
-    {
-        id: BUILTIN_COMPILED_ZONE_IDS.HOME,
-        path: "home.md",
-        kind: "file",
-        required: true,
-        description: "Primary entrypoint note for agents using the compiled dataset.",
-    },
-    {
-        id: BUILTIN_COMPILED_ZONE_IDS.RUNTIME,
-        path: ".interf/runtime",
-        kind: "runtime",
-        required: true,
-        description: "CLI-owned runtime state, health, stage contracts, and proof artifacts.",
-    },
-];
-export const BUILTIN_COMPILED_STAGE_ACCESS_PATTERNS = [
-    {
-        id: BUILTIN_COMPILED_STAGE_IDS.SUMMARIZE,
-        label: "Summarize",
-        description: "Turn source files into per-file summaries.",
-        contractType: "compiled-file-evidence",
-        skillDir: "summarize",
-        reads: [
-            BUILTIN_COMPILED_ZONE_IDS.RAW,
-            BUILTIN_COMPILED_ZONE_IDS.RUNTIME,
-        ],
-        writes: [
-            BUILTIN_COMPILED_ZONE_IDS.SUMMARIES,
-        ],
-    },
-    {
-        id: BUILTIN_COMPILED_STAGE_IDS.STRUCTURE,
-        label: "Structure",
-        description: "Build the cross-file knowledge structure from the summaries.",
-        contractType: "compiled-knowledge-structure",
-        skillDir: "structure",
-        reads: [
-            BUILTIN_COMPILED_ZONE_IDS.SUMMARIES,
-            BUILTIN_COMPILED_ZONE_IDS.RUNTIME,
-        ],
-        writes: [
-            BUILTIN_COMPILED_ZONE_IDS.KNOWLEDGE_ENTITIES,
-            BUILTIN_COMPILED_ZONE_IDS.KNOWLEDGE_CLAIMS,
-            BUILTIN_COMPILED_ZONE_IDS.KNOWLEDGE_INDEXES,
-        ],
-    },
-    {
-        id: BUILTIN_COMPILED_STAGE_IDS.SHAPE,
-        label: "Shape",
-        description: "Shape the final compiled around the saved focus and truth checks.",
-        contractType: "compiled-query-shape",
-        skillDir: "shape",
-        reads: [
-            BUILTIN_COMPILED_ZONE_IDS.RAW,
-            BUILTIN_COMPILED_ZONE_IDS.SUMMARIES,
-            BUILTIN_COMPILED_ZONE_IDS.KNOWLEDGE_ENTITIES,
-            BUILTIN_COMPILED_ZONE_IDS.KNOWLEDGE_CLAIMS,
-            BUILTIN_COMPILED_ZONE_IDS.KNOWLEDGE_INDEXES,
-            BUILTIN_COMPILED_ZONE_IDS.RUNTIME,
-        ],
-        writes: [
-            BUILTIN_COMPILED_ZONE_IDS.KNOWLEDGE_INDEXES,
-            BUILTIN_COMPILED_ZONE_IDS.HOME,
-        ],
-    },
-];
-export function listBuiltinCompiledZoneSpecs() {
-    return BUILTIN_COMPILED_ZONE_SPECS.map((zone) => ({ ...zone }));
-}
-export function listBuiltinCompiledFallbackStages() {
-    return BUILTIN_COMPILED_STAGE_ACCESS_PATTERNS.map((stage) => ({
-        id: stage.id,
-        contract_type: stage.contractType,
-        reads: [...stage.reads],
-        writes: [...stage.writes],
-    }));
-}
-export function requiredCompiledZoneOwners(stages, zoneId) {
-    return Array.from(new Set(stages
-        .filter((stage) => stage.writes.includes(zoneId))
-        .map((stage) => stage.id)));
-}