@interf/compiler 0.1.12 → 0.2.1

package/dist/lib/workflow-stage-runner.js

@@ -0,0 +1,106 @@
+import { markRuntimeRunSucceededAfterValidation, buildStagePrompt, markRuntimeRunFailedAfterValidation, runExecutorStage, runExecutorSummarizeStage, } from "./runtime.js";
+import { reportValidationFailure, validateStageOutcome, } from "./workflow-helpers.js";
+export function findStageByContractType(stages, contractType) {
+    const stage = stages.find((candidate) => candidate.contractType === contractType);
+    if (!stage) {
+        throw new Error(`Missing workflow stage for contract type: ${contractType}`);
+    }
+    return stage;
+}
+export async function executeValidatedStage(options) {
+    const completionCheck = options.completionCheck
+        ? () => {
+            options.reconcile?.();
+            return options.completionCheck?.() === true;
+        }
+        : undefined;
+    const code = await runExecutorStage({
+        executor: options.executor,
+        knowledgeBasePath: options.workspacePath,
+        targetType: options.targetType,
+        knowledgeBaseName: options.targetName,
+        workflow: options.workflow,
+        workflowSourcePath: options.workflowSourcePath,
+        stage: options.stageDefinition.id,
+        stageLabel: options.stageDefinition.label,
+        contractType: options.stageDefinition.contractType,
+        summary: options.summary,
+        contract: options.contract,
+        buildPrompt: (contractPath) => buildStagePrompt(options.instructions, contractPath, options.statusLines),
+        completionCheck,
+    });
+    return finalizeValidatedStage(options, code);
+}
+export async function executeValidatedSummarizeStage(options) {
+    const completionCheck = options.completionCheck
+        ? () => {
+            options.reconcile?.();
+            return options.completionCheck?.() === true;
+        }
+        : undefined;
+    const code = await runExecutorSummarizeStage({
+        executor: options.executor,
+        knowledgeBasePath: options.workspacePath,
+        targetType: options.targetType,
+        knowledgeBaseName: options.targetName,
+        workflow: options.workflow,
+        workflowSourcePath: options.workflowSourcePath,
+        stage: options.stageDefinition.id,
+        stageLabel: options.stageDefinition.label,
+        contractType: options.stageDefinition.contractType,
+        summary: options.summary,
+        contract: options.contract,
+        buildPrompt: (contractPath) => buildStagePrompt(options.instructions, contractPath, options.statusLines),
+        completionCheck,
+        startingSummaryCount: options.startingSummaryCount,
+        targetCount: options.targetCount,
+    });
+    return finalizeValidatedStage(options, code);
+}
+function finalizeValidatedStage(options, code) {
+    const refreshAndValidate = () => {
+        options.reconcile?.();
+        options.refreshArtifacts?.();
+        return validateStageOutcome(options.workspacePath, options.validate());
+    };
+    if (code !== 0) {
+        let completionSatisfied = false;
+        try {
+            options.reconcile?.();
+            completionSatisfied = options.completionCheck?.() === true;
+        }
+        catch {
+            completionSatisfied = false;
+        }
+        if (completionSatisfied) {
+            const validation = refreshAndValidate();
+            if (validation.ok) {
+                markRuntimeRunSucceededAfterValidation(options.workspacePath, validation.summary);
+                return {
+                    ok: true,
+                    code: 0,
+                    summary: validation.summary,
+                };
+            }
+            reportValidationFailure(options.reporter, validation.summary);
+            markRuntimeRunFailedAfterValidation(options.workspacePath, validation.summary);
+            return {
+                ok: false,
+                code,
+                summary: validation.summary,
+            };
+        }
+        return { ok: false, code };
+    }
+    const validation = refreshAndValidate();
+    if (!validation.ok) {
+        reportValidationFailure(options.reporter, validation.summary);
+        markRuntimeRunFailedAfterValidation(options.workspacePath, validation.summary);
+    }
+    return {
+        ok: validation.ok,
+        code: validation.ok ? 0 : 1,
+        summary: validation.summary,
+    };
+}
+//# sourceMappingURL=workflow-stage-runner.js.map

