@interf/compiler 0.3.4 → 0.4.0

package/dist/lib/agent-status.d.ts

@@ -1,4 +1,3 @@
 export declare function extractAgentFailureStatus(event: Record<string, unknown>): string | null;
 export declare function classifyTerminalVisibleStatus(text: string | null | undefined): "done" | "failure" | null;
 export declare function hasAgentStalled(lastActivityAt: number, now: number, stallTimeoutMs: number | null | undefined): boolean;
-//# sourceMappingURL=agent-status.d.ts.map

package/dist/lib/agent-status.js

@@ -56,4 +56,3 @@ function pickString(value) {
     }
     return null;
 }
-//# sourceMappingURL=agent-status.js.map

package/dist/lib/agent-types.d.ts

@@ -28,4 +28,3 @@ export interface SpawnAgentOptions {
     executionProfile?: WorkflowExecutionProfile;
     completionCheck?: (() => boolean) | null;
 }
-//# sourceMappingURL=agent-types.d.ts.map

package/dist/lib/agent-types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=agent-types.js.map

package/dist/lib/agents.d.ts

@@ -1,15 +1,6 @@
-import type { Agent } from "./agent-types.js";
-export { refreshInterfSkills, inspectInterfSkills, ensureRequiredSkill, extractRequiredSkill, } from "./agent-skills.js";
-export type { InterfSkillHealth } from "./agent-skills.js";
 export type { Agent, AgentAutomationReadiness, AgentPreflightOptions, AgentPreflightResult, SpawnAgentOptions, } from "./agent-types.js";
 export { detectAgents, supportsAutomatedRuns, resolveAgent, } from "./agent-detection.js";
 export { buildAgentPreflightPrompt, runAgentPreflight, ensureAgentAutomatedRunReady, } from "./agent-preflight.js";
 export { spawnAgent, } from "./agent-execution.js";
 export { buildAgentArgs } from "./agent-args.js";
 export { extractAgentFailureStatus, classifyTerminalVisibleStatus, hasAgentStalled, } from "./agent-status.js";
-export declare function installSkills(agents?: Agent[]): {
-    agent: string;
-    skill: string;
-    success: boolean;
-}[];
-//# sourceMappingURL=agents.d.ts.map

package/dist/lib/agents.js

@@ -1,14 +1,5 @@
-import { installSkills as installSkillsCore } from "./agent-skills.js";
-import { detectAgents } from "./agent-detection.js";
-// Re-export skill functions so existing imports from "./agents.js" still resolve.
-export { refreshInterfSkills, inspectInterfSkills, ensureRequiredSkill, extractRequiredSkill, } from "./agent-skills.js";
 export { detectAgents, supportsAutomatedRuns, resolveAgent, } from "./agent-detection.js";
 export { buildAgentPreflightPrompt, runAgentPreflight, ensureAgentAutomatedRunReady, } from "./agent-preflight.js";
 export { spawnAgent, } from "./agent-execution.js";
 export { buildAgentArgs } from "./agent-args.js";
 export { extractAgentFailureStatus, classifyTerminalVisibleStatus, hasAgentStalled, } from "./agent-status.js";
-// Keep the legacy facade shape so existing "./agents.js" imports stay stable.
-export function installSkills(agents) {
-    return installSkillsCore(agents ?? detectAgents());
-}
-//# sourceMappingURL=agents.js.map

package/dist/lib/chart-guidance.d.ts

@@ -0,0 +1 @@
+export declare const CHART_APPROXIMATION_NOTES: readonly ["When a chart-derived value is approximate, use a bounded range instead of a pseudo-exact number.", "Match the granularity of the visible axis labels or bands. Do not invent finer precision than the chart supports.", "Keep the answer inside the visible tick band unless the chart supports a tighter bound.", "Use an upper-half or lower-half band only when the mark clearly sits there.", "If a mark touches or nearly touches a labeled gridline, anchor the answer at that gridline or the immediately adjacent half-band.", "Do not widen a chart-derived range across multiple visible bands unless the chart genuinely supports that uncertainty."];

package/dist/lib/chart-guidance.js

@@ -0,0 +1,8 @@
+export const CHART_APPROXIMATION_NOTES = [
+    "When a chart-derived value is approximate, use a bounded range instead of a pseudo-exact number.",
+    "Match the granularity of the visible axis labels or bands. Do not invent finer precision than the chart supports.",
+    "Keep the answer inside the visible tick band unless the chart supports a tighter bound.",
+    "Use an upper-half or lower-half band only when the mark clearly sits there.",
+    "If a mark touches or nearly touches a labeled gridline, anchor the answer at that gridline or the immediately adjacent half-band.",
+    "Do not widen a chart-derived range across multiple visible bands unless the chart genuinely supports that uncertainty.",
+];

