ineedcodes 0.1.5 → 0.2.0

package/agent.mjs

@@ -0,0 +1,244 @@
+#!/usr/bin/env node
+// ineed — minimal, self-contained terminal AI agent. No dependencies.
+
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { spawn } from 'node:child_process';
+import * as readline from 'node:readline';
+
+const VERSION = '0.2.0';
+const CONFIG_DIR = path.join(os.homedir(), '.ineedcodes');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const A = (c, t) => process.stdout.isTTY ? `\x1b[${c}m${t}\x1b[0m` : t;
+const bold = t => A('1', t), dim = t => A('2', t), green = t => A('32', t);
+const red = t => A('31', t), yellow = t => A('33', t), cyan = t => A('36', t), gray = t => A('90', t);
+const trunc = (s, n = 120) => { const o = s.replaceAll('\n', ' '); return o.length > n ? o.slice(0, n - 1) + '…' : o; };
+
+/* ── config ─────────────────────────────────────────────── */
+function loadConfig() {
+  try { return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8')); } catch { return null; }
+}
+function saveConfig(cfg) {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2));
+}
+
+/* ── provider API (OpenAI-compatible) ───────────────────── */
+async function chat(cfg, messages, tools) {
+  const body = { model: cfg.model, messages, temperature: 0.2 };
+  if (tools?.length) body.tools = tools.map(t => ({ type: 'function', function: { name: t.name, description: t.description, parameters: t.parameters } }));
+  const res = await fetch(cfg.baseUrl.replace(/\/+$/, '') + '/chat/completions', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json', authorization: `Bearer ${cfg.apiKey}` },
+    body: JSON.stringify(body)
+  });
+  if (!res.ok) throw new Error(`HTTP ${res.status}: ${(await res.text()).slice(0, 200)}`);
+  return (await res.json()).choices?.[0]?.message ?? { role: 'assistant', content: '', tool_calls: [] };
+}
+
+/* ── tools ──────────────────────────────────────────────── */
+const TOOLS = [
+  { name: 'read_file', description: 'Read a text file (UTF-8).', parameters: { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] } },
+  { name: 'write_file', description: 'Create or overwrite a file.', parameters: { type: 'object', properties: { path: { type: 'string' }, content: { type: 'string' } }, required: ['path', 'content'] } },
+  { name: 'list_files', description: 'List files in a directory (recursive, skips node_modules/.git/dist).', parameters: { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] } },
+  { name: 'shell', description: 'Run a shell command and capture stdout, stderr, exit code.', parameters: { type: 'object', properties: { command: { type: 'string' } }, required: ['command'] } }
+];
+
+function runTool(name, input, cwd) {
+  try {
+    if (name === 'read_file') {
+      const p = path.resolve(cwd, input.path);
+      if (path.basename(p).startsWith('.env') || /(^|\/)\.ssh\//.test(p)) return { ok: false, output: 'Refused: looks like a secret file.' };
+      return { ok: true, output: fs.readFileSync(p, 'utf8').slice(0, 60_000) };
+    }
+    if (name === 'write_file') {
+      const p = path.resolve(cwd, input.path);
+      fs.mkdirSync(path.dirname(p), { recursive: true });
+      fs.writeFileSync(p, input.content);
+      return { ok: true, output: `Wrote ${p} (${input.content.length} bytes).` };
+    }
+    if (name === 'list_files') {
+      const out = [];
+      const skip = new Set(['node_modules', '.git', 'dist', 'build', '.next']);
+      (function walk(d, depth) {
+        if (out.length > 400 || depth > 4) return;
+        for (const e of fs.readdirSync(d, { withFileTypes: true })) {
+          if (skip.has(e.name)) continue;
+          out.push((e.isDirectory() ? e.name + '/' : e.name));
+          if (e.isDirectory()) walk(path.join(d, e.name), depth + 1);
+        }
+      })(path.resolve(cwd, input.path || '.'), 0);
+      return { ok: true, output: out.join('\n') };
+    }
+    if (name === 'shell') {
+      return { ok: true, output: 'RUNNING' }; // replaced by async shellRun
+    }
+    return { ok: false, output: `Unknown tool: ${name}` };
+  } catch (err) {
+    return { ok: false, output: `Error: ${err.message}` };
+  }
+}
+
+function shellRun(command, cwd) {
+  return new Promise(resolve => {
+    const child = spawn(command, { cwd, shell: true, env: { ...process.env, NO_COLOR: '1' } });
+    let out = '';
+    const timer = setTimeout(() => { try { child.kill('SIGKILL'); } catch {} out += '\n[timeout after 120s]'; }, 120_000);
+    child.stdout.on('data', c => { out += c.toString(); if (out.length > 100_000) child.kill('SIGKILL'); });
+    child.stderr.on('data', c => { out += c.toString(); });
+    child.on('close', code => { clearTimeout(timer); resolve({ ok: code === 0, output: `exit code: ${code}\n${out.slice(0, 20_000)}` }); });
+    child.on('error', err => { clearTimeout(timer); resolve({ ok: false, output: `spawn error: ${err.message}` }); });
+  });
+}
+
+/* ── agent loop ─────────────────────────────────────────── */
+const SYSTEM = `You are ineed, an autonomous terminal agent on the user's machine.
+Rules:
+- Use the tools to do real work. Never invent command output; success claims need evidence.
+- Prefer targeted edits over full rewrites. Work only inside the current folder.
+- Never push to remotes or delete data without being asked.
+- When the objective is met, reply with the final result: what changed, what you ran, and the evidence.`;
+
+async function runObjective(cfg, objective, cwd, history) {
+  const messages = [
+    { role: 'system', content: `${SYSTEM}\nWorking directory: ${cwd}` },
+    ...history,
+    { role: 'user', content: objective }
+  ];
+  let answer = '';
+
+  for (let step = 0; step < 30; step++) {
+    const msg = await chat(cfg, messages, TOOLS);
+    messages.push(msg);
+
+    if (msg.content) { console.log('  ' + dim(trunc(msg.content, 200))); answer = msg.content; }
+    const calls = msg.tool_calls ?? [];
+    if (calls.length === 0) return { answer, history: [{ role: 'user', content: objective }, { role: 'assistant', content: answer }] };
+
+    for (const call of calls) {
+      const input = JSON.parse(call.function?.arguments || '{}');
+      console.log('  ' + cyan('▸ ' + call.function?.name) + ' ' + gray(trunc(call.function?.arguments || '', 90)));
+      let result;
+      if (call.function?.name === 'shell') result = await shellRun(input.command, cwd);
+      else result = runTool(call.function?.name, input, cwd);
+      console.log('  ' + (result.ok ? green('◂ ok') : red('◂ fail')) + ' ' + gray(trunc(result.output, 100)));
+      messages.push({ role: 'tool', tool_call_id: call.id, content: result.output.slice(0, 20_000) });
+    }
+  }
+  return { answer: answer || 'Stopped: too many steps.', history: [{ role: 'user', content: objective }, { role: 'assistant', content: answer }] };
+}
+
+/* ── setup wizard ───────────────────────────────────────── */
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+let askQueue = [];
+let askPending = null;
+let wizardMode = true;
+let replHandler = null;
+rl.on('line', l => {
+  const line = l.trim();
+  if (askPending) { const r = askPending; askPending = null; r(line); return; }
+  if (wizardMode) { askQueue.push(line); return; }
+  if (replHandler) replHandler(line);
+});
+rl.on('close', () => { if (askPending) { const r = askPending; askPending = null; r(''); } });
+const ask = q => new Promise(res => {
+  process.stdout.write(q + ' ');
+  if (askQueue.length > 0) res(askQueue.shift());
+  else askPending = res;
+});
+
+async function wizard() {
+  console.log('\n' + bold('Welcome to ineed!') + ' Let me connect to your AI provider. One time only.\n');
+  const baseUrl = await ask(cyan('1. API base URL (e.g. https://api.openai.com/v1):'));
+  const apiKey = await ask(cyan('2. API key:'));
+  if (!baseUrl || !apiKey) { console.log(red('Both are required. Run `ineed` again.')); process.exit(1); }
+  console.log(dim('\nChecking…'));
+  let models = [];
+  try {
+    const res = await fetch(baseUrl.replace(/\/+$/, '') + '/models', { headers: { authorization: `Bearer ${apiKey}` } });
+    if (res.ok) models = (await res.json()).data?.map(m => m.id).filter(Boolean) ?? [];
+  } catch {}
+  if (models.length > 0) console.log(green(`✓ Connected. ${models.length} models found.`));
+  else console.log(yellow('⚠ Could not list models (some servers hide them). Type a model id from the provider docs.'));
+  const model = await ask(cyan(`3. Model id ${models.length ? '(e.g. ' + (models.find(m => /gpt-4o-mini|fast|flash/i.test(m)) ?? models[0]) + ')' : ''}:`));
+  if (!model) { console.log(red('Model is required. Run `ineed` again.')); process.exit(1); }
+
+  console.log(dim('\nSending a test message…'));
+  try {
+    const m = await chat({ baseUrl, apiKey, model }, [{ role: 'user', content: 'Reply with exactly: OK' }]);
+    console.log(green('✓ Works!') + dim(` model replied: ${trunc(m.content ?? '', 40)}`));
+  } catch (err) {
+    console.log(yellow(`⚠ Test failed: ${err.message}`));
+    const keep = await ask(yellow('Save anyway? [y/N]:'));
+    if (!/^y/i.test(keep)) { console.log(dim('Not saved. Run `ineed` to retry.')); process.exit(1); }
+  }
+  saveConfig({ baseUrl, apiKey, model });
+  console.log(green('\nSaved to ' + CONFIG_FILE));
+  console.log('All set! Type your goal below.\n');
+}
+
+/* ── main ───────────────────────────────────────────────── */
+const args = process.argv.slice(2);
+if (args[0] === '--version' || args[0] === '-v') { console.log(`ineed ${VERSION}`); process.exit(0); }
+if (args[0] === '--help' || args[0] === '-h') {
+  console.log(`
+${bold('ineed')} v${VERSION} — your terminal, now autonomous
+
+  ${cyan('ineed')}                     interactive session here
+  ${cyan('ineed "do something"')}     one-shot task
+  ${cyan('ineed --reset')}            forget saved config and run the wizard again
+`);
+  process.exit(0);
+}
+
+const cwd = process.cwd();
+let cfg = loadConfig();
+if (args[0] === '--reset') { try { fs.unlinkSync(CONFIG_FILE); } catch {} cfg = null; }
+
+if (!cfg) { await wizard(); cfg = loadConfig(); }
+
+if (args.length) {
+  const { answer } = await runObjective(cfg, args.join(' '), cwd, []);
+  console.log('\n' + bold(green('Done')) + (answer ? '\n  ' + trunc(answer, 500) : ''));
+  process.exit(0);
+}
+
+console.log(bold(green('ineed')) + dim(` v${VERSION} · ${cfg.model} · ${cwd}`));
+console.log(dim('Say what you want. /help for commands. Ctrl+C twice to exit.\n'));
+
+// main REPL reuses the shared rl above
+rl.setPrompt('\n' + bold(green('ineed')) + dim(' ❯ '));
+let lastAnswer = '';
+const history = [];
+
+const handleLine = async input => {
+  if (!input) { rl.prompt(); return; }
+  if (input === '/exit' || input === '/quit' || input === 'exit') { console.log(dim('Goodbye.')); process.exit(0); }
+  if (input === '/help') {
+    console.log('  ' + cyan('/model') + '   show or change model   ' + cyan('/reset') + '  redo setup   ' + cyan('/exit') + '  quit');
+    rl.prompt(); return;
+  }
+  if (input.startsWith('/model')) {
+    console.log('Model: ' + bold(cfg.model) + dim(' — change with `ineed --reset` or edit ' + CONFIG_FILE));
+    rl.prompt(); return;
+  }
+  if (input === '/reset') { try { fs.unlinkSync(CONFIG_FILE); } catch {} console.log(dim('Config cleared. Exiting: run `ineed` to set up again.')); process.exit(0); }
+
+  try {
+    const { answer, history: h } = await runObjective(cfg, input, cwd, history);
+    history.push(...h);
+    lastAnswer = answer;
+    console.log('\n' + bold(green('Done')) + (answer ? '\n  ' + answer.split('\n').slice(0, 12).join('\n  ') : ''));
+  } catch (err) {
+    console.log(red('\nError: ' + err.message));
+  }
+  rl.prompt();
+};
+
+wizardMode = false;
+replHandler = handleLine;
+const backlog = askQueue.splice(0);
+for (const line of backlog) await handleLine(line);
+rl.prompt();
+rl.on('SIGINT', () => { console.log(dim('\nGoodbye.')); process.exit(0); });

package/package.json

@@ -1,36 +1,16 @@
 {
   "name": "ineedcodes",
-  "version": "0.1.5",
-  "description": "ineed — your terminal, now autonomous. CLI-first general-purpose autonomous AI agent.",
+  "version": "0.2.0",
+  "description": "ineed: your terminal, now autonomous. Minimal, self-contained AI agent.",
   "license": "MIT",
   "type": "module",
   "bin": {
-    "ineed": "packages/cli/dist/index.js"
-  },
-  "files": [
-    "packages/core/dist",
-    "packages/agent/dist",
-    "packages/cli/dist",
-    "packages/core/package.json",
-    "packages/agent/package.json",
-    "packages/cli/package.json",
-    "docs",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "prepare": "npm run build",
-    "build": "tsc -b packages/core packages/agent packages/cli",
-    "clean": "rm -rf packages/*/dist",
-    "typecheck": "tsc -b packages/core packages/agent packages/cli --force",
-    "dev": "npm run build && node packages/cli/dist/index.js"
+    "ineed": "agent.mjs"
   },
+  "scripts": {},
   "engines": {
     "node": ">=20.0.0"
   },
-  "workspaces": [
-    "packages/*"
-  ],
   "repository": {
     "type": "git"
   },
@@ -47,5 +27,10 @@
     "@types/node": "^22.10.2",
     "esbuild": "^0.28.2",
     "typescript": "^5.6.3"
-  }
+  },
+  "files": [
+    "agent.mjs",
+    "README.md",
+    "LICENSE"
+  ]
 }

