yadflow 4.9.0 → 4.11.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 (155) hide show
  1. package/CHANGELOG.md +184 -0
  2. package/README.md +15 -5
  3. package/bin/commands.mjs +11 -1
  4. package/bin/yad.mjs +203 -14
  5. package/cli/agent-guard-worker.mjs +13 -0
  6. package/cli/agent-guard.mjs +1797 -73
  7. package/cli/agent-rules.mjs +64 -5
  8. package/cli/argv-flags.mjs +2 -2
  9. package/cli/brain/vendor/LICENSE-graphology-library.txt +21 -0
  10. package/cli/brain/vendor/LICENSE-graphology.txt +21 -0
  11. package/cli/brain/vendor/LICENSE-sigma.txt +12 -0
  12. package/cli/brain/vendor/graphology-library.min.js +2 -0
  13. package/cli/brain/vendor/graphology.umd.min.js +2 -0
  14. package/cli/brain/vendor/sigma.min.js +1369 -0
  15. package/cli/brain/view/app.js +382 -0
  16. package/cli/brain/view/index.html +63 -0
  17. package/cli/brain/view/live.css +228 -0
  18. package/cli/brain/view/live.html +110 -0
  19. package/cli/brain/view/live.js +884 -0
  20. package/cli/brain/view/style.css +141 -0
  21. package/cli/brain-about.mjs +206 -0
  22. package/cli/brain-activity.mjs +285 -0
  23. package/cli/brain-skills.mjs +118 -0
  24. package/cli/brain-vendor.mjs +71 -0
  25. package/cli/brain-view.mjs +344 -0
  26. package/cli/brain.mjs +810 -0
  27. package/cli/ci-check.mjs +48 -4
  28. package/cli/codeowners-command.mjs +72 -6
  29. package/cli/commit.mjs +17 -3
  30. package/cli/docs.mjs +2 -0
  31. package/cli/doctor.mjs +151 -25
  32. package/cli/epic-state.mjs +186 -4
  33. package/cli/epic.mjs +26 -10
  34. package/cli/errors.mjs +2 -1
  35. package/cli/find-product.mjs +69 -15
  36. package/cli/fold.mjs +31 -6
  37. package/cli/foundation-publish.mjs +256 -0
  38. package/cli/gate.mjs +29 -3
  39. package/cli/git-read.mjs +38 -0
  40. package/cli/guard-stream.mjs +409 -0
  41. package/cli/guide.mjs +3 -1
  42. package/cli/hook.mjs +102 -9
  43. package/cli/issue-links.mjs +61 -0
  44. package/cli/issues-act.mjs +371 -0
  45. package/cli/issues-write.mjs +441 -0
  46. package/cli/issues.mjs +513 -0
  47. package/cli/lib.mjs +37 -2
  48. package/cli/lifecycle.mjs +7 -0
  49. package/cli/local-page.mjs +138 -0
  50. package/cli/machine.mjs +1 -1
  51. package/cli/manifest.mjs +59 -3
  52. package/cli/map/view/app.js +712 -0
  53. package/cli/map/view/index.html +50 -0
  54. package/cli/map/view/style.css +142 -0
  55. package/cli/map-view.mjs +186 -0
  56. package/cli/map.mjs +637 -0
  57. package/cli/members.mjs +9 -15
  58. package/cli/next.mjs +1 -1
  59. package/cli/openpr.mjs +26 -6
  60. package/cli/plan.mjs +127 -0
  61. package/cli/platform.mjs +159 -4
  62. package/cli/product-index.mjs +1 -1
  63. package/cli/protection.mjs +53 -3
  64. package/cli/reconcile.mjs +9 -3
  65. package/cli/report.mjs +9 -3
  66. package/cli/reports-dir.mjs +391 -0
  67. package/cli/reports.mjs +65 -0
  68. package/cli/run-checks.mjs +15 -4
  69. package/cli/scan.mjs +314 -0
  70. package/cli/setup.mjs +42 -8
  71. package/cli/standup.mjs +120 -78
  72. package/cli/status.mjs +6 -5
  73. package/cli/story-frames.mjs +17 -6
  74. package/cli/test-agents-file.mjs +985 -12
  75. package/cli/test-brain-activity.mjs +753 -0
  76. package/cli/test-brain-view.mjs +381 -0
  77. package/cli/test-brain.mjs +795 -0
  78. package/cli/test-build.mjs +25 -0
  79. package/cli/test-ci-check.mjs +469 -10
  80. package/cli/test-guide.mjs +218 -0
  81. package/cli/test-machine.mjs +59 -0
  82. package/cli/test-map.mjs +615 -0
  83. package/cli/test-node.mjs +15 -0
  84. package/cli/test-reports.mjs +382 -0
  85. package/cli/test-run-checks.mjs +21 -0
  86. package/cli/test-setup-agent.mjs +14 -0
  87. package/cli/test-story-frames.mjs +74 -4
  88. package/cli/test-worktree.mjs +24 -3
  89. package/cli/toolbox-connect.mjs +259 -0
  90. package/cli/toolbox.mjs +187 -12
  91. package/cli/update-commit.mjs +101 -9
  92. package/cli/usage.mjs +8 -4
  93. package/package.json +12 -4
  94. package/skills/sdlc/config.yaml +1 -1
  95. package/skills/sdlc/module-help.csv +3 -1
  96. package/skills/yad-analysis/SKILL.md +4 -0
  97. package/skills/yad-architecture/SKILL.md +22 -4
  98. package/skills/yad-backfill/SKILL.md +4 -0
  99. package/skills/yad-change/SKILL.md +7 -1
  100. package/skills/yad-change/references/triage.md +2 -0
  101. package/skills/yad-checks/SKILL.md +15 -7
  102. package/skills/yad-checks/references/check-gates.md +70 -35
  103. package/skills/yad-checks/templates/checks/build-test-lint.sh +7 -0
  104. package/skills/yad-checks/templates/checks/install-deps.sh +6 -0
  105. package/skills/yad-checks/templates/checks/member-check.mjs +3 -2
  106. package/skills/yad-checks/templates/checks/package-manager.sh +42 -0
  107. package/skills/yad-checks/templates/checks/risk-map-check.sh +2 -2
  108. package/skills/yad-checks/templates/checks/verified-commits.sh +3 -3
  109. package/skills/yad-checks/templates/github/yad-checks.yml +358 -69
  110. package/skills/yad-checks/templates/github/yad-pr-text.yml +118 -0
  111. package/skills/yad-checks/templates/github/yad-product-checks.yml +130 -54
  112. package/skills/yad-checks/templates/github/yad-product-pr-text.yml +131 -0
  113. package/skills/yad-checks/templates/github/yad-update-guard.yml +2 -1
  114. package/skills/yad-checks/templates/github/yad-verified-commits.yml +49 -3
  115. package/skills/yad-checks/templates/gitlab/yad-checks.gitlab-ci.yml +80 -20
  116. package/skills/yad-checks/templates/gitlab/yad-product-checks.gitlab-ci.yml +59 -9
  117. package/skills/yad-checks/templates/gitlab/yad-update-guard.gitlab-ci.yml +1 -0
  118. package/skills/yad-checks/templates/gitlab/yad-verified-commits.gitlab-ci.yml +49 -1
  119. package/skills/yad-checks/templates/hooks/agent-guard.mjs +44 -10
  120. package/skills/yad-checks/templates/hooks/ledger-guard-cursor.mjs +12 -6
  121. package/skills/yad-checks/templates/hooks/yad-activity.mjs +238 -0
  122. package/skills/yad-commit/SKILL.md +3 -1
  123. package/skills/yad-connect-design/SKILL.md +42 -10
  124. package/skills/yad-connect-design/references/design-context.md +35 -5
  125. package/skills/yad-connect-design/references/design-registry.md +3 -3
  126. package/skills/yad-connect-learning/SKILL.md +12 -2
  127. package/skills/yad-connect-repos/SKILL.md +18 -0
  128. package/skills/yad-connect-testing/SKILL.md +22 -5
  129. package/skills/yad-connect-testing/references/testing-context.md +1 -1
  130. package/skills/yad-discovery/SKILL.md +11 -0
  131. package/skills/yad-discovery/references/foundation-schema.md +11 -0
  132. package/skills/yad-docs/templates/app/package-lock.json +18 -10
  133. package/skills/yad-docs/templates/app/package.json +6 -1
  134. package/skills/yad-epic/SKILL.md +7 -0
  135. package/skills/yad-epic/references/state-schema.md +50 -1
  136. package/skills/yad-guide/SKILL.md +8 -4
  137. package/skills/yad-implement/SKILL.md +117 -4
  138. package/skills/yad-implement/references/implement-conventions.md +2 -1
  139. package/skills/yad-issues/SKILL.md +54 -0
  140. package/skills/yad-learn/SKILL.md +4 -0
  141. package/skills/yad-open-pr/SKILL.md +6 -0
  142. package/skills/yad-pr-template/SKILL.md +2 -1
  143. package/skills/yad-pr-template/templates/checks/pr-template.sh +8 -4
  144. package/skills/yad-pr-template/templates/checks/pr-title.sh +42 -6
  145. package/skills/yad-product-bridge/references/bridge.md +28 -0
  146. package/skills/yad-product-bridge/templates/github/yad-gate-sync.yml +25 -11
  147. package/skills/yad-product-bridge/templates/gitlab/yad-gate-sync.gitlab-ci.yml +38 -14
  148. package/skills/yad-run/SKILL.md +5 -0
  149. package/skills/yad-scan/SKILL.md +51 -0
  150. package/skills/yad-spec/SKILL.md +32 -2
  151. package/skills/yad-stories/SKILL.md +22 -4
  152. package/skills/yad-stories/references/story-schema.md +1 -1
  153. package/skills/yad-test-cases/SKILL.md +18 -2
  154. package/skills/yad-ui/SKILL.md +43 -8
  155. package/skills/yad-checks/templates/gitlab/.gitlab-ci.yml +0 -49
