@interf/compiler 0.2.5 → 0.3.1

package/dist/lib/workflows-interface.d.ts

@@ -1,72 +0,0 @@
-import { type WorkflowExecutor } from "./executors.js";
-import { type InterfaceWorkflowId } from "./workflow-definitions.js";
-import { type WorkflowReporter, type WorkflowStageResult } from "./workflow-helpers.js";
-import { type InterfaceStageExecutionDefinition } from "./workflows-interface-contracts.js";
-export interface InterfaceRetrieveResult extends WorkflowStageResult {
-    knowledgeBaseSummaryTotal: number;
-    relevantCount: number;
-    deltaCount: number;
-    analyzeCount: number;
-}
-export interface InterfaceAnalyzeResult extends WorkflowStageResult {
-    relevantCount: number;
-    deltaCount: number;
-    analyzeCount: number;
-}
-export interface InterfaceCompileStageResult extends WorkflowStageResult {
-    relevantCount: number;
-}
-export interface InterfaceCompileResult {
-    ok: boolean;
-    retrieve: InterfaceRetrieveResult;
-    analyze: InterfaceAnalyzeResult | null;
-    compile: InterfaceCompileStageResult | null;
-    failedStage: string | null;
-}
-export interface InterfacePlanOptions {
-    executor: WorkflowExecutor;
-    knowledgeBasePath: string;
-    name: string;
-    workflow: string;
-    useCase: string;
-    knowledgeBaseName: string;
-    targetQuestions?: string[];
-}
-export declare function resolveInterfaceContext(knowledgeBasePath: string): {
-    knowledgeBaseName: string;
-    connectedKnowledgeBasePath: string | null;
-    sourcePath: string | null;
-    workflowId: InterfaceWorkflowId;
-};
-export declare function interfaceExecutionStages(workflowId: InterfaceWorkflowId, interfacePath: string): InterfaceStageExecutionDefinition[];
-export declare function planInterface(options: InterfacePlanOptions): Promise<WorkflowStageResult>;
-export declare function runInterfaceRetrieve(options: {
-    executor: WorkflowExecutor;
-    knowledgeBasePath: string;
-    sourcePath?: string;
-    reporter?: WorkflowReporter;
-    reportStep?: boolean;
-    stageDefinition?: InterfaceStageExecutionDefinition;
-}): Promise<InterfaceRetrieveResult>;
-export declare function runInterfaceAnalyze(options: {
-    executor: WorkflowExecutor;
-    knowledgeBasePath: string;
-    sourcePath?: string;
-    reporter?: WorkflowReporter;
-    reportStep?: boolean;
-    stageDefinition?: InterfaceStageExecutionDefinition;
-}): Promise<InterfaceAnalyzeResult>;
-export declare function runInterfaceCompileStage(options: {
-    executor: WorkflowExecutor;
-    knowledgeBasePath: string;
-    sourcePath?: string;
-    reporter?: WorkflowReporter;
-    reportStep?: boolean;
-    stageDefinition?: InterfaceStageExecutionDefinition;
-}): Promise<InterfaceCompileStageResult>;
-export declare function compileInterface(options: {
-    executor: WorkflowExecutor;
-    knowledgeBasePath: string;
-    reporter?: WorkflowReporter;
-}): Promise<InterfaceCompileResult>;
-//# sourceMappingURL=workflows-interface.d.ts.map

package/dist/lib/workflows-interface.d.ts.map

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

package/dist/lib/workflows-interface.js

