@interf/compiler 0.22.2 → 0.50.0

package/dist/packages/engine/cloud-seams.js

@@ -1,84 +0,0 @@
-/**
- * 0.17 — interface seams for the future cloud variant.
- *
- * These types document the injection points a cloud variant of the
- * engine slots into without forking. The local binary keeps its
- * in-process implementations (private `Map` fields on the runtime,
- * the per-instance bearer-token check in `server.ts`); cloud variants
- * provide their own implementations and pass them through
- * `startLocalService` / `LocalServiceRuntimeOptions`.
- *
- * Each seam below is paired with a `TODO(cloud)` marker at the
- * concrete call site so the cloud variant has a clear "wire this
- * through" landing pad. Local default behavior is unchanged in 0.17.
- */
-// ───────────────────────────────────────────────────────────────────────────
-// Local default implementations
-//
-// These wrap in-process Maps and satisfy the interfaces above so the
-// runtime can inject either a local default (current behavior) or a
-// cloud override (Redis-shaped store, shared lease, etc) without
-// branching on the deployment.
-// ───────────────────────────────────────────────────────────────────────────
-export class InMemoryIdempotencyStore {
-    buckets = new Map();
-    get(scope, key) {
-        return this.buckets.get(scope)?.get(key) ?? null;
-    }
-    set(scope, key, value) {
-        let bucket = this.buckets.get(scope);
-        if (!bucket) {
-            bucket = new Map();
-            this.buckets.set(scope, bucket);
-        }
-        bucket.set(key, value);
-    }
-    delete(scope, key) {
-        const bucket = this.buckets.get(scope);
-        if (!bucket)
-            return;
-        bucket.delete(key);
-        if (bucket.size === 0)
-            this.buckets.delete(scope);
-    }
-    prune(now) {
-        for (const [scope, bucket] of this.buckets) {
-            for (const [key, value] of bucket) {
-                if (value.expiresAt < now)
-                    bucket.delete(key);
-            }
-            if (bucket.size === 0)
-                this.buckets.delete(scope);
-        }
-    }
-    size() {
-        let total = 0;
-        for (const bucket of this.buckets.values())
-            total += bucket.size;
-        return total;
-    }
-}
-export class InMemoryRunLeaseStore {
-    leases = new Map();
-    acquire(runId, lease) {
-        this.leases.set(runId, lease);
-    }
-    release(runId) {
-        this.leases.delete(runId);
-    }
-    get(runId) {
-        return this.leases.get(runId) ?? null;
-    }
-    markCancelled(runId) {
-        const lease = this.leases.get(runId);
-        if (!lease)
-            return;
-        lease.cancelled = true;
-        lease.cancelledAt = new Date().toISOString();
-    }
-    *listActive() {
-        for (const [runId, lease] of this.leases) {
-            yield { runId, lease };
-        }
-    }
-}

package/dist/packages/engine/index.d.ts