package/dist/lib/workflow-stage-runner.js.map

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

package/dist/lib/workflow-starter-docs.d.ts

@@ -0,0 +1,9 @@
+interface StarterDoc {
+    relativePath: string;
+    content: string;
+}
+export declare const KNOWLEDGE_BASE_INTERF_STARTER_DOCS: StarterDoc[];
+export declare const KNOWLEDGE_BASE_KARPATHY_STARTER_DOCS: StarterDoc[];
+export declare const INTERFACE_INTERF_STARTER_DOCS: StarterDoc[];
+export {};
+//# sourceMappingURL=workflow-starter-docs.d.ts.map

package/dist/lib/workflow-starter-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-starter-docs.d.ts","sourceRoot":"","sources":["../../src/lib/workflow-starter-docs.ts"],"names":[],"mappings":"AAEA,UAAU,UAAU;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AASD,eAAO,MAAM,kCAAkC,EAAE,UAAU,EAE1D,CAAC;AAEF,eAAO,MAAM,oCAAoC,EAAE,UAAU,EAE5D,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,UAAU,EAGrD,CAAC"}

package/dist/lib/workflow-starter-docs.js

@@ -0,0 +1,18 @@
+import { renderBundledTemplate } from "./bundled-templates.js";
+function doc(relativePath, templatePath) {
+    return {
+        relativePath,
+        content: renderBundledTemplate(templatePath),
+    };
+}
+export const KNOWLEDGE_BASE_INTERF_STARTER_DOCS = [
+    doc("README.md", "workflow-starters/knowledge-base/interf/README.md"),
+];
+export const KNOWLEDGE_BASE_KARPATHY_STARTER_DOCS = [
+    doc("README.md", "workflow-starters/knowledge-base/karpathy/README.md"),
+];
+export const INTERFACE_INTERF_STARTER_DOCS = [
+    doc("README.md", "workflow-starters/interface/interf/README.md"),
+    doc("create/SKILL.md", "workflow-starters/interface/interf/create/SKILL.md"),
+];
+//# sourceMappingURL=workflow-starter-docs.js.map

