@specforge/canary-cli 0.1.12 → 0.1.13

package/node_modules/@specforge/session-types/dist/runtime/planning-entity-score-datapoint.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const PlanningEntityScoreDatapointSchema: z.ZodObject<{
+    id: z.ZodString;
+    entityId: z.ZodString;
+    entityType: z.ZodEnum<["spec", "epic", "ticket"]>;
+    planningSessionId: z.ZodString;
+    projectId: z.ZodString;
+    recordedAt: z.ZodString;
+    score: z.ZodNumber;
+    triggerActionId: z.ZodString;
+    trigger: z.ZodEnum<["created", "metadata_updated", "epic_field_updated", "ticket_field_updated", "blueprint_field_updated", "dependency_added", "dependency_removed", "blueprint_linked", "blueprint_unlinked", "cross_val_recompute"]>;
+}, "strip", z.ZodTypeAny, {
+    score: number;
+    entityId: string;
+    entityType: "ticket" | "epic" | "spec";
+    recordedAt: string;
+    id: string;
+    projectId: string;
+    planningSessionId: string;
+    trigger: "created" | "metadata_updated" | "epic_field_updated" | "ticket_field_updated" | "blueprint_field_updated" | "dependency_added" | "dependency_removed" | "blueprint_linked" | "blueprint_unlinked" | "cross_val_recompute";
+    triggerActionId: string;
+}, {
+    score: number;
+    entityId: string;
+    entityType: "ticket" | "epic" | "spec";
+    recordedAt: string;
+    id: string;
+    projectId: string;
+    planningSessionId: string;
+    trigger: "created" | "metadata_updated" | "epic_field_updated" | "ticket_field_updated" | "blueprint_field_updated" | "dependency_added" | "dependency_removed" | "blueprint_linked" | "blueprint_unlinked" | "cross_val_recompute";
+    triggerActionId: string;
+}>;
+export type PlanningEntityScoreDatapoint = z.infer<typeof PlanningEntityScoreDatapointSchema>;
+//# sourceMappingURL=planning-entity-score-datapoint.d.ts.map

package/node_modules/@specforge/session-types/dist/runtime/planning-entity-score-datapoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-entity-score-datapoint.d.ts","sourceRoot":"","sources":["../../src/runtime/planning-entity-score-datapoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC"}

package/node_modules/@specforge/session-types/dist/runtime/planning-entity-score-datapoint.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { DATAPOINT_TRIGGERS } from './enums.js';
+export const PlanningEntityScoreDatapointSchema = z.object({
+    id: z.string(),
+    entityId: z.string(),
+    entityType: z.enum(['spec', 'epic', 'ticket']),
+    planningSessionId: z.string(),
+    projectId: z.string(),
+    recordedAt: z.string().datetime(),
+    score: z.number(),
+    triggerActionId: z.string(),
+    trigger: z.enum(DATAPOINT_TRIGGERS),
+});
+//# sourceMappingURL=planning-entity-score-datapoint.js.map

package/node_modules/@specforge/session-types/dist/runtime/planning-entity-score-datapoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-entity-score-datapoint.js","sourceRoot":"","sources":["../../src/runtime/planning-entity-score-datapoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC9C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;CACpC,CAAC,CAAC"}

package/node_modules/@specforge/session-types/dist/runtime/planning-operations.d.ts

@@ -0,0 +1,6 @@
+export declare const PLANNING_MUTATING_OPERATIONS: readonly ["update_spec", "create_epic", "update_epic", "delete_epic", "create_ticket", "update_ticket", "delete_ticket", "create_blueprint", "update_blueprint", "delete_blueprint", "link_blueprint_to_tickets", "unlink_blueprint_to_tickets", "create_dependencies", "delete_dependencies", "justify", "unjustify"];
+export declare const PLANNING_READ_ONLY_OPERATIONS: readonly ["get_planning_status"];
+export declare const PLANNING_SYNTHETIC_OPERATIONS: readonly ["start_planning_session", "complete_planning_session", "phase_complete", "phase_advance", "phase_rollback", "human_approve", "human_reject_with_feedback", "human_reject_no_feedback", "session_closed"];
+export declare const PLANNING_OPERATIONS: readonly ["update_spec", "create_epic", "update_epic", "delete_epic", "create_ticket", "update_ticket", "delete_ticket", "create_blueprint", "update_blueprint", "delete_blueprint", "link_blueprint_to_tickets", "unlink_blueprint_to_tickets", "create_dependencies", "delete_dependencies", "justify", "unjustify", "get_planning_status", "start_planning_session", "complete_planning_session", "phase_complete", "phase_advance", "phase_rollback", "human_approve", "human_reject_with_feedback", "human_reject_no_feedback", "session_closed"];
+export type PlanningOperationName = typeof PLANNING_OPERATIONS[number];
+//# sourceMappingURL=planning-operations.d.ts.map