@@ -1,22 +0,0 @@
-export * as schema from "./lib/schema.js";
-export * as actionValues from "./action-values.js";
-export * as actionDefinitions from "./action-definitions.js";
-export * as routes from "./routes.js";
-export * as client from "./client.js";
-export * as runtime from "./runtime.js";
-export * as server from "./server.js";
-export type { BuildRunCreateRequest, BuildRunResource, BuildRunSummary, LocalServiceDiscovery, VerifiableContextMapping, PreparationRunLinkage, PreparationResource, PreparationWireShape, BuildPlanResource, LocalJobAgent, LocalJobEvent, LocalJobEventAppendRequest, LocalJobEventType, LocalJobRunCreateRequest, LocalJobRunResource, LocalJobStatus, LocalRunHandlerResult, LocalJobStep, LocalJobType, LocalServiceConfig, LocalServiceError, LocalServiceHealth, LocalExecutorStatus, ActionClientOrigin, ActionProposalApproval, ActionProposalApprovalRequest, ActionProposalCreateRequest, ActionProposalListResponse, ActionProposalPlan, ActionProposalPlanActionType, ActionProposalResource, ActionProposalStatus, ActionProposalType, BuildPlanChangeResult, PreparationChangeResult, PreparationSetupResult, ResetRequest, ResetResult, VerifiableContextResource, ReadinessResource, SourceFileResource, ReadinessCheckDraftCreateRequest, ReadinessCheckDraftResult, VerifyRunCreateRequest, VerifyRunResource, VerifyRunStatus, RunObservabilityListResponse, RunObservabilityResource, BuildPlanAuthoringCreateRequest, BuildPlanAuthoringResult, PreparationListResponse, BuildPlanListResponse, VerifiableContextListResponse, BuildRunListResponse, SourceFileListResponse, OpenPathRequest, OpenPathResponse, } from "./lib/schema.js";
-export { BuildRunCreateRequestSchema, BuildRunResourceSchema, BuildRunSummarySchema, LocalServiceDiscoverySchema, VerifiableContextMappingSchema, PreparationRunLinkageSchema, PreparationResourceSchema, PreparationWireShapeSchema, BuildPlanResourceSchema, LocalJobAgentSchema, LocalJobEventAppendRequestSchema, LocalJobEventSchema, LocalJobEventTypeSchema, LocalJobRunCreateRequestSchema, LocalJobRunResourceSchema, LocalJobStatusSchema, LocalRunHandlerResultSchema, LocalJobStepSchema, LocalJobTypeSchema, LocalServiceConfigSchema, LocalServiceErrorSchema, LocalServiceHealthSchema, VerifiableContextResourceSchema, ReadinessResourceSchema, SourceFileResourceSchema, ReadinessCheckDraftCreateRequestSchema, ReadinessCheckDraftResultSchema, VerifyRunCreateRequestSchema, VerifyRunResourceSchema, VerifyRunStatusSchema, RunObservabilityResourceSchema, RunObservabilityListResponseSchema, LocalExecutorStatusSchema, ActionClientOriginSchema, ActionProposalApprovalRequestSchema, ActionProposalApprovalSchema, ActionProposalCreateRequestSchema, ActionProposalListResponseSchema, ActionProposalPlanSchema, ActionProposalPlanActionTypeSchema, ActionProposalResourceSchema, ActionProposalStatusSchema, ActionProposalTypeSchema, ResetRequestSchema, ResetResultSchema, BuildPlanAuthoringCreateRequestSchema, BuildPlanAuthoringResultSchema, PreparationListResponseSchema, BuildPlanListResponseSchema, VerifiableContextListResponseSchema, BuildRunListResponseSchema, SourceFileListResponseSchema, OpenPathRequestSchema, OpenPathResponseSchema, } from "./lib/schema.js";
-export { LOCAL_SERVICE_DEFAULT_HOST, LOCAL_SERVICE_DEFAULT_PORT, LOCAL_SERVICE_ROUTES, buildLocalServiceUrl, } from "./routes.js";
-export type { ServiceRegistry, ServiceRegistryEntry, } from "./lib/schema.js";
-export { ServiceRegistrySchema, ServiceRegistryEntrySchema, } from "./lib/schema.js";
-export { readServiceRegistry, registerServiceLocally, unregisterService, writeServiceRegistry, serviceRegistryPath, } from "./service-registry.js";
-export type { LocalServiceJobSubmission, LocalServiceJobSubmitted, LocalServiceConnection, } from "./client.js";
-export type { LocalBuildRunCancelResult, } from "./client.js";
-export { approveActionProposalInLocalService, cancelLocalBuildRun, configuredLocalServiceUrl, resolveLocalServiceAuthToken, createActionProposalInLocalService, decideActionProposalInLocalService, findLocalService, getLocalJobRun, getLocalBuildRun, getLocalServiceHealth, getLocalVerifyRun, submitBuildRunToLocalService, submitReadinessCheckDraftToLocalService, submitResetToLocalService, submitVerifyRunToLocalService, submitBuildPlanAuthoringRunToLocalService, waitForLocalJobRun, waitForLocalBuildRun, waitForLocalVerifyRun, } from "./client.js";
-export type { LocalServiceActionPlanningContext, LocalServiceBuildRunContext, LocalServiceJobRunContext, LocalServiceRunHandlers, LocalServiceRuntimeOptions, LocalServiceVerifyRunContext, PreparationContext, } from "./runtime.js";
-export { LocalServiceRuntime, createLocalServiceRuntime, } from "./runtime.js";
-export type { StartedLocalService, StartLocalServiceOptions, } from "./server.js";
-export { createLocalServiceServer, createLocalServiceAuthToken, startLocalService, } from "./server.js";
-export type { NativeLocalServiceRunHandlerOptions, } from "./native-run-handlers.js";
-export { createNativeLocalServiceRunHandlers, } from "./native-run-handlers.js";

