@izkac/forgekit 0.3.12 → 0.3.14

package/bin/forge.mjs

@@ -1,107 +1,119 @@
-#!/usr/bin/env node
-/**
- * Forge CLI — session orchestration, prefs, models, project init.
- *
- * Usage: forge <command> [args...]
- * Install: forge install → forgekit install --skills forge …
- */
-
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { spawnSync } from 'node:child_process';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SRC = path.join(__dirname, '..', 'src');
-
-/** @type {Record<string, { script: string, aliases?: string[], prependArgs?: string[] }>} */
-const COMMANDS = {
-  new: { script: 'new-session.mjs', aliases: ['session-new'] },
-  status: { script: 'session-status.mjs' },
-  cleanup: { script: 'cleanup-sessions.mjs' },
-  phase: { script: 'set-phase.mjs', aliases: ['set-phase'] },
-  prefs: { script: 'set-prefs.mjs' },
-  models: { script: 'set-models.mjs' },
-  'resolve-model': { script: 'resolve-model.mjs' },
-  doctor: { script: 'doctor.mjs' },
-  evidence: { script: 'record-evidence.mjs' },
-  reminder: { script: 'session-reminder.mjs' },
-  overlay: { script: 'vendor-openspec-overlays.mjs', aliases: ['overlays'] },
-  install: { script: 'install.mjs', prependArgs: ['--skills', 'forge'] },
-  init: { script: 'init.mjs' },
-  triage: { script: 'triage-prompt.mjs' },
-  change: { script: 'change.mjs' },
-  spine: { script: 'spine.mjs' },
-  e2e: { script: 'e2e.mjs' },
-  defer: { script: 'defer.mjs' },
-  'integrity-check': { script: 'integrity-check.mjs', aliases: ['integrity'] },
-  score: { script: 'score-cli.mjs', aliases: ['scorecard'] },
-  fleet: { script: 'fleet.mjs' },
-  brief: { script: 'brief-cli.mjs' },
-};
-
-function printHelp() {
-  process.stdout.write(`Forge — disciplined development workflow
-
-Usage:
-  forge <command> [args...]
-
-Commands:
-  new <slug>              Create a Forge session under .forge/
-  status                  Show active session
-  phase <phase>           Update session phase
-  cleanup                 Prune old/finished sessions
-  prefs [pace]            Get/set pace preferences
-  models [lane]           Get/set subagent billing (included|metered)
-  resolve-model --tier …  Resolve subagent model JSON
-  doctor                  Plan-engine readiness (OpenSpec or specs)
-  evidence                Stamp tier-2 test-evidence.md
-  reminder                Session reminder (for hooks)
-  overlay                 Re-apply OpenSpec vendor overlays in this project
-  install                 Alias → forgekit install --skills forge
-  init                    Wire Forge commands/hooks/rules into this project
-  triage                  Classify whether a prompt needs Forge triage
-  change new|archive      Specs-engine change scaffold / archive
-  spine init|check        Capability→runtime spine matrix (spine.json)
-  e2e init|run|check      Executable product-loop acceptance (e2e.json)
-  e2e disable|enable      Operator-only project e2e off switch
-  defer add|resolve|list  Deferral registry (deferred wiring = tracked debt)
-  integrity-check         Mechanical integrity gate (runs at phase done)
-  score [--write]         L2 session scorecard (auto-written at phase done)
-  fleet list|watch|view|send  Cross-project session control terminal
-  brief stamp|check|open  Operator brief (plain-language HTML, gates implement)
-
-Prefer \`forgekit install\` to pick multiple skills + agents at once.
-
-Global:
-  forge --help
-  forge <command> --help
-`);
-}
-
-const argv = process.argv.slice(2);
-if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {
-  printHelp();
-  process.exit(0);
-}
-
-const [cmd, ...rest] = argv;
-const entry = COMMANDS[cmd] ?? Object.values(COMMANDS).find((c) => c.aliases?.includes(cmd));
-
-if (!entry) {
-  process.stderr.write(`Unknown command: ${cmd}\n\n`);
-  printHelp();
-  process.exit(1);
-}
-
-const args = [...(entry.prependArgs ?? []), ...rest];
-const r = spawnSync(process.execPath, [path.join(SRC, entry.script), ...args], {
-  stdio: 'inherit',
-  cwd: process.cwd(),
-  env: {
-    ...process.env,
-    FORGEKIT_ROOT: path.resolve(__dirname, '..', '..', '..'),
-    FORGEKIT_CLI_ROOT: path.resolve(__dirname, '..'),
-  },
-});
-
-process.exit(r.status ?? 1);
+#!/usr/bin/env node
+/**
+ * Forge CLI — session orchestration, prefs, models, project init.
+ *
+ * Usage: forge <command> [args...]
+ * Install: forge install → forgekit install --skills forge …
+ */
+
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+import { findRepoRoot } from '../src/repo-root.mjs';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const SRC = path.join(__dirname, '..', 'src');
+
+/** @type {Record<string, { script: string, aliases?: string[], prependArgs?: string[] }>} */
+const COMMANDS = {
+  new: { script: 'new-session.mjs', aliases: ['session-new'] },
+  status: { script: 'session-status.mjs' },
+  cleanup: { script: 'cleanup-sessions.mjs' },
+  phase: { script: 'set-phase.mjs', aliases: ['set-phase'] },
+  prefs: { script: 'set-prefs.mjs' },
+  models: { script: 'set-models.mjs' },
+  'resolve-model': { script: 'resolve-model.mjs' },
+  doctor: { script: 'doctor.mjs' },
+  evidence: { script: 'record-evidence.mjs' },
+  reminder: { script: 'session-reminder.mjs' },
+  overlay: { script: 'vendor-openspec-overlays.mjs', aliases: ['overlays'] },
+  install: { script: 'install.mjs', prependArgs: ['--skills', 'forge'] },
+  init: { script: 'init.mjs' },
+  triage: { script: 'triage-prompt.mjs' },
+  change: { script: 'change.mjs' },
+  spine: { script: 'spine.mjs' },
+  e2e: { script: 'e2e.mjs' },
+  defer: { script: 'defer.mjs' },
+  'integrity-check': { script: 'integrity-check.mjs', aliases: ['integrity'] },
+  score: { script: 'score-cli.mjs', aliases: ['scorecard'] },
+  fleet: { script: 'fleet.mjs' },
+  brief: { script: 'brief-cli.mjs' },
+};
+
+function printHelp() {
+  process.stdout.write(`Forge — disciplined development workflow
+
+Usage:
+  forge <command> [args...]
+
+Commands:
+  new <slug>              Create a Forge session under .forge/
+  status                  Show active session
+  phase <phase>           Update session phase
+  cleanup                 Prune old/finished sessions
+  prefs [pace]            Get/set pace preferences
+  models [lane]           Get/set subagent billing (included|metered)
+  resolve-model --tier …  Resolve subagent model JSON
+  doctor                  Plan-engine readiness (OpenSpec or specs)
+  evidence                Stamp tier-2 test-evidence.md
+  reminder                Session reminder (for hooks)
+  overlay                 Re-apply OpenSpec vendor overlays in this project
+  install                 Alias → forgekit install --skills forge
+  init                    Wire Forge commands/hooks/rules into this project
+  triage                  Classify whether a prompt needs Forge triage
+  change new|archive      Specs-engine change scaffold / archive
+  spine init|check        Capability→runtime spine matrix (spine.json)
+  e2e init|run|check      Executable product-loop acceptance (e2e.json)
+  e2e disable|enable      Operator-only project e2e off switch
+  defer add|resolve|list  Deferral registry (deferred wiring = tracked debt)
+  integrity-check         Mechanical integrity gate (runs at phase done)
+  score [--write]         L2 session scorecard (auto-written at phase done)
+  fleet list|watch|view|send  Cross-project session control terminal
+  brief stamp|check|open  Operator brief (plain-language HTML, gates implement)
+
+Prefer \`forgekit install\` to pick multiple skills + agents at once.
+
+Global:
+  forge --help
+  forge <command> --help
+`);
+}
+
+const argv = process.argv.slice(2);
+if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {
+  printHelp();
+  process.exit(0);
+}
+
+const [cmd, ...rest] = argv;
+const entry = COMMANDS[cmd] ?? Object.values(COMMANDS).find((c) => c.aliases?.includes(cmd));
+
+if (!entry) {
+  process.stderr.write(`Unknown command: ${cmd}\n\n`);
+  printHelp();
+  process.exit(1);
+}
+
+// Every subcommand is project-scoped, so run it from the project root rather
+// than wherever the shell happens to sit: `cd crates && forge status` used to
+// report "no session" and `forge new` would have written a second .forge tree
+// inside the workspace. An explicit relative `--cwd` still means what the
+// caller typed, so absolutize it against the invocation dir first.
+const invokedFrom = process.cwd();
+const repoRoot = findRepoRoot(invokedFrom);
+const args = [...(entry.prependArgs ?? []), ...rest].map((arg, i, all) =>
+  i > 0 && all[i - 1] === '--cwd' && !path.isAbsolute(arg) ? path.resolve(invokedFrom, arg) : arg,
+);
+
+const r = spawnSync(process.execPath, [path.join(SRC, entry.script), ...args], {
+  stdio: 'inherit',
+  cwd: repoRoot,
+  env: {
+    ...process.env,
+    FORGE_INVOKED_FROM: invokedFrom,
+    FORGEKIT_ROOT: path.resolve(__dirname, '..', '..', '..'),
+    FORGEKIT_CLI_ROOT: path.resolve(__dirname, '..'),
+  },
+});
+
+process.exit(r.status ?? 1);

