@rsaglobaltech/specgate 0.27.9 → 1.0.0-rc.1

package/dist/scripts/change/instructions.js

@@ -52,6 +52,7 @@ exports.main = main;
  * Code extension — consumes this. It is deliberately data, not prose: the
  * caller decides how to render it.
  */
+const ChangeLayers_1 = require("../../packages/core/src/domain/ChangeLayers");
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const project_root_1 = require("../lib/project-root");
@@ -86,12 +87,38 @@ const DESIGN_RULES = [
     "Only for `--full` rigor. At `--lite` this artefact is skipped, not missing.",
     "Record the decision and the alternatives rejected. If it is a decision the project will be asked about later, it wants an ADR instead.",
 ];
+// ADR-0042: the layers of a `layered` change, each with its owner.
+const DISCOVER_RULES = [
+    "Owner: product. The business context, the use case and the acceptance criteria — what and why, never how.",
+    "Number each criterion `- AC-1: …` under `## Acceptance criteria`: the design must answer every one.",
+    "No technology: frameworks, databases, APIs and queues belong in design.md (`layer_discover_technical`).",
+    "Once agreed, the story stays put: rewriting it during the design is reported (`layer_discover_rewritten`).",
+];
+const LAYERED_DESIGN_RULES = [
+    "Owner: the architect. Modules, mechanisms, channels, and the ADRs this touches.",
+    "Name each acceptance criterion of discover.md where it is answered (`AC-1 — …`), or validation reports `layer_design_misses_criterion`.",
+];
+const LAYERED_TASKS_RULES = [
+    "Owner: the developer. Each task is verifiable and names the requirement it delivers (`REQ-NNN`).",
+    "The specification tasks under `## 1. Specification` are the process and need no requirement.",
+];
 const ARTIFACT_RULES = {
+    discover: DISCOVER_RULES,
     proposal: PROPOSAL_RULES,
     specs: exports.DELTA_RULES,
     design: DESIGN_RULES,
     tasks: TASKS_RULES,
 };
