yadflow 4.6.0 → 4.8.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 (136) hide show
  1. package/CHANGELOG.md +259 -0
  2. package/README.md +46 -4
  3. package/bin/commands.mjs +9 -2
  4. package/bin/yad.mjs +309 -30
  5. package/cli/agent-guard.mjs +511 -0
  6. package/cli/agent-guide.mjs +83 -0
  7. package/cli/agent-rules.mjs +381 -0
  8. package/cli/argv-flags.mjs +7 -0
  9. package/cli/artifact-status.mjs +88 -20
  10. package/cli/build.mjs +1372 -0
  11. package/cli/checkpoint.mjs +2 -2
  12. package/cli/ci-check.mjs +492 -0
  13. package/cli/commit.mjs +1 -0
  14. package/cli/dial.mjs +21 -1
  15. package/cli/docs.mjs +7 -2
  16. package/cli/doctor.mjs +176 -33
  17. package/cli/epic-state.mjs +360 -12
  18. package/cli/errors.mjs +3 -0
  19. package/cli/find-product.mjs +36 -2
  20. package/cli/fold.mjs +9 -5
  21. package/cli/gate-local.mjs +9 -1
  22. package/cli/gate.mjs +364 -22
  23. package/cli/guide.mjs +549 -0
  24. package/cli/history.mjs +22 -2
  25. package/cli/hook.mjs +35 -4
  26. package/cli/index-command.mjs +2 -2
  27. package/cli/ledger.mjs +60 -0
  28. package/cli/lib.mjs +46 -0
  29. package/cli/lifecycle/defaults/2.json +124 -0
  30. package/cli/lifecycle/lifecycle.schema.json +5 -2
  31. package/cli/lifecycle.mjs +16 -3
  32. package/cli/manifest.mjs +75 -0
  33. package/cli/marked-block.mjs +48 -0
  34. package/cli/members.mjs +19 -5
  35. package/cli/migrate.mjs +17 -19
  36. package/cli/next.mjs +35 -12
  37. package/cli/openpr.mjs +81 -5
  38. package/cli/plan.mjs +326 -22
  39. package/cli/platform.mjs +21 -0
  40. package/cli/pr-list.mjs +5 -3
  41. package/cli/product-index.mjs +6 -3
  42. package/cli/product-token.mjs +186 -0
  43. package/cli/productcommit.mjs +33 -0
  44. package/cli/protection.mjs +50 -0
  45. package/cli/recommend.mjs +3 -1
  46. package/cli/reconcile.mjs +187 -26
  47. package/cli/repo-publish.mjs +2 -2
  48. package/cli/report.mjs +62 -14
  49. package/cli/run-checks.mjs +586 -0
  50. package/cli/setup.mjs +244 -25
  51. package/cli/ship-drift.mjs +49 -18
  52. package/cli/signing.mjs +377 -0
  53. package/cli/standup.mjs +1 -1
  54. package/cli/status.mjs +282 -0
  55. package/cli/test-agents-file.mjs +993 -0
  56. package/cli/test-build.mjs +1559 -0
  57. package/cli/test-ci-check.mjs +616 -0
  58. package/cli/test-guide.mjs +1267 -0
  59. package/cli/test-node.mjs +129 -0
  60. package/cli/test-run-checks.mjs +603 -0
  61. package/cli/test-setup-agent.mjs +352 -0
  62. package/cli/test-signing.mjs +524 -0
  63. package/cli/test-worktree.mjs +520 -0
  64. package/cli/thread.mjs +4 -0
  65. package/cli/tidy.mjs +2 -2
  66. package/cli/toolbox.mjs +37 -6
  67. package/cli/update-commit.mjs +313 -11
  68. package/cli/workspace.mjs +38 -10
  69. package/cli/worktree-record.mjs +53 -0
  70. package/cli/worktree.mjs +379 -0
  71. package/package.json +6 -4
  72. package/skills/sdlc/config.yaml +5 -5
  73. package/skills/sdlc/module-help.csv +2 -1
  74. package/skills/yad-backfill/templates/checks/backfill-check.sh +9 -9
  75. package/skills/yad-change/SKILL.md +5 -1
  76. package/skills/yad-checks/SKILL.md +61 -12
  77. package/skills/yad-checks/references/check-gates.md +78 -14
  78. package/skills/yad-checks/templates/checks/build-test-lint.sh +22 -3
  79. package/skills/yad-checks/templates/checks/commit-message.sh +8 -2
  80. package/skills/yad-checks/templates/checks/contract-check.sh +61 -33
  81. package/skills/yad-checks/templates/checks/epic-open.sh +87 -14
  82. package/skills/yad-checks/templates/checks/ledger-guard.sh +3 -3
  83. package/skills/yad-checks/templates/checks/lineage-check.sh +88 -15
  84. package/skills/yad-checks/templates/checks/member-check.mjs +206 -35
  85. package/skills/yad-checks/templates/checks/package-manager.sh +42 -5
  86. package/skills/yad-checks/templates/checks/product-checkout.sh +161 -13
  87. package/skills/yad-checks/templates/checks/reconcile-debt-check.sh +94 -15
  88. package/skills/yad-checks/templates/checks/risk-map-check.sh +2 -2
  89. package/skills/yad-checks/templates/checks/spec-link.sh +63 -4
  90. package/skills/yad-checks/templates/checks/verified-commits.sh +23 -5
  91. package/skills/yad-checks/templates/github/yad-checks.yml +9 -9
  92. package/skills/yad-checks/templates/gitlab/.gitlab-ci.yml +4 -1
  93. package/skills/yad-checks/templates/gitlab/yad-checks.gitlab-ci.yml +5 -5
  94. package/skills/yad-checks/templates/gitlab/yad-product-checks.gitlab-ci.yml +16 -3
  95. package/skills/yad-checks/templates/gitlab/yad-update-guard.gitlab-ci.yml +5 -1
  96. package/skills/yad-checks/templates/gitlab/yad-verified-commits.gitlab-ci.yml +5 -1
  97. package/skills/yad-checks/templates/hooks/agent-guard.mjs +116 -0
  98. package/skills/yad-commit/SKILL.md +8 -5
  99. package/skills/yad-connect-repos/SKILL.md +5 -3
  100. package/skills/yad-connect-repos/references/code-context.md +2 -1
  101. package/skills/yad-connect-repos/references/repos-registry.md +2 -1
  102. package/skills/yad-docs/templates/app/package-lock.json +395 -106
  103. package/skills/yad-docs/templates/app/package.json +2 -2
  104. package/skills/yad-docs-overview/references/pipeline-model.md +2 -2
  105. package/skills/yad-engineer-review/SKILL.md +55 -25
  106. package/skills/yad-engineer-review/references/ship-and-record.md +49 -12
  107. package/skills/yad-epic/SKILL.md +2 -1
  108. package/skills/yad-epic/references/state-schema.md +76 -17
  109. package/skills/yad-guide/SKILL.md +192 -0
  110. package/skills/yad-implement/SKILL.md +75 -13
  111. package/skills/yad-implement/references/implement-conventions.md +8 -1
  112. package/skills/yad-implement/templates/.gitmessage +3 -0
  113. package/skills/yad-open-pr/SKILL.md +21 -0
  114. package/skills/yad-pair-review/SKILL.md +14 -5
  115. package/skills/yad-pr-template/SKILL.md +6 -2
  116. package/skills/yad-pr-template/templates/checks/pr-template.sh +85 -4
  117. package/skills/yad-pr-template/templates/checks/pr-title.sh +1 -1
  118. package/skills/yad-pr-template/templates/github/pull_request_template.md +1 -1
  119. package/skills/yad-pr-template/templates/gitlab/merge_request_templates/Default.md +1 -1
  120. package/skills/yad-product-bridge/SKILL.md +44 -12
  121. package/skills/yad-product-bridge/references/bridge.md +11 -5
  122. package/skills/yad-product-bridge/templates/github/yad-gate-sync.yml +2 -2
  123. package/skills/yad-product-bridge/templates/gitlab/yad-gate-sync.gitlab-ci.yml +9 -4
  124. package/skills/yad-reconcile/SKILL.md +9 -3
  125. package/skills/yad-report/SKILL.md +15 -0
  126. package/skills/yad-review-companion/SKILL.md +5 -3
  127. package/skills/yad-review-gate/SKILL.md +16 -8
  128. package/skills/yad-review-gate/references/gating.md +26 -1
  129. package/skills/yad-run/SKILL.md +61 -33
  130. package/skills/yad-run/references/run-loop.md +44 -22
  131. package/skills/yad-spec/SKILL.md +137 -16
  132. package/skills/yad-spec/references/spec-handoff.md +50 -3
  133. package/skills/yad-status/SKILL.md +7 -0
  134. package/skills/yad-stories/references/story-schema.md +1 -1
  135. package/skills/yad-sync-repos/SKILL.md +2 -1
  136. package/skills/yad-ui/SKILL.md +2 -2