package/bin/forgekit.mjs

@@ -1,84 +1,84 @@
 #!/usr/bin/env node
-/**
- * Forgekit meta CLI — install / list / update / uninstall skills across agents.
- *
- * Skill day-to-day commands stay on `forge` and `review`.
- *
- * Usage: forgekit <command> [args...]
- */
-
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { spawnSync } from 'node:child_process';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SRC = path.join(__dirname, '..', 'src');
-
-/** @type {Record<string, { script: string, prependArgs?: string[] }>} */
-const COMMANDS = {
-  install: { script: 'install.mjs' },
-  list: { script: 'install.mjs', prependArgs: ['--list'] },
-  update: { script: 'install.mjs', prependArgs: ['--update'] },
-  uninstall: { script: 'install.mjs', prependArgs: ['--uninstall'] },
-};
-
-function printHelp() {
-  process.stdout.write(`Forgekit — portable agent skills
-
-Usage:
-  forgekit <command> [args...]
-
-Commands:
-  install                 Install skills into ~/.cursor|claude|codex/skills/
-  list                    Show installed / missing / outdated (skill × agent)
-  update                  Reinstall outdated skills
-  uninstall               Remove installed skill directories
-
-Install picks skills and agents (interactive on TTY, or via flags).
-Also asks about planning engine (OpenSpec vs specs) and ADRs:
-
-  forgekit install
-  forgekit install --skills forge,thorough-code-review --agents cursor,claude
-  forgekit install --adr --adr-dir docs/adr --adr-project
-  forgekit install --all-skills --all-agents --force
-  forgekit list
-  forgekit update
-  forgekit uninstall --skills forge --agents cursor
-
-Day-to-day skill CLIs (same package):
-
-  forge …                 Forge workflow sessions
-  review …                Thorough code review pipeline
-
-  forge install …         Alias → forgekit install --skills forge …
-  review install …        Alias → forgekit install --skills thorough-code-review …
-`);
-}
-
-const argv = process.argv.slice(2);
-if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {
-  printHelp();
-  process.exit(0);
-}
-
-const [cmd, ...rest] = argv;
-const entry = COMMANDS[cmd];
-
-if (!entry) {
-  process.stderr.write(`Unknown command: ${cmd}\n\n`);
-  printHelp();
-  process.exit(1);
-}
-
-const args = [...(entry.prependArgs ?? []), ...rest];
-const r = spawnSync(process.execPath, [path.join(SRC, entry.script), ...args], {
-  stdio: 'inherit',
-  cwd: process.cwd(),
-  env: {
-    ...process.env,
-    FORGEKIT_ROOT: path.resolve(__dirname, '..', '..', '..'),
-    FORGEKIT_CLI_ROOT: path.resolve(__dirname, '..'),
-  },
-});
-
-process.exit(r.status ?? 1);
+/**
+ * Forgekit meta CLI — install / list / update / uninstall skills across agents.
+ *
+ * Skill day-to-day commands stay on `forge` and `review`.
+ *
+ * Usage: forgekit <command> [args...]
+ */
+
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const SRC = path.join(__dirname, '..', 'src');
+
+/** @type {Record<string, { script: string, prependArgs?: string[] }>} */
+const COMMANDS = {
+  install: { script: 'install.mjs' },
+  list: { script: 'install.mjs', prependArgs: ['--list'] },
+  update: { script: 'install.mjs', prependArgs: ['--update'] },
+  uninstall: { script: 'install.mjs', prependArgs: ['--uninstall'] },
+};
+
+function printHelp() {
+  process.stdout.write(`Forgekit — portable agent skills
+
+Usage:
+  forgekit <command> [args...]
+
+Commands:
+  install                 Install skills into ~/.cursor|claude|codex/skills/
+  list                    Show installed / missing / outdated (skill × agent)
+  update                  Reinstall outdated skills
+  uninstall               Remove installed skill directories
+
+Install picks skills and agents (interactive on TTY, or via flags).
+Also asks about planning engine (OpenSpec vs specs) and ADRs:
+
+  forgekit install
+  forgekit install --skills forge,thorough-code-review --agents cursor,claude
+  forgekit install --adr --adr-dir docs/adr --adr-project
+  forgekit install --all-skills --all-agents --force
+  forgekit list
+  forgekit update
+  forgekit uninstall --skills forge --agents cursor
+
+Day-to-day skill CLIs (same package):
+
+  forge …                 Forge workflow sessions
+  review …                Thorough code review pipeline
+
+  forge install …         Alias → forgekit install --skills forge …
+  review install …        Alias → forgekit install --skills thorough-code-review …
+`);
+}
+
+const argv = process.argv.slice(2);
+if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {
+  printHelp();
+  process.exit(0);
+}
+
+const [cmd, ...rest] = argv;
+const entry = COMMANDS[cmd];
+
+if (!entry) {
+  process.stderr.write(`Unknown command: ${cmd}\n\n`);
+  printHelp();
+  process.exit(1);
+}
+
+const args = [...(entry.prependArgs ?? []), ...rest];
+const r = spawnSync(process.execPath, [path.join(SRC, entry.script), ...args], {
+  stdio: 'inherit',
+  cwd: process.cwd(),
+  env: {
+    ...process.env,
+    FORGEKIT_ROOT: path.resolve(__dirname, '..', '..', '..'),
+    FORGEKIT_CLI_ROOT: path.resolve(__dirname, '..'),
+  },
+});
+
+process.exit(r.status ?? 1);

