agentera 3.0.0-dev.21 → 3.0.0-dev.23

package/dist/state/write/operations.js

@@ -2,6 +2,7 @@ export const WRITABLE_ARTIFACTS = ["progress", "decisions", "plan", "health", "e
 export const WRITE_VERBS = [
     "append",
     "update",
+    "amend",
     "set-status",
     "set-plan-status",
     "record-evaluation",
@@ -11,6 +12,8 @@ export const WRITE_VERBS = [
     "publish",
     "explain",
 ];
+/** Caller-selected existing decision number (update/amend). Never CLI-assigned. */
+const EXISTING_DECISION_NUMBER_DESCRIPTION = "Existing decision number to update or amend. Caller-selected: it must match a numbered decision in the active projection or numbered archive and is never assigned by the CLI.";
 const progressAppend = [
     {
         flag: "--type",
@@ -60,7 +63,13 @@ const decisionAppend = [
     { flag: "--date", field: "date", kind: "date", required: false },
 ];
 const decisionUpdate = [
-    { flag: "--number", field: "number", kind: "integer", required: true },
+    {
+        flag: "--number",
+        field: "number",
+        kind: "integer",
+        required: true,
+        description: EXISTING_DECISION_NUMBER_DESCRIPTION,
+    },
     {
         flag: "--satisfaction-state",
         field: "satisfaction.state",
@@ -72,6 +81,44 @@ const decisionUpdate = [
     { flag: "--confirmed-by", field: "satisfaction.user_confirmation.confirmed_by", kind: "string" },
     { flag: "--confirmed-at", field: "satisfaction.user_confirmation.confirmed_at", kind: "string" },
 ];
+/**
+ * Amending decision content fields. `--number` is caller-selected (an existing
+ * decision). At least one amendable content field must be supplied; individual
+ * fields are optional so the writer can validate the union requirement.
+ * `--alternative-rejected` is repeatable and appends rejected alternatives.
+ * Confidence values must be current vocabulary (firm|provisional|exploratory).
+ * Amendment publication publishes a record-local revision document override
+ * with recovery; the decisions projection is never rewritten.
+ */
+const decisionAmend = [
+    {
+        flag: "--number",
+        field: "number",
+        kind: "integer",
+        required: true,
+        description: EXISTING_DECISION_NUMBER_DESCRIPTION,
+    },
+    { flag: "--question", field: "question", kind: "string", required: false },
+    { flag: "--context", field: "context", kind: "string", required: false },
+    { flag: "--alternative-chosen", field: "alternatives.chosen", kind: "string", required: false },
+    {
+        flag: "--alternative-rejected",
+        field: "alternatives.rejected",
+        kind: "string_list",
+        repeatable: true,
+        required: false,
+    },
+    { flag: "--choice", field: "choice", kind: "string", required: false },
+    { flag: "--reasoning", field: "reasoning", kind: "string", required: false },
+    {
+        flag: "--confidence",
+        field: "confidence",
+        kind: "string",
+        required: false,
+        validValues: ["firm", "provisional", "exploratory"],
+    },
+    { flag: "--feeds-into", field: "feeds_into", kind: "string", required: false },
+];
 const planTaskFields = [
     { flag: "--name", field: "name", kind: "string", required: true },
     { flag: "--depends-on", field: "depends_on", kind: "integer_list", repeatable: true },
@@ -109,6 +156,7 @@ const SPECS = [
     { artifact: "progress", verb: "append", fields: progressAppend, compacts: true },
     { artifact: "decisions", verb: "append", fields: decisionAppend, compacts: true },
     { artifact: "decisions", verb: "update", fields: decisionUpdate },
+    { artifact: "decisions", verb: "amend", fields: decisionAmend },
     { artifact: "plan", verb: "append", fields: planTaskFields },
     {
         artifact: "plan",

package/dist/state/write/operations.js.map

@@ -1 +1 @@
-{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../src/state/write/operations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../src/state/write/operations.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAU,CAAC;AAGtG,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,YAAY;IACZ,iBAAiB;IACjB,mBAAmB;IACnB,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;CACD,CAAC;AAyCX,mFAAmF;AACnF,MAAM,oCAAoC,GACxC,gLAAgL,CAAC;AAEnL,MAAM,cAAc,GAAqB;IACvC;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;KAClE;IACD;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;KAClE;IACD,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IACjE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC7E,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC9E,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC/D,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC7D,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;IACzD,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;IACjD,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE;IACvE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE;IACjE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE;CAC5D,CAAC;AAEF,MAAM,cAAc,GAAqB;IACvC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IACzE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IACvE,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC9F;QACE,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,uBAAuB;QAC9B,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,IAAI;KACjB;IACD,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IACrE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC3E;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC;KACpD;IACD,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC7D,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;CACjE,CAAC;AAEF,MAAM,cAAc,GAAqB;IACvC;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,oCAAoC;KAClD;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,CAAC,MAAM,EAAE,yBAAyB,EAAE,0BAA0B,CAAC;KAC7E;IACD,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,QAAQ,EAAE;IACnF,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,6CAA6C,EAAE,IAAI,EAAE,QAAQ,EAAE;IAChG,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,6CAA6C,EAAE,IAAI,EAAE,QAAQ,EAAE;CACjG,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,aAAa,GAAqB;IACtC;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,oCAAoC;KAClD;IACD,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC1E,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;IACxE,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC/F;QACE,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,uBAAuB;QAC9B,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,KAAK;KAChB;IACD,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;IACtE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC5E;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC;KACpD;IACD,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;CAC/E,CAAC;AAEF,MAAM,cAAc,GAAqB;IACvC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IACjE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE;IACrF,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE;IACpF;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,CAAC;QAC9D,WAAW,EAAE,4DAA4D;KAC1E;CACF,CAAC;AAEF,MAAM,oBAAoB,GAAqB;IAC7C,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;IAClE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IACxF;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QAC7B,WAAW,EAAE,gDAAgD;KAC9D;IACD,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,6BAA6B,EAAE,IAAI,EAAE,QAAQ,EAAE;IACpF;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,uBAAuB;QAC9B,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,mDAAmD;KACjE;CACF,CAAC;AAEF,MAAM,KAAK,GAAoB;IAC7B,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE;IAChF,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE;IACjF,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE;IACjE,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE;IAC/D,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE;IAC5D;QACE,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;YAClE,GAAG,cAAc;iBACd,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC;iBAC3C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzD,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE;YACrE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1D;KACF;IACD;QACE,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;YAClE;gBACE,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,QAAQ;gBACf,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,CAAC;gBAC9D,WAAW,EAAE,4DAA4D;aAC1E;SACF;KACF;IACD;QACE,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,QAAQ;gBACf,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;gBACjC,WAAW,EAAE,sEAAsE;aACpF;SACF;KACF;IACD,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,oBAAoB,EAAE;IAC7E,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;IACnE;QACE,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,wBAAwB;QACnC,cAAc,EAAE,CAAC,WAAW,EAAE,wBAAwB,CAAC;QACvD,UAAU,EAAE,IAAI;KACjB;IACD;QACE,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,iBAAiB;QAC5B,cAAc,EAAE,CAAC,QAAQ,CAAC;QAC1B,QAAQ,EAAE,IAAI;KACf;IACD;QACE,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;YACtE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE;SACnG;QACD,UAAU,EAAE,IAAI;KACjB;IACD;QACE,QAAQ,EAAE,aAAa;QACvB,IAAI,EAAE,SAAS;QACf,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,aAAa;gBACnB,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,kDAAkD;aAChE;YACD;gBACE,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,QAAQ;gBACf,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,uDAAuD;aACrE;SACF;QACD,SAAS,EAAE,sBAAsB;QACjC,cAAc,EAAE,CAAC,QAAQ,CAAC;QAC1B,QAAQ,EAAE,IAAI;KACf;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,IAAY;IAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAA4B,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1E,OAAO;QACL,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9E,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAyB;IACnD,OAAO,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAkB,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,kBAAkB,CAAC,QAAQ,CAAC,KAAyB,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,QAAgB;IAC1D,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC7D,OAAO;QACL,QAAQ;QACR,SAAS;QACT,eAAe,EAAE,kBAAkB,QAAQ,wBAAwB;QACnE,eAAe,EAAE,MAAM,CAAC,WAAW,CACjC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACtB,IAAI;YACJ,kBAAkB,QAAQ,mBAAmB,IAAI,gBAAgB;SAClE,CAAC,CACH;QACD,gBAAgB,EAAE,IAAI;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAA6B,kBAAkB;IAE/C,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,aAAa;SAC5B,GAAG,CAAC,2BAA2B,CAAC;SAChC,MAAM,CAAC,CAAC,KAAK,EAAuB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IAC1D,OAAO;QACL,aAAa,EAAE,kCAAkC;QACjD,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EACJ,6HAA6H;QAC/H,SAAS,EAAE,4BAA4B;QACvC,iBAAiB,EAAE,+BAA+B;QAClD,SAAS;QACT,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;KACnF,CAAC;AACJ,CAAC"}

package/dist/state/write/transaction.js

@@ -7,37 +7,21 @@ import { dumpYamlMapping, loadYamlMapping } from "../../core/yaml.js";
 import { compactYamlFile, decisionProtectedOverflowCount, } from "../../hooks/compaction/index.js";
 import { assertRealpathBoundary, loadArtifactRegistry, resolveArtifactPath, } from "../../registries/artifactRegistry.js";
 import { withStateMutation, } from "./mutation.js";
-import { localDate, localTimestamp, nextEntryNumber, nextTaskNumber } from "./assign.js";
+import { nextEntryNumber } from "./assign.js";
+import { mutateCandidate, normalizedDecisionPayload } from "./candidateMutation.js";
+import { array, findByNumber, mapping, schemaViolation } from "./helpers.js";
 import { reject } from "./errors.js";
-import { findByNumber, schemaViolation } from "./helpers.js";
 import { validateArtifactBytes } from "./validate.js";
 import { planEvaluationViolations, validatePlanCreateInput, validatePlanPublicationCandidate, } from "./planPublication.js";
 import { dependencyReadyTasks } from "../../cli/capabilityContext/planState.js";
 import { publishImmutableFile, } from "../archivePublication.js";
-import { findArchivedReplay, isExactArchiveReplay, recoverArchivedEntry, } from "../archiveReplay.js";
+import { findArchivedReplay } from "../archiveReplay.js";
 import { discoverNumberedArchives } from "../archiveDiscovery.js";
 import { hydrateDecisionRecords, updateDecisionOverlay, } from "../decisionOverlay.js";
-import { repairHealthDuplicates, repairHealthProjectionBytes } from "../healthRepair.js";
+import { dispatchDecisionAmendment } from "../decisionRevisionPublication.js";
+import { decisionLegacyCoexistence, gateCandidateDecisions, gateCompactedDecisions, gateExistingDecisions, } from "../decisionLegacyValidation.js";
+import { repairHealthProjectionBytes } from "../healthRepair.js";
 import { executeExperimentPublication } from "./experimentPublication.js";
-function mapping(value) {
-    return value && typeof value === "object" && !Array.isArray(value)
-        ? value
-        : {};
-}
-function array(doc, key) {
-    return Array.isArray(doc[key])
-        ? doc[key].filter((v) => Boolean(v && typeof v === "object" && !Array.isArray(v)))
-        : [];
-}
-function mappingPath(entry, field) {
-    let value = entry;
-    for (const part of field.split(".")) {
-        if (!value || typeof value !== "object" || Array.isArray(value))
-            return undefined;
-        value = value[part];
-    }
-    return value;
-}
 function readExisting(target) {
     if (!fs.existsSync(target))
         return { doc: {}, bytes: "" };
@@ -49,329 +33,6 @@ function readExisting(target) {
         throw new Error(`cannot parse existing artifact '${target}': ${error.message}; run agentera check validate artifact before retrying`);
     }
 }
-function buildProgress(doc, values) {
-    const entry = {
-        number: nextEntryNumber(doc, "cycles"),
-        timestamp: values.timestamp ?? localTimestamp(),
-        type: values.type,
-        phase: values.phase,
-        what: values.what,
-    };
-    for (const field of ["inspiration", "discovered", "verified", "next"])
-        if (values[field] !== undefined)
-            entry[field] = values[field];
-    const context = { intent: mappingPath(values, "context.intent") };
-    for (const field of ["constraints", "unknowns", "scope"]) {
-        const value = mappingPath(values, `context.${field}`);
-        if (value !== undefined)
-            context[field] = value;
-    }
-    entry.context = context;
-    return entry;
-}
-function buildDecision(doc, values) {
-    const alternatives = mapping(values.alternatives);
-    const rejected = Array.isArray(alternatives.rejected) ? alternatives.rejected : [];
-    const entry = {
-        number: nextEntryNumber(doc, "decisions"),
-        date: values.date ?? localDate(),
-        question: values.question,
-        context: values.context,
-        alternatives: [
-            { name: alternatives.chosen, status: "chosen" },
-            ...rejected.map((name) => ({ name, status: "rejected" })),
-        ],
-        choice: values.choice,
-        reasoning: values.reasoning,
-        confidence: values.confidence,
-    };
-    if (values.feeds_into !== undefined)
-        entry.feeds_into = values.feeds_into;
-    return entry;
-}
-function normalizedDecisionPayload(values) {
-    const payload = { ...values };
-    const alternatives = mapping(values.alternatives);
-    payload.alternatives = [
-        { name: alternatives.chosen, status: "chosen" },
-        ...(Array.isArray(alternatives.rejected) ? alternatives.rejected : []).map((name) => ({
-            name,
-            status: "rejected",
-        })),
-    ];
-    return payload;
-}
-function mutateCandidate(req, doc, recovered) {
-    const candidate = structuredClone(doc);
-    if (req.artifact === "progress") {
-        const payload = req.callerPayload;
-        const entries = array(candidate, "cycles");
-        const replay = entries.find((entry) => isExactArchiveReplay(entry, payload));
-        if (replay)
-            return {
-                candidate,
-                written: replay,
-                assigned: { number: replay.number, timestamp: replay.timestamp },
-                replay: true,
-            };
-        if (recovered) {
-            recoverArchivedEntry(candidate, "cycles", entries, recovered, true);
-            return {
-                candidate,
-                written: recovered,
-                assigned: { number: recovered.number, timestamp: recovered.timestamp },
-                replay: true,
-            };
-        }
-        const entry = buildProgress(candidate, req.values);
-        candidate.cycles = [entry, ...entries];
-        return {
-            candidate,
-            written: entry,
-            assigned: { number: entry.number, timestamp: entry.timestamp },
-            replay: false,
-        };
-    }
-    if (req.artifact === "decisions" && req.spec.verb === "append") {
-        const entries = array(candidate, "decisions");
-        const payload = normalizedDecisionPayload(req.callerPayload);
-        const replay = entries.find((entry) => isExactArchiveReplay(entry, payload));
-        if (replay) {
-            const entry = replay;
-            return {
-                candidate,
-                written: entry,
-                assigned: { number: entry.number, date: entry.date },
-                replay: true,
-            };
-        }
-        if (recovered) {
-            recoverArchivedEntry(candidate, "decisions", entries, recovered, false);
-            return {
-                candidate,
-                written: recovered,
-                assigned: { number: recovered.number, date: recovered.date },
-                replay: true,
-            };
-        }
-        const entry = buildDecision(candidate, req.values);
-        candidate.decisions = [...entries, entry];
-        return {
-            candidate,
-            written: entry,
-            assigned: { number: entry.number, date: entry.date },
-            replay: false,
-        };
-    }
-    if (req.artifact === "health") {
-        if (req.spec.verb === "repair") {
-            if (!req.force)
-                reject({ class: "conflict", message: "health repair requires --force; use --dry-run to preview the edit" });
-            const number = Number(req.values.number);
-            const keep = req.values.keep === "last" ? "last" : "first";
-            const repaired = repairHealthDuplicates(candidate, number, keep);
-            if (repaired.removed === 0)
-                reject({ class: "unsupported_target", message: `health audit ${number} has no duplicate current-history rows to repair` });
-            return { candidate: repaired.candidate, written: { number, removed_rows: repaired.removed, retained: keep }, assigned: { number, removed_rows: repaired.removed }, replay: false };
-        }
-        if (req.input && ("audits" in req.input || "archive" in req.input)) {
-            reject({
-                class: "schema_violation",
-                message: "health append input must be one audit entry, not a whole health artifact",
-                violations: ["remove audits/archive wrapper fields"],
-            });
-        }
-        const entries = array(candidate, "audits");
-        const payload = req.callerPayload;
-        const replay = entries.find((entry) => isExactArchiveReplay(entry, payload));
-        if (replay) {
-            const entry = replay;
-            return {
-                candidate,
-                written: entry,
-                assigned: { number: entry.number, date: entry.date },
-                replay: true,
-            };
-        }
-        if (recovered) {
-            recoverArchivedEntry(candidate, "audits", entries, recovered, false);
-            return {
-                candidate,
-                written: recovered,
-                assigned: { number: recovered.number, date: recovered.date },
-                replay: true,
-            };
-        }
-        const entry = {
-            number: nextEntryNumber(candidate, "audits"),
-            date: req.input?.date ?? localDate(),
-            ...req.input,
-        };
-        candidate.audits = [...entries, entry];
-        return {
-            candidate,
-            written: entry,
-            assigned: { number: entry.number, date: entry.date },
-            replay: false,
-        };
-    }
-    const tasks = array(candidate, "tasks");
-    if (req.spec.verb === "append") {
-        const sameName = tasks.find((task) => task.name === req.values.name);
-        const payload = req.callerPayload;
-        if (sameName) {
-            if (isExactArchiveReplay(sameName, payload))
-                return {
-                    candidate,
-                    written: sameName,
-                    assigned: { number: sameName.number },
-                    replay: true,
-                };
-            reject({
-                class: "conflict",
-                message: `plan task "${req.values.name}" exists with different fields; use 'state plan update --task ${sameName.number}' to modify it`,
-            });
-        }
-        const entry = {
-            number: nextTaskNumber(candidate),
-            name: req.values.name,
-            status: req.values.status ?? "pending",
-        };
-        for (const field of ["depends_on", "acceptance"])
-            if (req.values[field] !== undefined)
-                entry[field] = req.values[field];
-        candidate.tasks = [...tasks, entry];
-        return { candidate, written: entry, assigned: { number: entry.number }, replay: false };
-    }
-    if (req.spec.verb === "update") {
-        const number = Number(req.values.task);
-        const entry = findByNumber(tasks, number);
-        if (!entry)
-            reject({ class: "unsupported_target", message: `no plan task with number ${number}` });
-        let changed = false;
-        for (const field of [
-            "name",
-            "depends_on",
-            "acceptance",
-            "status",
-            "evidence",
-            "blocked_reason",
-        ]) {
-            if (req.values[field] !== undefined && !isDeepStrictEqual(entry[field], req.values[field])) {
-                entry[field] = req.values[field];
-                changed = true;
-            }
-        }
-        if (req.values.surprise !== undefined) {
-            const current = String(candidate.surprises ?? "").trim();
-            const surprise = String(req.values.surprise);
-            if (!current.split("\n").includes(surprise)) {
-                candidate.surprises = current ? `${current}\n${surprise}` : surprise;
-                changed = true;
-            }
-        }
-        return { candidate, written: entry, assigned: { number }, replay: !changed };
-    }
-    if (req.spec.verb === "set-plan-status") {
-        const status = String(req.values.status);
-        if (status === "complete" && tasks.some((task) => task.status !== "complete")) {
-            reject({
-                class: "conflict",
-                message: "plan cannot be marked complete while incomplete tasks remain",
-            });
-        }
-        const header = mapping(candidate.header);
-        const replay = header.status === status;
-        header.status = status;
-        candidate.header = header;
-        return { candidate, written: header, assigned: {}, replay };
-    }
-    if (req.spec.verb === "set-status") {
-        const taskNumber = Number(req.values.task);
-        const status = String(req.values.status);
-        if (!["complete", "in_progress", "pending", "blocked"].includes(status))
-            reject({
-                class: "invalid_choice",
-                message: `argument --status: invalid choice: '${status}'`,
-                valid_values: ["complete", "in_progress", "pending", "blocked"],
-            });
-        const entry = findByNumber(tasks, taskNumber);
-        if (!entry)
-            reject({ class: "unsupported_target", message: `no plan task with number ${taskNumber}` });
-        const replay = entry.status === status;
-        entry.status = status;
-        return { candidate, written: entry, assigned: { number: taskNumber }, replay };
-    }
-    if (req.spec.verb === "record-evaluation") {
-        const taskNumber = Number(req.values.task);
-        const entry = findByNumber(tasks, taskNumber);
-        if (!entry)
-            reject({ class: "unsupported_target", message: `no plan task with number ${taskNumber}` });
-        const evaluationInput = mapping(req.values.evaluation);
-        const attemptId = String(evaluationInput.attempt_id ?? "").trim();
-        const verdict = String(evaluationInput.verdict ?? "");
-        const provenance = String(evaluationInput.provenance ?? "").trim();
-        const failureEvidence = String(evaluationInput.failure_evidence ?? "").trim();
-        if (!attemptId || !provenance)
-            reject({ class: "schema_violation", message: "evaluation requires non-empty --attempt-id and --provenance" });
-        if (verdict === "fail" && !failureEvidence)
-            reject({ class: "schema_violation", message: "a failed evaluation requires non-empty --failure-evidence" });
-        if (verdict === "pass" && failureEvidence)
-            reject({ class: "schema_violation", message: "--failure-evidence applies only to a failed evaluation" });
-        const prior = mapping(entry.evaluation);
-        const priorProvenance = mapping(prior.provenance);
-        if (priorProvenance.attempt_id === attemptId) {
-            const replay = prior.last_verdict === verdict &&
-                priorProvenance.source === provenance &&
-                (verdict !== "fail" || prior.last_failure_evidence === failureEvidence);
-            if (!replay)
-                reject({
-                    class: "conflict",
-                    message: `evaluation attempt '${attemptId}' already exists with different result data`,
-                });
-            return {
-                candidate,
-                written: entry,
-                assigned: { number: taskNumber, attempt_count: prior.attempt_count ?? 0 },
-                replay: true,
-            };
-        }
-        if (["complete", "blocked"].includes(String(entry.status ?? "")))
-            reject({ class: "conflict", message: `plan task ${taskNumber} is ${entry.status} and cannot accept another evaluation` });
-        const attemptCount = Number(prior.attempt_count ?? 0);
-        const failureCount = Number(prior.failure_count ?? 0);
-        if (!Number.isInteger(attemptCount) || attemptCount < 0 || !Number.isInteger(failureCount) || failureCount < 0)
-            reject({ class: "schema_violation", message: `plan task ${taskNumber} has malformed evaluation state` });
-        if (verdict === "fail" && failureCount >= 2)
-            reject({ class: "conflict", message: `plan task ${taskNumber} has exhausted its evaluation retry budget` });
-        const nextFailureCount = failureCount + (verdict === "fail" ? 1 : 0);
-        entry.evaluation = {
-            attempt_count: attemptCount + 1,
-            failure_count: nextFailureCount,
-            last_verdict: verdict,
-            last_failure_evidence: verdict === "fail" ? failureEvidence : prior.last_failure_evidence ?? null,
-            provenance: {
-                attempt_id: attemptId,
-                source: provenance,
-                recorded_at: localTimestamp(),
-                writer_command: "agentera state plan record-evaluation",
-            },
-        };
-        if (nextFailureCount >= 2)
-            entry.status = "blocked";
-        return {
-            candidate,
-            written: entry,
-            assigned: {
-                number: taskNumber,
-                attempt_count: attemptCount + 1,
-                failure_count: nextFailureCount,
-            },
-            replay: false,
-        };
-    }
-    throw new Error(`unsupported transaction ${req.artifact} ${req.spec.verb}`);
-}
 function activeKey(artifact) {
     return artifact === "progress"
         ? "cycles"
@@ -644,6 +305,8 @@ function envelope(req, target, finalDoc, written, assigned, replay, compaction,
                 ? { diagnostics: extra.validationDiagnostics }
                 : {}),
         },
+        ...(extra.compatibilityCaveats?.length
+            ? { compatibility: { legacy_caveats: extra.compatibilityCaveats } } : {}),
         compaction: compaction && req.artifact === "decisions"
             ? { ...compaction, protected_overflow_count: extra.protectedOverflowCount ?? 0 }
             : compaction,
@@ -656,6 +319,9 @@ function envelope(req, target, finalDoc, written, assigned, replay, compaction,
     return result;
 }
 export function executeStateWrite(req, options = {}) {
+    if (req.artifact === "decisions" && req.spec.verb === "amend") {
+        return dispatchDecisionAmendment(req, options);
+    }
     assertWriterBoundary(req.projectRoot, path.join(req.projectRoot, ".agentera"), "writer lock");
     const planPublication = req.artifact === "plan" && ["archive", "create"].includes(req.spec.verb);
     if (req.dryRun && planPublication)
@@ -682,12 +348,13 @@ function executeStateWriteUnlocked(req, transaction) {
     const legacyLifecycle = req.artifact === "plan" && ["active", "completed"].includes(String(mapping(existing.doc.header).status ?? ""));
     if (legacyLifecycle)
         existing.doc = canonicalPlanDocumentForWrite(existing.doc);
+    const decisionCoexistence = req.artifact === "decisions" ? decisionLegacyCoexistence() : null;
+    let decisionLegacyCaveats = [];
     if (existing.bytes) {
         const validationBytes = req.artifact === "plan" ? dumpYamlMapping(existing.doc) : existing.bytes;
         const violations = validateArtifactBytes(req.artifact, validationBytes);
-        if (violations.length) {
-            throw new Error(`existing artifact '${target}' is schema-invalid: ${violations.join("; ")}; repair it before retrying`);
-        }
+        if (violations.length)
+            decisionLegacyCaveats = gateExistingDecisions(violations, existing.doc, decisionCoexistence, target);
         if (req.artifact === "plan") {
             const evaluationViolations = planEvaluationViolations(existing.doc);
             if (evaluationViolations.length > 0)
@@ -716,7 +383,7 @@ function executeStateWriteUnlocked(req, transaction) {
         const update = updateDecisionOverlay(req.projectRoot, number, req.values.satisfaction, record.satisfaction, transaction, !req.dryRun);
         const before = dumpYamlMapping(update.before);
         const after = dumpYamlMapping(update.after);
-        return envelope(req, update.path, existing.doc, { satisfaction: update.satisfaction }, { number }, update.replay, null, { diff: diffText(before, after, update.path), before: update.before, after: update.after });
+        return envelope(req, update.path, existing.doc, { satisfaction: update.satisfaction }, { number }, update.replay, null, { diff: diffText(before, after, update.path), before: update.before, after: update.after, compatibilityCaveats: decisionLegacyCaveats });
     }
     if (req.artifact === "plan" && ["archive", "create"].includes(req.spec.verb))
         return planLifecycle(req, target, existing, legacyLifecycle);
@@ -741,6 +408,7 @@ function executeStateWriteUnlocked(req, transaction) {
         return envelope(req, target, mutated.candidate, mutated.written, mutated.assigned, true, null, {
             ...(archive ? { archivePath: archive.path } : {}),
             ...(req.dryRun ? { diff: "", before: existing.doc, after: mutated.candidate } : {}),
+            compatibilityCaveats: decisionLegacyCaveats,
         });
     }
     const repairedBytes = req.artifact === "health" && req.spec.verb === "repair"
@@ -750,8 +418,7 @@ function executeStateWriteUnlocked(req, transaction) {
         reject({ class: "unsupported_target", message: `health audit ${Number(req.values.number)} has no duplicate current-history rows to repair` });
     const candidateBytes = repairedBytes?.bytes ?? dumpYamlMapping(mutated.candidate);
     const candidateViolations = validateArtifactBytes(req.artifact, candidateBytes);
-    if (candidateViolations.length)
-        schemaViolation(candidateViolations);
+    decisionLegacyCaveats = gateCandidateDecisions(candidateViolations, mutated.candidate, decisionCoexistence, Number(mutated.written.number), schemaViolation);
     const stage = req.dryRun
         ? stagingPath(req, target)
         : transaction?.stageProjection(target, candidateBytes);
@@ -769,21 +436,20 @@ function executeStateWriteUnlocked(req, transaction) {
         }
         const finalBytes = fs.readFileSync(stage, "utf8");
         const finalViolations = validateArtifactBytes(req.artifact, finalBytes);
-        if (finalViolations.length)
-            throw new Error(`writer/compactor invariant failure: ${finalViolations.join("; ")}`);
+        const finalDoc = loadYamlMapping(finalBytes);
+        decisionLegacyCaveats = gateCompactedDecisions(finalViolations, finalDoc, decisionCoexistence, Number(mutated.written.number));
         if (!req.dryRun)
             transaction?.syncStaged(stage);
-        const finalDoc = loadYamlMapping(finalBytes);
         const diff = diffText(existing.bytes, finalBytes, target);
         if (req.dryRun) {
-            return envelope(req, target, finalDoc, mutated.written, mutated.assigned, false, compaction, { diff, before: existing.doc, after: finalDoc, protectedOverflowCount });
+            return envelope(req, target, finalDoc, mutated.written, mutated.assigned, false, compaction, { diff, before: existing.doc, after: finalDoc, protectedOverflowCount, compatibilityCaveats: decisionLegacyCaveats });
         }
         const archive = numberedAppend
             ? transaction?.publishArchive(req.artifact, Number(mutated.written.number), mutated.written)
             : undefined;
         if (!req.dryRun)
             transaction?.publishProjection(stage, target);
-        return envelope(req, target, finalDoc, mutated.written, mutated.assigned, mutated.replay, compaction, { ...(archive ? { archivePath: archive.path } : {}), protectedOverflowCount });
+        return envelope(req, target, finalDoc, mutated.written, mutated.assigned, mutated.replay, compaction, { ...(archive ? { archivePath: archive.path } : {}), protectedOverflowCount, compatibilityCaveats: decisionLegacyCaveats });
     }
     finally {
         try {