@izkac/forgekit 0.3.12 → 0.3.14

package/src/new-session.mjs

@@ -1,99 +1,99 @@
-#!/usr/bin/env node
-/**
- * Create a new Forge session under .forge/sessions/ and set it active.
- *
- * Usage:
- *   forge new mercury-console-validation
- *   forge new <slug> [--chat-id <id>] [--signal <text>]
- */
-
-import {
-  defaultSession,
-  defaultStatus,
-  ensureForgeLayout,
-  FORGE_DIR,
-  makeSessionId,
-  saveSession,
-  scaffoldSessionDirs,
-  sessionPath,
-  writeActive,
-} from './lib.mjs';
-import { resolveSessionPaceFields } from './preferences.mjs';
-import { warnIfDoctorFails } from './doctor.mjs';
-import { liveOverlaps, queueMessage, sessionDirFor } from './lib/fleet.mjs';
-
-function usage() {
-  process.stderr.write(
-    'Usage: forge new <slug> [--chat-id <id>] [--signal <text>]\n',
-  );
-  process.exit(1);
-}
-
-const args = process.argv.slice(2);
-if (args.length === 0 || args[0] === '--help' || args[0] === '-h') usage();
-
-const slug = args[0];
-let cursorChatId = null;
-let signalText = null;
-for (let i = 1; i < args.length; i += 1) {
-  if (args[i] === '--chat-id' && args[i + 1]) {
-    cursorChatId = args[i + 1];
-    i += 1;
-  } else if (args[i] === '--signal' && args[i + 1]) {
-    signalText = args[i + 1];
-    i += 1;
-  }
-}
-
-ensureForgeLayout();
-warnIfDoctorFails({ cwd: process.cwd() });
-
-const sessionId = makeSessionId(slug);
-const dir = sessionPath(sessionId);
-scaffoldSessionDirs(dir);
-
-const session = defaultSession(sessionId, slug);
-if (cursorChatId) session.cursorChatId = cursorChatId;
-
-const paceFields = resolveSessionPaceFields({
-  forgeDir: FORGE_DIR,
-  slug: session.slug,
-  signalText: signalText || session.slug,
-});
-Object.assign(session, paceFields);
-
-saveSession(dir, session);
-writeActive(sessionId);
-
-// Fleet coordination: another live session in this working tree risks
-// conflicting edits — surface it here and notify the other sessions' inboxes.
-const overlaps = liveOverlaps(process.cwd(), sessionId);
-for (const o of overlaps) {
-  queueMessage(
-    sessionDirFor(o),
-    `Fleet overlap: session "${session.slug}" (${sessionId}) just started in this project. Coordinate with the user to avoid conflicting edits.`,
-  );
-}
-
-const out = {
-  sessionId,
-  dir,
-  session: defaultStatus(session),
-  pace: {
-    requested: session.pace,
-    resolved: session.resolvedPace,
-    reason: session.paceReason,
-  },
-};
-if (overlaps.length > 0) {
-  out.overlaps = overlaps.map((o) => ({
-    sessionId: o.sessionId,
-    slug: o.slug,
-    phase: o.phase,
-    engine: o.engine,
-    lastSeen: o.lastSeen ?? o.updatedAt,
-  }));
-  out.overlapAdvice =
-    'Other live sessions are working in this project. Tell the user and ask: continue anyway, use a git worktree, or pause one session.';
-}
-process.stdout.write(`${JSON.stringify(out, null, 2)}\n`);
+#!/usr/bin/env node
+/**
+ * Create a new Forge session under .forge/sessions/ and set it active.
+ *
+ * Usage:
+ *   forge new mercury-console-validation
+ *   forge new <slug> [--chat-id <id>] [--signal <text>]
+ */
+
+import {
+  defaultSession,
+  defaultStatus,
+  ensureForgeLayout,
+  FORGE_DIR,
+  makeSessionId,
+  saveSession,
+  scaffoldSessionDirs,
+  sessionPath,
+  writeActive,
+} from './lib.mjs';
+import { resolveSessionPaceFields } from './preferences.mjs';
+import { warnIfDoctorFails } from './doctor.mjs';
+import { liveOverlaps, queueMessage, sessionDirFor } from './lib/fleet.mjs';
+
+function usage() {
+  process.stderr.write(
+    'Usage: forge new <slug> [--chat-id <id>] [--signal <text>]\n',
+  );
+  process.exit(1);
+}
+
+const args = process.argv.slice(2);
+if (args.length === 0 || args[0] === '--help' || args[0] === '-h') usage();
+
+const slug = args[0];
+let cursorChatId = null;
+let signalText = null;
+for (let i = 1; i < args.length; i += 1) {
+  if (args[i] === '--chat-id' && args[i + 1]) {
+    cursorChatId = args[i + 1];
+    i += 1;
+  } else if (args[i] === '--signal' && args[i + 1]) {
+    signalText = args[i + 1];
+    i += 1;
+  }
+}
+
+ensureForgeLayout();
+warnIfDoctorFails({ cwd: process.cwd() });
+
+const sessionId = makeSessionId(slug);
+const dir = sessionPath(sessionId);
+scaffoldSessionDirs(dir);
+
+const session = defaultSession(sessionId, slug);
+if (cursorChatId) session.cursorChatId = cursorChatId;
+
+const paceFields = resolveSessionPaceFields({
+  forgeDir: FORGE_DIR,
+  slug: session.slug,
+  signalText: signalText || session.slug,
+});
+Object.assign(session, paceFields);
+
+saveSession(dir, session);
+writeActive(sessionId);
+
+// Fleet coordination: another live session in this working tree risks
+// conflicting edits — surface it here and notify the other sessions' inboxes.
+const overlaps = liveOverlaps(process.cwd(), sessionId);
+for (const o of overlaps) {
+  queueMessage(
+    sessionDirFor(o),
+    `Fleet overlap: session "${session.slug}" (${sessionId}) just started in this project. Coordinate with the user to avoid conflicting edits.`,
+  );
+}
+
+const out = {
+  sessionId,
+  dir,
+  session: defaultStatus(session),
+  pace: {
+    requested: session.pace,
+    resolved: session.resolvedPace,
+    reason: session.paceReason,
+  },
+};
+if (overlaps.length > 0) {
+  out.overlaps = overlaps.map((o) => ({
+    sessionId: o.sessionId,
+    slug: o.slug,
+    phase: o.phase,
+    engine: o.engine,
+    lastSeen: o.lastSeen ?? o.updatedAt,
+  }));
+  out.overlapAdvice =
+    'Other live sessions are working in this project. Tell the user and ask: continue anyway, use a git worktree, or pause one session.';
+}
+process.stdout.write(`${JSON.stringify(out, null, 2)}\n`);

