@specforge/canary-cli 0.1.12 → 0.1.14

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

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+import { PLANNING_PHASES, GUIDANCE_VARIANTS, FINDING_CATEGORIES } from './enums.js';
+export const PlanningSessionAggregateSchema = z.object({
+    planningSessionId: z.string(),
+    projectId: z.string(),
+    specificationId: z.string(),
+    phaseTimeline: z.array(z.object({
+        phase: z.enum(PLANNING_PHASES),
+        enteredAt: z.string().datetime(),
+        exitedAt: z.string().datetime().optional(),
+        durationMs: z.number().int().nonnegative().optional(),
+        // MB.4.6 (R3) — the global readiness score as of this phase's EXIT. Populated
+        // by the projector on close from the running `scoreHistoryGlobal` (the last real
+        // score point at or before `exitedAt`). Optional: the OPEN/terminal entry has no
+        // exit (⇒ no score), and a phase that closes before any real score was recorded
+        // (e.g. an early `planning_spec` exit) has none either. WITHOUT declaring it here
+        // the Zod `z.object()` STRIPS it on any parse/round-trip, so the Planning Timeline
+        // widget's "· score" clause would stay blank. Amplify `phaseTimeline` is `a.json()`
+        // (no model change needed).
+        scoreAtExit: z.number().optional(),
+    })),
+    currentScores: z.object({
+        global: z.number().optional(),
+        perEntity: z.record(z.string(), z.object({
+            type: z.enum(['spec', 'epic', 'ticket']),
+            score: z.number(),
+        })),
+    }),
+    entityCounts: z.object({
+        epic: z.number().int().nonnegative(),
+        ticket: z.number().int().nonnegative(),
+        blueprint: z.number().int().nonnegative(),
+        dependency: z.number().int().nonnegative(),
+    }),
+    entityRevisions: z.record(z.string(), z.object({
+        type: z.enum(['epic', 'ticket', 'blueprint']),
+        title: z.string(),
+        count: z.number().int().nonnegative(),
+        lastRevisedAt: z.string().datetime(),
+    })),
+    opsMix: z.record(z.string(), z.number().int().nonnegative()),
+    // MB.3.3 (MON-C) — first-class monitoring counters. `actionsTotal` == the total
+    // number of folded action rows (≡ Σ opsMix by construction, incl.
+    // get_planning_status/start/handover); `deniedTotal` == the denied subset. The
+    // observatory source-of-truth mirror of `PlanningSession.actionsCount`. Defaulted
+    // to 0 so legacy aggregate rows (which lack these fields) still parse.
+    actionsTotal: z.number().int().nonnegative().default(0),
+    deniedTotal: z.number().int().nonnegative().default(0),
+    scoreHistoryGlobal: z.array(z.object({
+        at: z.string().datetime(),
+        score: z.number(),
+        triggerActionId: z.string(),
+    })),
+    // ── §2.4c telemetry breakdowns (M10.0a) ────────────────────────────────────
+    // All defaulted to empty objects so legacy aggregate rows (which lack these
+    // fields) still parse. Folded by the planning-aggregate-projector (M10.0c).
+    // DeniedActionsByReason (#17): count of denied actions per denyReason.
+    deniedByReason: z.record(z.string(), z.number().int().nonnegative()).default({}),
+    // ActorMixPerPhase (#18): per-phase agent vs human action counts.
+    actorMixPerPhase: z.record(z.enum(PLANNING_PHASES), z.object({
+        agent: z.number().int().nonnegative(),
+        human: z.number().int().nonnegative(),
+    })).default({}),
+    // PhaseTransitionTriggerBreakdown (#19): count of transitions per trigger.
+    triggerBreakdown: z.record(z.string(), z.number().int().nonnegative()).default({}),
+    // GuidanceVariantHistogram (#20): count of actions per produced guidance variant.
+    guidanceVariantCounts: z.record(z.enum(GUIDANCE_VARIANTS), z.number().int().nonnegative()).default({}),
+    // FindingsByCategory (#21): count of findings per FINDING_CATEGORY across actions.
+    findingsByCategory: z.record(z.enum(FINDING_CATEGORIES), z.number().int().nonnegative()).default({}),
+    // ScoreDeltaPerOperation (#24): accumulated {sum,count} of consecutive
+    // scoreAfter deltas keyed by operation (mean = sum/count).
+    scoreDeltaByOperation: z.record(z.string(), z.object({
+        sum: z.number(),
+        count: z.number().int().nonnegative(),
+    })).default({}),
+    lastProcessedActionId: z.string().optional(),
+    lastProcessedTransitionId: z.string().optional(),
+    // MB.3.2 (MON-A) — windowed dedup state. Beyond the monotonic floor
+    // (`lastProcessed*Id`), the projector keeps a bounded, time-windowed set of
+    // recently-processed ids so a late, out-of-order stream record (id below the
+    // floor but within the skew window) is re-folded EXACTLY ONCE instead of being
+    // silently dropped. Persisted as a compact CSV of ULIDs (bounded by
+    // DEDUP_WINDOW_MAX_IDS → item-size-safe). Optional/absent on legacy rows.
+    recentActionWindow: z.string().optional(),
+    recentTransitionWindow: z.string().optional(),
+    lastUpdatedAt: z.string().datetime(),
+});
+//# sourceMappingURL=planning-session-aggregate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planning-session-aggregate.js","sourceRoot":"","sources":["../../src/runtime/planning-session-aggregate.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,574 @@
+import { z } from 'zod';
+export declare const PendingHumanFeedbackSchema: z.ZodObject<{
+    content: z.ZodString;
+    recordedAt: z.ZodString;
+    recordedByUserId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    recordedAt: string;
+    recordedByUserId: string;
+}, {
+    content: string;
+    recordedAt: string;
+    recordedByUserId: string;
+}>;
+export type PendingHumanFeedback = z.infer<typeof PendingHumanFeedbackSchema>;
+export declare const PlanningSessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    specificationId: z.ZodString;
+    projectId: z.ZodString;
+    status: z.ZodEnum<["active", "awaiting_human_review", "closed"]>;
+    currentPhase: z.ZodEnum<["planning_spec", "epic_decomposition", "epic_expansion", "ticket_decomposition", "ticket_expansion", "cross_validation", "planned"]>;
+    startedAt: z.ZodString;
+    lastActionAt: z.ZodString;
+    completedAt: z.ZodOptional<z.ZodString>;
+    closedAt: z.ZodOptional<z.ZodString>;
+    lastScore: z.ZodOptional<z.ZodNumber>;
+    lastGlobalScore: z.ZodOptional<z.ZodNumber>;
+    actionsCount: z.ZodDefault<z.ZodNumber>;
+    lastProcessGuidance: z.ZodOptional<z.ZodObject<{
+        variant: 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"]>;
+        headline: z.ZodString;
+        status: z.ZodObject<{
+            sessionStatus: z.ZodEnum<["active", "awaiting_human_review", "closed"]>;
+            currentPhase: z.ZodEnum<["planning_spec", "epic_decomposition", "epic_expansion", "ticket_decomposition", "ticket_expansion", "cross_validation", "planned"]>;
+            score: z.ZodOptional<z.ZodObject<{
+                current: z.ZodNumber;
+                threshold: z.ZodNumber;
+                gateResult: z.ZodEnum<["pass", "fail"]>;
+                globalContribution: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                current: number;
+                threshold: number;
+                gateResult: "pass" | "fail";
+                globalContribution?: number | undefined;
+            }, {
+                current: number;
+                threshold: number;
+                gateResult: "pass" | "fail";
+                globalContribution?: number | undefined;
+            }>>;
+            actionsCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            sessionStatus: "active" | "awaiting_human_review" | "closed";
+            currentPhase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+            actionsCount: number;
+            score?: {
+                current: number;
+                threshold: number;
+                gateResult: "pass" | "fail";
+                globalContribution?: number | undefined;
+            } | undefined;
+        }, {
+            sessionStatus: "active" | "awaiting_human_review" | "closed";
+            currentPhase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+            actionsCount: number;
+            score?: {
+                current: number;
+                threshold: number;
+                gateResult: "pass" | "fail";
+                globalContribution?: number | undefined;
+            } | undefined;
+        }>;
+        findings: z.ZodOptional<z.ZodObject<{
+            summary: z.ZodString;
+            truncated: z.ZodDefault<z.ZodBoolean>;
+            grouped: z.ZodArray<z.ZodObject<{
+                category: z.ZodEnum<["rubric", "count", "cross-cut", "cascade", "cross-validation", "schema"]>;
+                items: z.ZodArray<z.ZodObject<{
+                    entityId: z.ZodOptional<z.ZodString>;
+                    entityType: z.ZodOptional<z.ZodString>;
+                    path: z.ZodOptional<z.ZodString>;
+                    message: z.ZodString;
+                    severity: z.ZodEnum<["finding", "denial"]>;
+                    pointsLost: z.ZodOptional<z.ZodNumber>;
+                    globalImpactOnFix: z.ZodOptional<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    message: string;
+                    severity: "finding" | "denial";
+                    path?: string | undefined;
+                    entityId?: string | undefined;
+                    entityType?: string | undefined;
+                    pointsLost?: number | undefined;
+                    globalImpactOnFix?: number | undefined;
+                }, {
+                    message: string;
+                    severity: "finding" | "denial";
+                    path?: string | undefined;
+                    entityId?: string | undefined;
+                    entityType?: string | undefined;
+                    pointsLost?: number | undefined;
+                    globalImpactOnFix?: number | undefined;
+                }>, "many">;
+            }, "strip", z.ZodTypeAny, {
+                category: "rubric" | "count" | "cross-cut" | "cascade" | "cross-validation" | "schema";
+                items: {
+                    message: string;
+                    severity: "finding" | "denial";
+                    path?: string | undefined;
+                    entityId?: string | undefined;
+                    entityType?: string | undefined;
+                    pointsLost?: number | undefined;
+                    globalImpactOnFix?: number | undefined;
+                }[];
+            }, {
+                category: "rubric" | "count" | "cross-cut" | "cascade" | "cross-validation" | "schema";
+                items: {
+                    message: string;
+                    severity: "finding" | "denial";
+                    path?: string | undefined;
+                    entityId?: string | undefined;
+                    entityType?: string | undefined;
+                    pointsLost?: number | undefined;
+                    globalImpactOnFix?: number | undefined;
+                }[];
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            summary: string;
+            truncated: boolean;
+            grouped: {
+                category: "rubric" | "count" | "cross-cut" | "cascade" | "cross-validation" | "schema";
+                items: {
+                    message: string;
+                    severity: "finding" | "denial";
+                    path?: string | undefined;
+                    entityId?: string | undefined;
+                    entityType?: string | undefined;
+                    pointsLost?: number | undefined;
+                    globalImpactOnFix?: number | undefined;
+                }[];
+            }[];
+        }, {
+            summary: string;
+            grouped: {
+                category: "rubric" | "count" | "cross-cut" | "cascade" | "cross-validation" | "schema";
+                items: {
+                    message: string;
+                    severity: "finding" | "denial";
+                    path?: string | undefined;
+                    entityId?: string | undefined;
+                    entityType?: string | undefined;
+                    pointsLost?: number | undefined;
+                    globalImpactOnFix?: number | undefined;
+                }[];
+            }[];
+            truncated?: boolean | undefined;
+        }>>;
+        recommendedMoves: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            operation: z.ZodString;
+            rationale: z.ZodString;
+            examplePayload: z.ZodOptional<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            operation: string;
+            rationale: string;
+            examplePayload?: unknown;
+        }, {
+            operation: string;
+            rationale: string;
+            examplePayload?: unknown;
+        }>, "many">>;
+        body: z.ZodString;
+        composedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        variant: "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";
+        status: {
+            sessionStatus: "active" | "awaiting_human_review" | "closed";
+            currentPhase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+            actionsCount: number;
+            score?: {
+                current: number;
+                threshold: number;
+                gateResult: "pass" | "fail";
+                globalContribution?: number | undefined;
+            } | undefined;
+        };
+        headline: string;
+        body: string;
+        composedAt: string;
+        findings?: {
+            summary: string;
+            truncated: boolean;
+            grouped: {
+                category: "rubric" | "count" | "cross-cut" | "cascade" | "cross-validation" | "schema";
+                items: {
+                    message: string;
+                    severity: "finding" | "denial";
+                    path?: string | undefined;
+                    entityId?: string | undefined;
+                    entityType?: string | undefined;
+                    pointsLost?: number | undefined;
+                    globalImpactOnFix?: number | undefined;
+                }[];
+            }[];
+        } | undefined;
+        recommendedMoves?: {
+            operation: string;
+            rationale: string;
+            examplePayload?: unknown;
+        }[] | undefined;
+    }, {
+        variant: "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";
+        status: {
+            sessionStatus: "active" | "awaiting_human_review" | "closed";
+            currentPhase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+            actionsCount: number;
+            score?: {
+                current: number;
+                threshold: number;
+                gateResult: "pass" | "fail";
+                globalContribution?: number | undefined;
+            } | undefined;
+        };
+        headline: string;
+        body: string;
+        composedAt: string;
+        findings?: {
+            summary: string;
+            grouped: {
+                category: "rubric" | "count" | "cross-cut" | "cascade" | "cross-validation" | "schema";
+                items: {
+                    message: string;
+                    severity: "finding" | "denial";
+                    path?: string | undefined;
+                    entityId?: string | undefined;
+                    entityType?: string | undefined;
+                    pointsLost?: number | undefined;
+                    globalImpactOnFix?: number | undefined;
+                }[];
+            }[];
+            truncated?: boolean | undefined;
+        } | undefined;
+        recommendedMoves?: {
+            operation: string;
+            rationale: string;
+            examplePayload?: unknown;
+        }[] | undefined;
+    }>>;
+    lastLifecyclePlanningGuidance: z.ZodOptional<z.ZodObject<{
+        variant: 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"]>;
+        fieldsToFill: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fieldId: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodString;
+            required: z.ZodBoolean;
+            currentState: z.ZodEnum<["empty", "partial", "filled", "na"]>;
+            minCount: z.ZodOptional<z.ZodNumber>;
+            examples: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            shape: z.ZodOptional<z.ZodString>;
+            interview_hooks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            naEligible: z.ZodOptional<z.ZodBoolean>;
+            na_when: z.ZodOptional<z.ZodString>;
+            tier: z.ZodOptional<z.ZodEnum<["critical", "recommended", "standard"]>>;
+        }, "strip", z.ZodTypeAny, {
+            fieldId: string;
+            name: string;
+            description: string;
+            required: boolean;
+            currentState: "empty" | "partial" | "filled" | "na";
+            minCount?: number | undefined;
+            examples?: string[] | undefined;
+            shape?: string | undefined;
+            interview_hooks?: string[] | undefined;
+            naEligible?: boolean | undefined;
+            na_when?: string | undefined;
+            tier?: "critical" | "recommended" | "standard" | undefined;
+        }, {
+            fieldId: string;
+            name: string;
+            description: string;
+            required: boolean;
+            currentState: "empty" | "partial" | "filled" | "na";
+            minCount?: number | undefined;
+            examples?: string[] | undefined;
+            shape?: string | undefined;
+            interview_hooks?: string[] | undefined;
+            naEligible?: boolean | undefined;
+            na_when?: string | undefined;
+            tier?: "critical" | "recommended" | "standard" | undefined;
+        }>, "many">>;
+        humanHandoff: z.ZodOptional<z.ZodObject<{
+            message: z.ZodString;
+            observatoryLink: z.ZodOptional<z.ZodString>;
+            iterationNeeded: z.ZodOptional<z.ZodObject<{
+                focus: z.ZodString;
+                suggestion: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                focus: string;
+                suggestion: string;
+            }, {
+                focus: string;
+                suggestion: string;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            observatoryLink?: string | undefined;
+            iterationNeeded?: {
+                focus: string;
+                suggestion: string;
+            } | undefined;
+        }, {
+            message: string;
+            observatoryLink?: string | undefined;
+            iterationNeeded?: {
+                focus: string;
+                suggestion: string;
+            } | undefined;
+        }>>;
+        postApprovalActions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        composedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        variant: "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";
+        composedAt: string;
+        fieldsToFill?: {
+            fieldId: string;
+            name: string;
+            description: string;
+            required: boolean;
+            currentState: "empty" | "partial" | "filled" | "na";
+            minCount?: number | undefined;
+            examples?: string[] | undefined;
+            shape?: string | undefined;
+            interview_hooks?: string[] | undefined;
+            naEligible?: boolean | undefined;
+            na_when?: string | undefined;
+            tier?: "critical" | "recommended" | "standard" | undefined;
+        }[] | undefined;
+        humanHandoff?: {
+            message: string;
+            observatoryLink?: string | undefined;
+            iterationNeeded?: {
+                focus: string;
+                suggestion: string;
+            } | undefined;
+        } | undefined;
+        postApprovalActions?: string[] | undefined;
+    }, {
+        variant: "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";
+        composedAt: string;
+        fieldsToFill?: {
+            fieldId: string;
+            name: string;
+            description: string;
+            required: boolean;
+            currentState: "empty" | "partial" | "filled" | "na";
+            minCount?: number | undefined;
+            examples?: string[] | undefined;
+            shape?: string | undefined;
+            interview_hooks?: string[] | undefined;
+            naEligible?: boolean | undefined;
+            na_when?: string | undefined;
+            tier?: "critical" | "recommended" | "standard" | undefined;
+        }[] | undefined;
+        humanHandoff?: {
+            message: string;
+            observatoryLink?: string | undefined;
+            iterationNeeded?: {
+                focus: string;
+                suggestion: string;
+            } | undefined;
+        } | undefined;
+        postApprovalActions?: string[] | undefined;
+    }>>;
+    pendingHumanFeedback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        content: z.ZodString;
+        recordedAt: z.ZodString;
+        recordedByUserId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        recordedAt: string;
+        recordedByUserId: string;
+    }, {
+        content: string;
+        recordedAt: string;
+        recordedByUserId: string;
+    }>>>;
+    lastTransitionTrigger: z.ZodEnum<["auto_initial", "ai_agent", "human_approve", "human_reject_with_feedback", "human_reject_no_feedback"]>;
+    lastTransitionAt: z.ZodString;
+    lastReadAt: z.ZodString;
+    lastValidatorOutput: z.ZodOptional<z.ZodUnknown>;
+    lastGateResult: z.ZodOptional<z.ZodEnum<["pass", "fail"]>>;
+    lastValidatedAt: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    status: "active" | "awaiting_human_review" | "closed";
+    currentPhase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+    actionsCount: number;
+    id: string;
+    specificationId: string;
+    projectId: string;
+    startedAt: string;
+    lastActionAt: string;
+    lastTransitionTrigger: "auto_initial" | "ai_agent" | "human_approve" | "human_reject_with_feedback" | "human_reject_no_feedback";
+    lastTransitionAt: string;
+    lastReadAt: string;
+    completedAt?: string | undefined;
+    closedAt?: string | undefined;
+    lastScore?: number | undefined;
+    lastGlobalScore?: number | undefined;
+    lastProcessGuidance?: {
+        variant: "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";
+        status: {
+            sessionStatus: "active" | "awaiting_human_review" | "closed";
+            currentPhase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+            actionsCount: number;
+            score?: {
+                current: number;
+                threshold: number;
+                gateResult: "pass" | "fail";
+                globalContribution?: number | undefined;
+            } | undefined;
+        };
+        headline: string;
+        body: string;
+        composedAt: string;
+        findings?: {
+            summary: string;
+            truncated: boolean;
+            grouped: {
+                category: "rubric" | "count" | "cross-cut" | "cascade" | "cross-validation" | "schema";
+                items: {
+                    message: string;
+                    severity: "finding" | "denial";
+                    path?: string | undefined;
+                    entityId?: string | undefined;
+                    entityType?: string | undefined;
+                    pointsLost?: number | undefined;
+                    globalImpactOnFix?: number | undefined;
+                }[];
+            }[];
+        } | undefined;
+        recommendedMoves?: {
+            operation: string;
+            rationale: string;
+            examplePayload?: unknown;
+        }[] | undefined;
+    } | undefined;
+    lastLifecyclePlanningGuidance?: {
+        variant: "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";
+        composedAt: string;
+        fieldsToFill?: {
+            fieldId: string;
+            name: string;
+            description: string;
+            required: boolean;
+            currentState: "empty" | "partial" | "filled" | "na";
+            minCount?: number | undefined;
+            examples?: string[] | undefined;
+            shape?: string | undefined;
+            interview_hooks?: string[] | undefined;
+            naEligible?: boolean | undefined;
+            na_when?: string | undefined;
+            tier?: "critical" | "recommended" | "standard" | undefined;
+        }[] | undefined;
+        humanHandoff?: {
+            message: string;
+            observatoryLink?: string | undefined;
+            iterationNeeded?: {
+                focus: string;
+                suggestion: string;
+            } | undefined;
+        } | undefined;
+        postApprovalActions?: string[] | undefined;
+    } | undefined;
+    pendingHumanFeedback?: {
+        content: string;
+        recordedAt: string;
+        recordedByUserId: string;
+    } | null | undefined;
+    lastValidatorOutput?: unknown;
+    lastGateResult?: "pass" | "fail" | undefined;
+    lastValidatedAt?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    status: "active" | "awaiting_human_review" | "closed";
+    currentPhase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+    id: string;
+    specificationId: string;
+    projectId: string;
+    startedAt: string;
+    lastActionAt: string;
+    lastTransitionTrigger: "auto_initial" | "ai_agent" | "human_approve" | "human_reject_with_feedback" | "human_reject_no_feedback";
+    lastTransitionAt: string;
+    lastReadAt: string;
+    actionsCount?: number | undefined;
+    completedAt?: string | undefined;
+    closedAt?: string | undefined;
+    lastScore?: number | undefined;
+    lastGlobalScore?: number | undefined;
+    lastProcessGuidance?: {
+        variant: "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";
+        status: {
+            sessionStatus: "active" | "awaiting_human_review" | "closed";
+            currentPhase: "planning_spec" | "epic_decomposition" | "epic_expansion" | "ticket_decomposition" | "ticket_expansion" | "cross_validation" | "planned";
+            actionsCount: number;
+            score?: {
+                current: number;
+                threshold: number;
+                gateResult: "pass" | "fail";
+                globalContribution?: number | undefined;
+            } | undefined;
+        };
+        headline: string;
+        body: string;
+        composedAt: string;
+        findings?: {
+            summary: string;
+            grouped: {
+                category: "rubric" | "count" | "cross-cut" | "cascade" | "cross-validation" | "schema";
+                items: {
+                    message: string;
+                    severity: "finding" | "denial";
+                    path?: string | undefined;
+                    entityId?: string | undefined;
+                    entityType?: string | undefined;
+                    pointsLost?: number | undefined;
+                    globalImpactOnFix?: number | undefined;
+                }[];
+            }[];
+            truncated?: boolean | undefined;
+        } | undefined;
+        recommendedMoves?: {
+            operation: string;
+            rationale: string;
+            examplePayload?: unknown;
+        }[] | undefined;
+    } | undefined;
+    lastLifecyclePlanningGuidance?: {
+        variant: "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";
+        composedAt: string;
+        fieldsToFill?: {
+            fieldId: string;
+            name: string;
+            description: string;
+            required: boolean;
+            currentState: "empty" | "partial" | "filled" | "na";
+            minCount?: number | undefined;
+            examples?: string[] | undefined;
+            shape?: string | undefined;
+            interview_hooks?: string[] | undefined;
+            naEligible?: boolean | undefined;
+            na_when?: string | undefined;
+            tier?: "critical" | "recommended" | "standard" | undefined;
+        }[] | undefined;
+        humanHandoff?: {
+            message: string;
+            observatoryLink?: string | undefined;
+            iterationNeeded?: {
+                focus: string;
+                suggestion: string;
+            } | undefined;
+        } | undefined;
+        postApprovalActions?: string[] | undefined;
+    } | undefined;
+    pendingHumanFeedback?: {
+        content: string;
+        recordedAt: string;
+        recordedByUserId: string;
+    } | null | undefined;
+    lastValidatorOutput?: unknown;
+    lastGateResult?: "pass" | "fail" | undefined;
+    lastValidatedAt?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export type PlanningSession = z.infer<typeof PlanningSessionSchema>;
+//# sourceMappingURL=planning-session.d.ts.map