@@ -1,377 +0,0 @@
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-import { countFilesRecursive } from "./filesystem.js";
-import { readInterfConfig, refreshWorkspaceBootstrapGuidance, resolveInterfaceKnowledgeBasePath, resolveKnowledgeBaseSourcePath, syncClaudeBootstrap, writeInterfaceCompilePlanTemplate, } from "./interf.js";
-import { loadState, computeInterfaceHealth, refreshInterfaceArtifacts, } from "./state.js";
-import { buildStagePrompt, markRuntimeRunFailedAfterValidation, markRuntimeRunSucceededAfterValidation, runExecutorStage, validateStageContractAcceptance, } from "./runtime.js";
-import { reconcileInterfaceAnalyzeRun, reconcileInterfaceCompileRun, reconcileInterfaceRetrieveRun, } from "./runtime-reconcile.js";
-import { formatInterfaceWorkflowStageStep, getInterfaceWorkflow, resolveInterfaceWorkflowFromConfig, } from "./workflow-definitions.js";
-import { validateInterfaceRetrieve, } from "./validate.js";
-import { reportLine, reportBlankLine, buildLocalSkillContractExtension, buildLocalSkillContractExtensionRelativeTo, emptyLocalSkillContractExtension, mergeLocalSkillContractExtensions, buildStageInstructions, bundledSkillForContractType, workflowCreateDirectory, workflowCompileStageDirectory, } from "./workflow-helpers.js";
-import { buildInterfaceAnalyzeContract, buildInterfaceCompileContract, buildInterfaceCreateContract, buildInterfaceRetrieveContract, isRetrieveStageComplete, validateInterfacePlanForUseCase, } from "./workflows-interface-contracts.js";
-import { executeValidatedStage, findStageByContractType, } from "./workflow-stage-runner.js";
-export function resolveInterfaceContext(knowledgeBasePath) {
-    const config = readInterfConfig(knowledgeBasePath);
-    const workflowId = resolveInterfaceWorkflowFromConfig(config);
-    const connectedKnowledgeBasePath = resolveInterfaceKnowledgeBasePath(knowledgeBasePath);
-    return {
-        knowledgeBaseName: config?.name ?? "interface",
-        connectedKnowledgeBasePath,
-        sourcePath: connectedKnowledgeBasePath ? resolveKnowledgeBaseSourcePath(connectedKnowledgeBasePath) : null,
-        workflowId,
-    };
-}
-export function interfaceExecutionStages(workflowId, interfacePath) {
-    return getInterfaceWorkflow(workflowId, { workspacePath: interfacePath }).stages;
-}
-function buildInterfaceCreateInstructions(interfacePath, connectedKnowledgeBasePath) {
-    return buildStageInstructions("interface/create", mergeLocalSkillContractExtensions([
-        connectedKnowledgeBasePath
-            ? buildLocalSkillContractExtensionRelativeTo(connectedKnowledgeBasePath, interfacePath, [], "Use the connected knowledge-base workflow README as high-level guidance only if it materially improves the interface scaffold.")
-            : emptyLocalSkillContractExtension(),
-        buildLocalSkillContractExtension(interfacePath, [workflowCreateDirectory()], "Use the interface workflow's local create docs as scaffolding heuristics only if they materially improve the interface setup."),
-    ]));
-}
-function buildInterfaceStageInstructions(contractType, interfacePath, connectedKnowledgeBasePath, stageSkillDir, parentPurpose, localPurpose) {
-    return buildStageInstructions(bundledSkillForContractType(contractType), mergeLocalSkillContractExtensions([
-        connectedKnowledgeBasePath
-            ? buildLocalSkillContractExtensionRelativeTo(connectedKnowledgeBasePath, interfacePath, [], parentPurpose)
-            : emptyLocalSkillContractExtension(),
-        buildLocalSkillContractExtension(interfacePath, [workflowCompileStageDirectory(stageSkillDir)], localPurpose),
-    ]));
-}
-// ---------------------------------------------------------------------------
-// Interface orchestration functions
-// ---------------------------------------------------------------------------
-export async function planInterface(options) {
-    const connectedKnowledgeBasePath = resolveInterfaceKnowledgeBasePath(options.knowledgeBasePath);
-    writeInterfaceCompilePlanTemplate(options.knowledgeBasePath, {
-        workflowId: options.workflow,
-        sourcePath: connectedKnowledgeBasePath ? resolveKnowledgeBaseSourcePath(connectedKnowledgeBasePath) : undefined,
-        interfaceName: options.name,
-        useCase: options.useCase.trim(),
-        targetQuestions: options.targetQuestions,
-    });
-    const interfaceWorkflow = resolveInterfaceWorkflowFromConfig(readInterfConfig(options.knowledgeBasePath));
-    const instructions = buildInterfaceCreateInstructions(options.knowledgeBasePath, connectedKnowledgeBasePath);
-    const code = await runExecutorStage({
-        executor: options.executor,
-        knowledgeBasePath: options.knowledgeBasePath,
-        targetType: "interface",
-        knowledgeBaseName: options.name,
-        workflow: interfaceWorkflow,
-        workflowSourcePath: connectedKnowledgeBasePath ? resolveKnowledgeBaseSourcePath(connectedKnowledgeBasePath) : undefined,
-        stage: "create-interface",
-        stageLabel: "Create Interface",
-        contractType: "interface-plan",
-        summary: `Designing the initial runtime hypothesis for the ${options.name} interface.`,
-        contract: buildInterfaceCreateContract({
-            name: options.name,
-            workflow: options.workflow,
-            useCase: options.useCase,
-            knowledgeBaseName: options.knowledgeBaseName,
-            knowledgeBasePath: options.knowledgeBasePath,
-            targetQuestions: options.targetQuestions,
-            instructions,
-        }),
-        buildPrompt: (contractPath) => buildStagePrompt(instructions, contractPath, [
-            "Emit exactly one startup line, verbatim and on its own line: STATUS: loaded interface creation contract.",
-            "After the scaffold inputs and knowledge-base evidence have been reviewed, emit this canonical line verbatim and on its own line: STATUS: analyzed knowledge-base.",
-            "Do not inspect raw source files or run chart extraction in this stage. Encode future raw/chart work in compile-plan.md instead.",
-            "After compile-plan.md is updated and the scaffold still validates, emit this canonical line verbatim and on its own line: STATUS: wrote compile plan. interf.json and AGENTS.md may remain unchanged when the scaffold is already correct.",
-            "When the scaffold is ready for `interf compile`, stop. You may emit `DONE: interface create complete.` as a final progress line, but the CLI validates completion from the scaffold files instead of trusting that line.",
-            "You may emit additional STATUS lines, but the three canonical STATUS lines above are mandatory and must not be paraphrased.",
-        ]),
-        completionCheck: () => validateInterfacePlanForUseCase(options.knowledgeBasePath, options.useCase).ok,
-    });
-    syncClaudeBootstrap(options.knowledgeBasePath);
-    const validation = validateInterfacePlanForUseCase(options.knowledgeBasePath, options.useCase);
-    if (validation.ok) {
-        if (code !== 0) {
-            markRuntimeRunSucceededAfterValidation(options.knowledgeBasePath, "create-interface completed successfully.");
-        }
-        return {
-            ok: true,
-            code: 0,
-            summary: validation.summary,
-        };
-    }
-    if (!validation.ok) {
-        markRuntimeRunFailedAfterValidation(options.knowledgeBasePath, validation.summary);
-    }
-    return {
-        ok: false,
-        code,
-        summary: validation.summary,
-    };
-}
-export async function runInterfaceRetrieve(options) {
-    const context = resolveInterfaceContext(options.knowledgeBasePath);
-    const sourcePath = options.sourcePath ?? context.sourcePath ?? resolveKnowledgeBaseSourcePath(resolveInterfaceKnowledgeBasePath(options.knowledgeBasePath) ?? options.knowledgeBasePath);
-    const workflowId = context.workflowId;
-    const connectedKnowledgeBasePath = context.connectedKnowledgeBasePath;
-    const stageDefinition = options.stageDefinition ?? findStageByContractType(interfaceExecutionStages(workflowId, options.knowledgeBasePath), "interface-retrieval");
-    const stageStatusLabel = stageDefinition.label.toLowerCase();
-    const knowledgeBaseSummaryTotal = connectedKnowledgeBasePath ? countFilesRecursive(join(connectedKnowledgeBasePath, "summaries")) : 0;
-    if (options.reportStep !== false) {
-        reportLine(options.reporter, formatInterfaceWorkflowStageStep(workflowId, stageDefinition.id, { sourcePath }));
-    }
-    const instructions = buildInterfaceStageInstructions(stageDefinition.contractType, options.knowledgeBasePath, connectedKnowledgeBasePath, stageDefinition.skillDir, "Use the connected knowledge-base workflow README as high-level knowledge-base context before applying interface-local retrieve rules.", "Use interface-local docs to refine filters, expansion heuristics, ranking, and ontology hints.");
-    const stageResult = await executeValidatedStage({
-        executor: options.executor,
-        workspacePath: options.knowledgeBasePath,
-        targetType: "interface",
-        targetName: context.knowledgeBaseName,
-        workflow: workflowId,
-        workflowSourcePath: sourcePath,
-        stageDefinition,
-        instructions,
-        summary: `Preparing ${stageDefinition.label.toLowerCase()} across ${knowledgeBaseSummaryTotal} knowledge-base summaries.`,
-        contract: buildInterfaceRetrieveContract(options.knowledgeBasePath, workflowId, knowledgeBaseSummaryTotal, instructions, stageDefinition.id, stageDefinition.skillDir),
-        statusLines: [
-            `Emit exactly one startup line: STATUS: loaded ${stageStatusLabel} plan ${knowledgeBaseSummaryTotal} summary files.`,
-            `Emit STATUS: scanned X/${knowledgeBaseSummaryTotal} after each scan batch or every 250 files, whichever comes first.`,
-            "Emit STATUS: reviewed A abstracts, P expansion passes after the candidate-review phase is complete.",
-            "Emit STATUS: selected R relevant, J rejected, D delta after filters are applied and the retrieved set is finalized.",
-            "If the retrieved set is final, write `.interf/relevant.json` and `.interf/coverage.json` immediately, then emit the DONE line and stop.",
-            `Emit DONE: ${stageStatusLabel} complete when \`.interf/relevant.json\` and \`.interf/coverage.json\` are updated.`,
-        ],
-        reporter: options.reporter,
-        completionCheck: () => isRetrieveStageComplete(options.knowledgeBasePath) &&
-            validateStageContractAcceptance(options.knowledgeBasePath).ok,
-        reconcile: () => reconcileInterfaceRetrieveRun(options.knowledgeBasePath),
-        refreshArtifacts: () => refreshInterfaceArtifacts(options.knowledgeBasePath, { ensureViewSpec: true }),
-        validate: () => validateInterfaceRetrieve(options.knowledgeBasePath),
-    });
-    if (!stageResult.ok) {
-        return {
-            ok: false,
-            code: stageResult.code,
-            knowledgeBaseSummaryTotal,
-            relevantCount: 0,
-            deltaCount: 0,
-            analyzeCount: 0,
-        };
-    }
-    const queryState = loadState(options.knowledgeBasePath);
-    const relevantCount = queryState?.relevant_count ?? 0;
-    const deltaCount = queryState?.delta_count ?? relevantCount;
-    const analyzeCount = deltaCount > 0 ? deltaCount : relevantCount;
-    return {
-        ok: true,
-        code: 0,
-        knowledgeBaseSummaryTotal,
-        relevantCount,
-        deltaCount,
-        analyzeCount,
-    };
-}
-export async function runInterfaceAnalyze(options) {
-    const interfaceConfig = readInterfConfig(options.knowledgeBasePath);
-    const knowledgeBaseName = interfaceConfig?.name ?? "interface";
-    const workflowId = resolveInterfaceWorkflowFromConfig(interfaceConfig);
-    const connectedKnowledgeBasePath = resolveInterfaceKnowledgeBasePath(options.knowledgeBasePath);
-    const sourcePath = options.sourcePath ?? (connectedKnowledgeBasePath ? resolveKnowledgeBaseSourcePath(connectedKnowledgeBasePath) : options.knowledgeBasePath);
-    const stageDefinition = options.stageDefinition ?? findStageByContractType(interfaceExecutionStages(workflowId, options.knowledgeBasePath), "interface-analysis");
-    const stageStatusLabel = stageDefinition.label.toLowerCase();
-    const queryState = loadState(options.knowledgeBasePath);
-    const relevantCount = queryState?.relevant_count ?? 0;
-    const deltaCount = queryState?.delta_count ?? relevantCount;
-    const analyzeCount = deltaCount > 0 ? deltaCount : relevantCount;
-    if (options.reportStep !== false) {
-        reportBlankLine(options.reporter);
-        reportLine(options.reporter, `${formatInterfaceWorkflowStageStep(workflowId, stageDefinition.id, { sourcePath })}${analyzeCount > 0 ? ` (${analyzeCount} files)` : ""}`);
-    }
-    const instructions = buildInterfaceStageInstructions(stageDefinition.contractType, options.knowledgeBasePath, connectedKnowledgeBasePath, stageDefinition.skillDir, "Use the connected knowledge-base workflow README as high-level knowledge-base context before applying interface-local analyze rules.", "Use interface-local docs to refine the interface ontology, extraction schema, and evidence grouping.");
-    const stageResult = await executeValidatedStage({
-        executor: options.executor,
-        workspacePath: options.knowledgeBasePath,
-        targetType: "interface",
-        targetName: knowledgeBaseName,
-        workflow: workflowId,
-        workflowSourcePath: sourcePath,
-        stageDefinition,
-        instructions,
-        summary: `Preparing ${stageDefinition.label.toLowerCase()} for ${analyzeCount} interface summaries.`,
-        contract: buildInterfaceAnalyzeContract(options.knowledgeBasePath, workflowId, analyzeCount, instructions, stageDefinition.id, stageDefinition.skillDir),
-        statusLines: [
-            `Emit exactly one startup line: STATUS: loaded ${stageStatusLabel} plan ${analyzeCount} files.`,
-            "Emit STATUS: inspecting <current subtask> before each new raw page group, market batch, chart family, or extraction method.",
-            "During long-running raw/PDF/chart extraction, do not stay silent for more than about one minute. Emit another STATUS: inspecting <current subtask> line before continuing.",
-            `Emit STATUS: analyzed X/${analyzeCount} after each batch or every 25 files, whichever comes first.`,
-            `If the target ledger is narrower than the file count, still emit visible STATUS lines as each target batch is classified. Do not wait for the final analyzed X/${analyzeCount} milestone before reporting progress.`,
-            `Emit STATUS: wrote ${stageStatusLabel} outputs after \`.interf/analysis.json\` is updated.`,
-            `Emit DONE: ${stageStatusLabel} complete when \`.interf/analysis.json\` reflects the finished extraction pass.`,
-        ],
-        reporter: options.reporter,
-        completionCheck: () => {
-            const state = loadState(options.knowledgeBasePath);
-            return Boolean(state?.analyze_complete &&
-                existsSync(join(options.knowledgeBasePath, ".interf", "analysis.json")) &&
-                validateStageContractAcceptance(options.knowledgeBasePath).ok);
-        },
-        reconcile: () => reconcileInterfaceAnalyzeRun(options.knowledgeBasePath),
-        refreshArtifacts: () => refreshInterfaceArtifacts(options.knowledgeBasePath, { ensureViewSpec: true }),
-        validate: () => ({
-            ok: true,
-            summary: "Interface analyze verified.",
-        }),
-    });
-    return {
-        ok: stageResult.ok,
-        code: stageResult.code,
-        relevantCount,
-        deltaCount,
-        analyzeCount,
-    };
-}
-export async function runInterfaceCompileStage(options) {
-    const interfaceConfig = readInterfConfig(options.knowledgeBasePath);
-    const knowledgeBaseName = interfaceConfig?.name ?? "interface";
-    const workflowId = resolveInterfaceWorkflowFromConfig(interfaceConfig);
-    const connectedKnowledgeBasePath = resolveInterfaceKnowledgeBasePath(options.knowledgeBasePath);
-    const sourcePath = options.sourcePath ?? (connectedKnowledgeBasePath ? resolveKnowledgeBaseSourcePath(connectedKnowledgeBasePath) : options.knowledgeBasePath);
-    const stageDefinition = options.stageDefinition ?? findStageByContractType(interfaceExecutionStages(workflowId, options.knowledgeBasePath), "interface-output");
-    const stageStatusLabel = stageDefinition.label.toLowerCase();
-    const relevantCount = loadState(options.knowledgeBasePath)?.relevant_count ?? 0;
-    if (options.reportStep !== false) {
-        reportBlankLine(options.reporter);
-        reportLine(options.reporter, formatInterfaceWorkflowStageStep(workflowId, stageDefinition.id, { sourcePath }));
-    }
-    const instructions = buildInterfaceStageInstructions(stageDefinition.contractType, options.knowledgeBasePath, connectedKnowledgeBasePath, stageDefinition.skillDir, "Use the connected knowledge-base workflow README as high-level knowledge-base context before applying interface-local compile rules.", "Use interface-local docs to refine the output inventory, navigation, canvases, and final interface shape.");
-    const stageResult = await executeValidatedStage({
-        executor: options.executor,
-        workspacePath: options.knowledgeBasePath,
-        targetType: "interface",
-        targetName: knowledgeBaseName,
-        workflow: workflowId,
-        workflowSourcePath: sourcePath,
-        stageDefinition,
-        instructions,
-        summary: `Preparing ${stageDefinition.label.toLowerCase()} from ${relevantCount} relevant files.`,
-        contract: buildInterfaceCompileContract(options.knowledgeBasePath, workflowId, relevantCount, instructions, stageDefinition.id, stageDefinition.skillDir),
-        statusLines: [
-            `Emit exactly one startup line: STATUS: loaded ${stageStatusLabel} plan ${relevantCount} relevant files.`,
-            "Emit STATUS: wrote entities X after the entity pass completes.",
-            "Emit STATUS: wrote claims Y after the claim pass completes.",
-            `Emit STATUS: wrote ${stageStatusLabel} outputs after local notes and home.md are updated.`,
-            `Emit DONE: ${stageStatusLabel} complete when the required outputs are on disk and temporary analysis artifacts are cleaned up.`,
-        ],
-        reporter: options.reporter,
-        completionCheck: () => {
-            const state = loadState(options.knowledgeBasePath);
-            const health = computeInterfaceHealth(options.knowledgeBasePath);
-            return Boolean(state?.compile_complete &&
-                typeof state.last_compile === "string" &&
-                health.checks.home_present &&
-                health.checks.outputs_present &&
-                !health.checks.analysis_pending &&
-                validateStageContractAcceptance(options.knowledgeBasePath).ok);
-        },
-        reconcile: () => reconcileInterfaceCompileRun(options.knowledgeBasePath),
-        refreshArtifacts: () => refreshInterfaceArtifacts(options.knowledgeBasePath, { ensureViewSpec: true }),
-        validate: () => {
-            const state = loadState(options.knowledgeBasePath);
-            const health = computeInterfaceHealth(options.knowledgeBasePath);
-            const ok = Boolean(state?.compile_complete &&
-                typeof state.last_compile === "string" &&
-                health.checks.home_present &&
-                health.checks.outputs_present &&
-                !health.checks.analysis_pending);
-            return {
-                ok,
-                summary: ok
-                    ? "Interface compile verified."
-                    : `Interface compile failed — health is ${health.status}/${health.stage}.`,
-            };
-        },
-    });
-    return {
-        ok: stageResult.ok,
-        code: stageResult.code,
-        relevantCount,
-    };
-}
-export async function compileInterface(options) {
-    refreshWorkspaceBootstrapGuidance(options.knowledgeBasePath);
-    const context = resolveInterfaceContext(options.knowledgeBasePath);
-    const sourcePath = context.sourcePath ?? (context.connectedKnowledgeBasePath ? resolveKnowledgeBaseSourcePath(context.connectedKnowledgeBasePath) : options.knowledgeBasePath);
-    const stages = interfaceExecutionStages(context.workflowId, options.knowledgeBasePath);
-    let retrieve = {
-        ok: true,
-        code: 0,
-        knowledgeBaseSummaryTotal: 0,
-        relevantCount: 0,
-        deltaCount: 0,
-        analyzeCount: 0,
-    };
-    let analyze = null;
-    let compile = null;
-    for (const stageDefinition of stages) {
-        if (stageDefinition.contractType === "interface-retrieval") {
-            retrieve = await runInterfaceRetrieve({
-                executor: options.executor,
-                knowledgeBasePath: options.knowledgeBasePath,
-                sourcePath,
-                reporter: options.reporter,
-                reportStep: true,
-                stageDefinition,
-            });
-            if (!retrieve.ok) {
-                return {
-                    ok: false,
-                    retrieve,
-                    analyze: null,
-                    compile: null,
-                    failedStage: stageDefinition.id,
-                };
-            }
-            continue;
-        }
-        if (stageDefinition.contractType === "interface-analysis") {
-            analyze = await runInterfaceAnalyze({
-                executor: options.executor,
-                knowledgeBasePath: options.knowledgeBasePath,
-                sourcePath,
-                reporter: options.reporter,
-                reportStep: true,
-                stageDefinition,
-            });
-            if (!analyze.ok) {
-                return {
-                    ok: false,
-                    retrieve,
-                    analyze,
-                    compile: null,
-                    failedStage: stageDefinition.id,
-                };
-            }
-            continue;
-        }
-        compile = await runInterfaceCompileStage({
-            executor: options.executor,
-            knowledgeBasePath: options.knowledgeBasePath,
-            sourcePath,
-            reporter: options.reporter,
-            reportStep: true,
-            stageDefinition,
-        });
-        if (!compile.ok) {
-            return {
-                ok: false,
-                retrieve,
-                analyze,
-                compile,
-                failedStage: stageDefinition.id,
-            };
-        }
-    }
-    return {
-        ok: compile?.ok ?? analyze?.ok ?? retrieve.ok,
-        retrieve,
-        analyze,
-        compile,
-        failedStage: null,
-    };
-}
-//# sourceMappingURL=workflows-interface.js.map