package/bin/review.mjs

@@ -1,82 +1,82 @@
 #!/usr/bin/env node
-/**
- * Review CLI — thorough-code-review scaffolding, render, export, signals.
- *
- * Usage: review <command> [args...]
- * Install: review install → forgekit install --skills thorough-code-review …
- */
-
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { spawnSync } from 'node:child_process';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SRC = path.join(__dirname, '..', 'src');
-const REVIEW_SRC = path.join(SRC, 'review');
-
-/** @type {Record<string, { script: string, prependArgs?: string[] }>} */
-const COMMANDS = {
-  new: { script: path.join(REVIEW_SRC, 'new-review.mjs') },
-  render: { script: path.join(REVIEW_SRC, 'render.mjs') },
-  export: { script: path.join(REVIEW_SRC, 'export.mjs') },
-  carryforward: { script: path.join(REVIEW_SRC, 'carryforward.mjs') },
-  merge: { script: path.join(REVIEW_SRC, 'merge-tentative.mjs') },
-  signals: { script: path.join(REVIEW_SRC, 'signals.mjs') },
-  install: {
-    script: path.join(SRC, 'install.mjs'),
-    prependArgs: ['--skills', 'thorough-code-review'],
-  },
-};
-
-function printHelp() {
-  process.stdout.write(`Review — thorough code review tooling
-
-Usage:
-  review <command> [args...]
-
-Commands:
-  new <slug>              Scaffold .reviews/<id>-review.json
-  render                  Generate markdown from JSON
-  export                  Validate + summarize (+ optional CI gate)
-  carryforward            Inherit prior verdicts for unchanged files
-  merge                   Merge scout tentative JSON shards
-  signals                 Plan typecheck/lint/test grounding commands
-  install                 Alias → forgekit install --skills thorough-code-review
-
-Prefer \`forgekit install\` to pick multiple skills + agents at once.
-
-Global:
-  review --help
-  review <command> --help
-
-After install, invoke the skill explicitly in your agent (it does not auto-load).
-`);
-}
-
-const argv = process.argv.slice(2);
-if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {
-  printHelp();
-  process.exit(0);
-}
-
-const [cmd, ...rest] = argv;
-const entry = COMMANDS[cmd];
-
-if (!entry) {
-  process.stderr.write(`Unknown command: ${cmd}\n\n`);
-  printHelp();
-  process.exit(1);
-}
-
-const args = [...(entry.prependArgs ?? []), ...rest];
-const r = spawnSync(process.execPath, [entry.script, ...args], {
-  stdio: 'inherit',
-  cwd: process.cwd(),
-  env: {
-    ...process.env,
-    FORGEKIT_ROOT: path.resolve(__dirname, '..', '..', '..'),
-    FORGEKIT_CLI_ROOT: path.resolve(__dirname, '..'),
-  },
-});
-
-process.exit(r.status ?? 1);
+/**
+ * Review CLI — thorough-code-review scaffolding, render, export, signals.
+ *
+ * Usage: review <command> [args...]
+ * Install: review install → forgekit install --skills thorough-code-review …
+ */
+
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const SRC = path.join(__dirname, '..', 'src');
+const REVIEW_SRC = path.join(SRC, 'review');
+
+/** @type {Record<string, { script: string, prependArgs?: string[] }>} */
+const COMMANDS = {
+  new: { script: path.join(REVIEW_SRC, 'new-review.mjs') },
+  render: { script: path.join(REVIEW_SRC, 'render.mjs') },
+  export: { script: path.join(REVIEW_SRC, 'export.mjs') },
+  carryforward: { script: path.join(REVIEW_SRC, 'carryforward.mjs') },
+  merge: { script: path.join(REVIEW_SRC, 'merge-tentative.mjs') },
+  signals: { script: path.join(REVIEW_SRC, 'signals.mjs') },
+  install: {
+    script: path.join(SRC, 'install.mjs'),
+    prependArgs: ['--skills', 'thorough-code-review'],
+  },
+};
+
+function printHelp() {
+  process.stdout.write(`Review — thorough code review tooling
+
+Usage:
+  review <command> [args...]
+
+Commands:
+  new <slug>              Scaffold .reviews/<id>-review.json
+  render                  Generate markdown from JSON
+  export                  Validate + summarize (+ optional CI gate)
+  carryforward            Inherit prior verdicts for unchanged files
+  merge                   Merge scout tentative JSON shards
+  signals                 Plan typecheck/lint/test grounding commands
+  install                 Alias → forgekit install --skills thorough-code-review
+
+Prefer \`forgekit install\` to pick multiple skills + agents at once.
+
+Global:
+  review --help
+  review <command> --help
+
+After install, invoke the skill explicitly in your agent (it does not auto-load).
+`);
+}
+
+const argv = process.argv.slice(2);
+if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {
+  printHelp();
+  process.exit(0);
+}
+
+const [cmd, ...rest] = argv;
+const entry = COMMANDS[cmd];
+
+if (!entry) {
+  process.stderr.write(`Unknown command: ${cmd}\n\n`);
+  printHelp();
+  process.exit(1);
+}
+
+const args = [...(entry.prependArgs ?? []), ...rest];
+const r = spawnSync(process.execPath, [entry.script, ...args], {
+  stdio: 'inherit',
+  cwd: process.cwd(),
+  env: {
+    ...process.env,
+    FORGEKIT_ROOT: path.resolve(__dirname, '..', '..', '..'),
+    FORGEKIT_CLI_ROOT: path.resolve(__dirname, '..'),
+  },
+});
+
+process.exit(r.status ?? 1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@izkac/forgekit",
-  "version": "0.3.12",
+  "version": "0.3.14",
   "description": "Forgekit CLIs — forgekit (install), forge (workflow), review (code review)",
   "type": "module",
   "bin": {
@@ -16,6 +16,7 @@
   ],
   "scripts": {
     "prepack": "node scripts/prepack.mjs",
+    "prepublishOnly": "npm run lint && npm test",
     "test": "node scripts/run-tests.mjs",
     "lint": "eslint src bin scripts"
   },