ex-workflow 0.1.0-stage → 0.3.0-stage

package/dist/roles-BLBRKhUZ.d.ts

@@ -0,0 +1,14 @@
+import { WorkflowState, Role, Capability } from './types.js';
+
+declare function registerRole(state: WorkflowState, role: Role, by: string, now?: string): WorkflowState;
+declare function retireRole(state: WorkflowState, roleId: string, by: string, now?: string): WorkflowState;
+declare function hasCapability(role: Role, cap: Capability): boolean;
+declare function rolesWith(state: WorkflowState, cap: Capability): Role[];
+declare function approversFor(state: WorkflowState, gateId: string): Role[];
+declare function requireCapabilities(state: WorkflowState, required: Capability[], exclusive: Capability[]): void;
+declare function separationLost(state: WorkflowState, required: Capability[]): Role[];
+/** `human` may do anything; a role must hold at least one of `caps`; unknown ids may do nothing. */
+declare function canDo(state: WorkflowState, by: string, ...caps: Capability[]): boolean;
+declare function requireCap(state: WorkflowState, by: string, ...caps: Capability[]): void;
+
+export { approversFor as a, requireCap as b, canDo as c, requireCapabilities as d, retireRole as e, rolesWith as f, hasCapability as h, registerRole as r, separationLost as s };

package/dist/roles-aneKYJ3Z.d.cts

@@ -0,0 +1,14 @@
+import { WorkflowState, Role, Capability } from './types.cjs';
+
+declare function registerRole(state: WorkflowState, role: Role, by: string, now?: string): WorkflowState;
+declare function retireRole(state: WorkflowState, roleId: string, by: string, now?: string): WorkflowState;
+declare function hasCapability(role: Role, cap: Capability): boolean;
+declare function rolesWith(state: WorkflowState, cap: Capability): Role[];
+declare function approversFor(state: WorkflowState, gateId: string): Role[];
+declare function requireCapabilities(state: WorkflowState, required: Capability[], exclusive: Capability[]): void;
+declare function separationLost(state: WorkflowState, required: Capability[]): Role[];
+/** `human` may do anything; a role must hold at least one of `caps`; unknown ids may do nothing. */
+declare function canDo(state: WorkflowState, by: string, ...caps: Capability[]): boolean;
+declare function requireCap(state: WorkflowState, by: string, ...caps: Capability[]): void;
+
+export { approversFor as a, requireCap as b, canDo as c, requireCapabilities as d, retireRole as e, rolesWith as f, hasCapability as h, registerRole as r, separationLost as s };

package/dist/scrum/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkLPQSNYYT_cjs=require('../chunk-LPQSNYYT.cjs');require('../chunk-5XAKW64K.cjs'),require('../chunk-S3BXVHO7.cjs');Object.defineProperty(exports,"SCRUM_VOCABULARY",{enumerable:true,get:function(){return chunkLPQSNYYT_cjs.i}});Object.defineProperty(exports,"canDo",{enumerable:true,get:function(){return chunkLPQSNYYT_cjs.a}});Object.defineProperty(exports,"closeSprint",{enumerable:true,get:function(){return chunkLPQSNYYT_cjs.k}});Object.defineProperty(exports,"configOf",{enumerable:true,get:function(){return chunkLPQSNYYT_cjs.j}});Object.defineProperty(exports,"dailyReport",{enumerable:true,get:function(){return chunkLPQSNYYT_cjs.b}});Object.defineProperty(exports,"scrum",{enumerable:true,get:function(){return chunkLPQSNYYT_cjs.l}});Object.defineProperty(exports,"scrumCeremonies",{enumerable:true,get:function(){return chunkLPQSNYYT_cjs.c}});Object.defineProperty(exports,"scrumMetrics",{enumerable:true,get:function(){return chunkLPQSNYYT_cjs.e}});Object.defineProperty(exports,"scrumRoles",{enumerable:true,get:function(){return chunkLPQSNYYT_cjs.f}});Object.defineProperty(exports,"scrumRules",{enumerable:true,get:function(){return chunkLPQSNYYT_cjs.g}});Object.defineProperty(exports,"scrumStages",{enumerable:true,get:function(){return chunkLPQSNYYT_cjs.h}});Object.defineProperty(exports,"validateScrumConfig",{enumerable:true,get:function(){return chunkLPQSNYYT_cjs.d}});//# sourceMappingURL=index.cjs.map
+'use strict';var chunk4A4TD4MH_cjs=require('../chunk-4A4TD4MH.cjs');require('../chunk-2IKIBB73.cjs');var chunk23P7C25E_cjs=require('../chunk-23P7C25E.cjs');require('../chunk-S3BXVHO7.cjs');Object.defineProperty(exports,"SCRUM_VOCABULARY",{enumerable:true,get:function(){return chunk4A4TD4MH_cjs.h}});Object.defineProperty(exports,"closeSprint",{enumerable:true,get:function(){return chunk4A4TD4MH_cjs.j}});Object.defineProperty(exports,"configOf",{enumerable:true,get:function(){return chunk4A4TD4MH_cjs.i}});Object.defineProperty(exports,"dailyReport",{enumerable:true,get:function(){return chunk4A4TD4MH_cjs.a}});Object.defineProperty(exports,"scrum",{enumerable:true,get:function(){return chunk4A4TD4MH_cjs.k}});Object.defineProperty(exports,"scrumCeremonies",{enumerable:true,get:function(){return chunk4A4TD4MH_cjs.b}});Object.defineProperty(exports,"scrumMetrics",{enumerable:true,get:function(){return chunk4A4TD4MH_cjs.d}});Object.defineProperty(exports,"scrumRoles",{enumerable:true,get:function(){return chunk4A4TD4MH_cjs.e}});Object.defineProperty(exports,"scrumRules",{enumerable:true,get:function(){return chunk4A4TD4MH_cjs.f}});Object.defineProperty(exports,"scrumStages",{enumerable:true,get:function(){return chunk4A4TD4MH_cjs.g}});Object.defineProperty(exports,"validateScrumConfig",{enumerable:true,get:function(){return chunk4A4TD4MH_cjs.c}});Object.defineProperty(exports,"canDo",{enumerable:true,get:function(){return chunk23P7C25E_cjs.n}});//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/scrum/index.d.cts

