@interf/compiler 0.2.5 → 0.3.1

package/dist/lib/interf-workflow-package.d.ts

@@ -1,4 +1,3 @@
 import { type WorkflowDefinition } from "./workflow-definitions.js";
-export declare function writeKnowledgeBaseWorkflowPackage(knowledgeBasePath: string, workflow: WorkflowDefinition<string>, interfaceTemplates: WorkflowDefinition<string>[]): void;
-export declare function writeInterfaceWorkflowPackage(interfacePath: string, workflow: WorkflowDefinition<string>): void;
+export declare function writeWorkspaceWorkflowPackage(workspacePath: string, workflow: WorkflowDefinition<string>): void;
 //# sourceMappingURL=interf-workflow-package.d.ts.map

package/dist/lib/interf-workflow-package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interf-workflow-package.d.ts","sourceRoot":"","sources":["../../src/lib/interf-workflow-package.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,2BAA2B,CAAC;AAsJnC,wBAAgB,iCAAiC,CAC/C,iBAAiB,EAAE,MAAM,EACzB,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,EACpC,kBAAkB,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,GAC/C,IAAI,CAyBN;AAED,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,GACnC,IAAI,CAEN"}
+{"version":3,"file":"interf-workflow-package.d.ts","sourceRoot":"","sources":["../../src/lib/interf-workflow-package.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,2BAA2B,CAAC;AAgJnC,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,GACnC,IAAI,CAuBN"}

package/dist/lib/interf-workflow-package.js

@@ -1,8 +1,9 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { WORKFLOW_PACKAGE_DIR } from "./interf-detect.js";
-import { renderBundledTemplate } from "./bundled-templates.js";
-import { buildManualQueryFirstReplyRule, topKnowledgeBaseManualPreflightBlock, topInterfaceManualPreflightBlock, } from "./interf-bootstrap.js";
+function workflowPackagePath(dirPath) {
+    return join(dirPath, WORKFLOW_PACKAGE_DIR);
+}
 function writeWorkflowStarterDocs(dirPath, docs) {
     for (const doc of docs ?? []) {
         const targetPath = join(dirPath, doc.relativePath);
@@ -10,19 +11,12 @@ function writeWorkflowStarterDocs(dirPath, docs) {
         writeFileSync(targetPath, doc.content);
     }
 }
-function workflowPackagePath(dirPath) {
-    return join(dirPath, WORKFLOW_PACKAGE_DIR);
-}
-function workflowInterfacesPath(knowledgeBasePath) {
-    return join(workflowPackagePath(knowledgeBasePath), "interfaces");
-}
-function writeWorkflowPackageJson(rootPath, targetType, workflow) {
+function writeWorkflowPackageJson(rootPath, workflow) {
     writeFileSync(join(rootPath, "workflow.json"), `${JSON.stringify({
         id: workflow.id,
-        type: targetType,
+        type: "workspace",
         label: workflow.label,
         hint: workflow.hint,
-        ...(workflow.placeholder ? { placeholder: workflow.placeholder } : {}),
         stages: workflow.stages.map((stage) => ({
             id: stage.id,
             label: stage.label,
@@ -34,98 +28,113 @@ function writeWorkflowPackageJson(rootPath, targetType, workflow) {
         ...(workflow.stagePolicyNotes ? { stage_policy_notes: workflow.stagePolicyNotes } : {}),
     }, null, 2)}\n`);
 }
-function defaultWorkflowReadme(targetType, workflow) {
-    const stageLines = workflow.stages.map((stage) => `- \`${stage.id}\` — ${stage.description} (${stage.contractType})`);
-    return renderBundledTemplate("workflow-package/README.md", {
-        workflow_label: workflow.label,
-        target_type: targetType,
-        workflow_id: workflow.id,
-        workflow_hint: workflow.hint,
-        stage_lines: stageLines,
-    });
+function renderWorkflowReadme(workflow) {
+    const stageLines = workflow.stages
+        .map((stage) => `- \`${stage.id}\` — ${stage.description} (${stage.contractType})`)
+        .join("\n");
+    return [
+        `# ${workflow.label}`,
+        "",
+        workflow.hint,
+        "",
+        "## Stages",
+        "",
+        stageLines,
+        "",
+        "This workflow package lives under `workflow/` and controls how Interf builds this compiled workspace.",
+        "",
+    ].join("\n");
 }
-function defaultWorkflowCreateSkill(targetType, workflow) {
-    return renderBundledTemplate("workflow-package/create/SKILL.md", {
-        target_type: targetType,
-        workflow_id: workflow.id,
-        workflow_hint: workflow.hint,
-    });
+function renderCreateSkill(workflow) {
+    return [
+        "# Workspace Create Notes",
+        "",
+        `Workflow: ${workflow.id}`,
+        "",
+        "This workspace uses the built-in Interf structure. Edit these notes only if you want local create-time guidance for agents or maintainers.",
+        "",
+    ].join("\n");
 }
-function defaultKnowledgeBaseStageSkill(workflow, stage) {
-    const notes = workflow.stagePolicyNotes?.[stage.id] ?? [];
-    return renderBundledTemplate("workflow-package/knowledge-base-stage/SKILL.md", {
-        stage_label: stage.label,
-        contract_type: stage.contractType,
-        workflow_id: workflow.id,
-        stage_description: stage.description,
-        stage_notes: notes.map((note) => `- ${note}`),
-    });
+function renderQuerySkill() {
+    return [
+        "# Manual Query Loop",
+        "",
+        "Default loop:",
+        "1. Read `home.md` first.",
+        "2. Browse `knowledge/` before raw files.",
+        "3. Use `summaries/` for source-grounded evidence.",
+        "4. Inspect `.interf/source-access.json` before claiming raw verification.",
+        "",
+        "First-reply rule:",
+        "- on the first substantive manual question, inspect `.interf/source-access.json` immediately and open one `suggested_checks` path",
+        "- if the environment asks for permission, request it immediately instead of guessing",
+        "- the first line of the answer must be exactly `Raw access: confirmed` or `Raw access: unavailable`",
+        "- use `Raw access: confirmed` only after you actually open and inspect a suggested raw path from this session; a plain existence check is not enough",
+        "- use `Raw access: unavailable` only after a raw check fails or permission is denied",
+        "",
+        "You can edit this file to bias manual question-answering behavior for this workspace.",
+        "",
+    ].join("\n");
 }
-function defaultInterfaceStageSkill(workflow, stage) {
+function renderStageSkill(workflow, stage) {
     const notes = workflow.stagePolicyNotes?.[stage.id] ?? [];
-    return renderBundledTemplate("workflow-package/interface-stage/SKILL.md", {
-        stage_label: stage.label,
-        contract_type: stage.contractType,
-        workflow_id: workflow.id,
-        stage_description: stage.description,
-        stage_notes: notes.map((note) => `- ${note}`),
-    });
+    const stageSpecificNotes = stage.contractType === "workspace-file-evidence"
+        ? [
+            "Each summary must use JSON frontmatter and include `source`, `source_kind`, `evidence_tier`, `truth_mode`, `state`, and a non-empty `abstract`.",
+            "Include a clear abstract block in the body so a human can skim the summary quickly.",
+            "Do not skip the abstract just because the overview section is present.",
+        ]
+        : stage.contractType === "workspace-knowledge-structure"
+            ? [
+                "Treat the knowledge layer as retrieval structure, not final truth.",
+                "Prefer durable entity, claim, and index notes over one giant catch-all file.",
+            ]
+            : stage.contractType === "workspace-query-shape"
+                ? [
+                    "Use the workspace focus plus saved question text to shape `home.md` and retrieval routes.",
+                    "Do not copy expected answers into the workspace.",
+                ]
+                : [];
+    return [
+        `# ${stage.label}`,
+        "",
+        stage.description,
+        "",
+        `Contract type: \`${stage.contractType}\``,
+        "",
+        ...(stageSpecificNotes.length > 0
+            ? [
+                "## Requirements",
+                "",
+                ...stageSpecificNotes.map((note) => `- ${note}`),
+                "",
+            ]
+            : []),
+        ...(notes.length > 0
+            ? [
+                "## Notes",
+                "",
+                ...notes.map((note) => `- ${note}`),
+                "",
+            ]
+            : []),
+    ].join("\n");
 }
-function defaultQuerySkill(scope) {
-    const isInterface = scope === "interface";
-    const topPreflight = isInterface
-        ? topInterfaceManualPreflightBlock()
-        : topKnowledgeBaseManualPreflightBlock();
-    if (isInterface) {
-        return renderBundledTemplate("workflow-package/interface-query/SKILL.md", {
-            top_preflight: topPreflight,
-            first_reply_rule: buildManualQueryFirstReplyRule(scope),
-        });
-    }
-    return renderBundledTemplate("workflow-package/knowledge-base-query/SKILL.md", {
-        top_preflight: topPreflight,
-        first_reply_rule: buildManualQueryFirstReplyRule(scope),
-    });
-}
-function writeInterfaceWorkflowTemplate(targetDir, workflow) {
-    mkdirSync(join(targetDir, "create"), { recursive: true });
-    mkdirSync(join(targetDir, "use", "query"), { recursive: true });
-    mkdirSync(join(targetDir, "compile", "stages"), { recursive: true });
-    for (const stage of workflow.stages) {
-        mkdirSync(join(targetDir, "compile", "stages", stage.skillDir), { recursive: true });
-    }
-    writeWorkflowPackageJson(targetDir, "interface", workflow);
-    writeFileSync(join(targetDir, "README.md"), defaultWorkflowReadme("interface", workflow));
-    writeFileSync(join(targetDir, "create", "SKILL.md"), defaultWorkflowCreateSkill("interface", workflow));
-    writeFileSync(join(targetDir, "use", "query", "SKILL.md"), defaultQuerySkill("interface"));
-    for (const stage of workflow.stages) {
-        writeFileSync(join(targetDir, "compile", "stages", stage.skillDir, "SKILL.md"), defaultInterfaceStageSkill(workflow, stage));
-    }
-    writeWorkflowStarterDocs(targetDir, workflow.starterDocs);
-}
-export function writeKnowledgeBaseWorkflowPackage(knowledgeBasePath, workflow, interfaceTemplates) {
-    const workflowDir = workflowPackagePath(knowledgeBasePath);
+export function writeWorkspaceWorkflowPackage(workspacePath, workflow) {
+    const workflowDir = workflowPackagePath(workspacePath);
     mkdirSync(join(workflowDir, "create"), { recursive: true });
     mkdirSync(join(workflowDir, "use", "query"), { recursive: true });
     mkdirSync(join(workflowDir, "compile", "stages"), { recursive: true });
     for (const stage of workflow.stages) {
         mkdirSync(join(workflowDir, "compile", "stages", stage.skillDir), { recursive: true });
     }
-    writeWorkflowPackageJson(workflowDir, "knowledge-base", workflow);
-    writeFileSync(join(workflowDir, "README.md"), defaultWorkflowReadme("knowledge-base", workflow));
-    writeFileSync(join(workflowDir, "create", "SKILL.md"), defaultWorkflowCreateSkill("knowledge-base", workflow));
-    writeFileSync(join(workflowDir, "use", "query", "SKILL.md"), defaultQuerySkill("knowledge-base"));
+    writeWorkflowPackageJson(workflowDir, workflow);
+    writeFileSync(join(workflowDir, "README.md"), renderWorkflowReadme(workflow));
+    writeFileSync(join(workflowDir, "create", "SKILL.md"), renderCreateSkill(workflow));
+    writeFileSync(join(workflowDir, "use", "query", "SKILL.md"), renderQuerySkill());
     for (const stage of workflow.stages) {
-        writeFileSync(join(workflowDir, "compile", "stages", stage.skillDir, "SKILL.md"), defaultKnowledgeBaseStageSkill(workflow, stage));
+        writeFileSync(join(workflowDir, "compile", "stages", stage.skillDir, "SKILL.md"), renderStageSkill(workflow, stage));
     }
     writeWorkflowStarterDocs(workflowDir, workflow.starterDocs);
-    const interfacesDir = workflowInterfacesPath(knowledgeBasePath);
-    mkdirSync(interfacesDir, { recursive: true });
-    for (const template of interfaceTemplates) {
-        writeInterfaceWorkflowTemplate(join(interfacesDir, template.id), template);
-    }
-}
-export function writeInterfaceWorkflowPackage(interfacePath, workflow) {
-    writeInterfaceWorkflowTemplate(workflowPackagePath(interfacePath), workflow);
 }
 //# sourceMappingURL=interf-workflow-package.js.map

package/dist/lib/interf-workflow-package.js.map

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

package/dist/lib/interf.d.ts

@@ -1,6 +1,5 @@
-export { INTERF_CONTAINER_NAME, WORKFLOW_CONTAINER_NAME, BENCHMARK_CONTAINER_NAME, INTERF_CONFIG_FILE, WORKFLOW_PACKAGE_DIR, readInterfConfig, detectInterf, resolveKnowledgeBase, resolveInterfaceKnowledgeBasePath, resolveKnowledgeBaseSourcePath, listKnowledgeBasesForSourceFolder, assertKnowledgeBaseContainer, assertWritableTargetDir, assertWorkspaceName, } from "./interf-detect.js";
-export type { InterfConfig, ResolvedKnowledgeBase } from "./interf-detect.js";
-export { syncClaudeBootstrap, refreshWorkspaceBootstrapGuidance, refreshLegacyAgentsBootstrap, refreshLegacyKnowledgeBaseQuerySkill, refreshLegacyInterfaceQuerySkill, insertLineAfterFirstMatch, insertBlockBeforeFirstMatch, renderClaudeBootstrap, topKnowledgeBaseManualPreflightBlock, topInterfaceManualPreflightBlock, buildWorkspaceRuntimeControlLines, buildWorkspaceAgentLayerLines, } from "./interf-bootstrap.js";
-export { buildInterfaceStagePolicySection, formatWorkflowStageFolders, formatWorkflowStageSequence, writeInterfaceCompilePlanTemplate, } from "./interf-compile-plan.js";
-export { createKnowledgeBase, createKnowledgeBaseWithWorkflow, createInterface, createInterfaceWithWorkflow, } from "./interf-scaffold.js";
+export { INTERF_CONTAINER_NAME, WORKSPACE_CONTAINER_NAME, WORKFLOW_CONTAINER_NAME, BENCHMARK_CONTAINER_NAME, INTERF_CONFIG_FILE, WORKFLOW_PACKAGE_DIR, readInterfConfig, detectInterf, resolveWorkspace, resolveSourceFolderPath, listWorkspacesForSourceFolder, hasSourceFolderInput, assertWorkspaceContainer, assertWritableTargetDir, assertWorkspaceName, } from "./interf-detect.js";
+export type { InterfConfig, ResolvedWorkspace } from "./interf-detect.js";
+export { syncClaudeBootstrap, refreshWorkspaceBootstrapGuidance, refreshLegacyAgentsBootstrap, insertLineAfterFirstMatch, insertBlockBeforeFirstMatch, renderClaudeBootstrap, buildWorkspaceRuntimeControlLines, buildWorkspaceAgentLayerLines, } from "./interf-bootstrap.js";
+export { createWorkspace, defaultWorkspaceNameForSource, } from "./interf-scaffold.js";
 //# sourceMappingURL=interf.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"interf.d.ts","sourceRoot":"","sources":["../../src/lib/interf.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,iCAAiC,EACjC,8BAA8B,EAC9B,iCAAiC,EACjC,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,OAAO,EACL,mBAAmB,EACnB,iCAAiC,EACjC,4BAA4B,EAC5B,oCAAoC,EACpC,gCAAgC,EAChC,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,oCAAoC,EACpC,gCAAgC,EAChC,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,gCAAgC,EAChC,0BAA0B,EAC1B,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,eAAe,EACf,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"interf.d.ts","sourceRoot":"","sources":["../../src/lib/interf.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,6BAA6B,EAC7B,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EACL,mBAAmB,EACnB,iCAAiC,EACjC,4BAA4B,EAC5B,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,eAAe,EACf,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC"}

package/dist/lib/interf.js

@@ -1,7 +1,4 @@
-// Barrel — re-exports from the three focused sub-modules.
-// Every symbol previously exported from this file is still importable here.
-export { INTERF_CONTAINER_NAME, WORKFLOW_CONTAINER_NAME, BENCHMARK_CONTAINER_NAME, INTERF_CONFIG_FILE, WORKFLOW_PACKAGE_DIR, readInterfConfig, detectInterf, resolveKnowledgeBase, resolveInterfaceKnowledgeBasePath, resolveKnowledgeBaseSourcePath, listKnowledgeBasesForSourceFolder, assertKnowledgeBaseContainer, assertWritableTargetDir, assertWorkspaceName, } from "./interf-detect.js";
-export { syncClaudeBootstrap, refreshWorkspaceBootstrapGuidance, refreshLegacyAgentsBootstrap, refreshLegacyKnowledgeBaseQuerySkill, refreshLegacyInterfaceQuerySkill, insertLineAfterFirstMatch, insertBlockBeforeFirstMatch, renderClaudeBootstrap, topKnowledgeBaseManualPreflightBlock, topInterfaceManualPreflightBlock, buildWorkspaceRuntimeControlLines, buildWorkspaceAgentLayerLines, } from "./interf-bootstrap.js";
-export { buildInterfaceStagePolicySection, formatWorkflowStageFolders, formatWorkflowStageSequence, writeInterfaceCompilePlanTemplate, } from "./interf-compile-plan.js";
-export { createKnowledgeBase, createKnowledgeBaseWithWorkflow, createInterface, createInterfaceWithWorkflow, } from "./interf-scaffold.js";
+export { INTERF_CONTAINER_NAME, WORKSPACE_CONTAINER_NAME, WORKFLOW_CONTAINER_NAME, BENCHMARK_CONTAINER_NAME, INTERF_CONFIG_FILE, WORKFLOW_PACKAGE_DIR, readInterfConfig, detectInterf, resolveWorkspace, resolveSourceFolderPath, listWorkspacesForSourceFolder, hasSourceFolderInput, assertWorkspaceContainer, assertWritableTargetDir, assertWorkspaceName, } from "./interf-detect.js";
+export { syncClaudeBootstrap, refreshWorkspaceBootstrapGuidance, refreshLegacyAgentsBootstrap, insertLineAfterFirstMatch, insertBlockBeforeFirstMatch, renderClaudeBootstrap, buildWorkspaceRuntimeControlLines, buildWorkspaceAgentLayerLines, } from "./interf-bootstrap.js";
+export { createWorkspace, defaultWorkspaceNameForSource, } from "./interf-scaffold.js";
 //# sourceMappingURL=interf.js.map

package/dist/lib/interf.js.map

@@ -1 +1 @@
-{"version":3,"file":"interf.js","sourceRoot":"","sources":["../../src/lib/interf.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,4EAA4E;AAE5E,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,iCAAiC,EACjC,8BAA8B,EAC9B,iCAAiC,EACjC,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,mBAAmB,EACnB,iCAAiC,EACjC,4BAA4B,EAC5B,oCAAoC,EACpC,gCAAgC,EAChC,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,oCAAoC,EACpC,gCAAgC,EAChC,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,gCAAgC,EAChC,0BAA0B,EAC1B,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,eAAe,EACf,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"interf.js","sourceRoot":"","sources":["../../src/lib/interf.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,6BAA6B,EAC7B,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,mBAAmB,EACnB,iCAAiC,EACjC,4BAA4B,EAC5B,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,eAAe,EACf,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC"}

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

@@ -1,6 +1,5 @@
 import { z } from "zod";
 import { RuntimeContractTypeSchema, RuntimeStageAcceptanceSchema } from "./schema.js";
-export type WorkflowTargetType = "knowledge-base" | "interface";
 export interface LocalWorkflowStarterDoc {
     relativePath: string;
     content: string;
@@ -15,21 +14,20 @@ export interface LocalWorkflowStageDefinition {
 }
 export interface LocalWorkflowDefinition {
     id: string;
-    type: WorkflowTargetType;
+    type: "workspace";
     label: string;
     hint: string;
     extends?: string;
-    placeholder?: string;
     stages?: LocalWorkflowStageDefinition[];
     stage_policy_notes?: Record<string, string[]>;
     starter_docs: LocalWorkflowStarterDoc[];
     directoryPath: string;
     workflowPath: string;
 }
-export declare function workflowDefinitionPath(sourcePath: string, type: WorkflowTargetType, id: string): string;
-export declare function loadWorkflowDefinitionFromDir(dirPath: string, type: WorkflowTargetType): LocalWorkflowDefinition | null;
-export declare function listLocalWorkflowDefinitions(sourcePath: string, type: WorkflowTargetType): LocalWorkflowDefinition[];
-export declare function loadLocalWorkflowDefinition(sourcePath: string, type: WorkflowTargetType, id: string): LocalWorkflowDefinition | null;
+export declare function workflowDefinitionPath(sourcePath: string, id: string): string;
+export declare function loadWorkflowDefinitionFromDir(dirPath: string): LocalWorkflowDefinition | null;
+export declare function listLocalWorkflowDefinitions(sourcePath: string): LocalWorkflowDefinition[];
+export declare function loadLocalWorkflowDefinition(sourcePath: string, id: string): LocalWorkflowDefinition | null;
 export declare function isWorkflowId(value: string): boolean;
 export interface WorkflowValidationResult {
     ok: boolean;
@@ -38,5 +36,8 @@ export interface WorkflowValidationResult {
     counts: Record<string, number>;
 }
 export declare function validateWorkflowPackage(dirPath: string): WorkflowValidationResult;
-export declare function writeLocalWorkflowDefinition(sourcePath: string, definition: Omit<LocalWorkflowDefinition, "directoryPath" | "workflowPath">): string;
+export declare function writeLocalWorkflowDefinition(sourcePath: string, id: string, workflowJson: Record<string, unknown>, docs: Array<{
+    relativePath: string;
+    content: string;
+}>): string;
 //# sourceMappingURL=local-workflows.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"local-workflows.d.ts","sourceRoot":"","sources":["../../src/lib/local-workflows.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAE7B,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,4BAA4B,EAAE,CAAC;IACxC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,YAAY,EAAE,uBAAuB,EAAE,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AA6CD,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,kBAAkB,EACxB,EAAE,EAAE,MAAM,GACT,MAAM,CAER;AAwBD,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kBAAkB,GACvB,uBAAuB,GAAG,IAAI,CAyBhC;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,kBAAkB,GACvB,uBAAuB,EAAE,CAgB3B;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,kBAAkB,EACxB,EAAE,EAAE,MAAM,GACT,uBAAuB,GAAG,IAAI,CAEhC;AAaD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB,CAqFjF;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,IAAI,CAAC,uBAAuB,EAAE,eAAe,GAAG,cAAc,CAAC,GAC1E,MAAM,CA4BR"}
+{"version":3,"file":"local-workflows.d.ts","sourceRoot":"","sources":["../../src/lib/local-workflows.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAE7B,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,4BAA4B,EAAE,CAAC;IACxC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,YAAY,EAAE,uBAAuB,EAAE,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAyCD,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,GACT,MAAM,CAER;AAYD,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,GACd,uBAAuB,GAAG,IAAI,CAyBhC;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,GACjB,uBAAuB,EAAE,CAgB3B;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,GACT,uBAAuB,GAAG,IAAI,CAEhC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB,CAyEjF;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,IAAI,EAAE,KAAK,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACrD,MAAM,CAUR"}

package/dist/lib/local-workflows.js

@@ -16,23 +16,24 @@ const LocalWorkflowStageDefinitionSchema = z.object({
 });
 const LocalWorkflowDefinitionSchema = z.object({
     id: z.string().regex(WorkflowIdPattern),
-    type: z.enum(["knowledge-base", "interface"]),
+    type: z.literal("workspace"),
     label: z.string().min(1),
     hint: z.string().min(1),
     extends: z.string().regex(WorkflowIdPattern).optional(),
-    placeholder: z.string().min(1).optional(),
     stages: z.array(LocalWorkflowStageDefinitionSchema).min(1).optional(),
     stage_policy_notes: z.record(z.string(), z.array(z.string())).optional(),
 }).superRefine((value, ctx) => {
-    const allowed = value.type === "knowledge-base"
-        ? new Set(["kb-file-evidence", "kb-knowledge-layer"])
-        : new Set(["interface-retrieval", "interface-analysis", "interface-output"]);
+    const allowed = new Set([
+        "workspace-file-evidence",
+        "workspace-knowledge-structure",
+        "workspace-query-shape",
+    ]);
     for (const [index, stage] of (value.stages ?? []).entries()) {
         if (!allowed.has(stage.contract_type)) {
             ctx.addIssue({
                 code: z.ZodIssueCode.custom,
                 path: ["stages", index, "contract_type"],
-                message: `contract_type "${stage.contract_type}" is not valid for ${value.type}`,
+                message: `contract_type "${stage.contract_type}" is not valid for workspace workflows`,
             });
         }
     }
@@ -40,29 +41,19 @@ const LocalWorkflowDefinitionSchema = z.object({
 function workflowRootPath(sourcePath) {
     return join(sourcePath, "interf", "workflows");
 }
-function workflowTypePath(sourcePath, type) {
-    return join(workflowRootPath(sourcePath), type);
-}
-export function workflowDefinitionPath(sourcePath, type, id) {
-    return join(workflowTypePath(sourcePath, type), id);
-}
-function workflowJsonPath(sourcePath, type, id) {
-    return join(workflowDefinitionPath(sourcePath, type, id), "workflow.json");
+export function workflowDefinitionPath(sourcePath, id) {
+    return join(workflowRootPath(sourcePath), id);
 }
 function collectStarterDocs(dirPath) {
     return listFilesRecursive(dirPath, isMarkdownFile)
         .filter((filePath) => relative(dirPath, filePath).replaceAll("\\", "/") !== "workflow.json")
-        .filter((filePath) => {
-        const relativePath = relative(dirPath, filePath).replaceAll("\\", "/");
-        return !relativePath.startsWith("interfaces/");
-    })
         .map((filePath) => ({
         relativePath: relative(dirPath, filePath).replaceAll("\\", "/"),
         content: readFileSync(filePath, "utf8"),
     }))
         .sort((a, b) => a.relativePath.localeCompare(b.relativePath));
 }
-export function loadWorkflowDefinitionFromDir(dirPath, type) {
+export function loadWorkflowDefinitionFromDir(dirPath) {
     const workflowPath = existsSync(join(dirPath, "workflow.json"))
         ? join(dirPath, "workflow.json")
         : null;
@@ -71,8 +62,8 @@ export function loadWorkflowDefinitionFromDir(dirPath, type) {
     const definition = readJsonFileWithSchema(workflowPath, "local workflow definition", LocalWorkflowDefinitionSchema);
     if (!definition)
         return null;
-    if (definition.type !== type) {
-        warnInterf(`Warning: local workflow definition at ${workflowPath} has type "${definition.type}", expected "${type}".`);
+    if (definition.type !== "workspace") {
+        warnInterf(`Warning: local workflow definition at ${workflowPath} has unexpected type "${definition.type}".`);
         return null;
     }
     return {
@@ -82,8 +73,8 @@ export function loadWorkflowDefinitionFromDir(dirPath, type) {
         workflowPath,
     };
 }
-export function listLocalWorkflowDefinitions(sourcePath, type) {
-    const root = workflowTypePath(sourcePath, type);
+export function listLocalWorkflowDefinitions(sourcePath) {
+    const root = workflowRootPath(sourcePath);
     if (!existsSync(root))
         return [];
     return readdirSync(root)
@@ -96,23 +87,12 @@ export function listLocalWorkflowDefinitions(sourcePath, type) {
             return false;
         }
     })
-        .map((entryPath) => loadWorkflowDefinitionFromDir(entryPath, type))
+        .map((entryPath) => loadWorkflowDefinitionFromDir(entryPath))
         .filter((definition) => definition !== null)
         .sort((a, b) => a.label.localeCompare(b.label));
 }
-export function loadLocalWorkflowDefinition(sourcePath, type, id) {
-    return loadWorkflowDefinitionFromDir(workflowDefinitionPath(sourcePath, type, id), type);
-}
-function assertEmptyWorkflowDir(dirPath) {
-    if (!existsSync(dirPath))
-        return;
-    const stat = statSync(dirPath);
-    if (!stat.isDirectory()) {
-        throw new Error(`Workflow target exists and is not a directory: ${dirPath}`);
-    }
-    if (readdirSync(dirPath).length > 0) {
-        throw new Error(`Workflow target already exists and is not empty: ${dirPath}`);
-    }
+export function loadLocalWorkflowDefinition(sourcePath, id) {
+    return loadWorkflowDefinitionFromDir(workflowDefinitionPath(sourcePath, id));
 }
 export function isWorkflowId(value) {
     return WorkflowIdPattern.test(value);
@@ -123,7 +103,7 @@ export function validateWorkflowPackage(dirPath) {
         return {
             ok: false,
             summary: `No workflow.json found at ${dirPath}`,
-            errors: [`Missing workflow.json`],
+            errors: ["Missing workflow.json"],
             counts: {},
         };
     }
@@ -132,7 +112,7 @@ export function validateWorkflowPackage(dirPath) {
         return {
             ok: false,
             summary: `Failed to parse workflow.json at ${workflowPath}`,
-            errors: [`Invalid JSON in workflow.json`],
+            errors: ["Invalid JSON in workflow.json"],
             counts: {},
         };
     }
@@ -149,70 +129,54 @@ export function validateWorkflowPackage(dirPath) {
     const def = parsed.data;
     const errors = [];
     if (def.stages && def.stages.length > 0) {
-        const allowed = def.type === "knowledge-base"
-            ? new Set(["kb-file-evidence", "kb-knowledge-layer"])
-            : new Set(["interface-retrieval", "interface-analysis", "interface-output"]);
-        for (const stage of def.stages) {
-            if (!allowed.has(stage.contract_type)) {
-                errors.push(`Stage "${stage.id}" uses contract_type "${stage.contract_type}" which is not valid for ${def.type} workflows`);
-            }
+        const order = new Map([
+            ["workspace-file-evidence", 0],
+            ["workspace-knowledge-structure", 1],
+            ["workspace-query-shape", 2],
+        ]);
+        const contractTypes = def.stages.map((stage) => stage.contract_type);
+        if (def.stages.length < 3) {
+            errors.push("Workspace workflows must include summarize, structure, and shape stages in order.");
+        }
+        else if (!contractTypes.every((contractType, index) => index === 0 || (order.get(contractType) ?? -1) >= (order.get(contractTypes[index - 1]) ?? -1))) {
+            errors.push("Workspace workflow stages must keep non-decreasing order: file-evidence -> knowledge-structure -> query-shape.");
         }
-        if (def.type === "knowledge-base") {
-            const types = def.stages.map((s) => s.contract_type);
-            const firstKnowledge = types.findIndex((t) => t === "kb-knowledge-layer");
-            if (firstKnowledge <= 0) {
-                errors.push(`KB workflows must have at least one kb-file-evidence stage followed by at least one kb-knowledge-layer stage`);
+        else {
+            if (!contractTypes.includes("workspace-file-evidence")) {
+                errors.push("Workspace workflows must include at least one workspace-file-evidence stage.");
             }
-            else if (!types.slice(0, firstKnowledge).every((t) => t === "kb-file-evidence")) {
-                errors.push(`All stages before the first kb-knowledge-layer must be kb-file-evidence`);
+            if (!contractTypes.includes("workspace-knowledge-structure")) {
+                errors.push("Workspace workflows must include at least one workspace-knowledge-structure stage.");
             }
-        }
-        if (def.type === "interface") {
-            const types = def.stages.map((s) => s.contract_type);
-            const firstAnalysis = types.findIndex((t) => t === "interface-analysis");
-            const firstOutput = types.findIndex((t) => t === "interface-output");
-            if (firstAnalysis <= 0 || firstOutput <= firstAnalysis) {
-                errors.push(`Interface workflows must have retrieval stages, then analysis stages, then output stages`);
+            if (!contractTypes.includes("workspace-query-shape")) {
+                errors.push("Workspace workflows must include at least one workspace-query-shape stage.");
             }
         }
     }
-    const stageCount = def.stages?.length ?? 0;
-    const starterDocs = listFilesRecursive(dirPath, isMarkdownFile).length;
-    if (errors.length > 0) {
-        return {
-            ok: false,
-            summary: `Workflow "${def.id}" has ${errors.length} issue(s)`,
-            errors,
-            counts: { stages: stageCount, docs: starterDocs },
-        };
-    }
+    const stageDirs = listFilesRecursive(join(dirPath, "compile", "stages"), (filePath) => basename(filePath) === "SKILL.md");
+    const counts = {
+        starter_docs: collectStarterDocs(dirPath).length,
+        compile_stage_docs: stageDirs.length,
+    };
     return {
-        ok: true,
-        summary: `Workflow "${def.id}" (${def.type}) is valid: ${stageCount} stage(s), ${starterDocs} doc(s)`,
-        errors: [],
-        counts: { stages: stageCount, docs: starterDocs },
+        ok: errors.length === 0,
+        summary: errors.length === 0 ? "Workflow package is valid." : `Workflow package has ${errors.length} issue(s).`,
+        errors,
+        counts,
     };
 }
-export function writeLocalWorkflowDefinition(sourcePath, definition) {
-    const dirPath = workflowDefinitionPath(sourcePath, definition.type, definition.id);
-    assertEmptyWorkflowDir(dirPath);
-    mkdirSync(dirPath, { recursive: true });
-    const workflowJson = {
-        id: definition.id,
-        type: definition.type,
-        label: definition.label,
-        hint: definition.hint,
-        ...(definition.extends ? { extends: definition.extends } : {}),
-        ...(definition.placeholder ? { placeholder: definition.placeholder } : {}),
-        ...(definition.stages ? { stages: definition.stages } : {}),
-        ...(definition.stage_policy_notes ? { stage_policy_notes: definition.stage_policy_notes } : {}),
-    };
-    writeFileSync(workflowJsonPath(sourcePath, definition.type, definition.id), `${JSON.stringify(workflowJson, null, 2)}\n`);
-    for (const doc of definition.starter_docs) {
-        const targetPath = join(dirPath, doc.relativePath);
+export function writeLocalWorkflowDefinition(sourcePath, id, workflowJson, docs) {
+    const root = workflowDefinitionPath(sourcePath, id);
+    mkdirSync(root, { recursive: true });
+    writeFileSync(join(root, "workflow.json"), JSON.stringify(workflowJson, null, 2) + "\n");
+    for (const doc of docs) {
+        const targetPath = join(root, doc.relativePath);
         mkdirSync(dirname(targetPath), { recursive: true });
         writeFileSync(targetPath, doc.content);
     }
-    return dirPath;
+    return root;
+}
+function basename(filePath) {
+    return filePath.split(/[\\/]/).pop() ?? filePath;
 }
 //# sourceMappingURL=local-workflows.js.map