@izkac/forgekit 0.3.12 → 0.3.13

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 (116) hide show
  1. package/bin/forge.mjs +107 -107
  2. package/bin/forgekit.mjs +83 -83
  3. package/bin/review.mjs +81 -81
  4. package/package.json +1 -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/init.mjs +680 -621
  17. package/src/install.mjs +815 -815
  18. package/src/install.test.mjs +180 -180
  19. package/src/integrity-check.mjs +60 -60
  20. package/src/integrity.mjs +682 -682
  21. package/src/integrity.test.mjs +566 -566
  22. package/src/lib.mjs +143 -143
  23. package/src/models.defaults.json +41 -41
  24. package/src/new-session.mjs +99 -99
  25. package/src/openspec-overlays/README.md +19 -19
  26. package/src/openspec-overlays/openspec-apply-change-footer.md +14 -14
  27. package/src/openspec-overlays/opsx-apply-completion-step.md +1 -1
  28. package/src/openspec-overlays/opsx-apply-implement-step.md +11 -11
  29. package/src/paths.mjs +92 -92
  30. package/src/plan-engine.mjs +321 -278
  31. package/src/plan-engine.test.mjs +447 -283
  32. package/src/preferences.defaults.json +78 -78
  33. package/src/preferences.mjs +438 -438
  34. package/src/preferences.test.mjs +174 -174
  35. package/src/record-evidence.mjs +204 -204
  36. package/src/resolve-model.mjs +312 -312
  37. package/src/resolve-model.test.mjs +194 -194
  38. package/src/review/cli.test.mjs +117 -117
  39. package/src/review/export.mjs +172 -172
  40. package/src/review/export.test.mjs +197 -197
  41. package/src/review/fixtures/valid-review.json +42 -42
  42. package/src/review/lib.mjs +894 -894
  43. package/src/review/lib.test.mjs +266 -266
  44. package/src/review/schema.json +196 -196
  45. package/src/review/signals.test.mjs +62 -62
  46. package/src/score-cli.mjs +68 -68
  47. package/src/score.mjs +568 -568
  48. package/src/score.test.mjs +366 -366
  49. package/src/session-reminder.mjs +207 -207
  50. package/src/session-status.mjs +70 -70
  51. package/src/set-models.mjs +186 -186
  52. package/src/set-phase.mjs +205 -205
  53. package/src/set-prefs.mjs +294 -294
  54. package/src/specs-sync.mjs +234 -0
  55. package/src/specs-sync.test.mjs +114 -0
  56. package/src/spine.mjs +93 -93
  57. package/src/triage-prompt.mjs +175 -175
  58. package/src/triage-prompt.test.mjs +50 -50
  59. package/src/vendor-openspec-overlays.mjs +176 -176
  60. package/src/vendor-openspec-overlays.test.mjs +62 -62
  61. package/vendor/skills/archive-to-adr/SKILL.md +149 -149
  62. package/vendor/skills/forge/SKILL.md +136 -136
  63. package/vendor/skills/forge/docs/forge.md +650 -647
  64. package/vendor/skills/forge/phases/brainstorm.md +23 -23
  65. package/vendor/skills/forge/phases/finish.md +90 -87
  66. package/vendor/skills/forge/phases/implement.md +77 -77
  67. package/vendor/skills/forge/phases/plan-openspec.md +60 -60
  68. package/vendor/skills/forge/phases/plan-specs.md +163 -117
  69. package/vendor/skills/forge/phases/review.md +25 -25
  70. package/vendor/skills/forge/phases/verify.md +124 -124
  71. package/vendor/skills/forge/references/forge-layout.md +85 -85
  72. package/vendor/skills/forge/references/pace.md +115 -115
  73. package/vendor/skills/forge/references/plan-routing.md +52 -51
  74. package/vendor/skills/forge/references/runtime-integrity.md +232 -232
  75. package/vendor/skills/forge/references/substantial-work.md +37 -37
  76. package/vendor/skills/forge/references/test-evidence.md +30 -30
  77. package/vendor/skills/forge/references/test-strategy.md +68 -68
  78. package/vendor/skills/forge/skills/subagent-driven-development/SKILL.md +87 -87
  79. package/vendor/skills/forge/subagents/final-reviewer-prompt.md +56 -56
  80. package/vendor/skills/forge/subagents/implementer-prompt.md +38 -38
  81. package/vendor/skills/git-resolve-adr-conflict/SKILL.md +132 -132
  82. package/vendor/skills/thorough-code-review/SKILL.md +290 -290
  83. package/vendor/skills/thorough-code-review/examples.md +133 -133
  84. package/vendor/skills/thorough-code-review/reference/accepted-risks.md +26 -26
  85. package/vendor/skills/thorough-code-review/reference/lenses.md +96 -96
  86. package/vendor/skills/thorough-code-review/reference/phase1-scout.md +62 -62
  87. package/vendor/skills/thorough-code-review/reference/phase2-skeptic.md +105 -105
  88. package/vendor/skills/thorough-code-review/reference/report-schema.json +222 -222
  89. package/vendor/skills/thorough-code-review/reference/report-template.md +115 -115
  90. package/vendor/skills/thorough-code-review/reference/severity-rubric.md +49 -49
  91. package/vendor/skills/thorough-code-review/reference/signals-preflight.md +55 -55
  92. package/vendor/templates/adr/README.md +7 -7
  93. package/vendor/templates/adr/decisions.md +141 -141
  94. package/vendor/templates/adr/hooks/check-pending-adrs.mjs +74 -74
  95. package/vendor/templates/adr/hooks/check-pending-adrs.sh +3 -3
  96. package/vendor/templates/adr/hooks/openspec-archive-agent-message.mjs +52 -52
  97. package/vendor/templates/adr/hooks/openspec-archive-agent-message.sh +3 -3
  98. package/vendor/templates/project/claude/commands/forge-apply.md +75 -75
  99. package/vendor/templates/project/claude/commands/forge-brainstorm.md +7 -7
  100. package/vendor/templates/project/claude/commands/forge-build.md +17 -17
  101. package/vendor/templates/project/claude/commands/forge-plan.md +12 -12
  102. package/vendor/templates/project/claude/commands/forge-skip.md +14 -14
  103. package/vendor/templates/project/claude/commands/forge-status.md +16 -16
  104. package/vendor/templates/project/claude/commands/forge.md +16 -16
  105. package/vendor/templates/project/claude/hooks/forge-prompt-hook.mjs +73 -73
  106. package/vendor/templates/project/claude/hooks/forge-session-start.mjs +19 -19
  107. package/vendor/templates/project/claude/hooks/forge-triage-hook.mjs +77 -77
  108. package/vendor/templates/project/cursor/commands/forge-apply.md +75 -75
  109. package/vendor/templates/project/cursor/commands/forge-brainstorm.md +10 -10
  110. package/vendor/templates/project/cursor/commands/forge-build.md +17 -17
  111. package/vendor/templates/project/cursor/commands/forge-plan.md +15 -15
  112. package/vendor/templates/project/cursor/commands/forge-skip.md +14 -14
  113. package/vendor/templates/project/cursor/commands/forge-status.md +16 -16
  114. package/vendor/templates/project/cursor/commands/forge.md +16 -16
  115. package/vendor/templates/project/cursor/hooks/forge-session-start.mjs +30 -30
  116. package/vendor/templates/project/cursor/hooks/forge-session-start.sh +3 -3