package/node_modules/@specforge/session-types/dist/runtime/planning-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-operations.d.ts","sourceRoot":"","sources":["../../src/runtime/planning-operations.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,wTAa/B,CAAC;AAEX,eAAO,MAAM,6BAA6B,kCAAmC,CAAC;AAE9E,eAAO,MAAM,6BAA6B,oNAUhC,CAAC;AAEX,eAAO,MAAM,mBAAmB,whBAItB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC"}

package/node_modules/@specforge/session-types/dist/runtime/planning-operations.js

@@ -0,0 +1,32 @@
+export const PLANNING_MUTATING_OPERATIONS = [
+    'update_spec',
+    'create_epic', 'update_epic', 'delete_epic',
+    'create_ticket', 'update_ticket', 'delete_ticket',
+    'create_blueprint', 'update_blueprint', 'delete_blueprint',
+    'link_blueprint_to_tickets', 'unlink_blueprint_to_tickets',
+    'create_dependencies', 'delete_dependencies',
+    // MB.11.1 — the paired N/A-justification op (declare + remove), mirroring
+    // create/delete_dependencies + link/unlink_blueprint_to_tickets. `justify` gives
+    // N/A declaration its own door so it stops overloading `update_*{fieldDeclarations}`
+    // (the source of the cross_validation rollback + canonical-key bugs). Structural-
+    // neutral → native in every phase, never rolls back (see operations-registry.ts).
+    'justify', 'unjustify',
+];
+export const PLANNING_READ_ONLY_OPERATIONS = ['get_planning_status'];
+export const PLANNING_SYNTHETIC_OPERATIONS = [
+    'start_planning_session',
+    'complete_planning_session',
+    'phase_complete',
+    'phase_advance',
+    'phase_rollback',
+    'human_approve',
+    'human_reject_with_feedback',
+    'human_reject_no_feedback',
+    'session_closed',
+];
+export const PLANNING_OPERATIONS = [
+    ...PLANNING_MUTATING_OPERATIONS,
+    ...PLANNING_READ_ONLY_OPERATIONS,
+    ...PLANNING_SYNTHETIC_OPERATIONS,
+];
+//# sourceMappingURL=planning-operations.js.map

package/node_modules/@specforge/session-types/dist/runtime/planning-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-operations.js","sourceRoot":"","sources":["../../src/runtime/planning-operations.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,aAAa;IACb,aAAa,EAAE,aAAa,EAAE,aAAa;IAC3C,eAAe,EAAE,eAAe,EAAE,eAAe;IACjD,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB;IAC1D,2BAA2B,EAAE,6BAA6B;IAC1D,qBAAqB,EAAE,qBAAqB;IAC5C,0EAA0E;IAC1E,iFAAiF;IACjF,qFAAqF;IACrF,kFAAkF;IAClF,kFAAkF;IAClF,SAAS,EAAE,WAAW;CACd,CAAC;AAEX,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,qBAAqB,CAAU,CAAC;AAE9E,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,wBAAwB;IACxB,2BAA2B;IAC3B,gBAAgB;IAChB,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,4BAA4B;IAC5B,0BAA0B;IAC1B,gBAAgB;CACR,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,4BAA4B;IAC/B,GAAG,6BAA6B;IAChC,GAAG,6BAA6B;CACxB,CAAC"}

