rafcode 1.0.0

package/dist/ui/project-picker.js

@@ -0,0 +1,58 @@
+import { select } from '@inquirer/prompts';
+import { discoverProjects, deriveProjectState, getDerivedStats } from '../core/state-derivation.js';
+import { extractProjectNumber, formatProjectNumber } from '../utils/paths.js';
+/**
+ * Get all projects that have pending tasks (not fully completed).
+ * Returns projects sorted by number (oldest first).
+ */
+export function getPendingProjects(rafDir) {
+    const allProjects = discoverProjects(rafDir);
+    const pendingProjects = [];
+    for (const project of allProjects) {
+        const state = deriveProjectState(project.path);
+        const stats = getDerivedStats(state);
+        // Include projects that are not fully completed (have pending or failed tasks)
+        if (stats.pending > 0 || stats.failed > 0) {
+            const projectNumber = extractProjectNumber(project.path);
+            const formattedNumber = projectNumber ?? formatProjectNumber(project.number);
+            pendingProjects.push({
+                folder: `${formattedNumber}-${project.name}`,
+                number: project.number,
+                name: project.name,
+                path: project.path,
+                completedTasks: stats.completed,
+                totalTasks: stats.total,
+            });
+        }
+    }
+    // Sort by number (already sorted by discoverProjects, but ensure it)
+    return pendingProjects.sort((a, b) => a.number - b.number);
+}
+/**
+ * Format a project for display in the picker.
+ * Example: "001 fix-auth-bug (2/5 tasks)"
+ */
+export function formatProjectChoice(project) {
+    const projectNumber = extractProjectNumber(project.path) ?? formatProjectNumber(project.number);
+    return `${projectNumber} ${project.name} (${project.completedTasks}/${project.totalTasks} tasks)`;
+}
+/**
+ * Display an interactive project picker for pending projects.
+ * Returns the selected project folder name or null if no projects or cancelled.
+ */
+export async function pickPendingProject(rafDir) {
+    const pendingProjects = getPendingProjects(rafDir);
+    if (pendingProjects.length === 0) {
+        return null;
+    }
+    const choices = pendingProjects.map((project) => ({
+        name: formatProjectChoice(project),
+        value: project.folder,
+    }));
+    const selected = await select({
+        message: 'Select a project to execute:',
+        choices,
+    });
+    return selected;
+}
+//# sourceMappingURL=project-picker.js.map

package/dist/ui/project-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-picker.js","sourceRoot":"","sources":["../../src/ui/project-picker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAc9E;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,eAAe,GAAyB,EAAE,CAAC;IAEjD,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAErC,+EAA+E;QAC/E,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,aAAa,GAAG,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACzD,MAAM,eAAe,GAAG,aAAa,IAAI,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE7E,eAAe,CAAC,IAAI,CAAC;gBACnB,MAAM,EAAE,GAAG,eAAe,IAAI,OAAO,CAAC,IAAI,EAAE;gBAC5C,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,cAAc,EAAE,KAAK,CAAC,SAAS;gBAC/B,UAAU,EAAE,KAAK,CAAC,KAAK;aACxB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA2B;IAC7D,MAAM,aAAa,GAAG,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChG,OAAO,GAAG,aAAa,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,UAAU,SAAS,CAAC;AACpG,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAc;IACrD,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAEnD,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,MAAM;KACtB,CAAC,CAAC,CAAC;IAEJ,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;QAC5B,OAAO,EAAE,8BAA8B;QACvC,OAAO;KACR,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,24 @@
+import { RafConfig } from '../types/config.js';
+/**
+ * Get the path to Claude CLI settings file.
+ */
+export declare function getClaudeSettingsPath(): string;
+export declare function loadConfig(rafDir: string): RafConfig;
+export declare function saveConfig(rafDir: string, config: RafConfig): void;
+export declare function getEditor(): string;
+/**
+ * Get the Claude model name from Claude CLI settings.
+ * Returns the model name or null if not found.
+ * @param settingsPath Optional path to settings file (for testing)
+ */
+export declare function getClaudeModel(settingsPath?: string): string | null;
+/**
+ * Get runtime configuration for task execution.
+ * Returns default values which can be overridden by command line options.
+ */
+export declare function getConfig(): {
+    timeout: number;
+    maxRetries: number;
+    autoCommit: boolean;
+};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAsB,MAAM,oBAAoB,CAAC;AAInE;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAcpD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAGlE;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYnE;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAMxF"}

