@specforge/cli 0.1.0

package/bin/specforge

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+/**
+ * SpecForge MCP CLI Entry Point
+ *
+ * All logic is handled by the CLI module.
+ * The 'serve' command is set as default in Commander.js for backward compatibility.
+ *
+ * When called with no arguments: starts MCP server
+ * When called with subcommands/flags: runs CLI
+ */
+
+import('../dist/cli/index.js')
+  .then(({ runCLI }) => runCLI())
+  .catch((error) => {
+    console.error('Fatal error:', error.message);
+    if (process.env.SPECFORGE_DEBUG === 'true') {
+      console.error(error.stack);
+    }
+    process.exit(1);
+  });

package/dist/channel.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Channel manifest — single import surface for build-time substitutions.
+ *
+ * `__CLI_*__` symbols are declared ambient in `channel.d.ts` and substituted
+ * by `tsup` (build) and `vitest` (tests) via `build/channel-defines.ts`.
+ *
+ * The rest of the CLI source must reference `CHANNEL.*` only — never the
+ * literal endpoint URLs, package name, or config dir name. The B1 acceptance
+ * grep enforces this.
+ */
+export declare const CHANNEL: {
+    /** Binary / display name. e.g. `"specforge"` (stable) or `"specforge-canary"`. */
+    readonly name: string;
+    /** npm package name on the public registry. */
+    readonly packageName: string;
+    /** MCP API gateway endpoint pair + health probes. */
+    readonly endpoint: {
+        readonly primary: string;
+        readonly fallback: string;
+        readonly healthPrimary: string;
+        readonly healthFallback: string;
+    };
+    /** Per-channel config dir under `$HOME` (and at the project level). */
+    readonly configDir: string;
+};
+export type ChannelManifest = typeof CHANNEL;
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,OAAO;IAClB,kFAAkF;;IAElF,+CAA+C;;IAE/C,qDAAqD;;;;;;;IAUrD,uEAAuE;;CAE/D,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,OAAO,OAAO,CAAC"}

package/dist/channel.js

