@braingrid/cli 0.0.2

package/dist/utils/jwt.js

@@ -0,0 +1,64 @@
+/**
+ * JWT utility functions
+ * Note: This is basic JWT decoding without signature verification
+ * The server validates the token signature when we make API calls
+ */
+/**
+ * Decode a JWT token to extract the payload
+ * Note: This does NOT verify the signature - that's the server's job
+ */
+export function decodeJWT(token) {
+    try {
+        // JWT format: header.payload.signature
+        const parts = token.split('.');
+        if (parts.length !== 3) {
+            return null;
+        }
+        // Decode the payload (base64url)
+        const payload = parts[1];
+        // Replace URL-safe characters with standard base64 characters
+        const base64 = payload.replace(/-/g, '+').replace(/_/g, '/');
+        // Add padding if necessary
+        const padded = base64 + '=='.substring(0, (4 - (base64.length % 4)) % 4);
+        const decoded = Buffer.from(padded, 'base64').toString('utf-8');
+        return JSON.parse(decoded);
+    }
+    catch {
+        // Invalid token format or JSON
+        return null;
+    }
+}
+/**
+ * Check if a JWT token is expired
+ */
+export function isJWTExpired(token) {
+    const payload = decodeJWT(token);
+    if (!payload || !payload.exp) {
+        // If we can't decode or no expiry, assume it's invalid
+        return true;
+    }
+    // exp is in seconds, Date.now() is in milliseconds
+    return Date.now() >= payload.exp * 1000;
+}
+/**
+ * Extract user information from JWT payload
+ */
+export function extractUserFromJWT(payload) {
+    return {
+        id: payload.sub || '',
+        email: payload.email || '',
+        // Try different naming conventions for first name
+        firstName: payload.firstName ||
+            payload.first_name ||
+            payload.given_name ||
+            (payload.name ? payload.name.split(' ')[0] : ''),
+        // Try different naming conventions for last name
+        lastName: payload.lastName ||
+            payload.last_name ||
+            payload.family_name ||
+            (payload.name ? payload.name.split(' ').slice(1).join(' ') : ''),
+        // Try different naming conventions for organization
+        organizationId: payload.organizationId || payload.organization_id || payload.org || 'default',
+    };
+}
+//# sourceMappingURL=jwt.js.map

