yadflow 4.10.0 → 4.12.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 (120) hide show
  1. package/CHANGELOG.md +152 -0
  2. package/README.md +14 -3
  3. package/bin/commands.mjs +7 -1
  4. package/bin/yad.mjs +163 -16
  5. package/cli/agent-guard-worker.mjs +13 -0
  6. package/cli/agent-guard.mjs +1053 -57
  7. package/cli/agent-rules.mjs +59 -3
  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 +345 -0
  26. package/cli/brain.mjs +810 -0
  27. package/cli/brand-cmd.mjs +326 -0
  28. package/cli/brand.mjs +327 -0
  29. package/cli/ci-check.mjs +3 -3
  30. package/cli/doctor.mjs +145 -14
  31. package/cli/epic-state.mjs +93 -1
  32. package/cli/epic.mjs +15 -3
  33. package/cli/errors.mjs +2 -1
  34. package/cli/find-product.mjs +69 -15
  35. package/cli/foundation-publish.mjs +256 -0
  36. package/cli/gate.mjs +29 -3
  37. package/cli/git-read.mjs +38 -0
  38. package/cli/guard-stream.mjs +409 -0
  39. package/cli/guide.mjs +26 -3
  40. package/cli/hook.mjs +59 -9
  41. package/cli/issues-act.mjs +57 -13
  42. package/cli/issues-write.mjs +19 -6
  43. package/cli/issues.mjs +69 -24
  44. package/cli/lib.mjs +37 -2
  45. package/cli/local-page.mjs +138 -0
  46. package/cli/local-setup-record.mjs +71 -0
  47. package/cli/local-setup-steps.mjs +186 -0
  48. package/cli/local-setup.mjs +611 -0
  49. package/cli/machine.mjs +1 -1
  50. package/cli/manifest.mjs +55 -0
  51. package/cli/map/view/app.js +712 -0
  52. package/cli/map/view/index.html +50 -0
  53. package/cli/map/view/style.css +142 -0
  54. package/cli/map-view.mjs +190 -0
  55. package/cli/map.mjs +637 -0
  56. package/cli/members.mjs +9 -15
  57. package/cli/next.mjs +1 -1
  58. package/cli/openpr.mjs +2 -2
  59. package/cli/plain-text.mjs +22 -0
  60. package/cli/plan.mjs +310 -36
  61. package/cli/platform.mjs +5 -5
  62. package/cli/product-index.mjs +1 -1
  63. package/cli/protection.mjs +32 -0
  64. package/cli/reconcile.mjs +61 -13
  65. package/cli/report.mjs +9 -3
  66. package/cli/reports-dir.mjs +393 -0
  67. package/cli/reports.mjs +65 -0
  68. package/cli/run-checks.mjs +5 -2
  69. package/cli/scan.mjs +4 -6
  70. package/cli/secret-text.mjs +66 -0
  71. package/cli/setup.mjs +54 -8
  72. package/cli/standup.mjs +94 -72
  73. package/cli/status.mjs +6 -5
  74. package/cli/test-agents-file.mjs +614 -8
  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-brand.mjs +558 -0
  79. package/cli/test-guide.mjs +438 -0
  80. package/cli/test-local-setup.mjs +1188 -0
  81. package/cli/test-machine.mjs +59 -0
  82. package/cli/test-map.mjs +615 -0
  83. package/cli/test-reports.mjs +382 -0
  84. package/cli/test-run-checks.mjs +4 -0
  85. package/cli/test-worktree.mjs +24 -3
  86. package/cli/toolbox-connect.mjs +21 -6
  87. package/cli/toolbox.mjs +74 -5
  88. package/cli/update-commit.mjs +118 -9
  89. package/cli/usage.mjs +17 -7
  90. package/cli/workspace.mjs +11 -2
  91. package/package.json +8 -4
  92. package/skills/sdlc/module-help.csv +1 -0
  93. package/skills/yad-architecture/SKILL.md +22 -4
  94. package/skills/yad-brand/SKILL.md +69 -0
  95. package/skills/yad-change/SKILL.md +3 -1
  96. package/skills/yad-change/references/triage.md +2 -0
  97. package/skills/yad-checks/SKILL.md +2 -0
  98. package/skills/yad-checks/references/check-gates.md +8 -5
  99. package/skills/yad-checks/templates/checks/build-test-lint.sh +7 -0
  100. package/skills/yad-checks/templates/checks/install-deps.sh +6 -0
  101. package/skills/yad-checks/templates/checks/package-manager.sh +42 -0
  102. package/skills/yad-checks/templates/github/yad-checks.yml +3 -2
  103. package/skills/yad-checks/templates/gitlab/yad-checks.gitlab-ci.yml +3 -2
  104. package/skills/yad-checks/templates/hooks/local-setup-notice.mjs +96 -0
  105. package/skills/yad-checks/templates/hooks/yad-activity.mjs +238 -0
  106. package/skills/yad-connect-repos/SKILL.md +14 -0
  107. package/skills/yad-discovery/SKILL.md +11 -0
  108. package/skills/yad-discovery/references/foundation-schema.md +11 -0
  109. package/skills/yad-docs/templates/app/package-lock.json +18 -10
  110. package/skills/yad-docs/templates/app/package.json +6 -1
  111. package/skills/yad-epic/SKILL.md +3 -0
  112. package/skills/yad-epic/references/state-schema.md +35 -1
  113. package/skills/yad-guide/SKILL.md +10 -7
  114. package/skills/yad-implement/SKILL.md +76 -15
  115. package/skills/yad-issues/SKILL.md +2 -1
  116. package/skills/yad-pr-template/templates/checks/pr-template.sh +8 -4
  117. package/skills/yad-pr-template/templates/checks/pr-title.sh +8 -4
  118. package/skills/yad-spec/SKILL.md +19 -0
  119. package/skills/yad-stories/SKILL.md +22 -4
  120. package/skills/yad-stories/references/story-schema.md +1 -1
