@izkac/forgekit 0.3.12 → 0.3.14

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/bin/forge.mjs +119 -107
  2. package/bin/forgekit.mjs +83 -83
  3. package/bin/review.mjs +81 -81
  4. package/package.json +2 -1
  5. package/scripts/prepack.mjs +78 -78
  6. package/scripts/run-tests.mjs +50 -50
  7. package/src/adr.mjs +236 -236
  8. package/src/adr.test.mjs +170 -170
  9. package/src/change.mjs +327 -234
  10. package/src/change.test.mjs +145 -83
  11. package/src/cleanup-sessions.mjs +84 -84
  12. package/src/config.mjs +103 -103
  13. package/src/defer.mjs +75 -75
  14. package/src/doctor.mjs +350 -341
  15. package/src/doctor.test.mjs +114 -114
  16. package/src/fleet.test.mjs +50 -0
  17. package/src/init.mjs +680 -621
  18. package/src/install.mjs +815 -815
  19. package/src/install.test.mjs +180 -180
  20. package/src/integrity-check.mjs +60 -60
  21. package/src/integrity.mjs +688 -682
  22. package/src/integrity.test.mjs +612 -566
  23. package/src/lib/fleet.mjs +61 -4
  24. package/src/lib.mjs +160 -143
  25. package/src/lib.test.mjs +128 -0
  26. package/src/models.defaults.json +41 -41
  27. package/src/new-session.mjs +99 -99
  28. package/src/openspec-overlays/README.md +19 -19
  29. package/src/openspec-overlays/openspec-apply-change-footer.md +14 -14
  30. package/src/openspec-overlays/opsx-apply-completion-step.md +1 -1
  31. package/src/openspec-overlays/opsx-apply-implement-step.md +11 -11
  32. package/src/paths.mjs +92 -92
  33. package/src/plan-engine.mjs +321 -278
  34. package/src/plan-engine.test.mjs +447 -283
  35. package/src/preferences.defaults.json +78 -78
  36. package/src/preferences.mjs +438 -438
  37. package/src/preferences.test.mjs +174 -174
  38. package/src/record-evidence.mjs +204 -204
  39. package/src/repo-root.mjs +33 -0
  40. package/src/resolve-model.mjs +312 -312
  41. package/src/resolve-model.test.mjs +194 -194
  42. package/src/review/cli.test.mjs +117 -117
  43. package/src/review/export.mjs +172 -172
  44. package/src/review/export.test.mjs +197 -197
  45. package/src/review/fixtures/valid-review.json +42 -42
  46. package/src/review/lib.mjs +894 -894
  47. package/src/review/lib.test.mjs +266 -266
  48. package/src/review/schema.json +196 -196
  49. package/src/review/signals.test.mjs +62 -62
  50. package/src/score-cli.mjs +68 -68
  51. package/src/score.mjs +568 -568
  52. package/src/score.test.mjs +366 -366
  53. package/src/session-reminder.mjs +207 -207
  54. package/src/session-status.mjs +70 -70
  55. package/src/set-models.mjs +186 -186
  56. package/src/set-phase.mjs +205 -205
  57. package/src/set-prefs.mjs +294 -294
  58. package/src/specs-sync.mjs +232 -0
  59. package/src/specs-sync.test.mjs +114 -0
  60. package/src/spine.mjs +93 -93
  61. package/src/triage-prompt.mjs +175 -175
  62. package/src/triage-prompt.test.mjs +50 -50
  63. package/src/vendor-openspec-overlays.mjs +176 -176
  64. package/src/vendor-openspec-overlays.test.mjs +62 -62
  65. package/vendor/skills/archive-to-adr/SKILL.md +149 -149
  66. package/vendor/skills/forge/SKILL.md +136 -136
  67. package/vendor/skills/forge/docs/forge.md +650 -647
  68. package/vendor/skills/forge/phases/brainstorm.md +23 -23
  69. package/vendor/skills/forge/phases/finish.md +90 -87
  70. package/vendor/skills/forge/phases/implement.md +77 -77
  71. package/vendor/skills/forge/phases/plan-openspec.md +60 -60
  72. package/vendor/skills/forge/phases/plan-specs.md +163 -117
  73. package/vendor/skills/forge/phases/review.md +25 -25
  74. package/vendor/skills/forge/phases/verify.md +124 -124
  75. package/vendor/skills/forge/references/forge-layout.md +85 -85
  76. package/vendor/skills/forge/references/pace.md +115 -115
  77. package/vendor/skills/forge/references/plan-routing.md +52 -51
  78. package/vendor/skills/forge/references/runtime-integrity.md +232 -232
  79. package/vendor/skills/forge/references/substantial-work.md +37 -37
  80. package/vendor/skills/forge/references/test-evidence.md +30 -30
  81. package/vendor/skills/forge/references/test-strategy.md +68 -68
  82. package/vendor/skills/forge/skills/subagent-driven-development/SKILL.md +87 -87
  83. package/vendor/skills/forge/subagents/final-reviewer-prompt.md +56 -56
  84. package/vendor/skills/forge/subagents/implementer-prompt.md +38 -38
  85. package/vendor/skills/git-resolve-adr-conflict/SKILL.md +132 -132
  86. package/vendor/skills/thorough-code-review/SKILL.md +290 -290
  87. package/vendor/skills/thorough-code-review/examples.md +133 -133
  88. package/vendor/skills/thorough-code-review/reference/accepted-risks.md +26 -26
  89. package/vendor/skills/thorough-code-review/reference/lenses.md +96 -96
  90. package/vendor/skills/thorough-code-review/reference/phase1-scout.md +62 -62
  91. package/vendor/skills/thorough-code-review/reference/phase2-skeptic.md +105 -105
  92. package/vendor/skills/thorough-code-review/reference/report-schema.json +222 -222
  93. package/vendor/skills/thorough-code-review/reference/report-template.md +115 -115
  94. package/vendor/skills/thorough-code-review/reference/severity-rubric.md +49 -49
  95. package/vendor/skills/thorough-code-review/reference/signals-preflight.md +55 -55
  96. package/vendor/templates/adr/README.md +7 -7
  97. package/vendor/templates/adr/decisions.md +141 -141
  98. package/vendor/templates/adr/hooks/check-pending-adrs.mjs +74 -74
  99. package/vendor/templates/adr/hooks/check-pending-adrs.sh +3 -3
  100. package/vendor/templates/adr/hooks/openspec-archive-agent-message.mjs +52 -52
  101. package/vendor/templates/adr/hooks/openspec-archive-agent-message.sh +3 -3
  102. package/vendor/templates/project/claude/commands/forge-apply.md +75 -75
  103. package/vendor/templates/project/claude/commands/forge-brainstorm.md +7 -7
  104. package/vendor/templates/project/claude/commands/forge-build.md +17 -17
  105. package/vendor/templates/project/claude/commands/forge-plan.md +12 -12
  106. package/vendor/templates/project/claude/commands/forge-skip.md +14 -14
  107. package/vendor/templates/project/claude/commands/forge-status.md +16 -16
  108. package/vendor/templates/project/claude/commands/forge.md +16 -16
  109. package/vendor/templates/project/claude/hooks/forge-prompt-hook.mjs +73 -73
  110. package/vendor/templates/project/claude/hooks/forge-session-start.mjs +19 -19
  111. package/vendor/templates/project/claude/hooks/forge-triage-hook.mjs +77 -77
  112. package/vendor/templates/project/cursor/commands/forge-apply.md +75 -75
  113. package/vendor/templates/project/cursor/commands/forge-brainstorm.md +10 -10
  114. package/vendor/templates/project/cursor/commands/forge-build.md +17 -17
  115. package/vendor/templates/project/cursor/commands/forge-plan.md +15 -15
  116. package/vendor/templates/project/cursor/commands/forge-skip.md +14 -14
  117. package/vendor/templates/project/cursor/commands/forge-status.md +16 -16
  118. package/vendor/templates/project/cursor/commands/forge.md +16 -16
  119. package/vendor/templates/project/cursor/hooks/forge-session-start.mjs +30 -30
  120. package/vendor/templates/project/cursor/hooks/forge-session-start.sh +3 -3
