ex-workflow 0.3.0-stage → 0.6.0-stage

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { ErrorCode, WorkflowState, MethodologyName, Stage, Role, Event, WorkItem, Evidence, NewItem, ItemStatus, Policy, Violation, Gate, Methodology, Transition, PendingHuman, Budget, Accounting, Iteration, Brief, Handoff, ApplyResult, Rule, Action } from './types.js';
-export { Baseline, Blocker, Capability, Ceremony, CeremonyInput, ClassOfService, CoreTerm, GateRequirement, ImpactAnalysis, ItemType, Lesson, LessonChange, ModelTier, Phase, PlannerOptions, Produced, Verdict } from './types.js';
-export { a as approversFor, c as canDo, h as hasCapability, r as registerRole, b as requireCap, d as requireCapabilities, e as retireRole, f as rolesWith, s as separationLost } from './roles-BLBRKhUZ.js';
+import { ErrorCode, WorkflowState, MethodologyName, Stage, Role, Event, Evidence, NewItem, ItemPatch, WorkItem, ItemStatus, Policy, Violation, Gate, Methodology, Transition, PendingHuman, Iteration, Brief, Handoff, Accounting, ApplyResult, Rule, Action } from './types.js';
+export { Baseline, Blocker, Budget, Capability, Ceremony, CeremonyInput, ClassOfService, CoreTerm, GateRequirement, ImpactAnalysis, ItemType, Lesson, LessonChange, ModelTier, Phase, PlannerOptions, Produced, Spent, Verdict } from './types.js';
+export { E as EstimateMode, Z as ZERO_SPENT, a as addSpent, b as approversFor, c as canDo, e as estimateTokens, h as hasCapability, i as isExhausted, r as registerRole, d as remaining, f as requireCap, g as requireCapabilities, j as retireRole, k as rolesWith, s as separationLost } from './budget-Cx63FX2K.js';
 import { ExNode } from 'ex-flow';
 
 interface WorkflowErrorExtra {
@@ -42,7 +42,7 @@ declare function nextStageOf(state: WorkflowState, stageId: string): Stage | und
 declare function isTerminalStage(state: WorkflowState, stageId: string): boolean;
 declare function getItem(state: WorkflowState, id: string): WorkItem;
 declare function addItem(state: WorkflowState, input: NewItem, by: string, now?: string): WorkflowState;
-type ItemPatch = Partial<Omit<WorkItem, "id" | "stage" | "status" | "transitions" | "evidence" | "blockers">>;
+
 declare function editItem(state: WorkflowState, id: string, patch: ItemPatch, by: string, now?: string): WorkflowState;
 declare function moveItem(state: WorkflowState, id: string, to: {
     stage?: string;
@@ -50,7 +50,15 @@ declare function moveItem(state: WorkflowState, id: string, to: {
 }, by: string, now?: string): WorkflowState;
 declare function addEvidence(state: WorkflowState, id: string, evidence: Omit<Evidence, "at">, now?: string): WorkflowState;
 declare function raiseBlocker(state: WorkflowState, id: string, reason: string, owner: string, by: string, now?: string): WorkflowState;
-declare function clearBlocker(state: WorkflowState, id: string, blockerId: string, by: string, now?: string): WorkflowState;
+declare function clearBlocker(state: WorkflowState, id: string, blockerId: string, by: string, now?: string, note?: string): WorkflowState;
+
+/** Adds an agreement (idempotent); with `replaces`, retires that one in the same step. */
+declare function applyAgreement(state: WorkflowState, change: {
+    text: string;
+    replaces?: string;
+}, by: string, now: string): WorkflowState;
+/** Removes an agreement and records why it left (replacedBy null). */
+declare function retireAgreement(state: WorkflowState, text: string, by: string, now: string): WorkflowState;
 
 declare function evaluatePolicies(state: WorkflowState, item: WorkItem, policies: Policy[]): Violation[];
 declare function assertPolicies(state: WorkflowState, item: WorkItem, policies: Policy[], context: string): void;
@@ -71,12 +79,6 @@ declare function checkGate(state: WorkflowState, item: WorkItem, gate: Gate, by:
 declare function raisePending(state: WorkflowState, pending: Omit<PendingHuman, "id" | "raisedAt">, now?: string): WorkflowState;
 declare function decide(state: WorkflowState, pendingId: string, decision: "approve" | "reject", by: string, note: string, now?: string, methodology?: Methodology): WorkflowState;
 
-declare const ZERO_SPENT: Required<Budget>;
-declare function addSpent(spent: Required<Budget>, acc: Accounting): Required<Budget>;
-declare function remaining(budget: Budget, spent: Required<Budget>): Budget;
-declare function isExhausted(budget: Budget, spent: Required<Budget>): boolean;
-declare function estimateTokens(state: WorkflowState, weight: number | undefined, fallbackPerWeight?: number): number;
-
 type NodeData = {
     id: string;
 };
@@ -105,6 +107,13 @@ interface PlanResult {
 declare function plan(state: WorkflowState, methodology: Methodology, opts?: PlanOptions): PlanResult;
 
 declare function synthesizeBrief(state: WorkflowState, methodology: Methodology, item: WorkItem): Brief;
+/** Open questions of finished items: the last completion per item, verdict done/needs-review, with open_questions left unanswered. */
+declare function openQuestions(state: WorkflowState): Array<{
+    item: string;
+    role: string;
+    questions: string[];
+    at: string;
+}>;
 interface NextResult {
     state: WorkflowState;
     briefs: Brief[];
@@ -115,6 +124,18 @@ declare function next(state: WorkflowState, methodology: Methodology, opts?: Pla
 
 declare function complete(state: WorkflowState, methodology: Methodology, handoff: Handoff, acc: Accounting, now?: string): ApplyResult;
 
+interface AccountingPatch {
+    tokensIn?: number;
+    tokensOut?: number;
+    durationMs?: number;
+    model?: string;
+}
+/**
+ * Rewrite one accounting line of an item (`line` is 1-based among the item's lines, default the last).
+ * The owning iteration's spent follows the delta, open or closed; the event records before/after.
+ */
+declare function correctAccounting(state: WorkflowState, itemId: string, patch: AccountingPatch, by: string, now?: string, line?: number): WorkflowState;
+
 declare function coreRulesFor(methodology: Pick<Methodology, "requiredCapabilities">): Rule[];
 
 declare function validateAction(state: WorkflowState, methodology: Methodology, action: Action): Violation[];
@@ -128,7 +149,9 @@ interface InitInput<C> {
     now?: string;
 }
 declare function init<C>(input: InitInput<C>): ApplyResult;
+/** Change the config between iterations: re-validated, recorded as config.changed, derived state kept in step by the methodology hook. */
+declare function changeConfig(state: WorkflowState, methodology: Methodology, patch: Record<string, unknown>, by: string, now?: string): ApplyResult;
 
-declare const VERSION = "0.3.0-stage";
+declare const VERSION = "0.6.0-stage";
 
-export { Accounting, Action, ApplyResult, Brief, Budget, ErrorCode, Event, Evidence, Gate, type GateResult, Handoff, type InitInput, type ItemPatch, ItemStatus, Iteration, Methodology, MethodologyName, NewItem, type NextResult, PendingHuman, type PlanOptions, type PlanReason, type PlanResult, Policy, Role, Rule, type Skipped, Stage, Transition, VERSION, Violation, WorkItem, WorkflowError, WorkflowState, ZERO_SPENT, addEvidence, addItem, addSpent, appendEvent, applyAction, assertId, assertPolicies, assignRole, authorOf, checkGate, clearBlocker, complete, coreRulesFor, createState, decide, editItem, estimateTokens, evaluatePolicies, fail, getItem, init, isExhausted, isTerminalStage, lastDispatchBefore, lastEvent, moveItem, next, nextStageOf, nowOf, openIteration, plan, raiseBlocker, raisePending, remaining, resourceCapsFor, stageOf, synthesizeBrief, toExNodes, validateAction };
+export { Accounting, type AccountingPatch, Action, ApplyResult, Brief, ErrorCode, Event, Evidence, Gate, type GateResult, Handoff, type InitInput, ItemPatch, ItemStatus, Iteration, Methodology, MethodologyName, NewItem, type NextResult, PendingHuman, type PlanOptions, type PlanReason, type PlanResult, Policy, Role, Rule, type Skipped, Stage, Transition, VERSION, Violation, WorkItem, WorkflowError, WorkflowState, addEvidence, addItem, appendEvent, applyAction, applyAgreement, assertId, assertPolicies, assignRole, authorOf, changeConfig, checkGate, clearBlocker, complete, coreRulesFor, correctAccounting, createState, decide, editItem, evaluatePolicies, fail, getItem, init, isTerminalStage, lastDispatchBefore, lastEvent, moveItem, next, nextStageOf, nowOf, openIteration, openQuestions, plan, raiseBlocker, raisePending, resourceCapsFor, retireAgreement, stageOf, synthesizeBrief, toExNodes, validateAction };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import'./chunk-KIQOUUEZ.mjs';export{c as complete,b as next,a as synthesizeBrief}from'./chunk-WOKNWJKU.mjs';export{a as ZERO_SPENT,b as addSpent,g as assignRole,e as estimateTokens,d as isExhausted,f as openIteration,j as plan,c as remaining,h as resourceCapsFor,i as toExNodes}from'./chunk-ZX4DAMTG.mjs';export{y as addEvidence,v as addItem,c as appendEvent,M as applyAction,k as approversFor,E as assertPolicies,G as authorOf,n as canDo,H as checkGate,A as clearBlocker,K as coreRulesFor,b as createState,J as decide,w as editItem,D as evaluatePolicies,u as getItem,h as hasCapability,N as init,r as isTerminalStage,F as lastDispatchBefore,d as lastEvent,x as moveItem,q as nextStageOf,a as nowOf,z as raiseBlocker,I as raisePending,f as registerRole,o as requireCap,l as requireCapabilities,g as retireRole,i as rolesWith,m as separationLost,p as stageOf,L as validateAction}from'./chunk-FLCYD2QF.mjs';export{a as WorkflowError,c as assertId,b as fail}from'./chunk-2FRRD6A3.mjs';var U="0.3.0-stage";export{U as VERSION};//# sourceMappingURL=index.mjs.map
+import'./chunk-KIQOUUEZ.mjs';export{d as complete,e as correctAccounting,c as next,b as openQuestions,a as synthesizeBrief}from'./chunk-TEPK5Y36.mjs';export{a as applyAgreement,b as retireAgreement}from'./chunk-IHE5K4X3.mjs';export{K as ZERO_SPENT,y as addEvidence,v as addItem,L as addSpent,c as appendEvent,W as applyAction,k as approversFor,E as assertPolicies,Q as assignRole,G as authorOf,n as canDo,Y as changeConfig,H as checkGate,A as clearBlocker,U as coreRulesFor,b as createState,J as decide,w as editItem,O as estimateTokens,D as evaluatePolicies,u as getItem,h as hasCapability,X as init,N as isExhausted,r as isTerminalStage,F as lastDispatchBefore,d as lastEvent,x as moveItem,q as nextStageOf,a as nowOf,P as openIteration,T as plan,z as raiseBlocker,I as raisePending,f as registerRole,M as remaining,o as requireCap,l as requireCapabilities,R as resourceCapsFor,g as retireRole,i as rolesWith,m as separationLost,p as stageOf,S as toExNodes,V as validateAction}from'./chunk-Z3PU6EBI.mjs';export{a as WorkflowError,c as assertId,b as fail}from'./chunk-2FRRD6A3.mjs';var te="0.6.0-stage";export{te as VERSION};//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["VERSION"],"mappings":"s9BAAO,IAAMA,CAAAA,CAAU","file":"index.mjs","sourcesContent":["export const VERSION = \"0.3.0-stage\";\nexport * from \"./types.ts\";\nexport { WorkflowError, fail } from \"./errors.ts\";\nexport { createState, appendEvent, lastEvent, nowOf } from \"./state.ts\";\nexport {\n  registerRole,\n  retireRole,\n  hasCapability,\n  rolesWith,\n  approversFor,\n  requireCapabilities,\n  separationLost,\n  canDo,\n  requireCap,\n} from \"./roles.ts\";\nexport {\n  assertId,\n  stageOf,\n  nextStageOf,\n  isTerminalStage,\n  getItem,\n  addItem,\n  editItem,\n  moveItem,\n  addEvidence,\n  raiseBlocker,\n  clearBlocker,\n} from \"./items.ts\";\nexport type { ItemPatch } from \"./items.ts\";\nexport { evaluatePolicies, assertPolicies } from \"./policies.ts\";\nexport { checkGate, authorOf, lastDispatchBefore, raisePending, decide } from \"./gates.ts\";\nexport type { GateResult } from \"./gates.ts\";\nexport { ZERO_SPENT, addSpent, remaining, isExhausted, estimateTokens } from \"./budget.ts\";\nexport { plan, toExNodes, assignRole, resourceCapsFor, openIteration } from \"./planner.ts\";\nexport type { PlanOptions, PlanReason, PlanResult, Skipped } from \"./planner.ts\";\nexport { synthesizeBrief, next } from \"./brief.ts\";\nexport type { NextResult } from \"./brief.ts\";\nexport { complete } from \"./complete.ts\";\nexport { coreRulesFor } from \"./rules.ts\";\nexport { applyAction, validateAction, init } from \"./methodology.ts\";\nexport type { InitInput } from \"./methodology.ts\";\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["VERSION"],"mappings":"2jCAAO,IAAMA,EAAAA,CAAU","file":"index.mjs","sourcesContent":["export const VERSION = \"0.6.0-stage\";\nexport * from \"./types.ts\";\nexport { WorkflowError, fail } from \"./errors.ts\";\nexport { createState, appendEvent, lastEvent, nowOf } from \"./state.ts\";\nexport {\n  registerRole,\n  retireRole,\n  hasCapability,\n  rolesWith,\n  approversFor,\n  requireCapabilities,\n  separationLost,\n  canDo,\n  requireCap,\n} from \"./roles.ts\";\nexport {\n  assertId,\n  stageOf,\n  nextStageOf,\n  isTerminalStage,\n  getItem,\n  addItem,\n  editItem,\n  moveItem,\n  addEvidence,\n  raiseBlocker,\n  clearBlocker,\n} from \"./items.ts\";\nexport type { ItemPatch } from \"./items.ts\";\nexport { applyAgreement, retireAgreement } from \"./agreements.ts\";\nexport { evaluatePolicies, assertPolicies } from \"./policies.ts\";\nexport { checkGate, authorOf, lastDispatchBefore, raisePending, decide } from \"./gates.ts\";\nexport type { GateResult } from \"./gates.ts\";\nexport { ZERO_SPENT, addSpent, remaining, isExhausted, estimateTokens } from \"./budget.ts\";\nexport type { EstimateMode } from \"./budget.ts\";\nexport { plan, toExNodes, assignRole, resourceCapsFor, openIteration } from \"./planner.ts\";\nexport type { PlanOptions, PlanReason, PlanResult, Skipped } from \"./planner.ts\";\nexport { synthesizeBrief, next, openQuestions } from \"./brief.ts\";\nexport type { NextResult } from \"./brief.ts\";\nexport { complete } from \"./complete.ts\";\nexport { correctAccounting } from \"./accounting.ts\";\nexport type { AccountingPatch } from \"./accounting.ts\";\nexport { coreRulesFor } from \"./rules.ts\";\nexport { applyAction, validateAction, init, changeConfig } from \"./methodology.ts\";\nexport type { InitInput } from \"./methodology.ts\";\n"]}

package/dist/kanban/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunk7HZXZF3L_cjs=require('../chunk-7HZXZF3L.cjs');require('../chunk-23P7C25E.cjs'),require('../chunk-S3BXVHO7.cjs');Object.defineProperty(exports,"ACTIVE",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.a}});Object.defineProperty(exports,"CADENCE_EVENT",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.s}});Object.defineProperty(exports,"CLASSES",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.k}});Object.defineProperty(exports,"DAY_MS",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.l}});Object.defineProperty(exports,"DEFAULT_COLUMNS",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.n}});Object.defineProperty(exports,"KANBAN_CADENCES",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.j}});Object.defineProperty(exports,"KANBAN_VOCABULARY",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.F}});Object.defineProperty(exports,"OPEN",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.b}});Object.defineProperty(exports,"activeExpedites",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.h}});Object.defineProperty(exports,"addedAt",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.p}});Object.defineProperty(exports,"board",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.r}});Object.defineProperty(exports,"byClassThenAge",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.H}});Object.defineProperty(exports,"cadencesDue",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.t}});Object.defineProperty(exports,"cardAge",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.q}});Object.defineProperty(exports,"columnIndex",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.f}});Object.defineProperty(exports,"columnStays",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.w}});Object.defineProperty(exports,"commitmentColumn",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.d}});Object.defineProperty(exports,"configOf",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.m}});Object.defineProperty(exports,"deliveryColumn",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.e}});Object.defineProperty(exports,"enteredStageAt",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.i}});Object.defineProperty(exports,"kanban",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.I}});Object.defineProperty(exports,"kanbanCeremonies",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.B}});Object.defineProperty(exports,"kanbanMetrics",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.x}});Object.defineProperty(exports,"kanbanRoles",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.C}});Object.defineProperty(exports,"kanbanRules",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.D}});Object.defineProperty(exports,"kanbanStages",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.E}});Object.defineProperty(exports,"onBoard",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.g}});Object.defineProperty(exports,"opsReport",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.y}});Object.defineProperty(exports,"optionsColumn",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.c}});Object.defineProperty(exports,"percentile",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.v}});Object.defineProperty(exports,"priorityByClass",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.G}});Object.defineProperty(exports,"replay",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.u}});Object.defineProperty(exports,"riskReport",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.z}});Object.defineProperty(exports,"validateKanbanConfig",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.o}});Object.defineProperty(exports,"wantItems",{enumerable:true,get:function(){return chunk7HZXZF3L_cjs.A}});//# sourceMappingURL=index.cjs.map
+'use strict';var chunk2OVYXXNV_cjs=require('../chunk-2OVYXXNV.cjs');require('../chunk-ZTE7LREB.cjs'),require('../chunk-S3BXVHO7.cjs');Object.defineProperty(exports,"ACTIVE",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.a}});Object.defineProperty(exports,"CADENCE_EVENT",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.s}});Object.defineProperty(exports,"CLASSES",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.k}});Object.defineProperty(exports,"DAY_MS",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.l}});Object.defineProperty(exports,"DEFAULT_COLUMNS",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.n}});Object.defineProperty(exports,"KANBAN_CADENCES",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.j}});Object.defineProperty(exports,"KANBAN_VOCABULARY",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.F}});Object.defineProperty(exports,"OPEN",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.b}});Object.defineProperty(exports,"activeExpedites",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.h}});Object.defineProperty(exports,"addedAt",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.p}});Object.defineProperty(exports,"board",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.r}});Object.defineProperty(exports,"byClassThenAge",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.H}});Object.defineProperty(exports,"cadencesDue",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.t}});Object.defineProperty(exports,"cardAge",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.q}});Object.defineProperty(exports,"columnIndex",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.f}});Object.defineProperty(exports,"columnStays",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.w}});Object.defineProperty(exports,"commitmentColumn",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.d}});Object.defineProperty(exports,"configOf",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.m}});Object.defineProperty(exports,"deliveryColumn",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.e}});Object.defineProperty(exports,"enteredStageAt",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.i}});Object.defineProperty(exports,"kanban",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.I}});Object.defineProperty(exports,"kanbanCeremonies",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.B}});Object.defineProperty(exports,"kanbanMetrics",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.x}});Object.defineProperty(exports,"kanbanRoles",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.C}});Object.defineProperty(exports,"kanbanRules",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.D}});Object.defineProperty(exports,"kanbanStages",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.E}});Object.defineProperty(exports,"onBoard",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.g}});Object.defineProperty(exports,"opsReport",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.y}});Object.defineProperty(exports,"optionsColumn",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.c}});Object.defineProperty(exports,"percentile",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.v}});Object.defineProperty(exports,"priorityByClass",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.G}});Object.defineProperty(exports,"replay",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.u}});Object.defineProperty(exports,"riskReport",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.z}});Object.defineProperty(exports,"validateKanbanConfig",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.o}});Object.defineProperty(exports,"wantItems",{enumerable:true,get:function(){return chunk2OVYXXNV_cjs.A}});//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/kanban/index.mjs