package/node_modules/@specforge/session-types/dist/runtime/planning-phase-transition.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const PlanningPhaseTransitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    planningSessionId: z.ZodString;
+    projectId: z.ZodOptional<z.ZodString>;
+    fromPhase: z.ZodEnum<["planning_spec", "epic_decomposition", "epic_expansion", "ticket_decomposition", "ticket_expansion", "cross_validation", "planned"]>;
+    toPhase: z.ZodEnum<["planning_spec", "epic_decomposition", "epic_expansion", "ticket_decomposition", "ticket_expansion", "cross_validation", "planned"]>;
+    trigger: z.ZodEnum<["auto_initial", "ai_agent", "human_approve", "human_reject_with_feedback", "human_reject_no_feedback"]>;
+    triggeredAt: z.ZodString;
+    triggeredByUserId: z.ZodOptional<z.ZodString>;
+    notes: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    planningSessionId: string;
+    fromPhase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+    toPhase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+    trigger: "auto_initial" | "ai_agent" | "human_approve" | "human_reject_with_feedback" | "human_reject_no_feedback";
+    triggeredAt: string;
+    projectId?: string | undefined;
+    triggeredByUserId?: string | undefined;
+    notes?: string | undefined;
+}, {
+    id: string;
+    planningSessionId: string;
+    fromPhase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+    toPhase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+    trigger: "auto_initial" | "ai_agent" | "human_approve" | "human_reject_with_feedback" | "human_reject_no_feedback";
+    triggeredAt: string;
+    projectId?: string | undefined;
+    triggeredByUserId?: string | undefined;
+    notes?: string | undefined;
+}>;
+export type PlanningPhaseTransition = z.infer<typeof PlanningPhaseTransitionSchema>;
+//# sourceMappingURL=planning-phase-transition.d.ts.map

package/node_modules/@specforge/session-types/dist/runtime/planning-phase-transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-phase-transition.d.ts","sourceRoot":"","sources":["../../src/runtime/planning-phase-transition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/node_modules/@specforge/session-types/dist/runtime/planning-phase-transition.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { PLANNING_PHASES, TRANSITION_TRIGGERS } from './enums.js';
+export const PlanningPhaseTransitionSchema = z.object({
+    id: z.string(),
+    planningSessionId: z.string(),
+    // MB.3.1 (MON-B) — the PlanningPhaseTransition Amplify model declares
+    // `projectId` as REQUIRED, and the notifier's createPlanningPhaseTransition
+    // mutation fails input validation without it. `buildTransition` now always
+    // sets it from the session context. Kept OPTIONAL on the DOMAIN schema so the
+    // AppSync read-store `parseTransition` (which selects no projectId) and any
+    // legacy pre-MB.3.1 row without the attribute still parse — the value is only
+    // consumed by the writer/notifier, never re-read (the aggregate derives
+    // projectId from the session context, not from the transition row).
+    projectId: z.string().optional(),
+    fromPhase: z.enum(PLANNING_PHASES),
+    toPhase: z.enum(PLANNING_PHASES),
+    trigger: z.enum(TRANSITION_TRIGGERS),
+    triggeredAt: z.string().datetime(),
+    triggeredByUserId: z.string().optional(),
+    notes: z.string().optional(),
+});
+//# sourceMappingURL=planning-phase-transition.js.map

package/node_modules/@specforge/session-types/dist/runtime/planning-phase-transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-phase-transition.js","sourceRoot":"","sources":["../../src/runtime/planning-phase-transition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,sEAAsE;IACtE,4EAA4E;IAC5E,2EAA2E;IAC3E,8EAA8E;IAC9E,4EAA4E;IAC5E,8EAA8E;IAC9E,wEAAwE;IACxE,oEAAoE;IACpE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;IACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC"}

