jg-agent-hq 0.1.0 → 0.3.0

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,11 +757,64 @@ 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<{
+    sourceRevision: z.ZodObject<{
+        planDigest: z.ZodString;
+        breakdownDigest: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    targetDirectory: z.ZodString;
+    targetRevision: z.ZodObject<{
+        planDigest: z.ZodString;
+        breakdownDigest: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    verdict: z.ZodEnum<{
+        compatible: "compatible";
+        contradiction: "contradiction";
+    }>;
+    reason: z.ZodString;
+    reviewer: z.ZodObject<{
+        provider: z.ZodEnum<{
+            claude: "claude";
+            codex: "codex";
+        }>;
+        cliVersion: z.ZodString;
+        model: z.ZodNullable<z.ZodString>;
+        reference: z.ZodString;
+    }, z.core.$strict>;
+    reviewedAt: z.ZodNumber;
+}, z.core.$strict>;
+export type IPlanComparison = z.infer<typeof PlanComparisonSchema>;
 export declare const PlanCoordinationSchema: z.ZodObject<{
     schemaVersion: z.ZodLiteral<1>;
+    comparisons: z.ZodArray<z.ZodObject<{
+        sourceRevision: z.ZodObject<{
+            planDigest: z.ZodString;
+            breakdownDigest: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        targetDirectory: z.ZodString;
+        targetRevision: z.ZodObject<{
+            planDigest: z.ZodString;
+            breakdownDigest: z.ZodNullable<z.ZodString>;
+        }, z.core.$strict>;
+        verdict: z.ZodEnum<{
+            compatible: "compatible";
+            contradiction: "contradiction";
+        }>;
+        reason: z.ZodString;
+        reviewer: z.ZodObject<{
+            provider: z.ZodEnum<{
+                claude: "claude";
+                codex: "codex";
+            }>;
+            cliVersion: z.ZodString;
+            model: z.ZodNullable<z.ZodString>;
+            reference: z.ZodString;
+        }, z.core.$strict>;
+        reviewedAt: z.ZodNumber;
+    }, z.core.$strict>>;
     finalized: z.ZodNullable<z.ZodObject<{
         action: z.ZodObject<{
             id: z.ZodUUID;
@@ -778,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<{
@@ -890,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>;
@@ -898,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;
@@ -1012,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;
@@ -1062,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;
@@ -1115,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;
@@ -1216,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<{
@@ -1299,6 +1352,7 @@ export declare const PlanCoordinationSummarySchema: z.ZodObject<{
             closeActionId: z.ZodUUID;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
+    comparisonCount: z.ZodNumber;
     completionCount: z.ZodNumber;
     revision: z.ZodNullable<z.ZodObject<{
         createdAt: z.ZodNumber;
@@ -1432,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<{
@@ -1515,6 +1569,7 @@ export declare const PlanStatusSchema: z.ZodObject<{
                 closeActionId: z.ZodUUID;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
+        comparisonCount: z.ZodNumber;
         completionCount: z.ZodNumber;
         revision: z.ZodNullable<z.ZodObject<{
             createdAt: z.ZodNumber;
@@ -1661,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>;
@@ -1669,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;
@@ -1816,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<{
@@ -1899,6 +1954,7 @@ export declare const PlanResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     closeActionId: z.ZodUUID;
                 }, z.core.$strict>>;
             }, z.core.$strict>>;
+            comparisonCount: z.ZodNumber;
             completionCount: z.ZodNumber;
             revision: z.ZodNullable<z.ZodObject<{
                 createdAt: z.ZodNumber;
@@ -2035,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<{
@@ -2118,6 +2174,7 @@ export declare const PlanResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     closeActionId: z.ZodUUID;
                 }, z.core.$strict>>;
             }, z.core.$strict>>;
+            comparisonCount: z.ZodNumber;
             completionCount: z.ZodNumber;
             revision: z.ZodNullable<z.ZodObject<{
                 createdAt: z.ZodNumber;
@@ -2222,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>;
@@ -2230,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;
@@ -2378,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<{
@@ -2461,6 +2518,7 @@ export declare const PlanResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     closeActionId: z.ZodUUID;
                 }, z.core.$strict>>;
             }, z.core.$strict>>;
+            comparisonCount: z.ZodNumber;
             completionCount: z.ZodNumber;
             revision: z.ZodNullable<z.ZodObject<{
                 createdAt: z.ZodNumber;
@@ -2516,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,11 +266,27 @@ 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
+export const PlanComparisonSchema = z.strictObject({
+    sourceRevision: PlanRevisionSchema,
+    targetDirectory: z.string().min(1).max(4096),
+    targetRevision: PlanRevisionSchema,
+    verdict: z.enum(['compatible', 'contradiction']),
+    reason: z.string().min(1).max(4096),
+    reviewer: z.strictObject({
+        provider: z.enum(['claude', 'codex']),
+        cliVersion: z.string().min(1).max(128),
+        model: z.string().min(1).max(256).nullable(),
+        reference: z.string().min(1).max(4096),
+    }),
+    reviewedAt: z.number().int().nonnegative(),
+});
 export const PlanCoordinationSchema = z.strictObject({
     schemaVersion: z.literal(1),
+    comparisons: z.array(PlanComparisonSchema).max(1024),
     finalized: PlanFinalizationSchema.nullable(),
     planApproval: PlanApprovalSchema.nullable(),
     sequenceApproval: PlanApprovalSchema.nullable(),
@@ -294,11 +309,13 @@ export const PlanCoordinationSchema = z.strictObject({
 });
 // collection bodies remain in the file owner and paged SQLite projections
 export const PlanCoordinationSummarySchema = PlanCoordinationSchema.omit({
+    comparisons: true,
     completions: true,
     correspondences: true,
     revision: true,
     baseline: true,
 }).extend({
+    comparisonCount: z.number().int().nonnegative(),
     completionCount: z.number().int().nonnegative(),
     revision: PlanRevisionWorkflowSchema.omit({
         checkpoint: true,
@@ -367,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'),