@@ -1,2 +1,2 @@
-export{a as ACTIVE,s as CADENCE_EVENT,k as CLASSES,l as DAY_MS,n as DEFAULT_COLUMNS,j as KANBAN_CADENCES,F as KANBAN_VOCABULARY,b as OPEN,h as activeExpedites,p as addedAt,r as board,H as byClassThenAge,t as cadencesDue,q as cardAge,f as columnIndex,w as columnStays,d as commitmentColumn,m as configOf,e as deliveryColumn,i as enteredStageAt,I as kanban,B as kanbanCeremonies,x as kanbanMetrics,C as kanbanRoles,D as kanbanRules,E as kanbanStages,g as onBoard,y as opsReport,c as optionsColumn,v as percentile,G as priorityByClass,u as replay,z as riskReport,o as validateKanbanConfig,A as wantItems}from'../chunk-UOGNVWVO.mjs';import'../chunk-FLCYD2QF.mjs';import'../chunk-2FRRD6A3.mjs';//# sourceMappingURL=index.mjs.map
+export{a as ACTIVE,s as CADENCE_EVENT,k as CLASSES,l as DAY_MS,n as DEFAULT_COLUMNS,j as KANBAN_CADENCES,F as KANBAN_VOCABULARY,b as OPEN,h as activeExpedites,p as addedAt,r as board,H as byClassThenAge,t as cadencesDue,q as cardAge,f as columnIndex,w as columnStays,d as commitmentColumn,m as configOf,e as deliveryColumn,i as enteredStageAt,I as kanban,B as kanbanCeremonies,x as kanbanMetrics,C as kanbanRoles,D as kanbanRules,E as kanbanStages,g as onBoard,y as opsReport,c as optionsColumn,v as percentile,G as priorityByClass,u as replay,z as riskReport,o as validateKanbanConfig,A as wantItems}from'../chunk-GT57PLUT.mjs';import'../chunk-Z3PU6EBI.mjs';import'../chunk-2FRRD6A3.mjs';//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/schema/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkWOGK54HB_cjs=require('../chunk-WOGK54HB.cjs');require('../chunk-S3BXVHO7.cjs');Object.defineProperty(exports,"DRAFT_07",{enumerable:true,get:function(){return chunkWOGK54HB_cjs.c}});Object.defineProperty(exports,"assertValid",{enumerable:true,get:function(){return chunkWOGK54HB_cjs.b}});Object.defineProperty(exports,"handoffSchema",{enumerable:true,get:function(){return chunkWOGK54HB_cjs.h}});Object.defineProperty(exports,"itemPatchSchema",{enumerable:true,get:function(){return chunkWOGK54HB_cjs.g}});Object.defineProperty(exports,"kanbanConfigSchema",{enumerable:true,get:function(){return chunkWOGK54HB_cjs.j}});Object.defineProperty(exports,"newItemSchema",{enumerable:true,get:function(){return chunkWOGK54HB_cjs.f}});Object.defineProperty(exports,"roleSchema",{enumerable:true,get:function(){return chunkWOGK54HB_cjs.e}});Object.defineProperty(exports,"scrumConfigSchema",{enumerable:true,get:function(){return chunkWOGK54HB_cjs.i}});Object.defineProperty(exports,"validate",{enumerable:true,get:function(){return chunkWOGK54HB_cjs.a}});Object.defineProperty(exports,"waterfallConfigSchema",{enumerable:true,get:function(){return chunkWOGK54HB_cjs.k}});Object.defineProperty(exports,"workflowStateSchema",{enumerable:true,get:function(){return chunkWOGK54HB_cjs.d}});//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/schema/index.cjs.map

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

