vouchington-tooling 0.63.0 → 0.65.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 (90) hide show
  1. package/README.md +109 -7
  2. package/dist/cli/commands/cloc.d.mts +7 -0
  3. package/dist/cli/commands/cloc.mjs +47 -0
  4. package/dist/cli/commands/storybook-browser-runner.d.mts +7 -0
  5. package/dist/cli/commands/storybook-browser-runner.mjs +29 -0
  6. package/dist/cli/commands/worktree.d.mts +1 -1
  7. package/dist/cli/commands/worktree.mjs +54 -7
  8. package/dist/cli/index.mjs +4 -0
  9. package/dist/cli/parse-forwarded-commands.d.mts +6 -0
  10. package/dist/cli/parse-forwarded-commands.mjs +4 -0
  11. package/dist/cli/parse.d.mts +6 -0
  12. package/dist/cli/usage-text.d.mts +1 -1
  13. package/dist/cli/usage-text.mjs +19 -1
  14. package/dist/cloc/child-process.d.mts +3 -0
  15. package/dist/cloc/child-process.mjs +14 -0
  16. package/dist/cloc/classify.d.mts +8 -0
  17. package/dist/cloc/classify.mjs +20 -0
  18. package/dist/cloc/config-load.d.mts +7 -0
  19. package/dist/cloc/config-load.mjs +26 -0
  20. package/dist/cloc/config.d.mts +55 -0
  21. package/dist/cloc/config.mjs +109 -0
  22. package/dist/cloc/count.d.mts +9 -0
  23. package/dist/cloc/count.mjs +33 -0
  24. package/dist/cloc/index.d.mts +12 -0
  25. package/dist/cloc/index.mjs +7 -0
  26. package/dist/cloc/layout.test-helpers.d.mts +8 -0
  27. package/dist/cloc/layout.test-helpers.mjs +42 -0
  28. package/dist/cloc/paths.d.mts +7 -0
  29. package/dist/cloc/paths.mjs +29 -0
  30. package/dist/cloc/patterns.d.mts +10 -0
  31. package/dist/cloc/patterns.mjs +25 -0
  32. package/dist/cloc/rows.d.mts +13 -0
  33. package/dist/cloc/rows.mjs +42 -0
  34. package/dist/cloc/scc.d.mts +10 -0
  35. package/dist/cloc/scc.mjs +55 -0
  36. package/dist/cloc/tracked.d.mts +4 -0
  37. package/dist/cloc/tracked.mjs +40 -0
  38. package/dist/command-policy/engine.mjs +9 -2
  39. package/dist/command-policy/hook/post-tool-use.mjs +3 -0
  40. package/dist/git-worktrees/assess.d.mts +15 -0
  41. package/dist/git-worktrees/assess.mjs +25 -6
  42. package/dist/git-worktrees/reclaim.d.mts +15 -2
  43. package/dist/git-worktrees/reclaim.mjs +49 -11
  44. package/dist/git-worktrees/reclaim.test-helpers.mjs +11 -5
  45. package/dist/git-worktrees/run.d.mts +2 -0
  46. package/dist/git-worktrees/run.mjs +4 -1
  47. package/dist/shell-parse/shell-heredoc.mjs +9 -1
  48. package/dist/storybook-browser-runner/args.d.mts +8 -0
  49. package/dist/storybook-browser-runner/args.mjs +52 -0
  50. package/dist/storybook-browser-runner/attempt-result.d.mts +41 -0
  51. package/dist/storybook-browser-runner/attempt-result.mjs +108 -0
  52. package/dist/storybook-browser-runner/bootstrap-telemetry.d.mts +35 -0
  53. package/dist/storybook-browser-runner/bootstrap-telemetry.mjs +138 -0
  54. package/dist/storybook-browser-runner/cache-plan.d.mts +22 -0
  55. package/dist/storybook-browser-runner/cache-plan.mjs +53 -0
  56. package/dist/storybook-browser-runner/diagnostics.d.mts +8 -0
  57. package/dist/storybook-browser-runner/diagnostics.mjs +29 -0
  58. package/dist/storybook-browser-runner/env.d.mts +2 -0
  59. package/dist/storybook-browser-runner/env.mjs +59 -0
  60. package/dist/storybook-browser-runner/fixtures.test-helpers.d.mts +49 -0
  61. package/dist/storybook-browser-runner/fixtures.test-helpers.mjs +95 -0
  62. package/dist/storybook-browser-runner/index.d.mts +15 -0
  63. package/dist/storybook-browser-runner/index.mjs +70 -0
  64. package/dist/storybook-browser-runner/observer-state.d.mts +22 -0
  65. package/dist/storybook-browser-runner/observer-state.mjs +21 -0
  66. package/dist/storybook-browser-runner/options.d.mts +18 -0
  67. package/dist/storybook-browser-runner/options.mjs +49 -0
  68. package/dist/storybook-browser-runner/output-observer.d.mts +37 -0
  69. package/dist/storybook-browser-runner/output-observer.mjs +130 -0
  70. package/dist/storybook-browser-runner/output-patterns.d.mts +14 -0
  71. package/dist/storybook-browser-runner/output-patterns.mjs +26 -0
  72. package/dist/storybook-browser-runner/quiet-output.d.mts +16 -0
  73. package/dist/storybook-browser-runner/quiet-output.mjs +79 -0
  74. package/dist/storybook-browser-runner/run-attempt.d.mts +14 -0
  75. package/dist/storybook-browser-runner/run-attempt.mjs +111 -0
  76. package/dist/storybook-browser-runner/runtime-metadata.d.mts +12 -0
  77. package/dist/storybook-browser-runner/runtime-metadata.mjs +50 -0
  78. package/dist/storybook-browser-runner/session-deps.d.mts +11 -0
  79. package/dist/storybook-browser-runner/session-deps.mjs +70 -0
  80. package/dist/storybook-browser-runner/types.d.mts +49 -0
  81. package/dist/storybook-browser-runner/types.mjs +1 -0
  82. package/dist/storybook-browser-runner/vite-detectors.d.mts +6 -0
  83. package/dist/storybook-browser-runner/vite-detectors.mjs +20 -0
  84. package/dist/storybook-browser-runner/watchdog.d.mts +23 -0
  85. package/dist/storybook-browser-runner/watchdog.mjs +55 -0
  86. package/package.json +12 -2
  87. package/scripts/__pycache__/run_bounded_process.cpython-312.pyc +0 -0
  88. package/skills/blackboard/SKILL.md +6 -3
  89. package/skills/manifest.json +20 -20
  90. package/skills/retrospective-distill/SKILL.md +3 -4