package/dist/packages/engine/index.js

@@ -1,15 +0,0 @@
-export * as schema from "./lib/schema.js";
-export * as actionValues from "./action-values.js";
-export * as actionDefinitions from "./action-definitions.js";
-export * as routes from "./routes.js";
-export * as client from "./client.js";
-export * as runtime from "./runtime.js";
-export * as server from "./server.js";
-export { BuildRunCreateRequestSchema, BuildRunResourceSchema, BuildRunSummarySchema, LocalServiceDiscoverySchema, VerifiableContextMappingSchema, PreparationRunLinkageSchema, PreparationResourceSchema, PreparationWireShapeSchema, BuildPlanResourceSchema, LocalJobAgentSchema, LocalJobEventAppendRequestSchema, LocalJobEventSchema, LocalJobEventTypeSchema, LocalJobRunCreateRequestSchema, LocalJobRunResourceSchema, LocalJobStatusSchema, LocalRunHandlerResultSchema, LocalJobStepSchema, LocalJobTypeSchema, LocalServiceConfigSchema, LocalServiceErrorSchema, LocalServiceHealthSchema, VerifiableContextResourceSchema, ReadinessResourceSchema, SourceFileResourceSchema, ReadinessCheckDraftCreateRequestSchema, ReadinessCheckDraftResultSchema, VerifyRunCreateRequestSchema, VerifyRunResourceSchema, VerifyRunStatusSchema, RunObservabilityResourceSchema, RunObservabilityListResponseSchema, LocalExecutorStatusSchema, ActionClientOriginSchema, ActionProposalApprovalRequestSchema, ActionProposalApprovalSchema, ActionProposalCreateRequestSchema, ActionProposalListResponseSchema, ActionProposalPlanSchema, ActionProposalPlanActionTypeSchema, ActionProposalResourceSchema, ActionProposalStatusSchema, ActionProposalTypeSchema, ResetRequestSchema, ResetResultSchema, BuildPlanAuthoringCreateRequestSchema, BuildPlanAuthoringResultSchema, PreparationListResponseSchema, BuildPlanListResponseSchema, VerifiableContextListResponseSchema, BuildRunListResponseSchema, SourceFileListResponseSchema, OpenPathRequestSchema, OpenPathResponseSchema, } from "./lib/schema.js";
-export { LOCAL_SERVICE_DEFAULT_HOST, LOCAL_SERVICE_DEFAULT_PORT, LOCAL_SERVICE_ROUTES, buildLocalServiceUrl, } from "./routes.js";
-export { ServiceRegistrySchema, ServiceRegistryEntrySchema, } from "./lib/schema.js";
-export { readServiceRegistry, registerServiceLocally, unregisterService, writeServiceRegistry, serviceRegistryPath, } from "./service-registry.js";
-export { approveActionProposalInLocalService, cancelLocalBuildRun, configuredLocalServiceUrl, resolveLocalServiceAuthToken, createActionProposalInLocalService, decideActionProposalInLocalService, findLocalService, getLocalJobRun, getLocalBuildRun, getLocalServiceHealth, getLocalVerifyRun, submitBuildRunToLocalService, submitReadinessCheckDraftToLocalService, submitResetToLocalService, submitVerifyRunToLocalService, submitBuildPlanAuthoringRunToLocalService, waitForLocalJobRun, waitForLocalBuildRun, waitForLocalVerifyRun, } from "./client.js";
-export { LocalServiceRuntime, createLocalServiceRuntime, } from "./runtime.js";
-export { createLocalServiceServer, createLocalServiceAuthToken, startLocalService, } from "./server.js";
-export { createNativeLocalServiceRunHandlers, } from "./native-run-handlers.js";

