symbiot 0.9.4 → 0.10.1

package/README.md

@@ -52,6 +52,19 @@ where no Chromium-family browser is found it opens your default browser instead.
 npm install -g symbiot        # or run without installing:  npx symbiot week
 ```
 
+## Hand tasks to your coding agent: `symbiot push`
+
+```bash
+symbiot push          # or the "Send to repos" button in the app's Tasks tab
+```
+
+Writes a **`.symbiot/TASKS.md`** into each repo your tasks reference — a checklist
+**plus the context an agent needs to get oriented**: the stack, recent commits,
+open `TODO/FIXME` markers (with `file:line`), and current drift. Then point Claude
+Code / Cursor / any agent at it: *"Read `.symbiot/TASKS.md` and implement the
+unchecked items."* Tasks come from ticking a repo review's ideas, or adding your
+own in the Tasks tab.
+
 ## What's out of sync? `symbiot drift`
 
 ```bash

package/index.mjs

@@ -103,6 +103,62 @@ function addTask(text, repo) {
 }
 function toggleTask(id) { const t = loadTasks(); const it = t.find((x) => x.id === id); if (it) { it.done = !it.done; saveTasks(t); } return it || { error: "not found" }; }
 function removeTask(id) { saveTasks(loadTasks().filter((x) => x.id !== id)); return { ok: true }; }
