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.
- package/CHANGELOG.md +152 -0
- package/README.md +14 -3
- package/bin/commands.mjs +7 -1
- package/bin/yad.mjs +163 -16
- package/cli/agent-guard-worker.mjs +13 -0
- package/cli/agent-guard.mjs +1053 -57
- package/cli/agent-rules.mjs +59 -3
- package/cli/argv-flags.mjs +2 -2
- package/cli/brain/vendor/LICENSE-graphology-library.txt +21 -0
- package/cli/brain/vendor/LICENSE-graphology.txt +21 -0
- package/cli/brain/vendor/LICENSE-sigma.txt +12 -0
- package/cli/brain/vendor/graphology-library.min.js +2 -0
- package/cli/brain/vendor/graphology.umd.min.js +2 -0
- package/cli/brain/vendor/sigma.min.js +1369 -0
- package/cli/brain/view/app.js +382 -0
- package/cli/brain/view/index.html +63 -0
- package/cli/brain/view/live.css +228 -0
- package/cli/brain/view/live.html +110 -0
- package/cli/brain/view/live.js +884 -0
- package/cli/brain/view/style.css +141 -0
- package/cli/brain-about.mjs +206 -0
- package/cli/brain-activity.mjs +285 -0
- package/cli/brain-skills.mjs +118 -0
- package/cli/brain-vendor.mjs +71 -0
- package/cli/brain-view.mjs +345 -0
- package/cli/brain.mjs +810 -0
- package/cli/brand-cmd.mjs +326 -0
- package/cli/brand.mjs +327 -0
- package/cli/ci-check.mjs +3 -3
- package/cli/doctor.mjs +145 -14
- package/cli/epic-state.mjs +93 -1
- package/cli/epic.mjs +15 -3
- package/cli/errors.mjs +2 -1
- package/cli/find-product.mjs +69 -15
- package/cli/foundation-publish.mjs +256 -0
- package/cli/gate.mjs +29 -3
- package/cli/git-read.mjs +38 -0
- package/cli/guard-stream.mjs +409 -0
- package/cli/guide.mjs +26 -3
- package/cli/hook.mjs +59 -9
- package/cli/issues-act.mjs +57 -13
- package/cli/issues-write.mjs +19 -6
- package/cli/issues.mjs +69 -24
- package/cli/lib.mjs +37 -2
- package/cli/local-page.mjs +138 -0
- package/cli/local-setup-record.mjs +71 -0
- package/cli/local-setup-steps.mjs +186 -0
- package/cli/local-setup.mjs +611 -0
- package/cli/machine.mjs +1 -1
- package/cli/manifest.mjs +55 -0
- package/cli/map/view/app.js +712 -0
- package/cli/map/view/index.html +50 -0
- package/cli/map/view/style.css +142 -0
- package/cli/map-view.mjs +190 -0
- package/cli/map.mjs +637 -0
- package/cli/members.mjs +9 -15
- package/cli/next.mjs +1 -1
- package/cli/openpr.mjs +2 -2
- package/cli/plain-text.mjs +22 -0
- package/cli/plan.mjs +310 -36
- package/cli/platform.mjs +5 -5
- package/cli/product-index.mjs +1 -1
- package/cli/protection.mjs +32 -0
- package/cli/reconcile.mjs +61 -13
- package/cli/report.mjs +9 -3
- package/cli/reports-dir.mjs +393 -0
- package/cli/reports.mjs +65 -0
- package/cli/run-checks.mjs +5 -2
- package/cli/scan.mjs +4 -6
- package/cli/secret-text.mjs +66 -0
- package/cli/setup.mjs +54 -8
- package/cli/standup.mjs +94 -72
- package/cli/status.mjs +6 -5
- package/cli/test-agents-file.mjs +614 -8
- package/cli/test-brain-activity.mjs +753 -0
- package/cli/test-brain-view.mjs +381 -0
- package/cli/test-brain.mjs +795 -0
- package/cli/test-brand.mjs +558 -0
- package/cli/test-guide.mjs +438 -0
- package/cli/test-local-setup.mjs +1188 -0
- package/cli/test-machine.mjs +59 -0
- package/cli/test-map.mjs +615 -0
- package/cli/test-reports.mjs +382 -0
- package/cli/test-run-checks.mjs +4 -0
- package/cli/test-worktree.mjs +24 -3
- package/cli/toolbox-connect.mjs +21 -6
- package/cli/toolbox.mjs +74 -5
- package/cli/update-commit.mjs +118 -9
- package/cli/usage.mjs +17 -7
- package/cli/workspace.mjs +11 -2
- package/package.json +8 -4
- package/skills/sdlc/module-help.csv +1 -0
- package/skills/yad-architecture/SKILL.md +22 -4
- package/skills/yad-brand/SKILL.md +69 -0
- package/skills/yad-change/SKILL.md +3 -1
- package/skills/yad-change/references/triage.md +2 -0
- package/skills/yad-checks/SKILL.md +2 -0
- package/skills/yad-checks/references/check-gates.md +8 -5
- package/skills/yad-checks/templates/checks/build-test-lint.sh +7 -0
- package/skills/yad-checks/templates/checks/install-deps.sh +6 -0
- package/skills/yad-checks/templates/checks/package-manager.sh +42 -0
- package/skills/yad-checks/templates/github/yad-checks.yml +3 -2
- package/skills/yad-checks/templates/gitlab/yad-checks.gitlab-ci.yml +3 -2
- package/skills/yad-checks/templates/hooks/local-setup-notice.mjs +96 -0
- package/skills/yad-checks/templates/hooks/yad-activity.mjs +238 -0
- package/skills/yad-connect-repos/SKILL.md +14 -0
- package/skills/yad-discovery/SKILL.md +11 -0
- package/skills/yad-discovery/references/foundation-schema.md +11 -0
- package/skills/yad-docs/templates/app/package-lock.json +18 -10
- package/skills/yad-docs/templates/app/package.json +6 -1
- package/skills/yad-epic/SKILL.md +3 -0
- package/skills/yad-epic/references/state-schema.md +35 -1
- package/skills/yad-guide/SKILL.md +10 -7
- package/skills/yad-implement/SKILL.md +76 -15
- package/skills/yad-issues/SKILL.md +2 -1
- package/skills/yad-pr-template/templates/checks/pr-template.sh +8 -4
- package/skills/yad-pr-template/templates/checks/pr-title.sh +8 -4
- package/skills/yad-spec/SKILL.md +19 -0
- package/skills/yad-stories/SKILL.md +22 -4
- package/skills/yad-stories/references/story-schema.md +1 -1
|
@@ -103,6 +103,8 @@ thread: <its own id>
|
|
|
103
103
|
Both names, same value: `kind:` is the one every reader still uses, `type:` is the name from shape 5 on.
|
|
104
104
|
|
|
105
105
|
This is a non-gated, idempotent frontmatter add (no `parent`, since a genesis epic is the thread root).
|
|
106
|
+
It keeps the epic's approvals live: the gate accepts the fingerprint of `epic.md` with exactly these three lines
|
|
107
|
+
taken out (#499). Add nothing else in the same edit — any other value or key still counts as an edit.
|
|
106
108
|
`workItemType` already defaults an absent type to `feature`, so an un-migrated genesis still behaves as
|
|
107
109
|
a root — migration just makes the `thread` cache explicit and lets `yad thread` group it.
|
|
108
110
|
|
|
@@ -41,6 +41,8 @@ in CI on every PR/MR and must pass before merge (build plan §C). Each is a smal
|
|
|
41
41
|
A missing token on a PR that is not from a fork is a `WARNING` in CI, and a token that expires within
|
|
42
42
|
30 days is warned about there too (#345); `yad doctor` reports where each code repo's CI gets it.
|
|
43
43
|
3. **build/test/lint** — standard quality stage; tests must actually exercise new behavior, not just pass.
|
|
44
|
+
A Unity project (`ProjectSettings/ProjectVersion.txt` and `Assets/`, no `package.json`) is skipped with a
|
|
45
|
+
note: build and test it with Unity's own CI, such as GameCI (#496).
|
|
44
46
|
CI installs and runs through the package manager declared by the repo's standard
|
|
45
47
|
`package.json#packageManager` field (`npm` and `pnpm` are supported; any other manager stays on
|
|
46
48
|
npm with a warning when an npm lockfile is present, and fails closed otherwise); an npm repo
|
|
@@ -386,10 +386,13 @@ from the event payload):
|
|
|
386
386
|
`--changed <file>` (computed from the diff against the base ref); without that list (a direct
|
|
387
387
|
by-hand caller) the guard is inert and the branch split alone applies. A step owner file
|
|
388
388
|
(`epics/<epic>/.sdlc/owners/<step>.json`, `foundation/.sdlc/owners/…`, written by `yad assign`,
|
|
389
|
-
E47) is not a Shape artifact
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
389
|
+
E47) is not a Shape artifact, and neither is an epic's issue-links file
|
|
390
|
+
(`epics/<epic>/.sdlc/issue-links.json`, written by `yad issues link`) or the Foundation's
|
|
391
|
+
roadmap-items file (`foundation/.sdlc/roadmap-items.json`, written by `yad foundation publish`)
|
|
392
|
+
(#512): a PR that changes only these files passes on any branch. The workflow builds the list
|
|
393
|
+
with `--no-renames` (and `core.quotePath=false`), so a rename INTO `owners/` or onto one of those
|
|
394
|
+
records still lists the artifact it removed. A path git still C-quotes (a `"`, `\`, tab or newline in its name) counts as
|
|
395
|
+
an artifact change and never as an exempt file. Both greps run with
|
|
393
396
|
`LC_ALL=C grep -a`, so a path with bytes that are not valid UTF-8 is never dropped from the list.
|
|
394
397
|
|
|
395
398
|
## 7. pr-template (`templates/checks/pr-template.sh`)
|
|
@@ -406,7 +409,7 @@ catches a free-form description that bypassed it:
|
|
|
406
409
|
`## Impact & Risk`, `## Checklist`, filled `Risk level:`).
|
|
407
410
|
- **Anti-bypass guard** (same as pr-title): a non-review head that changes Shape artifacts
|
|
408
411
|
(`epics/**` or `foundation/**`, detected from the CI-supplied `--changed <file>` list) **FAILS** — artifact changes
|
|
409
|
-
must go through a `review/EP-*` PR, and the message says how, as in pr-title. Step owner files alone do not count (E47).
|
|
412
|
+
must go through a `review/EP-*` PR, and the message says how, as in pr-title. Step owner files and the issue-links and roadmap-items records alone do not count (E47, #512).
|
|
410
413
|
|
|
411
414
|
**GitLab truncates the description this gate reads.** `$CI_MERGE_REQUEST_DESCRIPTION` stops at **2700
|
|
412
415
|
characters**, so a long but perfectly valid MR can lose a required section *before the gate sees it* —
|
|
@@ -9,6 +9,13 @@ readonly YAD_CHECKS_DIR
|
|
|
9
9
|
# shellcheck source-path=SCRIPTDIR
|
|
10
10
|
# shellcheck source=package-manager.sh
|
|
11
11
|
source "$YAD_CHECKS_DIR/package-manager.sh"
|
|
12
|
+
|
|
13
|
+
# The base branch, as the other gates take it: the first argument, or SDLC_BASE (#496).
|
|
14
|
+
if yad_unity_skip "${1:-${SDLC_BASE:-}}"; then
|
|
15
|
+
echo "SKIP [build/test/lint]: a Unity project (ProjectSettings/ProjectVersion.txt and Assets/): not built by yad. Build and test it with Unity's own CI, such as GameCI."
|
|
16
|
+
exit 0
|
|
17
|
+
fi
|
|
18
|
+
|
|
12
19
|
# Two assignments on purpose: nested inside another $(...), a failing yad_package_manager_spec would
|
|
13
20
|
# be swallowed, and the gate would fall back to lockfile detection and PASS on a package.json it
|
|
14
21
|
# had just rejected. Each step fails the gate on its own under `set -e`.
|
|
@@ -8,6 +8,12 @@ readonly YAD_CHECKS_DIR
|
|
|
8
8
|
# shellcheck source=package-manager.sh
|
|
9
9
|
source "$YAD_CHECKS_DIR/package-manager.sh"
|
|
10
10
|
|
|
11
|
+
# The base branch, as the other gates take it: the first argument, or SDLC_BASE (#496).
|
|
12
|
+
if yad_unity_skip "${1:-${SDLC_BASE:-}}"; then
|
|
13
|
+
echo "SKIP [install-deps]: a Unity project (ProjectSettings/ProjectVersion.txt and Assets/): no Node packages to install."
|
|
14
|
+
exit 0
|
|
15
|
+
fi
|
|
16
|
+
|
|
11
17
|
package_manager_spec="$(yad_package_manager_spec)"
|
|
12
18
|
package_manager="$(yad_detect_package_manager "$package_manager_spec")"
|
|
13
19
|
|
|
@@ -76,6 +76,48 @@ yad_validate_exact_package_manager_spec() {
|
|
|
76
76
|
'
|
|
77
77
|
}
|
|
78
78
|
|
|
79
|
+
# #496 — a Unity project builds and tests with Unity's own CI (GameCI, for example), and has no package.json, so
|
|
80
|
+
# the Node gate is skipped for it. A Unity project here is what `yad commit` reads as one: the file
|
|
81
|
+
# ProjectSettings/ProjectVersion.txt and the folder Assets/ at the root, neither a link, and no package.json.
|
|
82
|
+
# The base branch must have no package.json either: otherwise a change that deletes package.json and adds those
|
|
83
|
+
# two paths would skip the build of a Node repo. CI passes the base. With none (an edited CI file, or a local run),
|
|
84
|
+
# the base is worked out as the other gates do it (origin/HEAD, then origin/main); in CI, a base that cannot be
|
|
85
|
+
# worked out refuses the skip. Only a local run with no remote at all decides from its own files. Returns 0 to skip.
|
|
86
|
+
yad_unity_skip() {
|
|
87
|
+
local base="${1:-}" head c
|
|
88
|
+
[ ! -e "$YAD_PACKAGE_JSON" ] && [ ! -L "$YAD_PACKAGE_JSON" ] || return 1
|
|
89
|
+
[ -f ProjectSettings/ProjectVersion.txt ] && [ ! -L ProjectSettings/ProjectVersion.txt ] && [ ! -L ProjectSettings ] || return 1
|
|
90
|
+
[ -d Assets ] && [ ! -L Assets ] || return 1
|
|
91
|
+
if [ -z "$base" ]; then
|
|
92
|
+
head="$(git symbolic-ref --short --quiet refs/remotes/origin/HEAD 2>/dev/null)" || head=""
|
|
93
|
+
for c in "$head" origin/main; do
|
|
94
|
+
if [ -n "$c" ] && git rev-parse --verify --quiet "${c}^{commit}" >/dev/null 2>&1; then base="$c"; break; fi
|
|
95
|
+
done
|
|
96
|
+
if [ -z "$base" ] && [ -n "${CI:-}" ]; then
|
|
97
|
+
echo "note [unity]: no base branch was given or found, so the Unity project is not skipped. Pass the base branch to this script." >&2
|
|
98
|
+
return 1
|
|
99
|
+
fi
|
|
100
|
+
fi
|
|
101
|
+
if [ -n "$base" ]; then
|
|
102
|
+
if ! git rev-parse --verify --quiet "${base}^{commit}" >/dev/null 2>&1; then
|
|
103
|
+
echo "note [unity]: the base branch ${base} could not be read, so the Unity project is not skipped." >&2
|
|
104
|
+
return 1
|
|
105
|
+
fi
|
|
106
|
+
# The tree entry, not the file's contents: a partial clone may hold the tree without the file, and a read
|
|
107
|
+
# that fails must not look like "no package.json". A link or a submodule named package.json counts too.
|
|
108
|
+
local entry
|
|
109
|
+
if ! entry="$(git ls-tree "$base" -- package.json 2>/dev/null)"; then
|
|
110
|
+
echo "note [unity]: the base branch ${base} could not be read, so the Unity project is not skipped." >&2
|
|
111
|
+
return 1
|
|
112
|
+
fi
|
|
113
|
+
if [ -n "$entry" ]; then
|
|
114
|
+
echo "note [unity]: ${base} has a package.json, so removing it here does not skip the Node gate." >&2
|
|
115
|
+
return 1
|
|
116
|
+
fi
|
|
117
|
+
fi
|
|
118
|
+
return 0
|
|
119
|
+
}
|
|
120
|
+
|
|
79
121
|
yad_package_manager_spec() {
|
|
80
122
|
if [ ! -f "$YAD_PACKAGE_JSON" ]; then
|
|
81
123
|
echo "FAIL [package-manager]: package.json is missing." >&2
|
|
@@ -227,8 +227,9 @@ jobs:
|
|
|
227
227
|
${{ env.COREPACK_HOME }}
|
|
228
228
|
key: yad-deps-${{ runner.os }}-node${{ env.YAD_NODE_VERSION }}-${{ hashFiles('package-lock.json', 'npm-shrinkwrap.json', 'pnpm-lock.yaml', 'package.json') }}
|
|
229
229
|
restore-keys: yad-deps-${{ runner.os }}-node${{ env.YAD_NODE_VERSION }}-
|
|
230
|
-
|
|
231
|
-
- run: bash "$YAD_CHECKS/
|
|
230
|
+
# The base branch lets a Unity project skip these two, and stops a change from skipping them by deleting package.json (#496).
|
|
231
|
+
- run: bash "$YAD_CHECKS/install-deps.sh" "origin/${{ github.base_ref }}"
|
|
232
|
+
- run: bash "$YAD_CHECKS/build-test-lint.sh" "origin/${{ github.base_ref }}"
|
|
232
233
|
|
|
233
234
|
# Phase 6 — feature-thread gates. lineage-check: the change links a real threaded epic. epic-open:
|
|
234
235
|
# a sealed epic (all stories shipped) refuses new behaviour, forcing a change-epic. reconcile-debt:
|
|
@@ -123,8 +123,9 @@ yad-build-test-lint:
|
|
|
123
123
|
YAD_TEST_MAX_WORKERS: "2" # cap jest/vitest test workers in CI; ignored by other runners
|
|
124
124
|
script:
|
|
125
125
|
- !reference [.yad_base_checks, script]
|
|
126
|
-
|
|
127
|
-
- bash "$YAD_CHECKS/
|
|
126
|
+
# The base branch lets a Unity project skip these two, and stops a change from skipping them by deleting package.json (#496).
|
|
127
|
+
- bash "$YAD_CHECKS/install-deps.sh" "origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME"
|
|
128
|
+
- bash "$YAD_CHECKS/build-test-lint.sh" "origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME"
|
|
128
129
|
|
|
129
130
|
# Phase 6 — feature-thread gates (lineage / seal / hotfix-debt). Build on spec-link's story->epic
|
|
130
131
|
# resolution; degrade to a note when the product repo is not reachable from CI.
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
// local-setup NOTICE — git's post-merge and post-rewrite hooks run this after a pull (E185 part 4).
|
|
2
|
+
//
|
|
3
|
+
// When the pull changed the Product's local setup script (`.sdlc/local-setup.json`), it says, in one line, how
|
|
4
|
+
// many steps are new or changed for this machine, so the person (or their agent) runs `yad local-setup`.
|
|
5
|
+
//
|
|
6
|
+
// IT ONLY PRINTS. It runs no step, reaches no network, and never fails the pull: any error, an old git, a file
|
|
7
|
+
// that does not parse — it says nothing and exits 0. `YAD_HOOK_DISABLE=1` silences it.
|
|
8
|
+
//
|
|
9
|
+
// A NODE SCRIPT (E113), importing nothing outside Node itself. NEVER RUN FROM THE PRODUCT'S FILES: yad copies it
|
|
10
|
+
// from its own package into this clone's git folder (`.git/yad/local-setup-notice.mjs`), which a pull never
|
|
11
|
+
// changes — so a pull can never make a teammate's machine run code the pull brought (review 1). Git runs the hook
|
|
12
|
+
// from the top of the repo and passes the Product's folder within it (`.` when the Product is the repo). yad
|
|
13
|
+
// rewrites this copy; the Product turns the notice off with `"localSetupNotice": false` in .sdlc/product.json.
|
|
14
|
+
import { spawnSync } from 'node:child_process';
|
|
15
|
+
import { createHash } from 'node:crypto';
|
|
16
|
+
import fs from 'node:fs';
|
|
17
|
+
import path from 'node:path';
|
|
18
|
+
import { fileURLToPath } from 'node:url';
|
|
19
|
+
|
|
20
|
+
const FILE = '.sdlc/local-setup.json';
|
|
21
|
+
// The same as cli/local-setup-steps.mjs (a test keeps the two equal).
|
|
22
|
+
const STEP_ID = /^[a-z0-9][a-z0-9-]{0,62}$/;
|
|
23
|
+
export const stepHash = (step) => createHash('sha256')
|
|
24
|
+
.update(JSON.stringify({ commands: step.commands ?? [], check: step.check ?? null, when: step.when ?? 'optional' }))
|
|
25
|
+
.digest('hex').slice(0, 16);
|
|
26
|
+
|
|
27
|
+
// Every git call runs where git runs the hook — the top of the working tree — and names the Product's files by
|
|
28
|
+
// their path from there (`<prefix>.sdlc/…`). Never with -C into a subfolder: in a linked worktree git hands the hook
|
|
29
|
+
// GIT_DIR and no GIT_WORK_TREE, so a -C folder would become the top (review 2). Never fetches (a partial clone).
|
|
30
|
+
const git = (args) => {
|
|
31
|
+
const r = spawnSync('git', args, { encoding: 'utf8', maxBuffer: 16 * 1024 * 1024, windowsHide: true, timeout: 5_000, env: { ...process.env, GIT_NO_LAZY_FETCH: '1' } });
|
|
32
|
+
return r.status === 0 ? r.stdout : null;
|
|
33
|
+
};
|
|
34
|
+
// The Product's folder within the repo as git paths want it: '' for the top, else `dir/`.
|
|
35
|
+
const asPrefix = (p) => { const t = String(p || '').replace(/\\/g, '/').replace(/^\.(?:\/|$)|\/+$/g, ''); return t && t !== '.' ? `${t}/` : ''; };
|
|
36
|
+
const parse = (text) => {
|
|
37
|
+
if (text === null) return null;
|
|
38
|
+
try { const v = JSON.parse(text.charCodeAt(0) === 0xfeff ? text.slice(1) : text); return v && typeof v === 'object' && !Array.isArray(v) ? v : null; } catch { return null; }
|
|
39
|
+
};
|
|
40
|
+
// Every step of a script, `{ id → hash }`, both lists, ids yad would accept only.
|
|
41
|
+
const hashes = (doc) => {
|
|
42
|
+
const out = new Map();
|
|
43
|
+
for (const list of [doc?.yadflow, doc?.team]) {
|
|
44
|
+
if (!Array.isArray(list)) continue;
|
|
45
|
+
for (const s of list) if (s && typeof s === 'object' && typeof s.id === 'string' && STEP_ID.test(s.id) && !out.has(s.id)) out.set(s.id, stepHash(s));
|
|
46
|
+
}
|
|
47
|
+
return out;
|
|
48
|
+
};
|
|
49
|
+
|
|
50
|
+
// The steps the move from `before` to `after` brought that this machine has not answered as they are now.
|
|
51
|
+
// → the ids, in the script's order.
|
|
52
|
+
export function broughtSteps(before, after, record) {
|
|
53
|
+
const was = hashes(before);
|
|
54
|
+
const answered = record && typeof record.steps === 'object' && record.steps ? record.steps : {};
|
|
55
|
+
const ids = [];
|
|
56
|
+
for (const [id, hash] of hashes(after)) {
|
|
57
|
+
if (was.get(id) === hash) continue;
|
|
58
|
+
const a = Object.hasOwn(answered, id) ? answered[id] : null;
|
|
59
|
+
if (a && a.hash === hash) continue;
|
|
60
|
+
ids.push(id);
|
|
61
|
+
}
|
|
62
|
+
return ids;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
export function notice(product = '.') {
|
|
66
|
+
if (process.env.YAD_HOOK_DISABLE === '1') return null;
|
|
67
|
+
const at = asPrefix(product);
|
|
68
|
+
// The team turned it off (a hand line in a hook of its own still runs this copy): say nothing.
|
|
69
|
+
// The Product config, or its older name when that is all there is (`.sdlc/hub.json`).
|
|
70
|
+
const cfg = parse(git(['show', `HEAD:./${at}.sdlc/product.json`]) ?? git(['show', `HEAD:./${at}.sdlc/hub.json`]));
|
|
71
|
+
if (cfg && cfg.localSetupNotice === false) return null;
|
|
72
|
+
// No ORIG_HEAD: no move to compare. One without the file: the pull brought the script itself.
|
|
73
|
+
if (git(['rev-parse', '-q', '--verify', 'ORIG_HEAD^{commit}']) === null) return null;
|
|
74
|
+
const before = git(['show', `ORIG_HEAD:./${at}${FILE}`]) ?? '';
|
|
75
|
+
const after = git(['show', `HEAD:./${at}${FILE}`]);
|
|
76
|
+
if (after === null || before === after) return null;
|
|
77
|
+
// Read relative to where git runs (an older git than 2.31 has no --path-format).
|
|
78
|
+
const commonOut = (git(['rev-parse', '--git-common-dir']) || '').trim();
|
|
79
|
+
const common = commonOut ? path.resolve(process.cwd(), commonOut) : '';
|
|
80
|
+
let record = null;
|
|
81
|
+
if (common) { try { record = parse(fs.readFileSync(path.join(common, 'yad', 'local-setup-done.json'), 'utf8')); } catch { /* none yet */ } }
|
|
82
|
+
const ids = broughtSteps(parse(before), parse(after), record);
|
|
83
|
+
if (!ids.length) return null;
|
|
84
|
+
const shown = ids.length > 6 ? `${ids.slice(0, 6).join(', ')} and ${ids.length - 6} more` : ids.join(', ');
|
|
85
|
+
return `yad: the pull brought ${ids.length} local setup step(s) to look at (${shown}) — run \`yad local-setup\` (your agent: \`yad local-setup list --json\`)`;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
// Run as a hook: print the line, if any, and never fail.
|
|
89
|
+
// Real paths on both sides: Node runs the main module by its real path (a junction, a linked folder, a drive
|
|
90
|
+
// letter's case on Windows would otherwise keep this silent for good).
|
|
91
|
+
const real = (p) => { try { return fs.realpathSync(p); } catch { return path.resolve(p); } };
|
|
92
|
+
const isMain = !!process.argv[1] && real(process.argv[1]) === real(fileURLToPath(import.meta.url));
|
|
93
|
+
if (isMain) {
|
|
94
|
+
try { const line = notice(process.argv[2] || '.'); if (line) process.stderr.write(`${line}\n`); } catch { /* never fail the pull */ }
|
|
95
|
+
process.exitCode = 0;
|
|
96
|
+
}
|
|
@@ -0,0 +1,238 @@
|
|
|
1
|
+
// yad-activity HARNESS HOOK — the live activity record behind `yad brain view --live` (E178).
|
|
2
|
+
//
|
|
3
|
+
// Runs AFTER an agent uses a tool, and appends ONE line to `<git common dir>/yad-activity.jsonl`: what kind
|
|
4
|
+
// of thing it did (read, search, edit, run), which files of this repo it touched, and when. The live view
|
|
5
|
+
// tails that file and lights up the brain as the agent works.
|
|
6
|
+
//
|
|
7
|
+
// Wired by `yad check --fix` only when the Product sets `"activity": true` (off by default), in the Product
|
|
8
|
+
// and in each cloned code repo:
|
|
9
|
+
// Claude Code a `PostToolUse` hook in `.claude/settings.json`:
|
|
10
|
+
// node "$CLAUDE_PROJECT_DIR/hooks/yad-activity.mjs" --format claude
|
|
11
|
+
// Cursor `afterFileEdit` and `afterShellExecution` hooks in `.cursor/hooks.json`:
|
|
12
|
+
// node hooks/yad-activity.mjs --format cursor
|
|
13
|
+
// (in a code repo the file is `checks/yad-activity.mjs`, since a repo's own `hooks/` is often the app's).
|
|
14
|
+
//
|
|
15
|
+
// IT NEVER STARTS YAD: it fires on every file the agent reads, so it writes the line itself, with nothing
|
|
16
|
+
// but `node:` modules, in a few milliseconds.
|
|
17
|
+
//
|
|
18
|
+
// WHAT A LINE HOLDS — and nothing else, whatever the harness sends:
|
|
19
|
+
// { v: 1, ts, s, h, op, tool, paths, yad? }
|
|
20
|
+
// s the first 12 hex characters of sha256(session id) — sessions told apart, never named
|
|
21
|
+
// h 'claude' or 'cursor'
|
|
22
|
+
// op 'read' | 'search' | 'edit' | 'run'
|
|
23
|
+
// tool the harness's tool name (Read, Grep, Edit, Bash, afterFileEdit, …)
|
|
24
|
+
// paths up to 20 paths, relative to this repo; a path outside it, absolute, or reached through a link
|
|
25
|
+
// that leaves it is dropped
|
|
26
|
+
// yad for a shell command that is a yad command: '<command> [<action>]' from yad's own list — never the
|
|
27
|
+
// rest of the line
|
|
28
|
+
// NEVER STORED: search patterns, command text, prompts, file content, tool output, absolute paths.
|
|
29
|
+
//
|
|
30
|
+
// THE CONTRACT: it ALWAYS exits 0 and prints nothing on stdout, so it can never block or slow the agent. A
|
|
31
|
+
// problem is at most one line on stderr. A line is at most 4 KB, so an append lands whole even when two
|
|
32
|
+
// agents write at once. Above 5 MB the file is renamed to `yad-activity.1.jsonl` (one old file is kept).
|
|
33
|
+
import { createHash } from 'node:crypto';
|
|
34
|
+
import { spawnSync } from 'node:child_process';
|
|
35
|
+
import fs from 'node:fs';
|
|
36
|
+
import path from 'node:path';
|
|
37
|
+
import { fileURLToPath, pathToFileURL } from 'node:url';
|
|
38
|
+
|
|
39
|
+
export const LOG_NAME = 'yad-activity.jsonl';
|
|
40
|
+
export const OLD_LOG_NAME = 'yad-activity.1.jsonl';
|
|
41
|
+
export const ROTATE_AT = 5 * 1024 * 1024;
|
|
42
|
+
export const MAX_LINE = 4096;
|
|
43
|
+
export const MAX_PATHS = 20;
|
|
44
|
+
|
|
45
|
+
// The yad commands a `run` may name: every key of COMMAND_CLASS (cli/agent-rules.mjs), frozen here because a
|
|
46
|
+
// hook imports nothing of yad's. A test holds the two lists equal.
|
|
47
|
+
export const YAD_COMMANDS = Object.freeze([
|
|
48
|
+
'assign', 'brain build', 'brain file', 'brain query', 'brain status', 'brain story', 'brain view', 'build done', 'build merged',
|
|
49
|
+
'brand check', 'brand init', 'brand show', 'build ship', 'build start', 'build step', 'build sync', 'build trust', 'capture', 'check', 'checkpoint',
|
|
50
|
+
'ci check', 'claims', 'codeowners check', 'commit', 'defer', 'detect', 'dial', 'docs build', 'docs deploy',
|
|
51
|
+
'docs list', 'docs sync', 'doctor', 'epic new', 'fold', 'foundation new', 'foundation publish',
|
|
52
|
+
'foundation status', 'gate advance', 'gate approve', 'gate ci', 'gate comment', 'gate comments',
|
|
53
|
+
'gate open', 'gate reopen', 'gate repair', 'gate review', 'gate status', 'gate sync', 'gate trailer',
|
|
54
|
+
'gate walkthrough', 'guide', 'help', 'history list', 'history search', 'history show', 'hook agent-guard',
|
|
55
|
+
'hook ledger-guard', 'index', 'init', 'issues assign', 'issues close', 'issues comment', 'issues edit',
|
|
56
|
+
'issues label', 'issues labels', 'issues link', 'issues list', 'issues new', 'issues reopen',
|
|
57
|
+
'issues show', 'issues sync', 'issues unlink', 'join', 'kill', 'local-setup add', 'local-setup done', 'local-setup list', 'local-setup remove', 'local-setup skip', 'map', 'member add', 'member list',
|
|
58
|
+
'member remove', 'migrate', 'mode', 'mode solo', 'mode team', 'new', 'next', 'open-pr', 'owners',
|
|
59
|
+
'reconcile check', 'reconcile refresh', 'reconcile wire', 'repo clone', 'repo list', 'repo preview',
|
|
60
|
+
'repo refresh', 'repo sync', 'report', 'reports list', 'reports open', 'reports prune', 'review cards', 'review chat', 'review context', 'review nudge',
|
|
61
|
+
'review reconcile', 'review trailer', 'review walkthrough', 'risk-map check', 'risk-map draft', 'roster',
|
|
62
|
+
'run checks', 'scan file', 'setup', 'ship', 'signing check', 'skill bind', 'skill list', 'skill recommend',
|
|
63
|
+
'skill unbind', 'skip', 'standup', 'status', 'story frames', 'sync-status', 'thread', 'tidy up',
|
|
64
|
+
'toolbox add', 'toolbox check', 'toolbox connect', 'toolbox list', 'toolbox remove', 'unassign', 'unblock',
|
|
65
|
+
'undefer', 'unkill', 'unskip', 'update', 'usage', 'worktree add', 'worktree list', 'worktree remove',
|
|
66
|
+
]);
|
|
67
|
+
const KNOWN = new Set(YAD_COMMANDS);
|
|
68
|
+
|
|
69
|
+
const CLAUDE_OPS = new Map([
|
|
70
|
+
['Read', 'read'], ['Grep', 'search'], ['Glob', 'search'],
|
|
71
|
+
['Edit', 'edit'], ['Write', 'edit'], ['MultiEdit', 'edit'], ['NotebookEdit', 'edit'],
|
|
72
|
+
['Bash', 'run'],
|
|
73
|
+
]);
|
|
74
|
+
const CURSOR_OPS = new Map([['afterFileEdit', 'edit'], ['afterShellExecution', 'run']]);
|
|
75
|
+
|
|
76
|
+
const isObject = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
|
|
77
|
+
const short = (v, n) => (typeof v === 'string' ? v.slice(0, n) : null);
|
|
78
|
+
|
|
79
|
+
// The real path of `abs`: its nearest part that exists, resolved through its links, with the rest (not
|
|
80
|
+
// written yet, or deleted) added back by name. Null when nothing on the way exists.
|
|
81
|
+
function realOf(abs) {
|
|
82
|
+
let head = abs;
|
|
83
|
+
const tail = [];
|
|
84
|
+
for (;;) {
|
|
85
|
+
try { return path.join(fs.realpathSync(head), ...tail); } catch { /* go up one */ }
|
|
86
|
+
const up = path.dirname(head);
|
|
87
|
+
if (up === head) return null;
|
|
88
|
+
tail.unshift(path.basename(head));
|
|
89
|
+
head = up;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
// Text no harness sends as a file path, but that would read as a relative name: a home (`~`), a variable
|
|
94
|
+
// (`$HOME`, `%USERPROFILE%`), a URL (`file://…`), and — off Windows — a drive or a backslash path.
|
|
95
|
+
const NOT_A_PATH = process.platform === 'win32' ? /^[~$%]|^[a-z][a-z0-9+.-]*:\/\//i : /^[~$%]|[:\\]/;
|
|
96
|
+
|
|
97
|
+
// A path the harness gave, as a path relative to the repo, or null when it is not inside it. Judged on the
|
|
98
|
+
// REAL path (links resolved), against the repo's real root: a link inside the repo that points out is not the
|
|
99
|
+
// repo's, and a repo opened through a link (macOS /tmp, a linked projects folder, a Windows junction) still
|
|
100
|
+
// matches what the agent typed (E178 review 1).
|
|
101
|
+
export function repoPath(given, root, realRoot = root) {
|
|
102
|
+
if (typeof given !== 'string' || !given || given.length > 1024 || given.includes('\0') || NOT_A_PATH.test(given)) return null;
|
|
103
|
+
const real = realOf(path.resolve(root, given));
|
|
104
|
+
if (real === null) return null;
|
|
105
|
+
const rel = path.relative(realRoot, real);
|
|
106
|
+
if (!rel || rel.startsWith('..') || path.isAbsolute(rel)) return null;
|
|
107
|
+
return rel.split(path.sep).join('/');
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
// The yad command a shell line runs, as '<command> [<action>]', or null. Only a line that IS a yad command
|
|
111
|
+
// (optionally through npx) counts, and only words yad itself names are kept.
|
|
112
|
+
export function yadCommand(line) {
|
|
113
|
+
if (typeof line !== 'string') return null;
|
|
114
|
+
const m = /^\s*(?:npx\s+(?:--no-install\s+)?)?yad\s+([a-z][a-z-]{0,30})(?:\s+([a-z][a-z-]{0,30}))?(?=\s|$)/.exec(line);
|
|
115
|
+
if (!m) return null;
|
|
116
|
+
if (m[2] && KNOWN.has(`${m[1]} ${m[2]}`)) return `${m[1]} ${m[2]}`;
|
|
117
|
+
return KNOWN.has(m[1]) || YAD_COMMANDS.some((k) => k.startsWith(`${m[1]} `)) ? m[1] : null;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
// The record for one payload, or null when the tool is not one this records.
|
|
121
|
+
export function recordOf(payload, { root, realRoot = root, now = Date.now(), format = 'claude' } = {}) {
|
|
122
|
+
if (!isObject(payload) || !root) return null;
|
|
123
|
+
const claude = format === 'claude';
|
|
124
|
+
const tool = claude ? short(payload.tool_name, 40) : short(payload.hook_event_name, 40);
|
|
125
|
+
const op = tool && (claude ? CLAUDE_OPS : CURSOR_OPS).get(tool);
|
|
126
|
+
if (!op) return null;
|
|
127
|
+
const input = claude ? (isObject(payload.tool_input) ? payload.tool_input : {}) : payload;
|
|
128
|
+
const given = [];
|
|
129
|
+
for (const key of ['file_path', 'notebook_path', 'path']) if (typeof input[key] === 'string') given.push(input[key]);
|
|
130
|
+
if (Array.isArray(input.edits)) for (const e of input.edits) if (isObject(e) && typeof e.file_path === 'string') given.push(e.file_path);
|
|
131
|
+
const paths = [];
|
|
132
|
+
for (const g of given) {
|
|
133
|
+
const p = repoPath(g, root, realRoot);
|
|
134
|
+
if (p && !paths.includes(p) && paths.length < MAX_PATHS) paths.push(p);
|
|
135
|
+
}
|
|
136
|
+
const session = short(claude ? payload.session_id : payload.conversation_id, 200);
|
|
137
|
+
const rec = {
|
|
138
|
+
v: 1,
|
|
139
|
+
ts: new Date(now).toISOString(),
|
|
140
|
+
s: session ? createHash('sha256').update(session).digest('hex').slice(0, 12) : null,
|
|
141
|
+
h: claude ? 'claude' : 'cursor',
|
|
142
|
+
op,
|
|
143
|
+
tool,
|
|
144
|
+
paths,
|
|
145
|
+
};
|
|
146
|
+
if (op === 'run') {
|
|
147
|
+
const y = yadCommand(input.command);
|
|
148
|
+
if (y) rec.yad = y;
|
|
149
|
+
}
|
|
150
|
+
return rec;
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
// One line, never longer than MAX_LINE: paths are dropped from the end until it fits.
|
|
154
|
+
export function lineOf(rec) {
|
|
155
|
+
const r = { ...rec, paths: [...rec.paths] };
|
|
156
|
+
let line = `${JSON.stringify(r)}\n`;
|
|
157
|
+
while (Buffer.byteLength(line) > MAX_LINE && r.paths.length) { r.paths.pop(); line = `${JSON.stringify(r)}\n`; }
|
|
158
|
+
return Buffer.byteLength(line) > MAX_LINE ? null : line;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
// The folder git keeps this repo's shared data in. `<root>/.git` when it is a folder (the usual case, with
|
|
162
|
+
// no process started); for a worktree or a submodule, where `.git` is a file, git is asked.
|
|
163
|
+
export function gitCommonDir(root) {
|
|
164
|
+
const dotGit = path.join(root, '.git');
|
|
165
|
+
let here = null;
|
|
166
|
+
try { here = fs.lstatSync(dotGit); } catch { /* none here */ }
|
|
167
|
+
if (here && here.isDirectory()) return dotGit;
|
|
168
|
+
// No `.git` here: a repo whose root is ABOVE this folder (a Product in a subfolder, a monorepo app) —
|
|
169
|
+
// but only one that TRACKS files under it. A folder that merely sits inside some other repo (a home folder
|
|
170
|
+
// kept in git) is not that repo's, and its activity is written nowhere (E178 review 2). With no `.git`
|
|
171
|
+
// anywhere above, git is never started.
|
|
172
|
+
if (!here) {
|
|
173
|
+
let up = path.dirname(root);
|
|
174
|
+
let found = false;
|
|
175
|
+
for (;;) {
|
|
176
|
+
try { fs.lstatSync(path.join(up, '.git')); found = true; break; } catch { /* keep going */ }
|
|
177
|
+
const next = path.dirname(up);
|
|
178
|
+
if (next === up) break;
|
|
179
|
+
up = next;
|
|
180
|
+
}
|
|
181
|
+
if (!found) return null;
|
|
182
|
+
// One tracked file is the answer; a big folder's full list overflows a small buffer, and that is a yes
|
|
183
|
+
// too (E178 review 3), never a no.
|
|
184
|
+
const tracked = spawnSync('git', ['-C', root, 'ls-files', '-z', '--', '.'], { encoding: 'utf8', timeout: 2000, maxBuffer: 4096 });
|
|
185
|
+
const listed = String(tracked.stdout || '').length > 0;
|
|
186
|
+
if (!listed || (tracked.status !== 0 && tracked.error?.code !== 'ENOBUFS')) return null;
|
|
187
|
+
}
|
|
188
|
+
const r = spawnSync('git', ['-C', root, 'rev-parse', '--path-format=absolute', '--git-common-dir'], { encoding: 'utf8', timeout: 2000 });
|
|
189
|
+
const out = r.status === 0 ? String(r.stdout).trim() : '';
|
|
190
|
+
return out && path.isAbsolute(out) ? out : null;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
// Append one line, renaming a full log aside first.
|
|
194
|
+
export function appendLine(dir, line) {
|
|
195
|
+
const file = path.join(dir, LOG_NAME);
|
|
196
|
+
let size = 0;
|
|
197
|
+
try { const st = fs.lstatSync(file); if (!st.isFile()) return; size = st.size; } catch { /* first line */ }
|
|
198
|
+
if (size + Buffer.byteLength(line) > ROTATE_AT) {
|
|
199
|
+
try { fs.renameSync(file, path.join(dir, OLD_LOG_NAME)); } catch { /* another agent rotated it first */ }
|
|
200
|
+
}
|
|
201
|
+
fs.appendFileSync(file, line, { flag: 'a' });
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
// Read the payload: never from a terminal, at most a second, at most 1 MB.
|
|
205
|
+
function readStdin() {
|
|
206
|
+
if (process.stdin.isTTY) return Promise.resolve('');
|
|
207
|
+
return new Promise((resolve) => {
|
|
208
|
+
const chunks = [];
|
|
209
|
+
let size = 0;
|
|
210
|
+
const done = () => { clearTimeout(timer); process.stdin.pause(); resolve(Buffer.concat(chunks).toString('utf8')); };
|
|
211
|
+
const timer = setTimeout(done, 1000);
|
|
212
|
+
process.stdin.on('data', (d) => { size += d.length; if (size <= 1024 * 1024) chunks.push(d); });
|
|
213
|
+
process.stdin.on('end', done);
|
|
214
|
+
process.stdin.on('error', done);
|
|
215
|
+
process.stdin.resume();
|
|
216
|
+
});
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
async function main() {
|
|
220
|
+
const text = await readStdin();
|
|
221
|
+
const argv = process.argv.slice(2);
|
|
222
|
+
const i = argv.indexOf('--format');
|
|
223
|
+
const format = i >= 0 && argv[i + 1] === 'cursor' ? 'cursor' : 'claude';
|
|
224
|
+
// The repo is this script's grandparent: `<repo>/hooks/yad-activity.mjs` or `<repo>/checks/yad-activity.mjs`.
|
|
225
|
+
const root = path.dirname(path.dirname(fs.realpathSync(fileURLToPath(import.meta.url))));
|
|
226
|
+
let payload;
|
|
227
|
+
try { payload = JSON.parse(text); } catch { return; }
|
|
228
|
+
const rec = recordOf(payload, { root, realRoot: fs.realpathSync(root), format });
|
|
229
|
+
if (!rec) return;
|
|
230
|
+
const line = lineOf(rec);
|
|
231
|
+
const dir = line && gitCommonDir(root);
|
|
232
|
+
if (dir) appendLine(dir, line);
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
// Run only as the hook itself; a test imports the functions above.
|
|
236
|
+
if (process.argv[1] && import.meta.url === pathToFileURL(fs.realpathSync(process.argv[1])).href) {
|
|
237
|
+
main().catch((e) => { process.stderr.write(` • yad activity: ${String(e?.message || e).slice(0, 200)}\n`); }).finally(() => process.exit(0));
|
|
238
|
+
}
|
|
@@ -196,6 +196,20 @@ locally only.
|
|
|
196
196
|
Report the connected repo, its `platform`, the pack + code-map paths, the secret-scan result, and that
|
|
197
197
|
the Shape phases will now load this repo's code-map. Nothing auto-advances; this is setup.
|
|
198
198
|
|
|
199
|
+
Optionally, offer to build the **project brain** (E176) — one knowledge graph of the code and the work
|
|
200
|
+
items, on this machine only: **`yad brain build`**. It runs Graphify in each connected repo with its LLM
|
|
201
|
+
pass off (code is parsed locally; nothing leaves the machine), writes `.sdlc/brain/`, which ignores
|
|
202
|
+
itself, and commits nothing. Without Graphify it builds the work items alone and says how to install it
|
|
203
|
+
(`yad toolbox connect graphify`). Then `yad brain query <text>` answers "which story touches this file?",
|
|
204
|
+
and `yad brain view --open` draws the graph in the person's browser (E177): a local page only this machine
|
|
205
|
+
can reach, until Ctrl-C. It keeps running, so start it for the person to open rather than waiting on it; or
|
|
206
|
+
use `yad brain view --html --open`, which writes one offline file and returns.
|
|
207
|
+
To watch an agent work through the brain live (E178), the Product sets `"activity": true` and runs
|
|
208
|
+
`yad check --fix`; then `yad brain view --live --open` shows each file the agent reads, searches or edits
|
|
209
|
+
against the task's declared files. It records what the agent did, never why.
|
|
210
|
+
Once built, the planning and building skills ask it themselves (E179): `yad brain file <repo>/<path>`
|
|
211
|
+
(who declares a file, what uses it) and `yad brain story <id>` (a story's tasks and their files).
|
|
212
|
+
|
|
199
213
|
## Other actions
|
|
200
214
|
|
|
201
215
|
- **`refresh`** — re-run Steps 2–4 (including Step 3b) for an already-connected repo (after its code moves). A new directory gets an `unset` line and a guess; a `confirmed` line is only ever suggested against. Updates
|
|
@@ -162,6 +162,17 @@ each `yad-epic` reads (its "Step 2c"). When the Product has a platform, the gate
|
|
|
162
162
|
Product (via `yad-product-bridge`) and `yad-review-gate action: sync` pulls platform approvals and comments
|
|
163
163
|
into the ledger; otherwise the review is recorded locally.
|
|
164
164
|
|
|
165
|
+
**Once the review has passed and the Product has a platform, offer to publish the roadmap** (E174). Ask the
|
|
166
|
+
person, then run `yad foundation publish --dry-run` to show what it would create, then `yad foundation publish`.
|
|
167
|
+
It opens one issue or work item per roadmap feature in the Product repo: type feature, a priority by phase
|
|
168
|
+
(the first phase, the MVP, is P1; the next P2; later ones P3), the label `epic: EP-x`, and the phase as its
|
|
169
|
+
milestone. The `Later / parked` phase is left out. If the Foundation changed after its review, the command refuses:
|
|
170
|
+
the changed roadmap needs a new review first. Report the links, and remind the person to commit
|
|
171
|
+
`foundation/.sdlc/roadmap-items.json` on a branch of its own, not a `review/…` one, and open a pull request
|
|
172
|
+
(`chore: record tracker links`). A review branch would advance a step. On a verified Product, the Product
|
|
173
|
+
checks let a pull request of that file, the epics' `.sdlc/issue-links.json` files and step owner files alone
|
|
174
|
+
through from any branch (#512), once a `yad update` carrying that rule has merged on the default branch.
|
|
175
|
+
|
|
165
176
|
## Reference
|
|
166
177
|
- Foundation section templates: `references/foundation-schema.md`.
|
|
167
178
|
- The older spelling of the Product level (`EP-discovery`, its six files, and how it converts):
|
|
@@ -372,3 +372,14 @@ action happen before the risk would hurt?
|
|
|
372
372
|
| Only one flatmate uses it | The ledger is useless if others do not log | Measure second-member activity from week 1; stop if under 20% |
|
|
373
373
|
| People want it to move money | "Not a payment app" loses them | Ask the first 20 flats; revisit scope.md at 8 weeks |
|
|
374
374
|
```
|
|
375
|
+
|
|
376
|
+
## `.sdlc/roadmap-items.json` (E174)
|
|
377
|
+
|
|
378
|
+
Written by `yad foundation publish`, after the review has passed. It records which issue or work item each roadmap feature was published as. It is outside the Foundation's fingerprint, so writing it never makes the review stale. Commit it on a branch of its own, not a `review/…` one: on a verified Product, the Product checks let a pull request of this file (with the epics' `.sdlc/issue-links.json` files and step owner files, or alone) through from any branch (#512), once a `yad update` carrying that rule has merged on the default branch.
|
|
379
|
+
|
|
380
|
+
```json
|
|
381
|
+
{ "items": [{ "epicId": "EP-checkout", "platform": "github", "host": "github.com", "repo": "acme/product", "number": 12, "url": "https://github.com/acme/product/issues/12", "publishedAt": "2026-11-10T10:00:00.000Z" }] }
|
|
382
|
+
```
|
|
383
|
+
|
|
384
|
+
A file that cannot be parsed is refused, never overwritten.
|
|
385
|
+
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "yadflow-docs-site",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.6",
|
|
4
4
|
"lockfileVersion": 3,
|
|
5
5
|
"requires": true,
|
|
6
6
|
"packages": {
|
|
7
7
|
"": {
|
|
8
8
|
"name": "yadflow-docs-site",
|
|
9
|
-
"version": "0.0.
|
|
9
|
+
"version": "0.0.6",
|
|
10
10
|
"dependencies": {
|
|
11
11
|
"framer-motion": "^12.34.4",
|
|
12
12
|
"react": "^19.2.0",
|
|
@@ -570,6 +570,13 @@
|
|
|
570
570
|
"url": "https://github.com/sponsors/nzakas"
|
|
571
571
|
}
|
|
572
572
|
},
|
|
573
|
+
"node_modules/@isaacs/nonrecursive-glob-match": {
|
|
574
|
+
"version": "1.1.0",
|
|
575
|
+
"resolved": "https://registry.npmjs.org/@isaacs/nonrecursive-glob-match/-/nonrecursive-glob-match-1.1.0.tgz",
|
|
576
|
+
"integrity": "sha512-GPm/Dbvk5RLmhRnxXIa7nTpK0xtl4E0wj0MslsuNiJ1FIROU+2+9lgUC/dgF7Ey4QCWhfEsgxilMRMCdHPfDfw==",
|
|
577
|
+
"dev": true,
|
|
578
|
+
"license": "BlueOak-1.0.0"
|
|
579
|
+
},
|
|
573
580
|
"node_modules/@jridgewell/gen-mapping": {
|
|
574
581
|
"version": "0.3.13",
|
|
575
582
|
"resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz",
|
|
@@ -1513,16 +1520,17 @@
|
|
|
1513
1520
|
}
|
|
1514
1521
|
},
|
|
1515
1522
|
"node_modules/@typescript-eslint/typescript-estree/node_modules/minimatch": {
|
|
1516
|
-
"version": "
|
|
1517
|
-
"resolved": "https://registry.npmjs.org/minimatch/-/minimatch-
|
|
1518
|
-
"integrity": "sha512-
|
|
1523
|
+
"version": "11.0.8",
|
|
1524
|
+
"resolved": "https://registry.npmjs.org/minimatch/-/minimatch-11.0.8.tgz",
|
|
1525
|
+
"integrity": "sha512-nFQuYSTVrGvysVBps5Ih+0BdnYFN/Cj3C816r6+p7yK+FHrVLGE4O4N9AFwykrlNlvM2HYt+Rad1Uiro6h88Ig==",
|
|
1519
1526
|
"dev": true,
|
|
1520
1527
|
"license": "BlueOak-1.0.0",
|
|
1521
1528
|
"dependencies": {
|
|
1522
|
-
"
|
|
1529
|
+
"@isaacs/nonrecursive-glob-match": "^1.1.0",
|
|
1530
|
+
"brace-expansion": "^5.0.12"
|
|
1523
1531
|
},
|
|
1524
1532
|
"engines": {
|
|
1525
|
-
"node": "
|
|
1533
|
+
"node": "20 || >=22"
|
|
1526
1534
|
},
|
|
1527
1535
|
"funding": {
|
|
1528
1536
|
"url": "https://github.com/sponsors/isaacs"
|
|
@@ -3787,9 +3795,9 @@
|
|
|
3787
3795
|
}
|
|
3788
3796
|
},
|
|
3789
3797
|
"node_modules/zod": {
|
|
3790
|
-
"version": "4.
|
|
3791
|
-
"resolved": "https://registry.npmjs.org/zod/-/zod-4.
|
|
3792
|
-
"integrity": "sha512-
|
|
3798
|
+
"version": "4.6.7",
|
|
3799
|
+
"resolved": "https://registry.npmjs.org/zod/-/zod-4.6.7.tgz",
|
|
3800
|
+
"integrity": "sha512-g8W2D2kU6a8untc053fX1uVBKzM7yqAxW/3zwk83+6RyF2+SKOuV+c0wBDhUwzV1PaGapmZH+rmcUzPf+3CGwg==",
|
|
3793
3801
|
"dev": true,
|
|
3794
3802
|
"license": "MIT",
|
|
3795
3803
|
"funding": {
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "yadflow-docs-site",
|
|
3
3
|
"private": true,
|
|
4
|
-
"version": "0.0.
|
|
4
|
+
"version": "0.0.6",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"scripts": {
|
|
7
7
|
"dev": "vite",
|
|
@@ -31,5 +31,10 @@
|
|
|
31
31
|
"typescript": "~5.9.3",
|
|
32
32
|
"typescript-eslint": "^8.48.0",
|
|
33
33
|
"vite": "^8.3.5"
|
|
34
|
+
},
|
|
35
|
+
"overrides": {
|
|
36
|
+
"@typescript-eslint/typescript-estree": {
|
|
37
|
+
"minimatch": "^11.0.8"
|
|
38
|
+
}
|
|
34
39
|
}
|
|
35
40
|
}
|