yadflow 4.7.0 → 4.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/CHANGELOG.md +116 -0
  2. package/README.md +43 -4
  3. package/bin/commands.mjs +5 -1
  4. package/bin/yad.mjs +169 -22
  5. package/cli/agent-guard.mjs +511 -0
  6. package/cli/agent-guide.mjs +83 -0
  7. package/cli/agent-rules.mjs +388 -0
  8. package/cli/argv-flags.mjs +7 -0
  9. package/cli/build.mjs +1 -1
  10. package/cli/ci-check.mjs +492 -0
  11. package/cli/docs.mjs +1 -1
  12. package/cli/doctor.mjs +148 -7
  13. package/cli/epic-state.mjs +3 -3
  14. package/cli/errors.mjs +1 -0
  15. package/cli/guide.mjs +549 -0
  16. package/cli/hook.mjs +32 -3
  17. package/cli/lib.mjs +46 -0
  18. package/cli/lifecycle/defaults/2.json +124 -0
  19. package/cli/lifecycle/lifecycle.schema.json +5 -2
  20. package/cli/lifecycle.mjs +16 -3
  21. package/cli/machine.mjs +141 -0
  22. package/cli/manifest.mjs +75 -0
  23. package/cli/marked-block.mjs +48 -0
  24. package/cli/members.mjs +19 -5
  25. package/cli/migrate.mjs +17 -19
  26. package/cli/next.mjs +1 -1
  27. package/cli/openpr.mjs +46 -6
  28. package/cli/plan.mjs +326 -22
  29. package/cli/preview.mjs +253 -0
  30. package/cli/protection.mjs +50 -0
  31. package/cli/reconcile.mjs +187 -26
  32. package/cli/repo.mjs +64 -3
  33. package/cli/report.mjs +62 -14
  34. package/cli/review.mjs +4 -0
  35. package/cli/setup.mjs +244 -25
  36. package/cli/signing.mjs +377 -0
  37. package/cli/story-frames.mjs +296 -0
  38. package/cli/test-agents-file.mjs +993 -0
  39. package/cli/test-ci-check.mjs +616 -0
  40. package/cli/test-guide.mjs +1267 -0
  41. package/cli/test-machine.mjs +140 -0
  42. package/cli/test-node.mjs +129 -0
  43. package/cli/test-preview.mjs +511 -0
  44. package/cli/test-setup-agent.mjs +352 -0
  45. package/cli/test-signing.mjs +524 -0
  46. package/cli/test-story-frames.mjs +339 -0
  47. package/cli/toolbox.mjs +35 -1
  48. package/cli/update-commit.mjs +313 -11
  49. package/cli/workspace.mjs +37 -12
  50. package/package.json +6 -4
  51. package/skills/sdlc/config.yaml +4 -4
  52. package/skills/sdlc/module-help.csv +1 -0
  53. package/skills/yad-change/SKILL.md +3 -2
  54. package/skills/yad-checks/SKILL.md +29 -9
  55. package/skills/yad-checks/references/check-gates.md +9 -4
  56. package/skills/yad-checks/templates/checks/package-manager.sh +1 -1
  57. package/skills/yad-checks/templates/github/yad-checks.yml +1 -1
  58. package/skills/yad-checks/templates/gitlab/.gitlab-ci.yml +1 -1
  59. package/skills/yad-checks/templates/gitlab/yad-checks.gitlab-ci.yml +1 -1
  60. package/skills/yad-checks/templates/gitlab/yad-product-checks.gitlab-ci.yml +1 -1
  61. package/skills/yad-checks/templates/gitlab/yad-update-guard.gitlab-ci.yml +1 -1
  62. package/skills/yad-checks/templates/gitlab/yad-verified-commits.gitlab-ci.yml +1 -1
  63. package/skills/yad-checks/templates/hooks/agent-guard.mjs +116 -0
  64. package/skills/yad-commit/SKILL.md +4 -3
  65. package/skills/yad-connect-design/SKILL.md +7 -4
  66. package/skills/yad-connect-design/references/design-context.md +23 -0
  67. package/skills/yad-connect-design/references/design-registry.md +3 -3
  68. package/skills/yad-connect-repos/SKILL.md +13 -3
  69. package/skills/yad-connect-repos/references/code-context.md +2 -1
  70. package/skills/yad-connect-repos/references/repos-registry.md +2 -1
  71. package/skills/yad-docs-overview/references/pipeline-model.md +2 -2
  72. package/skills/yad-engineer-review/SKILL.md +25 -7
  73. package/skills/yad-engineer-review/references/ship-and-record.md +7 -4
  74. package/skills/yad-epic/SKILL.md +2 -1
  75. package/skills/yad-epic/references/state-schema.md +7 -1
  76. package/skills/yad-guide/SKILL.md +192 -0
  77. package/skills/yad-implement/SKILL.md +14 -0
  78. package/skills/yad-open-pr/SKILL.md +5 -2
  79. package/skills/yad-pair-review/SKILL.md +19 -5
  80. package/skills/yad-pr-template/templates/github/pull_request_template.md +1 -0
  81. package/skills/yad-pr-template/templates/gitlab/merge_request_templates/Default.md +1 -0
  82. package/skills/yad-product-bridge/SKILL.md +32 -13
  83. package/skills/yad-product-bridge/references/bridge.md +6 -3
  84. package/skills/yad-product-bridge/templates/github/yad-gate-sync.yml +2 -2
  85. package/skills/yad-product-bridge/templates/gitlab/yad-gate-sync.gitlab-ci.yml +1 -1
  86. package/skills/yad-report/SKILL.md +15 -0
  87. package/skills/yad-review-companion/SKILL.md +9 -4
  88. package/skills/yad-review-gate/SKILL.md +13 -9
  89. package/skills/yad-review-gate/references/gating.md +1 -1
  90. package/skills/yad-run/SKILL.md +10 -6
  91. package/skills/yad-run/references/run-loop.md +2 -1
  92. package/skills/yad-spec/SKILL.md +21 -0
  93. package/skills/yad-stories/SKILL.md +22 -0
  94. package/skills/yad-stories/references/story-schema.md +1 -0
  95. package/skills/yad-sync-repos/SKILL.md +2 -1
  96. package/skills/yad-ui/SKILL.md +7 -2