package/docs/assets/ineed-logo.svg

@@ -1,161 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="1380" height="406" viewBox="0 0 1380 406">
-  <defs>
-    <linearGradient id="bg" x1="0" y1="0" x2="0" y2="1">
-      <stop offset="0" stop-color="#161b22"/>
-      <stop offset="1" stop-color="#0d1117"/>
-    </linearGradient>
-  </defs>
-  <!-- terminal window -->
-  <rect x="2" y="2" width="1376" height="402" rx="18" fill="url(#bg)" stroke="#30363d" stroke-width="2"/>
-  <!-- traffic lights -->
-  <circle cx="60" cy="28" r="7" fill="#ff5f57"/>
-  <circle cx="86" cy="28" r="7" fill="#febc2e"/>
-  <circle cx="112" cy="28" r="7" fill="#28c840"/>
-  <text x="1320" y="33" text-anchor="end" font-family="ui-monospace, Menlo, monospace" font-size="14" fill="#8b949e">~/project: ineed</text>
-
-  <!-- INEED block art -->
-    <rect x="60" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="90" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="120" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="60" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="90" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="60" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="90" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="60" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="90" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="60" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="90" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="60" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="90" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="120" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="210" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="240" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="270" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="450" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="480" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="210" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="240" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="270" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="300" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="450" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="480" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="210" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="240" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="270" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="300" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="330" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="360" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="450" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="210" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="240" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="270" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="330" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="360" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="390" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="450" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="210" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="240" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="270" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="360" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="390" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="420" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="450" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="210" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="240" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="270" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="360" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="390" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="420" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="450" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="480" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="570" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="600" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="630" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="660" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="690" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="720" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="750" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="570" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="600" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="570" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="600" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="630" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="570" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="600" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="570" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="600" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="630" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="660" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="690" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="570" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="600" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="630" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="660" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="690" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="720" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="840" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="870" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="900" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="930" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="960" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="990" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="1020" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="840" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="870" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="840" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="870" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="900" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="840" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="870" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="840" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="870" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="900" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="930" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="960" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="840" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="870" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="900" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="930" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="960" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="990" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="1110" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="1140" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="1170" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="1200" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="1230" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="1260" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="1290" y="90" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="1110" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="1140" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="1260" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="1290" y="120" width="27" height="27" rx="4" fill="#4ade80"/>
-  <rect x="1110" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="1140" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="1260" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="1290" y="150" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="1110" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="1140" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="1260" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="1290" y="180" width="27" height="27" rx="4" fill="#22d3ee"/>
-  <rect x="1110" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="1140" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="1170" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="1200" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="1230" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="1260" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="1290" y="210" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="1110" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="1140" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="1170" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="1200" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="1230" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-  <rect x="1260" y="240" width="27" height="27" rx="4" fill="#e879f9"/>
-
-  <!-- prompt line -->
-  <text x="60" y="296" font-family="ui-monospace, Menlo, monospace" font-size="26">
-    <tspan fill="#4ade80">❯</tspan><tspan fill="#e6edf3" dx="14">ineed</tspan><tspan fill="#8b949e" dx="14">"fix the build errors"</tspan><tspan fill="#4ade80">▮</tspan>
-  </text>
-
-  <!-- tagline -->
-  <text x="60" y="348" font-family="ui-monospace, Menlo, monospace" font-size="17" letter-spacing="4" fill="#6e7681">YOUR TERMINAL, NOW AUTONOMOUS</text>
-</svg>