package/dist/packages/engine/instance-paths.d.ts

@@ -1,106 +0,0 @@
-/**
- * Interf Home path helpers used by the local service.
- *
- * The instance is the opaque owner of its preparation state. Storage lives
- * under `~/.interf/`. The CLI never opens these files directly — it asks the
- * API where things are and reads from the locator the API returns.
- *
- * Current preparation config and verifiable-context paths live in
- * `contracts/lib/preparation-paths.ts` and are bridged by
- * `preparation-store.ts` for the existing Build runtime. Keep the old
- * `config.json` / `verifiable-context` constants below as a migration boundary
- * only; do not cite them as current user-visible layout.
- *
- * Layout:
- *   ~/.interf/
- *     connection.json            ← single CLI connection record
- *     services.json              ← internal stop-lookup registry
- *     build-plans/<id>/              ← user-installed Build Plans (cross-preparation)
- *     preparations/<prep-id>/    ← per-preparation state owned by the engine
- *       interf.json              ← current preparation config bridge
- *       <prep-id>/               ← current verifiable context output
- *         .interf/               ← per-preparation runtime/build-plan/tests state
- *       runs/                    ← persisted run records
- *       jobs/                    ← service job runs
- *       proposals/               ← chat/wizard action proposals
- *       tests/                   ← saved readiness check specs
- */
-export type InterfHomeRoot = string & {
-    readonly __brand: "InterfHomeRoot";
-};
-export type PreparationDataDir = string & {
-    readonly __brand: "PreparationDataDir";
-};
-export type VerifiableContextPath = string & {
-    readonly __brand: "VerifiableContextPath";
-};
-export type SourceFolderPath = string & {
-    readonly __brand: "SourceFolderPath";
-};
-export declare const INTERF_USER_HOME_ENV = "INTERF_USER_HOME";
-export declare const INTERF_HOME_DIR = ".interf";
-export declare const PREPARATIONS_DIR = "preparations";
-export declare const BUILD_PLANS_DIR = "build-plans";
-export declare const SERVICE_REGISTRY_FILENAME = "services.json";
-export declare const CONNECTION_CONFIG_FILENAME = "connection.json";
-export declare const PREPARATION_CONFIG_FILENAME = "config.json";
-export declare const PREPARATION_VERIFIABLE_CONTEXT_DIR = "verifiable-context";
-export declare const PREPARATION_RUNS_DIR = "runs";
-export declare const PREPARATION_JOBS_DIR = "jobs";
-export declare const PREPARATION_PROPOSALS_DIR = "proposals";
-export declare const PREPARATION_TESTS_DIR = "tests";
-export declare const PREPARATION_BUILD_PLAN_DIR = "build-plan";
-export declare const VERIFIABLE_CONTEXT_STATE_DIR = ".interf";
-export declare const VERIFIABLE_CONTEXT_RUNTIME_DIR = "runtime";
-export declare const VERIFIABLE_CONTEXT_BUILD_PLAN_DIR = "build-plan";
-export declare const VERIFIABLE_CONTEXT_TESTS_DIR = "tests";
-export declare function asPreparationDataDir(path: string): PreparationDataDir;
-export declare function asVerifiableContextPath(path: string): VerifiableContextPath;
-export declare function asSourceFolderPath(path: string): SourceFolderPath;
-/** `~/.interf/` — overridable via INTERF_USER_HOME for tests. */
-export declare function interfHomeRoot(): InterfHomeRoot;
-/** `~/.interf/connection.json` — single CLI connection record. */
-export declare function connectionConfigPath(): string;
-/** `~/.interf/services.json` — internal `interf web stop` lookup registry. */
-export declare function serviceRegistryPath(): string;
-/** `~/.interf/build-plans/` — user-installed Build Plans (cross-preparation). */
-export declare function userBuildPlansRoot(): string;
-/** `~/.interf/build-plans/<id>/` — a specific user-library Build Plan package. */
-export declare function userBuildPlanPackagePath(buildPlanId: string): string;
-/** `~/.interf/preparations/` — root for all preparation state. */
-export declare function preparationsRoot(): string;
-/** `~/.interf/preparations/<prep-id>/` — one preparation's state dir. */
-export declare function preparationDataDir(prepId: string): PreparationDataDir;
-/** Legacy planned path: `<prep-data>/config.json`. Current runtime uses `interf.json`. */
-export declare function preparationConfigPath(prepId: string): string;
-/** Legacy planned path: `<prep-data>/verifiable-context/`. Current runtime uses `<prep-data>/<prep-id>/`. */
-export declare function preparationVerifiableContextDir(prepId: string): VerifiableContextPath;
-/** `<prep-data>/runs/` — build/test run records. */
-export declare function preparationRunsRoot(prepId: string): string;
-/** `<prep-data>/jobs/` — service job runs (drafts, improvements, etc). */
-export declare function preparationJobsRoot(prepId: string): string;
-/** `<prep-data>/proposals/` — action proposals scoped to this preparation. */
-export declare function preparationProposalsRoot(prepId: string): string;
-/** `<prep-data>/tests/` — saved readiness check specs. */
-export declare function preparationTestsRoot(prepId: string): string;
-/** `<prep-data>/build-plan/` — preparation-draft Build Plan package (if any). */
-export declare function preparationBuildPlanDraftPath(prepId: string): string;
-/** `<verifiable-context>/.interf/`. */
-export declare function verifiableContextStateRoot(verifiableContext: VerifiableContextPath): string;
-/** `<verifiable-context>/.interf/build-plan/`. */
-export declare function verifiableContextBuildPlanPath(verifiableContext: VerifiableContextPath): string;
-/** `<verifiable-context>/.interf/runtime/`. */
-export declare function verifiableContextRuntimeRoot(verifiableContext: VerifiableContextPath): string;
-/** `<verifiable-context>/.interf/tests/`. */
-export declare function verifiableContextTestsRoot(verifiableContext: VerifiableContextPath): string;
-export type PreparationTestTargetLabel = "source-files" | "verifiable-context";
-/** Legacy planned path: `<prep-data>/verifiable-context/.interf/tests/<target>/runs/`. */
-export declare function preparationTestRunsRoot(prepId: string, target: PreparationTestTargetLabel): string;
-/** Legacy planned path: `<prep-data>/verifiable-context/.interf/tests/latest.json`. */
-export declare function preparationLatestReadinessRunPath(prepId: string): string;
-/** Legacy planned path: `<prep-data>/verifiable-context/.interf/tests/latest.md`. */
-export declare function preparationLatestReadinessSummaryPath(prepId: string): string;
-/** Normalize a free-form string into a stable kebab-cased id (≤80 chars). */
-export declare function normalizePreparationTestRunId(input: string): string;
-/** Legacy planned path: `<prep-data>/verifiable-context/.interf/tests/<target>/runs/<timestamp>-<run-id>[-<suffix>].json`. */
-export declare function preparationTestRunPath(prepId: string, target: PreparationTestTargetLabel, generatedAt: string, runId: string, runSuffix?: string | null): string;

