closed-loop-cli 1.0.2 → 1.0.4

package/CLAUDE.md

@@ -0,0 +1,17 @@
+# CLAUDE.md - Project Development Guidelines
+
+## Project Commands
+- **Build**: `npm run build` (Compiles TypeScript files into `dist/`)
+- **Run CLI**: `npm start` (Runs the compiled CLI application)
+- **Run Tests**: `npm test` (Executes the test suite and self-eval task)
+
+## Code Quality & Linting
+- Ensure typescript compiles with zero warnings or errors.
+- Do not check in `dist/` files to Git.
+
+## Coding Style & Principles
+1. **TypeScript & Types**: Avoid `any` types. Provide explicit interfaces for options, configuration, and API responses.
+2. **File Operations**: Use the custom tools in `src/tools/file-tools.ts` for file interactions.
+3. **Execution Safety**: Always wrap external commands in a timeout and check their exit codes.
+4. **Self-Healing Loop**: The agent must record failures in `Learnings.md` and attempt to heal them by editing files and re-running tests.
+5. **No Placeholders**: Write fully functional implementations.

package/Learnings.md

@@ -0,0 +1,73 @@
+# Persistent Repository Learnings
+
+This file acts as a local, repository-versioned memory layer for the coding agent. Before each task, the agent reads this file along with `CLAUDE.md`. Upon completion of any task, the agent appends its findings below in the strict format.
+
+## Format Guidelines
+For every completed or failed task, append a new section at the end of the file:
+```markdown
+### [YYYY-MM-DD] - [Task/Goal Title]
+- **Observation (สิ่งที่พบ)**: Describe the problem, codebase quirks, linter failures, or unexpected behaviors.
+- **Action (การแก้ไข)**: Describe how the problem was resolved (e.g. prompt edits, specific file modifications, library upgrades).
+- **Confidence (ความมั่นใจ 0-1)**: Score representing how robust the solution is.
+```
+
+---
+## Learnings History
+
+### 2026-06-05 - Initial Setup
+- **Observation (สิ่งที่พบ)**: Workspace was empty except for DOCX documentation.
+- **Action (การแก้ไข)**: Initialized Node.js, TSConfig, CLAUDE.md, and core file/shell tools for the agent.
+- **Confidence (ความมั่นใจ 0-1)**: 1.0
+
+### 2026-06-05 - Add fileExists Helper Function
+- **Observation (สิ่งที่พบ)**: `src/tools/file-tools.ts` had `readFile`, `writeFile`, `editFile`, `listDir`, and `grepSearch` but lacked a simple boolean existence check.
+- **Action (การแก้ไข)**: Added `fileExists(filePath: string, workspaceRoot?: string): boolean` that resolves the path via `resolveWorkspacePath` and returns `fs.existsSync(resolved)`. Placed it between `readFile` and `writeFile` for logical grouping. Build and all tests passed.
+- **Confidence (ความมั่นใจ 0-1)**: 1.0
+
+### 2024-12-05 - Add helper function fileExists to file-tools.ts
+- **Observation (สิ่งที่พบ)**: The implementation was successful. Adding the `fileExists` function using `fs.existsSync` and the existing `resolveWorkspacePath` utility integrated cleanly. The build (`npm run build`) and test suite (`npm test`) both passed without errors or failures.
+- **Action (การแก้ไข)**: 
+    1. Added the `fileExists` function to `src/tools/file-tools.ts` with the implementation: `export const fileExists = (path: string): boolean => { const resolved = resolveWorkspacePath(path); return fs.existsSync(resolved); };`
+    2. Executed `npm run build` to verify TypeScript compilation.
+    3. Executed `npm test` to run the full test suite and verify functionality.
+- **Confidence (ความมั่นใจ 0-1)**: 1.0
+
+### 2025-04-24 - Add a comment to shell-tools.ts
+- **Observation (สิ่งที่พบ)**: The task was straightforward and completed successfully. Adding a single-line comment at the top of a TypeScript file (`src/tools/shell-tools.ts`) did not introduce any linter or compilation errors, and the subsequent TypeScript build (`npm run build`) passed cleanly. The codebase accepted the change without any quirks or side effects.
+- **Action (การแก้ไข)**: Added the comment `// Utility wrapper for shell execution.` as the first line of the file. Verified the change by running `npm run build`, which returned zero errors.
+- **Confidence (ความมั่นใจ 0-1)**: 0.95
+
+### 2024-07-23 - Compilation Error Handling Test
+- **Observation (สิ่งที่พบ)**: Injecting a function with an intentional TypeScript syntax error (referencing an undeclared variable) correctly caused the compiler to fail with exit code 2 and a `TS2304` error. The self-healing loop (reverting the faulty code, then rebuilding and retesting) successfully restored the codebase to a passing state.
+- **Action (การแก้ไข)**: Executed a test that added a broken function (`getFileSizeWithBrokenRef`) referencing `nonExistentVar`, triggered a build to confirm the compilation failure, then reverted the change and verified the build and all tests passed cleanly.
+- **Confidence (ความมั่นใจ 0-1)**: 0.95
+
+### 2025-10-15 - Search for the latest version of Node.js and print it
+- **Observation (สิ่งที่พบ)**: The agent successfully performed a web search and synthesized the results to provide a clear, structured summary of the latest Node.js versions (Current, LTS, and Maintenance). It also correctly compared the found LTS version (v24.11.0) to the locally running version (v24.16.0) in the workspace.
+- **Action (การแก้ไข)**: The agent generated a formatted markdown table and "Key Takeaways" section to present the search results, effectively clarifying the release lines and their recommended use cases.
+- **Confidence (ความมั่นใจ 0-1)**: 0.95
+
+### 2024-01-24 - Write a comment inside src/index.ts stating that Phase 3 is initialized
+- **Observation (สิ่งที่พบ)**: The task was completed successfully and cleanly. The build passed after adding the comment, indicating no syntax or build-system issues were introduced.
+- **Action (การแก้ไข)**: Added the comment `// Phase 3 is initialized` to the file `src/index.ts`, placing it immediately after the import statements.
+- **Confidence (ความมั่นใจ 0-1)**: 0.9
+
+### 2026-06-06 - Web Dashboard Monitor Integration
+- **Observation (สิ่งที่พบ)**: Adding a web dashboard to monitor the evolution daemon introduces build-safety quirks. Because the continuous daemon runs `git reset --hard HEAD` and `git clean -fd` when a SAHOO gate check fails or a compile error occurs, any newly created untracked files are wiped out instantly.
+- **Action (การแก้ไข)**: Temporarily halted the daemon, built a zero-dependency HTTP server served on port 3000, and immediately added/committed the dashboard files to Git HEAD. Now the files are fully preserved during resets.
+- **Confidence (ความมั่นใจ 0-1)**: 1.0
+
+### 2026-06-06 - Create Program Launchers for Windows
+- **Observation (สิ่งที่พบ)**: Running the agent CLI, dashboard server, and daemon on Windows requires multiple terminals and commands (compilation + execution). Batch files are an effective way to simplify this for Windows users.
+- **Action (การแก้ไข)**: Created `start-agent-cli.bat`, `start-dashboard.bat`, and `start-evolution-daemon.bat` at the root of the workspace. These scripts automatically handle `node_modules` checking, TypeScript compilation (`npm run build`), launching the processes, and opening default browsers.
+- **Confidence (ความมั่นใจ 0-1)**: 1.0
+
+### 2026-06-06 - Enhance Autonomous Agent Loop and Dashboard UI
+- **Observation (สิ่งที่พบ)**: The agent requirements in the document demand high-effort settings ("ultracode"), role-based boundaries (explorer vs worker), destination path sanitization checks, and programmatic logging of agent decisions and attempts (Live Research Manager).
+- **Action (การแก้ไข)**:
+    1. Implemented `ResearchManager` to write sessions and decisions to `research-log.json`.
+    2. Updated `runTaskAgent` and `runSelfImprovingTask` to support `--effort` / `ultracode` settings, allowing extended steps (up to 45) and strict prompts for alternate architecture scanning, regression detection, and precise filepath outputs.
+    3. Added `/api/research` to `server.ts` and integrated a visual "Live Research Log" timeline into the HTML, JS, and CSS files of the web dashboard.
+- **Confidence (ความมั่นใจ 0-1)**: 1.0
+
+