package/docs/configuration.md

@@ -1,71 +0,0 @@
-# Configuration Reference
-
-iNeedCodes reads `~/.ineedcodes/config.json`. Every field is optional; environment variables work too.
-
-## Providers (LLM)
-
-Any OpenAI-compatible endpoint works (OpenAI, iNeed API, local servers, …):
-
-```json
-{
-  "providers": {
-    "default": { "baseUrl": "https://api.openai.com/v1", "apiKey": "sk-...", "model": "gpt-4.1-mini" },
-    "fast":    { "baseUrl": "http://localhost:11434/v1", "apiKey": "x", "model": "qwen2.5-coder", "contextLimit": 32768 }
-  },
-  "defaultProvider": "default",
-  "roleProviders": { "lead": "default", "research": "fast" }
-}
-```
-
-Environment variables: `INEEDCODES_BASE_URL`, `INEEDCODES_API_KEY`, `INEEDCODES_MODEL`.
-
-## Permissions
-
-```json
-{ "permissions": { "mode": "workspace", "allow": ["git_remote"], "deny": ["destructive"], "maxParallelAgents": 4 } }
-```
-
-- `ask`: every tool action needs approval.
-- `workspace` (default): reading, writing, and running commands inside the project
-  flow freely; outside-workspace access, remote Git pushes, destructive operations,
-  and secret access need approval.
-- `autonomous`: no interruptions (use with care).
-
-Change at runtime with `/permissions <mode>` or `ineedcodes -p <mode>`.
-
-## Memory
-
-```json
-{ "memory": { "backend": "icm" } }
-```
-
-ICM is the memory engine. Each project gets an isolated database at
-`~/.ineedcodes/projects/<project-id>/memory/icm.db`. Memories never mix
-between repositories. Set `"backend": "off"` to disable.
-
-## Web search (optional)
-
-```json
-{ "webSearch": { "provider": "brave", "apiKey": "..." } }
-```
-
-Without it, `fetch_url` still works for known URLs and the agent honestly
-reports that search is unavailable instead of pretending.
-
-## MCP servers (optional)
-
-```json
-{
-  "mcpServers": {
-    "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_TOKEN": "..." } }
-  }
-}
-```
-
-MCP tools appear in the normal registry as `mcp_<server>_<tool>` and need no
-special handling by the agent. A failing server is reported, never fatal.
-
-## Project instructions
-
-Drop an `AGENTS.md` or `.ineedcodes/instructions.md` in your repository and
-the agent applies them automatically when working there.