package/dist/schema/index.d.cts

@@ -0,0 +1,57 @@
+/** The JSON Schema (draft-07) subset ts-json-schema-generator emits for our types and the validator understands. */
+interface JsonSchema {
+    $schema?: string;
+    $ref?: string;
+    definitions?: Record<string, JsonSchema>;
+    type?: string | string[];
+    const?: unknown;
+    enum?: unknown[];
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    additionalProperties?: boolean | JsonSchema;
+    items?: JsonSchema;
+    anyOf?: JsonSchema[];
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    pattern?: string;
+    description?: string;
+}
+/** A self-contained document: the root points into its own definitions. */
+interface JsonSchemaDocument extends JsonSchema {
+    $schema: string;
+    $ref: string;
+    definitions: Record<string, JsonSchema>;
+}
+interface SchemaError {
+    /** JSON pointer to the offending value ("/" for the root) */
+    path: string;
+    /** which keyword failed: type, const, enum, required, additionalProperties, minimum, maximum, minLength, pattern */
+    keyword: string;
+    message: string;
+    expected: string;
+    found: string;
+}
+
+/** Validate `value` against `schema` (a document: `$ref`s resolve against its `definitions`). Returns every error found. */
+declare function validate(schema: JsonSchema, value: unknown): SchemaError[];
+/** Throw WorkflowError("invalid-input") describing the first problem when `value` does not match `schema`. */
+declare function assertValid(schema: JsonSchema, value: unknown, what: string): void;
+
+declare const DRAFT_07 = "http://json-schema.org/draft-07/schema#";
+/** `.workflow/state.json` */
+declare const workflowStateSchema: JsonSchemaDocument;
+/** a role manifest (`.workflow/roles/*.json`, `exwf role add`) */
+declare const roleSchema: JsonSchemaDocument;
+/** `exwf add <item.json>` */
+declare const newItemSchema: JsonSchemaDocument;
+/** `exwf edit <id> <patch.json>` */
+declare const itemPatchSchema: JsonSchemaDocument;
+/** `exwf complete <id> <handoff.json>` */
+declare const handoffSchema: JsonSchemaDocument;
+/** `exwf init scrum --config` / the scrum-master policy.json */
+declare const scrumConfigSchema: JsonSchemaDocument;
+declare const kanbanConfigSchema: JsonSchemaDocument;
+declare const waterfallConfigSchema: JsonSchemaDocument;
+
+export { DRAFT_07, type JsonSchema, type JsonSchemaDocument, type SchemaError, assertValid, handoffSchema, itemPatchSchema, kanbanConfigSchema, newItemSchema, roleSchema, scrumConfigSchema, validate, waterfallConfigSchema, workflowStateSchema };

