@izkac/forgekit 0.3.11 → 0.3.13

package/src/lib.mjs

@@ -1,143 +1,143 @@
-#!/usr/bin/env node
-/**
- * Shared helpers for Forge session management.
- */
-
-import crypto from 'node:crypto';
-import fs from 'node:fs';
-import path from 'node:path';
-import { registerSession } from './lib/fleet.mjs';
-
-export const REPO_ROOT = process.cwd();
-export const FORGE_DIR = path.join(REPO_ROOT, '.forge');
-export const SESSIONS_DIR = path.join(FORGE_DIR, 'sessions');
-export const ACTIVE_FILE = path.join(FORGE_DIR, 'active.json');
-export const RETENTION_DAYS = 14;
-
-export function ensureForgeLayout() {
-  fs.mkdirSync(SESSIONS_DIR, { recursive: true });
-}
-
-export function slugify(input) {
-  return String(input)
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/^-+|-+$/g, '')
-    .slice(0, 48) || 'session';
-}
-
-export function utcCompactNow() {
-  return new Date().toISOString().replace(/[-:]/g, '').replace(/\.\d{3}Z$/, 'Z');
-}
-
-export function randomSuffix(bytes = 3) {
-  return crypto.randomBytes(bytes).toString('hex');
-}
-
-export function makeSessionId(slug) {
-  return `${utcCompactNow()}-${slugify(slug)}-${randomSuffix()}`;
-}
-
-export function sessionPath(sessionId) {
-  return path.join(SESSIONS_DIR, sessionId);
-}
-
-export function readJson(filePath) {
-  return JSON.parse(fs.readFileSync(filePath, 'utf8'));
-}
-
-export function writeJson(filePath, data) {
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
-}
-
-export function readActive() {
-  if (!fs.existsSync(ACTIVE_FILE)) return null;
-  try {
-    return readJson(ACTIVE_FILE);
-  } catch {
-    return null;
-  }
-}
-
-export function writeActive(sessionId) {
-  writeJson(ACTIVE_FILE, {
-    sessionId,
-    sessionPath: path.relative(REPO_ROOT, sessionPath(sessionId)).replace(/\\/g, '/'),
-    updatedAt: new Date().toISOString(),
-  });
-}
-
-export function clearActive() {
-  if (fs.existsSync(ACTIVE_FILE)) fs.unlinkSync(ACTIVE_FILE);
-}
-
-export function defaultSession(sessionId, slug) {
-  const now = new Date().toISOString();
-  return {
-    id: sessionId,
-    slug: slugify(slug),
-    createdAt: now,
-    updatedAt: now,
-    phase: 'triage',
-    planType: null,
-    openspecChange: null,
-    forgeSkipped: false,
-    cursorChatId: null,
-    tasksTotal: 0,
-    tasksComplete: 0,
-    /** Requested pace: auto | thorough | standard | brisk | lite */
-    pace: 'auto',
-    /** Concrete pace after auto resolve or explicit pin */
-    resolvedPace: null,
-    paceReason: null,
-    paceSignal: null,
-    pacePinned: false,
-    preferencesOverride: null,
-  };
-}
-
-export function defaultStatus(session) {
-  return {
-    sessionId: session.id,
-    phase: session.phase,
-    planType: session.planType,
-    openspecChange: session.openspecChange,
-    tasksTotal: session.tasksTotal,
-    tasksComplete: session.tasksComplete,
-    pace: session.pace ?? null,
-    resolvedPace: session.resolvedPace ?? null,
-    paceReason: session.paceReason ?? null,
-    updatedAt: session.updatedAt,
-  };
-}
-
-export function scaffoldSessionDirs(dir) {
-  for (const sub of ['brainstorm', 'tasks', 'reviews']) {
-    fs.mkdirSync(path.join(dir, sub), { recursive: true });
-  }
-}
-
-export function loadSession(sessionId) {
-  const dir = sessionPath(sessionId);
-  const file = path.join(dir, 'session.json');
-  if (!fs.existsSync(file)) {
-    throw new Error(`Session not found: ${sessionId}`);
-  }
-  return { dir, session: readJson(file) };
-}
-
-export function saveSession(dir, session) {
-  session.updatedAt = new Date().toISOString();
-  writeJson(path.join(dir, 'session.json'), session);
-  writeJson(path.join(dir, 'status.json'), defaultStatus(session));
-  // Mirror into ~/.forgekit/fleet so `forge fleet` sees every project's
-  // sessions. Project root derived from dir (<root>/.forge/sessions/<id>),
-  // not REPO_ROOT, so callers with explicit dirs mirror correctly too.
-  registerSession(path.resolve(dir, '..', '..', '..'), session);
-}
-
-export function sessionAgeDays(session) {
-  const created = new Date(session.createdAt).getTime();
-  return (Date.now() - created) / (1000 * 60 * 60 * 24);
-}
+#!/usr/bin/env node
+/**
+ * Shared helpers for Forge session management.
+ */
+
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { registerSession } from './lib/fleet.mjs';
+
+export const REPO_ROOT = process.cwd();
+export const FORGE_DIR = path.join(REPO_ROOT, '.forge');
+export const SESSIONS_DIR = path.join(FORGE_DIR, 'sessions');
+export const ACTIVE_FILE = path.join(FORGE_DIR, 'active.json');
+export const RETENTION_DAYS = 14;
+
+export function ensureForgeLayout() {
+  fs.mkdirSync(SESSIONS_DIR, { recursive: true });
+}
+
+export function slugify(input) {
+  return String(input)
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .slice(0, 48) || 'session';
+}
+
+export function utcCompactNow() {
+  return new Date().toISOString().replace(/[-:]/g, '').replace(/\.\d{3}Z$/, 'Z');
+}
+
+export function randomSuffix(bytes = 3) {
+  return crypto.randomBytes(bytes).toString('hex');
+}
+
+export function makeSessionId(slug) {
+  return `${utcCompactNow()}-${slugify(slug)}-${randomSuffix()}`;
+}
+
+export function sessionPath(sessionId) {
+  return path.join(SESSIONS_DIR, sessionId);
+}
+
+export function readJson(filePath) {
+  return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+}
+
+export function writeJson(filePath, data) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
+}
+
+export function readActive() {
+  if (!fs.existsSync(ACTIVE_FILE)) return null;
+  try {
+    return readJson(ACTIVE_FILE);
+  } catch {
+    return null;
+  }
+}
+
+export function writeActive(sessionId) {
+  writeJson(ACTIVE_FILE, {
+    sessionId,
+    sessionPath: path.relative(REPO_ROOT, sessionPath(sessionId)).replace(/\\/g, '/'),
+    updatedAt: new Date().toISOString(),
+  });
+}
+
+export function clearActive() {
+  if (fs.existsSync(ACTIVE_FILE)) fs.unlinkSync(ACTIVE_FILE);
+}
+
+export function defaultSession(sessionId, slug) {
+  const now = new Date().toISOString();
+  return {
+    id: sessionId,
+    slug: slugify(slug),
+    createdAt: now,
+    updatedAt: now,
+    phase: 'triage',
+    planType: null,
+    openspecChange: null,
+    forgeSkipped: false,
+    cursorChatId: null,
+    tasksTotal: 0,
+    tasksComplete: 0,
+    /** Requested pace: auto | thorough | standard | brisk | lite */
+    pace: 'auto',
+    /** Concrete pace after auto resolve or explicit pin */
+    resolvedPace: null,
+    paceReason: null,
+    paceSignal: null,
+    pacePinned: false,
+    preferencesOverride: null,
+  };
+}
+
+export function defaultStatus(session) {
+  return {
+    sessionId: session.id,
+    phase: session.phase,
+    planType: session.planType,
+    openspecChange: session.openspecChange,
+    tasksTotal: session.tasksTotal,
+    tasksComplete: session.tasksComplete,
+    pace: session.pace ?? null,
+    resolvedPace: session.resolvedPace ?? null,
+    paceReason: session.paceReason ?? null,
+    updatedAt: session.updatedAt,
+  };
+}
+
+export function scaffoldSessionDirs(dir) {
+  for (const sub of ['brainstorm', 'tasks', 'reviews']) {
+    fs.mkdirSync(path.join(dir, sub), { recursive: true });
+  }
+}
+
+export function loadSession(sessionId) {
+  const dir = sessionPath(sessionId);
+  const file = path.join(dir, 'session.json');
+  if (!fs.existsSync(file)) {
+    throw new Error(`Session not found: ${sessionId}`);
+  }
+  return { dir, session: readJson(file) };
+}
+
+export function saveSession(dir, session) {
+  session.updatedAt = new Date().toISOString();
+  writeJson(path.join(dir, 'session.json'), session);
+  writeJson(path.join(dir, 'status.json'), defaultStatus(session));
+  // Mirror into ~/.forgekit/fleet so `forge fleet` sees every project's
+  // sessions. Project root derived from dir (<root>/.forge/sessions/<id>),
+  // not REPO_ROOT, so callers with explicit dirs mirror correctly too.
+  registerSession(path.resolve(dir, '..', '..', '..'), session);
+}
+
+export function sessionAgeDays(session) {
+  const created = new Date(session.createdAt).getTime();
+  return (Date.now() - created) / (1000 * 60 * 60 * 24);
+}

