@interf/compiler 0.1.12 → 0.2.1

package/dist/lib/source-config.js

@@ -0,0 +1,75 @@
+import { existsSync } from "node:fs";
+import { basename, join } from "node:path";
+import { readJsonFileWithSchema } from "./parse.js";
+import { SourceFolderConfigSchema, } from "./schema.js";
+import { slugify } from "./util.js";
+export const SOURCE_FOLDER_CONFIG_FILE = "interf.config.json";
+function sourceConfigPath(sourcePath) {
+    return join(sourcePath, SOURCE_FOLDER_CONFIG_FILE);
+}
+function normalizeEvalCases(cases) {
+    const seen = new Set();
+    return cases.map((caseSpec, index) => {
+        const baseId = slugify(caseSpec.id ?? caseSpec.question) || `check-${index + 1}`;
+        let id = baseId;
+        let suffix = 2;
+        while (seen.has(id)) {
+            id = `${baseId}-${suffix}`;
+            suffix += 1;
+        }
+        seen.add(id);
+        return {
+            id,
+            question: caseSpec.question.trim(),
+            ...(caseSpec.answer ? { answer: caseSpec.answer.trim() } : {}),
+            ...(caseSpec.strictness ? { strictness: caseSpec.strictness.trim() } : {}),
+            ...(caseSpec.expect ? { expect: caseSpec.expect } : {}),
+        };
+    });
+}
+export function loadSourceFolderConfig(sourcePath) {
+    const filePath = sourceConfigPath(sourcePath);
+    if (!existsSync(filePath))
+        return null;
+    return readJsonFileWithSchema(filePath, "source-folder config", SourceFolderConfigSchema);
+}
+export function buildBenchmarkSpecFromSourceFolderConfig(options) {
+    const { sourcePath, type, targetName } = options;
+    const config = loadSourceFolderConfig(sourcePath);
+    if (!config)
+        return null;
+    if (type === "knowledge-base") {
+        const knowledgeBase = config.knowledge_base;
+        if (!knowledgeBase?.evals || knowledgeBase.evals.length === 0)
+            return null;
+        const configPath = sourceConfigPath(sourcePath);
+        return {
+            id: knowledgeBase.id ?? slugify(knowledgeBase.name ?? basename(sourcePath) ?? "knowledge-base"),
+            filePath: `${configPath}#knowledge_base`,
+            type: "knowledge-base",
+            name: knowledgeBase.name ?? "Knowledge Base",
+            description: `Derived from ${SOURCE_FOLDER_CONFIG_FILE}`,
+            cases: normalizeEvalCases(knowledgeBase.evals),
+        };
+    }
+    const interfaces = config.interfaces ?? [];
+    if (interfaces.length === 0)
+        return null;
+    const match = targetName
+        ? interfaces.find((entry) => entry.name === targetName)
+        : interfaces.length === 1
+            ? interfaces[0]
+            : null;
+    if (!match?.evals || match.evals.length === 0)
+        return null;
+    const configPath = sourceConfigPath(sourcePath);
+    return {
+        id: match.id ?? slugify(match.name),
+        filePath: `${configPath}#interfaces/${match.name}`,
+        type: "interface",
+        name: match.name,
+        description: match.about,
+        cases: normalizeEvalCases(match.evals),
+    };
+}
+//# sourceMappingURL=source-config.js.map

package/dist/lib/source-config.js.map

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

package/dist/lib/state-artifacts.d.ts

@@ -0,0 +1,15 @@
+import { type InterfaceHealth, type InterfaceViewSpec, type KnowledgeBaseHealth, type KnowledgeBaseSourceAccess, type KnowledgeBaseViewSpec } from "./schema.js";
+export declare function refreshInterfaceArtifacts(dirPath: string, options?: {
+    ensureViewSpec?: boolean;
+}): {
+    health: InterfaceHealth;
+    viewSpec?: InterfaceViewSpec;
+};
+export declare function refreshKnowledgeBaseArtifacts(dirPath: string, options?: {
+    ensureViewSpec?: boolean;
+}): {
+    health: KnowledgeBaseHealth;
+    viewSpec?: KnowledgeBaseViewSpec;
+    sourceAccess: KnowledgeBaseSourceAccess;
+};
+//# sourceMappingURL=state-artifacts.d.ts.map