package/dist/lib/config.d.ts

@@ -1,6 +1,3 @@
 export declare const PACKAGE_ROOT: string;
-export declare const SKILLS_DIR: string;
-export declare const WORKSPACE_INTERFIGNORE: string;
 export declare const INTERF_HOME: string;
 export declare const REGISTRY_PATH: string;
-//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.js

@@ -5,11 +5,6 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 // Package root (dist/lib/ → package root)
 export const PACKAGE_ROOT = join(__dirname, "..", "..");
-// Bundled skills shipped with the package
-export const SKILLS_DIR = join(PACKAGE_ROOT, "skills");
-// Workspace helper files
-export const WORKSPACE_INTERFIGNORE = join(PACKAGE_ROOT, "templates", "workspace", "interfignore");
 // User config
 export const INTERF_HOME = join(homedir(), ".interf");
 export const REGISTRY_PATH = join(INTERF_HOME, "registry.json");
-//# sourceMappingURL=config.js.map

package/dist/lib/discovery.d.ts

@@ -5,4 +5,3 @@ export interface DiscoveryResult {
 }
 export declare function discoverSourceFiles(sourcePath: string, workspacePath: string): DiscoveryResult;
 export declare function loadIgnorePatterns(knowledgeBasePath: string): string[];
-//# sourceMappingURL=discovery.d.ts.map

package/dist/lib/discovery.js

@@ -82,4 +82,3 @@ function matchGlob(path, pattern) {
     // Prefix match: "dist/foo" matches "dist/foo" and "dist/foo/bar"
     return path === pattern || path.startsWith(pattern + "/");
 }
-//# sourceMappingURL=discovery.js.map

package/dist/lib/execution-profile.d.ts

@@ -15,4 +15,3 @@ export declare function applyInternalAcceptanceExecutionProfileDefaults(agent: A
 export declare function hasWorkflowExecutionProfile(profile: WorkflowExecutionProfile | null | undefined): boolean;
 export declare function formatWorkflowExecutionProfile(profile: WorkflowExecutionProfile | null | undefined): string | null;
 export {};
-//# sourceMappingURL=execution-profile.d.ts.map

package/dist/lib/execution-profile.js

@@ -82,4 +82,3 @@ export function formatWorkflowExecutionProfile(profile) {
         ...(profile?.timeoutMs ? { timeout_ms: profile.timeoutMs } : {}),
     });
 }
-//# sourceMappingURL=execution-profile.js.map

package/dist/lib/executors.d.ts

@@ -30,4 +30,3 @@ export declare function resolveLocalExecutor(options?: {
     executor: WorkflowExecutor | null;
     error?: string;
 };
-//# sourceMappingURL=executors.d.ts.map

package/dist/lib/executors.js

@@ -41,4 +41,3 @@ export function resolveLocalExecutor(options = {}) {
     }
     return { executor: createLocalAgentExecutor(agent, options.executionProfile) };
 }
-//# sourceMappingURL=executors.js.map

package/dist/lib/filesystem.d.ts

@@ -1,3 +1,2 @@
 export declare function countFilesRecursive(dirPath: string): number;
 export declare function listFilesRecursive(dirPath: string, predicate?: (filePath: string) => boolean): string[];
-//# sourceMappingURL=filesystem.d.ts.map

package/dist/lib/filesystem.js

@@ -53,4 +53,3 @@ function walkFilesRecursiveInternal(dirPath, onFile, visitedDirs) {
         }
     }
 }
-//# sourceMappingURL=filesystem.js.map

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

@@ -1,4 +1,3 @@
 import { renderClaudeBootstrap } from "./agent-shells.js";
 export { renderClaudeBootstrap };
 export declare function refreshWorkspaceBootstrapGuidance(dirPath: string): boolean;
-//# sourceMappingURL=interf-bootstrap.d.ts.map

package/dist/lib/interf-bootstrap.js

@@ -8,7 +8,11 @@ export function refreshWorkspaceBootstrapGuidance(dirPath) {
         return false;
     const workspaceName = config.name ?? basename(dirPath);
     const workflowId = config.workflow ?? "interf";
+    const workflowOriginSelected = config.workflow_origin?.selected ?? workflowId;
+    const workflowLocalDraft = config.workflow_origin?.local_draft === true;
     const about = typeof config.about === "string" && config.about.length > 0 ? config.about : undefined;
-    return projectWorkspaceQueryShell(dirPath, workspaceName, workflowId, about);
+    return projectWorkspaceQueryShell(dirPath, workspaceName, workflowId, about, {
+        workflowOriginSelected,
+        workflowLocalDraft,
+    });
 }