package/src/models.defaults.json

@@ -1,41 +1,41 @@
-{
-  "billing": "included",
-  "agents": {
-    "cursor": {
-      "included": {
-        "fast": "inherit",
-        "standard": "inherit",
-        "capable": "inherit"
-      },
-      "metered": {
-        "fast": "gpt-5.6-terra-medium",
-        "standard": "claude-sonnet-5-thinking-high",
-        "capable": "claude-opus-4-8-thinking-high"
-      }
-    },
-    "claude-code": {
-      "included": {
-        "fast": "haiku",
-        "standard": "sonnet",
-        "capable": "opus"
-      },
-      "metered": {
-        "fast": "haiku",
-        "standard": "sonnet",
-        "capable": "opus"
-      }
-    },
-    "codex": {
-      "included": {
-        "fast": "inherit",
-        "standard": "inherit",
-        "capable": "inherit"
-      },
-      "metered": {
-        "fast": "inherit",
-        "standard": "inherit",
-        "capable": "inherit"
-      }
-    }
-  }
-}
+{
+  "billing": "included",
+  "agents": {
+    "cursor": {
+      "included": {
+        "fast": "inherit",
+        "standard": "inherit",
+        "capable": "inherit"
+      },
+      "metered": {
+        "fast": "gpt-5.6-terra-medium",
+        "standard": "claude-sonnet-5-thinking-high",
+        "capable": "claude-opus-4-8-thinking-high"
+      }
+    },
+    "claude-code": {
+      "included": {
+        "fast": "haiku",
+        "standard": "sonnet",
+        "capable": "opus"
+      },
+      "metered": {
+        "fast": "haiku",
+        "standard": "sonnet",
+        "capable": "opus"
+      }
+    },
+    "codex": {
+      "included": {
+        "fast": "inherit",
+        "standard": "inherit",
+        "capable": "inherit"
+      },
+      "metered": {
+        "fast": "inherit",
+        "standard": "inherit",
+        "capable": "inherit"
+      }
+    }
+  }
+}

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