@interf/compiler 0.2.4 → 0.3.0

package/dist/lib/interf-compile-plan.js

@@ -1,143 +0,0 @@
-import { basename, join } from "node:path";
-import { writeFileSync } from "node:fs";
-import { getInterfaceWorkflow, } from "./workflow-definitions.js";
-import { readInterfConfig } from "./interf-detect.js";
-export function buildInterfaceStagePolicySection(notes) {
-    if (!notes || notes.length === 0)
-        return [];
-    const dedupedNotes = Array.from(new Set(notes));
-    return [
-        "### Workflow bias",
-        ...dedupedNotes.map((note) => `- ${note}`),
-        "",
-    ];
-}
-export function formatWorkflowStageFolders(stages) {
-    return stages.map((stage) => `\`workflow/compile/stages/${stage.skillDir}/\``).join(", ");
-}
-export function formatWorkflowStageSequence(stages) {
-    return stages.map((stage) => stage.label).join(" -> ");
-}
-function renderInterfaceCompilePlanStageSection(stage, index, useCase, notes) {
-    const heading = `## Stage ${index + 1} — ${stage.label}`;
-    switch (stage.contractType) {
-        case "interface-retrieval":
-            return [
-                heading,
-                "### Goal",
-                `Retrieve the knowledge-base summaries needed to answer this interface's job: ${useCase}.`,
-                "### Filter criteria",
-                `- prioritize summaries that directly help answer: ${useCase}`,
-                "### Key entities:",
-                "- people, companies, products, systems, decisions, claims, and evidence objects tied to the use case",
-                "### Priority evidence tiers:",
-                "- direct source-backed summaries",
-                "- linked supporting summaries that close coverage gaps",
-                "### Truth modes to prioritize or downweight:",
-                "- prioritize current, observed, and final material",
-                "- downweight speculative, stale, or weakly supported material unless needed for coverage",
-                "### Expected relevant file count:",
-                "- start narrow, then expand until coverage proof is complete",
-                ...buildInterfaceStagePolicySection(notes),
-                "### Method",
-                "- scan all parent summary frontmatter before selecting the set",
-                "- review candidate abstracts before final selection",
-                "- keep the retrieved set narrow, but preserve any summary whose decisive evidence may still live in charts, tables, or appendices",
-                "- write `.interf/relevant.json` and `.interf/coverage.json`, then stop",
-                "",
-            ];
-        case "interface-analysis":
-            return [
-                heading,
-                "### Goal",
-                `Extract the interface-specific structure and findings needed for: ${useCase}.`,
-                "### Target ledger:",
-                "- list one requested target per bullet with metric, entity/market, period, chart/table kind, and required precision",
-                "### Batching:",
-                "- analyze relevant summaries in bounded batches, then merge local findings",
-                "### Entities:",
-                "- derive the entities, themes, and evidence objects this interface needs",
-                "### Claims:",
-                "- record evidence-backed claims, contradictions, and open questions for the use case",
-                ...buildInterfaceStagePolicySection(notes),
-                "### Method",
-                "- use `.interf/relevant.json` and the target ledger as the primary checklist",
-                "- keep one result per requested target and preserve metric plus period as part of the target identity",
-                "- if exact answers are not preserved in summaries, inspect the raw source for those specific items and record whether they are exact, approximate, or unresolved",
-                "- keep raw extraction focused and bounded; stop once every requested target is classified",
-                "- write `.interf/analysis.json` with the target ledger and any raw extraction notes",
-                "",
-            ];
-        case "interface-output":
-            return [
-                heading,
-                "### Goal",
-                "Compile local interface outputs an agent can use immediately.",
-                "### Output files",
-                "- `home.md`",
-                "- `knowledge/`",
-                "- `briefs/`",
-                "- `summaries/` when interface-local summaries are useful",
-                ...buildInterfaceStagePolicySection(notes),
-                "### Method",
-                `- render the smallest useful local output set for: ${useCase}`,
-                "- treat Stage 3 of `compile-plan.md` as the output contract and follow the exact filenames it names",
-                "- cover every requested target explicitly and keep approximate or unresolved findings labeled as such",
-                "- preserve `value_display`, `bin_choice`, `precision`, `source_kind`, and page metadata from `.interf/analysis.json`",
-                "- write the requested local outputs, then stop",
-                "",
-            ];
-        default:
-            return [
-                heading,
-                "### Goal",
-                `Complete the ${stage.label} stage for this interface.`,
-                "### Method",
-                "- Follow the active stage contract and write the required artifacts.",
-                ...buildInterfaceStagePolicySection(notes),
-                "",
-            ];
-    }
-}
-function renderInterfaceCompilePlanTemplate(options) {
-    const useCase = options.useCase?.trim() || options.workflowPlaceholder || options.workflowHint;
-    const stageSections = options.stages.flatMap((stage, index) => renderInterfaceCompilePlanStageSection(stage, index, useCase, options.stagePolicyNotes?.[stage.id]));
-    return [
-        "# Compile Plan",
-        "",
-        "## Interface Goal",
-        `- workflow: \`${options.workflowId}\` (${options.workflowLabel})`,
-        `- use case: ${useCase}`,
-        `- method: ${options.workflowHint}`,
-        ...(options.targetQuestions && options.targetQuestions.length > 0
-            ? [
-                "",
-                "### Hard target questions",
-                ...options.targetQuestions.map((question) => `- ${question}`),
-            ]
-            : []),
-        "",
-        ...stageSections,
-    ].join("\n");
-}
-export function writeInterfaceCompilePlanTemplate(dirPath, options) {
-    const workflow = getInterfaceWorkflow(options.workflowId, {
-        sourcePath: options.sourcePath,
-        workspacePath: dirPath,
-    });
-    const config = readInterfConfig(dirPath);
-    const interfaceName = options.interfaceName ?? config?.name ?? basename(dirPath);
-    const content = renderInterfaceCompilePlanTemplate({
-        interfaceName,
-        workflowId: workflow.id,
-        workflowLabel: workflow.label,
-        workflowHint: workflow.hint,
-        workflowPlaceholder: workflow.placeholder,
-        useCase: options.useCase,
-        targetQuestions: options.targetQuestions,
-        stages: workflow.stages,
-        stagePolicyNotes: workflow.stagePolicyNotes,
-    });
-    writeFileSync(join(dirPath, "compile-plan.md"), content);
-}
-//# sourceMappingURL=interf-compile-plan.js.map

