@specforge/cli 0.1.0

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

@@ -0,0 +1,180 @@
+/**
+ * Doctor Command Types
+ *
+ * Type definitions for the doctor command health checks.
+ */
+/**
+ * Doctor command options from Commander
+ */
+export interface DoctorOptions {
+    /** Output as JSON instead of formatted text */
+    json?: boolean;
+    /** Attempt to fix issues automatically */
+    fix?: boolean;
+}
+/**
+ * Check status result
+ */
+export type CheckStatus = 'pass' | 'fail' | 'warn';
+/**
+ * Individual check result
+ */
+export interface CheckResult {
+    /** Name/title of the check */
+    name: string;
+    /** Status of the check */
+    status: CheckStatus;
+    /** Detailed message about the result */
+    message: string;
+    /** Fix suggestion if check failed/warned */
+    fix?: string;
+    /** Additional metadata for JSON output */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Check category names
+ */
+export type CheckCategory = 'configuration' | 'authentication' | 'connection' | 'projectAccess';
+/**
+ * Doctor report structure
+ */
+export interface DoctorReport {
+    /** Check results grouped by category */
+    checks: Record<CheckCategory, CheckResult[]>;
+    /** Summary counts */
+    summary: DoctorSummary;
+    /** Timestamp of the check */
+    timestamp: string;
+    /** Version of the CLI */
+    version?: string;
+}
+/**
+ * Doctor report summary
+ */
+export interface DoctorSummary {
+    /** Number of passed checks */
+    passed: number;
+    /** Number of failed checks */
+    failed: number;
+    /** Number of warnings */
+    warnings: number;
+    /** Total number of checks */
+    total: number;
+}
+/**
+ * Check category display info
+ */
+export interface CheckCategoryInfo {
+    /** Category identifier */
+    id: CheckCategory;
+    /** Display name */
+    name: string;
+    /** Description */
+    description: string;
+}
+/**
+ * Check category definitions with display info
+ */
+export declare const CHECK_CATEGORIES: CheckCategoryInfo[];
+/**
+ * Check name constants for configuration checks
+ */
+export declare const CONFIG_CHECK_NAMES: {
+    readonly CHANNEL: "Channel";
+    readonly MCP_CONFIG_FOUND: ".mcp.json found";
+    readonly PROJECT_CONFIG_FOUND: "project config found";
+    readonly GLOBAL_CONFIG_DIR: "Global config";
+    readonly API_KEY_CONFIGURED: "API key configured";
+    readonly PLANNING_SESSION: "Active planning session";
+};
+/**
+ * Check name constants for authentication checks
+ */
+export declare const AUTH_CHECK_NAMES: {
+    readonly API_KEY_FORMAT: "API key format valid";
+    readonly API_KEY_AUTHENTICATED: "API key authenticated";
+    readonly USER_INFO: "User info";
+};
+/**
+ * Check name constants for connection checks
+ */
+export declare const CONNECTION_CHECK_NAMES: {
+    readonly API_ENDPOINT_REACHABLE: "API endpoint reachable";
+    readonly RESPONSE_TIME: "Response time";
+};
+/**
+ * Check name constants for project access checks
+ */
+export declare const PROJECT_CHECK_NAMES: {
+    readonly PROJECT_ACCESSIBLE: "Default project accessible";
+    readonly SPECIFICATION_ACCESSIBLE: "Default specification accessible";
+    readonly IMPLEMENTATION_SESSION: "Implementation session";
+};
+/**
+ * Thresholds for performance checks
+ */
+export declare const PERFORMANCE_THRESHOLDS: {
+    /** Response time warning threshold in ms */
+    readonly RESPONSE_TIME_WARNING: 500;
+    /** Response time error threshold in ms */
+    readonly RESPONSE_TIME_ERROR: 5000;
+    /** Connection timeout in ms */
+    readonly CONNECTION_TIMEOUT: 10000;
+};
+/**
+ * API key validation constants
+ */
+export declare const API_KEY_VALIDATION: {
+    /** Required prefix for live API keys */
+    readonly PREFIX: "sf_live_";
+    /** Minimum length for valid API key */
+    readonly MIN_LENGTH: 28;
+};
+/**
+ * Fix suggestion templates
+ */
+export declare const FIX_SUGGESTIONS: {
+    readonly MISSING_MCP_CONFIG: "Run 'specforge init' to create configuration";
+    readonly MISSING_PROJECT_CONFIG: "Run 'specforge init' to create configuration";
+    readonly MISSING_API_KEY: "Run 'specforge login' to authenticate";
+    readonly INVALID_API_KEY_FORMAT: "Get a valid API key from https://specforge.com.br/settings/api-keys";
+    readonly EXPIRED_API_KEY: "Run 'specforge login --force' to re-authenticate";
+    readonly CONNECTION_FAILED: "Check your internet connection";
+    readonly CONNECTION_TIMEOUT: "Check your internet connection or try again later";
+    readonly PROJECT_NOT_ACCESSIBLE: "Run 'specforge init' to reconfigure project";
+    readonly SPEC_NOT_ACCESSIBLE: "Run 'specforge init' to reconfigure specification";
+    readonly NO_PROJECT_CONFIGURED: "Run 'specforge init' to configure a project";
+};
+/**
+ * Create a passing check result
+ */
+export declare function createPassResult(name: string, message: string, metadata?: Record<string, unknown>): CheckResult;
+/**
+ * Create a failing check result
+ */
+export declare function createFailResult(name: string, message: string, fix?: string, metadata?: Record<string, unknown>): CheckResult;
+/**
+ * Create a warning check result
+ */
+export declare function createWarnResult(name: string, message: string, fix?: string, metadata?: Record<string, unknown>): CheckResult;
+/**
+ * Calculate summary from check results
+ */
+export declare function calculateSummary(checks: Record<CheckCategory, CheckResult[]>): DoctorSummary;
+/**
+ * Create an empty report structure
+ */
+export declare function createEmptyReport(): DoctorReport;
+/**
+ * Check if the report has any failures
+ */
+export declare function hasFailures(report: DoctorReport): boolean;
+/**
+ * Check if the report has any warnings
+ */
+export declare function hasWarnings(report: DoctorReport): boolean;
+/**
+ * Get status icon for display
+ */
+export declare function getStatusIcon(status: CheckStatus): string;
+//# sourceMappingURL=doctor.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.types.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,140 @@
+const CHECK_CATEGORIES = [
+  {
+    id: "configuration",
+    name: "Configuration",
+    description: "Config file presence and validity"
+  },
+  {
+    id: "authentication",
+    name: "Authentication",
+    description: "API key format and authentication"
+  },
+  {
+    id: "connection",
+    name: "Connection",
+    description: "API connectivity and response time"
+  },
+  {
+    id: "projectAccess",
+    name: "Project Access",
+    description: "Access to configured project and specification"
+  }
+];
+const CONFIG_CHECK_NAMES = {
+  CHANNEL: "Channel",
+  MCP_CONFIG_FOUND: ".mcp.json found",
+  PROJECT_CONFIG_FOUND: "project config found",
+  GLOBAL_CONFIG_DIR: "Global config",
+  API_KEY_CONFIGURED: "API key configured",
+  PLANNING_SESSION: "Active planning session"
+};
+const AUTH_CHECK_NAMES = {
+  API_KEY_FORMAT: "API key format valid",
+  API_KEY_AUTHENTICATED: "API key authenticated",
+  USER_INFO: "User info"
+};
+const CONNECTION_CHECK_NAMES = {
+  API_ENDPOINT_REACHABLE: "API endpoint reachable",
+  RESPONSE_TIME: "Response time"
+};
+const PROJECT_CHECK_NAMES = {
+  PROJECT_ACCESSIBLE: "Default project accessible",
+  SPECIFICATION_ACCESSIBLE: "Default specification accessible",
+  IMPLEMENTATION_SESSION: "Implementation session"
+};
+const PERFORMANCE_THRESHOLDS = {
+  /** Response time warning threshold in ms */
+  RESPONSE_TIME_WARNING: 500,
+  /** Response time error threshold in ms */
+  RESPONSE_TIME_ERROR: 5e3,
+  /** Connection timeout in ms */
+  CONNECTION_TIMEOUT: 1e4
+};
+const API_KEY_VALIDATION = {
+  /** Required prefix for live API keys */
+  PREFIX: "sf_live_",
+  /** Minimum length for valid API key */
+  MIN_LENGTH: 28
+};
+const FIX_SUGGESTIONS = {
+  MISSING_MCP_CONFIG: "Run 'specforge init' to create configuration",
+  MISSING_PROJECT_CONFIG: "Run 'specforge init' to create configuration",
+  MISSING_API_KEY: "Run 'specforge login' to authenticate",
+  INVALID_API_KEY_FORMAT: "Get a valid API key from https://specforge.com.br/settings/api-keys",
+  EXPIRED_API_KEY: "Run 'specforge login --force' to re-authenticate",
+  CONNECTION_FAILED: "Check your internet connection",
+  CONNECTION_TIMEOUT: "Check your internet connection or try again later",
+  PROJECT_NOT_ACCESSIBLE: "Run 'specforge init' to reconfigure project",
+  SPEC_NOT_ACCESSIBLE: "Run 'specforge init' to reconfigure specification",
+  NO_PROJECT_CONFIGURED: "Run 'specforge init' to configure a project"
+};
+function createPassResult(name, message, metadata) {
+  return { name, status: "pass", message, metadata };
+}
+function createFailResult(name, message, fix, metadata) {
+  return { name, status: "fail", message, fix, metadata };
+}
+function createWarnResult(name, message, fix, metadata) {
+  return { name, status: "warn", message, fix, metadata };
+}
+function calculateSummary(checks) {
+  const allChecks = Object.values(checks).flat();
+  return {
+    passed: allChecks.filter((c) => c.status === "pass").length,
+    failed: allChecks.filter((c) => c.status === "fail").length,
+    warnings: allChecks.filter((c) => c.status === "warn").length,
+    total: allChecks.length
+  };
+}
+function createEmptyReport() {
+  return {
+    checks: {
+      configuration: [],
+      authentication: [],
+      connection: [],
+      projectAccess: []
+    },
+    summary: {
+      passed: 0,
+      failed: 0,
+      warnings: 0,
+      total: 0
+    },
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function hasFailures(report) {
+  return report.summary.failed > 0;
+}
+function hasWarnings(report) {
+  return report.summary.warnings > 0;
+}
+function getStatusIcon(status) {
+  switch (status) {
+    case "pass":
+      return "\u2713";
+    case "fail":
+      return "\u2717";
+    case "warn":
+      return "\u26A0";
+  }
+}
+export {
+  API_KEY_VALIDATION,
+  AUTH_CHECK_NAMES,
+  CHECK_CATEGORIES,
+  CONFIG_CHECK_NAMES,
+  CONNECTION_CHECK_NAMES,
+  FIX_SUGGESTIONS,
+  PERFORMANCE_THRESHOLDS,
+  PROJECT_CHECK_NAMES,
+  calculateSummary,
+  createEmptyReport,
+  createFailResult,
+  createPassResult,
+  createWarnResult,
+  getStatusIcon,
+  hasFailures,
+  hasWarnings
+};
+//# sourceMappingURL=doctor.types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/doctor.types.ts"],"sourcesContent":["/**\n * Doctor Command Types\n *\n * Type definitions for the doctor command health checks.\n */\n\n/**\n * Doctor command options from Commander\n */\nexport interface DoctorOptions {\n  /** Output as JSON instead of formatted text */\n  json?: boolean;\n  /** Attempt to fix issues automatically */\n  fix?: boolean;\n}\n\n/**\n * Check status result\n */\nexport type CheckStatus = 'pass' | 'fail' | 'warn';\n\n/**\n * Individual check result\n */\nexport interface CheckResult {\n  /** Name/title of the check */\n  name: string;\n  /** Status of the check */\n  status: CheckStatus;\n  /** Detailed message about the result */\n  message: string;\n  /** Fix suggestion if check failed/warned */\n  fix?: string;\n  /** Additional metadata for JSON output */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Check category names\n */\nexport type CheckCategory = 'configuration' | 'authentication' | 'connection' | 'projectAccess';\n\n/**\n * Doctor report structure\n */\nexport interface DoctorReport {\n  /** Check results grouped by category */\n  checks: Record<CheckCategory, CheckResult[]>;\n  /** Summary counts */\n  summary: DoctorSummary;\n  /** Timestamp of the check */\n  timestamp: string;\n  /** Version of the CLI */\n  version?: string;\n}\n\n/**\n * Doctor report summary\n */\nexport interface DoctorSummary {\n  /** Number of passed checks */\n  passed: number;\n  /** Number of failed checks */\n  failed: number;\n  /** Number of warnings */\n  warnings: number;\n  /** Total number of checks */\n  total: number;\n}\n\n/**\n * Check category display info\n */\nexport interface CheckCategoryInfo {\n  /** Category identifier */\n  id: CheckCategory;\n  /** Display name */\n  name: string;\n  /** Description */\n  description: string;\n}\n\n/**\n * Check category definitions with display info\n */\nexport const CHECK_CATEGORIES: CheckCategoryInfo[] = [\n  {\n    id: 'configuration',\n    name: 'Configuration',\n    description: 'Config file presence and validity',\n  },\n  {\n    id: 'authentication',\n    name: 'Authentication',\n    description: 'API key format and authentication',\n  },\n  {\n    id: 'connection',\n    name: 'Connection',\n    description: 'API connectivity and response time',\n  },\n  {\n    id: 'projectAccess',\n    name: 'Project Access',\n    description: 'Access to configured project and specification',\n  },\n];\n\n/**\n * Check name constants for configuration checks\n */\nexport const CONFIG_CHECK_NAMES = {\n  CHANNEL: 'Channel',\n  MCP_CONFIG_FOUND: '.mcp.json found',\n  PROJECT_CONFIG_FOUND: 'project config found',\n  GLOBAL_CONFIG_DIR: 'Global config',\n  API_KEY_CONFIGURED: 'API key configured',\n  PLANNING_SESSION: 'Active planning session',\n} as const;\n\n/**\n * Check name constants for authentication checks\n */\nexport const AUTH_CHECK_NAMES = {\n  API_KEY_FORMAT: 'API key format valid',\n  API_KEY_AUTHENTICATED: 'API key authenticated',\n  USER_INFO: 'User info',\n} as const;\n\n/**\n * Check name constants for connection checks\n */\nexport const CONNECTION_CHECK_NAMES = {\n  API_ENDPOINT_REACHABLE: 'API endpoint reachable',\n  RESPONSE_TIME: 'Response time',\n} as const;\n\n/**\n * Check name constants for project access checks\n */\nexport const PROJECT_CHECK_NAMES = {\n  PROJECT_ACCESSIBLE: 'Default project accessible',\n  SPECIFICATION_ACCESSIBLE: 'Default specification accessible',\n  IMPLEMENTATION_SESSION: 'Implementation session',\n} as const;\n\n/**\n * Thresholds for performance checks\n */\nexport const PERFORMANCE_THRESHOLDS = {\n  /** Response time warning threshold in ms */\n  RESPONSE_TIME_WARNING: 500,\n  /** Response time error threshold in ms */\n  RESPONSE_TIME_ERROR: 5000,\n  /** Connection timeout in ms */\n  CONNECTION_TIMEOUT: 10000,\n} as const;\n\n/**\n * API key validation constants\n */\nexport const API_KEY_VALIDATION = {\n  /** Required prefix for live API keys */\n  PREFIX: 'sf_live_',\n  /** Minimum length for valid API key */\n  MIN_LENGTH: 28,\n} as const;\n\n/**\n * Fix suggestion templates\n */\nexport const FIX_SUGGESTIONS = {\n  MISSING_MCP_CONFIG: \"Run 'specforge init' to create configuration\",\n  MISSING_PROJECT_CONFIG: \"Run 'specforge init' to create configuration\",\n  MISSING_API_KEY: \"Run 'specforge login' to authenticate\",\n  INVALID_API_KEY_FORMAT: 'Get a valid API key from https://specforge.com.br/settings/api-keys',\n  EXPIRED_API_KEY: \"Run 'specforge login --force' to re-authenticate\",\n  CONNECTION_FAILED: 'Check your internet connection',\n  CONNECTION_TIMEOUT: 'Check your internet connection or try again later',\n  PROJECT_NOT_ACCESSIBLE: \"Run 'specforge init' to reconfigure project\",\n  SPEC_NOT_ACCESSIBLE: \"Run 'specforge init' to reconfigure specification\",\n  NO_PROJECT_CONFIGURED: \"Run 'specforge init' to configure a project\",\n} as const;\n\n/**\n * Create a passing check result\n */\nexport function createPassResult(name: string, message: string, metadata?: Record<string, unknown>): CheckResult {\n  return { name, status: 'pass', message, metadata };\n}\n\n/**\n * Create a failing check result\n */\nexport function createFailResult(name: string, message: string, fix?: string, metadata?: Record<string, unknown>): CheckResult {\n  return { name, status: 'fail', message, fix, metadata };\n}\n\n/**\n * Create a warning check result\n */\nexport function createWarnResult(name: string, message: string, fix?: string, metadata?: Record<string, unknown>): CheckResult {\n  return { name, status: 'warn', message, fix, metadata };\n}\n\n/**\n * Calculate summary from check results\n */\nexport function calculateSummary(checks: Record<CheckCategory, CheckResult[]>): DoctorSummary {\n  const allChecks = Object.values(checks).flat();\n  return {\n    passed: allChecks.filter(c => c.status === 'pass').length,\n    failed: allChecks.filter(c => c.status === 'fail').length,\n    warnings: allChecks.filter(c => c.status === 'warn').length,\n    total: allChecks.length,\n  };\n}\n\n/**\n * Create an empty report structure\n */\nexport function createEmptyReport(): DoctorReport {\n  return {\n    checks: {\n      configuration: [],\n      authentication: [],\n      connection: [],\n      projectAccess: [],\n    },\n    summary: {\n      passed: 0,\n      failed: 0,\n      warnings: 0,\n      total: 0,\n    },\n    timestamp: new Date().toISOString(),\n  };\n}\n\n/**\n * Check if the report has any failures\n */\nexport function hasFailures(report: DoctorReport): boolean {\n  return report.summary.failed > 0;\n}\n\n/**\n * Check if the report has any warnings\n */\nexport function hasWarnings(report: DoctorReport): boolean {\n  return report.summary.warnings > 0;\n}\n\n/**\n * Get status icon for display\n */\nexport function getStatusIcon(status: CheckStatus): string {\n  switch (status) {\n    case 'pass':\n      return '✓';\n    case 'fail':\n      return '✗';\n    case 'warn':\n      return '⚠';\n  }\n}\n"],"mappings":"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","names":[]}

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

@@ -0,0 +1,27 @@
+/**
+ * Feedback Command
+ *
+ * Lists and submits feedback via the MCP API.
+ */
+import { Command } from 'commander';
+import { FeedbackOptions } from './feedback.types.js';
+/**
+ * Feedback list action handler
+ */
+export declare function feedbackAction(options: FeedbackOptions): Promise<void>;
+/**
+ * Feedback submit action handler
+ */
+export declare function feedbackSubmitAction(options: {
+    category: string;
+    summary: string;
+    severity?: string;
+    tool?: string;
+    details?: string;
+    json?: boolean;
+}): Promise<void>;
+/**
+ * Register feedback command with Commander
+ */
+export declare function registerFeedbackCommand(program: Command): void;
+//# sourceMappingURL=feedback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/feedback.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,OAAO,EACL,eAAe,EAUhB,MAAM,qBAAqB,CAAC;AAoJ7B;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgE5E;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDhB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6D9D"}

package/dist/cli/commands/feedback.js

@@ -0,0 +1,262 @@
+import ora from "ora";
+import { resolveConfig } from "../config/index.js";
+import { ApiClient } from "../../client/api-client.js";
+import { withErrorHandler, CliError } from "../middleware/error-handler.js";
+import { printBlank, printHeader } from "../ui/output.js";
+import { colors } from "../ui/colors.js";
+import {
+  VALID_CATEGORIES,
+  CATEGORY_COLORS,
+  SEVERITY_COLORS,
+  isValidCategory,
+  truncateSummary
+} from "./feedback.types.js";
+function getCategoryColorFn(category) {
+  const colorName = CATEGORY_COLORS[category];
+  switch (colorName) {
+    case "red":
+      return colors.error;
+    case "blue":
+      return colors.primary;
+    case "yellow":
+      return colors.warning;
+    case "cyan":
+      return (s) => colors.primary(s);
+    case "magenta":
+      return (s) => colors.primary(s);
+    default:
+      return (s) => s;
+  }
+}
+function getSeverityColorFn(severity) {
+  const colorName = SEVERITY_COLORS[severity];
+  switch (colorName) {
+    case "red":
+      return colors.error;
+    case "yellow":
+      return colors.warning;
+    case "blue":
+      return colors.primary;
+    case "dim":
+      return colors.muted;
+    default:
+      return (s) => s;
+  }
+}
+function displayFeedbackTable(entries, total) {
+  printBlank();
+  printHeader("Feedback");
+  printBlank();
+  if (entries.length === 0) {
+    console.log(colors.muted("No feedback entries found."));
+    printBlank();
+    return;
+  }
+  const header = [
+    "ID".padEnd(24),
+    "CATEGORY".padEnd(16),
+    "SEVERITY".padEnd(10),
+    "TOOL".padEnd(12),
+    "SUMMARY"
+  ].join(" ");
+  console.log(colors.muted(header));
+  console.log(colors.muted("\u2500".repeat(header.length)));
+  for (const entry of entries) {
+    const categoryColor = getCategoryColorFn(entry.category);
+    const severityColor = getSeverityColorFn(entry.severity);
+    const row = [
+      entry.id.padEnd(24),
+      categoryColor(entry.category.padEnd(16)),
+      severityColor(entry.severity.padEnd(10)),
+      (entry.tool || "-").padEnd(12),
+      truncateSummary(entry.summary)
+    ].join(" ");
+    console.log(row);
+  }
+  printBlank();
+  console.log(colors.muted(`Total: ${total} ${total === 1 ? "entry" : "entries"}`));
+  printBlank();
+}
+function displayEmptyState() {
+  printBlank();
+  console.log(colors.muted("No feedback entries found."));
+  console.log(
+    colors.muted('Use "specforge feedback submit" to submit feedback.')
+  );
+  printBlank();
+}
+function formatFeedbackAsToon(entries, total) {
+  const lines = ["@feedback"];
+  lines.push(`  total: ${total}`);
+  lines.push("  entries:");
+  for (const entry of entries) {
+    lines.push(`    - ${entry.id}`);
+    lines.push(`      category: ${entry.category}`);
+    lines.push(`      severity: ${entry.severity}`);
+    if (entry.tool) {
+      lines.push(`      tool: ${entry.tool}`);
+    }
+    lines.push(`      summary: ${entry.summary}`);
+    lines.push(`      createdAt: ${entry.createdAt}`);
+  }
+  return lines.join("\n");
+}
+function createClient() {
+  const config = resolveConfig();
+  if (!config.apiKey) {
+    throw new CliError(
+      "Not authenticated",
+      1,
+      "Run `specforge login` to authenticate first"
+    );
+  }
+  return new ApiClient(
+    {
+      apiKey: config.apiKey,
+      apiUrl: config.apiUrl,
+      debug: config.debug
+    },
+    { origin: "cli" }
+  );
+}
+async function feedbackAction(options) {
+  const spinner = ora({
+    text: "Loading feedback...",
+    color: "cyan"
+  }).start();
+  try {
+    if (options.category && !isValidCategory(options.category)) {
+      spinner.stop();
+      throw new CliError(
+        `Invalid category: ${options.category}`,
+        1,
+        `Valid categories: ${VALID_CATEGORIES.join(", ")}`
+      );
+    }
+    const limit = options.limit ? parseInt(options.limit, 10) : 10;
+    if (isNaN(limit) || limit < 1) {
+      spinner.stop();
+      throw new CliError("Invalid limit", 1, "Limit must be a positive number");
+    }
+    const client = createClient();
+    const response = await client.call("feedback", {
+      operation: "list",
+      limit,
+      categoryFilter: options.category || void 0
+    });
+    spinner.stop();
+    const entries = response.entries || [];
+    const total = response.total || entries.length;
+    if (options.json) {
+      console.log(JSON.stringify(response, null, 2));
+      return;
+    }
+    if (options.toon) {
+      console.log(formatFeedbackAsToon(entries, total));
+      return;
+    }
+    if (entries.length === 0) {
+      displayEmptyState();
+    } else {
+      displayFeedbackTable(entries, total);
+    }
+  } catch (error) {
+    spinner.stop();
+    if (error instanceof CliError) {
+      throw error;
+    }
+    const message = error instanceof Error ? error.message : "Unknown error";
+    throw new CliError(`Failed to load feedback: ${message}`, 1);
+  }
+}
+async function feedbackSubmitAction(options) {
+  if (!isValidCategory(options.category)) {
+    throw new CliError(
+      `Invalid category: ${options.category}`,
+      1,
+      `Valid categories: ${VALID_CATEGORIES.join(", ")}`
+    );
+  }
+  const spinner = ora({
+    text: "Submitting feedback...",
+    color: "cyan"
+  }).start();
+  try {
+    const client = createClient();
+    const response = await client.call("feedback", {
+      operation: "submit",
+      category: options.category,
+      summary: options.summary,
+      severity: options.severity || "medium",
+      tool: options.tool || void 0,
+      details: options.details || void 0
+    });
+    spinner.stop();
+    if (options.json) {
+      console.log(JSON.stringify(response, null, 2));
+      return;
+    }
+    printBlank();
+    console.log(colors.success("\u2713") + " Feedback submitted");
+    console.log(colors.muted("\u2500".repeat(40)));
+    console.log(colors.muted(`  ID: ${response.feedbackId}`));
+    console.log(colors.muted(`  Category: ${options.category}`));
+    console.log(colors.muted(`  Summary: ${options.summary}`));
+    printBlank();
+  } catch (error) {
+    spinner.stop();
+    if (error instanceof CliError) {
+      throw error;
+    }
+    const message = error instanceof Error ? error.message : "Unknown error";
+    throw new CliError(`Failed to submit feedback: ${message}`, 1);
+  }
+}
+function registerFeedbackCommand(program) {
+  const feedback = program.command("feedback").description("List and submit feedback");
+  feedback.option("--json", "Output as JSON").option("--toon", "Output as TOON format").option(
+    "--category <category>",
+    `Filter by category (${VALID_CATEGORIES.join(", ")})`
+  ).option("--limit <n>", "Limit number of results", "10").action(withErrorHandler(feedbackAction));
+  feedback.command("submit <summary>").description("Submit new feedback").requiredOption(
+    "-c, --category <category>",
+    `Category (${VALID_CATEGORIES.join(", ")})`
+  ).option(
+    "-s, --severity <severity>",
+    "Severity (critical, high, medium, low)",
+    "medium"
+  ).option("-t, --tool <tool>", "Related MCP tool").option("-d, --details <details>", "Extended description").option("--json", "Output as JSON").action(withErrorHandler(async (summary, opts) => {
+    await feedbackSubmitAction({
+      summary,
+      category: opts.category,
+      severity: opts.severity,
+      tool: opts.tool,
+      details: opts.details,
+      json: !!opts.json
+    });
+  }));
+  feedback.addHelpText(
+    "after",
+    `
+Examples:
+  $ specforge feedback                          # List all feedback
+  $ specforge feedback --json                   # Output as JSON
+  $ specforge feedback --category bug           # Filter by category
+  $ specforge feedback submit "Tool X fails"    # Submit feedback
+    -c bug -s high -t action_work_session
+
+Categories:
+  ${colors.error("bug")}             - Something isn't working correctly
+  ${colors.primary("feature_request")} - New capability suggestion
+  ${colors.warning("usability")}       - UX/DX improvement
+  ${colors.primary("documentation")}   - Docs unclear or missing
+  ${colors.primary("performance")}     - Speed/efficiency issue
+`
+  );
+}
+export {
+  feedbackAction,
+  feedbackSubmitAction,
+  registerFeedbackCommand
+};
+//# sourceMappingURL=feedback.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/feedback.ts"],"sourcesContent":["/**\n * Feedback Command\n *\n * Lists and submits feedback via the MCP API.\n */\n\nimport { Command } from 'commander';\nimport ora from 'ora';\nimport { resolveConfig } from '../config/index.js';\nimport { ApiClient } from '../../client/api-client.js';\nimport { withErrorHandler, CliError } from '../middleware/error-handler.js';\nimport { printBlank, printHeader } from '../ui/output.js';\nimport { colors } from '../ui/colors.js';\nimport {\n  FeedbackOptions,\n  FeedbackListEntry,\n  FeedbackListResponse,\n  VALID_CATEGORIES,\n  CATEGORY_COLORS,\n  SEVERITY_COLORS,\n  isValidCategory,\n  truncateSummary,\n  type FeedbackCategory,\n  type FeedbackSeverity,\n} from './feedback.types.js';\n\n/**\n * Get chalk color function for category\n */\nfunction getCategoryColorFn(category: FeedbackCategory): (s: string) => string {\n  const colorName = CATEGORY_COLORS[category];\n  switch (colorName) {\n    case 'red':\n      return colors.error;\n    case 'blue':\n      return colors.primary;\n    case 'yellow':\n      return colors.warning;\n    case 'cyan':\n      return (s: string) => colors.primary(s);\n    case 'magenta':\n      return (s: string) => colors.primary(s);\n    default:\n      return (s: string) => s;\n  }\n}\n\n/**\n * Get chalk color function for severity\n */\nfunction getSeverityColorFn(severity: FeedbackSeverity): (s: string) => string {\n  const colorName = SEVERITY_COLORS[severity];\n  switch (colorName) {\n    case 'red':\n      return colors.error;\n    case 'yellow':\n      return colors.warning;\n    case 'blue':\n      return colors.primary;\n    case 'dim':\n      return colors.muted;\n    default:\n      return (s: string) => s;\n  }\n}\n\n/**\n * Display feedback entries in table format\n */\nfunction displayFeedbackTable(entries: FeedbackListEntry[], total: number): void {\n  printBlank();\n  printHeader('Feedback');\n  printBlank();\n\n  if (entries.length === 0) {\n    console.log(colors.muted('No feedback entries found.'));\n    printBlank();\n    return;\n  }\n\n  // Table header\n  const header = [\n    'ID'.padEnd(24),\n    'CATEGORY'.padEnd(16),\n    'SEVERITY'.padEnd(10),\n    'TOOL'.padEnd(12),\n    'SUMMARY',\n  ].join(' ');\n  console.log(colors.muted(header));\n  console.log(colors.muted('─'.repeat(header.length)));\n\n  // Table rows\n  for (const entry of entries) {\n    const categoryColor = getCategoryColorFn(entry.category);\n    const severityColor = getSeverityColorFn(entry.severity);\n\n    const row = [\n      entry.id.padEnd(24),\n      categoryColor(entry.category.padEnd(16)),\n      severityColor(entry.severity.padEnd(10)),\n      (entry.tool || '-').padEnd(12),\n      truncateSummary(entry.summary),\n    ].join(' ');\n\n    console.log(row);\n  }\n\n  printBlank();\n  console.log(colors.muted(`Total: ${total} ${total === 1 ? 'entry' : 'entries'}`));\n  printBlank();\n}\n\n/**\n * Display empty state\n */\nfunction displayEmptyState(): void {\n  printBlank();\n  console.log(colors.muted('No feedback entries found.'));\n  console.log(\n    colors.muted('Use \"specforge feedback submit\" to submit feedback.')\n  );\n  printBlank();\n}\n\n/**\n * Format feedback as TOON\n */\nfunction formatFeedbackAsToon(entries: FeedbackListEntry[], total: number): string {\n  const lines: string[] = ['@feedback'];\n  lines.push(`  total: ${total}`);\n  lines.push('  entries:');\n\n  for (const entry of entries) {\n    lines.push(`    - ${entry.id}`);\n    lines.push(`      category: ${entry.category}`);\n    lines.push(`      severity: ${entry.severity}`);\n    if (entry.tool) {\n      lines.push(`      tool: ${entry.tool}`);\n    }\n    lines.push(`      summary: ${entry.summary}`);\n    lines.push(`      createdAt: ${entry.createdAt}`);\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Create an ApiClient from resolved config\n */\nfunction createClient(): ApiClient {\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  // M9.7: the human CLI surface stamps origin via the `X-SpecForge-Origin: cli`\n  // header (the backend dropped the request-body `source` field in M7.4).\n  return new ApiClient(\n    {\n      apiKey: config.apiKey,\n      apiUrl: config.apiUrl,\n      debug: config.debug,\n    },\n    { origin: 'cli' },\n  );\n}\n\n/**\n * Feedback list action handler\n */\nexport async function feedbackAction(options: FeedbackOptions): Promise<void> {\n  const spinner = ora({\n    text: 'Loading feedback...',\n    color: 'cyan',\n  }).start();\n\n  try {\n    // Validate category filter if provided\n    if (options.category && !isValidCategory(options.category)) {\n      spinner.stop();\n      throw new CliError(\n        `Invalid category: ${options.category}`,\n        1,\n        `Valid categories: ${VALID_CATEGORIES.join(', ')}`\n      );\n    }\n\n    // Parse limit\n    const limit = options.limit ? parseInt(options.limit, 10) : 10;\n    if (isNaN(limit) || limit < 1) {\n      spinner.stop();\n      throw new CliError('Invalid limit', 1, 'Limit must be a positive number');\n    }\n\n    const client = createClient();\n\n    const response = await client.call<FeedbackListResponse>('feedback', {\n      operation: 'list',\n      limit,\n      categoryFilter: options.category || undefined,\n    });\n\n    spinner.stop();\n\n    const entries: FeedbackListEntry[] = response.entries || [];\n    const total = response.total || entries.length;\n\n    // Output based on format\n    if (options.json) {\n      console.log(JSON.stringify(response, null, 2));\n      return;\n    }\n\n    if (options.toon) {\n      console.log(formatFeedbackAsToon(entries, total));\n      return;\n    }\n\n    // Default: table display\n    if (entries.length === 0) {\n      displayEmptyState();\n    } else {\n      displayFeedbackTable(entries, total);\n    }\n  } catch (error) {\n    spinner.stop();\n\n    if (error instanceof CliError) {\n      throw error;\n    }\n\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    throw new CliError(`Failed to load feedback: ${message}`, 1);\n  }\n}\n\n/**\n * Feedback submit action handler\n */\nexport async function feedbackSubmitAction(options: {\n  category: string;\n  summary: string;\n  severity?: string;\n  tool?: string;\n  details?: string;\n  json?: boolean;\n}): Promise<void> {\n  // Validate category\n  if (!isValidCategory(options.category)) {\n    throw new CliError(\n      `Invalid category: ${options.category}`,\n      1,\n      `Valid categories: ${VALID_CATEGORIES.join(', ')}`\n    );\n  }\n\n  const spinner = ora({\n    text: 'Submitting feedback...',\n    color: 'cyan',\n  }).start();\n\n  try {\n    const client = createClient();\n\n    const response = await client.call<{\n      success: boolean;\n      feedbackId: string;\n      message: string;\n    }>('feedback', {\n      operation: 'submit',\n      category: options.category,\n      summary: options.summary,\n      severity: options.severity || 'medium',\n      tool: options.tool || undefined,\n      details: options.details || undefined,\n    });\n\n    spinner.stop();\n\n    if (options.json) {\n      console.log(JSON.stringify(response, null, 2));\n      return;\n    }\n\n    printBlank();\n    console.log(colors.success('✓') + ' Feedback submitted');\n    console.log(colors.muted('─'.repeat(40)));\n    console.log(colors.muted(`  ID: ${response.feedbackId}`));\n    console.log(colors.muted(`  Category: ${options.category}`));\n    console.log(colors.muted(`  Summary: ${options.summary}`));\n    printBlank();\n  } catch (error) {\n    spinner.stop();\n\n    if (error instanceof CliError) {\n      throw error;\n    }\n\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    throw new CliError(`Failed to submit feedback: ${message}`, 1);\n  }\n}\n\n/**\n * Register feedback command with Commander\n */\nexport function registerFeedbackCommand(program: Command): void {\n  const feedback = program\n    .command('feedback')\n    .description('List and submit feedback');\n\n  // Default: list feedback\n  feedback\n    .option('--json', 'Output as JSON')\n    .option('--toon', 'Output as TOON format')\n    .option(\n      '--category <category>',\n      `Filter by category (${VALID_CATEGORIES.join(', ')})`\n    )\n    .option('--limit <n>', 'Limit number of results', '10')\n    .action(withErrorHandler(feedbackAction));\n\n  // Submit subcommand\n  feedback\n    .command('submit <summary>')\n    .description('Submit new feedback')\n    .requiredOption(\n      '-c, --category <category>',\n      `Category (${VALID_CATEGORIES.join(', ')})`\n    )\n    .option(\n      '-s, --severity <severity>',\n      'Severity (critical, high, medium, low)',\n      'medium'\n    )\n    .option('-t, --tool <tool>', 'Related MCP tool')\n    .option('-d, --details <details>', 'Extended description')\n    .option('--json', 'Output as JSON')\n    .action(withErrorHandler(async (summary: string, opts: Record<string, string | undefined>) => {\n      await feedbackSubmitAction({\n        summary,\n        category: opts.category!,\n        severity: opts.severity,\n        tool: opts.tool,\n        details: opts.details,\n        json: !!opts.json,\n      });\n    }));\n\n  feedback.addHelpText(\n    'after',\n    `\nExamples:\n  $ specforge feedback                          # List all feedback\n  $ specforge feedback --json                   # Output as JSON\n  $ specforge feedback --category bug           # Filter by category\n  $ specforge feedback submit \"Tool X fails\"    # Submit feedback\n    -c bug -s high -t action_work_session\n\nCategories:\n  ${colors.error('bug')}             - Something isn't working correctly\n  ${colors.primary('feature_request')} - New capability suggestion\n  ${colors.warning('usability')}       - UX/DX improvement\n  ${colors.primary('documentation')}   - Docs unclear or missing\n  ${colors.primary('performance')}     - Speed/efficiency issue\n`\n  );\n}\n"],"mappings":"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","names":[]}