package/cli/fold.mjs CHANGED
@@ -2,7 +2,7 @@
2
2
  //
3
3
  // E43 saves every draft of an artifact to a private `yad/wip/<name>/<epic>` branch, as unsigned `wip(…)`
4
4
  // commits. At the end of an authoring step, this command makes the ONE commit the record keeps:
5
- // `docs(<epic>): author <step>`. The decisions were the user's (2026-09-25):
5
+ // `docs(<epic, lowercase>): author <step>` (#413). The decisions were the user's (2026-09-25):
6
6
  // 1. THE DRAFT BRANCH IS LEFT ALONE. The fold does not delete, reset or mark it. E95 (rework measurement)
7
7
  // reads the draft history, and deleting a capture branch is the multi-machine trap E43's reviews kept
8
8
  // finding (another machine pushes its copy back). Capture's own rule makes the next capture a no-op:
@@ -30,7 +30,7 @@ import os from 'node:os';
30
30
  import path from 'node:path';
31
31
  import { ok, info, warn, fail, hand, readJSON } from './lib.mjs';
32
32
  import { productConfigPath, isVerifiedLedger } from './manifest.mjs';
33
- import { STEPS, FOUNDATION_EPIC, FOUNDATION_DIR, DISCOVERY_EPIC, artifactBase, artifactPaths, epicRoot } from './epic-state.mjs';
33
+ import { STEPS, FOUNDATION_EPIC, FOUNDATION_DIR, DISCOVERY_EPIC, artifactBase, artifactPaths, epicRoot, isValidEpicId } from './epic-state.mjs';
34
34
  import { capturedEpic, gitIn, isOwnerPath, statusEntries, wipName, wipBranch, runCapture } from './capture.mjs';