package/node_modules/@specforge/session-types/dist/runtime/planning-session-action.d.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+export declare const PlanningSessionActionSchema: z.ZodObject<{
+    id: z.ZodString;
+    planningSessionId: z.ZodString;
+    projectId: z.ZodOptional<z.ZodString>;
+    performedAt: z.ZodString;
+    phase: z.ZodEnum<["planning_spec", "epic_decomposition", "epic_expansion", "ticket_decomposition", "ticket_expansion", "cross_validation", "planned"]>;
+    operation: z.ZodString;
+    payload: z.ZodOptional<z.ZodUnknown>;
+    entityType: z.ZodOptional<z.ZodEnum<["spec", "epic", "ticket", "blueprint", "acceptanceCriterion", "implementationStep", "ticketDependency"]>>;
+    entityId: z.ZodOptional<z.ZodString>;
+    fieldsChanged: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    outcome: z.ZodEnum<["success", "denied"]>;
+    denyReason: z.ZodOptional<z.ZodString>;
+    denyDetails: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    scoreAfter: z.ZodOptional<z.ZodNumber>;
+    globalScoreAfter: z.ZodOptional<z.ZodNumber>;
+    perEntityScoresAfter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    humanInstruction: z.ZodOptional<z.ZodString>;
+    targetActionId: z.ZodOptional<z.ZodString>;
+    performedByActor: z.ZodEnum<["agent", "human"]>;
+    performedByUserId: z.ZodOptional<z.ZodString>;
+    guidanceVariant: z.ZodOptional<z.ZodEnum<["denied", "gate_failed", "gate_passed", "human_handover", "human_feedback", "phase_advance", "phase_rollback", "phase_complete", "phase_status_report", "awaiting_human_review_handover", "human_feedback_received", "human_rejected_no_feedback", "phase_advanced_after_approve", "session_closed"]>>;
+    findingsCategories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    operation: string;
+    id: string;
+    planningSessionId: string;
+    performedAt: string;
+    phase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+    outcome: "success" | "denied";
+    performedByActor: "agent" | "human";
+    entityId?: string | undefined;
+    entityType?: "ticket" | "epic" | "spec" | "blueprint" | "acceptanceCriterion" | "implementationStep" | "ticketDependency" | undefined;
+    projectId?: string | undefined;
+    payload?: unknown;
+    fieldsChanged?: string[] | undefined;
+    denyReason?: string | undefined;
+    denyDetails?: Record<string, unknown> | undefined;
+    scoreAfter?: number | undefined;
+    globalScoreAfter?: number | undefined;
+    perEntityScoresAfter?: Record<string, number> | undefined;
+    humanInstruction?: string | undefined;
+    targetActionId?: string | undefined;
+    performedByUserId?: string | undefined;
+    guidanceVariant?: "denied" | "gate_failed" | "gate_passed" | "human_handover" | "human_feedback" | "phase_advance" | "phase_rollback" | "phase_complete" | "phase_status_report" | "awaiting_human_review_handover" | "human_feedback_received" | "human_rejected_no_feedback" | "phase_advanced_after_approve" | "session_closed" | undefined;
+    findingsCategories?: string[] | undefined;
+}, {
+    operation: string;
+    id: string;
+    planningSessionId: string;
+    performedAt: string;
+    phase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+    outcome: "success" | "denied";
+    performedByActor: "agent" | "human";
+    entityId?: string | undefined;
+    entityType?: "ticket" | "epic" | "spec" | "blueprint" | "acceptanceCriterion" | "implementationStep" | "ticketDependency" | undefined;
+    projectId?: string | undefined;
+    payload?: unknown;
+    fieldsChanged?: string[] | undefined;
+    denyReason?: string | undefined;
+    denyDetails?: Record<string, unknown> | undefined;
+    scoreAfter?: number | undefined;
+    globalScoreAfter?: number | undefined;
+    perEntityScoresAfter?: Record<string, number> | undefined;
+    humanInstruction?: string | undefined;
+    targetActionId?: string | undefined;
+    performedByUserId?: string | undefined;
+    guidanceVariant?: "denied" | "gate_failed" | "gate_passed" | "human_handover" | "human_feedback" | "phase_advance" | "phase_rollback" | "phase_complete" | "phase_status_report" | "awaiting_human_review_handover" | "human_feedback_received" | "human_rejected_no_feedback" | "phase_advanced_after_approve" | "session_closed" | undefined;
+    findingsCategories?: string[] | undefined;
+}>;
+export type PlanningSessionAction = z.infer<typeof PlanningSessionActionSchema>;
+//# sourceMappingURL=planning-session-action.d.ts.map

