@interf/compiler 0.22.0 → 0.33.0

package/dist/packages/runtime/build/context-graph-paths.js

@@ -0,0 +1,133 @@
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
+import { CONTEXT_GRAPH_BUILD_PLAN_DIR as SHARED_CONTEXT_GRAPH_BUILD_PLAN_DIR, CONTEXT_GRAPH_RUNTIME_DIR as SHARED_CONTEXT_GRAPH_RUNTIME_DIR, CONTEXT_GRAPH_STATE_DIR, CONTEXT_GRAPH_TESTS_DIR, CONTEXT_GRAPHS_DIR, PROJECT_CONFIG_FILENAME, } from "../../contracts/lib/project-paths.js";
+export const CONTEXT_GRAPH_INTERF_DIR = CONTEXT_GRAPH_STATE_DIR;
+export const CONTEXT_GRAPH_CONFIG_FILE = PROJECT_CONFIG_FILENAME;
+export const CONTEXT_GRAPH_BUILD_PLAN_DIR = SHARED_CONTEXT_GRAPH_BUILD_PLAN_DIR;
+export const CONTEXT_GRAPH_TEST_DIR = CONTEXT_GRAPH_TESTS_DIR;
+export const CONTEXT_GRAPH_TEST_TARGETS_DIR = "targets";
+export const CONTEXT_GRAPH_RUNTIME_DIR = SHARED_CONTEXT_GRAPH_RUNTIME_DIR;
+export const CONTEXT_GRAPH_RUNTIME_STATE_FILE = "state.json";
+export const CONTEXT_GRAPH_RUNTIME_HEALTH_FILE = "health.json";
+export const CONTEXT_GRAPH_RUNTIME_VIEW_SPEC_FILE = "view-spec.json";
+export const CONTEXT_GRAPH_RUNTIME_SOURCE_MANIFEST_FILE = "source-manifest.json";
+export const CONTEXT_GRAPH_RUNTIME_SOURCE_MANIFEST_AUDIT_FILE = "source-manifest.audit.json";
+export const CONTEXT_GRAPH_RUNTIME_SOURCE_FILES_FILE = "source-files.json";
+export const CONTEXT_GRAPH_RUNTIME_SOURCE_STATE_FILE = "source-state.json";
+export const CONTEXT_GRAPH_RUNTIME_STAGE_INPUTS_DIR = "stages";
+export const CONTEXT_GRAPH_RUNTIME_STAGE_INPUTS_FILE = "inputs.json";
+export const CONTEXT_GRAPH_RUNTIME_INVENTORY_FILE = "inventory.json";
+export const CONTEXT_GRAPH_RUNTIME_RUN_FILE = "run.json";
+export const CONTEXT_GRAPH_RUNTIME_RUN_HISTORY_FILE = "run-history.jsonl";
+export const CONTEXT_GRAPH_RUNTIME_STAGE_CONTRACT_FILE = "stage-contract.json";
+export function contextGraphRuntimeRoot(contextGraphPath) {
+    return join(contextGraphPath, CONTEXT_GRAPH_INTERF_DIR, CONTEXT_GRAPH_RUNTIME_DIR);
+}
+export function contextGraphRuntimeFilePath(contextGraphPath, fileName) {
+    return join(contextGraphRuntimeRoot(contextGraphPath), fileName);
+}
+export function contextGraphInterfRoot(contextGraphPath) {
+    return join(contextGraphPath, CONTEXT_GRAPH_INTERF_DIR);
+}
+export function contextGraphInterfConfigPath(contextGraphPath) {
+    return join(contextGraphInterfRoot(contextGraphPath), CONTEXT_GRAPH_CONFIG_FILE);
+}
+export function buildPlanPackagePathForContextGraph(contextGraphPath) {
+    return join(contextGraphInterfRoot(contextGraphPath), CONTEXT_GRAPH_BUILD_PLAN_DIR);
+}
+export function testRootForContextGraph(contextGraphPath) {
+    return join(contextGraphInterfRoot(contextGraphPath), CONTEXT_GRAPH_TEST_DIR);
+}
+export function testTargetsRootForContextGraph(contextGraphPath) {
+    return join(testRootForContextGraph(contextGraphPath), CONTEXT_GRAPH_TEST_TARGETS_DIR);
+}
+export function stageExecutionShellsRoot(contextGraphPath) {
+    return join(contextGraphRuntimeRoot(contextGraphPath), "execution-shells");
+}
+export function buildPlanImprovementLoopsRoot(contextGraphPath) {
+    return join(contextGraphRuntimeRoot(contextGraphPath), "improvement-loops");
+}
+export function buildPlanImprovementRunRoot(contextGraphPath, runId) {
+    return join(buildPlanImprovementLoopsRoot(contextGraphPath), runId);
+}
+export function buildPlanImprovementLoopRoot(contextGraphPath, runId, loopIndex) {
+    return join(buildPlanImprovementRunRoot(contextGraphPath, runId), `loop-${String(loopIndex).padStart(2, "0")}`);
+}
+export function targetTestRunsRootForContextGraph(contextGraphPath) {
+    return join(testTargetsRootForContextGraph(contextGraphPath), "runs");
+}
+export function targetTestSandboxesRootForContextGraph(contextGraphPath) {
+    return join(testTargetsRootForContextGraph(contextGraphPath), "sandboxes");
+}
+export function contextGraphRuntimeLogsRoot(contextGraphPath) {
+    return join(contextGraphRuntimeRoot(contextGraphPath), "logs");
+}
+export function contextGraphRuntimeArchivedStageContractPath(contextGraphPath, runId) {
+    return join(contextGraphRuntimeLogsRoot(contextGraphPath), `${runId}.stage-contract.json`);
+}
+export function contextGraphQueryAcceptanceRoot(contextGraphPath) {
+    return join(contextGraphRuntimeRoot(contextGraphPath), "query-acceptance");
+}
+export function contextGraphRuntimeStatePath(contextGraphPath) {
+    return contextGraphRuntimeFilePath(contextGraphPath, CONTEXT_GRAPH_RUNTIME_STATE_FILE);
+}
+export function contextGraphRuntimeHealthPath(contextGraphPath) {
+    return contextGraphRuntimeFilePath(contextGraphPath, CONTEXT_GRAPH_RUNTIME_HEALTH_FILE);
+}
+export function contextGraphRuntimeViewSpecPath(contextGraphPath) {
+    return contextGraphRuntimeFilePath(contextGraphPath, CONTEXT_GRAPH_RUNTIME_VIEW_SPEC_FILE);
+}
+export function contextGraphRuntimeSourceManifestPath(contextGraphPath) {
+    return contextGraphRuntimeFilePath(contextGraphPath, CONTEXT_GRAPH_RUNTIME_SOURCE_MANIFEST_FILE);
+}
+export function contextGraphRuntimeSourceManifestAuditPath(contextGraphPath) {
+    return contextGraphRuntimeFilePath(contextGraphPath, CONTEXT_GRAPH_RUNTIME_SOURCE_MANIFEST_AUDIT_FILE);
+}
+export function contextGraphRuntimeSourceFilesPath(contextGraphPath) {
+    return contextGraphRuntimeFilePath(contextGraphPath, CONTEXT_GRAPH_RUNTIME_SOURCE_FILES_FILE);
+}
+export function contextGraphRuntimeSourceStatePath(contextGraphPath) {
+    return contextGraphRuntimeFilePath(contextGraphPath, CONTEXT_GRAPH_RUNTIME_SOURCE_STATE_FILE);
+}
+export function contextGraphRuntimeStagesRoot(contextGraphPath) {
+    return join(contextGraphRuntimeRoot(contextGraphPath), CONTEXT_GRAPH_RUNTIME_STAGE_INPUTS_DIR);
+}
+export function contextGraphRuntimeStageRoot(contextGraphPath, stageId) {
+    return join(contextGraphRuntimeStagesRoot(contextGraphPath), stageId);
+}
+export function contextGraphRuntimeStageInputsPath(contextGraphPath, stageId) {
+    return join(contextGraphRuntimeStageRoot(contextGraphPath, stageId), CONTEXT_GRAPH_RUNTIME_STAGE_INPUTS_FILE);
+}
+export function contextGraphExecutionInventoryPath(contextGraphPath) {
+    return contextGraphRuntimeFilePath(contextGraphPath, CONTEXT_GRAPH_RUNTIME_INVENTORY_FILE);
+}
+export function contextGraphExecutionStageLedgerPath(contextGraphPath) {
+    return contextGraphRuntimeFilePath(contextGraphPath, CONTEXT_GRAPH_RUNTIME_RUN_FILE);
+}
+export function contextGraphExecutionStageLedgerHistoryPath(contextGraphPath) {
+    return contextGraphRuntimeFilePath(contextGraphPath, CONTEXT_GRAPH_RUNTIME_RUN_HISTORY_FILE);
+}
+export function contextGraphRuntimeStageContractPath(contextGraphPath) {
+    return contextGraphRuntimeFilePath(contextGraphPath, CONTEXT_GRAPH_RUNTIME_STAGE_CONTRACT_FILE);
+}
+export function resolveSourceControlPathForContextGraph(contextGraphPath) {
+    // Legacy Project-level graphs live at `<project-data-dir>/<project>`.
+    // Isolated Build Run graphs live at `<project-data-dir>/graphs/<run-id>`.
+    // Both layouts share the same Project data root for config, Build Plans,
+    // runs, and source binding.
+    const contextGraphAbsolute = resolve(contextGraphPath);
+    const parent = dirname(contextGraphAbsolute);
+    if (parent === contextGraphAbsolute) {
+        throw new Error(`Context Graph is not under the canonical Interf Project data layout: ${contextGraphPath}`);
+    }
+    if (basename(parent) === "interf") {
+        throw new Error(`Context Graph is not under the canonical Interf Project data layout: ${contextGraphPath}`);
+    }
+    if (basename(parent) === CONTEXT_GRAPHS_DIR) {
+        return dirname(parent);
+    }
+    return parent;
+}
+export function defaultControlPathForContextGraph(contextGraphPath) {
+    const relativePath = relative(contextGraphPath, resolveSourceControlPathForContextGraph(contextGraphPath));
+    return relativePath.length > 0 ? relativePath.split(sep).join("/") : ".";
+}