35
35
  import { resolveDefaultBranch, preflightGuardReadiness } from './productcommit.mjs';
36
36
 
@@ -55,8 +55,11 @@ export function stepPaths(epic, stepId) {
55
55
  }
56
56
  const covers = (paths, p) => paths.some((s) => p === s || p.startsWith(`${s}/`));
57
57
 
58
+ // The scope is the epic ID in lowercase (#413): the commit-message gate takes a lowercase scope
59
+ // (`[a-z0-9._-]`), so `docs(EP-x)` failed every review PR. The exact ID stays in the Yad-Epic trailer.
60
+ export const foldSubject = (epic, step) => `docs(${epic.toLowerCase()}): author ${step}`;
58
61
  export const foldMessage = ({ epic, step, folded }) =>
59
- `docs(${epic}): author ${step}\n\nYad-Epic: ${epic}\nYad-Step: ${step}\nYad-Folded: ${folded || 'none'}\n`;
62
+ `${foldSubject(epic, step)}\n\nYad-Epic: ${epic}\nYad-Step: ${step}\nYad-Folded: ${folded || 'none'}\n`;
60
63
 
61
64
  // Sort one epic's changed files into what the fold takes and what it leaves. `entries` are
62
65
  // `statusEntries` rows; `verified` is the ledger mode; `seeding` is true while the epic has no