package/src/openspec-overlays/README.md

@@ -1,19 +1,19 @@
-# OpenSpec Forge overlays
-
-Vendor OpenSpec skills and `/opsx:*` commands are upgraded in place. **Do not hand-edit** them.
-
-Forge adaptations live here and are applied by:
-
-```bash
-forge overlay
-```
-
-Run after refreshing OpenSpec skills/commands from upstream (usually via `forge init --overlay`).
-
-| Overlay | Targets |
-| ------- | ------- |
-| `opsx-apply-implement-step.md` | Step 6 in `opsx-apply` / `opsx/apply` commands |
-| `opsx-apply-completion-step.md` | Step 7 “all done” bullet in same commands |
-| `openspec-apply-change-footer.md` | Footer on `openspec-apply-change/SKILL.md` (all agents) |
-
-**Forge-owned (never overwritten):** `/forge:apply` command, `forge/` skill tree.
+# OpenSpec Forge overlays
+
+Vendor OpenSpec skills and `/opsx:*` commands are upgraded in place. **Do not hand-edit** them.
+
+Forge adaptations live here and are applied by:
+
+```bash
+forge overlay
+```
+
+Run after refreshing OpenSpec skills/commands from upstream (usually via `forge init --overlay`).
+
+| Overlay | Targets |
+| ------- | ------- |
+| `opsx-apply-implement-step.md` | Step 6 in `opsx-apply` / `opsx/apply` commands |
+| `opsx-apply-completion-step.md` | Step 7 “all done” bullet in same commands |
+| `openspec-apply-change-footer.md` | Footer on `openspec-apply-change/SKILL.md` (all agents) |
+
+**Forge-owned (never overwritten):** `/forge:apply` command, `forge/` skill tree.

package/src/openspec-overlays/openspec-apply-change-footer.md

