@izkac/forgekit 0.3.11 → 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.
- package/bin/forge.mjs +107 -107
- package/bin/forgekit.mjs +83 -83
- package/bin/review.mjs +81 -81
- package/package.json +1 -1
- package/scripts/prepack.mjs +78 -78
- package/scripts/run-tests.mjs +50 -50
- package/src/adr.mjs +236 -236
- package/src/adr.test.mjs +170 -170
- package/src/change.mjs +327 -234
- package/src/change.test.mjs +145 -83
- package/src/cleanup-sessions.mjs +84 -84
- package/src/config.mjs +103 -103
- package/src/defer.mjs +75 -75
- package/src/doctor.mjs +350 -341
- package/src/doctor.test.mjs +114 -114
- package/src/init.mjs +680 -621
- package/src/install.mjs +815 -815
- package/src/install.test.mjs +180 -180
- package/src/integrity-check.mjs +60 -60
- package/src/integrity.mjs +682 -682
- package/src/integrity.test.mjs +566 -566
- package/src/lib.mjs +143 -143
- package/src/models.defaults.json +41 -41
- package/src/new-session.mjs +99 -99
- package/src/openspec-overlays/README.md +19 -19
- package/src/openspec-overlays/openspec-apply-change-footer.md +14 -14
- package/src/openspec-overlays/opsx-apply-completion-step.md +1 -1
- package/src/openspec-overlays/opsx-apply-implement-step.md +11 -11
- package/src/paths.mjs +92 -92
- package/src/plan-engine.mjs +321 -278
- package/src/plan-engine.test.mjs +447 -283
- package/src/preferences.defaults.json +78 -78
- package/src/preferences.mjs +438 -438
- package/src/preferences.test.mjs +174 -174
- package/src/record-evidence.mjs +204 -204
- package/src/resolve-model.mjs +312 -312
- package/src/resolve-model.test.mjs +194 -194
- package/src/review/cli.test.mjs +117 -117
- package/src/review/export.mjs +172 -172
- package/src/review/export.test.mjs +197 -197
- package/src/review/fixtures/valid-review.json +42 -42
- package/src/review/lib.mjs +894 -894
- package/src/review/lib.test.mjs +266 -266
- package/src/review/schema.json +196 -196
- package/src/review/signals.test.mjs +62 -62
- package/src/score-cli.mjs +68 -68
- package/src/score.mjs +568 -566
- package/src/score.test.mjs +366 -340
- package/src/session-reminder.mjs +207 -207
- package/src/session-status.mjs +70 -70
- package/src/set-models.mjs +186 -186
- package/src/set-phase.mjs +205 -205
- package/src/set-prefs.mjs +294 -294
- package/src/specs-sync.mjs +234 -0
- package/src/specs-sync.test.mjs +114 -0
- package/src/spine.mjs +93 -93
- package/src/triage-prompt.mjs +175 -175
- package/src/triage-prompt.test.mjs +50 -50
- package/src/vendor-openspec-overlays.mjs +176 -176
- package/src/vendor-openspec-overlays.test.mjs +62 -62
- package/vendor/skills/archive-to-adr/SKILL.md +149 -149
- package/vendor/skills/forge/SKILL.md +136 -136
- package/vendor/skills/forge/docs/forge.md +650 -647
- package/vendor/skills/forge/phases/brainstorm.md +23 -23
- package/vendor/skills/forge/phases/finish.md +90 -87
- package/vendor/skills/forge/phases/implement.md +77 -77
- package/vendor/skills/forge/phases/plan-openspec.md +60 -60
- package/vendor/skills/forge/phases/plan-specs.md +163 -117
- package/vendor/skills/forge/phases/review.md +25 -25
- package/vendor/skills/forge/phases/verify.md +124 -124
- package/vendor/skills/forge/references/forge-layout.md +85 -85
- package/vendor/skills/forge/references/pace.md +115 -115
- package/vendor/skills/forge/references/plan-routing.md +52 -51
- package/vendor/skills/forge/references/runtime-integrity.md +232 -225
- package/vendor/skills/forge/references/substantial-work.md +37 -37
- package/vendor/skills/forge/references/test-evidence.md +30 -30
- package/vendor/skills/forge/references/test-strategy.md +68 -68
- package/vendor/skills/forge/skills/subagent-driven-development/SKILL.md +87 -87
- package/vendor/skills/forge/subagents/final-reviewer-prompt.md +56 -56
- package/vendor/skills/forge/subagents/implementer-prompt.md +38 -38
- package/vendor/skills/git-resolve-adr-conflict/SKILL.md +132 -132
- package/vendor/skills/thorough-code-review/SKILL.md +290 -290
- package/vendor/skills/thorough-code-review/examples.md +133 -133
- package/vendor/skills/thorough-code-review/reference/accepted-risks.md +26 -26
- package/vendor/skills/thorough-code-review/reference/lenses.md +96 -96
- package/vendor/skills/thorough-code-review/reference/phase1-scout.md +62 -62
- package/vendor/skills/thorough-code-review/reference/phase2-skeptic.md +105 -105
- package/vendor/skills/thorough-code-review/reference/report-schema.json +222 -222
- package/vendor/skills/thorough-code-review/reference/report-template.md +115 -115
- package/vendor/skills/thorough-code-review/reference/severity-rubric.md +49 -49
- package/vendor/skills/thorough-code-review/reference/signals-preflight.md +55 -55
- package/vendor/templates/adr/README.md +7 -7
- package/vendor/templates/adr/decisions.md +141 -141
- package/vendor/templates/adr/hooks/check-pending-adrs.mjs +74 -74
- package/vendor/templates/adr/hooks/check-pending-adrs.sh +3 -3
- package/vendor/templates/adr/hooks/openspec-archive-agent-message.mjs +52 -52
- package/vendor/templates/adr/hooks/openspec-archive-agent-message.sh +3 -3
- package/vendor/templates/project/claude/commands/forge-apply.md +75 -75
- package/vendor/templates/project/claude/commands/forge-brainstorm.md +7 -7
- package/vendor/templates/project/claude/commands/forge-build.md +17 -17
- package/vendor/templates/project/claude/commands/forge-plan.md +12 -12
- package/vendor/templates/project/claude/commands/forge-skip.md +14 -14
- package/vendor/templates/project/claude/commands/forge-status.md +16 -16
- package/vendor/templates/project/claude/commands/forge.md +16 -16
- package/vendor/templates/project/claude/hooks/forge-prompt-hook.mjs +73 -73
- package/vendor/templates/project/claude/hooks/forge-session-start.mjs +19 -19
- package/vendor/templates/project/claude/hooks/forge-triage-hook.mjs +77 -77
- package/vendor/templates/project/cursor/commands/forge-apply.md +75 -75
- package/vendor/templates/project/cursor/commands/forge-brainstorm.md +10 -10
- package/vendor/templates/project/cursor/commands/forge-build.md +17 -17
- package/vendor/templates/project/cursor/commands/forge-plan.md +15 -15
- package/vendor/templates/project/cursor/commands/forge-skip.md +14 -14
- package/vendor/templates/project/cursor/commands/forge-status.md +16 -16
- package/vendor/templates/project/cursor/commands/forge.md +16 -16
- package/vendor/templates/project/cursor/hooks/forge-session-start.mjs +30 -30
- package/vendor/templates/project/cursor/hooks/forge-session-start.sh +3 -3
package/src/paths.mjs
CHANGED
|
@@ -1,92 +1,92 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* Resolve forgekit asset roots (skills, templates).
|
|
4
|
-
*
|
|
5
|
-
* Search order for assets:
|
|
6
|
-
* 1. FORGEKIT_ROOT env (dev / linked monorepo)
|
|
7
|
-
* 2. Monorepo root (packages/cli/../../..)
|
|
8
|
-
* 3. Vendored copy inside the published package (packages/cli/vendor)
|
|
9
|
-
*/
|
|
10
|
-
|
|
11
|
-
import fs from 'node:fs';
|
|
12
|
-
import path from 'node:path';
|
|
13
|
-
import { fileURLToPath } from 'node:url';
|
|
14
|
-
import { createHash } from 'node:crypto';
|
|
15
|
-
|
|
16
|
-
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
17
|
-
|
|
18
|
-
/** @returns {string} Absolute path to packages/cli */
|
|
19
|
-
export function cliPackageRoot() {
|
|
20
|
-
return path.resolve(__dirname, '..');
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
/**
|
|
24
|
-
* Candidate forgekit roots that may contain skills/ and templates/.
|
|
25
|
-
* @returns {string[]}
|
|
26
|
-
*/
|
|
27
|
-
export function forgekitRootCandidates() {
|
|
28
|
-
const roots = [];
|
|
29
|
-
if (process.env.FORGEKIT_ROOT) roots.push(process.env.FORGEKIT_ROOT);
|
|
30
|
-
// Monorepo: packages/cli/src → ../../../
|
|
31
|
-
roots.push(path.resolve(__dirname, '..', '..', '..'));
|
|
32
|
-
// Published package: vendor/ next to src/
|
|
33
|
-
roots.push(path.join(cliPackageRoot(), 'vendor'));
|
|
34
|
-
return [...new Set(roots.map((r) => path.resolve(r)))];
|
|
35
|
-
}
|
|
36
|
-
|
|
37
|
-
/**
|
|
38
|
-
* @param {string} relativePath e.g. 'skills/forge' or 'templates/project'
|
|
39
|
-
* @param {{ requireFile?: string }} [opts] file that must exist under the candidate
|
|
40
|
-
* @returns {string}
|
|
41
|
-
*/
|
|
42
|
-
export function resolveAsset(relativePath, opts = {}) {
|
|
43
|
-
const requireFile = opts.requireFile;
|
|
44
|
-
const tried = [];
|
|
45
|
-
for (const root of forgekitRootCandidates()) {
|
|
46
|
-
const candidate = path.join(root, relativePath);
|
|
47
|
-
tried.push(candidate);
|
|
48
|
-
const check = requireFile ? path.join(candidate, requireFile) : candidate;
|
|
49
|
-
if (fs.existsSync(check)) return candidate;
|
|
50
|
-
}
|
|
51
|
-
throw new Error(
|
|
52
|
-
`Asset not found: ${relativePath}${requireFile ? ` (${requireFile})` : ''}.\nTried:\n ${tried.join('\n ')}`,
|
|
53
|
-
);
|
|
54
|
-
}
|
|
55
|
-
|
|
56
|
-
/**
|
|
57
|
-
* @returns {string} package version from packages/cli/package.json
|
|
58
|
-
*/
|
|
59
|
-
export function packageVersion() {
|
|
60
|
-
const pkgPath = path.join(cliPackageRoot(), 'package.json');
|
|
61
|
-
const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
|
|
62
|
-
return pkg.version ?? '0.0.0';
|
|
63
|
-
}
|
|
64
|
-
|
|
65
|
-
/**
|
|
66
|
-
* Stable content hash of a directory (sorted relative paths + file bytes).
|
|
67
|
-
* @param {string} dir
|
|
68
|
-
* @returns {string} sha256 hex
|
|
69
|
-
*/
|
|
70
|
-
export function hashDirectory(dir) {
|
|
71
|
-
const hash = createHash('sha256');
|
|
72
|
-
/** @type {string[]} */
|
|
73
|
-
const files = [];
|
|
74
|
-
const walk = (d, prefix = '') => {
|
|
75
|
-
for (const entry of fs.readdirSync(d, { withFileTypes: true })) {
|
|
76
|
-
if (entry.name === '.forgekit.json') continue;
|
|
77
|
-
const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
|
|
78
|
-
const full = path.join(d, entry.name);
|
|
79
|
-
if (entry.isDirectory()) walk(full, rel);
|
|
80
|
-
else files.push(rel);
|
|
81
|
-
}
|
|
82
|
-
};
|
|
83
|
-
walk(dir);
|
|
84
|
-
files.sort();
|
|
85
|
-
for (const rel of files) {
|
|
86
|
-
hash.update(rel);
|
|
87
|
-
hash.update('\0');
|
|
88
|
-
hash.update(fs.readFileSync(path.join(dir, ...rel.split('/'))));
|
|
89
|
-
hash.update('\0');
|
|
90
|
-
}
|
|
91
|
-
return hash.digest('hex');
|
|
92
|
-
}
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Resolve forgekit asset roots (skills, templates).
|
|
4
|
+
*
|
|
5
|
+
* Search order for assets:
|
|
6
|
+
* 1. FORGEKIT_ROOT env (dev / linked monorepo)
|
|
7
|
+
* 2. Monorepo root (packages/cli/../../..)
|
|
8
|
+
* 3. Vendored copy inside the published package (packages/cli/vendor)
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
import fs from 'node:fs';
|
|
12
|
+
import path from 'node:path';
|
|
13
|
+
import { fileURLToPath } from 'node:url';
|
|
14
|
+
import { createHash } from 'node:crypto';
|
|
15
|
+
|
|
16
|
+
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
17
|
+
|
|
18
|
+
/** @returns {string} Absolute path to packages/cli */
|
|
19
|
+
export function cliPackageRoot() {
|
|
20
|
+
return path.resolve(__dirname, '..');
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* Candidate forgekit roots that may contain skills/ and templates/.
|
|
25
|
+
* @returns {string[]}
|
|
26
|
+
*/
|
|
27
|
+
export function forgekitRootCandidates() {
|
|
28
|
+
const roots = [];
|
|
29
|
+
if (process.env.FORGEKIT_ROOT) roots.push(process.env.FORGEKIT_ROOT);
|
|
30
|
+
// Monorepo: packages/cli/src → ../../../
|
|
31
|
+
roots.push(path.resolve(__dirname, '..', '..', '..'));
|
|
32
|
+
// Published package: vendor/ next to src/
|
|
33
|
+
roots.push(path.join(cliPackageRoot(), 'vendor'));
|
|
34
|
+
return [...new Set(roots.map((r) => path.resolve(r)))];
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* @param {string} relativePath e.g. 'skills/forge' or 'templates/project'
|
|
39
|
+
* @param {{ requireFile?: string }} [opts] file that must exist under the candidate
|
|
40
|
+
* @returns {string}
|
|
41
|
+
*/
|
|
42
|
+
export function resolveAsset(relativePath, opts = {}) {
|
|
43
|
+
const requireFile = opts.requireFile;
|
|
44
|
+
const tried = [];
|
|
45
|
+
for (const root of forgekitRootCandidates()) {
|
|
46
|
+
const candidate = path.join(root, relativePath);
|
|
47
|
+
tried.push(candidate);
|
|
48
|
+
const check = requireFile ? path.join(candidate, requireFile) : candidate;
|
|
49
|
+
if (fs.existsSync(check)) return candidate;
|
|
50
|
+
}
|
|
51
|
+
throw new Error(
|
|
52
|
+
`Asset not found: ${relativePath}${requireFile ? ` (${requireFile})` : ''}.\nTried:\n ${tried.join('\n ')}`,
|
|
53
|
+
);
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* @returns {string} package version from packages/cli/package.json
|
|
58
|
+
*/
|
|
59
|
+
export function packageVersion() {
|
|
60
|
+
const pkgPath = path.join(cliPackageRoot(), 'package.json');
|
|
61
|
+
const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
|
|
62
|
+
return pkg.version ?? '0.0.0';
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* Stable content hash of a directory (sorted relative paths + file bytes).
|
|
67
|
+
* @param {string} dir
|
|
68
|
+
* @returns {string} sha256 hex
|
|
69
|
+
*/
|
|
70
|
+
export function hashDirectory(dir) {
|
|
71
|
+
const hash = createHash('sha256');
|
|
72
|
+
/** @type {string[]} */
|
|
73
|
+
const files = [];
|
|
74
|
+
const walk = (d, prefix = '') => {
|
|
75
|
+
for (const entry of fs.readdirSync(d, { withFileTypes: true })) {
|
|
76
|
+
if (entry.name === '.forgekit.json') continue;
|
|
77
|
+
const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
|
|
78
|
+
const full = path.join(d, entry.name);
|
|
79
|
+
if (entry.isDirectory()) walk(full, rel);
|
|
80
|
+
else files.push(rel);
|
|
81
|
+
}
|
|
82
|
+
};
|
|
83
|
+
walk(dir);
|
|
84
|
+
files.sort();
|
|
85
|
+
for (const rel of files) {
|
|
86
|
+
hash.update(rel);
|
|
87
|
+
hash.update('\0');
|
|
88
|
+
hash.update(fs.readFileSync(path.join(dir, ...rel.split('/'))));
|
|
89
|
+
hash.update('\0');
|
|
90
|
+
}
|
|
91
|
+
return hash.digest('hex');
|
|
92
|
+
}
|