package/dist/lib/state-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-artifacts.d.ts","sourceRoot":"","sources":["../../src/lib/state-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AAgBrB,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAAE,CAW3D;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAAC,YAAY,EAAE,yBAAyB,CAAA;CAAE,CAW5G"}

package/dist/lib/state-artifacts.js

@@ -0,0 +1,24 @@
+import { saveInterfaceHealth, saveKnowledgeBaseHealth, } from "./state-io.js";
+import { computeInterfaceHealth, computeKnowledgeBaseHealth, normalizeInterfaceCompileState, } from "./state-health.js";
+import { ensureInterfaceViewSpec, ensureKnowledgeBaseSourceAccess, ensureKnowledgeBaseViewSpec, } from "./state-view.js";
+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 };
+}
+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 };
+}
+//# sourceMappingURL=state-artifacts.js.map

package/dist/lib/state-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-artifacts.js","sourceRoot":"","sources":["../../src/lib/state-artifacts.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,UAAU,yBAAyB,CACvC,OAAe,EACf,OAAsC;IAEtC,8BAA8B,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC/C,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAErC,IAAI,QAAuC,CAAC;IAC5C,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;QAC5B,QAAQ,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,OAAe,EACf,OAAsC;IAEtC,MAAM,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACnD,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,YAAY,GAAG,+BAA+B,CAAC,OAAO,CAAC,CAAC;IAE9D,IAAI,QAA2C,CAAC;IAChD,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;QAC5B,QAAQ,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;AAC5C,CAAC"}

package/dist/lib/state-health.d.ts

@@ -0,0 +1,9 @@
+import { type InterfaceHealth, type InterfaceState, type InterfaceStage, type KnowledgeBaseHealth, type KnowledgeBaseState, type KnowledgeBaseStage, type RuntimeStatus } from "./schema.js";
+export declare function computeKnowledgeBaseHealth(dirPath: string): KnowledgeBaseHealth;
+export declare function computeInterfaceHealth(dirPath: string): InterfaceHealth;
+export declare function resolveKnowledgeBaseStatus(rawTotal: number, summarized: number, toSummarize: number, toCompile: number, errors: number, state: KnowledgeBaseState): RuntimeStatus;
+export declare function resolveKnowledgeBaseStage(state: KnowledgeBaseState, rawTotal: number, summarized: number, toSummarize: number, toCompile: number, errors: number): KnowledgeBaseStage;
+export declare function resolveInterfaceStatus(state: InterfaceState, toSync: number, errors: number): RuntimeStatus;
+export declare function resolveInterfaceStage(state: InterfaceState, errors: number): InterfaceStage;
+export declare function normalizeInterfaceCompileState(dirPath: string): InterfaceState;
+//# sourceMappingURL=state-health.d.ts.map

package/dist/lib/state-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-health.d.ts","sourceRoot":"","sources":["../../src/lib/state-health.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AAUrB,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAyF/E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CA0HvE;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,kBAAkB,GACxB,aAAa,CAKf;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,kBAAkB,CAMpB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,aAAa,CAMf;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,GACb,cAAc,CAMhB;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CA0B9E"}

package/dist/lib/state-health.js

