@specforge/mcp 2.0.9 → 2.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"tickets.types.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/tickets.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4BAA4B;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EAKxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAK5C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,oBAAoB;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uBAAuB;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oCAAoC;IACpC,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACrC;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,EAMnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAK1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAKtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAyB,GAAG,MAAM,CAKzF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,YAAY,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,cAAc,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAEpF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,EAAE,CAE1F"}

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

@@ -0,0 +1,138 @@
+/**
+ * Tickets Command Types
+ *
+ * Type definitions for the tickets list command.
+ */
+/**
+ * All valid ticket statuses
+ */
+export const VALID_STATUSES = [
+    'pending',
+    'in_progress',
+    'done',
+    'blocked',
+];
+/**
+ * All valid ticket priorities
+ */
+export const VALID_PRIORITIES = [
+    'critical',
+    'high',
+    'medium',
+    'low',
+];
+/**
+ * Default table columns for tickets
+ */
+export const TICKET_TABLE_COLUMNS = [
+    { header: '#', width: 6, align: 'right' },
+    { header: 'TITLE', width: 40 },
+    { header: 'PRIORITY', width: 10 },
+    { header: 'STATUS', width: 12 },
+    { header: 'BLOCKED', width: 8 },
+];
+/**
+ * Priority display colors (chalk color names)
+ */
+export const PRIORITY_COLORS = {
+    critical: 'red',
+    high: 'yellow',
+    medium: 'blue',
+    low: 'dim',
+};
+/**
+ * Status display colors (chalk color names)
+ */
+export const STATUS_COLORS = {
+    done: 'green',
+    in_progress: 'blue',
+    pending: 'yellow',
+    blocked: 'red',
+};
+/**
+ * Maximum title length for table display
+ */
+export const MAX_TITLE_LENGTH = 38;
+/**
+ * Ticket number padding width
+ */
+export const TICKET_NUMBER_WIDTH = 3;
+/**
+ * Format ticket number with leading zeros
+ *
+ * @param num Ticket number
+ * @returns Formatted ticket number (e.g., "001", "042")
+ */
+export function formatTicketNumber(num) {
+    return num.toString().padStart(TICKET_NUMBER_WIDTH, '0');
+}
+/**
+ * Truncate title if too long for display
+ *
+ * @param title Ticket title
+ * @param maxLength Maximum length (default: MAX_TITLE_LENGTH)
+ * @returns Truncated title with ellipsis if needed
+ */
+export function truncateTitle(title, maxLength = MAX_TITLE_LENGTH) {
+    if (title.length <= maxLength) {
+        return title;
+    }
+    return title.slice(0, maxLength - 3) + '...';
+}
+/**
+ * Check if a ticket is blocked
+ *
+ * @param ticket Ticket to check
+ * @returns True if ticket has blockers
+ */
+export function isTicketBlocked(ticket) {
+    return Array.isArray(ticket.blockedBy) && ticket.blockedBy.length > 0;
+}
+/**
+ * Validate status filter
+ *
+ * @param status Status to validate
+ * @returns True if valid status
+ */
+export function isValidStatus(status) {
+    return VALID_STATUSES.includes(status);
+}
+/**
+ * Validate priority filter
+ *
+ * @param priority Priority to validate
+ * @returns True if valid priority
+ */
+export function isValidPriority(priority) {
+    return VALID_PRIORITIES.includes(priority);
+}
+/**
+ * Get count of blocked tickets
+ *
+ * @param tickets Array of tickets
+ * @returns Number of blocked tickets
+ */
+export function countBlockedTickets(tickets) {
+    return tickets.filter(isTicketBlocked).length;
+}
+/**
+ * Get tickets by status
+ *
+ * @param tickets Array of tickets
+ * @param status Status to filter by
+ * @returns Filtered tickets
+ */
+export function getTicketsByStatus(tickets, status) {
+    return tickets.filter(t => t.status === status);
+}
+/**
+ * Get tickets by priority
+ *
+ * @param tickets Array of tickets
+ * @param priority Priority to filter by
+ * @returns Filtered tickets
+ */
+export function getTicketsByPriority(tickets, priority) {
+    return tickets.filter(t => t.priority === priority);
+}
+//# sourceMappingURL=tickets.types.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * CLI Configuration Module
+ *
+ * Provides configuration loading, writing, and path resolution
+ * for the SpecForge CLI.
+ */
+export * from './types.js';
+export * from './paths.js';
+export * from './loader.js';
+export * from './writer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/cli/config/index.js