-//# sourceMappingURL=interf-bootstrap.js.map

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

@@ -8,9 +8,10 @@ export interface ResolvedWorkspace {
 export declare const INTERF_CONTAINER_NAME = "interf";
 export declare const WORKSPACE_CONTAINER_NAME = "workspaces";
 export declare const WORKFLOW_CONTAINER_NAME = "workflows";
-export declare const BENCHMARK_CONTAINER_NAME = "benchmarks";
+export declare const TEST_CONTAINER_NAME = "tests";
 export declare const INTERF_CONFIG_FILE = "interf.json";
 export declare const WORKFLOW_PACKAGE_DIR = "workflow";
+export declare function prepareWorkspaceLayout(dirPath: string): boolean;
 export declare function readInterfConfig(dirPath: string): InterfConfig | null;
 export declare function hasSourceFolderInput(config: InterfConfig | null | undefined): config is InterfConfig & {
     source: {
@@ -31,4 +32,3 @@ export declare function listWorkspacesForSourceFolder(sourcePath: string): Array
 export declare function assertWorkspaceContainer(sourcePath: string): string;
 export declare function assertWritableTargetDir(dirPath: string, label: string): void;
 export declare function assertWorkspaceName(name: string, label: string): void;
-//# sourceMappingURL=interf-detect.d.ts.map

package/dist/lib/interf-detect.js

@@ -2,15 +2,23 @@ import { existsSync, readdirSync, statSync, } from "node:fs";
 import { join, resolve } from "node:path";
 import { warnInterf } from "./logger.js";
 import { readJsonFileWithSchema } from "./parse.js";
+import { resolveSourceControlPathForWorkspace, workspaceInterfConfigPath, } from "./workspace-paths.js";
+import { normalizeLegacyWorkspaceLayout, workspaceNeedsLegacyLayoutNormalization, } from "./workspace-layout.js";
 import { InterfConfigSchema, } from "./schema.js";
 export const INTERF_CONTAINER_NAME = "interf";
 export const WORKSPACE_CONTAINER_NAME = "workspaces";
 export const WORKFLOW_CONTAINER_NAME = "workflows";
-export const BENCHMARK_CONTAINER_NAME = "benchmarks";
+export const TEST_CONTAINER_NAME = "tests";
 export const INTERF_CONFIG_FILE = "interf.json";
 export const WORKFLOW_PACKAGE_DIR = "workflow";
+export function prepareWorkspaceLayout(dirPath) {
+    if (!workspaceNeedsLegacyLayoutNormalization(dirPath)) {
+        return false;
+    }
+    return normalizeLegacyWorkspaceLayout(dirPath);
+}
 export function readInterfConfig(dirPath) {
-    const configPath = join(dirPath, INTERF_CONFIG_FILE);
+    const configPath = workspaceInterfConfigPath(dirPath);
     if (!existsSync(configPath))
         return null;
     return readJsonFileWithSchema(configPath, "Interf config", InterfConfigSchema);
@@ -19,6 +27,7 @@ export function hasSourceFolderInput(config) {
     return typeof config?.source?.path === "string" && config.source.path.length > 0;
 }
 export function detectInterf(cwd) {
+    prepareWorkspaceLayout(cwd);
     const config = readInterfConfig(cwd);
     if (config)
         return { path: cwd, config };
@@ -34,14 +43,21 @@ export function resolveWorkspace(cwd) {
         config: detected.config,
     };
 }
-export function resolveSourceFolderPath(workspacePath, config = readInterfConfig(workspacePath)) {
-    if (hasSourceFolderInput(config)) {
-        return resolve(workspacePath, config.source.path);
+export function resolveSourceFolderPath(workspacePath, config = null) {
+    prepareWorkspaceLayout(workspacePath);
+    const resolvedConfig = config ?? readInterfConfig(workspacePath);
+    if (hasSourceFolderInput(resolvedConfig)) {
+        return resolve(workspacePath, resolvedConfig.source.path);
     }
     return resolve(workspacePath, "raw");
 }
 export function resolveSourceControlPath(workspacePath) {
-    return resolve(workspacePath, "..", "..", "..");
+    prepareWorkspaceLayout(workspacePath);
+    const config = readInterfConfig(workspacePath);
+    if (typeof config?.source?.control_path === "string" && config.source.control_path.length > 0) {
+        return resolve(workspacePath, config.source.control_path);
+    }
+    return resolveSourceControlPathForWorkspace(workspacePath);
 }
 function listWorkspaceEntries(containerPath) {
     if (!existsSync(containerPath))
@@ -66,6 +82,7 @@ function listWorkspaceEntries(containerPath) {
         }
     })
         .map((entryPath) => {
+        prepareWorkspaceLayout(entryPath);
         const config = readInterfConfig(entryPath);
         return config ? { path: entryPath, config } : null;
     })
@@ -87,7 +104,7 @@ export function assertWorkspaceContainer(sourcePath) {
             const entryPath = join(interfRoot, entry);
             if (entry === WORKSPACE_CONTAINER_NAME ||
                 entry === WORKFLOW_CONTAINER_NAME ||
-                entry === BENCHMARK_CONTAINER_NAME) {
+                entry === TEST_CONTAINER_NAME) {
                 try {
                     return !statSync(entryPath).isDirectory();
                 }
@@ -122,6 +139,7 @@ export function assertWorkspaceContainer(sourcePath) {
             warnInterf(`Warning: failed to inspect Interf entry at ${entryPath}: ${error instanceof Error ? error.message : String(error)}`);
             return true;
         }
+        prepareWorkspaceLayout(entryPath);
         return !readInterfConfig(entryPath);
     });
     if (unexpectedEntries.length > 0) {
@@ -145,4 +163,3 @@ export function assertWorkspaceName(name, label) {
         throw new Error(`${label} name must be a safe slug with lowercase letters, numbers, and dashes only: ${name}`);
     }
 }
-//# sourceMappingURL=interf-detect.js.map

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

@@ -1,3 +1,2 @@
 export declare function createWorkspace(name: string, sourcePath: string, workflowId?: string, about?: string): string;
 export declare function defaultWorkspaceNameForSource(sourcePath: string): string;
-//# sourceMappingURL=interf-scaffold.d.ts.map

package/dist/lib/interf-scaffold.js

@@ -1,16 +1,27 @@
-import { copyFileSync, existsSync, mkdirSync, writeFileSync, } from "node:fs";
+import { mkdirSync, writeFileSync, } from "node:fs";
 import { basename, join } from "node:path";
-import { WORKSPACE_INTERFIGNORE } from "./config.js";
 import { getWorkspaceWorkflow } from "./workflow-definitions.js";
 import { refreshWorkspaceArtifacts, saveState, initWorkspaceState, } from "./state.js";
+import { saveEmptyWorkspaceInventory } from "./state-io.js";
 import { writeObsidianDefaults } from "./obsidian.js";
-import { assertWorkspaceContainer, assertWritableTargetDir, assertWorkspaceName, INTERF_CONFIG_FILE, } from "./interf-detect.js";
+import { assertWorkspaceContainer, assertWritableTargetDir, assertWorkspaceName, } from "./interf-detect.js";
 import { refreshWorkspaceBootstrapGuidance } from "./interf-bootstrap.js";
-import { writeWorkspaceWorkflowPackage } from "./interf-workflow-package.js";
+import { seedWorkspaceWorkflowPackage } from "./interf-workflow-package.js";
 import { syncWorkspaceRawSnapshot } from "./workspace-raw.js";
-function writeInterfConfigFile(dirPath, config) {
-    writeFileSync(join(dirPath, INTERF_CONFIG_FILE), `${JSON.stringify(config, null, 2)}\n`);
-}
+import { findSourceWorkspaceConfig, loadSourceFolderConfig, saveWorkspaceInterfConfig, } from "./source-config.js";
+import { defaultControlPathForWorkspace } from "./workspace-paths.js";
+import { renderUncompiledWorkspaceHome } from "./workspace-home.js";
+const DEFAULT_INTERFIGNORE = [
+    ".claude/",
+    ".codex/",
+    ".agents/",
+    ".cursor/",
+    ".interf/tests/",
+    ".interf/tests/targets/sandboxes/",
+    ".interf/runtime/",
+    ".obsidian/",
+    "",
+].join("\n");
 export function createWorkspace(name, sourcePath, workflowId = "interf", about) {
     assertWorkspaceName(name, "Workspace");
     const containerPath = assertWorkspaceContainer(sourcePath);
@@ -18,33 +29,56 @@ export function createWorkspace(name, sourcePath, workflowId = "interf", about)
     const workspacePath = join(containerPath, name);
     assertWritableTargetDir(workspacePath, "Workspace");
     mkdirSync(workspacePath, { recursive: true });
+    const savedWorkspace = findSourceWorkspaceConfig(loadSourceFolderConfig(sourcePath), name);
     const selectedWorkflow = getWorkspaceWorkflow(workflowId, { sourcePath });
-    writeInterfConfigFile(workspacePath, {
+    const resolvedAbout = about ?? savedWorkspace?.about;
+    saveWorkspaceInterfConfig(workspacePath, {
         type: "workspace",
         name,
-        ...(about ? { about } : {}),
+        ...(resolvedAbout ? { about: resolvedAbout } : {}),
         workflow: selectedWorkflow.id,
+        ...(typeof savedWorkspace?.max_attempts === "number"
+            ? { max_attempts: savedWorkspace.max_attempts }
+            : {}),
+        ...(typeof savedWorkspace?.max_loops === "number"
+            ? { max_loops: savedWorkspace.max_loops }
+            : {}),
+        checks: savedWorkspace?.checks ?? [],
+        workflow_origin: {
+            selected: selectedWorkflow.id,
+            local_draft: false,
+        },
         source: {
             path: "./raw",
+            control_path: defaultControlPathForWorkspace(workspacePath),
         },
     });
     mkdirSync(join(workspacePath, "raw"), { recursive: true });
     syncWorkspaceRawSnapshot(workspacePath, sourcePath);
-    if (existsSync(WORKSPACE_INTERFIGNORE)) {
-        copyFileSync(WORKSPACE_INTERFIGNORE, join(workspacePath, ".interfignore"));
-    }
-    writeWorkspaceWorkflowPackage(workspacePath, selectedWorkflow);
+    writeFileSync(join(workspacePath, ".interfignore"), DEFAULT_INTERFIGNORE);
+    seedWorkspaceWorkflowPackage({
+        workspacePath,
+        sourcePath,
+        workflowId: selectedWorkflow.id,
+    });
     refreshWorkspaceBootstrapGuidance(workspacePath);
-    writeFileSync(join(workspacePath, "home.md"), [
-        `# ${name} — Home`,
-        "",
-        "Not yet compiled. Run `interf compile` to build this compiled workspace.",
-        ...(about ? ["", `About: ${about}`] : []),
+    writeFileSync(join(workspacePath, "home.md"), renderUncompiledWorkspaceHome(name, about));
+    writeFileSync(join(workspacePath, ".gitignore"), [
+        "raw/",
+        "summaries/",
+        "knowledge/",
+        ".claude/",
+        ".codex/",
+        ".agents/",
+        ".cursor/",
+        ".interf/tests/",
+        ".interf/tests/targets/sandboxes/",
+        ".interf/runtime/",
+        ".obsidian/",
         "",
     ].join("\n"));
-    writeFileSync(join(workspacePath, ".gitignore"), "raw/\nsummaries/\nknowledge/\n.interf/\n.obsidian/\n");
     saveState(workspacePath, initWorkspaceState());
-    writeFileSync(join(workspacePath, ".interf", "inventory.json"), JSON.stringify({ total: 0, files: [] }, null, 2) + "\n");
+    saveEmptyWorkspaceInventory(workspacePath);
     refreshWorkspaceArtifacts(workspacePath, { ensureViewSpec: true });
     writeObsidianDefaults(workspacePath, "workspace");
     return workspacePath;
@@ -52,4 +86,3 @@ export function createWorkspace(name, sourcePath, workflowId = "interf", about)
 export function defaultWorkspaceNameForSource(sourcePath) {
     return basename(sourcePath);
 }
-//# sourceMappingURL=interf-scaffold.js.map

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

@@ -1,3 +1,20 @@
 import { type WorkflowDefinition } from "./workflow-definitions.js";
 export declare function writeWorkspaceWorkflowPackage(workspacePath: string, workflow: WorkflowDefinition<string>): void;
-//# sourceMappingURL=interf-workflow-package.d.ts.map
+export declare function writeWorkflowPackageToDir(workflowDir: string, workflow: WorkflowDefinition<string>, options?: {
+    overwrite?: boolean;
+}): void;
+export declare function seedWorkspaceWorkflowPackage(options: {
+    workspacePath: string;
+    sourcePath: string;
+    workflowId: string;
+}): void;
+export declare function createLocalWorkflowPackageFromTemplate(options: {
+    sourcePath: string;
+    baseWorkflowId: string;
+    workflowId: string;
+    label: string;
+    hint: string;
+    summarizeBias: string;
+    structureBias: string;
+    shapeBias: string;
+}): string;