@@ -1,4 +1,5 @@
-import { Budget, Policy, WorkflowState, Role, Rule, Stage, ItemStatus, Capability, Methodology, Ceremony, CoreTerm } from '../types.cjs';
+import { Budget, Policy, WorkflowState, Role, Rule, Stage, ItemStatus, Methodology, Ceremony, CoreTerm } from '../types.cjs';
+export { c as canDo } from '../roles-aneKYJ3Z.cjs';
 
 interface ScrumConfig {
     sprintBudget: Budget;
@@ -28,7 +29,6 @@ declare function scrumRules(): Rule[];
 
 declare function scrumStages(config: ScrumConfig): Stage[];
 
-declare function canDo(state: WorkflowState, by: string, ...caps: Capability[]): boolean;
 interface DailyReport {
     sprint: string | null;
     goal: string | null;
@@ -56,4 +56,4 @@ declare function configOf(state: WorkflowState): ScrumConfig;
 declare function closeSprint(state: WorkflowState, reason: "budget" | "review" | "cancel", now: string): WorkflowState;
 declare function scrum(): Methodology<ScrumConfig>;
 
-export { type DailyReport, SCRUM_VOCABULARY, type ScrumConfig, type ScrumMetrics, canDo, closeSprint, configOf, dailyReport, scrum, scrumCeremonies, scrumMetrics, scrumRoles, scrumRules, scrumStages, validateScrumConfig };
+export { type DailyReport, SCRUM_VOCABULARY, type ScrumConfig, type ScrumMetrics, closeSprint, configOf, dailyReport, scrum, scrumCeremonies, scrumMetrics, scrumRoles, scrumRules, scrumStages, validateScrumConfig };

package/dist/scrum/index.d.ts

@@ -1,4 +1,5 @@
-import { Budget, Policy, WorkflowState, Role, Rule, Stage, ItemStatus, Capability, Methodology, Ceremony, CoreTerm } from '../types.js';
+import { Budget, Policy, WorkflowState, Role, Rule, Stage, ItemStatus, Methodology, Ceremony, CoreTerm } from '../types.js';
+export { c as canDo } from '../roles-BLBRKhUZ.js';
 
 interface ScrumConfig {
     sprintBudget: Budget;
@@ -28,7 +29,6 @@ declare function scrumRules(): Rule[];
 
 declare function scrumStages(config: ScrumConfig): Stage[];
 
-declare function canDo(state: WorkflowState, by: string, ...caps: Capability[]): boolean;
 interface DailyReport {
     sprint: string | null;
     goal: string | null;
@@ -56,4 +56,4 @@ declare function configOf(state: WorkflowState): ScrumConfig;
 declare function closeSprint(state: WorkflowState, reason: "budget" | "review" | "cancel", now: string): WorkflowState;
 declare function scrum(): Methodology<ScrumConfig>;
 
-export { type DailyReport, SCRUM_VOCABULARY, type ScrumConfig, type ScrumMetrics, canDo, closeSprint, configOf, dailyReport, scrum, scrumCeremonies, scrumMetrics, scrumRoles, scrumRules, scrumStages, validateScrumConfig };
+export { type DailyReport, SCRUM_VOCABULARY, type ScrumConfig, type ScrumMetrics, closeSprint, configOf, dailyReport, scrum, scrumCeremonies, scrumMetrics, scrumRoles, scrumRules, scrumStages, validateScrumConfig };

package/dist/scrum/index.mjs

@@ -1,2 +1,2 @@
-export{i as SCRUM_VOCABULARY,a as canDo,k as closeSprint,j as configOf,b as dailyReport,l as scrum,c as scrumCeremonies,e as scrumMetrics,f as scrumRoles,g as scrumRules,h as scrumStages,d as validateScrumConfig}from'../chunk-ROH3RYBI.mjs';import'../chunk-D7U3ES2L.mjs';import'../chunk-2FRRD6A3.mjs';//# sourceMappingURL=index.mjs.map
+export{h as SCRUM_VOCABULARY,j as closeSprint,i as configOf,a as dailyReport,k as scrum,b as scrumCeremonies,d as scrumMetrics,e as scrumRoles,f as scrumRules,g as scrumStages,c as validateScrumConfig}from'../chunk-R27STIER.mjs';import'../chunk-ZX4DAMTG.mjs';export{n as canDo}from'../chunk-FLCYD2QF.mjs';import'../chunk-2FRRD6A3.mjs';//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/types.d.cts

@@ -26,6 +26,14 @@ interface Transition {
     at: string;
     by: string;
 }
+/** Change-request: what the change touches and what it costs (waterfall change control). */
+interface ImpactAnalysis {
+    summary: string;
+    /** phase ids to reopen when the change is approved (each must be baselined or open) */
+    reopen: string[];
+    /** estimated rework weight (story points / size) */
+    weight: number;
+}
 interface WorkItem {
     id: string;
     type: ItemType;
@@ -49,6 +57,10 @@ interface WorkItem {
     tags?: string[];
     /** bug / change-request: ids of items whose finished work this invalidates */
     affects?: string[];
+    /** waterfall: Phase.id this item belongs to; questions and follow-ups inherit their parent's */
+    phase?: string;
+    /** change-request: impact analysis required before the change control board decides */
+    impactAnalysis?: ImpactAnalysis;
 }
 /** Fields a caller supplies to addItem; the rest are defaulted. */
 type NewItem = Pick<WorkItem, "id" | "title"> & Partial<Omit<WorkItem, "id" | "title" | "stage" | "status" | "evidence" | "blockers" | "transitions">> & {
@@ -197,12 +209,23 @@ interface Lesson {
     item?: string;
     suggestedChange?: LessonChange;
 }
+/** A deliverable recorded on a phase (gateReview input or engine-generated). */
+interface Produced {
+    kind: string;
+    ref: string;
+    by: string;
+    at: string;
+}
 interface Phase {
     id: string;
     name: string;
     deliverables: string[];
     gate: Gate;
     status: "pending" | "open" | "baselined" | "reopened";
+    /** planned budget; spent is tracked on the Iteration kickoff opens for the phase */
+    budget?: Budget;
+    /** phase-level deliverables (item evidence counts too) */
+    produced?: Produced[];
 }
 interface Baseline {
     phase: string;
@@ -222,6 +245,8 @@ interface WorkflowState {
     iterations: Iteration[];
     phases?: Phase[];
     baseline?: Baseline;
+    /** waterfall: every baseline ever taken, oldest first; `baseline` is the last one */
+    baselines?: Baseline[];
     events: Event[];
     accounting: Accounting[];
     pending: PendingHuman[];
@@ -287,13 +312,23 @@ type CeremonyInput = {
 type Ceremony = (state: WorkflowState, input: CeremonyInput) => ApplyResult;
 interface PlannerOptions {
     schedulerMode: "level" | "throughput";
-    /** Stage a todo item is pulled into when dispatched; omitted = stay in its current stage. */
-    dispatchStage?: string;
+    /** Stage a todo item is pulled into when dispatched; a function decides per item; omitted/undefined = stay in its current stage. */
+    dispatchStage?: string | ((item: WorkItem) => string | undefined);
     concurrencyCap?: number;
     fairnessPolicy?: "none" | "aging";
     maxDeferralRounds?: number;
     deadlineStrategy?: "earliest-first" | "latest-first";
     weightStrategy?: "higher-first" | "lower-first";
+    /** Priority the planner orders by; defaults to item.priority. */
+    priorityOf?(item: WorkItem): number | undefined;
+    /** Orders items of equal priority (after deadline/weight strategies); e.g. class of service, then age. */
+    tieBreaker?(a: WorkItem, b: WorkItem): number;
+    /** Statuses that occupy a stage's wipLimit slot; default ["in_progress"]. */
+    wipCounts?: ItemStatus[];
+    /** Per-item replacement for the target stage's wipLimit (e.g. an expedite bypass); undefined = no limit. */
+    wipLimitOf?(stage: Stage, item: WorkItem): number | undefined;
+    /** Role id to dispatch a todo item to (e.g. the phase's deliverer); undefined = default (item.role, then reviewer/deliverer by capability). */
+    roleFor?(item: WorkItem): string | undefined;
 }
 interface Methodology<C = unknown> {
     name: MethodologyName;
@@ -314,7 +349,11 @@ interface Methodology<C = unknown> {
     };
     /** Called after complete(); lets the methodology react (e.g. close a sprint when the budget is gone). */
     afterComplete?(state: WorkflowState, itemId: string, now: string): WorkflowState;
+    /** Methodology-specific status for hosts (e.g. cadences due); printed by `exwf status`. */
+    report?(state: WorkflowState): Record<string, unknown>;
+    /** Called by decide() after a pending entry is resolved; lets the methodology act on it (e.g. baseline a phase gate, apply a change-request decision). */
+    afterDecide?(state: WorkflowState, entry: PendingHuman, decision: "approve" | "reject", by: string, note: string, now: string): WorkflowState;
 }
 type ErrorCode = "unknown-item" | "duplicate-item" | "unknown-role" | "duplicate-role" | "unknown-stage" | "missing-capability" | "exclusive-capability" | "role-has-open-items" | "invalid-transition" | "policy-unmet" | "gate-unmet" | "conflict-of-interest" | "handoff-invalid" | "accounting-invalid" | "rule-violation" | "planner-error" | "no-op" | "unknown-pending" | "unknown-ceremony" | "state-version" | "config-invalid" | "budget-exhausted" | "invalid-input";
 
-export type { Accounting, Action, ApplyResult, Baseline, Blocker, Brief, Budget, Capability, Ceremony, CeremonyInput, ClassOfService, CoreTerm, ErrorCode, Event, Evidence, Gate, GateRequirement, Handoff, ItemStatus, ItemType, Iteration, Lesson, LessonChange, Methodology, MethodologyName, ModelTier, NewItem, PendingHuman, Phase, PlannerOptions, Policy, Role, Rule, Stage, Transition, Verdict, Violation, WorkItem, WorkflowState };
+export type { Accounting, Action, ApplyResult, Baseline, Blocker, Brief, Budget, Capability, Ceremony, CeremonyInput, ClassOfService, CoreTerm, ErrorCode, Event, Evidence, Gate, GateRequirement, Handoff, ImpactAnalysis, ItemStatus, ItemType, Iteration, Lesson, LessonChange, Methodology, MethodologyName, ModelTier, NewItem, PendingHuman, Phase, PlannerOptions, Policy, Produced, Role, Rule, Stage, Transition, Verdict, Violation, WorkItem, WorkflowState };

package/dist/types.d.ts

@@ -26,6 +26,14 @@ interface Transition {
     at: string;
     by: string;
 }
+/** Change-request: what the change touches and what it costs (waterfall change control). */
+interface ImpactAnalysis {
+    summary: string;
+    /** phase ids to reopen when the change is approved (each must be baselined or open) */
+    reopen: string[];
+    /** estimated rework weight (story points / size) */
+    weight: number;
+}
 interface WorkItem {
     id: string;
     type: ItemType;
@@ -49,6 +57,10 @@ interface WorkItem {
     tags?: string[];
     /** bug / change-request: ids of items whose finished work this invalidates */
     affects?: string[];
+    /** waterfall: Phase.id this item belongs to; questions and follow-ups inherit their parent's */
+    phase?: string;
+    /** change-request: impact analysis required before the change control board decides */
+    impactAnalysis?: ImpactAnalysis;
 }
 /** Fields a caller supplies to addItem; the rest are defaulted. */
 type NewItem = Pick<WorkItem, "id" | "title"> & Partial<Omit<WorkItem, "id" | "title" | "stage" | "status" | "evidence" | "blockers" | "transitions">> & {
@@ -197,12 +209,23 @@ interface Lesson {
     item?: string;
     suggestedChange?: LessonChange;
 }
+/** A deliverable recorded on a phase (gateReview input or engine-generated). */
+interface Produced {
+    kind: string;
+    ref: string;
+    by: string;
+    at: string;
+}
 interface Phase {
     id: string;
     name: string;
     deliverables: string[];
     gate: Gate;
     status: "pending" | "open" | "baselined" | "reopened";
+    /** planned budget; spent is tracked on the Iteration kickoff opens for the phase */
+    budget?: Budget;
+    /** phase-level deliverables (item evidence counts too) */
+    produced?: Produced[];
 }
 interface Baseline {
     phase: string;
@@ -222,6 +245,8 @@ interface WorkflowState {
     iterations: Iteration[];
     phases?: Phase[];
     baseline?: Baseline;
+    /** waterfall: every baseline ever taken, oldest first; `baseline` is the last one */
+    baselines?: Baseline[];
     events: Event[];
     accounting: Accounting[];
     pending: PendingHuman[];
@@ -287,13 +312,23 @@ type CeremonyInput = {
 type Ceremony = (state: WorkflowState, input: CeremonyInput) => ApplyResult;
 interface PlannerOptions {
     schedulerMode: "level" | "throughput";
-    /** Stage a todo item is pulled into when dispatched; omitted = stay in its current stage. */
-    dispatchStage?: string;
+    /** Stage a todo item is pulled into when dispatched; a function decides per item; omitted/undefined = stay in its current stage. */
+    dispatchStage?: string | ((item: WorkItem) => string | undefined);
     concurrencyCap?: number;
     fairnessPolicy?: "none" | "aging";
     maxDeferralRounds?: number;
     deadlineStrategy?: "earliest-first" | "latest-first";
     weightStrategy?: "higher-first" | "lower-first";
+    /** Priority the planner orders by; defaults to item.priority. */
+    priorityOf?(item: WorkItem): number | undefined;
+    /** Orders items of equal priority (after deadline/weight strategies); e.g. class of service, then age. */
+    tieBreaker?(a: WorkItem, b: WorkItem): number;
+    /** Statuses that occupy a stage's wipLimit slot; default ["in_progress"]. */
+    wipCounts?: ItemStatus[];
+    /** Per-item replacement for the target stage's wipLimit (e.g. an expedite bypass); undefined = no limit. */
+    wipLimitOf?(stage: Stage, item: WorkItem): number | undefined;
+    /** Role id to dispatch a todo item to (e.g. the phase's deliverer); undefined = default (item.role, then reviewer/deliverer by capability). */
+    roleFor?(item: WorkItem): string | undefined;
 }
 interface Methodology<C = unknown> {
     name: MethodologyName;
@@ -314,7 +349,11 @@ interface Methodology<C = unknown> {
     };
     /** Called after complete(); lets the methodology react (e.g. close a sprint when the budget is gone). */
     afterComplete?(state: WorkflowState, itemId: string, now: string): WorkflowState;
+    /** Methodology-specific status for hosts (e.g. cadences due); printed by `exwf status`. */
+    report?(state: WorkflowState): Record<string, unknown>;
+    /** Called by decide() after a pending entry is resolved; lets the methodology act on it (e.g. baseline a phase gate, apply a change-request decision). */
+    afterDecide?(state: WorkflowState, entry: PendingHuman, decision: "approve" | "reject", by: string, note: string, now: string): WorkflowState;
 }
 type ErrorCode = "unknown-item" | "duplicate-item" | "unknown-role" | "duplicate-role" | "unknown-stage" | "missing-capability" | "exclusive-capability" | "role-has-open-items" | "invalid-transition" | "policy-unmet" | "gate-unmet" | "conflict-of-interest" | "handoff-invalid" | "accounting-invalid" | "rule-violation" | "planner-error" | "no-op" | "unknown-pending" | "unknown-ceremony" | "state-version" | "config-invalid" | "budget-exhausted" | "invalid-input";
 
-export type { Accounting, Action, ApplyResult, Baseline, Blocker, Brief, Budget, Capability, Ceremony, CeremonyInput, ClassOfService, CoreTerm, ErrorCode, Event, Evidence, Gate, GateRequirement, Handoff, ItemStatus, ItemType, Iteration, Lesson, LessonChange, Methodology, MethodologyName, ModelTier, NewItem, PendingHuman, Phase, PlannerOptions, Policy, Role, Rule, Stage, Transition, Verdict, Violation, WorkItem, WorkflowState };
+export type { Accounting, Action, ApplyResult, Baseline, Blocker, Brief, Budget, Capability, Ceremony, CeremonyInput, ClassOfService, CoreTerm, ErrorCode, Event, Evidence, Gate, GateRequirement, Handoff, ImpactAnalysis, ItemStatus, ItemType, Iteration, Lesson, LessonChange, Methodology, MethodologyName, ModelTier, NewItem, PendingHuman, Phase, PlannerOptions, Policy, Produced, Role, Rule, Stage, Transition, Verdict, Violation, WorkItem, WorkflowState };

package/dist/waterfall/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkTMKCALFT_cjs=require('../chunk-TMKCALFT.cjs');require('../chunk-2IKIBB73.cjs'),require('../chunk-23P7C25E.cjs'),require('../chunk-S3BXVHO7.cjs');Object.defineProperty(exports,"CHANGE_GATE",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.e}});Object.defineProperty(exports,"DEFAULT_DELIVERABLES",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.b}});Object.defineProperty(exports,"DEFAULT_DELIVER_BY",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.c}});Object.defineProperty(exports,"DEFAULT_PHASE_IDS",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.a}});Object.defineProperty(exports,"DONE",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.k}});Object.defineProperty(exports,"GATE_ID",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.d}});Object.defineProperty(exports,"REVIEW",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.j}});Object.defineProperty(exports,"WATERFALL_VOCABULARY",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.K}});Object.defineProperty(exports,"WORK",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.i}});Object.defineProperty(exports,"approveChange",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.z}});Object.defineProperty(exports,"baselinePhase",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.x}});Object.defineProperty(exports,"configOf",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.g}});Object.defineProperty(exports,"currentPhase",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.s}});Object.defineProperty(exports,"defaultPhases",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.f}});Object.defineProperty(exports,"deliverRoleFor",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.L}});Object.defineProperty(exports,"getPhase",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.o}});Object.defineProperty(exports,"isFrozen",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.t}});Object.defineProperty(exports,"itemsInPhase",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.q}});Object.defineProperty(exports,"lastToPhase",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.w}});Object.defineProperty(exports,"missingDeliverables",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.v}});Object.defineProperty(exports,"missingTraces",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.C}});Object.defineProperty(exports,"openPhase",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.r}});Object.defineProperty(exports,"phaseIndex",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.n}});Object.defineProperty(exports,"phaseOf",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.p}});Object.defineProperty(exports,"phaseReport",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.M}});Object.defineProperty(exports,"phasesOf",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.l}});Object.defineProperty(exports,"producedKinds",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.u}});Object.defineProperty(exports,"rejectChange",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.A}});Object.defineProperty(exports,"reopenPhases",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.y}});Object.defineProperty(exports,"traceabilityMatrix",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.B}});Object.defineProperty(exports,"validateWaterfallConfig",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.h}});Object.defineProperty(exports,"wantPhase",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.D}});Object.defineProperty(exports,"waterfall",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.N}});Object.defineProperty(exports,"waterfallAfterDecide",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.F}});Object.defineProperty(exports,"waterfallCeremonies",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.E}});Object.defineProperty(exports,"waterfallMetrics",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.G}});Object.defineProperty(exports,"waterfallRoles",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.H}});Object.defineProperty(exports,"waterfallRules",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.I}});Object.defineProperty(exports,"waterfallStages",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.J}});Object.defineProperty(exports,"withPhases",{enumerable:true,get:function(){return chunkTMKCALFT_cjs.m}});//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/waterfall/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/waterfall/index.d.cts