@@ -0,0 +1,11 @@
+/**
+ * CLI Configuration Module
+ *
+ * Provides configuration loading, writing, and path resolution
+ * for the SpecForge CLI.
+ */
+export * from './types.js';
+export * from './paths.js';
+export * from './loader.js';
+export * from './writer.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1,98 @@
+/**
+ * Config Loader
+ *
+ * Loads and merges configuration from multiple sources with the following priority:
+ * 1. Environment variables (highest)
+ * 2. Project config (.specforge.json)
+ * 3. Global config (~/.specforge/config.json)
+ * 4. Default values (lowest)
+ */
+import { GlobalConfig, ProjectConfig, ResolvedConfig } from './types.js';
+/**
+ * Load global configuration from ~/.specforge/config.json
+ *
+ * @returns GlobalConfig object (empty object if file doesn't exist or is invalid)
+ *
+ * @example
+ * ```typescript
+ * const globalConfig = loadGlobalConfig();
+ * if (globalConfig.apiKey) {
+ *   console.log('API key found in global config');
+ * }
+ * ```
+ */
+export declare function loadGlobalConfig(): GlobalConfig;
+/**
+ * Load project configuration from .specforge.json
+ *
+ * Searches current directory and parent directories for .specforge.json.
+ *
+ * @returns ProjectConfig object if found, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const projectConfig = loadProjectConfig();
+ * if (projectConfig?.projectId) {
+ *   console.log('Project ID:', projectConfig.projectId);
+ * }
+ * ```
+ */
+export declare function loadProjectConfig(): ProjectConfig | null;
+/**
+ * Resolve final configuration from all sources
+ *
+ * Merges configuration with the following priority (highest to lowest):
+ * 1. Environment variables
+ * 2. Project config (.specforge.json)
+ * 3. Global config (~/.specforge/config.json)
+ * 4. Default values
+ *
+ * @returns ResolvedConfig with all values and source tracking
+ *
+ * @example
+ * ```typescript
+ * const config = resolveConfig();
+ * console.log('API Key from:', config.sources.apiKey); // 'env' | 'global' | null
+ * console.log('Format:', config.format); // 'json' | 'toon'
+ * ```
+ */
+export declare function resolveConfig(): ResolvedConfig;
+/**
+ * Check if user is authenticated (has API key configured)
+ *
+ * @returns true if API key is available from any source
+ *
+ * @example
+ * ```typescript
+ * if (!isAuthenticated()) {
+ *   console.error('Please run: specforge-mcp login');
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export declare function isAuthenticated(): boolean;
+/**
+ * Get API key if available
+ *
+ * @returns API key string or null if not configured
+ */
+export declare function getApiKey(): string | null;
+/**
+ * Check if running in a project context
+ *
+ * @returns true if a .specforge.json was found
+ */
+export declare function hasProjectContext(): boolean;
+/**
+ * Get current project ID if available
+ *
+ * @returns Project ID or null
+ */
+export declare function getProjectId(): string | null;
+/**
+ * Get current specification ID if available
+ *
+ * @returns Specification ID or null
+ */
+export declare function getSpecificationId(): string | null;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/cli/config/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EAKf,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CA2B/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,GAAG,IAAI,CA0BxD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,IAAI,cAAc,CA0E9C;AASD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAGzC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAGzC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAG5C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAGlD"}

package/dist/cli/config/loader.js