@@ -0,0 +1,22 @@
+const CHANNEL = {
+  /** Binary / display name. e.g. `"specforge"` (stable) or `"specforge-canary"`. */
+  name: "specforge",
+  /** npm package name on the public registry. */
+  packageName: "@specforge/cli",
+  /** MCP API gateway endpoint pair + health probes. */
+  endpoint: {
+    primary: "https://mcp.specforge.tech/local",
+    fallback: "https://mcp.specforge.com.br/local",
+    healthPrimary: "https://mcp.specforge.tech/health",
+    healthFallback: "https://mcp.specforge.com.br/health"
+  },
+  // (CLI REST `cliRest` endpoints removed — the human CLI now uses the `/cli`
+  // route on the MCP host via `createCliClient`; the separate cli-rest gateway
+  // is retired.)
+  /** Per-channel config dir under `$HOME` (and at the project level). */
+  configDir: ".specforge"
+};
+export {
+  CHANNEL
+};
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/channel.ts"],"sourcesContent":["/**\n * Channel manifest — single import surface for build-time substitutions.\n *\n * `__CLI_*__` symbols are declared ambient in `channel.d.ts` and substituted\n * by `tsup` (build) and `vitest` (tests) via `build/channel-defines.ts`.\n *\n * The rest of the CLI source must reference `CHANNEL.*` only — never the\n * literal endpoint URLs, package name, or config dir name. The B1 acceptance\n * grep enforces this.\n */\n\nexport const CHANNEL = {\n  /** Binary / display name. e.g. `\"specforge\"` (stable) or `\"specforge-canary\"`. */\n  name: __CLI_NAME__,\n  /** npm package name on the public registry. */\n  packageName: __CLI_PACKAGE_NAME__,\n  /** MCP API gateway endpoint pair + health probes. */\n  endpoint: {\n    primary: __CLI_ENDPOINT_PRIMARY__,\n    fallback: __CLI_ENDPOINT_FALLBACK__,\n    healthPrimary: __CLI_HEALTH_PRIMARY__,\n    healthFallback: __CLI_HEALTH_FALLBACK__,\n  },\n  // (CLI REST `cliRest` endpoints removed — the human CLI now uses the `/cli`\n  // route on the MCP host via `createCliClient`; the separate cli-rest gateway\n  // is retired.)\n  /** Per-channel config dir under `$HOME` (and at the project level). */\n  configDir: __CLI_CONFIG_DIR__,\n} as const;\n\nexport type ChannelManifest = typeof CHANNEL;\n"],"mappings":"AAWO,MAAM,UAAU;AAAA;AAAA,EAErB,MAAM;AAAA;AAAA,EAEN,aAAa;AAAA;AAAA,EAEb,UAAU;AAAA,IACR,SAAS;AAAA,IACT,UAAU;AAAA,IACV,eAAe;AAAA,IACf,gBAAgB;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW;AACb;","names":[]}

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

@@ -0,0 +1,16 @@
+/**
+ * Configure Command
+ *
+ * View and modify configuration values for global and project settings.
+ */
+import { Command } from 'commander';
+import { ConfigureOptions } from './configure.types.js';
+/**
+ * Configure command action handler
+ */
+export declare function configureAction(key: string | undefined, value: string | undefined, options: ConfigureOptions): Promise<void>;
+/**
+ * Register configure command with Commander
+ */
+export declare function registerConfigureCommand(program: Command): void;
+//# sourceMappingURL=configure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/configure.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBpC,OAAO,EACL,gBAAgB,EAMjB,MAAM,sBAAsB,CAAC;AA+K9B;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA0Cf;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2B/D"}

package/dist/cli/commands/configure.js

@@ -0,0 +1,186 @@
+import {
+  resolveConfig,
+  loadGlobalConfig,
+  tryLoadProjectConfig,
+  saveGlobalConfig,
+  saveProjectConfig,
+  getConfigPaths
+} from "../config/index.js";
+import { withErrorHandler, CliError, ValidationError } from "../middleware/error-handler.js";
+import {
+  printSuccess,
+  printBlank,
+  printHeader
+} from "../ui/output.js";
+import { colors } from "../ui/colors.js";
+import {
+  VALID_KEYS,
+  CONFIG_KEY_META,
+  isValidKeyForScope,
+  parseConfigValue
+} from "./configure.types.js";
+function maskValue(value, visibleChars = 8) {
+  if (value.length <= visibleChars) {
+    return "***";
+  }
+  return "***" + value.slice(-visibleChars);
+}
+function formatDisplayValue(key, value) {
+  if (value === void 0 || value === null || value === "") {
+    return colors.muted("(not set)");
+  }
+  if (key === "apiKey" && typeof value === "string") {
+    return colors.muted(maskValue(value));
+  }
+  if (typeof value === "boolean") {
+    return value ? colors.success("true") : colors.muted("false");
+  }
+  return String(value);
+}
+function displayAllConfig() {
+  const config = resolveConfig();
+  const paths = getConfigPaths();
+  printBlank();
+  printHeader("Configuration");
+  printBlank();
+  console.log(colors.muted("# Resolved values (from all sources)"));
+  printBlank();
+  const apiKeyDisplay = config.apiKey ? colors.muted(maskValue(config.apiKey)) : colors.error("(not set)");
+  const apiKeySource = config.sources.apiKey ? colors.muted(` (from ${config.sources.apiKey})`) : "";
+  console.log(`  apiKey:           ${apiKeyDisplay}${apiKeySource}`);
+  const formatSource = config.sources.mcpOutputFormat ? colors.muted(` (from ${config.sources.mcpOutputFormat})`) : "";
+  console.log(`  mcpOutputFormat:  ${config.mcpOutputFormat}${formatSource}`);
+  const projectIdDisplay = formatDisplayValue("projectId", config.projectId);
+  const projectIdSource = config.sources.projectId ? colors.muted(` (from ${config.sources.projectId})`) : "";
+  console.log(`  projectId:        ${projectIdDisplay}${projectIdSource}`);
+  const specIdDisplay = formatDisplayValue("specificationId", config.specificationId);
+  const specIdSource = config.sources.specificationId ? colors.muted(` (from ${config.sources.specificationId})`) : "";
+  console.log(`  specificationId:  ${specIdDisplay}${specIdSource}`);
+  const autoSetDisplay = formatDisplayValue("autoSetContext", config.autoSetContext);
+  console.log(`  autoSetContext:   ${autoSetDisplay}`);
+  printBlank();
+  console.log(colors.muted("# File locations"));
+  console.log(`  global:  ${paths.globalConfig}`);
+  console.log(`  project: ${paths.projectConfig}`);
+  printBlank();
+}
+function displayKey(key) {
+  const config = resolveConfig();
+  const value = config[key];
+  if (key === "apiKey" && typeof value === "string") {
+    console.log(maskValue(value));
+  } else if (value === void 0 || value === null || value === "") {
+    console.log(colors.muted("(not set)"));
+  } else {
+    console.log(String(value));
+  }
+}
+function setConfigValue(key, value, global) {
+  const scope = global ? "global" : "project";
+  if (!isValidKeyForScope(key, scope)) {
+    const validKeys = VALID_KEYS[scope];
+    throw new ValidationError(
+      `Invalid key "${key}" for ${scope} config`,
+      `Valid keys: ${validKeys.join(", ")}`
+    );
+  }
+  const parseResult = parseConfigValue(key, value);
+  if (!parseResult.valid) {
+    const meta = CONFIG_KEY_META[key];
+    throw new ValidationError(
+      `Invalid value "${value}" for key "${key}"`,
+      meta?.validValues ? `Valid values: ${meta.validValues.join(", ")}` : void 0
+    );
+  }
+  if (global) {
+    const currentConfig = loadGlobalConfig();
+    saveGlobalConfig({
+      ...currentConfig,
+      [key]: parseResult.parsed
+    });
+  } else {
+    const currentConfig = tryLoadProjectConfig() || {};
+    saveProjectConfig({
+      ...currentConfig,
+      [key]: parseResult.parsed
+    });
+  }
+  printSuccess(`Set ${key} = ${value}`);
+}
+function unsetConfigKey(key, global) {
+  const scope = global ? "global" : "project";
+  if (!isValidKeyForScope(key, scope)) {
+    const validKeys = VALID_KEYS[scope];
+    throw new ValidationError(
+      `Invalid key "${key}" for ${scope} config`,
+      `Valid keys: ${validKeys.join(", ")}`
+    );
+  }
+  if (global) {
+    const config = loadGlobalConfig();
+    delete config[key];
+    saveGlobalConfig(config);
+  } else {
+    const config = tryLoadProjectConfig() || {};
+    delete config[key];
+    saveProjectConfig(config);
+  }
+  printSuccess(`Removed ${key} from ${scope} config`);
+}
+async function configureAction(key, value, options) {
+  if (options.unset) {
+    unsetConfigKey(options.unset, !!options.global);
+    return;
+  }
+  if (!key) {
+    displayAllConfig();
+    return;
+  }
+  const isValidGlobal = isValidKeyForScope(key, "global");
+  const isValidProject = isValidKeyForScope(key, "project");
+  if (!isValidGlobal && !isValidProject && key !== "apiKey") {
+    const allKeys = [.../* @__PURE__ */ new Set([...VALID_KEYS.global, ...VALID_KEYS.project])];
+    throw new ValidationError(
+      `Unknown configuration key "${key}"`,
+      `Valid keys: ${allKeys.join(", ")}`
+    );
+  }
+  if (value === void 0) {
+    displayKey(key);
+    return;
+  }
+  if (key === "apiKey") {
+    throw new CliError(
+      "Cannot set API key via configure command",
+      1,
+      "Use `specforge login` to set your API key"
+    );
+  }
+  setConfigValue(key, value, !!options.global);
+}
+function registerConfigureCommand(program) {
+  program.command("configure [key] [value]").alias("config").description("View or modify configuration").option("--global", "Read/write global config (~/.specforge/config.json)").option("--unset <key>", "Remove a configuration key").addHelpText("after", `
+Examples:
+  $ specforge configure                     # Show all configuration
+  $ specforge configure mcpOutputFormat              # Show MCP output format value
+  $ specforge configure mcpOutputFormat toon         # Set project MCP output format to toon
+  $ specforge configure --global mcpOutputFormat json  # Set global MCP output format to json
+  $ specforge configure --unset projectId   # Remove projectId from project config
+
+Valid keys:
+  Global: ${VALID_KEYS.global.join(", ")}
+  Project: ${VALID_KEYS.project.join(", ")}
+
+Key descriptions:
+  mcpOutputFormat - Local MCP response encoding: json or toon (44% smaller)
+  projectId       - Default project ID for this directory
+  specificationId - Default specification ID for this directory
+  autoSetContext  - Auto-set working context on start (true/false)
+  defaultProjectId - Global default project ID
+`).action(withErrorHandler(configureAction));
+}
+export {
+  configureAction,
+  registerConfigureCommand
+};
+//# sourceMappingURL=configure.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/configure.ts"],"sourcesContent":["/**\n * Configure Command\n *\n * View and modify configuration values for global and project settings.\n */\n\nimport { Command } from 'commander';\nimport {\n  resolveConfig,\n  loadGlobalConfig,\n  tryLoadProjectConfig,\n  saveGlobalConfig,\n  saveProjectConfig,\n  getConfigPaths,\n} from '../config/index.js';\nimport { withErrorHandler, CliError, ValidationError } from '../middleware/error-handler.js';\nimport {\n  printSuccess,\n  printBlank,\n  printHeader,\n} from '../ui/output.js';\nimport { colors } from '../ui/colors.js';\nimport {\n  ConfigureOptions,\n  VALID_KEYS,\n  CONFIG_KEY_META,\n  ValidConfigKey,\n  isValidKeyForScope,\n  parseConfigValue,\n} from './configure.types.js';\n\n/**\n * Mask a sensitive value (show only last N characters)\n */\nfunction maskValue(value: string, visibleChars = 8): string {\n  if (value.length <= visibleChars) {\n    return '***';\n  }\n  return '***' + value.slice(-visibleChars);\n}\n\n/**\n * Format a value for display\n */\nfunction formatDisplayValue(key: string, value: unknown): string {\n  if (value === undefined || value === null || value === '') {\n    return colors.muted('(not set)');\n  }\n\n  // Mask API key\n  if (key === 'apiKey' && typeof value === 'string') {\n    return colors.muted(maskValue(value));\n  }\n\n  // Boolean values\n  if (typeof value === 'boolean') {\n    return value ? colors.success('true') : colors.muted('false');\n  }\n\n  return String(value);\n}\n\n/**\n * Display all configuration values with sources\n */\nfunction displayAllConfig(): void {\n  const config = resolveConfig();\n  const paths = getConfigPaths();\n\n  printBlank();\n  printHeader('Configuration');\n  printBlank();\n\n  console.log(colors.muted('# Resolved values (from all sources)'));\n  printBlank();\n\n  // API Key (always masked)\n  const apiKeyDisplay = config.apiKey\n    ? colors.muted(maskValue(config.apiKey))\n    : colors.error('(not set)');\n  const apiKeySource = config.sources.apiKey\n    ? colors.muted(` (from ${config.sources.apiKey})`)\n    : '';\n  console.log(`  apiKey:           ${apiKeyDisplay}${apiKeySource}`);\n\n  // MCP output format\n  const formatSource = config.sources.mcpOutputFormat\n    ? colors.muted(` (from ${config.sources.mcpOutputFormat})`)\n    : '';\n  console.log(`  mcpOutputFormat:  ${config.mcpOutputFormat}${formatSource}`);\n\n  // Project ID\n  const projectIdDisplay = formatDisplayValue('projectId', config.projectId);\n  const projectIdSource = config.sources.projectId\n    ? colors.muted(` (from ${config.sources.projectId})`)\n    : '';\n  console.log(`  projectId:        ${projectIdDisplay}${projectIdSource}`);\n\n  // Specification ID\n  const specIdDisplay = formatDisplayValue('specificationId', config.specificationId);\n  const specIdSource = config.sources.specificationId\n    ? colors.muted(` (from ${config.sources.specificationId})`)\n    : '';\n  console.log(`  specificationId:  ${specIdDisplay}${specIdSource}`);\n\n  // Auto Set Context\n  const autoSetDisplay = formatDisplayValue('autoSetContext', config.autoSetContext);\n  // Note: autoSetContext source tracking not yet implemented in ConfigSources\n  console.log(`  autoSetContext:   ${autoSetDisplay}`);\n\n  printBlank();\n  console.log(colors.muted('# File locations'));\n  console.log(`  global:  ${paths.globalConfig}`);\n  console.log(`  project: ${paths.projectConfig}`);\n  printBlank();\n}\n\n/**\n * Display a specific configuration key value\n */\nfunction displayKey(key: string): void {\n  const config = resolveConfig();\n  const value = (config as unknown as Record<string, unknown>)[key];\n\n  if (key === 'apiKey' && typeof value === 'string') {\n    console.log(maskValue(value));\n  } else if (value === undefined || value === null || value === '') {\n    console.log(colors.muted('(not set)'));\n  } else {\n    console.log(String(value));\n  }\n}\n\n/**\n * Set a configuration value\n */\nfunction setConfigValue(key: string, value: string, global: boolean): void {\n  const scope = global ? 'global' : 'project';\n\n  // Validate key for scope\n  if (!isValidKeyForScope(key, scope)) {\n    const validKeys = VALID_KEYS[scope];\n    throw new ValidationError(\n      `Invalid key \"${key}\" for ${scope} config`,\n      `Valid keys: ${validKeys.join(', ')}`\n    );\n  }\n\n  // Parse and validate value\n  const parseResult = parseConfigValue(key, value);\n  if (!parseResult.valid) {\n    const meta = CONFIG_KEY_META[key as ValidConfigKey];\n    throw new ValidationError(\n      `Invalid value \"${value}\" for key \"${key}\"`,\n      meta?.validValues ? `Valid values: ${meta.validValues.join(', ')}` : undefined\n    );\n  }\n\n  // Save to appropriate config file\n  if (global) {\n    const currentConfig = loadGlobalConfig();\n    saveGlobalConfig({\n      ...currentConfig,\n      [key]: parseResult.parsed,\n    });\n  } else {\n    const currentConfig = tryLoadProjectConfig() || {};\n    saveProjectConfig({\n      ...currentConfig,\n      [key]: parseResult.parsed,\n    });\n  }\n\n  printSuccess(`Set ${key} = ${value}`);\n}\n\n/**\n * Remove a configuration key\n */\nfunction unsetConfigKey(key: string, global: boolean): void {\n  const scope = global ? 'global' : 'project';\n\n  // Validate key for scope\n  if (!isValidKeyForScope(key, scope)) {\n    const validKeys = VALID_KEYS[scope];\n    throw new ValidationError(\n      `Invalid key \"${key}\" for ${scope} config`,\n      `Valid keys: ${validKeys.join(', ')}`\n    );\n  }\n\n  if (global) {\n    const config = loadGlobalConfig();\n    delete (config as Record<string, unknown>)[key];\n    saveGlobalConfig(config);\n  } else {\n    const config = tryLoadProjectConfig() || {};\n    delete (config as Record<string, unknown>)[key];\n    saveProjectConfig(config);\n  }\n\n  printSuccess(`Removed ${key} from ${scope} config`);\n}\n\n/**\n * Configure command action handler\n */\nexport async function configureAction(\n  key: string | undefined,\n  value: string | undefined,\n  options: ConfigureOptions\n): Promise<void> {\n  // Handle --unset\n  if (options.unset) {\n    unsetConfigKey(options.unset, !!options.global);\n    return;\n  }\n\n  // No key = show all config\n  if (!key) {\n    displayAllConfig();\n    return;\n  }\n\n  // Validate key exists in at least one scope\n  const isValidGlobal = isValidKeyForScope(key, 'global');\n  const isValidProject = isValidKeyForScope(key, 'project');\n\n  if (!isValidGlobal && !isValidProject && key !== 'apiKey') {\n    const allKeys = [...new Set([...VALID_KEYS.global, ...VALID_KEYS.project])];\n    throw new ValidationError(\n      `Unknown configuration key \"${key}\"`,\n      `Valid keys: ${allKeys.join(', ')}`\n    );\n  }\n\n  // Key only = show value\n  if (value === undefined) {\n    displayKey(key);\n    return;\n  }\n\n  // Key + value = set value\n  // Prevent setting apiKey via configure\n  if (key === 'apiKey') {\n    throw new CliError(\n      'Cannot set API key via configure command',\n      1,\n      'Use `specforge login` to set your API key'\n    );\n  }\n\n  setConfigValue(key, value, !!options.global);\n}\n\n/**\n * Register configure command with Commander\n */\nexport function registerConfigureCommand(program: Command): void {\n  program\n    .command('configure [key] [value]')\n    .alias('config')\n    .description('View or modify configuration')\n    .option('--global', 'Read/write global config (~/.specforge/config.json)')\n    .option('--unset <key>', 'Remove a configuration key')\n    .addHelpText('after', `\nExamples:\n  $ specforge configure                     # Show all configuration\n  $ specforge configure mcpOutputFormat              # Show MCP output format value\n  $ specforge configure mcpOutputFormat toon         # Set project MCP output format to toon\n  $ specforge configure --global mcpOutputFormat json  # Set global MCP output format to json\n  $ specforge configure --unset projectId   # Remove projectId from project config\n\nValid keys:\n  Global: ${VALID_KEYS.global.join(', ')}\n  Project: ${VALID_KEYS.project.join(', ')}\n\nKey descriptions:\n  mcpOutputFormat - Local MCP response encoding: json or toon (44% smaller)\n  projectId       - Default project ID for this directory\n  specificationId - Default specification ID for this directory\n  autoSetContext  - Auto-set working context on start (true/false)\n  defaultProjectId - Global default project ID\n`)\n    .action(withErrorHandler(configureAction));\n}\n"],"mappings":"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","names":[]}

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

@@ -0,0 +1,110 @@
+/**
+ * Configure Command Types
+ *
+ * Type definitions and constants for the configure command.
+ */
+/**
+ * Configure command options from Commander
+ */
+export interface ConfigureOptions {
+    /** Read/write global config (~/.specforge/config.json) */
+    global?: boolean;
+    /** Remove a configuration key */
+    unset?: string;
+}
+/**
+ * Configuration scope
+ */
+export type ConfigScope = 'global' | 'project';
+/**
+ * Valid configuration keys by scope
+ */
+export declare const VALID_KEYS: Record<ConfigScope, string[]>;
+/**
+ * All valid configuration keys (union of both scopes)
+ */
+export declare const ALL_VALID_KEYS: readonly ["mcpOutputFormat", "projectId", "specificationId", "autoSetContext", "defaultProjectId"];
+/**
+ * Valid configuration key type
+ */
+export type ValidConfigKey = (typeof ALL_VALID_KEYS)[number];
+/**
+ * Configuration key metadata
+ */
+export interface ConfigKeyMeta {
+    /** Human-readable description */
+    description: string;
+    /** Valid scopes for this key */
+    scopes: ConfigScope[];
+    /** Valid values (if restricted) */
+    validValues?: string[];
+    /** Whether the value should be masked in output */
+    masked?: boolean;
+    /** Value type after parsing */
+    type: 'string' | 'boolean';
+}
+/**
+ * Configuration key metadata map
+ */
+export declare const CONFIG_KEY_META: Record<ValidConfigKey, ConfigKeyMeta>;
+/**
+ * Key validator function type
+ */
+export type KeyValidator = (value: string) => boolean;
+/**
+ * Key validators for values that need validation
+ */
+export declare const KEY_VALIDATORS: Partial<Record<ValidConfigKey, KeyValidator>>;
+/**
+ * Value parser function type
+ */
+export type ValueParser = (value: string) => unknown;
+/**
+ * Value parsers for converting string input to proper types
+ */
+export declare const VALUE_PARSERS: Partial<Record<ValidConfigKey, ValueParser>>;
+/**
+ * Configuration display entry
+ */
+export interface ConfigDisplayEntry {
+    /** Configuration key */
+    key: string;
+    /** Resolved value */
+    value: unknown;
+    /** Source of the value */
+    source: string;
+    /** Whether to mask the value */
+    masked?: boolean;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    /** Whether the validation passed */
+    valid: boolean;
+    /** Error message if validation failed */
+    error?: string;
+    /** Hint for valid values */
+    hint?: string;
+}
+/**
+ * Check if a key is valid for the given scope
+ */
+export declare function isValidKeyForScope(key: string, scope: ConfigScope): boolean;
+/**
+ * Get validator for a key
+ */
+export declare function getValidator(key: string): KeyValidator | undefined;
+/**
+ * Get parser for a key
+ */
+export declare function getParser(key: string): ValueParser | undefined;
+/**
+ * Parse and validate a configuration value
+ */
+export declare function parseConfigValue(key: string, value: string): {
+    parsed: unknown;
+    valid: boolean;
+    error?: string;
+};
+//# sourceMappingURL=configure.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configure.types.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/configure.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,CAGpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,oGAMjB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,cAAc,EAAE,aAAa,CA4BjE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,YAAY,CAAC,CAGxE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAEtE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAE3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAiBrD"}

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

@@ -0,0 +1,82 @@
+const VALID_KEYS = {
+  global: ["mcpOutputFormat", "defaultProjectId"],
+  project: ["mcpOutputFormat", "projectId", "specificationId", "autoSetContext"]
+};
+const ALL_VALID_KEYS = [
+  "mcpOutputFormat",
+  "projectId",
+  "specificationId",
+  "autoSetContext",
+  "defaultProjectId"
+];
+const CONFIG_KEY_META = {
+  mcpOutputFormat: {
+    description: "Local MCP response encoding (json or toon)",
+    scopes: ["global", "project"],
+    validValues: ["json", "toon"],
+    type: "string"
+  },
+  projectId: {
+    description: "Default project ID",
+    scopes: ["project"],
+    type: "string"
+  },
+  specificationId: {
+    description: "Default specification ID",
+    scopes: ["project"],
+    type: "string"
+  },
+  autoSetContext: {
+    description: "Auto-set working context on MCP server start",
+    scopes: ["project"],
+    validValues: ["true", "false"],
+    type: "boolean"
+  },
+  defaultProjectId: {
+    description: "Global default project ID",
+    scopes: ["global"],
+    type: "string"
+  }
+};
+const KEY_VALIDATORS = {
+  mcpOutputFormat: (v) => ["json", "toon"].includes(v),
+  autoSetContext: (v) => ["true", "false"].includes(v.toLowerCase())
+};
+const VALUE_PARSERS = {
+  autoSetContext: (v) => v.toLowerCase() === "true"
+};
+function isValidKeyForScope(key, scope) {
+  return VALID_KEYS[scope].includes(key);
+}
+function getValidator(key) {
+  return KEY_VALIDATORS[key];
+}
+function getParser(key) {
+  return VALUE_PARSERS[key];
+}
+function parseConfigValue(key, value) {
+  const validator = getValidator(key);
+  if (validator && !validator(value)) {
+    const meta = CONFIG_KEY_META[key];
+    return {
+      parsed: value,
+      valid: false,
+      error: `Invalid value "${value}" for key "${key}". Valid values: ${meta?.validValues?.join(", ")}`
+    };
+  }
+  const parser = getParser(key);
+  const parsed = parser ? parser(value) : value;
+  return { parsed, valid: true };
+}
+export {
+  ALL_VALID_KEYS,
+  CONFIG_KEY_META,
+  KEY_VALIDATORS,
+  VALID_KEYS,
+  VALUE_PARSERS,
+  getParser,
+  getValidator,
+  isValidKeyForScope,
+  parseConfigValue
+};
+//# sourceMappingURL=configure.types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/configure.types.ts"],"sourcesContent":["/**\n * Configure Command Types\n *\n * Type definitions and constants for the configure command.\n */\n\n/**\n * Configure command options from Commander\n */\nexport interface ConfigureOptions {\n  /** Read/write global config (~/.specforge/config.json) */\n  global?: boolean;\n  /** Remove a configuration key */\n  unset?: string;\n}\n\n/**\n * Configuration scope\n */\nexport type ConfigScope = 'global' | 'project';\n\n/**\n * Valid configuration keys by scope\n */\nexport const VALID_KEYS: Record<ConfigScope, string[]> = {\n  global: ['mcpOutputFormat', 'defaultProjectId'],\n  project: ['mcpOutputFormat', 'projectId', 'specificationId', 'autoSetContext'],\n};\n\n/**\n * All valid configuration keys (union of both scopes)\n */\nexport const ALL_VALID_KEYS = [\n  'mcpOutputFormat',\n  'projectId',\n  'specificationId',\n  'autoSetContext',\n  'defaultProjectId',\n] as const;\n\n/**\n * Valid configuration key type\n */\nexport type ValidConfigKey = (typeof ALL_VALID_KEYS)[number];\n\n/**\n * Configuration key metadata\n */\nexport interface ConfigKeyMeta {\n  /** Human-readable description */\n  description: string;\n  /** Valid scopes for this key */\n  scopes: ConfigScope[];\n  /** Valid values (if restricted) */\n  validValues?: string[];\n  /** Whether the value should be masked in output */\n  masked?: boolean;\n  /** Value type after parsing */\n  type: 'string' | 'boolean';\n}\n\n/**\n * Configuration key metadata map\n */\nexport const CONFIG_KEY_META: Record<ValidConfigKey, ConfigKeyMeta> = {\n  mcpOutputFormat: {\n    description: 'Local MCP response encoding (json or toon)',\n    scopes: ['global', 'project'],\n    validValues: ['json', 'toon'],\n    type: 'string',\n  },\n  projectId: {\n    description: 'Default project ID',\n    scopes: ['project'],\n    type: 'string',\n  },\n  specificationId: {\n    description: 'Default specification ID',\n    scopes: ['project'],\n    type: 'string',\n  },\n  autoSetContext: {\n    description: 'Auto-set working context on MCP server start',\n    scopes: ['project'],\n    validValues: ['true', 'false'],\n    type: 'boolean',\n  },\n  defaultProjectId: {\n    description: 'Global default project ID',\n    scopes: ['global'],\n    type: 'string',\n  },\n};\n\n/**\n * Key validator function type\n */\nexport type KeyValidator = (value: string) => boolean;\n\n/**\n * Key validators for values that need validation\n */\nexport const KEY_VALIDATORS: Partial<Record<ValidConfigKey, KeyValidator>> = {\n  mcpOutputFormat: (v: string) => ['json', 'toon'].includes(v),\n  autoSetContext: (v: string) => ['true', 'false'].includes(v.toLowerCase()),\n};\n\n/**\n * Value parser function type\n */\nexport type ValueParser = (value: string) => unknown;\n\n/**\n * Value parsers for converting string input to proper types\n */\nexport const VALUE_PARSERS: Partial<Record<ValidConfigKey, ValueParser>> = {\n  autoSetContext: (v: string) => v.toLowerCase() === 'true',\n};\n\n/**\n * Configuration display entry\n */\nexport interface ConfigDisplayEntry {\n  /** Configuration key */\n  key: string;\n  /** Resolved value */\n  value: unknown;\n  /** Source of the value */\n  source: string;\n  /** Whether to mask the value */\n  masked?: boolean;\n}\n\n/**\n * Validation result\n */\nexport interface ValidationResult {\n  /** Whether the validation passed */\n  valid: boolean;\n  /** Error message if validation failed */\n  error?: string;\n  /** Hint for valid values */\n  hint?: string;\n}\n\n/**\n * Check if a key is valid for the given scope\n */\nexport function isValidKeyForScope(key: string, scope: ConfigScope): boolean {\n  return VALID_KEYS[scope].includes(key);\n}\n\n/**\n * Get validator for a key\n */\nexport function getValidator(key: string): KeyValidator | undefined {\n  return KEY_VALIDATORS[key as ValidConfigKey];\n}\n\n/**\n * Get parser for a key\n */\nexport function getParser(key: string): ValueParser | undefined {\n  return VALUE_PARSERS[key as ValidConfigKey];\n}\n\n/**\n * Parse and validate a configuration value\n */\nexport function parseConfigValue(\n  key: string,\n  value: string\n): { parsed: unknown; valid: boolean; error?: string } {\n  // Validate if validator exists\n  const validator = getValidator(key);\n  if (validator && !validator(value)) {\n    const meta = CONFIG_KEY_META[key as ValidConfigKey];\n    return {\n      parsed: value,\n      valid: false,\n      error: `Invalid value \"${value}\" for key \"${key}\". Valid values: ${meta?.validValues?.join(', ')}`,\n    };\n  }\n\n  // Parse the value\n  const parser = getParser(key);\n  const parsed = parser ? parser(value) : value;\n\n  return { parsed, valid: true };\n}\n"],"mappings":"AAwBO,MAAM,aAA4C;AAAA,EACvD,QAAQ,CAAC,mBAAmB,kBAAkB;AAAA,EAC9C,SAAS,CAAC,mBAAmB,aAAa,mBAAmB,gBAAgB;AAC/E;AAKO,MAAM,iBAAiB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AA0BO,MAAM,kBAAyD;AAAA,EACpE,iBAAiB;AAAA,IACf,aAAa;AAAA,IACb,QAAQ,CAAC,UAAU,SAAS;AAAA,IAC5B,aAAa,CAAC,QAAQ,MAAM;AAAA,IAC5B,MAAM;AAAA,EACR;AAAA,EACA,WAAW;AAAA,IACT,aAAa;AAAA,IACb,QAAQ,CAAC,SAAS;AAAA,IAClB,MAAM;AAAA,EACR;AAAA,EACA,iBAAiB;AAAA,IACf,aAAa;AAAA,IACb,QAAQ,CAAC,SAAS;AAAA,IAClB,MAAM;AAAA,EACR;AAAA,EACA,gBAAgB;AAAA,IACd,aAAa;AAAA,IACb,QAAQ,CAAC,SAAS;AAAA,IAClB,aAAa,CAAC,QAAQ,OAAO;AAAA,IAC7B,MAAM;AAAA,EACR;AAAA,EACA,kBAAkB;AAAA,IAChB,aAAa;AAAA,IACb,QAAQ,CAAC,QAAQ;AAAA,IACjB,MAAM;AAAA,EACR;AACF;AAUO,MAAM,iBAAgE;AAAA,EAC3E,iBAAiB,CAAC,MAAc,CAAC,QAAQ,MAAM,EAAE,SAAS,CAAC;AAAA,EAC3D,gBAAgB,CAAC,MAAc,CAAC,QAAQ,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC;AAC3E;AAUO,MAAM,gBAA8D;AAAA,EACzE,gBAAgB,CAAC,MAAc,EAAE,YAAY,MAAM;AACrD;AA+BO,SAAS,mBAAmB,KAAa,OAA6B;AAC3E,SAAO,WAAW,KAAK,EAAE,SAAS,GAAG;AACvC;AAKO,SAAS,aAAa,KAAuC;AAClE,SAAO,eAAe,GAAqB;AAC7C;AAKO,SAAS,UAAU,KAAsC;AAC9D,SAAO,cAAc,GAAqB;AAC5C;AAKO,SAAS,iBACd,KACA,OACqD;AAErD,QAAM,YAAY,aAAa,GAAG;AAClC,MAAI,aAAa,CAAC,UAAU,KAAK,GAAG;AAClC,UAAM,OAAO,gBAAgB,GAAqB;AAClD,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,OAAO,kBAAkB,KAAK,cAAc,GAAG,oBAAoB,MAAM,aAAa,KAAK,IAAI,CAAC;AAAA,IAClG;AAAA,EACF;AAGA,QAAM,SAAS,UAAU,GAAG;AAC5B,QAAM,SAAS,SAAS,OAAO,KAAK,IAAI;AAExC,SAAO,EAAE,QAAQ,OAAO,KAAK;AAC/B;","names":[]}

package/dist/cli/commands/debug/call.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Call Command Implementation
+ *
+ * Allows directly calling MCP tools with JSON arguments, useful for testing
+ * and debugging.
+ */
+import type { CallOptions } from './types.js';
+/**
+ * Call command implementation
+ *
+ * Directly calls an MCP tool with optional JSON arguments.
+ */
+export declare function callCommand(tool: string, options: CallOptions): Promise<void>;
+//# sourceMappingURL=call.d.ts.map

package/dist/cli/commands/debug/call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/debug/call.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAsD9C;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA+DnF"}

package/dist/cli/commands/debug/call.js

@@ -0,0 +1,96 @@
+import ora from "ora";
+import { resolveConfig } from "../../config/index.js";
+import { colors } from "../../ui/colors.js";
+import { ApiClient } from "../../../client/api-client.js";
+import { handleToolCall } from "../../../tools/index.js";
+function parseArgs(argsString) {
+  if (!argsString) {
+    return {};
+  }
+  try {
+    return JSON.parse(argsString);
+  } catch (error) {
+    throw new Error(
+      `Invalid JSON in --args. Example: --args='{"ticketId": "abc123"}'`
+    );
+  }
+}
+function formatToon(response) {
+  if (typeof response === "object" && response !== null) {
+    const lines = ["@response"];
+    const entries = Object.entries(response);
+    for (const [key, value] of entries) {
+      if (typeof value === "object" && value !== null) {
+        lines.push(`  ${key}: ${JSON.stringify(value)}`);
+      } else {
+        lines.push(`  ${key}: ${value}`);
+      }
+    }
+    return lines.join("\n");
+  }
+  return String(response);
+}
+function formatOutput(response, options) {
+  if (options.raw) {
+    return typeof response === "string" ? response : JSON.stringify(response);
+  }
+  if (options.format === "toon") {
+    return formatToon(response);
+  }
+  return JSON.stringify(response, null, 2);
+}
+async function callCommand(tool, options) {
+  if (!tool) {
+    console.error(colors.error("\nError: Tool name is required."));
+    console.error(`Usage: specforge call <tool> --args='{"key": "value"}'`);
+    process.exit(1);
+  }
+  const config = resolveConfig();
+  let args;
+  try {
+    args = parseArgs(options.args);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Invalid JSON";
+    console.error(colors.error(`
+Error: ${message}`));
+    process.exit(1);
+  }
+  const spinner = ora(`Calling ${tool}...`).start();
+  try {
+    if (!config.apiKey) {
+      spinner.fail("Not authenticated");
+      console.error(colors.error("\nError: Not authenticated."));
+      console.error(colors.muted("Run `specforge login` to authenticate first."));
+      process.exit(1);
+    }
+    const client = new ApiClient({
+      apiKey: config.apiKey,
+      apiUrl: config.apiUrl,
+      debug: config.debug
+    });
+    const response = await handleToolCall(client, tool, args, config.debug);
+    spinner.stop();
+    const output = formatOutput(response, options);
+    console.log(output);
+  } catch (error) {
+    spinner.fail(`Failed to call ${tool}`);
+    const message = error instanceof Error ? error.message : "Unknown error";
+    if (message.includes("Unknown tool") || message.includes("not found")) {
+      console.error(colors.error(`
+Error: Unknown tool "${tool}".`));
+      console.error(colors.muted("Run 'specforge tools' to see available tools."));
+    } else if (message.includes("required")) {
+      console.error(colors.error(`
+Error: ${message}`));
+      console.error(colors.muted("Check the tool requires specific arguments."));
+    } else {
+      console.error(colors.error(`
+Error: ${message}`));
+    }
+    process.exit(1);
+  }
+}
+export {
+  callCommand
+};
+//# sourceMappingURL=call.js.map