@interf/compiler 0.3.3 → 0.4.0

package/dist/lib/state-io.js

@@ -1,11 +1,10 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
-import { join } from "node:path";
 import { warnInterf } from "./logger.js";
 import { readJsonFileUnchecked, readJsonFileWithSchema } from "./parse.js";
 import { WorkspaceHealthSchema, WorkspaceInventorySchema, WorkspaceRawSnapshotSchema, WorkspaceStateSchema, WorkspaceViewSpecSchema, } from "./schema.js";
 import { readInventoryFiles, readInventoryTotal } from "./validate-helpers.js";
-import { STATE_DIR } from "./util.js";
 import { healthPath, rawSnapshotPath, statePath, viewSpecPath } from "./state-paths.js";
+import { workspaceRuntimeInventoryPath, workspaceRuntimeRoot, } from "./workspace-paths.js";
 const NORMALIZABLE_RUNTIME_TIMESTAMP_FIELDS = [
     "last_add",
     "last_summarize",
@@ -38,8 +37,7 @@ export function loadState(dirPath) {
     return null;
 }
 export function saveState(dirPath, state) {
-    const dir = join(dirPath, STATE_DIR);
-    mkdirSync(dir, { recursive: true });
+    mkdirSync(workspaceRuntimeRoot(dirPath), { recursive: true });
     writeFileSync(statePath(dirPath), JSON.stringify(state, null, 2) + "\n");
 }
 export function loadWorkspaceHealth(dirPath) {
@@ -49,8 +47,7 @@ export function loadWorkspaceHealth(dirPath) {
     return readJsonFileWithSchema(path, "workspace health", WorkspaceHealthSchema);
 }
 export function saveWorkspaceHealth(dirPath, health) {
-    const dir = join(dirPath, STATE_DIR);
-    mkdirSync(dir, { recursive: true });
+    mkdirSync(workspaceRuntimeRoot(dirPath), { recursive: true });
     writeFileSync(healthPath(dirPath), JSON.stringify(health, null, 2) + "\n");
 }
 export function loadWorkspaceViewSpec(dirPath) {
@@ -60,8 +57,7 @@ export function loadWorkspaceViewSpec(dirPath) {
     return loadViewSpec(path, WorkspaceViewSpecSchema);
 }
 export function saveWorkspaceViewSpec(dirPath, viewSpec) {
-    const dir = join(dirPath, STATE_DIR);
-    mkdirSync(dir, { recursive: true });
+    mkdirSync(workspaceRuntimeRoot(dirPath), { recursive: true });
     writeFileSync(viewSpecPath(dirPath), JSON.stringify(viewSpec, null, 2) + "\n");
 }
 export function loadWorkspaceRawSnapshot(dirPath) {
@@ -70,6 +66,10 @@ export function loadWorkspaceRawSnapshot(dirPath) {
         return null;
     return readJsonFileWithSchema(path, "workspace raw snapshot", WorkspaceRawSnapshotSchema);
 }
+export function saveEmptyWorkspaceInventory(dirPath) {
+    mkdirSync(workspaceRuntimeRoot(dirPath), { recursive: true });
+    writeFileSync(workspaceRuntimeInventoryPath(dirPath), JSON.stringify({ entries: [], total: 0 }, null, 2) + "\n");
+}
 export function initWorkspaceState() {
     return {
         version: 1,
@@ -116,7 +116,7 @@ function healParsedRuntimeState(dirPath, state) {
         return null;
     if (typeof state.last_summarize !== "string" || state.last_summarize.length === 0)
         return null;
-    const inventoryPath = join(dirPath, STATE_DIR, "inventory.json");
+    const inventoryPath = workspaceRuntimeInventoryPath(dirPath);
     if (!existsSync(inventoryPath))
         return null;
     const inventory = readJsonFileWithSchema(inventoryPath, "workspace inventory", WorkspaceInventorySchema);
@@ -155,4 +155,3 @@ function loadViewSpec(filePath, schema) {
         return null;
     }
 }
-//# sourceMappingURL=state-io.js.map

package/dist/lib/state-paths.d.ts

@@ -2,4 +2,3 @@ export declare function statePath(dirPath: string): string;
 export declare function healthPath(dirPath: string): string;
 export declare function viewSpecPath(dirPath: string): string;
 export declare function rawSnapshotPath(dirPath: string): string;
-//# sourceMappingURL=state-paths.d.ts.map

package/dist/lib/state-paths.js

@@ -1,19 +1,13 @@
-import { join } from "node:path";
-import { STATE_DIR } from "./util.js";
-const STATE_FILE = "state.json";
-const HEALTH_FILE = "health.json";
-const VIEW_SPEC_FILE = "view-spec.json";
-const RAW_SNAPSHOT_FILE = "raw-snapshot.json";
+import { workspaceRawSnapshotMetadataPath, workspaceRuntimeHealthPath, workspaceRuntimeStatePath, workspaceRuntimeViewSpecPath, } from "./workspace-paths.js";
 export function statePath(dirPath) {
-    return join(dirPath, STATE_DIR, STATE_FILE);
+    return workspaceRuntimeStatePath(dirPath);
 }
 export function healthPath(dirPath) {
-    return join(dirPath, STATE_DIR, HEALTH_FILE);
+    return workspaceRuntimeHealthPath(dirPath);
 }
 export function viewSpecPath(dirPath) {
-    return join(dirPath, STATE_DIR, VIEW_SPEC_FILE);
+    return workspaceRuntimeViewSpecPath(dirPath);
 }
 export function rawSnapshotPath(dirPath) {
-    return join(dirPath, STATE_DIR, RAW_SNAPSHOT_FILE);
+    return workspaceRawSnapshotMetadataPath(dirPath);
 }
-//# sourceMappingURL=state-paths.js.map

package/dist/lib/state-view.d.ts

@@ -2,4 +2,3 @@ import { type WorkspaceRawSnapshot, type WorkspaceViewSpec } from "./schema.js";
 export declare function ensureWorkspaceViewSpec(dirPath: string): WorkspaceViewSpec;
 export declare function ensureWorkspaceRawSnapshot(dirPath: string): WorkspaceRawSnapshot;
 export declare function normalizeWorkspaceViewSpec(existing: WorkspaceViewSpec, defaults?: WorkspaceViewSpec): WorkspaceViewSpec;
-//# sourceMappingURL=state-view.d.ts.map

package/dist/lib/state-view.js

@@ -1,10 +1,10 @@
-import { basename, relative, join } from "node:path";
+import { basename, relative } from "node:path";
 import { mkdirSync, writeFileSync } from "node:fs";
 import { discoverSourceFiles } from "./discovery.js";
 import { readInterfConfig, resolveSourceFolderPath } from "./interf.js";
 import { loadWorkspaceViewSpec, saveWorkspaceViewSpec, } from "./state-io.js";
 import { rawSnapshotPath } from "./state-paths.js";
-import { STATE_DIR } from "./util.js";
+import { workspaceRuntimeRoot } from "./workspace-paths.js";
 export function ensureWorkspaceViewSpec(dirPath) {
     const existing = loadWorkspaceViewSpec(dirPath);
     const now = new Date().toISOString();
@@ -40,7 +40,7 @@ export function ensureWorkspaceRawSnapshot(dirPath) {
         source_total: discovery.totalCount,
         sample_files: sampleFiles,
     };
-    mkdirSync(join(dirPath, STATE_DIR), { recursive: true });
+    mkdirSync(workspaceRuntimeRoot(dirPath), { recursive: true });
     writeFileSync(rawSnapshotPath(dirPath), JSON.stringify(artifact, null, 2) + "\n");
     return artifact;
 }
@@ -61,8 +61,8 @@ function buildDefaultWorkspaceViewSpec(workspaceName, generatedAt) {
         version: 1,
         generated_at: generatedAt,
         target_name: workspaceName,
-        health_source: ".interf/health.json",
-        state_source: ".interf/state.json",
+        health_source: ".interf/runtime/health.json",
+        state_source: ".interf/runtime/state.json",
         default_note: "home.md",
         graph_scope: ["summaries", "knowledge"],
         cards: [
@@ -74,8 +74,8 @@ function buildDefaultWorkspaceViewSpec(workspaceName, generatedAt) {
             { id: "claims", label: "Claims", metric: "claims", format: "number" },
         ],
         sections: [
-            { id: "status", type: "status", title: "Compile Status", path: ".interf/health.json" },
-            { id: "cards", type: "cards", title: "Key Metrics", path: ".interf/health.json" },
+            { id: "status", type: "status", title: "Compile Status", path: ".interf/runtime/health.json" },
+            { id: "cards", type: "cards", title: "Key Metrics", path: ".interf/runtime/health.json" },
             { id: "graph", type: "graph", title: "Knowledge Graph", paths: ["summaries", "knowledge"] },
             { id: "core-docs", type: "documents", title: "Core Docs", paths: ["home.md", "knowledge/indexes", "knowledge/entities", "knowledge/claims", "summaries"] },
             { id: "claims", type: "table", title: "Claims", path: "knowledge/claims" },
@@ -104,4 +104,3 @@ function normalizeWorkspaceCards(cards, defaults) {
         return normalized;
     });
 }
-//# sourceMappingURL=state-view.js.map

package/dist/lib/state.d.ts

@@ -4,4 +4,3 @@ export { loadState, saveState, loadWorkspaceHealth, saveWorkspaceHealth, loadWor
 export { refreshWorkspaceArtifacts, } from "./state-artifacts.js";
 export { computeWorkspaceHealth, resolveWorkspaceStatus, resolveWorkspaceStage, } from "./state-health.js";
 export { ensureWorkspaceViewSpec, ensureWorkspaceRawSnapshot, normalizeWorkspaceViewSpec, } from "./state-view.js";
-//# sourceMappingURL=state.d.ts.map

package/dist/lib/state.js

@@ -3,4 +3,3 @@ export { loadState, saveState, loadWorkspaceHealth, saveWorkspaceHealth, loadWor
 export { refreshWorkspaceArtifacts, } from "./state-artifacts.js";
 export { computeWorkspaceHealth, resolveWorkspaceStatus, resolveWorkspaceStage, } from "./state-health.js";
 export { ensureWorkspaceViewSpec, ensureWorkspaceRawSnapshot, normalizeWorkspaceViewSpec, } from "./state-view.js";
-//# sourceMappingURL=state.js.map

package/dist/lib/summarize-plan.d.ts

@@ -14,4 +14,3 @@ export interface SummarizePlan {
 }
 export declare function buildSummarizePlan(sourcePath: string, workspacePath: string, mode?: "pending" | "all"): SummarizePlan;
 export declare function writeSummarizePlan(workspacePath: string, plan: SummarizePlan): string;
-//# sourceMappingURL=summarize-plan.d.ts.map

package/dist/lib/summarize-plan.js

@@ -4,7 +4,8 @@ import { listFilesRecursive } from "./filesystem.js";
 import { discoverSourceFiles } from "./discovery.js";
 import { loadState } from "./state.js";
 import { parseJsonFrontmatter } from "./parse.js";
-const PLAN_PATH = join(".interf", "summarize-targets.json");
+import { workspaceRuntimeRoot } from "./workspace-paths.js";
+const PLAN_PATH = join(".interf", "runtime", "summarize-targets.json");
 export function buildSummarizePlan(sourcePath, workspacePath, mode = "pending") {
     const discovery = discoverSourceFiles(sourcePath, workspacePath);
     const sourceFiles = discovery.sourceFiles;
@@ -92,7 +93,7 @@ export function buildSummarizePlan(sourcePath, workspacePath, mode = "pending")
 }
 export function writeSummarizePlan(workspacePath, plan) {
     const planPath = join(workspacePath, PLAN_PATH);
-    mkdirSync(join(workspacePath, ".interf"), { recursive: true });
+    mkdirSync(workspaceRuntimeRoot(workspacePath), { recursive: true });
     writeFileSync(planPath, JSON.stringify(plan, null, 2) + "\n");
     return planPath;
 }
@@ -119,4 +120,3 @@ function defaultSummaryPath(sourcePath) {
     const replaced = sourcePath.replace(/\.[^.]+$/, ".md");
     return `summaries/${replaced === sourcePath ? `${sourcePath}.md` : replaced}`;
 }
-//# sourceMappingURL=summarize-plan.js.map

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

@@ -0,0 +1,14 @@
+import { type WorkflowExecutor } from "./executors.js";
+import type { TestTargetRun, TestTargetCandidate, LoadedTestSpec } from "./test-types.js";
+import { type TestSandboxRetentionMode } from "./test-sandbox.js";
+export declare function runTargetTests(sourcePath: string, spec: LoadedTestSpec, targets: TestTargetCandidate[]): TestTargetRun;
+export declare function runTargetTestsWithJudge(sourcePath: string, spec: LoadedTestSpec, targets: TestTargetCandidate[], executor: WorkflowExecutor, options?: {
+    preserveSandboxes?: TestSandboxRetentionMode;
+    artifactRootPath?: string;
+}): Promise<TestTargetRun>;
+export declare function runTargetTestsAuto(sourcePath: string, spec: LoadedTestSpec, targets: TestTargetCandidate[], options?: {
+    executor?: WorkflowExecutor | null;
+    preserveSandboxes?: TestSandboxRetentionMode;
+    artifactRootPath?: string;
+}): Promise<TestTargetRun>;
+export declare function saveTargetTestRun(artifactRootPath: string, result: TestTargetRun): string;