@@ -0,0 +1,55 @@
1
+ import { resolve } from 'node:path';
2
+ const MAX_WATCHDOG_INTERVAL_MS = 5000;
3
+ /** Terminates the attempt on an optimizer stall, a mid-suite stall, or a tester-connection hang. */
4
+ export function createStorybookWatchdog(options) {
5
+ const { deps, hangMs, observer, outcome, stallMs } = options;
6
+ return (controller) => {
7
+ // The first decision is final: later ticks during the termination grace must not repeat it.
8
+ let decided = false;
9
+ const check = () => {
10
+ const now = deps.now();
11
+ sampleCompletionFile(options);
12
+ if (decided)
13
+ return;
14
+ const seen = observer.snapshot();
15
+ if (!seen.semanticProgressSeen &&
16
+ seen.optimizerLastProgressAt != null &&
17
+ now - seen.optimizerLastProgressAt >= stallMs) {
18
+ outcome.stalled = true;
19
+ deps.stderr.write(`[storybook-browser] Vite optimizer made no startup progress for ${stallMs}ms; terminating attempt\n`);
20
+ decided = true;
21
+ controller.terminate();
22
+ }
23
+ else if (seen.semanticProgressSeen && now - seen.lastSemanticProgressAt >= hangMs) {
24
+ outcome.semanticStall = true;
25
+ deps.stderr.write(`[storybook-browser] no semantic test progress for ${hangMs}ms; terminating terminal mid-suite stall\n`);
26
+ decided = true;
27
+ controller.terminate();
28
+ }
29
+ else if (seen.anyOutputSeen &&
30
+ !seen.semanticProgressSeen &&
31
+ now - seen.lastHangProgressAt >= hangMs) {
32
+ outcome.hung = true;
33
+ deps.stderr.write(`[storybook-browser] no test output for ${hangMs}ms after Vite startup — suspected Vitest/Chromium tester-connection hang; last output:\n${seen.outputBuffer}\n`);
34
+ decided = true;
35
+ controller.terminate();
36
+ }
37
+ };
38
+ const interval = deps.setInterval(check, Math.min(MAX_WATCHDOG_INTERVAL_MS, stallMs, hangMs));
39
+ return () => deps.clearInterval(interval);
40
+ };
41
+ }
42
+ /** Records when the completion file first appears; also sampled once more as an attempt ends. */
43
+ export function sampleCompletionFile(options) {
44
+ const { completionFile, deps, outcome } = options;
45
+ if (!completionFile || outcome.resultFileDetectedAt != null)
46
+ return;
47
+ if (deps.existsSync(resolve(deps.cwd, completionFile)))
48
+ outcome.resultFileDetectedAt = deps.now();
49
+ }
50
+ export function isSpawnedProcessGroupId(processGroupId) {
51
+ return (processGroupId != null &&
52
+ Number.isSafeInteger(processGroupId) &&
53
+ processGroupId > 1 &&
54
+ processGroupId <= 2_147_483_647);
55
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vouchington-tooling",
3
- "version": "0.63.0",
3
+ "version": "0.65.0",
4
4
  "description": "Vouchington CLI and extractable tooling libraries.",
5
5
  "homepage": "https://github.com/vouchington/vouchington-tooling/tree/main/packages/vouchington-tooling#readme",
6
6
  "bugs": {
@@ -321,6 +321,16 @@
321
321
  "import": "./dist/dead-code/index.mjs",
322
322
  "default": "./dist/dead-code/index.mjs"
323
323
  },
324
+ "./cloc": {
325
+ "types": "./dist/cloc/index.d.mts",
326
+ "import": "./dist/cloc/index.mjs",
327
+ "default": "./dist/cloc/index.mjs"
328
+ },
329
+ "./storybook-browser-runner": {
330
+ "types": "./dist/storybook-browser-runner/index.d.mts",
331
+ "import": "./dist/storybook-browser-runner/index.mjs",
332
+ "default": "./dist/storybook-browser-runner/index.mjs"
333
+ },
324
334
  "./sandbox-command-audit": {
325
335
  "types": "./dist/sandbox-command-audit/index.d.mts",
326
336
  "import": "./dist/sandbox-command-audit/index.mjs",
@@ -472,7 +482,7 @@
472
482
  "yaml": "2.9.1"
473
483
  },
474
484
  "devDependencies": {
475
- "@ast-grep/cli": "0.50.0",
485
+ "@ast-grep/cli": "0.51.0",
476
486
  "@modelcontextprotocol/sdk": "1.32.1",
477
487
  "@playwright/test": "1.64.1",
478
488
  "@types/pg": "8.23.1",
@@ -62,9 +62,12 @@ report the blocker.
62
62
 
63
63
  ## Journaling policy
64
64
 
65
- 1. Capture consequential observations before filing an issue: failed or recovered checks, denied or
66
- approved permissions, repeated fixes, scope changes, first-party tool behavior, and architectural
67
- findings. Record useful resolved outcomes as well as unresolved gaps. Include bounded evidence,
65
+ 1. Friction is the primary thing to journal: failed or recovered checks, denied or approved
66
+ permissions, scope changes, repeated fixes, and reusable tool gaps. Capture it before filing an
67
+ issue. Broader consequential observations, such as first-party tool behavior and architectural
68
+ findings, are allowed but secondary: add them after the friction is recorded, never in place of
69
+ it. A consumer wrapper may add repository-specific triggers but does not narrow this list.
70
+ Record useful resolved outcomes as well as unresolved gaps. Include bounded evidence,
68
71
  affected areas, an explicit disposition, and an existing tracking reference when present.
69
72
  Journal meaningful skips or bypasses of applicable configured workflows before completion, with
70
73
  the owning workflow or command-catalog entrypoint, reason, and observed result/action.
@@ -4,7 +4,7 @@
4
4
  {
5
5
  "name": "agent-workflow",
6
6
  "plugin": "vouchington-workflow",
7
- "pluginVersion": "0.14.0",
7
+ "pluginVersion": "0.14.1",
8
8
  "path": "agent-workflow/SKILL.md",
9
9
  "prerequisites": [
10
10
  "blackboard",
@@ -24,7 +24,7 @@
24
24
  {
25
25
  "name": "blackboard",
26
26
  "plugin": "vouchington-workflow",
27
- "pluginVersion": "0.14.0",
27
+ "pluginVersion": "0.14.1",
28
28
  "path": "blackboard/SKILL.md"
29
29
  },
30
30
  {
@@ -36,7 +36,7 @@
36
36
  {
37
37
  "name": "dependabot",
38
38
  "plugin": "vouchington-workflow",
39
- "pluginVersion": "0.14.0",
39
+ "pluginVersion": "0.14.1",
40
40
  "path": "dependabot/SKILL.md",
41
41
  "prerequisites": ["github-actions-checklist"]
42
42
  },
@@ -50,26 +50,26 @@
50
50
  {
51
51
  "name": "git-commit-checklist",
52
52
  "plugin": "vouchington-workflow",
53
- "pluginVersion": "0.14.0",
53
+ "pluginVersion": "0.14.1",
54
54
  "path": "git-commit-checklist/SKILL.md"
55
55
  },
56
56
  {
57
57
  "name": "github-actions-authoring",
58
58
  "plugin": "vouchington-workflow",
59
- "pluginVersion": "0.14.0",
59
+ "pluginVersion": "0.14.1",
60
60
  "path": "github-actions-authoring/SKILL.md",
61
61
  "prerequisites": ["github-actions-checklist"]
62
62
  },
63
63
  {
64
64
  "name": "github-actions-checklist",
65
65
  "plugin": "vouchington-workflow",
66
- "pluginVersion": "0.14.0",
66
+ "pluginVersion": "0.14.1",
67
67
  "path": "github-actions-checklist/SKILL.md"
68
68
  },
69
69
  {
70
70
  "name": "github-issue",
71
71
  "plugin": "vouchington-workflow",
72
- "pluginVersion": "0.14.0",
72
+ "pluginVersion": "0.14.1",
73
73
  "path": "github-issue/SKILL.md"
74
74
  },
75
75
  {
@@ -82,26 +82,26 @@
82
82
  {
83
83
  "name": "npm-publishing",
84
84
  "plugin": "vouchington-workflow",
85
- "pluginVersion": "0.14.0",
85
+ "pluginVersion": "0.14.1",
86
86
  "path": "npm-publishing/SKILL.md"
87
87
  },
88
88
  {
89
89
  "name": "organize-github-issues",
90
90
  "plugin": "vouchington-workflow",
91
- "pluginVersion": "0.14.0",
91
+ "pluginVersion": "0.14.1",
92
92
  "path": "organize-github-issues/SKILL.md",
93
93
  "prerequisites": ["github-issue"]
94
94
  },
95
95
  {
96
96
  "name": "package-json-checklist",
97
97
  "plugin": "vouchington-workflow",
98
- "pluginVersion": "0.14.0",
98
+ "pluginVersion": "0.14.1",
99
99
  "path": "package-json-checklist/SKILL.md"
100
100
  },
101
101
  {
102
102
  "name": "planning",
103
103
  "plugin": "vouchington-workflow",
104
- "pluginVersion": "0.14.0",
104
+ "pluginVersion": "0.14.1",
105
105
  "path": "planning/SKILL.md",
106
106
  "prerequisites": ["github-issue"]
107
107
  },
@@ -133,53 +133,53 @@
133
133
  {
134
134
  "name": "pr-description",
135
135
  "plugin": "vouchington-workflow",
136
- "pluginVersion": "0.14.0",
136
+ "pluginVersion": "0.14.1",
137
137
  "path": "pr-description/SKILL.md"
138
138
  },
139
139
  {
140
140
  "name": "retrospective",
141
141
  "plugin": "vouchington-workflow",
142
- "pluginVersion": "0.14.0",
142
+ "pluginVersion": "0.14.1",
143
143
  "path": "retrospective/SKILL.md"
144
144
  },
145
145
  {
146
146
  "name": "retrospective-distill",
147
147
  "plugin": "vouchington-workflow",
148
- "pluginVersion": "0.14.0",
148
+ "pluginVersion": "0.14.1",
149
149
  "path": "retrospective-distill/SKILL.md",
150
150
  "prerequisites": ["github-issue"]
151
151
  },
152
152
  {
153
153
  "name": "review-ci-logs",
154
154
  "plugin": "vouchington-workflow",
155
- "pluginVersion": "0.14.0",
155
+ "pluginVersion": "0.14.1",
156
156
  "path": "review-ci-logs/SKILL.md",
157
157
  "prerequisites": ["github-actions-checklist", "pr-description"]
158
158
  },
159
159
  {
160
160
  "name": "review-github-issue-taxonomy",
161
161
  "plugin": "vouchington-workflow",
162
- "pluginVersion": "0.14.0",
162
+ "pluginVersion": "0.14.1",
163
163
  "path": "review-github-issue-taxonomy/SKILL.md",
164
164
  "prerequisites": ["github-issue"]
165
165
  },
166
166
  {
167
167
  "name": "revisit-followups",
168
168
  "plugin": "vouchington-workflow",
169
- "pluginVersion": "0.14.0",
169
+ "pluginVersion": "0.14.1",
170
170
  "path": "revisit-followups/SKILL.md",
171
171
  "prerequisites": ["github-issue"]
172
172
  },
173
173
  {
174
174
  "name": "stacked-prs",
175
175
  "plugin": "vouchington-workflow",
176
- "pluginVersion": "0.14.0",
176
+ "pluginVersion": "0.14.1",
177
177
  "path": "stacked-prs/SKILL.md"
178
178
  },
179
179
  {
180
180
  "name": "static-analysis-checklist",
181
181
  "plugin": "vouchington-workflow",
182
- "pluginVersion": "0.14.0",
182
+ "pluginVersion": "0.14.1",
183
183
  "path": "static-analysis-checklist/SKILL.md",
184
184
  "prerequisites": ["github-actions-checklist"]
185
185
  },
@@ -206,7 +206,7 @@
206
206
  {
207
207
  "name": "triage-prs",
208
208
  "plugin": "vouchington-workflow",
209
- "pluginVersion": "0.14.0",
209
+ "pluginVersion": "0.14.1",
210
210
  "path": "triage-prs/SKILL.md",
211
211
  "prerequisites": [
212
212
  "pr-description",
@@ -108,10 +108,9 @@ difference is a conflicting payload and stays quarantined.
108
108
  alone makes a stale checkpoint-only, journal-only, or zero-entry session eligible, so a
109
109
  retrospective-only gate cannot strand it. Everything else is not yet eligible; skip it with a
110
110
  reason.
111
- - Export unfiltered rather than with `inactiveForHours`: a zero-entry session has no last entry and
112
- never matches that filter, which would hide the feedback gaps this pass exists to sweep up.
113
- Derive age from the cutoffs above; they supply the delay for outboxes in removed worktrees or on
114
- other machines.
111
+ - Export unfiltered; the retrospective and session cutoffs above decide eligibility, and too-new
112
+ sessions must still appear as skipped with a reason. Derive age from the cutoffs above; they supply the delay for outboxes in
113
+ removed worktrees or on other machines.
115
114
  - Journal-only and zero-entry evidence get full issue-filing rights, subject to the same duplicate,
116
115
  current-state, and dependency checks as retrospective evidence, plus redaction: never quote a
117
116
  journal entry's raw command string or stderr in an issue body, since a journal entry can carry