+// Push tasks into the repos as an agent-readable brief (.symbiot/TASKS.md):
+// a checklist plus the deterministic context an agent needs to get oriented.
+function buildTasksMd(name, ctx, list) {
+  const L = [];
+  L.push(`# Symbiot tasks — ${name}`);
+  L.push(`_generated ${new Date().toISOString().slice(0, 10)}${ctx.branch ? ` · branch ${ctx.branch}` : ""} · by symbiot ${VERSION}_`, "");
+  L.push("## Context for an AI agent", `Tasks for the \`${name}\` repo. Get oriented from the signals below before actioning them.`);
+  if (ctx.stack) L.push(`- **Stack:** ${ctx.stack}`);
+  if (ctx.commits && ctx.commits.length) { L.push("- **Recent commits:**"); for (const c of ctx.commits) L.push(`  - ${c}`); }
+  if (ctx.open && ctx.open.length) { L.push("- **Open markers (TODO/FIXME + uncommitted):**"); for (const o of ctx.open) L.push(`  - ${o}`); }
+  if (ctx.drift && ctx.drift.length) { L.push("- **Current drift / risk:**"); for (const d of ctx.drift) L.push(`  - ${d}`); }
+  L.push("", "## Tasks");
+  for (const t of list) L.push(`- [ ] ${t.text}`);
+  L.push("", "---", 'To action these, tell your coding agent: "Read `.symbiot/TASKS.md` and implement the unchecked items in this repo, using the context above. Confirm with me before anything destructive."');
+  return L.join("\n") + "\n";
+}
+function pushTasks() {
+  const tasks = loadTasks().filter((t) => !t.done);
+  if (!tasks.length) return { empty: true, written: [], unresolved: [] };
+  // Resolve repo name -> path from the already-scanned map when we have it
+  // (avoids a fresh full scan); fall back to a scan only if needed.
+  const byName = {};
+  const src = (LAST_MAP && LAST_MAP.nodes) ? LAST_MAP.nodes.filter((n) => n.type === "repo").map((n) => ({ name: n.label, path: n.meta && n.meta.path })) : findAllRepos(BASE);
+  for (const r of src) if (r.path && !byName[r.name]) byName[r.name] = r.path;
+  const groups = {}; for (const t of tasks) { const k = t.repo || ""; (groups[k] = groups[k] || []).push(t); }
+  const written = [], unresolved = [];
+  for (const name of Object.keys(groups)) {
+    const list = groups[name], path = name && byName[name];
+    if (!path) { unresolved.push({ name: name || "(no repo)", count: list.length }); continue; }
+    try {
+      // Cheap, per-repo signals only — no full drift scan (that can be very slow
+      // on big repos and would block the request).
+      const st = repoState(path);
+      const commits = sh(`git -C ${JSON.stringify(path)} log --format='%s' -10 2>/dev/null`).split("\n").filter(Boolean);
+      const open = openWork([{ path, name }]).slice(0, 12);
+      const det = detectRepo({ path, name, recency: 0 });
+      const stack = [...det.langs.slice(0, 4), ...det.tools].join(", ");
+      const risk = [];
+      if (st.stale) risk.push("stale checkout — working tree is an old snapshot, not new work");
+      if (st.behind) risk.push(`${st.behind} behind upstream on ${st.branch}`);
+      if (st.dirty && !st.stale) risk.push(`${st.dirty} uncommitted (${st.mod} mod / ${st.del} del / ${st.add} new)`);
+      const dir = join(path, ".symbiot"); mkdirSync(dir, { recursive: true });
+      const file = join(dir, "TASKS.md");
+      writeFileSync(file, buildTasksMd(name, { branch: st.branch, commits, open, drift: risk, stack }, list));
+      written.push({ name, file, count: list.length });
+    } catch (e) { unresolved.push({ name, count: list.length, error: String((e && e.message) || e) }); }
+  }
+  return { empty: false, written, unresolved };
+}
+function cmdPush() {
+  const r = pushTasks();
+  if (r.empty) { console.log(c.y("No open tasks to push.") + c.d("  Add some in `symbiot app` — a repo review's ideas, or the Tasks tab.")); return; }
+  if (r.written.length) { console.log("\n" + c.g("●") + " " + c.b("Pushed tasks into repos:")); for (const w of r.written) console.log(`  ${c.g("✓")} ${w.name}  ${c.d(w.file + "  (" + w.count + " task" + (w.count > 1 ? "s" : "") + ")")}`); }
+  if (r.unresolved.length) { console.log("\n" + c.y(`Not written (repo not found under ${BASE}):`)); for (const u of r.unresolved) console.log(`  · ${u.name} (${u.count})`); }
+  console.log("\n" + c.d("Open each repo in your IDE/agent and point it at .symbiot/TASKS.md."));
+}
 function envKey(provider) {
   for (const e of (PROVIDERS[provider].env || [])) if (process.env[e]) return process.env[e];
   return null;
@@ -1021,7 +1077,8 @@ footer{padding:10px 18px;border-top:1px solid var(--line);display:flex}
 <div class="rfoot" id="outfoot" style="display:none"></div>
 </section>
 <section id="panel-tasks" class="hidden">
-<div class="row"><input id="newtask" placeholder="Add a task..." style="flex:1"><button class="act" id="addtask">Add</button></div>
+<div class="row"><input id="newtask" placeholder="Add a task..." style="flex:1"><button class="act" id="addtask">Add</button><button class="ghost" id="pushtasks" title="Write .symbiot/TASKS.md into each repo for your coding agent">Send to repos</button></div>
+<div id="pushout"></div>
 <div id="tasklist"></div>
 </section>
 <section id="panel-drift" class="hidden">
@@ -1154,6 +1211,15 @@ if(clean.length)h+="<div class='muted' style='margin-top:10px'>clean: "+esc(clea
 if(!repos.length)h+="<div class='muted'>No repos found under your home folder.</div>";
 out.innerHTML=h;});}
 function addTaskUI(){var i=document.getElementById('newtask');var v=(i.value||'').trim();if(!v)return;api('/api/tasks/add',{text:v,repo:''}).then(function(){i.value='';loadTasks();});}