@@ -0,0 +1,148 @@
+import { Gate, Budget, GateRequirement, WorkflowState, Phase, WorkItem, Stage, Role, Rule, CeremonyInput, PendingHuman, Methodology, Ceremony, CoreTerm } from '../types.cjs';
+
+interface WaterfallPhaseConfig {
+    id: string;
+    name: string;
+    deliverables: string[];
+    gate: Gate;
+    budget?: Budget;
+    /** role id that delivers this phase's items; default: the first role with "deliver" */
+    deliverBy?: string;
+}
+interface WaterfallConfig {
+    phases: WaterfallPhaseConfig[];
+    changeControl: {
+        requiresImpactAnalysis: boolean;
+        approvers: GateRequirement[];
+    };
+    /** phase ids: every item of `from` must trace to an item of each `to` phase before that phase's gate */
+    traceability: {
+        from: string;
+        to: string[];
+    };
+    humanGates: "all" | string[];
+}
+declare const DEFAULT_PHASE_IDS: readonly string[];
+declare const DEFAULT_DELIVERABLES: Record<string, string[]>;
+declare const DEFAULT_DELIVER_BY: Record<string, string>;
+declare const GATE_ID: (id: string) => string;
+declare const CHANGE_GATE = "change-control";
+declare function defaultPhases(): WaterfallPhaseConfig[];
+declare function configOf(state: WorkflowState): WaterfallConfig;
+declare function validateWaterfallConfig(raw: unknown): WaterfallConfig;
+
+declare const WORK = "work";
+declare const REVIEW = "review";
+declare const DONE = "done";
+/** state.phases, or the config phases as pending (before the first ceremony touches them). */
+declare function phasesOf(state: WorkflowState): Phase[];
+declare function withPhases(state: WorkflowState, phases: Phase[]): WorkflowState;
+declare function phaseIndex(state: WorkflowState, id: string): number;
+declare function getPhase(state: WorkflowState, id: string): Phase;
+/** The item's phase, inherited from its parent chain (questions, follow-ups, retro items). */
+declare function phaseOf(state: WorkflowState, item: WorkItem): string | undefined;
+declare function itemsInPhase(state: WorkflowState, phaseId: string): WorkItem[];
+declare function openPhase(state: WorkflowState): Phase | undefined;
+/** First phase in order that is not baselined: the one to kick off (or the open one). */
+declare function currentPhase(state: WorkflowState): Phase | undefined;
+declare function isFrozen(state: WorkflowState, item: WorkItem): boolean;
+declare function producedKinds(state: WorkflowState, phase: Phase): Set<string>;
+/** Deliverables (and gate evidence kinds) still missing, in declaration order. */
+declare function missingDeliverables(state: WorkflowState, phase: Phase, extra?: string[]): string[];
+/** The traceability `to` phase that comes last in phase order (where the matrix must be complete). */
+declare function lastToPhase(state: WorkflowState): string | undefined;
+
+/** Every phase's items share the same three steps; the phase is the unit of governance. */
+declare function waterfallStages(_config: WaterfallConfig): Stage[];
+
+/** Order matters: the first role with "deliver" is the fallback deliverer for phases without deliverBy. */
+declare function waterfallRoles(config: WaterfallConfig): Role[];
+
+declare function waterfallRules(): Rule[];
+
+interface WaterfallMetrics {
+    phaseCompletion: Record<string, number>;
+    budgetPlanned: Record<string, number>;
+    budgetSpent: Record<string, number>;
+    scheduleVariance: Record<string, number>;
+    requirementCoverage: number;
+    requirementsTraced: number;
+    requirementsTotal: number;
+    defectsPerPhase: Record<string, number>;
+    changeRequests: number;
+    changesApproved: number;
+    changesRejected: number;
+    changeApprovalRate: number;
+    reworkWeight: number;
+    phasesReopened: number;
+}
+/** Phase metrics replayed from events alone (membership from item.added, spend from item.completed). */
+declare function waterfallMetrics(state: WorkflowState): WaterfallMetrics;
+
+declare function approveChange(state: WorkflowState, changeId: string, by: string, note: string, now: string): WorkflowState;
+declare function rejectChange(state: WorkflowState, changeId: string, by: string, note: string, now: string): WorkflowState;
+
+/** input.phase as an existing phase. */
+declare function wantPhase(state: WorkflowState, input: CeremonyInput, ceremony: string): Phase;
+
+declare function waterfallCeremonies(methodology: () => Methodology): Record<string, Ceremony>;
+/** decide() hook: a phase gate's human decision baselines the phase or records the failure. */
+declare function waterfallAfterDecide(state: WorkflowState, entry: PendingHuman, decision: "approve" | "reject", by: string, note: string, now: string): WorkflowState;
+
+interface TraceRow {
+    item: string;
+    /** to-phase id → ids of linked items in that phase */
+    links: Record<string, string[]>;
+}
+interface TraceabilityMatrix {
+    from: string;
+    to: string[];
+    rows: TraceRow[];
+    missing: Array<{
+        item: string;
+        phases: string[];
+    }>;
+    coverage: {
+        traced: number;
+        total: number;
+    };
+}
+declare function traceabilityMatrix(state: WorkflowState): TraceabilityMatrix;
+/** Ids of `from` items with no link into `toPhase`. */
+declare function missingTraces(state: WorkflowState, toPhase: string): string[];
+
+/** Pass the phase gate: freeze its items, record the baseline, close its iteration. */
+declare function baselinePhase(state: WorkflowState, phaseId: string, approvedBy: string[], now: string): WorkflowState;
+interface ReopenResult {
+    state: WorkflowState;
+    reopened: string[];
+    suspended: string | null;
+}
+/** Change-control approval: reopen the listed baselined phases; a later open phase is suspended until they are re-baselined. */
+declare function reopenPhases(state: WorkflowState, ids: string[], now: string): ReopenResult;
+
+declare const WATERFALL_VOCABULARY: Record<CoreTerm, string>;
+/** The role that delivers the item's phase (config deliverBy); undefined = the planner's default deliverer. */
+declare function deliverRoleFor(state: WorkflowState, item: WorkItem): string | undefined;
+interface PhaseReportRow {
+    id: string;
+    name: string;
+    status: string;
+    items: number;
+    done: number;
+    missingDeliverables: string[];
+    readyForGate: boolean;
+}
+interface PhaseReport {
+    phases: PhaseReportRow[];
+    current: string | null;
+    open: string | null;
+    pendingGates: Array<{
+        pending: string;
+        gate: string;
+    }>;
+}
+declare function phaseReport(state: WorkflowState): PhaseReport;
+declare function waterfall(): Methodology<WaterfallConfig>;
+
+export { CHANGE_GATE, DEFAULT_DELIVERABLES, DEFAULT_DELIVER_BY, DEFAULT_PHASE_IDS, DONE, GATE_ID, type PhaseReport, type PhaseReportRow, REVIEW, type ReopenResult, type TraceRow, type TraceabilityMatrix, WATERFALL_VOCABULARY, WORK, type WaterfallConfig, type WaterfallMetrics, type WaterfallPhaseConfig, approveChange, baselinePhase, configOf, currentPhase, defaultPhases, deliverRoleFor, getPhase, isFrozen, itemsInPhase, lastToPhase, missingDeliverables, missingTraces, openPhase, phaseIndex, phaseOf, phaseReport, phasesOf, producedKinds, rejectChange, reopenPhases, traceabilityMatrix, validateWaterfallConfig, wantPhase, waterfall, waterfallAfterDecide, waterfallCeremonies, waterfallMetrics, waterfallRoles, waterfallRules, waterfallStages, withPhases };