@@ -1,14 +1,14 @@
-
----
-
-<!-- forgekit:openspec-overlay:start -->
-
-## Forge overlay (re-applied by `forge overlay`)
-
-**Do not implement tasks inline in coordinator context.**
-
-1. Prefer **`/forge:apply`** for OpenSpec implement + verify + review.
-2. Otherwise follow vendor steps 1–5 above, then **`{{PHASES_IMPLEMENT}}`** for step 6+.
-3. Re-apply this overlay after upgrading OpenSpec skills: `forge overlay`
-
-<!-- forgekit:openspec-overlay:end -->
+
+---
+
+<!-- forgekit:openspec-overlay:start -->
+
+## Forge overlay (re-applied by `forge overlay`)
+
+**Do not implement tasks inline in coordinator context.**
+
+1. Prefer **`/forge:apply`** for OpenSpec implement + verify + review.
+2. Otherwise follow vendor steps 1–5 above, then **`{{PHASES_IMPLEMENT}}`** for step 6+.
+3. Re-apply this overlay after upgrading OpenSpec skills: `forge overlay`
+
+<!-- forgekit:openspec-overlay:end -->

package/src/openspec-overlays/opsx-apply-completion-step.md

@@ -1 +1 @@
-   - If all done: proceed to Forge [verify]({{PHASES_VERIFY}}) and [review]({{PHASES_REVIEW}}) when in a Forge session (or user invoked `/forge:apply`), then suggest `/opsx:archive`
+   - If all done: proceed to Forge [verify]({{PHASES_VERIFY}}) and [review]({{PHASES_REVIEW}}) when in a Forge session (or user invoked `/forge:apply`), then suggest `/opsx:archive`

package/src/openspec-overlays/opsx-apply-implement-step.md

@@ -1,11 +1,11 @@
-**REQUIRED (Forge):** Wrap this loop in the implement phase —
-`{{PHASES_IMPLEMENT}}`.
-Use bundled `skills/subagent-driven-development` + `skills/test-driven-development` per task.
-Prefer **`/forge:apply`** over bare `/opsx:apply` — same OpenSpec CLI steps plus verify and review.
-
-   For each pending task:
-   - Show which task is being worked on
-   - Dispatch **implementer** subagent (TDD first), then **spec** + **quality** reviewers
-   - Keep changes minimal and focused
-   - Mark task complete in the tasks file: `- [ ]` → `- [x]`
-   - Continue to next task
+**REQUIRED (Forge):** Wrap this loop in the implement phase —
+`{{PHASES_IMPLEMENT}}`.
+Use bundled `skills/subagent-driven-development` + `skills/test-driven-development` per task.
+Prefer **`/forge:apply`** over bare `/opsx:apply` — same OpenSpec CLI steps plus verify and review.
+
+   For each pending task:
+   - Show which task is being worked on
+   - Dispatch **implementer** subagent (TDD first), then **spec** + **quality** reviewers
+   - Keep changes minimal and focused
+   - Mark task complete in the tasks file: `- [ ]` → `- [x]`
+   - Continue to next task

package/src/paths.mjs

