@interf/compiler 0.4.0 → 0.5.0

package/dist/lib/workspace-paths.js

@@ -1,107 +0,0 @@
-import { basename, dirname, join, relative, resolve, sep } from "node:path";
-export const WORKSPACE_INTERF_DIR = ".interf";
-export const WORKSPACE_CONFIG_FILE = "interf.json";
-export const WORKSPACE_WORKFLOW_DIR = "workflow";
-export const WORKSPACE_TEST_DIR = "tests";
-export const WORKSPACE_TEST_TARGETS_DIR = "targets";
-export const WORKSPACE_RUNTIME_DIR = "runtime";
-export const WORKSPACE_RUNTIME_STATE_FILE = "state.json";
-export const WORKSPACE_RUNTIME_HEALTH_FILE = "health.json";
-export const WORKSPACE_RUNTIME_VIEW_SPEC_FILE = "view-spec.json";
-export const WORKSPACE_RUNTIME_RAW_SNAPSHOT_FILE = "raw-snapshot.json";
-export const WORKSPACE_RUNTIME_INVENTORY_FILE = "inventory.json";
-export const WORKSPACE_RUNTIME_RUN_FILE = "run.json";
-export const WORKSPACE_RUNTIME_RUN_HISTORY_FILE = "run-history.jsonl";
-export const WORKSPACE_RUNTIME_STAGE_CONTRACT_FILE = "stage-contract.json";
-export function workspaceRuntimeRoot(workspacePath) {
-    return join(workspacePath, WORKSPACE_INTERF_DIR, WORKSPACE_RUNTIME_DIR);
-}
-export function workspaceRuntimeFilePath(workspacePath, fileName) {
-    return join(workspaceRuntimeRoot(workspacePath), fileName);
-}
-export function workspaceInterfRoot(workspacePath) {
-    return join(workspacePath, WORKSPACE_INTERF_DIR);
-}
-export function workspaceInterfConfigPath(workspacePath) {
-    return join(workspaceInterfRoot(workspacePath), WORKSPACE_CONFIG_FILE);
-}
-export function workflowPackagePathForWorkspace(workspacePath) {
-    return join(workspaceInterfRoot(workspacePath), WORKSPACE_WORKFLOW_DIR);
-}
-export function testRootForWorkspace(workspacePath) {
-    return join(workspaceInterfRoot(workspacePath), WORKSPACE_TEST_DIR);
-}
-export function testRunsRootForWorkspace(workspacePath) {
-    return join(testRootForWorkspace(workspacePath), "runs");
-}
-export function testTargetsRootForWorkspace(workspacePath) {
-    return join(testRootForWorkspace(workspacePath), WORKSPACE_TEST_TARGETS_DIR);
-}
-export function latestTestComparisonPathForWorkspace(workspacePath) {
-    return join(testRootForWorkspace(workspacePath), "latest.json");
-}
-export function stageExecutionShellsRoot(workspacePath) {
-    return join(workspaceRuntimeRoot(workspacePath), "execution-shells");
-}
-export function workflowImprovementLoopsRoot(workspacePath) {
-    return join(workspaceRuntimeRoot(workspacePath), "improvement-loops");
-}
-export function workflowImprovementRunRoot(workspacePath, runId) {
-    return join(workflowImprovementLoopsRoot(workspacePath), runId);
-}
-export function workflowImprovementLoopRoot(workspacePath, runId, loopIndex) {
-    return join(workflowImprovementRunRoot(workspacePath, runId), `loop-${String(loopIndex).padStart(2, "0")}`);
-}
-export function targetTestRunsRootForWorkspace(workspacePath) {
-    return join(testTargetsRootForWorkspace(workspacePath), "runs");
-}
-export function targetTestSandboxesRootForWorkspace(workspacePath) {
-    return join(testTargetsRootForWorkspace(workspacePath), "sandboxes");
-}
-export function workspaceRuntimeLogsRoot(workspacePath) {
-    return join(workspaceRuntimeRoot(workspacePath), "logs");
-}
-export function workspaceQueryAcceptanceRoot(workspacePath) {
-    return join(workspaceRuntimeRoot(workspacePath), "query-acceptance");
-}
-export function workspaceRuntimeStatePath(workspacePath) {
-    return workspaceRuntimeFilePath(workspacePath, WORKSPACE_RUNTIME_STATE_FILE);
-}
-export function workspaceRuntimeHealthPath(workspacePath) {
-    return workspaceRuntimeFilePath(workspacePath, WORKSPACE_RUNTIME_HEALTH_FILE);
-}
-export function workspaceRuntimeViewSpecPath(workspacePath) {
-    return workspaceRuntimeFilePath(workspacePath, WORKSPACE_RUNTIME_VIEW_SPEC_FILE);
-}
-export function workspaceRawSnapshotMetadataPath(workspacePath) {
-    return workspaceRuntimeFilePath(workspacePath, WORKSPACE_RUNTIME_RAW_SNAPSHOT_FILE);
-}
-export function workspaceRuntimeInventoryPath(workspacePath) {
-    return workspaceRuntimeFilePath(workspacePath, WORKSPACE_RUNTIME_INVENTORY_FILE);
-}
-export function workspaceRuntimeRunPath(workspacePath) {
-    return workspaceRuntimeFilePath(workspacePath, WORKSPACE_RUNTIME_RUN_FILE);
-}
-export function workspaceRuntimeRunHistoryPath(workspacePath) {
-    return workspaceRuntimeFilePath(workspacePath, WORKSPACE_RUNTIME_RUN_HISTORY_FILE);
-}
-export function workspaceRuntimeStageContractPath(workspacePath) {
-    return workspaceRuntimeFilePath(workspacePath, WORKSPACE_RUNTIME_STAGE_CONTRACT_FILE);
-}
-export function resolveSourceControlPathForWorkspace(workspacePath) {
-    let cursor = resolve(workspacePath);
-    while (true) {
-        const parent = dirname(cursor);
-        if (parent === cursor)
-            break;
-        if (basename(parent) === "workspaces" && basename(dirname(parent)) === "interf") {
-            return dirname(dirname(parent));
-        }
-        cursor = parent;
-    }
-    return resolve(workspacePath, "..", "..", "..");
-}
-export function defaultControlPathForWorkspace(workspacePath) {
-    const relativePath = relative(workspacePath, resolveSourceControlPathForWorkspace(workspacePath));
-    return relativePath.length > 0 ? relativePath.split(sep).join("/") : ".";
-}