@@ -1,78 +1,78 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Copy skills/ and templates/ from the monorepo root into packages/cli/vendor/
4
- * so the published npm package is self-contained.
5
- *
6
- * Usage: node packages/cli/scripts/prepack.mjs
7
- * Triggered by npm prepack in @izkac/forgekit.
8
- */
9
-
10
- import fs from 'node:fs';
11
- import path from 'node:path';
12
- import { fileURLToPath } from 'node:url';
13
-
14
- const __dirname = path.dirname(fileURLToPath(import.meta.url));
15
- const cliRoot = path.resolve(__dirname, '..');
16
- const monoRoot = path.resolve(cliRoot, '..', '..');
17
- const vendorRoot = path.join(cliRoot, 'vendor');
18
-
19
- /**
20
- * @param {string} src
21
- * @param {string} dest
22
- */
23
- function copyDirRecursive(src, dest) {
24
- fs.mkdirSync(dest, { recursive: true });
25
- for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
26
- const from = path.join(src, entry.name);
27
- const to = path.join(dest, entry.name);
28
- if (entry.isDirectory()) copyDirRecursive(from, to);
29
- else fs.copyFileSync(from, to);
30
- }
31
- }
32
-
33
- /**
34
- * Best-effort clear. On Windows EPERM, leave the tree and overwrite in place.
35
- * @param {string} dir
36
- * @returns {boolean} true if cleared
37
- */
38
- function tryEmptyDir(dir) {
39
- if (!fs.existsSync(dir)) return true;
40
- try {
41
- for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
42
- fs.rmSync(path.join(dir, entry.name), {
43
- recursive: true,
44
- force: true,
45
- maxRetries: 5,
46
- retryDelay: 100,
47
- });
48
- }
49
- return true;
50
- } catch (err) {
51
- process.stderr.write(
52
- `prepack: could not empty ${dir} (${err.code || err.message}); overwriting in place\n`,
53
- );
54
- return false;
55
- }
56
- }
57
-
58
- function main() {
59
- const skillsSrc = path.join(monoRoot, 'skills');
60
- const templatesSrc = path.join(monoRoot, 'templates');
61
- if (!fs.existsSync(skillsSrc) || !fs.existsSync(templatesSrc)) {
62
- if (fs.existsSync(path.join(vendorRoot, 'skills'))) {
63
- process.stdout.write(`prepack: vendor already present at ${vendorRoot}\n`);
64
- return;
65
- }
66
- throw new Error(
67
- `prepack: monorepo skills/templates not found at ${monoRoot} and vendor/ missing`,
68
- );
69
- }
70
-
71
- fs.mkdirSync(vendorRoot, { recursive: true });
72
- tryEmptyDir(vendorRoot);
73
- copyDirRecursive(skillsSrc, path.join(vendorRoot, 'skills'));
74
- copyDirRecursive(templatesSrc, path.join(vendorRoot, 'templates'));
75
- process.stdout.write(`prepack: vendored skills + templates → ${vendorRoot}\n`);
76
- }
77
-
78
- main();
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Copy skills/ and templates/ from the monorepo root into packages/cli/vendor/
4
+ * so the published npm package is self-contained.
5
+ *
6
+ * Usage: node packages/cli/scripts/prepack.mjs
7
+ * Triggered by npm prepack in @izkac/forgekit.
8
+ */
9
+
10
+ import fs from 'node:fs';
11
+ import path from 'node:path';
12
+ import { fileURLToPath } from 'node:url';
13
+
14
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
15
+ const cliRoot = path.resolve(__dirname, '..');
16
+ const monoRoot = path.resolve(cliRoot, '..', '..');
17
+ const vendorRoot = path.join(cliRoot, 'vendor');
18
+
19
+ /**
20
+ * @param {string} src
21
+ * @param {string} dest
22
+ */
23
+ function copyDirRecursive(src, dest) {
24
+ fs.mkdirSync(dest, { recursive: true });
25
+ for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
26
+ const from = path.join(src, entry.name);
27
+ const to = path.join(dest, entry.name);
28
+ if (entry.isDirectory()) copyDirRecursive(from, to);
29
+ else fs.copyFileSync(from, to);
30
+ }
31
+ }
32
+
33
+ /**
34
+ * Best-effort clear. On Windows EPERM, leave the tree and overwrite in place.
35
+ * @param {string} dir
36
+ * @returns {boolean} true if cleared
37
+ */
38
+ function tryEmptyDir(dir) {
39
+ if (!fs.existsSync(dir)) return true;
40
+ try {
41
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
42
+ fs.rmSync(path.join(dir, entry.name), {
43
+ recursive: true,
44
+ force: true,
45
+ maxRetries: 5,
46
+ retryDelay: 100,
47
+ });
48
+ }
49
+ return true;
50
+ } catch (err) {
51
+ process.stderr.write(
52
+ `prepack: could not empty ${dir} (${err.code || err.message}); overwriting in place\n`,
53
+ );
54
+ return false;
55
+ }
56
+ }
57
+
58
+ function main() {
59
+ const skillsSrc = path.join(monoRoot, 'skills');
60
+ const templatesSrc = path.join(monoRoot, 'templates');
61
+ if (!fs.existsSync(skillsSrc) || !fs.existsSync(templatesSrc)) {
62
+ if (fs.existsSync(path.join(vendorRoot, 'skills'))) {
63
+ process.stdout.write(`prepack: vendor already present at ${vendorRoot}\n`);
64
+ return;
65
+ }
66
+ throw new Error(
67
+ `prepack: monorepo skills/templates not found at ${monoRoot} and vendor/ missing`,
68
+ );
69
+ }
70
+
71
+ fs.mkdirSync(vendorRoot, { recursive: true });
72
+ tryEmptyDir(vendorRoot);
73
+ copyDirRecursive(skillsSrc, path.join(vendorRoot, 'skills'));
74
+ copyDirRecursive(templatesSrc, path.join(vendorRoot, 'templates'));
75
+ process.stdout.write(`prepack: vendored skills + templates → ${vendorRoot}\n`);
76
+ }
77
+
78
+ main();
@@ -1,50 +1,50 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Run all src test files (*.test.mjs) via node --test.
4
- *
5
- * Node 20 does not expand globs passed to `node --test`; Node 22+ does.
6
- * Explicit file discovery keeps CI green on the engines.node >=20 matrix.
7
- */
8
-
9
- import fs from 'node:fs';
10
- import os from 'node:os';
11
- import path from 'node:path';
12
- import { spawnSync } from 'node:child_process';
13
- import { fileURLToPath } from 'node:url';
14
-
15
- const __dirname = path.dirname(fileURLToPath(import.meta.url));
16
- const cliRoot = path.resolve(__dirname, '..');
17
- const srcRoot = path.join(cliRoot, 'src');
18
-
19
- /**
20
- * @param {string} dir
21
- * @returns {string[]}
22
- */
23
- function findTestFiles(dir) {
24
- /** @type {string[]} */
25
- const out = [];
26
- for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
27
- const full = path.join(dir, entry.name);
28
- if (entry.isDirectory()) out.push(...findTestFiles(full));
29
- else if (entry.name.endsWith('.test.mjs')) out.push(full);
30
- }
31
- return out;
32
- }
33
-
34
- const files = findTestFiles(srcRoot).sort();
35
- if (files.length === 0) {
36
- console.error(`No *.test.mjs files under ${srcRoot}`);
37
- process.exit(1);
38
- }
39
-
40
- const result = spawnSync(process.execPath, ['--test', ...files], {
41
- cwd: cliRoot,
42
- stdio: 'inherit',
43
- env: {
44
- ...process.env,
45
- // Keep saveSession's fleet-registry mirroring away from ~/.forgekit
46
- // when tests exercise session saves with scratch projects.
47
- FORGEKIT_FLEET_DIR: fs.mkdtempSync(path.join(os.tmpdir(), 'forgekit-test-fleet-')),
48
- },
49
- });
50
- process.exit(result.status ?? 1);
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Run all src test files (*.test.mjs) via node --test.
4
+ *
5
+ * Node 20 does not expand globs passed to `node --test`; Node 22+ does.
6
+ * Explicit file discovery keeps CI green on the engines.node >=20 matrix.
7
+ */
8
+
9
+ import fs from 'node:fs';
10
+ import os from 'node:os';
11
+ import path from 'node:path';
12
+ import { spawnSync } from 'node:child_process';
13
+ import { fileURLToPath } from 'node:url';
14
+
15
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
16
+ const cliRoot = path.resolve(__dirname, '..');
17
+ const srcRoot = path.join(cliRoot, 'src');
18
+
19
+ /**
20
+ * @param {string} dir
21
+ * @returns {string[]}
22
+ */
23
+ function findTestFiles(dir) {
24
+ /** @type {string[]} */
25
+ const out = [];
26
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
27
+ const full = path.join(dir, entry.name);
28
+ if (entry.isDirectory()) out.push(...findTestFiles(full));
29
+ else if (entry.name.endsWith('.test.mjs')) out.push(full);
30
+ }
31
+ return out;
32
+ }
33
+
34
+ const files = findTestFiles(srcRoot).sort();
35
+ if (files.length === 0) {
36
+ console.error(`No *.test.mjs files under ${srcRoot}`);
37
+ process.exit(1);
38
+ }
39
+
40
+ const result = spawnSync(process.execPath, ['--test', ...files], {
41
+ cwd: cliRoot,
42
+ stdio: 'inherit',
43
+ env: {
44
+ ...process.env,
45
+ // Keep saveSession's fleet-registry mirroring away from ~/.forgekit
46
+ // when tests exercise session saves with scratch projects.
47
+ FORGEKIT_FLEET_DIR: fs.mkdtempSync(path.join(os.tmpdir(), 'forgekit-test-fleet-')),
48
+ },
49
+ });
50
+ process.exit(result.status ?? 1);