package/CHANGELOG.md CHANGED
@@ -1,3 +1,119 @@
1
+ # [4.9.0](https://github.com/abdelrahmannasr/yadflow/compare/v4.8.0...v4.9.0) (2026-11-04)
2
+
3
+
4
+ ### Bug Fixes
5
+
6
+ * **doctor:** [#352](https://github.com/abdelrahmannasr/yadflow/issues/352) review 1 — '>22' and '>= 22' read as npm reads them, glab duplicates only where glab looks, repo text cleaned, one Node row per folder ([5474a05](https://github.com/abdelrahmannasr/yadflow/commit/5474a052012a1bf7e2322d53e998654e171bb90f))
7
+ * **doctor:** [#352](https://github.com/abdelrahmannasr/yadflow/issues/352) review 2 — look for glab's config only where glab is known to look on Windows ([35b9d67](https://github.com/abdelrahmannasr/yadflow/commit/35b9d67a93f5b7639f07492ac7bd63f503265134))
8
+ * **preview:** review 1 — a {branch} pattern never fills from the wrong branch, one hard time budget, no false 'none recorded' ([#359](https://github.com/abdelrahmannasr/yadflow/issues/359)) ([d1688b0](https://github.com/abdelrahmannasr/yadflow/commit/d1688b0d23d9b88f6709b7a9921091e760b49f86))
9
+ * **preview:** review 2 — the Preview line is set before the summary, GitLab environments asked for their state, the default branch is no PR's ([#359](https://github.com/abdelrahmannasr/yadflow/issues/359)) ([aa8b8b7](https://github.com/abdelrahmannasr/yadflow/commit/aa8b8b7b56222a2f9047691a3f7019ad30e44d94))
10
+ * **preview:** review 3 — one next step in the why, GitLab merge-request pipeline deployments count ([#359](https://github.com/abdelrahmannasr/yadflow/issues/359)) ([98089df](https://github.com/abdelrahmannasr/yadflow/commit/98089dfeebc7ca590b71c883208f4bace61d178d))
11
+ * **preview:** review 4 — GitLab without --pr and a non-number --pr both say pass --pr; the MR ref counts with no source branch ([#359](https://github.com/abdelrahmannasr/yadflow/issues/359)) ([86d65ae](https://github.com/abdelrahmannasr/yadflow/commit/86d65aea2a8b47d7f4a6fa3a2b3b3ec35534b8d2))
12
+ * **preview:** review 5 — a broken pattern is named before --pr on GitLab, and --pr is never offered for a GitLab that cannot be asked ([#359](https://github.com/abdelrahmannasr/yadflow/issues/359)) ([04c4379](https://github.com/abdelrahmannasr/yadflow/commit/04c43798e2d6b4e97f7c6e4b5f27047fa654f55d))
13
+ * **preview:** review 6 — the GitLab MR-pipeline step reads a flag, not the wording ([#359](https://github.com/abdelrahmannasr/yadflow/issues/359)) ([42fa00d](https://github.com/abdelrahmannasr/yadflow/commit/42fa00d8779f655eaeada77082c60ca02d3d25bd))
14
+ * **story:** review 1 — the preflight never stops a person for the wrong reason ([#358](https://github.com/abdelrahmannasr/yadflow/issues/358)) ([5dcd98b](https://github.com/abdelrahmannasr/yadflow/commit/5dcd98b3244309b7ce2bb4a72c6504c357cf91eb))
15
+ * **story:** review 1 — Windows line endings, misspelled keys and odd story files never read as "no frames" ([#354](https://github.com/abdelrahmannasr/yadflow/issues/354)) ([b130a56](https://github.com/abdelrahmannasr/yadflow/commit/b130a56c397d2ee6851ff9264bb93e950633eb2c))
16
+ * **story:** review 2 — doctor follows symlinks like the command; a second, misspelled key is said ([#354](https://github.com/abdelrahmannasr/yadflow/issues/354)) ([c4a0570](https://github.com/abdelrahmannasr/yadflow/commit/c4a0570db90c28ec59d8d931fb81555ac450615c))
17
+ * **story:** review 2 — frames of another tool, unknown MCP ids and a missing design-links.json never stop a person wrongly ([#358](https://github.com/abdelrahmannasr/yadflow/issues/358)) ([041c368](https://github.com/abdelrahmannasr/yadflow/commit/041c36867198a62843f4daf643b366f910e632d1))
18
+ * **story:** review 3 — provider and tool names compared on their letters and digits ([#358](https://github.com/abdelrahmannasr/yadflow/issues/358)) ([edd1145](https://github.com/abdelrahmannasr/yadflow/commit/edd1145833792700a787b5c0795ddf441364321b))
19
+
20
+
21
+ ### Features
22
+
23
+ * **doctor:** [#352](https://github.com/abdelrahmannasr/yadflow/issues/352) — check the machine: the Node each repo pins, Docker where a repo asks for it, duplicate glab config files ([fdabafc](https://github.com/abdelrahmannasr/yadflow/commit/fdabafc166d8fce0216023c885650b6362ca1de6))
24
+ * **repo:** a preview address per PR/MR for live design checks ([#359](https://github.com/abdelrahmannasr/yadflow/issues/359)) ([225b646](https://github.com/abdelrahmannasr/yadflow/commit/225b646bbed8fd1422368279e2c03e1c348a95c5))
25
+ * **story:** yad story frames reads a story's design frames; doctor warns on any it cannot read ([#354](https://github.com/abdelrahmannasr/yadflow/issues/354)) ([fda0a46](https://github.com/abdelrahmannasr/yadflow/commit/fda0a468b9c7213b308ad60bcabd653fd5bf231d))
26
+ * **story:** yad story frames says how to check the design tool can be reached ([#358](https://github.com/abdelrahmannasr/yadflow/issues/358)) ([dd9bd94](https://github.com/abdelrahmannasr/yadflow/commit/dd9bd94c0a35b62e62416c9b5999c966de4bccb6))
27
+
28
+ # [4.8.0](https://github.com/abdelrahmannasr/yadflow/compare/v4.7.0...v4.8.0) (2026-11-02)
29
+
30
+
31
+ ### Bug Fixes
32
+
33
+ * **agents:** E158 review 1 — the guard reads the line as yad does, PR approvals are the person's ([86b4150](https://github.com/abdelrahmannasr/yadflow/commit/86b4150c70d5080264c04fdba2a6d2e6935b38bb))
34
+ * **agents:** E158 review 10 — skipping the git hooks is the person's; API merges; node and wrapper options ([5c31021](https://github.com/abdelrahmannasr/yadflow/commit/5c3102159266bbca02c1cc544a232a1b723cd519))
35
+ * **agents:** E158 review 11 — API merges only as writes; core.hooksPath in git config; the hook door is the person's ([9e820d8](https://github.com/abdelrahmannasr/yadflow/commit/9e820d8f294bdfb989ee2ce464f0ced5b9a84434))
36
+ * **agents:** E158 review 12 — xargs switches; field= approvals; the pointer block's hook rule; the pre-commit hook's skip is a person's ([815660d](https://github.com/abdelrahmannasr/yadflow/commit/815660d0ecd492b0745456ca38475ae229a70c07))
37
+ * **agents:** E158 review 13 — doctor on an earlier hook text; BSD xargs; the ledger hook's person-only rows ([e8346ac](https://github.com/abdelrahmannasr/yadflow/commit/e8346ac21bc65c00513d49ce1e2d788073305b6b))
38
+ * **agents:** E158 review 14 — short options with =; the shipped guard header; commit --manual is the person's in migrate and ship ([78ea0a8](https://github.com/abdelrahmannasr/yadflow/commit/78ea0a83f416962dd10a6fb8fcaa540d7644619e))
39
+ * **agents:** E158 review 15 — pin the person-only wording in tests; doc nits ([70704a0](https://github.com/abdelrahmannasr/yadflow/commit/70704a0cf183f525a2603504b0d14f4794074299))
40
+ * **agents:** E158 review 2 — the guard reads here-strings, comments and more prefixes; closed annotations; push hand-offs in skill references ([26c00e8](https://github.com/abdelrahmannasr/yadflow/commit/26c00e816f6be3fde654a37fb5cb5881096212b7))
41
+ * **agents:** E158 review 3 — substitutions and package runners in the guard, no block added to an unwired repo ([1a915e5](https://github.com/abdelrahmannasr/yadflow/commit/1a915e55346f77907c60912dc200ae870d4f1a83))
42
+ * **agents:** E158 review 4 — only files the run writes ride update --open-pr; the person's acts in more skills ([3d8ba6f](https://github.com/abdelrahmannasr/yadflow/commit/3d8ba6f5eeb0befc09ae4904af5ace690035117e))
43
+ * **agents:** E158 review 5 — a runner's -c line is judged; the guard and allow list are the Product folder's ([6b6d456](https://github.com/abdelrahmannasr/yadflow/commit/6b6d456ec36f878c0bfc525510b6f4f507786e6b))
44
+ * **agents:** E158 review 6 — one reader for package runners; a real read confirms each GitLab setting ([b28ac7f](https://github.com/abdelrahmannasr/yadflow/commit/b28ac7f3975e94c6ab360bced158762e2e36107b))
45
+ * **agents:** E158 review 7 — npm -w in the guard; approvals confirmed on the PR/MR ([016b699](https://github.com/abdelrahmannasr/yadflow/commit/016b69923ef3251c48b47905b9764b1414b41112))
46
+ * **agents:** E158 review 8 — bun options before run; confirming an approval per mode ([7c22a89](https://github.com/abdelrahmannasr/yadflow/commit/7c22a89cbdfab7d42a52cfc212ab17b2f8274360))
47
+ * **agents:** E158 review 9 — bun options that take a value; the stories review branch ([073c48a](https://github.com/abdelrahmannasr/yadflow/commit/073c48a39c99707602e6106520b8bfdc8c4ab6e7))
48
+ * **agents:** E158b review 1 — never remove entries through a linked tool folder; cases 8 and 10 through yad itself; doc twins ([736992b](https://github.com/abdelrahmannasr/yadflow/commit/736992bf54b202746d388ec2086421734bd634ef))
49
+ * **agents:** E158b review 2 — a linked .cursor too; the code repo block names all four kinds ([569c682](https://github.com/abdelrahmannasr/yadflow/commit/569c68213b748df7a36bf341f017d8e640175cf6))
50
+ * **agents:** E159 review 1 — init's found repos need --connect; team size and AI tools checked before any write; doc twins ([6bba7c2](https://github.com/abdelrahmannasr/yadflow/commit/6bba7c2c2327bdbee29c32e64cf4fbb9b852ff5b))
51
+ * **agents:** E159 review 2 — an --add-repo that is not a git repo is refused before any write ([0a30394](https://github.com/abdelrahmannasr/yadflow/commit/0a3039471ed162ab1802e5ac3a65ded1adf7c90c))
52
+ * **agents:** E160a review 1 — no false ok: an unread account, another account's no-reply address, a GPG key matched by part of an email or unable to sign ([5f6591f](https://github.com/abdelrahmannasr/yadflow/commit/5f6591f27790ae45264e3588906125f9bd94adca))
53
+ * **agents:** E160a review 10 — a pin gpg does not have asks first about a typo; the test uses gpg's real failure ([8195108](https://github.com/abdelrahmannasr/yadflow/commit/8195108cebeefd7ef8fb380d5e546af744bf984b))
54
+ * **agents:** E160a review 11 — a named key gpg does not have asks about a typo first, with or without "!" ([ef9452b](https://github.com/abdelrahmannasr/yadflow/commit/ef9452b5c2ddf50cafe4e3dd7f2fb9c9165dfa23))
55
+ * **agents:** E160a review 12 — an email lookup keeps the usual steps (tested); the GPG steps name the "!" pin ([76fb607](https://github.com/abdelrahmannasr/yadflow/commit/76fb607ee3d9ced3bfc0495eee43bfec79da3690))
56
+ * **agents:** E160a review 2 — a GPG stub cannot sign here; only usable keys count; no login is unknown ([ef4e552](https://github.com/abdelrahmannasr/yadflow/commit/ef4e552e59be4ebe0cba77792bee1b9ccfbd100a))
57
+ * **agents:** E160a review 3 — an offline primary with a signing subkey is ok; only signing keys count; disabled, smartcard and stub keys named; no id is unknown ([019eac9](https://github.com/abdelrahmannasr/yadflow/commit/019eac946cdd7ca5b7b1b56aff933092e1fe1519))
58
+ * **agents:** E160a review 4 — a primary that cannot be used takes its subkeys with it; an orphan subkey is skipped; smartcard only when every signing part is on one ([a191d37](https://github.com/abdelrahmannasr/yadflow/commit/a191d37ef302f5b51c70563d1107021b6cbafbf6))
59
+ * **agents:** E160a review 5 — an expired or revoked copy on the account is a gap; any signing part on a card names the card ([17dbfcf](https://github.com/abdelrahmannasr/yadflow/commit/17dbfcf80ead0efa352da47d2ec9e3aa58586f70))
60
+ * **agents:** E160a review 6 — the part gpg signs with must be on the account and in force; an unreadable expiry is unknown ([3d2a915](https://github.com/abdelrahmannasr/yadflow/commit/3d2a915e30264eb0bfe3255bed7d7861fc8019bf))
61
+ * **agents:** E160a review 7 — a pinned part that cannot sign is a gap; a tie goes to the first subkey; the hint reads every id ([1dbe2da](https://github.com/abdelrahmannasr/yadflow/commit/1dbe2da78601813c0c3469d7ac098c163c0ff202))
62
+ * **agents:** E160a review 8 — the hint reads only the signing key; a fingerprint pin matches a long id; the card follows the part gpg signs with ([1bcc32d](https://github.com/abdelrahmannasr/yadflow/commit/1bcc32d0d458c179edc94fb2852eee759b504483))
63
+ * **agents:** E160a review 9 — tests for a short id two keys share; a pin gpg does not have says so ([ec854d5](https://github.com/abdelrahmannasr/yadflow/commit/ec854d54e1a379617b563ce40983b744432dda99))
64
+ * **agents:** E160b review 1 — GitLab's root pipeline must include yad's jobs; no ok from disagreeing or group-hidden answers; direct push; the gate bot's steps ([02edead](https://github.com/abdelrahmannasr/yadflow/commit/02edead8d58289dcdcf60264872e3b0bdf8d5a57))
65
+ * **agents:** E160b review 10 — flow style anywhere in the include is unknown; the unknown sentences read whole ([8dac984](https://github.com/abdelrahmannasr/yadflow/commit/8dac98493a905e6dfa2f48d27afc0b6420836556))
66
+ * **agents:** E160b review 11 — a list item whose dash stands alone is read from its next line ([91fc195](https://github.com/abdelrahmannasr/yadflow/commit/91fc1953152d24f5b613352554bd034e65877162))
67
+ * **agents:** E160b review 2 — no platform is never a quiet ok; the CI file GitLab reads; a full page or disagreeing rules are unknown ([4401ac0](https://github.com/abdelrahmannasr/yadflow/commit/4401ac0a65e0c01dc4f347586b760f1a4f5957b8))
68
+ * **agents:** E160b review 3 — an unread CI file setting is unknown; an include is a line of its own; a verified Product with no platform; admins on classic protection ([1b8290a](https://github.com/abdelrahmannasr/yadflow/commit/1b8290ad79d3eff7630a0bf571e2db748b5051e7))
69
+ * **agents:** E160b review 4 — only the CI file's top-level include counts; an include with its own rules is unknown ([4ec942f](https://github.com/abdelrahmannasr/yadflow/commit/4ec942f9d51709cc170c6c96dd28eda45304c794))
70
+ * **agents:** E160b review 5 — two top-level include keys are unknown; a list item needs a space after its dash; the fix line keeps the list's indent ([652c103](https://github.com/abdelrahmannasr/yadflow/commit/652c10373d9b4ab4134b0cca54342f1b0b67ebe0))
71
+ * **agents:** E160b review 6 — each fix line is pure YAML and the map form is named; a repo with no platform anywhere is not a files ok ([35afa07](https://github.com/abdelrahmannasr/yadflow/commit/35afa0709d9f85df27ec327825b8982434dbdde9))
72
+ * **agents:** E160b review 7 — an include that is not a list yet keeps its own kind; a plainer no-platform message ([b412f3b](https://github.com/abdelrahmannasr/yadflow/commit/b412f3b7620b656b003672af82bf53c8a0a7dc8d))
73
+ * **agents:** E160b review 8 — an include that is not a list yet moves exactly as written into the first list item ([7aaf84d](https://github.com/abdelrahmannasr/yadflow/commit/7aaf84dd666161b84f4797bc06bbd3a6c3677d89))
74
+ * **agents:** E160b review 9 — an include written on one line in [ ] or { } is unknown, with no rewrite step ([4b74817](https://github.com/abdelrahmannasr/yadflow/commit/4b7481719a0155f1caa1b6dd95ff2ea304e056b7))
75
+ * **agents:** E163 review 1 — ask right before a default-branch push (a request made earlier is not the yes); the acceptance run isolates the agents and checks the disk ([4c3ba9f](https://github.com/abdelrahmannasr/yadflow/commit/4c3ba9f893dac4f0bb574ad13140422799711bc2))
76
+ * **guide:** E157 review 1 — the review hand-off is reached, and a broken ledger is never a new epic ([66d6029](https://github.com/abdelrahmannasr/yadflow/commit/66d6029c3fc735882563ec72fce67f6afc718e29))
77
+ * **guide:** E157 review 1 — the rules' classes match what each command does ([0b026bd](https://github.com/abdelrahmannasr/yadflow/commit/0b026bd10638eed84915086ad5a858fb0361dd74)), closes [#356](https://github.com/abdelrahmannasr/yadflow/issues/356)
78
+ * **guide:** E157 review 2 — re-opened reviews, a skip CI would refuse, and an unknown epic ([f1eb97c](https://github.com/abdelrahmannasr/yadflow/commit/f1eb97c00d43eeffdc28e1ad63040988714b0a87))
79
+ * **guide:** E157 review 3 — the printed skip when CI owns the ledger, and one rule for blocked steps ([b86d485](https://github.com/abdelrahmannasr/yadflow/commit/b86d485cfa25885c55c3f4baf44eb646cfb22291))
80
+ * **guide:** E157 review 4 — commit --manual is the person's, and the fetch caution ([ec91eef](https://github.com/abdelrahmannasr/yadflow/commit/ec91eef7b6b072b2413758e38ca9e13e71544ce7))
81
+ * **guide:** E157 review 5 — a trust verdict is recorded on request, --force is asked, and a bare command takes its default ([3e33d03](https://github.com/abdelrahmannasr/yadflow/commit/3e33d0336dbea9c672ae2c5c9a2d90125888a18d))
82
+ * **guide:** E157 review 6 — --solo/--team on setup switch the mode, and a person's word is recorded on request ([371aacd](https://github.com/abdelrahmannasr/yadflow/commit/371aacdd045c1207b4c2c6103c6e4c31d038bdc2))
83
+ * **guide:** E157 review 7 — setup is the person's until E159, and a push is always asked ([c505f05](https://github.com/abdelrahmannasr/yadflow/commit/c505f053db9db798f9bde2de674bf26079ba4c97))
84
+ * **guide:** E157 review 8 — the halt reason from the build-state, and on-request kept under a push ([8bcfa12](https://github.com/abdelrahmannasr/yadflow/commit/8bcfa12b7b94ff13ccd87d34161fa4e431eae716))
85
+ * **guide:** E157 review 9 — reaches() never raises CI's or removed commands, and onRequest is tested ([87b7005](https://github.com/abdelrahmannasr/yadflow/commit/87b7005f6592b7359618ce65faef4e41fdc1a1e8))
86
+ * **lifecycle:** E157 review 1 — descriptions true with no platform and in plain words ([ba94afc](https://github.com/abdelrahmannasr/yadflow/commit/ba94afc1c5dfeab842098bc92addb2d2638240ce))
87
+ * **node:** E161 review 1 — the running-Node test fits the 18/20 legs; a failed move removes only what it made; folder modes kept; docs on Node 22 as the deploy ([b123c12](https://github.com/abdelrahmannasr/yadflow/commit/b123c12711450bbe1a5fab916464255ba731bdd3))
88
+ * **node:** E161 review 2 — a read-only folder is filled before its mode is set, and every removal in the move opens folders first ([7897118](https://github.com/abdelrahmannasr/yadflow/commit/789711890723afcb08d67a0327bbbedbe391f0ee))
89
+ * **release:** the release check passes on Node 24 — coverage prints TAP, and a missing summary never stops the check ([37980aa](https://github.com/abdelrahmannasr/yadflow/commit/37980aa10b33e1d30f2aeaf8945a201c48eaa07e))
90
+ * **update:** E157 update review 1 — every repo checked before it is written, and upkeep never loops ([1f3bd17](https://github.com/abdelrahmannasr/yadflow/commit/1f3bd17461e037f5ae10959145c022a41b40eb58))
91
+ * **update:** E157 update review 11 — the hook script and the entry that runs it land together ([ffaeec2](https://github.com/abdelrahmannasr/yadflow/commit/ffaeec2fa7cacf982bd8561f2464508c96dd7448))
92
+ * **update:** E157 update review 12 — no settings row when yad's entries are already committed ([87a504a](https://github.com/abdelrahmannasr/yadflow/commit/87a504adb57214ae8e341816958cc16b068a59ff))
93
+ * **update:** E157 update review 2 — all or nothing, and upkeep read per repo ([f555cb4](https://github.com/abdelrahmannasr/yadflow/commit/f555cb447e6f40d537a8359b8df98e8c35976846))
94
+ * **update:** E157 update review 3 — one list of repos for the run and the guide ([c01f6df](https://github.com/abdelrahmannasr/yadflow/commit/c01f6df28424facff4c3c5e6b3376af962e505ef))
95
+ * **update:** E157 update review 4 — no upkeep for an unwired repo, and no run while any repo would stop it ([86ad9b1](https://github.com/abdelrahmannasr/yadflow/commit/86ad9b1d4dec4284475802622632e0c3f6905de0))
96
+ * **update:** E157 update review 6 — a reason and hint for every held or half-done repo ([a69cbd7](https://github.com/abdelrahmannasr/yadflow/commit/a69cbd77cbcc5ff640aac4777c63096d797a0c6e))
97
+ * **update:** E157 update review 7 — never held forever, never a downgrade, a person's files kept ([92bdacb](https://github.com/abdelrahmannasr/yadflow/commit/92bdacb0036f2897293eda0811cef535ed6db72c))
98
+ * **update:** E157 update review 8 — no part lists, no crash on a reshaped skill, a true hint after a failed push ([7eba6c0](https://github.com/abdelrahmannasr/yadflow/commit/7eba6c084b546433c63bb8f4fed5a8421dce8386))
99
+ * **update:** E157 update review 9 — the kept count names only files back in place ([e95afa8](https://github.com/abdelrahmannasr/yadflow/commit/e95afa8427ade0712de6ab356e9a2307479722a5))
100
+
101
+
102
+ ### Features
103
+
104
+ * **agents:** E158 — the agent guard, pre-approved reads, and reports from the agent ([204b327](https://github.com/abdelrahmannasr/yadflow/commit/204b327331b7531a044f615784a745b65698a70d))
105
+ * **agents:** E158 — the yadflow rules block in AGENTS.md and CLAUDE.md ([0ab3563](https://github.com/abdelrahmannasr/yadflow/commit/0ab356372e4569305d74a46fa927791c83b381a7))
106
+ * **agents:** E158b — the agent guard and the read-only allow list in every connected code repo ([777d9c9](https://github.com/abdelrahmannasr/yadflow/commit/777d9c9071ff8bf92b7142cacaa08fba574820c3))
107
+ * **agents:** E159 — every setup question has a flag; a --json run missing one is refused before any write, with the questions ([9d42e0e](https://github.com/abdelrahmannasr/yadflow/commit/9d42e0e64da014c04da4c26b3bcc88adf5500d65))
108
+ * **agents:** E160a — yad signing check reads whether commits will be signed and Verified; the doctor line; closes [#432](https://github.com/abdelrahmannasr/yadflow/issues/432) ([eaf8647](https://github.com/abdelrahmannasr/yadflow/commit/eaf8647830d80f5cd640e6eec08f9b0a6205fd6b))
109
+ * **agents:** E160b — yad ci check reads whether yad's checks will hold a merge, for the Product and each repo ([50b44b1](https://github.com/abdelrahmannasr/yadflow/commit/50b44b1b473c7b612140a7eff1bab9332d6974d1))
110
+ * **guide:** E157 upkeep — the guide puts the update first when the install is behind ([68ada64](https://github.com/abdelrahmannasr/yadflow/commit/68ada6475ecc91410bf830947fb5a86384cd4e7d))
111
+ * **guide:** E157 yad guide — the step brief an AI agent reads before each step ([86bfff4](https://github.com/abdelrahmannasr/yadflow/commit/86bfff42083e393146596093f6cdc04a2b54b35f))
112
+ * **lifecycle:** E157 default 2 — what each step is for and who does it ([ad4f301](https://github.com/abdelrahmannasr/yadflow/commit/ad4f301702107e9a6b98911e12bf6dcafb325769))
113
+ * **node:** E161 — Node 22 is the supported line; 18 and 20 warn, and leave in yadflow 5 ([6bedc41](https://github.com/abdelrahmannasr/yadflow/commit/6bedc4112e0a1f191e2271aeef2600ebe0af7463))
114
+ * **skills:** E158 — the yad-guide skill ([144d963](https://github.com/abdelrahmannasr/yadflow/commit/144d9635477503b8393bc7ae2daba1392255a256))
115
+ * **update:** E157 yad update --open-pr — the update on its own branch, with a PR/MR per repo ([db4d8eb](https://github.com/abdelrahmannasr/yadflow/commit/db4d8eb4bbbba9ef6245bd697e073179331174d8))
116
+
1
117
  # [4.7.0](https://github.com/abdelrahmannasr/yadflow/compare/v4.6.0...v4.7.0) (2026-10-27)
2
118
 
3
119
 
package/README.md CHANGED
@@ -17,7 +17,7 @@ where it matters.
17
17
 
18
18
  - **The `yad` command-line tool.** It is written in Node and has no dependencies. It sets up a
19
19
  project, tells you the next action, runs reviews, and reads the project history.
20
- - **38 workflow skills.** A skill is a set of instructions that your AI assistant loads for one task,
20
+ - **39 workflow skills.** A skill is a set of instructions that your AI assistant loads for one task,
21
21
  such as "write the architecture". The skills run in Claude Code, Codex CLI, Cursor, Gemini CLI,
22
22
  GitHub Copilot, Zencoder and opencode.
23
23
  - **Plain files in git.** Every plan, decision, approval and link lives as a readable file in a
@@ -86,7 +86,8 @@ It is large, so open it full size.
86
86
 
87
87
  **You need:**
88
88
 
89
- - Node.js 18 or newer
89
+ - Node.js 22 or newer. Node 18 and 20 still run yadflow 4, with a warning: they are end of life and get
90
+ no security fixes, so yadflow 5 will need Node 22.
90
91
  - git
91
92
  - an AI assistant from the list above
92
93
 
@@ -138,6 +139,42 @@ stops. `yad next` then says the epic review is waiting. How the review passes de
138
139
  In solo mode no approval is needed. Merging your own pull request (then the same `yad gate sync`,
139
140
  unless CI runs it), or `yad gate advance` with no platform, is the human decision. After that, `yad next` names the next step.
140
141
 
142
+ **Or let your AI agent drive.** Open the folder in Claude Code or Codex and type:
143
+
144
+ ```text
145
+ Run yadflow here: run `npx -y yadflow@4 guide --json` and follow the yad-guide rules.
146
+ ```
147
+
148
+ The rules call the command `yad`. Install it once (`npm install -g yadflow`) so `yad …` works; without it
149
+ the agent runs `npx yadflow …`, which Claude Code asks you to allow each time.
150
+
151
+ In a folder with no Product yet, the agent asks you the setup questions in the chat: solo or team, new
152
+ or existing code, where the Product lives, which repos to connect, and the others. You can tell it to
153
+ take the defaults. It then runs `new`, `init` or `setup` with your answers. If it misses one, yad refuses
154
+ before writing anything and lists the questions still open. When you join a team, the agent runs
155
+ `yad join`; if you are not logged in to GitHub or GitLab, it gives you the login command to run yourself.
156
+
157
+ The agent reads `yad guide` before each step. It tells you what the step is for, whether you can skip
158
+ it, and who does it. Then it does its own part. The parts that are yours (approvals and merges, logins,
159
+ secrets, signing keys, repository settings) it hands to you with the exact command or steps, and it
160
+ checks they were done before it goes on. Setup writes the rules into `AGENTS.md` — the file AI coding
161
+ agents read at the start of a session — and into a `CLAUDE.md` that loads it, so every new session
162
+ starts with them.
163
+
164
+ In Claude Code and Cursor, in a session opened at the Product folder or at any connected code repo, a
165
+ hook also stops the agent. A
166
+ hook is a small script the agent's tool runs before each shell command. It refuses four kinds of
167
+ command when the agent runs them:
168
+
169
+ - a yad command only you may run (a gate approve, comment, advance or reopen, or `commit --manual`,
170
+ a commit past the local ledger check, which CI still checks);
171
+ - approving or merging a pull request (GitHub) or merge request (GitLab), a PR/MR, with `gh` or `glab`;
172
+ - skipping the git hooks (`git commit --no-verify`), which would pass the local ledger check;
173
+ - a force push, which overwrites commits already on the server.
174
+
175
+ The hook reads only the command line, so it catches mistakes, not tricks. In Codex, which has no hooks,
176
+ only the rules apply.
177
+
141
178
  **Other ways in:**
142
179
 
143
180
  | You have | Run | Then |
@@ -233,7 +270,8 @@ The record is worth trusting because people approve what goes into it.
233
270
  - **Checks on every change.** Each change must name its task (spec-link). A contract change must be
234
271
  declared and locked again (contract-check). Commits must carry a signature that GitHub or GitLab
235
272
  marks as verified (verified-commits; it is skipped, with a warning, when there is no platform).
236
- To make these checks block a merge, see [branch protection](docs/branch-protection.md). Every
273
+ To make these checks block a merge, see [branch protection](docs/branch-protection.md); `yad ci check`
274
+ reads whether they do. Every
237
275
  check's rules, exemptions and failure messages are listed in [CI gates](docs/GATES.md).
238
276
  - **Pair review.** The `yad-pair-review` skill walks you through a change one risky part at a time.
239
277
  It asks you questions and keeps a private log of how your reviewing improves. It never blocks a
@@ -257,6 +295,7 @@ The record is worth trusting because people approve what goes into it.
257
295
  - the Shape and Build steps with review gates
258
296
  - linked changes and `yad thread`
259
297
  - `yad history`, `yad next` and `yad usage`
298
+ - `yad guide`, the step brief an AI coding agent reads before each step — what the step is for, whether it can be skipped, who does it, the skills that fit, what the agent runs, and what only the person can do
260
299
  - `yad status --brief`, where the work stands in about 20 lines — this checkout's task, each open epic's next action, your open PRs/MRs and what is owed — for picking up after a break or an AI context reset
261
300
  - `yad standup`, a daily status for each team member — what they did since the last working day, what they are on now, and what is waiting — rebuilt live from git, the ledgers and the platform, facts only
262
301
  - `yad detect`, which lists the skills, agents, MCP servers and plugins installed for each AI agent
@@ -284,7 +323,7 @@ The record is worth trusting because people approve what goes into it.
284
323
  - [working together: capture, claims, owners, fold](docs/CLI.md#working-together-capture-claims-owners-and-fold)
285
324
  - [troubleshooting and error codes](docs/CLI.md#troubleshooting-yad-doctor--error-codes)
286
325
  - [every CI gate: rules, exemptions and failures](docs/GATES.md)
287
- - [all 38 skills](docs/SKILLS.md)
326
+ - [all 39 skills](docs/SKILLS.md)
288
327
  - [the by-hand walkthrough](docs/WALKTHROUGH.md)
289
328
  - **Upgrade:** [staying up to date](docs/CLI.md#staying-up-to-date) ·
290
329
  [upgrading to 4.0](docs/migrations/upgrading-to-4.md) ·
package/bin/commands.mjs CHANGED
@@ -19,6 +19,7 @@ export { gateApprove, gateComment, gateAdvance } from '../cli/gate-local.mjs';
19
19
  export { isValidEpicId, productDriftError, seedableProfiles } from '../cli/epic-state.mjs';
20
20
  export { runEpicNew, runFoundationNew, runFoundationStatus } from '../cli/epic.mjs';
21
21
  export { runStatus } from '../cli/status.mjs';
22
+ export { runGuide } from '../cli/guide.mjs';
22
23
  export { runSkillBind, runSkillList, runSkillRecommend, runSkillUnbind } from '../cli/skill.mjs';
23
24
  export { runCommit } from '../cli/commit.mjs';
24
25
  export { runOpenPr } from '../cli/openpr.mjs';
@@ -40,10 +41,13 @@ export { runHistory, HISTORY_FLAGS } from '../cli/history.mjs';
40
41
  export { runRepo } from '../cli/repo.mjs';
41
42
  export { runRiskMap } from '../cli/riskmap-command.mjs';
42
43
  export { runCodeowners } from '../cli/codeowners-command.mjs';
44
+ export { runStory } from '../cli/story-frames.mjs';
43
45
  export { runDocs } from '../cli/docs.mjs';
44
46
  export { runDetect } from '../cli/detect.mjs';
45
47
  export { runToolboxAdd, runToolboxCheck, runToolboxList, runToolboxRemove } from '../cli/toolbox.mjs';
46
48
  export { runDoctor } from '../cli/doctor.mjs';
49
+ export { runSigningCheck } from '../cli/signing.mjs';
50
+ export { runCiCheck } from '../cli/ci-check.mjs';
47
51
  export { runMigrate, warnIfProjectAhead } from '../cli/migrate.mjs';
48
52
  export { runNext } from '../cli/next.mjs';
49
53
  export { runSkip, runDefer, runUnblock, runLaneSkip } from '../cli/skip.mjs';
@@ -51,6 +55,6 @@ export { runDial, runKill } from '../cli/dial.mjs';
51
55
  export { runMode } from '../cli/mode.mjs';
52
56
  export { syncStatuses } from '../cli/artifact-status.mjs';
53
57
  export { runThread, runReconcile } from '../cli/thread.mjs';
54
- export { runReport } from '../cli/report.mjs';
58
+ export { runReport, REPORT_KINDS } from '../cli/report.mjs';
55
59
  export { runUsage } from '../cli/usage.mjs';
56
60
  export { maybeNotifyUpdate } from '../cli/update-notice.mjs';