red64-cli 0.1.0

package/dist/services/TaskRunner.js

@@ -0,0 +1,135 @@
+/**
+ * Task Runner Service
+ * Task 4.2: Implement task runner for incremental implementation execution
+ * Requirements: 5.2, 5.3, 5.4
+ */
+/**
+ * Checkpoint interval - trigger checkpoint every N tasks
+ * Requirements: 5.5 - Checkpoint every 3 tasks
+ */
+const CHECKPOINT_INTERVAL = 3;
+/**
+ * Generate task prompt for agent invocation
+ */
+function generateTaskPrompt(task, feature) {
+    return `Execute implementation task ${task.id} for feature "${feature}":
+
+Task: ${task.title}
+
+Description:
+${task.description}
+
+Instructions:
+1. Implement the task as described
+2. Write tests before implementation (TDD)
+3. Ensure all existing tests pass
+4. Follow the project's coding standards
+`;
+}
+/**
+ * Create task runner service
+ * Requirements: 5.2, 5.3, 5.4 - Factory function for task execution
+ */
+export function createTaskRunner(agentInvoker, commitService, taskParser) {
+    let aborted = false;
+    return {
+        /**
+         * Execute tasks sequentially
+         * Requirements: 5.2 - Execute tasks in order via AgentInvoker
+         * Requirements: 5.3 - Commit after each successful task
+         * Requirements: 5.4 - Report progress to callback
+         */
+        async execute(options) {
+            aborted = false;
+            // Parse tasks from spec directory
+            const allTasks = await taskParser.parse(options.specDir);
+            const pendingTasks = taskParser.getPendingTasks(allTasks);
+            // Start from specified index
+            const tasksToExecute = pendingTasks.slice(options.startFromTask);
+            const totalTasks = pendingTasks.length;
+            if (tasksToExecute.length === 0) {
+                return {
+                    success: true,
+                    completedTasks: 0,
+                    totalTasks,
+                    pausedAt: undefined,
+                    error: undefined
+                };
+            }
+            let completedCount = options.startFromTask;
+            for (const task of tasksToExecute) {
+                // Check for abort
+                if (aborted) {
+                    return {
+                        success: false,
+                        completedTasks: completedCount,
+                        totalTasks,
+                        pausedAt: undefined,
+                        error: 'Execution aborted'
+                    };
+                }
+                // Invoke agent for task
+                const prompt = generateTaskPrompt(task, options.feature);
+                const result = await agentInvoker.invoke({
+                    prompt,
+                    workingDirectory: options.workingDir,
+                    skipPermissions: options.flags.skipPermissions,
+                    tier: options.flags.tier
+                });
+                if (!result.success) {
+                    return {
+                        success: false,
+                        completedTasks: completedCount,
+                        totalTasks,
+                        pausedAt: undefined,
+                        error: result.stderr || 'Agent execution failed'
+                    };
+                }
+                // Commit changes after successful task
+                const commitMessage = commitService.formatTaskCommitMessage(options.feature, completedCount + 1, task.title);
+                await commitService.stageAndCommit(options.workingDir, commitMessage);
+                completedCount++;
+                // Report progress
+                options.onProgress(completedCount, totalTasks, task);
+                // Check for checkpoint (every 3 tasks)
+                if (completedCount % CHECKPOINT_INTERVAL === 0) {
+                    const decision = await options.onCheckpoint(completedCount, totalTasks);
+                    if (decision === 'pause') {
+                        return {
+                            success: true,
+                            completedTasks: completedCount,
+                            totalTasks,
+                            pausedAt: completedCount,
+                            error: undefined
+                        };
+                    }
+                    if (decision === 'abort') {
+                        return {
+                            success: false,
+                            completedTasks: completedCount,
+                            totalTasks,
+                            pausedAt: undefined,
+                            error: 'Execution aborted by user'
+                        };
+                    }
+                }
+            }
+            return {
+                success: true,
+                completedTasks: completedCount,
+                totalTasks,
+                pausedAt: undefined,
+                error: undefined
+            };
+        },
+        /**
+         * Abort running task execution
+         * Requirements: 5.6 - Allow abort at any point
+         */
+        abort() {
+            aborted = true;
+            agentInvoker.abort();
+        }
+    };
+}
+//# sourceMappingURL=TaskRunner.js.map

package/dist/services/TaskRunner.js.map

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