package/dist/lib/workspace-reset.d.ts

@@ -1 +0,0 @@
-export declare function resetWorkspaceGeneratedState(workspacePath: string, scope?: "compile" | "all"): void;

package/dist/lib/workspace-reset.js

@@ -1,43 +0,0 @@
-import { existsSync, rmSync } from "node:fs";
-import { join } from "node:path";
-import { initWorkspaceState, refreshWorkspaceArtifacts, saveState, } from "./state.js";
-import { saveEmptyWorkspaceInventory } from "./state-io.js";
-import { stageExecutionShellsRoot, testRootForWorkspace, testTargetsRootForWorkspace, workflowImprovementLoopsRoot, workspaceQueryAcceptanceRoot, workspaceRuntimeRoot, workspaceRuntimeLogsRoot, } from "./workspace-paths.js";
-function removeIfExists(path) {
-    if (existsSync(path)) {
-        rmSync(path, { recursive: true, force: true });
-    }
-}
-const COMPILE_RUNTIME_RESET_ENTRIES = [
-    "state.json",
-    "health.json",
-    "view-spec.json",
-    "inventory.json",
-    "run.json",
-    "stage-contract.json",
-    "summarize-targets.json",
-];
-function resetWorkspaceRuntimeFiles(workspacePath) {
-    const runtimeRoot = workspaceRuntimeRoot(workspacePath);
-    for (const entry of COMPILE_RUNTIME_RESET_ENTRIES) {
-        removeIfExists(join(runtimeRoot, entry));
-    }
-    removeIfExists(workspaceQueryAcceptanceRoot(workspacePath));
-}
-export function resetWorkspaceGeneratedState(workspacePath, scope = "compile") {
-    removeIfExists(join(workspacePath, "summaries"));
-    removeIfExists(join(workspacePath, "knowledge"));
-    removeIfExists(join(workspacePath, ".obsidian"));
-    resetWorkspaceRuntimeFiles(workspacePath);
-    saveState(workspacePath, initWorkspaceState());
-    saveEmptyWorkspaceInventory(workspacePath);
-    refreshWorkspaceArtifacts(workspacePath, { ensureViewSpec: true });
-    if (scope === "all") {
-        removeIfExists(stageExecutionShellsRoot(workspacePath));
-        removeIfExists(workflowImprovementLoopsRoot(workspacePath));
-        removeIfExists(workspaceRuntimeLogsRoot(workspacePath));
-        removeIfExists(join(workspaceRuntimeRoot(workspacePath), "run-history.jsonl"));
-        removeIfExists(testRootForWorkspace(workspacePath));
-        removeIfExists(testTargetsRootForWorkspace(workspacePath));
-    }
-}

package/dist/lib/workspace-schema.d.ts

