@interf/compiler 0.16.0 → 0.21.0

package/dist/packages/engine/execution/lib/schema.d.ts

@@ -286,15 +286,15 @@ export declare const RunObservabilitySchema: z.ZodObject<{
         generated_at: z.ZodString;
         preparation: z.ZodString;
         status: z.ZodEnum<{
+            ready: "ready";
+            failed: "failed";
             "not-configured": "not-configured";
             "not-built": "not-built";
             building: "building";
             built: "built";
             checking: "checking";
-            ready: "ready";
             "not-ready": "not-ready";
             stale: "stale";
-            failed: "failed";
         }>;
         ready: z.ZodBoolean;
         summary: z.ZodString;
@@ -306,20 +306,21 @@ export declare const RunObservabilitySchema: z.ZodObject<{
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
             ok: z.ZodBoolean;
             status: z.ZodOptional<z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
                 "not-configured": "not-configured";
                 "not-built": "not-built";
                 building: "building";
                 built: "built";
                 checking: "checking";
-                ready: "ready";
                 "not-ready": "not-ready";
                 stale: "stale";
-                failed: "failed";
             }>>;
             summary: z.ZodString;
             detail: z.ZodOptional<z.ZodString>;
@@ -353,20 +354,21 @@ export declare const RunObservabilitySchema: z.ZodObject<{
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
             ok: z.ZodBoolean;
             status: z.ZodOptional<z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
                 "not-configured": "not-configured";
                 "not-built": "not-built";
                 building: "building";
                 built: "built";
                 checking: "checking";
-                ready: "ready";
                 "not-ready": "not-ready";
                 stale: "stale";
-                failed: "failed";
             }>>;
             summary: z.ZodString;
             detail: z.ZodOptional<z.ZodString>;
@@ -470,7 +472,6 @@ export declare const StageRunContractSchema: z.ZodObject<{
     stage_total: z.ZodOptional<z.ZodNumber>;
     reads: z.ZodDefault<z.ZodArray<z.ZodString>>;
     writes: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    acceptance: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
 export declare const StageRunLogsSchema: z.ZodObject<{
     prompt_path: z.ZodOptional<z.ZodString>;
@@ -605,6 +606,13 @@ export declare const RunFailedEventSchema: z.ZodObject<{
     type: z.ZodLiteral<"run.failed">;
     error: z.ZodString;
 }, z.core.$strict>;
+export declare const RunCancelledEventSchema: z.ZodObject<{
+    event_id: z.ZodString;
+    run_id: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"run.cancelled">;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
 export declare const ChecksEvaluatedEventSchema: z.ZodObject<{
     event_id: z.ZodString;
     run_id: z.ZodString;
@@ -632,15 +640,15 @@ export declare const ReadinessUpdatedEventSchema: z.ZodObject<{
         generated_at: z.ZodString;
         preparation: z.ZodString;
         status: z.ZodEnum<{
+            ready: "ready";
+            failed: "failed";
             "not-configured": "not-configured";
             "not-built": "not-built";
             building: "building";
             built: "built";
             checking: "checking";
-            ready: "ready";
             "not-ready": "not-ready";
             stale: "stale";
-            failed: "failed";
         }>;
         ready: z.ZodBoolean;
         summary: z.ZodString;
@@ -652,20 +660,21 @@ export declare const ReadinessUpdatedEventSchema: z.ZodObject<{
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
             ok: z.ZodBoolean;
             status: z.ZodOptional<z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
                 "not-configured": "not-configured";
                 "not-built": "not-built";
                 building: "building";
                 built: "built";
                 checking: "checking";
-                ready: "ready";
                 "not-ready": "not-ready";
                 stale: "stale";
-                failed: "failed";
             }>>;
             summary: z.ZodString;
             detail: z.ZodOptional<z.ZodString>;
@@ -699,20 +708,21 @@ export declare const ReadinessUpdatedEventSchema: z.ZodObject<{
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
             ok: z.ZodBoolean;
             status: z.ZodOptional<z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
                 "not-configured": "not-configured";
                 "not-built": "not-built";
                 building: "building";
                 built: "built";
                 checking: "checking";
-                ready: "ready";
                 "not-ready": "not-ready";
                 stale: "stale";
-                failed: "failed";
             }>>;
             summary: z.ZodString;
             detail: z.ZodOptional<z.ZodString>;
@@ -838,6 +848,12 @@ export declare const InterfRunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     timestamp: z.ZodString;
     type: z.ZodLiteral<"run.failed">;
     error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    event_id: z.ZodString;
+    run_id: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodLiteral<"run.cancelled">;
+    reason: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     event_id: z.ZodString;
     run_id: z.ZodString;
@@ -864,15 +880,15 @@ export declare const InterfRunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         generated_at: z.ZodString;
         preparation: z.ZodString;
         status: z.ZodEnum<{
+            ready: "ready";
+            failed: "failed";
             "not-configured": "not-configured";
             "not-built": "not-built";
             building: "building";
             built: "built";
             checking: "checking";
-            ready: "ready";
             "not-ready": "not-ready";
             stale: "stale";
-            failed: "failed";
         }>;
         ready: z.ZodBoolean;
         summary: z.ZodString;
@@ -884,20 +900,21 @@ export declare const InterfRunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
             ok: z.ZodBoolean;
             status: z.ZodOptional<z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
                 "not-configured": "not-configured";
                 "not-built": "not-built";
                 building: "building";
                 built: "built";
                 checking: "checking";
-                ready: "ready";
                 "not-ready": "not-ready";
                 stale: "stale";
-                failed: "failed";
             }>>;
             summary: z.ZodString;
             detail: z.ZodOptional<z.ZodString>;
@@ -931,20 +948,21 @@ export declare const InterfRunEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
             ok: z.ZodBoolean;
             status: z.ZodOptional<z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
                 "not-configured": "not-configured";
                 "not-built": "not-built";
                 building: "building";
                 built: "built";
                 checking: "checking";
-                ready: "ready";
                 "not-ready": "not-ready";
                 stale: "stale";
-                failed: "failed";
             }>>;
             summary: z.ZodString;
             detail: z.ZodOptional<z.ZodString>;
@@ -974,7 +992,6 @@ export declare const StageRunSchema: z.ZodObject<{
         stage_total: z.ZodOptional<z.ZodNumber>;
         reads: z.ZodDefault<z.ZodArray<z.ZodString>>;
         writes: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        acceptance: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>>;
     executor: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         kind: z.ZodEnum<{
@@ -1081,7 +1098,6 @@ export declare const CompileRunSchema: z.ZodObject<{
             stage_total: z.ZodOptional<z.ZodNumber>;
             reads: z.ZodDefault<z.ZodArray<z.ZodString>>;
             writes: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            acceptance: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strict>>;
         executor: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             kind: z.ZodEnum<{
@@ -1262,6 +1278,12 @@ export declare const CompileRunSchema: z.ZodObject<{
         timestamp: z.ZodString;
         type: z.ZodLiteral<"run.failed">;
         error: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        event_id: z.ZodString;
+        run_id: z.ZodString;
+        timestamp: z.ZodString;
+        type: z.ZodLiteral<"run.cancelled">;
+        reason: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{
         event_id: z.ZodString;
         run_id: z.ZodString;
@@ -1288,15 +1310,15 @@ export declare const CompileRunSchema: z.ZodObject<{
             generated_at: z.ZodString;
             preparation: z.ZodString;
             status: z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
                 "not-configured": "not-configured";
                 "not-built": "not-built";
                 building: "building";
                 built: "built";
                 checking: "checking";
-                ready: "ready";
                 "not-ready": "not-ready";
                 stale: "stale";
-                failed: "failed";
             }>;
             ready: z.ZodBoolean;
             summary: z.ZodString;
@@ -1308,20 +1330,21 @@ export declare const CompileRunSchema: z.ZodObject<{
                     "portable-context": "portable-context";
                     "preparation-config": "preparation-config";
                     "compile-run": "compile-run";
+                    "artifact-checks": "artifact-checks";
                     "readiness-checks": "readiness-checks";
                     "checks-current": "checks-current";
                 }>;
                 ok: z.ZodBoolean;
                 status: z.ZodOptional<z.ZodEnum<{
+                    ready: "ready";
+                    failed: "failed";
                     "not-configured": "not-configured";
                     "not-built": "not-built";
                     building: "building";
                     built: "built";
                     checking: "checking";
-                    ready: "ready";
                     "not-ready": "not-ready";
                     stale: "stale";
-                    failed: "failed";
                 }>>;
                 summary: z.ZodString;
                 detail: z.ZodOptional<z.ZodString>;
@@ -1355,20 +1378,21 @@ export declare const CompileRunSchema: z.ZodObject<{
                     "portable-context": "portable-context";
                     "preparation-config": "preparation-config";
                     "compile-run": "compile-run";
+                    "artifact-checks": "artifact-checks";
                     "readiness-checks": "readiness-checks";
                     "checks-current": "checks-current";
                 }>;
                 ok: z.ZodBoolean;
                 status: z.ZodOptional<z.ZodEnum<{
+                    ready: "ready";
+                    failed: "failed";
                     "not-configured": "not-configured";
                     "not-built": "not-built";
                     building: "building";
                     built: "built";
                     checking: "checking";
-                    ready: "ready";
                     "not-ready": "not-ready";
                     stale: "stale";
-                    failed: "failed";
                 }>>;
                 summary: z.ZodString;
                 detail: z.ZodOptional<z.ZodString>;
@@ -1410,15 +1434,15 @@ export declare const CompileRunSchema: z.ZodObject<{
         generated_at: z.ZodString;
         preparation: z.ZodString;
         status: z.ZodEnum<{
+            ready: "ready";
+            failed: "failed";
             "not-configured": "not-configured";
             "not-built": "not-built";
             building: "building";
             built: "built";
             checking: "checking";
-            ready: "ready";
             "not-ready": "not-ready";
             stale: "stale";
-            failed: "failed";
         }>;
         ready: z.ZodBoolean;
         summary: z.ZodString;
@@ -1430,20 +1454,21 @@ export declare const CompileRunSchema: z.ZodObject<{
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
             ok: z.ZodBoolean;
             status: z.ZodOptional<z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
                 "not-configured": "not-configured";
                 "not-built": "not-built";
                 building: "building";
                 built: "built";
                 checking: "checking";
-                ready: "ready";
                 "not-ready": "not-ready";
                 stale: "stale";
-                failed: "failed";
             }>>;
             summary: z.ZodString;
             detail: z.ZodOptional<z.ZodString>;
@@ -1477,20 +1502,21 @@ export declare const CompileRunSchema: z.ZodObject<{
                 "portable-context": "portable-context";
                 "preparation-config": "preparation-config";
                 "compile-run": "compile-run";
+                "artifact-checks": "artifact-checks";
                 "readiness-checks": "readiness-checks";
                 "checks-current": "checks-current";
             }>;
             ok: z.ZodBoolean;
             status: z.ZodOptional<z.ZodEnum<{
+                ready: "ready";
+                failed: "failed";
                 "not-configured": "not-configured";
                 "not-built": "not-built";
                 building: "building";
                 built: "built";
                 checking: "checking";
-                ready: "ready";
                 "not-ready": "not-ready";
                 stale: "stale";
-                failed: "failed";
             }>>;
             summary: z.ZodString;
             detail: z.ZodOptional<z.ZodString>;
@@ -1498,6 +1524,36 @@ export declare const CompileRunSchema: z.ZodObject<{
             artifact_path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        artifact_id: z.ZodString;
+        status: z.ZodEnum<{
+            ready: "ready";
+            not_ready: "not_ready";
+            failed: "failed";
+            skipped: "skipped";
+        }>;
+        built_by_stages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        proofs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            check_id: z.ZodString;
+            kind: z.ZodEnum<{
+                file_exists: "file_exists";
+                min_file_count: "min_file_count";
+                min_file_count_matches_source: "min_file_count_matches_source";
+                frontmatter_valid: "frontmatter_valid";
+                frontmatter_required_keys: "frontmatter_required_keys";
+                wikilinks_valid: "wikilinks_valid";
+                must_not_contain: "must_not_contain";
+                must_contain: "must_contain";
+                qa_match: "qa_match";
+            }>;
+            passed: z.ZodBoolean;
+            required: z.ZodBoolean;
+            summary: z.ZodString;
+            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            evaluated_at: z.ZodString;
+        }, z.core.$strict>>>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
 export type ExecutionBackendKind = z.infer<typeof ExecutionBackendKindSchema>;
 export type MethodTraceRunStatus = z.infer<typeof MethodTraceRunStatusSchema>;

package/dist/packages/engine/execution/lib/schema.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { RuntimeExecutorInfoSchema, RuntimeStageSchema, MethodIdSchema, ReadinessStateSchema, PreparationNameSchema, } from "../../../contracts/lib/schema.js";
+import { ArtifactStatusSchema, RuntimeExecutorInfoSchema, RuntimeStageSchema, MethodIdSchema, ReadinessSchema, PreparationNameSchema, } from "../../../contracts/lib/schema.js";
 const RunIdSchema = z.string().min(1);
 const JsonObjectSchema = z.record(z.string(), z.unknown());
 export const MethodTraceRunStatusSchema = z.enum([
@@ -146,7 +146,7 @@ export const RunObservabilitySchema = z.object({
     metrics: z.array(ObservableRunMetricSchema).default([]),
     artifacts: z.array(ArtifactRefSchema).default([]),
     proof: z.array(ProofCheckSchema).default([]),
-    readiness: ReadinessStateSchema.nullable().optional(),
+    readiness: ReadinessSchema.nullable().optional(),
     trace: MethodTraceSchema,
 }).strict();
 export const ProofRecordSchema = z.object({
@@ -165,7 +165,6 @@ export const StageRunContractSchema = z.object({
     stage_total: z.number().int().min(1).optional(),
     reads: z.array(z.string().min(1)).default([]),
     writes: z.array(z.string().min(1)).default([]),
-    acceptance: z.record(z.string(), z.unknown()).optional(),
 }).strict();
 export const StageRunLogsSchema = z.object({
     prompt_path: z.string().min(1).optional(),
@@ -230,6 +229,10 @@ export const RunFailedEventSchema = RunEventBaseSchema.extend({
     type: z.literal("run.failed"),
     error: z.string().min(1),
 }).strict();
+export const RunCancelledEventSchema = RunEventBaseSchema.extend({
+    type: z.literal("run.cancelled"),
+    reason: z.string().min(1).optional(),
+}).strict();
 export const ChecksEvaluatedEventSchema = RunEventBaseSchema.extend({
     type: z.literal("checks.evaluated"),
     passed: z.number().int().min(0),
@@ -242,7 +245,7 @@ export const ChecksEvaluatedEventSchema = RunEventBaseSchema.extend({
 export const ReadinessUpdatedEventSchema = RunEventBaseSchema.extend({
     type: z.literal("readiness.updated"),
     preparation: PreparationNameSchema,
-    readiness: ReadinessStateSchema,
+    readiness: ReadinessSchema,
 }).strict();
 export const InterfRunEventSchema = z.discriminatedUnion("type", [
     RunStartedEventSchema,
@@ -255,6 +258,7 @@ export const InterfRunEventSchema = z.discriminatedUnion("type", [
     StageFailedEventSchema,
     RunCompletedEventSchema,
     RunFailedEventSchema,
+    RunCancelledEventSchema,
     ChecksEvaluatedEventSchema,
     ReadinessUpdatedEventSchema,
 ]);
@@ -291,5 +295,9 @@ export const CompileRunSchema = z.object({
     stages: z.array(StageRunSchema).default([]),
     events: z.array(InterfRunEventSchema).default([]),
     latest_proof: ProofRecordSchema.nullable().optional(),
-    readiness: ReadinessStateSchema.nullable().optional(),
+    readiness: ReadinessSchema.nullable().optional(),
+    // Per-Artifact status records when the Method declares an
+    // `artifacts[]` block. Computed
+    // once the run reaches a terminal status; `not_ready` while running.
+    artifacts: z.array(ArtifactStatusSchema).default([]),
 }).strict();

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

@@ -5,8 +5,8 @@ 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 { CompileRunCreateRequest, CompileRunResource, CompileRunSummary, LocalServiceDiscovery, PortableContextMapping, PreparationRunLinkage, PreparationResource, MethodResource, LocalJobAgent, LocalJobEvent, LocalJobEventAppendRequest, LocalJobEventType, LocalJobRunCreateRequest, LocalJobRunResource, LocalJobStatus, LocalRunHandlerResult, LocalJobStep, LocalJobType, LocalServiceConfig, LocalServiceError, LocalServiceHealth, LocalExecutorStatus, ActionClientOrigin, ActionProposalApproval, ActionProposalApprovalRequest, ActionProposalCreateRequest, ActionProposalListResponse, ActionProposalPlan, ActionProposalPlanActionType, ActionProposalResource, ActionProposalStatus, ActionProposalType, MethodChangeResult, PreparationChangeResult, PreparationSetupResult, ResetRequest, ResetResult, PortableContextResource, ReadinessResource, SourceFileResource, ReadinessCheckDraftCreateRequest, ReadinessCheckDraftResult, VerifyRunCreateRequest, VerifyRunResource, VerifyRunStatus, RunObservabilityListResponse, RunObservabilityResource, MethodAuthoringCreateRequest, MethodAuthoringResult, PreparationListResponse, MethodListResponse, PortableContextListResponse, SourceFileListResponse, OpenPathRequest, OpenPathResponse, WorkspaceFileResource, } from "./lib/schema.js";
-export { CompileRunCreateRequestSchema, CompileRunResourceSchema, CompileRunSummarySchema, LocalServiceDiscoverySchema, PortableContextMappingSchema, PreparationRunLinkageSchema, PreparationResourceSchema, MethodResourceSchema, LocalJobAgentSchema, LocalJobEventAppendRequestSchema, LocalJobEventSchema, LocalJobEventTypeSchema, LocalJobRunCreateRequestSchema, LocalJobRunResourceSchema, LocalJobStatusSchema, LocalRunHandlerResultSchema, LocalJobStepSchema, LocalJobTypeSchema, LocalServiceConfigSchema, LocalServiceErrorSchema, LocalServiceHealthSchema, PortableContextResourceSchema, ReadinessResourceSchema, SourceFileResourceSchema, ReadinessCheckDraftCreateRequestSchema, ReadinessCheckDraftResultSchema, VerifyRunCreateRequestSchema, VerifyRunResourceSchema, VerifyRunStatusSchema, RunObservabilityResourceSchema, RunObservabilityListResponseSchema, LocalExecutorStatusSchema, ActionClientOriginSchema, ActionProposalApprovalRequestSchema, ActionProposalApprovalSchema, ActionProposalCreateRequestSchema, ActionProposalListResponseSchema, ActionProposalPlanSchema, ActionProposalPlanActionTypeSchema, ActionProposalResourceSchema, ActionProposalStatusSchema, ActionProposalTypeSchema, ResetRequestSchema, ResetResultSchema, MethodAuthoringCreateRequestSchema, MethodAuthoringResultSchema, PreparationListResponseSchema, MethodListResponseSchema, PortableContextListResponseSchema, SourceFileListResponseSchema, OpenPathRequestSchema, OpenPathResponseSchema, } from "./lib/schema.js";
+export type { CompileRunCreateRequest, CompileRunResource, CompileRunSummary, LocalServiceDiscovery, PortableContextMapping, PreparationRunLinkage, PreparationResource, PreparationWireShape, MethodResource, LocalJobAgent, LocalJobEvent, LocalJobEventAppendRequest, LocalJobEventType, LocalJobRunCreateRequest, LocalJobRunResource, LocalJobStatus, LocalRunHandlerResult, LocalJobStep, LocalJobType, LocalServiceConfig, LocalServiceError, LocalServiceHealth, LocalExecutorStatus, ActionClientOrigin, ActionProposalApproval, ActionProposalApprovalRequest, ActionProposalCreateRequest, ActionProposalListResponse, ActionProposalPlan, ActionProposalPlanActionType, ActionProposalResource, ActionProposalStatus, ActionProposalType, MethodChangeResult, PreparationChangeResult, PreparationSetupResult, ResetRequest, ResetResult, PortableContextResource, ReadinessResource, SourceFileResource, ReadinessCheckDraftCreateRequest, ReadinessCheckDraftResult, VerifyRunCreateRequest, VerifyRunResource, VerifyRunStatus, RunObservabilityListResponse, RunObservabilityResource, MethodAuthoringCreateRequest, MethodAuthoringResult, PreparationListResponse, MethodListResponse, PortableContextListResponse, SourceFileListResponse, OpenPathRequest, OpenPathResponse, WorkspaceFileResource, } from "./lib/schema.js";
+export { CompileRunCreateRequestSchema, CompileRunResourceSchema, CompileRunSummarySchema, LocalServiceDiscoverySchema, PortableContextMappingSchema, PreparationRunLinkageSchema, PreparationResourceSchema, PreparationWireShapeSchema, MethodResourceSchema, LocalJobAgentSchema, LocalJobEventAppendRequestSchema, LocalJobEventSchema, LocalJobEventTypeSchema, LocalJobRunCreateRequestSchema, LocalJobRunResourceSchema, LocalJobStatusSchema, LocalRunHandlerResultSchema, LocalJobStepSchema, LocalJobTypeSchema, LocalServiceConfigSchema, LocalServiceErrorSchema, LocalServiceHealthSchema, PortableContextResourceSchema, ReadinessResourceSchema, SourceFileResourceSchema, ReadinessCheckDraftCreateRequestSchema, ReadinessCheckDraftResultSchema, VerifyRunCreateRequestSchema, VerifyRunResourceSchema, VerifyRunStatusSchema, RunObservabilityResourceSchema, RunObservabilityListResponseSchema, LocalExecutorStatusSchema, ActionClientOriginSchema, ActionProposalApprovalRequestSchema, ActionProposalApprovalSchema, ActionProposalCreateRequestSchema, ActionProposalListResponseSchema, ActionProposalPlanSchema, ActionProposalPlanActionTypeSchema, ActionProposalResourceSchema, ActionProposalStatusSchema, ActionProposalTypeSchema, ResetRequestSchema, ResetResultSchema, MethodAuthoringCreateRequestSchema, MethodAuthoringResultSchema, PreparationListResponseSchema, MethodListResponseSchema, PortableContextListResponseSchema, 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, ServiceRegistryWorkspace, } from "./lib/schema.js";
 export { ServiceRegistrySchema, ServiceRegistryEntrySchema, ServiceRegistryWorkspaceSchema, } from "./lib/schema.js";

package/dist/packages/engine/index.js

@@ -5,7 +5,7 @@ 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 { CompileRunCreateRequestSchema, CompileRunResourceSchema, CompileRunSummarySchema, LocalServiceDiscoverySchema, PortableContextMappingSchema, PreparationRunLinkageSchema, PreparationResourceSchema, MethodResourceSchema, LocalJobAgentSchema, LocalJobEventAppendRequestSchema, LocalJobEventSchema, LocalJobEventTypeSchema, LocalJobRunCreateRequestSchema, LocalJobRunResourceSchema, LocalJobStatusSchema, LocalRunHandlerResultSchema, LocalJobStepSchema, LocalJobTypeSchema, LocalServiceConfigSchema, LocalServiceErrorSchema, LocalServiceHealthSchema, PortableContextResourceSchema, ReadinessResourceSchema, SourceFileResourceSchema, ReadinessCheckDraftCreateRequestSchema, ReadinessCheckDraftResultSchema, VerifyRunCreateRequestSchema, VerifyRunResourceSchema, VerifyRunStatusSchema, RunObservabilityResourceSchema, RunObservabilityListResponseSchema, LocalExecutorStatusSchema, ActionClientOriginSchema, ActionProposalApprovalRequestSchema, ActionProposalApprovalSchema, ActionProposalCreateRequestSchema, ActionProposalListResponseSchema, ActionProposalPlanSchema, ActionProposalPlanActionTypeSchema, ActionProposalResourceSchema, ActionProposalStatusSchema, ActionProposalTypeSchema, ResetRequestSchema, ResetResultSchema, MethodAuthoringCreateRequestSchema, MethodAuthoringResultSchema, PreparationListResponseSchema, MethodListResponseSchema, PortableContextListResponseSchema, SourceFileListResponseSchema, OpenPathRequestSchema, OpenPathResponseSchema, } from "./lib/schema.js";
+export { CompileRunCreateRequestSchema, CompileRunResourceSchema, CompileRunSummarySchema, LocalServiceDiscoverySchema, PortableContextMappingSchema, PreparationRunLinkageSchema, PreparationResourceSchema, PreparationWireShapeSchema, MethodResourceSchema, LocalJobAgentSchema, LocalJobEventAppendRequestSchema, LocalJobEventSchema, LocalJobEventTypeSchema, LocalJobRunCreateRequestSchema, LocalJobRunResourceSchema, LocalJobStatusSchema, LocalRunHandlerResultSchema, LocalJobStepSchema, LocalJobTypeSchema, LocalServiceConfigSchema, LocalServiceErrorSchema, LocalServiceHealthSchema, PortableContextResourceSchema, ReadinessResourceSchema, SourceFileResourceSchema, ReadinessCheckDraftCreateRequestSchema, ReadinessCheckDraftResultSchema, VerifyRunCreateRequestSchema, VerifyRunResourceSchema, VerifyRunStatusSchema, RunObservabilityResourceSchema, RunObservabilityListResponseSchema, LocalExecutorStatusSchema, ActionClientOriginSchema, ActionProposalApprovalRequestSchema, ActionProposalApprovalSchema, ActionProposalCreateRequestSchema, ActionProposalListResponseSchema, ActionProposalPlanSchema, ActionProposalPlanActionTypeSchema, ActionProposalResourceSchema, ActionProposalStatusSchema, ActionProposalTypeSchema, ResetRequestSchema, ResetResultSchema, MethodAuthoringCreateRequestSchema, MethodAuthoringResultSchema, PreparationListResponseSchema, MethodListResponseSchema, PortableContextListResponseSchema, 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, ServiceRegistryWorkspaceSchema, } from "./lib/schema.js";
 export { readServiceRegistry, registerServiceLocally, unregisterService, writeServiceRegistry, serviceRegistryPath, } from "./service-registry.js";

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

@@ -1,18 +1,24 @@
 /**
- * Source of truth for every Interf path on disk in 0.13.
+ * Interf Home path helpers used by the local service.
  *
  * The instance is a black box that owns 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 portable-context paths live in
+ * `contracts/lib/preparation-paths.ts` and are bridged by
+ * `preparation-store.ts` for the existing compile runtime. Keep the old
+ * `config.json` / `portable-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
  *     methods/<id>/              ← user-installed methods (cross-preparation)
  *     preparations/<prep-id>/    ← per-preparation state owned by the engine
- *       config.json              ← preparation config (id, source, method, …)
- *       portable-context/        ← compiled portable context output
+ *       interf.json              ← current preparation config bridge
+ *       <prep-id>/               ← current portable context output
  *         .interf/               ← per-preparation runtime/method/tests state
  *       runs/                    ← persisted run records
  *       jobs/                    ← service job runs
@@ -65,9 +71,9 @@ export declare function userMethodPackagePath(methodId: string): string;
 export declare function preparationsRoot(): string;
 /** `~/.interf/preparations/<prep-id>/` — one preparation's state dir. */
 export declare function preparationDataDir(prepId: string): PreparationDataDir;
-/** `<prep-data>/config.json` — preparation config source of truth. */
+/** Legacy planned path: `<prep-data>/config.json`. Current runtime uses `interf.json`. */
 export declare function preparationConfigPath(prepId: string): string;
-/** `<prep-data>/portable-context/` — compiled portable context output. */
+/** Legacy planned path: `<prep-data>/portable-context/`. Current runtime uses `<prep-data>/<prep-id>/`. */
 export declare function preparationPortableContextDir(prepId: string): PortableContextPath;
 /** `<prep-data>/runs/` — compile/test run records. */
 export declare function preparationRunsRoot(prepId: string): string;
@@ -88,13 +94,13 @@ export declare function portableContextRuntimeRoot(portableContext: PortableCont
 /** `<portable-context>/.interf/tests/`. */
 export declare function portableContextTestsRoot(portableContext: PortableContextPath): string;
 export type PreparationTestTargetLabel = "source-files" | "compiled";
-/** `<prep-data>/portable-context/.interf/tests/<target>/runs/`. */
+/** Legacy planned path: `<prep-data>/portable-context/.interf/tests/<target>/runs/`. */
 export declare function preparationTestRunsRoot(prepId: string, target: PreparationTestTargetLabel): string;
-/** `<prep-data>/portable-context/.interf/tests/latest.json`. */
+/** Legacy planned path: `<prep-data>/portable-context/.interf/tests/latest.json`. */
 export declare function preparationLatestReadinessRunPath(prepId: string): string;
-/** `<prep-data>/portable-context/.interf/tests/latest.md`. */
+/** Legacy planned path: `<prep-data>/portable-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;
-/** `<prep-data>/portable-context/.interf/tests/<target>/runs/<timestamp>-<run-id>[-<suffix>].json`. */
+/** Legacy planned path: `<prep-data>/portable-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,18 +1,24 @@
 /**
- * Source of truth for every Interf path on disk in 0.13.
+ * Interf Home path helpers used by the local service.
  *
  * The instance is a black box that owns 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 portable-context paths live in
+ * `contracts/lib/preparation-paths.ts` and are bridged by
+ * `preparation-store.ts` for the existing compile runtime. Keep the old
+ * `config.json` / `portable-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
  *     methods/<id>/              ← user-installed methods (cross-preparation)
  *     preparations/<prep-id>/    ← per-preparation state owned by the engine
- *       config.json              ← preparation config (id, source, method, …)
- *       portable-context/        ← compiled portable context output
+ *       interf.json              ← current preparation config bridge
+ *       <prep-id>/               ← current portable context output
  *         .interf/               ← per-preparation runtime/method/tests state
  *       runs/                    ← persisted run records
  *       jobs/                    ← service job runs
@@ -90,11 +96,11 @@ export function preparationsRoot() {
 export function preparationDataDir(prepId) {
     return asPreparationDataDir(join(preparationsRoot(), prepId));
 }
-/** `<prep-data>/config.json` — preparation config source of truth. */
+/** Legacy planned path: `<prep-data>/config.json`. Current runtime uses `interf.json`. */
 export function preparationConfigPath(prepId) {
     return join(preparationDataDir(prepId), PREPARATION_CONFIG_FILENAME);
 }
-/** `<prep-data>/portable-context/` — compiled portable context output. */
+/** Legacy planned path: `<prep-data>/portable-context/`. Current runtime uses `<prep-data>/<prep-id>/`. */
 export function preparationPortableContextDir(prepId) {
     return asPortableContextPath(join(preparationDataDir(prepId), PREPARATION_PORTABLE_CONTEXT_DIR));
 }
@@ -137,15 +143,15 @@ export function portableContextRuntimeRoot(portableContext) {
 export function portableContextTestsRoot(portableContext) {
     return join(portableContextStateRoot(portableContext), PORTABLE_CONTEXT_TESTS_DIR);
 }
-/** `<prep-data>/portable-context/.interf/tests/<target>/runs/`. */
+/** Legacy planned path: `<prep-data>/portable-context/.interf/tests/<target>/runs/`. */
 export function preparationTestRunsRoot(prepId, target) {
     return join(portableContextTestsRoot(preparationPortableContextDir(prepId)), target, "runs");
 }
-/** `<prep-data>/portable-context/.interf/tests/latest.json`. */
+/** Legacy planned path: `<prep-data>/portable-context/.interf/tests/latest.json`. */
 export function preparationLatestReadinessRunPath(prepId) {
     return join(portableContextTestsRoot(preparationPortableContextDir(prepId)), "latest.json");
 }
-/** `<prep-data>/portable-context/.interf/tests/latest.md`. */
+/** Legacy planned path: `<prep-data>/portable-context/.interf/tests/latest.md`. */
 export function preparationLatestReadinessSummaryPath(prepId) {
     return join(portableContextTestsRoot(preparationPortableContextDir(prepId)), "latest.md");
 }
@@ -158,7 +164,7 @@ export function normalizePreparationTestRunId(input) {
         .replace(/^-+|-+$/g, "")
         .slice(0, 80);
 }
-/** `<prep-data>/portable-context/.interf/tests/<target>/runs/<timestamp>-<run-id>[-<suffix>].json`. */
+/** Legacy planned path: `<prep-data>/portable-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`);