package/dist/lib/workflows-interface.js.map

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

package/dist/lib/workflows-kb.d.ts

@@ -1,50 +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 KnowledgeBaseWorkflowId, type WorkflowStageDefinition } from "./workflow-definitions.js";
-import { type WorkflowReporter, type WorkflowStageResult } from "./workflow-helpers.js";
-export interface KnowledgeBaseStageExecutionDefinition extends WorkflowStageDefinition {
-    contractType: "kb-file-evidence" | "kb-knowledge-layer";
-}
-export interface KnowledgeBaseSummarizeResult extends WorkflowStageResult {
-    skipped: boolean;
-    plan: SummarizePlan;
-}
-export interface KnowledgeBaseCompileResult {
-    ok: boolean;
-    summarize: KnowledgeBaseSummarizeResult;
-    compile: WorkflowStageResult | null;
-    failedStage: string | null;
-}
-export declare function resolveKnowledgeBaseContext(knowledgeBasePath: string): {
-    knowledgeBaseName: string;
-    sourcePath: string;
-    workflowId: KnowledgeBaseWorkflowId;
-};
-export declare function knowledgeBaseExecutionStages(workflowId: KnowledgeBaseWorkflowId, knowledgeBasePath: string): KnowledgeBaseStageExecutionDefinition[];
-export declare function buildKnowledgeBaseCompileContract(knowledgeBasePath: string, workflowId: KnowledgeBaseWorkflowId, summaryCount: number, instructions: RuntimeStageInstructions, stageId?: string, stageSkillDir?: string): RuntimeStageContractDraft;
-export declare function runKnowledgeBaseSummarize(options: {
-    executor: WorkflowExecutor;
-    knowledgeBasePath: string;
-    sourcePath?: string;
-    reporter?: WorkflowReporter;
-    reportSummary?: boolean;
-    reportStep?: boolean;
-    stageDefinition?: KnowledgeBaseStageExecutionDefinition;
-    fullPass?: boolean;
-}): Promise<KnowledgeBaseSummarizeResult>;
-export declare function runKnowledgeBaseCompile(options: {
-    executor: WorkflowExecutor;
-    knowledgeBasePath: string;
-    sourcePath?: string;
-    reporter?: WorkflowReporter;
-    reportStep?: boolean;
-    stageDefinition?: KnowledgeBaseStageExecutionDefinition;
-}): Promise<WorkflowStageResult>;
-export declare function compileKnowledgeBase(options: {
-    executor: WorkflowExecutor;
-    knowledgeBasePath: string;
-    reporter?: WorkflowReporter;
-}): Promise<KnowledgeBaseCompileResult>;
-//# sourceMappingURL=workflows-kb.d.ts.map

