jg-agent-hq 0.2.0 → 0.4.0

package/dist/contracts/browser/types.js

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+import { ActionEnvelopeSchema, ActionReceiptSchema, ActionSummarySchema, ActionPlanContextSchema, ManagedThreadSchema, NativeApprovalSchema, } from '../actions/index.js';
+import { RuntimeStatusSchema, LiveItemsSchema } from '../types.js';
+import { HandoffCommandSchema } from '../handoffs/index.js';
+import { PlanCommandSchema, PlanStatusSchema, PlanResultSchema, PlanMetadataSchema, PlanRevisionSchema, PlanTargetSchema, } from '../plans/index.js';
+// the browser surface is closed; hosts resolve every supplied identity against their registry
+export const BrowserCommandSchema = z.discriminatedUnion('kind', [
+    z.strictObject({ kind: z.literal('native'), action: ActionEnvelopeSchema }),
+    z.strictObject({ kind: z.literal('plan'), command: PlanCommandSchema }),
+    z.strictObject({ kind: z.literal('handoff'), command: HandoffCommandSchema }),
+    z.strictObject({
+        kind: z.literal('priority'),
+        target: PlanTargetSchema,
+        expectedRevision: PlanRevisionSchema,
+        priority: z.enum(['P0', 'P1', 'P2', 'P3']),
+        reason: z.string().min(1).max(4096),
+    }),
+    z.strictObject({
+        kind: z.literal('error-reservation'),
+        target: PlanTargetSchema,
+        expectedRevision: PlanRevisionSchema,
+        reservation: PlanMetadataSchema.shape.errorReservations.element,
+        release: z.boolean(),
+    }),
+    z.strictObject({
+        kind: z.literal('publication-retry'),
+        expectedCommit: z.string().regex(/^[a-f0-9]{40}(?:[a-f0-9]{24})?$/),
+    }),
+]);
+export const BrowserActionSchema = z
+    .strictObject({
+    id: z.uuid(),
+    runtimeEpoch: z.uuid(),
+    command: BrowserCommandSchema,
+})
+    .refine((request) => new TextEncoder().encode(JSON.stringify(request)).byteLength <= 2_097_152);
+// admission and host completion do not imply native turn completion
+export const BrowserReceiptSchema = z.object({
+    id: z.uuid(),
+    runtimeEpoch: z.uuid(),
+    kind: z.enum(BrowserCommandSchema.options.map((command) => command.shape.kind.value)),
+    state: z.enum(['submitted', 'acknowledged', 'uncertain']),
+    nativeActionId: z.uuid(),
+    createdAt: z.number().int(),
+    updatedAt: z.number().int(),
+    native: ActionReceiptSchema.nullable(),
+});
+// read models contain generic registration metadata, never deployment configuration
+export const BrowserRepositorySchema = z.object({
+    name: z.string().max(128),
+    root: z.string().max(4096).nullable(),
+    purpose: z.string().max(4096),
+    worktrees: z.boolean(),
+});
+export const BrowserPlanSummarySchema = z.object({
+    id: z.string().max(128),
+    directory: z.string().max(4096),
+    scope: z.string().max(128),
+    status: z.enum(['planned', 'in-progress', 'done', 'abandoned']),
+    summary: z.string().max(4096),
+    priority: z.enum(['P0', 'P1', 'P2', 'P3']),
+    priorityReason: z.string().max(4096),
+    repositories: PlanMetadataSchema.shape.repositories,
+    errorReservations: PlanMetadataSchema.shape.errorReservations,
+});
+export const BrowserPlanPageSchema = z.object({
+    data: z.array(BrowserPlanSummarySchema).max(128),
+    nextCursor: z.string().nullable(),
+    revision: z.string().regex(/^[a-f0-9]{64}$/),
+});
+export const BrowserPlanDetailSchema = z.object({
+    summary: BrowserPlanSummarySchema,
+    contract: z.string().max(1_048_576),
+    status: PlanStatusSchema,
+    presentation: z.string().max(1_048_576).nullable(),
+    page: PlanResultSchema.nullable(),
+});
+export const BrowserSessionSchema = z.object({
+    operator: z.object({ id: z.string().max(256) }),
+    runtimeEpoch: z.uuid(),
+    capabilities: z.object({
+        native: z.boolean(),
+        plans: z.boolean(),
+        handoffs: z.boolean(),
+        priorities: z.boolean(),
+        errorReservations: z.boolean(),
+        publicationRetry: z.boolean(),
+    }),
+});
+export const BrowserRepositoryPageSchema = z.object({
+    data: z.array(BrowserRepositorySchema).max(128),
+    nextCursor: z.string().nullable(),
+});
+export const BrowserSystemSchema = z.object({
+    runtime: RuntimeStatusSchema,
+    publication: z.object({ state: z.literal('unavailable') }),
+    resources: z.object({ state: z.literal('unavailable') }),
+    service: z.object({ state: z.literal('unavailable') }),
+});
+export const BrowserThreadDetailSchema = z.object({
+    thread: ManagedThreadSchema,
+    plan: ActionPlanContextSchema.nullable(),
+    approvals: z.array(NativeApprovalSchema).max(128),
+    live: LiveItemsSchema,
+    actions: z.object({
+        data: z.array(ActionSummarySchema).max(128),
+        nextCursor: z.string().nullable(),
+    }),
+});

