ineedcodes 1.1.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ineedcodes",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Your terminal, now autonomous. Just say what you want, ineed does the rest.",
   "license": "MIT",
   "type": "module",

package/src/agent.js

@@ -4,6 +4,7 @@ import { chat } from './provider.js';
 import { TOOLS, runTool, shellRun, isDestructive } from './tools.js';
 import { trunc, gray, cyan, dim } from './ui.js';
 import { getMemoryProvider } from './memory.js';
+import * as path from 'node:path';
 
 export const MAX_STEPS = 30;
 export const MAX_HISTORY_CHARS = 30_000;
@@ -17,6 +18,8 @@ Rules:
 - Destructive commands are always blocked. Ask the user to run those themselves.
 - Some actions need user approval. A tool result starting with "Denied" means the user said no: do not retry the same call, explain what you wanted instead.
 - For objectives with 3 or more steps, keep a checklist with the todo tool and update statuses as you go (in_progress for what you are doing now).
+- A "[steer from the user, newer than the objective]" message is a live steer: it is newer than the original objective. Adapt to it immediately; if it changes direction, change course without redoing finished work.
+- When building web pages or UI: commit to one coherent style; restrained palette (1 primary, 1 accent, neutral background); a real Google Fonts pairing; no emoji as icons (use inline SVG); cursor-pointer on clickables; visible focus states; text contrast at least 4.5:1; responsive at 375, 768, 1024, 1440px; respect prefers-reduced-motion; avoid generic AI purple/pink gradients and default template blue.
 - When the objective is done, verify it (run the tests, read the file back, whatever proves it), then reply with the final result in this shape:
   What changed, what you ran, the evidence you saw.`;
 
@@ -155,6 +158,16 @@ export async function runObjective(cfg, objective, cwd, history, hooks = {}, ext
   try {
     for (let step = 0; step < MAX_STEPS; step++) {
       if (ctrl.signal.aborted) break;
+      // steering: notes typed while the task runs join the conversation here
+      if (hooks.drainSteer) {
+        const steer = hooks.drainSteer();
+        if (steer.length) {
+          for (const s of steer) {
+            messages.push({ role: 'user', content: `[steer from the user, newer than the objective] ${s}` });
+          }
+          hooks.onSteer?.(steer);
+        }
+      }
       let msg;
       try {
         hooks.onThinkingStart?.();
@@ -259,6 +272,15 @@ export async function runObjective(cfg, objective, cwd, history, hooks = {}, ext
             if (allowedNow && !plan && isEdit
               && !/^(Refused|Error|Denied)/.test(String(result.output))) {
               changed.add(String(input.path ?? ''));
+              // humanizer pass: prose files only (html/md/txt), code never touched (rule 21)
+              if (name === 'write_file' && cfg.humanize !== false) {
+                const abs = path.resolve(cwd, String(input.path ?? ''));
+                try {
+                  const { humanizeFile } = await import('./humanize.js');
+                  const hr = await humanizeFile(cfg, abs, ctrl.signal, { skipModel: false });
+                  if (hr.changed) hooks.onNote?.(`humanized copy in ${String(input.path)}`);
+                } catch {}
+              }
             }
           }
         }

package/src/config.js

@@ -25,6 +25,7 @@ export function normalize(c) {
     mode: c.mode === 'plan' ? 'plan' : 'build',
     memory: c.memory !== false,
     mcp: c.mcp !== false,
+    humanize: c.humanize !== false,
     permEdit: c.permEdit === 'allow' ? 'allow' : 'ask',
     permShell: c.permShell === 'allow' ? 'allow' : 'ask'
   };

package/src/humanize.js

@@ -0,0 +1,139 @@
+// humanize.js: post-processing pass for prose content. Scope is strict:
+// it rewrites marketing/marketing-adjacent copy inside HTML pages and plain prose files
+// (landing pages, posts, README-style text). It never touches code, attributes, URLs,
+// JSON, YAML, or technical values. Meaning and facts are preserved.
+
+import * as fs from 'node:fs';
+import { chat } from './provider.js';
+
+const PROSE_EXT = new Set(['.html', '.htm', '.md', '.markdown', '.txt']);
+const CODE_EXT = new Set(['.js', '.mjs', '.cjs', '.ts', '.tsx', '.jsx', '.json', '.yaml', '.yml', '.css', '.scss', '.py', '.rb', '.go', '.rs', '.java', '.php', '.sh', '.sql', '.toml', '.xml', '.svg']);
+
+export function isHumanizableFile(absPath) {
+  const ext = absPath.slice(absPath.lastIndexOf('.')).toLowerCase();
+  if (CODE_EXT.has(ext)) return false;
+  return PROSE_EXT.has(ext);
+}
+
+// Rule-based cleanups that are safe everywhere inside prose text nodes.
+const RULES = [
+  [/ ?\u2014 ?/g, ', '],
+  [/ ?\u2013 ?/g, ', '],
+  [/\bgame-?changer\b/gi, 'a real improvement'],
+  [/\bcutting-?edge\b/gi, 'new'],
+  [/\brevolutionar(y|ily)\b/gi, 'genuinely new'],
+  [/\bseamless(ly)?\b/gi, 'smooth'],
+  [/\bunlock(ing)? the (full )?potential\b/gi, 'get more out of it'],
+  [/\btake .{0,20} to the next level\b/gi, 'go further'],
+  [/\bdive (deep )?into\b/gi, 'look at'],
+  [/\blet.s (get )?started\b/gi, 'here is how'],
+  [/\bworld-?class\b/gi, 'top'],
+  [/\bblazing(ly)? (fast|quick)\b/gi, 'fast'],
+  [/\bwhisper-?quiet\b/gi, 'quiet'],
+  [/\bwe understand that\b/gi, ''],
+  [/\bin today.s (fast-?paced )?(digital|modern) world\b/gi, ''],
+  [/\blook no further\b/gi, ''],
+  [/\bdreams? (come|become) (true|reality)\b/gi, 'happens'],
+  [/\bempower(s|ing|ed)?\b/gi, 'help'],
+  [/\bcrucial|pivotal\b/gi, 'important'],
+  [/\bmost importantly,?/gi, ''],
+  [/!{2,}/g, '!']
+];
+
+function applyRules(text) {
+  let out = text;
+  for (const [re, to] of RULES) out = out.replace(re, to);
+  out = out.replace(/[ \t]{2,}/g, ' ');
+  out = out.replace(/ +([.,!?])/g, '$1');
+  out = out.replace(/ \n/g, '\n');
+  return out;
+}
+
+// Extract copy blocks from HTML: between > and < (text nodes). Tag names, attributes,
+// scripts, styles, and comments are left byte-identical.
+function humanizeHtmlTextNodes(html, fn) {
+  return html.replace(/(<script[\s\S]*?<\/script>|<style[\s\S]*?<\/style>|<!--[\s\S]*?-->)/gi, m => '\x00BLOCK' + Buffer.from(m).toString('base64') + '\x00')
+    .replace(/>([^<>]+)</g, (m, text) => {
+      if (!/[a-zA-Z]/.test(text)) return m;
+      const next = fn(text);
+      return next === text ? m : '>' + next + '<';
+    })
+    .replace(/\x00BLOCK([A-Za-z0-9+/=]+)\x00/g, (_, b64) => Buffer.from(b64, 'base64').toString());
+}
+
+async function humanizeWithModel(cfg, text, kind, signal) {
+  const prompt = (kind === 'html'
+    ? `Below is the text content of an HTML page. Rewrite ONLY the marketing copy so it reads like a human wrote it: drop AI cliches ("game-changer", "cutting-edge", "unlock", "seamless"), filler openers, and excessive enthusiasm. Never use em dashes. Keep the message, facts, product names, numbers, and language (id vs en) exactly. Reply with ONLY the rewritten text, same line structure. If nothing needs changing, reply with the text unchanged.`
+    : `Rewrite the text below so it reads like a human wrote it: drop AI cliches and filler, keep it natural and direct. Never use em dashes. Keep the message, facts, names, numbers, and language exactly. Keep the same line structure. Reply with ONLY the rewritten text. If nothing needs changing, reply with it unchanged.`)
+    + `\n---\n${text.slice(0, 8000)}`;
+  const msg = await chat({ ...cfg, reasoning: 'low' }, [{ role: 'user', content: prompt }], undefined, signal);
+  const out = String(msg.content ?? '').trim();
+  return out || text;
+}
+
+export async function humanizeFile(cfg, absPath, signal, hooks = {}) {
+  if (!isHumanizableFile(absPath)) return { changed: false, reason: 'not a prose file' };
+  let src;
+  try { src = fs.readFileSync(absPath, 'utf8'); } catch (err) { return { changed: false, reason: err.message }; }
+  if (src.length < 40) return { changed: false, reason: 'too short' };
+
+  const ext = absPath.slice(absPath.lastIndexOf('.')).toLowerCase();
+  const isHtml = ext === '.html' || ext === '.htm';
+  const kind = isHtml ? 'html' : 'text';
+
+  // step 1: deterministic rules
+  let next = isHtml
+    ? humanizeHtmlTextNodes(src, applyRules)
+    : applyRules(src);
+
+  // step 2: model pass (skipped in plan mode or when no hooks provide a provider)
+  const before = next;
+  if (cfg?.apiKey && !hooks.skipModel) {
+    try {
+      if (isHtml) {
+        next = humanizeHtmlTextNodes(next, t => t); // normalize markers once
+        const plain = next; // model sees text-node friendly form already
+        const rewritten = await humanizeWithModel(cfg, stripTagsForPrompt(plain), kind, signal);
+        // sanity: refuse junk replies (too short or structure-destroying)
+        const okLen = rewritten.length >= Math.max(20, plain.length * 0.4);
+        if (okLen) next = applyModelToTextNodes(next, rewritten);
+        else hooks.onNote?.('humanizer model pass skipped: reply looked wrong');
+      } else {
+        const rewritten = await humanizeWithModel(cfg, next, kind, signal);
+        if (rewritten.length >= Math.max(20, next.length * 0.4)) next = rewritten;
+        else hooks.onNote?.('humanizer model pass skipped: reply looked wrong');
+      }
+      // final sanitization: the model pass may reintroduce cliches or em dashes
+      next = isHtml ? humanizeHtmlTextNodes(next, applyRules) : applyRules(next);
+    } catch (err) {
+      hooks.onNote?.(`humanizer model pass skipped: ${err.message}`);
+    }
+  }
+
+  if (next !== src && next.trim()) {
+    fs.writeFileSync(absPath, next);
+    return { changed: true, before, after: next };
+  }
+  return { changed: false, reason: 'already clean' };
+}
+
+function stripTagsForPrompt(html) {
+  return html.replace(/<[^>]+>/g, '\n').replace(/\n{2,}/g, '\n').trim();
+}
+
+// Map model-rewritten plain text back onto HTML text nodes: greedy line pairing.
+// Structure is preserved; if pairing fails, the node text is left unchanged.
+function applyModelToTextNodes(html, modelText) {
+  const lines = modelText.split('\n').map(l => l.trim()).filter(Boolean);
+  let li = 0;
+  return html.replace(/>([^<>]+)</g, (m, text) => {
+    const trimmed = text.trim();
+    if (li < lines.length && /[a-zA-Z]/.test(trimmed) && trimmed.length > 2) {
+      const candidate = lines[li++];
+      if (candidate && candidate !== trimmed && candidate.length > 2) {
+        return '>' + text.replace(trimmed, candidate) + '<';
+      }
+    }
+    return m;
+  });
+}

package/src/session.js

@@ -42,6 +42,7 @@ export async function startSession(cfg, { fresh = false } = {}) {
   let closed = false;
   const approved = new Set(); // session-wide "always allow" grants
   const pendingLines = [];
+  const steerQueue = [];      // notes typed while a task runs, injected mid-task
 
   const TUI = process.stdout.isTTY && !process.env.NO_COLOR;
 
@@ -104,11 +105,22 @@ export async function startSession(cfg, { fresh = false } = {}) {
         onAgentEnd: (id, r) => { stopSpinner(); say((r.status === 'completed' ? green('  ◆ ' + id + ' done') : yellow('  ◆ ' + id + ' ' + r.status)) + gray(' ' + trunc(String(r.summary ?? '').replaceAll('\n', ' '), 90))); },
         onMCP: names => { if (names.length) say(dim('  MCP tools available: ' + names.join(', '))); },
         onMCPResult: (name, out) => { say(gray('    mcp result: ' + trunc(out, 100))); },
+        onNote: note => { stopSpinner(); say(dim('  ◇ ' + note)); },
+        drainSteer: () => steerQueue.splice(0),
+        onSteer: list => { for (const s of list) say(yellow('  ↳ steer: ') + s); },
         onApprove: async (cat, name, input2) => {
           stopSpinner();
           say(yellow('  ⚠ approval needed') + ' ' + cyan(name) + gray(' ' + trunc(JSON.stringify(input2), 80)));
-          const a = await ask('     [y] once · [a] always for ' + cat + ' · [n] no: ');
+          const a = await ask('     [y] once · [a] this session · [s] always (save) · [n] no: ');
           const c = a.trim().toLowerCase();
+          if (c === 's' || c === 'save') {
+            approved.add(cat);
+            if (cat === 'edit') Object.assign(state, normalize({ ...state, permEdit: 'allow' }));
+            if (cat === 'shell') Object.assign(state, normalize({ ...state, permShell: 'allow' }));
+            saveConfig(state);
+            say(dim('     always allowed, saved to config. /perm safe to undo.'));
+            return 'always';
+          }
           if (c === 'a' || c === 'always') { approved.add(cat); say(dim('     always allowed for this session.')); return 'always'; }
           if (c === 'y' || c === 'yes') return true;
           say(dim('     denied.'));
@@ -143,6 +155,8 @@ export async function startSession(cfg, { fresh = false } = {}) {
 
   async function afterTask() {
     if (closed) return;
+    // notes typed near the end that never reached the model become follow-up tasks
+    if (steerQueue.length) pendingLines.unshift(...steerQueue.splice(0));
     if (TUI) { drawStatus(); scrollRegion(); return; }
     plainPrompt();
     while (!busy && !closed) {
@@ -162,9 +176,12 @@ export async function startSession(cfg, { fresh = false } = {}) {
       say('  ' + cyan('/config') + '   show provider config (key hidden)');
       say('  ' + cyan('/memory') + '   memory status, /memory on|off to toggle');
       say('  ' + cyan('/mcp') + '     list MCP servers and their tools');
+      say('  ' + cyan('/humanizer') + ' natural-writing pass for pages and posts (on/off)');
       say('  ' + cyan('/clear') + '    forget this conversation');
       say('  ' + cyan('/setup') + '    redo provider setup');
       say('  ' + cyan('/reset') + '    clear saved config');
+      say('  ' + cyan('/help') + '     this list. Type normally to work, steer mid-task anytime');
+      say(dim('  while a task runs: your text is a live steer, /stop cancels it'));
       say('  ' + cyan('/exit') + '     quit');
     },
     '/config': () => {
@@ -185,7 +202,12 @@ export async function startSession(cfg, { fresh = false } = {}) {
 
   async function handle(input) {
     if (!input) return;
-    if (busy) { pendingLines.push(input); return; }
+    if (busy) {
+      if (input === '/stop') { activeRun?.abort(); say(dim('  (stopping...')); return; }
+      if (input.startsWith('/')) { pendingLines.push(input); return; }
+      steerQueue.push(input);
+      return;
+    }
     if (['/exit', '/quit', 'exit', 'quit'].includes(input)) return doExit();
     if (input === '/help' || input === '?') return commands['/help']();
     if (input === '/config') return commands['/config']();
@@ -247,6 +269,24 @@ export async function startSession(cfg, { fresh = false } = {}) {
       busy = false;
       return afterTask();
     }
+    if (input === '/humanizer' || input.startsWith('/humanizer ')) {
+      const arg = input.split(/\s+/)[1];
+      if (arg === 'on' || arg === 'off') {
+        Object.assign(state, normalize({ ...state, humanize: arg === 'on' }));
+        saveConfig(state);
+        say(arg === 'on'
+          ? green('Humanizer: on') + dim(' - web pages and posts get a natural-writing pass after they are written.')
+          : yellow('Humanizer: off') + dim(' - files are written exactly as the model produces them.'));
+        return;
+      }
+      say(box([
+        bold('Humanizer') + dim('  ' + (state.humanize === false ? 'off' : 'on')),
+        dim('scope') + '      .html .htm .md .txt (web pages, posts, docs)',
+        dim('never touches') + '  code, tags, attributes, URLs, JSON, technical values',
+        dim('toggle') + '      /humanizer on | /humanizer off'
+      ]));
+      return;
+    }
     if (input === '/mcp' || input === '/mcp reload') {
       if (!mcpConfigured()) {
         say(yellow('No MCP servers configured.') + dim(' Add them to ~/.ineedcodes/mcp.json, e.g.: {"context7":{"command":"npx","args":["-y","@upstash/context7-mcp"]}}'));

package/src/ui.js

@@ -1,6 +1,6 @@
 // ui.js: terminal helpers. No dependencies, respects NO_COLOR and non-TTY.
 
-export const VERSION = '1.1.0';
+export const VERSION = '1.2.0';
 
 const USE_COLOR = process.stdout.isTTY && !process.env.NO_COLOR;
 const wrap = (code, t) => USE_COLOR ? `\x1b[${code}m${t}\x1b[0m` : String(t);