package/dist/schema/index.d.ts

@@ -0,0 +1,57 @@
+/** The JSON Schema (draft-07) subset ts-json-schema-generator emits for our types and the validator understands. */
+interface JsonSchema {
+    $schema?: string;
+    $ref?: string;
+    definitions?: Record<string, JsonSchema>;
+    type?: string | string[];
+    const?: unknown;
+    enum?: unknown[];
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    additionalProperties?: boolean | JsonSchema;
+    items?: JsonSchema;
+    anyOf?: JsonSchema[];
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    pattern?: string;
+    description?: string;
+}
+/** A self-contained document: the root points into its own definitions. */
+interface JsonSchemaDocument extends JsonSchema {
+    $schema: string;
+    $ref: string;
+    definitions: Record<string, JsonSchema>;
+}
+interface SchemaError {
+    /** JSON pointer to the offending value ("/" for the root) */
+    path: string;
+    /** which keyword failed: type, const, enum, required, additionalProperties, minimum, maximum, minLength, pattern */
+    keyword: string;
+    message: string;
+    expected: string;
+    found: string;
+}
+
+/** Validate `value` against `schema` (a document: `$ref`s resolve against its `definitions`). Returns every error found. */
+declare function validate(schema: JsonSchema, value: unknown): SchemaError[];
+/** Throw WorkflowError("invalid-input") describing the first problem when `value` does not match `schema`. */
+declare function assertValid(schema: JsonSchema, value: unknown, what: string): void;
+
+declare const DRAFT_07 = "http://json-schema.org/draft-07/schema#";
+/** `.workflow/state.json` */
+declare const workflowStateSchema: JsonSchemaDocument;
+/** a role manifest (`.workflow/roles/*.json`, `exwf role add`) */
+declare const roleSchema: JsonSchemaDocument;
+/** `exwf add <item.json>` */
+declare const newItemSchema: JsonSchemaDocument;
+/** `exwf edit <id> <patch.json>` */
+declare const itemPatchSchema: JsonSchemaDocument;
+/** `exwf complete <id> <handoff.json>` */
+declare const handoffSchema: JsonSchemaDocument;
+/** `exwf init scrum --config` / the scrum-master policy.json */
+declare const scrumConfigSchema: JsonSchemaDocument;
+declare const kanbanConfigSchema: JsonSchemaDocument;
+declare const waterfallConfigSchema: JsonSchemaDocument;
+
+export { DRAFT_07, type JsonSchema, type JsonSchemaDocument, type SchemaError, assertValid, handoffSchema, itemPatchSchema, kanbanConfigSchema, newItemSchema, roleSchema, scrumConfigSchema, validate, waterfallConfigSchema, workflowStateSchema };