package/dist/lib/interf-compile-plan.js.map

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

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

@@ -1,79 +0,0 @@
-import { type RuntimeContractType } from "./schema.js";
-export declare function extractInterfacePlannedOutputFiles(dirPath: string): string[];
-export interface InterfaceValidationSummary {
-    config_present: boolean;
-    config_valid: boolean;
-    config_type_match: boolean;
-    knowledge_base_path_valid: boolean;
-    broken_links: number;
-}
-export interface InterfaceRetrieveValidation {
-    ok: boolean;
-    required: boolean;
-    summary: string;
-    counts: {
-        knowledge_base_total: number;
-        frontmatter_scanned: number;
-        candidate_count: number;
-        abstracts_read: number;
-        selected_count: number;
-        rejected_count: number;
-        delta_count: number;
-        expansion_passes: number;
-    };
-    checks: {
-        knowledge_base_path_valid: boolean;
-        state_present: boolean;
-        state_valid: boolean;
-        relevant_present: boolean;
-        relevant_valid: boolean;
-        coverage_present: boolean;
-        coverage_valid: boolean;
-        knowledge_base_count_match: boolean;
-        full_frontmatter_scan: boolean;
-        candidate_partition_valid: boolean;
-        abstracts_cover_candidates: boolean;
-        selected_match_relevant: boolean;
-        delta_subset: boolean;
-        proof_paths_resolve: boolean;
-        state_counts_match: boolean;
-        state_flags_match: boolean;
-    };
-    errors: string[];
-}
-export interface InterfacePlanValidation {
-    ok: boolean;
-    required: boolean;
-    summary: string;
-    counts: {
-        stage_sections_expected: number;
-        stage_sections_present: number;
-        output_mentions: number;
-    };
-    checks: {
-        config_present: boolean;
-        config_valid: boolean;
-        config_type_match: boolean;
-        knowledge_base_path_valid: boolean;
-        compile_plan_present: boolean;
-        compile_plan_sections: boolean;
-        stage1_defined: boolean;
-        stage2_defined: boolean;
-        stage3_defined: boolean;
-        all_stage_definitions_valid: boolean;
-        stage_checks: Array<{
-            id: string;
-            label: string;
-            contract_type: RuntimeContractType;
-            present: boolean;
-            defined: boolean;
-        }>;
-        agents_present: boolean;
-        home_present: boolean;
-    };
-    errors: string[];
-}
-export declare function validateInterfaceKnowledgeBase(dirPath: string): InterfaceValidationSummary;
-export declare function validateInterfacePlan(dirPath: string): InterfacePlanValidation;
-export declare function validateInterfaceRetrieve(dirPath: string): InterfaceRetrieveValidation;
-//# sourceMappingURL=validate-interface.d.ts.map

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

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