package/dist/packages/runtime/build/context-graph-schema.d.ts

@@ -0,0 +1,19 @@
+import { buildContextInterface, contextInterfaceArtifactAbsolutePath, contextInterfaceArtifactPath, contextInterfaceExists, contextInterfaceFilePath, listContextInterfaceArtifacts, readContextInterface, resolveContextInterfacePath, writeContextInterface, writeContextInterfaceFile } from "../../build-plans/package/context-interface.js";
+import type { ContextInterface as BuildPlanContextSchema, ContextInterfaceArtifact as BuildPlanArtifact, ContextInterfaceArtifactId as BuildPlanArtifactId } from "../../build-plans/package/context-interface.js";
+export declare const BUILD_PLAN_SCHEMA_FILE = "build-plan.schema.json";
+export declare const buildPlanSchemaFilePath: typeof contextInterfaceFilePath;
+export declare const resolveBuildPlanSchemaPath: typeof resolveContextInterfacePath;
+export declare const buildPlanSchemaExists: typeof contextInterfaceExists;
+export declare const listBuildPlanContextArtifacts: typeof listContextInterfaceArtifacts;
+export declare const contextGraphArtifactAbsolutePath: typeof contextInterfaceArtifactAbsolutePath;
+export declare const contextGraphArtifactPath: typeof contextInterfaceArtifactPath;
+export declare const buildBuildPlanContextSchema: typeof buildContextInterface;
+export declare const writeBuildPlanContextSchemaFile: typeof writeContextInterfaceFile;
+export declare const writeBuildPlanContextSchemaDocument: typeof writeContextInterface;
+export declare const readBuildPlanContextSchemaFile: typeof readContextInterface;
+export declare const readBuildPlanContextFile: typeof readContextInterface;
+export type { BuildPlanContextSchema, BuildPlanArtifact, BuildPlanArtifactId, };
+export declare function buildPlanSchemaRelativePath(): string;
+export declare function findBuildPlanContextArtifact(schema: BuildPlanContextSchema, artifactId: BuildPlanArtifactId): BuildPlanArtifact | null;
+export declare function contextGraphArtifactPathsForArtifactIds(schema: BuildPlanContextSchema, artifactIds: readonly BuildPlanArtifactId[]): string[];
+export declare function ensureBuildPlanArtifactTargets(contextGraphPath: string, schema: BuildPlanContextSchema): void;