package/dist/lib/workflows-kb.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflows-kb.d.ts","sourceRoot":"","sources":["../../src/lib/workflows-kb.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAMvD,OAAO,EAA0C,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUjG,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,KAAK,wBAAwB,EAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,EAKL,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC7B,MAAM,2BAA2B,CAAC;AAKnC,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EASzB,MAAM,uBAAuB,CAAC;AAW/B,MAAM,WAAW,qCAAsC,SAAQ,uBAAuB;IACpF,YAAY,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;CACzD;AAED,MAAM,WAAW,4BAA6B,SAAQ,mBAAmB;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,4BAA4B,CAAC;IACxC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAMD,wBAAgB,2BAA2B,CAAC,iBAAiB,EAAE,MAAM,GAAG;IACtE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,uBAAuB,CAAC;CACrC,CAQA;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,uBAAuB,EACnC,iBAAiB,EAAE,MAAM,GACxB,qCAAqC,EAAE,CAEzC;AAwCD,wBAAgB,iCAAiC,CAC/C,iBAAiB,EAAE,MAAM,EACzB,UAAU,EAAE,uBAAuB,EACnC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,wBAAwB,EACtC,OAAO,SAAY,EACnB,aAAa,SAAY,GACxB,yBAAyB,CAgE3B;AAMD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE;IACP,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,qCAAqC,CAAC;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GACA,OAAO,CAAC,4BAA4B,CAAC,CAyGvC;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE;IACP,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,qCAAqC,CAAC;CACzD,GACA,OAAO,CAAC,mBAAmB,CAAC,CA4D9B;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE;IACP,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,GACA,OAAO,CAAC,0BAA0B,CAAC,CA6DrC"}