package/node_modules/@specforge/session-types/dist/runtime/planning-session-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-session-action.d.ts","sourceRoot":"","sources":["../../src/runtime/planning-session-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoDtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/node_modules/@specforge/session-types/dist/runtime/planning-session-action.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { PLANNING_PHASES, OUTCOMES, GUIDANCE_VARIANTS } from './enums.js';
+export const PlanningSessionActionSchema = z.object({
+    id: z.string(),
+    planningSessionId: z.string(),
+    // MB.4.1 (S1) — the `PlanningSessionAction` Amplify model declares `projectId`
+    // as REQUIRED (denormalized), but neither the domain builder nor the executor
+    // ever wrote it. A raw action row therefore lands with a NULL required field, so
+    // (a) the `listPlanningSessionAction…` read errors null-for-required → the
+    // action log spins "Loading…" forever in ANY spec, and (b) the notifier's
+    // `createPlanningSessionAction` mutation fails input validation → the
+    // `onCreatePlanningSessionAction` subscription never fires (dead live push). Fix:
+    // `buildAction` now always sets it from the session context (mirror of MB.3.1's
+    // transition fix). Kept OPTIONAL on the DOMAIN schema so any legacy pre-MB.4.1 row
+    // (absent attribute) still parses — the value is only consumed by the
+    // writer/notifier, never re-read (the aggregate derives projectId from the
+    // session context, not from the action row).
+    projectId: z.string().optional(),
+    performedAt: z.string().datetime(),
+    phase: z.enum(PLANNING_PHASES),
+    operation: z.string(),
+    payload: z.unknown().optional(),
+    entityType: z.enum([
+        'spec', 'epic', 'ticket', 'blueprint',
+        'acceptanceCriterion', 'implementationStep', 'ticketDependency',
+    ]).optional(),
+    entityId: z.string().optional(),
+    fieldsChanged: z.array(z.string()).optional(),
+    outcome: z.enum(OUTCOMES),
+    denyReason: z.string().optional(),
+    denyDetails: z.record(z.string(), z.unknown()).optional(),
+    scoreAfter: z.number().optional(),
+    // MB.7.1 — the phase-WEIGHTED global readiness score in effect after this action
+    // (`validatorOutput.globalScore`; the same value persisted as
+    // `PlanningSession.lastGlobalScore`). Distinct from the phase-LOCAL `scoreAfter`,
+    // whose semantics change per phase (spec-local → epic-avg → ticket-avg). This is the
+    // ONLY stream source the projector's `scoreHistoryGlobal` fold has for the weighted
+    // global — before MB.7.1 the Readiness Trending "Global" line mis-plotted the local
+    // `scoreAfter`. Optional so legacy pre-MB.7.1 rows (absent attribute) still parse.
+    globalScoreAfter: z.number().optional(),
+    perEntityScoresAfter: z.record(z.string(), z.number()).optional(),
+    humanInstruction: z.string().optional(),
+    targetActionId: z.string().optional(),
+    performedByActor: z.enum(['agent', 'human']),
+    performedByUserId: z.string().optional(),
+    // ── M10.0a write-side capture fields (populated by M10.0b) ──────────────────
+    // The guidance variant this action produced + the distinct FINDING_CATEGORIES
+    // from its ProcessGuidance.findings.grouped. Optional so legacy action rows
+    // (absent fields) still parse. Folded by M10.0c into guidanceVariantCounts /
+    // findingsByCategory on the aggregate — they are the only stream source those
+    // two folds have (the variant/findings otherwise live only on the latest-only
+    // PlanningSession.lastProcessGuidance snapshot the projector does not read).
+    guidanceVariant: z.enum(GUIDANCE_VARIANTS).optional(),
+    findingsCategories: z.array(z.string()).optional(),
+});
+//# sourceMappingURL=planning-session-action.js.map

package/node_modules/@specforge/session-types/dist/runtime/planning-session-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-session-action.js","sourceRoot":"","sources":["../../src/runtime/planning-session-action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,+EAA+E;IAC/E,8EAA8E;IAC9E,iFAAiF;IACjF,2EAA2E;IAC3E,0EAA0E;IAC1E,sEAAsE;IACtE,kFAAkF;IAClF,gFAAgF;IAChF,mFAAmF;IACnF,sEAAsE;IACtE,2EAA2E;IAC3E,6CAA6C;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW;QACrC,qBAAqB,EAAE,oBAAoB,EAAE,kBAAkB;KAChE,CAAC,CAAC,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IACzB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,iFAAiF;IACjF,8DAA8D;IAC9D,kFAAkF;IAClF,qFAAqF;IACrF,oFAAoF;IACpF,oFAAoF;IACpF,mFAAmF;IACnF,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,oBAAoB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACjE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,+EAA+E;IAC/E,8EAA8E;IAC9E,4EAA4E;IAC5E,6EAA6E;IAC7E,8EAA8E;IAC9E,8EAA8E;IAC9E,6EAA6E;IAC7E,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;IACrD,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC"}

package/node_modules/@specforge/session-types/dist/runtime/planning-session-aggregate.d.ts

