@specforge/mcp 2.0.9 → 2.1.0

package/dist/cli/config/paths.js

@@ -0,0 +1,140 @@
+/**
+ * Config Paths Resolution
+ *
+ * Provides functions for resolving configuration file paths.
+ * Handles both global (~/.specforge/) and project-level (.specforge.json) paths.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { CONFIG_FILES } from './types.js';
+/**
+ * Get all configuration file paths
+ *
+ * @returns ConfigPaths object with all resolved paths
+ *
+ * @example
+ * ```typescript
+ * const paths = getConfigPaths();
+ * console.log(paths.globalDir);    // /home/user/.specforge
+ * console.log(paths.globalConfig); // /home/user/.specforge/config.json
+ * console.log(paths.projectConfig); // /current/dir/.specforge.json
+ * ```
+ */
+export function getConfigPaths() {
+    const globalDir = getGlobalConfigDir();
+    return {
+        globalDir,
+        globalConfig: path.join(globalDir, CONFIG_FILES.GLOBAL_CONFIG),
+        projectConfig: path.resolve(CONFIG_FILES.PROJECT_CONFIG),
+        mcpConfig: path.resolve(CONFIG_FILES.MCP_CONFIG),
+    };
+}
+/**
+ * Get the global configuration directory path
+ *
+ * Uses $HOME/.specforge on all platforms.
+ * Does not create the directory - that's handled by the writer.
+ *
+ * @returns Absolute path to global config directory
+ *
+ * @example
+ * ```typescript
+ * const dir = getGlobalConfigDir();
+ * // Linux/macOS: /home/user/.specforge
+ * // Windows: C:\Users\user\.specforge
+ * ```
+ */
+export function getGlobalConfigDir() {
+    return path.join(os.homedir(), CONFIG_FILES.GLOBAL_DIR);
+}
+/**
+ * Get the global configuration file path
+ *
+ * @returns Absolute path to ~/.specforge/config.json
+ */
+export function getGlobalConfigPath() {
+    return path.join(getGlobalConfigDir(), CONFIG_FILES.GLOBAL_CONFIG);
+}
+/**
+ * Get the project configuration file path
+ *
+ * Resolves to .specforge.json in the current working directory.
+ * Note: This returns the path in CWD only - for searching up the
+ * directory tree, use findProjectConfigPath().
+ *
+ * @returns Absolute path to .specforge.json in current directory
+ */
+export function getProjectConfigPath() {
+    return path.resolve(CONFIG_FILES.PROJECT_CONFIG);
+}
+/**
+ * Get the MCP configuration file path
+ *
+ * @returns Absolute path to .mcp.json in current directory
+ */
+export function getMcpConfigPath() {
+    return path.resolve(CONFIG_FILES.MCP_CONFIG);
+}
+/**
+ * Find project config by searching up the directory tree
+ *
+ * Starts from the current directory and walks up to the filesystem root,
+ * looking for .specforge.json at each level.
+ *
+ * @param startDir - Directory to start searching from (defaults to cwd)
+ * @returns Absolute path to .specforge.json if found, null otherwise
+ *
+ * @example
+ * ```typescript
+ * // Given: /home/user/projects/myapp/src/components
+ * // With .specforge.json at /home/user/projects/myapp/.specforge.json
+ *
+ * const configPath = findProjectConfigPath();
+ * // Returns: /home/user/projects/myapp/.specforge.json
+ * ```
+ */
+export function findProjectConfigPath(startDir) {
+    let currentDir = startDir ? path.resolve(startDir) : process.cwd();
+    const root = path.parse(currentDir).root;
+    while (currentDir !== root) {
+        const configPath = path.join(currentDir, CONFIG_FILES.PROJECT_CONFIG);
+        if (fs.existsSync(configPath)) {
+            return configPath;
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    // Check root directory as well
+    const rootConfig = path.join(root, CONFIG_FILES.PROJECT_CONFIG);
+    if (fs.existsSync(rootConfig)) {
+        return rootConfig;
+    }
+    return null;
+}
+/**
+ * Get the directory containing the project config
+ *
+ * Useful for resolving relative paths from the project root.
+ *
+ * @returns Directory path if project config found, null otherwise
+ */
+export function findProjectRoot() {
+    const configPath = findProjectConfigPath();
+    return configPath ? path.dirname(configPath) : null;
+}
+/**
+ * Check if a path is within the global config directory
+ *
+ * Security check to prevent path traversal attacks.
+ *
+ * @param targetPath - Path to check
+ * @returns true if path is within ~/.specforge/
+ */
+export function isWithinGlobalDir(targetPath) {
+    const globalDir = getGlobalConfigDir();
+    const resolved = path.resolve(targetPath);
+    const relative = path.relative(globalDir, resolved);
+    // If the relative path starts with '..' or is absolute, it's outside
+    return !relative.startsWith('..') && !path.isAbsolute(relative);
+}
+//# sourceMappingURL=paths.js.map

package/dist/cli/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/cli/config/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IAEvC,OAAO;QACL,SAAS;QACT,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,aAAa,CAAC;QAC9D,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC;QACxD,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC;KACjD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAiB;IACrD,IAAI,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACnE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;IAEzC,OAAO,UAAU,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;QAEtE,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,+BAA+B;IAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IAChE,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,UAAU,GAAG,qBAAqB,EAAE,CAAC;IAC3C,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEpD,qEAAqE;IACrE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AAClE,CAAC"}

package/dist/cli/config/types.d.ts

@@ -0,0 +1,148 @@
+/**
+ * CLI Configuration Types
+ *
+ * Defines interfaces for global, project, and resolved configuration
+ * used throughout the CLI application.
+ */
+/**
+ * Output format options for CLI commands
+ */
+export type OutputFormat = 'json' | 'toon';
+/**
+ * Source tracking for configuration values
+ * Used for diagnostics and debugging (e.g., `specforge-mcp doctor`)
+ */
+export type ConfigSource = 'env' | 'global' | 'project' | 'default' | null;
+/**
+ * Global configuration stored in ~/.specforge/config.json
+ *
+ * This file contains user-level settings that apply across all projects.
+ * The API key is stored here for security (not in project files).
+ *
+ * @example
+ * ```json
+ * {
+ *   "apiKey": "sf_live_abc123...",
+ *   "format": "toon",
+ *   "defaultProjectId": "proj_xyz"
+ * }
+ * ```
+ */
+export interface GlobalConfig {
+    /** API key for SpecForge authentication (format: sf_live_*) */
+    apiKey?: string;
+    /** Default output format for CLI commands */
+    format?: OutputFormat;
+    /** Default project ID when not in a project directory */
+    defaultProjectId?: string;
+}
+/**
+ * Project configuration stored in .specforge.json
+ *
+ * This file is created in the project root when running `specforge-mcp init`.
+ * It links the local directory to a SpecForge project and specification.
+ *
+ * @example
+ * ```json
+ * {
+ *   "projectId": "proj_abc123",
+ *   "specificationId": "spec_xyz789",
+ *   "format": "json",
+ *   "autoSetContext": true
+ * }
+ * ```
+ */
+export interface ProjectConfig {
+    /** SpecForge project ID this directory is linked to */
+    projectId?: string;
+    /** Active specification ID for this project */
+    specificationId?: string;
+    /** Output format override for this project */
+    format?: OutputFormat;
+    /** Automatically set working context when CLI runs */
+    autoSetContext?: boolean;
+}
+/**
+ * Resolved configuration merged from all sources
+ *
+ * This is the final configuration used by CLI commands after merging:
+ * - Environment variables (highest priority)
+ * - Project config (.specforge.json)
+ * - Global config (~/.specforge/config.json)
+ * - Default values (lowest priority)
+ */
+export interface ResolvedConfig {
+    /** API key for authentication (null if not authenticated) */
+    apiKey: string | null;
+    /** API endpoint URL */
+    apiUrl: string;
+    /** Output format for CLI commands */
+    format: OutputFormat;
+    /** Current project ID (null if not in project context) */
+    projectId: string | null;
+    /** Current specification ID (null if not set) */
+    specificationId: string | null;
+    /** Whether to auto-set working context */
+    autoSetContext: boolean;
+    /** Debug mode enabled */
+    debug: boolean;
+    /**
+     * Source tracking for each config value
+     * Useful for diagnostics and understanding where values come from
+     */
+    sources: ConfigSources;
+}
+/**
+ * Tracks the source of each resolved configuration value
+ */
+export interface ConfigSources {
+    /** Where the API key was loaded from */
+    apiKey: 'env' | 'global' | null;
+    /** Where the project ID was loaded from */
+    projectId: 'env' | 'project' | 'global' | null;
+    /** Where the specification ID was loaded from */
+    specificationId: 'project' | null;
+    /** Where the format setting was loaded from */
+    format: 'env' | 'project' | 'global' | 'default';
+}
+/**
+ * Configuration file paths used by the CLI
+ */
+export interface ConfigPaths {
+    /** Global config directory (~/.specforge/) */
+    globalDir: string;
+    /** Global config file (~/.specforge/config.json) */
+    globalConfig: string;
+    /** Project config file (./.specforge.json) */
+    projectConfig: string;
+    /** MCP config file for Claude Code (./.mcp.json) */
+    mcpConfig: string;
+}
+/**
+ * Default configuration values
+ */
+export declare const CONFIG_DEFAULTS: {
+    readonly apiUrl: "https://mcp.specforge.com.br/mcp";
+    readonly format: OutputFormat;
+    readonly autoSetContext: true;
+    readonly debug: false;
+};
+/**
+ * Environment variable names for configuration
+ */
+export declare const CONFIG_ENV_VARS: {
+    readonly API_KEY: "SPECFORGE_API_KEY";
+    readonly API_URL: "SPECFORGE_API_URL";
+    readonly FORMAT: "SPECFORGE_FORMAT";
+    readonly DEBUG: "SPECFORGE_DEBUG";
+};
+/**
+ * Configuration file names
+ */
+export declare const CONFIG_FILES: {
+    readonly GLOBAL_DIR: ".specforge";
+    readonly GLOBAL_CONFIG: "config.json";
+    readonly PROJECT_CONFIG: ".specforge.json";
+    readonly MCP_CONFIG: ".mcp.json";
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/config/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;AAE3E;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB,sDAAsD;IACtD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IAEf,qCAAqC;IACrC,MAAM,EAAE,YAAY,CAAC;IAErB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,iDAAiD;IACjD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,0CAA0C;IAC1C,cAAc,EAAE,OAAO,CAAC;IAExB,yBAAyB;IACzB,KAAK,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;IAEhC,2CAA2C;IAC3C,SAAS,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC;IAE/C,iDAAiD;IACjD,eAAe,EAAE,SAAS,GAAG,IAAI,CAAC;IAElC,+CAA+C;IAC/C,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAElB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IAErB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IAEtB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;qBAER,YAAY;;;CAGtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;CAKf,CAAC"}

package/dist/cli/config/types.js

@@ -0,0 +1,34 @@
+/**
+ * CLI Configuration Types
+ *
+ * Defines interfaces for global, project, and resolved configuration
+ * used throughout the CLI application.
+ */
+/**
+ * Default configuration values
+ */
+export const CONFIG_DEFAULTS = {
+    apiUrl: 'https://mcp.specforge.com.br/mcp',
+    format: 'toon',
+    autoSetContext: true,
+    debug: false,
+};
+/**
+ * Environment variable names for configuration
+ */
+export const CONFIG_ENV_VARS = {
+    API_KEY: 'SPECFORGE_API_KEY',
+    API_URL: 'SPECFORGE_API_URL',
+    FORMAT: 'SPECFORGE_FORMAT',
+    DEBUG: 'SPECFORGE_DEBUG',
+};
+/**
+ * Configuration file names
+ */
+export const CONFIG_FILES = {
+    GLOBAL_DIR: '.specforge',
+    GLOBAL_CONFIG: 'config.json',
+    PROJECT_CONFIG: '.specforge.json',
+    MCP_CONFIG: '.mcp.json',
+};
+//# sourceMappingURL=types.js.map

package/dist/cli/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/config/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6IH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,kCAAkC;IAC1C,MAAM,EAAE,MAAsB;IAC9B,cAAc,EAAE,IAAI;IACpB,KAAK,EAAE,KAAK;CACJ,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,mBAAmB;IAC5B,MAAM,EAAE,kBAAkB;IAC1B,KAAK,EAAE,iBAAiB;CAChB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,UAAU,EAAE,YAAY;IACxB,aAAa,EAAE,aAAa;IAC5B,cAAc,EAAE,iBAAiB;IACjC,UAAU,EAAE,WAAW;CACf,CAAC"}

package/dist/cli/config/writer.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Config Writer
+ *
+ * Provides safe config file writing with atomic operations and proper permissions.
+ *
+ * Security features:
+ * - Global config (contains API key) written with mode 0600 (owner read/write only)
+ * - Global directory created with mode 0700 (owner access only)
+ * - Project config written with standard permissions (0644)
+ * - Path validation to prevent writes outside allowed directories
+ */
+import { GlobalConfig, ProjectConfig } from './types.js';
+/**
+ * Ensure global config directory exists with secure permissions
+ *
+ * Creates ~/.specforge/ if it doesn't exist, with mode 0700 (owner-only access).
+ * Idempotent - safe to call multiple times.
+ *
+ * @throws Error if directory creation fails
+ *
+ * @example
+ * ```typescript
+ * ensureGlobalDir();
+ * // ~/.specforge/ now exists with drwx------ permissions
+ * ```
+ */
+export declare function ensureGlobalDir(): void;
+/**
+ * Save global configuration
+ *
+ * Merges the provided config with existing global config and writes to
+ * ~/.specforge/config.json with secure permissions (0600).
+ *
+ * Undefined values are removed from the final config.
+ *
+ * @param config - Partial global config to save
+ * @throws Error if write fails
+ *
+ * @example
+ * ```typescript
+ * // Save API key
+ * saveGlobalConfig({ apiKey: 'sf_live_...' });
+ *
+ * // Update format, keeping existing apiKey
+ * saveGlobalConfig({ format: 'json' });
+ * ```
+ */
+export declare function saveGlobalConfig(config: Partial<GlobalConfig>): void;
+/**
+ * Delete a field from global config
+ *
+ * Loads existing config, removes the specified field, and saves.
+ * No-op if the field doesn't exist.
+ *
+ * @param field - Field name to remove
+ * @throws Error if read/write fails
+ *
+ * @example
+ * ```typescript
+ * deleteGlobalConfigField('apiKey');
+ * deleteGlobalConfigField('defaultProjectId');
+ * ```
+ */
+export declare function deleteGlobalConfigField(field: keyof GlobalConfig): void;
+/**
+ * Save project configuration
+ *
+ * Merges the provided config with existing project config and writes to
+ * .specforge.json in the current directory.
+ *
+ * Undefined values are removed from the final config.
+ *
+ * @param config - Partial project config to save
+ * @param targetDir - Directory to write .specforge.json to (defaults to cwd)
+ * @throws Error if write fails
+ *
+ * @example
+ * ```typescript
+ * // Initialize project
+ * saveProjectConfig({
+ *   projectId: 'proj_123',
+ *   specificationId: 'spec_456',
+ * });
+ *
+ * // Update format setting
+ * saveProjectConfig({ format: 'json' });
+ * ```
+ */
+export declare function saveProjectConfig(config: Partial<ProjectConfig>, targetDir?: string): void;
+/**
+ * Generate MCP configuration for Claude Code integration
+ *
+ * Creates a .mcp.json configuration that registers the SpecForge MCP server
+ * for Claude Code. The server is registered under the @specforge/mcp
+ * package name.
+ *
+ * @returns MCP config object
+ *
+ * @example
+ * ```typescript
+ * const mcpConfig = generateMcpConfig();
+ * console.log(mcpConfig.mcpServers['@specforge/mcp']);
+ * // { command: 'npx', args: [...] }
+ * ```
+ */
+export declare function generateMcpConfig(): {
+    mcpServers: {
+        '@specforge/mcp': {
+            command: string;
+            args: string[];
+        };
+    };
+};
+/**
+ * Save MCP configuration file
+ *
+ * Writes .mcp.json to the current directory (or specified directory)
+ * to enable Claude Code integration with the SpecForge MCP server.
+ *
+ * @param targetDir - Directory to write .mcp.json to (defaults to cwd)
+ * @throws Error if write fails
+ *
+ * @example
+ * ```typescript
+ * saveMcpConfig();
+ * // .mcp.json created in current directory
+ * ```
+ */
+export declare function saveMcpConfig(targetDir?: string): void;
+/**
+ * Add an entry to .gitignore if it exists
+ *
+ * Does not create .gitignore if it doesn't exist.
+ * Does not duplicate existing entries.
+ *
+ * @param entry - Line to add to .gitignore
+ * @param targetDir - Directory containing .gitignore (defaults to cwd)
+ * @returns true if entry was added, false if already exists or no .gitignore
+ *
+ * @example
+ * ```typescript
+ * const added = addToGitignore('.specforge.json');
+ * if (added) {
+ *   console.log('Added .specforge.json to .gitignore');
+ * }
+ * ```
+ */
+export declare function addToGitignore(entry: string, targetDir?: string): boolean;
+/**
+ * Remove API key from global config (logout)
+ *
+ * @example
+ * ```typescript
+ * clearApiKey();
+ * console.log('Logged out successfully');
+ * ```
+ */
+export declare function clearApiKey(): void;
+/**
+ * Check if global config file exists
+ *
+ * @returns true if ~/.specforge/config.json exists
+ */
+export declare function hasGlobalConfig(): boolean;
+/**
+ * Check if project config file exists in cwd
+ *
+ * @returns true if .specforge.json exists
+ */
+export declare function hasProjectConfig(): boolean;
+//# sourceMappingURL=writer.d.ts.map

package/dist/cli/config/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/cli/config/writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EACL,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AAsBpB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAetC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAgCpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,YAAY,GAAG,IAAI,CAuBvE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,EAC9B,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAgCN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB;;;;;;;EAShC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAetD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAiCzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}