+function pushTasksUI(){var o=document.getElementById('pushout');var btn=document.getElementById('pushtasks');btn.disabled=true;
+o.innerHTML="<div class='muted' style='margin-top:10px'><span class='dot-c' style='background:var(--amber)'></span> Writing .symbiot/TASKS.md into your repos&hellip;</div>";
+api('/api/tasks/push').then(function(r){btn.disabled=false;
+if(r.empty){o.innerHTML="<div class='muted' style='margin-top:10px'>No open tasks to send. Tick ideas in a repo review, or add tasks above.</div>";return;}
+var n=(r.written||[]).length;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></li>";});h+="</ul>";}
+if(r.unresolved&&r.unresolved.length){h+="<div class='dd' style='margin-top:6px'>&#9888; not written (repo not found under your home folder): "+esc(r.unresolved.map(function(u){return u.name;}).join(", "))+"</div>";}
+h+="<div class='dd' style='margin-top:8px'>Now tell your coding agent, in each repo: <b>“Read .symbiot/TASKS.md and implement the unchecked items.”</b></div></div>";
+o.innerHTML=h;}).catch(function(e){btn.disabled=false;o.innerHTML="<div class='err' style='margin-top:10px'>Couldn&#39;t write tasks: "+esc(String((e&&e.message)||e))+"</div>";});}
 function selectNode(id){sel=id;render();updateBar(id);var n=nodeById(id);api('/api/node?id='+encodeURIComponent(id)).then(showDetail);
 if(n&&n.type==='repo'&&n.meta&&n.meta.path){loadReview(n.label,n.meta.path);}else{hideReview();}}
 function screenToGraph(el,ev){var rc=el.getBoundingClientRect();var mx=(ev.clientX-rc.left)/rc.width*GW;var my=(ev.clientY-rc.top)/rc.height*GH;return {x:(mx-view.x)/view.k,y:(my-view.y)/view.k};}
@@ -1184,6 +1250,7 @@ document.getElementById('remap').addEventListener('click',loadMap);
 document.getElementById('recbtn').addEventListener('click',loadRec);
 document.getElementById('driftrun').addEventListener('click',function(){driftLoaded=false;loadDrift();});
 document.getElementById('addtask').addEventListener('click',addTaskUI);
+document.getElementById('pushtasks').addEventListener('click',pushTasksUI);
 document.getElementById('newtask').addEventListener('keydown',function(e){if(e.key==='Enter')addTaskUI();});
 initGraphEvents();syncP();refresh();loadMap();
 </script></body></html>`;
@@ -1248,6 +1315,7 @@ async function cmdApp() {
       if (u.pathname === "/api/tasks/add" && req.method === "POST") { const b = await readBody(req); return json(res, addTask(b.text, b.repo)); }
       if (u.pathname === "/api/tasks/toggle" && req.method === "POST") { const b = await readBody(req); return json(res, toggleTask(String(b.id || ""))); }
       if (u.pathname === "/api/tasks/remove" && req.method === "POST") { const b = await readBody(req); return json(res, removeTask(String(b.id || ""))); }
+      if (u.pathname === "/api/tasks/push" && req.method === "POST") return json(res, pushTasks());
       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/quit") { res.writeHead(200); res.end("bye"); setTimeout(() => process.exit(0), 150); return; }
@@ -1271,6 +1339,7 @@ ${c.b("Usage")}
   symbiot todo                      what's still on your plate
   symbiot app                       open the visual app in your browser
   symbiot drift                     what's out of sync / at risk across repos
+  symbiot push                      write your tasks into each repo for your agent
   symbiot models                    recommend AI models for your hardware
   symbiot login                     connect it to an AI (once)
   symbiot whoami                    show how it's connected
@@ -1302,6 +1371,7 @@ async function main() {
   if (cmd === "app" || cmd === "ui") return cmdApp();
   if (cmd === "models" || cmd === "hardware") return cmdModels();
   if (cmd === "drift") return cmdDrift();
+  if (cmd === "push") return cmdPush();
   if (cmd === "week") return cmdRun("week");
   if (cmd === "standup") return cmdRun("standup");
   if (cmd === "todo") return cmdRun("todo");
@@ -1317,4 +1387,4 @@ const isMain = (() => {
 })();
 if (isMain) main();
 
-export { authorship, repoState, readmeInfo, repoShape, houseRules, findAllRepos, buildMap, reportFooter, detectHardware, recommendModels, computeDrift, driftRepo, gitDefaultBranch, EMBEDDED_UI };
+export { authorship, repoState, readmeInfo, repoShape, houseRules, findAllRepos, buildMap, reportFooter, detectHardware, recommendModels, computeDrift, driftRepo, gitDefaultBranch, buildTasksMd, EMBEDDED_UI };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "symbiot",
-  "version": "0.9.4",
+  "version": "0.10.1",
   "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": {