package/CHANGELOG.md CHANGED
@@ -1,3 +1,155 @@
1
+ # [4.12.0](https://github.com/abdelrahmannasr/yadflow/compare/v4.11.0...v4.12.0) (2026-11-15)
2
+
3
+
4
+ ### Bug Fixes
5
+
6
+ * **brand:** review round 1 — linear-time reading, a source path inside the Product, safe terminal text (E184, [#553](https://github.com/abdelrahmannasr/yadflow/issues/553)) ([6aff2ea](https://github.com/abdelrahmannasr/yadflow/commit/6aff2eafdf065688067236572f24f34bf630f520))
7
+ * **brand:** review round 2 — the dark block read inside itself; primary checked as link text (E184, [#553](https://github.com/abdelrahmannasr/yadflow/issues/553)) ([c67e888](https://github.com/abdelrahmannasr/yadflow/commit/c67e888fcc943b95fa6afef519959db54abafe9e)), closes [#9466f8](https://github.com/abdelrahmannasr/yadflow/issues/9466f8)
8
+ * **brand:** review round 3 — DESIGN.md's CSS read as rules in one pass (E184, [#553](https://github.com/abdelrahmannasr/yadflow/issues/553)) ([3a363d9](https://github.com/abdelrahmannasr/yadflow/commit/3a363d9257b1758a56bb0d22f6b7e0d9010dea69))
9
+ * **brand:** review round 4 — markdown prose, fences and html.dark read right (E184, [#553](https://github.com/abdelrahmannasr/yadflow/issues/553)) ([cac56be](https://github.com/abdelrahmannasr/yadflow/commit/cac56be6846c70dc34819ecead9d3beab4f22dff))
10
+ * **brand:** review round 5 — :not(.dark) is light; a /* in prose is not a comment (E184, [#553](https://github.com/abdelrahmannasr/yadflow/issues/553)) ([034c995](https://github.com/abdelrahmannasr/yadflow/commit/034c995689ad0c40f4d3859b71ba43d4c4aad56f))
11
+ * **brand:** review round 6 — a comment after a brace is a comment; nested :not() (E184, [#553](https://github.com/abdelrahmannasr/yadflow/issues/553)) ([a390ddc](https://github.com/abdelrahmannasr/yadflow/commit/a390ddc309554b910045cf09d276b3c9559fbe5b))
12
+ * **brand:** review round 7 — a fenced DESIGN.md is read only inside its CSS fences (E184, [#553](https://github.com/abdelrahmannasr/yadflow/issues/553)) ([fb908f8](https://github.com/abdelrahmannasr/yadflow/commit/fb908f8a3a022332b0e6defb567517e83ccbfa66))
13
+ * **brand:** review round 8 — fences read as CommonMark does, each on its own (E184, [#553](https://github.com/abdelrahmannasr/yadflow/issues/553)) ([5e5d989](https://github.com/abdelrahmannasr/yadflow/commit/5e5d989a7388d8ebf8a76ac41f0e791bea22b8a0))
14
+ * **brand:** review round 9 — the light look is the first :root rule with colours (E184, [#553](https://github.com/abdelrahmannasr/yadflow/issues/553)) ([0ee5f21](https://github.com/abdelrahmannasr/yadflow/commit/0ee5f21dbc01b54a3c2646a3a005e509062a6ad5))
15
+ * **local-setup:** CodeQL — refuse `--!>` too, and the version test builds no regex ([1cb4c65](https://github.com/abdelrahmannasr/yadflow/commit/1cb4c65b4de54fb34b76f102d297d360687542bf))
16
+ * **local-setup:** review round 1 — nothing hidden, the view as text, add writes only the team list (E185, part 3) ([558b46a](https://github.com/abdelrahmannasr/yadflow/commit/558b46a59a991f609307939c07db4a77b5aecf30))
17
+ * **local-setup:** review round 1 — the agent sees every command first, upkeep is not only an update, done and skip start no gh they do not need (E185) ([175ba90](https://github.com/abdelrahmannasr/yadflow/commit/175ba908cd56072b8b767603395d2f0b7593328d))
18
+ * **local-setup:** review round 1 — the notice runs yad's own copy in git's folder, never the Product's file (E185, part 4) ([ffaf7f9](https://github.com/abdelrahmannasr/yadflow/commit/ffaf7f90e9901ae9505f85e673c4f1451ebf1212))
19
+ * **local-setup:** review round 1 — vetted only by hash, markers refused, commands shown exactly (E185) ([936aeac](https://github.com/abdelrahmannasr/yadflow/commit/936aeac0549602624a294a8bca3ee3307c46930b))
20
+ * **local-setup:** review round 2 — a person step's commands are the person's, upkeep hands over person steps, done and skip run no extra checks (E185) ([fc1dea6](https://github.com/abdelrahmannasr/yadflow/commit/fc1dea64db806f9cbbaee073bbfcc6e37f5139fb))
21
+ * **local-setup:** review round 2 — nested secrets found, toolbox files read as before, the invite is update's (E185, part 3) ([03b9a1d](https://github.com/abdelrahmannasr/yadflow/commit/03b9a1d45f70a148a2462ae3acb004044fdf7e7d))
22
+ * **local-setup:** review round 2 — the notice in a linked worktree, a hand-wired hook, off removes any copy (E185, part 4) ([6d36755](https://github.com/abdelrahmannasr/yadflow/commit/6d367554cb1169c9056fe2a279de644eb5178fdf))
23
+ * **local-setup:** review round 2 — version skew, the view's PR rule, invisible characters (E185) ([8f1007f](https://github.com/abdelrahmannasr/yadflow/commit/8f1007f38bda4cb77a159fda3a48dfcd875cbd69))
24
+ * **local-setup:** review round 3 — --api-key= found again, every bit of HTML in the view escaped (E185, part 3) ([be6da2f](https://github.com/abdelrahmannasr/yadflow/commit/be6da2f7908b693e95e06323adada50f0ffcc80f))
25
+ * **local-setup:** review round 3 — "not vetted" never softened, no lowered CLI version (E185) ([5b724ef](https://github.com/abdelrahmannasr/yadflow/commit/5b724ef1e313512c6deee26ce04b1f296b7d06b3))
26
+ * **local-setup:** review round 3 — a husky hook with yad's line is wired; only a real line counts (E185, part 4) ([f1180a9](https://github.com/abdelrahmannasr/yadflow/commit/f1180a9db2d0e730d96364fd4498a81c963aacd7))
27
+ * **local-setup:** review round 4 — a hand-wired hook is read where git runs it (E185, part 4) ([0772ec1](https://github.com/abdelrahmannasr/yadflow/commit/0772ec19134c46113099c7c3a1b7d145a4c9e51e))
28
+ * **local-setup:** review round 4 — a quoted value is read whole; an empty value is not a secret (E185, part 3) ([47b7ff4](https://github.com/abdelrahmannasr/yadflow/commit/47b7ff4a1a03aa4dd381c850748c6f857950437d))
29
+ * **local-setup:** review round 4 — the machine section names unvetted steps, plain spaces only (E185) ([2006cdd](https://github.com/abdelrahmannasr/yadflow/commit/2006cddc402e6f1862e743979307a21c2ed1db5a))
30
+ * **local-setup:** review round 5 — a hook file with any carriage return is not wired (E185, part 4) ([9728616](https://github.com/abdelrahmannasr/yadflow/commit/9728616a35132a0f104999bb5e76d46957ded3b7))
31
+ * **local-setup:** review round 5 — a prompt's closing quote opens nothing; a quoted & value is a secret (E185, part 3) ([fc38d5e](https://github.com/abdelrahmannasr/yadflow/commit/fc38d5ecfef711506ed7044a3f98e22dcfbc99d2))
32
+ * **local-setup:** review round 5 — the unvetted bucket named directly, tested, and in --json (E185) ([3b9f36b](https://github.com/abdelrahmannasr/yadflow/commit/3b9f36bafe01b113a3bad32de36bcd853433b568))
33
+ * **local-setup:** review round 6 — a prompt before ; is not a secret, nor a bare query flag (E185, part 3) ([6a32b28](https://github.com/abdelrahmannasr/yadflow/commit/6a32b2878fc495d8000fe46892f1556900dae141))
34
+ * **local-setup:** review round 7 — a quoted value that starts with ; is a secret again (E185, part 3) ([b4cecd4](https://github.com/abdelrahmannasr/yadflow/commit/b4cecd4499fc5689e6ae52f9a50e8f3095cb0664))
35
+ * **local-setup:** review round 8 — a prompt with no space after ; or && is not a secret (E185, part 3) ([84d4256](https://github.com/abdelrahmannasr/yadflow/commit/84d4256e818eb2787eb42d24e35d50a090fcc970))
36
+ * **update:** a shared file the Product gitignores gets no row asking to commit it ([#555](https://github.com/abdelrahmannasr/yadflow/issues/555)) ([7a26f0f](https://github.com/abdelrahmannasr/yadflow/commit/7a26f0f495d47d9c2b876a1c6ce1ab45a02d0fc1))
37
+ * **update:** review round 1 — only a committed ignore rule is the team's; each shared file names what was left out ([#555](https://github.com/abdelrahmannasr/yadflow/issues/555)) ([1bc0b7b](https://github.com/abdelrahmannasr/yadflow/commit/1bc0b7b3747b2b348319a3a9cebcbb86de315ea6))
38
+ * **update:** review round 2 — the team's rule is a line the committed ignore file holds ([#555](https://github.com/abdelrahmannasr/yadflow/issues/555)) ([38795e9](https://github.com/abdelrahmannasr/yadflow/commit/38795e9c7c4e3a4c04fa2c71f7e8b85f45793624))
39
+ * **update:** review round 3 — the committed ignore file is read as git reads it ([#555](https://github.com/abdelrahmannasr/yadflow/issues/555)) ([b315bc0](https://github.com/abdelrahmannasr/yadflow/commit/b315bc00e14ece84700588fae822addf0804bc79))
40
+ * **update:** review round 4 — an ignore file's lines read by one helper that trims as git does ([#555](https://github.com/abdelrahmannasr/yadflow/issues/555)) ([989bcd6](https://github.com/abdelrahmannasr/yadflow/commit/989bcd63cedd3d2386ed4550f31d50f7104933b5))
41
+
42
+
43
+ ### Features
44
+
45
+ * **brand:** every page yad makes wears the Product's brand (E184, [#553](https://github.com/abdelrahmannasr/yadflow/issues/553)) ([924dd18](https://github.com/abdelrahmannasr/yadflow/commit/924dd184399e4b6580285e0b61857753048ed643))
46
+ * **doctor:** the local setup notice after a pull, in this clone (E185, part 4) ([d9cb264](https://github.com/abdelrahmannasr/yadflow/commit/d9cb264e2cf75087307163f8758e25760d3fa151))
47
+ * **doctor:** the local setup steps waiting on this machine, and a record it cannot read (E185, part 2) ([0043520](https://github.com/abdelrahmannasr/yadflow/commit/0043520b8aaef00a56053c13c87ab803996122e0))
48
+ * **guide:** local setup steps waiting for this machine ride the upkeep, and the local-setup rule (E185, part 2) ([eef939c](https://github.com/abdelrahmannasr/yadflow/commit/eef939ca18c54a14d66dd524f61cf10576e47712))
49
+ * **local-setup:** a one-line notice after a pull brings new local setup steps (E185, part 4) ([84b9860](https://github.com/abdelrahmannasr/yadflow/commit/84b9860b05964ecb4c11a59a0f6c168de3861806))
50
+ * **local-setup:** a step stays readable, and text that holds a secret is found (E185, part 3) ([5acc495](https://github.com/abdelrahmannasr/yadflow/commit/5acc4955550dbb23343c363b06fa6fd5cb3a71ea))
51
+ * **local-setup:** the agent proposes the project's own steps; the machine section says how to add them (E185, part 3) ([5fd8742](https://github.com/abdelrahmannasr/yadflow/commit/5fd8742682f4e7fa3c1b5f895b9bbfd330906048))
52
+ * **local-setup:** the local setup script and yad local-setup list (E185) ([97715bb](https://github.com/abdelrahmannasr/yadflow/commit/97715bbf92653e191b2f408750859ef7b0888eea))
53
+ * **local-setup:** this machine's record, and yad local-setup done and skip (E185, part 2) ([ce9226b](https://github.com/abdelrahmannasr/yadflow/commit/ce9226ba056021ac46120f7f21448bcdcae51eca))
54
+ * **local-setup:** yad local-setup add and remove, for the team's own steps (E185, part 3) ([c745184](https://github.com/abdelrahmannasr/yadflow/commit/c7451846cfc208da184ed7445e00fe9c2246e3f4))
55
+
56
+ # [4.11.0](https://github.com/abdelrahmannasr/yadflow/compare/v4.10.0...v4.11.0) (2026-11-14)
57
+
58
+
59
+ ### Bug Fixes
60
+
61
+ * **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)
62
+ * **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)
63
+ * **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)
64
+ * **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))
65
+ * **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))
66
+ * **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))
67
+ * **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))
68
+ * **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))
69
+ * **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))
70
+ * **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))
71
+ * **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))
72
+ * **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))
73
+ * **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))
74
+ * **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))
75
+ * **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))
76
+ * **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))
77
+ * **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))
78
+ * **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))
79
+ * **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))
80
+ * **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))
81
+ * **brain:** CI — the test runner passes git's ENOBUFS; no 'hub' in a comment ([7c47234](https://github.com/abdelrahmannasr/yadflow/commit/7c47234e8e3d86e97fe564caf72775c9b1cfb81b))
82
+ * **brain:** CodeQL — cut the served script tags by markers, not an HTML pattern (E177) ([e09137f](https://github.com/abdelrahmannasr/yadflow/commit/e09137f871d946839531c35261ff2e9d830078d2))
83
+ * **brain:** E179 review 1 — --repo limits the file; the skills read a moved repo as behind ([efb9cb5](https://github.com/abdelrahmannasr/yadflow/commit/efb9cb51cd1bfca9cbea001f6220fb9fb1dc7a8a))
84
+ * **brain:** E179 review 2 — the stories question has a place; the light spec is judged again ([8842784](https://github.com/abdelrahmannasr/yadflow/commit/8842784880c400edf741eae0c1bc0f7868452233))
85
+ * **brain:** E179 review 3 — an added file that ends the light spec is asked about first ([f1b6605](https://github.com/abdelrahmannasr/yadflow/commit/f1b6605a92f6ad207c57389bd1dfe9cb9f0647e4))
86
+ * **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)
87
+ * **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)
88
+ * **brain:** labels follow the page theme, light on the dark one (E177 view) ([44f000f](https://github.com/abdelrahmannasr/yadflow/commit/44f000f51c703a33572984ab3d6acef06ee89ca9))
89
+ * **brain:** review — a held node keeps its heat; at most 60 neighbours named ([36bd6e6](https://github.com/abdelrahmannasr/yadflow/commit/36bd6e6b86981b6c661338b1ed1deed5f682b744))
90
+ * **brain:** review — a theme switch keeps the camera, labels stay put on hover ([b06b0cb](https://github.com/abdelrahmannasr/yadflow/commit/b06b0cb4264fdef144e07f79d684a65549bc2055))
91
+ * **brain:** review — only the left button drags a node ([5fbff4a](https://github.com/abdelrahmannasr/yadflow/commit/5fbff4a426a69e75b5d69a2ff44ba5fc9b89f6ac))
92
+ * **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))
93
+ * **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))
94
+ * **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))
95
+ * **brain:** review 2 — the task follows edits, no unrelated parent repo, the attach order (E178) ([13c7923](https://github.com/abdelrahmannasr/yadflow/commit/13c7923f6684a721ac286523fd30c07cbd277e28))
96
+ * **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))
97
+ * **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))
98
+ * **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))
99
+ * **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)
100
+ * **docs:** raise the docs shell version to 0.0.5 for the zod bump ([876a2a5](https://github.com/abdelrahmannasr/yadflow/commit/876a2a516020bf64358dded5cd06a8b4bb15f074))
101
+ * **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)
102
+ * **foundation:** review round 1 — a failed CI read fails, all readers agree, platforms number apart ([ea51d29](https://github.com/abdelrahmannasr/yadflow/commit/ea51d29d1996298f535b41e1249330b3c3fa6022))
103
+ * **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))
104
+ * **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)
105
+ * **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))
106
+ * **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))
107
+ * **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)
108
+ * **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))
109
+ * **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))
110
+ * **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))
111
+ * **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))
112
+ * **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))
113
+ * **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))
114
+ * **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))
115
+ * **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))
116
+ * **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))
117
+ * **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))
118
+ * **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))
119
+ * **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))
120
+ * **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))
121
+ * **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))
122
+ * **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)
123
+ * **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))
124
+ * **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))
125
+ * read shell-bound output in the agent guard ([#532](https://github.com/abdelrahmannasr/yadflow/issues/532)) ([f1d5693](https://github.com/abdelrahmannasr/yadflow/commit/f1d56934e46ef573c86cf0b3d0a42e98cbcbaa15))
126
+ * **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))
127
+ * **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))
128
+ * **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))
129
+ * **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))
130
+ * **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))
131
+ * **toolbox:** review 1 — pin the AI Game Developer plugin too, and test the reach order (E175) ([7040cab](https://github.com/abdelrahmannasr/yadflow/commit/7040cab9b86d9587f72dca59b477e526bd856559))
132
+ * **toolbox:** review 4 — stdio transport, compile by error code, no hidden Unity (E175) ([4bb8784](https://github.com/abdelrahmannasr/yadflow/commit/4bb8784f8234d7a0cb953f1a905710372e8a9c8e))
133
+ * **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))
134
+
135
+
136
+ ### Features
137
+
138
+ * **brain:** agents consult the brain while planning and building (E179) ([6bc19e0](https://github.com/abdelrahmannasr/yadflow/commit/6bc19e09f757372be00e8236c367630777148239))
139
+ * **brain:** drag a node on the live page, its links lit (E178) ([a0d9e3d](https://github.com/abdelrahmannasr/yadflow/commit/a0d9e3d5d44c4437ac353ee2c47aae69636fd87e))
140
+ * **brain:** press and hold a node to drag it (E177 view) ([966bf67](https://github.com/abdelrahmannasr/yadflow/commit/966bf67baf74d27ed927edb189702767bf4f2d62))
141
+ * **brain:** the live activity record — a hook that notes each agent tool call (E178) ([3c79ee6](https://github.com/abdelrahmannasr/yadflow/commit/3c79ee6fb8d1494f1bcb79027b7f1b2af15b2537))
142
+ * **brain:** vendor sigma.js, graphology and graphology-library for the brain viewer (E177) ([6e16dce](https://github.com/abdelrahmannasr/yadflow/commit/6e16dce0516186c8c2679232c2f2daf941ce3a8e))
143
+ * **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))
144
+ * **brain:** yad brain view --live — the Observatory (E178) ([8d2974f](https://github.com/abdelrahmannasr/yadflow/commit/8d2974f33d2b4b3d27ba42067a17acb39e460457))
145
+ * **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))
146
+ * **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))
147
+ * **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))
148
+ * **reports:** E180 — every report is saved on this machine, beside the Product ([32edfe6](https://github.com/abdelrahmannasr/yadflow/commit/32edfe677f9863941e6230b9fb5a0407db245f38))
149
+ * 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))
150
+ * **toolbox:** add Unity MCP (AI Game Developer) beside MCP for Unity ([c604f6b](https://github.com/abdelrahmannasr/yadflow/commit/c604f6ba48f24cd28d5f2df3e9006183d966a615))
151
+ * **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))
152
+
1
153
  # [4.10.0](https://github.com/abdelrahmannasr/yadflow/compare/v4.9.0...v4.10.0) (2026-11-10)
2
154
 
3
155
 
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
@@ -295,12 +297,17 @@ 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
301
- - `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. `yad-run` and `yad-implement` also scan each implementation and file security findings, technical debt and suggestions there
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
302
307
  - `yad detect`, which lists the skills, agents, MCP servers and plugins installed for each AI agent
303
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
309
+ - `yad local-setup`, which lists the steps each team member's machine needs for this project — from the Product's `LOCAL-SETUP.md` script — each with why it is needed and what it changes for you, and whether it is done here; `yad local-setup done` and `skip` record your answer on this machine, so after an update only new or changed steps are asked; `yad local-setup add` and `remove` change your team's own steps, which the agent proposes at the first setup; after a `git pull` that brings new steps, one line says so (E185)
310
+ - `yad brand`, which makes every page yad makes for the Product (the progress map, the brain view, the standup, usage and issues reports, the reports catalog) wear the Product's own logo, colours and fonts, from one small committed file, `.sdlc/brand.json`, that `yad brand init` fills from DESIGN.md; with none, the pages wear yadflow's look (E184)
304
311
  - `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
305
312
  - draft saving, claims and owners
306
313
  - the CI checks
@@ -316,9 +323,13 @@ The record is worth trusting because people approve what goes into it.
316
323
 
317
324
  ## Documentation
318
325
 
319
- - **Learn:** the [guided tutorial](https://abdelrahmannasr.github.io/yadflow/tutorial/) (setup to
320
- your first shipped feature) · the [team guide](TEAM-GUIDE.md) · the
326
+ - **Learn:** [yadflow, explained](docs/YADFLOW-EXPLAINED.md) (every part in plain words, for technical
327
+ and non-technical readers) · the [guided tutorial](https://abdelrahmannasr.github.io/yadflow/tutorial/)
328
+ (setup to your first shipped feature) · the [team guide](TEAM-GUIDE.md) · the
321
329
  [terminology and workflow report](https://abdelrahmannasr.github.io/yadflow/)
330
+ - **Talk:** [GitHub Discussions](https://github.com/abdelrahmannasr/yadflow/discussions) — ask
331
+ questions in Q&A, suggest ideas, and share what you build. Bugs go to
332
+ [Issues](https://github.com/abdelrahmannasr/yadflow/issues/new/choose).
322
333
  - **Reference:**
323
334
  - [every `yad` command](docs/CLI.md#commands)
324
335
  - [working together: capture, claims, owners, fold](docs/CLI.md#working-together-capture-claims-owners-and-fold)
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,13 +36,18 @@ 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 { runBrand, BRAND_USAGE } from '../cli/brand-cmd.mjs';
41
+ export { runMap, MAP_USAGE } from '../cli/map-view.mjs';
39
42
  export { runIssuesNew, runIssuesAssign, runIssuesLabel, runIssuesEdit, runIssuesComment, runIssuesClose, runIssuesReopen, ACT_ACTIONS, actForeignFlags } from '../cli/issues-act.mjs';
43
+ export { runFoundationPublish } from '../cli/foundation-publish.mjs';
40
44
  export { runScanFile } from '../cli/scan.mjs';
41
45
  export { runIssuesSync, syncAfterGate } from '../cli/issues-write.mjs';
42
46
  export { runIssuesShow, runIssuesLink, runIssuesUnlink, runEpicNewFromIssue, seedForeignFlags as seedForeign } from '../cli/issues-write.mjs';
43
47
  export { runIssuesList, runIssuesLabels, foreignFlags as issuesForeignFlags } from '../cli/issues.mjs';
44
48
  export { runIndex } from '../cli/index-command.mjs';
45
49
  export { runHistory, HISTORY_FLAGS } from '../cli/history.mjs';
50
+ export { runBrain, BRAIN_USAGE, BRAIN_FLAGS } from '../cli/brain.mjs';
46
51
  export { runRepo } from '../cli/repo.mjs';
47
52
  export { runRiskMap } from '../cli/riskmap-command.mjs';
48
53
  export { runCodeowners } from '../cli/codeowners-command.mjs';
@@ -51,6 +56,7 @@ export { runDocs } from '../cli/docs.mjs';
51
56
  export { runDetect } from '../cli/detect.mjs';
52
57
  export { runToolboxAdd, runToolboxCheck, runToolboxList, runToolboxRemove } from '../cli/toolbox.mjs';
53
58
  export { runToolboxConnect } from '../cli/toolbox-connect.mjs';
59
+ export { runLocalSetupList, runLocalSetupDone, runLocalSetupSkip, runLocalSetupAdd, runLocalSetupRemove } from '../cli/local-setup.mjs';
54
60
  export { runDoctor } from '../cli/doctor.mjs';
55
61
  export { runSigningCheck } from '../cli/signing.mjs';
56
62
  export { runCiCheck } from '../cli/ci-check.mjs';