package/dist/index.js

@@ -38,20 +38,19 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const readline = __importStar(require("readline"));
 const dotenv = __importStar(require("dotenv"));
-const autogenesis_1 = require("./orchestrator/autogenesis");
+const os = __importStar(require("os"));
 const server_1 = require("./dashboard/server");
 const telegram_bot_1 = require("./orchestrator/telegram-bot");
 const task_agent_1 = require("./orchestrator/task-agent");
-// Phase 3 is initialized
 // Load environment variables
 dotenv.config();
 function printHeader() {
-    const banner = `
-\x1b[38;5;99m   ___ _                     _   _                     
-  / __\\ | ___  ___  ___  __| | | | ___   ___  _ __     
- / /  | |/ _ \\/ __|/ _ \\/ _\` | | |/ _ \\ / _ \\| '_ \\    
-/ /___| | (_) \\__ \\  __/ (_| | | | (_) | (_) | |_) |   
-\\____/|_|\\___/|___/\\___|\\__,_| |_|\\___/ \\___/| .__/    
+    const banner = `
+\x1b[38;5;99m   ___ _                     _   _                     
+  / __\\ | ___  ___  ___  __| | | | ___   ___  _ __     
+ / /  | |/ _ \\/ __|/ _ \\/ _\` | | |/ _ \\ / _ \\| '_ \\    
+/ /___| | (_) \\__ \\  __/ (_| | | | (_) | (_) | |_) |   
+\\____/|_|\\___/|___/\\___|\\__,_| |_|\\___/ \\___/| .__/    
                                              |_|       \x1b[0m`;
     console.log(banner);
     console.log('\x1b[37mTips for getting started:\x1b[0m');
@@ -91,12 +90,12 @@ class ClosedLoopTUI {
         // Clear screen and move cursor to 1,1
         process.stdout.write('\x1b[2J\x1b[H');
         // 1. Draw Banner & Info
-        const banner = `
-\x1b[38;5;99m   ___ _                     _   _                     
-  / __\\ | ___  ___  ___  __| | | | ___   ___  _ __     
- / /  | |/ _ \\/ __|/ _ \\/ _\` | | |/ _ \\ / _ \\| '_ \\    
-/ /___| | (_) \\__ \\  __/ (_| | | | (_) | (_) | |_) |   
-\\____/|_|\\___/|___/\\___|\\__,_| |_|\\___/ \\___/| .__/    
+        const banner = `
+\x1b[38;5;99m   ___ _                     _   _                     
+  / __\\ | ___  ___  ___  __| | | | ___   ___  _ __     
+ / /  | |/ _ \\/ __|/ _ \\/ _\` | | |/ _ \\ / _ \\| '_ \\    
+/ /___| | (_) \\__ \\  __/ (_| | | | (_) | (_) | |_) |   
+\\____/|_|\\___/|___/\\___|\\__,_| |_|\\___/ \\___/| .__/    
                                              |_|       \x1b[0m`;
         console.log(banner);
         console.log('\x1b[37mTips for getting started:\x1b[0m');
@@ -240,20 +239,50 @@ async function startInteractiveCLI(effort = 'standard', codeactMode = false) {
     const tui = new ClosedLoopTUI(effort);
     tui.start();
 }
-function setupLogRedirection() {
-    const logFile = fs.createWriteStream(path.join(process.cwd(), 'evolution.log'), { flags: 'a' });
-    const originalLog = console.log;
-    const originalError = console.error;
-    console.log = function (...args) {
-        originalLog.apply(console, args);
-        logFile.write(args.join(' ') + '\n');
-    };
-    console.error = function (...args) {
-        originalError.apply(console, args);
-        logFile.write('ERROR: ' + args.join(' ') + '\n');
+async function checkAndPromptAPIKey() {
+    if (process.env.ANTHROPIC_API_KEY || process.env.ANTHROPIC_AUTH_TOKEN) {
+        return process.env.ANTHROPIC_API_KEY || process.env.ANTHROPIC_AUTH_TOKEN || '';
+    }
+    const configPath = path.join(os.homedir(), '.closed-loop.json');
+    if (fs.existsSync(configPath)) {
+        try {
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            if (config.apiKey) {
+                process.env.ANTHROPIC_API_KEY = config.apiKey;
+                return config.apiKey;
+            }
+        }
+        catch (e) { }
+    }
+    console.log('\n\x1b[33m🔑 Anthropic API key not found in environment or local .env file.\x1b[0m');
+    console.log('To run this assistant, please configure your API key below.');
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    const question = (query) => {
+        return new Promise(resolve => rl.question(query, resolve));
     };
+    const key = await question('\x1b[35mEnter your Anthropic API Key:\x1b[0m ');
+    rl.close();
+    const trimmedKey = key.trim();
+    if (!trimmedKey) {
+        console.error('\x1b[31mError: API Key cannot be empty.\x1b[0m');
+        process.exit(1);
+    }
+    try {
+        fs.writeFileSync(configPath, JSON.stringify({ apiKey: trimmedKey }, null, 2), 'utf8');
+        console.log(`\x1b[32m✔ Saved API key to ${configPath}\x1b[0m\n`);
+    }
+    catch (err) {
+        console.warn(`\x1b[33mWarning: Could not save API key to config: ${err.message}\x1b[0m`);
+    }
+    process.env.ANTHROPIC_API_KEY = trimmedKey;
+    return trimmedKey;
 }
 async function main() {
+    // Ensure API Key is configured before running any agent logic
+    await checkAndPromptAPIKey();
     const args = process.argv.slice(2);
     // Parse codeact option
     let codeactMode = false;
@@ -302,107 +331,8 @@ async function main() {
                 process.exit(1);
             }
         }
-        const isContinuous = args.includes('--continuous') || args.includes('-c');
-        if (isContinuous) {
-            try {
-                let cycles = 0; // infinite
-                const cyclesIdx = args.indexOf('--cycles');
-                if (cyclesIdx !== -1 && cyclesIdx + 1 < args.length) {
-                    cycles = parseInt(args[cyclesIdx + 1], 10) || 0;
-                }
-                let tokenBudget = 500000; // default 500k tokens
-                const budgetIdx = args.indexOf('--budget-tokens');
-                if (budgetIdx !== -1 && budgetIdx + 1 < args.length) {
-                    tokenBudget = parseInt(args[budgetIdx + 1], 10) || 500000;
-                }
-                console.log(`\n\x1b[33m[Running Continuous Self-Evolution Daemon Mode]\x1b[0m`);
-                console.log(`- Cycle Limit:  ${cycles === 0 ? 'Infinite' : cycles}`);
-                console.log(`- Token Budget: ${tokenBudget} tokens\n`);
-                setupLogRedirection();
-                (0, server_1.startDashboardServer)();
-                (0, telegram_bot_1.startTelegramBot)();
-                const engine = new autogenesis_1.AutogenesisEngine();
-                engine.setEffort(effort);
-                engine.codeactMode = codeactMode;
-                await engine.runContinuousEvolution(cycles, tokenBudget);
-                console.log('\n\x1b[32m[Continuous Self-Evolution Daemon Stopped Cleanly]\x1b[0m');
-                process.exit(0);
-            }
-            catch (err) {
-                console.error('\n\x1b[31m[Continuous Self-Evolution Daemon Failed]:\x1b[0m', err.message);
-                process.exit(1);
-            }
-        }
-        if (args[0] === '--refactor') {
-            try {
-                console.log(`\n\x1b[33m[Running Autonomous Refactoring Mode]\x1b[0m`);
-                const engine = new autogenesis_1.AutogenesisEngine();
-                engine.setEffort(effort);
-                engine.codeactMode = codeactMode;
-                await engine.runAutonomousRefactor();
-                console.log('\n\x1b[32m[Autonomous Refactoring Completed]\x1b[0m');
-                process.exit(0);
-            }
-            catch (err) {
-                console.error('\n\x1b[31m[Autonomous Refactoring Failed]:\x1b[0m', err.message);
-                process.exit(1);
-            }
-        }
-        if (args[0] === '--optimize-prompt') {
-            try {
-                console.log(`\n\x1b[33m[Running Prompt Optimization Benchmarking Mode]\x1b[0m`);
-                const engine = new autogenesis_1.AutogenesisEngine();
-                engine.setEffort(effort);
-                engine.codeactMode = codeactMode;
-                await engine.runPromptOptimization();
-                console.log('\n\x1b[32m[Prompt Optimization Completed]\x1b[0m');
-                process.exit(0);
-            }
-            catch (err) {
-                console.error('\n\x1b[31m[Prompt Optimization Failed]:\x1b[0m', err.message);
-                process.exit(1);
-            }
-        }
-        if (args[0] === '--dgm') {
-            try {
-                // Parse optional --generations N flag
-                let maxGenerations = 5;
-                const genIdx = args.indexOf('--generations');
-                if (genIdx !== -1 && genIdx + 1 < args.length) {
-                    maxGenerations = parseInt(args[genIdx + 1], 10) || 5;
-                    args.splice(genIdx, 2);
-                }
-                // Task is everything after --dgm flag
-                const dgmTask = args.slice(1).join(' ') || 'Improve the codebase using open-ended evolution';
-                console.log(`\n\x1b[33m[Running DGM (Darwin Gödel Machine) Evolution Mode]\x1b[0m`);
-                console.log(`Task: "${dgmTask}" | Generations: ${maxGenerations}\n`);
-                const engine = new autogenesis_1.AutogenesisEngine();
-                engine.setEffort(effort);
-                engine.codeactMode = codeactMode;
-                await engine.runDGMEvolution(dgmTask, maxGenerations);
-                console.log('\n\x1b[32m[DGM Evolution Completed]\x1b[0m');
-                process.exit(0);
-            }
-            catch (err) {
-                console.error('\n\x1b[31m[DGM Evolution Failed]:\x1b[0m', err.message);
-                process.exit(1);
-            }
-        }
-        // Direct command execution
-        const task = args.join(' ');
-        try {
-            console.log(`Running direct task: "${task}" (CodeAct=${codeactMode})`);
-            const engine = new autogenesis_1.AutogenesisEngine();
-            engine.setEffort(effort);
-            engine.codeactMode = codeactMode;
-            await engine.runEvolutionStep(task);
-            console.log('\n\x1b[32m[Evolution Step Completed]\x1b[0m');
-            process.exit(0);
-        }
-        catch (err) {
-            console.error('\n\x1b[31m[Evolution Failed]:\x1b[0m', err.message);
-            process.exit(1);
-        }
+        console.log(`Unknown option: ${args[0]}. Running interactive session...`);
+        await startInteractiveCLI(effort, codeactMode);
     }
     else {
         // Start interactive session

package/package.json

@@ -1,17 +1,11 @@
 {
   "name": "closed-loop-cli",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Self-Developing Multi-Agent CLI Coding Assistant",
   "main": "dist/index.js",
   "bin": {
     "closed-loop": "dist/index.js"
   },
-  "files": [
-    "dist",
-    "src",
-    "README.md",
-    "docs"
-  ],
   "type": "commonjs",
   "scripts": {
     "build": "tsc",