symbiot 0.36.1 → 0.37.0

package/README.md

@@ -52,7 +52,8 @@ Tabs:
   one-line verdict on whether it needs new work at all (it prefers stabilising over
   new features), and ideas you can tick straight into **Tasks**. The graph needs
   **no AI key**; reviews and suggestions use your chosen model. While the scan runs
-  the Map shows its progress.
+  the Map shows its progress. Under the graph is the [experimental](#screens-blueprints-for-screen-automation)
+  **Screens** view.
 - **Drift** — the [`symbiot drift`](#whats-out-of-sync-symbiot-drift) report, with
   a "fetch latest" toggle (and an [experimental](#experimental) "check CI").
 - **Week / Standup / Todo** — the write-ups (these use your chosen AI).
@@ -71,7 +72,8 @@ Tabs:
   did** — files changed and commits made, read from git, whichever agent it was.
   When an agent leaves **questions, options or ideas** for you, they show up on its
   block (see [Questions from your agent](#questions-from-your-agent)).
-- **Settings** — your AI, the folders to scan and your agent command, plus the
+- **Settings** — your AI, the folders to scan, your agent command, the
+  [weekly write-up and start at login](#every-week-and-at-login), plus the
   [experimental](#experimental) email, model recommendations and one-click local
   model.
 
@@ -89,6 +91,25 @@ it falls back to a free one.
 It works on **Linux, macOS and Windows**; with no Chromium-family browser to open
 the chrome-less window, it uses your default browser.
 
+### Every week, and at login
+
+Two switches in Settings do what the old `symbiot-desktop` tray app did (that
+repo is now archived), without Electron:
+
+- **Write my week and notify me** on a day and hour you pick (Friday 16:00 by
+  default). The app writes your week with your chosen AI, saves it to
+  `~/.config/symbiot/weeks/<date>.md`, and sends a desktop notification
+  (`notify-send` on Linux, Notification Center on macOS, a tray balloon on
+  Windows). The Week tab shows it until you write a new one. It runs while
+  `symbiot app` is running. A week missed while the computer was off is written
+  when the app next starts, once. **Write it now** checks that it works.
+- **Start Symbiot in the background when I log in** adds an autostart entry
+  (`~/.config/autostart/symbiot.desktop` on Linux, a LaunchAgent on macOS, the
+  Startup folder on Windows) that starts `symbiot app` with no window, so the
+  weekly write-up happens even on days you don't open it. Running `symbiot app`
+  then opens that copy's window. Switch it off to remove the entry. It needs an
+  installed Symbiot (`npm install -g symbiot`), not `npx`.
+
 ## Hand tasks to your coding agent: `symbiot push`
 
 ```bash
@@ -173,9 +194,14 @@ One agent per repo: while a run is still going (tracked in
 `.symbiot/agent.pid`, so the app and `symbiot push --open` both see it), sending
 again doesn't start a second agent there, and doesn't rewrite the `TASKS.md` it's
 working from either: the new tasks wait in `.symbiot/TASKS.next.md` and replace
-`TASKS.md` when it finishes, keeping anything it ticked. Send again then to start
-an agent on them. Orca and editor presets only open a tab and exit, so Symbiot
-can't see the agent you run in them. Send to repos stays disabled until its
+`TASKS.md` when it finishes, keeping anything it ticked. The agent's block in the
+**Agents** tab shows "tasks held" meanwhile (hover it for their titles), and
+when the agent finishes, the app starts one on the held tasks by itself. If
+`symbiot push --open` started the running agent, the app can't see it exit, so
+it starts one the next time it checks that repo after it finishes (opening the
+**Tasks** tab), or you can send again. Orca and
+editor presets only open a tab and exit, so Symbiot can't see the agent you run
+in them. Send to repos stays disabled until its
 handoffs have started, so a double click can't send twice.
 
 ### Questions from your agent
@@ -373,6 +399,35 @@ the one-line install for your OS and you re-run it after. Both are buttons in
 Settings, where the download shows in the Agents tab. You can always pick a model
 yourself with `symbiot login`.
 
+### Screens: blueprints for screen automation
+
+Under the Map, **Screens** builds the map that screen automation needs: what's on a
+screen, and where. **Capture screen** (now, or after a few seconds so you can bring
+the right window to the front) or **Load image** for a PNG you already have, then
+drag a box over each part that matters (a button, a field, a menu) and name it.
+Hovering shows the pixel under the pointer. Each region keeps its position and size
+in the screenshot's own pixels, plus its **centre**, the point a click would aim at.
+**Copy blueprint** copies them as JSON; everything is also saved in
+`~/.config/symbiot/screens/screens.json` (next to each screen's PNG), where an
+agent or script can read it.
+
+**Click here** on a region moves your mouse to the region's centre and clicks there,
+on your real screen. It asks you to confirm every time, and can wait 3, 5 or 10
+seconds first so you can bring the right window to the front. It clicks with
+`cliclick` on macOS (`brew install cliclick`), and on Linux with `xdotool` on X11 or
+`ydotool` on Wayland (which needs access to `/dev/uinput`, and `ydotoold` running for
+ydotool 1.x). Windows can't click yet. Nothing types yet.
+
+Capture uses the screenshot tool your system has: `screencapture` on macOS,
+PowerShell on Windows, and on Linux `gnome-screenshot`, `spectacle`,
+`cosmic-screenshot`, `grim` or `xfce4-screenshooter` (plus `scrot` / ImageMagick
+`import` on X11). Why it's experimental: Wayland desktops restrict screenshots, so
+capture may fail or ask for permission (use **Load image** then). And on a scaled
+(HiDPI) display, screenshot pixels can differ from the coordinates a click tool
+expects. Symbiot rescales for `xdotool` and for `cliclick` on a Retina screen, but
+it can't read the scale on Wayland, and ydotool's moves follow your pointer
+acceleration, so a click there can land off target.
+
 ## Config, development and releasing
 
 Config files, environment variables (`SYMBIOT_MODEL`, `SYMBIOT_PORT`, …), the test

package/agents.mjs

@@ -68,8 +68,7 @@ function runHandoff(repoPath) {
   const lock = join(repoPath, ".symbiot", LOCK);
   const e = track(repoPath.split("/").pop(), fillHandoff(tmpl, repoPath), repoPath, () => {
     try { if (JSON.parse(readFileSync(lock, "utf8")).pid === e.pid) unlinkSync(lock); } catch {}
-    // tasks sent while it ran land now; start on them as that Send would have
-    if (releaseHeldTasks(repoPath) && /^\s*-\s*\[ \]/m.test(readSymbiot(repoPath, "TASKS.md"))) { const n = runHandoff(repoPath); if (n && !n.busy) n.fromHeld = true; }
+    startHeldTasks(repoPath); // tasks sent while it ran land now; start on them as that Send would have
   });
   if (!e) return null;
   e.handoff = true;
@@ -111,6 +110,16 @@ function releaseHeldTasks(path) {
   const md = held.split("\n").map((l) => /^\s*-\s*\[ \]/.test(l) && ticked.has(key(l)) ? l.replace("[ ]", "[x]") : l).join("\n");
   try { writeFileSync(join(path, ".symbiot", "TASKS.md"), md); unlinkSync(join(path, ".symbiot", HELD)); return true; } catch { return false; }
 }
+// Land the held brief and, if it leaves anything open, start an agent on it.
+// Runs when an agent this process started exits, and when the app next checks
+// the repo (syncTasks), which covers one `symbiot push --open` started: that
+// process is gone by the time its agent finishes. A held brief is released only
+// once, so this can't loop. Returns the new job, or null.
+function startHeldTasks(path) {
+  if (!releaseHeldTasks(path) || !/^\s*-\s*\[ \]/m.test(readSymbiot(path, "TASKS.md"))) return null;
+  const n = runHandoff(path); if (!n || n.busy) return null;
+  n.fromHeld = true; return n;
+}
 // Presets. [cmd, label, macAppName] — macApp used to launch GUI editors on macOS
 // where the CLI isn't on PATH (they're .app bundles).
 const IDE_LIST = [["code", "VS Code", "Visual Studio Code"], ["cursor", "Cursor", "Cursor"], ["windsurf", "Windsurf", "Windsurf"], ["zed", "Zed", "Zed"], ["subl", "Sublime Text", "Sublime Text"], ["idea", "IntelliJ IDEA", "IntelliJ IDEA"], ["nvim", "Neovim", ""]];
@@ -318,10 +327,10 @@ function answerQuestions(path, answers, opts = {}) {
   if (opts.rerun) { const e = runHandoff(path); if (e && e.busy) out.note = "Answers saved. An agent is still running in that folder, so another wasn't started. Send them again once it finishes."; else if (e) out.rerun = e.id; else out.note = "Answers saved. Set an agent command in Settings to have the agent pick them up automatically."; }
   return out;
 }
-// Open tasks in a held brief (TASKS.next.md), or null if nothing is held.
+// The open tasks' titles in a held brief (TASKS.next.md), or null if nothing is held.
 function heldTasks(path) {
   const md = readSymbiot(path, HELD);
-  return md ? md.split("\n").filter((l) => /^\s*-\s*\[ \]/.test(l)).length : null;
+  return md ? md.split("\n").filter((l) => /^\s*-\s*\[ \]/.test(l)).map((l) => l.replace(/^\s*-\s*\[ \]\s*/, "").trim().slice(0, 200)) : null;
 }
 // The Agents tab: every tracked job, its log tail, what it changed, and — on the
 // newest job per folder — the questions/ideas it left and any tasks held for it.
@@ -334,4 +343,4 @@ function agentsList() {
   });
 }
 
-export { HANDOFFS, HANDOFF_PROMPT, QUESTIONS_MAX, shSingle, CLAUDE_CMD, ORCA_CLAUDE_CMD, handoffCmd, setHandoffCmd, grantAgent, fillHandoff, runHandoff, runningHandoff, writeTasks, releaseHeldTasks, detectHandoffs, orcaHandoffCmd, migrateOrcaCmd, migrateClaudeCmd, track, agentChanges, parseQuestions, agentQuestions, answerQuestions, agentsList };
+export { HANDOFFS, HANDOFF_PROMPT, QUESTIONS_MAX, shSingle, CLAUDE_CMD, ORCA_CLAUDE_CMD, handoffCmd, setHandoffCmd, grantAgent, fillHandoff, runHandoff, runningHandoff, writeTasks, releaseHeldTasks, startHeldTasks, detectHandoffs, orcaHandoffCmd, migrateOrcaCmd, migrateClaudeCmd, track, agentChanges, parseQuestions, agentQuestions, answerQuestions, agentsList };

package/desktop.mjs

@@ -0,0 +1,132 @@
+// symbiot — what the symbiot-desktop tray app added, now part of `symbiot app`:
+// a weekly write-up with a desktop notification, and starting at login.
+// No Electron: the app's own server runs the weekly schedule while it's up, and
+// start-at-login launches that server in the background (no window) when you
+// log in, so the write-up still happens on days you never open Symbiot.
+// `symbiot app` then finds that running copy and opens its window.
+import { spawn } from "node:child_process";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync, readdirSync, statSync } from "node:fs";
+import { CONFIG_DIR, loadConfig, saveConfig, hasCmd } from "./core.mjs";
+
+// ---- weekly write-up --------------------------------------------------------
+// config.weekly = { on, day (0 = Sunday … 6 = Saturday), hour (0-23), last (ms) }.
+// Each run saves the write-up to ~/.config/symbiot/weeks/<date>.md.
+const WEEKS_DIR = join(CONFIG_DIR, "weeks");
+const intIn = (v, lo, hi, def) => { const n = v === "" || v == null ? NaN : Number(v); return Number.isInteger(n) && n >= lo && n <= hi ? n : def; };
+function weeklyCfg(cfg = loadConfig()) {
+  const w = cfg.weekly || {};
+  return { on: !!w.on, day: intIn(w.day, 0, 6, 5), hour: intIn(w.hour, 0, 23, 16), last: Number(w.last) || 0 };
+}
+// The latest scheduled moment at or before `now`, in local time.
+function lastSlot(now, day, hour) {
+  const d = new Date(now); d.setHours(hour, 0, 0, 0);
+  d.setDate(d.getDate() - ((d.getDay() - day + 7) % 7));
+  if (d.getTime() > now) d.setDate(d.getDate() - 7);
+  return d.getTime();
+}
+// Due when it's on and hasn't run since the latest slot, so a slot missed while
+// the computer was off runs as soon as the app is up again (once, not per week missed).
+function weeklyDue(w, now = Date.now()) { return !!w.on && w.last < lastSlot(now, w.day, w.hour); }
+// Any change to the schedule counts as a run now, so switching it on (or moving
+// the day) never fires straight away for a slot that's already past.
+function setWeekly(b = {}) {
+  const cfg = loadConfig(), w = weeklyCfg(cfg);
+  if (typeof b.on === "boolean") w.on = b.on;
+  w.day = intIn(b.day, 0, 6, w.day); w.hour = intIn(b.hour, 0, 23, w.hour); w.last = Date.now();
+  cfg.weekly = w; saveConfig(cfg);
+  return weeklyState();
+}
+const localDay = (t = Date.now()) => { const d = new Date(t); return [d.getFullYear(), d.getMonth() + 1, d.getDate()].map((n) => String(n).padStart(2, "0")).join("-"); };
+const FOOT = "\n\n---\n";
+// The newest saved write-up, or null.
+function latestWeek() {
+  try {
+    const f = readdirSync(WEEKS_DIR).filter((x) => /^\d{4}-\d{2}-\d{2}\.md$/.test(x)).sort().pop(); if (!f) return null;
+    const file = join(WEEKS_DIR, f), raw = readFileSync(file, "utf8"), i = raw.lastIndexOf(FOOT);
+    return { file, at: statSync(file).mtimeMs, text: (i >= 0 ? raw.slice(0, i) : raw).trim(), footer: i >= 0 ? raw.slice(i + FOOT.length).trim() : "" };
+  } catch { return null; }
+}
+function weeklyState() { return { ...weeklyCfg(), latest: latestWeek() }; }
+// Write the week with `produce` (index.mjs), save it and notify. `last` is set
+// first, so a slow or failing run is never retried every minute.
+async function runWeekly(produce) {
+  const cfg = loadConfig(); cfg.weekly = { ...weeklyCfg(cfg), last: Date.now() }; saveConfig(cfg);
+  const r = await produce("week");
+  if (r.error === "not-connected") { desktopNotify("Symbiot", "Time for your weekly update. Connect an AI in Symbiot's Settings and it writes it for you."); return { error: r.error }; }
+  if (/^\(?couldn't reach the model/i.test(String(r.text || ""))) { desktopNotify("Symbiot", "Couldn't write your week: the model didn't answer. Try the Week tab."); return { error: r.text }; }
+  const file = join(WEEKS_DIR, localDay() + ".md");
+  try { mkdirSync(WEEKS_DIR, { recursive: true }); writeFileSync(file, String(r.text || "").trim() + (r.footer ? FOOT + r.footer : "") + "\n"); }
+  catch (e) { return { error: "Couldn't save the write-up: " + ((e && e.message) || e) }; }
+  desktopNotify("Symbiot", "Your week is written. Open the Week tab in Symbiot, or " + file);
+  return { ok: true, file, text: r.text };
+}
+// Checks once a minute while the app runs. Returns a stop function.
+function startWeekly(produce) {
+  let busy = false;
+  const tick = () => { if (busy || !weeklyDue(weeklyCfg())) return; busy = true; runWeekly(produce).catch(() => {}).finally(() => { busy = false; }); };
+  const first = setTimeout(tick, 5000), every = setInterval(tick, 60 * 1000);
+  first.unref(); every.unref();
+  return () => { clearTimeout(first); clearInterval(every); };
+}
+
+// ---- desktop notification (no dependencies) ---------------------------------
+// [cmd, args] for this OS, or null when there's nothing to notify with.
+function notifyCmd(title, body, platform = process.platform) {
+  if (platform === "darwin") return ["osascript", ["-e", `display notification ${JSON.stringify(body)} with title ${JSON.stringify(title)}`]];
+  if (platform === "win32") {
+    const q = (s) => "'" + String(s).replace(/'/g, "''") + "'";
+    return ["powershell", ["-NoProfile", "-WindowStyle", "Hidden", "-Command", `Add-Type -AssemblyName System.Windows.Forms; $n = New-Object System.Windows.Forms.NotifyIcon; $n.Icon = [System.Drawing.SystemIcons]::Information; $n.Visible = $true; $n.ShowBalloonTip(10000, ${q(title)}, ${q(body)}, 'Info'); Start-Sleep -Seconds 11; $n.Dispose()`]];
+  }
+  return hasCmd("notify-send") ? ["notify-send", ["--app-name=Symbiot", title, body]] : null;
+}
+function desktopNotify(title, body) {
+  const c = notifyCmd(title, body); if (!c) return false;
+  try { const ch = spawn(c[0], c[1], { detached: true, stdio: "ignore" }); ch.on("error", () => {}); ch.unref(); return true; } catch { return false; }
+}
+
+// ---- start at login -----------------------------------------------------------
+// One file per OS, in the place that OS starts things from at login: an XDG
+// autostart entry (Linux), a LaunchAgent (macOS), the Startup folder (Windows).
+// It runs `symbiot app` with SYMBIOT_NO_OPEN=1, so no window pops up. PATH is
+// saved too, so agents and git resolve as they do in your terminal.
+function autostartFile(platform = process.platform, home = homedir()) {
+  if (platform === "darwin") return join(home, "Library", "LaunchAgents", "co.symbiot.app.plist");
+  if (platform === "win32") return join(home, "AppData", "Roaming", "Microsoft", "Windows", "Start Menu", "Programs", "Startup", "symbiot.cmd");
+  return join(home, ".config", "autostart", "symbiot.desktop");
+}
+function autostartContent(node, script, platform = process.platform, path = process.env.PATH || "") {
+  if (platform === "darwin") {
+    const x = (s) => String(s).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict>
+  <key>Label</key><string>co.symbiot.app</string>
+  <key>ProgramArguments</key><array><string>${x(node)}</string><string>${x(script)}</string><string>app</string></array>
+  <key>EnvironmentVariables</key><dict><key>SYMBIOT_NO_OPEN</key><string>1</string><key>PATH</key><string>${x(path)}</string></dict>
+  <key>RunAtLoad</key><true/>
+</dict></plist>
+`;
+  }
+  if (platform === "win32") return ["@echo off", "set SYMBIOT_NO_OPEN=1", `start "Symbiot" /min "${node}" "${script}" app`, ""].join("\r\n");
+  // Desktop Entry Exec quoting: double quotes, with " ` $ \ backslash-escaped
+  const q = (s) => '"' + String(s).replace(/(["`$\\])/g, "\\$1") + '"';
+  return ["[Desktop Entry]", "Type=Application", "Name=Symbiot", "Comment=Symbiot in the background: the weekly write-up and its notification",
+    `Exec=env SYMBIOT_NO_OPEN=1 ${q("PATH=" + path)} ${q(node)} ${q(script)} app`, "Terminal=false", "NoDisplay=true", "X-GNOME-Autostart-enabled=true", ""].join("\n");
+}
+function autostartState() { const file = autostartFile(); return { on: existsSync(file), file }; }
+// `script` is index.mjs's real path. From npx that's a cache folder that goes
+// away, so it has to be installed for this to keep working.
+function setAutostart(on, script) {
+  const file = autostartFile();
+  try {
+    if (!on) { if (existsSync(file)) unlinkSync(file); return autostartState(); }
+    if (/[\\/]_npx[\\/]/.test(String(script))) return { ...autostartState(), error: "Symbiot is running from npx. Install it first (npm install -g symbiot), then switch this on." };
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, autostartContent(process.execPath, script));
+    return autostartState();
+  } catch (e) { return { ...autostartState(), error: String((e && e.message) || e) }; }
+}
+
+export { weeklyCfg, lastSlot, weeklyDue, setWeekly, weeklyState, latestWeek, runWeekly, startWeekly, notifyCmd, desktopNotify, autostartFile, autostartContent, autostartState, setAutostart };

package/index.mjs

@@ -30,8 +30,10 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 import { EMBEDDED_UI } from "./ui.mjs";
 import { detectMailSources, mailActivity } from "./mail.mjs";
 import { CONFIG_PATH, loadConfig, saveConfig, loadTasks, saveTasks, sh, hasCmd, repoState } from "./core.mjs";
-import { HANDOFF_PROMPT, QUESTIONS_MAX, shSingle, CLAUDE_CMD, ORCA_CLAUDE_CMD, handoffCmd, setHandoffCmd, grantAgent, fillHandoff, runHandoff, writeTasks, releaseHeldTasks, detectHandoffs, orcaHandoffCmd, migrateOrcaCmd, migrateClaudeCmd, track, parseQuestions, agentQuestions, answerQuestions, agentsList } from "./agents.mjs";
+import { HANDOFF_PROMPT, QUESTIONS_MAX, shSingle, CLAUDE_CMD, ORCA_CLAUDE_CMD, handoffCmd, setHandoffCmd, grantAgent, fillHandoff, runHandoff, runningHandoff, writeTasks, startHeldTasks, detectHandoffs, orcaHandoffCmd, migrateOrcaCmd, migrateClaudeCmd, track, parseQuestions, agentQuestions, answerQuestions, agentsList } from "./agents.mjs";
 import { gitDefaultBranch, loadDeploys, driftRepo } from "./drift.mjs";
+import { loadScreens, screenImage, captureScreen, importScreen, setRegions, renameScreen, removeScreen, blueprint, clickRegion } from "./screens.mjs";
+import { weeklyState, setWeekly, runWeekly, startWeekly, autostartState, setAutostart } from "./desktop.mjs";
 
 const HERE = fileURLToPath(new URL(".", import.meta.url));
 let VERSION = "0"; try { VERSION = JSON.parse(readFileSync(join(HERE, "package.json"), "utf8")).version; } catch {}
@@ -125,16 +127,18 @@ function repoPathMap() {
 // please review", NOT archived: it waits in review until the user approves it
 // (approveRepo: branch + commit + push + PR, then archive) or sends it back
 // (sendBack: unticked, open again). Only a task the USER ticks archives directly.
+// Tasks held for an agent that has since finished land here too, and an agent
+// starts on what's still open in them (one `push --open` started can't do that).
 function syncTasks() {
-  const t = loadTasks(); const map = repoPathMap(); let review = 0, archived = 0; const checkedByRepo = {};
+  const t = loadTasks(); const map = repoPathMap(); let review = 0, archived = 0, started = 0; const checkedByRepo = {};
   for (const x of t) {
     if (x.archived || x.done || x.review || !x.repo) continue;
-    if (!(x.repo in checkedByRepo)) { const p = map[x.repo]; if (p) releaseHeldTasks(p); checkedByRepo[x.repo] = p ? completedInRepo(p) : []; }
+    if (!(x.repo in checkedByRepo)) { const p = map[x.repo]; if (p && startHeldTasks(p)) started++; checkedByRepo[x.repo] = p ? completedInRepo(p) : []; }
     if (checkedByRepo[x.repo].includes(x.text.toLowerCase())) { x.review = true; x.reviewAt = Date.now(); review++; }
   }
   for (const x of t) { if (x.done && !x.archived) { x.archived = true; x.archivedAt = Date.now(); archived++; } }
   saveTasks(t);
-  return { review, archived };
+  return { review, archived, started };
 }
 // git with an argv (task text goes into commit messages — never through a shell)
 function git(repo, args, timeout = 30000) {
@@ -161,18 +165,21 @@ function workingDiff(path, cap = 400000) {
 }
 // Repos with tasks awaiting review, plus repos Symbiot sent tasks to that have
 // uncommitted changes no ticked task covers (untasked: approve them as-is).
+// running: an agent is still editing there, so its changes may be half done.
 function pendingReview() {
   const t = loadTasks(), by = {}; for (const x of t) if (x.review && !x.done && !x.archived) (by[x.repo] = by[x.repo] || []).push(x);
   const sent = [...new Set(t.filter((x) => x.repo && !x.archived && !by[x.repo]).map((x) => x.repo))];
   const map = Object.keys(by).length || sent.length ? repoPathMap() : {};
   const am = autoMergeRepos();
-  const out = Object.keys(by).sort().map((repo) => { const path = map[repo] || ""; return { repo, path, tasks: by[repo], autoMerge: am.includes(repo), ...(path ? workingChanges(path) : { branch: "", files: [], stat: "" }) }; });
+  const out = Object.keys(by).sort().map((repo) => { const path = map[repo] || ""; return { repo, path, tasks: by[repo], autoMerge: am.includes(repo), running: !!(path && runningHandoff(path)), ...(path ? workingChanges(path) : { branch: "", files: [], stat: "" }) }; });
   for (const repo of sent.sort()) {
     const path = map[repo]; if (!path || !existsSync(join(path, ".symbiot", "TASKS.md"))) continue;
-    const wc = workingChanges(path); if (wc.files.length) out.push({ repo, path, tasks: [], untasked: true, autoMerge: am.includes(repo), ...wc });
+    const wc = workingChanges(path); if (wc.files.length) out.push({ repo, path, tasks: [], untasked: true, autoMerge: am.includes(repo), running: !!runningHandoff(path), ...wc });
   }
   return out;
 }
+// Approving while the agent is still editing would commit its half-done work.
+const stillWorking = (repo, path) => path && runningHandoff(path) ? { error: `The agent is still working in ${repo}. Approve once it finishes.`, running: true } : null;
 const branchSlug = (s) => String(s).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40).replace(/-+$/, "") || "tasks";
 // Sync approved work: off the default branch onto symbiot/<task>, commit the
 // working tree (minus .symbiot/), push, and open a PR with gh. Each step that
@@ -228,6 +235,7 @@ function approveRepo(repo, opts = {}) {
   const t = loadTasks(); const items = t.filter((x) => x.repo === repo && x.review && !x.done && !x.archived);
   if (!items.length) return { error: "Nothing awaiting review for " + (repo || "(no repo)") + "." };
   const path = repoPathMap()[repo]; if (!path) return { error: "Repo not found: " + repo };
+  const busy = stillWorking(repo, path); if (busy) return busy;
   const r = shipChanges(path, items.map((x) => x.text), { ...opts, autoMerge: opts.autoMerge !== undefined ? opts.autoMerge : autoMergeRepos().includes(repo) });
   if (r.error) return r;
   const now = Date.now();
@@ -241,6 +249,7 @@ function approveRepo(repo, opts = {}) {
 function approveChanges(repo, opts = {}) {
   if (loadTasks().some((x) => x.repo === repo && x.review && !x.done && !x.archived)) return approveRepo(repo, opts);
   const path = repoPathMap()[repo]; if (!path) return { error: "Repo not found: " + (repo || "(no repo)") };
+  const busy = stillWorking(repo, path); if (busy) return busy;
   if (!workingChanges(path).files.length) return { error: "No uncommitted changes in " + repo + "." };
   const r = shipChanges(path, [], { ...opts, autoMerge: opts.autoMerge !== undefined ? opts.autoMerge : autoMergeRepos().includes(repo) });
   return r.error ? r : { ...r, approved: 0 };
@@ -328,10 +337,10 @@ function cmdPush() {
   if (has("open")) {
     if (!r.handoff) console.log("\n" + c.y("No agent command set.") + c.d("  Set one in `symbiot app` Settings, or `agentCmd` in ~/.config/symbiot/config.json (use {dir} and {prompt})."));
     else {
-      const busy = r.written.filter((w) => { const e = runHandoff(w.path); return e && e.busy; });
+      const busy = r.written.map((w) => ({ w, e: runHandoff(w.path) })).filter((x) => x.e && x.e.busy);
       const n = r.written.length - busy.length;
       if (n) console.log("\n" + c.g("→ ") + `Handed ${n} repo(s) to your agent (${r.handoff}).`);
-      for (const w of busy) console.log("\n" + c.y("Not started: ") + `${w.name} already has an agent running.` + c.d("  Its new tasks are held until it finishes; send again then to start one on them."));
+      for (const { w, e } of busy) console.log("\n" + c.y("Not started: ") + `${w.name} already has an agent running.` + c.d(e.auto ? "  Its new tasks are held, and the app starts an agent on them when it finishes." : "  Its new tasks are held until it finishes. After that, the app starts an agent on them the next time it checks the repo (opening its Tasks tab), or send again."));
     }
   } else {
     console.log("\n" + c.d("Point your agent at .symbiot/TASKS.md in each repo.  (add --open to run your configured agent command)"));
@@ -1448,6 +1457,7 @@ async function cmdApp() {
     } catch {}
   }
   const json = (res, obj) => { res.writeHead(200, { "content-type": "application/json" }); res.end(JSON.stringify(obj)); };
+  const screenOut = (s) => (s && s.id ? { ...s, blueprint: blueprint(s) } : s);
   const server = createServer(async (req, res) => {
     const u = new URL(req.url, "http://127.0.0.1");
     if (req.method === "GET" && u.pathname === "/") { res.writeHead(200, { "content-type": "text/html; charset=utf-8" }); res.end(EMBEDDED_UI); return; }
@@ -1485,7 +1495,7 @@ async function cmdApp() {
       if (u.pathname === "/api/agentcfg") { const d = detectHandoffs(); return json(res, { cmd: handoffCmd(), agents: d.agents, editors: d.editors }); }
       if (u.pathname === "/api/agentcmd" && req.method === "POST") { const b = await readBody(req); return json(res, setHandoffCmd(b.cmd)); }
       if (u.pathname === "/api/agent/grant" && req.method === "POST") { const b = await readBody(req); return json(res, grantAgent({ tool: b.tool, dir: b.dir })); }
-      if (u.pathname === "/api/open" && req.method === "POST") { const b = await readBody(req); const e = runHandoff(String(b.path || "")); return json(res, { opened: !!e && !e.busy, busy: !!(e && e.busy), id: e ? e.id : "" }); }
+      if (u.pathname === "/api/open" && req.method === "POST") { const b = await readBody(req); const e = runHandoff(String(b.path || "")); return json(res, { opened: !!e && !e.busy, busy: !!(e && e.busy), auto: !!(e && e.auto), id: e ? e.id : "" }); }
       if (u.pathname === "/api/setup-local" && req.method === "POST") {
         const b = await readBody(req);
         if (!hasOllama()) return json(res, { error: "not-installed", install: ollamaInstall() });
@@ -1499,6 +1509,23 @@ async function cmdApp() {
       if (u.pathname === "/api/mail") return json(res, mailState());
       if (u.pathname === "/api/mail/set" && req.method === "POST") { const b = await readBody(req); return json(res, setMail(b)); }
       if (u.pathname === "/api/mail/preview") { const items = sentMail(Number(u.searchParams.get("days")) || SINCE_WEEK, true); return json(res, { count: items.length, items: items.slice(0, 20) }); }
+      // Screens: screenshots + named regions (screens.mjs). The image is an <img>
+      // src, so it carries the token in the query (?t=), which the check above accepts.
+      if (u.pathname === "/api/screens") return json(res, loadScreens().map(screenOut));
+      if (u.pathname === "/api/screens/image") { const f = screenImage(u.searchParams.get("id")); if (!f) { res.writeHead(404); res.end("not found"); return; } res.writeHead(200, { "content-type": "image/png", "cache-control": "private, max-age=86400" }); res.end(readFileSync(f)); return; } // a screen's image never changes
+      if (u.pathname === "/api/screens/capture" && req.method === "POST") { const b = await readBody(req); const d = Math.min(10, Math.max(0, Number(b.delay) || 0)); if (d) await new Promise((r) => setTimeout(r, d * 1000)); return json(res, screenOut(captureScreen(b.name))); }
+      if (u.pathname === "/api/screens/import" && req.method === "POST") { const b = await readBody(req); return json(res, screenOut(importScreen(b.name, b.png))); }
+      if (u.pathname === "/api/screens/regions" && req.method === "POST") { const b = await readBody(req); return json(res, screenOut(setRegions(String(b.id || ""), b.regions))); }
+      if (u.pathname === "/api/screens/rename" && req.method === "POST") { const b = await readBody(req); return json(res, screenOut(renameScreen(String(b.id || ""), b.name))); }
+      if (u.pathname === "/api/screens/remove" && req.method === "POST") { const b = await readBody(req); return json(res, removeScreen(String(b.id || ""))); }
+      // A real click on the real screen: only with the user's confirmation, after
+      // the delay they picked (to bring the right window to the front).
+      if (u.pathname === "/api/screens/click" && req.method === "POST") { const b = await readBody(req); if (b.confirmed !== true) return json(res, { error: "Each click needs your confirmation." }); const d = Math.min(10, Math.max(0, Number(b.delay) || 0)); if (d) await new Promise((r) => setTimeout(r, d * 1000)); return json(res, clickRegion(String(b.id || ""), String(b.region || ""))); }
+      // What symbiot-desktop added (desktop.mjs): the weekly write-up, start at login.
+      if (u.pathname === "/api/desktop") return json(res, { weekly: weeklyState(), autostart: autostartState() });
+      if (u.pathname === "/api/desktop/weekly" && req.method === "POST") { const b = await readBody(req); return json(res, setWeekly(b)); }
+      if (u.pathname === "/api/desktop/weekly/run" && req.method === "POST") return json(res, await runWeekly(produce));
+      if (u.pathname === "/api/desktop/autostart" && req.method === "POST") { const b = await readBody(req); return json(res, setAutostart(!!b.on, realpathSync(fileURLToPath(import.meta.url)))); }
       if (u.pathname === "/api/run" && req.method === "POST") { const b = await readBody(req); const cmd = ["week", "standup", "todo"].includes(b.cmd) ? b.cmd : "week"; return json(res, await produce(cmd)); }
       if (u.pathname === "/api/connect" && req.method === "POST") { return json(res, await connectProvider(await readBody(req))); }
       if (u.pathname === "/api/ping") { if (u.searchParams.get("fresh") === "1") await checkLatest(); return json(res, { version: VERSION, started: SERVER_STARTED, latest: LATEST_VERSION, newer: semverGt(LATEST_VERSION, VERSION) }); }
@@ -1535,6 +1562,7 @@ async function cmdApp() {
   });
   server.listen(PORT, "127.0.0.1");
   checkLatest(); setInterval(checkLatest, 2 * 60 * 1000).unref(); // background update check (every 2 min)
+  startWeekly(produce); // the weekly write-up + notification, when switched on in Settings
 }
 
 // `symbiot mail [--on|--off] [--add <path>]`: what mail it can read, and a preview.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "symbiot",
-  "version": "0.36.1",
+  "version": "0.37.0",
   "description": "Your week, written from your real work. Reads your local git and writes it up with the AI of your choice — Claude, OpenAI, Gemini, or a local model.",
   "type": "module",
   "bin": {
@@ -13,6 +13,8 @@
     "drift.mjs",
     "ui.mjs",
     "mail.mjs",
+    "screens.mjs",
+    "desktop.mjs",
     "README.md",
     "LICENSE"
   ],

package/screens.mjs

@@ -0,0 +1,152 @@
+// symbiot — Screens: screenshots with named regions, i.e. a blueprint of where
+// things are on a screen, in screenshot pixels. The first slices of screen
+// automation: it captures, stores and maps, and clicks a region's centre when
+// asked (the app confirms each click). Nothing types yet.
+//
+// Stored in ~/.config/symbiot/screens/: <id>.png per screen, and screens.json =
+// [{ id, name, w, h, ts, via, regions: [{ id, label, x, y, w, h }] }], which is
+// also what an agent or script reads to find a region.
+import { spawnSync } from "node:child_process";
+import { join } from "node:path";
+import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync, readdirSync, renameSync, rmSync } from "node:fs";
+import { randomBytes } from "node:crypto";
+import { CONFIG_DIR, hasCmd } from "./core.mjs";
+
+const SCREENS_DIR = join(CONFIG_DIR, "screens");
+const INDEX = join(SCREENS_DIR, "screens.json");
+const MAX_REGIONS = 200;
+const MAX_IMAGE = 40 * 1024 * 1024;
+function loadScreens() { try { const a = JSON.parse(readFileSync(INDEX, "utf8")); return Array.isArray(a) ? a : []; } catch { return []; } }
+function saveScreens(a) { mkdirSync(SCREENS_DIR, { recursive: true }); writeFileSync(INDEX, JSON.stringify(a, null, 2)); }
+const validId = (id) => /^[a-f0-9]{12}$/.test(String(id || ""));
+const screenFile = (id) => join(SCREENS_DIR, id + ".png");
+// The PNG's own file, or "" (ids are checked, so a request can't reach outside the folder).
+function screenImage(id) { return validId(id) && existsSync(screenFile(id)) ? screenFile(id) : ""; }
+
+// Width and height from a PNG's IHDR chunk, or null if it isn't a PNG.
+function pngSize(buf) {
+  if (!buf || buf.length < 24 || buf.readUInt32BE(0) !== 0x89504e47 || buf.readUInt32BE(4) !== 0x0d0a1a0a || buf.toString("ascii", 12, 16) !== "IHDR") return null;
+  const w = buf.readUInt32BE(16), h = buf.readUInt32BE(20);
+  return w && h ? { w, h } : null;
+}
+
+// Screenshot tools to try, in order, as [cmd, args] that write a PNG to `file`,
+// or [cmd, args, dir] for a tool that only takes a folder (it picks the name).
+// scrot and import only see X11, which on Wayland is a blank screen, so they're
+// left out there.
+function captureCmds(file, platform = process.platform, wayland = process.env.XDG_SESSION_TYPE === "wayland") {
+  if (platform === "darwin") return [["screencapture", ["-x", "-t", "png", file]]];
+  if (platform === "win32") {
+    const ps = "Add-Type -AssemblyName System.Windows.Forms,System.Drawing; $b = [System.Windows.Forms.SystemInformation]::VirtualScreen; $bmp = New-Object System.Drawing.Bitmap $b.Width, $b.Height; $g = [System.Drawing.Graphics]::FromImage($bmp); $g.CopyFromScreen($b.Left, $b.Top, 0, 0, $bmp.Size); $bmp.Save('" + file.replace(/'/g, "''") + "', [System.Drawing.Imaging.ImageFormat]::Png)";
+    return [["powershell", ["-NoProfile", "-Command", ps]]];
+  }
+  const dir = file.replace(/\.png$/, ".d");
+  return [["gnome-screenshot", ["-f", file]], ["spectacle", ["-b", "-n", "-f", "-o", file]], ["cosmic-screenshot", ["--interactive=false", "--modal=false", "--notify=false", "--save-dir", dir], dir], ["grim", [file]],
+    ["xfce4-screenshooter", ["-f", "-s", file]], ...(wayland ? [] : [["scrot", [file]], ["import", ["-window", "root", file]]])];
+}
+function addScreen(id, name, size, via) {
+  const s = { id, name: String(name || "").trim().slice(0, 80) || "Screen " + new Date().toLocaleString(), w: size.w, h: size.h, ts: Date.now(), via, regions: [] };
+  saveScreens([s, ...loadScreens()]);
+  return s;
+}
+// Take a screenshot of the whole screen with the first tool that works here.
+function captureScreen(name) {
+  const id = randomBytes(6).toString("hex"), file = screenFile(id), tried = [];
+  try { mkdirSync(SCREENS_DIR, { recursive: true }); } catch (e) { return { error: String((e && e.message) || e) }; }
+  const posix = process.platform !== "win32" && process.platform !== "darwin";
+  for (const [cmd, args, dir] of captureCmds(file)) {
+    if (posix && !hasCmd(cmd)) continue;
+    tried.push(cmd);
+    if (dir) try { mkdirSync(dir, { recursive: true }); } catch {}
+    spawnSync(cmd, args, { stdio: "ignore", timeout: 20000, killSignal: "SIGKILL" });
+    if (dir) { try { const f = readdirSync(dir).find((x) => /\.png$/i.test(x)); if (f) renameSync(join(dir, f), file); } catch {} rmSync(dir, { recursive: true, force: true }); }
+    let size = null; try { size = pngSize(readFileSync(file)); } catch {}
+    if (size) return addScreen(id, name, size, cmd);
+    try { unlinkSync(file); } catch {}
+  }
+  return { error: tried.length ? `Couldn't take a screenshot (tried ${tried.join(", ")}). Take one yourself and use Load image.` : "No screenshot tool found. Install gnome-screenshot, spectacle, grim or scrot, or take one yourself and use Load image." };
+}
+// A PNG you already have (base64, or a data: URL), for when capture can't run.
+function importScreen(name, data) {
+  const buf = Buffer.from(String(data || "").replace(/^data:[^,]*,/, ""), "base64");
+  if (buf.length > MAX_IMAGE) return { error: "That image is too big (40 MB at most)." };
+  const size = pngSize(buf); if (!size) return { error: "That isn't a PNG image." };
+  const id = randomBytes(6).toString("hex");
+  try { mkdirSync(SCREENS_DIR, { recursive: true }); writeFileSync(screenFile(id), buf); } catch (e) { return { error: String((e && e.message) || e) }; }
+  return addScreen(id, name, size, "loaded");
+}
+// Replace a screen's regions, clamped to the image and rounded to whole pixels.
+function setRegions(id, regions) {
+  const all = loadScreens(), s = all.find((x) => x.id === id); if (!s) return { error: "not found" };
+  const out = [];
+  for (const r of (Array.isArray(regions) ? regions : []).slice(0, MAX_REGIONS)) {
+    if (!r) continue;
+    const x = Math.max(0, Math.min(s.w - 1, Math.round(Number(r.x) || 0))), y = Math.max(0, Math.min(s.h - 1, Math.round(Number(r.y) || 0)));
+    const w = Math.max(1, Math.min(s.w - x, Math.round(Number(r.w) || 0))), h = Math.max(1, Math.min(s.h - y, Math.round(Number(r.h) || 0)));
+    out.push({ id: validId(r.id) ? r.id : randomBytes(6).toString("hex"), label: String(r.label || "").trim().slice(0, 80) || "region " + (out.length + 1), x, y, w, h });
+  }
+  s.regions = out; saveScreens(all);
+  return s;
+}
+function renameScreen(id, name) {
+  const all = loadScreens(), s = all.find((x) => x.id === id); if (!s) return { error: "not found" };
+  s.name = String(name || "").trim().slice(0, 80) || s.name; saveScreens(all); return s;
+}
+function removeScreen(id) {
+  const all = loadScreens(); if (!all.some((x) => x.id === id)) return { error: "not found" };
+  saveScreens(all.filter((x) => x.id !== id));
+  try { if (validId(id)) unlinkSync(screenFile(id)); } catch {}
+  return { ok: true };
+}
+const center = (r) => ({ x: r.x + Math.floor(r.w / 2), y: r.y + Math.floor(r.h / 2) });
+// What automation reads: each region with the point to aim at (its centre).
+function blueprint(s) {
+  return { screen: s.name, size: { w: s.w, h: s.h }, regions: (s.regions || []).map((r) => ({ label: r.label, x: r.x, y: r.y, w: r.w, h: r.h, center: center(r) })) };
+}
+
+// Click tools to try, in order, as a list of [cmd, args] steps that move the
+// mouse to (x, y) and left-click there. xdotool only reaches X11 windows, so on
+// Wayland it's ydotool (it needs /dev/uinput). ydotool 1.x moves relative unless
+// told --absolute and takes a button code; 0.1.x (Debian/Ubuntu) moves to the
+// point and takes a button number.
+function clickCmds(x, y, platform = process.platform, wayland = process.env.XDG_SESSION_TYPE === "wayland", ydotool1 = false) {
+  x = String(x); y = String(y);
+  if (platform === "darwin") return [[["cliclick", ["c:" + x + "," + y]]]];
+  if (platform === "win32") return [];
+  const ydo = ydotool1 ? [["ydotool", ["mousemove", "--absolute", "-x", x, "-y", y]], ["ydotool", ["click", "0xC0"]]] : [["ydotool", ["mousemove", x, y]], ["ydotool", ["click", "1"]]];
+  const xdo = [["xdotool", ["mousemove", "--sync", x, y, "click", "1"]]];
+  return wayland ? [ydo] : [xdo, ydo];
+}
+const ydotoolIs1 = () => /absolute/i.test(String(spawnSync("ydotool", ["mousemove", "--help"], { encoding: "utf8", timeout: 5000 }).stdout || ""));
+// The size of the screen in the units the click tool uses, when it can be read:
+// on macOS screencapture saves Retina pixels but cliclick takes points.
+function clickSpace(tool) {
+  const run = (cmd, args) => String(spawnSync(cmd, args, { encoding: "utf8", timeout: 5000 }).stdout || "");
+  const m = tool === "xdotool" ? run("xdotool", ["getdisplaygeometry"]).match(/(\d+)\s+(\d+)/)
+    : tool === "cliclick" ? run("osascript", ["-l", "JavaScript", "-e", "ObjC.import('AppKit'); var f = $.NSScreen.screens.objectAtIndex(0).frame; f.size.width + ' ' + f.size.height"]).match(/(\d+)\s+(\d+)/) : null;
+  return m && +m[1] && +m[2] ? { w: +m[1], h: +m[2] } : null;
+}
+// Move the mouse to a region's centre and click it. The caller confirms first:
+// it clicks whatever is at that spot on the screen right now.
+function clickRegion(id, regionId) {
+  const s = loadScreens().find((x) => x.id === id); if (!s) return { error: "not found" };
+  const r = (s.regions || []).find((x) => x.id === regionId); if (!r) return { error: "That region is gone. Reload the screen." };
+  if (process.platform === "win32") return { error: "Clicking isn't supported on Windows yet." };
+  const c = center(r), wayland = process.env.XDG_SESSION_TYPE === "wayland";
+  // The first tool that's installed does it. If that fails it says so, rather
+  // than trying the next one: a half-done move + click could otherwise click twice.
+  const tool = clickCmds(c.x, c.y).map((st) => st[0][0]).find((t) => hasCmd(t));
+  if (tool) {
+    const sp = clickSpace(tool), x = sp ? Math.round(c.x * sp.w / s.w) : c.x, y = sp ? Math.round(c.y * sp.h / s.h) : c.y;
+    const steps = clickCmds(x, y, process.platform, wayland, tool === "ydotool" && ydotoolIs1()).find((st) => st[0][0] === tool);
+    for (const [cmd, args] of steps) {
+      const p = spawnSync(cmd, args, { encoding: "utf8", timeout: 10000, killSignal: "SIGKILL" });
+      if (p.status !== 0) return { error: `${tool} couldn't click: ` + (String(p.stderr || (p.error && p.error.message) || "").trim().split("\n").filter((l) => l && !/notice:/.test(l)).pop() || "exit " + p.status) };
+    }
+    return { ok: true, label: r.label, x, y, via: tool };
+  }
+  const want = process.platform === "darwin" ? "cliclick (brew install cliclick)" : wayland ? "ydotool" : "xdotool or ydotool";
+  return { error: `No click tool found. Install ${want}.` };
+}
+
+export { loadScreens, screenImage, pngSize, captureCmds, captureScreen, importScreen, setRegions, renameScreen, removeScreen, blueprint, clickCmds, clickRegion };

package/ui.mjs

@@ -124,6 +124,11 @@ label.check input{width:auto}
 .legend{display:flex;gap:14px;align-items:center;margin-top:10px;font-size:12px;color:var(--faint);flex-wrap:wrap}
 .lg{display:inline-flex;gap:6px;align-items:center}
 .lg i{width:10px;height:10px;border-radius:50%;display:inline-block}
+.scrwrap{position:relative;margin-top:10px;border:1px solid var(--line);border-radius:10px;overflow:hidden;cursor:crosshair;user-select:none;touch-action:none;background:var(--ink2)}
+.scrwrap img{display:block;width:100%;height:auto;pointer-events:none}
+.scrbox{position:absolute;border:2px solid var(--green);background:rgba(61,220,151,.12);pointer-events:none}
+.scrbox span{position:absolute;left:0;top:0;font-size:11px;background:var(--green);color:var(--ink);padding:1px 6px;white-space:nowrap}
+.scrbox.draw{border:2px dashed var(--amber);background:rgba(242,165,65,.14)}
 @media(max-width:760px){.maprow{flex-direction:column}.detail{width:auto;max-height:none}}
 </style></head><body>
 <div id="updatebar" class="updatebar"></div>
@@ -158,6 +163,14 @@ label.check input{width:auto}
 <button class="ghost" id="remap" style="margin-left:auto">Rescan</button>
 </div>
 <div id="review" class="review hidden"></div>
+<div style="margin-top:22px;border-top:1px solid var(--line);padding-top:4px">
+<div class="tgroup">Screens <span class="tcount">experimental &middot; blueprints for screen automation</span></div>
+<div class="note muted" style="margin-top:2px">Capture a screen, then drag a box over each part that matters (a button, a field, a menu) and name it. Each region keeps its pixel coordinates and its centre, ready for automation to aim at. <b>Click here</b> on a region clicks its centre on your real screen, after you confirm. Nothing types yet.</div>
+<div class="row" style="margin-top:10px"><input id="screenname" placeholder="name the screen, e.g. GitHub PR page" style="flex:1"><select id="screendelay" title="wait first, so you can bring the right window to the front" style="flex:0 0 auto;width:auto"><option value="0">now</option><option value="3">in 3s</option><option value="5">in 5s</option><option value="10">in 10s</option></select><button class="ghost" id="capture">Capture screen</button><button class="ghost" id="screenload" title="use a PNG screenshot you already have">Load image</button><input type="file" id="screenfile" accept="image/png" class="hidden"></div>
+<div id="screenmsg"></div>
+<div id="screenlist" class="taskfilter"></div>
+<div id="screenview"></div>
+</div>
 </section>
 <section id="panel-run" class="hidden">
 <div class="row"><button class="act" id="write">Write my <span id="what">week</span></button>
@@ -231,6 +244,13 @@ label.check input{width:auto}
 <div id="mailout"></div>
 </div>
 <div style="margin-top:20px;border-top:1px solid var(--line);padding-top:16px">
+<label>Weekly write-up and start at login</label>
+<label class="check"><input type="checkbox" id="weeklyon"> Write my week and send me a desktop notification every</label>
+<div class="row" style="margin-top:2px"><select id="weeklyday" style="width:auto"><option value="1">Monday</option><option value="2">Tuesday</option><option value="3">Wednesday</option><option value="4">Thursday</option><option value="5">Friday</option><option value="6">Saturday</option><option value="0">Sunday</option></select><span class="muted">at</span><select id="weeklyhour" style="width:auto"></select><button class="ghost" id="weeklynow" title="write it now and send the notification, to check it works">Write it now</button></div>
+<label class="check"><input type="checkbox" id="autostart"> Start Symbiot in the background when I log in (no window)</label>
+<div class="note muted" id="desktopnote"></div>
+</div>
+<div style="margin-top:20px;border-top:1px solid var(--line);padding-top:16px">
 <label>Local models <span class="muted">(experimental)</span></label>
 <button class="ghost" id="recbtn">Recommend models for my machine</button>
 <button class="ghost" id="setuplocal" style="margin-left:8px">Set up a free local model</button>
@@ -257,7 +277,7 @@ $('panel-settings').classList.toggle('hidden',!isSet);
 $('panel-tasks').classList.toggle('hidden',!isTasks);
 $('panel-drift').classList.toggle('hidden',!isDrift);
 $('panel-agents').classList.toggle('hidden',!isAgents);
-if(isRun){$('what').textContent=tab;$('out').textContent='Nothing yet - hit the button.';$('out').classList.add('muted');$('copy').classList.add('hidden');}
+if(isRun){$('what').textContent=tab;$('out').textContent='Nothing yet - hit the button.';$('out').classList.add('muted');$('copy').classList.add('hidden');$('outfoot').style.display='none';if(tab==='week')showLatestWeek();}
 if(isMap&&!mapLoaded)loadMap();
 if(isTasks){fillTaskRepos();loadTasks();}
 if(isDrift&&!driftLoaded)loadDrift();
@@ -377,14 +397,24 @@ var keys=Object.keys(groups).sort(function(a,b){var ia=TORDER.indexOf(a),ib=TORD
 var h="";keys.forEach(function(ty){h+="<div class='tgroup'>"+esc(ty)+" <span class='tcount'>"+groups[ty].length+"</span></div>";groups[ty].forEach(function(t){h+=taskRow(t,false);});});
 el.innerHTML=h;wireTaskRows(el);}
 function loadTasks(){TARCH=false;api('/api/tasks/sync',{}).then(function(){api('/api/tasks').then(function(list){ALLTASKS=list;renderTasks();});loadPending();});}
-function loadPending(){api('/api/pending').then(function(list){var el=document.getElementById('reviewlist');PENDTASKS=[];if(!list||!list.length){el.innerHTML='';return;}
+// While an agent is still working in a repo on the review list, its Approve is
+// greyed out; check again every few seconds, and when it finishes, sync (its last
+// ticks land in review) so Approve unlocks without reopening the tab. The poll
+// only re-renders on a change, so an open diff or chat isn't closed under you.
+var pendTimer=null,PENDRUN='';
+function pendRunning(list){return (list||[]).filter(function(r){return r.running;}).map(function(r){return r.repo;}).join('\\n');}
+function pendPoll(){if(pendTimer){clearTimeout(pendTimer);pendTimer=null;}if(!PENDRUN||current!=='tasks')return;
+pendTimer=setTimeout(function(){pendTimer=null;if(current!=='tasks')return;api('/api/pending').then(function(list){if(pendRunning(list)!==PENDRUN)loadTasks();else pendPoll();}).catch(pendPoll);},4000);}
+function loadPending(){api('/api/pending').then(function(list){var el=document.getElementById('reviewlist');PENDTASKS=[];PENDRUN=pendRunning(list);pendPoll();
+if(!list||!list.length){el.innerHTML='';return;}
 var n=0;list.forEach(function(r){n+=r.tasks.length||1;});
 var h="<div class='tgroup' style='color:var(--amber)'>Awaiting your review <span class='tcount'>"+n+"</span></div>";
 list.forEach(function(r){var ch=r.files.length?(r.files.length+" file"+(r.files.length>1?"s":"")+" changed"+(r.stat?" &middot; "+esc(r.stat):"")):"no uncommitted changes";
 h+="<div class='rcard' data-repo='"+esc(r.repo)+"'><div class='rhead'><b>"+esc(r.repo)+"</b><span class='muted'>"+(r.path?"on "+esc(r.branch||'?')+" &middot; "+ch:"repo not found on disk")+"</span></div>";
 r.tasks.forEach(function(t){PENDTASKS.push(t);h+="<div class='task' data-id='"+esc(t.id)+"'><span class='t'>"+esc(t.text)+"</span>"+askBtn(t)+"<button class='rm sendback' title='not right - send back to the agent (unticks it)'>&#8630;</button></div>";});
 if(r.untasked)h+="<div class='muted' style='margin:6px 0'>Uncommitted changes with no ticked task behind them. Check the diff before you approve.</div>";
-h+="<div class='row'><button class='act approve'"+(r.path?"":" disabled")+(r.untasked?" data-untasked='1' title='commit on a branch, push and open a PR, without a task'>Approve changes without a task &rarr; PR":" title='commit on a branch, push, open a PR, then archive'>Approve &rarr; "+(r.files.length?"PR":"archive"))+"</button>"+(r.files.length?"<button class='ghost showdiff'>Show diff</button>":"")+"<label title='Queue GitHub auto-merge so this PR lands once its CI checks pass. Needs Allow auto-merge on the repo.' style='margin-left:auto;font-size:12px;color:var(--faint);display:flex;align-items:center;gap:6px'><input type='checkbox' class='amtoggle' style='width:auto'"+(r.autoMerge?" checked":"")+"> auto-merge on green CI</label></div><div class='rdiff hidden'></div></div>";});
+if(r.running)h+="<div class='muted' style='margin:6px 0'>&#9203; Agent still working: its changes may be half done. Approve unlocks when it finishes.</div>";
+h+="<div class='row'><button class='act approve'"+(r.path&&!r.running?"":" disabled")+(r.running?" title='the agent is still editing this repo'>"+(r.untasked?"Approve changes without a task":"Approve")+" &middot; agent still working":r.untasked?" data-untasked='1' title='commit on a branch, push and open a PR, without a task'>Approve changes without a task &rarr; PR":" title='commit on a branch, push, open a PR, then archive'>Approve &rarr; "+(r.files.length?"PR":"archive"))+"</button>"+(r.files.length?"<button class='ghost showdiff'>Show diff</button>":"")+"<label title='Queue GitHub auto-merge so this PR lands once its CI checks pass. Needs Allow auto-merge on the repo.' style='margin-left:auto;font-size:12px;color:var(--faint);display:flex;align-items:center;gap:6px'><input type='checkbox' class='amtoggle' style='width:auto'"+(r.autoMerge?" checked":"")+"> auto-merge on green CI</label></div><div class='rdiff hidden'></div></div>";});
 el.innerHTML=h;
 el.querySelectorAll('.rcard').forEach(function(card){var repo=card.getAttribute('data-repo');
 card.querySelectorAll('.task').forEach(function(row){wireAsk(row,row.getAttribute('data-id'));});
@@ -449,7 +479,11 @@ if(answering()){stopAgentsPoll();if(anyRunning&&current==='agents')agentsTimer=s
 saveDrafts(el);AGENTLIST=list;
 el.innerHTML=list.map(function(a){var cls=a.status==='running'?'run':(a.status==='done'?'ok':'fail');
 var st=a.status==='running'?('working &middot; '+fmtE(a.elapsed)):(esc(a.status)+' &middot; '+fmtE(a.elapsed)+(a.exitCode!=null?' &middot; exit '+a.exitCode:''));
+if(a.fromHeld)st+=" &middot; started on the tasks held for the last run";
 if(nQs(a))st+=" &middot; <span style='color:var(--amber)'>needs your answers</span>";
+if(a.held!=null){var hn=a.held.length,ht=a.held.map(function(t){return "&bull; "+esc(t).replace(/'/g,'&#39;');}).join('&#10;');
+ht+=(hn?'&#10;&#10;':'')+(a.status==='running'?"Sent while this agent was running. They wait in .symbiot/TASKS.next.md, replace TASKS.md when it finishes (keeping its ticks), and an agent starts on them then.":"They wait in .symbiot/TASKS.next.md for the agent running in this folder to finish. After that, an agent starts on them the next time the Tasks tab checks this repo, or send again.");
+st+=" &middot; <span style='color:var(--amber);cursor:help' title='"+ht+"'>&#9208; "+(hn?hn+" task"+(hn>1?"s":"")+" held":"tasks held")+"</span>";}
 var b="<div class='dh'><span class='adot "+cls+"'></span><span class='dn'>"+esc(a.name)+"</span><span class='dd'>"+st+"</span></div>";
 if(a.status==='running')b+="<div class='bar'><i></i></div>";
 var ch=a.changed;
@@ -489,7 +523,7 @@ if(r.empty){btn.disabled=false;o.innerHTML="<div class='muted' style='margin-top
 var n=(r.written||[]).length;var opens=[];var h="<div class='drift' style='margin-top:10px'><div class='dh'><span class='dot-c'></span><span class='dn'>Done &mdash; wrote "+n+" file"+(n===1?"":"s")+"</span></div>";
 if(n){h+="<ul>";r.written.forEach(function(w){h+="<li class='info'>&#10003; <b>"+esc(w.name)+"</b> <span class='ev'>"+esc(w.file)+" ("+w.count+" task"+(w.count===1?"":"s")+")</span>"+(w.held?" <span class='ev'>&#9208; held: an agent is still running there, so these land when it finishes</span>":"")+"</li>";});h+="</ul>";}
 if(r.unresolved&&r.unresolved.length){var names=r.unresolved.map(function(u){return u.name;}).join(", ");var hasNoRepo=r.unresolved.some(function(u){return u.name==='(no repo)';});h+="<div class='dd' style='margin-top:6px'>&#9888; not sent: "+esc(names)+". "+(hasNoRepo?"Pick a repo in the dropdown next to <b>Add</b> so the task has somewhere to go.":"That repo isn't in the map &mdash; add its folder in Settings.")+"</div>";}
-if(r.handoff&&r.written&&r.written.length){opens=r.written.map(function(w){return api('/api/open',{path:w.path}).then(function(x){if(x&&x.busy){var d=document.createElement('div');d.className='dd';d.innerHTML="&#9888; <b>"+esc(w.name)+"</b> already has an agent running, so another wasn&#39;t started. Its new tasks are held until it finishes; send again then to start one on them.";o.appendChild(d);}}).catch(function(){});});h+="<div class='dd' style='margin-top:8px'>&#129302; Handed "+n+" repo(s) to your agent &mdash; opening the <b>Agents</b> tab to watch it work&hellip;</div>";setTimeout(function(){setTab('agents');},500);}
+if(r.handoff&&r.written&&r.written.length){opens=r.written.map(function(w){return api('/api/open',{path:w.path}).then(function(x){if(x&&x.busy){var d=document.createElement('div');d.className='dd';d.innerHTML="&#9888; <b>"+esc(w.name)+"</b> already has an agent running, so another wasn&#39;t started. "+(x.auto?"Its new tasks are held, and an agent starts on them when it finishes.":"Its new tasks are held until it finishes. After that, an agent starts on them the next time this tab checks the repo, or send again.");o.appendChild(d);}}).catch(function(){});});h+="<div class='dd' style='margin-top:8px'>&#129302; Handed "+n+" repo(s) to your agent &mdash; opening the <b>Agents</b> tab to watch it work&hellip;</div>";setTimeout(function(){setTab('agents');},500);}
 else{h+="<div class='dd' style='margin-top:8px'>Set an <b>agent command</b> in Settings to auto-run it on send (and watch it in the Agents tab). For now, tell your agent: <b>“Read .symbiot/TASKS.md and implement the unchecked items.”</b></div>";}
 h+="</div>";
 o.innerHTML=h;
@@ -552,6 +586,74 @@ function loadMap(){var p=document.getElementById("profile");p.textContent="Mappi
 function poll(){if(done)return;api('/api/scan').then(function(s){if(done)return;if(s&&s.active&&s.phase)p.textContent=scanLine(s);setTimeout(poll,600);}).catch(function(){});}
 setTimeout(poll,400);
 api("/api/map").then(function(g){done=true;mapLoaded=true;if(!g.nodes||!g.nodes.length){p.textContent="No git repositories found under your home folder.";return;}GRAPH=g;fillTaskRepos();layout(g.nodes,g.edges);view={k:1,x:0,y:0};p.innerHTML=profileLine(g)+(g.stats&&g.stats.partial?" &middot; <span class='err'>partial &mdash; the scan hit its time limit</span>":"");render();});}
+// Screens: a screenshot plus named regions, the blueprint (screens.mjs). Drag on
+// the image to mark a region; coordinates are the screenshot's own pixels.
+// Names stay out of attributes (esc() doesn't escape quotes): rows carry indexes.
+var SCREENS=[],SCREEN=null,SDRAG=null,SPEND=null,SCLICKDELAY=3;
+function loadScreensUI(){api('/api/screens').then(function(list){SCREENS=list||[];var id=SCREEN&&SCREEN.id;SCREEN=null;SCREENS.forEach(function(s){if(s.id===id)SCREEN=s;});renderScreenList();renderScreen();});}
+function renderScreenList(){var box=$('screenlist');if(!SCREENS.length){box.innerHTML="<span class='muted' style='font-size:12px'>No screens yet.</span>";return;}
+box.innerHTML="<span class='fl'>Screens</span>"+SCREENS.map(function(s,i){return "<button class='fchip"+(SCREEN&&SCREEN.id===s.id?" on":"")+"' data-i='"+i+"'>"+esc(s.name)+" <span class='tcount'>"+(s.regions||[]).length+"</span></button>";}).join('');
+box.querySelectorAll('.fchip').forEach(function(b){b.addEventListener('click',function(){var s=SCREENS[+b.getAttribute('data-i')];SCREEN=(SCREEN&&s&&SCREEN.id===s.id)?null:s;SPEND=null;renderScreenList();renderScreen();});});}
+function scrPct(v,of){return (v/of*100).toFixed(3)+'%';}
+function scrBox(r,s,cls){return "<div class='scrbox"+(cls?" "+cls:"")+"' style='left:"+scrPct(r.x,s.w)+";top:"+scrPct(r.y,s.h)+";width:"+scrPct(r.w,s.w)+";height:"+scrPct(r.h,s.h)+"'>"+(r.label?"<span>"+esc(r.label)+"</span>":"")+"</div>";}
+function renderScreen(){var v=$('screenview'),s=SCREEN;if(!s){v.innerHTML='';return;}
+var h="<div class='row' style='margin-top:10px'><input id='scrname' title='rename this screen' style='flex:1'><span class='muted'>"+s.w+" &times; "+s.h+" px</span><button class='ghost' id='scrcopy' title='copy the regions and their coordinates as JSON'>Copy blueprint</button><button class='ghost' id='scrdel'>Delete</button></div>";
+h+="<div class='scrwrap' id='scrwrap'><img src='/api/screens/image?id="+encodeURIComponent(s.id)+"&t="+encodeURIComponent(T)+"' alt='' draggable='false'>"+(s.regions||[]).map(function(r){return scrBox(r,s,'');}).join('')+(SPEND?scrBox(SPEND,s,'draw'):"")+"<div class='scrbox draw hidden' id='scrdraw'></div></div>";
+h+="<div class='mapbar' id='scrbar'>Drag on the screenshot to mark a region &middot; coordinates are screenshot pixels</div>";
+h+="<div class='row"+(SPEND?"":" hidden")+"' id='scrlabel' style='margin-top:8px'><input id='scrlabelin' placeholder='name this region, e.g. Merge button' style='flex:1'><button class='act' id='scrlabelok'>Add region</button><button class='ghost' id='scrlabelno'>Cancel</button></div>";
+var rs=(s.blueprint&&s.blueprint.regions)||[];
+if(rs.length)h+="<div class='row' style='margin-top:8px'><span class='muted' style='font-size:12px;flex:1'><b>Click here</b> moves your mouse to a region's centre and clicks, on your real screen. It asks first, every time.</span><select id='scrclickdelay' title='wait first, so you can bring the right window to the front' style='flex:0 0 auto;width:auto'>"+[0,3,5,10].map(function(d){return "<option value='"+d+"'"+(d===SCLICKDELAY?" selected":"")+">"+(d?"click in "+d+"s":"click now")+"</option>";}).join('')+"</select></div>";
+h+="<div id='scrregions'>"+(rs.length?rs.map(function(r,i){return "<div class='task' data-i='"+i+"'><span class='t'><b>"+esc(r.label)+"</b> <span class='muted' style='font-family:ui-monospace,Menlo,Consolas,monospace;font-size:12px'>x "+r.x+", y "+r.y+" &middot; "+r.w+"&times;"+r.h+" &middot; centre ("+r.center.x+", "+r.center.y+")</span></span><button class='ghost scrclick' title='move the mouse to the centre of this region and click there'>Click here</button><button class='rm scrrm' title='remove this region'>&times;</button></div>";}).join(''):"<div class='muted' style='font-size:12px;margin-top:8px'>No regions yet.</div>")+"</div>";
+v.innerHTML=h;wireScreen();}
+function scrPoint(ev){var rc=$('scrwrap').querySelector('img').getBoundingClientRect(),s=SCREEN;if(!rc.width||!rc.height)return {x:0,y:0};return {x:Math.max(0,Math.min(s.w-1,Math.round((ev.clientX-rc.left)/rc.width*s.w))),y:Math.max(0,Math.min(s.h-1,Math.round((ev.clientY-rc.top)/rc.height*s.h)))};}
+function scrRect(a,b){return {x:Math.min(a.x,b.x),y:Math.min(a.y,b.y),w:Math.abs(b.x-a.x),h:Math.abs(b.y-a.y)};}
+function screenErr(msg){$('screenmsg').innerHTML="<div class='note err'>"+esc(msg)+"</div>";}
+function screenSaved(s){if(!s||s.error){screenErr((s&&s.error)||'could not save');return;}$('screenmsg').innerHTML='';SCREENS=SCREENS.map(function(x){return x.id===s.id?s:x;});SCREEN=s;SPEND=null;renderScreenList();renderScreen();}
+function saveRegions(regions){api('/api/screens/regions',{id:SCREEN.id,regions:regions}).then(screenSaved);}
+function wireScreen(){var s=SCREEN,wrap=$('scrwrap'),bar=$('scrbar'),draw=$('scrdraw'),nm=$('scrname');
+nm.value=s.name;
+nm.addEventListener('change',function(){var n=(nm.value||'').trim();if(n)api('/api/screens/rename',{id:s.id,name:n}).then(screenSaved);});
+$('scrcopy').addEventListener('click',function(){var b=$('scrcopy');navigator.clipboard.writeText(JSON.stringify(s.blueprint,null,2));b.textContent='Copied';setTimeout(function(){b.textContent='Copy blueprint';},1400);});
+$('scrdel').addEventListener('click',function(){if(typeof confirm==='function'&&!confirm('Delete this screen and its regions?'))return;api('/api/screens/remove',{id:s.id}).then(function(){SCREEN=null;SPEND=null;loadScreensUI();});});
+wrap.addEventListener('pointerdown',function(ev){if(ev.button)return;ev.preventDefault();SDRAG=scrPoint(ev);try{wrap.setPointerCapture(ev.pointerId);}catch(e){}});
+wrap.addEventListener('pointermove',function(ev){var p=scrPoint(ev);if(!SDRAG){bar.innerHTML='<b>x '+p.x+', y '+p.y+'</b> &middot; drag to mark a region';return;}
+var r=scrRect(SDRAG,p);bar.innerHTML='<b>x '+r.x+', y '+r.y+' &middot; '+r.w+'&times;'+r.h+'</b>';draw.classList.remove('hidden');draw.style.left=scrPct(r.x,s.w);draw.style.top=scrPct(r.y,s.h);draw.style.width=scrPct(r.w,s.w);draw.style.height=scrPct(r.h,s.h);});
+wrap.addEventListener('pointerup',function(ev){if(!SDRAG)return;var r=scrRect(SDRAG,scrPoint(ev));SDRAG=null;if(r.w<4||r.h<4){draw.classList.add('hidden');return;}SPEND=r;renderScreen();$('scrlabelin').focus();});
+function addPending(){if(!SPEND)return;saveRegions((s.regions||[]).concat([{label:($('scrlabelin').value||'').trim(),x:SPEND.x,y:SPEND.y,w:SPEND.w,h:SPEND.h}]));}
+$('scrlabelok').addEventListener('click',addPending);
+$('scrlabelin').addEventListener('keydown',function(e){if(e.key==='Enter')addPending();else if(e.key==='Escape'){SPEND=null;renderScreen();}});
+$('scrlabelno').addEventListener('click',function(){SPEND=null;renderScreen();});
+$('scrregions').querySelectorAll('.scrrm').forEach(function(b){b.addEventListener('click',function(){var i=+b.closest('.task').getAttribute('data-i');saveRegions((s.regions||[]).filter(function(r,j){return j!==i;}));});});
+var cd=$('scrclickdelay');if(cd)cd.addEventListener('change',function(){SCLICKDELAY=+cd.value||0;});
+$('scrregions').querySelectorAll('.scrclick').forEach(function(b){b.addEventListener('click',function(){clickUI(s,+b.closest('.task').getAttribute('data-i'),b);});});}
+// A real click: confirmed every time (no confirm() to ask with means no click).
+function clickUI(s,i,b){var r=(s.regions||[])[i],c=s.blueprint&&s.blueprint.regions[i];if(!r||!c)return;var d=SCLICKDELAY;
+var q="Move your mouse to “"+r.label+"” at ("+c.center.x+", "+c.center.y+") and click there"+(d?" in "+d+" seconds":" now")+"?\\n\\nIt clicks whatever is at that spot on your screen"+(d?" by then, so bring the right window to the front.":".")+(s.via==='loaded'?"\\n\\nThis screen was loaded from an image: check it matches your screen now.":"");
+if(typeof confirm!=='function'||!confirm(q))return;
+b.disabled=true;$('screenmsg').innerHTML="<div class='note muted'>"+(d?"Clicking “"+esc(r.label)+"” in "+d+"s &mdash; bring the right window to the front&hellip;":"Clicking&hellip;")+"</div>";
+api('/api/screens/click',{id:s.id,region:r.id,delay:d,confirmed:true}).then(function(x){b.disabled=false;if(!x||x.error){screenErr((x&&x.error)||'failed');return;}
+$('screenmsg').innerHTML="<div class='note ok'>&#10003; Clicked “"+esc(x.label)+"” at ("+x.x+", "+x.y+") with "+esc(x.via)+".</div>";}).catch(function(e){b.disabled=false;screenErr(String((e&&e.message)||e));});}
+function screenAdded(s){if(!s||s.error){screenErr((s&&s.error)||'failed');return;}$('screenmsg').innerHTML='';$('screenname').value='';SCREEN=s;SPEND=null;loadScreensUI();}
+function captureUI(){var b=$('capture'),d=+($('screendelay').value||0);b.disabled=true;
+$('screenmsg').innerHTML="<div class='note muted'>"+(d?"Capturing in "+d+"s &mdash; bring the window you want to the front&hellip;":"Capturing&hellip;")+"</div>";
+api('/api/screens/capture',{name:$('screenname').value||'',delay:d}).then(function(s){b.disabled=false;screenAdded(s);}).catch(function(e){b.disabled=false;screenErr(String((e&&e.message)||e));});}
+function pickImageUI(){var f=$('screenfile');if(f&&f.click)f.click();}
+function importUI(){var f=$('screenfile'),file=f&&f.files&&f.files[0];if(!file)return;$('screenmsg').innerHTML="<div class='note muted'>Loading&hellip;</div>";
+var rd=new FileReader();rd.onload=function(){api('/api/screens/import',{name:$('screenname').value||file.name.replace(/[.]png$/i,''),png:rd.result}).then(function(s){f.value='';screenAdded(s);});};rd.readAsDataURL(file);}
+// Weekly write-up + start at login (desktop.mjs). The Week tab shows the latest
+// write-up until you write a new one.
+function renderDesktop(d){if(!d)return;var w=d.weekly||{},a=d.autostart||{};$('weeklyon').checked=!!w.on;$('weeklyday').value=String(w.day);$('weeklyhour').value=String(w.hour);$('autostart').checked=!!a.on;
+var n=[];if(d.error)n.push("<span class='err'>"+esc(d.error)+"</span>");
+if(w.latest)n.push("Latest write-up: "+esc(new Date(w.latest.at).toLocaleString())+" &middot; <span style='font-family:ui-monospace,monospace'>"+esc(w.latest.file)+"</span> (also in the Week tab)");
+n.push(a.on?"Starts at login from <span style='font-family:ui-monospace,monospace'>"+esc(a.file)+"</span>. Run <b>symbiot app</b> to open its window.":"The weekly write-up happens while Symbiot is running, so start it at login to have it every week. A week missed while the computer was off is written when Symbiot next starts.");
+$('desktopnote').innerHTML=n.join('<br>');}
+function loadDesktop(err){api('/api/desktop').then(function(d){if(d&&err)d.error=err;renderDesktop(d);});}
+function saveWeekly(){api('/api/desktop/weekly',{on:$('weeklyon').checked,day:$('weeklyday').value,hour:$('weeklyhour').value}).then(function(){loadDesktop();});}
+function saveAutostart(){api('/api/desktop/autostart',{on:$('autostart').checked}).then(function(a){loadDesktop(a&&a.error);});}
+function weeklyNow(){var b=$('weeklynow');b.disabled=true;b.textContent='Writing...';
+api('/api/desktop/weekly/run',{}).then(function(r){b.disabled=false;b.textContent='Write it now';loadDesktop(r&&r.error?(r.error==='not-connected'?'Connect an AI above first.':r.error):'');});}
+function showLatestWeek(){api('/api/desktop').then(function(d){var l=d&&d.weekly&&d.weekly.latest;if(!l||current!=='week'||$('out').textContent!=='Nothing yet - hit the button.')return;
+$('out').textContent=l.text;$('out').classList.remove('muted');$('copy').classList.remove('hidden');var f=$('outfoot');f.textContent='Written automatically '+new Date(l.at).toLocaleString()+' · '+l.file+(l.footer?' · '+l.footer:'');f.style.display='block';});}
 function fitBadge(m){return m.fits?"<span class='tag'>fits your RAM</span>":"<span class='tag' style='background:#3a2a12;border-color:#6b4a1f;color:#F2A541'>needs more RAM</span>";}
 function loadRec(){var out=document.getElementById('recout');out.innerHTML="<div class='muted'>Reading your hardware...</div>";
 api('/api/models').then(function(d){var hw=d.hardware,rec=d.rec;
@@ -582,6 +684,15 @@ document.getElementById('addmail').addEventListener('click',addMailUI);
 document.getElementById('newmail').addEventListener('keydown',function(e){if(e.key==='Enter')addMailUI();});
 document.getElementById('mailpreview').addEventListener('click',previewMail);
 document.getElementById('newtask').addEventListener('keydown',function(e){if(e.key==='Enter')addTaskUI();});
+document.getElementById('capture').addEventListener('click',captureUI);
+document.getElementById('screenload').addEventListener('click',pickImageUI);
+document.getElementById('screenfile').addEventListener('change',importUI);
+document.getElementById('weeklyon').addEventListener('change',saveWeekly);
+document.getElementById('weeklyday').addEventListener('change',saveWeekly);
+document.getElementById('weeklyhour').addEventListener('change',saveWeekly);
+document.getElementById('weeklynow').addEventListener('click',weeklyNow);
+document.getElementById('autostart').addEventListener('change',saveAutostart);
+(function(){var h='';for(var i=0;i<24;i++)h+="<option value='"+i+"'>"+(i<10?'0':'')+i+":00</option>";document.getElementById('weeklyhour').innerHTML=h;})();
 var SRV_STARTED=null,srvDown=false,updBusy=false;
 function ubar(){return document.getElementById('updatebar');}
 function heartbeat(fresh){
@@ -614,5 +725,5 @@ function heartbeat(fresh){
 function doUpdate(){updBusy=true;try{localStorage.setItem('symbiot_update_tried',document.getElementById('ver').textContent.replace(/^v/,''));}catch(e){}var b=ubar();b.className='updatebar show';b.textContent='Updating & restarting… this page will reload itself when it is back.';api('/api/update',{});}
 setInterval(heartbeat,4000);heartbeat(true);
 window.addEventListener('focus',function(){heartbeat(true);}); // re-check for updates when you come back to the window
-initGraphEvents();syncP();refresh();loadMap();loadAgentCfg();loadScanRoots();loadMail();
+initGraphEvents();syncP();refresh();loadMap();loadAgentCfg();loadScanRoots();loadMail();loadScreensUI();loadDesktop();
 </script></body></html>`;