@interf/compiler 0.22.0 → 0.33.0

package/dist/packages/engine/build/verifiable-context-schema.js

@@ -1,126 +0,0 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { warnInterf } from "../../contracts/utils/logger.js";
-import { readJsonFileUnchecked } from "../../contracts/utils/parse.js";
-import { listBuiltinBuildPlanArtifactSpecs, requiredBuildPlanArtifactOwners, } from "../../build-plans/package/builtin-build-plan.js";
-import { BuildPlanContextSchemaSchema, } from "./lib/schema.js";
-export const BUILD_PLAN_SCHEMA_FILE = "build-plan.schema.json";
-export function buildPlanSchemaFilePath(rootPath) {
-    return join(rootPath, BUILD_PLAN_SCHEMA_FILE);
-}
-export function resolveBuildPlanSchemaPath(rootPath) {
-    const path = buildPlanSchemaFilePath(rootPath);
-    return existsSync(path) ? path : null;
-}
-export function buildPlanSchemaExists(rootPath) {
-    return existsSync(buildPlanSchemaFilePath(rootPath));
-}
-export function buildPlanSchemaRelativePath() {
-    return `build-plan/${BUILD_PLAN_SCHEMA_FILE}`;
-}
-export function listBuildPlanContextArtifacts(schema) {
-    return schema.artifacts.map(artifactToBuildPlanArtifact);
-}
-export function findBuildPlanContextArtifact(schema, artifactId) {
-    return listBuildPlanContextArtifacts(schema).find((artifact) => artifact.id === artifactId) ?? null;
-}
-export function verifiableContextArtifactAbsolutePath(verifiableContextPath, artifact) {
-    return join(verifiableContextPath, artifact.path);
-}
-export function verifiableContextArtifactPath(artifact) {
-    if (artifact.kind === "file")
-        return artifact.path;
-    return artifact.path.endsWith("/") ? artifact.path : `${artifact.path}/`;
-}
-export function verifiableContextArtifactPathsForArtifactIds(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 verifiableContextArtifactPath(artifact);
-    });
-}
-export function ensureBuildPlanArtifactTargets(verifiableContextPath, schema) {
-    for (const artifact of listBuildPlanContextArtifacts(schema)) {
-        if (artifact.kind === "directory" || artifact.kind === "runtime") {
-            mkdirSync(verifiableContextArtifactAbsolutePath(verifiableContextPath, artifact), { recursive: true });
-            continue;
-        }
-        mkdirSync(dirname(verifiableContextArtifactAbsolutePath(verifiableContextPath, artifact)), { recursive: true });
-    }
-}
-function normalizeBuildPlanContextSchema(schema) {
-    return {
-        ...schema,
-        kind: "build-plan-schema",
-    };
-}
-function artifactToBuildPlanArtifact(artifact) {
-    if (artifact.shape.kind !== "path") {
-        return {
-            id: artifact.id,
-            role: "output",
-            path: artifact.id,
-            kind: "directory",
-            required: true,
-            owned_by: [...artifact.built_by_stages],
-            description: artifact.description,
-        };
-    }
-    return {
-        id: artifact.id,
-        role: "output",
-        path: artifact.shape.path,
-        kind: artifact.shape.artifact_kind,
-        required: true,
-        owned_by: [...artifact.built_by_stages],
-        description: artifact.description,
-    };
-}
-export function buildBuildPlanContextSchema(stages, label = "Build Plan schema") {
-    return {
-        kind: "build-plan-schema",
-        version: 1,
-        target_type: "verifiable-context",
-        label,
-        artifacts: listBuiltinBuildPlanArtifactSpecs().map((artifact) => ({
-            id: artifact.id,
-            description: artifact.description,
-            shape: {
-                kind: "path",
-                path: artifact.path,
-                artifact_kind: artifact.kind === "file" ? "file" : "directory",
-            },
-            checks: [],
-            built_by_stages: requiredBuildPlanArtifactOwners(stages, artifact.id),
-        })),
-    };
-}
-export function writeBuildPlanContextSchemaFile(rootPath, stages, label) {
-    const schema = buildBuildPlanContextSchema(stages, label);
-    writeBuildPlanContextSchemaDocument(rootPath, schema);
-    return schema;
-}
-export function writeBuildPlanContextSchemaDocument(rootPath, schema) {
-    const normalized = normalizeBuildPlanContextSchema(schema);
-    writeFileSync(buildPlanSchemaFilePath(rootPath), `${JSON.stringify(normalized, null, 2)}\n`);
-    return normalized;
-}
-export function readBuildPlanContextSchemaFile(rootPath) {
-    const path = buildPlanSchemaFilePath(rootPath);
-    if (!existsSync(path))
-        return null;
-    const raw = readJsonFileUnchecked(path, "Build Plan schema");
-    if (raw === null)
-        return null;
-    const parsed = BuildPlanContextSchemaSchema.safeParse(raw);
-    if (!parsed.success) {
-        warnInterf(`Warning: failed to validate Build Plan schema at ${path}: ${parsed.error.issues.map((issue) => issue.message).join("; ")}`);
-        return null;
-    }
-    return normalizeBuildPlanContextSchema(parsed.data);
-}
-export function readBuildPlanContextFile(rootPath) {
-    return readBuildPlanContextSchemaFile(rootPath);
-}

