codeply-cli 0.5.5 → 0.6.0

package/lib/commands.js

@@ -1,103 +1,103 @@
-/**
- * Custom slash commands: a markdown file per command, same layout opencode
- * and Claude Code use, so existing ones can be copied over.
- *
- *   ~/.codeply/commands/<name>.md          (every project)
- *   <project>/.codeply/commands/<name>.md  (this project; same name wins)
- *
- *   ---
- *   description: Review the changed files for bugs
- *   mode: Plan            # optional: Build | Plan | Ask
- *   ---
- *   Review $ARGUMENTS for correctness bugs. Cite file:line.
- *
- * In the body, $ARGUMENTS is everything typed after the command, $1 $2 ...
- * are single words (the highest one takes the rest), and if the body has no
- * placeholder at all the arguments are appended on their own line.
- * Sub-folders become part of the name: commands/git/pr.md is /git/pr.
- * Installed plugins add theirs as /<plugin>:<name> (see plugins.js).
- */
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const plugins = require('./plugins.js');
-
-const MAX_BODY = 20000;
-const RESERVED = new Set(['goal', 'g', 'skills', 'skill', 'skill-list']);
-
-function parseFrontmatter(text) {
-  const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(text);
-  if (!m) return { meta: {}, body: text };
-  const meta = {};
-  for (const line of m[1].split(/\r?\n/)) {
-    const kv = /^([A-Za-z_-]+)\s*:\s*(.*)$/.exec(line);
-    if (kv) meta[kv[1].toLowerCase()] = kv[2].trim().replace(/^["']|["']$/g, '');
-  }
-  return { meta, body: text.slice(m[0].length) };
-}
-
-function scan(dir, prefix, out) {
-  let entries;
-  try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
-  for (const e of entries) {
-    const full = path.join(dir, e.name);
-    if (e.isDirectory()) scan(full, `${prefix}${e.name}/`, out);
-    else if (e.isFile() && e.name.toLowerCase().endsWith('.md')) {
-      const name = `${prefix}${e.name.slice(0, -3)}`.toLowerCase().replace(/\s+/g, '-');
-      if (RESERVED.has(name)) continue;
-      try {
-        const { meta, body } = parseFrontmatter(fs.readFileSync(full, 'utf8').slice(0, MAX_BODY));
-        const mode = ['Build', 'Plan', 'Ask'].find((x) => x.toLowerCase() === String(meta.mode || '').toLowerCase());
-        out.set(name, {
-          name,
-          description: meta.description || body.trim().split('\n')[0].slice(0, 100),
-          mode: mode || null,
-          body: body.trim(),
-          file: full,
-        });
-      } catch {}
-    }
-  }
-}
-
-/** @returns {Map<string, {name, description, mode, body, file}>} */
-function loadCommands(cwd) {
-  const out = new Map();
-  for (const { plugin, dir } of plugins.commandDirs(cwd)) scan(dir, `${plugin}:`, out);
-  scan(path.join(os.homedir(), '.codeply', 'commands'), '', out);
-  if (cwd) scan(path.join(cwd, '.codeply', 'commands'), '', out);
-  return out;
-}
-
-/** Fill a command's template with what was typed after it. */
-function expand(cmd, argText) {
-  const args = String(argText || '').trim();
-  const words = args ? args.split(/\s+/) : [];
-  let body = cmd.body;
-  const nums = [...body.matchAll(/\$(\d+)/g)].map((m) => Number(m[1]));
-  const max = nums.length ? Math.max(...nums) : 0;
-  const used = /\$ARGUMENTS|\$\d+/.test(body);
-  body = body.replace(/\$(\d+)/g, (_, n) => {
-    const i = Number(n) - 1;
-    return Number(n) === max ? words.slice(i).join(' ') : (words[i] || '');
-  });
-  body = body.replace(/\$ARGUMENTS/g, args);
-  if (!used && args) body = `${body}\n\n${args}`;
-  return body.trim();
-}
-
-/**
- * If `text` starts with a known custom command, the expanded prompt and the
- * command; otherwise null. `/goal` and the app's built-ins are never matched.
- */
-function resolve(text, cwd) {
-  const m = /^\/([A-Za-z0-9_./:-]+)(?:\s+([\s\S]*))?$/.exec(String(text || '').trim());
-  if (!m) return null;
-  const name = m[1].toLowerCase();
-  if (RESERVED.has(name)) return null;
-  const cmd = loadCommands(cwd).get(name);
-  if (!cmd) return null;
-  return { command: cmd, prompt: expand(cmd, m[2] || '') };
-}
-
-module.exports = { loadCommands, expand, resolve, parseFrontmatter };
+/**
+ * Custom slash commands: a markdown file per command, same layout opencode
+ * and Claude Code use, so existing ones can be copied over.
+ *
+ *   ~/.codeply/commands/<name>.md          (every project)
+ *   <project>/.codeply/commands/<name>.md  (this project; same name wins)
+ *
+ *   ---
+ *   description: Review the changed files for bugs
+ *   mode: Plan            # optional: Build | Plan | Ask
+ *   ---
+ *   Review $ARGUMENTS for correctness bugs. Cite file:line.
+ *
+ * In the body, $ARGUMENTS is everything typed after the command, $1 $2 ...
+ * are single words (the highest one takes the rest), and if the body has no
+ * placeholder at all the arguments are appended on their own line.
+ * Sub-folders become part of the name: commands/git/pr.md is /git/pr.
+ * Installed plugins add theirs as /<plugin>:<name> (see plugins.js).
+ */
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const plugins = require('./plugins.js');
+
+const MAX_BODY = 20000;
+const RESERVED = new Set(['goal', 'g', 'skills', 'skill', 'skill-list', 'plugins', 'plugin']);
+
+function parseFrontmatter(text) {
+  const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(text);
+  if (!m) return { meta: {}, body: text };
+  const meta = {};
+  for (const line of m[1].split(/\r?\n/)) {
+    const kv = /^([A-Za-z_-]+)\s*:\s*(.*)$/.exec(line);
+    if (kv) meta[kv[1].toLowerCase()] = kv[2].trim().replace(/^["']|["']$/g, '');
+  }
+  return { meta, body: text.slice(m[0].length) };
+}
+
+function scan(dir, prefix, out) {
+  let entries;
+  try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
+  for (const e of entries) {
+    const full = path.join(dir, e.name);
+    if (e.isDirectory()) scan(full, `${prefix}${e.name}/`, out);
+    else if (e.isFile() && e.name.toLowerCase().endsWith('.md')) {
+      const name = `${prefix}${e.name.slice(0, -3)}`.toLowerCase().replace(/\s+/g, '-');
+      if (RESERVED.has(name)) continue;
+      try {
+        const { meta, body } = parseFrontmatter(fs.readFileSync(full, 'utf8').slice(0, MAX_BODY));
+        const mode = ['Build', 'Plan', 'Ask'].find((x) => x.toLowerCase() === String(meta.mode || '').toLowerCase());
+        out.set(name, {
+          name,
+          description: meta.description || body.trim().split('\n')[0].slice(0, 100),
+          mode: mode || null,
+          body: body.trim(),
+          file: full,
+        });
+      } catch {}
+    }
+  }
+}
+
+/** @returns {Map<string, {name, description, mode, body, file}>} */
+function loadCommands(cwd) {
+  const out = new Map();
+  for (const { plugin, dir } of plugins.commandDirs(cwd)) scan(dir, `${plugin}:`, out);
+  scan(path.join(os.homedir(), '.codeply', 'commands'), '', out);
+  if (cwd) scan(path.join(cwd, '.codeply', 'commands'), '', out);
+  return out;
+}
+
+/** Fill a command's template with what was typed after it. */
+function expand(cmd, argText) {
+  const args = String(argText || '').trim();
+  const words = args ? args.split(/\s+/) : [];
+  let body = cmd.body;
+  const nums = [...body.matchAll(/\$(\d+)/g)].map((m) => Number(m[1]));
+  const max = nums.length ? Math.max(...nums) : 0;
+  const used = /\$ARGUMENTS|\$\d+/.test(body);
+  body = body.replace(/\$(\d+)/g, (_, n) => {
+    const i = Number(n) - 1;
+    return Number(n) === max ? words.slice(i).join(' ') : (words[i] || '');
+  });
+  body = body.replace(/\$ARGUMENTS/g, args);
+  if (!used && args) body = `${body}\n\n${args}`;
+  return body.trim();
+}
+
+/**
+ * If `text` starts with a known custom command, the expanded prompt and the
+ * command; otherwise null. `/goal` and the app's built-ins are never matched.
+ */
+function resolve(text, cwd) {
+  const m = /^\/([A-Za-z0-9_./:-]+)(?:\s+([\s\S]*))?$/.exec(String(text || '').trim());
+  if (!m) return null;
+  const name = m[1].toLowerCase();
+  if (RESERVED.has(name)) return null;
+  const cmd = loadCommands(cwd).get(name);
+  if (!cmd) return null;
+  return { command: cmd, prompt: expand(cmd, m[2] || '') };
+}
+
+module.exports = { loadCommands, expand, resolve, parseFrontmatter };

package/lib/computer.js

@@ -0,0 +1,136 @@
+// use_computer: the agent drives other apps on this PC with the mouse and
+// keyboard (the same hands voice mode uses, voice/act.js), and sees the result.
+//
+// Every action that changes something first makes sure the window it is meant
+// for is really in front. If it is not, nothing is typed or clicked: a stray
+// keystroke in the wrong window (the chat the user is reading, a terminal) is
+// the worst thing this tool could do.
+//
+// Only the desktop app has hands, so it attaches a host (computer-desktop.js):
+//   host.front()            -> { app, title, bounds, front } | null
+//   host.focus(want)        -> the same for the window it brought forward | null
+//   host.capture(win)       -> { image, w, h, text? } of the screen that window is on
+//   host.point(x, y)        -> screen point for a spot on the last capture | null
+//   host.click(pt, opts), host.type(text), host.keys(combo), host.scroll(pt, clicks)
+//   host.isOwn(win)         -> true for Codeply's own windows
+let host = null;
+
+function attach(h) { host = h && typeof h === 'object' ? h : null; }
+function available() { return !!host; }
+
+const ACTIONS = new Set(['look', 'focus', 'click', 'double_click', 'right_click', 'type', 'keys', 'scroll', 'wait']);
+const CHANGES = new Set(['click', 'double_click', 'right_click', 'type', 'keys', 'scroll']);
+const ALIASES = { open: 'focus', activate: 'focus', switch: 'focus', screenshot: 'look', see: 'look', press: 'keys', key: 'keys', hotkey: 'keys', write: 'type', doubleclick: 'double_click', rightclick: 'right_click', sleep: 'wait' };
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const clip = (s, n) => { s = String(s || '').replace(/\s+/g, ' ').trim(); return s.length > n ? `${s.slice(0, n - 1)}…` : s; };
+const matches = (win, want) => !!win && `${win.app} ${win.title}`.toLowerCase().includes(String(want).toLowerCase());
+const named = (win) => (win ? clip(win.title || win.app || 'a window', 60) : 'nothing');
+
+/** A fresh picture of the screen the window is on, as the tool's result. */
+async function seeing(win, said, label = '') {
+  let shot = null;
+  try { shot = await host.capture(win); } catch (e) { return { ok: true, output: `${said} (No screenshot: ${e.message}.)` }; }
+  if (!shot || !shot.image) return { ok: true, output: `${said} (The screen could not be captured.)` };
+  const lines = [
+    said,
+    `Screenshot attached, ${shot.w} x ${shot.h} pixels, window in front: ${named(win)}. Spots for click and scroll are x and y in this picture's pixels, measured from its top left.`,
+    shot.text ? `Text on the screen (OCR, one row per line, may have small mistakes):\n${String(shot.text).slice(0, 4000)}` : '',
+  ].filter(Boolean);
+  return { ok: true, output: lines.join('\n\n'), meta: { imageDataUrls: [shot.image], ...(label ? { label } : {}) } };
+}
+
+/**
+ * <action> look | focus | click | double_click | right_click | type | keys | scroll | wait
+ * <window> words from the app name or window title it is for (required to act)
+ * <x> <y> a spot on the latest screenshot (click, scroll); <text> to type; <keys> "ctrl+n", "enter";
+ * <amount> scroll clicks (negative is up); <seconds> to wait.
+ */
+async function tool(args = {}, ctx = {}) {
+  if (!host) return { ok: false, output: 'use_computer only works in the Codeply desktop app on Windows or macOS.' };
+  let action = String(args.action || '').trim().toLowerCase().replace(/[\s-]+/g, '_');
+  action = ALIASES[action.replace(/_/g, '')] || ALIASES[action] || action;
+  if (!ACTIONS.has(action)) return { ok: false, output: `use_computer needs <action>: one of ${[...ACTIONS].join(', ')}.` };
+  const want = String(args.window || args.app || '').trim();
+
+  if (action === 'wait') {
+    const secs = Math.max(1, Math.min(30, Number(args.seconds) || 3));
+    if (ctx.signal && ctx.signal.aborted) return { ok: false, output: 'Stopped.' };
+    await sleep(secs * 1000);
+    let win = null; try { win = await host.front(); } catch {}
+    return seeing(win, `Waited ${secs} s.`, `Waited ${secs} s and looked`);
+  }
+
+  if (action === 'look' && !want) {
+    let win = null; try { win = await host.front(); } catch {}
+    return seeing(win, 'Looked at the screen.', 'Looked at the screen');
+  }
+
+  if (!want) return { ok: false, output: `use_computer ${action} needs <window>: a few words of the app name or window title it is for, so it never lands in the wrong window.` };
+
+  // Bring it forward unless it already is.
+  let win = null;
+  try { win = await host.front(); } catch {}
+  if (!matches(win, want) || (host.isOwn && host.isOwn(win))) {
+    try { win = await host.focus(want); } catch (e) { return { ok: false, output: `Could not switch to "${want}": ${e.message}` }; }
+    if (!win) return { ok: false, output: `No open window matches "${want}". Open the app first (on Windows: <codeply:run> start "" "shell:AppsFolder\\..." or the app's name; on a Mac: open -a "App"), then use_computer focus it.` };
+    await sleep(250);
+    // What is really in front now decides; the window it tried keeps its name for the messages below.
+    try { const now = await host.front(); win = now && matches(now, want) ? { ...now, front: true } : { ...win, front: false }; } catch {}
+  }
+  if (host.isOwn && host.isOwn(win)) return { ok: false, output: `"${want}" is Codeply's own window. use_computer is for other apps; nothing was done.` };
+  if (!win || !win.front || !matches(win, want)) {
+    let front = null; try { front = await host.front(); } catch {}
+    return { ok: false, output: `Could not bring "${want}" to the front (the window in front is ${named(front)}), so nothing was ${action === 'type' ? 'typed' : action === 'keys' ? 'pressed' : 'clicked'}. Try use_computer focus again, or a more exact <window>.` };
+  }
+  if (action === 'focus' || action === 'look') return seeing(win, `${named(win)} is in front.`, `Brought ${named(win)} to the front`);
+
+  // What it will do, checked before asking.
+  let pt = null;
+  let what = '';
+  if (action === 'type') {
+    const text = String(args.text == null ? '' : args.text);
+    if (!text) return { ok: false, output: 'use_computer type needs <text>.' };
+    if (text.length > 2000) return { ok: false, output: 'use_computer type takes up to 2000 characters at a time.' };
+    what = `Type "${clip(text, 120)}" into ${named(win)}`;
+  } else if (action === 'keys') {
+    const combo = String(args.keys || args.key || args.text || '').trim().toLowerCase();
+    if (!combo) return { ok: false, output: 'use_computer keys needs <keys>, like enter, ctrl+n or cmd+shift+t.' };
+    what = `Press ${combo} in ${named(win)}`;
+  } else {
+    const x = Number(args.x); const y = Number(args.y);
+    if (!Number.isFinite(x) || !Number.isFinite(y)) return { ok: false, output: `use_computer ${action} needs <x> and <y>: a spot on the latest screenshot (use_computer look shows one).` };
+    pt = host.point(x, y);
+    if (!pt) return { ok: false, output: 'There is no screenshot to measure that spot on yet, or it is outside it. Call use_computer look (or focus) first, then give x and y on that picture.' };
+    what = action === 'scroll' ? `Scroll ${Number(args.amount) < 0 ? 'up' : 'down'} in ${named(win)}` : `${action === 'double_click' ? 'Double-click' : action === 'right_click' ? 'Right-click' : 'Click'}${args.target ? ` "${clip(args.target, 60)}"` : ''} in ${named(win)}`;
+  }
+
+  if (CHANGES.has(action) && typeof ctx.approve === 'function') {
+    const v = await ctx.approve({ tool: 'use_computer', title: what, detail: `Codeply will use your mouse and keyboard in ${named(win)}.`, danger: false });
+    const verdict = v && typeof v === 'object' ? v.verdict : v;
+    if (verdict === 'reject') return { ok: false, output: `The user said no to: ${what}.`, meta: { rejected: true } };
+  }
+
+  // Focus can drift while the user was asked: check once more right before acting.
+  try {
+    const now = await host.front();
+    if (!matches(now, want)) {
+      const again = await host.focus(want);
+      if (!again || !again.front) return { ok: false, output: `${named(now)} came to the front before Codeply could act, so nothing was done. Try again.` };
+    }
+  } catch {}
+
+  try {
+    if (action === 'type') await host.type(String(args.text));
+    else if (action === 'keys') await host.keys(String(args.keys || args.key || args.text).trim().toLowerCase());
+    else if (action === 'scroll') await host.scroll(pt, Number(args.amount) || 3);
+    else await host.click(pt, { button: action === 'right_click' ? 'right' : 'left', count: action === 'double_click' ? 2 : 1 });
+  } catch (e) {
+    return { ok: false, output: `${what} failed: ${e.message}` };
+  }
+  await sleep(action === 'type' || action === 'keys' ? 500 : 700);
+  const r = await seeing(win, `Done: ${what}.`);
+  return { ...r, meta: { ...(r.meta || {}), label: clip(what, 100) } };
+}
+
+module.exports = { attach, available, tool, ACTIONS };

package/lib/design-library/assemble-artifact.mjs

@@ -1,21 +1,21 @@
-import { readFileSync, writeFileSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const template = readFileSync(path.join(__dirname, 'artifact-template.html'), 'utf8');
-const data = JSON.parse(readFileSync(path.join(__dirname, 'table-data.json'), 'utf8'));
-
-const totalApps = data.rows.length;
-const totalShots = data.rows.reduce((s, r) => s + r.s, 0);
-const generatedAt = new Date(data.generatedAt).toISOString().slice(0, 16).replace('T', ' ') + ' UTC';
-
-const out = template
-  .replace('__DATA_JSON__', JSON.stringify(data).replace(/</g, '\\u003c'))
-  .replace('__GENERATED_AT__', generatedAt)
-  .replace('__TOTAL_APPS__', String(totalApps))
-  .replace('__TOTAL_SHOTS__', String(totalShots));
-
-const outPath = process.argv[2];
-writeFileSync(outPath, out);
-console.log('wrote', outPath, '(' + (out.length / 1024).toFixed(0) + ' KB)');
+import { readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const template = readFileSync(path.join(__dirname, 'artifact-template.html'), 'utf8');
+const data = JSON.parse(readFileSync(path.join(__dirname, 'table-data.json'), 'utf8'));
+
+const totalApps = data.rows.length;
+const totalShots = data.rows.reduce((s, r) => s + r.s, 0);
+const generatedAt = new Date(data.generatedAt).toISOString().slice(0, 16).replace('T', ' ') + ' UTC';
+
+const out = template
+  .replace('__DATA_JSON__', JSON.stringify(data).replace(/</g, '\\u003c'))
+  .replace('__GENERATED_AT__', generatedAt)
+  .replace('__TOTAL_APPS__', String(totalApps))
+  .replace('__TOTAL_SHOTS__', String(totalShots));
+
+const outPath = process.argv[2];
+writeFileSync(outPath, out);
+console.log('wrote', outPath, '(' + (out.length / 1024).toFixed(0) + ' KB)');

package/lib/design-library/cleanup.mjs

@@ -1,45 +1,45 @@
-import { readFileSync, writeFileSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const OUT_PATH = path.join(__dirname, 'index.json');
-
-// [category, appId] pairs confirmed as wrong-category mismatches on manual review.
-// Same app can be a correct match in one category and a mismatch in another
-// (e.g. "BetterHelp" is a real health_fitness app but wrongly matched a
-// real_estate search term), so removal is scoped per (category, id), not global.
-const REMOVE = [
-  ['productivity', 6470821480],  // "Zapia" matched from "Zapier" search - unrelated app
-  ['productivity', 1038369065],  // "Flo Cycle & Period Tracker" matched from "Glo" - wrong app (correct in health_fitness)
-  ['productivity', 1573566111],  // "Complices" matched from "Complice" - unrelated French dating app
-  ['shopping', 6748155184],      // "Courtyard: TCG, Watches, Cards" - unrelated marketplace
-  ['food_delivery', 1416720539], // "Tango Reserve by AgilQuest" matched from generic "Reserve" search - enterprise workspace booking, not food
-  ['food_delivery', 6748155184], // "Courtyard" again - unrelated
-  ['real_estate', 995252384],    // "BetterHelp - Therapy" matched from "Better.com" - wrong app (correct in health_fitness)
-  ['real_estate', 1264782561],   // "Co-Star Personalized Astrology" matched from "CoStar" - astrology app, not commercial real estate data
-  ['real_estate', 1457119021],   // "Rainbow - Ethereum Wallet" - unrelated crypto wallet
-  ['real_estate', 407108860],    // "Cozi Family Organizer" - unrelated family calendar app
-  ['real_estate', 880735556],    // "Gods of Olympus" matched from "Zeus Living" - unrelated mobile game
-];
-
-const idx = JSON.parse(readFileSync(OUT_PATH, 'utf8'));
-let removed = 0;
-for (const [cat, id] of REMOVE) {
-  const before = idx.categories[cat].length;
-  idx.categories[cat] = idx.categories[cat].filter((a) => a.id !== id);
-  removed += before - idx.categories[cat].length;
-}
-
-idx.cleanedAt = new Date().toISOString();
-writeFileSync(OUT_PATH, JSON.stringify(idx, null, 2));
-console.log(`Removed ${removed} confirmed-mismatch entries.`);
-
-let totalApps = 0, totalShots = 0;
-for (const [cat, apps] of Object.entries(idx.categories)) {
-  const shots = apps.reduce((s, a) => s + a.screenshots.length, 0);
-  totalApps += apps.length;
-  totalShots += shots;
-  console.log(`${cat}: ${apps.length} apps, ${shots} screenshots`);
-}
-console.log(`\nFinal: ${totalApps} apps, ${totalShots} screenshots`);
+import { readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const OUT_PATH = path.join(__dirname, 'index.json');
+
+// [category, appId] pairs confirmed as wrong-category mismatches on manual review.
+// Same app can be a correct match in one category and a mismatch in another
+// (e.g. "BetterHelp" is a real health_fitness app but wrongly matched a
+// real_estate search term), so removal is scoped per (category, id), not global.
+const REMOVE = [
+  ['productivity', 6470821480],  // "Zapia" matched from "Zapier" search - unrelated app
+  ['productivity', 1038369065],  // "Flo Cycle & Period Tracker" matched from "Glo" - wrong app (correct in health_fitness)
+  ['productivity', 1573566111],  // "Complices" matched from "Complice" - unrelated French dating app
+  ['shopping', 6748155184],      // "Courtyard: TCG, Watches, Cards" - unrelated marketplace
+  ['food_delivery', 1416720539], // "Tango Reserve by AgilQuest" matched from generic "Reserve" search - enterprise workspace booking, not food
+  ['food_delivery', 6748155184], // "Courtyard" again - unrelated
+  ['real_estate', 995252384],    // "BetterHelp - Therapy" matched from "Better.com" - wrong app (correct in health_fitness)
+  ['real_estate', 1264782561],   // "Co-Star Personalized Astrology" matched from "CoStar" - astrology app, not commercial real estate data
+  ['real_estate', 1457119021],   // "Rainbow - Ethereum Wallet" - unrelated crypto wallet
+  ['real_estate', 407108860],    // "Cozi Family Organizer" - unrelated family calendar app
+  ['real_estate', 880735556],    // "Gods of Olympus" matched from "Zeus Living" - unrelated mobile game
+];
+
+const idx = JSON.parse(readFileSync(OUT_PATH, 'utf8'));
+let removed = 0;
+for (const [cat, id] of REMOVE) {
+  const before = idx.categories[cat].length;
+  idx.categories[cat] = idx.categories[cat].filter((a) => a.id !== id);
+  removed += before - idx.categories[cat].length;
+}
+
+idx.cleanedAt = new Date().toISOString();
+writeFileSync(OUT_PATH, JSON.stringify(idx, null, 2));
+console.log(`Removed ${removed} confirmed-mismatch entries.`);
+
+let totalApps = 0, totalShots = 0;
+for (const [cat, apps] of Object.entries(idx.categories)) {
+  const shots = apps.reduce((s, a) => s + a.screenshots.length, 0);
+  totalApps += apps.length;
+  totalShots += shots;
+  console.log(`${cat}: ${apps.length} apps, ${shots} screenshots`);
+}
+console.log(`\nFinal: ${totalApps} apps, ${totalShots} screenshots`);