+/** A layered change's own rules and templates for the layers it shares with 0.27. */
+const LAYERED_RULES = {
+    design: LAYERED_DESIGN_RULES,
+    tasks: LAYERED_TASKS_RULES,
+};
+const LAYER_TEMPLATES = {
+    discover: (id) => (0, ChangeLayers_1.templateDiscover)(id),
+    design: (id) => (0, ChangeLayers_1.templateLayeredDesign)(id),
+    tasks: () => (0, ChangeLayers_1.templateLayeredTasks)(),
+};
 /** Pseudo-artefacts: not files to write, but stages to carry out. */
 exports.STAGES = {
     apply: {
@@ -169,15 +196,18 @@ function buildInstructions(projectDir, artifact, changeId, templates) {
     const states = (0, artifacts_1.artifactState)(projectDir, changeId, config);
     const state = states.find((s) => s.id === artifact);
     const context = { ...projectContext(projectDir) };
-    const proposal = readIfExists(path.join(p.change(changeId), "proposal.md"));
-    // The proposal is the intent every later artefact has to stay faithful to.
-    if (proposal && artifact !== "proposal")
+    // The Discover (a 0.27 change's proposal) is the intent every later
+    // artefact has to stay faithful to.
+    const proposal = readIfExists(path.join(p.change(changeId), "discover.md")) ||
+        readIfExists(path.join(p.change(changeId), "proposal.md"));
+    if (proposal && artifact !== "proposal" && artifact !== "discover")
         context.proposal = proposal;
     if (Array.isArray(config.req_range) && config.req_range.length === 2) {
         context.reservedReqRange = config.req_range;
     }
     context.rigor = config.rigor;
     context.schema = config.schema || "spec-driven";
+    const layered = config.schema === ChangeLayers_1.LAYERED_SCHEMA;
     context.deltasWritten = (0, ChangeWorkspace_1.listDeltas)(projectDir, changeId).length;
     if (stage) {
         return {
@@ -198,8 +228,12 @@ function buildInstructions(projectDir, artifact, changeId, templates) {
         state: state ? state.status : "unknown",
         requires: state ? state.requires : [],
         unlocks: unlockedBy(artifact, artifacts),
-        template: templates[artifact] ? templates[artifact](changeId, projectDir) : null,
-        rules: ARTIFACT_RULES[artifact] || [],
+        template: layered && LAYER_TEMPLATES[artifact]
+            ? LAYER_TEMPLATES[artifact](changeId)
+            : templates[artifact]
+                ? templates[artifact](changeId, projectDir)
+                : null,
+        rules: (layered && LAYERED_RULES[artifact]) || ARTIFACT_RULES[artifact] || [],
         context,
         nextCommand: `specgate change validate ${changeId}`,
     };

package/dist/scripts/change/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../scripts/change/instructions.ts"],"names":[],"mappings":";;AACA,mFAAmF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8HnF,gCAIC;AAqDD,8CAiDC;AAYD,4BAEC;AAaD,oBAoGC;AArWD;;;;;;;;;;;GAWG;AAEH,4CAA8B;AAC9B,gDAAkC;AAElC,sDAAwD;AACxD,oDAAyD;AACzD,wCAAiE;AACjE,4FAMgE;AAEhE,2CAAqE;AACrE,iDAA8C;AAiC9C;;;;GAIG;AACU,QAAA,WAAW,GAAG;IACzB,6DAA6D;IAC7D,qHAAqH;IACrH,2FAA2F;IAC3F,8HAA8H;IAC9H,uJAAuJ;IACvJ,gDAAgD;IAChD,wLAAwL;CACzL,CAAC;AAEF,MAAM,cAAc,GAAG;IACrB,oHAAoH;IACpH,wFAAwF;CACzF,CAAC;AAEF,MAAM,WAAW,GAAG;IAClB,kGAAkG;IAClG,iEAAiE;CAClE,CAAC;AAEF,MAAM,YAAY,GAAG;IACnB,6EAA6E;IAC7E,wIAAwI;CACzI,CAAC;AAEF,MAAM,cAAc,GAA6B;IAC/C,QAAQ,EAAE,cAAc;IACxB,KAAK,EAAE,mBAAW;IAClB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,WAAW;CACnB,CAAC;AAEF,qEAAqE;AACxD,QAAA,MAAM,GAA0B;IAC3C,KAAK,EAAE;QACL,OAAO,EAAE,6DAA6D;QACtE,KAAK,EAAE;YACL,iEAAiE;YACjE,yFAAyF;YACzF,8FAA8F;YAC9F,iHAAiH;YACjH,4HAA4H;SAC7H;QACD,WAAW,EAAE,gBAAgB;KAC9B;IACD,OAAO,EAAE;QACP,OAAO,EAAE,wEAAwE;QACjF,KAAK,EAAE;YACL,0HAA0H;YAC1H,8EAA8E;YAC9E,6GAA6G;YAC7G,0FAA0F;SAC3F;QACD,WAAW,EAAE,iCAAiC;KAC/C;CACF,CAAC;AAEF,wFAAwF;AACxF,SAAgB,UAAU,CAAC,UAAkB,EAAE,SAAqC;IAClF,OAAO,CAAC,SAAS,IAAI,qBAAS,CAAC;SAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;SACtD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAeD,qEAAqE;AACrE,SAAS,cAAc,CAAC,UAAkB;IACxC,mFAAmF;IACnF,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,IAAI,KAAK,EAAE,CAAC;QACV,sEAAsE;QACtE,wEAAwE;QACxE,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE;YAC7B,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,wBAAwB,IAAI,wBAAwB,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5F,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAChC,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,KAAK;YAAE,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QACjC,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,OAAO;YAAE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;QACvC,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;IAC7D,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kCAAgB,CAAC,CAAC;IAC7D,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,oBAAoB,GAAG,EAAE;aAC9B,WAAW,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAClD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,iBAAiB,CAC/B,UAAkB,EAClB,QAAgB,EAChB,QAAgB,EAChB,SAA2C;IAE3C,MAAM,CAAC,GAAG,IAAA,uBAAK,EAAC,UAAU,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,cAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAA,4BAAU,EAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,IAAA,wBAAY,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,IAAA,yBAAa,EAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAEpD,MAAM,OAAO,GAAuB,EAAE,GAAG,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC;IACtE,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;IAC5E,2EAA2E;IAC3E,IAAI,QAAQ,IAAI,QAAQ,KAAK,UAAU;QAAE,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACrE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrE,OAAO,CAAC,gBAAgB,GAAG,MAAM,CAAC,SAAS,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC7B,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,aAAa,CAAC;IAChD,OAAO,CAAC,aAAa,GAAG,IAAA,4BAAU,EAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC;IAEhE,IAAI,KAAK,EAAE,CAAC;QACV,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,QAAQ;YACR,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO;YACP,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,QAAQ;QAChB,QAAQ;QACR,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;QAC3C,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QACvC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QACrC,OAAO,EAAE,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;QACxC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;QAChF,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE;QACrC,OAAO;QACP,WAAW,EAAE,4BAA4B,QAAQ,EAAE;KACpD,CAAC;AACJ,CAAC;AAED,+EAA+E;AAClE,QAAA,KAAK,GAAG,CAAC,GAAG,qBAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,cAAM,CAAC,CAAC,CAAC;AAE7E,yEAAyE;AACzE,MAAM,SAAS,GAAG;IAChB,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChF,GAAG,MAAM,CAAC,IAAI,CAAC,cAAM,CAAC;CACvB,CAAC;AAEF,0EAA0E;AAC1E,SAAgB,QAAQ,CAAC,UAAkB,EAAE,MAAoB;IAC/D,OAAO,CAAC,GAAG,IAAA,wBAAY,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,cAAM,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,KAAK;IACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,UAAU;QACR,mCAAmC,aAAK,CAAC,IAAI,CAAC,GAAG,CAAC,8BAA8B;QAChF,0EAA0E;QAC1E,wEAAwE;QACxE,6EAA6E;QAC7E,mCAAmC,CACtC,CAAC;AACJ,CAAC;AAED,SAAgB,IAAI,CAAC,IAAc,EAAE,SAA2C;IAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;IAChD,MAAM,EAAE,GAAY,IAAA,eAAO,EAAC,IAAA,iBAAS,EAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAE1C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,IAAI,CAAC,YAAI,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,IAAI,CAAC,EAAE,CAAC,IAAI;YAAE,KAAK,EAAE,CAAC;QACtB,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE;YACnB,IAAA,mBAAK,EAAC,mBAAmB,EAAE,8CAA8C,EAAE;gBACzE,GAAG,EAAE,eAAe,aAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aACxC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,0EAA0E;IAC1E,2EAA2E;IAC3E,4EAA4E;IAC5E,oEAAoE;IACpE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE;YACnB,IAAA,mBAAK,EAAC,kBAAkB,EAAE,qBAAqB,QAAQ,GAAG,EAAE;gBAC1D,MAAM,EAAE,QAAQ;gBAChB,GAAG,EAAE,eAAe,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aAC5C,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IACD,4EAA4E;IAC5E,0EAA0E;IAC1E,8CAA8C;IAC9C,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,aAAa,GAAG,GAAG,CAAC;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,eAAe,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC/C,aAAa,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC;IACf,IAAI,CAAC;QACH,UAAU,GAAG,IAAA,gCAAiB,EAAC,aAAa,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE;YACnB,IAAA,mBAAK,EAAC,mBAAmB,EAAE,IAAA,0BAAY,EAAC,GAAG,CAAC,EAAE;gBAC5C,GAAG,EAAE,+DAA+D;aACrE,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,MAAM,GAAG,GAAG,IAAA,+BAAa,EAAC,UAAU,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAErE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE;YAClB,IAAA,mBAAK,EACH,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,EAC1D,GAAG,CAAC,MAAM,KAAK,CAAC;gBACd,CAAC,CAAC,oBAAoB;gBACtB,CAAC,CAAC,mDAAmD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EACxE;gBACE,GAAG,EACD,GAAG,CAAC,MAAM,KAAK,CAAC;oBACd,CAAC,CAAC,uCAAuC;oBACzC,CAAC,CAAC,gCAAgC,QAAQ,cAAc;aAC7D,CACF;SACF,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE;YAClB,IAAA,mBAAK,EAAC,kBAAkB,EAAE,WAAW,QAAQ,mBAAmB,EAAE;gBAChE,MAAM,EAAE,QAAQ;gBAChB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,mBAAmB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,iCAAiC;aAC3F,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAC9E,8EAA8E;IAC9E,+DAA+D;IAC/D,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,EAAE,IAAA,4BAAU,EAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE;YACnB,IAAA,mBAAK,EAAC,kBAAkB,EAAE,qBAAqB,QAAQ,GAAG,EAAE;gBAC1D,MAAM,EAAE,QAAQ;gBAChB,GAAG,EAAE,4BAA4B,IAAA,4BAAU,EAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,MAAM,IAAI,aAAa,yBAAyB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;aACtI,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,MAAM,YAAY,GAAG,iBAAiB,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAClF,EAAE,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,YAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,WAAW,CAAC,GAAiB;IACpC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;IAClD,IAAI,GAAG,CAAC,OAAO;QAAE,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IAChD,IAAI,GAAG,CAAC,UAAU;QAAE,GAAG,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,UAAU,MAAM,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;IAC9E,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM;QAAE,GAAG,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzF,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK;QAAE,GAAG,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACpE,IAAI,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACtB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjB,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC3B,GAAG,CAAC,IAAI,CACN,GAAG,CAAC,QAAQ;aACT,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;aACtB,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;IACJ,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC;IAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../scripts/change/instructions.ts"],"names":[],"mappings":"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"}

package/dist/scripts/cli/commands/alm/PhaseCommand.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * `specgate alm phase <change>` and `specgate alm move <change> [<phase>]`
+ * (REQ-309) — what an agent needs to drive the board: read where a change
+ * stands without the network, and move its ticket there.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.phaseMain = phaseMain;
+exports.moveMain = moveMain;
+const project_root_1 = require("../../../lib/project-root");
+const agent_1 = require("../../../lib/agent");
+const diagnostics_1 = require("../../../lib/diagnostics");
+const core_1 = require("../../../alm/core");
+const clients_1 = require("../../../alm/clients");
+const port_1 = require("../../../alm/port");
+const phases_1 = require("../../../alm/phases");
+const ui = __importStar(require("../../../lib/ui"));
+function parseArgs(argv) {
+    const opts = { projectDir: ".", json: false, positional: [] };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--project-dir" && argv[i + 1])
+            opts.projectDir = argv[++i];
+        else if (a === "--json")
+            opts.json = true;
+        else if (a.startsWith("-")) {
+            process.stderr.write(`Unknown flag: ${a}\n`);
+            process.exit(2);
+        }
+        else
+            opts.positional.push(a);
+    }
+    return opts;
+}
+/** `alm phase <change>`: the phase, the ticket and the board state last set. No network. */
+async function phaseMain(argv) {
+    const opts = parseArgs(argv);
+    const io = (0, agent_1.agentIo)(opts.json || (0, agent_1.wantsJson)(argv));
+    const nullShape = { phase: null };
+    const id = opts.positional[0];
+    const projectDir = (0, project_root_1.resolveProjectDir)(opts.projectDir);
+    const change = (0, phases_1.boardChanges)(projectDir).find((c) => c.id === id);
+    if (!change) {
+        return io.fail(nullShape, [
+            (0, diagnostics_1.error)("change_not_found", `No change ${id || "(none)"}.`, {
+                target: id,
+                fix: "specgate alm phase <change-id> — see specgate change list.",
+            }),
+        ]);
+    }
+    const record = (0, phases_1.readPhaseMap)(projectDir)[change.id];
+    const phase = {
+        change: change.id,
+        phase: change.phase,
+        ticket: change.ticket,
+        state: record && record.phase === change.phase ? (record.state ?? null) : null,
+        requirements: change.requirements,
+    };
+    io.emit({ phase }, () => process.stdout.write(ui.header("alm phase", change.id) +
+        `  ${change.phase}  ${change.ticket ?? ui.muted("no ticket")}  ${phase.state ? `board: ${phase.state}` : ui.muted("not on the board yet")}\n\n`));
+}
+/** `alm move <change> [<phase>]`: move the change's ticket to its phase, or the one named. */
+async function moveMain(argv) {
+    const opts = parseArgs(argv);
+    const io = (0, agent_1.agentIo)(opts.json || (0, agent_1.wantsJson)(argv));
+    const nullShape = { move: null };
+    const [id, named] = opts.positional;
+    if (named && !port_1.PHASES.includes(named)) {
+        return io.fail(nullShape, [
+            (0, diagnostics_1.error)("phase_unknown", `"${named}" is not a phase.`, {
+                target: named,
+                fix: `One of: ${port_1.PHASES.join(", ")}.`,
+            }),
+        ]);
+    }
+    try {
+        const projectDir = (0, project_root_1.resolveProjectDir)(opts.projectDir);
+        const change = (0, phases_1.boardChanges)(projectDir).find((c) => c.id === id);
+        if (!change) {
+            return io.fail(nullShape, [
+                (0, diagnostics_1.error)("change_not_found", `No change ${id || "(none)"}.`, {
+                    target: id,
+                    fix: "specgate alm move <change-id> [<phase>]",
+                }),
+            ]);
+        }
+        if (!change.ticket) {
+            return io.fail(nullShape, [
+                (0, diagnostics_1.error)("change_no_ticket", `${change.id} has no ticket to move.`, {
+                    target: change.id,
+                    fix: "Add ticket: <KEY> to its change.yaml.",
+                }),
+            ]);
+        }
+        const cfg = (0, core_1.readAlmConfig)(projectDir);
+        const client = (0, clients_1.makeClient)(cfg, undefined, projectDir);
+        const map = (0, phases_1.readPhaseMap)(projectDir);
+        const action = await (0, phases_1.movePhase)({ ...change, ticket: change.ticket }, map, client, cfg, {
+            phase: named || undefined,
+            force: true,
+        });
+        if (action.action === "phase-unsupported") {
+            return io.fail(nullShape, [
+                (0, diagnostics_1.error)("alm_phase_unsupported", action.detail || "", { target: cfg.provider }),
+            ]);
+        }
+        (0, phases_1.writePhaseMap)(projectDir, map, false);
+        const move = {
+            change: change.id,
+            issue: action.issue,
+            phase: action.phase,
+            state: action.state,
+        };
+        io.emit({ move }, () => process.stdout.write(ui.header("alm move", change.id) + ui.ok(`${action.issue} → ${action.state}`) + "\n"));
+    }
+    catch (e) {
+        return io.fail(nullShape, [(0, diagnostics_1.error)("alm_move_error", e.message || String(e))]);
+    }
+}
+//# sourceMappingURL=PhaseCommand.js.map

package/dist/scripts/cli/commands/alm/PhaseCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhaseCommand.js","sourceRoot":"","sources":["../../../../../scripts/cli/commands/alm/PhaseCommand.ts"],"names":[],"mappings":"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"}

package/dist/scripts/cli/commands/alm/PullCommand.js

@@ -67,6 +67,8 @@ const agent_1 = require("../../../lib/agent");
 const diagnostics_1 = require("../../../lib/diagnostics");
 const core_1 = require("../../../alm/core");
 const clients_1 = require("../../../alm/clients");
+const phases_1 = require("../../../alm/phases");
+const pull_back_1 = require("./pull-back");
 const ChangeWorkspace_1 = require("../../../../packages/core/src/infrastructure/ChangeWorkspace");
 const InboundChange_1 = require("../../../../packages/core/src/domain/InboundChange");
 const NULL_SHAPE = { pulled: [], skipped: [] };
@@ -151,6 +153,31 @@ async function main(argv) {
             }),
         ]);
     }