@@ -0,0 +1,237 @@
+/**
+ * Config Loader
+ *
+ * Loads and merges configuration from multiple sources with the following priority:
+ * 1. Environment variables (highest)
+ * 2. Project config (.specforge.json)
+ * 3. Global config (~/.specforge/config.json)
+ * 4. Default values (lowest)
+ */
+import fs from 'node:fs';
+import { CONFIG_DEFAULTS, CONFIG_ENV_VARS, } from './types.js';
+import { getGlobalConfigPath, findProjectConfigPath, } from './paths.js';
+/**
+ * Load global configuration from ~/.specforge/config.json
+ *
+ * @returns GlobalConfig object (empty object if file doesn't exist or is invalid)
+ *
+ * @example
+ * ```typescript
+ * const globalConfig = loadGlobalConfig();
+ * if (globalConfig.apiKey) {
+ *   console.log('API key found in global config');
+ * }
+ * ```
+ */
+export function loadGlobalConfig() {
+    const configPath = getGlobalConfigPath();
+    if (!fs.existsSync(configPath)) {
+        return {};
+    }
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        // Validate it's an object
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            console.warn(`Warning: ${configPath} is not a valid config object`);
+            return {};
+        }
+        return parsed;
+    }
+    catch (error) {
+        // Log warning but don't fail - return empty config for graceful degradation
+        if (error instanceof SyntaxError) {
+            console.warn(`Warning: Failed to parse ${configPath} - invalid JSON`);
+        }
+        else {
+            console.warn(`Warning: Failed to read ${configPath}`);
+        }
+        return {};
+    }
+}
+/**
+ * Load project configuration from .specforge.json
+ *
+ * Searches current directory and parent directories for .specforge.json.
+ *
+ * @returns ProjectConfig object if found, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const projectConfig = loadProjectConfig();
+ * if (projectConfig?.projectId) {
+ *   console.log('Project ID:', projectConfig.projectId);
+ * }
+ * ```
+ */
+export function loadProjectConfig() {
+    const configPath = findProjectConfigPath();
+    if (!configPath) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        // Validate it's an object
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            console.warn(`Warning: ${configPath} is not a valid config object`);
+            return null;
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            console.warn(`Warning: Failed to parse ${configPath} - invalid JSON`);
+        }
+        else {
+            console.warn(`Warning: Failed to read ${configPath}`);
+        }
+        return null;
+    }
+}
+/**
+ * Resolve final configuration from all sources
+ *
+ * Merges configuration with the following priority (highest to lowest):
+ * 1. Environment variables
+ * 2. Project config (.specforge.json)
+ * 3. Global config (~/.specforge/config.json)
+ * 4. Default values
+ *
+ * @returns ResolvedConfig with all values and source tracking
+ *
+ * @example
+ * ```typescript
+ * const config = resolveConfig();
+ * console.log('API Key from:', config.sources.apiKey); // 'env' | 'global' | null
+ * console.log('Format:', config.format); // 'json' | 'toon'
+ * ```
+ */
+export function resolveConfig() {
+    const globalConfig = loadGlobalConfig();
+    const projectConfig = loadProjectConfig();
+    // Initialize with defaults
+    const sources = {
+        apiKey: null,
+        projectId: null,
+        specificationId: null,
+        format: 'default',
+    };
+    const resolved = {
+        apiKey: null,
+        apiUrl: CONFIG_DEFAULTS.apiUrl,
+        format: CONFIG_DEFAULTS.format,
+        projectId: null,
+        specificationId: null,
+        autoSetContext: CONFIG_DEFAULTS.autoSetContext,
+        debug: CONFIG_DEFAULTS.debug,
+        sources,
+    };
+    // --- API Key: ENV > Global ---
+    if (process.env[CONFIG_ENV_VARS.API_KEY]) {
+        resolved.apiKey = process.env[CONFIG_ENV_VARS.API_KEY];
+        sources.apiKey = 'env';
+    }
+    else if (globalConfig.apiKey) {
+        resolved.apiKey = globalConfig.apiKey;
+        sources.apiKey = 'global';
+    }
+    // --- API URL: ENV > Default ---
+    if (process.env[CONFIG_ENV_VARS.API_URL]) {
+        resolved.apiUrl = process.env[CONFIG_ENV_VARS.API_URL];
+    }
+    // --- Debug: ENV only ---
+    resolved.debug = process.env[CONFIG_ENV_VARS.DEBUG] === 'true';
+    // --- Format: ENV > Project > Global > Default ---
+    const envFormat = process.env[CONFIG_ENV_VARS.FORMAT];
+    if (envFormat && isValidFormat(envFormat)) {
+        resolved.format = envFormat;
+        sources.format = 'env';
+    }
+    else if (projectConfig?.format && isValidFormat(projectConfig.format)) {
+        resolved.format = projectConfig.format;
+        sources.format = 'project';
+    }
+    else if (globalConfig.format && isValidFormat(globalConfig.format)) {
+        resolved.format = globalConfig.format;
+        sources.format = 'global';
+    }
+    // --- Project ID: Project > Global ---
+    if (projectConfig?.projectId) {
+        resolved.projectId = projectConfig.projectId;
+        sources.projectId = 'project';
+    }
+    else if (globalConfig.defaultProjectId) {
+        resolved.projectId = globalConfig.defaultProjectId;
+        sources.projectId = 'global';
+    }
+    // --- Specification ID: Project only ---
+    if (projectConfig?.specificationId) {
+        resolved.specificationId = projectConfig.specificationId;
+        sources.specificationId = 'project';
+    }
+    // --- Auto Set Context: Project > Default ---
+    if (projectConfig?.autoSetContext !== undefined) {
+        resolved.autoSetContext = projectConfig.autoSetContext;
+    }
+    return resolved;
+}
+/**
+ * Validate that a string is a valid output format
+ */
+function isValidFormat(format) {
+    return format === 'json' || format === 'toon';
+}
+/**
+ * Check if user is authenticated (has API key configured)
+ *
+ * @returns true if API key is available from any source
+ *
+ * @example
+ * ```typescript
+ * if (!isAuthenticated()) {
+ *   console.error('Please run: specforge-mcp login');
+ *   process.exit(1);
+ * }
+ * ```
+ */
+export function isAuthenticated() {
+    const config = resolveConfig();
+    return config.apiKey !== null;
+}
+/**
+ * Get API key if available
+ *
+ * @returns API key string or null if not configured
+ */
+export function getApiKey() {
+    const config = resolveConfig();
+    return config.apiKey;
+}
+/**
+ * Check if running in a project context
+ *
+ * @returns true if a .specforge.json was found
+ */
+export function hasProjectContext() {
+    return loadProjectConfig() !== null;
+}
+/**
+ * Get current project ID if available
+ *
+ * @returns Project ID or null
+ */
+export function getProjectId() {
+    const config = resolveConfig();
+    return config.projectId;
+}
+/**
+ * Get current specification ID if available
+ *
+ * @returns Specification ID or null
+ */
+export function getSpecificationId() {
+    const config = resolveConfig();
+    return config.specificationId;
+}
+//# sourceMappingURL=loader.js.map

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

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

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

@@ -0,0 +1,96 @@
+/**
+ * Config Paths Resolution
+ *
+ * Provides functions for resolving configuration file paths.
+ * Handles both global (~/.specforge/) and project-level (.specforge.json) paths.
+ */
+import { ConfigPaths } 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 declare function getConfigPaths(): ConfigPaths;
+/**
+ * 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 declare function getGlobalConfigDir(): string;
+/**
+ * Get the global configuration file path
+ *
+ * @returns Absolute path to ~/.specforge/config.json
+ */
+export declare function getGlobalConfigPath(): string;
+/**
+ * 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 declare function getProjectConfigPath(): string;
+/**
+ * Get the MCP configuration file path
+ *
+ * @returns Absolute path to .mcp.json in current directory
+ */
+export declare function getMcpConfigPath(): string;
+/**
+ * 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 declare function findProjectConfigPath(startDir?: string): string | 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 declare function findProjectRoot(): string | 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 declare function isWithinGlobalDir(targetPath: string): boolean;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/cli/config/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAS5C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBtE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAG/C;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAO7D"}