package/dist/lib/workflow-starter-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-starter-docs.js","sourceRoot":"","sources":["../../src/lib/workflow-starter-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAO/D,SAAS,GAAG,CAAC,YAAoB,EAAE,YAAoB;IACrD,OAAO;QACL,YAAY;QACZ,OAAO,EAAE,qBAAqB,CAAC,YAAY,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,kCAAkC,GAAiB;IAC9D,GAAG,CAAC,WAAW,EAAE,mDAAmD,CAAC;CACtE,CAAC;AAEF,MAAM,CAAC,MAAM,oCAAoC,GAAiB;IAChE,GAAG,CAAC,WAAW,EAAE,qDAAqD,CAAC;CACxE,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAiB;IACzD,GAAG,CAAC,WAAW,EAAE,8CAA8C,CAAC;IAChE,GAAG,CAAC,iBAAiB,EAAE,oDAAoD,CAAC;CAC7E,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { RuntimeStageContractDraft } from "./runtime.js";
+import type { RuntimeStageInstructions } from "./schema.js";
+import { type InterfaceWorkflowId, type WorkflowStageDefinition } from "./workflow-definitions.js";
+export interface InterfaceStageExecutionDefinition extends WorkflowStageDefinition {
+    contractType: "interface-retrieval" | "interface-analysis" | "interface-output";
+}
+export declare function isRetrieveStageComplete(dirPath: string): boolean;
+export declare function validateInterfacePlanForUseCase(interfacePath: string, useCase: string): {
+    ok: boolean;
+    summary: string;
+};
+export declare function buildInterfaceCreateContract(options: {
+    name: string;
+    workflow: string;
+    useCase: string;
+    knowledgeBaseName: string;
+    knowledgeBasePath: string;
+    targetQuestions?: string[];
+    instructions: RuntimeStageInstructions;
+}): RuntimeStageContractDraft;
+export declare function buildInterfaceRetrieveContract(interfacePath: string, workflowId: InterfaceWorkflowId, summaryCount: number, instructions: RuntimeStageInstructions, stageId?: string, stageSkillDir?: string): RuntimeStageContractDraft;
+export declare function buildInterfaceAnalyzeContract(interfacePath: string, workflowId: InterfaceWorkflowId, analyzeCount: number, instructions: RuntimeStageInstructions, stageId?: string, stageSkillDir?: string): RuntimeStageContractDraft;
+export declare function buildInterfaceCompileContract(interfacePath: string, workflowId: InterfaceWorkflowId, relevantCount: number, instructions: RuntimeStageInstructions, stageId?: string, stageSkillDir?: string): RuntimeStageContractDraft;
+//# sourceMappingURL=workflows-interface-contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflows-interface-contracts.d.ts","sourceRoot":"","sources":["../../src/lib/workflows-interface-contracts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC7B,MAAM,2BAA2B,CAAC;AAiBnC,MAAM,WAAW,iCAAkC,SAAQ,uBAAuB;IAChF,YAAY,EAAE,qBAAqB,GAAG,oBAAoB,GAAG,kBAAkB,CAAC;CACjF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GACd;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAUlC;AAmJD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE;IACP,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,wBAAwB,CAAC;CACxC,GACA,yBAAyB,CAiF3B;AAED,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,mBAAmB,EAC/B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,wBAAwB,EACtC,OAAO,SAAa,EACpB,aAAa,SAAa,GACzB,yBAAyB,CAmD3B;AAED,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,mBAAmB,EAC/B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,wBAAwB,EACtC,OAAO,SAAY,EACnB,aAAa,SAAY,GACxB,yBAAyB,CAgD3B;AAED,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,mBAAmB,EAC/B,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,wBAAwB,EACtC,OAAO,SAAY,EACnB,aAAa,SAAY,GACxB,yBAAyB,CAmD3B"}

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