package/dist/schema/index.mjs

@@ -0,0 +1,2 @@
+export{c as DRAFT_07,b as assertValid,h as handoffSchema,g as itemPatchSchema,j as kanbanConfigSchema,f as newItemSchema,e as roleSchema,i as scrumConfigSchema,a as validate,k as waterfallConfigSchema,d as workflowStateSchema}from'../chunk-5TXYMLBF.mjs';import'../chunk-2FRRD6A3.mjs';//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/schema/index.mjs.map

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

package/dist/scrum/index.cjs

@@ -1,2 +1,2 @@
-'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
+'use strict';var chunkUUOMQMWT_cjs=require('../chunk-UUOMQMWT.cjs');require('../chunk-N3QB2S7R.cjs');var chunkZTE7LREB_cjs=require('../chunk-ZTE7LREB.cjs');require('../chunk-S3BXVHO7.cjs');Object.defineProperty(exports,"SCRUM_VOCABULARY",{enumerable:true,get:function(){return chunkUUOMQMWT_cjs.h}});Object.defineProperty(exports,"closeSprint",{enumerable:true,get:function(){return chunkUUOMQMWT_cjs.k}});Object.defineProperty(exports,"configOf",{enumerable:true,get:function(){return chunkUUOMQMWT_cjs.i}});Object.defineProperty(exports,"dailyReport",{enumerable:true,get:function(){return chunkUUOMQMWT_cjs.a}});Object.defineProperty(exports,"resumeStageOf",{enumerable:true,get:function(){return chunkUUOMQMWT_cjs.j}});Object.defineProperty(exports,"scrum",{enumerable:true,get:function(){return chunkUUOMQMWT_cjs.l}});Object.defineProperty(exports,"scrumCeremonies",{enumerable:true,get:function(){return chunkUUOMQMWT_cjs.b}});Object.defineProperty(exports,"scrumMetrics",{enumerable:true,get:function(){return chunkUUOMQMWT_cjs.d}});Object.defineProperty(exports,"scrumRoles",{enumerable:true,get:function(){return chunkUUOMQMWT_cjs.e}});Object.defineProperty(exports,"scrumRules",{enumerable:true,get:function(){return chunkUUOMQMWT_cjs.f}});Object.defineProperty(exports,"scrumStages",{enumerable:true,get:function(){return chunkUUOMQMWT_cjs.g}});Object.defineProperty(exports,"validateScrumConfig",{enumerable:true,get:function(){return chunkUUOMQMWT_cjs.c}});Object.defineProperty(exports,"canDo",{enumerable:true,get:function(){return chunkZTE7LREB_cjs.n}});//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/scrum/index.d.cts

