@interf/compiler 0.4.0 → 0.5.0

package/dist/lib/registry.d.ts

@@ -1,16 +0,0 @@
-export interface WorkspaceEntry {
-    name: string;
-    path: string;
-    workflow: string;
-    created: string;
-}
-export interface Registry {
-    version: number;
-    workspaces: WorkspaceEntry[];
-}
-export declare function loadRegistry(): Registry;
-export declare function saveRegistry(registry: Registry): void;
-export declare function listWorkspaceEntries(registry?: Registry): WorkspaceEntry[];
-export declare function addWorkspace(name: string, path: string, workflow: string): void;
-export declare function findWorkspaceByName(name: string): WorkspaceEntry[];
-export declare function findInterf(name: string): WorkspaceEntry | undefined;

package/dist/lib/registry.js

@@ -1,65 +0,0 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { INTERF_HOME, REGISTRY_PATH } from "./config.js";
-import { readJsonFileUnchecked } from "./parse.js";
-function normalizeWorkspaceEntry(value) {
-    const name = String(value.name ?? "");
-    const path = String(value.path ?? "");
-    if (name.length === 0 || path.length === 0)
-        return null;
-    return {
-        name,
-        path,
-        workflow: String(value.workflow ?? "interf"),
-        created: String(value.created ?? new Date().toISOString()),
-    };
-}
-export function loadRegistry() {
-    const empty = { version: 7, workspaces: [] };
-    if (!existsSync(REGISTRY_PATH)) {
-        return empty;
-    }
-    const raw = readJsonFileUnchecked(REGISTRY_PATH, "Interf registry");
-    if (!raw)
-        return empty;
-    const seen = new Set();
-    const workspaces = [];
-    const rawWorkspaces = Array.isArray(raw.workspaces) ? raw.workspaces : [];
-    for (const value of rawWorkspaces) {
-        if (!value || typeof value !== "object")
-            continue;
-        const entry = normalizeWorkspaceEntry(value);
-        if (!entry || seen.has(entry.path))
-            continue;
-        seen.add(entry.path);
-        workspaces.push(entry);
-    }
-    return {
-        version: 7,
-        workspaces,
-    };
-}
-export function saveRegistry(registry) {
-    mkdirSync(INTERF_HOME, { recursive: true });
-    writeFileSync(REGISTRY_PATH, JSON.stringify({ version: 7, workspaces: registry.workspaces }, null, 2) + "\n");
-}
-export function listWorkspaceEntries(registry = loadRegistry()) {
-    return [...registry.workspaces].sort((left, right) => left.name.localeCompare(right.name) || left.path.localeCompare(right.path));
-}
-export function addWorkspace(name, path, workflow) {
-    const reg = loadRegistry();
-    reg.workspaces = reg.workspaces.filter((entry) => entry.path !== path);
-    reg.workspaces.push({
-        name,
-        path,
-        workflow,
-        created: new Date().toISOString(),
-    });
-    saveRegistry(reg);
-}
-export function findWorkspaceByName(name) {
-    return listWorkspaceEntries().filter((workspace) => workspace.name === name);
-}
-export function findInterf(name) {
-    const matches = listWorkspaceEntries().filter((workspace) => workspace.name === name);
-    return matches.length === 1 ? matches[0] : undefined;
-}

package/dist/lib/validate-workspace.d.ts