package/dist/packages/runtime/build/context-graph-schema.js

@@ -0,0 +1,39 @@
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { CONTEXT_INTERFACE_FILE, buildContextInterface, contextInterfaceArtifactAbsolutePath, contextInterfaceArtifactPath, contextInterfaceExists, contextInterfaceFilePath, listContextInterfaceArtifacts, readContextInterface, resolveContextInterfacePath, writeContextInterface, writeContextInterfaceFile, } from "../../build-plans/package/context-interface.js";
+export const BUILD_PLAN_SCHEMA_FILE = CONTEXT_INTERFACE_FILE;
+export const buildPlanSchemaFilePath = contextInterfaceFilePath;
+export const resolveBuildPlanSchemaPath = resolveContextInterfacePath;
+export const buildPlanSchemaExists = contextInterfaceExists;
+export const listBuildPlanContextArtifacts = listContextInterfaceArtifacts;
+export const contextGraphArtifactAbsolutePath = contextInterfaceArtifactAbsolutePath;
+export const contextGraphArtifactPath = contextInterfaceArtifactPath;
+export const buildBuildPlanContextSchema = buildContextInterface;
+export const writeBuildPlanContextSchemaFile = writeContextInterfaceFile;
+export const writeBuildPlanContextSchemaDocument = writeContextInterface;
+export const readBuildPlanContextSchemaFile = readContextInterface;
+export const readBuildPlanContextFile = readContextInterface;
+export function buildPlanSchemaRelativePath() {
+    return `build-plan/${BUILD_PLAN_SCHEMA_FILE}`;
+}
+export function findBuildPlanContextArtifact(schema, artifactId) {
+    return listBuildPlanContextArtifacts(schema).find((artifact) => artifact.id === artifactId) ?? null;
+}
+export function contextGraphArtifactPathsForArtifactIds(schema, artifactIds) {
+    return artifactIds.map((artifactId) => {
+        const artifact = findBuildPlanContextArtifact(schema, artifactId);
+        if (!artifact) {
+            throw new Error(`Build Plan schema is missing declared Artifact "${artifactId}".`);
+        }
+        return contextGraphArtifactPath(artifact);
+    });
+}
+export function ensureBuildPlanArtifactTargets(contextGraphPath, schema) {
+    for (const artifact of listBuildPlanContextArtifacts(schema)) {
+        if (artifact.kind === "directory") {
+            mkdirSync(contextGraphArtifactAbsolutePath(contextGraphPath, artifact), { recursive: true });
+            continue;
+        }
+        mkdirSync(dirname(contextGraphArtifactAbsolutePath(contextGraphPath, artifact)), { recursive: true });
+    }
+}