@@ -1,5 +1,6 @@
-import { Budget, Policy, WorkflowState, Role, Rule, Stage, ItemStatus, Methodology, Ceremony, CoreTerm } from '../types.cjs';
-export { c as canDo } from '../roles-aneKYJ3Z.cjs';
+import { Budget, Policy, WorkflowState, Role, Rule, Stage, ItemStatus, Methodology, Ceremony, CoreTerm, WorkItem } from '../types.cjs';
+import { E as EstimateMode } from '../budget-JyNKxP5N.cjs';
+export { c as canDo } from '../budget-JyNKxP5N.cjs';
 
 interface ScrumConfig {
     sprintBudget: Budget;
@@ -8,6 +9,12 @@ interface ScrumConfig {
     refinementSharePct: number;
     allowMidSprintAdd: "never" | "po-only" | "any";
     inProgressWipLimit?: number;
+    /** Close the sprint automatically when its budget is spent and nothing is in flight; default true. */
+    autoClose?: boolean;
+    /** How the planner and sprint planning price a candidate; default "per-weight". */
+    estimateMode?: EstimateMode;
+    /** Tokens per weight unit when no accounting history exists; default 20000. */
+    fallbackTokensPerWeight?: number;
 }
 declare function validateScrumConfig(raw: unknown): ScrumConfig;
 
@@ -20,6 +27,8 @@ interface ScrumMetrics {
     carryoverRatio: number;
     budgetUtilisation: number;
     costPerPoint: number;
+    /** The open sprint right now; all zeros when none is open. */
+    current: Record<string, number>;
 }
 declare function scrumMetrics(state: WorkflowState): ScrumMetrics;
 
@@ -52,8 +61,14 @@ declare function scrumCeremonies(methodology: () => Methodology): Record<string,
 declare const SCRUM_VOCABULARY: Record<CoreTerm, string>;
 /** Advanced; used by ceremonies. */
 declare function configOf(state: WorkflowState): ScrumConfig;
+/**
+ * The stage a carried-over item was returned from when it was in a review stage: it resumes there, not at the
+ * sprint start. closeSprint releases blocked and awaiting_human items, so the stage (its `review` flag) is read from
+ * the last system transition, not the status. Without `state` only a `review` status is recognised.
+ */
+declare function resumeStageOf(item: WorkItem, state?: WorkflowState): string | undefined;
 /** Advanced; used by ceremonies. Closes the open sprint and returns unfinished work (and its open questions) to the backlog. */
 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, closeSprint, configOf, dailyReport, scrum, scrumCeremonies, scrumMetrics, scrumRoles, scrumRules, scrumStages, validateScrumConfig };