package/dist/waterfall/index.d.ts

@@ -0,0 +1,148 @@
+import { Gate, Budget, GateRequirement, WorkflowState, Phase, WorkItem, Stage, Role, Rule, CeremonyInput, PendingHuman, Methodology, Ceremony, CoreTerm } from '../types.js';
+
+interface WaterfallPhaseConfig {
+    id: string;
+    name: string;
+    deliverables: string[];
+    gate: Gate;
+    budget?: Budget;
+    /** role id that delivers this phase's items; default: the first role with "deliver" */
+    deliverBy?: string;
+}
+interface WaterfallConfig {
+    phases: WaterfallPhaseConfig[];
+    changeControl: {
+        requiresImpactAnalysis: boolean;
+        approvers: GateRequirement[];
+    };
+    /** phase ids: every item of `from` must trace to an item of each `to` phase before that phase's gate */
+    traceability: {
+        from: string;
+        to: string[];
+    };
+    humanGates: "all" | string[];
+}
+declare const DEFAULT_PHASE_IDS: readonly string[];
+declare const DEFAULT_DELIVERABLES: Record<string, string[]>;
+declare const DEFAULT_DELIVER_BY: Record<string, string>;
+declare const GATE_ID: (id: string) => string;
+declare const CHANGE_GATE = "change-control";
+declare function defaultPhases(): WaterfallPhaseConfig[];
+declare function configOf(state: WorkflowState): WaterfallConfig;
+declare function validateWaterfallConfig(raw: unknown): WaterfallConfig;
+
+declare const WORK = "work";
+declare const REVIEW = "review";
+declare const DONE = "done";
+/** state.phases, or the config phases as pending (before the first ceremony touches them). */
+declare function phasesOf(state: WorkflowState): Phase[];
+declare function withPhases(state: WorkflowState, phases: Phase[]): WorkflowState;
+declare function phaseIndex(state: WorkflowState, id: string): number;
+declare function getPhase(state: WorkflowState, id: string): Phase;
+/** The item's phase, inherited from its parent chain (questions, follow-ups, retro items). */
+declare function phaseOf(state: WorkflowState, item: WorkItem): string | undefined;
+declare function itemsInPhase(state: WorkflowState, phaseId: string): WorkItem[];
+declare function openPhase(state: WorkflowState): Phase | undefined;
+/** First phase in order that is not baselined: the one to kick off (or the open one). */
+declare function currentPhase(state: WorkflowState): Phase | undefined;
+declare function isFrozen(state: WorkflowState, item: WorkItem): boolean;
+declare function producedKinds(state: WorkflowState, phase: Phase): Set<string>;
+/** Deliverables (and gate evidence kinds) still missing, in declaration order. */
+declare function missingDeliverables(state: WorkflowState, phase: Phase, extra?: string[]): string[];
+/** The traceability `to` phase that comes last in phase order (where the matrix must be complete). */
+declare function lastToPhase(state: WorkflowState): string | undefined;
+
+/** Every phase's items share the same three steps; the phase is the unit of governance. */
+declare function waterfallStages(_config: WaterfallConfig): Stage[];
+
+/** Order matters: the first role with "deliver" is the fallback deliverer for phases without deliverBy. */
+declare function waterfallRoles(config: WaterfallConfig): Role[];
+
+declare function waterfallRules(): Rule[];
+
+interface WaterfallMetrics {
+    phaseCompletion: Record<string, number>;
+    budgetPlanned: Record<string, number>;
+    budgetSpent: Record<string, number>;
+    scheduleVariance: Record<string, number>;
+    requirementCoverage: number;
+    requirementsTraced: number;
+    requirementsTotal: number;
+    defectsPerPhase: Record<string, number>;
+    changeRequests: number;
+    changesApproved: number;
+    changesRejected: number;
+    changeApprovalRate: number;
+    reworkWeight: number;
+    phasesReopened: number;
+}
+/** Phase metrics replayed from events alone (membership from item.added, spend from item.completed). */
+declare function waterfallMetrics(state: WorkflowState): WaterfallMetrics;
+
+declare function approveChange(state: WorkflowState, changeId: string, by: string, note: string, now: string): WorkflowState;
+declare function rejectChange(state: WorkflowState, changeId: string, by: string, note: string, now: string): WorkflowState;
+
+/** input.phase as an existing phase. */
+declare function wantPhase(state: WorkflowState, input: CeremonyInput, ceremony: string): Phase;
+
+declare function waterfallCeremonies(methodology: () => Methodology): Record<string, Ceremony>;
+/** decide() hook: a phase gate's human decision baselines the phase or records the failure. */
+declare function waterfallAfterDecide(state: WorkflowState, entry: PendingHuman, decision: "approve" | "reject", by: string, note: string, now: string): WorkflowState;
+
+interface TraceRow {
+    item: string;
+    /** to-phase id → ids of linked items in that phase */
+    links: Record<string, string[]>;
+}
+interface TraceabilityMatrix {
+    from: string;
+    to: string[];
+    rows: TraceRow[];
+    missing: Array<{
+        item: string;
+        phases: string[];
+    }>;
+    coverage: {
+        traced: number;
+        total: number;
+    };
+}
+declare function traceabilityMatrix(state: WorkflowState): TraceabilityMatrix;
+/** Ids of `from` items with no link into `toPhase`. */
+declare function missingTraces(state: WorkflowState, toPhase: string): string[];
+
+/** Pass the phase gate: freeze its items, record the baseline, close its iteration. */
+declare function baselinePhase(state: WorkflowState, phaseId: string, approvedBy: string[], now: string): WorkflowState;
+interface ReopenResult {
+    state: WorkflowState;
+    reopened: string[];
+    suspended: string | null;
+}
+/** Change-control approval: reopen the listed baselined phases; a later open phase is suspended until they are re-baselined. */
+declare function reopenPhases(state: WorkflowState, ids: string[], now: string): ReopenResult;
+
+declare const WATERFALL_VOCABULARY: Record<CoreTerm, string>;
+/** The role that delivers the item's phase (config deliverBy); undefined = the planner's default deliverer. */
+declare function deliverRoleFor(state: WorkflowState, item: WorkItem): string | undefined;
+interface PhaseReportRow {
+    id: string;
+    name: string;
+    status: string;
+    items: number;
+    done: number;
+    missingDeliverables: string[];
+    readyForGate: boolean;
+}
+interface PhaseReport {
+    phases: PhaseReportRow[];
+    current: string | null;
+    open: string | null;
+    pendingGates: Array<{
+        pending: string;
+        gate: string;
+    }>;
+}
+declare function phaseReport(state: WorkflowState): PhaseReport;
+declare function waterfall(): Methodology<WaterfallConfig>;
+
+export { CHANGE_GATE, DEFAULT_DELIVERABLES, DEFAULT_DELIVER_BY, DEFAULT_PHASE_IDS, DONE, GATE_ID, type PhaseReport, type PhaseReportRow, REVIEW, type ReopenResult, type TraceRow, type TraceabilityMatrix, WATERFALL_VOCABULARY, WORK, type WaterfallConfig, type WaterfallMetrics, type WaterfallPhaseConfig, approveChange, baselinePhase, configOf, currentPhase, defaultPhases, deliverRoleFor, getPhase, isFrozen, itemsInPhase, lastToPhase, missingDeliverables, missingTraces, openPhase, phaseIndex, phaseOf, phaseReport, phasesOf, producedKinds, rejectChange, reopenPhases, traceabilityMatrix, validateWaterfallConfig, wantPhase, waterfall, waterfallAfterDecide, waterfallCeremonies, waterfallMetrics, waterfallRoles, waterfallRules, waterfallStages, withPhases };