@@ -1,121 +0,0 @@
-export interface WorkspaceValidationSummary {
-    config_present: boolean;
-    config_valid: boolean;
-    config_type_match: boolean;
-    summary_frontmatter_valid: boolean;
-    abstracts_valid: boolean;
-    invalid_frontmatter: number;
-    short_abstracts: number;
-    broken_links: number;
-}
-export interface WorkspaceSummarizeValidation {
-    ok: boolean;
-    required: boolean;
-    summary: string;
-    counts: {
-        source_total: number;
-        source_covered: number;
-        summarized: number;
-        to_summarize: number;
-        invalid_frontmatter: number;
-        short_abstracts: number;
-        inventory_total: number;
-    };
-    checks: {
-        config_present: boolean;
-        config_valid: boolean;
-        config_type_match: boolean;
-        summaries_present: boolean;
-        state_present: boolean;
-        state_valid: boolean;
-        inventory_present: boolean;
-        inventory_valid: boolean;
-        inventory_complete: boolean;
-        inventory_matches_summaries: boolean;
-        state_covers_summaries: boolean;
-        full_source_coverage: boolean;
-        summary_frontmatter_valid: boolean;
-        abstracts_valid: boolean;
-    };
-    errors: string[];
-}
-export interface WorkspaceCompileValidation {
-    ok: boolean;
-    required: boolean;
-    summary: string;
-    counts: {
-        source_total: number;
-        summarized: number;
-        structured: number;
-        shaped: number;
-        compiled: number;
-        inventory_total: number;
-        frontmatter_scanned: number;
-        abstracts_read: number;
-        full_reads: number;
-        entity_files: number;
-        claim_files: number;
-        index_files: number;
-        outputs: number;
-    };
-    checks: {
-        config_present: boolean;
-        config_valid: boolean;
-        config_type_match: boolean;
-        summarize_complete: boolean;
-        structure_complete: boolean;
-        state_present: boolean;
-        state_valid: boolean;
-        inventory_present: boolean;
-        inventory_valid: boolean;
-        inventory_complete: boolean;
-        inventory_matches_summaries: boolean;
-        frontmatter_inventory_complete: boolean;
-        abstracts_cover_summaries: boolean;
-        shaped_complete: boolean;
-        compiled_complete: boolean;
-        outputs_present: boolean;
-        home_present: boolean;
-        links_valid: boolean;
-    };
-    errors: string[];
-}
-export interface WorkspaceStructureValidation {
-    ok: boolean;
-    required: boolean;
-    summary: string;
-    counts: {
-        source_total: number;
-        summarized: number;
-        structured: number;
-        inventory_total: number;
-        frontmatter_scanned: number;
-        abstracts_read: number;
-        entity_files: number;
-        claim_files: number;
-        index_files: number;
-        outputs: number;
-    };
-    checks: {
-        config_present: boolean;
-        config_valid: boolean;
-        config_type_match: boolean;
-        summarize_complete: boolean;
-        state_present: boolean;
-        state_valid: boolean;
-        inventory_present: boolean;
-        inventory_valid: boolean;
-        inventory_complete: boolean;
-        inventory_matches_summaries: boolean;
-        frontmatter_inventory_complete: boolean;
-        abstracts_cover_summaries: boolean;
-        structured_complete: boolean;
-        outputs_present: boolean;
-        links_valid: boolean;
-    };
-    errors: string[];
-}
-export declare function validateWorkspace(dirPath: string): WorkspaceValidationSummary;
-export declare function validateWorkspaceSummarize(dirPath: string): WorkspaceSummarizeValidation;
-export declare function validateWorkspaceCompile(dirPath: string): WorkspaceCompileValidation;
-export declare function validateWorkspaceStructure(dirPath: string): WorkspaceStructureValidation;

package/dist/lib/validate-workspace.js