package/dist/contracts/handoffs/types.d.ts

@@ -12,7 +12,7 @@ export declare const HandoffSourceSchema: z.ZodObject<{
         scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"execution">;
             authorizationId: z.ZodUUID;
-            milestoneId: z.ZodUUID;
+            milestoneId: z.ZodNullable<z.ZodUUID>;
             mode: z.ZodEnum<{
                 supervised: "supervised";
                 auto: "auto";
@@ -126,7 +126,7 @@ export declare const HandoffSummarySchema: z.ZodObject<{
             scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"execution">;
                 authorizationId: z.ZodUUID;
-                milestoneId: z.ZodUUID;
+                milestoneId: z.ZodNullable<z.ZodUUID>;
                 mode: z.ZodEnum<{
                     supervised: "supervised";
                     auto: "auto";
@@ -229,7 +229,7 @@ export declare const HandoffSchema: z.ZodObject<{
             scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"execution">;
                 authorizationId: z.ZodUUID;
-                milestoneId: z.ZodUUID;
+                milestoneId: z.ZodNullable<z.ZodUUID>;
                 mode: z.ZodEnum<{
                     supervised: "supervised";
                     auto: "auto";
@@ -363,7 +363,7 @@ export declare const HandoffResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"execution">;
                     authorizationId: z.ZodUUID;
-                    milestoneId: z.ZodUUID;
+                    milestoneId: z.ZodNullable<z.ZodUUID>;
                     mode: z.ZodEnum<{
                         supervised: "supervised";
                         auto: "auto";
@@ -496,7 +496,7 @@ export declare const HandoffResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 scope: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"execution">;
                     authorizationId: z.ZodUUID;
-                    milestoneId: z.ZodUUID;
+                    milestoneId: z.ZodNullable<z.ZodUUID>;
                     mode: z.ZodEnum<{
                         supervised: "supervised";
                         auto: "auto";

package/dist/contracts/index.d.ts

@@ -17,3 +17,7 @@ export { PlanActionScopeSchema, ActionPlanContextSchema } from './actions/index.
 export type { IPlanActionScope, IActionPlanContext } from './actions/index.js';
 export { HandoffSourceSchema, HandoffFindingsSchema, HandoffPhaseSchema, HandoffCommandSchema, HandoffDeliverySchema, HandoffSummarySchema, HandoffSchema, HandoffPreviewSchema, HandoffResultSchema, } from './handoffs/index.js';
 export type { IHandoffCommand, IHandoffPhase, IHandoffSource, IHandoffFindings, IHandoff, IHandoffSummary, IHandoffPreview, IHandoffResult, } from './handoffs/index.js';
+export { BrowserCommandSchema, BrowserActionSchema, BrowserReceiptSchema, } from './browser/index.js';
+export type { IBrowserAction, IBrowserReceipt } from './browser/index.js';
+export { BrowserRepositorySchema, BrowserPlanSummarySchema, BrowserPlanPageSchema, BrowserPlanDetailSchema, BrowserSessionSchema, } from './browser/index.js';
+export { BrowserRepositoryPageSchema, BrowserSystemSchema, BrowserThreadDetailSchema, } from './browser/index.js';

package/dist/contracts/index.js

@@ -18,3 +18,9 @@ export { PlanCorrespondenceSummarySchema, PlanReconciliationEntrySchema } from '
 export { PlanActionScopeSchema, ActionPlanContextSchema } from './actions/index.js';
 // explicit cross-provider handoffs
 export { HandoffSourceSchema, HandoffFindingsSchema, HandoffPhaseSchema, HandoffCommandSchema, HandoffDeliverySchema, HandoffSummarySchema, HandoffSchema, HandoffPreviewSchema, HandoffResultSchema, } from './handoffs/index.js';
+// authenticated host actions
+export { BrowserCommandSchema, BrowserActionSchema, BrowserReceiptSchema, } from './browser/index.js';
+// host read models
+export { BrowserRepositorySchema, BrowserPlanSummarySchema, BrowserPlanPageSchema, BrowserPlanDetailSchema, BrowserSessionSchema, } from './browser/index.js';
+// bounded host views
+export { BrowserRepositoryPageSchema, BrowserSystemSchema, BrowserThreadDetailSchema, } from './browser/index.js';

package/dist/contracts/plans/types.d.ts

@@ -81,7 +81,7 @@ export declare const PlanCompletionSchema: z.ZodObject<{
             reference: z.ZodString;
         }, z.core.$strict>;
     }, z.core.$strict>;
-    milestoneId: z.ZodUUID;
+    milestoneId: z.ZodNullable<z.ZodUUID>;
     revision: z.ZodObject<{
         planDigest: z.ZodString;
         breakdownDigest: z.ZodNullable<z.ZodString>;
@@ -89,7 +89,7 @@ export declare const PlanCompletionSchema: z.ZodObject<{
     contractDigest: z.ZodString;
     title: z.ZodString;
     contract: z.ZodString;
-    sharedDigest: z.ZodString;
+    sharedDigest: z.ZodNullable<z.ZodString>;
     checkouts: z.ZodArray<z.ZodObject<{
         repository: z.ZodString;
         directory: z.ZodString;
@@ -128,7 +128,7 @@ export declare const PlanCheckpointSchema: z.ZodObject<{
         breakdownDigest: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
     plan: z.ZodString;
-    milestones: z.ZodString;
+    milestones: z.ZodNullable<z.ZodString>;
     entries: z.ZodArray<z.ZodObject<{
         ordinal: z.ZodNumber;
         title: z.ZodString;
@@ -192,7 +192,7 @@ export declare const PlanProposalSchema: z.ZodObject<{
         planDigest: z.ZodString;
         breakdownDigest: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
-    inspectionHash: z.ZodString;
+    inspectionHash: z.ZodNullable<z.ZodString>;
     drafts: z.ZodArray<z.ZodObject<{
         ordinal: z.ZodNumber;
         title: z.ZodString;
@@ -285,7 +285,7 @@ export declare const PlanRevisionWorkflowSchema: z.ZodObject<{
             breakdownDigest: z.ZodNullable<z.ZodString>;
         }, z.core.$strict>;
         plan: z.ZodString;
-        milestones: z.ZodString;
+        milestones: z.ZodNullable<z.ZodString>;
         entries: z.ZodArray<z.ZodObject<{
             ordinal: z.ZodNumber;
             title: z.ZodString;
@@ -335,7 +335,7 @@ export declare const PlanRevisionWorkflowSchema: z.ZodObject<{
             planDigest: z.ZodString;
             breakdownDigest: z.ZodNullable<z.ZodString>;
         }, z.core.$strict>;
-        inspectionHash: z.ZodString;
+        inspectionHash: z.ZodNullable<z.ZodString>;
         drafts: z.ZodArray<z.ZodObject<{
             ordinal: z.ZodNumber;
             title: z.ZodString;
@@ -482,7 +482,7 @@ export declare const PlanCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strict>;
     kind: z.ZodLiteral<"finalize">;
 }, z.core.$strict>, z.ZodObject<{
-    milestoneId: z.ZodUUID;
+    milestoneId: z.ZodNullable<z.ZodUUID>;
     checks: z.ZodArray<z.ZodObject<{
         command: z.ZodString;
         outcome: z.ZodLiteral<"passed">;
@@ -668,7 +668,7 @@ export declare const PlanCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         breakdownDigest: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
     authorizationId: z.ZodUUID;
-    milestoneId: z.ZodUUID;
+    milestoneId: z.ZodNullable<z.ZodUUID>;
     mode: z.ZodEnum<{
         supervised: "supervised";
         auto: "auto";
@@ -757,7 +757,7 @@ export declare const PlanFinalizationSchema: z.ZodObject<{
         planDigest: z.ZodString;
         breakdownDigest: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
-    fileHash: z.ZodString;
+    fileHash: z.ZodNullable<z.ZodString>;
     createdAt: z.ZodNumber;
 }, z.core.$strict>;
 export declare const PlanComparisonSchema: z.ZodObject<{
@@ -831,7 +831,7 @@ export declare const PlanCoordinationSchema: z.ZodObject<{
             planDigest: z.ZodString;
             breakdownDigest: z.ZodNullable<z.ZodString>;
         }, z.core.$strict>;
-        fileHash: z.ZodString;
+        fileHash: z.ZodNullable<z.ZodString>;
         createdAt: z.ZodNumber;
     }, z.core.$strict>>;
     planApproval: z.ZodNullable<z.ZodObject<{
@@ -943,7 +943,7 @@ export declare const PlanCoordinationSchema: z.ZodObject<{
                 reference: z.ZodString;
             }, z.core.$strict>;
         }, z.core.$strict>;
-        milestoneId: z.ZodUUID;
+        milestoneId: z.ZodNullable<z.ZodUUID>;
         revision: z.ZodObject<{
             planDigest: z.ZodString;
             breakdownDigest: z.ZodNullable<z.ZodString>;
@@ -951,7 +951,7 @@ export declare const PlanCoordinationSchema: z.ZodObject<{
         contractDigest: z.ZodString;
         title: z.ZodString;
         contract: z.ZodString;
-        sharedDigest: z.ZodString;
+        sharedDigest: z.ZodNullable<z.ZodString>;
         checkouts: z.ZodArray<z.ZodObject<{
             repository: z.ZodString;
             directory: z.ZodString;
@@ -1065,7 +1065,7 @@ export declare const PlanCoordinationSchema: z.ZodObject<{
                 breakdownDigest: z.ZodNullable<z.ZodString>;
             }, z.core.$strict>;
             plan: z.ZodString;
-            milestones: z.ZodString;
+            milestones: z.ZodNullable<z.ZodString>;
             entries: z.ZodArray<z.ZodObject<{
                 ordinal: z.ZodNumber;
                 title: z.ZodString;
@@ -1115,7 +1115,7 @@ export declare const PlanCoordinationSchema: z.ZodObject<{
                 planDigest: z.ZodString;
                 breakdownDigest: z.ZodNullable<z.ZodString>;
             }, z.core.$strict>;
-            inspectionHash: z.ZodString;
+            inspectionHash: z.ZodNullable<z.ZodString>;
             drafts: z.ZodArray<z.ZodObject<{
                 ordinal: z.ZodNumber;
                 title: z.ZodString;
@@ -1168,7 +1168,7 @@ export declare const PlanCoordinationSchema: z.ZodObject<{
             breakdownDigest: z.ZodNullable<z.ZodString>;
         }, z.core.$strict>;
         plan: z.ZodString;
-        milestones: z.ZodString;
+        milestones: z.ZodNullable<z.ZodString>;
         entries: z.ZodArray<z.ZodObject<{
             ordinal: z.ZodNumber;
             title: z.ZodString;
@@ -1269,7 +1269,7 @@ export declare const PlanCoordinationSummarySchema: z.ZodObject<{
             planDigest: z.ZodString;
             breakdownDigest: z.ZodNullable<z.ZodString>;
         }, z.core.$strict>;
-        fileHash: z.ZodString;
+        fileHash: z.ZodNullable<z.ZodString>;
         createdAt: z.ZodNumber;
     }, z.core.$strict>>;
     planApproval: z.ZodNullable<z.ZodObject<{
@@ -1486,7 +1486,7 @@ export declare const PlanStatusSchema: z.ZodObject<{
                 planDigest: z.ZodString;
                 breakdownDigest: z.ZodNullable<z.ZodString>;
             }, z.core.$strict>;
-            fileHash: z.ZodString;
+            fileHash: z.ZodNullable<z.ZodString>;
             createdAt: z.ZodNumber;
         }, z.core.$strict>>;
         planApproval: z.ZodNullable<z.ZodObject<{
@@ -1716,7 +1716,7 @@ export declare const PlanReconciliationEntrySchema: z.ZodDiscriminatedUnion<[z.Z
                 reference: z.ZodString;
             }, z.core.$strict>;
         }, z.core.$strict>;
-        milestoneId: z.ZodUUID;
+        milestoneId: z.ZodNullable<z.ZodUUID>;
         revision: z.ZodObject<{
             planDigest: z.ZodString;
             breakdownDigest: z.ZodNullable<z.ZodString>;
@@ -1724,7 +1724,7 @@ export declare const PlanReconciliationEntrySchema: z.ZodDiscriminatedUnion<[z.Z
         contractDigest: z.ZodString;
         title: z.ZodString;
         contract: z.ZodString;
-        sharedDigest: z.ZodString;
+        sharedDigest: z.ZodNullable<z.ZodString>;
         checkouts: z.ZodArray<z.ZodObject<{
             repository: z.ZodString;
             directory: z.ZodString;
@@ -1871,7 +1871,7 @@ export declare const PlanResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     planDigest: z.ZodString;
                     breakdownDigest: z.ZodNullable<z.ZodString>;
                 }, z.core.$strict>;
-                fileHash: z.ZodString;
+                fileHash: z.ZodNullable<z.ZodString>;
                 createdAt: z.ZodNumber;
             }, z.core.$strict>>;
             planApproval: z.ZodNullable<z.ZodObject<{
@@ -2091,7 +2091,7 @@ export declare const PlanResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     planDigest: z.ZodString;
                     breakdownDigest: z.ZodNullable<z.ZodString>;
                 }, z.core.$strict>;
-                fileHash: z.ZodString;
+                fileHash: z.ZodNullable<z.ZodString>;
                 createdAt: z.ZodNumber;
             }, z.core.$strict>>;
             planApproval: z.ZodNullable<z.ZodObject<{
@@ -2279,7 +2279,7 @@ export declare const PlanResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         reference: z.ZodString;
                     }, z.core.$strict>;
                 }, z.core.$strict>;
-                milestoneId: z.ZodUUID;
+                milestoneId: z.ZodNullable<z.ZodUUID>;
                 revision: z.ZodObject<{
                     planDigest: z.ZodString;
                     breakdownDigest: z.ZodNullable<z.ZodString>;
@@ -2287,7 +2287,7 @@ export declare const PlanResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 contractDigest: z.ZodString;
                 title: z.ZodString;
                 contract: z.ZodString;
-                sharedDigest: z.ZodString;
+                sharedDigest: z.ZodNullable<z.ZodString>;
                 checkouts: z.ZodArray<z.ZodObject<{
                     repository: z.ZodString;
                     directory: z.ZodString;
@@ -2435,7 +2435,7 @@ export declare const PlanResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     planDigest: z.ZodString;
                     breakdownDigest: z.ZodNullable<z.ZodString>;
                 }, z.core.$strict>;
-                fileHash: z.ZodString;
+                fileHash: z.ZodNullable<z.ZodString>;
                 createdAt: z.ZodNumber;
             }, z.core.$strict>>;
             planApproval: z.ZodNullable<z.ZodObject<{
@@ -2574,7 +2574,7 @@ export declare const PlanResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }, z.core.$strict>>;
         }, z.core.$strict>;
     }, z.core.$strip>;
-    content: z.ZodString;
+    content: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"milestones">;
     result: z.ZodObject<{

package/dist/contracts/plans/types.js

@@ -64,12 +64,12 @@ export const PlanWorktreeProofSchema = PlanCheckoutSchema.extend({
 export const PlanCompletionSchema = z.strictObject({
     id: z.uuid(),
     action: PlanOperatorActionSchema,
-    milestoneId: z.uuid(),
+    milestoneId: z.uuid().nullable(),
     revision: PlanRevisionSchema,
     contractDigest: PlanDigestSchema,
     title: z.string().min(1).max(4096),
     contract: z.string().max(1_048_576),
-    sharedDigest: PlanDigestSchema,
+    sharedDigest: PlanDigestSchema.nullable(),
     checkouts: z.array(PlanWorktreeProofSchema).max(128),
     checks: z.array(PlanCheckSchema).min(1).max(32),
     completedAt: z.number().int(),
@@ -84,7 +84,7 @@ export const PlanSnapshotMilestoneSchema = PlanMilestoneSchema.extend({
 export const PlanCheckpointSchema = z.strictObject({
     revision: PlanRevisionSchema,
     plan: z.string().max(1_048_576),
-    milestones: z.string().max(1_048_576),
+    milestones: z.string().max(1_048_576).nullable(),
     entries: z.array(PlanSnapshotMilestoneSchema).max(1024),
     checkouts: z.array(PlanWorktreeProofSchema).max(128),
     threadIds: z.array(z.uuid()).max(32),
@@ -111,7 +111,7 @@ export const PlanDraftMilestoneSchema = PlanSnapshotMilestoneSchema.extend({
 export const PlanProposalSchema = z.strictObject({
     id: z.uuid(),
     revision: PlanRevisionSchema,
-    inspectionHash: PlanDigestSchema,
+    inspectionHash: PlanDigestSchema.nullable(),
     drafts: z.array(PlanDraftMilestoneSchema).max(1024),
     unmatchedSourceIds: z.array(z.uuid()).max(1024),
     confirmation: z
@@ -193,7 +193,7 @@ export const PlanCommandSchema = z.discriminatedUnion('kind', [
     z.strictObject({
         kind: z.literal('complete'),
         ...MutationFields,
-        milestoneId: z.uuid(),
+        milestoneId: z.uuid().nullable(),
         checks: z.array(PlanCheckSchema).min(1).max(32),
         checkouts: z.array(PlanCheckoutSchema).max(128),
     }),
@@ -234,7 +234,6 @@ export const PlanCommandSchema = z.discriminatedUnion('kind', [
         mode: z.enum(['supervised', 'auto']),
         milestoneIds: z
             .array(z.uuid())
-            .min(1)
             .max(1024)
             .refine((ids) => new Set(ids).size === ids.length),
     }),
@@ -243,7 +242,7 @@ export const PlanCommandSchema = z.discriminatedUnion('kind', [
         target: PlanTargetSchema,
         expected: PlanRevisionSchema,
         authorizationId: z.uuid(),
-        milestoneId: z.uuid(),
+        milestoneId: z.uuid().nullable(),
         mode: z.enum(['supervised', 'auto']),
     }),
 ]);
@@ -259,7 +258,7 @@ export const PlanExecutionSchema = z.strictObject({
     action: PlanOperatorActionSchema,
     revision: PlanRevisionSchema,
     mode: z.enum(['supervised', 'auto']),
-    milestoneIds: z.array(z.uuid()).min(1).max(1024),
+    milestoneIds: z.array(z.uuid()).max(1024),
     createdAt: z.number().int(),
     revokedBy: PlanOperatorActionSchema.nullable(),
 });
@@ -267,7 +266,7 @@ export const PlanExecutionSchema = z.strictObject({
 export const PlanFinalizationSchema = z.strictObject({
     action: PlanOperatorActionSchema,
     revision: PlanRevisionSchema,
-    fileHash: PlanDigestSchema,
+    fileHash: PlanDigestSchema.nullable(),
     createdAt: z.number().int(),
 });
 // coordinators own semantic review; the core preserves its exact revision-bound evidence
@@ -385,7 +384,7 @@ export const PlanResultSchema = z.discriminatedUnion('kind', [
     z.object({
         kind: z.literal('finalized'),
         result: PlanStatusSchema,
-        content: z.string().max(1_048_576),
+        content: z.string().max(1_048_576).nullable(),
     }),
     z.object({
         kind: z.literal('milestones'),