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
@@ -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: a PR that changes only owner files passes on any branch. The
390
- workflow builds the list with `--no-renames` (and `core.quotePath=false`), so a rename INTO
391
- `owners/` still lists the artifact it removed. A path git still C-quotes (a `"`, `\`, tab or
392
- newline in its name) counts as an artifact change and never as an owner file. Both greps run with
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
- - run: bash "$YAD_CHECKS/install-deps.sh"
231
- - run: bash "$YAD_CHECKS/build-test-lint.sh"
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
- - bash "$YAD_CHECKS/install-deps.sh"
127
- - bash "$YAD_CHECKS/build-test-lint.sh"
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.4",
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.4",
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": "10.2.4",
1517
- "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.4.tgz",
1518
- "integrity": "sha512-oRjTw/97aTBN0RHbYCdtF1MQfvusSIBQM0IZEgzl6426+8jSC0nF1a/GmnVLpfB9yyr6g6FTqWqiZVbxrtaCIg==",
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
- "brace-expansion": "^5.0.2"
1529
+ "@isaacs/nonrecursive-glob-match": "^1.1.0",
1530
+ "brace-expansion": "^5.0.12"
1523
1531
  },
1524
1532
  "engines": {
1525
- "node": "18 || 20 || >=22"
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.3.6",
3791
- "resolved": "https://registry.npmjs.org/zod/-/zod-4.3.6.tgz",
3792
- "integrity": "sha512-rftlrkhHZOcjDwkGlnUtZZkvaPHCsDATp4pGpuOOMDaTdDDXF91wuVDJoWoPsKX/3YPQ5fHuF3STjcYyKr+Qhg==",
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",
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
  }