@@ -1,92 +1,92 @@
-#!/usr/bin/env node
-/**
- * Resolve forgekit asset roots (skills, templates).
- *
- * Search order for assets:
- *   1. FORGEKIT_ROOT env (dev / linked monorepo)
- *   2. Monorepo root (packages/cli/../../..)
- *   3. Vendored copy inside the published package (packages/cli/vendor)
- */
-
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { createHash } from 'node:crypto';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-/** @returns {string} Absolute path to packages/cli */
-export function cliPackageRoot() {
-  return path.resolve(__dirname, '..');
-}
-
-/**
- * Candidate forgekit roots that may contain skills/ and templates/.
- * @returns {string[]}
- */
-export function forgekitRootCandidates() {
-  const roots = [];
-  if (process.env.FORGEKIT_ROOT) roots.push(process.env.FORGEKIT_ROOT);
-  // Monorepo: packages/cli/src → ../../../
-  roots.push(path.resolve(__dirname, '..', '..', '..'));
-  // Published package: vendor/ next to src/
-  roots.push(path.join(cliPackageRoot(), 'vendor'));
-  return [...new Set(roots.map((r) => path.resolve(r)))];
-}
-
-/**
- * @param {string} relativePath e.g. 'skills/forge' or 'templates/project'
- * @param {{ requireFile?: string }} [opts] file that must exist under the candidate
- * @returns {string}
- */
-export function resolveAsset(relativePath, opts = {}) {
-  const requireFile = opts.requireFile;
-  const tried = [];
-  for (const root of forgekitRootCandidates()) {
-    const candidate = path.join(root, relativePath);
-    tried.push(candidate);
-    const check = requireFile ? path.join(candidate, requireFile) : candidate;
-    if (fs.existsSync(check)) return candidate;
-  }
-  throw new Error(
-    `Asset not found: ${relativePath}${requireFile ? ` (${requireFile})` : ''}.\nTried:\n  ${tried.join('\n  ')}`,
-  );
-}
-
-/**
- * @returns {string} package version from packages/cli/package.json
- */
-export function packageVersion() {
-  const pkgPath = path.join(cliPackageRoot(), 'package.json');
-  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-  return pkg.version ?? '0.0.0';
-}
-
-/**
- * Stable content hash of a directory (sorted relative paths + file bytes).
- * @param {string} dir
- * @returns {string} sha256 hex
- */
-export function hashDirectory(dir) {
-  const hash = createHash('sha256');
-  /** @type {string[]} */
-  const files = [];
-  const walk = (d, prefix = '') => {
-    for (const entry of fs.readdirSync(d, { withFileTypes: true })) {
-      if (entry.name === '.forgekit.json') continue;
-      const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
-      const full = path.join(d, entry.name);
-      if (entry.isDirectory()) walk(full, rel);
-      else files.push(rel);
-    }
-  };
-  walk(dir);
-  files.sort();
-  for (const rel of files) {
-    hash.update(rel);
-    hash.update('\0');
-    hash.update(fs.readFileSync(path.join(dir, ...rel.split('/'))));
-    hash.update('\0');
-  }
-  return hash.digest('hex');
-}
+#!/usr/bin/env node
+/**
+ * Resolve forgekit asset roots (skills, templates).
+ *
+ * Search order for assets:
+ *   1. FORGEKIT_ROOT env (dev / linked monorepo)
+ *   2. Monorepo root (packages/cli/../../..)
+ *   3. Vendored copy inside the published package (packages/cli/vendor)
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createHash } from 'node:crypto';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/** @returns {string} Absolute path to packages/cli */
+export function cliPackageRoot() {
+  return path.resolve(__dirname, '..');
+}
+
+/**
+ * Candidate forgekit roots that may contain skills/ and templates/.
+ * @returns {string[]}
+ */
+export function forgekitRootCandidates() {
+  const roots = [];
+  if (process.env.FORGEKIT_ROOT) roots.push(process.env.FORGEKIT_ROOT);
+  // Monorepo: packages/cli/src → ../../../
+  roots.push(path.resolve(__dirname, '..', '..', '..'));
+  // Published package: vendor/ next to src/
+  roots.push(path.join(cliPackageRoot(), 'vendor'));
+  return [...new Set(roots.map((r) => path.resolve(r)))];
+}
+
+/**
+ * @param {string} relativePath e.g. 'skills/forge' or 'templates/project'
+ * @param {{ requireFile?: string }} [opts] file that must exist under the candidate
+ * @returns {string}
+ */
+export function resolveAsset(relativePath, opts = {}) {
+  const requireFile = opts.requireFile;
+  const tried = [];
+  for (const root of forgekitRootCandidates()) {
+    const candidate = path.join(root, relativePath);
+    tried.push(candidate);
+    const check = requireFile ? path.join(candidate, requireFile) : candidate;
+    if (fs.existsSync(check)) return candidate;
+  }
+  throw new Error(
+    `Asset not found: ${relativePath}${requireFile ? ` (${requireFile})` : ''}.\nTried:\n  ${tried.join('\n  ')}`,
+  );
+}
+
+/**
+ * @returns {string} package version from packages/cli/package.json
+ */
+export function packageVersion() {
+  const pkgPath = path.join(cliPackageRoot(), 'package.json');
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+  return pkg.version ?? '0.0.0';
+}
+
+/**
+ * Stable content hash of a directory (sorted relative paths + file bytes).
+ * @param {string} dir
+ * @returns {string} sha256 hex
+ */
+export function hashDirectory(dir) {
+  const hash = createHash('sha256');
+  /** @type {string[]} */
+  const files = [];
+  const walk = (d, prefix = '') => {
+    for (const entry of fs.readdirSync(d, { withFileTypes: true })) {
+      if (entry.name === '.forgekit.json') continue;
+      const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+      const full = path.join(d, entry.name);
+      if (entry.isDirectory()) walk(full, rel);
+      else files.push(rel);
+    }
+  };
+  walk(dir);
+  files.sort();
+  for (const rel of files) {
+    hash.update(rel);
+    hash.update('\0');
+    hash.update(fs.readFileSync(path.join(dir, ...rel.split('/'))));
+    hash.update('\0');
+  }
+  return hash.digest('hex');
+}