@specforge/cli 0.1.0

package/dist/cli/commands/status.js

@@ -0,0 +1,124 @@
+import ora from "ora";
+import { resolveConfig } from "../config/index.js";
+import { withErrorHandler, CliError, NetworkError } from "../middleware/error-handler.js";
+import { printBlank } from "../ui/output.js";
+import { colors } from "../ui/colors.js";
+import { ApiClient } from "../../client/api-client.js";
+import {
+  formatTicketNumber
+} from "./status.types.js";
+function renderStatus(report, next, specificationId) {
+  printBlank();
+  console.log(colors.bold("Context"));
+  console.log(colors.muted("\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(`Project: ${report.project?.name ?? colors.muted("(unknown)")}`);
+  const specEntry = specificationId ? report.specifications.find((s) => s.specification.id === specificationId) : report.specifications[0];
+  if (specEntry) {
+    const spec = specEntry.specification;
+    const specStatus = spec.status;
+    console.log(`Spec:    ${spec.title}${specStatus ? colors.muted(` (${specStatus})`) : ""}`);
+    printBlank();
+    console.log(colors.bold("Progress"));
+    console.log(colors.muted("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    const pct = specEntry.totalTickets > 0 ? Math.round(specEntry.completedTickets / specEntry.totalTickets * 100) : 0;
+    console.log(`Tickets: ${specEntry.completedTickets}/${specEntry.totalTickets} (${pct}%)`);
+    console.log(`Epics:   ${specEntry.completedEpics}/${specEntry.totalEpics}`);
+  } else {
+    console.log(colors.muted("Spec:    (none active \u2014 run `specforge switch <id>`)"));
+  }
+  if (report.recentActivity && report.recentActivity.length > 0) {
+    printBlank();
+    console.log(colors.bold("Recent activity"));
+    console.log(colors.muted("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    for (const a of report.recentActivity.slice(0, 3)) {
+      console.log(`  ${a.action} \u2014 ${a.ticketTitle}`);
+    }
+  }
+  if (next && next.items.length > 0) {
+    printBlank();
+    console.log(colors.bold("Next actionable"));
+    console.log(colors.muted("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    for (const t of next.items.slice(0, 5)) {
+      const priority = t.priority ? colors.muted(` [${t.priority}]`) : "";
+      console.log(`  ${formatTicketNumber(t.ticketNumber)} ${t.title}${priority}`);
+    }
+  }
+  printBlank();
+}
+async function statusAction(options) {
+  const config = resolveConfig();
+  if (!config.apiKey) {
+    throw new CliError(
+      "Not authenticated",
+      1,
+      "Run `specforge login` to authenticate first"
+    );
+  }
+  const scope = config.specificationId ? "specification" : "project";
+  const scopeId = config.specificationId ?? config.projectId;
+  if (!scopeId) {
+    throw new CliError(
+      "No active project or specification",
+      1,
+      "Run `specforge init` or `specforge switch <id>` first"
+    );
+  }
+  const spinner = ora({ text: "Fetching status...", color: "cyan" }).start();
+  try {
+    const client = new ApiClient({
+      apiKey: config.apiKey,
+      apiUrl: config.apiUrl,
+      debug: config.debug
+    });
+    const report = await client.call("get_report", {
+      type: "implementation",
+      scope,
+      scopeId
+    });
+    let next;
+    if (config.specificationId) {
+      try {
+        next = await client.call("get_next_actionable_tickets", {
+          specificationId: config.specificationId
+        });
+      } catch {
+      }
+    }
+    spinner.stop();
+    if (options.json) {
+      console.log(JSON.stringify({ report, nextActionable: next ?? null }, null, 2));
+    } else {
+      renderStatus(report, next, config.specificationId);
+    }
+  } catch (error) {
+    spinner.fail("Failed to fetch status");
+    const message = error instanceof Error ? error.message : "Unknown error";
+    if (message.includes("401") || message.includes("Unauthorized")) {
+      throw new CliError(
+        "Authentication failed",
+        1,
+        "Your API key may be invalid. Run `specforge login` to re-authenticate"
+      );
+    }
+    throw new NetworkError(`Failed to fetch status: ${message}`);
+  }
+}
+function registerStatusCommand(program) {
+  program.command("status").description("Show active project/spec, implementation progress, and next actionable tickets").option("--json", "Output as JSON").addHelpText("after", `
+Examples:
+  $ specforge status         # Active project/spec + progress + next tickets
+  $ specforge status --json  # Machine-readable output
+
+Shows:
+  - Context: active project and specification (from .specforge/config.json)
+  - Progress: epic/ticket completion for the active spec
+  - Next actionable: ready-to-work tickets
+
+Use 'specforge switch <id>' to change the active project or specification.
+`).action(withErrorHandler(statusAction));
+}
+export {
+  registerStatusCommand,
+  statusAction
+};
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/status.ts"],"sourcesContent":["/**\n * Status Command\n *\n * Shows what this terminal is pointed at (project / spec from\n * `.specforge/config.json`) plus a live implementation report for the active\n * spec and the next actionable tickets. Uses only canonical tools —\n * `get_report` (type='implementation') + `get_next_actionable_tickets`.\n */\n\nimport { Command } from 'commander';\nimport ora from 'ora';\nimport { resolveConfig } from '../config/index.js';\nimport { withErrorHandler, CliError, NetworkError } from '../middleware/error-handler.js';\nimport { printBlank } from '../ui/output.js';\nimport { colors } from '../ui/colors.js';\nimport { ApiClient } from '../../client/api-client.js';\nimport type { ImplementationSummary } from '../../types/index.js';\nimport {\n  StatusOptions,\n  NextActionableResponse,\n  formatTicketNumber,\n} from './status.types.js';\n\n/**\n * Render the human-facing status view.\n */\nfunction renderStatus(\n  report: ImplementationSummary,\n  next: NextActionableResponse | undefined,\n  specificationId: string | null\n): void {\n  printBlank();\n  console.log(colors.bold('Context'));\n  console.log(colors.muted('───────'));\n  console.log(`Project: ${report.project?.name ?? colors.muted('(unknown)')}`);\n\n  const specEntry = specificationId\n    ? report.specifications.find((s) => s.specification.id === specificationId)\n    : report.specifications[0];\n\n  if (specEntry) {\n    const spec = specEntry.specification;\n    const specStatus = (spec as { status?: string }).status;\n    console.log(`Spec:    ${spec.title}${specStatus ? colors.muted(` (${specStatus})`) : ''}`);\n\n    printBlank();\n    console.log(colors.bold('Progress'));\n    console.log(colors.muted('────────'));\n    const pct = specEntry.totalTickets > 0\n      ? Math.round((specEntry.completedTickets / specEntry.totalTickets) * 100)\n      : 0;\n    console.log(`Tickets: ${specEntry.completedTickets}/${specEntry.totalTickets} (${pct}%)`);\n    console.log(`Epics:   ${specEntry.completedEpics}/${specEntry.totalEpics}`);\n  } else {\n    console.log(colors.muted('Spec:    (none active — run `specforge switch <id>`)'));\n  }\n\n  if (report.recentActivity && report.recentActivity.length > 0) {\n    printBlank();\n    console.log(colors.bold('Recent activity'));\n    console.log(colors.muted('───────────────'));\n    for (const a of report.recentActivity.slice(0, 3)) {\n      console.log(`  ${a.action} — ${a.ticketTitle}`);\n    }\n  }\n\n  if (next && next.items.length > 0) {\n    printBlank();\n    console.log(colors.bold('Next actionable'));\n    console.log(colors.muted('───────────────'));\n    for (const t of next.items.slice(0, 5)) {\n      const priority = t.priority ? colors.muted(` [${t.priority}]`) : '';\n      console.log(`  ${formatTicketNumber(t.ticketNumber)} ${t.title}${priority}`);\n    }\n  }\n\n  printBlank();\n}\n\n/**\n * Status command action handler\n */\nexport async function statusAction(options: StatusOptions): Promise<void> {\n  const config = resolveConfig();\n\n  if (!config.apiKey) {\n    throw new CliError(\n      'Not authenticated',\n      1,\n      'Run `specforge login` to authenticate first'\n    );\n  }\n\n  const scope = config.specificationId ? 'specification' : 'project';\n  const scopeId = config.specificationId ?? config.projectId;\n  if (!scopeId) {\n    throw new CliError(\n      'No active project or specification',\n      1,\n      'Run `specforge init` or `specforge switch <id>` first'\n    );\n  }\n\n  const spinner = ora({ text: 'Fetching status...', color: 'cyan' }).start();\n\n  try {\n    const client = new ApiClient({\n      apiKey: config.apiKey,\n      apiUrl: config.apiUrl,\n      debug: config.debug,\n    });\n\n    const report = await client.call<ImplementationSummary>('get_report', {\n      type: 'implementation',\n      scope,\n      scopeId,\n    });\n\n    let next: NextActionableResponse | undefined;\n    if (config.specificationId) {\n      try {\n        next = await client.call<NextActionableResponse>('get_next_actionable_tickets', {\n          specificationId: config.specificationId,\n        });\n      } catch {\n        // Next-actionable is a best-effort enrichment — ignore failures.\n      }\n    }\n\n    spinner.stop();\n\n    if (options.json) {\n      console.log(JSON.stringify({ report, nextActionable: next ?? null }, null, 2));\n    } else {\n      renderStatus(report, next, config.specificationId);\n    }\n  } catch (error) {\n    spinner.fail('Failed to fetch status');\n\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    if (message.includes('401') || message.includes('Unauthorized')) {\n      throw new CliError(\n        'Authentication failed',\n        1,\n        'Your API key may be invalid. Run `specforge login` to re-authenticate'\n      );\n    }\n\n    throw new NetworkError(`Failed to fetch status: ${message}`);\n  }\n}\n\n/**\n * Register status command with Commander\n */\nexport function registerStatusCommand(program: Command): void {\n  program\n    .command('status')\n    .description('Show active project/spec, implementation progress, and next actionable tickets')\n    .option('--json', 'Output as JSON')\n    .addHelpText('after', `\nExamples:\n  $ specforge status         # Active project/spec + progress + next tickets\n  $ specforge status --json  # Machine-readable output\n\nShows:\n  - Context: active project and specification (from .specforge/config.json)\n  - Progress: epic/ticket completion for the active spec\n  - Next actionable: ready-to-work tickets\n\nUse 'specforge switch <id>' to change the active project or specification.\n`)\n    .action(withErrorHandler(statusAction));\n}\n"],"mappings":"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","names":[]}

package/dist/cli/commands/status.types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Status Command Types
+ *
+ * Post-M9: status shows the active project/spec (from config) plus a live
+ * implementation report and the next actionable tickets. The pre-M9
+ * working-context / session / dashboard / teams model was removed with its
+ * backing ops (M9.4).
+ */
+/**
+ * Status command options from Commander
+ */
+export interface StatusOptions {
+    /** Output as JSON */
+    json?: boolean;
+}
+/**
+ * A single next-actionable ticket (subset of get_next_actionable_tickets items).
+ */
+export interface NextActionableItem {
+    id: string;
+    ticketNumber: number;
+    title: string;
+    priority?: string;
+    epicTitle?: string;
+}
+/**
+ * Response shape of get_next_actionable_tickets.
+ */
+export interface NextActionableResponse {
+    items: NextActionableItem[];
+    total: number;
+}
+/**
+ * Format a ticket number with padding (e.g. 7 → "TKT-007").
+ */
+export declare function formatTicketNumber(ticketNumber: number, prefix?: string, padding?: number): string;
+//# sourceMappingURL=status.types.d.ts.map

package/dist/cli/commands/status.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.types.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/status.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,MAAM,SAAQ,EACd,OAAO,SAAI,GACV,MAAM,CAER"}

package/dist/cli/commands/status.types.js

@@ -0,0 +1,7 @@
+function formatTicketNumber(ticketNumber, prefix = "TKT", padding = 3) {
+  return `${prefix}-${ticketNumber.toString().padStart(padding, "0")}`;
+}
+export {
+  formatTicketNumber
+};
+//# sourceMappingURL=status.types.js.map

package/dist/cli/commands/status.types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/status.types.ts"],"sourcesContent":["/**\n * Status Command Types\n *\n * Post-M9: status shows the active project/spec (from config) plus a live\n * implementation report and the next actionable tickets. The pre-M9\n * working-context / session / dashboard / teams model was removed with its\n * backing ops (M9.4).\n */\n\n/**\n * Status command options from Commander\n */\nexport interface StatusOptions {\n  /** Output as JSON */\n  json?: boolean;\n}\n\n/**\n * A single next-actionable ticket (subset of get_next_actionable_tickets items).\n */\nexport interface NextActionableItem {\n  id: string;\n  ticketNumber: number;\n  title: string;\n  priority?: string;\n  epicTitle?: string;\n}\n\n/**\n * Response shape of get_next_actionable_tickets.\n */\nexport interface NextActionableResponse {\n  items: NextActionableItem[];\n  total: number;\n}\n\n/**\n * Format a ticket number with padding (e.g. 7 → \"TKT-007\").\n */\nexport function formatTicketNumber(\n  ticketNumber: number,\n  prefix = 'TKT',\n  padding = 3\n): string {\n  return `${prefix}-${ticketNumber.toString().padStart(padding, '0')}`;\n}\n"],"mappings":"AAuCO,SAAS,mBACd,cACA,SAAS,OACT,UAAU,GACF;AACR,SAAO,GAAG,MAAM,IAAI,aAAa,SAAS,EAAE,SAAS,SAAS,GAAG,CAAC;AACpE;","names":[]}

package/dist/cli/commands/switch.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Switch Command
+ *
+ * Changes working context to a different project or specification.
+ * Auto-detects whether the ID is a project or specification.
+ */
+import { Command } from 'commander';
+/**
+ * Switch command action handler
+ *
+ * @param id Project or Specification ID to switch to
+ */
+export declare function switchAction(id: string): Promise<void>;
+/**
+ * Register switch command with Commander
+ */
+export declare function registerSwitchCommand(program: Command): void;
+//# sourceMappingURL=switch.d.ts.map

package/dist/cli/commands/switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/switch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyEpC;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiG5D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqB5D"}

package/dist/cli/commands/switch.js

@@ -0,0 +1,134 @@
+import ora from "ora";
+import { resolveConfig, tryLoadProjectConfig, saveProjectConfig } from "../config/index.js";
+import { withErrorHandler, CliError, NetworkError, ValidationError } from "../middleware/error-handler.js";
+import { printBlank } from "../ui/output.js";
+import { colors } from "../ui/colors.js";
+import { createCliClient } from "../../client/cli-client.js";
+import {
+  isProjectResult,
+  getDisplayName
+} from "./switch.types.js";
+async function detectIdType(client, id) {
+  try {
+    const project = await client.call("get_project", {
+      projectId: id
+    });
+    return { type: "project", data: project };
+  } catch {
+  }
+  try {
+    const specification = await client.call("get_specification", {
+      specificationId: id
+    });
+    return { type: "specification", data: specification };
+  } catch {
+  }
+  return null;
+}
+function updateLocalConfig(projectId, specificationId) {
+  const projectConfig = tryLoadProjectConfig() || {};
+  projectConfig.projectId = projectId;
+  if (specificationId) {
+    projectConfig.specificationId = specificationId;
+  } else {
+    delete projectConfig.specificationId;
+  }
+  saveProjectConfig(projectConfig);
+}
+async function switchAction(id) {
+  if (!id || id.trim() === "") {
+    throw new ValidationError(
+      "ID is required",
+      "Usage: specforge switch <project-or-spec-id>"
+    );
+  }
+  const config = resolveConfig();
+  if (!config.apiKey) {
+    throw new CliError(
+      "Not authenticated",
+      1,
+      "Run `specforge login` to authenticate first"
+    );
+  }
+  const spinner = ora({
+    text: "Detecting resource type...",
+    color: "cyan"
+  }).start();
+  try {
+    const client = createCliClient({
+      apiKey: config.apiKey,
+      apiUrl: config.apiUrl,
+      debug: config.debug
+    });
+    spinner.text = "Looking up ID...";
+    const detected = await detectIdType(client, id);
+    if (!detected) {
+      spinner.fail("Resource not found");
+      throw new CliError(
+        `"${id}" is not a valid project or specification ID`,
+        1,
+        "Make sure you have access to this resource. Use `specforge projects` or `specforge specs` to list available resources."
+      );
+    }
+    const { type, data } = detected;
+    const displayName = getDisplayName(detected);
+    spinner.text = `Switching to ${type}...`;
+    if (isProjectResult(detected)) {
+      const projectData = data;
+      updateLocalConfig(projectData.id);
+      spinner.succeed(`Switched to project: ${colors.primary(displayName)}`);
+    } else {
+      const specData = data;
+      updateLocalConfig(specData.projectId, specData.id);
+      spinner.succeed(`Switched to specification: ${colors.primary(displayName)}`);
+    }
+    printBlank();
+    console.log(colors.muted("Run `specforge status` to see the current context."));
+    printBlank();
+  } catch (error) {
+    if (error instanceof CliError || error instanceof ValidationError) {
+      spinner.stop();
+      throw error;
+    }
+    spinner.fail("Failed to switch context");
+    const message = error instanceof Error ? error.message : "Unknown error";
+    if (message.includes("401") || message.includes("Unauthorized")) {
+      throw new CliError(
+        "Authentication failed",
+        1,
+        "Your API key may be invalid. Run `specforge login` to re-authenticate"
+      );
+    }
+    if (message.includes("403") || message.includes("Forbidden")) {
+      throw new CliError(
+        `Access denied to "${id}"`,
+        1,
+        "You may not have permission to access this resource"
+      );
+    }
+    throw new NetworkError(`Failed to switch context: ${message}`);
+  }
+}
+function registerSwitchCommand(program) {
+  program.command("switch <id>").description("Switch working context to a project or specification").addHelpText("after", `
+Arguments:
+  id    Project ID (proj_xxx) or Specification ID (spec_xxx)
+
+Examples:
+  $ specforge switch proj_abc123     # Switch to a project
+  $ specforge switch spec_def456     # Switch to a specification
+
+The command auto-detects whether the ID is a project or specification.
+When switching to a project, the specification context is cleared.
+When switching to a specification, the project is set automatically.
+
+Use 'specforge status' to see the current context.
+Use 'specforge projects' to list available projects.
+Use 'specforge specs' to list specifications in a project.
+`).action(withErrorHandler(switchAction));
+}
+export {
+  registerSwitchCommand,
+  switchAction
+};
+//# sourceMappingURL=switch.js.map

package/dist/cli/commands/switch.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/switch.ts"],"sourcesContent":["/**\n * Switch Command\n *\n * Changes working context to a different project or specification.\n * Auto-detects whether the ID is a project or specification.\n */\n\nimport { Command } from 'commander';\nimport ora from 'ora';\nimport { resolveConfig, tryLoadProjectConfig, saveProjectConfig } from '../config/index.js';\nimport { withErrorHandler, CliError, NetworkError, ValidationError } from '../middleware/error-handler.js';\nimport { printBlank } from '../ui/output.js';\nimport { colors } from '../ui/colors.js';\nimport { ApiClient } from '../../client/api-client.js';\nimport { createCliClient } from '../../client/cli-client.js';\nimport {\n  DetectionResult,\n  ProjectData,\n  SpecificationData,\n  isProjectResult,\n  getDisplayName,\n} from './switch.types.js';\n\n/**\n * Detect if an ID refers to a project or specification\n *\n * Tries to fetch the ID as a project first, then as a specification.\n *\n * @param client API client instance\n * @param id ID to detect\n * @returns Detection result or null if not found\n */\nasync function detectIdType(\n  client: ApiClient,\n  id: string\n): Promise<DetectionResult | null> {\n  // Try as project first\n  try {\n    const project = await client.call<ProjectData>('get_project', {\n      projectId: id,\n    });\n    return { type: 'project', data: project };\n  } catch {\n    // Not a project, continue to try specification\n  }\n\n  // Try as specification\n  try {\n    const specification = await client.call<SpecificationData>('get_specification', {\n      specificationId: id,\n    });\n    return { type: 'specification', data: specification };\n  } catch {\n    // Not a specification either\n  }\n\n  return null;\n}\n\n/**\n * Update local project configuration\n *\n * @param projectId Project ID to set\n * @param specificationId Specification ID to set (undefined to clear)\n */\nfunction updateLocalConfig(projectId: string, specificationId?: string): void {\n  const projectConfig = tryLoadProjectConfig() || {};\n\n  projectConfig.projectId = projectId;\n\n  if (specificationId) {\n    projectConfig.specificationId = specificationId;\n  } else {\n    // Clear specification when switching to a project\n    delete projectConfig.specificationId;\n  }\n\n  saveProjectConfig(projectConfig);\n}\n\n/**\n * Switch command action handler\n *\n * @param id Project or Specification ID to switch to\n */\nexport async function switchAction(id: string): Promise<void> {\n  // Validate ID is provided\n  if (!id || id.trim() === '') {\n    throw new ValidationError(\n      'ID is required',\n      'Usage: specforge switch <project-or-spec-id>'\n    );\n  }\n\n  const config = resolveConfig();\n\n  if (!config.apiKey) {\n    throw new CliError(\n      'Not authenticated',\n      1,\n      'Run `specforge login` to authenticate first'\n    );\n  }\n\n  const spinner = ora({\n    text: 'Detecting resource type...',\n    color: 'cyan',\n  }).start();\n\n  try {\n    const client = createCliClient({\n      apiKey: config.apiKey,\n      apiUrl: config.apiUrl,\n      debug: config.debug,\n    });\n\n    // Detect what type of ID this is\n    spinner.text = 'Looking up ID...';\n    const detected = await detectIdType(client, id);\n\n    if (!detected) {\n      spinner.fail('Resource not found');\n      throw new CliError(\n        `\"${id}\" is not a valid project or specification ID`,\n        1,\n        'Make sure you have access to this resource. Use `specforge projects` or `specforge specs` to list available resources.'\n      );\n    }\n\n    const { type, data } = detected;\n    const displayName = getDisplayName(detected);\n\n    // Update working context based on type\n    spinner.text = `Switching to ${type}...`;\n\n    // The local `.specforge/config.json` IS the working context now (M9 — the\n    // backend `set_working_context` op was removed); persist the selection.\n    if (isProjectResult(detected)) {\n      const projectData = data as ProjectData;\n      updateLocalConfig(projectData.id);\n      spinner.succeed(`Switched to project: ${colors.primary(displayName)}`);\n    } else {\n      const specData = data as SpecificationData;\n      updateLocalConfig(specData.projectId, specData.id);\n      spinner.succeed(`Switched to specification: ${colors.primary(displayName)}`);\n    }\n\n    printBlank();\n\n    // Show helpful next steps\n    console.log(colors.muted('Run `specforge status` to see the current context.'));\n    printBlank();\n\n  } catch (error) {\n    // Re-throw CLI errors as-is\n    if (error instanceof CliError || error instanceof ValidationError) {\n      spinner.stop();\n      throw error;\n    }\n\n    spinner.fail('Failed to switch context');\n\n    const message = error instanceof Error ? error.message : 'Unknown error';\n\n    if (message.includes('401') || message.includes('Unauthorized')) {\n      throw new CliError(\n        'Authentication failed',\n        1,\n        'Your API key may be invalid. Run `specforge login` to re-authenticate'\n      );\n    }\n\n    if (message.includes('403') || message.includes('Forbidden')) {\n      throw new CliError(\n        `Access denied to \"${id}\"`,\n        1,\n        'You may not have permission to access this resource'\n      );\n    }\n\n    throw new NetworkError(`Failed to switch context: ${message}`);\n  }\n}\n\n/**\n * Register switch command with Commander\n */\nexport function registerSwitchCommand(program: Command): void {\n  program\n    .command('switch <id>')\n    .description('Switch working context to a project or specification')\n    .addHelpText('after', `\nArguments:\n  id    Project ID (proj_xxx) or Specification ID (spec_xxx)\n\nExamples:\n  $ specforge switch proj_abc123     # Switch to a project\n  $ specforge switch spec_def456     # Switch to a specification\n\nThe command auto-detects whether the ID is a project or specification.\nWhen switching to a project, the specification context is cleared.\nWhen switching to a specification, the project is set automatically.\n\nUse 'specforge status' to see the current context.\nUse 'specforge projects' to list available projects.\nUse 'specforge specs' to list specifications in a project.\n`)\n    .action(withErrorHandler(switchAction));\n}\n"],"mappings":"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","names":[]}

package/dist/cli/commands/switch.types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Switch Command Types
+ *
+ * Type definitions for the switch command that changes
+ * working context between projects and specifications.
+ */
+/**
+ * Types of resources that can be switched to
+ */
+export type SwitchTargetType = 'project' | 'specification';
+/**
+ * Result of detecting what type an ID refers to
+ */
+export interface DetectionResult {
+    /** The type of resource detected */
+    type: SwitchTargetType;
+    /** The resource data from the API */
+    data: ProjectData | SpecificationData;
+}
+/**
+ * Project data from get_project API
+ */
+export interface ProjectData {
+    /** Project ID */
+    id: string;
+    /** Project name */
+    name: string;
+    /** Project description (optional) */
+    description?: string;
+}
+/**
+ * Specification data from get_specification API
+ */
+export interface SpecificationData {
+    /** Specification ID */
+    id: string;
+    /** Specification title */
+    title: string;
+    /** Parent project ID */
+    projectId: string;
+    /** Specification description (optional) */
+    description?: string;
+    /** Specification status (optional) */
+    status?: string;
+}
+/**
+ * API request for set_working_context
+ */
+export interface SetWorkingContextRequest extends Record<string, unknown> {
+    /** Project ID to set */
+    projectId: string;
+    /** Specification ID to set (null to clear) */
+    specificationId: string | null;
+    /** Epic ID to set (null to clear) */
+    epicId: string | null;
+    /** Ticket ID to set (null to clear) */
+    ticketId: string | null;
+}
+/**
+ * API response for set_working_context
+ */
+export interface SetWorkingContextResponse {
+    /** Success indicator */
+    success?: boolean;
+    /** Updated context */
+    context?: {
+        projectId: string;
+        specificationId: string | null;
+        epicId: string | null;
+        ticketId: string | null;
+    };
+}
+/**
+ * Switch command result for display
+ */
+export interface SwitchResult {
+    /** Whether switch was successful */
+    success: boolean;
+    /** Type of resource switched to */
+    type: SwitchTargetType;
+    /** Display name of the resource */
+    displayName: string;
+    /** Project ID (always set) */
+    projectId: string;
+    /** Specification ID (if switching to spec) */
+    specificationId?: string;
+}
+/**
+ * Error codes for switch command
+ */
+export declare enum SwitchErrorCode {
+    /** ID not provided */
+    MISSING_ID = "MISSING_ID",
+    /** ID not found as project or specification */
+    NOT_FOUND = "NOT_FOUND",
+    /** User does not have access to resource */
+    ACCESS_DENIED = "ACCESS_DENIED",
+    /** Failed to update working context */
+    UPDATE_FAILED = "UPDATE_FAILED",
+    /** Failed to save local config */
+    CONFIG_SAVE_FAILED = "CONFIG_SAVE_FAILED"
+}
+/**
+ * Check if detection result is a project
+ */
+export declare function isProjectResult(result: DetectionResult): result is DetectionResult & {
+    data: ProjectData;
+};
+/**
+ * Check if detection result is a specification
+ */
+export declare function isSpecificationResult(result: DetectionResult): result is DetectionResult & {
+    data: SpecificationData;
+};
+/**
+ * Get display name from detection result
+ */
+export declare function getDisplayName(result: DetectionResult): string;
+/**
+ * Create switch result from detection result
+ */
+export declare function createSwitchResult(result: DetectionResult): SwitchResult;
+//# sourceMappingURL=switch.types.d.ts.map

package/dist/cli/commands/switch.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.types.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/switch.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,eAAe,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACvB,qCAAqC;IACrC,IAAI,EAAE,WAAW,GAAG,iBAAiB,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvE,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,qCAAqC;IACrC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,wBAAwB;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sBAAsB;IACtB,OAAO,CAAC,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,sBAAsB;IACtB,UAAU,eAAe;IACzB,+CAA+C;IAC/C,SAAS,cAAc;IACvB,4CAA4C;IAC5C,aAAa,kBAAkB;IAC/B,uCAAuC;IACvC,aAAa,kBAAkB;IAC/B,kCAAkC;IAClC,kBAAkB,uBAAuB;CAC1C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,IAAI,eAAe,GAAG;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAE1G;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,IAAI,eAAe,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAEtH;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAK9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CAkBxE"}

package/dist/cli/commands/switch.types.js

@@ -0,0 +1,46 @@
+var SwitchErrorCode = /* @__PURE__ */ ((SwitchErrorCode2) => {
+  SwitchErrorCode2["MISSING_ID"] = "MISSING_ID";
+  SwitchErrorCode2["NOT_FOUND"] = "NOT_FOUND";
+  SwitchErrorCode2["ACCESS_DENIED"] = "ACCESS_DENIED";
+  SwitchErrorCode2["UPDATE_FAILED"] = "UPDATE_FAILED";
+  SwitchErrorCode2["CONFIG_SAVE_FAILED"] = "CONFIG_SAVE_FAILED";
+  return SwitchErrorCode2;
+})(SwitchErrorCode || {});
+function isProjectResult(result) {
+  return result.type === "project";
+}
+function isSpecificationResult(result) {
+  return result.type === "specification";
+}
+function getDisplayName(result) {
+  if (isProjectResult(result)) {
+    return result.data.name;
+  }
+  return result.data.title;
+}
+function createSwitchResult(result) {
+  if (isProjectResult(result)) {
+    return {
+      success: true,
+      type: "project",
+      displayName: result.data.name,
+      projectId: result.data.id
+    };
+  }
+  const specData = result.data;
+  return {
+    success: true,
+    type: "specification",
+    displayName: specData.title,
+    projectId: specData.projectId,
+    specificationId: specData.id
+  };
+}
+export {
+  SwitchErrorCode,
+  createSwitchResult,
+  getDisplayName,
+  isProjectResult,
+  isSpecificationResult
+};
+//# sourceMappingURL=switch.types.js.map

package/dist/cli/commands/switch.types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/switch.types.ts"],"sourcesContent":["/**\n * Switch Command Types\n *\n * Type definitions for the switch command that changes\n * working context between projects and specifications.\n */\n\n/**\n * Types of resources that can be switched to\n */\nexport type SwitchTargetType = 'project' | 'specification';\n\n/**\n * Result of detecting what type an ID refers to\n */\nexport interface DetectionResult {\n  /** The type of resource detected */\n  type: SwitchTargetType;\n  /** The resource data from the API */\n  data: ProjectData | SpecificationData;\n}\n\n/**\n * Project data from get_project API\n */\nexport interface ProjectData {\n  /** Project ID */\n  id: string;\n  /** Project name */\n  name: string;\n  /** Project description (optional) */\n  description?: string;\n}\n\n/**\n * Specification data from get_specification API\n */\nexport interface SpecificationData {\n  /** Specification ID */\n  id: string;\n  /** Specification title */\n  title: string;\n  /** Parent project ID */\n  projectId: string;\n  /** Specification description (optional) */\n  description?: string;\n  /** Specification status (optional) */\n  status?: string;\n}\n\n/**\n * API request for set_working_context\n */\nexport interface SetWorkingContextRequest extends Record<string, unknown> {\n  /** Project ID to set */\n  projectId: string;\n  /** Specification ID to set (null to clear) */\n  specificationId: string | null;\n  /** Epic ID to set (null to clear) */\n  epicId: string | null;\n  /** Ticket ID to set (null to clear) */\n  ticketId: string | null;\n}\n\n/**\n * API response for set_working_context\n */\nexport interface SetWorkingContextResponse {\n  /** Success indicator */\n  success?: boolean;\n  /** Updated context */\n  context?: {\n    projectId: string;\n    specificationId: string | null;\n    epicId: string | null;\n    ticketId: string | null;\n  };\n}\n\n/**\n * Switch command result for display\n */\nexport interface SwitchResult {\n  /** Whether switch was successful */\n  success: boolean;\n  /** Type of resource switched to */\n  type: SwitchTargetType;\n  /** Display name of the resource */\n  displayName: string;\n  /** Project ID (always set) */\n  projectId: string;\n  /** Specification ID (if switching to spec) */\n  specificationId?: string;\n}\n\n/**\n * Error codes for switch command\n */\nexport enum SwitchErrorCode {\n  /** ID not provided */\n  MISSING_ID = 'MISSING_ID',\n  /** ID not found as project or specification */\n  NOT_FOUND = 'NOT_FOUND',\n  /** User does not have access to resource */\n  ACCESS_DENIED = 'ACCESS_DENIED',\n  /** Failed to update working context */\n  UPDATE_FAILED = 'UPDATE_FAILED',\n  /** Failed to save local config */\n  CONFIG_SAVE_FAILED = 'CONFIG_SAVE_FAILED',\n}\n\n/**\n * Check if detection result is a project\n */\nexport function isProjectResult(result: DetectionResult): result is DetectionResult & { data: ProjectData } {\n  return result.type === 'project';\n}\n\n/**\n * Check if detection result is a specification\n */\nexport function isSpecificationResult(result: DetectionResult): result is DetectionResult & { data: SpecificationData } {\n  return result.type === 'specification';\n}\n\n/**\n * Get display name from detection result\n */\nexport function getDisplayName(result: DetectionResult): string {\n  if (isProjectResult(result)) {\n    return result.data.name;\n  }\n  return (result.data as SpecificationData).title;\n}\n\n/**\n * Create switch result from detection result\n */\nexport function createSwitchResult(result: DetectionResult): SwitchResult {\n  if (isProjectResult(result)) {\n    return {\n      success: true,\n      type: 'project',\n      displayName: result.data.name,\n      projectId: result.data.id,\n    };\n  }\n\n  const specData = result.data as SpecificationData;\n  return {\n    success: true,\n    type: 'specification',\n    displayName: specData.title,\n    projectId: specData.projectId,\n    specificationId: specData.id,\n  };\n}\n"],"mappings":"AAkGO,IAAK,kBAAL,kBAAKA,qBAAL;AAEL,EAAAA,iBAAA,gBAAa;AAEb,EAAAA,iBAAA,eAAY;AAEZ,EAAAA,iBAAA,mBAAgB;AAEhB,EAAAA,iBAAA,mBAAgB;AAEhB,EAAAA,iBAAA,wBAAqB;AAVX,SAAAA;AAAA,GAAA;AAgBL,SAAS,gBAAgB,QAA4E;AAC1G,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,sBAAsB,QAAkF;AACtH,SAAO,OAAO,SAAS;AACzB;AAKO,SAAS,eAAe,QAAiC;AAC9D,MAAI,gBAAgB,MAAM,GAAG;AAC3B,WAAO,OAAO,KAAK;AAAA,EACrB;AACA,SAAQ,OAAO,KAA2B;AAC5C;AAKO,SAAS,mBAAmB,QAAuC;AACxE,MAAI,gBAAgB,MAAM,GAAG;AAC3B,WAAO;AAAA,MACL,SAAS;AAAA,MACT,MAAM;AAAA,MACN,aAAa,OAAO,KAAK;AAAA,MACzB,WAAW,OAAO,KAAK;AAAA,IACzB;AAAA,EACF;AAEA,QAAM,WAAW,OAAO;AACxB,SAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM;AAAA,IACN,aAAa,SAAS;AAAA,IACtB,WAAW,SAAS;AAAA,IACpB,iBAAiB,SAAS;AAAA,EAC5B;AACF;","names":["SwitchErrorCode"]}