@@ -1,407 +0,0 @@
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-import { countFilesRecursive, listFilesRecursive } from "./filesystem.js";
-import { discoverSourceFiles } from "./discovery.js";
-import { resolveSourceFolderPath } from "./interf.js";
-import { readJsonFileUnchecked } from "./parse.js";
-import { workspaceHomeIsShaped } from "./workspace-home.js";
-import { WorkspaceInventorySchema, WorkspaceStateSchema, } from "./schema.js";
-import { readWorkspaceConfig, validateSynthFiles, countBrokenWikilinks, asNumber, isOutputMarkdownFile, } from "./validate.js";
-import { readInventoryFiles, readInventoryTotal, } from "./validate-helpers.js";
-import { workspaceInterfConfigPath, workspaceRuntimeRoot, } from "./workspace-paths.js";
-export function validateWorkspace(dirPath) {
-    const config = readWorkspaceConfig(dirPath);
-    const summaryFiles = listFilesRecursive(join(dirPath, "summaries"), isOutputMarkdownFile);
-    const summaryValidation = validateSynthFiles(summaryFiles);
-    const brokenLinks = countBrokenWikilinks(dirPath, [join(dirPath, "summaries"), join(dirPath, "knowledge")], [join(dirPath, "summaries"), join(dirPath, "knowledge")]);
-    return {
-        config_present: config.present,
-        config_valid: config.valid,
-        config_type_match: config.typeMatch(),
-        summary_frontmatter_valid: summaryValidation.invalid_frontmatter === 0,
-        abstracts_valid: summaryValidation.short_abstracts === 0,
-        invalid_frontmatter: summaryValidation.invalid_frontmatter,
-        short_abstracts: summaryValidation.short_abstracts,
-        broken_links: brokenLinks,
-    };
-}
-export function validateWorkspaceSummarize(dirPath) {
-    const config = readWorkspaceConfig(dirPath);
-    const sourcePath = resolveSourceFolderPath(dirPath, config.value);
-    const discovery = discoverSourceFiles(sourcePath, dirPath);
-    const sourceTotal = discovery.totalCount;
-    const summariesPresent = existsSync(join(dirPath, "summaries"));
-    const summaryFiles = listFilesRecursive(join(dirPath, "summaries"), isOutputMarkdownFile);
-    const summaryValidation = validateSynthFiles(summaryFiles);
-    const summarized = summaryFiles.length;
-    const runtimeRoot = workspaceRuntimeRoot(dirPath);
-    const statePath = join(runtimeRoot, "state.json");
-    const inventoryPath = join(runtimeRoot, "inventory.json");
-    const statePresent = existsSync(statePath);
-    const inventoryPresent = existsSync(inventoryPath);
-    const state = statePresent
-        ? readJsonFileUnchecked(statePath, "workspace state")
-        : null;
-    const inventory = inventoryPresent
-        ? readJsonFileUnchecked(inventoryPath, "workspace inventory")
-        : null;
-    const inventoryValid = inventory !== null && WorkspaceInventorySchema.safeParse(inventory).success;
-    const inventoryFilesByShape = readInventoryFiles(inventory);
-    const inventoryFiles = inventoryFilesByShape.files;
-    const inventoryTotal = readInventoryTotal(inventory, inventoryFilesByShape);
-    const sourceCovered = Math.min(sourceTotal, summarized);
-    const toSummarize = Math.max(0, sourceTotal - sourceCovered);
-    const required = sourceTotal > 0 || summarized > 0;
-    const checks = {
-        config_present: config.present,
-        config_valid: config.valid,
-        config_type_match: config.typeMatch(),
-        summaries_present: summariesPresent,
-        state_present: statePresent,
-        state_valid: state !== null && WorkspaceStateSchema.safeParse(state).success,
-        inventory_present: inventoryPresent,
-        inventory_valid: inventoryValid,
-        inventory_complete: Boolean(state?.inventory_complete) === true,
-        inventory_matches_summaries: inventoryValid && inventoryTotal === summarized && inventoryFiles.length === summarized,
-        state_covers_summaries: asNumber(state?.summarized) >= summarized &&
-            typeof state?.last_summarize === "string" &&
-            state.last_summarize.length > 0,
-        full_source_coverage: toSummarize === 0,
-        summary_frontmatter_valid: summaryValidation.invalid_frontmatter === 0,
-        abstracts_valid: summaryValidation.short_abstracts === 0,
-    };
-    const errors = [];
-    if (!checks.config_present)
-        errors.push(`Missing ${workspaceInterfConfigPath(dirPath)}.`);
-    else if (!checks.config_valid)
-        errors.push(`Could not parse ${workspaceInterfConfigPath(dirPath)}.`);
-    else if (!checks.config_type_match)
-        errors.push("Config is not a workspace.");
-    if (required && !checks.summaries_present)
-        errors.push("Missing summaries/ directory.");
-    if (required && !checks.state_present)
-        errors.push("Missing .interf/runtime/state.json.");
-    else if (required && !checks.state_valid)
-        errors.push("Could not parse .interf/runtime/state.json.");
-    if (required && !checks.inventory_present)
-        errors.push("Missing .interf/runtime/inventory.json.");
-    else if (required && !checks.inventory_valid)
-        errors.push("Could not parse .interf/runtime/inventory.json or it has the wrong shape.");
-    if (required && checks.inventory_present && checks.inventory_valid && !checks.inventory_complete) {
-        errors.push("state.json does not mark inventory_complete.");
-    }
-    if (required && checks.inventory_present && checks.inventory_valid && !checks.inventory_matches_summaries) {
-        errors.push("Inventory does not match the summary set.");
-    }
-    if (required && checks.state_present && checks.state_valid && !checks.state_covers_summaries) {
-        errors.push("state.json does not prove summarize completion.");
-    }
-    if (!checks.full_source_coverage)
-        errors.push("Not every source file has a summary yet.");
-    if (!checks.summary_frontmatter_valid)
-        errors.push("Some summary files have invalid or incomplete frontmatter.");
-    if (!checks.abstracts_valid)
-        errors.push("Some summary files are missing a valid abstract block.");
-    const ok = errors.length === 0;
-    const summary = !required
-        ? "Summarize not required yet — no source files discovered."
-        : ok
-            ? `Summarize verified — ${sourceCovered}/${sourceTotal} source files are covered by valid summaries.`
-            : `Summarize failed — ${errors[0] ?? "incomplete summary coverage."}`;
-    return {
-        ok,
-        required,
-        summary,
-        counts: {
-            source_total: sourceTotal,
-            source_covered: sourceCovered,
-            summarized,
-            to_summarize: toSummarize,
-            invalid_frontmatter: summaryValidation.invalid_frontmatter,
-            short_abstracts: summaryValidation.short_abstracts,
-            inventory_total: inventoryTotal,
-        },
-        checks,
-        errors,
-    };
-}
-export function validateWorkspaceCompile(dirPath) {
-    const summarizeValidation = validateWorkspaceSummarize(dirPath);
-    const structureValidation = validateWorkspaceStructure(dirPath);
-    const config = readWorkspaceConfig(dirPath);
-    const runtimeRoot = workspaceRuntimeRoot(dirPath);
-    const statePath = join(runtimeRoot, "state.json");
-    const inventoryPath = join(runtimeRoot, "inventory.json");
-    const statePresent = existsSync(statePath);
-    const inventoryPresent = existsSync(inventoryPath);
-    const state = statePresent
-        ? readJsonFileUnchecked(statePath, "workspace state")
-        : null;
-    const inventory = inventoryPresent
-        ? readJsonFileUnchecked(inventoryPath, "workspace inventory")
-        : null;
-    const summarized = countFilesRecursive(join(dirPath, "summaries"));
-    const structured = Math.max(asNumber(state?.structured), asNumber(state?.compiled));
-    const shaped = Math.max(asNumber(state?.shaped), asNumber(state?.compiled));
-    const compiled = asNumber(state?.compiled);
-    const inventoryFilesByShape = readInventoryFiles(inventory);
-    const { legacyFiles: legacyInventoryFiles, summaryFiles: summaryInventoryFiles, entryFiles: entryInventoryFiles, files: inventoryFiles, } = inventoryFilesByShape;
-    const inventoryTotal = readInventoryTotal(inventory, inventoryFilesByShape);
-    const frontmatterScanned = legacyInventoryFiles.length > 0
-        ? inventoryFiles.filter((file) => file.frontmatter_scanned === true || file.frontmatter_read === true).length
-        : summaryInventoryFiles.length > 0
-            ? inventoryFiles.filter((file) => typeof file.file === "string" && typeof file.source === "string").length
-            : inventoryFiles.filter((file) => (typeof file.summary === "string" || typeof file.digest === "string") &&
-                typeof file.source === "string").length;
-    const abstractsRead = legacyInventoryFiles.length > 0
-        ? inventoryFiles.filter((file) => file.abstract_read === true).length
-        : summaryInventoryFiles.length > 0
-            ? inventoryFiles.filter((file) => file.abstract_read === true ||
-                (typeof file.abstract === "string" && file.abstract.trim().length > 0) ||
-                typeof file.status === "string" ||
-                typeof file.state === "string").length
-            : inventoryFiles.filter((file) => typeof file.state === "string").length;
-    const entryAbstractsRead = entryInventoryFiles.length > 0
-        ? entryInventoryFiles.filter((file) => typeof file.abstract === "string" && file.abstract.trim().length > 0).length
-        : 0;
-    const effectiveAbstractsRead = entryInventoryFiles.length > 0 && summaryInventoryFiles.length === 0 && legacyInventoryFiles.length === 0
-        ? Math.max(abstractsRead, entryAbstractsRead)
-        : abstractsRead;
-    const fullReads = asNumber(state?.full_reads);
-    const entityFiles = countFilesRecursive(join(dirPath, "knowledge", "entities"));
-    const claimFiles = countFilesRecursive(join(dirPath, "knowledge", "claims"));
-    const indexFiles = countFilesRecursive(join(dirPath, "knowledge", "indexes"));
-    const outputs = entityFiles + claimFiles + indexFiles;
-    const homePresent = existsSync(join(dirPath, "home.md"));
-    const homeShaped = workspaceHomeIsShaped(dirPath);
-    const brokenLinks = countBrokenWikilinks(dirPath, [join(dirPath, "summaries"), join(dirPath, "knowledge"), join(dirPath, "home.md")], [join(dirPath, "summaries"), join(dirPath, "knowledge"), join(dirPath, "home.md")]);
-    const required = structureValidation.required || homePresent || shaped > 0 || compiled > 0 || inventoryPresent;
-    const checks = {
-        config_present: config.present,
-        config_valid: config.valid,
-        config_type_match: config.typeMatch(),
-        summarize_complete: summarizeValidation.ok && summarizeValidation.required,
-        structure_complete: structureValidation.ok && structureValidation.required,
-        state_present: statePresent,
-        state_valid: state !== null && WorkspaceStateSchema.safeParse(state).success,
-        inventory_present: inventoryPresent,
-        inventory_valid: inventory !== null && WorkspaceInventorySchema.safeParse(inventory).success,
-        inventory_complete: Boolean(state?.inventory_complete) === true,
-        inventory_matches_summaries: inventoryTotal === summarized && inventoryFiles.length === summarized,
-        frontmatter_inventory_complete: frontmatterScanned === summarized,
-        abstracts_cover_summaries: asNumber(state?.abstracts_read) >= summarized && effectiveAbstractsRead >= summarized,
-        shaped_complete: shaped >= summarized &&
-            summarized > 0 &&
-            typeof state?.last_shape === "string" &&
-            state.last_shape.length > 0,
-        compiled_complete: compiled >= summarized &&
-            summarized > 0 &&
-            typeof state?.last_compile === "string" &&
-            state.last_compile.length > 0,
-        outputs_present: outputs > 0,
-        home_present: homePresent,
-        home_shaped: homeShaped,
-        links_valid: brokenLinks === 0,
-    };
-    const errors = [];
-    if (!checks.config_present)
-        errors.push(`Missing ${workspaceInterfConfigPath(dirPath)}.`);
-    else if (!checks.config_valid)
-        errors.push(`Could not parse ${workspaceInterfConfigPath(dirPath)}.`);
-    else if (!checks.config_type_match)
-        errors.push("Config is not a workspace.");
-    if (!checks.summarize_complete)
-        errors.push("Workspace summarize is incomplete or invalid.");
-    if (!checks.structure_complete)
-        errors.push("Workspace structure is incomplete or invalid.");
-    if (!checks.state_present)
-        errors.push("Missing .interf/runtime/state.json.");
-    else if (!checks.state_valid)
-        errors.push("Could not parse .interf/runtime/state.json.");
-    if (!checks.inventory_present)
-        errors.push("Missing .interf/runtime/inventory.json.");
-    else if (!checks.inventory_valid)
-        errors.push("Could not parse .interf/runtime/inventory.json or it has the wrong shape.");
-    if (checks.inventory_present && checks.inventory_valid && !checks.inventory_complete) {
-        errors.push("state.json does not mark inventory_complete.");
-    }
-    if (checks.inventory_present && checks.inventory_valid && !checks.inventory_matches_summaries) {
-        errors.push("Inventory does not match the summary set.");
-    }
-    if (checks.inventory_present && checks.inventory_valid && !checks.frontmatter_inventory_complete) {
-        errors.push("Not every summary is marked frontmatter_scanned in inventory.");
-    }
-    if (checks.state_present && checks.state_valid && !checks.abstracts_cover_summaries) {
-        errors.push("Abstract review does not cover the full summary set.");
-    }
-    if (checks.state_present && checks.state_valid && !checks.shaped_complete) {
-        errors.push("state.json does not prove final workspace shaping.");
-    }
-    if (checks.state_present && checks.state_valid && !checks.compiled_complete) {
-        errors.push("state.json compiled count does not cover the full summary set.");
-    }
-    if (!checks.outputs_present)
-        errors.push("Workspace compile outputs are missing or empty.");
-    if (!checks.home_present)
-        errors.push("Workspace home.md is missing.");
-    if (checks.home_present && !checks.home_shaped) {
-        errors.push("Workspace home.md still contains the uncompiled scaffold placeholder.");
-    }
-    if (!checks.links_valid)
-        errors.push("Some knowledge notes contain broken wikilinks.");
-    const ok = required ? errors.length === 0 : true;
-    const summary = !required
-        ? "Workspace compile not required yet — no summaries exist yet."
-        : ok
-            ? `Workspace compile verified — ${compiled}/${summarized} summaries shaped and compiled, ${entityFiles} entities, ${claimFiles} claims.`
-            : `Workspace compile failed — ${errors[0] ?? "incomplete compile."}`;
-    return {
-        ok,
-        required,
-        summary,
-        counts: {
-            source_total: summarizeValidation.counts.source_total,
-            summarized,
-            structured,
-            shaped,
-            compiled,
-            inventory_total: inventoryTotal,
-            frontmatter_scanned: frontmatterScanned,
-            abstracts_read: Math.max(asNumber(state?.abstracts_read), effectiveAbstractsRead),
-            full_reads: fullReads,
-            entity_files: entityFiles,
-            claim_files: claimFiles,
-            index_files: indexFiles,
-            outputs,
-        },
-        checks,
-        errors,
-    };
-}
-export function validateWorkspaceStructure(dirPath) {
-    const summarizeValidation = validateWorkspaceSummarize(dirPath);
-    const config = readWorkspaceConfig(dirPath);
-    const runtimeRoot = workspaceRuntimeRoot(dirPath);
-    const statePath = join(runtimeRoot, "state.json");
-    const inventoryPath = join(runtimeRoot, "inventory.json");
-    const statePresent = existsSync(statePath);
-    const inventoryPresent = existsSync(inventoryPath);
-    const state = statePresent
-        ? readJsonFileUnchecked(statePath, "workspace state")
-        : null;
-    const inventory = inventoryPresent
-        ? readJsonFileUnchecked(inventoryPath, "workspace inventory")
-        : null;
-    const summarized = countFilesRecursive(join(dirPath, "summaries"));
-    const structured = Math.max(asNumber(state?.structured), asNumber(state?.compiled));
-    const inventoryFilesByShape = readInventoryFiles(inventory);
-    const { legacyFiles: legacyInventoryFiles, summaryFiles: summaryInventoryFiles, entryFiles: entryInventoryFiles, files: inventoryFiles, } = inventoryFilesByShape;
-    const inventoryTotal = readInventoryTotal(inventory, inventoryFilesByShape);
-    const frontmatterScanned = legacyInventoryFiles.length > 0
-        ? inventoryFiles.filter((file) => file.frontmatter_scanned === true || file.frontmatter_read === true).length
-        : summaryInventoryFiles.length > 0
-            ? inventoryFiles.filter((file) => typeof file.file === "string" && typeof file.source === "string").length
-            : inventoryFiles.filter((file) => (typeof file.summary === "string" || typeof file.digest === "string") &&
-                typeof file.source === "string").length;
-    const abstractsRead = legacyInventoryFiles.length > 0
-        ? inventoryFiles.filter((file) => file.abstract_read === true).length
-        : summaryInventoryFiles.length > 0
-            ? inventoryFiles.filter((file) => file.abstract_read === true ||
-                (typeof file.abstract === "string" && file.abstract.trim().length > 0) ||
-                typeof file.status === "string" ||
-                typeof file.state === "string").length
-            : inventoryFiles.filter((file) => typeof file.state === "string").length;
-    const entryAbstractsRead = entryInventoryFiles.length > 0
-        ? entryInventoryFiles.filter((file) => typeof file.abstract === "string" && file.abstract.trim().length > 0).length
-        : 0;
-    const effectiveAbstractsRead = entryInventoryFiles.length > 0 && summaryInventoryFiles.length === 0 && legacyInventoryFiles.length === 0
-        ? Math.max(abstractsRead, entryAbstractsRead)
-        : abstractsRead;
-    const entityFiles = countFilesRecursive(join(dirPath, "knowledge", "entities"));
-    const claimFiles = countFilesRecursive(join(dirPath, "knowledge", "claims"));
-    const indexFiles = countFilesRecursive(join(dirPath, "knowledge", "indexes"));
-    const outputs = entityFiles + claimFiles + indexFiles;
-    const brokenLinks = countBrokenWikilinks(dirPath, [join(dirPath, "summaries"), join(dirPath, "knowledge")], [join(dirPath, "summaries"), join(dirPath, "knowledge")]);
-    const required = summarizeValidation.required || outputs > 0 || structured > 0 || inventoryPresent;
-    const checks = {
-        config_present: config.present,
-        config_valid: config.valid,
-        config_type_match: config.typeMatch(),
-        summarize_complete: summarizeValidation.ok && summarizeValidation.required,
-        state_present: statePresent,
-        state_valid: state !== null && WorkspaceStateSchema.safeParse(state).success,
-        inventory_present: inventoryPresent,
-        inventory_valid: inventory !== null && WorkspaceInventorySchema.safeParse(inventory).success,
-        inventory_complete: Boolean(state?.inventory_complete) === true,
-        inventory_matches_summaries: inventoryTotal === summarized && inventoryFiles.length === summarized,
-        frontmatter_inventory_complete: frontmatterScanned === summarized,
-        abstracts_cover_summaries: asNumber(state?.abstracts_read) >= summarized && effectiveAbstractsRead >= summarized,
-        structured_complete: structured >= summarized &&
-            summarized > 0 &&
-            typeof state?.last_structure === "string" &&
-            state.last_structure.length > 0,
-        outputs_present: outputs > 0,
-        links_valid: brokenLinks === 0,
-    };
-    const errors = [];
-    if (!checks.config_present)
-        errors.push(`Missing ${workspaceInterfConfigPath(dirPath)}.`);
-    else if (!checks.config_valid)
-        errors.push(`Could not parse ${workspaceInterfConfigPath(dirPath)}.`);
-    else if (!checks.config_type_match)
-        errors.push("Config is not a workspace.");
-    if (!checks.summarize_complete)
-        errors.push("Workspace summarize is incomplete or invalid.");
-    if (!checks.state_present)
-        errors.push("Missing .interf/runtime/state.json.");
-    else if (!checks.state_valid)
-        errors.push("Could not parse .interf/runtime/state.json.");
-    if (!checks.inventory_present)
-        errors.push("Missing .interf/runtime/inventory.json.");
-    else if (!checks.inventory_valid)
-        errors.push("Could not parse .interf/runtime/inventory.json or it has the wrong shape.");
-    if (checks.inventory_present && checks.inventory_valid && !checks.inventory_complete) {
-        errors.push("state.json does not mark inventory_complete.");
-    }
-    if (checks.inventory_present && checks.inventory_valid && !checks.inventory_matches_summaries) {
-        errors.push("Inventory does not match the summary set.");
-    }
-    if (checks.inventory_present && checks.inventory_valid && !checks.frontmatter_inventory_complete) {
-        errors.push("Not every summary is marked frontmatter_scanned in inventory.");
-    }
-    if (checks.state_present && checks.state_valid && !checks.abstracts_cover_summaries) {
-        errors.push("Abstract review does not cover the full summary set.");
-    }
-    if (checks.state_present && checks.state_valid && !checks.structured_complete) {
-        errors.push("state.json does not prove workspace structure completion.");
-    }
-    if (!checks.outputs_present)
-        errors.push("Workspace structure outputs are missing or empty.");
-    if (!checks.links_valid)
-        errors.push("Some knowledge notes contain broken wikilinks.");
-    const ok = required ? errors.length === 0 : true;
-    const summary = !required
-        ? "Workspace structure not required yet — no summaries exist yet."
-        : ok
-            ? `Workspace structure verified — ${structured}/${summarized} summaries structured, ${entityFiles} entities, ${claimFiles} claims.`
-            : `Workspace structure failed — ${errors[0] ?? "incomplete structure."}`;
-    return {
-        ok,
-        required,
-        summary,
-        counts: {
-            source_total: summarizeValidation.counts.source_total,
-            summarized,
-            structured,
-            inventory_total: inventoryTotal,
-            frontmatter_scanned: frontmatterScanned,
-            abstracts_read: Math.max(asNumber(state?.abstracts_read), effectiveAbstractsRead),
-            entity_files: entityFiles,
-            claim_files: claimFiles,
-            index_files: indexFiles,
-            outputs,
-        },
-        checks,
-        errors,
-    };
-}

