@interf/compiler 0.1.11 → 0.2.0

package/dist/lib/state-io.js

@@ -0,0 +1,219 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+import { warnInterf } from "./logger.js";
+import { readJsonFileUnchecked, readJsonFileWithSchema } from "./parse.js";
+import { InterfaceHealthSchema, KnowledgeBaseInventorySchema, InterfaceStateSchema, InterfaceViewSpecSchema, KnowledgeBaseHealthSchema, KnowledgeBaseSourceAccessSchema, KnowledgeBaseStateSchema, KnowledgeBaseViewSpecSchema, } from "./schema.js";
+import { readInventoryFiles, readInventoryTotal } from "./validate-helpers.js";
+import { STATE_DIR } from "./util.js";
+import { healthPath, sourceAccessPath, statePath, viewSpecPath } from "./state-paths.js";
+const RuntimeStateSchema = KnowledgeBaseStateSchema.or(InterfaceStateSchema);
+const NORMALIZABLE_RUNTIME_TIMESTAMP_FIELDS = [
+    "last_add",
+    "last_summarize",
+    "last_compile",
+    "last_retrieve",
+    "last_analyze",
+];
+export function loadState(dirPath) {
+    const p = statePath(dirPath);
+    if (!existsSync(p))
+        return null;
+    const raw = readJsonFileUnchecked(p, "runtime state");
+    if (raw === null)
+        return null;
+    const parsed = RuntimeStateSchema.safeParse(raw);
+    if (parsed.success) {
+        const healed = healParsedRuntimeState(dirPath, parsed.data);
+        if (healed !== null) {
+            saveState(dirPath, healed);
+            return healed;
+        }
+        return parsed.data;
+    }
+    const normalized = normalizeRuntimeState(raw);
+    if (normalized !== null) {
+        saveState(dirPath, normalized);
+        return normalized;
+    }
+    warnInterf(`Warning: failed to validate runtime state at ${p}: ${parsed.error.issues.map((issue) => issue.message).join("; ")}`);
+    return null;
+}
+export function saveState(dirPath, state) {
+    const dir = join(dirPath, STATE_DIR);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(statePath(dirPath), JSON.stringify(state, null, 2) + "\n");
+}
+export function loadInterfaceHealth(dirPath) {
+    const p = healthPath(dirPath);
+    if (!existsSync(p))
+        return null;
+    return readJsonFileWithSchema(p, "interface health", InterfaceHealthSchema);
+}
+export function loadKnowledgeBaseHealth(dirPath) {
+    const p = healthPath(dirPath);
+    if (!existsSync(p))
+        return null;
+    return readJsonFileWithSchema(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 readJsonFileWithSchema(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,
+    };
+}
+function normalizeRuntimeState(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const normalized = { ...raw };
+    let changed = false;
+    if (typeof normalized.build_complete === "boolean" &&
+        typeof normalized.compile_complete !== "boolean") {
+        normalized.compile_complete = normalized.build_complete;
+        changed = true;
+    }
+    const legacyBuildTimestamp = normalizeRuntimeTimestampField(normalized.last_build);
+    if (legacyBuildTimestamp !== undefined &&
+        (typeof normalized.last_compile !== "string" && normalized.last_compile !== null)) {
+        normalized.last_compile = legacyBuildTimestamp;
+        changed = true;
+    }
+    for (const field of NORMALIZABLE_RUNTIME_TIMESTAMP_FIELDS) {
+        const timestamp = normalizeRuntimeTimestampField(normalized[field]);
+        if (timestamp !== undefined && timestamp !== normalized[field]) {
+            normalized[field] = timestamp;
+            changed = true;
+        }
+    }
+    if (!changed)
+        return null;
+    const parsed = RuntimeStateSchema.safeParse(normalized);
+    return parsed.success ? parsed.data : null;
+}
+function healParsedRuntimeState(dirPath, state) {
+    if (!("pending" in state) || typeof state.summarized !== "number")
+        return null;
+    if (typeof state.inventory_complete === "boolean")
+        return null;
+    if (!Array.isArray(state.pending) || state.pending.length > 0)
+        return null;
+    if (typeof state.last_summarize !== "string" || state.last_summarize.length === 0)
+        return null;
+    const inventoryPath = join(dirPath, STATE_DIR, "inventory.json");
+    if (!existsSync(inventoryPath))
+        return null;
+    const inventory = readJsonFileWithSchema(inventoryPath, "knowledge-base inventory", KnowledgeBaseInventorySchema);
+    if (inventory === null)
+        return null;
+    const inventoryFiles = readInventoryFiles(inventory);
+    const inventoryTotal = readInventoryTotal(inventory, inventoryFiles);
+    if (inventoryTotal !== state.summarized || inventoryFiles.files.length !== state.summarized)
+        return null;
+    return {
+        ...state,
+        inventory_complete: true,
+    };
+}
+function normalizeRuntimeTimestampField(value) {
+    if (typeof value === "string" || value === null)
+        return value;
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const record = value;
+    for (const key of ["generated_at", "finished_at", "updated_at", "started_at", "timestamp"]) {
+        const candidate = record[key];
+        if (typeof candidate === "string" && candidate.length > 0) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+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 (error) {
+        warnInterf(`Warning: failed to read view spec at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        return null;
+    }
+}
+//# sourceMappingURL=state-io.js.map

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

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

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

@@ -0,0 +1,5 @@
+export declare function statePath(dirPath: string): string;
+export declare function healthPath(dirPath: string): string;
+export declare function viewSpecPath(dirPath: string): string;
+export declare function sourceAccessPath(dirPath: string): string;
+//# sourceMappingURL=state-paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state-paths.d.ts","sourceRoot":"","sources":["../../src/lib/state-paths.ts"],"names":[],"mappings":"AAQA,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/lib/state-paths.js

@@ -0,0 +1,19 @@
+import { join } from "node:path";
+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);
+}
+//# sourceMappingURL=state-paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state-paths.js","sourceRoot":"","sources":["../../src/lib/state-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,UAAU,GAAG,YAAY,CAAC;AAChC,MAAM,WAAW,GAAG,aAAa,CAAC;AAClC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AACxC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEhD,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;AACtD,CAAC"}

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

@@ -0,0 +1,7 @@
+import { type InterfaceViewSpec, type KnowledgeBaseSourceAccess, type KnowledgeBaseViewSpec } from "./schema.js";
+export declare function ensureInterfaceViewSpec(dirPath: string): InterfaceViewSpec;
+export declare function ensureKnowledgeBaseViewSpec(dirPath: string): KnowledgeBaseViewSpec;
+export declare function ensureKnowledgeBaseSourceAccess(dirPath: string): KnowledgeBaseSourceAccess;
+export declare function normalizeInterfaceViewSpec(existing: InterfaceViewSpec, defaults: InterfaceViewSpec): InterfaceViewSpec;
+export declare function normalizeKnowledgeBaseViewSpec(existing: KnowledgeBaseViewSpec, defaults: KnowledgeBaseViewSpec): KnowledgeBaseViewSpec;
+//# sourceMappingURL=state-view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state-view.d.ts","sourceRoot":"","sources":["../../src/lib/state-view.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AAUrB,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAyC1E;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAwClF;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,yBAAyB,CA0B1F;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,iBAAiB,GAC1B,iBAAiB,CAuBnB;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,qBAAqB,EAC/B,QAAQ,EAAE,qBAAqB,GAC9B,qBAAqB,CAcvB"}

package/dist/lib/state-view.js

@@ -0,0 +1,147 @@
+import { basename, relative, resolve, join } from "node:path";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { discoverSourceFiles } from "./discovery.js";
+import { readInterfConfig, resolveKnowledgeBaseSourcePath } from "./interf.js";
+import { loadInterfaceViewSpec, loadKnowledgeBaseViewSpec, saveInterfaceViewSpec, saveKnowledgeBaseViewSpec, } from "./state-io.js";
+import { sourceAccessPath } from "./state-paths.js";
+import { STATE_DIR } from "./util.js";
+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 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,
+    };
+}
+//# sourceMappingURL=state-view.js.map

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

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

package/dist/lib/state.d.ts

@@ -1,47 +1,7 @@
-import { type InterfaceHealth, type InterfaceState, type InterfaceViewSpec, type KnowledgeBaseHealth, type KnowledgeBaseSourceAccess, type KnowledgeBaseState, type KnowledgeBaseViewSpec } from "./schema.js";
-export type RuntimeStatus = "idle" | "running" | "compiled" | "stale" | "failed";
-export type KnowledgeBaseStage = "idle" | "summarize" | "compile" | "compiled" | "failed";
-export type InterfaceStage = "idle" | "create" | "retrieve" | "analyze" | "compile" | "compiled" | "failed";
-export type { KnowledgeBaseState, InterfaceState, KnowledgeBaseHealth, InterfaceHealth, ViewSection, ViewCard, KnowledgeBaseViewSpec, InterfaceViewSpec, KnowledgeBaseSourceAccess } from "./schema.js";
-export declare function statePath(dirPath: string): string;
-export declare function healthPath(dirPath: string): string;
-export declare function viewSpecPath(dirPath: string): string;
-export declare function sourceAccessPath(dirPath: string): string;
-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;
-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;
-};
-export declare function computeKnowledgeBaseHealth(dirPath: string): KnowledgeBaseHealth;
-export declare function computeInterfaceHealth(dirPath: string): InterfaceHealth;
-export declare function ensureInterfaceViewSpec(dirPath: string): InterfaceViewSpec;
-export declare function ensureKnowledgeBaseViewSpec(dirPath: string): KnowledgeBaseViewSpec;
-export declare function ensureKnowledgeBaseSourceAccess(dirPath: string): KnowledgeBaseSourceAccess;
-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 normalizeInterfaceViewSpec(existing: InterfaceViewSpec, defaults: InterfaceViewSpec): InterfaceViewSpec;
-export declare function normalizeKnowledgeBaseViewSpec(existing: KnowledgeBaseViewSpec, defaults: KnowledgeBaseViewSpec): KnowledgeBaseViewSpec;
-export declare function resolveInterfaceStatus(state: InterfaceState, toSync: number, errors: number): RuntimeStatus;
-export declare function resolveInterfaceStage(state: InterfaceState, errors: number): InterfaceStage;
+export type { RuntimeStatus, KnowledgeBaseStage, InterfaceStage, KnowledgeBaseState, InterfaceState, KnowledgeBaseHealth, InterfaceHealth, ViewSection, ViewCard, KnowledgeBaseViewSpec, InterfaceViewSpec, KnowledgeBaseSourceAccess, } from "./schema.js";
+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.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/lib/state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/lib/state.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,QAAQ,EACR,qBAAqB,EACrB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,+BAA+B,EAC/B,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC"}