+    // REQ-306: what each open change's ticket gained since the last pull comes
+    // back as notes, before any new issue is pulled.
+    let notes;
+    try {
+        const map = (0, phases_1.readPhaseMap)(projectDir);
+        notes = await (0, pull_back_1.pullBack)(projectDir, (0, phases_1.boardChanges)(projectDir), map, client, {
+            dryRun: opts.dryRun,
+            today: new Date().toISOString().slice(0, 10),
+        });
+        (0, phases_1.writePhaseMap)(projectDir, map, opts.dryRun);
+    }
+    catch (e) {
+        return io.fail(NULL_SHAPE, [
+            (0, diagnostics_1.error)("alm_pull_error", e.message || String(e), {
+                fix: "Check the ticket keys in change.yaml and your ALM configuration.",
+            }),
+        ]);
+    }
+    const printNotes = () => {
+        for (const n of notes) {
+            process.stdout.write(n.action === "comments-unsupported"
+                ? `  ${n.change}: ${n.text}\n`
+                : `  ${n.change} <- ${n.issue}: ${n.text}\n`);
+        }
+    };
     // Declared, not discovered at the first request: Jira searches with JQL,
     // GitHub with query parameters, Azure with WIQL — and a provider that cannot
     // search says so rather than failing halfway through a pull.