@@ -1,186 +1,186 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Get or set the checkout-local Forge subagent billing preference.
4
- *
5
- * Usage:
6
- * forge set-models # print effective billing
7
- * forge set-models included # set local billing
8
- * forge set-models metered
9
- *
10
- * Options:
11
- * --forge-dir <path> Forge root (default: .forge under cwd)
12
- * --defaults <path> Defaults JSON path
13
- * --json Machine-readable stdout for get
14
- * --help
15
- */
16
-
17
- import fs from 'node:fs';
18
- import path from 'node:path';
19
- import { pathToFileURL } from 'node:url';
20
- import {
21
- BILLING_LANES,
22
- DEFAULTS_PATH,
23
- loadJsonFile,
24
- loadMergedConfig,
25
- } from './resolve-model.mjs';
26
-
27
- /**
28
- * @param {string[]} argv
29
- */
30
- export function parseArgs(argv) {
31
- const opts = {
32
- billing: null,
33
- forgeDir: null,
34
- defaults: null,
35
- json: false,
36
- help: false,
37
- };
38
-
39
- for (let i = 0; i < argv.length; i += 1) {
40
- const arg = argv[i];
41
- if (arg === '--forge-dir') opts.forgeDir = argv[++i];
42
- else if (arg === '--defaults') opts.defaults = argv[++i];
43
- else if (arg === '--json') opts.json = true;
44
- else if (arg === '--help' || arg === '-h') opts.help = true;
45
- else if (arg === '--') continue;
46
- else if (!arg.startsWith('-') && opts.billing === null) opts.billing = arg;
47
- else throw new Error(`Unknown argument: ${arg}`);
48
- }
49
-
50
- return opts;
51
- }
52
-
53
- /**
54
- * @param {{ forgeDir: string, billing: string }} opts
55
- */
56
- export function writeLocalBilling(opts) {
57
- if (!BILLING_LANES.includes(opts.billing)) {
58
- throw new Error(`Unknown billing "${opts.billing}". Expected one of: ${BILLING_LANES.join(', ')}`);
59
- }
60
-
61
- fs.mkdirSync(opts.forgeDir, { recursive: true });
62
- const localPath = path.join(opts.forgeDir, 'models.local.json');
63
-
64
- /** @type {Record<string, unknown>} */
65
- let existing = {};
66
- if (fs.existsSync(localPath)) {
67
- existing = loadJsonFile(localPath);
68
- }
69
-
70
- const next = { ...existing, billing: opts.billing };
71
- fs.writeFileSync(localPath, `${JSON.stringify(next, null, 2)}\n`, 'utf8');
72
- return { localPath, billing: opts.billing };
73
- }
74
-
75
- /**
76
- * @param {{ forgeDir?: string, defaultsPath?: string, cwd?: string }} [paths]
77
- */
78
- export function getEffectiveBilling(paths = {}) {
79
- const { config, sources, localPath } = loadMergedConfig({
80
- defaultsPath: paths.defaultsPath,
81
- forgeDir: paths.forgeDir,
82
- cwd: paths.cwd,
83
- });
84
- const billing =
85
- typeof config.billing === 'string' && BILLING_LANES.includes(config.billing)
86
- ? config.billing
87
- : 'included';
88
- return {
89
- billing,
90
- localPath,
91
- localExists: fs.existsSync(localPath),
92
- source: sources,
93
- };
94
- }
95
-
96
- function printHelp() {
97
- process.stdout.write(`Usage: forge set-models [included|metered] [options]
98
-
99
- Get or set checkout-local Forge subagent billing lane.
100
-
101
- forge models
102
- Print effective lane only — does NOT create .forge/models.local.json.
103
- Without a local file, this prints the committed default (usually "included").
104
-
105
- forge models included|metered
106
- Write/update .forge/models.local.json (gitignored, per-checkout).
107
-
108
- forge models -- --json
109
- Same get, with paths and localExists.
110
-
111
- Defaults: models.defaults.json
112
- Local overlay: .forge/models.local.json (appears only after a set)
113
-
114
- Options:
115
- --forge-dir <path> Forge directory (default: .forge)
116
- --defaults <path> Defaults JSON path
117
- --json JSON stdout when getting
118
- --help Show help
119
- `);
120
- }
121
-
122
- /**
123
- * @param {string[]} argv
124
- * @param {{ cwd?: string, stdout?: NodeJS.WritableStream, stderr?: NodeJS.WritableStream }} [io]
125
- */
126
- export function runSetModels(argv, io = {}) {
127
- const stdout = io.stdout ?? process.stdout;
128
- const stderr = io.stderr ?? process.stderr;
129
- const cwd = io.cwd ?? process.cwd();
130
-
131
- let opts;
132
- try {
133
- opts = parseArgs(argv);
134
- } catch (err) {
135
- const msg = err instanceof Error ? err.message : String(err);
136
- stderr.write(`${msg}\n`);
137
- return 2;
138
- }
139
-
140
- if (opts.help) {
141
- printHelp();
142
- return 0;
143
- }
144
-
145
- const forgeDir = opts.forgeDir ?? path.join(cwd, '.forge');
146
- const defaultsPath = opts.defaults ?? DEFAULTS_PATH;
147
-
148
- try {
149
- if (opts.billing) {
150
- const written = writeLocalBilling({ forgeDir, billing: opts.billing });
151
- stdout.write(`billing=${written.billing}\n`);
152
- stdout.write(`wrote ${written.localPath}\n`);
153
- return 0;
154
- }
155
-
156
- const effective = getEffectiveBilling({
157
- forgeDir,
158
- defaultsPath,
159
- cwd,
160
- });
161
- if (opts.json) {
162
- stdout.write(`${JSON.stringify(effective, null, 2)}\n`);
163
- } else {
164
- stdout.write(`billing=${effective.billing}\n`);
165
- if (effective.localExists) {
166
- stdout.write(`local=${effective.localPath}\n`);
167
- } else {
168
- stdout.write(`local=(none — using models.defaults.json)\n`);
169
- stdout.write(`hint: forge models included|metered # writes .forge/models.local.json\n`);
170
- }
171
- }
172
- return 0;
173
- } catch (err) {
174
- const msg = err instanceof Error ? err.message : String(err);
175
- stderr.write(`${msg}\n`);
176
- return 1;
177
- }
178
- }
179
-
180
- const isMain =
181
- process.argv[1] &&
182
- import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href;
183
-
184
- if (isMain) {
185
- process.exitCode = runSetModels(process.argv.slice(2));
186
- }
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Get or set the checkout-local Forge subagent billing preference.
4
+ *
5
+ * Usage:
6
+ * forge set-models # print effective billing
7
+ * forge set-models included # set local billing
8
+ * forge set-models metered
9
+ *
10
+ * Options:
11
+ * --forge-dir <path> Forge root (default: .forge under cwd)
12
+ * --defaults <path> Defaults JSON path
13
+ * --json Machine-readable stdout for get
14
+ * --help
15
+ */
16
+
17
+ import fs from 'node:fs';
18
+ import path from 'node:path';
19
+ import { pathToFileURL } from 'node:url';
20
+ import {
21
+ BILLING_LANES,
22
+ DEFAULTS_PATH,
23
+ loadJsonFile,
24
+ loadMergedConfig,
25
+ } from './resolve-model.mjs';
26
+
27
+ /**
28
+ * @param {string[]} argv
29
+ */
30
+ export function parseArgs(argv) {
31
+ const opts = {
32
+ billing: null,
33
+ forgeDir: null,
34
+ defaults: null,
35
+ json: false,
36
+ help: false,
37
+ };
38
+
39
+ for (let i = 0; i < argv.length; i += 1) {
40
+ const arg = argv[i];
41
+ if (arg === '--forge-dir') opts.forgeDir = argv[++i];
42
+ else if (arg === '--defaults') opts.defaults = argv[++i];
43
+ else if (arg === '--json') opts.json = true;
44
+ else if (arg === '--help' || arg === '-h') opts.help = true;
45
+ else if (arg === '--') continue;
46
+ else if (!arg.startsWith('-') && opts.billing === null) opts.billing = arg;
47
+ else throw new Error(`Unknown argument: ${arg}`);
48
+ }
49
+
50
+ return opts;
51
+ }
52
+
53
+ /**
54
+ * @param {{ forgeDir: string, billing: string }} opts
55
+ */
56
+ export function writeLocalBilling(opts) {
57
+ if (!BILLING_LANES.includes(opts.billing)) {
58
+ throw new Error(`Unknown billing "${opts.billing}". Expected one of: ${BILLING_LANES.join(', ')}`);
59
+ }
60
+
61
+ fs.mkdirSync(opts.forgeDir, { recursive: true });
62
+ const localPath = path.join(opts.forgeDir, 'models.local.json');
63
+
64
+ /** @type {Record<string, unknown>} */
65
+ let existing = {};
66
+ if (fs.existsSync(localPath)) {
67
+ existing = loadJsonFile(localPath);
68
+ }
69
+
70
+ const next = { ...existing, billing: opts.billing };
71
+ fs.writeFileSync(localPath, `${JSON.stringify(next, null, 2)}\n`, 'utf8');
72
+ return { localPath, billing: opts.billing };
73
+ }
74
+
75
+ /**
76
+ * @param {{ forgeDir?: string, defaultsPath?: string, cwd?: string }} [paths]
77
+ */
78
+ export function getEffectiveBilling(paths = {}) {
79
+ const { config, sources, localPath } = loadMergedConfig({
80
+ defaultsPath: paths.defaultsPath,
81
+ forgeDir: paths.forgeDir,
82
+ cwd: paths.cwd,
83
+ });
84
+ const billing =
85
+ typeof config.billing === 'string' && BILLING_LANES.includes(config.billing)
86
+ ? config.billing
87
+ : 'included';
88
+ return {
89
+ billing,
90
+ localPath,
91
+ localExists: fs.existsSync(localPath),
92
+ source: sources,
93
+ };
94
+ }
95
+
96
+ function printHelp() {
97
+ process.stdout.write(`Usage: forge set-models [included|metered] [options]
98
+
99
+ Get or set checkout-local Forge subagent billing lane.
100
+
101
+ forge models
102
+ Print effective lane only — does NOT create .forge/models.local.json.
103
+ Without a local file, this prints the committed default (usually "included").
104
+
105
+ forge models included|metered
106
+ Write/update .forge/models.local.json (gitignored, per-checkout).
107
+
108
+ forge models -- --json
109
+ Same get, with paths and localExists.
110
+
111
+ Defaults: models.defaults.json
112
+ Local overlay: .forge/models.local.json (appears only after a set)
113
+
114
+ Options:
115
+ --forge-dir <path> Forge directory (default: .forge)
116
+ --defaults <path> Defaults JSON path
117
+ --json JSON stdout when getting
118
+ --help Show help
119
+ `);
120
+ }
121
+
122
+ /**
123
+ * @param {string[]} argv
124
+ * @param {{ cwd?: string, stdout?: NodeJS.WritableStream, stderr?: NodeJS.WritableStream }} [io]
125
+ */
126
+ export function runSetModels(argv, io = {}) {
127
+ const stdout = io.stdout ?? process.stdout;
128
+ const stderr = io.stderr ?? process.stderr;
129
+ const cwd = io.cwd ?? process.cwd();
130
+
131
+ let opts;
132
+ try {
133
+ opts = parseArgs(argv);
134
+ } catch (err) {
135
+ const msg = err instanceof Error ? err.message : String(err);
136
+ stderr.write(`${msg}\n`);
137
+ return 2;
138
+ }
139
+
140
+ if (opts.help) {
141
+ printHelp();
142
+ return 0;
143
+ }
144
+
145
+ const forgeDir = opts.forgeDir ?? path.join(cwd, '.forge');
146
+ const defaultsPath = opts.defaults ?? DEFAULTS_PATH;
147
+
148
+ try {
149
+ if (opts.billing) {
150
+ const written = writeLocalBilling({ forgeDir, billing: opts.billing });
151
+ stdout.write(`billing=${written.billing}\n`);
152
+ stdout.write(`wrote ${written.localPath}\n`);
153
+ return 0;
154
+ }
155
+
156
+ const effective = getEffectiveBilling({
157
+ forgeDir,
158
+ defaultsPath,
159
+ cwd,
160
+ });
161
+ if (opts.json) {
162
+ stdout.write(`${JSON.stringify(effective, null, 2)}\n`);
163
+ } else {
164
+ stdout.write(`billing=${effective.billing}\n`);
165
+ if (effective.localExists) {
166
+ stdout.write(`local=${effective.localPath}\n`);
167
+ } else {
168
+ stdout.write(`local=(none — using models.defaults.json)\n`);
169
+ stdout.write(`hint: forge models included|metered # writes .forge/models.local.json\n`);
170
+ }
171
+ }
172
+ return 0;
173
+ } catch (err) {
174
+ const msg = err instanceof Error ? err.message : String(err);
175
+ stderr.write(`${msg}\n`);
176
+ return 1;
177
+ }
178
+ }
179
+
180
+ const isMain =
181
+ process.argv[1] &&
182
+ import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href;
183
+
184
+ if (isMain) {
185
+ process.exitCode = runSetModels(process.argv.slice(2));
186
+ }