package/dist/packages/{engine → runtime}/build/discovery.d.ts

@@ -3,5 +3,5 @@ export interface DiscoveryResult {
     totalCount: number;
     ignoredCount: number;
 }
-export declare function discoverSourceFiles(sourcePath: string, verifiableContextPath: string): DiscoveryResult;
-export declare function loadIgnorePatterns(verifiableContextPath: string): string[];
+export declare function discoverSourceFiles(sourcePath: string, contextGraphPath: string): DiscoveryResult;
+export declare function loadIgnorePatterns(contextGraphPath: string): string[];

package/dist/packages/{engine → runtime}/build/discovery.js

@@ -12,8 +12,8 @@ const DEFAULT_IGNORE_DIRS = new Set([
 const DEFAULT_IGNORE_FILES = new Set([
     "interf.json",
 ]);
-export function discoverSourceFiles(sourcePath, verifiableContextPath) {
-    const userPatterns = loadIgnorePatterns(verifiableContextPath);
+export function discoverSourceFiles(sourcePath, contextGraphPath) {
+    const userPatterns = loadIgnorePatterns(contextGraphPath);
     let ignoredCount = 0;
     const allFiles = listFilesRecursive(sourcePath, (filePath) => {
         const rel = relative(sourcePath, filePath);
@@ -36,8 +36,8 @@ export function discoverSourceFiles(sourcePath, verifiableContextPath) {
         ignoredCount,
     };
 }
-export function loadIgnorePatterns(verifiableContextPath) {
-    const ignorePath = join(verifiableContextPath, ".interfignore");
+export function loadIgnorePatterns(contextGraphPath) {
+    const ignorePath = join(contextGraphPath, ".interfignore");
     if (!existsSync(ignorePath))
         return [];
     return readFileSync(ignorePath, "utf-8")

package/dist/packages/{engine → runtime}/build/index.d.ts

@@ -1,7 +1,8 @@
 export * as primitives from "./build-plan-primitives.js";
 export * as schema from "./lib/schema.js";
-export * as verifiableContextSchema from "./verifiable-context-schema.js";
+export * as contextGraphSchema from "./context-graph-schema.js";
 export * as buildExecution from "./build-execution.js";
+export * as buildEvidence from "./build-evidence.js";
 export * as runtime from "./runtime.js";
 export * as runtimeContracts from "./runtime-contracts.js";
 export * as runtimeInventory from "./runtime-inventory.js";
@@ -11,6 +12,8 @@ export * as runtimeReconcile from "./runtime-reconcile.js";
 export * as runtimeRuns from "./runtime-runs.js";
 export * as runtimeTypes from "./runtime-types.js";
 export * as sourceFiles from "./source-files.js";
+export * as sourceManifest from "./source-manifest.js";
+export * as stageEvidence from "./stage-evidence.js";
 export * as state from "./state.js";
 export * as stateArtifacts from "./state-artifacts.js";
 export * as stateHealth from "./state-health.js";
@@ -18,7 +21,6 @@ export * as stateIo from "./state-io.js";
 export * as statePaths from "./state-paths.js";
 export * as stateView from "./state-view.js";
 export * as validate from "./validate.js";
-export * as validateVerifiableContextSetup from "./validate-verifiable-context.js";
-export * as validateHelpers from "./validate-helpers.js";
+export * as validateContextGraphSetup from "./validate-context-graph.js";
 export * as buildPlanRuns from "./build-plan-runs.js";
 export type { BuildResult, BuildSummarizeResult, StageShellRetentionMode, } from "./build-plan-runs.js";

package/dist/packages/{engine → runtime}/build/index.js

@@ -1,7 +1,8 @@
 export * as primitives from "./build-plan-primitives.js";
 export * as schema from "./lib/schema.js";
-export * as verifiableContextSchema from "./verifiable-context-schema.js";
+export * as contextGraphSchema from "./context-graph-schema.js";
 export * as buildExecution from "./build-execution.js";
+export * as buildEvidence from "./build-evidence.js";
 export * as runtime from "./runtime.js";
 export * as runtimeContracts from "./runtime-contracts.js";
 export * as runtimeInventory from "./runtime-inventory.js";
@@ -11,6 +12,8 @@ export * as runtimeReconcile from "./runtime-reconcile.js";
 export * as runtimeRuns from "./runtime-runs.js";
 export * as runtimeTypes from "./runtime-types.js";
 export * as sourceFiles from "./source-files.js";
+export * as sourceManifest from "./source-manifest.js";
+export * as stageEvidence from "./stage-evidence.js";
 export * as state from "./state.js";
 export * as stateArtifacts from "./state-artifacts.js";
 export * as stateHealth from "./state-health.js";
@@ -18,6 +21,5 @@ export * as stateIo from "./state-io.js";
 export * as statePaths from "./state-paths.js";
 export * as stateView from "./state-view.js";
 export * as validate from "./validate.js";
-export * as validateVerifiableContextSetup from "./validate-verifiable-context.js";
-export * as validateHelpers from "./validate-helpers.js";
+export * as validateContextGraphSetup from "./validate-context-graph.js";
 export * as buildPlanRuns from "./build-plan-runs.js";