@izkac/forgekit 0.3.12 → 0.3.14

package/src/session-reminder.mjs

@@ -1,207 +1,207 @@
-#!/usr/bin/env node
-/**
- * Build Forge session reminders for agent hooks.
- *
- * Usage:
- *   forge reminder --format cursor
- *   forge reminder --format claude-session-start
- *   forge reminder --format plain
- */
-
-import { FORGE_DIR, loadSession, readActive, REPO_ROOT } from './lib.mjs';
-import {
-  drainInbox,
-  liveOverlaps,
-  queueMessage,
-  sessionDirFor,
-  touchSession,
-} from './lib/fleet.mjs';
-import { resolveEffectivePreferences } from './preferences.mjs';
-
-function getActiveSessionInfo() {
-  const active = readActive();
-  if (!active?.sessionId) return null;
-  try {
-    const { dir, session } = loadSession(active.sessionId);
-    return { active, dir, session };
-  } catch {
-    return null;
-  }
-}
-
-/**
- * @param {Record<string, unknown>} session
- */
-export function formatPaceLine(session) {
-  try {
-    const eff = resolveEffectivePreferences({
-      forgeDir: FORGE_DIR,
-      session,
-      signalText:
-        (typeof session.paceSignal === 'string' && session.paceSignal) ||
-        (typeof session.slug === 'string' && session.slug) ||
-        '',
-    });
-    const requested = eff.requestedPace;
-    const resolved = eff.resolvedPace;
-    if (requested === 'auto') {
-      return `Pace: auto → ${resolved} (${eff.paceReason})`;
-    }
-    return `Pace: ${resolved}`;
-  } catch {
-    const requested = session.pace ?? 'auto';
-    const resolved = session.resolvedPace;
-    if (resolved) return `Pace: ${requested} → ${resolved}`;
-    return `Pace: ${requested}`;
-  }
-}
-
-export const OPENSPEC_PLAN_REMINDER =
-  'Planning: Forge always uses OpenSpec. After brainstorm approval, run /opsx:propose (openspec-propose). Do not ask for a plan mode. See forge references/plan-routing.md.';
-
-/** @deprecated use OPENSPEC_PLAN_REMINDER */
-export const PLAN_MODE_PROMPT_REMINDER = OPENSPEC_PLAN_REMINDER;
-
-export function needsOpenSpecPlan(session) {
-  return (
-    !session.planType &&
-    (session.phase === 'brainstorm' || session.phase === 'plan')
-  );
-}
-
-/** @deprecated use needsOpenSpecPlan */
-export const needsPlanModePrompt = needsOpenSpecPlan;
-
-export const RUNTIME_INTEGRITY_REMINDER =
-  'Integrity: spine.json mandatory every change (rows or notApplicable); no stubs/false success; specs beat task wording; product-loop when spine has rows; defer wiring only via `forge defer` — `forge phase done` runs `forge integrity-check` (forge references/runtime-integrity.md).';
-
-export function buildForgeMessage(info) {
-  const { session } = info;
-  const lines = [];
-  lines.push(`[forge] Active Forge session: ${session.id}`);
-  lines.push(
-    `Phase: ${session.phase} | Plan: ${session.planType ?? 'pending'}${
-      session.openspecChange ? ` (${session.openspecChange})` : ''
-    }`,
-  );
-  lines.push(formatPaceLine(session));
-  if (session.tasksTotal > 0) {
-    lines.push(`Tasks: ${session.tasksComplete}/${session.tasksTotal}`);
-  }
-  if (needsOpenSpecPlan(session)) {
-    lines.push(OPENSPEC_PLAN_REMINDER);
-  }
-  lines.push(RUNTIME_INTEGRITY_REMINDER);
-  lines.push('Resume: invoke the forge skill for the current phase.');
-  lines.push('Honor pace: see forge references/pace.md (`forge prefs`).');
-  lines.push('Skip Forge for this task only: /forge:skip');
-  lines.push('Guide: Forge skill + docs/forge.md (under the installed forge skill)');
-  return lines.join('\n');
-}
-
-export function buildForgePromptMessage(info, prompt) {
-  const base = buildForgeMessage(info);
-  const trimmed = (prompt || '').trim();
-  if (/^\/forge:skip\b/i.test(trimmed)) {
-    return `${base}\n\nUser invoked /forge:skip — execute directly; do not start brainstorm/plan.`;
-  }
-  if (/^\/forge:status\b/i.test(trimmed)) {
-    return `${base}\n\nRun: forge status — then summarize for the user.`;
-  }
-  if (/^\/forge:plan\b/i.test(trimmed)) {
-    return `${base}\n\nPlan phase: ${OPENSPEC_PLAN_REMINDER}`;
-  }
-  if (/^\/forge:brainstorm\b/i.test(trimmed)) {
-    return `${base}\n\nBrainstorm terminal state: proceed to OpenSpec propose — do not implement until artefacts are approved.`;
-  }
-  return `${base}\n\nUser invoked Forge — follow forge skill from phase "${info.session.phase}".`;
-}
-
-function emitCursor(message) {
-  const payload = JSON.stringify({ agent_message: message });
-  process.stdout.write(`${payload}\n`);
-}
-
-function emitClaudeSessionStart(message) {
-  const payload = {
-    hookSpecificOutput: {
-      hookEventName: 'SessionStart',
-      additionalContext: `<system-reminder>\n${message}\n</system-reminder>`,
-    },
-  };
-  process.stdout.write(`${JSON.stringify(payload)}\n`);
-}
-
-function emitPlain(message) {
-  process.stdout.write(`${message}\n`);
-}
-
-const args = process.argv.slice(2);
-let format = 'plain';
-let prompt = '';
-
-for (let i = 0; i < args.length; i += 1) {
-  if (args[i] === '--format' && args[i + 1]) {
-    format = args[i + 1];
-    i += 1;
-  } else if (args[i] === '--prompt' && args[i + 1]) {
-    prompt = args[i + 1];
-    i += 1;
-  }
-}
-
-const info = getActiveSessionInfo();
-if (!info) {
-  process.exit(0);
-}
-
-// Fleet heartbeat: this hook fires on every agent turn, so lastSeen in the
-// registry tracks "agent actually running", not just the last saveSession.
-touchSession(REPO_ROOT, info.session.id);
-
-let message = prompt
-  ? buildForgePromptMessage(info, prompt)
-  : buildForgeMessage(info);
-
-// Overlap check on resume: another live session in this same working tree
-// means potentially conflicting edits. Warn this agent and drop a note in the
-// other sessions' inboxes. Session-start only — per-turn would spam.
-if (format === 'claude-session-start') {
-  const overlaps = liveOverlaps(REPO_ROOT, info.session.id);
-  if (overlaps.length > 0) {
-    message += `\n\nFleet overlap — other live session(s) in this project:\n${overlaps
-      .map((o) => `- ${o.slug} (${o.sessionId}) · ${o.engine ?? 'unknown'} · phase ${o.phase}`)
-      .join('\n')}\nTell the user and ask how to proceed: continue anyway, move this work to a git worktree, or pause one session.`;
-    for (const o of overlaps) {
-      queueMessage(
-        sessionDirFor(o),
-        `Fleet overlap: session "${info.session.slug}" (${info.session.id}) just resumed in this project. Coordinate with the user to avoid conflicting edits.`,
-      );
-    }
-  }
-}
-
-// Deliver queued `forge fleet send` messages exactly once (drain moves them
-// to inbox/delivered/). This is the fleet command bus: control terminal →
-// inbox file → injected into the agent's next turn via this hook.
-const fleetMessages = drainInbox(info.dir);
-if (fleetMessages.length > 0) {
-  message += `\n\nFleet messages from the control terminal — acknowledge and act on these first:\n${fleetMessages
-    .map((m) => `- ${m.text}`)
-    .join('\n')}`;
-}
-
-switch (format) {
-  case 'cursor':
-    emitCursor(message);
-    break;
-  case 'claude-session-start':
-    emitClaudeSessionStart(message);
-    break;
-  case 'plain':
-    emitPlain(message);
-    break;
-  default:
-    process.stderr.write(`Unknown format: ${format}\n`);
-    process.exit(1);
-}
+#!/usr/bin/env node
+/**
+ * Build Forge session reminders for agent hooks.
+ *
+ * Usage:
+ *   forge reminder --format cursor
+ *   forge reminder --format claude-session-start
+ *   forge reminder --format plain
+ */
+
+import { FORGE_DIR, loadSession, readActive, REPO_ROOT } from './lib.mjs';
+import {
+  drainInbox,
+  liveOverlaps,
+  queueMessage,
+  sessionDirFor,
+  touchSession,
+} from './lib/fleet.mjs';
+import { resolveEffectivePreferences } from './preferences.mjs';
+
+function getActiveSessionInfo() {
+  const active = readActive();
+  if (!active?.sessionId) return null;
+  try {
+    const { dir, session } = loadSession(active.sessionId);
+    return { active, dir, session };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * @param {Record<string, unknown>} session
+ */
+export function formatPaceLine(session) {
+  try {
+    const eff = resolveEffectivePreferences({
+      forgeDir: FORGE_DIR,
+      session,
+      signalText:
+        (typeof session.paceSignal === 'string' && session.paceSignal) ||
+        (typeof session.slug === 'string' && session.slug) ||
+        '',
+    });
+    const requested = eff.requestedPace;
+    const resolved = eff.resolvedPace;
+    if (requested === 'auto') {
+      return `Pace: auto → ${resolved} (${eff.paceReason})`;
+    }
+    return `Pace: ${resolved}`;
+  } catch {
+    const requested = session.pace ?? 'auto';
+    const resolved = session.resolvedPace;
+    if (resolved) return `Pace: ${requested} → ${resolved}`;
+    return `Pace: ${requested}`;
+  }
+}
+
+export const OPENSPEC_PLAN_REMINDER =
+  'Planning: Forge always uses OpenSpec. After brainstorm approval, run /opsx:propose (openspec-propose). Do not ask for a plan mode. See forge references/plan-routing.md.';
+
+/** @deprecated use OPENSPEC_PLAN_REMINDER */
+export const PLAN_MODE_PROMPT_REMINDER = OPENSPEC_PLAN_REMINDER;
+
+export function needsOpenSpecPlan(session) {
+  return (
+    !session.planType &&
+    (session.phase === 'brainstorm' || session.phase === 'plan')
+  );
+}
+
+/** @deprecated use needsOpenSpecPlan */
+export const needsPlanModePrompt = needsOpenSpecPlan;
+
+export const RUNTIME_INTEGRITY_REMINDER =
+  'Integrity: spine.json mandatory every change (rows or notApplicable); no stubs/false success; specs beat task wording; product-loop when spine has rows; defer wiring only via `forge defer` — `forge phase done` runs `forge integrity-check` (forge references/runtime-integrity.md).';
+
+export function buildForgeMessage(info) {
+  const { session } = info;
+  const lines = [];
+  lines.push(`[forge] Active Forge session: ${session.id}`);
+  lines.push(
+    `Phase: ${session.phase} | Plan: ${session.planType ?? 'pending'}${
+      session.openspecChange ? ` (${session.openspecChange})` : ''
+    }`,
+  );
+  lines.push(formatPaceLine(session));
+  if (session.tasksTotal > 0) {
+    lines.push(`Tasks: ${session.tasksComplete}/${session.tasksTotal}`);
+  }
+  if (needsOpenSpecPlan(session)) {
+    lines.push(OPENSPEC_PLAN_REMINDER);
+  }
+  lines.push(RUNTIME_INTEGRITY_REMINDER);
+  lines.push('Resume: invoke the forge skill for the current phase.');
+  lines.push('Honor pace: see forge references/pace.md (`forge prefs`).');
+  lines.push('Skip Forge for this task only: /forge:skip');
+  lines.push('Guide: Forge skill + docs/forge.md (under the installed forge skill)');
+  return lines.join('\n');
+}
+
+export function buildForgePromptMessage(info, prompt) {
+  const base = buildForgeMessage(info);
+  const trimmed = (prompt || '').trim();
+  if (/^\/forge:skip\b/i.test(trimmed)) {
+    return `${base}\n\nUser invoked /forge:skip — execute directly; do not start brainstorm/plan.`;
+  }
+  if (/^\/forge:status\b/i.test(trimmed)) {
+    return `${base}\n\nRun: forge status — then summarize for the user.`;
+  }
+  if (/^\/forge:plan\b/i.test(trimmed)) {
+    return `${base}\n\nPlan phase: ${OPENSPEC_PLAN_REMINDER}`;
+  }
+  if (/^\/forge:brainstorm\b/i.test(trimmed)) {
+    return `${base}\n\nBrainstorm terminal state: proceed to OpenSpec propose — do not implement until artefacts are approved.`;
+  }
+  return `${base}\n\nUser invoked Forge — follow forge skill from phase "${info.session.phase}".`;
+}
+
+function emitCursor(message) {
+  const payload = JSON.stringify({ agent_message: message });
+  process.stdout.write(`${payload}\n`);
+}
+
+function emitClaudeSessionStart(message) {
+  const payload = {
+    hookSpecificOutput: {
+      hookEventName: 'SessionStart',
+      additionalContext: `<system-reminder>\n${message}\n</system-reminder>`,
+    },
+  };
+  process.stdout.write(`${JSON.stringify(payload)}\n`);
+}
+
+function emitPlain(message) {
+  process.stdout.write(`${message}\n`);
+}
+
+const args = process.argv.slice(2);
+let format = 'plain';
+let prompt = '';
+
+for (let i = 0; i < args.length; i += 1) {
+  if (args[i] === '--format' && args[i + 1]) {
+    format = args[i + 1];
+    i += 1;
+  } else if (args[i] === '--prompt' && args[i + 1]) {
+    prompt = args[i + 1];
+    i += 1;
+  }
+}
+
+const info = getActiveSessionInfo();
+if (!info) {
+  process.exit(0);
+}
+
+// Fleet heartbeat: this hook fires on every agent turn, so lastSeen in the
+// registry tracks "agent actually running", not just the last saveSession.
+touchSession(REPO_ROOT, info.session.id);
+
+let message = prompt
+  ? buildForgePromptMessage(info, prompt)
+  : buildForgeMessage(info);
+
+// Overlap check on resume: another live session in this same working tree
+// means potentially conflicting edits. Warn this agent and drop a note in the
+// other sessions' inboxes. Session-start only — per-turn would spam.
+if (format === 'claude-session-start') {
+  const overlaps = liveOverlaps(REPO_ROOT, info.session.id);
+  if (overlaps.length > 0) {
+    message += `\n\nFleet overlap — other live session(s) in this project:\n${overlaps
+      .map((o) => `- ${o.slug} (${o.sessionId}) · ${o.engine ?? 'unknown'} · phase ${o.phase}`)
+      .join('\n')}\nTell the user and ask how to proceed: continue anyway, move this work to a git worktree, or pause one session.`;
+    for (const o of overlaps) {
+      queueMessage(
+        sessionDirFor(o),
+        `Fleet overlap: session "${info.session.slug}" (${info.session.id}) just resumed in this project. Coordinate with the user to avoid conflicting edits.`,
+      );
+    }
+  }
+}
+
+// Deliver queued `forge fleet send` messages exactly once (drain moves them
+// to inbox/delivered/). This is the fleet command bus: control terminal →
+// inbox file → injected into the agent's next turn via this hook.
+const fleetMessages = drainInbox(info.dir);
+if (fleetMessages.length > 0) {
+  message += `\n\nFleet messages from the control terminal — acknowledge and act on these first:\n${fleetMessages
+    .map((m) => `- ${m.text}`)
+    .join('\n')}`;
+}
+
+switch (format) {
+  case 'cursor':
+    emitCursor(message);
+    break;
+  case 'claude-session-start':
+    emitClaudeSessionStart(message);
+    break;
+  case 'plain':
+    emitPlain(message);
+    break;
+  default:
+    process.stderr.write(`Unknown format: ${format}\n`);
+    process.exit(1);
+}

package/src/session-status.mjs

@@ -1,70 +1,70 @@
-#!/usr/bin/env node
-/**
- * Print the active Forge session or a specific session by id.
- *
- * Usage:
- *   forge status
- *   forge status [--session <id>]
- */
-
-import fs from 'node:fs';
-import path from 'node:path';
-import {
-  FORGE_DIR,
-  loadSession,
-  readActive,
-  REPO_ROOT,
-} from './lib.mjs';
-import { resolveEffectivePreferences } from './preferences.mjs';
-
-const args = process.argv.slice(2);
-let sessionId = null;
-for (let i = 0; i < args.length; i += 1) {
-  if (args[i] === '--session' && args[i + 1]) {
-    sessionId = args[i + 1];
-    i += 1;
-  }
-}
-
-if (!sessionId) {
-  const active = readActive();
-  if (!active?.sessionId) {
-    process.stdout.write(JSON.stringify({ status: 'none', message: 'No active Forge session.' }, null, 2));
-    process.stdout.write('\n');
-    process.exit(0);
-  }
-  sessionId = active.sessionId;
-}
-
-const { dir, session } = loadSession(sessionId);
-const statusPath = path.join(dir, 'status.json');
-const status = fs.existsSync(statusPath) ? JSON.parse(fs.readFileSync(statusPath, 'utf8')) : null;
-
-const pace = resolveEffectivePreferences({
-  forgeDir: FORGE_DIR,
-  session,
-  signalText: session.paceSignal || session.slug || '',
-});
-
-process.stdout.write(
-  JSON.stringify(
-    {
-      status: 'ok',
-      sessionId,
-      sessionPath: path.relative(REPO_ROOT, dir).replace(/\\/g, '/'),
-      session,
-      progress: status,
-      pace: {
-        requested: pace.requestedPace,
-        resolved: pace.resolvedPace,
-        reason: pace.paceReason,
-        source: pace.source,
-        effective: pace.effective,
-      },
-      integrity: pace.integrity,
-    },
-    null,
-    2,
-  ),
-);
-process.stdout.write('\n');
+#!/usr/bin/env node
+/**
+ * Print the active Forge session or a specific session by id.
+ *
+ * Usage:
+ *   forge status
+ *   forge status [--session <id>]
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import {
+  FORGE_DIR,
+  loadSession,
+  readActive,
+  REPO_ROOT,
+} from './lib.mjs';
+import { resolveEffectivePreferences } from './preferences.mjs';
+
+const args = process.argv.slice(2);
+let sessionId = null;
+for (let i = 0; i < args.length; i += 1) {
+  if (args[i] === '--session' && args[i + 1]) {
+    sessionId = args[i + 1];
+    i += 1;
+  }
+}
+
+if (!sessionId) {
+  const active = readActive();
+  if (!active?.sessionId) {
+    process.stdout.write(JSON.stringify({ status: 'none', message: 'No active Forge session.' }, null, 2));
+    process.stdout.write('\n');
+    process.exit(0);
+  }
+  sessionId = active.sessionId;
+}
+
+const { dir, session } = loadSession(sessionId);
+const statusPath = path.join(dir, 'status.json');
+const status = fs.existsSync(statusPath) ? JSON.parse(fs.readFileSync(statusPath, 'utf8')) : null;
+
+const pace = resolveEffectivePreferences({
+  forgeDir: FORGE_DIR,
+  session,
+  signalText: session.paceSignal || session.slug || '',
+});
+
+process.stdout.write(
+  JSON.stringify(
+    {
+      status: 'ok',
+      sessionId,
+      sessionPath: path.relative(REPO_ROOT, dir).replace(/\\/g, '/'),
+      session,
+      progress: status,
+      pace: {
+        requested: pace.requestedPace,
+        resolved: pace.resolvedPace,
+        reason: pace.paceReason,
+        source: pace.source,
+        effective: pace.effective,
+      },
+      integrity: pace.integrity,
+    },
+    null,
+    2,
+  ),
+);
+process.stdout.write('\n');