package/docs/skills.md

@@ -1,58 +0,0 @@
-# Skills in iNeedCodes
-
-Skills are portable instruction packs that teach the agent specialized workflows.
-A skill is a folder with a single `SKILL.md` file using YAML frontmatter.
-
-## Format
-
-```markdown
----
-name: my-skill
-description: One sentence: when the agent should use this skill.
-version: 1.0.0          # optional
-allowed-tools:          # optional hint, informational
-  - read_file
-  - search_text
----
-
-# My Skill
-
-Instructions the agent follows when the skill is active...
-```
-
-## Locations (priority order)
-
-1. **Project**: `<project>/.ineedcodes/skills/<name>/SKILL.md`
-2. **Project (alternate)**: `<project>/skills/<name>/SKILL.md`
-3. **Global user**: `~/.ineedcodes/skills/<name>/SKILL.md`
-4. **Built-in**: shipped with iNeedCodes (`boost`, `humanizer`)
-
-A project skill with the same name overrides the global one, which overrides
-the built-in. `/skills` shows each skill's scope so overrides are visible.
-
-## Invocation
-
-- Explicit: `/boost`, `/humanizer`, or just name the skill in a sentence.
-- Natural: *"Use boost to verify this implementation."*
-- Automatic: the Lead Agent may pick a skill when its description clearly matches the task.
-
-## Built-in: boost
-
-An advanced execution-and-verification protocol. When invoked, the agent:
-
-1. Creates an isolated Git worktree (`.ineedcodes/boost-<timestamp>`)
-2. Investigates root causes
-3. Implements changes there; your working tree stays clean
-4. Runs tests with real evidence
-5. Verifies independently
-6. Reconciles (merges) only on success, with your approval
-7. Cleans up the worktree either way
-
-A failed Boost run never merges broken changes. Good for hard debugging,
-major refactors, and regression-sensitive work. Simple tasks should not use it.
-
-## Built-in: humanizer
-
-Rewrites prose (README, docs, release notes, explanations) so it reads naturally.
-Never applied to code, JSON, YAML, commands, or technical values. Meaning and
-technical facts are always preserved.