package/dist/services/TemplateService.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Template service for file extraction and transformation
+ * Requirements: 1.3, 2.1-2.7, 3.1-3.6
+ */
+import type { CodingAgent } from '../types/index.js';
+/**
+ * Structure creation result
+ */
+export interface StructureResult {
+    readonly createdDirs: readonly string[];
+    readonly createdFiles: readonly string[];
+}
+/**
+ * Stack template application options
+ */
+export interface StackTemplateOptions {
+    readonly sourceDir: string;
+    readonly targetDir: string;
+    readonly stack: string;
+    readonly variables: Record<string, string>;
+}
+/**
+ * Tarball extraction options
+ */
+export interface ExtractOptions {
+    readonly tarballPath: string;
+    readonly targetDir: string;
+    readonly onProgress?: (file: string) => void;
+}
+/**
+ * Framework installation options
+ */
+export interface InstallFrameworkOptions {
+    readonly sourceDir: string;
+    readonly targetDir: string;
+    readonly variables?: Record<string, string>;
+    readonly agent?: CodingAgent;
+}
+/**
+ * Template service interface
+ * Requirements: 1.3, 2.1-2.7, 3.1-3.6
+ */
+export interface TemplateService {
+    /**
+     * Extract tarball and transform contents
+     * - Extracts to targetDir/.red64/
+     * - Renames kiro references to red64
+     */
+    extract(options: ExtractOptions): Promise<StructureResult>;
+    /**
+     * Create unified directory structure
+     */
+    createStructure(targetDir: string): Promise<StructureResult>;
+    /**
+     * Install the full framework from source to target
+     * Copies framework/.red64/ to target/.red64/
+     */
+    installFramework(options: InstallFrameworkOptions): Promise<StructureResult>;
+    /**
+     * Apply stack-specific steering templates
+     */
+    applyStackTemplates(options: StackTemplateOptions): Promise<readonly string[]>;
+    /**
+     * List available stacks in extracted source
+     */
+    listStacks(sourceDir: string): Promise<readonly string[]>;
+}
+/**
+ * Create template service
+ * Task 2.3, 3.1, 3.2: Template service factory
+ */
+export declare function createTemplateService(): TemplateService;
+//# sourceMappingURL=TemplateService.d.ts.map

package/dist/services/TemplateService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateService.d.ts","sourceRoot":"","sources":["../../src/services/TemplateService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA4BrD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE3D;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE7D;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE7E;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAE/E;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;CAC3D;AAgJD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAuIvD"}

package/dist/services/TemplateService.js