package/dist/waterfall/index.mjs

@@ -0,0 +1,2 @@
+export{e as CHANGE_GATE,b as DEFAULT_DELIVERABLES,c as DEFAULT_DELIVER_BY,a as DEFAULT_PHASE_IDS,k as DONE,d as GATE_ID,j as REVIEW,K as WATERFALL_VOCABULARY,i as WORK,z as approveChange,x as baselinePhase,g as configOf,s as currentPhase,f as defaultPhases,L as deliverRoleFor,o as getPhase,t as isFrozen,q as itemsInPhase,w as lastToPhase,v as missingDeliverables,C as missingTraces,r as openPhase,n as phaseIndex,p as phaseOf,M as phaseReport,l as phasesOf,u as producedKinds,A as rejectChange,y as reopenPhases,B as traceabilityMatrix,h as validateWaterfallConfig,D as wantPhase,N as waterfall,F as waterfallAfterDecide,E as waterfallCeremonies,G as waterfallMetrics,H as waterfallRoles,I as waterfallRules,J as waterfallStages,m as withPhases}from'../chunk-BJEOTG6P.mjs';import'../chunk-ZX4DAMTG.mjs';import'../chunk-FLCYD2QF.mjs';import'../chunk-2FRRD6A3.mjs';//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/waterfall/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}