@@ -0,0 +1,330 @@
+import { basename, join, resolve } from "node:path";
+import { existsSync } from "node:fs";
+import { countFilesRecursive } from "./filesystem.js";
+import { discoverSourceFiles } from "./discovery.js";
+import { readInterfConfig, resolveKnowledgeBaseSourcePath } from "./interf.js";
+import { loadRuntimeRun } from "./runtime.js";
+import { validateKnowledgeBase, validateInterfaceKnowledgeBase } from "./validate.js";
+import { STATE_DIR } from "./util.js";
+import { initInterfaceState, initKnowledgeBaseState, loadState, saveState, } from "./state-io.js";
+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 freshAnalyzePrepared = hasInterfaceStagePrepared(state, "analyze");
+    const freshRetrievePrepared = hasInterfaceStagePrepared(state, "retrieve");
+    const compileSurfaceExpected = !freshAnalyzePrepared &&
+        !freshRetrievePrepared &&
+        Boolean(state.compile_complete || state.last_compile);
+    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) +
+        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) +
+        (compileSurfaceExpected && !homePresent ? 1 : 0) +
+        (compileSurfaceExpected && !outputsPresent ? 1 : 0) +
+        (compileSurfaceExpected && analysisPending ? 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 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";
+}
+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";
+}
+export 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;
+}
+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.`;
+}
+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;
+}
+//# sourceMappingURL=state-health.js.map

package/dist/lib/state-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-health.js","sourceRoot":"","sources":["../../src/lib/state-health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAU9C,OAAO,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,SAAS,EACT,SAAS,GACV,MAAM,eAAe,CAAC;AAEvB,MAAM,UAAU,0BAA0B,CAAC,OAAe;IACxD,MAAM,KAAK,GAAG;QACZ,GAAG,sBAAsB,EAAE;QAC3B,GAAG,CAAC,SAAS,CAAqB,OAAO,CAAC,IAAI,EAAE,CAAC;KAClD,CAAC;IACF,MAAM,UAAU,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,iBAAiB,GAAG,MAAM,EAAE,IAAI,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,8BAA8B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAE3D,MAAM,gBAAgB,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAChE,MAAM,gBAAgB,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAChF,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,OAAO,GAAG,CAAC,CAAC;IACnC,MAAM,WAAW,GAAG,SAAS,CAAC,UAAU,CAAC;IACzC,MAAM,UAAU,GAAG,gBAAgB,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1F,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC,CAAC;IACrD,MAAM,QAAQ,GACZ,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,UAAU,GAAG,WAAW,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC,CAAC,cAAc,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,UAAU,CAAC,mBAAmB;QAC9B,UAAU,CAAC,eAAe;QAC1B,UAAU,CAAC,YAAY,CAAC;IAC1B,MAAM,MAAM,GACV,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,UAAU,CAAC,YAAY,IAAI,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,CAAC,CAAC,UAAU,CAAC,iBAAiB,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;IAC3B,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,aAAa,GAAG,yBAAyB,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAChH,MAAM,cAAc,GAAG,0BAA0B,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAClH,MAAM,KAAK,GACT,SAAS,EAAE,MAAM,KAAK,SAAS;QAC7B,CAAC,CAAC,SAAS,CAAC,aAAa,KAAK,oBAAoB;YAChD,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,CAAC,aAAa,KAAK,kBAAkB;gBAC9C,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,aAAa;QACnB,CAAC,CAAC,aAAa,CAAC;IACpB,MAAM,MAAM,GAAG,SAAS,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC;IAE5E,OAAO;QACL,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,CAAC;QACV,YAAY,EAAE,GAAG;QACjB,WAAW,EAAE,iBAAiB;QAC9B,MAAM;QACN,KAAK;QACL,OAAO,EACL,SAAS,EAAE,MAAM,KAAK,SAAS;YAC7B,CAAC,CAAC,aAAa,SAAS,CAAC,WAAW,QAAQ,SAAS,CAAC,QAAQ,CAAC,YAAY,KAAK,SAAS,CAAC,OAAO,EAAE;YACnG,CAAC,CAAC,yBAAyB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QAClJ,OAAO,EAAE;YACP,YAAY,EAAE,WAAW;YACzB,cAAc,EAAE,aAAa;YAC7B,UAAU;YACV,YAAY,EAAE,WAAW;YACzB,QAAQ;YACR,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,KAAK,CAAC,YAAY,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;YAC3F,MAAM,EAAE,KAAK,CAAC,WAAW,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;YACtF,OAAO;YACP,mBAAmB,EAAE,UAAU,CAAC,mBAAmB;YACnD,eAAe,EAAE,UAAU,CAAC,eAAe;YAC3C,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,QAAQ,EAAE,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC,GAAG,QAAQ;YAC/C,MAAM;SACP;QACD,MAAM,EAAE;YACN,cAAc,EAAE,UAAU,CAAC,cAAc;YACzC,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;YAC/C,iBAAiB,EAAE,gBAAgB;YACnC,iBAAiB,EAAE,gBAAgB;YACnC,eAAe,EAAE,cAAc;YAC/B,YAAY,EAAE,WAAW;YACzB,yBAAyB,EAAE,UAAU,CAAC,yBAAyB;YAC/D,eAAe,EAAE,UAAU,CAAC,eAAe;YAC3C,WAAW,EAAE,UAAU,CAAC,YAAY,KAAK,CAAC;SAC3C;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,MAAM,KAAK,GAAG;QACZ,GAAG,kBAAkB,EAAE;QACvB,GAAG,CAAC,SAAS,CAAiB,OAAO,CAAC,IAAI,EAAE,CAAC;KAC9C,CAAC;IACF,MAAM,UAAU,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,MAAM,EAAE,IAAI,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,iBAAiB,GACrB,MAAM,EAAE,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,cAAc,EAAE,IAAI;QACzD,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC;QAC9C,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,sBAAsB,GAAG,iBAAiB,KAAK,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC,CAAC;IAE9G,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;IAC3E,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;IAC9E,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,cAAc,GAAG,OAAO,GAAG,CAAC,CAAC;IACnC,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClH,MAAM,qBAAqB,GAAG,IAAI,CAAC,GAAG,CACpC,kBAAkB,EAClB,qCAAqC,CAAC,KAAK,EAAE,kBAAkB,CAAC,CACjE,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,GAAG,qBAAqB,CAAC,CAAC;IACvE,MAAM,oBAAoB,GAAG,yBAAyB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACzE,MAAM,qBAAqB,GAAG,yBAAyB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC3E,MAAM,sBAAsB,GAAG,CAAC,oBAAoB;QAClD,CAAC,qBAAqB;QACtB,OAAO,CAAC,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;IACxD,MAAM,QAAQ,GACZ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvG,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,CAAC,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,UAAU,CAAC,YAAY,CAAC;IAC1B,MAAM,MAAM,GACV,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,UAAU,CAAC,YAAY,IAAI,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,CAAC,CAAC,UAAU,CAAC,iBAAiB,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC,sBAAsB,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC,sBAAsB,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC,sBAAsB,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;IAE3B,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,aAAa,GAAG,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC3D,MAAM,cAAc,GAAG,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrE,MAAM,KAAK,GACT,SAAS,EAAE,MAAM,KAAK,SAAS;QAC7B,CAAC,CAAC,SAAS,CAAC,aAAa,KAAK,gBAAgB;YAC5C,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,SAAS,CAAC,aAAa,KAAK,qBAAqB;gBACjD,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,SAAS,CAAC,aAAa,KAAK,oBAAoB;oBAChD,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,SAAS,CAAC,aAAa,KAAK,kBAAkB;wBAC9C,CAAC,CAAC,SAAS;wBACf,CAAC,CAAC,aAAa;QACnB,CAAC,CAAC,aAAa,CAAC;IACpB,MAAM,MAAM,GAAG,SAAS,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC;IAE5E,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,CAAC;QACV,YAAY,EAAE,GAAG;QACjB,cAAc,EAAE,aAAa;QAC7B,MAAM;QACN,KAAK;QACL,OAAO,EACL,SAAS,EAAE,MAAM,KAAK,SAAS;YAC7B,CAAC,CAAC,aAAa,SAAS,CAAC,WAAW,QAAQ,SAAS,CAAC,QAAQ,CAAC,YAAY,KAAK,SAAS,CAAC,OAAO,EAAE;YACnG,CAAC,CAAC,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE;gBACnC,kBAAkB;gBAClB,qBAAqB;gBACrB,MAAM;gBACN,kBAAkB,EAAE,KAAK,CAAC,mBAAmB,IAAI,CAAC;gBAClD,aAAa,EAAE,KAAK,CAAC,cAAc,IAAI,CAAC;gBACxC,QAAQ,EAAE,KAAK,CAAC,cAAc,IAAI,CAAC;gBACnC,KAAK,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC;aAC9B,CAAC;QACR,OAAO,EAAE;YACP,oBAAoB,EAAE,kBAAkB;YACxC,uBAAuB,EAAE,qBAAqB;YAC9C,UAAU,EAAE,MAAM;YAClB,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,IAAI,CAAC;YACnD,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,CAAC;YAC3C,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,CAAC;YACzC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,CAAC;YAC7C,QAAQ,EAAE,KAAK,CAAC,cAAc,IAAI,CAAC;YACnC,QAAQ,EAAE,KAAK,CAAC,cAAc,IAAI,CAAC;YACnC,KAAK,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC;YAC7B,QAAQ,EACN,KAAK,CAAC,YAAY;gBAClB,KAAK,CAAC,kBAAkB;gBACxB,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;YAC7D,MAAM,EACJ,KAAK,CAAC,WAAW;gBACjB,KAAK,CAAC,gBAAgB;gBACtB,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;YAC3D,OAAO;YACP,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,QAAQ,EAAE,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC,GAAG,QAAQ;YAC/C,MAAM;SACP;QACD,MAAM,EAAE;YACN,cAAc,EAAE,UAAU,CAAC,cAAc;YACzC,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;YAC/C,yBAAyB,EAAE,sBAAsB;YACjD,cAAc,EAAE,aAAa;YAC7B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,KAAK;YACnD,aAAa,EAAE,YAAY;YAC3B,gBAAgB,EAAE,eAAe;YACjC,eAAe,EAAE,cAAc;YAC/B,YAAY,EAAE,WAAW;YACzB,WAAW,EAAE,UAAU,CAAC,YAAY,KAAK,CAAC;SAC3C;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAAgB,EAChB,UAAkB,EAClB,WAAmB,EACnB,SAAiB,EACjB,MAAc,EACd,KAAyB;IAEzB,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChC,IAAI,QAAQ,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,IAAI,KAAK,CAAC,cAAc,KAAK,IAAI,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACtH,IAAI,WAAW,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IACrD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAyB,EACzB,QAAgB,EAChB,UAAkB,EAClB,WAAmB,EACnB,SAAiB,EACjB,MAAc;IAEd,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChC,IAAI,QAAQ,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,IAAI,KAAK,CAAC,cAAc,KAAK,IAAI,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACtH,IAAI,WAAW,GAAG,CAAC;QAAE,OAAO,WAAW,CAAC;IACxC,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAqB,EACrB,MAAc,EACd,MAAc;IAEd,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChC,IAAI,yBAAyB,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,yBAAyB,CAAC,KAAK,EAAE,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IAClH,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAC/C,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAqB,EACrB,MAAc;IAEd,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChC,IAAI,yBAAyB,CAAC,KAAK,EAAE,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAClE,IAAI,yBAAyB,CAAC,KAAK,EAAE,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IACnE,IAAI,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,UAAU,CAAC;IACpE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,OAAe;IAC5D,MAAM,KAAK,GAAG;QACZ,GAAG,kBAAkB,EAAE;QACvB,GAAG,CAAC,SAAS,CAAiB,OAAO,CAAC,IAAI,EAAE,CAAC;KAC9C,CAAC;IACF,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,iBAAiB,GACrB,MAAM,EAAE,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,cAAc,EAAE,IAAI;QACzD,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC;QAC9C,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,kBAAkB,GACtB,iBAAiB,KAAK,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;QAC5E,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC,CAAC;IAER,IACE,KAAK,CAAC,gBAAgB,KAAK,IAAI;QAC/B,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;QACtC,kBAAkB,GAAG,CAAC;QACtB,CAAC,KAAK,CAAC,4CAA4C,IAAI,CAAC,CAAC,IAAI,CAAC,EAC9D,CAAC;QACD,KAAK,CAAC,4CAA4C,GAAG,kBAAkB,CAAC;QACxE,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,qCAAqC,CAC5C,KAAqB,EACrB,kBAA0B;IAE1B,MAAM,aAAa,GAAG,KAAK,CAAC,4CAA4C,IAAI,CAAC,CAAC;IAC9E,IAAI,aAAa,GAAG,CAAC;QAAE,OAAO,aAAa,CAAC;IAC5C,IAAI,KAAK,CAAC,gBAAgB,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9E,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,yBAAyB,CAChC,MAAqB,EACrB,KAAyB,EACzB,OAA+H;IAE/H,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,sDAAsD,CAAC;IACvF,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,6CAA6C,CAAC;IAC5E,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;QAC1B,OAAO,WAAW,OAAO,CAAC,WAAW,oCAAoC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,QAAQ,eAAe,CAAC;IACjI,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,WAAW,OAAO,CAAC,SAAS,wCAAwC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,UAAU,aAAa,CAAC;IACjI,CAAC;IACD,OAAO,cAAc,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,UAAU,wBAAwB,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,QAAQ,wBAAwB,CAAC;AACpJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAAqB,EACrB,KAAqB,EACrB,OAQC;IAED,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,iDAAiD,CAAC;IAClF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,KAAK,KAAK,QAAQ;YACvB,CAAC,CAAC,6BAA6B;YAC/B,CAAC,CAAC,yBAAyB,KAAK,gBAAgB,CAAC;IACrD,CAAC;IACD,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,6CAA6C,CAAC;IAC5E,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,OAAO,WAAW,OAAO,CAAC,MAAM,0CAA0C,OAAO,CAAC,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,YAAY,CAAC;IACpJ,CAAC;IACD,OAAO,sBAAsB,OAAO,CAAC,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,wBAAwB,OAAO,CAAC,aAAa,wBAAwB,OAAO,CAAC,QAAQ,cAAc,OAAO,CAAC,MAAM,cAAc,CAAC;AACvN,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO;QACL,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC;QACpC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;QACvB,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC;KAC3B,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,6BAA6B,CAAC,OAAe;IACpD,OAAO;QACL,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC;QACpC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC;KACtC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,yBAAyB,CAChC,KAAqB,EACrB,KAA6B;IAE7B,MAAM,aAAa,GAAG,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAC9F,MAAM,OAAO,GAAG,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IAEhF,IAAI,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IACjC,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,OAAO,GAAG,KAAK,CAAC,YAAY,CAAC;AACtC,CAAC"}

package/dist/lib/state-io.d.ts

@@ -0,0 +1,15 @@
+import { type InterfaceHealth, type InterfaceState, type InterfaceViewSpec, type KnowledgeBaseHealth, type KnowledgeBaseSourceAccess, type KnowledgeBaseState, type KnowledgeBaseViewSpec } from "./schema.js";
+export declare function loadState<T>(dirPath: string): T | null;
+export declare function saveState<T>(dirPath: string, state: T): void;
+export declare function loadInterfaceHealth(dirPath: string): InterfaceHealth | null;
+export declare function loadKnowledgeBaseHealth(dirPath: string): KnowledgeBaseHealth | null;
+export declare function saveInterfaceHealth(dirPath: string, health: InterfaceHealth): void;
+export declare function saveKnowledgeBaseHealth(dirPath: string, health: KnowledgeBaseHealth): void;
+export declare function loadInterfaceViewSpec(dirPath: string): InterfaceViewSpec | null;
+export declare function loadKnowledgeBaseViewSpec(dirPath: string): KnowledgeBaseViewSpec | null;
+export declare function loadKnowledgeBaseSourceAccess(dirPath: string): KnowledgeBaseSourceAccess | null;
+export declare function saveInterfaceViewSpec(dirPath: string, viewSpec: InterfaceViewSpec): void;
+export declare function saveKnowledgeBaseViewSpec(dirPath: string, viewSpec: KnowledgeBaseViewSpec): void;
+export declare function initKnowledgeBaseState(): KnowledgeBaseState;
+export declare function initInterfaceState(): InterfaceState;
+//# sourceMappingURL=state-io.d.ts.map

package/dist/lib/state-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-io.d.ts","sourceRoot":"","sources":["../../src/lib/state-io.ts"],"names":[],"mappings":"AASA,OAAO,EASL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AAcrB,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CA0BtD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAI5D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAI3E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAInF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAIlF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAI1F;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAI/E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAIvF;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI,CAI/F;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAIxF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAIhG;AAED,wBAAgB,sBAAsB,IAAI,kBAAkB,CAiB3D;AAED,wBAAgB,kBAAkB,IAAI,cAAc,CA2BnD"}