+export { type DailyReport, SCRUM_VOCABULARY, type ScrumConfig, type ScrumMetrics, closeSprint, configOf, dailyReport, resumeStageOf, scrum, scrumCeremonies, scrumMetrics, scrumRoles, scrumRules, scrumStages, validateScrumConfig };

package/dist/scrum/index.d.ts

@@ -1,5 +1,6 @@
-import { Budget, Policy, WorkflowState, Role, Rule, Stage, ItemStatus, Methodology, Ceremony, CoreTerm } from '../types.js';
-export { c as canDo } from '../roles-BLBRKhUZ.js';
+import { Budget, Policy, WorkflowState, Role, Rule, Stage, ItemStatus, Methodology, Ceremony, CoreTerm, WorkItem } from '../types.js';
+import { E as EstimateMode } from '../budget-Cx63FX2K.js';
+export { c as canDo } from '../budget-Cx63FX2K.js';
 
 interface ScrumConfig {
     sprintBudget: Budget;
@@ -8,6 +9,12 @@ interface ScrumConfig {
     refinementSharePct: number;
     allowMidSprintAdd: "never" | "po-only" | "any";
     inProgressWipLimit?: number;
+    /** Close the sprint automatically when its budget is spent and nothing is in flight; default true. */
+    autoClose?: boolean;
+    /** How the planner and sprint planning price a candidate; default "per-weight". */
+    estimateMode?: EstimateMode;
+    /** Tokens per weight unit when no accounting history exists; default 20000. */
+    fallbackTokensPerWeight?: number;
 }
 declare function validateScrumConfig(raw: unknown): ScrumConfig;
 
@@ -20,6 +27,8 @@ interface ScrumMetrics {
     carryoverRatio: number;
     budgetUtilisation: number;
     costPerPoint: number;
+    /** The open sprint right now; all zeros when none is open. */
+    current: Record<string, number>;
 }
 declare function scrumMetrics(state: WorkflowState): ScrumMetrics;
 
@@ -52,8 +61,14 @@ declare function scrumCeremonies(methodology: () => Methodology): Record<string,
 declare const SCRUM_VOCABULARY: Record<CoreTerm, string>;
 /** Advanced; used by ceremonies. */
 declare function configOf(state: WorkflowState): ScrumConfig;
+/**
+ * The stage a carried-over item was returned from when it was in a review stage: it resumes there, not at the
+ * sprint start. closeSprint releases blocked and awaiting_human items, so the stage (its `review` flag) is read from
+ * the last system transition, not the status. Without `state` only a `review` status is recognised.
+ */
+declare function resumeStageOf(item: WorkItem, state?: WorkflowState): string | undefined;
 /** Advanced; used by ceremonies. Closes the open sprint and returns unfinished work (and its open questions) to the backlog. */
 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, closeSprint, configOf, dailyReport, scrum, scrumCeremonies, scrumMetrics, scrumRoles, scrumRules, scrumStages, validateScrumConfig };
+export { type DailyReport, SCRUM_VOCABULARY, type ScrumConfig, type ScrumMetrics, closeSprint, configOf, dailyReport, resumeStageOf, scrum, scrumCeremonies, scrumMetrics, scrumRoles, scrumRules, scrumStages, validateScrumConfig };

package/dist/scrum/index.mjs

@@ -1,2 +1,2 @@
-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
+export{h as SCRUM_VOCABULARY,k as closeSprint,i as configOf,a as dailyReport,j as resumeStageOf,l as scrum,b as scrumCeremonies,d as scrumMetrics,e as scrumRoles,f as scrumRules,g as scrumStages,c as validateScrumConfig}from'../chunk-7CDGPTEJ.mjs';import'../chunk-IHE5K4X3.mjs';export{n as canDo}from'../chunk-Z3PU6EBI.mjs';import'../chunk-2FRRD6A3.mjs';//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/types.d.cts

@@ -62,6 +62,8 @@ interface WorkItem {
     /** change-request: impact analysis required before the change control board decides */
     impactAnalysis?: ImpactAnalysis;
 }