@@ -1,17 +0,0 @@
-import { type RuntimeContractType, type WorkflowWorkspaceSchema, type WorkflowWorkspaceZone, type WorkflowZoneId } from "./schema.js";
-export interface WorkflowSchemaStageLike {
-    id: string;
-    contractType?: RuntimeContractType;
-    contract_type?: RuntimeContractType;
-}
-export { BUILTIN_WORKSPACE_ZONE_IDS } from "./workflow-abi.js";
-export declare const WORKSPACE_SCHEMA_FILE = "workspace.schema.json";
-export declare function workspaceSchemaFilePath(rootPath: string): string;
-export declare function workspaceSchemaRelativePath(): string;
-export declare function listWorkspaceSchemaZones(schema: WorkflowWorkspaceSchema): WorkflowWorkspaceZone[];
-export declare function findWorkspaceSchemaZone(schema: WorkflowWorkspaceSchema, zoneId: WorkflowZoneId): WorkflowWorkspaceZone | null;
-export declare function workspaceZoneAbsolutePath(workspacePath: string, zone: Pick<WorkflowWorkspaceZone, "path">): string;
-export declare function ensureWorkspaceZoneTargets(workspacePath: string, schema: WorkflowWorkspaceSchema): void;
-export declare function buildWorkspaceSchema(stages: WorkflowSchemaStageLike[], label?: string): WorkflowWorkspaceSchema;
-export declare function writeWorkspaceSchemaFile(rootPath: string, stages: WorkflowSchemaStageLike[], label?: string): WorkflowWorkspaceSchema;
-export declare function readWorkspaceSchemaFile(rootPath: string): WorkflowWorkspaceSchema | null;

package/dist/lib/workspace-schema.js

@@ -1,74 +0,0 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { readJsonFileWithSchema } from "./parse.js";
-import { listBuiltinWorkspaceZoneSpecs, requiredWorkspaceZoneOwners, } from "./workflow-abi.js";
-import { WorkflowWorkspaceSchemaSchema, } from "./schema.js";
-export { BUILTIN_WORKSPACE_ZONE_IDS } from "./workflow-abi.js";
-export const WORKSPACE_SCHEMA_FILE = "workspace.schema.json";
-export function workspaceSchemaFilePath(rootPath) {
-    return join(rootPath, WORKSPACE_SCHEMA_FILE);
-}
-export function workspaceSchemaRelativePath() {
-    return `workflow/${WORKSPACE_SCHEMA_FILE}`;
-}
-export function listWorkspaceSchemaZones(schema) {
-    return [...schema.zones];
-}
-export function findWorkspaceSchemaZone(schema, zoneId) {
-    return schema.zones.find((zone) => zone.id === zoneId) ?? null;
-}
-export function workspaceZoneAbsolutePath(workspacePath, zone) {
-    return join(workspacePath, zone.path);
-}
-export function ensureWorkspaceZoneTargets(workspacePath, schema) {
-    for (const zone of schema.zones) {
-        if (zone.kind === "directory" || zone.kind === "runtime") {
-            mkdirSync(workspaceZoneAbsolutePath(workspacePath, zone), { recursive: true });
-            continue;
-        }
-        mkdirSync(dirname(workspaceZoneAbsolutePath(workspacePath, zone)), { recursive: true });
-    }
-}
-function stageContractType(stage) {
-    return (stage.contractType ?? stage.contract_type);
-}
-function pushZone(zones, zone) {
-    if (zones.some((existing) => existing.path === zone.path))
-        return;
-    zones.push(zone);
-}
-export function buildWorkspaceSchema(stages, label = "Compiled workspace schema") {
-    const zones = [];
-    const normalizedStages = stages.map((stage) => ({
-        id: stage.id,
-        contractType: stageContractType(stage),
-    }));
-    for (const zone of listBuiltinWorkspaceZoneSpecs()) {
-        pushZone(zones, {
-            id: zone.id,
-            path: zone.path,
-            kind: zone.kind,
-            required: zone.required,
-            owned_by: requiredWorkspaceZoneOwners(normalizedStages, zone.id),
-            description: zone.description,
-        });
-    }
-    return {
-        kind: "workspace-schema",
-        version: 1,
-        target_type: "workspace",
-        label,
-        zones,
-    };
-}
-export function writeWorkspaceSchemaFile(rootPath, stages, label) {
-    const schema = buildWorkspaceSchema(stages, label);
-    writeFileSync(workspaceSchemaFilePath(rootPath), `${JSON.stringify(schema, null, 2)}\n`);
-    return schema;
-}
-export function readWorkspaceSchemaFile(rootPath) {
-    const path = workspaceSchemaFilePath(rootPath);
-    if (!existsSync(path))
-        return null;
-    return readJsonFileWithSchema(path, "workspace schema", WorkflowWorkspaceSchemaSchema);
-}