package/dist/lib/workspace-compile.d.ts

@@ -1,54 +0,0 @@
-import { type WorkflowExecutor } from "./executors.js";
-import { type SummarizePlan } from "./summarize-plan.js";
-import { type RuntimeStageContractDraft } from "./runtime.js";
-import { type RuntimeStageInstructions } from "./schema.js";
-import { type WorkspaceWorkflowId, type WorkflowStageDefinition } from "./workflow-definitions.js";
-import { type WorkflowReporter, type WorkflowStageResult } from "./workflow-helpers.js";
-export interface WorkspaceStageExecutionDefinition extends WorkflowStageDefinition {
-    contractType: "workspace-file-evidence" | "workspace-knowledge-structure" | "workspace-query-shape";
-}
-export interface WorkspaceSummarizeResult extends WorkflowStageResult {
-    skipped: boolean;
-    plan: SummarizePlan;
-}
-export interface WorkspaceCompileResult {
-    ok: boolean;
-    summarize: WorkspaceSummarizeResult;
-    structure: WorkflowStageResult | null;
-    shape: WorkflowStageResult | null;
-    compile: WorkflowStageResult | null;
-    failedStage: string | null;
-}
-export type StageShellRetentionMode = "on-failure" | "always";
-export declare function resolveWorkspaceContext(workspacePath: string): {
-    workspaceName: string;
-    sourcePath: string;
-    controlPath: string;
-    workflowId: WorkspaceWorkflowId;
-};
-export declare function workspaceExecutionStages(workflowId: WorkspaceWorkflowId, workspacePath: string): WorkspaceStageExecutionDefinition[];
-export declare function buildWorkspaceCompileContract(workspacePath: string, workflowId: WorkspaceWorkflowId, summaryCount: number, instructions: RuntimeStageInstructions, stageId?: string, stageSkillDir?: string, shapeInputPath?: string): RuntimeStageContractDraft;
-export declare function runWorkspaceSummarize(options: {
-    executor: WorkflowExecutor;
-    workspacePath: string;
-    sourcePath?: string;
-    reporter?: WorkflowReporter;
-    reportSummary?: boolean;
-    reportStep?: boolean;
-    stageDefinition?: WorkspaceStageExecutionDefinition;
-    fullPass?: boolean;
-}): Promise<WorkspaceSummarizeResult>;
-export declare function runWorkspaceCompile(options: {
-    executor: WorkflowExecutor;
-    workspacePath: string;
-    sourcePath?: string;
-    reporter?: WorkflowReporter;
-    reportStep?: boolean;
-    preserveStageShells?: StageShellRetentionMode;
-}): Promise<WorkflowStageResult>;
-export declare function compileWorkspace(options: {
-    executor: WorkflowExecutor;
-    workspacePath: string;
-    reporter?: WorkflowReporter;
-    preserveStageShells?: StageShellRetentionMode;
-}): Promise<WorkspaceCompileResult>;