@interf/compiler 0.1.11 → 0.2.0

package/dist/lib/state.js

@@ -1,633 +1,6 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
-import { basename, join, relative, resolve } from "node:path";
-import { countFilesRecursive } from "./filesystem.js";
-import { discoverSourceFiles } from "./discovery.js";
-import { safeReadJsonFileWithSchema } from "./parse.js";
-import { readInterfConfig, resolveKnowledgeBaseSourcePath } from "./interf.js";
-import { loadRuntimeRun } from "./runtime.js";
-import { InterfaceHealthSchema, InterfaceStateSchema, InterfaceViewSpecSchema, KnowledgeBaseHealthSchema, KnowledgeBaseSourceAccessSchema, KnowledgeBaseStateSchema, KnowledgeBaseViewSpecSchema, } from "./schema.js";
-import { validateKnowledgeBase, validateInterfaceKnowledgeBase, } from "./validate.js";
-import { STATE_DIR } from "./util.js";
-const STATE_FILE = "state.json";
-const HEALTH_FILE = "health.json";
-const VIEW_SPEC_FILE = "view-spec.json";
-const SOURCE_ACCESS_FILE = "source-access.json";
-export function statePath(dirPath) {
-    return join(dirPath, STATE_DIR, STATE_FILE);
-}
-export function healthPath(dirPath) {
-    return join(dirPath, STATE_DIR, HEALTH_FILE);
-}
-export function viewSpecPath(dirPath) {
-    return join(dirPath, STATE_DIR, VIEW_SPEC_FILE);
-}
-export function sourceAccessPath(dirPath) {
-    return join(dirPath, STATE_DIR, SOURCE_ACCESS_FILE);
-}
-export function loadState(dirPath) {
-    const p = statePath(dirPath);
-    if (!existsSync(p))
-        return null;
-    return safeReadJsonFileWithSchema(p, "runtime state", KnowledgeBaseStateSchema.or(InterfaceStateSchema));
-}
-export function saveState(dirPath, state) {
-    const dir = join(dirPath, STATE_DIR);
-    mkdirSync(dir, { recursive: true });
-    writeFileSync(join(dir, STATE_FILE), JSON.stringify(state, null, 2) + "\n");
-}
-export function loadInterfaceHealth(dirPath) {
-    const p = healthPath(dirPath);
-    if (!existsSync(p))
-        return null;
-    return safeReadJsonFileWithSchema(p, "interface health", InterfaceHealthSchema);
-}
-export function loadKnowledgeBaseHealth(dirPath) {
-    const p = healthPath(dirPath);
-    if (!existsSync(p))
-        return null;
-    return safeReadJsonFileWithSchema(p, "knowledge-base health", KnowledgeBaseHealthSchema);
-}
-export function saveInterfaceHealth(dirPath, health) {
-    const dir = join(dirPath, STATE_DIR);
-    mkdirSync(dir, { recursive: true });
-    writeFileSync(healthPath(dirPath), JSON.stringify(health, null, 2) + "\n");
-}
-export function saveKnowledgeBaseHealth(dirPath, health) {
-    const dir = join(dirPath, STATE_DIR);
-    mkdirSync(dir, { recursive: true });
-    writeFileSync(healthPath(dirPath), JSON.stringify(health, null, 2) + "\n");
-}
-export function loadInterfaceViewSpec(dirPath) {
-    const p = viewSpecPath(dirPath);
-    if (!existsSync(p))
-        return null;
-    return loadViewSpec(p, InterfaceViewSpecSchema);
-}
-export function loadKnowledgeBaseViewSpec(dirPath) {
-    const p = viewSpecPath(dirPath);
-    if (!existsSync(p))
-        return null;
-    return loadViewSpec(p, KnowledgeBaseViewSpecSchema);
-}
-export function loadKnowledgeBaseSourceAccess(dirPath) {
-    const p = sourceAccessPath(dirPath);
-    if (!existsSync(p))
-        return null;
-    return safeReadJsonFileWithSchema(p, "knowledge-base source access", KnowledgeBaseSourceAccessSchema);
-}
-export function saveInterfaceViewSpec(dirPath, viewSpec) {
-    const dir = join(dirPath, STATE_DIR);
-    mkdirSync(dir, { recursive: true });
-    writeFileSync(viewSpecPath(dirPath), JSON.stringify(viewSpec, null, 2) + "\n");
-}
-export function saveKnowledgeBaseViewSpec(dirPath, viewSpec) {
-    const dir = join(dirPath, STATE_DIR);
-    mkdirSync(dir, { recursive: true });
-    writeFileSync(viewSpecPath(dirPath), JSON.stringify(viewSpec, null, 2) + "\n");
-}
-export function initKnowledgeBaseState() {
-    return {
-        version: 1,
-        pending: [],
-        summarized: 0,
-        compiled: 0,
-        last_add: null,
-        last_summarize: null,
-        last_compile: null,
-        inventory_complete: false,
-        abstracts_read: 0,
-        full_reads: 0,
-        entity_count: 0,
-        claim_count: 0,
-        warning_count: 0,
-        error_count: 0,
-    };
-}
-export function initInterfaceState() {
-    return {
-        version: 1,
-        retrieve_complete: false,
-        analyze_complete: false,
-        compile_complete: false,
-        coverage_complete: false,
-        frontmatter_scanned: 0,
-        candidate_count: 0,
-        abstracts_read: 0,
-        expansion_passes: 0,
-        relevant_count: 0,
-        rejected_count: 0,
-        delta_count: 0,
-        delta_files: [],
-        last_retrieve: null,
-        last_analyze: null,
-        last_compile: null,
-        knowledge_base_summary_count_at_last_compile: 0,
-        extracted_entities: 0,
-        extracted_claims: 0,
-        entity_count: 0,
-        claim_count: 0,
-        output_count: 0,
-        warning_count: 0,
-        error_count: 0,
-    };
-}
-export function refreshInterfaceArtifacts(dirPath, options) {
-    normalizeInterfaceCompileState(dirPath);
-    const health = computeInterfaceHealth(dirPath);
-    saveInterfaceHealth(dirPath, health);
-    let viewSpec;
-    if (options?.ensureViewSpec) {
-        viewSpec = ensureInterfaceViewSpec(dirPath);
-    }
-    return { health, viewSpec };
-}
-function normalizeInterfaceCompileState(dirPath) {
-    const state = {
-        ...initInterfaceState(),
-        ...(loadState(dirPath) ?? {}),
-    };
-    const config = readInterfConfig(dirPath);
-    const knowledgeBasePath = config?.type === "interface" && config.knowledge_base?.path
-        ? resolve(dirPath, config.knowledge_base.path)
-        : null;
-    const knowledgeBaseTotal = knowledgeBasePath !== null && existsSync(join(knowledgeBasePath, "summaries"))
-        ? countFilesRecursive(join(knowledgeBasePath, "summaries"))
-        : 0;
-    if (state.compile_complete === true &&
-        typeof state.last_compile === "string" &&
-        knowledgeBaseTotal > 0 &&
-        (state.knowledge_base_summary_count_at_last_compile ?? 0) <= 0) {
-        state.knowledge_base_summary_count_at_last_compile = knowledgeBaseTotal;
-        saveState(dirPath, state);
-    }
-    return state;
-}
-function resolveInterfaceCompileReferenceCount(state, knowledgeBaseTotal) {
-    const explicitCount = state.knowledge_base_summary_count_at_last_compile ?? 0;
-    if (explicitCount > 0)
-        return explicitCount;
-    if (state.compile_complete === true && typeof state.last_compile === "string") {
-        return knowledgeBaseTotal;
-    }
-    return 0;
-}
-export function refreshKnowledgeBaseArtifacts(dirPath, options) {
-    const health = computeKnowledgeBaseHealth(dirPath);
-    saveKnowledgeBaseHealth(dirPath, health);
-    const sourceAccess = ensureKnowledgeBaseSourceAccess(dirPath);
-    let viewSpec;
-    if (options?.ensureViewSpec) {
-        viewSpec = ensureKnowledgeBaseViewSpec(dirPath);
-    }
-    return { health, viewSpec, sourceAccess };
-}
-export function computeKnowledgeBaseHealth(dirPath) {
-    const state = {
-        ...initKnowledgeBaseState(),
-        ...(loadState(dirPath) ?? {}),
-    };
-    const validation = validateKnowledgeBase(dirPath);
-    const now = new Date().toISOString();
-    const config = readInterfConfig(dirPath);
-    const knowledgeBaseName = config?.name ?? basename(dirPath);
-    const sourcePath = resolveKnowledgeBaseSourcePath(dirPath, config);
-    const discovery = discoverSourceFiles(sourcePath, dirPath);
-    const summariesPresent = existsSync(join(dirPath, "summaries"));
-    const inventoryPresent = existsSync(join(dirPath, STATE_DIR, "inventory.json"));
-    const homePresent = existsSync(join(dirPath, "home.md"));
-    const outputs = countKnowledgeBaseOutputFiles(dirPath);
-    const outputsPresent = outputs > 0;
-    const sourceTotal = discovery.totalCount;
-    const summarized = summariesPresent ? countFilesRecursive(join(dirPath, "summaries")) : 0;
-    const sourceCovered = Math.min(sourceTotal, summarized);
-    const compiled = Math.min(summarized, state.compiled ?? 0);
-    const toSummarize = Math.max(0, sourceTotal - sourceCovered);
-    const toCompile = Math.max(0, summarized - compiled);
-    const warnings = (toSummarize > 0 ? 1 : 0) +
-        (toCompile > 0 ? 1 : 0) +
-        (summarized > sourceTotal && sourceTotal > 0 ? 1 : 0) +
-        (!outputsPresent && state.last_compile ? 1 : 0) +
-        validation.invalid_frontmatter +
-        validation.short_abstracts +
-        validation.broken_links;
-    const errors = (!validation.config_present ? 1 : 0) +
-        (!validation.config_valid && validation.config_present ? 1 : 0) +
-        (!validation.config_type_match && validation.config_valid ? 1 : 0) +
-        (state.error_count ?? 0);
-    const activeRun = loadRuntimeRun(dirPath);
-    const inferredStage = resolveKnowledgeBaseStage(state, sourceTotal, summarized, toSummarize, toCompile, errors);
-    const inferredStatus = resolveKnowledgeBaseStatus(sourceTotal, summarized, toSummarize, toCompile, errors, state);
-    const stage = activeRun?.status === "running"
-        ? activeRun.contract_type === "kb-knowledge-layer"
-            ? "compile"
-            : activeRun.contract_type === "kb-file-evidence"
-                ? "summarize"
-                : inferredStage
-        : inferredStage;
-    const status = activeRun?.status === "running" ? "running" : inferredStatus;
-    return {
-        kind: "knowledge-base-health",
-        version: 1,
-        generated_at: now,
-        target_name: knowledgeBaseName,
-        status,
-        stage,
-        summary: activeRun?.status === "running"
-            ? `Running — ${activeRun.stage_label} via ${activeRun.executor.display_name}. ${activeRun.summary}`
-            : buildKnowledgeBaseSummary(status, stage, { rawTotal: sourceTotal, rawCovered: sourceCovered, summarized, toSummarize, compiled, toCompile }),
-        metrics: {
-            source_total: sourceTotal,
-            source_covered: sourceCovered,
-            summarized,
-            to_summarize: toSummarize,
-            compiled,
-            to_compile: toCompile,
-            entities: state.entity_count ?? countFilesRecursive(join(dirPath, "knowledge", "entities")),
-            claims: state.claim_count ?? countFilesRecursive(join(dirPath, "knowledge", "claims")),
-            outputs,
-            invalid_frontmatter: validation.invalid_frontmatter,
-            short_abstracts: validation.short_abstracts,
-            broken_links: validation.broken_links,
-            warnings: (state.warning_count ?? 0) + warnings,
-            errors,
-        },
-        checks: {
-            config_present: validation.config_present,
-            config_valid: validation.config_valid,
-            config_type_match: validation.config_type_match,
-            summaries_present: summariesPresent,
-            inventory_present: inventoryPresent,
-            outputs_present: outputsPresent,
-            home_present: homePresent,
-            summary_frontmatter_valid: validation.summary_frontmatter_valid,
-            abstracts_valid: validation.abstracts_valid,
-            links_valid: validation.broken_links === 0,
-        },
-    };
-}
-export function computeInterfaceHealth(dirPath) {
-    const state = {
-        ...initInterfaceState(),
-        ...(loadState(dirPath) ?? {}),
-    };
-    const validation = validateInterfaceKnowledgeBase(dirPath);
-    const now = new Date().toISOString();
-    const config = readInterfConfig(dirPath);
-    const interfaceName = config?.name ?? basename(dirPath);
-    const knowledgeBasePath = config?.type === "interface" && config.knowledge_base?.path
-        ? resolve(dirPath, config.knowledge_base.path)
-        : null;
-    const knowledgeBasePathValid = knowledgeBasePath !== null && existsSync(join(knowledgeBasePath, "summaries"));
-    const coverageProof = existsSync(join(dirPath, STATE_DIR, "coverage.json"));
-    const retrievedSet = existsSync(join(dirPath, STATE_DIR, "relevant.json"));
-    const analysisPending = existsSync(join(dirPath, STATE_DIR, "analysis.json"));
-    const homePresent = existsSync(join(dirPath, "home.md"));
-    const outputs = countOutputFiles(dirPath);
-    const outputsPresent = outputs > 0;
-    const knowledgeBaseTotal = knowledgeBasePathValid ? countFilesRecursive(join(knowledgeBasePath, "summaries")) : 0;
-    const knowledgeBaseCompiled = Math.min(knowledgeBaseTotal, resolveInterfaceCompileReferenceCount(state, knowledgeBaseTotal));
-    const toSync = Math.max(0, knowledgeBaseTotal - knowledgeBaseCompiled);
-    const warnings = (toSync > 0 ? 1 : 0) +
-        ((state.frontmatter_scanned ?? 0) > 0 && (state.frontmatter_scanned ?? 0) < knowledgeBaseTotal ? 1 : 0) +
-        (state.retrieve_complete && !coverageProof ? 1 : 0) +
-        (state.retrieve_complete && !(state.coverage_complete ?? false) ? 1 : 0) +
-        (!outputsPresent && state.last_compile ? 1 : 0) +
-        (analysisPending ? 1 : 0) +
-        validation.broken_links;
-    const errors = (!validation.config_present ? 1 : 0) +
-        (!validation.config_valid && validation.config_present ? 1 : 0) +
-        (!validation.config_type_match && validation.config_valid ? 1 : 0) +
-        (!knowledgeBasePathValid ? 1 : 0) +
-        (state.error_count ?? 0);
-    const activeRun = loadRuntimeRun(dirPath);
-    const inferredStage = resolveInterfaceStage(state, errors);
-    const inferredStatus = resolveInterfaceStatus(state, toSync, errors);
-    const stage = activeRun?.status === "running"
-        ? activeRun.contract_type === "interface-plan"
-            ? "create"
-            : activeRun.contract_type === "interface-retrieval"
-                ? "retrieve"
-                : activeRun.contract_type === "interface-analysis"
-                    ? "analyze"
-                    : activeRun.contract_type === "interface-output"
-                        ? "compile"
-                        : inferredStage
-        : inferredStage;
-    const status = activeRun?.status === "running" ? "running" : inferredStatus;
-    return {
-        kind: "interface-health",
-        version: 1,
-        generated_at: now,
-        interface_name: interfaceName,
-        status,
-        stage,
-        summary: activeRun?.status === "running"
-            ? `Running — ${activeRun.stage_label} via ${activeRun.executor.display_name}. ${activeRun.summary}`
-            : buildInterfaceSummary(status, stage, {
-                knowledgeBaseTotal,
-                knowledgeBaseCompiled,
-                toSync,
-                frontmatterScanned: state.frontmatter_scanned ?? 0,
-                abstractsRead: state.abstracts_read ?? 0,
-                relevant: state.relevant_count ?? 0,
-                delta: state.delta_count ?? 0,
-            }),
-        metrics: {
-            knowledge_base_total: knowledgeBaseTotal,
-            knowledge_base_compiled: knowledgeBaseCompiled,
-            to_compile: toSync,
-            frontmatter_scanned: state.frontmatter_scanned ?? 0,
-            candidate_count: state.candidate_count ?? 0,
-            abstracts_read: state.abstracts_read ?? 0,
-            expansion_passes: state.expansion_passes ?? 0,
-            relevant: state.relevant_count ?? 0,
-            rejected: state.rejected_count ?? 0,
-            delta: state.delta_count ?? 0,
-            entities: state.entity_count ??
-                state.extracted_entities ??
-                countFilesRecursive(join(dirPath, "knowledge", "entities")),
-            claims: state.claim_count ??
-                state.extracted_claims ??
-                countFilesRecursive(join(dirPath, "knowledge", "claims")),
-            outputs,
-            broken_links: validation.broken_links,
-            warnings: (state.warning_count ?? 0) + warnings,
-            errors,
-        },
-        checks: {
-            config_present: validation.config_present,
-            config_valid: validation.config_valid,
-            config_type_match: validation.config_type_match,
-            knowledge_base_path_valid: knowledgeBasePathValid,
-            coverage_proof: coverageProof,
-            coverage_complete: state.coverage_complete ?? false,
-            retrieved_set: retrievedSet,
-            analysis_pending: analysisPending,
-            outputs_present: outputsPresent,
-            home_present: homePresent,
-            links_valid: validation.broken_links === 0,
-        },
-    };
-}
-export function ensureInterfaceViewSpec(dirPath) {
-    const existing = loadInterfaceViewSpec(dirPath);
-    const now = new Date().toISOString();
-    const interfaceName = readInterfConfig(dirPath)?.name ?? basename(dirPath);
-    const defaults = {
-        kind: "interface-view-spec",
-        version: 1,
-        generated_at: now,
-        interface_name: interfaceName,
-        health_source: ".interf/health.json",
-        state_source: ".interf/state.json",
-        default_note: "home.md",
-        graph_scope: ["knowledge", "briefs", "summaries"],
-        cards: [
-            { id: "compile", label: "Knowledge Base Compiled", metric: "knowledge_base_compiled", denominator_metric: "knowledge_base_total", format: "fraction" },
-            {
-                id: "scanned",
-                label: "Scanned",
-                metric: "frontmatter_scanned",
-                denominator_metric: "knowledge_base_total",
-                format: "fraction",
-            },
-            { id: "abstracts", label: "Abstracts Read", metric: "abstracts_read", format: "number" },
-            { id: "to-compile", label: "To Compile", metric: "to_compile", format: "number" },
-            { id: "relevant", label: "Relevant", metric: "relevant", format: "number" },
-            { id: "entities", label: "Entities", metric: "entities", format: "number" },
-            { id: "outputs", label: "Outputs", metric: "outputs", format: "number" },
-        ],
-        sections: [
-            { id: "status", type: "status", title: "Compile Status", path: ".interf/health.json" },
-            { id: "cards", type: "cards", title: "Key Metrics", path: ".interf/health.json" },
-            { id: "graph", type: "graph", title: "Knowledge Graph", paths: ["knowledge", "briefs", "summaries"] },
-            {
-                id: "core-docs",
-                type: "documents",
-                title: "Core Docs",
-                paths: ["home.md", "briefs", "summaries", "knowledge/claims", "knowledge/entities"],
-            },
-            { id: "claims", type: "table", title: "Claims", path: "knowledge/claims" },
-        ],
-    };
-    if (existing) {
-        const normalized = normalizeInterfaceViewSpec(existing, defaults);
-        if (JSON.stringify(normalized) !== JSON.stringify(existing)) {
-            saveInterfaceViewSpec(dirPath, normalized);
-        }
-        return normalized;
-    }
-    saveInterfaceViewSpec(dirPath, defaults);
-    return defaults;
-}
-export function ensureKnowledgeBaseViewSpec(dirPath) {
-    const existing = loadKnowledgeBaseViewSpec(dirPath);
-    const now = new Date().toISOString();
-    const knowledgeBaseName = readInterfConfig(dirPath)?.name ?? basename(dirPath);
-    const defaults = {
-        kind: "knowledge-base-view-spec",
-        version: 1,
-        generated_at: now,
-        target_name: knowledgeBaseName,
-        health_source: ".interf/health.json",
-        state_source: ".interf/state.json",
-        default_note: "home.md",
-        graph_scope: ["summaries", "knowledge"],
-        cards: [
-            { id: "source-total", label: "Source Files", metric: "source_total", format: "number" },
-            { id: "summarized", label: "Summarized", metric: "source_covered", denominator_metric: "source_total", format: "fraction" },
-            { id: "to-summarize", label: "To Summarize", metric: "to_summarize", format: "number" },
-            { id: "compiled", label: "Compiled", metric: "compiled", denominator_metric: "summarized", format: "fraction" },
-            { id: "entities", label: "Entities", metric: "entities", format: "number" },
-            { id: "claims", label: "Claims", metric: "claims", format: "number" },
-        ],
-        sections: [
-            { id: "status", type: "status", title: "Compile Status", path: ".interf/health.json" },
-            { id: "cards", type: "cards", title: "Key Metrics", path: ".interf/health.json" },
-            { id: "graph", type: "graph", title: "Knowledge Graph", paths: ["summaries", "knowledge"] },
-            {
-                id: "core-docs",
-                type: "documents",
-                title: "Core Docs",
-                paths: ["home.md", "knowledge/indexes", "knowledge/entities", "knowledge/claims", "summaries"],
-            },
-            { id: "claims", type: "table", title: "Claims", path: "knowledge/claims" },
-        ],
-    };
-    if (existing) {
-        const normalized = normalizeKnowledgeBaseViewSpec(existing, defaults);
-        if (JSON.stringify(normalized) !== JSON.stringify(existing)) {
-            saveKnowledgeBaseViewSpec(dirPath, normalized);
-        }
-        return normalized;
-    }
-    saveKnowledgeBaseViewSpec(dirPath, defaults);
-    return defaults;
-}
-export function ensureKnowledgeBaseSourceAccess(dirPath) {
-    const now = new Date().toISOString();
-    const config = readInterfConfig(dirPath);
-    const knowledgeBaseName = config?.name ?? basename(dirPath);
-    const sourcePath = resolveKnowledgeBaseSourcePath(dirPath, config);
-    const discovery = discoverSourceFiles(sourcePath, dirPath);
-    const sampleFiles = [...discovery.sourceFiles]
-        .sort((a, b) => a.length - b.length || a.localeCompare(b))
-        .slice(0, 10);
-    const sourceRoot = relative(dirPath, sourcePath) || ".";
-    const suggestedChecks = sampleFiles.slice(0, 3).map((file) => resolve(sourcePath, file));
-    const artifact = {
-        kind: "knowledge-base-source-access",
-        version: 1,
-        generated_at: now,
-        target_name: knowledgeBaseName,
-        source_root: sourceRoot,
-        source_total: discovery.totalCount,
-        sample_files: sampleFiles,
-        suggested_checks: suggestedChecks,
-    };
-    mkdirSync(join(dirPath, STATE_DIR), { recursive: true });
-    writeFileSync(sourceAccessPath(dirPath), JSON.stringify(artifact, null, 2) + "\n");
-    return artifact;
-}
-export function resolveKnowledgeBaseStatus(rawTotal, summarized, toSummarize, toCompile, errors, state) {
-    if (errors > 0)
-        return "failed";
-    if (rawTotal === 0 && summarized === 0 && state.last_summarize === null && state.last_compile === null)
-        return "idle";
-    if (toSummarize > 0 || toCompile > 0)
-        return "stale";
-    return "compiled";
-}
-export function resolveKnowledgeBaseStage(state, rawTotal, summarized, toSummarize, toCompile, errors) {
-    if (errors > 0)
-        return "failed";
-    if (rawTotal === 0 && summarized === 0 && state.last_summarize === null && state.last_compile === null)
-        return "idle";
-    if (toSummarize > 0)
-        return "summarize";
-    if (toCompile > 0)
-        return "compile";
-    return "compiled";
-}
-function buildKnowledgeBaseSummary(status, stage, metrics) {
-    if (status === "failed")
-        return "Failed — required knowledge-base inputs are missing.";
-    if (status === "idle")
-        return "Idle — no raw files have been ingested yet.";
-    if (stage === "summarize") {
-        return `Stale — ${metrics.toSummarize} raw files still need summaries (${metrics.rawCovered}/${metrics.rawTotal} summarized).`;
-    }
-    if (stage === "compile") {
-        return `Stale — ${metrics.toCompile} summaries still need graph compile (${metrics.compiled}/${metrics.summarized} compiled).`;
-    }
-    return `Compiled — ${metrics.compiled}/${metrics.summarized} summaries compiled, ${metrics.rawCovered}/${metrics.rawTotal} raw files summarized.`;
-}
-export function normalizeInterfaceViewSpec(existing, defaults) {
-    const existingCards = Array.isArray(existing.cards) ? existing.cards : defaults.cards;
-    const cards = existingCards.map((card) => {
-        if (card.id === "compile" && card.format === "fraction" && !card.denominator_metric) {
-            return {
-                ...card,
-                metric: "knowledge_base_compiled",
-                denominator_metric: "knowledge_base_total",
-            };
-        }
-        return card;
-    });
-    return {
-        ...defaults,
-        ...existing,
-        cards,
-        sections: Array.isArray(existing.sections) && existing.sections.length > 0 ? existing.sections : defaults.sections,
-        graph_scope: Array.isArray(existing.graph_scope) && existing.graph_scope.length > 0
-            ? existing.graph_scope
-            : defaults.graph_scope,
-    };
-}
-export function normalizeKnowledgeBaseViewSpec(existing, defaults) {
-    const existingCards = Array.isArray(existing.cards) ? existing.cards : defaults.cards;
-    const cards = existingCards.map((card) => card);
-    return {
-        ...defaults,
-        ...existing,
-        cards,
-        sections: Array.isArray(existing.sections) && existing.sections.length > 0 ? existing.sections : defaults.sections,
-        graph_scope: Array.isArray(existing.graph_scope) && existing.graph_scope.length > 0
-            ? existing.graph_scope
-            : defaults.graph_scope,
-    };
-}
-function loadViewSpec(filePath, schema) {
-    try {
-        const raw = JSON.parse(readFileSync(filePath, "utf8"));
-        const parsed = schema.safeParse(raw);
-        return parsed.success ? (parsed.data ?? null) : null;
-    }
-    catch {
-        return null;
-    }
-}
-export function resolveInterfaceStatus(state, toSync, errors) {
-    if (errors > 0)
-        return "failed";
-    if (hasInterfaceStagePrepared(state, "analyze") || hasInterfaceStagePrepared(state, "retrieve"))
-        return "running";
-    if (state.last_compile === null)
-        return "idle";
-    if (toSync > 0)
-        return "stale";
-    return "compiled";
-}
-export function resolveInterfaceStage(state, errors) {
-    if (errors > 0)
-        return "failed";
-    if (hasInterfaceStagePrepared(state, "analyze"))
-        return "compile";
-    if (hasInterfaceStagePrepared(state, "retrieve"))
-        return "analyze";
-    if (state.compile_complete || state.last_compile)
-        return "compiled";
-    return "idle";
-}
-function buildInterfaceSummary(status, stage, metrics) {
-    if (status === "failed")
-        return "Failed — required interface inputs are missing.";
-    if (status === "running") {
-        return stage === "create"
-            ? "Runtime design in progress."
-            : `Compile in progress — ${stage} stage active.`;
-    }
-    if (status === "idle")
-        return "Idle — interface has not been compiled yet.";
-    if (status === "stale") {
-        return `Stale — ${metrics.toSync} new summary files since last compile (${metrics.knowledgeBaseCompiled}/${metrics.knowledgeBaseTotal} covered).`;
-    }
-    return `Compiled — scanned ${metrics.frontmatterScanned}/${metrics.knowledgeBaseTotal} summaries, reviewed ${metrics.abstractsRead} abstracts, selected ${metrics.relevant} relevant, ${metrics.toSync} to compile.`;
-}
-function countOutputFiles(dirPath) {
-    return [
-        join(dirPath, "knowledge", "entities"),
-        join(dirPath, "knowledge", "claims"),
-        join(dirPath, "briefs"),
-        join(dirPath, "summaries"),
-    ].reduce((total, dir) => total + countFilesRecursive(dir), 0);
-}
-function countKnowledgeBaseOutputFiles(dirPath) {
-    return [
-        join(dirPath, "knowledge", "entities"),
-        join(dirPath, "knowledge", "claims"),
-        join(dirPath, "knowledge", "indexes"),
-    ].reduce((total, dir) => total + countFilesRecursive(dir), 0);
-}
-function hasInterfaceStagePrepared(state, stage) {
-    const stageComplete = stage === "retrieve" ? state.retrieve_complete : state.analyze_complete;
-    const stageAt = stage === "retrieve" ? state.last_retrieve : state.last_analyze;
-    if (!stageComplete)
-        return false;
-    if (stageAt === null)
-        return true;
-    if (state.last_compile === null)
-        return true;
-    return stageAt > state.last_compile;
-}
+export { statePath, healthPath, viewSpecPath, sourceAccessPath, } from "./state-paths.js";
+export { loadState, saveState, loadInterfaceHealth, loadKnowledgeBaseHealth, saveInterfaceHealth, saveKnowledgeBaseHealth, loadInterfaceViewSpec, loadKnowledgeBaseViewSpec, loadKnowledgeBaseSourceAccess, saveInterfaceViewSpec, saveKnowledgeBaseViewSpec, initKnowledgeBaseState, initInterfaceState, } from "./state-io.js";
+export { refreshInterfaceArtifacts, refreshKnowledgeBaseArtifacts, } from "./state-artifacts.js";
+export { computeKnowledgeBaseHealth, computeInterfaceHealth, resolveKnowledgeBaseStatus, resolveKnowledgeBaseStage, resolveInterfaceStatus, resolveInterfaceStage, } from "./state-health.js";
+export { ensureInterfaceViewSpec, ensureKnowledgeBaseViewSpec, ensureKnowledgeBaseSourceAccess, normalizeInterfaceViewSpec, normalizeKnowledgeBaseViewSpec, } from "./state-view.js";
 //# sourceMappingURL=state.js.map