package/dist/packages/engine/instance-paths.js

@@ -1,171 +0,0 @@
-/**
- * Interf Home path helpers used by the local service.
- *
- * The instance is the opaque owner of its preparation state. Storage lives
- * under `~/.interf/`. The CLI never opens these files directly — it asks the
- * API where things are and reads from the locator the API returns.
- *
- * Current preparation config and verifiable-context paths live in
- * `contracts/lib/preparation-paths.ts` and are bridged by
- * `preparation-store.ts` for the existing Build runtime. Keep the old
- * `config.json` / `verifiable-context` constants below as a migration boundary
- * only; do not cite them as current user-visible layout.
- *
- * Layout:
- *   ~/.interf/
- *     connection.json            ← single CLI connection record
- *     services.json              ← internal stop-lookup registry
- *     build-plans/<id>/              ← user-installed Build Plans (cross-preparation)
- *     preparations/<prep-id>/    ← per-preparation state owned by the engine
- *       interf.json              ← current preparation config bridge
- *       <prep-id>/               ← current verifiable context output
- *         .interf/               ← per-preparation runtime/build-plan/tests state
- *       runs/                    ← persisted run records
- *       jobs/                    ← service job runs
- *       proposals/               ← chat/wizard action proposals
- *       tests/                   ← saved readiness check specs
- */
-import { homedir } from "node:os";
-import { join } from "node:path";
-// ───────────────────────────────────────────────────────────────────────────
-// Constants
-// ───────────────────────────────────────────────────────────────────────────
-export const INTERF_USER_HOME_ENV = "INTERF_USER_HOME";
-export const INTERF_HOME_DIR = ".interf";
-export const PREPARATIONS_DIR = "preparations";
-export const BUILD_PLANS_DIR = "build-plans";
-export const SERVICE_REGISTRY_FILENAME = "services.json";
-export const CONNECTION_CONFIG_FILENAME = "connection.json";
-export const PREPARATION_CONFIG_FILENAME = "config.json";
-export const PREPARATION_VERIFIABLE_CONTEXT_DIR = "verifiable-context";
-export const PREPARATION_RUNS_DIR = "runs";
-export const PREPARATION_JOBS_DIR = "jobs";
-export const PREPARATION_PROPOSALS_DIR = "proposals";
-export const PREPARATION_TESTS_DIR = "tests";
-export const PREPARATION_BUILD_PLAN_DIR = "build-plan";
-export const VERIFIABLE_CONTEXT_STATE_DIR = ".interf";
-export const VERIFIABLE_CONTEXT_RUNTIME_DIR = "runtime";
-export const VERIFIABLE_CONTEXT_BUILD_PLAN_DIR = "build-plan";
-export const VERIFIABLE_CONTEXT_TESTS_DIR = "tests";
-// ───────────────────────────────────────────────────────────────────────────
-// Brand constructors
-// ───────────────────────────────────────────────────────────────────────────
-export function asPreparationDataDir(path) {
-    return path;
-}
-export function asVerifiableContextPath(path) {
-    return path;
-}
-export function asSourceFolderPath(path) {
-    return path;
-}
-// ───────────────────────────────────────────────────────────────────────────
-// Interf Home (~/.interf/)
-// ───────────────────────────────────────────────────────────────────────────
-/** `~/.interf/` — overridable via INTERF_USER_HOME for tests. */
-export function interfHomeRoot() {
-    const override = process.env[INTERF_USER_HOME_ENV]?.trim();
-    if (override && override.length > 0)
-        return override;
-    return join(homedir(), INTERF_HOME_DIR);
-}
-/** `~/.interf/connection.json` — single CLI connection record. */
-export function connectionConfigPath() {
-    return join(interfHomeRoot(), CONNECTION_CONFIG_FILENAME);
-}
-/** `~/.interf/services.json` — internal `interf web stop` lookup registry. */
-export function serviceRegistryPath() {
-    return join(interfHomeRoot(), SERVICE_REGISTRY_FILENAME);
-}
-/** `~/.interf/build-plans/` — user-installed Build Plans (cross-preparation). */
-export function userBuildPlansRoot() {
-    return join(interfHomeRoot(), BUILD_PLANS_DIR);
-}
-/** `~/.interf/build-plans/<id>/` — a specific user-library Build Plan package. */
-export function userBuildPlanPackagePath(buildPlanId) {
-    return join(userBuildPlansRoot(), buildPlanId);
-}
-// ───────────────────────────────────────────────────────────────────────────
-// Preparation data dirs
-// ───────────────────────────────────────────────────────────────────────────
-/** `~/.interf/preparations/` — root for all preparation state. */
-export function preparationsRoot() {
-    return join(interfHomeRoot(), PREPARATIONS_DIR);
-}
-/** `~/.interf/preparations/<prep-id>/` — one preparation's state dir. */
-export function preparationDataDir(prepId) {
-    return asPreparationDataDir(join(preparationsRoot(), prepId));
-}
-/** Legacy planned path: `<prep-data>/config.json`. Current runtime uses `interf.json`. */
-export function preparationConfigPath(prepId) {
-    return join(preparationDataDir(prepId), PREPARATION_CONFIG_FILENAME);
-}
-/** Legacy planned path: `<prep-data>/verifiable-context/`. Current runtime uses `<prep-data>/<prep-id>/`. */
-export function preparationVerifiableContextDir(prepId) {
-    return asVerifiableContextPath(join(preparationDataDir(prepId), PREPARATION_VERIFIABLE_CONTEXT_DIR));
-}
-/** `<prep-data>/runs/` — build/test run records. */
-export function preparationRunsRoot(prepId) {
-    return join(preparationDataDir(prepId), PREPARATION_RUNS_DIR);
-}
-/** `<prep-data>/jobs/` — service job runs (drafts, improvements, etc). */
-export function preparationJobsRoot(prepId) {
-    return join(preparationDataDir(prepId), PREPARATION_JOBS_DIR);
-}
-/** `<prep-data>/proposals/` — action proposals scoped to this preparation. */
-export function preparationProposalsRoot(prepId) {
-    return join(preparationDataDir(prepId), PREPARATION_PROPOSALS_DIR);
-}
-/** `<prep-data>/tests/` — saved readiness check specs. */
-export function preparationTestsRoot(prepId) {
-    return join(preparationDataDir(prepId), PREPARATION_TESTS_DIR);
-}
-/** `<prep-data>/build-plan/` — preparation-draft Build Plan package (if any). */
-export function preparationBuildPlanDraftPath(prepId) {
-    return join(preparationDataDir(prepId), PREPARATION_BUILD_PLAN_DIR);
-}
-// ───────────────────────────────────────────────────────────────────────────
-// Verifiable-context state (per-preparation, lives under preparation data dir)
-// ───────────────────────────────────────────────────────────────────────────
-/** `<verifiable-context>/.interf/`. */
-export function verifiableContextStateRoot(verifiableContext) {
-    return join(verifiableContext, VERIFIABLE_CONTEXT_STATE_DIR);
-}
-/** `<verifiable-context>/.interf/build-plan/`. */
-export function verifiableContextBuildPlanPath(verifiableContext) {
-    return join(verifiableContextStateRoot(verifiableContext), VERIFIABLE_CONTEXT_BUILD_PLAN_DIR);
-}
-/** `<verifiable-context>/.interf/runtime/`. */
-export function verifiableContextRuntimeRoot(verifiableContext) {
-    return join(verifiableContextStateRoot(verifiableContext), VERIFIABLE_CONTEXT_RUNTIME_DIR);
-}
-/** `<verifiable-context>/.interf/tests/`. */
-export function verifiableContextTestsRoot(verifiableContext) {
-    return join(verifiableContextStateRoot(verifiableContext), VERIFIABLE_CONTEXT_TESTS_DIR);
-}
-/** Legacy planned path: `<prep-data>/verifiable-context/.interf/tests/<target>/runs/`. */
-export function preparationTestRunsRoot(prepId, target) {
-    return join(verifiableContextTestsRoot(preparationVerifiableContextDir(prepId)), target, "runs");
-}
-/** Legacy planned path: `<prep-data>/verifiable-context/.interf/tests/latest.json`. */
-export function preparationLatestReadinessRunPath(prepId) {
-    return join(verifiableContextTestsRoot(preparationVerifiableContextDir(prepId)), "latest.json");
-}
-/** Legacy planned path: `<prep-data>/verifiable-context/.interf/tests/latest.md`. */
-export function preparationLatestReadinessSummaryPath(prepId) {
-    return join(verifiableContextTestsRoot(preparationVerifiableContextDir(prepId)), "latest.md");
-}
-/** Normalize a free-form string into a stable kebab-cased id (≤80 chars). */
-export function normalizePreparationTestRunId(input) {
-    return input
-        .toLowerCase()
-        .trim()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "")
-        .slice(0, 80);
-}
-/** Legacy planned path: `<prep-data>/verifiable-context/.interf/tests/<target>/runs/<timestamp>-<run-id>[-<suffix>].json`. */
-export function preparationTestRunPath(prepId, target, generatedAt, runId, runSuffix) {
-    const suffix = runSuffix ? `-${normalizePreparationTestRunId(runSuffix)}` : "";
-    return join(preparationTestRunsRoot(prepId, target), `${generatedAt.replace(/[:.]/g, "-")}-${runId}${suffix}.json`);
-}