package/packages/agent/dist/boost.d.ts

@@ -1,34 +0,0 @@
-import type { ToolRegistry, ToolContext, ToolResult } from '@ineedcodes/core';
-/**
- * Boost integration (plan §19–20): an advanced execution and verification
- * protocol running on top of the multi-agent runtime, in an isolated
- * Git worktree. The user's active working tree stays clean.
- *
- * Lifecycle: start → investigate → implement → test → verify → reconcile | abort → cleanup
- */
-export type BoostPhase = 'start' | 'investigate' | 'implement' | 'test' | 'verify' | 'reconcile' | 'abort' | 'cleanup';
-export interface BoostRun {
-    id: string;
-    worktreePath: string;
-    branch: string;
-    phase: BoostPhase;
-    startedAt: number;
-}
-export declare class BoostIntegration {
-    private readonly registry;
-    private readonly toolContext;
-    private readonly emit;
-    private run?;
-    constructor(registry: ToolRegistry, toolContext: ToolContext, emit: (event: import('./events.js').RuntimeEvent) => Promise<void>);
-    active(): boolean;
-    current(): BoostRun | undefined;
-    private exec;
-    start(objective: string): Promise<ToolResult>;
-    worktreeContext(): ToolContext | undefined;
-    /** Commit any uncommitted work inside the Boost worktree so it can merge. */
-    private commitWorktreeChanges;
-    reconcile(): Promise<ToolResult>;
-    abort(reason: string): Promise<ToolResult>;
-    cleanup(): Promise<ToolResult>;
-}
-export declare const BOOST_PHASES: readonly BoostPhase[];