@mmerterden/multi-agent-pipeline 20.25.1 → 20.26.0

package/manifest.json

@@ -1,15 +1,15 @@
 {
   "name": "@mmerterden/multi-agent-pipeline",
-  "version": "20.25.1",
-  "commit": "0eb30e00ade8fca0b4c5c778182d8e7dedac3901",
-  "generatedAt": "2026-10-14T16:23:55.250Z",
+  "version": "20.26.0",
+  "commit": "35ac932f54214466d6a63effea9d3a5fdd3f90bb",
+  "generatedAt": "2026-10-14T20:14:41.247Z",
   "algorithm": "sha256",
-  "fileCount": 1391,
+  "fileCount": 1394,
   "files": {
-    "CHANGELOG.md": "c2c25cc5f3ca4fb30fe20d0ac8d1182142e4baf0f1d31e6a1f32961d95fc8fee",
+    "CHANGELOG.md": "bc477ff23f828f3302ddd5f79cfa52bbbe792b1decbbbce270f46b19740257d1",
     "LICENSE": "8d8c51aaf1e1538b180c69965fa038db71be86798cc3e26a143bebfefe16a43e",
-    "README.md": "834be811f7e40d5a3cd5a04f61da666cc5fd746b8499781edfd2d083d88cc775",
-    "README.tr.md": "ae0a9acf8e367716bbba716f31b800bc4b912d3e98874b3e2123ea8684abbec3",
+    "README.md": "c90b8d15713750c621fa8083531cdeb8158e9b67e995192874b6ac9da1dedc45",
+    "README.tr.md": "ce7978c53c733cf359c21423fbfed640f20644584ff153aaab473958fdccfdc3",
     "SECURITY.md": "0eb89553ddcfc56bfe9712315b55a6630ee2f579631aaeccd6ad24f8ac769a0b",
     "docs/FIGMA_PIPELINE.md": "ea01f3ea5fef1a9cb316040a2d416fcf87dd4f2a14b5497aa00994a0b5dc7e6a",
     "docs/adr/0001-three-model-triage.md": "79a6f1025469f607a5859add21854052d7433bc213f4aceee2e159b613eeb6a1",
@@ -34,7 +34,7 @@
     "docs/best-practices.md": "f8b75b0d38b5896a6a852bb30a1edddeb24dab8b5b7b1d9313290e1241c72024",
     "docs/ecosystem.md": "9b23467fca1bcdc0275e7eccd3428c36181ba9f8cd866778159edd7d65a4d563",
     "docs/engineering.md": "550528cd47c7d2c921729c68d0782a00ac8e77a4bdfec479f6749f9c3235d188",
-    "docs/facts.json": "d3ea7392093c784ca410ce811fc57cb55ffb701fa1795c17f4afdabb2fc8006b",
+    "docs/facts.json": "7020352c8c1f73a6f9b616d1e3d8060b76d138beb8c68e85e4edc3c4a0cfb8a7",
     "docs/features.md": "d5fcbe3acc05e054efdf0c43ddfc1a82ef3d463f349ea2ec5b4842fa26d9d49d",
     "docs/performance.md": "bbf2f3922c25dcba0c1a9e69ef420e3871a729af5b35009a49b48a5d3c5cd151",
     "docs/recovery-guide.md": "59a8f1b66b34cb9ff5507b3d54dac3b9915e184aa044d9c758d18cac818d510e",
@@ -54,7 +54,7 @@
     "install/_unattended-profile.mjs": "e1ed82bde35d19105ee12c2a551eb778912b0e5c93ab227fd15c993098d98de0",
     "install/_usage-lifecycle.mjs": "4b010c4e75d6f8e13b58d80a93cc9407f42ccde781c9ed12dcb8e7faf05e526c",
     "install/_xcode-skills.mjs": "1a7e20f1e6743324b941c5d3ecac9f94c65fff1534ffd9c63b39cbea4f8d101a",
-    "install/catalog-history.json": "6e9be7c160b7288084bd859a62e09cd0f4c43be1d1414fee9807aa343f5f7245",
+    "install/catalog-history.json": "ae53e8c4bbf1d1f17a91f247f53a5ba79d881ec0251bf25273b68c1482df30ee",
     "install/claude.mjs": "106ce353ebc19c8319d057ce342e1f989519510465c798399076b5f3d8727904",
     "install/codex.mjs": "08925fe9f3ecdf509b37f01105652c847475d20fcde2db0d679b9a7d663ca145",
     "install/copilot.mjs": "41dc394b8a3ae77cfd194ce0ca9bbcafce9bdce349f1f72eeb86569f993e15fe",
@@ -66,7 +66,7 @@
     "install/templates/multi-agent-autopilot-awake.plist.template": "ddd25c76c56fcbb38a89de8e35637372d70ace993d6bc487a88ca9cfb702fe1f",
     "install/templates/multi-agent-autopilot.plist.template": "122c8a61cd927edd99375d6e3da40f1d42bcceed5b6641785c8b28bb930bc77e",
     "install/unattended-profile-legacy.json": "f52e86b998956f09ad306b1735a6c10b58580d7082d8a55665a4c6bb15c3aa1f",
-    "package.json": "dd4297297078a881bab0fdaeb64d804d3cbe8a73b0ccaad9cf09dd1c77ff5349",
+    "package.json": "e2aa2bd877d2f106314385ca681a67071158c9089a5a05e74b4f8a3039c2c39e",
     "pipeline/agents/android-architect.md": "11fb74543cb0ebcf9525ca6654fe95d53da7229e0bf4a1149b31fd9005abc453",
     "pipeline/agents/backend-architect.md": "b02a606c301e4714131aed70ae6d16eeb77fbc819a001e2752cff2488d4246de",
     "pipeline/agents/bulk-reader.md": "6597052cd7d205bac2b1c7633f5232fe1a40730664a913b8eb77efd5a786dc25",
@@ -91,7 +91,7 @@
     "pipeline/commands/multi-agent/autopilot/SKILL.md": "ae95364c28e21a5d12b8a579180d59963bad3738fcfd978180c5dca6e55a0d02",
     "pipeline/commands/multi-agent/bug-bash/SKILL.md": "0ae5883b72239c74f4f64fc2d60526091e471afa6a2886f90f70a469a85cc832",
     "pipeline/commands/multi-agent/build-optimize/SKILL.md": "e74d6f5be703acef1704092d5fe53485d95fe6c220bb768accaf68ebd212b7c1",
-    "pipeline/commands/multi-agent/channels/SKILL.md": "5c6d54c7153ceba6b19ecd55f2211d5ef0f97c472aac0623729fbe9f2fb9a3c0",
+    "pipeline/commands/multi-agent/channels/SKILL.md": "4ccd28e5eaa8bd0b618fc23dbf49f007cf65150a4796aabafdb51d1dcffd6752",
     "pipeline/commands/multi-agent/complaint-analysis/SKILL.md": "b9ab7b9444cf99f25868d90f050ed96f04ac8cd8ea18d0999376184b067fc2bc",
     "pipeline/commands/multi-agent/create-jira/SKILL.md": "ac3d3e0ab2fb079b7c4107928573912699f68600f922b2f453be49c65317665a",
     "pipeline/commands/multi-agent/design-check/SKILL.md": "d3cb1b50f2d14cf22a38f4c0db98c852e8ed0586e969f7e6da7c1d65f36554eb",
@@ -168,7 +168,7 @@
     "pipeline/contract/frozen/toolbox.json": "d52f94ca81f62e4c0d67f0718ce6361f332f289b09fe7cc25c8f5f40feb0ffff",
     "pipeline/contract/manifest.json": "e9163ba923619447f872416d7f57ea48d67dc13c356c9544f24957f4131946bf",
     "pipeline/contract/types/index.d.ts": "1434e70701023a7274fb13c9dbdf901b2a0d7259e46f3fcf40fe2454300c32a3",
-    "pipeline/lib/_jira-auth.sh": "fc468736057f8841d824eb1a4db527442562f8979fea333ebaef5527f4369e9f",
+    "pipeline/lib/_jira-auth.sh": "b5fd733ac26727eda299976c688456e95611ca40acafd3947c66c445d77f2237",
     "pipeline/lib/account-resolver.sh": "f7bef9beba3f839268509361651be0b1e1f319f2f23821f90ba466fdf185a8f6",
     "pipeline/lib/agent-model-sync.mjs": "2e0264ca8d8fef761563db219d588fed9067847043f960f68f055c186c20b668",
     "pipeline/lib/analysis-jira-write.sh": "26e17b8a972819a1649ead8cc4e6f0ff8548dd686c2572107e1777fb384f639d",
@@ -205,7 +205,8 @@
     "pipeline/lib/invoked-directly.mjs": "a7014f252174414c267cc303a992aa9f3986541c5aad188c87cc6809ba3b69bd",
     "pipeline/lib/issue-fetcher.sh": "36f6eb41935fa44072cf3c9a92a5698d4ffd762103eb57f733e65687ab47479e",
     "pipeline/lib/jira-epic-link.sh": "b5f9ce1067cd8e9f0e547da4e681b71e4ff8c145e9a759fc98f83703dfca4d35",
-    "pipeline/lib/jira-publish.sh": "a32e6a682ae730ddd9c6df64b9ece1fb73c797111c63f5c247d7e733668da6b7",
+    "pipeline/lib/jira-family-write.sh": "b29674fd2dc6993636d0c8b6b674a069f37d76775420372a755a1ce3b0f94b95",
+    "pipeline/lib/jira-publish.sh": "d80c7c128fb16e67962d087f0e12ecbb396d8c7367bbb4f6d7eecb7cedf60fb3",
     "pipeline/lib/json-file-lock.mjs": "d8a9075e6fa4fd10d4fb84efd438f92906fb3181455d661ca5fe604c57441524",
     "pipeline/lib/md2confluence-v3.py": "3677ca47931e4b3d0fd2ce3e11299fc5f6d24799eb8332e37dd60b6c3c4653a2",
     "pipeline/lib/model-dispatch.sh": "6500a5a7cb6a4c099cf1d01678bc9465a3d4eb1001e1f516dcc5eacd69577158",
@@ -270,7 +271,7 @@
     "pipeline/multi-agent-refs/channels/board.md": "895edfd4a26f7f5fbe13f0eb5865d30975ed86ee3dbd4bd3bd12340f48001fcb",
     "pipeline/multi-agent-refs/channels/confluence.md": "1e1d731e9f57efdfe77efab3281d74b7f16e28d3d49699da516225492c551ffc",
     "pipeline/multi-agent-refs/channels/issue-comment.md": "19df6d8d6c23b5ea88687250dc10dd5fa35ba2b2e279efcb000e83622a0664f6",
-    "pipeline/multi-agent-refs/channels/jira.md": "7969579dbc69c40743dc547163c5161af06205dece7327e33c9c4775bac96c14",
+    "pipeline/multi-agent-refs/channels/jira.md": "193152cb85396dcea312785b2a630c13a9403b9b9b1ae91c1fca719e8b37747e",
     "pipeline/multi-agent-refs/channels/multi-repo.md": "a309478d8ba253c797904b1ad174be958e4d365b5ff008634ad1d5fc87969474",
     "pipeline/multi-agent-refs/channels/pr-review-actions.md": "21bf53796ae4ecd59769f9944ad8c7d1cd3a5915b0956be99ec875b847b33c00",
     "pipeline/multi-agent-refs/channels/pr.md": "abe0101d4f2a7cb1ecd88c4260e9ae9e7d6dd65dd52afbf6c44c573c48d11f20",
@@ -306,6 +307,7 @@
     "pipeline/multi-agent-refs/features/external-context-injection.md": "be9a0e904efd52535fa18a254567c9d0c3fc2ed12fcbc7a116f7879048303df6",
     "pipeline/multi-agent-refs/features/free-models.md": "64afaba7e7a77575f4ed6a10905a01330a83f573907fb1a5d5356ae6c80999a0",
     "pipeline/multi-agent-refs/features/jira-context.md": "7d14802ed9ad1747e1a06dec26f22ff9e8959e03c47d7a018af45b8274aea47c",
+    "pipeline/multi-agent-refs/features/jira-family.md": "4be05f296e6a2050355c218ed1cd33b489cd8c89ab798e1e44c7ba45fb9517b8",
     "pipeline/multi-agent-refs/features/maturity-followup.md": "e663e5bcf0b3b4d4d2a67f4516dbb9fb12520dfbdedb47a9c5f57c13a9a0633e",
     "pipeline/multi-agent-refs/features/model-fallback.md": "5647b4dbeed6fea21d264f03a85796727a83a001710a8bcbb3932c5a3914d6c5",
     "pipeline/multi-agent-refs/features/mutation-probe.md": "e6d622ab061f6cdcc16da40311e8e7aeae3e6f3c1d4b76d3849859a48a8ae31a",
@@ -358,7 +360,7 @@
     "pipeline/multi-agent-refs/phases/log-format.md": "62d51e57cca8445ab40f3c0dc29615e4b5c8e4743286bf9ef0173610e81397aa",
     "pipeline/multi-agent-refs/phases/modes.md": "0733e20dce458c09f30343db9149fc93bc5a4c9531670b93952f223811dcb1aa",
     "pipeline/multi-agent-refs/phases/operations.md": "9506a26684abfff1e332d92c2321e840544fd4f049aff9f118731e198dabca94",
-    "pipeline/multi-agent-refs/phases/phase-0-init.md": "fe67c915e16adc477c45861b4e0b51f0a4c80189f41f3388883296952cd6acf0",
+    "pipeline/multi-agent-refs/phases/phase-0-init.md": "c83e485b2be0461fdefe796d37788fcb11360616d07ab8e13c266d039ecd4e28",
     "pipeline/multi-agent-refs/phases/phase-1-plan.md": "de3f3dc16ae8853740540caa5497d2f18f016dcb7ea0bfc280ca5c136259a078",
     "pipeline/multi-agent-refs/phases/phase-2-dev.md": "7a87dcf07fc36d877eea92a34c1137dba8cd1f7865c8de83959fb2929bd4c248",
     "pipeline/multi-agent-refs/phases/phase-3-review.md": "60d3bff0370e3a31cbc7824560bd8598c19da0c4025be71e1df60661202d2a38",
@@ -415,7 +417,7 @@
     "pipeline/rules/swiftui-qa.md": "8c4afe9e72413e7bdab655f3d17588469e80ac34cb7ad2a690901fc5b6534818",
     "pipeline/rules/tdd.md": "4c1b3114506aa9794c9bb1e1aee1b1bbb4a993d192342e5697cc00bc2f6ea4a2",
     "pipeline/rules/testing.md": "695be5520b65451f0aa300a9643df2c05e607ff6ad372201ea34798dc5998bd5",
-    "pipeline/schemas/agent-state.schema.json": "a53f8ae0e827034cc44df05fb5a42bd04f6d3ef27a3bda782e9511f0efddc096",
+    "pipeline/schemas/agent-state.schema.json": "85d9ebfb75f89adf9359320702b07742dff7ecc38b1b7801dbf3de9d4447ede4",
     "pipeline/schemas/analysis-output.schema.json": "41826f4bf7c96778f8cdbcc68531e984087897d438b7b49ac5a93fc29db47916",
     "pipeline/schemas/analysis-spec.schema.json": "43770223266be1c94e2cdea585efb6783043353bc5a374613b554596f46e1bcd",
     "pipeline/schemas/answer-request.schema.json": "29d4211a2a05a230e0707b171b73341d2e56f6b83edb178b731905211aab4e23",
@@ -469,7 +471,7 @@
     "pipeline/schemas/plan-todos.schema.json": "be4374b7eeb513fb8a7663374defa5b35ae084f72e112faa41b07c46532c50de",
     "pipeline/schemas/planning-output.schema.json": "6aea9b5b8bbf7f9a227215c29cc30a5b642981a02fe2a81eaf9e8a113f7c3947",
     "pipeline/schemas/pr-request.schema.json": "ae75c4856349d62834802b1189af516bb6fb3d36646831b7ff2fa61d938afcd0",
-    "pipeline/schemas/prefs.schema.json": "82b1442c6ebc89f1ae518dce1e61a44c90e76e62a1118af25a1e7cc97ca90741",
+    "pipeline/schemas/prefs.schema.json": "e3b983744852a8572d92344cdb88367a892afb3e3ee63ce84e798b92b764b8d7",
     "pipeline/schemas/repo-profile.schema.json": "1a74ef8330da9a26a5a70955f6f9cbb20eda54a8615efaf86c7993d420a7f04e",
     "pipeline/schemas/repos.schema.json": "a9bf56f25c66201c170912e3389bd73e4a3f61922410f83e31a6c6ba47aee861",
     "pipeline/schemas/research-output.schema.json": "54e3ba1b04fdc20fbaa84333b943a8ab95d1395c7b0e0aedc67929184cb49523",
@@ -606,8 +608,9 @@
     "pipeline/scripts/host-hooks.mjs": "19fa3afc4c5caead2905144fe7727eacaa7c8e1fee5db20cfdfb8879e5aa7704",
     "pipeline/scripts/issues.mjs": "66c787f1d6be924a61cb8b1504354dd7fb0de89a2afee744aa31435b834ef383",
     "pipeline/scripts/jira-attach.sh": "300b6eb76ae2179324f70a2131388c0f56ca8bf49397cc858937b4d7f47372db",
+    "pipeline/scripts/jira-family.mjs": "b5860c5702ec8c03d0a9ac222fe9728c147445eab32c72173fa077ef82dcf632",
     "pipeline/scripts/jira-search.sh": "afa2e552eec83bf7ab8bc1aa43b99c7480a82bfbfc808ce22c89df1b57e90563",
-    "pipeline/scripts/jira-wiki-escape.mjs": "79f5444e4684aaf09afc272e0c99df22c4976d3a9028dc901c9905dbf8861ecf",
+    "pipeline/scripts/jira-wiki-escape.mjs": "655a170c1ea0d366a7eac9eb25fbf80ddcd19d1d3315bbf75b210908d14237f9",
     "pipeline/scripts/keychain-save.sh": "7cc4d81acd88d84d710fa733d5c9604a0acb3d924738216ac7d34040bad7ae29",
     "pipeline/scripts/keychain.py": "727f55c6e2b87c6078d4a54cc9470b16fc4610abb3a24c60fdd226ae0bf10391",
     "pipeline/scripts/launch-request.mjs": "826c5ec100cd7def4d55c94894582959c1ce325ffc9527e4b3fe43c89fdd8b10",
@@ -724,7 +727,7 @@
     "pipeline/scripts/worktrees.mjs": "90dfd09b70fffe9b56c331a4ae2692cc248f4898f4ee6aee4239ef0b20888a90",
     "pipeline/scripts/write-state.mjs": "e1198bf970eace07d3eff22b394808a526e473df65d3d58aa2d5a12cfdac8b49",
     "pipeline/scripts/write-store-config.mjs": "b994a061f6febb2ca3d396074d8b51d2c1c1f991d3072d321703380da3639a56",
-    "pipeline/skills/.skill-manifest.json": "62b0ff370385c7299a9cb13bb36234bbd618a10fcd3d33e28490816741e526cd",
+    "pipeline/skills/.skill-manifest.json": "df49c99c3f308b8d5dab153e2ed22b301de7417e52065146d11eb754adf75326",
     "pipeline/skills/.skills-index.json": "bfb04a72333aec2c25e21c8edce4a76e2128e5e7f1e88b0cd780e7f1cc6bf370",
     "pipeline/skills/shared/README.md": "47f5c77556bf1676857fe6a803fc5c85da5cd32e1b0332a6f3728b6da610cc58",
     "pipeline/skills/shared/core/apple-archive-compliance/SKILL.md": "7239fef717ea45b79276bfcc2c3903acd57950b6e00dd6a2a66399c4b09cbd51",
@@ -740,7 +743,7 @@
     "pipeline/skills/shared/core/multi-agent-autopilot/SKILL.md": "a9731771fbc1f45260f214f069b976eff16e7b25e2f1375b0d9a213575271bc6",
     "pipeline/skills/shared/core/multi-agent-bug-bash/SKILL.md": "a44ad2520ef24444b68d9040519f82498abda3ebb6467890bb6b5e1460299400",
     "pipeline/skills/shared/core/multi-agent-build-optimize/SKILL.md": "8534891d1198597a0893d131e6b944d15443f62b24cb5584c486a235845fd281",
-    "pipeline/skills/shared/core/multi-agent-channels/SKILL.md": "03f7c648e1938f3d6d7c48d4c1c01f2bd734cdce873ec5203120b5be3ae761db",
+    "pipeline/skills/shared/core/multi-agent-channels/SKILL.md": "cb5e1f9e82f3fd3e7d9ad20bff7a066cafff75323044a08726e3af368738b123",
     "pipeline/skills/shared/core/multi-agent-complaint-analysis/SKILL.md": "dd30708491303902aa8629130809e9601c2096dc12aa9fc671f798142cea3485",
     "pipeline/skills/shared/core/multi-agent-create-jira/SKILL.md": "5aad0d841e9e5b7140bb441e07819209ca64c5b6fc209d6ad586b5fbb353e377",
     "pipeline/skills/shared/core/multi-agent-design-check/SKILL.md": "8888744fa52e935f53db9a1068e1b18c636b6c9d55b084dabfc19b9ae68bf6f8",
@@ -796,7 +799,7 @@
     "pipeline/skills/shared/core/multi-agent-testflight-validation/SKILL.md": "b6c360c330ef0094cd7e7d9624e89624446b048951e43a180766bbe67d1b725c",
     "pipeline/skills/shared/core/multi-agent-uninstall/SKILL.md": "9dccf78ffc2fb014d83f67d683d395f56f4fad8b5a36b9aa84e6cbd075b58818",
     "pipeline/skills/shared/core/multi-agent-update/SKILL.md": "2f9e224e240e1c9053a59066678f869ae36f18c088482488f3bda8fd207148ea",
-    "pipeline/skills/shared/core/multi-agent/SKILL.md": "b2435de3df518efb8ddf9ac89b3089449e46bf55f29220e07a3aa95dfc8cd083",
+    "pipeline/skills/shared/core/multi-agent/SKILL.md": "079b49a1981c63d90798089a343b7f324571c4f7cc6ad3fb757e82719c35eb0a",
     "pipeline/skills/shared/external/NOTICE-avdlee-swiftui-agent-skill.md": "400842e4653f038fad22509fe3f3d152151120758f5f9b170e6dba59afaf4a48",
     "pipeline/skills/shared/external/NOTICE-dimillian-skills.md": "f9c3d783fd3563418c18291b90899251e890fd3fa8ee353c8c1fbbe61078526e",
     "pipeline/skills/shared/external/NOTICE-paul-hudson-skills.md": "bca5fe8779df70fb0f234483d65ff3562c67521e719b69b22aac260803b75244",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmerterden/multi-agent-pipeline",
-  "version": "20.25.1",
+  "version": "20.26.0",
   "description": "6-phase AI development pipeline with full orchestration on Claude Code, Copilot CLI and Codex CLI. Analysis, planning, TDD, CLI-aware parallel review with consensus surfacing + Fable triage, default-FAIL evidence gates, secret + intent guards, per-phase cost ledger, persistent learnings memory, wiki generation, commit automation. Token-preserving uninstall.",
   "type": "module",
   "main": "index.js",

package/pipeline/commands/multi-agent/channels/SKILL.md

@@ -352,7 +352,7 @@ Aggregated Markdown from Step 5 → PR description. GitHub uses `gh pr edit --bo
 Full contract: [`$HOME/.claude/multi-agent-refs/channels/pr.md`]($HOME/.claude/multi-agent-refs/channels/pr.md)  -  Bitbucket payload assembly snippet, version-mismatch retry, `--ready` promotion, multi-repo cross-link block.
 
 #### Adapter: Jira comment
-Sections: `summary` + `test_scenarios` + `impact` + `context_refs` only - the technical ones go to the PR and Confluence (`channels/jira.md` fixes the order). The PR URL goes on line 1, above the first heading. The wiki-markup conversion table lives in that same ref and only there: the four-row summary that used to sit here mapped `### ...` to `*...*`, which is italic, not a heading - a shrunken copy of a table is a second answer, and it was the wrong one.
+Sections: `summary` + `test_scenarios` + `impact` + `context_refs` only - the technical ones go to the PR and Confluence (`channels/jira.md` fixes the order). The PR URL goes on line 1, above the first heading. The wiki-markup conversion table lives in that same ref and only there.
 
 Then post it - do not assemble the request:
 
@@ -360,10 +360,12 @@ Then post it - do not assemble the request:
 bash "$HOME/.claude/lib/jira-publish.sh" --issue "$JIRA_ID" --body-file "$F" --target comment
 ```
 
-The publisher escapes every body (Jira renders `:)` `(x)` `(!)` `(/)` as emoticon images, and a Swift selector like `login(source:input:)` ends in `:)`) and resolves the token from `keychainMapping.jira` without putting it on argv. The hand-rolled `jq`+`curl` this replaced kept the escape as a separate step, and a shipped comment turned `hash(into:)` into a smiley.
+The publisher escapes every body (Jira renders `:)` `(x)` `(!)` `(/)` as emoticon images, and a Swift selector like `login(source:input:)` ends in `:)`) and resolves the token from `keychainMapping.jira` without putting it on argv.
 
 Full contract: [`$HOME/.claude/multi-agent-refs/channels/jira.md`]($HOME/.claude/multi-agent-refs/channels/jira.md)  -  full conversion table, multi-repo PR-list prepend, Wiki→Jira triad interaction.
 
+**Issue family** (`state.jiraFamily` set): instead, `bash $HOME/.claude/lib/jira-family-write.sh plan --state "$STATE_FILE" --dev-body "$F"`, the Step 6 preview as one multi-select under `plan.confirm`, then `apply --state "$STATE_FILE"`: `$HOME/.claude/multi-agent-refs/features/jira-family.md`.
+
 #### Adapter: Confluence page
 Token from `keychainMapping.confluence`; missing/expired triggers the inline Save Flow from `setup.md`. Parent page picked from `prefs.projects[<project>].confluenceUrls` recents (LRU, max 5) or paste new URL. Auto-suggest title `"{jiraId}  -  {taskTitle}"`. Body converted to Confluence storage format (`<h3>`, `<table>`, `<ac:structured-macro>` code blocks). POST `/rest/api/content`; URL saved back to recents.
 

package/pipeline/lib/_jira-auth.sh

@@ -38,7 +38,9 @@
 
 # shellcheck shell=bash
 
-JIRA_AUTH_PREFS="${JIRA_AUTH_PREFS:-$HOME/.claude/multi-agent-preferences.json}"
+# MULTI_AGENT_PREFS is the same override jira-publish.sh reads, so a read and
+# the write after it resolve the same host and token.
+JIRA_AUTH_PREFS="${JIRA_AUTH_PREFS:-${MULTI_AGENT_PREFS:-$HOME/.claude/multi-agent-preferences.json}}"
 
 _jira_auth_pref() {  # _jira_auth_pref <jq path> -> value or empty
   [ -f "$JIRA_AUTH_PREFS" ] || { printf ''; return 0; }

package/pipeline/lib/jira-family-write.sh

@@ -0,0 +1,339 @@
+#!/usr/bin/env bash
+#
+# jira-family-write.sh  -  fetch the issue family of a Jira-started run, and
+# apply the writes scripts/jira-family.mjs planned for it.
+#
+# The planning half is offline and testable; this half is the one that talks
+# to Jira, so it stays small. Every write goes through jira-publish.sh, which
+# escapes the body, runs the outbound gate and backs a description up before it
+# replaces one. A write the plan marks `raw` (the story reformat: the author's
+# lines plus escaped macros) is sent with --raw, so the author's lines reach
+# Jira unchanged. Reads go through jira_api in _jira-auth.sh.
+#
+# A write is checked against the site right before it is sent:
+#   comment      skipped when a comment by the authenticated user on the issue
+#                already carries its marker
+#   description  skipped when the story already conforms, or when it changed
+#                since the plan read it (jira-publish.sh --expect-file)
+# so running the same plan twice writes nothing the second time.
+#
+# Usage, from a run (the state file is agent-state.json; the family's files go
+# to jira-family/ beside it):
+#   jira-family-write.sh resolve --state FILE
+#       fetch and resolve the family, record state.jiraFamily; no Jira write
+#   jira-family-write.sh plan --state FILE --dev-body FILE [--skip id,id]
+#                             [--dev-task KEY] [--test-task KEY] [--build TEXT]
+#       re-resolve and plan; run id, PR URL and mode come from the state
+#   jira-family-write.sh apply --state FILE [--dry-run]
+#       apply jira-family/plan.json, write jira-family/writes.json, merge it
+#       into state.jiraFamily.writes by write id
+#
+# Lower level:
+#   jira-family-write.sh fetch --issue KEY --out DIR
+#       DIR/input.json, DIR/story.json (the parent when KEY is a sub-task, else
+#       the same issue), DIR/site-types.txt (empty when unreadable)
+#   jira-family-write.sh apply --plan FILE [--state FILE] [--result FILE] [--dry-run]
+#       --state   the plan's autopilot decisions are recorded there
+#                 (decisions-log.mjs) once their write has gone out
+#       --result  the per-write outcome as JSON, written on every exit
+#
+# Exit: 0 done, 3 the input does not parse or the plan still has questions,
+#       4 auth (also when a write failed on auth), 5 a write failed (the others
+#       went out; --result lists which, and a re-run sends only what is missing),
+#       6 unattended (nothing read or written; the runner owns Jira),
+#       64 usage or a malformed issue key.
+
+set -uo pipefail
+
+SELF_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=/dev/null
+. "$SELF_DIR/_jira-auth.sh"
+# shellcheck source=/dev/null
+. "$SELF_DIR/unattended.sh"
+
+USAGE="usage:
+  jira-family-write.sh resolve --state FILE
+  jira-family-write.sh plan --state FILE --dev-body FILE [--skip id,id] [--dev-task KEY] [--test-task KEY] [--build TEXT]
+  jira-family-write.sh apply --state FILE [--plan FILE] [--result FILE] [--dry-run]
+  jira-family-write.sh fetch --issue KEY --out DIR
+  jira-family-write.sh apply --plan FILE [--state FILE] [--result FILE] [--dry-run]"
+usage() { echo "$USAGE" >&2; exit 64; }
+
+CMD="${1:-}"; [ -n "$CMD" ] || usage; shift
+case "$CMD" in -h|--help) sed -n '2,45p' "$0"; exit 0 ;; esac
+ISSUE=""; OUT=""; PLAN=""; STATE=""; RESULT=""; DRY=0
+DEV_BODY=""; SKIP=""; DEV_TASK=""; TEST_TASK=""; BUILD=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    -h|--help) sed -n '2,45p' "$0"; exit 0 ;;
+    --dev-body) DEV_BODY="${2:-}"; shift 2 ;;
+    --skip) SKIP="${2:-}"; shift 2 ;;
+    --dev-task) DEV_TASK="${2:-}"; shift 2 ;;
+    --test-task) TEST_TASK="${2:-}"; shift 2 ;;
+    --build) BUILD="${2:-}"; shift 2 ;;
+    --issue) ISSUE="${2:-}"; shift 2 ;;
+    --out) OUT="${2:-}"; shift 2 ;;
+    --plan) PLAN="${2:-}"; shift 2 ;;
+    --state) STATE="${2:-}"; shift 2 ;;
+    --result) RESULT="${2:-}"; shift 2 ;;
+    --dry-run) DRY=1; shift ;;
+    *) usage ;;
+  esac
+done
+
+command -v jq >/dev/null 2>&1 || { echo "ERR: jq is required" >&2; exit 3; }
+
+FAMILY_MJS="$SELF_DIR/../scripts/jira-family.mjs"
+DECISIONS_MJS="$SELF_DIR/../scripts/decisions-log.mjs"
+PUBLISH="$SELF_DIR/jira-publish.sh"
+FIELDS="summary,issuetype,parent,subtasks,description,project,status"
+
+# A key goes into a REST path, so anything but a key is refused before use.
+valid_key() { printf '%s' "$1" | grep -Eq '^[A-Z][A-Z0-9_]+-[0-9]+$'; }
+
+# What a jira-publish.sh exit code means, for the result line.
+publish_reason() {
+  case "$1" in
+    4) echo "Jira host or token could not be resolved (exit 4)" ;;
+    5) echo "the Jira call failed (exit 5)" ;;
+    64) echo "refused before sending, e.g. by the outbound gate (exit 64): $2" ;;
+    *) echo "jira-publish.sh exit $1: $2" ;;
+  esac
+}
+
+fetch_issue() {  # fetch_issue <key> <file>
+  jira_api GET "/rest/api/2/issue/$1?fields=$FIELDS" > "$2" 2>/dev/null || return 5
+  jq -e '.key' "$2" >/dev/null 2>&1 || return 5
+}
+
+do_fetch() {  # do_fetch <key> <dir>
+  local issue="$1" out="$2" parent project
+  valid_key "$issue" || { echo "ERR: not an issue key: $issue" >&2; return 64; }
+  if ma_unattended; then
+    echo "unattended run: the family is not read here; the runner owns Jira" >&2
+    return 6
+  fi
+  jira_auth_resolve || return 4
+  mkdir -p "$out"
+  fetch_issue "$issue" "$out/input.json" || { echo "ERR: could not read $issue" >&2; return 5; }
+  parent="$(jq -r 'if .fields.issuetype.subtask == true then .fields.parent.key // empty else empty end' "$out/input.json")"
+  if [ -n "$parent" ] && ! valid_key "$parent"; then
+    echo "WARN: the parent key does not look like a key: $parent" >&2; parent=""
+  fi
+  if [ -n "$parent" ]; then
+    fetch_issue "$parent" "$out/story.json" || { echo "WARN: could not read the parent $parent" >&2; rm -f "$out/story.json"; }
+  else
+    cp "$out/input.json" "$out/story.json"
+  fi
+  project="$(jq -r '.fields.project.key // empty' "$out/input.json")"
+  [ -n "$project" ] || project="${issue%%-*}"
+  bash "$SELF_DIR/analysis-jira-write.sh" --subtask-types --project "$project" \
+    > "$out/site-types.txt" 2>/dev/null || : > "$out/site-types.txt"
+  echo "fetched $issue${parent:+ (story $parent)} into $out"
+}
+
+# The run's own files: the issue key and the family directory beside agent-state.json.
+state_key() { jq -r '.jiraId // .taskId // empty' "$STATE"; }
+family_dir() { printf '%s/jira-family' "$(cd "$(dirname "$STATE")" && pwd)"; }
+
+do_resolve() {  # fetch, resolve, and record state.jiraFamily; asks and writes nothing in Jira
+  local key dir story=""
+  key="$(state_key)"; dir="$(family_dir)"
+  do_fetch "$key" "$dir" >/dev/null || return $?
+  [ -f "$dir/story.json" ] && story="--story $dir/story.json"
+  # shellcheck disable=SC2086
+  node "$FAMILY_MJS" resolve --input "$dir/input.json" $story \
+    --site-types "$dir/site-types.txt" > "$dir/family.json" || return 3
+}
+
+if [ "$CMD" = "fetch" ]; then
+  [ -n "$ISSUE" ] && [ -n "$OUT" ] || usage
+  do_fetch "$ISSUE" "$OUT"
+  exit $?
+fi
+
+WRITE_STATE="$SELF_DIR/../scripts/write-state.mjs"
+
+if [ "$CMD" = "resolve" ]; then
+  [ -n "$STATE" ] && [ -f "$STATE" ] || usage
+  do_resolve || exit $?
+  DIR="$(family_dir)"
+  jq -n --slurpfile f "$DIR/family.json" --slurpfile s "$STATE" \
+    '{jiraFamily: ($f[0].stateEntry + {writes: ($s[0].jiraFamily.writes // [])})}' \
+    | node "$WRITE_STATE" "$STATE" || exit 3
+  jq -r '"family: story \(.stateEntry.storyKey), dev \(.stateEntry.devTaskKey // "-"), test \(.stateEntry.testTaskKey // "-"), story format \(.stateEntry.storyFormat.status)"' "$DIR/family.json"
+  exit 0
+fi
+
+if [ "$CMD" = "plan" ]; then
+  [ -n "$STATE" ] && [ -f "$STATE" ] && [ -n "$DEV_BODY" ] && [ -f "$DEV_BODY" ] || usage
+  do_resolve || exit $?
+  DIR="$(family_dir)"
+  RUN_ID="$(jq -r '"\(.taskId)-\(.shortId // 0)"' "$STATE")"
+  PR_URL="$(jq -r '.pr.url // .projects[0].pr.url // empty' "$STATE")"
+  MODE="$(jq -r 'if .autopilot == true then "autopilot" else "interactive" end' "$STATE")"
+  set -- --family "$DIR/family.json" --dev-body "$DEV_BODY" --run-id "$RUN_ID" --mode "$MODE"
+  [ -z "$PR_URL" ] || set -- "$@" --pr-url "$PR_URL"
+  [ -z "$BUILD" ] || set -- "$@" --build "$BUILD"
+  [ -z "$SKIP" ] || set -- "$@" --skip "$SKIP"
+  [ -z "$DEV_TASK" ] || set -- "$@" --dev-task "$DEV_TASK"
+  [ -z "$TEST_TASK" ] || set -- "$@" --test-task "$TEST_TASK"
+  node "$FAMILY_MJS" plan "$@" > "$DIR/plan.json" || exit 3
+  jq -r '.confirm, (.skipped[] | "  not written: \(.id) (\(.reason))"), (.questions[] | "  question \(.id): \(.question) [\(.options | join(", "))]")' "$DIR/plan.json"
+  echo "plan: $DIR/plan.json"
+  exit 0
+fi
+
+[ "$CMD" = "apply" ] || usage
+MERGE=0
+if [ -z "$PLAN" ] && [ -n "$STATE" ] && [ -f "$STATE" ]; then
+  PLAN="$(family_dir)/plan.json"
+  [ -n "$RESULT" ] || RESULT="$(family_dir)/writes.json"
+  MERGE=1
+fi
+[ -n "$PLAN" ] && [ -f "$PLAN" ] || usage
+
+# Every exit leaves a result file, so the caller's follow-up never reads nothing.
+early_exit() {  # early_exit <code> <status> <reason>
+  if [ -n "$RESULT" ]; then
+    jq -c --arg s "$2" --arg r "$3" '[.writes[]? | {id, issue, status: $s, reason: $r}]' "$PLAN" \
+      > "$RESULT" 2>/dev/null || echo '[]' > "$RESULT"
+  fi
+  exit "$1"
+}
+if ma_unattended; then
+  echo "unattended run: the family writes are left to the runner" >&2
+  early_exit 6 skipped "unattended run: left to the runner"
+fi
+jq -e . "$PLAN" >/dev/null 2>&1 || { echo "ERR: the plan does not parse: $PLAN" >&2; early_exit 3 failed "the plan does not parse"; }
+if [ "$(jq -r '.ready' "$PLAN")" != "true" ]; then
+  echo "ERR: the plan still has open questions ($(jq -r '[.questions[].id] | join(", ")' "$PLAN")); answer them and re-plan" >&2
+  early_exit 3 skipped "the plan still has open questions"
+fi
+[ "$DRY" -eq 1 ] || jira_auth_resolve || exit 4
+
+WORK="$(mktemp -d)"
+trap 'rm -rf "$WORK"' EXIT
+RESULTS="$WORK/results.jsonl"; : > "$RESULTS"
+ME=""
+RC=0
+
+record() {  # record <id> <issue> <status> <reason>
+  jq -cn --arg i "$1" --arg k "$2" --arg s "$3" --arg r "$4" \
+    '{id: $i, issue: $k, status: $s, reason: $r}' >> "$RESULTS"
+  printf '  %-8s %-12s %s%s\n' "$3" "$1" "$2" "${4:+  ($4)}"
+}
+
+fail_rc() {  # an auth failure (4) outranks any other failure (5) in the exit code
+  if [ "$1" -eq 4 ]; then RC=4; elif [ "$RC" -ne 4 ]; then RC=5; fi
+}
+
+record_decisions() {  # record_decisions <writeId>, or "" for the decisions that made no write
+  [ -n "$STATE" ] || return 0
+  jq -c --arg w "$1" '.decisions[]? | select(if $w == "" then .writeId == null else .writeId == $w end)' "$PLAN" | while IFS= read -r d; do
+    node "$DECISIONS_MJS" add --state "$STATE" \
+      --what "$(printf '%s' "$d" | jq -r .what)" \
+      --why "$(printf '%s' "$d" | jq -r .why)" \
+      --cost-if-wrong "$(printf '%s' "$d" | jq -r .costIfWrong)" \
+      --phase "$(printf '%s' "$d" | jq -r .phase)" >/dev/null 2>&1 \
+      || echo "  WARN: could not record the decision for $1" >&2
+  done
+}
+
+echo "jira-family: $(jq -r '.confirm' "$PLAN")$([ "$DRY" -eq 1 ] && echo "  (dry run)")"
+N="$(jq '.writes | length' "$PLAN")"
+i=0
+while [ "$i" -lt "$N" ]; do
+  W="$(jq -c ".writes[$i]" "$PLAN")"
+  i=$((i + 1))
+  id="$(printf '%s' "$W" | jq -r .id)"
+  kind="$(printf '%s' "$W" | jq -r .kind)"
+  issue="$(printf '%s' "$W" | jq -r .issue)"
+  printf '%s' "$W" | jq -j .body > "$WORK/body.txt"
+  if ! valid_key "$issue"; then
+    record "$id" "$issue" "failed" "not an issue key"; RC=5; continue
+  fi
+  if [ "$DRY" -eq 1 ]; then
+    record "$id" "$issue" "dry-run" "$kind"
+    continue
+  fi
+  if [ "$kind" = "comment" ]; then
+    mark="$(printf '%s' "$W" | jq -r .marker)"
+    if ! jira_api GET "/rest/api/2/issue/$issue/comment?maxResults=1000" > "$WORK/comments.json" 2>/dev/null \
+        || ! jq -e '.comments' "$WORK/comments.json" >/dev/null 2>&1; then
+      record "$id" "$issue" "failed" "could not read the comments"; RC=5; continue
+    fi
+    if [ -z "$ME" ]; then
+      jira_api GET "/rest/api/2/myself" > "$WORK/me.json" 2>/dev/null || :
+      ME="$(jq -c '{name, key, accountId} | with_entries(select(.value != null))' "$WORK/me.json" 2>/dev/null || echo "")"
+    fi
+    if [ -z "$ME" ] || [ "$ME" = "{}" ]; then
+      ME=""; record "$id" "$issue" "failed" "could not read the authenticated user"; RC=5; continue
+    fi
+    # Only our own comments count: another user can paste a marker, and it
+    # must not be able to stop this one from being posted.
+    seen="$(jq --arg m "$mark" --argjson me "$ME" '[.comments[]?
+      | select((.author // {}) as $a | any($me | to_entries[]; $a[.key] == .value))
+      | .body // "" | select(contains($m))] | length' "$WORK/comments.json")"
+    if [ "${seen:-0}" -gt 0 ]; then
+      record "$id" "$issue" "exists" "already posted by this run"; continue
+    fi
+    bash "$PUBLISH" --issue "$issue" --body-file "$WORK/body.txt" --target comment >/dev/null 2>"$WORK/err.txt"
+    prc=$?
+    if [ "$prc" -eq 0 ]; then
+      record "$id" "$issue" "written" ""
+      record_decisions "$id"
+    else
+      record "$id" "$issue" "failed" "$(publish_reason "$prc" "$(head -1 "$WORK/err.txt")")"
+      fail_rc "$prc"
+    fi
+    continue
+  fi
+  # description
+  if ! jira_api GET "/rest/api/2/issue/$issue?fields=description" > "$WORK/current.json" 2>/dev/null \
+      || ! jq -e '.fields' "$WORK/current.json" >/dev/null 2>&1; then
+    record "$id" "$issue" "failed" "could not read the description"; RC=5; continue
+  fi
+  jq -j '.fields.description // ""' "$WORK/current.json" > "$WORK/current.txt"
+  printf '%s' "$W" | jq -j '.original // ""' > "$WORK/original.txt"
+  jq '{global: {issueTree: (if .storyPanels == null then {} else {storyPanels: .storyPanels} end)}}' \
+    "$PLAN" > "$WORK/plan-prefs.json"
+  if node "$FAMILY_MJS" check --description "$WORK/current.txt" --prefs "$WORK/plan-prefs.json" >/dev/null 2>&1; then
+    record "$id" "$issue" "exists" "already in the story format"; continue
+  fi
+  if ! cmp -s "$WORK/current.txt" "$WORK/original.txt"; then
+    record "$id" "$issue" "skipped" "the description changed since the preview"; continue
+  fi
+  raw=""
+  [ "$(printf '%s' "$W" | jq -r '.raw == true')" = "true" ] && raw="--raw"
+  bash "$PUBLISH" --issue "$issue" --body-file "$WORK/body.txt" --target description \
+    --mode replace --confirm-overwrite --expect-file "$WORK/original.txt" $raw >/dev/null 2>"$WORK/err.txt"
+  prc=$?
+  if [ "$prc" -eq 0 ]; then
+    record "$id" "$issue" "written" "previous text backed up"
+    record_decisions "$id"
+  elif [ "$prc" -eq 6 ]; then
+    record "$id" "$issue" "skipped" "the description changed since the preview"
+  else
+    record "$id" "$issue" "failed" "$(publish_reason "$prc" "$(head -1 "$WORK/err.txt")")"
+    fail_rc "$prc"
+  fi
+done
+
+[ "$DRY" -eq 1 ] || record_decisions ""
+[ -z "$RESULT" ] || jq -s '.' "$RESULTS" > "$RESULT"
+# Merged by write id: a re-run that finds a comment already there ("exists")
+# keeps the earlier "written" record instead of replacing it.
+if [ "$MERGE" -eq 1 ] && [ "$DRY" -eq 0 ]; then
+  jq -n --slurpfile s "$STATE" --slurpfile n "$RESULT" '
+    ($s[0].jiraFamily // {}) as $f
+    | ($f.writes // []) as $old
+    | ($n[0] | map({(.id): .}) | add // {}) as $new
+    | ($old | map(.id)) as $oldIds
+    | {jiraFamily: ($f + {writes: (
+        [$old[] | . as $o | ($new[$o.id] // null) as $x
+          | if $x == null or ($o.status == "written" and $x.status == "exists") then $o else $x end]
+        + [$n[0][] | select(.id as $i | $oldIds | index($i) | not)])})}' \
+    | node "$WRITE_STATE" "$STATE" >/dev/null || echo "  WARN: could not record the writes in $STATE" >&2
+fi
+exit "$RC"

package/pipeline/lib/jira-publish.sh

@@ -19,6 +19,8 @@
 #                   [--mode append|replace]          (description only, default: append)
 #                   [--confirm-overwrite]            (required for mode=replace on a non-empty field)
 #                   [--backup-dir DIR]
+#                   [--raw]                          (body is already Jira wiki markup; no emoticon escape)
+#                   [--expect-file FILE]             (description only: write only if it still equals FILE)
 #                   [--dry-run]
 #
 # Resolution:
@@ -29,6 +31,9 @@
 #
 # Every body is run through scripts/jira-wiki-escape.mjs before it is sent, so
 # Jira cannot manufacture an emoticon out of a Swift selector or a table cell.
+# --raw skips that one step for a body built only from text the author already
+# wrote in Jira markup plus macros the caller escaped itself (the story reformat
+# of lib/jira-family-write.sh); the outbound gate and the backup still apply.
 #
 # Exit codes:
 #   0  published (or, with --dry-run, previewed)
@@ -36,6 +41,8 @@
 #      --confirm-overwrite was given. The backup is already on disk.
 #   4  host or token could not be resolved
 #   5  a Jira API call failed
+#   6  refused: --expect-file no longer matches the description (someone
+#      edited it after the caller read it). Nothing was written.
 #  64  usage error
 
 set -euo pipefail
@@ -91,6 +98,8 @@ TARGET="comment"
 MODE="append"
 CONFIRM=0
 DRY_RUN=0
+RAW=0
+EXPECT=""
 BACKUP_DIR="${JIRA_BACKUP_DIR:-$HOME/.claude/logs/multi-agent/jira-backups}"
 
 die() { echo "$1" >&2; exit "${2:-64}"; }
@@ -106,6 +115,8 @@ while [ "$#" -gt 0 ]; do
     --backup-dir) need_value "$@"; BACKUP_DIR="$2"; shift 2 ;;
     --confirm-overwrite) CONFIRM=1; shift ;;
     --dry-run) DRY_RUN=1; shift ;;
+    --raw) RAW=1; shift ;;
+    --expect-file) need_value "$@"; EXPECT="$2"; shift 2 ;;
     -h|--help) sed -n '2,40p' "$0"; exit 0 ;;
     *) die "unknown argument: $1" ;;
   esac
@@ -148,7 +159,16 @@ api() { "$CURL" -sS -m 30 -K <(auth_cfg "$TOKEN") -H "Content-Type: application/
 WORK="$(mktemp -d)"
 trap 'rm -rf "$WORK"' EXIT
 
-node "$ESCAPER" "$BODY_FILE" > "$WORK/new.txt"
+if [ "$RAW" = "1" ]; then
+  cp "$BODY_FILE" "$WORK/new.txt"
+else
+  node "$ESCAPER" "$BODY_FILE" > "$WORK/new.txt"
+fi
+# An escaper that printed nothing for a body that has text would post an empty
+# comment or blank a description; that is refused, never sent.
+if [ -s "$BODY_FILE" ] && [ ! -s "$WORK/new.txt" ]; then
+  die "the escaped body came out empty; nothing was posted" 5
+fi
 
 if [ "$TARGET" = "comment" ]; then
   if [ "$DRY_RUN" = "1" ]; then
@@ -175,6 +195,13 @@ case "$http" in
   *) echo "could not read the current description of $ISSUE (HTTP $http)" >&2; exit 5 ;;
 esac
 jq -r '.fields.description // ""' "$WORK/issue.json" > "$WORK/existing.txt"
+if [ -n "$EXPECT" ]; then
+  jq -j '.fields.description // ""' "$WORK/issue.json" > "$WORK/existing-exact.txt"
+  if ! cmp -s "$WORK/existing-exact.txt" "$EXPECT"; then
+    echo "REFUSED: the description of $ISSUE changed since it was read; nothing was written." >&2
+    exit 6
+  fi
+fi
 
 existing_bytes=$(wc -c < "$WORK/existing.txt" | tr -d ' ')
 existing_lines=$(grep -c . "$WORK/existing.txt" || true)

package/pipeline/multi-agent-refs/channels/jira.md

@@ -232,6 +232,8 @@ Jira's wiki renderer turned it into an emoticon, which is what section
 *Emoticon escaping* below is about. A defence that has to be invoked by hand is
 a defence that is eventually not invoked.
 
+A run with `state.jiraFamily` posts this body on the development sub-task, plus a test comment on the test sub-task: `features/jira-family.md`.
+
 The dispatch summary line includes the comment URL with `?focusedCommentId=...` so the user can paste it into Slack/Teams.
 
 ### Writing the issue description (not a comment)