@@ -0,0 +1,263 @@
+/**
+ * Template service for file extraction and transformation
+ * Requirements: 1.3, 2.1-2.7, 3.1-3.6
+ */
+import { mkdir, readFile, writeFile, readdir, access, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Configuration for each supported coding agent
+ */
+const AGENT_CONFIGS = {
+    claude: {
+        configDir: '.claude',
+        instructionFile: 'CLAUDE.md'
+    },
+    gemini: {
+        configDir: '', // Gemini doesn't use a hidden config directory
+        instructionFile: 'GEMINI.md'
+    },
+    codex: {
+        configDir: '.codex',
+        instructionFile: 'AGENTS.md'
+    }
+};
+/**
+ * The unified directory structure to create
+ * Requirements: 2.1-2.6
+ */
+const STRUCTURE_DIRS = [
+    '.red64',
+    '.red64/steering',
+    '.red64/specs',
+    '.red64/templates',
+    '.red64/settings',
+    '.red64/settings/rules',
+    '.red64/settings/templates'
+];
+/**
+ * Perform kiro-to-red64 renaming in content
+ * Task 3.1: Case-aware string replacement
+ */
+function transformContent(content) {
+    return content
+        // Directory references
+        .replace(/\.kiro\//g, '.red64/')
+        .replace(/\.kiro(?=[^/a-z]|$)/g, '.red64')
+        // Slash command references
+        .replace(/\/kiro:/g, '/red64:')
+        // Hyphenated references (kiro-cli, kiro-spec, etc.)
+        .replace(/kiro-/g, 'red64-')
+        // Capitalized references
+        .replace(/Kiro/g, 'Red64')
+        // All caps references
+        .replace(/KIRO/g, 'RED64')
+        // Standalone lowercase
+        .replace(/\bkiro\b/g, 'red64');
+}
+/**
+ * Replace template variables in content
+ * Variables are in format {{variableName}}
+ */
+function replaceVariables(content, variables) {
+    let result = content;
+    for (const [key, value] of Object.entries(variables)) {
+        const pattern = new RegExp(`\\{\\{${key}\\}\\}`, 'g');
+        result = result.replace(pattern, value);
+    }
+    return result;
+}
+/**
+ * Check if path exists
+ */
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if path is a directory
+ */
+async function isDirectory(path) {
+    try {
+        const stats = await stat(path);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Copy framework directory recursively, tracking created dirs and files
+ */
+async function copyFrameworkDir(srcDir, destDir, variables, createdDirs, createdFiles, relativePath = '') {
+    await mkdir(destDir, { recursive: true });
+    if (relativePath) {
+        createdDirs.push(relativePath);
+    }
+    const entries = await readdir(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = join(srcDir, entry.name);
+        const destPath = join(destDir, entry.name);
+        const entryRelPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            await copyFrameworkDir(srcPath, destPath, variables, createdDirs, createdFiles, entryRelPath);
+        }
+        else if (entry.isFile()) {
+            let content = await readFile(srcPath, 'utf-8');
+            content = replaceVariables(content, variables);
+            await writeFile(destPath, content, 'utf-8');
+            createdFiles.push(entryRelPath);
+        }
+    }
+}
+/**
+ * Copy directory recursively with transformations
+ */
+async function copyDirWithTransform(srcDir, destDir, variables) {
+    const copiedFiles = [];
+    // Ensure destination exists
+    await mkdir(destDir, { recursive: true });
+    const entries = await readdir(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = join(srcDir, entry.name);
+        const destPath = join(destDir, entry.name);
+        if (entry.isDirectory()) {
+            // Recursively copy subdirectories
+            const subFiles = await copyDirWithTransform(srcPath, destPath, variables);
+            copiedFiles.push(...subFiles);
+        }
+        else if (entry.isFile()) {
+            // Read, transform, and write file
+            let content = await readFile(srcPath, 'utf-8');
+            content = transformContent(content);
+            content = replaceVariables(content, variables);
+            await writeFile(destPath, content, 'utf-8');
+            copiedFiles.push(entry.name);
+        }
+    }
+    return copiedFiles;
+}
+/**
+ * Create template service
+ * Task 2.3, 3.1, 3.2: Template service factory
+ */
+export function createTemplateService() {
+    return {
+        async extract(_options) {
+            // Note: Full tarball extraction will be implemented separately
+            // This placeholder allows testing the interface
+            const createdDirs = [];
+            const createdFiles = [];
+            return { createdDirs, createdFiles };
+        },
+        async createStructure(targetDir) {
+            const createdDirs = [];
+            const createdFiles = [];
+            // Create all required directories
+            for (const dir of STRUCTURE_DIRS) {
+                const fullPath = join(targetDir, dir);
+                await mkdir(fullPath, { recursive: true });
+                createdDirs.push(dir);
+            }
+            return { createdDirs, createdFiles };
+        },
+        async installFramework(options) {
+            const { sourceDir, targetDir, variables = {}, agent = 'claude' } = options;
+            const createdDirs = [];
+            const createdFiles = [];
+            const agentConfig = AGENT_CONFIGS[agent];
+            const agentSourceDir = join(sourceDir, 'agents', agent);
+            // 1. Copy agent-specific config directory (e.g., .claude/, .codex/)
+            if (agentConfig.configDir) {
+                const configSrc = join(agentSourceDir, agentConfig.configDir);
+                const configDest = join(targetDir, agentConfig.configDir);
+                if (await pathExists(configSrc)) {
+                    await copyFrameworkDir(configSrc, configDest, variables, createdDirs, createdFiles);
+                }
+            }
+            // 2. Copy shared .red64/ directory (settings, templates)
+            const red64Src = join(sourceDir, '.red64');
+            const red64Dest = join(targetDir, '.red64');
+            if (await pathExists(red64Src)) {
+                await copyFrameworkDir(red64Src, red64Dest, variables, createdDirs, createdFiles);
+            }
+            else {
+                // Fall back to creating empty structure if framework not found
+                return this.createStructure(targetDir);
+            }
+            // 3. Copy agent-specific instruction file (e.g., CLAUDE.md, GEMINI.md, AGENTS.md)
+            const instructionSrc = join(agentSourceDir, 'docs', agentConfig.instructionFile);
+            const instructionDest = join(targetDir, agentConfig.instructionFile);
+            if (await pathExists(instructionSrc)) {
+                let content = await readFile(instructionSrc, 'utf-8');
+                content = replaceVariables(content, variables);
+                await writeFile(instructionDest, content, 'utf-8');
+                createdFiles.push(agentConfig.instructionFile);
+            }
+            // 4. For Gemini: Copy commands.toml if present
+            if (agent === 'gemini') {
+                const tomlSrc = join(agentSourceDir, 'commands.toml');
+                const tomlDest = join(targetDir, 'commands.toml');
+                if (await pathExists(tomlSrc)) {
+                    let content = await readFile(tomlSrc, 'utf-8');
+                    content = replaceVariables(content, variables);
+                    await writeFile(tomlDest, content, 'utf-8');
+                    createdFiles.push('commands.toml');
+                }
+            }
+            // 5. Ensure additional directories exist (specs, steering)
+            const additionalDirs = ['.red64/specs', '.red64/steering'];
+            for (const dir of additionalDirs) {
+                const fullPath = join(targetDir, dir);
+                if (!(await pathExists(fullPath))) {
+                    await mkdir(fullPath, { recursive: true });
+                    createdDirs.push(dir);
+                }
+            }
+            return { createdDirs, createdFiles };
+        },
+        async applyStackTemplates(options) {
+            const { sourceDir, targetDir, stack, variables } = options;
+            const stacksDir = join(sourceDir, 'stacks');
+            // Ensure steering directory exists
+            const steeringDir = join(targetDir, '.red64', 'steering');
+            await mkdir(steeringDir, { recursive: true });
+            // Try to find the stack directory
+            let stackDir = join(stacksDir, stack);
+            let stackExists = await isDirectory(stackDir);
+            // Fall back to generic if stack not found
+            if (!stackExists) {
+                stackDir = join(stacksDir, 'generic');
+                stackExists = await isDirectory(stackDir);
+            }
+            if (!stackExists) {
+                return [];
+            }
+            // Copy and transform files
+            const copiedFiles = await copyDirWithTransform(stackDir, steeringDir, variables);
+            return copiedFiles;
+        },
+        async listStacks(sourceDir) {
+            const stacksDir = join(sourceDir, 'stacks');
+            if (!(await pathExists(stacksDir))) {
+                return [];
+            }
+            try {
+                const entries = await readdir(stacksDir, { withFileTypes: true });
+                const stacks = entries
+                    .filter(entry => entry.isDirectory())
+                    .map(entry => entry.name)
+                    .sort();
+                return stacks;
+            }
+            catch {
+                return [];
+            }
+        }
+    };
+}
+//# sourceMappingURL=TemplateService.js.map

package/dist/services/TemplateService.js.map

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

package/dist/services/WorktreeService.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Worktree Service
+ * Task 1.2: Build worktree service for git worktree operations
+ * Requirements: 1.3, 1.4
+ */
+/**
+ * Worktree information
+ * Requirements: 1.3 - Check for existing worktree
+ */
+export interface WorktreeInfo {
+    readonly path: string;
+    readonly branch: string;
+    readonly exists: boolean;
+}
+/**
+ * Worktree operation result
+ * Requirements: 1.4 - Create worktree with branch
+ */
+export interface WorktreeResult {
+    readonly success: boolean;
+    readonly path: string | undefined;
+    readonly error: string | undefined;
+}
+/**
+ * Worktree service interface
+ * Requirements: 1.3, 1.4
+ */
+export interface WorktreeServiceInterface {
+    check(repoPath: string, feature: string): Promise<WorktreeInfo>;
+    create(repoPath: string, feature: string): Promise<WorktreeResult>;
+    remove(repoPath: string, feature: string, force?: boolean): Promise<WorktreeResult>;
+    list(repoPath: string): Promise<readonly WorktreeInfo[]>;
+}
+/**
+ * Sanitize feature name for use in git branch names and paths
+ * - Replace spaces with hyphens
+ * - Remove invalid characters
+ * - Convert to lowercase
+ */
+export declare function sanitizeFeatureName(feature: string): string;
+/**
+ * Get the worktrees root directory (sibling to repo)
+ * Following GitLens/VSCode convention: ../repo-name.worktrees/
+ */
+export declare function getWorktreesRoot(repoPath: string): string;
+/**
+ * Create worktree service
+ * Requirements: 1.3, 1.4 - Factory function for git worktree operations
+ */
+export declare function createWorktreeService(): WorktreeServiceInterface;
+//# sourceMappingURL=WorktreeService.d.ts.map

package/dist/services/WorktreeService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorktreeService.d.ts","sourceRoot":"","sources":["../../src/services/WorktreeService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAChE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACnE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACpF,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;CAC1D;AAiFD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIzD;AAiBD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,wBAAwB,CAiHhE"}