package/CHANGELOG.md CHANGED
@@ -1,3 +1,187 @@
1
+ # [4.11.0](https://github.com/abdelrahmannasr/yadflow/compare/v4.10.0...v4.11.0) (2026-11-14)
2
+
3
+
4
+ ### Bug Fixes
5
+
6
+ * **agent-guard:** a reading stopped by the deadline says it took too long ([#542](https://github.com/abdelrahmannasr/yadflow/issues/542)) ([aac2c5f](https://github.com/abdelrahmannasr/yadflow/commit/aac2c5fd520f772c1920253f226281df1cd8f647)), closes [#492](https://github.com/abdelrahmannasr/yadflow/issues/492) [#535](https://github.com/abdelrahmannasr/yadflow/issues/535) [#535](https://github.com/abdelrahmannasr/yadflow/issues/535)
7
+ * **agent-guard:** judge text that reaches a shell: process substitutions, known $(…) output, files written then run ([#498](https://github.com/abdelrahmannasr/yadflow/issues/498), rows 1, 2, 8) ([#519](https://github.com/abdelrahmannasr/yadflow/issues/519)) ([37d9ea3](https://github.com/abdelrahmannasr/yadflow/commit/37d9ea3c6ebd504ff59542e547adf0193c1c6545)), closes [#518](https://github.com/abdelrahmannasr/yadflow/issues/518) [#518](https://github.com/abdelrahmannasr/yadflow/issues/518)
8
+ * **agent-guard:** read a line by each shell's $(…) end rule, and bash's brace rule ([#498](https://github.com/abdelrahmannasr/yadflow/issues/498), rows 3–7) ([#517](https://github.com/abdelrahmannasr/yadflow/issues/517)) ([69b2c5b](https://github.com/abdelrahmannasr/yadflow/commit/69b2c5bf2d3dd54e904e6aa1a70b8f134ad71d08)), closes [#516](https://github.com/abdelrahmannasr/yadflow/issues/516)
9
+ * **agent-guard:** read text printed with no newline as run on into what is printed next ([#518](https://github.com/abdelrahmannasr/yadflow/issues/518)) ([fa93d0e](https://github.com/abdelrahmannasr/yadflow/commit/fa93d0ef431b6d357deba0f2ed8828e470b7fba8))
10
+ * **agent-guard:** read the rarer places bash 3.2 and zsh end a $(…) ([#516](https://github.com/abdelrahmannasr/yadflow/issues/516)) ([35fef40](https://github.com/abdelrahmannasr/yadflow/commit/35fef408947d6445baef19263735e031997d935d))
11
+ * **agent-guard:** read the word after >& and <& as bash 3.2 and zsh do, and zsh's >! ([#518](https://github.com/abdelrahmannasr/yadflow/issues/518)) ([f399957](https://github.com/abdelrahmannasr/yadflow/commit/f399957258ab6d521322c7f4f7c53d24f37cf230))
12
+ * **agent-guard:** review 1 — a group record never changes main's write list ([#532](https://github.com/abdelrahmannasr/yadflow/issues/532)) ([12f940b](https://github.com/abdelrahmannasr/yadflow/commit/12f940b52ff02a2d6a7d196a22e96a1771ebe89e))
13
+ * **agent-guard:** review 1 — main's case-word bound kept; the rarer readings run once per text ([#516](https://github.com/abdelrahmannasr/yadflow/issues/516)) ([4a92879](https://github.com/abdelrahmannasr/yadflow/commit/4a92879f5b7156a3ee4fa12d8d3c80b159c55810))
14
+ * **agent-guard:** review 1 — readings with no newline are kept apart from those paired by place; the mark passes through tee, cat and filters ([#518](https://github.com/abdelrahmannasr/yadflow/issues/518)) ([cd899ee](https://github.com/abdelrahmannasr/yadflow/commit/cd899ee9c9cd83676d5c22fb01419fe6729511f5))
15
+ * **agent-guard:** review 1 — the output pass reads the twins of each gap ([#532](https://github.com/abdelrahmannasr/yadflow/issues/532)) ([b7d98a3](https://github.com/abdelrahmannasr/yadflow/commit/b7d98a35dc2b0561dfac801c6aebbfddf613c5ea))
16
+ * **agent-guard:** review 1 — the output pass refuses no line main allows for its own reasons ([#532](https://github.com/abdelrahmannasr/yadflow/issues/532)) ([db7de77](https://github.com/abdelrahmannasr/yadflow/commit/db7de77f8f68461579d4ae5c23828414a88acb04))
17
+ * **agent-guard:** review 1 — the shells' redirect readings are their own dimension, crossed with every $(…) end rule ([#518](https://github.com/abdelrahmannasr/yadflow/issues/518)) ([de0af0a](https://github.com/abdelrahmannasr/yadflow/commit/de0af0abc4685e71f21e6e1413182cf7febd9650))
18
+ * **agent-guard:** review 2 — a `#` at the case-word bound ends the loop; the rarer readings keep the `)#` reading ([#516](https://github.com/abdelrahmannasr/yadflow/issues/516)) ([f8af846](https://github.com/abdelrahmannasr/yadflow/commit/f8af84692de032c626bd0b27d53ad0acde1fe432))
19
+ * **agent-guard:** review 2 — a word's spellings kept apart stay apart through substituted, printedOf and here-strings ([#518](https://github.com/abdelrahmannasr/yadflow/issues/518)) ([9f3fe37](https://github.com/abdelrahmannasr/yadflow/commit/9f3fe37116e0eac287a7983480b7d3d15df667b3))
20
+ * **agent-guard:** review 2 — close the holes the round-1 output fixes opened ([#532](https://github.com/abdelrahmannasr/yadflow/issues/532)) ([21c9b52](https://github.com/abdelrahmannasr/yadflow/commit/21c9b52c711680966bb37dce2062859d390968a7))
21
+ * **agent-guard:** review 2 — what a $(…) prints is read by each shell's redirect reading; a nested $(…) keeps its reading's shell ([#518](https://github.com/abdelrahmannasr/yadflow/issues/518)) ([779adad](https://github.com/abdelrahmannasr/yadflow/commit/779adad8e198c65f1163b61499262e21da91f954))
22
+ * **agent-guard:** review 3 — a shell passes its stdin on, missed groups keep their output, nests are bounded ([#532](https://github.com/abdelrahmannasr/yadflow/issues/532)) ([e671f95](https://github.com/abdelrahmannasr/yadflow/commit/e671f958e19341539d2fa252b0b60f618b2e66b2))
23
+ * **agent-guard:** review 3 — the rarer readings keep the `|#` reading too; a never-ending heredoc's text is kept once ([#516](https://github.com/abdelrahmannasr/yadflow/issues/516)) ([d381d3f](https://github.com/abdelrahmannasr/yadflow/commit/d381d3f43ba7b4819a7a576d0f930cd483ccb097))
24
+ * **agent-guard:** review 4 — closed groups are read once, and a one-word `if` in a case may be a block ([#532](https://github.com/abdelrahmannasr/yadflow/issues/532)) ([17e5b81](https://github.com/abdelrahmannasr/yadflow/commit/17e5b81f2049dc557eed6f40afb76cf19a1ce30a))
25
+ * **agent-guard:** review 5 — a fold reads back to the group a block overlaps; a pattern stands only straight inside a case ([#532](https://github.com/abdelrahmannasr/yadflow/issues/532)) ([414e147](https://github.com/abdelrahmannasr/yadflow/commit/414e1478fa131a766d709e045bc72a3cb3afa5a4))
26
+ * **brain:** CI — the test runner passes git's ENOBUFS; no 'hub' in a comment ([7c47234](https://github.com/abdelrahmannasr/yadflow/commit/7c47234e8e3d86e97fe564caf72775c9b1cfb81b))
27
+ * **brain:** CodeQL — cut the served script tags by markers, not an HTML pattern (E177) ([e09137f](https://github.com/abdelrahmannasr/yadflow/commit/e09137f871d946839531c35261ff2e9d830078d2))
28
+ * **brain:** E179 review 1 — --repo limits the file; the skills read a moved repo as behind ([efb9cb5](https://github.com/abdelrahmannasr/yadflow/commit/efb9cb51cd1bfca9cbea001f6220fb9fb1dc7a8a))
29
+ * **brain:** E179 review 2 — the stories question has a place; the light spec is judged again ([8842784](https://github.com/abdelrahmannasr/yadflow/commit/8842784880c400edf741eae0c1bc0f7868452233))
30
+ * **brain:** E179 review 3 — an added file that ends the light spec is asked about first ([f1b6605](https://github.com/abdelrahmannasr/yadflow/commit/f1b6605a92f6ad207c57389bd1dfe9cb9f0647e4))
31
+ * **brain:** E179 review 4 — a contract file ends the light spec; a high-risk one is a choice ([b200a09](https://github.com/abdelrahmannasr/yadflow/commit/b200a09a586bb54f7b536af60cc23d9e35966316)), closes [hi#risk](https://github.com/hi/issues/risk) [hi#risk](https://github.com/hi/issues/risk)
32
+ * **brain:** E179 review 5 — a contract file never leaves a light spec on record ([0af058b](https://github.com/abdelrahmannasr/yadflow/commit/0af058b9d4a4fd1245414be109cb1a1a43c8b655)), closes [hi#risk](https://github.com/hi/issues/risk)
33
+ * **brain:** labels follow the page theme, light on the dark one (E177 view) ([44f000f](https://github.com/abdelrahmannasr/yadflow/commit/44f000f51c703a33572984ab3d6acef06ee89ca9))
34
+ * **brain:** review — a held node keeps its heat; at most 60 neighbours named ([36bd6e6](https://github.com/abdelrahmannasr/yadflow/commit/36bd6e6b86981b6c661338b1ed1deed5f682b744))
35
+ * **brain:** review — a theme switch keeps the camera, labels stay put on hover ([b06b0cb](https://github.com/abdelrahmannasr/yadflow/commit/b06b0cb4264fdef144e07f79d684a65549bc2055))
36
+ * **brain:** review — only the left button drags a node ([5fbff4a](https://github.com/abdelrahmannasr/yadflow/commit/5fbff4a426a69e75b5d69a2ff44ba5fc9b89f6ac))
37
+ * **brain:** review 1 — filters, the All-the-code toggle, Windows --open and the --html key placeholder (E177) ([0e3b61a](https://github.com/abdelrahmannasr/yadflow/commit/0e3b61ab2a9769b1a47540ea4af187eb8054442c))
38
+ * **brain:** review 1 — removal only of yad's copy and never through a link, real paths, the reader, per-page models (E178) ([7c0d419](https://github.com/abdelrahmannasr/yadflow/commit/7c0d41998ec28b9aeca4899105dba54f5e4cfc1c))
39
+ * **brain:** review 2 — --json says when no opener was found; the vendored libraries keep their spelling (E177) ([d7b7011](https://github.com/abdelrahmannasr/yadflow/commit/d7b701178c032d910a8025aabdac23b4e72eabd3))
40
+ * **brain:** review 2 — the task follows edits, no unrelated parent repo, the attach order (E178) ([13c7923](https://github.com/abdelrahmannasr/yadflow/commit/13c7923f6684a721ac286523fd30c07cbd277e28))
41
+ * **brain:** review 3 — big folders, the doctor's question, a shared file's task, one span for every panel (E178) ([3a18ea5](https://github.com/abdelrahmannasr/yadflow/commit/3a18ea553419a0519d38c363b3936414c951a5ac))
42
+ * **brain:** review 4 — no doubles at a rotation during a page's connect; a shared file stays tentative (E178) ([9800485](https://github.com/abdelrahmannasr/yadflow/commit/9800485b16d33f765ef7dfc50acaf397a6bebb21))
43
+ * **brain:** review 5 — trust file numbers only when they can tell files apart; read the current log first (E178) ([cb3eb5d](https://github.com/abdelrahmannasr/yadflow/commit/cb3eb5d003167f136b40249246186e4662e727a9))
44
+ * **docs:** force minimatch 11 under typescript-eslint in the docs template ([88901fa](https://github.com/abdelrahmannasr/yadflow/commit/88901fab630e5c46708e4838f7a0a5cda9970613)), closes [#199](https://github.com/abdelrahmannasr/yadflow/issues/199)
45
+ * **docs:** raise the docs shell version to 0.0.5 for the zod bump ([876a2a5](https://github.com/abdelrahmannasr/yadflow/commit/876a2a516020bf64358dded5cd06a8b4bb15f074))
46
+ * **foundation:** a changed Foundation can be reviewed again, in every setup ([cbf2c69](https://github.com/abdelrahmannasr/yadflow/commit/cbf2c69f1796d051f5d299cce987476a24bb8442)), closes [#418](https://github.com/abdelrahmannasr/yadflow/issues/418)
47
+ * **foundation:** review round 1 — a failed CI read fails, all readers agree, platforms number apart ([ea51d29](https://github.com/abdelrahmannasr/yadflow/commit/ea51d29d1996298f535b41e1249330b3c3fa6022))
48
+ * **foundation:** review round 2 — fail only for a merge still due, name the step's own branch ([ea170a2](https://github.com/abdelrahmannasr/yadflow/commit/ea170a2f232c7217756bad86e4b5498b01a3a4fc))
49
+ * **gates:** a PR of issue-links files alone may come from any branch ([#512](https://github.com/abdelrahmannasr/yadflow/issues/512)) ([#520](https://github.com/abdelrahmannasr/yadflow/issues/520)) ([21b66fb](https://github.com/abdelrahmannasr/yadflow/commit/21b66fb233e667238a242775a21c51ffa1201a96)), closes [#426](https://github.com/abdelrahmannasr/yadflow/issues/426)
50
+ * **gates:** a Unity project skips build/test/lint with a note ([#496](https://github.com/abdelrahmannasr/yadflow/issues/496)) ([#511](https://github.com/abdelrahmannasr/yadflow/issues/511)) ([08c686a](https://github.com/abdelrahmannasr/yadflow/commit/08c686a499636b7d36b740a4a631b0c947d035bf))
51
+ * **gates:** the genesis lineage header yad-change adds keeps an epic's approvals live ([#499](https://github.com/abdelrahmannasr/yadflow/issues/499)) ([#524](https://github.com/abdelrahmannasr/yadflow/issues/524)) ([a3863f3](https://github.com/abdelrahmannasr/yadflow/commit/a3863f3941049ec93be9bb5f9c2c31548547ff27))
52
+ * **git:** a push through glab's login helper shows git's real error, not glab's warning ([#526](https://github.com/abdelrahmannasr/yadflow/issues/526)) ([edb1117](https://github.com/abdelrahmannasr/yadflow/commit/edb1117b8bff3fb1f737d107221b64c8cdee5dab)), closes [#509](https://github.com/abdelrahmannasr/yadflow/issues/509)
53
+ * **git:** review 1 — every copy of glab's warning is dropped, not only the first ([#526](https://github.com/abdelrahmannasr/yadflow/issues/526)) ([35a6d44](https://github.com/abdelrahmannasr/yadflow/commit/35a6d449c4bcac816f21effe9f308082d656beca))
54
+ * **map:** E181 review 1 — --anonymous masks names joined by dots, underscores or nothing; the waited-on person and release authors are on the people list ([93dd003](https://github.com/abdelrahmannasr/yadflow/commit/93dd0038dd03fbf6d4a9f82876b6d1483725fe3b))
55
+ * **map:** E181 review 10 — --anonymous never masks the words of the address placeholder; the raw values are masked as before ([5db9324](https://github.com/abdelrahmannasr/yadflow/commit/5db9324fdae7d89533d6f95ae32e96b1e1e4882b))
56
+ * **map:** E181 review 10 — an address's names are the union of the word-by-word cut and the unwrapped cut, so no change masks less; names keep combining marks, ' and +; only a space after an @ joins it ([9931101](https://github.com/abdelrahmannasr/yadflow/commit/9931101f2215ca662023fa76c856511b6588c9c9))
57
+ * **map:** E181 review 2 — a port names its task by any separator and by number, a story-only port counts for every task; the --html path caveat is back in the agent rules ([2350133](https://github.com/abdelrahmannasr/yadflow/commit/235013334c9af1fcb7f96a05fd0dc3070aa0bace))
58
+ * **map:** E181 review 3 — a story-only port has no task id anywhere after the story id; the watch test restores fs.watch whatever happens ([3e65c64](https://github.com/abdelrahmannasr/yadflow/commit/3e65c64801b7c53933cd1cbfa33a22ddbda34870))
59
+ * **map:** E181 review 4 — a story-only port is judged from the first place the story id appears ([ddfa496](https://github.com/abdelrahmannasr/yadflow/commit/ddfa4968d91783c3d5b5fe54085558ef0eff53e2))
60
+ * **map:** E181 review 6 — any value with an @, even a leading one, is never shown; the test proves no part of the address leaks and every script tag is checked ([69a56bb](https://github.com/abdelrahmannasr/yadflow/commit/69a56bbd22dbfc5890e87ca11eaafb15c3440051))
61
+ * **map:** E181 review 7 — --anonymous no longer masks the words of the address placeholder or an address's domain; it masks the part before the @, and a handle without its @ ([3d35f02](https://github.com/abdelrahmannasr/yadflow/commit/3d35f02158e40f1eb9cf295c7eb38a27414c5de3))
62
+ * **map:** E181 review 7 — a branch name or member login holding an address never shows it, named or anonymous ([8e0e414](https://github.com/abdelrahmannasr/yadflow/commit/8e0e414824d9dae252d1cb9950ca08e078fd2d47))
63
+ * **map:** E181 review 8 — --anonymous cuts each address word on its own, so a name beside an address stays masked, and every part between two @ signs is masked ([cb38509](https://github.com/abdelrahmannasr/yadflow/commit/cb38509d657d2b26e532c2aa2a17d57275f20018))
64
+ * **map:** E181 review 8 — masked address parts keep a fingerprint so ids stay apart; the epic is read before masking; the checkout branch and links with an address are masked ([0d81c04](https://github.com/abdelrahmannasr/yadflow/commit/0d81c04edf5ecdd508b1afe56ab203d681aa12ed))
65
+ * **map:** E181 review 9 — an anonymous map numbers masked addresses instead of keeping their hash, and masks the checkout branch ([4896a59](https://github.com/abdelrahmannasr/yadflow/commit/4896a5964eb92280f3fa3959704dc46353ef9c89))
66
+ * **map:** E181 review 9 — one rule for every way a value holds an address: spaces round the @ closed, any non-name character splits, the words beside an address are masked joined too, and no empty piece is a name ([1017dc5](https://github.com/abdelrahmannasr/yadflow/commit/1017dc5312aeef850bf837dbb3566424dffcf56f))
67
+ * **open-pr:** a git worktree of a registered repo is that repo, worked in its own folder ([#515](https://github.com/abdelrahmannasr/yadflow/issues/515)) ([#521](https://github.com/abdelrahmannasr/yadflow/issues/521)) ([df85950](https://github.com/abdelrahmannasr/yadflow/commit/df8595062af4100b29df264931934bc42107b6e5)), closes [#115](https://github.com/abdelrahmannasr/yadflow/issues/115)
68
+ * **platform:** a Product git_url that names only a host is no repo — reads use origin, doctor says so, setup repairs it ([#513](https://github.com/abdelrahmannasr/yadflow/issues/513)) ([#523](https://github.com/abdelrahmannasr/yadflow/issues/523)) ([581a709](https://github.com/abdelrahmannasr/yadflow/commit/581a709031683f7e570e69c4cd35c6b4e30b53e1))
69
+ * **platform:** glab's two-config warning no longer hides why a glab call failed ([#509](https://github.com/abdelrahmannasr/yadflow/issues/509)) ([#522](https://github.com/abdelrahmannasr/yadflow/issues/522)) ([8ff6079](https://github.com/abdelrahmannasr/yadflow/commit/8ff60798ce0d566b1957d649db14a0bb1ae1c135))
70
+ * read shell-bound output in the agent guard ([#532](https://github.com/abdelrahmannasr/yadflow/issues/532)) ([f1d5693](https://github.com/abdelrahmannasr/yadflow/commit/f1d56934e46ef573c86cf0b3d0a42e98cbcbaa15))
71
+ * **reports:** E180 review 1 — prune never leaves the folder through a link, says why before deleting, and two runs never lose a report ([ffb66e0](https://github.com/abdelrahmannasr/yadflow/commit/ffb66e0e1a304b5af56311b00e5ef23d747c6efb))
72
+ * **reports:** E180 review 2 — a lock is taken by one run and released only by its owner; prune --missing drops gone entries without deleting ([e00a6b3](https://github.com/abdelrahmannasr/yadflow/commit/e00a6b35d1fa4b919475f2f01ec6a3bd055a5850))
73
+ * **reports:** E180 review 3 — the catalog lock appears whole, a takeover checks what it moved, and an unreadable lock ends at the deadline ([2d1537c](https://github.com/abdelrahmannasr/yadflow/commit/2d1537cdd366f1bffa741395dbd3610c0a4c4b2a))
74
+ * **reports:** E180 review 4 — a disk with no hard links locks with a plain create, and no temp lock file is left on a failed write ([1cc2a05](https://github.com/abdelrahmannasr/yadflow/commit/1cc2a052b774ebd5db803b6acabe2321d009472c))
75
+ * **reports:** E180 review 5 — a fresh lock moved by a takeover is put back on a disk with no hard links too ([9e89177](https://github.com/abdelrahmannasr/yadflow/commit/9e891778e004817ad60ffc3ec5183b3855e74bb9))
76
+ * **toolbox:** review 1 — pin the AI Game Developer plugin too, and test the reach order (E175) ([7040cab](https://github.com/abdelrahmannasr/yadflow/commit/7040cab9b86d9587f72dca59b477e526bd856559))
77
+ * **toolbox:** review 4 — stdio transport, compile by error code, no hidden Unity (E175) ([4bb8784](https://github.com/abdelrahmannasr/yadflow/commit/4bb8784f8234d7a0cb953f1a905710372e8a9c8e))
78
+ * **update:** a git add an ignore rule refused names the rule, not a lock ([#508](https://github.com/abdelrahmannasr/yadflow/issues/508)) ([#525](https://github.com/abdelrahmannasr/yadflow/issues/525)) ([8a50f63](https://github.com/abdelrahmannasr/yadflow/commit/8a50f632a055c38fba57bb8e37385ae35e749beb))
79
+
80
+
81
+ ### Features
82
+
83
+ * **brain:** agents consult the brain while planning and building (E179) ([6bc19e0](https://github.com/abdelrahmannasr/yadflow/commit/6bc19e09f757372be00e8236c367630777148239))
84
+ * **brain:** drag a node on the live page, its links lit (E178) ([a0d9e3d](https://github.com/abdelrahmannasr/yadflow/commit/a0d9e3d5d44c4437ac353ee2c47aae69636fd87e))
85
+ * **brain:** press and hold a node to drag it (E177 view) ([966bf67](https://github.com/abdelrahmannasr/yadflow/commit/966bf67baf74d27ed927edb189702767bf4f2d62))
86
+ * **brain:** the live activity record — a hook that notes each agent tool call (E178) ([3c79ee6](https://github.com/abdelrahmannasr/yadflow/commit/3c79ee6fb8d1494f1bcb79027b7f1b2af15b2537))
87
+ * **brain:** vendor sigma.js, graphology and graphology-library for the brain viewer (E177) ([6e16dce](https://github.com/abdelrahmannasr/yadflow/commit/6e16dce0516186c8c2679232c2f2daf941ce3a8e))
88
+ * **brain:** yad brain — one knowledge graph of the code and the work (E176) ([#541](https://github.com/abdelrahmannasr/yadflow/issues/541)) ([15024d0](https://github.com/abdelrahmannasr/yadflow/commit/15024d0431793a8d036cca90385cd63dac672761))
89
+ * **brain:** yad brain view --live — the Observatory (E178) ([8d2974f](https://github.com/abdelrahmannasr/yadflow/commit/8d2974f33d2b4b3d27ba42067a17acb39e460457))
90
+ * **brain:** yad brain view — the brain drawn in a browser, served locally or as one file (E177) ([6fa514c](https://github.com/abdelrahmannasr/yadflow/commit/6fa514c67b390c6722f3cda581e9de637cf0f33c))
91
+ * **issues:** filter by, show and set any label, not just priority and type ([#514](https://github.com/abdelrahmannasr/yadflow/issues/514)) ([#527](https://github.com/abdelrahmannasr/yadflow/issues/527)) ([5a0ebea](https://github.com/abdelrahmannasr/yadflow/commit/5a0ebea13ce5b1a6366339b52070076d612a23a2))
92
+ * **map:** E181 — yad map, the road to Production in the prototype's design, with who owns, built, reviewed and approved each part ([3aa9d70](https://github.com/abdelrahmannasr/yadflow/commit/3aa9d705ec7e38e9826be84c5bd20c66ce647bfd))
93
+ * **reports:** E180 — every report is saved on this machine, beside the Product ([32edfe6](https://github.com/abdelrahmannasr/yadflow/commit/32edfe677f9863941e6230b9fb5a0407db245f38))
94
+ * the approved roadmap becomes work items in the Product repo (E174) ([#510](https://github.com/abdelrahmannasr/yadflow/issues/510)) ([e0bd082](https://github.com/abdelrahmannasr/yadflow/commit/e0bd082ccb67d00208b66644a6a4eb8e59ce8d0d))
95
+ * **toolbox:** add Unity MCP (AI Game Developer) beside MCP for Unity ([c604f6b](https://github.com/abdelrahmannasr/yadflow/commit/c604f6ba48f24cd28d5f2df3e9006183d966a615))
96
+ * **toolbox:** AI Game Developer is the default Unity tool; the agent helps install and connect it (E175) ([1a93f96](https://github.com/abdelrahmannasr/yadflow/commit/1a93f96b3e47ee6c32d6fe9af95b4a11c2619099))
97
+
98
+ # [4.10.0](https://github.com/abdelrahmannasr/yadflow/compare/v4.9.0...v4.10.0) (2026-11-10)
99
+
100
+
101
+ ### Bug Fixes
102
+
103
+ * **agent-guard:** judge the CR-dropping reading at every depth, not only the raw line ([#353](https://github.com/abdelrahmannasr/yadflow/issues/353)) ([5a6d912](https://github.com/abdelrahmannasr/yadflow/commit/5a6d912b5ad9ac9772c7c6c6e904820c6d267ad5))
104
+ * **agent-guard:** keep reading a CRLF heredoc's end line as before, and never pre-approve more secret-bearing paths ([#353](https://github.com/abdelrahmannasr/yadflow/issues/353)) ([d8a5a09](https://github.com/abdelrahmannasr/yadflow/commit/d8a5a09a81b068752d14b61e4d76b74ca65eab77))
105
+ * **agent-guard:** never pre-approve what the shell expands, shortened git options, -R, jq -f or gh --cache ([#353](https://github.com/abdelrahmannasr/yadflow/issues/353)) ([1d784ac](https://github.com/abdelrahmannasr/yadflow/commit/1d784ac903e47dddf74c360364b89f0b27b208f6))
106
+ * **agent-guard:** no comment exception, and only space, tab and newline break words ([#353](https://github.com/abdelrahmannasr/yadflow/issues/353)) ([c5869ef](https://github.com/abdelrahmannasr/yadflow/commit/c5869ef7ed3398289fa25c642a6df7a1ee861f2c))
107
+ * **agent-guard:** read \\ + CR + LF and a CR on a heredoc's end line as bash and zsh do ([#353](https://github.com/abdelrahmannasr/yadflow/issues/353)) ([20391d0](https://github.com/abdelrahmannasr/yadflow/commit/20391d0b845392e573378a711aba61cc751528df))
108
+ * **agent-guard:** refuse a \\-CRLF line under either reading; decode an API path before testing its parts ([#353](https://github.com/abdelrahmannasr/yadflow/issues/353)) ([561a102](https://github.com/abdelrahmannasr/yadflow/commit/561a10222d3a09686a5e4905f6f8dd105a2c1996))
109
+ * **agent-guard:** unquoted text is held to an allow list of characters; git diff paths inside the project ([#353](https://github.com/abdelrahmannasr/yadflow/issues/353)) ([9fec042](https://github.com/abdelrahmannasr/yadflow/commit/9fec042a45f84dcf777f6798db11beeeee8f52e1))
110
+ * **ci-check:** review 1 — the merge queue is read through GraphQL, an unreported merge-train setting is not known, and the new rows are listed when nothing can be read ([#433](https://github.com/abdelrahmannasr/yadflow/issues/433)) ([4812250](https://github.com/abdelrahmannasr/yadflow/commit/4812250f4b82ceb8a0ce513e6213ee6bcda75acd))
111
+ * **ci-check:** review 2 — the merge-queue query sends the names as plain strings ([#433](https://github.com/abdelrahmannasr/yadflow/issues/433)) ([e599f47](https://github.com/abdelrahmannasr/yadflow/commit/e599f47e53c1534fc8eca620a5626b78cf9be00e))
112
+ * **ci-check:** yad ci check warns when the merge queue or merge trains are on, and reports the other merge settings ([#433](https://github.com/abdelrahmannasr/yadflow/issues/433)) ([237da2c](https://github.com/abdelrahmannasr/yadflow/commit/237da2c54167a6dc90e22d78235b8f72abea634f))
113
+ * **ci:** an edit of the PR text never re-runs the gate jobs, so a skipped gate cannot turn a failed one green ([#425](https://github.com/abdelrahmannasr/yadflow/issues/425)) ([207c6a1](https://github.com/abdelrahmannasr/yadflow/commit/207c6a1a515848255e20c83bc8a6874b46bc1aa8))
114
+ * **ci:** every CI job yad installs, and every job here, stops after a set time ([#424](https://github.com/abdelrahmannasr/yadflow/issues/424)) ([b6d45c7](https://github.com/abdelrahmannasr/yadflow/commit/b6d45c76b5c3b6768d1823e63f0c2ffa37ef5bd5)), closes [#420](https://github.com/abdelrahmannasr/yadflow/issues/420)
115
+ * **ci:** every gate job runs the base branch's checks/, never the PR's own, and keeps no token in the checkout ([#426](https://github.com/abdelrahmannasr/yadflow/issues/426)) ([b4c92e6](https://github.com/abdelrahmannasr/yadflow/commit/b4c92e6b6b2ac93c1da548a12b79141bf7fd170f))
116
+ * **ci:** GitLab gate-sync checks glab and jq against a pinned SHA-256 before installing them ([#431](https://github.com/abdelrahmannasr/yadflow/issues/431)) ([c521f13](https://github.com/abdelrahmannasr/yadflow/commit/c521f1302a4be6e4e4e70aa2f3bfdef017317ea6)), closes [#327](https://github.com/abdelrahmannasr/yadflow/issues/327)
117
+ * **ci:** review 1 — every CI file needs an owner, a code owner guards the merge not the run, GitLab keeps the host's before_script ([#426](https://github.com/abdelrahmannasr/yadflow/issues/426)) ([2838ccb](https://github.com/abdelrahmannasr/yadflow/commit/2838ccb6dc744e30567b9afccdbc9f6d0cbbd00b))
118
+ * **ci:** review 1 — tests read the Product's diff lines from yad-product-pr-text.yml; the doctor hint and the gate reference follow the move ([#425](https://github.com/abdelrahmannasr/yadflow/issues/425)) ([f072be7](https://github.com/abdelrahmannasr/yadflow/commit/f072be7452d238e9654cb5b4ad3cc2b277eab748))
119
+ * **ci:** review 1 — the chain comment says the install is skipped, not run; the test refuses any download not saved with -o ([#431](https://github.com/abdelrahmannasr/yadflow/issues/431)) ([8077636](https://github.com/abdelrahmannasr/yadflow/commit/8077636f5c29b52d297871a55a892ecf3c0331af))
120
+ * **ci:** review 1 — the docs say what yad update does to an edited limit; the test reads this repo's workflows and odd job names ([#424](https://github.com/abdelrahmannasr/yadflow/issues/424)) ([6b46910](https://github.com/abdelrahmannasr/yadflow/commit/6b46910c6c63097b2ae0ea5e201acd5bb215a8c3))
121
+ * **ci:** review 1 — the PR-text group names the commit, and the docs say what a cancel can block ([#428](https://github.com/abdelrahmannasr/yadflow/issues/428)) ([49e0cd6](https://github.com/abdelrahmannasr/yadflow/commit/49e0cd65f645990dde5c55ee7f8943a81e3e8622))
122
+ * **ci:** review 2 — control characters swapped the same in any locale; the gate-file warning only where yad's gates are installed ([#426](https://github.com/abdelrahmannasr/yadflow/issues/426)) ([0446802](https://github.com/abdelrahmannasr/yadflow/commit/0446802e34832d99873faefc1c99b7ceaad2932b))
123
+ * **ci:** review 2 — the docs name which runs each file cancels and how to add the GitLab rule safely; a job's own interruptible: false fails the test ([#428](https://github.com/abdelrahmannasr/yadflow/issues/428)) ([b229fd7](https://github.com/abdelrahmannasr/yadflow/commit/b229fd7e27f8f2d8eb73a1c7fa9dfe7dd535db83))
124
+ * **ci:** the CI templates pin the same action versions as the repo — checkout v7.0.1, setup-node v7.1.0, cache v6.1.0 ([#429](https://github.com/abdelrahmannasr/yadflow/issues/429)) ([96cbfe9](https://github.com/abdelrahmannasr/yadflow/commit/96cbfe9688efb1fd062cf007f97c5ca9df8b038d))
125
+ * **ci:** the PR gate files cancel their older run; GitLab's merge request jobs are interruptible ([#428](https://github.com/abdelrahmannasr/yadflow/issues/428)) ([e9e255d](https://github.com/abdelrahmannasr/yadflow/commit/e9e255d1f14eb742d716ceadd19ac9778d4a6203))
126
+ * **doctor:** review 1 — the rows say what was recorded, the hint covers a signed-out or closed tool, and the connect-tool rule names doctor (E165 follow-up) ([03d433c](https://github.com/abdelrahmannasr/yadflow/commit/03d433c2e76ca3d4b79055bb5c93b39df597ad1a))
127
+ * **doctor:** review 2 — the hint asks that the tool can be reached, not that it has an app to open, so it fits a CLI tool too (E165 follow-up) ([3a45a8b](https://github.com/abdelrahmannasr/yadflow/commit/3a45a8be21cbb5ff740e2c9e80d045e3e7064ae8))
128
+ * **doctor:** the design, testing and learning refresh hints name the tool and its connect command (E165 follow-up) ([051fd19](https://github.com/abdelrahmannasr/yadflow/commit/051fd192e45bb8997cc5c607c435f946582766c1))
129
+ * **frames:** review 1 — with no provider, OpenPencil's check tries the CLI, then the MCP, as its stop text says (E164) ([6888ebd](https://github.com/abdelrahmannasr/yadflow/commit/6888ebd1b2e576fc8a0de0833b21363d101a5043))
130
+ * **frames:** review 2 — with no provider, the check falls back to the MCP whenever the CLI does not find the frame (E164) ([786ac04](https://github.com/abdelrahmannasr/yadflow/commit/786ac04feb57f695e4339fc14b1dc2d2d3d52521))
131
+ * **gate:** review 1 — the UI design's fingerprint skips junk, links and nested repos, reads LFS pointers, and drops the doc-only pass (E164) ([40d7f81](https://github.com/abdelrahmannasr/yadflow/commit/40d7f817c4d4b641d0790268d2be576dd0ae5d6b))
132
+ * **gate:** review 2 — only the exact LFS pointer format counts, the junk list is named, and a nested repo is never folded (E164) ([5f27c3f](https://github.com/abdelrahmannasr/yadflow/commit/5f27c3fbb19b2421c51aa93eba229376e16d8c6f))
133
+ * **gate:** review 3 — a git-ignored design file is not counted on disk, and a committed submodule is never folded (E164) ([c06c221](https://github.com/abdelrahmannasr/yadflow/commit/c06c221d298337e09a7f7b9c8891838053285373))
134
+ * **gate:** review 4 — the ignore check finds git from the folder, never runs on a commit's scratch copy, and fold sees an uninitialised submodule (E164) ([994a5b8](https://github.com/abdelrahmannasr/yadflow/commit/994a5b86a35e9c644f678ff92f76eef059efb789))
135
+ * **gates:** pr-title ignores a GitLab draft marker in the title ([#451](https://github.com/abdelrahmannasr/yadflow/issues/451)) ([6a34f4b](https://github.com/abdelrahmannasr/yadflow/commit/6a34f4b257f2ee2e1137c0e309b86e39900cc8b2)), closes [#426](https://github.com/abdelrahmannasr/yadflow/issues/426)
136
+ * **gates:** review 1 — match the draft mark by pattern, not tr; docs say a GitLab title edit starts no pipeline, and why the mark is ignored ([#451](https://github.com/abdelrahmannasr/yadflow/issues/451)) ([17ff8e8](https://github.com/abdelrahmannasr/yadflow/commit/17ff8e81530683659504b04039a3885f8b31db5b))
137
+ * **hooks:** read the payload even when the pipe is not ready, and exit only after the verdict is written (macOS) ([5cc3087](https://github.com/abdelrahmannasr/yadflow/commit/5cc30879935528985e260c5c28ee6f85a19563b0))
138
+ * **hooks:** review 1 — name the real cause: asking process.stdin.isTTY makes stdin non-blocking; the last write-then-exit goes (macOS) ([82f00eb](https://github.com/abdelrahmannasr/yadflow/commit/82f00ebbef130edbeb884edbedde52237ee9445a)), closes [#459](https://github.com/abdelrahmannasr/yadflow/issues/459) [#460](https://github.com/abdelrahmannasr/yadflow/issues/460)
139
+ * **open-pr:** review 1 — only other tasks' commits count, so a teammate's branch is never named; main merged in is still found; a real --via auto test ([#450](https://github.com/abdelrahmannasr/yadflow/issues/450)) ([e1f38fd](https://github.com/abdelrahmannasr/yadflow/commit/e1f38fd0166b205503237b495cb2b6a3d1d64a38))
140
+ * **open-pr:** review 2 — a branch holding this task's own commit is a teammate's copy, never named, even when cut from develop ([#450](https://github.com/abdelrahmannasr/yadflow/issues/450)) ([32d76d1](https://github.com/abdelrahmannasr/yadflow/commit/32d76d16a99239adb69eac884088866d2668ea2d))
141
+ * **open-pr:** review 3 — name every branch that could be the fork, most likely first, and let the person pick ([#450](https://github.com/abdelrahmannasr/yadflow/issues/450)) ([664a0ab](https://github.com/abdelrahmannasr/yadflow/commit/664a0ab31265ff9a37e9830545b2e25bfce5f422)), closes [#350](https://github.com/abdelrahmannasr/yadflow/issues/350)
142
+ * **open-pr:** review 4 — list the possible bases in the form each command's --base takes, so one can be copied as it is ([#450](https://github.com/abdelrahmannasr/yadflow/issues/450)) ([cc94fff](https://github.com/abdelrahmannasr/yadflow/commit/cc94fffb2c03d6f05bcdacf0168a0206ebd2e188))
143
+ * **open-pr:** stop before pushing when the branch was cut from another branch and no base was chosen ([#450](https://github.com/abdelrahmannasr/yadflow/issues/450)) ([eba292a](https://github.com/abdelrahmannasr/yadflow/commit/eba292a8052c3e369ddcb3249a6452f48acde474))
144
+ * **run-checks:** warn once when the branch was cut from another branch and no base was chosen ([#450](https://github.com/abdelrahmannasr/yadflow/issues/450)) ([7c7c07b](https://github.com/abdelrahmannasr/yadflow/commit/7c7c07bdec5640b7d1df2b8835ed8dac389e5fb7))
145
+ * **skills:** review 2 — the first OpenPencil file comes from import, the hand commit has a gate-ready message, and the MCP-only rules name the CLI exception (E164) ([0688503](https://github.com/abdelrahmannasr/yadflow/commit/06885036f31b35c85564a9a1edbc3bcf7ab462cd))
146
+ * **toolbox:** review 1 — --verify only after the yes, and --replace to change the team's tool; MCP servers for the user account, cmd /c on Windows (E165) ([92091ae](https://github.com/abdelrahmannasr/yadflow/commit/92091aefdf39e338d48c28fc3a9f29890a886944))
147
+ * **toolbox:** review 1 — offer only a missing tool, refresh the connection after a connect, no hosted recipe for Figma's desktop server (E165) ([af28e07](https://github.com/abdelrahmannasr/yadflow/commit/af28e07bdc83e6ce49b180309bef67253a8aa741))
148
+ * **toolbox:** review 1 — OpenPencil's MCP needs its desktop app; yad-ui writes through the CLI first, into the epic's design/ folder (E164) ([8c64c3f](https://github.com/abdelrahmannasr/yadflow/commit/8c64c3f55f001eb73b53e76ef10a691bdec693ab))
149
+ * **toolbox:** review 1 — the node-ID script reads frames the skills' way, runs npm without a shell, and cleans up on every exit (E164) ([9fdcdd7](https://github.com/abdelrahmannasr/yadflow/commit/9fdcdd7a2e5977b042887befc68ce18ab3a51417))
150
+ * **toolbox:** review 2 — a server just added is seen after the agent restarts: say so, never record it unavailable (E165) ([338bdb3](https://github.com/abdelrahmannasr/yadflow/commit/338bdb333e8f194a8955acbc7d21d39e1f4f806f))
151
+ * **toolbox:** review 2 — the node-ID script takes only npm-cli.js, says "stopped" on Ctrl-C, and words what it withholds exactly (E164) ([ecdd606](https://github.com/abdelrahmannasr/yadflow/commit/ecdd6068d87fbc2539edb79fa2c66fbd2d0ecbc0))
152
+ * **toolbox:** review 2 — the person block's verify carries --replace too, and a tool name in other letters is not a replacement (E165) ([c5e4d80](https://github.com/abdelrahmannasr/yadflow/commit/c5e4d80abecb5d22cf4f44d85387ade68ea9ca1e))
153
+ * **toolbox:** review 3 — check the tool is reachable before the refresh; the CLI path and the connect skills too (E165) ([173241d](https://github.com/abdelrahmannasr/yadflow/commit/173241dc852807eaea7403dc8cdd8d4af524203d))
154
+ * **toolbox:** review 3 — the node-ID script says "stopped" on Ctrl-C during an openpencil run too (E164) ([8ec6d59](https://github.com/abdelrahmannasr/yadflow/commit/8ec6d59d75add1c316af5ad8bb20cc2fcb87de49))
155
+ * **toolbox:** review 4 — the restart branch writes nothing and skips Step 2; after a restart, refresh first (E165) ([1d88aa0](https://github.com/abdelrahmannasr/yadflow/commit/1d88aa072da0399e7c25e35add9a71a3d281c51d))
156
+ * **toolbox:** review 5 — the connect skills record what they find when the tool is reachable; the report fits the restart case (E165) ([adf1841](https://github.com/abdelrahmannasr/yadflow/commit/adf1841c484161f82b6a79746412c3d88242d34f))
157
+ * **toolbox:** review 6 — every refresh after a connect names the same tool, so it never checks the default one (E165) ([671fe0e](https://github.com/abdelrahmannasr/yadflow/commit/671fe0e99f555be427dc3fb8e585796ede47d564))
158
+ * **toolbox:** the node-ID script hands OpenPencil fixed code, nothing pasted in — CodeQL js/bad-code-sanitization (E164) ([f1f1ab0](https://github.com/abdelrahmannasr/yadflow/commit/f1f1ab00cc6ae7761c245b5db77cd742c0fe3803))
159
+
160
+
161
+ ### Features
162
+
163
+ * **agent-guard:** pre-approve read-only command lines — API GETs, git reads, jq, unchanged read gates ([#353](https://github.com/abdelrahmannasr/yadflow/issues/353)) ([a41880f](https://github.com/abdelrahmannasr/yadflow/commit/a41880f66086db3faf0e1bc609201f44ff8c5ca8))
164
+ * **agent:** the connect-tool rule — ask once with the command's own question, run only its agent steps, hand over the rest, then verify (E165) ([093213a](https://github.com/abdelrahmannasr/yadflow/commit/093213a4d9f397c41ee09157491aa59c013e161d))
165
+ * **agent:** the connect-tool rule names where an offer comes from — a toolbox finding's or a preflight's `connect`, or a skill; one tool, one question (E165) ([cdee8f5](https://github.com/abdelrahmannasr/yadflow/commit/cdee8f5ab5b882c7252b24df42ebe7a26bda8a13))
166
+ * an issue or work item seeds and links an epic (E170) ([#502](https://github.com/abdelrahmannasr/yadflow/issues/502)) ([fd169a1](https://github.com/abdelrahmannasr/yadflow/commit/fd169a18a77955936b4f92d71acb42fd754692a9)), closes [#501](https://github.com/abdelrahmannasr/yadflow/issues/501)
167
+ * **codeowners:** warn when checks/ and yad's CI files have no code owner whose review can be required ([#426](https://github.com/abdelrahmannasr/yadflow/issues/426)) ([e83699d](https://github.com/abdelrahmannasr/yadflow/commit/e83699d9857407fd864b17cec5f057cbc9fd4890))
168
+ * every implementation is scanned, and the findings are filed (E172) ([#504](https://github.com/abdelrahmannasr/yadflow/issues/504)) ([7bd2bfe](https://github.com/abdelrahmannasr/yadflow/commit/7bd2bfe27417237f84578acd6f981b472adb0513))
169
+ * **frames:** the design preflight checks OpenPencil — its CLI needs no app and no sign-in (E164) ([e226b7c](https://github.com/abdelrahmannasr/yadflow/commit/e226b7cfcc973c3cfa03ac76b7d22fc9907fa8dd)), closes [#358](https://github.com/abdelrahmannasr/yadflow/issues/358)
170
+ * **frames:** the design preflight names the connect command — for a tool not on this machine at all (E165) ([54f595a](https://github.com/abdelrahmannasr/yadflow/commit/54f595aa2594f2f219f6f167a87718b488c23ee6))
171
+ * **gate:** the UI review covers the epic's design/ folder — fold commits it, a change revokes (E164) ([8cd9f3a](https://github.com/abdelrahmannasr/yadflow/commit/8cd9f3a671094b8ccc617c46b4604ff6789bec66))
172
+ * linked items follow their epics, standup lists them, agents know them (E171) ([#503](https://github.com/abdelrahmannasr/yadflow/issues/503)) ([2428727](https://github.com/abdelrahmannasr/yadflow/commit/24287278c4d964975d96c8300717b2e17bf7f21b))
173
+ * read GitHub issues and GitLab work items, with an HTML report (E169) ([#501](https://github.com/abdelrahmannasr/yadflow/issues/501)) ([6849016](https://github.com/abdelrahmannasr/yadflow/commit/6849016594387356e3c44d43decac9dd59d0eaad))
174
+ * **setup:** show what the agent guard pre-approves, and give it to agents in yad guide ([#353](https://github.com/abdelrahmannasr/yadflow/issues/353)) ([81d41f9](https://github.com/abdelrahmannasr/yadflow/commit/81d41f9a1a33f87b91af9190a0fece469d6c229a))
175
+ * the agent acts on issues and work items when an engineer asks (E173) ([#506](https://github.com/abdelrahmannasr/yadflow/issues/506)) ([2324502](https://github.com/abdelrahmannasr/yadflow/commit/2324502bebfb4da8358428c5a7e4a40759dfa048))
176
+ * **toolbox:** OpenPencil as a third design tool — vetted, MCP and CLI pinned to 0.16.0 (E164) ([9a3453a](https://github.com/abdelrahmannasr/yadflow/commit/9a3453a37f0448ac290e882c55980d4b75108235)), closes [#358](https://github.com/abdelrahmannasr/yadflow/issues/358)
177
+ * **toolbox:** setup, check, update and join offer to connect a tool — `connect` on each finding (E165) ([9756639](https://github.com/abdelrahmannasr/yadflow/commit/97566399d653e0cd4f27fc410bc21742da93f80a))
178
+ * **toolbox:** yad toolbox connect — what the agent may run to connect a tool, after one yes; --verify records the team's choice (E165) ([bd6fd10](https://github.com/abdelrahmannasr/yadflow/commit/bd6fd10793569b4de66f69dc752d6af6edb5a0a9))
179
+
180
+
181
+ ### Performance Improvements
182
+
183
+ * **fold:** review 5 — the index's gitlinks are read once per fold, not once per design file; a literal-pathspec setting cannot hide them (E164) ([ce2a894](https://github.com/abdelrahmannasr/yadflow/commit/ce2a894a9a4e3f8b1b8cdf5d78b6035d987b095a))
184
+
1
185
  # [4.9.0](https://github.com/abdelrahmannasr/yadflow/compare/v4.8.0...v4.9.0) (2026-11-04)
2
186
 
3
187
 
package/README.md CHANGED
@@ -3,6 +3,8 @@
3
3
  [![npm version](https://img.shields.io/npm/v/yadflow?logo=npm)](https://www.npmjs.com/package/yadflow)
4
4
  [![CI](https://github.com/abdelrahmannasr/yadflow/actions/workflows/ci.yml/badge.svg)](https://github.com/abdelrahmannasr/yadflow/actions/workflows/ci.yml)
5
5
  [![node](https://img.shields.io/node/v/yadflow?logo=node.js)](https://github.com/abdelrahmannasr/yadflow/blob/main/package.json)
6
+ [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/abdelrahmannasr/yadflow/badge)](https://scorecard.dev/viewer/?uri=github.com/abdelrahmannasr/yadflow)
7
+ [![license: MIT](https://img.shields.io/npm/l/yadflow)](https://github.com/abdelrahmannasr/yadflow/blob/main/LICENSE)
6
8
 
7
9
  Coordinate work, automate repetitive delivery tasks, and keep the decisions behind your software.
8
10
  Yadflow connects plans, architecture, code and reviews in a versioned project record. Your team and
@@ -17,7 +19,7 @@ where it matters.
17
19
 
18
20
  - **The `yad` command-line tool.** It is written in Node and has no dependencies. It sets up a
19
21
  project, tells you the next action, runs reviews, and reads the project history.
20
- - **39 workflow skills.** A skill is a set of instructions that your AI assistant loads for one task,
22
+ - **41 workflow skills.** A skill is a set of instructions that your AI assistant loads for one task,
21
23
  such as "write the architecture". The skills run in Claude Code, Codex CLI, Cursor, Gemini CLI,
22
24
  GitHub Copilot, Zencoder and opencode.
23
25
  - **Plain files in git.** Every plan, decision, approval and link lives as a readable file in a
@@ -295,11 +297,15 @@ The record is worth trusting because people approve what goes into it.
295
297
  - the Shape and Build steps with review gates
296
298
  - linked changes and `yad thread`
297
299
  - `yad history`, `yad next` and `yad usage`
300
+ - `yad brain`, the project brain: one knowledge graph of your code and your work items (which story touches which file, which code handles which contract surface), built on your machine with [Graphify](https://github.com/Graphify-Labs/graphify) and never committed; `yad brain query` searches it, and `yad brain view` draws it in your browser (a locked-down local page, or one offline file); `yad brain view --live` lets you watch an agent work through it, against the plan; `yad brain file` and `yad brain story` answer what an agent asks before it plans or edits (who declares a file, what uses it), and the planning and building skills ask them when a brain is built
298
301
  - `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
299
302
  - `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
300
303
  - `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
304
+ - `yad issues`, the team's GitHub issues and GitLab issues and tasks, with priority, type, status and assignee, as a list or an HTML page you can sort and filter. Items link to epics, update from epic status, and appear in `yad standup`. Ask the agent to open, assign, label, edit, comment on, close or reopen an item, and it does. Once the Foundation review passes, `yad foundation publish` turns each roadmap feature into an item, with a milestone per phase. `yad-run` and `yad-implement` also scan each implementation and file security findings, technical debt and suggestions there
305
+ - `yad map`, the road to Production as one moving picture — epics, stories, tasks and branches flowing through Development into Production — with who owns, built, reviewed and approved each part (roles, never counts; `--anonymous` for sharing)
306
+ - `yad reports`, the reports you saved (standup, usage, issues, the brain view page, the progress map), kept on your machine only in `<product>--reports/` beside the Product, each named by date, kind, scope and state, and marked fresh or stale
301
307
  - `yad detect`, which lists the skills, agents, MCP servers and plugins installed for each AI agent
302
- - `yad toolbox list`, which shows the external tools yadflow can use, which ones you have, and what happens without each; `yad toolbox add` / `remove` record the tools your team uses, and `yad toolbox check` lists the ones not ready on your machine (`yad setup`, `check`, `update` and `join` print the same list, and never install anything); each skill that uses a tool reads the same answer and says what it does without it
308
+ - `yad toolbox list`, which shows the external tools yadflow can use, which ones you have, and what happens without each; `yad toolbox add` / `remove` record the tools your team uses, and `yad toolbox check` lists the ones not ready on your machine (`yad setup`, `check`, `update` and `join` print the same list, and never install anything without asking: your agent can connect a tool after one yes, with `yad toolbox connect`); each skill that uses a tool reads the same answer and says what it does without it
303
309
  - `yad skill recommend`, which lists hand-picked skills from the recommended skill collections for each step, why each fits, and the command to bind one; it binds nothing, and every pick was checked against its source
304
310
  - draft saving, claims and owners
305
311
  - the CI checks
@@ -315,15 +321,19 @@ The record is worth trusting because people approve what goes into it.
315
321
 
316
322
  ## Documentation
317
323
 
318
- - **Learn:** the [guided tutorial](https://abdelrahmannasr.github.io/yadflow/tutorial/) (setup to
319
- your first shipped feature) · the [team guide](TEAM-GUIDE.md) · the
324
+ - **Learn:** [yadflow, explained](docs/YADFLOW-EXPLAINED.md) (every part in plain words, for technical
325
+ and non-technical readers) · the [guided tutorial](https://abdelrahmannasr.github.io/yadflow/tutorial/)
326
+ (setup to your first shipped feature) · the [team guide](TEAM-GUIDE.md) · the
320
327
  [terminology and workflow report](https://abdelrahmannasr.github.io/yadflow/)
328
+ - **Talk:** [GitHub Discussions](https://github.com/abdelrahmannasr/yadflow/discussions) — ask
329
+ questions in Q&A, suggest ideas, and share what you build. Bugs go to
330
+ [Issues](https://github.com/abdelrahmannasr/yadflow/issues/new/choose).
321
331
  - **Reference:**
322
332
  - [every `yad` command](docs/CLI.md#commands)
323
333
  - [working together: capture, claims, owners, fold](docs/CLI.md#working-together-capture-claims-owners-and-fold)
324
334
  - [troubleshooting and error codes](docs/CLI.md#troubleshooting-yad-doctor--error-codes)
325
335
  - [every CI gate: rules, exemptions and failures](docs/GATES.md)
326
- - [all 39 skills](docs/SKILLS.md)
336
+ - [all 41 skills](docs/SKILLS.md)
327
337
  - [the by-hand walkthrough](docs/WALKTHROUGH.md)
328
338
  - **Upgrade:** [staying up to date](docs/CLI.md#staying-up-to-date) ·
329
339
  [upgrading to 4.0](docs/migrations/upgrading-to-4.md) ·
package/bin/commands.mjs CHANGED
@@ -12,7 +12,7 @@
12
12
 
13
13
  export { runSetup } from '../cli/setup.mjs';
14
14
  export { runNew, runInit, runJoin } from '../cli/workspace.mjs';
15
- export { findProduct, hasProduct, workspaceProduct, registryEntryFor, toolsFolder, WORKSPACE_FILE } from '../cli/find-product.mjs';
15
+ export { findProduct, hasProduct, workspaceProduct, registryEntryFor, registeredCheckoutFor, toolsFolder, WORKSPACE_FILE } from '../cli/find-product.mjs';
16
16
  export { reconcile } from '../cli/reconcile.mjs';
17
17
  export { gateOpen, gateSync, gateComments, gateStatus, gateCi, gateReview, gateTrailer, gateWalkthrough, gateRepair, gateReopen } from '../cli/gate.mjs';
18
18
  export { gateApprove, gateComment, gateAdvance } from '../cli/gate-local.mjs';
@@ -36,8 +36,17 @@ export { runAssign, runUnassign, runOwners } from '../cli/owners.mjs';
36
36
  export { runMemberAdd, runMemberList, runMemberRemove } from '../cli/members.mjs';
37
37
  export { runWorktreeAdd, runWorktreeList, runWorktreeRemove } from '../cli/worktree.mjs';
38
38
  export { runStandup, foreignFlags as standupForeignFlags } from '../cli/standup.mjs';
39
+ export { runReports } from '../cli/reports.mjs';
40
+ export { runMap, MAP_USAGE } from '../cli/map-view.mjs';
41
+ export { runIssuesNew, runIssuesAssign, runIssuesLabel, runIssuesEdit, runIssuesComment, runIssuesClose, runIssuesReopen, ACT_ACTIONS, actForeignFlags } from '../cli/issues-act.mjs';
42
+ export { runFoundationPublish } from '../cli/foundation-publish.mjs';
43
+ export { runScanFile } from '../cli/scan.mjs';
44
+ export { runIssuesSync, syncAfterGate } from '../cli/issues-write.mjs';
45
+ export { runIssuesShow, runIssuesLink, runIssuesUnlink, runEpicNewFromIssue, seedForeignFlags as seedForeign } from '../cli/issues-write.mjs';
46
+ export { runIssuesList, runIssuesLabels, foreignFlags as issuesForeignFlags } from '../cli/issues.mjs';
39
47
  export { runIndex } from '../cli/index-command.mjs';
40
48
  export { runHistory, HISTORY_FLAGS } from '../cli/history.mjs';
49
+ export { runBrain, BRAIN_USAGE, BRAIN_FLAGS } from '../cli/brain.mjs';
41
50
  export { runRepo } from '../cli/repo.mjs';
42
51
  export { runRiskMap } from '../cli/riskmap-command.mjs';
43
52
  export { runCodeowners } from '../cli/codeowners-command.mjs';
@@ -45,6 +54,7 @@ export { runStory } from '../cli/story-frames.mjs';
45
54
  export { runDocs } from '../cli/docs.mjs';
46
55
  export { runDetect } from '../cli/detect.mjs';
47
56
  export { runToolboxAdd, runToolboxCheck, runToolboxList, runToolboxRemove } from '../cli/toolbox.mjs';
57
+ export { runToolboxConnect } from '../cli/toolbox-connect.mjs';
48
58
  export { runDoctor } from '../cli/doctor.mjs';
49
59
  export { runSigningCheck } from '../cli/signing.mjs';
50
60
  export { runCiCheck } from '../cli/ci-check.mjs';