@@ -0,0 +1,304 @@
+import { join } from "node:path";
+import { resolveInterfaceKnowledgeBasePath, resolveKnowledgeBaseSourcePath } from "./interf.js";
+import { getInterfaceWorkflow, getWorkflowStagePolicyNotes, } from "./workflow-definitions.js";
+import { extractInterfacePlannedOutputFiles, validateInterfaceRetrieve, validateInterfacePlan, safeReadText, } from "./validate.js";
+import { buildLocalSkillContractExtension, buildLocalSkillContractExtensionRelativeTo, emptyLocalSkillContractExtension, mergeLocalSkillContractExtensions, resolveStageAcceptance, workflowCompileStageDirectory, workflowCreateDirectory, } from "./workflow-helpers.js";
+export function isRetrieveStageComplete(dirPath) {
+    const validation = validateInterfaceRetrieve(dirPath);
+    return validation.required && validation.ok;
+}
+export function validateInterfacePlanForUseCase(interfacePath, useCase) {
+    const validation = validateInterfacePlan(interfacePath);
+    if (!validation.ok)
+        return validation;
+    if (!interfacePlanPreservesUseCase(interfacePath, useCase)) {
+        return {
+            ok: false,
+            summary: "Interface plan still uses generic workflow wording instead of the requested use case.",
+        };
+    }
+    return validation;
+}
+function interfacePlanPreservesUseCase(interfacePath, useCase) {
+    const requestedUseCase = useCase.trim();
+    if (requestedUseCase.length === 0)
+        return true;
+    const compilePlanText = safeReadText(join(interfacePath, "compile-plan.md"));
+    if (!compilePlanText)
+        return false;
+    return compilePlanText.includes(`- use case: ${requestedUseCase}`);
+}
+function buildInterfaceStageLocalSkills(interfacePath, stageSkillDir, connectedKnowledgeBasePath, parentPurpose, localPurpose) {
+    return mergeLocalSkillContractExtensions([
+        connectedKnowledgeBasePath
+            ? buildLocalSkillContractExtensionRelativeTo(connectedKnowledgeBasePath, interfacePath, [], parentPurpose)
+            : emptyLocalSkillContractExtension(),
+        buildLocalSkillContractExtension(interfacePath, [workflowCompileStageDirectory(stageSkillDir)], localPurpose),
+    ]);
+}
+function buildInterfaceCreateLocalSkills(interfacePath, connectedKnowledgeBasePath) {
+    return mergeLocalSkillContractExtensions([
+        connectedKnowledgeBasePath
+            ? buildLocalSkillContractExtensionRelativeTo(connectedKnowledgeBasePath, interfacePath, [], "Use the connected knowledge-base workflow README as high-level knowledge-base context 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 interfaceRawFallbackPolicyNote() {
+    return "If you need raw-file fallback, inspect `../../.interf/source-access.json` first and verify one suggested path is readable. These are canonical absolute source-file paths shared by the parent knowledge base. If they are not reachable, continue from knowledge-base summaries and report that raw fallback was unavailable.";
+}
+function resolveInterfaceStageContractContext(interfacePath, workflowId, stageId, stageSkillDir, parentPurpose, localPurpose) {
+    const connectedKnowledgeBasePath = resolveInterfaceKnowledgeBasePath(interfacePath);
+    const sourcePath = connectedKnowledgeBasePath
+        ? resolveKnowledgeBaseSourcePath(connectedKnowledgeBasePath)
+        : undefined;
+    const acceptance = resolveStageAcceptance("interface", workflowId, stageId, sourcePath, interfacePath);
+    const localSkills = buildInterfaceStageLocalSkills(interfacePath, stageSkillDir, connectedKnowledgeBasePath, parentPurpose, localPurpose);
+    return {
+        connectedKnowledgeBasePath,
+        sourcePath,
+        acceptance,
+        localSkills,
+    };
+}
+function buildInterfaceRuntimeStageContract({ instructions, counts, acceptance, reads, writes, verifies = [], notes, targetContextFraction, strategy, }) {
+    return {
+        instructions,
+        counts,
+        ...(acceptance ? { acceptance } : {}),
+        artifacts: {
+            reads,
+            writes,
+            verifies,
+        },
+        policies: {
+            execution_mode: "deterministic",
+            status_prefixes: ["STATUS:", "DONE:", "BLOCKED:", "ERROR:"],
+            notes,
+            evidence_weighting: {
+                required_fields: ["source_kind", "evidence_tier", "truth_mode", "state"],
+                preserve_tiers: true,
+            },
+            working_set: {
+                target_context_fraction: targetContextFraction,
+                strategy,
+            },
+        },
+    };
+}
+function mergeAcceptanceArtifacts(acceptance, artifactsExist) {
+    if (artifactsExist.length === 0)
+        return acceptance;
+    return {
+        ...(acceptance ?? {}),
+        artifacts_exist: Array.from(new Set([...(acceptance?.artifacts_exist ?? []), ...artifactsExist])),
+    };
+}
+export function buildInterfaceCreateContract(options) {
+    const connectedKnowledgeBasePath = resolveInterfaceKnowledgeBasePath(options.knowledgeBasePath);
+    const workflowSourcePath = connectedKnowledgeBasePath
+        ? resolveKnowledgeBaseSourcePath(connectedKnowledgeBasePath)
+        : undefined;
+    const workflow = getInterfaceWorkflow(options.workflow, {
+        sourcePath: workflowSourcePath,
+        workspacePath: options.knowledgeBasePath,
+    });
+    const localSkills = buildInterfaceCreateLocalSkills(options.knowledgeBasePath, connectedKnowledgeBasePath);
+    return {
+        instructions: options.instructions,
+        counts: {
+            workflow_selected: 1,
+            local_skill_docs: localSkills.count,
+        },
+        artifacts: {
+            reads: [
+                "interf.json",
+                "compile-plan.md",
+                "AGENTS.md",
+                "home.md",
+                "../../interf.json",
+                "../../home.md",
+                "../../knowledge/",
+                "../../summaries/",
+                ...localSkills.reads,
+            ],
+            writes: [
+                "interf.json",
+                "compile-plan.md",
+                "AGENTS.md",
+            ],
+            verifies: [
+                "interf verify interface-plan --json",
+            ],
+        },
+        policies: {
+            execution_mode: "deterministic",
+            status_prefixes: ["STATUS:", "DONE:", "BLOCKED:", "ERROR:"],
+            notes: [
+                `Interface name: ${options.name}.`,
+                `Selected workflow: ${workflow.id} (${workflow.label}).`,
+                `Workflow stages: ${workflow.stages.map((stage) => `${stage.label} [${stage.id}]`).join(" -> ")}.`,
+                `Use case: ${options.useCase}.`,
+                `Connected knowledge-base: ${options.knowledgeBaseName} at ${connectedKnowledgeBasePath ?? "unknown"}.`,
+                "The scaffold already exists with home.md, AGENTS.md, CLAUDE.md, interf.json, and the .interf runtime artifacts.",
+                "This is a planning stage only. Do not inspect raw source files, open raw PDF pages, or run chart/table extraction during interface/create.",
+                "Read the current local compile-plan.md, interf.json, and home.md first. Use AGENTS.md only as scaffold router text, not as a checklist to execute literally.",
+                "When AGENTS.md mentions manual query loops, raw-source gates, or permission preflights, preserve those sections as scaffold text but do not execute them during this create stage.",
+                "Then consult ../../AGENTS.md and ../../home.md for parent knowledge-base navigation and evidence structure.",
+                "This interface lives inside the parent knowledge base workspace. Do not assume it will be opened as a standalone Obsidian workspace.",
+                "Do not recreate the workspace or ask follow-up questions.",
+                "Use the selected workflow as the starting point, then adapt it to the knowledge-base data and the use case.",
+                "The scaffolded compile-plan.md was already refreshed with the requested use case before this stage started. Refine that plan instead of regenerating it from a generic placeholder.",
+                "Plan from the parent knowledge-base surface only: ../../home.md, ../../knowledge/, and ../../summaries/. If later stages will need raw/chart work, encode that in compile-plan.md instead of doing it now.",
+                "Edit the existing compile-plan.md scaffold in place. Preserve the stage headings and required subsection labels from the starter plan; refine the bullets and narrative instead of replacing the structure.",
+                "Preserve the exact requested use-case text in the `## Interface Goal` section of compile-plan.md. Do not leave the generic workflow placeholder there.",
+                "If the use case names markets, years, metrics, or chart families, carry those exact nouns into the target ledger instead of collapsing them into generic audit wording.",
+                ...(options.targetQuestions && options.targetQuestions.length > 0
+                    ? [
+                        "Hard target questions to satisfy during compile:",
+                        ...options.targetQuestions.map((question) => `- ${question}`),
+                        "Carry the exact years, periods, metrics, comparators, and chart families from those hard target questions into the target ledger. Do not collapse them into generic audit wording.",
+                    ]
+                    : []),
+                "After reading the scaffold, rewrite compile-plan.md as a full document instead of relying on tiny anchored patches from memory.",
+                "Do not use patch-style or line-matched edits against scaffold placeholders in compile-plan.md. Read the scaffold, then replace the full document content in one write.",
+                "compile-plan.md is the primary durable planning artifact for this stage. Rewrite it first, then stop unless interf.json or AGENTS.md still needs a real correction.",
+                "Preserve the existing AGENTS.md scaffold sections, especially the manual access checklist, raw-source gate, and navigation/router guidance, but leave AGENTS.md unchanged when the scaffold already fits this interface.",
+                "If AGENTS.md does need a correction, keep it surgical and preserve the router/checklist structure. Do not replace AGENTS.md with a shorter template.",
+                "After the scaffold review, the next actions are the durable writes: compile-plan.md, then interf.json only if needed, then AGENTS.md only if needed. Do not keep researching once the requested plan is written.",
+                "Analyze the knowledge-base and update only the interface definition files in this workspace: interf.json, compile-plan.md, and AGENTS.md. CLAUDE.md is a generated mirror of AGENTS.md and will be rewritten by the harness after the stage completes.",
+                ...localSkills.notes,
+            ],
+        },
+    };
+}
+export function buildInterfaceRetrieveContract(interfacePath, workflowId, summaryCount, instructions, stageId = "retrieve", stageSkillDir = "retrieve") {
+    const { sourcePath, acceptance, localSkills } = resolveInterfaceStageContractContext(interfacePath, workflowId, stageId, stageSkillDir, "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.");
+    return buildInterfaceRuntimeStageContract({
+        instructions,
+        counts: {
+            knowledge_base_summary_total: summaryCount,
+            local_skill_docs: localSkills.count,
+        },
+        acceptance,
+        reads: [
+            "home.md",
+            "../../home.md",
+            "interf.json",
+            "compile-plan.md",
+            "../../.interf/source-access.json",
+            "../../summaries/",
+            ...localSkills.reads,
+        ],
+        writes: [
+            ".interf/relevant.json",
+            ".interf/coverage.json",
+        ],
+        verifies: [
+            "interf verify retrieve --json",
+        ],
+        notes: [
+            "Access hierarchy for this stage is: local interface artifacts -> parent knowledge-base artifacts -> raw source files only when needed.",
+            "Treat the interface runtime in compile-plan.md as an initial hypothesis, not a final truth.",
+            "Scan ALL knowledge-base summaries frontmatter before making any selection.",
+            "Review abstracts for the candidate set, expand through linked summaries when needed, and stop only when the retrieved set is coverage-complete for this interface.",
+            "Selection quality is judged by the proof of reviewed, retrieved, and excluded files, not by superficial brevity.",
+            interfaceRawFallbackPolicyNote(),
+            "When writing `.interf/relevant.json` or `.interf/coverage.json`, write each file as a complete replacement document after reading the current version. Do not try anchored line patches against missing or stale runtime files.",
+            "If a required runtime JSON file does not exist yet, create it in one full-file write instead of attempting to patch a placeholder.",
+            "Write `.interf/relevant.json` in the current runtime shape with top-level `generated_at`, `knowledge_base_summary_count`, `relevant_files`, and `delta_files`.",
+            "Write `.interf/coverage.json` in the current verifier shape with top-level `generated_at`, `knowledge_base_summary_total`, `frontmatter_scanned`, `candidates_after_frontmatter`, `abstracts_reviewed`, `relevant_selected`, `rejected`, `expansion_passes`, and `coverage_complete` plus `proof.scanned`, `proof.reviewed`, `proof.retrieved`, and `proof.excluded`.",
+            "The CLI reconciles `.interf/state.json` and refreshes `.interf/health.json` after stage validation. Do not treat those files as stage-owned write targets for retrieve.",
+            ...getWorkflowStagePolicyNotes("interface", workflowId, stageId, sourcePath, interfacePath),
+            ...localSkills.notes,
+        ],
+        targetContextFraction: 0.15,
+        strategy: "Frontmatter scan first, then abstract review, then linked expansion only where coverage proof requires it.",
+    });
+}
+export function buildInterfaceAnalyzeContract(interfacePath, workflowId, analyzeCount, instructions, stageId = "analyze", stageSkillDir = "analyze") {
+    const { sourcePath, acceptance, localSkills } = resolveInterfaceStageContractContext(interfacePath, workflowId, stageId, stageSkillDir, "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.");
+    return buildInterfaceRuntimeStageContract({
+        instructions,
+        counts: {
+            relevant_total: analyzeCount,
+            local_skill_docs: localSkills.count,
+        },
+        acceptance,
+        reads: [
+            "home.md",
+            "../../home.md",
+            "interf.json",
+            "compile-plan.md",
+            ".interf/relevant.json",
+            "../../.interf/source-access.json",
+            "../../summaries/",
+            ...localSkills.reads,
+        ],
+        writes: [
+            ".interf/analysis.json",
+        ],
+        notes: [
+            "Access hierarchy for this stage is: local interface artifacts -> parent knowledge-base artifacts -> raw source files only when needed.",
+            "This is the deep extraction pass over the relevant set selected by retrieve.",
+            "Refine the interface runtime from evidence when the knowledge base clearly demands it.",
+            "Keep extraction local to the interface ontology and output goals.",
+            "When raw/PDF/chart extraction is in progress, emit a visible STATUS line before each new page group, market batch, chart family, or extraction method. Do not stay silent for more than about one minute while analyze is still running.",
+            "Once the relevant pages are mapped, do not keep reopening the full raw PDF. Switch to a narrower page-bounded extraction step or a local scratch helper for that page group instead.",
+            "Keep shell helpers short and page-bounded. Avoid long inline Bash heredocs; if a helper needs multiple steps, write a small scratch script file first or run separate single-purpose commands.",
+            interfaceRawFallbackPolicyNote(),
+            "Before choosing a machine-readable extraction path, verify that the local method is actually available in this environment. If the first path is unavailable or blocked, record that and switch to another available local path instead of retrying the same missing dependency.",
+            "When updating `.interf/analysis.json`, rewrite the full JSON document after reading the current file. Do not depend on anchored patches against prior values.",
+            "The CLI reconciles `.interf/state.json` and refreshes `.interf/health.json` after stage validation. Do not treat those files as stage-owned write targets for analyze.",
+            ...getWorkflowStagePolicyNotes("interface", workflowId, stageId, sourcePath, interfacePath),
+            ...localSkills.notes,
+        ],
+        targetContextFraction: 0.3,
+        strategy: "Batch relevant summaries into bounded sets, derive local entities/claims, then merge before writing analysis artifacts.",
+    });
+}
+export function buildInterfaceCompileContract(interfacePath, workflowId, relevantCount, instructions, stageId = "compile", stageSkillDir = "compile") {
+    const { sourcePath, acceptance, localSkills } = resolveInterfaceStageContractContext(interfacePath, workflowId, stageId, stageSkillDir, "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 plannedOutputArtifacts = extractInterfacePlannedOutputFiles(interfacePath);
+    return buildInterfaceRuntimeStageContract({
+        instructions,
+        counts: {
+            relevant_total: relevantCount,
+            local_skill_docs: localSkills.count,
+        },
+        acceptance: mergeAcceptanceArtifacts(acceptance, plannedOutputArtifacts),
+        reads: [
+            "home.md",
+            "../../home.md",
+            "interf.json",
+            "compile-plan.md",
+            ".interf/analysis.json",
+            ".interf/relevant.json",
+            "../../.interf/source-access.json",
+            "../../summaries/",
+            ...localSkills.reads,
+        ],
+        writes: [
+            "knowledge/",
+            "briefs/",
+            "home.md",
+        ],
+        notes: [
+            "Access hierarchy for this stage is: local interface artifacts -> parent knowledge-base artifacts -> raw source files only when needed.",
+            "The interface is a local context shell for agents. Build it so an agent can navigate AGENTS.md -> home.md -> local knowledge/briefs -> local summaries when present -> knowledge-base summaries -> raw only when needed.",
+            "When local outputs cite knowledge-base evidence, point to the parent knowledge-base summary path `../../summaries/...`, not the interface-local `summaries/` folder.",
+            "Prefer durable local notes and indexes over monolithic summaries.",
+            ...(plannedOutputArtifacts.length > 0
+                ? [`Compile-plan Stage 3 requires these exact local outputs: ${plannedOutputArtifacts.join(", ")}.`]
+                : []),
+            "Delete stale analysis handoff artifacts once durable outputs are written.",
+            interfaceRawFallbackPolicyNote(),
+            "The CLI reconciles `.interf/state.json`, refreshes `.interf/health.json`, and refreshes `.interf/view-spec.json` after stage validation. Do not treat those files as stage-owned write targets for compile.",
+            ...getWorkflowStagePolicyNotes("interface", workflowId, stageId, sourcePath, interfacePath),
+            ...localSkills.notes,
+        ],
+        targetContextFraction: 0.25,
+        strategy: "Use analysis artifacts as the compile ledger, then write entities, claims, briefs, and navigation in separate local passes.",
+    });
+}
+//# sourceMappingURL=workflows-interface-contracts.js.map

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

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

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

@@ -1,11 +1,7 @@
 import { type WorkflowExecutor } from "./executors.js";
-import { type RuntimeStageContractDraft } from "./runtime.js";
-import { type RuntimeStageInstructions } from "./schema.js";
-import { type InterfaceWorkflowId, type WorkflowStageDefinition } from "./workflow-definitions.js";
+import { type InterfaceWorkflowId } from "./workflow-definitions.js";
 import { type WorkflowReporter, type WorkflowStageResult } from "./workflow-helpers.js";
-export interface InterfaceStageExecutionDefinition extends WorkflowStageDefinition {
-    contractType: "interface-retrieval" | "interface-analysis" | "interface-output";
-}
+import { type InterfaceStageExecutionDefinition } from "./workflows-interface-contracts.js";
 export interface InterfaceRetrieveResult extends WorkflowStageResult {
     knowledgeBaseSummaryTotal: number;
     relevantCount: number;
@@ -34,6 +30,7 @@ export interface InterfacePlanOptions {
     workflow: string;
     useCase: string;
     knowledgeBaseName: string;
+    targetQuestions?: string[];
 }
 export declare function resolveInterfaceContext(knowledgeBasePath: string): {
     knowledgeBaseName: string;
@@ -42,10 +39,6 @@ export declare function resolveInterfaceContext(knowledgeBasePath: string): {
     workflowId: InterfaceWorkflowId;
 };
 export declare function interfaceExecutionStages(workflowId: InterfaceWorkflowId, interfacePath: string): InterfaceStageExecutionDefinition[];
-export declare function isRetrieveStageComplete(dirPath: string): boolean;
-export declare function buildInterfaceRetrieveContract(interfacePath: string, workflowId: InterfaceWorkflowId, summaryCount: number, instructions: RuntimeStageInstructions, stageId?: string, stageSkillDir?: string): RuntimeStageContractDraft;
-export declare function buildInterfaceAnalyzeContract(interfacePath: string, workflowId: InterfaceWorkflowId, analyzeCount: number, instructions: RuntimeStageInstructions, stageId?: string, stageSkillDir?: string): RuntimeStageContractDraft;
-export declare function buildInterfaceCompileContract(interfacePath: string, workflowId: InterfaceWorkflowId, relevantCount: number, instructions: RuntimeStageInstructions, stageId?: string, stageSkillDir?: string): RuntimeStageContractDraft;
 export declare function planInterface(options: InterfacePlanOptions): Promise<WorkflowStageResult>;
 export declare function runInterfaceRetrieve(options: {
     executor: WorkflowExecutor;

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

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