@mmerterden/multi-agent-pipeline 20.23.0 → 20.23.2

package/pipeline/scripts/analysis-story-tree.mjs

@@ -50,6 +50,7 @@
  *
  * Usage:
  *   analysis-story-tree.mjs <analysis.md> [--json] [--brief] [--prefs FILE] [--page-url URL]
+ *   analysis-story-tree.mjs --save-subtasks "<type>[,<type>...]"|none [--prefs FILE]
  *
  * Exit: 0 planned, 2 nothing to plan, 3 usage, 4 the document is not issue-ready.
  */
@@ -60,6 +61,7 @@ import { createHash } from "node:crypto";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { hostCommand } from "../lib/user-facing.mjs";
+import { lockTimeoutFrom, updateJsonFileSync } from "../lib/json-file-lock.mjs";
 import { resolveConstitution } from "./constitution.mjs";
 import { gateContext, recordQuietly } from "./gate-ledger.mjs";
 import {
@@ -81,7 +83,11 @@ const PREFS_PATH =
     : join(homedir(), ".claude", "multi-agent-preferences.json");
 const pageUrlFlag = argv.indexOf("--page-url");
 const PAGE_URL = pageUrlFlag !== -1 ? argv[pageUrlFlag + 1] : null;
-const valueIdx = new Set([prefsFlag, pageUrlFlag].filter((i) => i !== -1).map((i) => i + 1));
+const saveFlag = argv.indexOf("--save-subtasks");
+const SAVE_SUBTASKS = saveFlag !== -1 ? (argv[saveFlag + 1] ?? "") : null;
+const valueIdx = new Set(
+  [prefsFlag, pageUrlFlag, saveFlag].filter((i) => i !== -1).map((i) => i + 1),
+);
 const file = argv.find((a, i) => !a.startsWith("--") && !valueIdx.has(i));
 
 function die(msg, code) {
@@ -153,7 +159,7 @@ export function identityLabel(prefix, docId, sourceIds) {
  *   issueTree.projectKey         where the tree is created
  *   issueTree.epicIssueType      the type name for an epic on this site
  *   issueTree.storyIssueType     the type name for a story
- *   issueTree.subtaskIssueType   null = discover from createmeta
+ *   issueTree.subtaskIssueType   a name, a {role: name} map, or null = discover
  *   issueTree.subtaskRoles       how a story is split; ships empty on purpose
  *   issueTree.channelComponents  channel -> this site's component name
  *   issueTree.channelTeams       channel -> this site's team name
@@ -162,6 +168,8 @@ export function identityLabel(prefix, docId, sourceIds) {
  *   issueTree.epicLinkFieldId    the epic-link field, when not discovered
  *   issueTree.cloneByChannel     one linked story per channel in channelComponents
  *   issueTree.cloneLinkType      the link type between a story and its clones
+ *   issueTree.storyPanels        story section panel colours, or false for none
+ *   issueTree.subtaskRolesDeclined  the person chose no sub-tasks; do not ask again
  */
 const ISSUE_TREE_SETTINGS = [
   "issueTree.enabled",
@@ -177,6 +185,8 @@ const ISSUE_TREE_SETTINGS = [
   "issueTree.epicLinkFieldId",
   "issueTree.cloneByChannel",
   "issueTree.cloneLinkType",
+  "issueTree.storyPanels",
+  "issueTree.subtaskRolesDeclined",
 ];
 
 function readPrefs() {
@@ -195,6 +205,17 @@ function readPrefs() {
   }
 }
 
+/**
+ * The sub-task type a role is created as, from issueTree.subtaskIssueType: a
+ * name for every role, or a {role: name} map with "*" for any other role. Null
+ * means the writer discovers it from the site.
+ */
+export function subtaskTypeFor(setting, role) {
+  if (typeof setting === "string" && setting) return setting;
+  if (setting && typeof setting === "object") return setting[role] ?? setting["*"] ?? null;
+  return null;
+}
+
 /** Every open placeholder that makes a document unfit to become work. */
 export function openItems(text) {
   const found = [];
@@ -377,6 +398,7 @@ export function plan(text, prefs, { pageUrl = null } = {}) {
     profile,
     pageUrl: pageUrl || fm.confluence_url || null,
     redesign: String(fm.redesign || "").toLowerCase() === "true",
+    panels: prefs.storyPanels,
   };
   for (const story of stories) {
     const b = buildStoryBody(story, bodyCtx);
@@ -423,6 +445,8 @@ export function plan(text, prefs, { pageUrl = null } = {}) {
       epicLinkFieldId: prefs.epicLinkFieldId ?? null,
       cloneByChannel: prefs.cloneByChannel === true,
       cloneLinkType: prefs.cloneLinkType ?? "Relates",
+      storyPanels: prefs.storyPanels ?? null,
+      subtaskRolesDeclined: prefs.subtaskRolesDeclined === true,
     },
     nodes: stories,
     writeCount: stories.reduce(
@@ -453,7 +477,50 @@ function consistencyOf(text, nodes) {
   });
 }
 
+/**
+ * Save the sub-tasks a person chose for every story: each chosen site type
+ * becomes a role named after it and mapped to it, or "none" records that the
+ * question was answered with no sub-tasks.
+ */
+function saveSubtasks(choice) {
+  const names = String(choice)
+    .split(",")
+    .map((n) => n.trim())
+    .filter(Boolean);
+  const none = names.length === 1 && names[0].toLowerCase() === "none";
+  if (!names.length || names.some((n) => n.length > 100 || /[\n{}]/.test(n)))
+    return die("analysis-story-tree: --save-subtasks takes type names or none", 3);
+  try {
+    updateJsonFileSync(
+      PREFS_PATH,
+      (j) => {
+        if (!j || typeof j !== "object" || Array.isArray(j)) return undefined;
+        j.global = j.global || {};
+        const t = { ...(j.global.issueTree || {}) };
+        if (none) {
+          t.subtaskRoles = [];
+          t.subtaskRolesDeclined = true;
+        } else {
+          t.subtaskRoles = names;
+          t.subtaskIssueType = Object.fromEntries(names.map((n) => [n, n]));
+          delete t.subtaskRolesDeclined;
+        }
+        j.global.issueTree = t;
+        return j;
+      },
+      { mode: 0o600, followSymlink: true, timeoutMs: lockTimeoutFrom(process.env) },
+    );
+  } catch (e) {
+    return die(`analysis-story-tree: could not write ${PREFS_PATH}: ${e.message}`, 3);
+  }
+  process.stdout.write(
+    none ? "issueTree: no sub-tasks\n" : `issueTree: sub-tasks ${names.join(", ")}\n`,
+  );
+  return null;
+}
+
 async function main() {
+  if (SAVE_SUBTASKS !== null) return saveSubtasks(SAVE_SUBTASKS);
   if (!file)
     return die(
       "usage: analysis-story-tree.mjs <analysis.md> [--json] [--brief] [--prefs FILE] [--page-url URL]",
@@ -557,7 +624,10 @@ async function main() {
       for (const line of s.description.split("\n")) process.stdout.write(`        ${line}\n`);
     }
     for (const t of s.subtasks) {
-      process.stdout.write(`      subtask  ${t.role}  [${t.label}]\n`);
+      const type = subtaskTypeFor(result.prefsUsed.subtaskIssueType, t.role);
+      process.stdout.write(
+        `      subtask  ${t.role}  type ${type ?? "discovered from createmeta"}  [${t.label}]\n`,
+      );
     }
     for (const c of s.clones || []) {
       process.stdout.write(

package/pipeline/scripts/code-graph-rules/ios.json

@@ -47,7 +47,7 @@
   "importPatterns": [
     {
       "id": "import",
-      "regex": "^\\s*import\\s+(?:class|struct|enum|protocol|func|var|let|typealias)\\s+([A-Za-z_][A-Za-z0-9_]*)|^\\s*import\\s+([A-Za-z_][A-Za-z0-9_]*)"
+      "regex": "^\\s*(?:@[A-Za-z_]\\w*(?:\\([^)\\n]*\\))?\\s+)*import\\s+(?:class|struct|enum|protocol|func|var|let|typealias)\\s+([A-Za-z_][A-Za-z0-9_]*)|^\\s*(?:@[A-Za-z_]\\w*(?:\\([^)\\n]*\\))?\\s+)*import\\s+([A-Za-z_][A-Za-z0-9_]*)"
     }
   ],
   "referenceKinds": ["class", "struct", "enum", "protocol", "actor", "typealias"],

package/pipeline/skills/.skill-manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-13T08:10:09Z",
+  "generatedAt": "2026-10-13T19:19:55Z",
   "skillCount": 228,
   "entries": [
     {
@@ -13,7 +13,7 @@
     },
     {
       "path": "shared/core/multi-agent-analysis-jira/SKILL.md",
-      "sha256": "130543d1017115de351a1175b6b179778642ba0b3207034b54114b39d0546407"
+      "sha256": "798061199762b141d0312b56f9e8e10af1324fb867393929565ebe4e61fcbc81"
     },
     {
       "path": "shared/core/multi-agent-analysis-resolve/SKILL.md",

package/pipeline/skills/shared/core/multi-agent-analysis-jira/SKILL.md

@@ -69,6 +69,13 @@ Then ask for the epic, once. `AskUserQuestion`:
 - **Link to an existing epic** - the user types its key (`--epic <KEY>`)
 - **No epic** - the stories are created unlinked
 
+When the plan's `prefsUsed.subtaskRoles` is empty and `prefsUsed.subtaskRolesDeclined`
+is false, attended runs ask once which sub-tasks every story gets. List the site's types
+with `bash "$HOME/.claude/lib/analysis-jira-write.sh" --subtask-types --project "<KEY>"`,
+offer them as a multi-select `AskUserQuestion` plus **No sub-tasks**, save the answer with
+`node "$HOME/.claude/scripts/analysis-story-tree.mjs" --save-subtasks "<type>,<type>"` (or
+`none`), and re-run Phase 1. Unattended runs never ask.
+
 Then the dry run, which is what proves the writer agrees with the plan:
 
 ```bash