@specforge/cli 0.1.0 → 0.2.5

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

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+/**
+ * Planning lifecycle config — the canonical contract type, resolved per-project/spec
+ * and persisted via the IConfigStore (domain `planning-lifecycle`). Lives here in
+ * session-types (alongside the other planning contracts + IConfigStore) so every
+ * consumer shares ONE source: the lifecycle resolver, and the M8.7 project-stream
+ * config-bootstrap in operations, both import from here — no operations→lifecycle dep.
+ *
+ * Behaviour (deepMerge + PlanningLifecycleConfigResolver) stays in @specforge/lifecycle.
+ */
+export const PLANNING_LIFECYCLE_CONFIG_DOMAIN = 'planning-lifecycle';
+// ME.10.5 — bumped 1 → 2 after the clean-break trim (thresholds, arrayCountPhases
+// removed; gate knobs moved to the validator config). No migration — greenfield wipe.
+export const PLANNING_LIFECYCLE_CONFIG_SCHEMA_VERSION = 2;
+export const PlanningLifecycleConfigSchema = z.object({
+    // ME.10.3 — the entity-count bounds (minEpics/maxEpics/min/maxTicketsPerEpic) moved
+    // to the validator config (domain `planning`,
+    // ValidatorConfig.structuralRequirements.arrayMin/MaxCounts) as the single owner.
+    // ME.10.4 — the blueprint:epic ratio also moved to the validator config
+    // (ValidatorConfig.crossValidation.ratios.blueprintToEpic.min), emptying
+    // `arrayCountPhases` entirely — the object is gone.
+    gateResultCacheTtlMs: z.number().int(), // CPS stale-cache check (default: 5 minutes)
+    // ME.10.8 — `.url()`-validated so a non-URL override is a value error (not just a
+    // UI gate). The env-aware host is resolved SERVER-SIDE at handover-link-build time
+    // (process.env.OBSERVATORY_BASE_URL ?? config.observatoryBaseUrl); this static
+    // default stays free of process.env so it bundles identically into the webapp client.
+    observatoryBaseUrl: z.string().url(),
+    guidance: z.object({
+        // Max entities shown in the "next to fill" block during expansion-phase APS guidance
+        // (epic_expansion / ticket_expansion). Caps response size. Default: 3.
+        maxNextEntitiesToShow: z.number().int(),
+        // Fidelity of the phase-entry field block (composePhaseIntro). Optional; absent ⇒ 'rich'.
+        //  - 'rich'    → full per-field render (shape, interview hooks, examples, NA mechanism,
+        //                min count, tier) — the agent fills without guessing. Default.
+        //  - 'concise' → one line per field (name — description) + an optional list. Lighter.
+        fieldRenderDetail: z.enum(['rich', 'concise']).optional(),
+    }),
+});
+/**
+ * PlanningLifecycleConfigOverridesSchema — a permissive DeepPartial of
+ * {@link PlanningLifecycleConfigSchema}. A project-level override is a sparse
+ * `DeepPartial<PlanningLifecycleConfig>` (e.g. `{ guidance: { maxNextEntitiesToShow: 5 } }`).
+ *
+ * `PlanningLifecycleConfigSchema` is a plain `ZodObject` tree of objects + primitives with
+ * NO cross-field refinements, so `.deepPartial()` is safe here (no `ZodEffects` to trip
+ * over, unlike the validator's `ValidatorConfigSchema`). The full schema is still re-checked
+ * on the deepMerged result by `validateOverrides` in @specforge/lifecycle.
+ */
+export const PlanningLifecycleConfigOverridesSchema = PlanningLifecycleConfigSchema.deepPartial();
+// ---------------------------------------------------------------------------
+// PLANNING_LIFECYCLE_DEFAULTS — baseline merged under project/spec overrides.
+// ---------------------------------------------------------------------------
+export const PLANNING_LIFECYCLE_DEFAULTS = {
+    gateResultCacheTtlMs: 5 * 60 * 1000,
+    observatoryBaseUrl: 'https://specforge.tech',
+    guidance: {
+        maxNextEntitiesToShow: 3,
+        fieldRenderDetail: 'rich',
+    },
+};
+//# sourceMappingURL=planning-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planning-config.js","sourceRoot":"","sources":["../../src/runtime/planning-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,oBAA6B,CAAC;AAC9E,kFAAkF;AAClF,sFAAsF;AACtF,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,oFAAoF;IACpF,8CAA8C;IAC9C,kFAAkF;IAClF,wEAAwE;IACxE,yEAAyE;IACzE,oDAAoD;IACpD,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAI,6CAA6C;IACvF,kFAAkF;IAClF,mFAAmF;IACnF,+EAA+E;IAC/E,sFAAsF;IACtF,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,qFAAqF;QACrF,uEAAuE;QACvE,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;QACvC,0FAA0F;QAC1F,wFAAwF;QACxF,+EAA+E;QAC/E,sFAAsF;QACtF,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC1D,CAAC;CACH,CAAC,CAAC;AAGH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,6BAA6B,CAAC,WAAW,EAAE,CAAC;AAGlG,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,2BAA2B,GAA4B;IAClE,oBAAoB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;IACnC,kBAAkB,EAAE,wBAAwB;IAC5C,QAAQ,EAAE;QACR,qBAAqB,EAAE,CAAC;QACxB,iBAAiB,EAAE,MAAM;KAC1B;CACF,CAAC"}

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", "delete_ticket", "ticket_general_actions", "ticket_step_actions", "ticket_criteria_actions", "ticket_test_actions", "create_blueprint", "update_blueprint", "delete_blueprint", "link_blueprint_to_tickets", "unlink_blueprint_to_tickets", "create_dependencies", "delete_dependencies", "justify", "unjustify", "link_step_file", "unlink_step_file", "link_step_snippet", "unlink_step_snippet", "apply_creator_election"];
+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", "delete_ticket", "ticket_general_actions", "ticket_step_actions", "ticket_criteria_actions", "ticket_test_actions", "create_blueprint", "update_blueprint", "delete_blueprint", "link_blueprint_to_tickets", "unlink_blueprint_to_tickets", "create_dependencies", "delete_dependencies", "justify", "unjustify", "link_step_file", "unlink_step_file", "link_step_snippet", "unlink_step_snippet", "apply_creator_election", "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,sfA8C/B,CAAC;AAEX,eAAO,MAAM,6BAA6B,kCAAmC,CAAC;AAE9E,eAAO,MAAM,6BAA6B,oNAUhC,CAAC;AAEX,eAAO,MAAM,mBAAmB,stBAItB,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,65 @@
+export const PLANNING_MUTATING_OPERATIONS = [
+    'update_spec',
+    'create_epic', 'update_epic', 'delete_epic',
+    'create_ticket', 'delete_ticket',
+    // ME.19.1 (D8) — the four ticket NODE VERBS replace the retired free-form
+    // `update_ticket` (`{id, fields: z.record(z.unknown())}`). Each targets ONE scope so
+    // its payload can be TYPED (no `fields` bag) and its phase semantics can differ:
+    //   · ticket_general_actions — shell/general fields (title, description, complexity,
+    //     epicId, order, planningType, ticketType, guardrails, estimatedMinutes).
+    //     ticket_decomposition-native + usable in ticket_expansion WITHOUT rollback for
+    //     shell edits; rolls back to ticket_decomposition ONLY when it changes
+    //     planningType/ticketType (a decomposition-level classification). SHELL-EDIT only —
+    //     create/delete stay with create_ticket/delete_ticket (D20).
+    //   · ticket_step_actions / ticket_criteria_actions / ticket_test_actions — the
+    //     ticket_expansion-content verbs: ticket_expansion-native, NO cross_validation in
+    //     the band, so a late call from cross_validation rolls back to ticket_expansion
+    //     (re-score + re-gate the MB.15 link gate) — update_ticket's exact phase semantics
+    //     (D15). complexity/planningType/ticketType are TYPED enum fields on the general
+    //     verb (enum-poison impossible by construction, D20); `status` is system/event-driven
+    //     (readiness cascade / work-discovery) and is NOT on any node-verb payload.
+    'ticket_general_actions', 'ticket_step_actions', 'ticket_criteria_actions', 'ticket_test_actions',
+    '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',
+    // MB.14.1 — step↔artifact link verbs. Each CREATES/DELETES a row in a separate
+    // M×N join table (TicketImplementationStepFile / …CodeSnippet / …TypeSnippet),
+    // keyed on stepId + fileChangeId/snippetId. Native band INCLUDES cross_validation
+    // (14.2's findings emit operations:['link_step_file'] in that phase) — see
+    // operations-registry.ts.
+    'link_step_file', 'unlink_step_file',
+    'link_step_snippet', 'unlink_step_snippet',
+    // MB.16.1 — the ATOMIC creator-election batch verb. Applies the whole
+    // `electFileCreators` plan in ONE op: moves each CLEAN orphan shared file to
+    // `filesToBeCreated` on its elected ticket (ticket_expansion write), links the
+    // producing step inline (MB.15.3 `producesFiles`), AND declares the ordering deps
+    // (cross_validation write). Native across the `ticket_expansion` → `cross_validation`
+    // band (same pattern as link_step_file / link_blueprint_to_tickets) so the cross-phase
+    // fix never rolls back. `conflict`-status files are excluded (routed to get_ticket) —
+    // see operations-registry.ts + creator-election-batch.ts.
+    'apply_creator_election',
+];
+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;IAChC,0EAA0E;IAC1E,qFAAqF;IACrF,iFAAiF;IACjF,qFAAqF;IACrF,8EAA8E;IAC9E,oFAAoF;IACpF,2EAA2E;IAC3E,wFAAwF;IACxF,iEAAiE;IACjE,gFAAgF;IAChF,sFAAsF;IACtF,oFAAoF;IACpF,uFAAuF;IACvF,qFAAqF;IACrF,0FAA0F;IAC1F,gFAAgF;IAChF,wBAAwB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,qBAAqB;IACjG,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;IACtB,+EAA+E;IAC/E,+EAA+E;IAC/E,kFAAkF;IAClF,2EAA2E;IAC3E,0BAA0B;IAC1B,gBAAgB,EAAE,kBAAkB;IACpC,mBAAmB,EAAE,qBAAqB;IAC1C,sEAAsE;IACtE,6EAA6E;IAC7E,+EAA+E;IAC/E,kFAAkF;IAClF,sFAAsF;IACtF,uFAAuF;IACvF,sFAAsF;IACtF,0DAA0D;IAC1D,wBAAwB;CAChB,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", "system"]>;
+    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" | "system";
+    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" | "system";
+    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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyDtC,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,61 @@
+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(),
+    // ME.19.5 (D18) — `'system'` is the actor of the auto-materialized baseline write on
+    // cross_validation entry (system-originated, deterministic). The resolvers stream parser
+    // runs this schema's `.safeParse` on EVERY row BEFORE the projector switch, so the enum
+    // MUST accept `'system'` or the baseline's scaffold edges are silently bucketed as
+    // `schema_mismatch` and dropped.
+    performedByActor: z.enum(['agent', 'human', 'system']),
+    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,qFAAqF;IACrF,yFAAyF;IACzF,wFAAwF;IACxF,mFAAmF;IACnF,iCAAiC;IACjC,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtD,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"}