package/dist/packages/engine/cloud-seams.d.ts

@@ -1,115 +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.
- */
-/**
- * **B4.1 — `IdempotencyStore` (E-1 in the 0.16 architecture audit).**
- *
- * Backs the `POS../../build-runs` idempotency-key dedupe cache. The
- * in-process `Map` cache works for one local engine; multi-replica
- * cloud needs a shared store (Redis-shaped) so a retry that lands on
- * a different replica hits the same dedupe entry.
- *
- * Local default: in-memory map on the runtime.
- *
- * Cloud injection: wrap a Redis client (or equivalent shared store).
- */
-export interface IdempotencyStore {
-    get(scope: string, key: string): {
-        runId: string;
-        expiresAt: number;
-    } | null;
-    set(scope: string, key: string, value: {
-        runId: string;
-        expiresAt: number;
-    }): void;
-    delete(scope: string, key: string): void;
-    prune(now: number): void;
-    size(): number;
-}
-/**
- * **B4.2 — `RunLeaseStore` (I-1 in the 0.16 architecture audit).**
- *
- * Tracks active Build runs so the engine can cancel them and reject
- * concurrent run starts on the same preparation. The local default uses
- * the runtime's `activeBuildRuns` map; multi-replica cloud needs a
- * shared lease store with heartbeat so a replica can take over a run
- * whose owning replica died.
- *
- * Local default: in-memory map on the runtime.
- *
- * Cloud injection: shared lease store with heartbeat (Redis lease,
- * Cassandra LWT, etc.) plus a `listActive()` heartbeat scan.
- */
-export interface RunLeaseStore {
-    acquire(runId: string, lease: RunLeaseEntry): void;
-    release(runId: string): void;
-    get(runId: string): RunLeaseEntry | null;
-    markCancelled(runId: string): void;
-    listActive(): Iterable<{
-        runId: string;
-        lease: RunLeaseEntry;
-    }>;
-}
-export interface RunLeaseEntry {
-    prepDataDir: string;
-    preparation: string;
-    cancelled: boolean;
-    cancelledAt?: string;
-}
-/**
- * **B4.3 — `tokenValidator` (S-2 in the 0.16 architecture audit).**
- *
- * Local default: every accepted token is treated equivalently — the
- * engine carries a single bearer token at startup, and any request
- * presenting that token is authorized. Cloud needs a per-account
- * token issuer + validator so the engine can attach an `account_id`
- * to billing events (Phase F) and scope writes per-account.
- *
- * Local default: configured bearer or `null` (loopback).
- *
- * Cloud injection: validate against a token-issuer service, return
- * the `account_id` so downstream code can attach it to runs and
- * billing events.
- */
-export type TokenValidator = (token: string) => TokenValidation | Promise<TokenValidation>;
-export interface TokenValidation {
-    ok: boolean;
-    account_id: string | null;
-    reason?: string;
-}
-export declare class InMemoryIdempotencyStore implements IdempotencyStore {
-    private buckets;
-    get(scope: string, key: string): {
-        runId: string;
-        expiresAt: number;
-    } | null;
-    set(scope: string, key: string, value: {
-        runId: string;
-        expiresAt: number;
-    }): void;
-    delete(scope: string, key: string): void;
-    prune(now: number): void;
-    size(): number;
-}
-export declare class InMemoryRunLeaseStore implements RunLeaseStore {
-    private leases;
-    acquire(runId: string, lease: RunLeaseEntry): void;
-    release(runId: string): void;
-    get(runId: string): RunLeaseEntry | null;
-    markCancelled(runId: string): void;
-    listActive(): Iterable<{
-        runId: string;
-        lease: RunLeaseEntry;
-    }>;
-}

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`);
-}