ponzu 1.68.3 → 1.69.0

package/dist/index.js

@@ -6978,7 +6978,7 @@ var require_dist = __commonJS(function(exports, module) {
 // apps/cli/src/index.ts
 import { existsSync as existsSync13 } from "fs";
 import { networkInterfaces } from "os";
-import { dirname as dirname11, isAbsolute as isAbsolute4, join as join19, resolve as resolve5 } from "path";
+import { dirname as dirname12, isAbsolute as isAbsolute4, join as join20, resolve as resolve5 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { parseArgs } from "util";
 
@@ -16498,6 +16498,23 @@ function carryIds(prev, next, derived) {
   }
   return changed;
 }
+// packages/core/src/suggestions.ts
+function sameName(a, b) {
+  const norm = (s) => s.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "");
+  const x = norm(a);
+  return x.length > 0 && x === norm(b);
+}
+function startedAs(idea, file) {
+  const folder = file.key.split("/").pop()?.replace(/\.design$/, "") ?? "";
+  return sameName(idea.name, file.name) || sameName(idea.name, folder);
+}
+var STARTED_FOR = 10 * 60000;
+function startedFrom(idea, files) {
+  return files.find((f) => f.git?.project === idea.projectId && startedAs(idea, f));
+}
+function settled(file, now = Date.now()) {
+  return !file.busy && !(file.created && now - file.created < STARTED_FOR);
+}
 // packages/core/src/update.ts
 function releaseNotesUrl(version) {
   return `https://github.com/north-brook/ponzu/releases/download/v${version}/release-notes.json`;
@@ -41722,8 +41739,8 @@ async function previewStale(root) {
 }
 // packages/server/src/serve.ts
 import { existsSync as existsSync8, statSync as statSync2 } from "fs";
-import { readFile as readFile9 } from "fs/promises";
-import { extname, join as join12, normalize, resolve as resolve4, sep as sep3 } from "path";
+import { readFile as readFile10 } from "fs/promises";
+import { extname, join as join13, normalize, resolve as resolve4, sep as sep3 } from "path";
 
 // packages/store/src/fs.ts
 import { watch as fsWatch, openAsBlob } from "fs";
@@ -43175,7 +43192,29 @@ function isListed(key) {
   return !/\/(node_modules|\.Trash|\.cache)\//.test(key) && !/\/\.[^/]+\.design$/.test(key);
 }
 async function gitOf(key) {
-  for (let dir = key;; dir = dirname4(dir)) {
+  const found = await checkoutOf(key);
+  if (!found)
+    return null;
+  const { root, gitdir, common } = found;
+  const at = { root, worktree: common !== gitdir, ...await projectOf(common) };
+  const head = (await readFile4(join6(gitdir, "HEAD"), "utf8")).trim();
+  const ref = /^ref:\s*refs\/heads\/(.+)$/.exec(head);
+  if (ref)
+    return { ...at, branch: ref[1] };
+  return /^[0-9a-f]{7,}$/.test(head) ? { ...at, commit: head.slice(0, 7) } : at;
+}
+async function repositoryOf(dir) {
+  const found = await checkoutOf(dir);
+  if (!found)
+    return null;
+  const root = basename(found.common) === ".git" ? dirname4(found.common) : null;
+  if (!root || !await exists(root))
+    return null;
+  const { project, projectName } = await projectOf(found.common);
+  return { root, project: project ?? root, name: projectName ?? basename(root) };
+}
+async function checkoutOf(dir) {
+  for (;; dir = dirname4(dir)) {
     const dotgit = join6(dir, ".git");
     const s = await stat5(dotgit).catch(() => null);
     if (s) {
@@ -43188,12 +43227,7 @@ async function gitOf(key) {
       }
       const commondir = await readFile4(join6(gitdir, "commondir"), "utf8").catch(() => null);
       const common = commondir === null ? gitdir : resolve2(gitdir, commondir.trim());
-      const at = { root: dir, worktree: commondir !== null, ...await projectOf(common) };
-      const head = (await readFile4(join6(gitdir, "HEAD"), "utf8")).trim();
-      const ref = /^ref:\s*refs\/heads\/(.+)$/.exec(head);
-      if (ref)
-        return { ...at, branch: ref[1] };
-      return /^[0-9a-f]{7,}$/.test(head) ? { ...at, commit: head.slice(0, 7) } : at;
+      return { root: dir, gitdir, common };
     }
     if (dirname4(dir) === dir)
       return null;
@@ -46024,6 +46058,731 @@ var RASTER = new Set([
   "image/avif"
 ]);
 
+// packages/server/src/suggest.ts
+import { spawn as spawn5 } from "child_process";
+import { createReadStream } from "fs";
+import {
+  mkdir as mkdir10,
+  mkdtemp,
+  readdir as readdir6,
+  readFile as readFile9,
+  realpath as realpath2,
+  rename as rename8,
+  rm as rm4,
+  stat as stat9,
+  writeFile as writeFile8
+} from "fs/promises";
+import { homedir as homedir4, tmpdir as tmpdir2 } from "os";
+import { basename as basename3, dirname as dirname5, join as join12 } from "path";
+var PROJECTS = 5;
+var IDEAS = 8;
+var PER_PROJECT = 4;
+var KEEP = 16;
+var STALE = 7 * 24 * 60 * 60000;
+var SESSIONS = 200;
+var HEAD_BYTES = 64 * 1024;
+var AT_ONCE = 8;
+var RUN_EVERY = 10 * 60000;
+var RUN_TIMEOUT = 3 * 60000;
+var QUIET = 20000;
+var TRIES = 2;
+var STEPS = 4;
+var LISTED = 600;
+var NOTE_BYTES = 4000;
+var GLANCE_SCHEMA = {
+  type: "object",
+  additionalProperties: false,
+  required: ["ideas"],
+  properties: {
+    ideas: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: false,
+        required: ["name", "files"],
+        properties: {
+          name: { type: "string" },
+          files: { type: "array", items: { type: "string" } }
+        }
+      }
+    }
+  }
+};
+var PROMPT_SCHEMA = {
+  type: "object",
+  additionalProperties: false,
+  required: ["prompt"],
+  properties: { prompt: { type: "string" } }
+};
+
+class SuggestionService {
+  opts;
+  ideas = [];
+  looking = [];
+  ran = 0;
+  running = false;
+  stopped = new AbortController;
+  loaded;
+  saving = Promise.resolve();
+  every;
+  now;
+  constructor(opts) {
+    this.opts = opts;
+    this.every = opts.every ?? RUN_EVERY;
+    this.now = opts.now ?? Date.now;
+    this.loaded = this.load();
+  }
+  async state() {
+    await this.loaded;
+    const [agent, designs] = await Promise.all([this.agent(), this.designs()]);
+    const now = this.now();
+    return {
+      agent: agent?.id ?? null,
+      ideas: this.ideas.filter((i) => {
+        const started = startedFrom(i, designs);
+        return !started || !settled(started, now);
+      }),
+      running: this.running,
+      looking: this.looking
+    };
+  }
+  async refresh() {
+    await this.loaded;
+    const due = () => !this.running && this.now() - this.ran >= this.every;
+    if (due()) {
+      const agent = await this.agent();
+      if (agent && due()) {
+        this.running = true;
+        this.ran = this.now();
+        this.run(agent).finally(() => {
+          this.running = false;
+          this.looking = [];
+        });
+      }
+    }
+    return this.state();
+  }
+  stop() {
+    this.stopped.abort();
+  }
+  async agent() {
+    const listed = this.opts.agents ? await this.opts.agents().catch(() => []) : null;
+    const isolated = this.opts.isolated ?? (this.opts.run ? null : isolates);
+    for (const id of ["claude", "codex"]) {
+      if (listed && !listed.some((a) => a.id === id && a.found))
+        continue;
+      const bin = this.opts.bin(id);
+      if (!bin)
+        continue;
+      if (isolated && !await isolated(id, bin, this.env()).catch(() => false))
+        continue;
+      return { id, bin };
+    }
+    return null;
+  }
+  env() {
+    return { ...process.env, ...this.opts.env };
+  }
+  async designs() {
+    return await this.opts.designs?.().catch(() => []) ?? [];
+  }
+  job(agent, project, kind, prompt, more = {}) {
+    return {
+      agent: agent.id,
+      bin: agent.bin,
+      kind,
+      project,
+      prompt,
+      schema: kind === "glance" ? GLANCE_SCHEMA : PROMPT_SCHEMA,
+      signal: AbortSignal.any([
+        this.stopped.signal,
+        AbortSignal.timeout(this.opts.timeout ?? RUN_TIMEOUT)
+      ]),
+      env: this.env(),
+      ...more
+    };
+  }
+  async run(agent) {
+    await this.save();
+    const projects = await recentProjects({ home: this.opts.home }).catch(() => []);
+    if (!projects.length)
+      return;
+    const designs = await this.designs();
+    const offered = this.ideas;
+    const now = this.now();
+    this.ideas = this.ideas.filter((i) => startedFrom(i, designs) || now - i.found < STALE);
+    const open = this.ideas.filter((i) => !startedFrom(i, designs)).length;
+    const counts = shares(IDEAS - open, projects.length);
+    const home = this.opts.home;
+    this.looking = projects.filter((_, i) => counts[i] > 0).map((p) => lookingAt(p, home));
+    const runner = this.opts.run ?? runAgent;
+    const lane = limiter(AT_ONCE);
+    const writing = [];
+    await Promise.all(projects.map(async (project, i) => {
+      const count = counts[i];
+      if (!count || this.stopped.signal.aborted)
+        return;
+      try {
+        const taken = {
+          designs: designs.filter((d) => d.git?.project === project.project).map((d) => d.name),
+          suggested: offered.filter((i) => i.project === project.root).map((i) => i.name)
+        };
+        const listing = await listingOf(project.root, this.env());
+        const ask = glanceFor(project, count, taken, listing, home);
+        const answer = await lane(() => runner(this.job(agent, project, "glance", ask)));
+        const found = glanceFrom(answer, project, { count, found: this.now() }).filter(({ idea }) => !startedFrom(idea, designs));
+        if (!found.length)
+          return;
+        this.ideas = [
+          ...found.map((f) => f.idea),
+          ...this.ideas.filter((old) => !found.some((f) => sameIdea(f.idea, old)))
+        ].slice(0, KEEP);
+        for (const f of found)
+          writing.push(this.write(agent, project, f.idea, f.files, lane));
+      } catch (err) {
+        console.error(`Suggestions for ${project.name}: ${err.message ?? err}`);
+      } finally {
+        this.looking = this.looking.filter((l) => l.project !== project.root);
+      }
+    }));
+    await Promise.all(writing);
+  }
+  async write(agent, project, idea, files, lane) {
+    const ask = promptFor(idea, files, project, this.opts.home);
+    const runner = this.opts.run ?? runAgent;
+    const onStep = (step) => {
+      idea.steps = [...idea.steps ?? [], step].slice(-STEPS);
+    };
+    let deadline;
+    for (let tries = 0;tries < TRIES && !this.stopped.signal.aborted; tries++) {
+      if (deadline?.aborted)
+        break;
+      idea.steps = [];
+      try {
+        const answer = await lane(() => {
+          deadline ??= AbortSignal.timeout(this.opts.timeout ?? RUN_TIMEOUT);
+          const signal = AbortSignal.any([this.stopped.signal, deadline]);
+          return runner(this.job(agent, project, "prompt", ask, { onStep, quiet: QUIET, signal }));
+        });
+        const prompt = promptFrom(answer, idea, project, this.opts.home);
+        if (!prompt)
+          continue;
+        idea.prompt = prompt;
+        delete idea.steps;
+        await this.save();
+        return;
+      } catch (err) {
+        console.error(`Suggestion \u201C${idea.name}\u201D: ${err.message ?? err}`);
+      }
+    }
+    this.ideas = this.ideas.filter((i) => i !== idea);
+  }
+  async load() {
+    if (!this.opts.file)
+      return;
+    try {
+      const saved = JSON.parse(await readFile9(this.opts.file, "utf8"));
+      this.ran = typeof saved.ran === "number" ? saved.ran : 0;
+      this.ideas = Array.isArray(saved.ideas) ? saved.ideas.filter((i) => isIdea(i) && i.prompt) : [];
+    } catch {}
+  }
+  save() {
+    const file = this.opts.file;
+    if (!file)
+      return Promise.resolve();
+    this.saving = this.saving.then(async () => {
+      const ideas = this.ideas.filter((i) => i.prompt).map(({ steps: _, ...i }) => i);
+      const saved = { ran: this.ran, ideas };
+      try {
+        await mkdir10(dirname5(file), { recursive: true });
+        const tmp = `${file}.${process.pid}.tmp`;
+        await writeFile8(tmp, `${JSON.stringify(saved, null, 2)}
+`);
+        await rename8(tmp, file);
+      } catch {}
+    });
+    return this.saving;
+  }
+}
+function sameIdea(a, b) {
+  return a.project === b.project && startedAs(a, { name: b.name, key: b.name });
+}
+function isIdea(i) {
+  const o = i;
+  return typeof o?.name === "string" && typeof o.project === "string" && typeof o.projectId === "string" && typeof o.projectName === "string" && typeof o.prompt === "string" && typeof o.found === "number";
+}
+function lookingAt(p, home) {
+  return {
+    project: p.root,
+    projectId: p.project,
+    projectName: p.name,
+    folder: tilde(p.root, home)
+  };
+}
+function shares(total, n) {
+  return Array.from({ length: n }, (_, i) => Math.min(PER_PROJECT, Math.max(0, Math.floor(total / n) + (i < total % n ? 1 : 0))));
+}
+function limiter(n) {
+  let running = 0;
+  const waiting = [];
+  return async (fn) => {
+    if (running < n)
+      running++;
+    else
+      await new Promise((go) => waiting.push(go));
+    try {
+      return await fn();
+    } finally {
+      const next = waiting.shift();
+      if (next)
+        next();
+      else
+        running--;
+    }
+  };
+}
+async function recentProjects(o = {}) {
+  const home = o.home ?? homedir4();
+  const env = o.env ?? (o.home ? {} : process.env);
+  const limit = o.limit ?? PROJECTS;
+  const sessions = [
+    ...await claudeSessions(env.CLAUDE_CONFIG_DIR ?? join12(home, ".claude")),
+    ...await codexSessions(env.CODEX_HOME ?? join12(home, ".codex"))
+  ].sort((a, b) => b.at - a.at);
+  const out = new Map;
+  const tried = new Set;
+  for (const s of sessions.slice(0, SESSIONS)) {
+    if (out.size >= limit)
+      break;
+    const cwd = await cwdOf(s.file);
+    if (!cwd || tried.has(cwd))
+      continue;
+    tried.add(cwd);
+    if (cwd === home || !cwd.startsWith(`${home}/`) && isTemporary(cwd))
+      continue;
+    if (!await stat9(cwd).then((st) => st.isDirectory(), () => false))
+      continue;
+    const repo = await repositoryOf(cwd).catch(() => null);
+    if (!repo || repo.root === home || out.has(repo.project))
+      continue;
+    out.set(repo.project, {
+      root: repo.root,
+      name: basename3(repo.root),
+      project: repo.project,
+      at: s.at
+    });
+  }
+  return [...out.values()];
+}
+async function claudeSessions(dir) {
+  const folders = await readdir6(join12(dir, "projects")).catch(() => []);
+  const out = [];
+  await Promise.all(folders.map(async (f) => {
+    const at = join12(dir, "projects", f);
+    const files = await readdir6(at).catch(() => []);
+    for (const name of files) {
+      if (!name.endsWith(".jsonl"))
+        continue;
+      const file = join12(at, name);
+      const s = await stat9(file).catch(() => null);
+      if (s?.isFile())
+        out.push({ file, at: s.mtimeMs });
+    }
+  }));
+  return out;
+}
+async function codexSessions(dir) {
+  const files = [];
+  const walk = async (at, depth) => {
+    const names = (await readdir6(at).catch(() => [])).sort().reverse();
+    for (const name of names) {
+      if (files.length >= SESSIONS)
+        return;
+      const path = join12(at, name);
+      if (depth < 3)
+        await walk(path, depth + 1);
+      else if (name.endsWith(".jsonl"))
+        files.push(path);
+    }
+  };
+  await walk(join12(dir, "sessions"), 0);
+  const out = [];
+  for (const file of files) {
+    const s = await stat9(file).catch(() => null);
+    if (s?.isFile())
+      out.push({ file, at: s.mtimeMs });
+  }
+  return out;
+}
+var CWD = /"cwd"\s*:\s*("(?:[^"\\]|\\.)*")/;
+async function cwdOf(file) {
+  const head = await new Promise((done) => {
+    let text = "";
+    const stream = createReadStream(file, { encoding: "utf8", start: 0, end: HEAD_BYTES - 1 });
+    stream.on("data", (chunk) => {
+      text += chunk;
+      if (CWD.test(text))
+        stream.destroy();
+    });
+    stream.on("close", () => done(text));
+    stream.on("error", () => done(text));
+  });
+  const m = CWD.exec(head);
+  if (!m)
+    return null;
+  try {
+    const cwd = JSON.parse(m[1]);
+    return cwd.startsWith("/") ? cwd.replace(/\/+$/, "") || "/" : null;
+  } catch {
+    return null;
+  }
+}
+function isTemporary(dir) {
+  return [tmpdir2(), "/tmp", "/private/tmp", "/var/folders", "/private/var/folders"].some((t) => dir === t || dir.startsWith(`${t.replace(/\/+$/, "")}/`));
+}
+function tilde(path, home = homedir4()) {
+  return path === home ? "~" : path.startsWith(`${home}/`) ? `~${path.slice(home.length)}` : path;
+}
+var UNLISTED_DIR = /(^|\/)(node_modules|dist|build|out|\.next|vendor|Pods)\//;
+var UNLISTED_FILE = /\.(png|jpe?g|gif|svg|ico|icns|webp|avif|mp4|mov|woff2?|ttf|otf|lock|snap)$/i;
+var NOTES = ["README.md", "AGENTS.md", "CLAUDE.md"];
+async function listingOf(root, env) {
+  const out = await exec("git", ["-C", root, "ls-files", "--cached", "--others", "--exclude-standard"], { env, signal: AbortSignal.timeout(15000) }).catch(() => "");
+  const all = out.split(`
+`).filter((f) => f && !UNLISTED_DIR.test(f) && !UNLISTED_FILE.test(f));
+  const files = all.length > LISTED ? all.filter((f) => f.split("/").length <= 5).slice(0, LISTED) : all;
+  const inside = await realpath2(root).catch(() => root);
+  const notes = await Promise.all(NOTES.map(async (name) => {
+    const at = await realpath2(join12(root, name)).catch(() => null);
+    if (!at?.startsWith(`${inside}/`))
+      return "";
+    const text = await readFile9(at, "utf8").catch(() => "");
+    return text.trim() ? `${name}:
+${text.slice(0, NOTE_BYTES).trim()}` : "";
+  }));
+  return { files, count: all.length, notes: notes.filter(Boolean).join(`
+
+`) };
+}
+function glanceFor(p, count, taken, listing, home) {
+  const folder = tilde(p.root, home);
+  const names = (list) => list.map((n) => `\u201C${n}\u201D`).join(", ");
+  const ideas = count === 1 ? "one design" : `${count} designs`;
+  return [
+    `You're suggesting designs for Ponzu, a design canvas where the person's coding agent draws in HTML and CSS and they steer it with comments on the canvas.`,
+    ``,
+    `From the repository in ${folder}, listed below, suggest ${ideas} they might ask their agent for next. Each must start from something really in it, named the way the code names it: its screens and their states, a flow end to end, a component, the data model, how its parts fit together, its brand or docs, a page it's missing. Prefer what someone working on it would want to see laid out, or decide between a few takes on.`,
+    ``,
+    `For each one give:`,
+    `- name: what the design is called, like a file name, in sentence case and two to five words, e.g. "Every Seekle screen" or "Checkout, three takes".`,
+    `- files: two to four paths from the list that it starts from.`,
+    ``,
+    `Leave out branches, worktrees and time estimates.${taken.designs.length ? ` It already has these designs, so suggest others: ${names(taken.designs)}.` : ""}${taken.suggested.length ? ` These were suggested before; suggest different ones, not new takes on them: ${names(taken.suggested)}.` : ""}`,
+    `Use no tools and change nothing: everything you need is here. Answer with the JSON alone: {"ideas": [{"name", "files"}]}.`,
+    ``,
+    `<files count="${listing.count}">`,
+    ...listing.files,
+    `</files>`,
+    ...listing.notes ? [``, `<notes>`, listing.notes, `</notes>`] : []
+  ].join(`
+`);
+}
+function promptFor(idea, files, p, home) {
+  const folder = tilde(p.root, home);
+  return [
+    `You're writing a prompt for Ponzu, a design canvas where the person's coding agent draws in HTML and CSS and they steer it with comments on the canvas. They'll send it to their agent to make a design called \u201C${idea.name}\u201D in ${folder}${files.length ? `, starting from ${files.join(", ")}` : ""}. Read the code it should start from, a few files at most, then write it.`,
+    ``,
+    `Its card shows the prompt, so it also teaches them how to ask for a design: write it in their voice, the way they'd type it, and be specific. Ask for what Ponzu is good at: each screen or state on its own artboard, side by side; a few takes to compare; a flow or a diagram drawn from the code; and their comments on the canvas to steer it.`,
+    ``,
+    `Start it with: In ${folder}, make a new Ponzu design called \u201C${idea.name}\u201D. Then, in three to six sentences, ask for what to draw, name the files, screens and states in the code to start from, and say how to lay it out on the canvas. End by asking it to watch the canvas for their comments. Write plain text, no Markdown, and leave out branches, worktrees and time estimates.`,
+    ``,
+    `Only read: change nothing. Answer with the JSON alone: {"prompt": "\u2026"}.`
+  ].join(`
+`);
+}
+function glanceFrom(answer, p, o) {
+  const list = answer?.ideas;
+  if (!Array.isArray(list))
+    return [];
+  const out = [];
+  for (const raw of list) {
+    const r = raw;
+    const name = clean(r?.name);
+    if (!name || name.length > 80)
+      continue;
+    if (out.some(({ idea }) => startedAs(idea, { name, key: name })))
+      continue;
+    const files = (Array.isArray(r.files) ? r.files : []).map(clean).filter(Boolean).slice(0, 4);
+    out.push({
+      idea: {
+        name,
+        project: p.root,
+        projectId: p.project,
+        projectName: p.name,
+        prompt: "",
+        steps: [],
+        found: o.found
+      },
+      files
+    });
+    if (out.length >= o.count)
+      break;
+  }
+  return out;
+}
+function promptFrom(answer, idea, p, home) {
+  const prompt = clean(answer?.prompt);
+  if (!prompt)
+    return "";
+  const folder = tilde(p.root, home);
+  const opens = prompt.includes(idea.name) && (prompt.includes(folder) || prompt.includes(p.root));
+  return opens ? prompt : `In ${folder}, make a new Ponzu design called \u201C${idea.name}\u201D. ${prompt}`;
+}
+function clean(v) {
+  return typeof v === "string" ? v.replace(/\s+/g, " ").trim() : "";
+}
+function stepOf(tool, input, root) {
+  const i = input ?? {};
+  const text = (v) => typeof v === "string" ? v.trim() : "";
+  if (tool === "Read") {
+    const path = text(i.file_path);
+    const rel = path.startsWith(`${root}/`) ? path.slice(root.length + 1) : path;
+    return rel ? { verb: "read", what: rel.split("/").slice(-2).join("/") } : null;
+  }
+  if (tool === "Glob") {
+    const pattern = text(i.pattern);
+    return pattern ? { verb: "find", what: pattern } : null;
+  }
+  if (tool === "Grep") {
+    const words = text(i.pattern).replace(/^\(\?i\)/, "").split("|")[0].replace(/\\[wsdb][+*?]?/g, " ").replace(/\.[+*?]?/g, " ").replace(/[\\^$()[\]{}?*+]/g, "").replace(/\s+/g, " ").trim().slice(0, 40);
+    return words ? { verb: "search", what: words } : null;
+  }
+  return null;
+}
+var runAgent = async (job) => {
+  if (job.agent === "claude")
+    return runClaude(job);
+  return runCodex(job);
+};
+var ISOLATION = {
+  claude: ["--strict-mcp-config", "--no-session-persistence", "--settings", "--setting-sources"],
+  codex: ["--ephemeral"]
+};
+var isolates = async (agent, bin, env) => {
+  const has = flagsOf(await helpOf(bin, agent === "codex" ? ["exec", "--help"] : ["--help"], env));
+  return ISOLATION[agent].every(has);
+};
+function flagsOf(help) {
+  return (flag) => new RegExp(`^\\s*(?:-\\w, )?${flag}\\b`, "m").test(help);
+}
+async function runClaude(job) {
+  const help = await helpOf(job.bin, ["--help"], job.env);
+  const has = flagsOf(help);
+  if (!ISOLATION.claude.every(has))
+    throw new Error("Claude Code can't run isolated");
+  const tools = job.kind === "glance" && has("--tools") ? "" : "Read,Glob,Grep";
+  const stream = job.kind === "prompt" && has("--include-partial-messages");
+  const args = [
+    "-p",
+    "--output-format",
+    stream ? "stream-json" : "json",
+    ...stream ? ["--verbose", "--include-partial-messages"] : [],
+    ...tools && has("--json-schema") ? ["--json-schema", JSON.stringify(job.schema)] : [],
+    ...has("--tools") ? ["--tools", tools] : [],
+    ...tools ? ["--allowedTools", tools] : [],
+    "--disallowedTools",
+    "Bash,Edit,Write,MultiEdit,NotebookEdit,WebFetch,WebSearch,Task",
+    ...help.includes("dontAsk") ? ["--permission-mode", "dontAsk"] : [],
+    "--setting-sources",
+    "user",
+    "--settings",
+    JSON.stringify({ disableAllHooks: true }),
+    "--strict-mcp-config",
+    "--no-session-persistence",
+    "--model",
+    "sonnet"
+  ];
+  let result = null;
+  const onLine = (line) => {
+    const e = parseJson(line);
+    if (e?.type === "result")
+      result = e;
+    if (e?.type !== "assistant")
+      return;
+    for (const block of e.message?.content ?? []) {
+      if (block?.type !== "tool_use" || !block.name)
+        continue;
+      const step = stepOf(block.name, block.input, job.project.root);
+      if (step)
+        job.onStep?.(step);
+    }
+  };
+  const out = await exec(job.bin, args, {
+    cwd: job.project.root,
+    input: job.prompt,
+    env: job.env,
+    signal: job.signal,
+    ...stream ? { onLine, quiet: job.quiet } : {}
+  });
+  const r = stream ? result : parseJson(out);
+  if (!r || r.is_error)
+    throw new Error("Claude Code didn't answer");
+  return r.structured_output ?? parseJson(r.result ?? "");
+}
+async function runCodex(job) {
+  const help = await helpOf(job.bin, ["exec", "--help"], job.env);
+  const has = flagsOf(help);
+  if (!ISOLATION.codex.every(has))
+    throw new Error("Codex can't run isolated");
+  const dir = await mkdtemp(join12(tmpdir2(), "ponzu-suggest-"));
+  try {
+    const work = join12(dir, "work");
+    const schema = join12(dir, "schema.json");
+    const last = join12(dir, "answer.json");
+    await mkdir10(work);
+    await writeFile8(schema, JSON.stringify(job.schema));
+    const off = (feature) => ["-c", `features.${feature}=false`];
+    const args = [
+      "exec",
+      "--sandbox",
+      "read-only",
+      "--skip-git-repo-check",
+      "--color",
+      "never",
+      "-C",
+      work,
+      "--output-schema",
+      schema,
+      "-o",
+      last,
+      "-c",
+      'approval_policy="never"',
+      ...off("hooks"),
+      ...off("plugins"),
+      ...off("apps"),
+      ...off("memories"),
+      ...has("--ignore-user-config") ? ["--ignore-user-config"] : ["-c", "mcp_servers={}", "-c", "notify=[]"],
+      ...has("--ignore-rules") ? ["--ignore-rules"] : [],
+      "--ephemeral",
+      "-"
+    ];
+    const out = await exec(job.bin, args, {
+      cwd: work,
+      input: job.prompt,
+      env: job.env,
+      signal: job.signal
+    });
+    const answer = await readFile9(last, "utf8").catch(() => out);
+    return parseJson(answer);
+  } finally {
+    await rm4(dir, { recursive: true, force: true });
+  }
+}
+function parseJson(text) {
+  try {
+    return JSON.parse(text);
+  } catch {}
+  const start = text.indexOf("{");
+  const end = text.lastIndexOf("}");
+  if (start < 0 || end <= start)
+    return null;
+  try {
+    return JSON.parse(text.slice(start, end + 1));
+  } catch {
+    return null;
+  }
+}
+var HELP_FOR = RUN_EVERY;
+var helps = new Map;
+function helpOf(bin, args, env) {
+  const key = `${bin} ${args.join(" ")}`;
+  const kept = helps.get(key);
+  if (kept && Date.now() - kept.at < HELP_FOR)
+    return kept.help;
+  const help = exec(bin, args, { env, signal: AbortSignal.timeout(15000) }).catch(() => "");
+  helps.set(key, { at: Date.now(), help });
+  help.then((text) => {
+    if (!text && helps.get(key)?.help === help)
+      helps.delete(key);
+  });
+  return help;
+}
+function exec(bin, args, o) {
+  return new Promise((done, fail) => {
+    if (o.signal.aborted)
+      return fail(new Error("stopped"));
+    const child = spawn5(bin, args, {
+      cwd: o.cwd,
+      env: o.env,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    let out = "";
+    let err = "";
+    let quiet = false;
+    const stop = () => {
+      child.kill("SIGTERM");
+      setTimeout(() => child.kill("SIGKILL"), 3000).unref();
+    };
+    let hush;
+    const heard = () => {
+      if (!o.quiet)
+        return;
+      clearTimeout(hush);
+      hush = setTimeout(() => {
+        quiet = true;
+        stop();
+      }, o.quiet);
+    };
+    heard();
+    const lines = (flush) => {
+      if (!o.onLine)
+        return;
+      let i = out.indexOf(`
+`);
+      while (i >= 0) {
+        o.onLine(out.slice(0, i));
+        out = out.slice(i + 1);
+        i = out.indexOf(`
+`);
+      }
+      if (flush && out)
+        o.onLine(out);
+    };
+    o.signal.addEventListener("abort", stop, { once: true });
+    child.stdout.on("data", (d) => {
+      heard();
+      if (out.length < 4000000)
+        out += d.toString();
+      lines(false);
+    });
+    child.stderr.on("data", (d) => {
+      if (err.length < 4000)
+        err += d.toString();
+    });
+    child.on("error", (e) => {
+      clearTimeout(hush);
+      o.signal.removeEventListener("abort", stop);
+      fail(e);
+    });
+    child.on("close", (code) => {
+      clearTimeout(hush);
+      o.signal.removeEventListener("abort", stop);
+      if (quiet)
+        return fail(new Error("went quiet"));
+      if (o.signal.aborted)
+        return fail(new Error("timed out"));
+      lines(true);
+      if (code === 0)
+        done(o.onLine ? "" : out);
+      else
+        fail(new Error(err.trim().split(`
+`).pop() || `exited with ${code}`));
+    });
+    child.stdin.on("error", () => {});
+    child.stdin.end(o.input ?? "");
+  });
+}
+
 // packages/server/src/serve.ts
 var PROTOCOL = 1;
 var PHONE_ACTIVE_MS = 2 * 60000;
@@ -46142,6 +46901,11 @@ function serve(ws, opts = {}) {
     agentWorking
   });
   const feed = new CatalogFeed(home, ws);
+  const suggestions = opts.suggest ? new SuggestionService({
+    ...opts.suggest,
+    agents: opts.agents,
+    designs: async () => (await home.local()).files
+  }) : null;
   const idleMs = () => idleFor({ agentIdle: mcp.idleMs(), phoneAt, phoneSockets: phoneSockets(), now: Date.now() });
   const handle = async (req, srv, caller) => {
     const url = new URL(req.url);
@@ -46244,6 +47008,16 @@ function serve(ws, opts = {}) {
       feed.poke(0);
       return Response.json({ ok: true });
     }
+    if (path === "/api/suggestions" || path === "/api/suggestions/refresh") {
+      if (caller !== "local" || !sameHostOk(req, url))
+        return new Response("Forbidden", { status: 403 });
+      const refresh = path === "/api/suggestions/refresh";
+      if (refresh && req.method !== "POST")
+        return new Response("Method not allowed", { status: 405 });
+      if (!suggestions)
+        return Response.json({ agent: null, ideas: [], running: false, looking: [] });
+      return Response.json(await (refresh ? suggestions.refresh() : suggestions.state()));
+    }
     if (path === "/api/update") {
       if (req.method !== "POST")
         return new Response("Method not allowed", { status: 405 });
@@ -46664,6 +47438,7 @@ function serve(ws, opts = {}) {
     clearInterval(catchUp);
     updater?.stop();
     feed.stop();
+    suggestions?.stop();
     advert?.stop();
     advert = null;
     tailnetServer?.stop(force);
@@ -46808,10 +47583,10 @@ async function serveStudio(path, dir) {
 <p>MCP endpoint: <code>/mcp</code></p></body>`, { headers: { "content-type": "text/html; charset=utf-8" } });
   }
   const clean = normalize(path).replace(/^(\.\.[/\\])+/, "");
-  let file = join12(dir, clean);
+  let file = join13(dir, clean);
   if (!file.startsWith(dir) || !existsSync8(file) || statSync2(file).isDirectory())
-    file = join12(dir, "index.html");
-  const body = await readFile9(file);
+    file = join13(dir, "index.html");
+  const body = await readFile10(file);
   const ext = extname(file);
   return new Response(body, {
     headers: {
@@ -46863,7 +47638,7 @@ function remoteUpdater(endpoint, token) {
 // apps/cli/package.json
 var package_default = {
   name: "ponzu",
-  version: "1.68.3",
+  version: "1.69.0",
   description: "The open source canvas your agent draws on in HTML and CSS.",
   type: "module",
   license: "MIT",
@@ -46885,24 +47660,24 @@ var package_default = {
 };
 
 // apps/cli/src/host.ts
-import { spawn as spawn5 } from "child_process";
+import { spawn as spawn6 } from "child_process";
 import { existsSync as existsSync9, readFileSync as readFileSync2, statSync as statSync3 } from "fs";
-import { chmod, copyFile, mkdir as mkdir10, rename as rename8, rm as rm4, utimes as utimes3, writeFile as writeFile8 } from "fs/promises";
-import { homedir as homedir4 } from "os";
-import { dirname as dirname5, join as join13, posix, win32 } from "path";
-var ponzuHome = () => process.env.PONZU_HOME ?? join13(homedir4(), ".ponzu");
-var hostFile = () => join13(ponzuHome(), "host.json");
+import { chmod, copyFile, mkdir as mkdir11, rename as rename9, rm as rm5, utimes as utimes3, writeFile as writeFile9 } from "fs/promises";
+import { homedir as homedir5 } from "os";
+import { dirname as dirname6, join as join14, posix, win32 } from "path";
+var ponzuHome = () => process.env.PONZU_HOME ?? join14(homedir5(), ".ponzu");
+var hostFile = () => join14(ponzuHome(), "host.json");
 async function announceHost(url, opts = {}) {
   if (!opts.takeOver && await runningHost())
     return async () => {};
   const path = hostFile();
-  await mkdir10(dirname5(path), { recursive: true });
+  await mkdir11(dirname6(path), { recursive: true });
   const me = { url, mcp: `${url}/mcp`, pid: process.pid };
-  await writeFile8(path, `${JSON.stringify(me)}
+  await writeFile9(path, `${JSON.stringify(me)}
 `);
   return async () => {
     if (readHost()?.pid === process.pid)
-      await rm4(path, { force: true });
+      await rm5(path, { force: true });
   };
 }
 function readHost() {
@@ -46926,8 +47701,8 @@ async function runningHost() {
 }
 var SERVER = "Contents/Resources/server/ponzu";
 var pathFor = (os) => os === "win32" ? win32 : posix;
-var appImageServer = () => join13(ponzuHome(), "app/ponzu");
-var appImageRecord = () => join13(ponzuHome(), "app/appimage");
+var appImageServer = () => join14(ponzuHome(), "app/ponzu");
+var appImageRecord = () => join14(ponzuHome(), "app/appimage");
 function recordedAppImage() {
   try {
     const path = readFileSync2(appImageRecord(), "utf8").trim();
@@ -46945,7 +47720,7 @@ function isFolder(app) {
 }
 function appServer(app, os = process.platform) {
   if (os === "darwin")
-    return join13(app, SERVER);
+    return join14(app, SERVER);
   const path = pathFor(os);
   if (os === "linux" && !isFolder(app))
     return appImageServer();
@@ -46978,7 +47753,7 @@ function ownBundle(execPath = process.execPath, os = process.platform, env = pro
 }
 function installedApps(os = process.platform, env = process.env) {
   if (os === "darwin")
-    return ["/Applications/Ponzu.app", join13(homedir4(), "Applications/Ponzu.app")];
+    return ["/Applications/Ponzu.app", join14(homedir5(), "Applications/Ponzu.app")];
   if (os === "win32") {
     return [
       env.LOCALAPPDATA && win32.join(env.LOCALAPPDATA, "Programs", "ponzu"),
@@ -47011,15 +47786,15 @@ async function adoptAppImage(execPath = process.execPath, os = process.platform,
   const from = statSync3(execPath);
   const to = statSync3(copy, { throwIfNoEntry: false });
   if (!to || to.size !== from.size || Math.trunc(to.mtimeMs) !== Math.trunc(from.mtimeMs)) {
-    await mkdir10(dirname5(copy), { recursive: true });
+    await mkdir11(dirname6(copy), { recursive: true });
     const temp = `${copy}.${process.pid}`;
     await copyFile(execPath, temp);
     await chmod(temp, 493);
     await utimes3(temp, from.atime, from.mtime);
-    await rename8(temp, copy);
+    await rename9(temp, copy);
   }
   if (recordedAppImage() !== appimage)
-    await writeFile8(appImageRecord(), `${appimage}
+    await writeFile9(appImageRecord(), `${appimage}
 `);
   return appimage;
 }
@@ -47047,7 +47822,7 @@ function startApp(app) {
   const [cmd, args] = launchCommand(app);
   return new Promise((resolve) => {
     try {
-      const child = spawn5(cmd, args, { detached: true, stdio: "ignore", env });
+      const child = spawn6(cmd, args, { detached: true, stdio: "ignore", env });
       child.on("error", () => resolve());
       child.on("spawn", () => resolve());
       child.unref();
@@ -47075,7 +47850,7 @@ async function findHost(launch) {
     lastFailed = Date.now();
   return url;
 }
-var shimPath = (os = process.platform) => join13(ponzuHome(), os === "win32" ? "bin/ponzu.cmd" : "bin/ponzu");
+var shimPath = (os = process.platform) => join14(ponzuHome(), os === "win32" ? "bin/ponzu.cmd" : "bin/ponzu");
 function shimScript(app, os = process.platform) {
   if (os === "win32") {
     const candidates = [
@@ -47120,8 +47895,8 @@ exit 1
 }
 async function writeShim(app) {
   const path = shimPath();
-  await mkdir10(dirname5(path), { recursive: true });
-  await writeFile8(path, shimScript(app));
+  await mkdir11(dirname6(path), { recursive: true });
+  await writeFile9(path, shimScript(app));
   await chmod(path, 493);
   return path;
 }
@@ -47129,27 +47904,27 @@ async function writeShim(app) {
 // apps/cli/src/install.ts
 import { spawnSync as spawnSync2 } from "child_process";
 import { existsSync as existsSync11, readFileSync as readFileSync4 } from "fs";
-import { mkdir as mkdir12, writeFile as writeFile10 } from "fs/promises";
-import { homedir as homedir6 } from "os";
-import { delimiter as delimiter2, dirname as dirname7, join as join15 } from "path";
+import { mkdir as mkdir13, writeFile as writeFile11 } from "fs/promises";
+import { homedir as homedir7 } from "os";
+import { delimiter as delimiter2, dirname as dirname8, join as join16 } from "path";
 
 // apps/cli/src/command.ts
 import { spawnSync } from "child_process";
 import { accessSync, constants, existsSync as existsSync10, lstatSync, readFileSync as readFileSync3, realpathSync as realpathSync3 } from "fs";
-import { mkdir as mkdir11, symlink, writeFile as writeFile9 } from "fs/promises";
-import { homedir as homedir5 } from "os";
-import { delimiter, dirname as dirname6, join as join14 } from "path";
-function commandDirs(home = homedir5()) {
-  return [join14(home, ".local/bin"), join14(home, "bin"), "/usr/local/bin"];
+import { mkdir as mkdir12, symlink, writeFile as writeFile10 } from "fs/promises";
+import { homedir as homedir6 } from "os";
+import { delimiter, dirname as dirname7, join as join15 } from "path";
+function commandDirs(home = homedir6()) {
+  return [join15(home, ".local/bin"), join15(home, "bin"), "/usr/local/bin"];
 }
-var stateFile = () => join14(ponzuHome(), "command.json");
+var stateFile = () => join15(ponzuHome(), "command.json");
 async function linkCommand(shim, opts) {
   const say = (s) => {
     if (!opts.auto)
       console.log(s);
   };
   if (process.platform === "win32")
-    return addToUserPath(dirname6(shim), opts.auto, say);
+    return addToUserPath(dirname7(shim), opts.auto, say);
   const found = Bun.which("ponzu", { PATH: opts.path.join(delimiter) });
   const app = found && opensApp(found) ? found : null;
   if (found && !app) {
@@ -47160,25 +47935,25 @@ async function linkCommand(shim, opts) {
   const state = readState();
   if (opts.auto && state.linked)
     return;
-  const before = app ? opts.path.indexOf(dirname6(app)) : -1;
+  const before = app ? opts.path.indexOf(dirname7(app)) : -1;
   const dir = commandDirs(opts.home).find((d) => {
     const at = opts.path.indexOf(d);
     return at >= 0 && (before < 0 || at < before) && canLink(d, opts.home);
   });
   if (!dir) {
-    say(process.platform === "darwin" ? `To run ponzu from a terminal, add ${dirname6(shim)} to your PATH, or choose Install Terminal Command in Ponzu's app menu.` : `To run ponzu from a terminal, add ${dirname6(shim)} to your PATH.`);
+    say(process.platform === "darwin" ? `To run ponzu from a terminal, add ${dirname7(shim)} to your PATH, or choose Install Terminal Command in Ponzu's app menu.` : `To run ponzu from a terminal, add ${dirname7(shim)} to your PATH.`);
     return;
   }
-  const link = join14(dir, "ponzu");
+  const link = join15(dir, "ponzu");
   try {
-    await mkdir11(dir, { recursive: true });
+    await mkdir12(dir, { recursive: true });
     await symlink(shim, link);
   } catch {
     say(`Couldn't link ponzu into ${dir}.`);
     return;
   }
-  await mkdir11(dirname6(stateFile()), { recursive: true });
-  await writeFile9(stateFile(), `${JSON.stringify({ linked: link }, null, 2)}
+  await mkdir12(dirname7(stateFile()), { recursive: true });
+  await writeFile10(stateFile(), `${JSON.stringify({ linked: link }, null, 2)}
 `);
   say(`Linked ${link}, so ponzu runs from a terminal.`);
 }
@@ -47216,8 +47991,8 @@ async function addToUserPath(dir, auto, say) {
     return;
   if (userPath(dir, true) !== "added")
     return say(`Couldn't add ${dir} to your PATH. Add it yourself to run ponzu from a terminal.`);
-  await mkdir11(dirname6(stateFile()), { recursive: true });
-  await writeFile9(stateFile(), `${JSON.stringify({ linked: dir }, null, 2)}
+  await mkdir12(dirname7(stateFile()), { recursive: true });
+  await writeFile10(stateFile(), `${JSON.stringify({ linked: dir }, null, 2)}
 `);
   say(`Added ${dir} to your PATH. Open a new terminal and run ponzu.`);
 }
@@ -47228,9 +48003,9 @@ function readState() {
     return {};
   }
 }
-function canLink(dir, home = homedir5()) {
+function canLink(dir, home = homedir6()) {
   try {
-    lstatSync(join14(dir, "ponzu"));
+    lstatSync(join15(dir, "ponzu"));
     return false;
   } catch {}
   if (!existsSync10(dir))
@@ -47244,7 +48019,7 @@ function canLink(dir, home = homedir5()) {
 }
 function opensApp(file) {
   try {
-    return existsSync10(join14(dirname6(realpathSync3(file)), "resources/server/ponzu"));
+    return existsSync10(join15(dirname7(realpathSync3(file)), "resources/server/ponzu"));
   } catch {
     return false;
   }
@@ -47264,7 +48039,7 @@ var AGENTS = [
     label: "Claude Code",
     detect: () => Boolean(which("claude")),
     current: () => {
-      const config = readJson(join15(homedir6(), ".claude.json"));
+      const config = readJson(join16(homedir7(), ".claude.json"));
       return toEntry(config?.mcpServers?.ponzu);
     },
     register(entry) {
@@ -47314,7 +48089,7 @@ var AGENTS = [
   {
     id: "cursor",
     label: "Cursor",
-    detect: () => existsSync11(join15(homedir6(), ".cursor")),
+    detect: () => existsSync11(join16(homedir7(), ".cursor")),
     current: () => {
       const config = readJson(cursorConfig());
       return toEntry(config?.mcpServers?.ponzu);
@@ -47332,8 +48107,8 @@ var AGENTS = [
         config = parsed;
       }
       config.mcpServers = { ...config.mcpServers, ponzu: entry };
-      await mkdir12(dirname7(path), { recursive: true });
-      await writeFile10(path, `${JSON.stringify(config, null, 2)}
+      await mkdir13(dirname8(path), { recursive: true });
+      await writeFile11(path, `${JSON.stringify(config, null, 2)}
 `);
       return true;
     }
@@ -47401,7 +48176,7 @@ function agentStatus() {
 }
 function codexConfigured() {
   try {
-    return /^\[mcp_servers\.ponzu\]/m.test(readFileSync4(join15(process.env.CODEX_HOME ?? join15(homedir6(), ".codex"), "config.toml"), "utf8"));
+    return /^\[mcp_servers\.ponzu\]/m.test(readFileSync4(join16(process.env.CODEX_HOME ?? join16(homedir7(), ".codex"), "config.toml"), "utf8"));
   } catch {
     return false;
   }
@@ -47445,18 +48220,18 @@ function shouldAutoRegister(current, setUpBefore) {
 function isLegacy(e) {
   return "url" in e && /^http:\/\/(127\.0\.0\.1|localhost):7777\/mcp\/?$/.test(e.url);
 }
-var doneFile = () => join15(ponzuHome(), "agents.json");
+var doneFile = () => join16(ponzuHome(), "agents.json");
 function readDone() {
   const raw = readJson(doneFile());
   return new Set(raw?.configured ?? []);
 }
 async function writeDone(done) {
-  await mkdir12(dirname7(doneFile()), { recursive: true });
-  await writeFile10(doneFile(), `${JSON.stringify({ configured: [...done].sort() }, null, 2)}
+  await mkdir13(dirname8(doneFile()), { recursive: true });
+  await writeFile11(doneFile(), `${JSON.stringify({ configured: [...done].sort() }, null, 2)}
 `);
 }
 function cursorConfig() {
-  return join15(homedir6(), ".cursor", "mcp.json");
+  return join16(homedir7(), ".cursor", "mcp.json");
 }
 function readJson(path) {
   try {
@@ -47469,13 +48244,13 @@ var searchPath;
 function agentPath() {
   if (searchPath !== undefined)
     return searchPath;
-  const home = homedir6();
+  const home = homedir7();
   const dirs = [
     ...(process.env.PATH ?? "").split(delimiter2),
-    join15(home, ".local/bin"),
-    join15(home, ".claude/local"),
-    join15(home, ".bun/bin"),
-    join15(home, ".npm-global/bin"),
+    join16(home, ".local/bin"),
+    join16(home, ".claude/local"),
+    join16(home, ".bun/bin"),
+    join16(home, ".npm-global/bin"),
     "/opt/homebrew/bin",
     "/usr/local/bin",
     ...loginPath()
@@ -47503,6 +48278,12 @@ function loginPath() {
 function which(cmd) {
   return Bun.which(cmd, { PATH: agentPath() });
 }
+function agentCli(cmd) {
+  return which(cmd);
+}
+function agentEnv() {
+  return { PATH: agentPath() };
+}
 function capture2(cmd) {
   const bin = which(cmd[0]);
   if (!bin)
@@ -47529,13 +48310,13 @@ function run(cmd, quiet = false) {
 // apps/cli/src/source.ts
 import { createHash as createHash5 } from "crypto";
 import { existsSync as existsSync12 } from "fs";
-import { dirname as dirname8, join as join16, sep as sep4 } from "path";
+import { dirname as dirname9, join as join17, sep as sep4 } from "path";
 import { fileURLToPath } from "url";
 function sourceCheckout(file = fileURLToPath(import.meta.url)) {
   if (file.startsWith("/$bunfs/") || file.split(sep4).includes("node_modules"))
     return null;
-  for (let dir = dirname8(file);dir !== dirname8(dir); dir = dirname8(dir))
-    if (existsSync12(join16(dir, ".git")))
+  for (let dir = dirname9(file);dir !== dirname9(dir); dir = dirname9(dir))
+    if (existsSync12(join17(dir, ".git")))
       return dir;
   return null;
 }
@@ -47574,12 +48355,12 @@ function firstFree(ports, hostname) {
 // apps/cli/src/telemetry.ts
 import { createHash as createHash6, randomUUID } from "crypto";
 import { readFileSync as readFileSync5 } from "fs";
-import { mkdir as mkdir13, rename as rename9, writeFile as writeFile11 } from "fs/promises";
+import { mkdir as mkdir14, rename as rename10, writeFile as writeFile12 } from "fs/promises";
 import { arch, platform as platform2 } from "os";
-import { dirname as dirname10, join as join17 } from "path";
+import { dirname as dirname11, join as join18 } from "path";
 
 // node_modules/.bun/posthog-node@5.56.2/node_modules/posthog-node/dist/extensions/error-tracking/modifiers/module.node.mjs
-import { dirname as dirname9, posix as posix2, sep as sep5 } from "path";
+import { dirname as dirname10, posix as posix2, sep as sep5 } from "path";
 function createModulerModifier() {
   const getModuleFromFileName = createGetModuleFromFilename();
   return async (frames) => {
@@ -47588,7 +48369,7 @@ function createModulerModifier() {
     return frames;
   };
 }
-function createGetModuleFromFilename(basePath = process.argv[1] ? dirname9(process.argv[1]) : process.cwd(), isWindows = sep5 === "\\") {
+function createGetModuleFromFilename(basePath = process.argv[1] ? dirname10(process.argv[1]) : process.cwd(), isWindows = sep5 === "\\") {
   const normalizedBase = isWindows ? normalizeWindowsPath(basePath) : basePath;
   return (filename) => {
     if (!filename)
@@ -56868,7 +57649,7 @@ var CATEGORY = {
   praise: "Praise",
   other: "Other"
 };
-var settingsFile = () => join17(ponzuHome(), "telemetry.json");
+var settingsFile = () => join18(ponzuHome(), "telemetry.json");
 function readSettings() {
   try {
     return JSON.parse(readFileSync5(settingsFile(), "utf8"));
@@ -56878,11 +57659,11 @@ function readSettings() {
 }
 async function writeSettings(settings) {
   const path = settingsFile();
-  await mkdir13(dirname10(path), { recursive: true });
+  await mkdir14(dirname11(path), { recursive: true });
   const tmp = `${path}.${process.pid}.tmp`;
-  await writeFile11(tmp, `${JSON.stringify(settings, null, 2)}
+  await writeFile12(tmp, `${JSON.stringify(settings, null, 2)}
 `);
-  await rename9(tmp, path);
+  await rename10(tmp, path);
 }
 async function settings() {
   const current = readSettings();
@@ -57055,13 +57836,13 @@ async function telemetryCommand(arg = "status") {
 import { dlopen, FFIType, ptr } from "bun:ffi";
 import { spawnSync as spawnSync3 } from "child_process";
 import { fstatSync, readFileSync as readFileSync6 } from "fs";
-import { mkdir as mkdir14, rm as rm5, writeFile as writeFile12 } from "fs/promises";
-import { homedir as homedir7 } from "os";
-import { join as join18 } from "path";
+import { mkdir as mkdir15, rm as rm6, writeFile as writeFile13 } from "fs/promises";
+import { homedir as homedir8 } from "os";
+import { join as join19 } from "path";
 var WAKE_LABEL = "design.ponzu.app.wake";
 var WAKE_PORT = 7778;
-var agentsDir = () => process.env.PONZU_LAUNCH_AGENTS ?? join18(homedir7(), "Library/LaunchAgents");
-var wakePlistPath = () => join18(agentsDir(), `${WAKE_LABEL}.plist`);
+var agentsDir = () => process.env.PONZU_LAUNCH_AGENTS ?? join19(homedir8(), "Library/LaunchAgents");
+var wakePlistPath = () => join19(agentsDir(), `${WAKE_LABEL}.plist`);
 var xml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 function wakePlist(program, port = WAKE_PORT) {
   return `<?xml version="1.0" encoding="UTF-8"?>
@@ -57107,17 +57888,17 @@ async function installWake(program, run = launchctl) {
   } catch {}
   if (current === plist && run(["print", `${domain()}/${WAKE_LABEL}`]))
     return false;
-  await mkdir14(agentsDir(), { recursive: true });
-  await writeFile12(path, plist);
+  await mkdir15(agentsDir(), { recursive: true });
+  await writeFile13(path, plist);
   run(["bootout", `${domain()}/${WAKE_LABEL}`]);
   run(["bootstrap", domain(), path]);
   return true;
 }
 async function uninstallWake(run = launchctl) {
   run(["bootout", `${domain()}/${WAKE_LABEL}`]);
-  await rm5(wakePlistPath(), { force: true });
+  await rm6(wakePlistPath(), { force: true });
 }
-var systemdDir = () => process.env.PONZU_SYSTEMD_USER ?? join18(process.env.XDG_CONFIG_HOME || join18(homedir7(), ".config"), "systemd/user");
+var systemdDir = () => process.env.PONZU_SYSTEMD_USER ?? join19(process.env.XDG_CONFIG_HOME || join19(homedir8(), ".config"), "systemd/user");
 var WAKE_SOCKET = "ponzu-wake.socket";
 var WAKE_SERVICE = "ponzu-wake@.service";
 var systemdWord = (s) => `"${s.replace(/[\\"]/g, "\\$&").replace(/%/g, "%%").replace(/\$/g, "$$$$")}"`;
@@ -57151,16 +57932,16 @@ async function installSystemdWake(program, run = systemctl) {
   const units = wakeUnits(program);
   const current = Object.entries(units).every(([name, text]) => {
     try {
-      return readFileSync6(join18(systemdDir(), name), "utf8") === text;
+      return readFileSync6(join19(systemdDir(), name), "utf8") === text;
     } catch {
       return false;
     }
   });
   if (current && run(["is-active", "--quiet", WAKE_SOCKET]))
     return false;
-  await mkdir14(systemdDir(), { recursive: true });
+  await mkdir15(systemdDir(), { recursive: true });
   for (const [name, text] of Object.entries(units))
-    await writeFile12(join18(systemdDir(), name), text);
+    await writeFile13(join19(systemdDir(), name), text);
   run(["daemon-reload"]);
   run(["enable", WAKE_SOCKET]);
   run(["restart", WAKE_SOCKET]);
@@ -57169,7 +57950,7 @@ async function installSystemdWake(program, run = systemctl) {
 async function uninstallSystemdWake(run = systemctl) {
   run(["disable", "--now", WAKE_SOCKET]);
   for (const name of [WAKE_SOCKET, WAKE_SERVICE])
-    await rm5(join18(systemdDir(), name), { force: true });
+    await rm6(join19(systemdDir(), name), { force: true });
   run(["daemon-reload"]);
 }
 function peerKind(ip) {
@@ -57334,7 +58115,7 @@ function lsofPeer() {
 
 // apps/cli/src/index.ts
 var VERSION2 = package_default.version;
-var here = dirname11(fileURLToPath2(import.meta.url));
+var here = dirname12(fileURLToPath2(import.meta.url));
 var HELP = `Ponzu ${VERSION2}: the open source canvas your agent draws on in HTML and CSS.
 
 Usage
@@ -57459,7 +58240,7 @@ async function openWorkspace(files, log) {
   const paths = files.length ? files.map((f) => resolve5(f)) : await findDesigns(process.cwd());
   const named = [];
   for (const p of paths) {
-    if (!existsSync13(join19(p, "design.json")) && existsSync13(p) === false && files.length) {
+    if (!existsSync13(join20(p, "design.json")) && existsSync13(p) === false && files.length) {
       log(`Creating ${p}`);
     }
     const { key } = await ws.open(p);
@@ -57485,10 +58266,15 @@ async function runServe(files, o) {
     root: process.cwd(),
     tailnet: o.tailnet,
     tailnetPort: 7777,
-    dbFile: join19(ponzuHome(), "ponzu.db"),
-    stateFile: join19(ponzuHome(), "catalog.json"),
+    dbFile: join20(ponzuHome(), "ponzu.db"),
+    stateFile: join20(ponzuHome(), "catalog.json"),
     spotlight: process.env.PONZU_SPOTLIGHT === "0" ? false : undefined,
     agents: async () => agents(),
+    suggest: {
+      bin: (agent) => agentCli(agent),
+      env: agentEnv(),
+      file: join20(ponzuHome(), "suggestions.json")
+    },
     opened: named,
     version: VERSION2,
     telemetry: phoneTelemetry(),
@@ -57594,7 +58380,7 @@ function absolutePaths(args, cwd) {
 }
 async function runInit(target = "design/untitled.design") {
   const path = resolve5(target.endsWith(".design") ? target : `${target}.design`);
-  if (existsSync13(join19(path, "design.json"))) {
+  if (existsSync13(join20(path, "design.json"))) {
     console.error(`${path} already exists.`);
     process.exit(1);
   }
@@ -57616,11 +58402,11 @@ Next: ponzu serve ${target}`);
 }
 function findStudio() {
   const candidates = [
-    join19(here, "../studio"),
-    join19(here, "../../studio/dist"),
-    join19(here, "../../../apps/studio/dist")
+    join20(here, "../studio"),
+    join20(here, "../../studio/dist"),
+    join20(here, "../../../apps/studio/dist")
   ];
-  return candidates.find((c) => existsSync13(join19(c, "index.html")));
+  return candidates.find((c) => existsSync13(join20(c, "index.html")));
 }
 function lanAddresses() {
   const out = [];