@@ -0,0 +1,239 @@
+import { z } from 'zod';
+export declare const PlanningSessionAggregateSchema: z.ZodObject<{
+    planningSessionId: z.ZodString;
+    projectId: z.ZodString;
+    specificationId: z.ZodString;
+    phaseTimeline: z.ZodArray<z.ZodObject<{
+        phase: z.ZodEnum<["planning_spec", "epic_decomposition", "epic_expansion", "ticket_decomposition", "ticket_expansion", "cross_validation", "planned"]>;
+        enteredAt: z.ZodString;
+        exitedAt: z.ZodOptional<z.ZodString>;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        scoreAtExit: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        phase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+        enteredAt: string;
+        exitedAt?: string | undefined;
+        durationMs?: number | undefined;
+        scoreAtExit?: number | undefined;
+    }, {
+        phase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+        enteredAt: string;
+        exitedAt?: string | undefined;
+        durationMs?: number | undefined;
+        scoreAtExit?: number | undefined;
+    }>, "many">;
+    currentScores: z.ZodObject<{
+        global: z.ZodOptional<z.ZodNumber>;
+        perEntity: z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<["spec", "epic", "ticket"]>;
+            score: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            type: "ticket" | "epic" | "spec";
+            score: number;
+        }, {
+            type: "ticket" | "epic" | "spec";
+            score: number;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        perEntity: Record<string, {
+            type: "ticket" | "epic" | "spec";
+            score: number;
+        }>;
+        global?: number | undefined;
+    }, {
+        perEntity: Record<string, {
+            type: "ticket" | "epic" | "spec";
+            score: number;
+        }>;
+        global?: number | undefined;
+    }>;
+    entityCounts: z.ZodObject<{
+        epic: z.ZodNumber;
+        ticket: z.ZodNumber;
+        blueprint: z.ZodNumber;
+        dependency: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        ticket: number;
+        epic: number;
+        blueprint: number;
+        dependency: number;
+    }, {
+        ticket: number;
+        epic: number;
+        blueprint: number;
+        dependency: number;
+    }>;
+    entityRevisions: z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<["epic", "ticket", "blueprint"]>;
+        title: z.ZodString;
+        count: z.ZodNumber;
+        lastRevisedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        type: "ticket" | "epic" | "blueprint";
+        title: string;
+        lastRevisedAt: string;
+    }, {
+        count: number;
+        type: "ticket" | "epic" | "blueprint";
+        title: string;
+        lastRevisedAt: string;
+    }>>;
+    opsMix: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    actionsTotal: z.ZodDefault<z.ZodNumber>;
+    deniedTotal: z.ZodDefault<z.ZodNumber>;
+    scoreHistoryGlobal: z.ZodArray<z.ZodObject<{
+        at: z.ZodString;
+        score: z.ZodNumber;
+        triggerActionId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        score: number;
+        triggerActionId: string;
+    }, {
+        at: string;
+        score: number;
+        triggerActionId: string;
+    }>, "many">;
+    deniedByReason: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    actorMixPerPhase: z.ZodDefault<z.ZodRecord<z.ZodEnum<["planning_spec", "epic_decomposition", "epic_expansion", "ticket_decomposition", "ticket_expansion", "cross_validation", "planned"]>, z.ZodObject<{
+        agent: z.ZodNumber;
+        human: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        agent: number;
+        human: number;
+    }, {
+        agent: number;
+        human: number;
+    }>>>;
+    triggerBreakdown: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    guidanceVariantCounts: z.ZodDefault<z.ZodRecord<z.ZodEnum<["denied", "gate_failed", "gate_passed", "human_handover", "human_feedback", "phase_advance", "phase_rollback", "phase_complete", "phase_status_report", "awaiting_human_review_handover", "human_feedback_received", "human_rejected_no_feedback", "phase_advanced_after_approve", "session_closed"]>, z.ZodNumber>>;
+    findingsByCategory: z.ZodDefault<z.ZodRecord<z.ZodEnum<["rubric", "count", "cross-cut", "cascade", "cross-validation", "schema"]>, z.ZodNumber>>;
+    scoreDeltaByOperation: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        sum: z.ZodNumber;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        sum: number;
+    }, {
+        count: number;
+        sum: number;
+    }>>>;
+    lastProcessedActionId: z.ZodOptional<z.ZodString>;
+    lastProcessedTransitionId: z.ZodOptional<z.ZodString>;
+    recentActionWindow: z.ZodOptional<z.ZodString>;
+    recentTransitionWindow: z.ZodOptional<z.ZodString>;
+    lastUpdatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    specificationId: string;
+    projectId: string;
+    planningSessionId: string;
+    phaseTimeline: {
+        phase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+        enteredAt: string;
+        exitedAt?: string | undefined;
+        durationMs?: number | undefined;
+        scoreAtExit?: number | undefined;
+    }[];
+    currentScores: {
+        perEntity: Record<string, {
+            type: "ticket" | "epic" | "spec";
+            score: number;
+        }>;
+        global?: number | undefined;
+    };
+    entityCounts: {
+        ticket: number;
+        epic: number;
+        blueprint: number;
+        dependency: number;
+    };
+    entityRevisions: Record<string, {
+        count: number;
+        type: "ticket" | "epic" | "blueprint";
+        title: string;
+        lastRevisedAt: string;
+    }>;
+    opsMix: Record<string, number>;
+    actionsTotal: number;
+    deniedTotal: number;
+    scoreHistoryGlobal: {
+        at: string;
+        score: number;
+        triggerActionId: string;
+    }[];
+    deniedByReason: Record<string, number>;
+    actorMixPerPhase: Partial<Record<"planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned", {
+        agent: number;
+        human: number;
+    }>>;
+    triggerBreakdown: Record<string, number>;
+    guidanceVariantCounts: Partial<Record<"denied" | "gate_failed" | "gate_passed" | "human_handover" | "human_feedback" | "phase_advance" | "phase_rollback" | "phase_complete" | "phase_status_report" | "awaiting_human_review_handover" | "human_feedback_received" | "human_rejected_no_feedback" | "phase_advanced_after_approve" | "session_closed", number>>;
+    findingsByCategory: Partial<Record<"rubric" | "count" | "cross-cut" | "cascade" | "cross-validation" | "schema", number>>;
+    scoreDeltaByOperation: Record<string, {
+        count: number;
+        sum: number;
+    }>;
+    lastUpdatedAt: string;
+    lastProcessedActionId?: string | undefined;
+    lastProcessedTransitionId?: string | undefined;
+    recentActionWindow?: string | undefined;
+    recentTransitionWindow?: string | undefined;
+}, {
+    specificationId: string;
+    projectId: string;
+    planningSessionId: string;
+    phaseTimeline: {
+        phase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+        enteredAt: string;
+        exitedAt?: string | undefined;
+        durationMs?: number | undefined;
+        scoreAtExit?: number | undefined;
+    }[];
+    currentScores: {
+        perEntity: Record<string, {
+            type: "ticket" | "epic" | "spec";
+            score: number;
+        }>;
+        global?: number | undefined;
+    };
+    entityCounts: {
+        ticket: number;
+        epic: number;
+        blueprint: number;
+        dependency: number;
+    };
+    entityRevisions: Record<string, {
+        count: number;
+        type: "ticket" | "epic" | "blueprint";
+        title: string;
+        lastRevisedAt: string;
+    }>;
+    opsMix: Record<string, number>;
+    scoreHistoryGlobal: {
+        at: string;
+        score: number;
+        triggerActionId: string;
+    }[];
+    lastUpdatedAt: string;
+    actionsTotal?: number | undefined;
+    deniedTotal?: number | undefined;
+    deniedByReason?: Record<string, number> | undefined;
+    actorMixPerPhase?: Partial<Record<"planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned", {
+        agent: number;
+        human: number;
+    }>> | undefined;
+    triggerBreakdown?: Record<string, number> | undefined;
+    guidanceVariantCounts?: Partial<Record<"denied" | "gate_failed" | "gate_passed" | "human_handover" | "human_feedback" | "phase_advance" | "phase_rollback" | "phase_complete" | "phase_status_report" | "awaiting_human_review_handover" | "human_feedback_received" | "human_rejected_no_feedback" | "phase_advanced_after_approve" | "session_closed", number>> | undefined;
+    findingsByCategory?: Partial<Record<"rubric" | "count" | "cross-cut" | "cascade" | "cross-validation" | "schema", number>> | undefined;
+    scoreDeltaByOperation?: Record<string, {
+        count: number;
+        sum: number;
+    }> | undefined;
+    lastProcessedActionId?: string | undefined;
+    lastProcessedTransitionId?: string | undefined;
+    recentActionWindow?: string | undefined;
+    recentTransitionWindow?: string | undefined;
+}>;
+export type PlanningSessionAggregate = z.infer<typeof PlanningSessionAggregateSchema>;
+//# sourceMappingURL=planning-session-aggregate.d.ts.map

package/node_modules/@specforge/session-types/dist/runtime/planning-session-aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-session-aggregate.d.ts","sourceRoot":"","sources":["../../src/runtime/planning-session-aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0FzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}