@@ -113,7 +116,8 @@ export function unfoldedPaths(root, epic, base, env = process.env) {
113
116
  export async function runFold(root, { epic, step, env = process.env, capture = runCapture } = {}) {
114
117
  const refuse = (msg, hint) => { fail(msg); if (hint) hand(hint); process.exitCode = 1; };
115
118
  if (!epic || !step) return refuse('yad fold needs an epic and a step', `usage: yad fold <epic> <step> (steps: ${FOLD_STEPS.join(', ')})`);
116
- if (!/^EP-[a-z0-9-]+$/.test(epic)) return refuse(`not an epic id: ${epic}`, 'an epic id looks like EP-<slug> (the Product level is EP-foundation)');
119
+ // One rule with the rest of yad, which also keeps foldSubject's lowercased scope inside the gate's [a-z0-9._-].
120
+ if (!isValidEpicId(epic)) return refuse(`not an epic id: ${epic}`, 'an epic id looks like EP-<slug> (the Product level is EP-foundation)');
117
121
  if (!FOLD_STEPS.includes(step)) return refuse(`${step} is not an authoring step with an artifact`, `steps: ${FOLD_STEPS.join(', ')}`);
118
122
  // The Product level has one folder, `foundation/`; a feature step never runs there, and `foundation`
119
123
  // never runs in an epic. (`discovery` is the old spelling, which lived in an ordinary epic folder.)
@@ -236,7 +240,7 @@ export async function runFold(root, { epic, step, env = process.env, capture = r
236
240
  fs.rmSync(tmp, { recursive: true, force: true });
237
241
  }
238
242
  const sha = git(['rev-parse', 'HEAD']).out.trim();
239
- const subject = `docs(${epic}): author ${step}`;
243
+ const subject = foldSubject(epic, step);
240
244
  ok(`${subject} → ${sha.slice(0, 7)} (${files.length} file(s))`);
241
245
  if (sorted.seed.length) info(`with the new epic's seed: ${sorted.seed.join(', ')}`);
242
246
  if (sorted.ledger.length) info(`with the ledger (${verified ? 'a new epic\'s seed' : 'ledger: local'}): ${sorted.ledger.length} file(s)`);
@@ -23,7 +23,7 @@ import { isVerifiedLedger } from './manifest.mjs';
23
23
  import {
24
24
  epicRel, epicRoot, loadLedger, findReviewStep, artifactHash, acceptedHashes, gatePredicate, printable, advanceState,
25
25
  gateRuleSum, gateRuleEnforced, legacyLogins, canonicalApprovals, canonicalComments, optionalStepsFor, writeState,
26
- isPassed, stepStatus, readFrontmatter,
26
+ isPassed, stepStatus, readFrontmatter, heldByReopen,
27
27
  } from './epic-state.mjs';
28
28
  import { activePeople, activeSum, activeBasis } from './people.mjs';
29
29
  import { actorName } from './platform.mjs';
@@ -270,6 +270,14 @@ export async function gateAdvance(root, { epic, artifact, today, headCount = nul
270
270
  return;
271
271
  }
272
272
  if (refuseUnopened(g, { epic, artifact, verb: 'advance' })) return;
273
+ // After a reopen the gates pass again in order (#322).
274
+ const held = heldByReopen(ledger.state, step.id);
275
+ if (held) {
276
+ fail(`${step.id} waits for ${held}, an earlier step not passed since \`yad gate reopen\` — nothing is written`);
277
+ hand(`pass ${held} first; the gates from a reopened step pass again in order`);
278
+ process.exitCode = 1;
279
+ return { epic, advanced: false, currentStep: ledger.state.currentStep ?? null, gate: null };
280
+ }
273
281
  const people = countPeople(root, g.productConfig, today, headCount);
274
282
  log(` ${c.dim(activeSum(people))}`);
275
283
  note(c.dim(activeBasis(people)));