+/** Fields `editItem` / `exwf edit` may change. */
+type ItemPatch = Partial<Omit<WorkItem, "id" | "stage" | "status" | "transitions" | "evidence" | "blockers">>;
 /** 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">> & {
     stage?: string;
@@ -113,11 +115,16 @@ interface Budget {
     turns?: number;
     wallclockMs?: number;
 }
+interface Spent {
+    tokens: number;
+    turns: number;
+    wallclockMs: number;
+}
 interface Iteration {
     id: string;
     goal: string;
     budget: Budget;
-    spent: Required<Budget>;
+    spent: Spent;
     startedAt: string;
     endedAt?: string;
     committed: string[];
@@ -170,6 +177,8 @@ interface Accounting {
     durationMs: number;
     startedAt: string;
     endedAt: string;
+    /** The tokens are a placeholder the host will correct with correctAccounting, not the host's usage figures. */
+    estimate?: boolean;
 }
 interface Event {
     seq: number;
@@ -189,6 +198,7 @@ interface PendingHuman {
 type LessonChange = {
     kind: "agreement";
     text: string;
+    replaces?: string;
 } | {
     kind: "dod";
     policy: Policy;
@@ -303,6 +313,15 @@ interface Brief {
     }>;
     budgetRemaining: Budget;
     gateAhead?: Gate;
+    /** for a question item: the escalating item's last handoff */
+    parent?: {
+        item: string;
+        role: string;
+        notes: string;
+        produced: Handoff["produced"];
+        open_questions: string[];
+        do_not: string[];
+    };
 }
 type CoreTerm = "backlog" | "item" | "stage" | "iteration" | "increment" | "ceremony" | "gate";
 type CeremonyInput = {
@@ -329,6 +348,10 @@ interface PlannerOptions {
     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;
+    /** How estimateTokens prices a candidate; default "per-weight". */
+    estimateMode?: "per-weight" | "per-call";
+    /** Tokens per weight unit when no accounting history exists; default 20000. PlanOptions.fallbackTokensPerWeight wins. */
+    fallbackTokensPerWeight?: number;
 }
 interface Methodology<C = unknown> {
     name: MethodologyName;
@@ -349,11 +372,17 @@ 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;
+    /** Config keys that cannot change after init (changeConfig refuses them). */
+    lockedConfigKeys?: string[];
+    /** Called by changeConfig after the new config is stored; keeps derived state (e.g. stage policies) in step. */
+    afterConfigChange?(state: WorkflowState, 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";
+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"
+/** reserved: never thrown; kept for type compatibility */
+ | "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, ImpactAnalysis, ItemStatus, ItemType, Iteration, Lesson, LessonChange, Methodology, MethodologyName, ModelTier, NewItem, PendingHuman, Phase, PlannerOptions, Policy, Produced, 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, ItemPatch, ItemStatus, ItemType, Iteration, Lesson, LessonChange, Methodology, MethodologyName, ModelTier, NewItem, PendingHuman, Phase, PlannerOptions, Policy, Produced, Role, Rule, Spent, Stage, Transition, Verdict, Violation, WorkItem, WorkflowState };

package/dist/types.d.ts

@@ -62,6 +62,8 @@ interface WorkItem {
     /** change-request: impact analysis required before the change control board decides */
     impactAnalysis?: ImpactAnalysis;
 }
+/** Fields `editItem` / `exwf edit` may change. */
+type ItemPatch = Partial<Omit<WorkItem, "id" | "stage" | "status" | "transitions" | "evidence" | "blockers">>;
 /** 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">> & {
     stage?: string;
@@ -113,11 +115,16 @@ interface Budget {
     turns?: number;
     wallclockMs?: number;
 }
+interface Spent {
+    tokens: number;
+    turns: number;
+    wallclockMs: number;
+}
 interface Iteration {
     id: string;
     goal: string;
     budget: Budget;
-    spent: Required<Budget>;
+    spent: Spent;
     startedAt: string;
     endedAt?: string;
     committed: string[];
@@ -170,6 +177,8 @@ interface Accounting {
     durationMs: number;
     startedAt: string;
     endedAt: string;
+    /** The tokens are a placeholder the host will correct with correctAccounting, not the host's usage figures. */
+    estimate?: boolean;
 }
 interface Event {
     seq: number;
@@ -189,6 +198,7 @@ interface PendingHuman {
 type LessonChange = {
     kind: "agreement";
     text: string;
+    replaces?: string;
 } | {
     kind: "dod";
     policy: Policy;
@@ -303,6 +313,15 @@ interface Brief {
     }>;
     budgetRemaining: Budget;
     gateAhead?: Gate;
+    /** for a question item: the escalating item's last handoff */
+    parent?: {
+        item: string;
+        role: string;
+        notes: string;
+        produced: Handoff["produced"];
+        open_questions: string[];
+        do_not: string[];
+    };
 }
 type CoreTerm = "backlog" | "item" | "stage" | "iteration" | "increment" | "ceremony" | "gate";
 type CeremonyInput = {
@@ -329,6 +348,10 @@ interface PlannerOptions {
     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;
+    /** How estimateTokens prices a candidate; default "per-weight". */
+    estimateMode?: "per-weight" | "per-call";
+    /** Tokens per weight unit when no accounting history exists; default 20000. PlanOptions.fallbackTokensPerWeight wins. */
+    fallbackTokensPerWeight?: number;
 }
 interface Methodology<C = unknown> {
     name: MethodologyName;
@@ -349,11 +372,17 @@ 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;
+    /** Config keys that cannot change after init (changeConfig refuses them). */
+    lockedConfigKeys?: string[];
+    /** Called by changeConfig after the new config is stored; keeps derived state (e.g. stage policies) in step. */
+    afterConfigChange?(state: WorkflowState, 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";
+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"
+/** reserved: never thrown; kept for type compatibility */
+ | "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, ImpactAnalysis, ItemStatus, ItemType, Iteration, Lesson, LessonChange, Methodology, MethodologyName, ModelTier, NewItem, PendingHuman, Phase, PlannerOptions, Policy, Produced, 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, ItemPatch, ItemStatus, ItemType, Iteration, Lesson, LessonChange, Methodology, MethodologyName, ModelTier, NewItem, PendingHuman, Phase, PlannerOptions, Policy, Produced, Role, Rule, Spent, Stage, Transition, Verdict, Violation, WorkItem, WorkflowState };

package/dist/waterfall/index.cjs

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

package/dist/waterfall/index.d.cts

@@ -21,6 +21,8 @@ interface WaterfallConfig {
         to: string[];
     };
     humanGates: "all" | string[];
+    /** tokens per weight unit when there is no accounting history (default 20000, as Scrum) */
+    fallbackTokensPerWeight?: number;
 }
 declare const DEFAULT_PHASE_IDS: readonly string[];
 declare const DEFAULT_DELIVERABLES: Record<string, string[]>;