@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
package/src/defer.mjs CHANGED
@@ -1,75 +1,75 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Forge deferral registry — deferred wiring is tracked debt, not a checkbox.
4
- *
5
- * Usage:
6
- * forge defer add --task <id> --reason "<why deferred>"
7
- * forge defer resolve --task <id>
8
- * forge defer list
9
- * [--session <id>]
10
- *
11
- * Unresolved deferrals block `forge phase done|finish`.
12
- */
13
-
14
- import { loadSession, readActive } from './lib.mjs';
15
- import { addDeferral, loadDeferrals, resolveDeferral } from './integrity.mjs';
16
-
17
- const args = process.argv.slice(2);
18
- const sub = args[0] && !args[0].startsWith('--') ? args[0] : 'list';
19
-
20
- if (args[0] === '--help' || sub === 'help') {
21
- process.stdout.write(
22
- 'Usage: forge defer [add --task <id> --reason "<why>" | resolve --task <id> | list] [--session <id>]\n',
23
- );
24
- process.exit(0);
25
- }
26
-
27
- let sessionId = null;
28
- let task = null;
29
- let reason = null;
30
- for (let i = 0; i < args.length; i += 1) {
31
- if (args[i] === '--session' && args[i + 1]) {
32
- sessionId = args[i + 1];
33
- i += 1;
34
- } else if (args[i] === '--task' && args[i + 1]) {
35
- task = args[i + 1];
36
- i += 1;
37
- } else if (args[i] === '--reason' && args[i + 1]) {
38
- reason = args[i + 1];
39
- i += 1;
40
- }
41
- }
42
-
43
- if (!sessionId) {
44
- const active = readActive();
45
- sessionId = active?.sessionId;
46
- }
47
- if (!sessionId) {
48
- process.stderr.write('No active session. Run forge new first.\n');
49
- process.exit(1);
50
- }
51
-
52
- const { dir } = loadSession(sessionId);
53
-
54
- try {
55
- if (sub === 'add') {
56
- const doc = addDeferral(dir, { task: task ?? '', reason: reason ?? '' });
57
- process.stdout.write(JSON.stringify(doc, null, 2));
58
- process.stdout.write('\n');
59
- } else if (sub === 'resolve') {
60
- if (!task) throw new Error('resolve requires --task <id>');
61
- const doc = resolveDeferral(dir, task);
62
- process.stdout.write(JSON.stringify(doc, null, 2));
63
- process.stdout.write('\n');
64
- } else if (sub === 'list') {
65
- const doc = loadDeferrals(dir);
66
- const open = doc.deferrals.filter((d) => !d.resolvedAt).length;
67
- process.stdout.write(JSON.stringify({ open, ...doc }, null, 2));
68
- process.stdout.write('\n');
69
- } else {
70
- throw new Error(`Unknown subcommand: ${sub}`);
71
- }
72
- } catch (err) {
73
- process.stderr.write(`${err instanceof Error ? err.message : err}\n`);
74
- process.exit(1);
75
- }
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Forge deferral registry — deferred wiring is tracked debt, not a checkbox.
4
+ *
5
+ * Usage:
6
+ * forge defer add --task <id> --reason "<why deferred>"
7
+ * forge defer resolve --task <id>
8
+ * forge defer list
9
+ * [--session <id>]
10
+ *
11
+ * Unresolved deferrals block `forge phase done|finish`.
12
+ */
13
+
14
+ import { loadSession, readActive } from './lib.mjs';
15
+ import { addDeferral, loadDeferrals, resolveDeferral } from './integrity.mjs';
16
+
17
+ const args = process.argv.slice(2);
18
+ const sub = args[0] && !args[0].startsWith('--') ? args[0] : 'list';
19
+
20
+ if (args[0] === '--help' || sub === 'help') {
21
+ process.stdout.write(
22
+ 'Usage: forge defer [add --task <id> --reason "<why>" | resolve --task <id> | list] [--session <id>]\n',
23
+ );
24
+ process.exit(0);
25
+ }
26
+
27
+ let sessionId = null;
28
+ let task = null;
29
+ let reason = null;
30
+ for (let i = 0; i < args.length; i += 1) {
31
+ if (args[i] === '--session' && args[i + 1]) {
32
+ sessionId = args[i + 1];
33
+ i += 1;
34
+ } else if (args[i] === '--task' && args[i + 1]) {
35
+ task = args[i + 1];
36
+ i += 1;
37
+ } else if (args[i] === '--reason' && args[i + 1]) {
38
+ reason = args[i + 1];
39
+ i += 1;
40
+ }
41
+ }
42
+
43
+ if (!sessionId) {
44
+ const active = readActive();
45
+ sessionId = active?.sessionId;
46
+ }
47
+ if (!sessionId) {
48
+ process.stderr.write('No active session. Run forge new first.\n');
49
+ process.exit(1);
50
+ }
51
+
52
+ const { dir } = loadSession(sessionId);
53
+
54
+ try {
55
+ if (sub === 'add') {
56
+ const doc = addDeferral(dir, { task: task ?? '', reason: reason ?? '' });
57
+ process.stdout.write(JSON.stringify(doc, null, 2));
58
+ process.stdout.write('\n');
59
+ } else if (sub === 'resolve') {
60
+ if (!task) throw new Error('resolve requires --task <id>');
61
+ const doc = resolveDeferral(dir, task);
62
+ process.stdout.write(JSON.stringify(doc, null, 2));
63
+ process.stdout.write('\n');
64
+ } else if (sub === 'list') {
65
+ const doc = loadDeferrals(dir);
66
+ const open = doc.deferrals.filter((d) => !d.resolvedAt).length;
67
+ process.stdout.write(JSON.stringify({ open, ...doc }, null, 2));
68
+ process.stdout.write('\n');
69
+ } else {
70
+ throw new Error(`Unknown subcommand: ${sub}`);
71
+ }
72
+ } catch (err) {
73
+ process.stderr.write(`${err instanceof Error ? err.message : err}\n`);
74
+ process.exit(1);
75
+ }