@@ -164,7 +191,10 @@ async function main(argv) {
     }
     const issues = await client.listIssues(opts.label);
     if (issues.length === 0) {
-        return io.emit({ pulled: [], skipped: [], label: opts.label }, () => process.stdout.write(`\n  No open issues labelled '${opts.label}'.\n\n`));
+        return io.emit({ pulled: [], skipped: [], label: opts.label, notes }, () => {
+            printNotes();
+            process.stdout.write(`\n  No open issues labelled '${opts.label}'.\n\n`);
+        });
     }
     const p = (0, ChangeWorkspace_1.paths)(projectDir);
     const existing = new Set((0, ChangeWorkspace_1.listChangeIds)(projectDir));
@@ -224,7 +254,8 @@ async function main(argv) {
             fix: "Delete the change to re-pull it, or edit the one that exists.",
         }));
     }
-    io.emit({ pulled, skipped, label: opts.label, status }, () => {
+    io.emit({ pulled, skipped, label: opts.label, status, notes }, () => {
+        printNotes();
         process.stdout.write(`\n  Pulled ${pulled.length} issue(s) labelled '${opts.label}'\n\n`);
         for (const row of pulled) {
             process.stdout.write(`    ${row.issue} → ${row.change}  (${row.requirement})\n`);

package/dist/scripts/cli/commands/alm/PullCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"PullCommand.js","sourceRoot":"","sources":["../../../../../scripts/cli/commands/alm/PullCommand.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PullCommand.js","sourceRoot":"","sources":["../../../../../scripts/cli/commands/alm/PullCommand.ts"],"names":[],"mappings":"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"}

package/dist/scripts/cli/commands/alm/pull-back.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * What a ticket gains comes back to its change as notes (REQ-306).
+ *
+ * Outside `scripts/alm/` for the reason `alm pull` is: ADR-0021 keeps the ALM
+ * subsystem from writing the spec tree, and a note is written into the
+ * change. It is written where `change note` writes — `review.md` — and nowhere
+ * else: a comment on a ticket is a request a person reads and folds in, never
+ * a rewrite of the proposal or the delta.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pullBack = pullBack;
+const crypto = __importStar(require("node:crypto"));
+const change_review_1 = require("../../../lib/change-review");
+const hash = (text) => crypto.createHash("sha256").update(text).digest("hex");
+/** One line of a note: a ticket's text, flattened and kept short enough to read in a table. */
+function oneLine(text, max = 400) {
+    const flat = text.replace(/\s+/g, " ").trim();
+    return flat.length > max ? `${flat.slice(0, max - 1)}…` : flat;
+}
+/**
+ * Bring back each open change's new comments and changed description.
+ *
+ * The first pull of a ticket records its description and comes back with its
+ * comments; from then on only what changed is noted, so pulling twice adds
+ * nothing.
+ */
+async function pullBack(projectDir, changes, map, client, opts) {
+    const actions = [];
+    for (const change of changes) {
+        if (change.archived || !change.ticket)
+            continue;
+        const ticket = change.ticket;
+        const record = (map[change.id] ??= { ticket });
+        const note = (action, text) => {
+            actions.push({ change: change.id, issue: ticket, action, text });
+            if (!opts.dryRun && action !== "comments-unsupported") {
+                (0, change_review_1.noteChange)(projectDir, change.id, text, "", opts.today);
+            }
+        };
+        if (client.capabilities.readText && typeof client.readIssueText === "function") {
+            const { body } = await client.readIssueText(ticket);
+            const now = hash(body);
+            if (record.description && record.description !== now) {
+                note("description", `The description of ${ticket} changed: ${oneLine(body)}`);
+            }
+            if (!opts.dryRun)
+                record.description = now;
+        }
+        if (!client.capabilities.comments || typeof client.listComments !== "function") {
+            actions.push({
+                change: change.id,
+                issue: ticket,
+                action: "comments-unsupported",
+                text: `This provider cannot read the comments of ${ticket}; read them on the board.`,
+            });
+            continue;
+        }
+        const seen = new Set(record.comments ?? []);
+        for (const comment of await client.listComments(ticket)) {
+            if (seen.has(comment.id))
+                continue;
+            note("comment", `Comment on ${ticket}${comment.author ? ` by ${comment.author}` : ""}: ${oneLine(comment.body)}`);
+            seen.add(comment.id);
+        }
+        if (!opts.dryRun)
+            record.comments = [...seen];
+    }
+    return actions;
+}
+//# sourceMappingURL=pull-back.js.map

package/dist/scripts/cli/commands/alm/pull-back.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-back.js","sourceRoot":"","sources":["../../../../../scripts/cli/commands/alm/pull-back.ts"],"names":[],"mappings":"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"}