package/dist/utils/jwt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../src/utils/jwt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACtC,IAAI,CAAC;QACJ,uCAAuC;QACvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACb,CAAC;QAED,iCAAiC;QACjC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,8DAA8D;QAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7D,2BAA2B;QAC3B,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAEzE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACR,+BAA+B;QAC/B,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACzC,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9B,uDAAuD;QACvD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,mDAAmD;IACnD,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAmB;IAOrD,OAAO;QACN,EAAE,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE;QACrB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,kDAAkD;QAClD,SAAS,EACR,OAAO,CAAC,SAAS;YACjB,OAAO,CAAC,UAAU;YAClB,OAAO,CAAC,UAAU;YAClB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,iDAAiD;QACjD,QAAQ,EACP,OAAO,CAAC,QAAQ;YAChB,OAAO,CAAC,SAAS;YACjB,OAAO,CAAC,WAAW;YACnB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,oDAAoD;QACpD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,IAAI,SAAS;KAC7F,CAAC;AACH,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,36 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type MessageType = 'user' | 'system' | 'error' | 'info' | 'debug';
+interface LoggerConfig {
+    logToFile: boolean;
+    logLevel: LogLevel;
+    logFilePath?: string;
+    maxFileSize: number;
+    maxFiles: number;
+    consoleOutput: boolean;
+}
+declare class Logger {
+    private config;
+    private logFilePath;
+    constructor(config?: Partial<LoggerConfig>);
+    private ensureLogDirectory;
+    private shouldLog;
+    private formatLogEntry;
+    private writeToFile;
+    private rotateLogFile;
+    private log;
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    userMessage(message: string, context?: Record<string, unknown>): void;
+    systemMessage(message: string, context?: Record<string, unknown>): void;
+    streamOutput(message: string, isError?: boolean): void;
+    updateConfig(newConfig: Partial<LoggerConfig>): void;
+    getLogFilePath(): string;
+    getLogFileSize(): number;
+    clearLogFile(): void;
+}
+export declare function getLogger(config?: Partial<LoggerConfig>): Logger;
+export declare function initializeLogger(config: Partial<LoggerConfig>): Logger;
+export { Logger };
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAC3D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAUzE,UAAU,YAAY;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACvB;AAED,cAAM,MAAM;IACX,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAmB9C,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,GAAG;IA2BX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIrE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKvE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,IAAI;IAKpD,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAapD,cAAc,IAAI,MAAM;IAKxB,cAAc,IAAI,MAAM;IAaxB,YAAY,IAAI,IAAI;CAUpB;AAKD,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAKhE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAGtE;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,176 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+class Logger {
+    constructor(config = {}) {
+        const isDebugMode = process.env.DEBUG === 'true';
+        this.config = {
+            logToFile: false,
+            logLevel: isDebugMode ? 'debug' : 'info', // Set log level to debug when DEBUG=true
+            maxFileSize: 10 * 1024 * 1024, // 10MB
+            maxFiles: 5,
+            consoleOutput: isDebugMode, // Enable console output when DEBUG=true
+            ...config,
+        };
+        this.logFilePath =
+            this.config.logFilePath || path.join(os.homedir(), '.braingrid', 'logs', 'braingrid-cli.log');
+        if (this.config.logToFile) {
+            this.ensureLogDirectory();
+        }
+    }
+    ensureLogDirectory() {
+        const logDir = path.dirname(this.logFilePath);
+        if (!fs.existsSync(logDir)) {
+            fs.mkdirSync(logDir, { recursive: true });
+        }
+    }
+    shouldLog(level) {
+        const levels = ['debug', 'info', 'warn', 'error'];
+        return levels.indexOf(level) >= levels.indexOf(this.config.logLevel);
+    }
+    formatLogEntry(entry) {
+        const timestamp = entry.timestamp.toISOString();
+        const level = entry.level.toUpperCase().padEnd(5);
+        const type = entry.type.toUpperCase().padEnd(7);
+        const contextStr = entry.context ? ` | ${JSON.stringify(entry.context)}` : '';
+        return `[${timestamp}] ${level} [${type}] ${entry.message}${contextStr}`;
+    }
+    writeToFile(entry) {
+        if (!this.config.logToFile)
+            return;
+        try {
+            const logLine = this.formatLogEntry(entry) + '\n';
+            // Check file size and rotate if necessary
+            if (fs.existsSync(this.logFilePath)) {
+                const stats = fs.statSync(this.logFilePath);
+                if (stats.size > this.config.maxFileSize) {
+                    this.rotateLogFile();
+                }
+            }
+            fs.appendFileSync(this.logFilePath, logLine);
+        }
+        catch (error) {
+            console.error('Failed to write to log file:', error);
+        }
+    }
+    rotateLogFile() {
+        try {
+            // Rotate log files
+            for (let i = this.config.maxFiles - 1; i >= 1; i--) {
+                const oldFile = `${this.logFilePath}.${i}`;
+                const newFile = `${this.logFilePath}.${i + 1}`;
+                if (fs.existsSync(oldFile)) {
+                    if (i === this.config.maxFiles - 1) {
+                        fs.unlinkSync(oldFile); // Delete oldest file
+                    }
+                    else {
+                        fs.renameSync(oldFile, newFile);
+                    }
+                }
+            }
+            // Move current log to .1
+            if (fs.existsSync(this.logFilePath)) {
+                fs.renameSync(this.logFilePath, `${this.logFilePath}.1`);
+            }
+        }
+        catch (error) {
+            console.error('Failed to rotate log file:', error);
+        }
+    }
+    log(level, type, message, context) {
+        if (!this.shouldLog(level))
+            return;
+        const entry = {
+            timestamp: new Date(),
+            level,
+            type,
+            message,
+            context,
+        };
+        // Write to file if enabled
+        this.writeToFile(entry);
+        // Write to console if enabled and it's a debug message
+        if (this.config.consoleOutput && level === 'debug') {
+            const contextStr = context ? ` ${JSON.stringify(context)}` : '';
+            // Write to stderr so it doesn't interfere with CLI output
+            console.error(`${message}${contextStr}`);
+        }
+    }
+    debug(message, context) {
+        this.log('debug', 'debug', message, context);
+    }
+    info(message, context) {
+        this.log('info', 'info', message, context);
+    }
+    warn(message, context) {
+        this.log('warn', 'info', message, context);
+    }
+    error(message, context) {
+        this.log('error', 'error', message, context);
+    }
+    userMessage(message, context) {
+        this.log('info', 'user', message, context);
+    }
+    systemMessage(message, context) {
+        this.log('info', 'system', message, context);
+    }
+    // Log streaming output with full content
+    streamOutput(message, isError = false) {
+        this.log(isError ? 'error' : 'info', isError ? 'error' : 'system', message);
+    }
+    // Update configuration
+    updateConfig(newConfig) {
+        const wasLoggingToFile = this.config.logToFile;
+        this.config = { ...this.config, ...newConfig };
+        if (this.config.logToFile && !wasLoggingToFile) {
+            this.ensureLogDirectory();
+            this.info('File logging enabled', { logFilePath: this.logFilePath });
+        }
+        else if (!this.config.logToFile && wasLoggingToFile) {
+            this.info('File logging disabled');
+        }
+    }
+    // Get current log file path
+    getLogFilePath() {
+        return this.logFilePath;
+    }
+    // Get log file size in MB
+    getLogFileSize() {
+        try {
+            if (fs.existsSync(this.logFilePath)) {
+                const stats = fs.statSync(this.logFilePath);
+                return stats.size / (1024 * 1024);
+            }
+            return 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+    // Clear log file
+    clearLogFile() {
+        try {
+            if (fs.existsSync(this.logFilePath)) {
+                fs.unlinkSync(this.logFilePath);
+                this.info('Log file cleared');
+            }
+        }
+        catch (error) {
+            console.error('Failed to clear log file:', error);
+        }
+    }
+}
+// Create singleton logger instance
+let loggerInstance = null;
+export function getLogger(config) {
+    if (!loggerInstance) {
+        loggerInstance = new Logger(config);
+    }
+    return loggerInstance;
+}
+export function initializeLogger(config) {
+    loggerInstance = new Logger(config);
+    return loggerInstance;
+}
+export { Logger };
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/requirements.d.ts

@@ -0,0 +1,28 @@
+import { Requirement } from '../types/requirement.js';
+/**
+ * Format a requirement with friendly REQ-<number> format
+ * Note: short_id already contains "REQ-123" format
+ */
+export declare function formatRequirementId(requirement: Requirement): string;
+/**
+ * Parse a requirement ID from various formats:
+ * - "REQ-123" -> { type: 'req_id', value: 123 }
+ * - "123" -> { type: 'req_id', value: 123 }
+ * - "uuid-string" -> { type: 'uuid', value: 'uuid-string' }
+ */
+export declare function parseRequirementId(input: string): {
+    type: 'req_id' | 'uuid';
+    value: string | number;
+};
+/**
+ * Find a requirement by either req_id or UUID
+ */
+export declare function findRequirementById(requirements: Requirement[], identifier: string): Requirement | undefined;
+/**
+ * Get query parameters for API calls based on identifier type
+ * Note: API doesn't support req_id parameter, so we only return id for UUIDs
+ */
+export declare function getRequirementQueryParams(identifier: string): {
+    id?: string;
+};
+//# sourceMappingURL=requirements.d.ts.map

package/dist/utils/requirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../../src/utils/requirements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;IAClD,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB,CAeA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,YAAY,EAAE,WAAW,EAAE,EAC3B,UAAU,EAAE,MAAM,GAChB,WAAW,GAAG,SAAS,CAQzB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAS7E"}

package/dist/utils/requirements.js

@@ -0,0 +1,54 @@
+/**
+ * Format a requirement with friendly REQ-<number> format
+ * Note: short_id already contains "REQ-123" format
+ */
+export function formatRequirementId(requirement) {
+    return requirement.short_id || `REQ-${requirement.req_id || 0}`;
+}
+/**
+ * Parse a requirement ID from various formats:
+ * - "REQ-123" -> { type: 'req_id', value: 123 }
+ * - "123" -> { type: 'req_id', value: 123 }
+ * - "uuid-string" -> { type: 'uuid', value: 'uuid-string' }
+ */
+export function parseRequirementId(input) {
+    // Handle REQ-123 format
+    const reqMatch = input.match(/^REQ-(\d+)$/i);
+    if (reqMatch) {
+        return { type: 'req_id', value: parseInt(reqMatch[1], 10) };
+    }
+    // Handle plain number format
+    const numberMatch = input.match(/^\d+$/);
+    if (numberMatch) {
+        return { type: 'req_id', value: parseInt(input, 10) };
+    }
+    // Assume it's a UUID
+    return { type: 'uuid', value: input };
+}
+/**
+ * Find a requirement by either req_id or UUID
+ */
+export function findRequirementById(requirements, identifier) {
+    const parsed = parseRequirementId(identifier);
+    if (parsed.type === 'req_id') {
+        return requirements.find(req => req.short_id === `REQ-${parsed.value}`);
+    }
+    else {
+        return requirements.find(req => req.id === parsed.value);
+    }
+}
+/**
+ * Get query parameters for API calls based on identifier type
+ * Note: API doesn't support req_id parameter, so we only return id for UUIDs
+ */
+export function getRequirementQueryParams(identifier) {
+    const parsed = parseRequirementId(identifier);
+    if (parsed.type === 'uuid') {
+        return { id: parsed.value };
+    }
+    else {
+        // For req_id, we'll need to search differently
+        return {};
+    }
+}
+//# sourceMappingURL=requirements.js.map

package/dist/utils/requirements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.js","sourceRoot":"","sources":["../../src/utils/requirements.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAwB;IAC3D,OAAO,WAAW,CAAC,QAAQ,IAAI,OAAO,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAI/C,wBAAwB;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC7C,IAAI,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC7D,CAAC;IAED,6BAA6B;IAC7B,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,qBAAqB;IACrB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAClC,YAA2B,EAC3B,UAAkB;IAElB,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;SAAM,CAAC;QACP,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC3D,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAe,EAAE,CAAC;IACvC,CAAC;SAAM,CAAC;QACP,+CAA+C;QAC/C,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC"}

package/dist/utils/status-parser.d.ts

@@ -0,0 +1,95 @@
+import type { RequirementStatus } from '../types/requirement.js';
+import type { TaskStatus } from '../types/task.js';
+export type Status = RequirementStatus | TaskStatus;
+/**
+ * Maps natural language keywords to Status enum values
+ */
+export declare const StatusKeywordMap: Record<string, Status>;
+/**
+ * Result of status parsing operation
+ */
+export interface StatusParsingResult {
+    /**
+     * Successfully parsed status values
+     */
+    statuses: Status[];
+    /**
+     * Invalid keywords that couldn't be parsed
+     */
+    invalid: string[];
+    /**
+     * Whether parsing encountered any errors
+     */
+    hasErrors: boolean;
+    /**
+     * Error message if any invalid keywords were found
+     */
+    errorMessage?: string;
+}
+/**
+ * Parses a comma-separated string of status keywords into Status values
+ *
+ * @param input - Comma-separated status keywords (e.g., "todo,doing" or "done")
+ * @returns Array of Status values
+ *
+ * @example
+ * parseStatusKeywords("todo,doing") // Returns ["PLANNED", "IN_PROGRESS"]
+ * parseStatusKeywords("done") // Returns ["COMPLETED"]
+ * parseStatusKeywords("") // Returns [] (all statuses)
+ */
+export declare function parseStatusKeywords(input: string): Status[];
+/**
+ * Validates status keywords and returns both valid and invalid ones
+ *
+ * @param keywords - Array of status keywords to validate
+ * @returns Object containing valid statuses and invalid keywords
+ *
+ * @example
+ * validateStatusKeywords(["todo", "invalid"])
+ * // Returns { valid: ["PLANNED"], invalid: ["invalid"] }
+ */
+export declare function validateStatusKeywords(keywords: string[]): {
+    valid: Status[];
+    invalid: string[];
+};
+/**
+ * Formats an error message for invalid status keywords
+ *
+ * @param invalidKeywords - Array of invalid keywords
+ * @returns Formatted error message with suggestions
+ *
+ * @example
+ * formatStatusError(["invalid", "unknown"])
+ * // Returns detailed error message with valid keyword suggestions
+ */
+export declare function formatStatusError(invalidKeywords: string[]): string;
+/**
+ * Parses and validates status keywords, returning a complete result
+ *
+ * @param input - Comma-separated status keywords
+ * @returns StatusParsingResult with parsed statuses and any errors
+ *
+ * @example
+ * parseAndValidateStatus("todo,invalid")
+ * // Returns {
+ * //   statuses: ["PLANNED"],
+ * //   invalid: ["invalid"],
+ * //   hasErrors: true,
+ * //   errorMessage: "Invalid status keyword: \"invalid\"..."
+ * // }
+ */
+export declare function parseAndValidateStatus(input: string): StatusParsingResult;
+/**
+ * Gets all valid status keywords grouped by their Status value
+ *
+ * @returns Object mapping Status to array of keywords
+ */
+export declare function getStatusKeywordsByValue(): Record<Status, string[]>;
+/**
+ * Checks if a given string is a valid status keyword
+ *
+ * @param keyword - The keyword to check
+ * @returns true if the keyword is valid, false otherwise
+ */
+export declare function isValidStatusKeyword(keyword: string): boolean;
+//# sourceMappingURL=status-parser.d.ts.map

package/dist/utils/status-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-parser.d.ts","sourceRoot":"","sources":["../../src/utils/status-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,MAAM,MAAM,MAAM,GAAG,iBAAiB,GAAG,UAAU,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+BnD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA4B3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAoBjG;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM,CAkBnE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAgCzE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAWnE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE7D"}