package/dist/utils/config.js

@@ -0,0 +1,63 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { DEFAULT_RAF_CONFIG } from '../types/config.js';
+const CONFIG_FILENAME = 'raf.config.json';
+/**
+ * Get the path to Claude CLI settings file.
+ */
+export function getClaudeSettingsPath() {
+    return path.join(os.homedir(), '.claude', 'settings.json');
+}
+export function loadConfig(rafDir) {
+    const configPath = path.join(rafDir, CONFIG_FILENAME);
+    if (!fs.existsSync(configPath)) {
+        return { ...DEFAULT_RAF_CONFIG };
+    }
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const userConfig = JSON.parse(content);
+        return { ...DEFAULT_RAF_CONFIG, ...userConfig };
+    }
+    catch {
+        return { ...DEFAULT_RAF_CONFIG };
+    }
+}
+export function saveConfig(rafDir, config) {
+    const configPath = path.join(rafDir, CONFIG_FILENAME);
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+}
+export function getEditor() {
+    return process.env['EDITOR'] ?? process.env['VISUAL'] ?? 'vi';
+}
+/**
+ * Get the Claude model name from Claude CLI settings.
+ * Returns the model name or null if not found.
+ * @param settingsPath Optional path to settings file (for testing)
+ */
+export function getClaudeModel(settingsPath) {
+    const filePath = settingsPath ?? getClaudeSettingsPath();
+    try {
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const settings = JSON.parse(content);
+        return settings.model ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get runtime configuration for task execution.
+ * Returns default values which can be overridden by command line options.
+ */
+export function getConfig() {
+    return {
+        timeout: DEFAULT_RAF_CONFIG.defaultTimeout,
+        maxRetries: DEFAULT_RAF_CONFIG.defaultMaxRetries,
+        autoCommit: DEFAULT_RAF_CONFIG.autoCommit,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAa,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAE1C;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAEtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAuB,CAAC;QAC7D,OAAO,EAAE,GAAG,kBAAkB,EAAE,GAAG,UAAU,EAAE,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,MAAiB;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACtD,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,YAAqB;IAClD,MAAM,QAAQ,GAAG,YAAY,IAAI,qBAAqB,EAAE,CAAC;IACzD,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAuB,CAAC;QAC3D,OAAO,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,OAAO,EAAE,kBAAkB,CAAC,cAAc;QAC1C,UAAU,EAAE,kBAAkB,CAAC,iBAAiB;QAChD,UAAU,EAAE,kBAAkB,CAAC,UAAU;KAC1C,CAAC;AACJ,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,32 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+interface LoggerOptions {
+    verbose?: boolean;
+    debug?: boolean;
+}
+declare class Logger {
+    private verbose;
+    private debugMode;
+    configure(options: LoggerOptions): void;
+    /**
+     * @deprecated No longer used - kept for backwards compatibility
+     */
+    setContext(_prefix: string): void;
+    /**
+     * @deprecated No longer used - kept for backwards compatibility
+     */
+    clearContext(): void;
+    private formatMessage;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    verbose_log(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    print(message: string, ...args: unknown[]): void;
+    success(message: string, ...args: unknown[]): void;
+    task(status: string, name: string): void;
+    newline(): void;
+    dim(message: string, ...args: unknown[]): void;
+}
+export declare const logger: Logger;
+export {};
+//# 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":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,cAAM,MAAM;IACV,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAE1B,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAKvC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB,OAAO,CAAC,aAAa;IAIrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMtD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIlD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxC,OAAO,IAAI,IAAI;IAIf,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAI/C;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,60 @@
+class Logger {
+    verbose = false;
+    debugMode = false;
+    configure(options) {
+        this.verbose = options.verbose ?? false;
+        this.debugMode = options.debug ?? false;
+    }
+    /**
+     * @deprecated No longer used - kept for backwards compatibility
+     */
+    setContext(_prefix) {
+        // No-op: context prefix feature removed in favor of minimal output style
+    }
+    /**
+     * @deprecated No longer used - kept for backwards compatibility
+     */
+    clearContext() {
+        // No-op: context prefix feature removed in favor of minimal output style
+    }
+    formatMessage(message) {
+        return message;
+    }
+    debug(message, ...args) {
+        if (this.debugMode) {
+            console.log(`[DEBUG] ${message}`, ...args);
+        }
+    }
+    info(message, ...args) {
+        console.log(this.formatMessage(message), ...args);
+    }
+    verbose_log(message, ...args) {
+        if (this.verbose || this.debugMode) {
+            console.log(this.formatMessage(message), ...args);
+        }
+    }
+    warn(message, ...args) {
+        console.warn(`⚠️  ${this.formatMessage(message)}`, ...args);
+    }
+    error(message, ...args) {
+        console.error(`✗ ${this.formatMessage(message)}`, ...args);
+    }
+    print(message, ...args) {
+        console.log(message, ...args);
+    }
+    success(message, ...args) {
+        console.log(`✓ ${this.formatMessage(message)}`, ...args);
+    }
+    task(status, name) {
+        console.log(`${status} ${name}`);
+    }
+    newline() {
+        console.log();
+    }
+    dim(message, ...args) {
+        // ANSI escape code for dim text
+        console.log(`\x1b[2m${this.formatMessage(message)}\x1b[0m`, ...args);
+    }
+}
+export const logger = new 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":"AAOA,MAAM,MAAM;IACF,OAAO,GAAG,KAAK,CAAC;IAChB,SAAS,GAAG,KAAK,CAAC;IAE1B,SAAS,CAAC,OAAsB;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAe;QACxB,yEAAyE;IAC3E,CAAC;IAED;;OAEG;IACH,YAAY;QACV,yEAAyE;IAC3E,CAAC;IAEO,aAAa,CAAC,OAAe;QACnC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,WAAW,CAAC,OAAe,EAAE,GAAG,IAAe;QAC7C,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,OAAe,EAAE,GAAG,IAAe;QACzC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,IAAY;QAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,OAAO;QACL,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,GAAG,CAAC,OAAe,EAAE,GAAG,IAAe;QACrC,gCAAgC;QAChC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;IACvE,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/dist/utils/name-generator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generate a single project name using Claude Sonnet.
+ * Falls back to extracting words from the description if the API call fails.
+ */
+export declare function generateProjectName(description: string): Promise<string>;
+/**
+ * Generate multiple project name suggestions using Claude Sonnet.
+ * Returns 3-5 unique names with varied styles.
+ */
+export declare function generateProjectNames(description: string): Promise<string[]>;
+/**
+ * Escape a string for use as a shell argument.
+ */
+declare function escapeShellArg(arg: string): string;
+/**
+ * Sanitize the generated name to ensure it's a valid kebab-case folder name.
+ */
+declare function sanitizeGeneratedName(name: string): string | null;
+export { sanitizeGeneratedName, escapeShellArg };
+//# sourceMappingURL=name-generator.d.ts.map

package/dist/utils/name-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-generator.d.ts","sourceRoot":"","sources":["../../src/utils/name-generator.ts"],"names":[],"mappings":"AAyCA;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB9E;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAejF;AAkED;;GAEG;AACH,iBAAS,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ3C;AAED;;GAEG;AACH,iBAAS,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyB1D;AAqBD,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,CAAC"}

package/dist/utils/name-generator.js

@@ -0,0 +1,183 @@
+import { execSync } from 'node:child_process';
+import { logger } from './logger.js';
+import { sanitizeProjectName } from './validation.js';
+const SONNET_MODEL = 'sonnet';
+const NAME_GENERATION_PROMPT = `Generate a short, punchy, creative project name (1-3 words, kebab-case).
+
+Be creative! Use metaphors, analogies, or evocative words that capture the SPIRIT of the project.
+Don't literally describe what it does - make it memorable and fun.
+
+Good examples:
+- Bug fix → 'bug-squasher', 'exterminator', 'patch-adams'
+- Performance optimization → 'turbo-boost', 'lightning-rod', 'speed-demon'
+- Auth system → 'gatekeeper', 'bouncer', 'key-master'
+- Refactoring → 'spring-cleaning', 'phoenix', 'makeover'
+- New feature → 'moonshot', 'secret-sauce', 'magic-wand'
+
+Output ONLY the kebab-case name. No quotes, no explanation.
+
+Project description:`;
+const MULTI_NAME_GENERATION_PROMPT = `Generate 5 creative project names for the description below.
+
+IMPORTANT: Each name should use a DIFFERENT naming style:
+1. **Metaphorical** - Use a metaphor or analogy (e.g., 'phoenix', 'lighthouse', 'compass')
+2. **Fun/Playful** - Make it fun or quirky (e.g., 'turbo-boost', 'magic-beans', 'ninja-move')
+3. **Action-oriented** - Focus on what it does with flair (e.g., 'bug-squasher', 'speed-demon', 'data-whisperer')
+4. **Abstract** - Use abstract/poetic concepts (e.g., 'horizon', 'cascade', 'catalyst')
+5. **Cultural reference** - Reference pop culture, mythology, or literature (e.g., 'atlas', 'merlin', 'gandalf')
+
+Rules:
+- Each name should be 1-3 words in kebab-case
+- Names must be lowercase with hyphens only
+- Make them memorable and evocative
+- If the project has many unrelated tasks, prefer abstract/metaphorical/fun names over descriptive ones
+
+Output format: ONLY output 5 names, one per line, no numbers, no explanations, no quotes.
+
+Project description:`;
+/**
+ * Generate a single project name using Claude Sonnet.
+ * Falls back to extracting words from the description if the API call fails.
+ */
+export async function generateProjectName(description) {
+    try {
+        const name = await callSonnetForName(description);
+        if (name) {
+            const sanitized = sanitizeGeneratedName(name);
+            if (sanitized) {
+                logger.debug(`Generated project name: ${sanitized}`);
+                return sanitized;
+            }
+        }
+    }
+    catch (error) {
+        logger.debug(`Failed to generate name with Sonnet: ${error}`);
+    }
+    // Fallback to extracting words from description
+    return generateFallbackName(description);
+}
+/**
+ * Generate multiple project name suggestions using Claude Sonnet.
+ * Returns 3-5 unique names with varied styles.
+ */
+export async function generateProjectNames(description) {
+    try {
+        const names = await callSonnetForMultipleNames(description);
+        if (names.length >= 3) {
+            logger.debug(`Generated ${names.length} project names`);
+            return names;
+        }
+    }
+    catch (error) {
+        logger.debug(`Failed to generate names with Sonnet: ${error}`);
+    }
+    // Fallback: generate a single fallback name
+    const fallbackName = generateFallbackName(description);
+    logger.debug(`Using fallback name: ${fallbackName}`);
+    return [fallbackName];
+}
+/**
+ * Call Claude Sonnet to generate a single project name.
+ */
+async function callSonnetForName(description) {
+    try {
+        const fullPrompt = `${NAME_GENERATION_PROMPT}\n${description}`;
+        // Use claude CLI with --model sonnet and --print for non-interactive output
+        const result = execSync(`claude --model ${SONNET_MODEL} --print "${escapeShellArg(fullPrompt)}"`, {
+            encoding: 'utf-8',
+            timeout: 30000, // 30 second timeout
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return result.trim();
+    }
+    catch (error) {
+        logger.debug(`Sonnet API call failed: ${error}`);
+        return null;
+    }
+}
+/**
+ * Call Claude Sonnet to generate multiple project names.
+ */
+async function callSonnetForMultipleNames(description) {
+    try {
+        const fullPrompt = `${MULTI_NAME_GENERATION_PROMPT}\n${description}`;
+        const result = execSync(`claude --model ${SONNET_MODEL} --print "${escapeShellArg(fullPrompt)}"`, {
+            encoding: 'utf-8',
+            timeout: 30000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        // Parse the multiline response
+        const lines = result
+            .trim()
+            .split('\n')
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0);
+        // Sanitize and validate each name
+        const validNames = [];
+        for (const line of lines) {
+            const sanitized = sanitizeGeneratedName(line);
+            if (sanitized && !validNames.includes(sanitized)) {
+                validNames.push(sanitized);
+            }
+        }
+        // Return 3-5 names
+        return validNames.slice(0, 5);
+    }
+    catch (error) {
+        logger.debug(`Sonnet API call for multiple names failed: ${error}`);
+        return [];
+    }
+}
+/**
+ * Escape a string for use as a shell argument.
+ */
+function escapeShellArg(arg) {
+    // Replace double quotes with escaped double quotes
+    // Replace backslashes with escaped backslashes
+    return arg
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\$/g, '\\$')
+        .replace(/`/g, '\\`');
+}
+/**
+ * Sanitize the generated name to ensure it's a valid kebab-case folder name.
+ */
+function sanitizeGeneratedName(name) {
+    // Remove any leading/trailing whitespace and quotes
+    let sanitized = name.trim().replace(/^["']|["']$/g, '');
+    // Remove any numbering prefix like "1." or "1:" or "1)"
+    sanitized = sanitized.replace(/^\d+[.:)]\s*/, '');
+    // Convert to lowercase
+    sanitized = sanitized.toLowerCase();
+    // Replace any non-alphanumeric characters with hyphens
+    sanitized = sanitized.replace(/[^a-z0-9]+/g, '-');
+    // Remove leading and trailing hyphens
+    sanitized = sanitized.replace(/^-+|-+$/g, '');
+    // Truncate if too long (max 50 chars)
+    sanitized = sanitized.substring(0, 50);
+    // Return null if the result is empty or too short
+    if (sanitized.length < 2) {
+        return null;
+    }
+    return sanitized;
+}
+/**
+ * Generate a fallback name by extracting meaningful words from the description.
+ */
+function generateFallbackName(description) {
+    // Extract first meaningful words from input
+    const words = description
+        .split(/\s+/)
+        .filter((w) => w.length > 2)
+        .slice(0, 3)
+        .join('-')
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '');
+    const name = sanitizeProjectName(words || 'project');
+    logger.debug(`Using fallback project name: ${name}`);
+    return name;
+}
+// Export for testing
+export { sanitizeGeneratedName, escapeShellArg };
+//# sourceMappingURL=name-generator.js.map

package/dist/utils/name-generator.js.map

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

package/dist/utils/paths.d.ts

@@ -0,0 +1,132 @@
+export declare const RAF_DIR = "RAF";
+/**
+ * Encode a project number >= 1000 to a 3-character base36 string.
+ * The encoding offsets by 1000, so:
+ * - 1000 -> 'a00'
+ * - 1001 -> 'a01'
+ * - 1035 -> 'a0z'
+ * - 1036 -> 'a10'
+ * - etc.
+ *
+ * First character uses a-z (10-35 in base36, letters only).
+ * Second and third characters use 0-9a-z (0-35 in base36).
+ */
+export declare function encodeBase36(num: number): string;
+/**
+ * Decode a 3-character base36 string to a project number.
+ * Returns the decoded number >= 1000, or null if invalid format.
+ */
+export declare function decodeBase36(str: string): number | null;
+/**
+ * Check if a string is a valid base36 project prefix.
+ * Valid format: starts with a-z, followed by two base36 chars (0-9, a-z).
+ */
+export declare function isBase36Prefix(str: string): boolean;
+export declare function getRafDir(): string;
+export declare function ensureRafDir(): string;
+export declare function getNextProjectNumber(rafDir: string): number;
+export declare function formatProjectNumber(num: number): string;
+export declare function getProjectDir(rafDir: string, projectName: string): string | null;
+/**
+ * Extract project number prefix from a project path.
+ * Supports both numeric (001-999) and base36 (a00-zzz) formats.
+ * E.g., "/Users/foo/RAF/001-my-project" -> "001"
+ * E.g., "/Users/foo/RAF/a00-my-project" -> "a00"
+ * Returns the prefix string (e.g., "001" or "a00") or null if not found.
+ */
+export declare function extractProjectNumber(projectPath: string): string | null;
+/**
+ * Parse a project prefix string to its numeric value.
+ * Handles both numeric (001-999) and base36 (a00-zzz) formats.
+ * Returns the numeric project number or null if invalid.
+ */
+export declare function parseProjectPrefix(prefix: string): number | null;
+/**
+ * Extract project name from a project path (without number prefix).
+ * Supports both numeric (001-999) and base36 (a00-zzz) formats.
+ * E.g., "/Users/foo/RAF/001-my-project" -> "my-project"
+ * E.g., "/Users/foo/RAF/a00-my-project" -> "my-project"
+ * Returns the project name or null if not found.
+ */
+export declare function extractProjectName(projectPath: string): string | null;
+/**
+ * Extract task name from a plan filename (without number prefix and extension).
+ * E.g., "002-fix-login-bug.md" -> "fix-login-bug"
+ * Returns the task name or null if not found.
+ */
+export declare function extractTaskNameFromPlanFile(planFilename: string): string | null;
+export declare function listProjects(rafDir: string): Array<{
+    number: number;
+    name: string;
+    path: string;
+}>;
+export declare function getPlansDir(projectPath: string): string;
+export declare function getOutcomesDir(projectPath: string): string;
+export declare function getOutcomeFilePath(projectPath: string, taskId: string, taskName: string): string;
+export declare function getDecisionsPath(projectPath: string): string;
+export declare function getLogsDir(projectPath: string): string;
+export declare function getInputPath(projectPath: string): string;
+/**
+ * Result of resolving a project identifier.
+ */
+export interface ProjectResolutionResult {
+    /** Resolved project path (null if not found or ambiguous) */
+    path: string | null;
+    /** Error type if resolution failed */
+    error?: 'not_found' | 'ambiguous';
+    /** For ambiguous matches, list of matching projects */
+    matches?: Array<{
+        number: number;
+        name: string;
+        path: string;
+        folder: string;
+    }>;
+}
+/**
+ * Resolve a project identifier with detailed result including ambiguity detection.
+ *
+ * Supported identifier formats (checked in this order):
+ * 1. Full folder name (e.g., "001-fix-stuff", "a01-important-project")
+ *    - Must be an exact match to an existing folder
+ *    - Pattern: numeric prefix (2-3 digits) or base36 prefix, followed by hyphen and name
+ * 2. Numeric ID (e.g., "003", "3", "1000")
+ *    - Looks up by project number
+ * 3. Base36 prefix (e.g., "a00", "a01")
+ *    - Looks up by base36 project number (for projects >= 1000)
+ * 4. Project name (e.g., "my-project", "fix-stuff")
+ *    - Looks up by the name portion of the folder (after the prefix)
+ *    - Case-insensitive matching
+ *    - Returns error if multiple projects have the same name
+ *
+ * @param rafDir - The RAF directory containing project folders
+ * @param identifier - The identifier to resolve
+ * @returns Resolution result with path, error type, and matches for ambiguous cases
+ */
+export declare function resolveProjectIdentifierWithDetails(rafDir: string, identifier: string): ProjectResolutionResult;
+/**
+ * Resolve a project identifier to a full project path.
+ *
+ * Supported identifier formats (checked in this order):
+ * 1. Full folder name (e.g., "001-fix-stuff", "a01-important-project")
+ *    - Must be an exact match to an existing folder
+ *    - Pattern: numeric prefix (2-3 digits) or base36 prefix, followed by hyphen and name
+ * 2. Numeric ID (e.g., "003", "3", "1000")
+ *    - Looks up by project number
+ * 3. Base36 prefix (e.g., "a00", "a01")
+ *    - Looks up by base36 project number (for projects >= 1000)
+ * 4. Project name (e.g., "my-project", "fix-stuff")
+ *    - Looks up by the name portion of the folder (after the prefix)
+ *    - Case-insensitive matching
+ *
+ * Note: For ambiguity detection (multiple projects with same name), use
+ * resolveProjectIdentifierWithDetails instead.
+ *
+ * This function is designed to be extensible for future task-level references
+ * like "001-project/002-task".
+ *
+ * @param rafDir - The RAF directory containing project folders
+ * @param identifier - The identifier to resolve
+ * @returns The full project path or null if not found (or ambiguous)
+ */
+export declare function resolveProjectIdentifier(rafDir: string, identifier: string): string | null;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,QAAQ,CAAC;AAO7B;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAyBhD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6BvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKnD;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiC3D;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBhF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBvE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYhE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBrE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI/E;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAqClG;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhG;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,sCAAsC;IACtC,KAAK,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IAClC,uDAAuD;IACvD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjF;AAsCD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,uBAAuB,CA0EzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAGf"}