npm - @unpolarize/knowledge-planning - Versions diffs - 0.1.0 → 0.2.0 - Mend

@unpolarize/knowledge-planning 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (27) hide show

package/LICENSE +21 -0
package/README.md +109 -62
package/dist/chunk-6GL2IYUE.js +2020 -0
package/dist/cli.js +385 -0
package/dist/index.d.ts +4532 -0
package/dist/index.js +94 -0
package/dist/server-NXAKSD5Z.js +862 -0
package/package.json +19 -9
package/src/cli/commands.test.ts +0 -105
package/src/cli/commands.ts +0 -341
package/src/cli/index.ts +0 -189
package/src/cli/sessions.ts +0 -40
package/src/graph/graph.ts +0 -67
package/src/index/db.test.ts +0 -91
package/src/index/db.ts +0 -196
package/src/index.ts +0 -14
package/src/kb-bridge/kb-bridge.test.ts +0 -44
package/src/kb-bridge/kb-bridge.ts +0 -63
package/src/migrate/gdoc.test.ts +0 -28
package/src/migrate/gdoc.ts +0 -68
package/src/schema/entities.test.ts +0 -60
package/src/schema/entities.ts +0 -233
package/src/schema/frontmatter.ts +0 -44
package/src/schema/index.ts +0 -2
package/src/store/store.test.ts +0 -64
package/src/store/store.ts +0 -231
package/src/types.ts +0 -18

package/dist/server-NXAKSD5Z.js ADDED Viewed

@@ -0,0 +1,862 @@
+import {
+  PlanningIndex,
+  Store,
+  buildLookback,
+  buildTopics,
+  cmdCapture,
+  cmdCreate,
+  cmdEditObject,
+  cmdExport,
+  cmdRecategorize,
+  cmdSetDue,
+  cmdSetPriority,
+  cmdSetProject,
+  cmdSetStatus,
+  readAllSessions,
+  sessionsByDay,
+  today
+} from "./chunk-6GL2IYUE.js";
+// src/serve/server.ts
+import { createServer } from "http";
+import { execFile } from "child_process";
+import { readdirSync, statSync, existsSync } from "fs";
+import { join, resolve, basename } from "path";
+// src/serve/page.ts
+var DASHBOARD_HTML = `<!DOCTYPE html>
+<html><head><meta charset="utf-8"><title>Planning \u2014 kp</title>
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<style>
+:root{--bg:#101418;--panel:#171d24;--card:#1e2630;--line:#2a3440;--fg:#dbe4ee;--dim:#8494a6;
+--blue:#569cd6;--green:#4ec9b0;--yellow:#dcdcaa;--red:#d16969;--purple:#c586c0;--tan:#d7ba7d;}
+*{box-sizing:border-box}
+body{margin:0;background:var(--bg);color:var(--fg);font:13px/1.45 -apple-system,'Segoe UI',sans-serif}
+#top{display:flex;gap:10px;align-items:center;padding:10px 14px;border-bottom:1px solid var(--line);position:sticky;top:0;background:var(--bg);z-index:5;flex-wrap:wrap}
+#top .brand{font-weight:800;letter-spacing:.3px}
+.seg{display:inline-flex;border:1px solid var(--line);border-radius:8px;overflow:hidden}
+.seg button{background:none;border:0;color:var(--dim);padding:5px 12px;cursor:pointer;font:inherit}
+.seg button.on{background:var(--panel);color:var(--fg)}
+#counts{color:var(--dim);font-size:11px}
+#syncPill{margin-left:auto;font-size:11px;padding:2px 9px;border-radius:11px;border:1px solid var(--line);cursor:pointer;white-space:nowrap;color:var(--dim)}
+#syncPill:hover{background:var(--panel);color:var(--fg)}
+#syncPill.ok{border-color:var(--green);color:var(--green)}
+#syncPill.syncing{border-color:var(--blue);color:var(--blue)}
+#syncPill.warn{border-color:var(--red);color:var(--red)}
+#syncPill.active{box-shadow:0 0 0 1px var(--blue) inset}
+#capture{display:flex;gap:6px}
+#capture input{background:var(--panel);border:1px solid var(--line);border-radius:8px;color:var(--fg);padding:5px 10px;width:220px;font:inherit}
+#capture button,button.act{background:var(--blue);border:0;border-radius:8px;color:#08131d;font-weight:700;padding:5px 12px;cursor:pointer;font:inherit}
+button.ghost{background:var(--panel);border:1px solid var(--line);color:var(--fg);border-radius:8px;padding:4px 10px;cursor:pointer;font:inherit}
+#board{display:flex;flex-direction:column;gap:10px;padding:12px}
+.boardfilter{display:flex;gap:8px;align-items:center;font-size:12px}
+.boardfilter select,.boardfilter input{background:var(--panel);border:1px solid var(--line);border-radius:6px;color:var(--fg);padding:3px 6px;font:inherit}
+.boardfilter .chip{cursor:pointer;border:1px solid var(--line)}
+.lanes{display:flex;gap:10px;align-items:flex-start;overflow-x:auto}
+.col{background:var(--panel);border:1px solid var(--line);border-radius:10px;min-width:230px;max-width:280px;flex:1}
+.col h3{margin:0;padding:8px 10px;font-size:11px;text-transform:uppercase;letter-spacing:.6px;color:var(--dim);display:flex;gap:6px;align-items:center;border-bottom:1px solid var(--line)}
+.col h3 .dot{width:8px;height:8px;border-radius:50%}
+.col h3 .n{margin-left:auto;color:var(--dim)}
+.cards{padding:8px;display:flex;flex-direction:column;gap:8px;min-height:30px;max-height:72vh;overflow-y:auto}
+.card{background:var(--card);border:1px solid var(--line);border-radius:8px;padding:8px 9px;cursor:pointer}
+.card:hover{border-color:var(--blue)}
+.card.dragging{opacity:.45}
+.card.nomatch,.titem.nomatch{display:none}
+.col.over{border-color:var(--blue);box-shadow:0 0 0 1px var(--blue) inset}
+.card .t{font-weight:600}
+.card .m{display:flex;gap:6px;flex-wrap:wrap;margin-top:6px;font-size:10.5px;color:var(--dim);align-items:center}
+.chip{border-radius:4px;padding:1px 6px;background:#2a3440}
+.chip.p0{background:var(--red);color:#fff}.chip.p1{background:var(--tan);color:#222}.chip.p2{background:var(--blue);color:#fff}.chip.p3{background:#2a3440}
+.chip.due{background:#233042}.chip.due.late{background:var(--red);color:#fff;font-weight:700}
+.chip.sess{background:#20303f;color:#9fd0ff}
+#calendar,#topics,#day{padding:14px;max-width:1200px;margin:0 auto}
+#calbar{display:flex;gap:8px;align-items:center;margin-bottom:12px;flex-wrap:wrap}
+#calbar .title{font-weight:700;font-size:15px;min-width:170px}
+/* month grid */
+.mgrid{display:grid;grid-template-columns:repeat(7,1fr);gap:6px}
+.mgrid .dow{color:var(--dim);font-size:10.5px;text-transform:uppercase;text-align:center;padding:2px}
+.mcell{background:var(--panel);border:1px solid var(--line);border-radius:8px;min-height:96px;padding:6px;cursor:pointer;overflow:hidden}
+.mcell:hover{border-color:var(--blue)}
+.mcell.dim{opacity:.35}
+.mcell.today{border-color:var(--blue);box-shadow:0 0 0 1px var(--blue) inset}
+.mcell .d{font-size:11px;color:var(--dim);display:flex;justify-content:space-between}
+.mcell .item{font-size:10.5px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;margin-top:3px}
+.mcell .item.late{color:var(--red)}
+/* week columns */
+.wgrid{display:grid;gap:8px}
+.wcol{background:var(--panel);border:1px solid var(--line);border-radius:10px;padding:8px;min-height:200px;min-width:0}
+.wcol h4{margin:0 0 6px;font-size:11px;color:var(--dim);display:flex;justify-content:space-between;cursor:pointer}
+.wcol h4:hover{color:var(--fg)}
+.wcol.today{border-color:var(--blue)}
+.witem{font-size:11px;padding:3px 5px;border-radius:5px;margin-top:3px;background:var(--card);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;cursor:pointer}
+.witem.due{border-left:3px solid var(--tan)}
+.witem.due.late{border-left-color:var(--red)}
+.witem.sess{border-left:3px solid #4fc1ff;color:#b6d9f5}
+/* day / lookback */
+.section{background:var(--panel);border:1px solid var(--line);border-radius:10px;padding:12px;margin-bottom:12px}
+.section h3{margin:0 0 8px;font-size:12px;text-transform:uppercase;letter-spacing:.5px;color:var(--dim)}
+.sessrow{display:flex;gap:10px;align-items:baseline;padding:4px 2px;border-bottom:1px dotted var(--line)}
+.sessrow:last-child{border-bottom:0}
+.sessrow .time{color:var(--dim);font-size:11px;width:44px;flex:none}
+.sessrow .proj{color:#9fd0ff;font-size:11px;width:170px;flex:none;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.sessrow .ttl{flex:1;min-width:0;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.sessrow .dur{color:var(--dim);font-size:11px;flex:none}
+pre.plan{white-space:pre-wrap;font:12px/1.5 ui-monospace,monospace;color:var(--fg);margin:0}
+/* topics */
+.tgroup{margin-bottom:18px}
+.tgroup>h2{font-size:14px;text-transform:uppercase;letter-spacing:1px;color:var(--fg);border-bottom:1px solid var(--line);padding-bottom:6px}
+.tdomains{display:grid;grid-template-columns:repeat(auto-fill,minmax(340px,1fr));gap:10px}
+.tdomain{background:var(--panel);border:1px solid var(--line);border-radius:10px;padding:10px}
+.tdomain h3{margin:0 0 6px;font-size:12.5px;display:flex;gap:8px;align-items:center}
+.tdomain h3 .n{color:var(--dim);font-weight:400;font-size:11px}
+.titem{font-size:12px;padding:3px 0;display:flex;gap:6px;align-items:baseline;cursor:pointer}
+.titem:hover .t{color:var(--blue)}
+.titem .st{color:var(--dim);font-size:10.5px;flex:none}
+.titem .t{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.tsess{margin-top:8px;border-top:1px dotted var(--line);padding-top:6px}
+.tsess .lbl{color:var(--dim);font-size:10.5px;text-transform:uppercase}
+#drawer{position:fixed;right:0;top:0;bottom:0;width:380px;max-width:92vw;background:var(--panel);border-left:1px solid var(--line);padding:16px;overflow-y:auto;transform:translateX(105%);transition:transform .15s;z-index:10}
+#drawer.open{transform:none}
+#drawer h2{margin:0 0 4px;font-size:15px}
+#drawer .id{color:var(--dim);font-size:11px;margin-bottom:14px;word-break:break-all}
+#drawer label{display:block;color:var(--dim);font-size:11px;margin:10px 0 3px;text-transform:uppercase;letter-spacing:.5px}
+#drawer select,#drawer input{width:100%;background:var(--card);border:1px solid var(--line);border-radius:6px;color:var(--fg);padding:6px 8px;font:inherit}
+#drawer .actions{display:flex;gap:8px;margin-top:16px}
+#msg{position:fixed;bottom:14px;left:50%;transform:translateX(-50%);background:var(--card);border:1px solid var(--line);border-radius:8px;padding:8px 14px;display:none;z-index:20}
+.empty{color:var(--dim);padding:20px;text-align:center}
+</style></head><body>
+<div id="top">
+  <span class="brand">\u25E7 Planning</span>
+  <span class="seg" id="views">
+    <button data-v="board" class="on">Board</button>
+    <button data-v="calendar">Calendar</button>
+    <button data-v="topics">Topics</button>
+    <button data-v="day">Day</button>
+  </span>
+  <span class="seg" id="lanes">
+    <button data-l="task" class="on">Tasks</button>
+    <button data-l="idea">Ideas</button>
+    <button data-l="plan">Plans</button>
+    <button data-l="thought">Thoughts</button>
+  </span>
+  <span class="seg" id="calmodes" style="display:none">
+    <button data-m="month" class="on">Month</button>
+    <button data-m="week">Week</button>
+    <button data-m="workweek">Work week</button>
+  </span>
+  <input id="search" placeholder="Search\u2026 (\u2318F)" style="display:none;background:var(--panel);border:1px solid var(--line);border-radius:8px;color:var(--fg);padding:5px 10px;width:220px;font:inherit">
+  <button id="newBtn" class="act" style="background:var(--blue)">\uFF0B New</button>
+  <span id="syncBtns"></span>
+  <span id="syncPill" title="Store sync \u2014 click to pull now">\u25CC sync</span>
+  <span id="counts"></span>
+</div>
+<div id="board"></div>
+<div id="calendar" style="display:none"></div>
+<div id="topics" style="display:none"></div>
+<div id="day" style="display:none"></div>
+<div id="drawer"></div>
+<div id="msg"></div>
+<script>
+const LANES={task:['inbox','today','in_progress','done','deferred','outdated'],
+  idea:['capture','refine','accepted','plan','parked','done'],
+  plan:['plan','prototype','implement','validate','done','parked'],
+  thought:['new','kept','converted','archived']};
+const LANE_COLOR={inbox:'#8494a6',today:'#569cd6',in_progress:'#dcdcaa',done:'#4ec9b0',deferred:'#c586c0',outdated:'#d16969',
+  capture:'#d7ba7d',refine:'#dcdcaa',accepted:'#4ec9b0',parked:'#8494a6',plan:'#569cd6',prototype:'#c586c0',implement:'#dcdcaa',validate:'#4fc1ff',
+  new:'#d7ba7d',kept:'#4ec9b0',converted:'#569cd6',archived:'#5a6672'};
+const DEFAULT_STATUS={task:'inbox',idea:'capture',plan:'plan',thought:'new'};
+let S=null,view='board',lane='task',calMode='month',anchor=null,dayDate=null;
+const $=s=>document.querySelector(s);
+const esc=s=>(s==null?'':String(s)).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');
+const todayStr=()=>(S&&S.board&&S.board.date)||new Date().toISOString().slice(0,10);
+const addDays=(d,n)=>{const x=new Date(d+'T00:00:00');x.setDate(x.getDate()+n);
+  return x.getFullYear()+'-'+String(x.getMonth()+1).padStart(2,'0')+'-'+String(x.getDate()).padStart(2,'0');};
+function toast(t){const m=$('#msg');m.textContent=t;m.style.display='block';setTimeout(()=>m.style.display='none',1800);}
+async function api(p,opts){const r=await fetch(p,opts);const j=await r.json();if(!r.ok)throw new Error(j.error||r.status);return j;}
+async function load(){S=await api('/api/snapshot');render();}
+async function act(op,id,value,extra){try{await api('/api/action',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify(Object.assign({op,id,value},extra||{}))});await load();toast(op+' \u2713');}catch(e){toast('\u2717 '+e.message);}}
+const CLOSING=new Set(['done','deferred','outdated','parked','archived']);
+// closing a task deserves a word on WHY \u2014 prompt for a resolution note.
+// OK+text => saved as a '## Resolution' body section; OK+empty => no note; Cancel => abort the move.
+function setStatusAsking(id,status){
+  if(!CLOSING.has(status))return act('set-status',id,status);
+  const note=window.prompt('Moving to "'+status+'" \u2014 add a resolution note? (empty = none, Cancel = abort)','');
+  if(note===null){load();return Promise.resolve();}
+  return act('set-status',id,status,note.trim()?{note:note.trim()}:undefined);
+}
+function chips(o){let h='';
+  if(o.priority)h+='<span class="chip '+esc(o.priority)+'">'+esc(o.priority)+'</span>';
+  if(o.due){const late=o.due<todayStr()&&o.status!=='done'&&o.status!=='outdated';
+    h+='<span class="chip due'+(late?' late':'')+'">\u23F0 '+esc(o.due)+'</span>';}
+  if(o.domain)h+='<span>'+esc(o.domain)+'</span>';
+  if(o.type==='thought'){
+    if(o.context)h+='<span class="chip" title="captured under">\u25D4 '+esc(o.context)+'</span>';
+    if(o.surfaced_on||o.created)h+='<span>'+esc(o.surfaced_on||o.created)+'</span>';}
+  return h;}
+function domainList(){const s=new Set();(S&&S.objects||[]).forEach(o=>{if(o.type==='domain')s.add((o.title||o.id.split('/').pop()));else if(o.domain)s.add(o.domain);});return [...s].sort();}
+function render(){
+  $('#counts').textContent=Object.entries(S.counts||{}).map(([k,v])=>k+':'+v).join('  ');
+  for(const v of ['board','calendar','topics','day'])$('#'+v).style.display=view===v?'block':'none';
+  if(view==='board')$('#board').style.display='flex';
+  document.querySelectorAll('#views button').forEach(b=>b.classList.toggle('on',b.dataset.v===view));
+  document.querySelectorAll('#lanes button').forEach(b=>b.classList.toggle('on',b.dataset.l===lane));
+  document.querySelectorAll('#calmodes button').forEach(b=>b.classList.toggle('on',b.dataset.m===calMode));
+  $('#lanes').style.display=view==='board'?'inline-flex':'none';
+  $('#calmodes').style.display=view==='calendar'?'inline-flex':'none';
+  if(view==='board')renderBoard();
+  else if(view==='calendar')renderCalendar();
+  else if(view==='topics')renderTopics();
+  else renderDay();
+  applySearch();
+}
+function renderBoard(){
+  const board=$('#board');board.innerHTML='';
+  // date filter bar (worked-on / due) \u2014 full-width row above the lanes
+  const fb=document.createElement('div');fb.className='boardfilter';
+  fb.innerHTML='<span style="opacity:.6">filter by</span>'+
+    '<select id="bfField"><option value="updated"'+(boardField==='updated'?' selected':'')+'>worked on (updated)</option>'+
+    '<option value="due"'+(boardField==='due'?' selected':'')+'>due</option></select>'+
+    '<input type="date" id="bfDate" value="'+esc(boardDate||'')+'">'+
+    '<button class="chip" id="bfToday">today</button>'+
+    (boardDate?'<button class="chip" id="bfClear">clear \u2715</button><span style="opacity:.6" id="bfN"></span>':'');
+  board.appendChild(fb);
+  fb.querySelector('#bfField').onchange=e=>{boardField=e.target.value;renderBoard();};
+  fb.querySelector('#bfDate').onchange=e=>{boardDate=e.target.value;renderBoard();};
+  fb.querySelector('#bfToday').onclick=()=>{boardDate=todayStr();renderBoard();};
+  if(fb.querySelector('#bfClear'))fb.querySelector('#bfClear').onclick=()=>{boardDate='';renderBoard();};
+  const lanesWrap=document.createElement('div');lanesWrap.className='lanes';board.appendChild(lanesWrap);
+  let objs=(S.objects||[]).filter(o=>o.type===lane);
+  if(boardDate)objs=objs.filter(o=>(o[boardField]||'').slice(0,10)===boardDate);
+  if(fb.querySelector('#bfN'))fb.querySelector('#bfN').textContent=objs.length+' '+lane+'(s) '+boardField+' '+boardDate;
+  LANES[lane].forEach(l=>{
+    const rows=objs.filter(o=>(o.status||'')===l);
+    const col=document.createElement('div');col.className='col';col.dataset.lane=l;
+    col.innerHTML='<h3><span class="dot" style="background:'+(LANE_COLOR[l]||'#888')+'"></span>'+l+'<span class="n">'+rows.length+'</span></h3>';
+    const cards=document.createElement('div');cards.className='cards';
+    rows.forEach(o=>{
+      const c=document.createElement('div');c.className='card';c.draggable=true;
+      c.innerHTML='<div class="t">'+esc(o.title||o.id)+'</div><div class="m">'+chips(o)+'</div>';
+      c.onclick=()=>openDrawer(o);
+      c.addEventListener('dragstart',ev=>{ev.dataTransfer.setData('text/plain',o.id);ev.dataTransfer.effectAllowed='move';c.classList.add('dragging');});
+      c.addEventListener('dragend',()=>c.classList.remove('dragging'));
+      cards.appendChild(c);
+    });
+    col.appendChild(cards);
+    col.addEventListener('dragover',ev=>{ev.preventDefault();ev.dataTransfer.dropEffect='move';col.classList.add('over');});
+    col.addEventListener('dragleave',()=>col.classList.remove('over'));
+    col.addEventListener('drop',ev=>{ev.preventDefault();col.classList.remove('over');
+      const id=ev.dataTransfer.getData('text/plain');if(id)setStatusAsking(id,l);});
+    lanesWrap.appendChild(col);
+  });
+}
+// \u2500\u2500 calendar (month / week / workweek) with sessions \u2500\u2500
+async function fetchWindow(from,to){
+  const [cal,sess]=await Promise.all([
+    api('/api/calendar?from='+from+'&to='+to),
+    api('/api/sessions?from='+from+'&to='+to)]);
+  const dueByDay={};cal.rows.forEach(r=>{(dueByDay[r.due]??=[]).push(r);});
+  return {dueByDay,sessByDay:sess.days||{}};
+}
+function calTitle(){
+  if(calMode==='month')return new Date(anchor+'T00:00:00').toLocaleDateString(undefined,{month:'long',year:'numeric'});
+  return 'Week of '+weekStart(anchor);
+}
+function weekStart(d){const x=new Date(d+'T00:00:00');const dow=(x.getDay()+6)%7;return addDays(d,-dow);} // Monday
+async function renderCalendar(){
+  const now=todayStr();
+  if(!anchor)anchor=now;
+  const cal=$('#calendar');cal.innerHTML='';
+  const bar=document.createElement('div');bar.id='calbar';
+  bar.innerHTML='<button class="ghost" id="prev">\u2039</button><span class="title">'+esc(calTitle())+'</span>'+
+    '<button class="ghost" id="next">\u203A</button><button class="ghost" id="tdy">Today</button>';
+  cal.appendChild(bar);
+  bar.querySelector('#tdy').onclick=()=>{anchor=now;renderCalendar();};
+  if(calMode==='month'){
+    bar.querySelector('#prev').onclick=()=>{const d=new Date(anchor+'T00:00:00');d.setMonth(d.getMonth()-1,1);anchor=d.toISOString().slice(0,10);renderCalendar();};
+    bar.querySelector('#next').onclick=()=>{const d=new Date(anchor+'T00:00:00');d.setMonth(d.getMonth()+1,1);anchor=d.toISOString().slice(0,10);renderCalendar();};
+    const first=anchor.slice(0,8)+'01';
+    const gridStart=weekStart(first);
+    const gridEnd=addDays(gridStart,41);
+    const {dueByDay,sessByDay}=await fetchWindow(gridStart,gridEnd);
+    const grid=document.createElement('div');grid.className='mgrid';
+    ['Mon','Tue','Wed','Thu','Fri','Sat','Sun'].forEach(d=>grid.insertAdjacentHTML('beforeend','<div class="dow">'+d+'</div>'));
+    for(let i=0;i<42;i++){
+      const d=addDays(gridStart,i);
+      const cell=document.createElement('div');
+      cell.className='mcell'+(d.slice(0,7)!==anchor.slice(0,7)?' dim':'')+(d===now?' today':'');
+      const sess=(sessByDay[d]||[]).length;
+      let h='<div class="d"><span>'+Number(d.slice(8))+'</span>'+(sess?'<span class="chip sess">'+sess+' sess</span>':'')+'</div>';
+      cell.innerHTML=h;
+      const due=dueByDay[d]||[];
+      due.slice(0,3).forEach(t=>{const closed=t.status==='done'||t.status==='outdated';
+        const it=document.createElement('div');it.className='item'+(d<now&&!closed?' late':'');
+        it.textContent=(t.priority?t.priority+' \xB7 ':'')+(t.title||t.id);
+        it.draggable=true;
+        it.addEventListener('dragstart',ev=>{ev.stopPropagation();ev.dataTransfer.setData('text/plain',t.id);ev.dataTransfer.effectAllowed='move';});
+        cell.appendChild(it);});
+      if(due.length>3)cell.insertAdjacentHTML('beforeend','<div class="item">+'+(due.length-3)+' more\u2026</div>');
+      cell.onclick=(ev)=>{ if(ev.target.closest('.item'))return; openCreate({due:d}); };
+      cell.querySelector('.d').addEventListener('click',ev=>{ev.stopPropagation();dayDate=d;view='day';render();});
+      cell.querySelector('.d').style.cursor='pointer';cell.querySelector('.d').title='open day view';
+      cell.addEventListener('dragover',ev=>{ev.preventDefault();ev.dataTransfer.dropEffect='move';cell.style.borderColor='var(--blue)';});
+      cell.addEventListener('dragleave',()=>{cell.style.borderColor='';});
+      cell.addEventListener('drop',ev=>{ev.preventDefault();cell.style.borderColor='';
+        const id=ev.dataTransfer.getData('text/plain');if(id)act('set-due',id,d).then(()=>renderCalendar());});
+      grid.appendChild(cell);
+    }
+    cal.appendChild(grid);
+  }else{
+    const days=calMode==='workweek'?5:7;
+    bar.querySelector('#prev').onclick=()=>{anchor=addDays(anchor,-7);renderCalendar();};
+    bar.querySelector('#next').onclick=()=>{anchor=addDays(anchor,7);renderCalendar();};
+    const start=weekStart(anchor);
+    const end=addDays(start,days-1);
+    const {dueByDay,sessByDay}=await fetchWindow(start,end);
+    const grid=document.createElement('div');grid.className='wgrid';
+    grid.style.gridTemplateColumns='repeat('+days+',1fr)';
+    for(let i=0;i<days;i++){
+      const d=addDays(start,i);
+      const col=document.createElement('div');col.className='wcol'+(d===now?' today':'');
+      const label=new Date(d+'T00:00:00').toLocaleDateString(undefined,{weekday:'short',month:'short',day:'numeric'});
+      col.innerHTML='<h4><span>'+esc(label)+'</span><span>\u203A</span></h4>';
+      col.querySelector('h4').onclick=()=>{dayDate=d;view='day';render();};
+      col.addEventListener('click',ev=>{ if(ev.target.closest('.witem')||ev.target.closest('h4'))return; openCreate({due:d}); });
+      col.style.cursor='pointer';col.title='click empty space to add a task due this day';
+      (dueByDay[d]||[]).forEach(t=>{const closed=t.status==='done'||t.status==='outdated';
+        const it=document.createElement('div');it.className='witem due'+(d<now&&!closed?' late':'');
+        it.textContent=(t.priority?t.priority+' \xB7 ':'')+'\u23F0 '+(t.title||t.id);
+        it.draggable=true;
+        it.addEventListener('dragstart',ev=>{ev.dataTransfer.setData('text/plain',t.id);ev.dataTransfer.effectAllowed='move';});
+        it.onclick=()=>{const o=(S.objects||[]).find(x=>x.id===t.id);if(o)openDrawer(o);};
+        col.appendChild(it);});
+      col.addEventListener('dragover',ev=>{ev.preventDefault();ev.dataTransfer.dropEffect='move';col.style.borderColor='var(--blue)';});
+      col.addEventListener('dragleave',()=>{col.style.borderColor='';});
+      col.addEventListener('drop',ev=>{ev.preventDefault();col.style.borderColor='';
+        const id=ev.dataTransfer.getData('text/plain');if(id)act('set-due',id,d).then(()=>renderCalendar());});
+      (sessByDay[d]||[]).forEach(s=>{
+        const it=document.createElement('div');it.className='witem sess';
+        const t=s.started_at?new Date(s.started_at).toTimeString().slice(0,5):'--:--';
+        it.textContent=t+' ['+(s.project_name||'?')+'] '+(s.title||'(session)');
+        it.title=s.title||'';
+        col.appendChild(it);});
+      grid.appendChild(col);
+    }
+    cal.appendChild(grid);
+  }
+}
+// \u2500\u2500 day lookback \u2500\u2500
+async function renderDay(){
+  if(!dayDate)dayDate=todayStr();
+  const el=$('#day');el.innerHTML='';
+  const bar=document.createElement('div');bar.id='calbar';
+  bar.innerHTML='<button class="ghost" id="prev">\u2039</button><span class="title">'+esc(new Date(dayDate+'T00:00:00').toDateString())+'</span>'+
+    '<button class="ghost" id="next">\u203A</button><button class="ghost" id="tdy">Today</button>';
+  el.appendChild(bar);
+  bar.querySelector('#prev').onclick=()=>{dayDate=addDays(dayDate,-1);renderDay();};
+  bar.querySelector('#next').onclick=()=>{dayDate=addDays(dayDate,1);renderDay();};
+  bar.querySelector('#tdy').onclick=()=>{dayDate=todayStr();renderDay();};
+  const lb=await api('/api/lookback?date='+dayDate);
+  if(lb.daily_plan&&lb.daily_plan.body&&lb.daily_plan.body.trim()){
+    const s=document.createElement('div');s.className='section';
+    s.innerHTML='<h3>Plan of the day</h3><pre class="plan">'+esc(lb.daily_plan.body.trim())+'</pre>';
+    el.appendChild(s);
+  }
+  const sess=document.createElement('div');sess.className='section';
+  sess.innerHTML='<h3>What I was up to \u2014 '+lb.sessions.length+' coding session(s)</h3>';
+  if(!lb.sessions.length)sess.insertAdjacentHTML('beforeend','<div class="empty">no captured sessions this day</div>');
+  lb.sessions.forEach(s=>{
+    const t=s.started_at?new Date(s.started_at).toTimeString().slice(0,5):'--:--';
+    sess.insertAdjacentHTML('beforeend','<div class="sessrow"><span class="time">'+t+'</span>'+
+      '<span class="proj">'+esc(s.project_name||'?')+'</span>'+
+      '<span class="ttl">'+esc(s.title||'(untitled session)')+'</span>'+
+      '<span class="dur">'+(s.minutes?s.minutes+'m':'')+(s.turns?' \xB7 '+s.turns+'t':'')+'</span></div>');
+  });
+  el.appendChild(sess);
+  const mk=(title,rows)=>{if(!rows.length)return;
+    const s=document.createElement('div');s.className='section';
+    s.innerHTML='<h3>'+title+'</h3>';
+    rows.forEach(t=>{s.insertAdjacentHTML('beforeend','<div class="titem"><span class="st">'+esc(t.status||'')+'</span><span class="t">'+esc(t.title||t.id)+'</span></div>');});
+    el.appendChild(s);};
+  mk('Worked on (updated) this day',lb.tasks_worked);
+  mk('Created this day',lb.tasks_created);
+  mk('Due this day',lb.tasks_due);
+}
+// \u2500\u2500 topics (life/work \u2192 domain \u2192 items + sessions) \u2500\u2500
+const topicsExpanded=new Set(); // "group/domain" keys \u2014 dblclick (or +N more) toggles full lists
+async function renderTopics(){
+  const el=$('#topics');el.innerHTML='';
+  const data=await api('/api/topics');
+  const order=Object.keys(data.groups).sort((a,b)=>(a==='other')-(b==='other')||a.localeCompare(b));
+  for(const g of order){
+    const grp=document.createElement('div');grp.className='tgroup';
+    grp.innerHTML='<h2>'+esc(g)+'</h2>';
+    const wrap=document.createElement('div');wrap.className='tdomains';
+    const domains=Object.keys(data.groups[g]).sort();
+    for(const dom of domains){
+      const d=data.groups[g][dom];
+      const key=g+'/'+dom;
+      const expanded=topicsExpanded.has(key);
+      const card=document.createElement('div');card.className='tdomain';
+      card.title='double-click to '+(expanded?'collapse':'expand all items');
+      card.innerHTML='<h3>'+esc(dom)+'<span class="n">'+d.tasks.length+' tasks \xB7 '+d.ideas.length+' ideas'+(d.sessions.length?' \xB7 '+d.sessions.length+' recent sessions':'')+(expanded?' \xB7 expanded':'')+'</span></h3>';
+      const toggle=()=>{expanded?topicsExpanded.delete(key):topicsExpanded.add(key);renderTopics();};
+      card.addEventListener('dblclick',ev=>{if(ev.target.closest('.titem')&&!ev.target.closest('.tmore'))return;toggle();});
+      (expanded?d.tasks:d.tasks.slice(0,8)).forEach(t=>{
+        const it=document.createElement('div');it.className='titem';
+        it.innerHTML='<span class="st">'+esc(t.status||'')+(t.priority?' '+esc(t.priority):'')+'</span><span class="t">'+esc(t.title||t.id)+'</span>';
+        it.onclick=()=>{const o=(S.objects||[]).find(x=>x.id===t.id);if(o)openDrawer(o);};
+        card.appendChild(it);});
+      if(!expanded&&d.tasks.length>8){
+        const more=document.createElement('div');more.className='titem tmore';
+        more.innerHTML='<span class="t" style="color:var(--blue);cursor:pointer">\u2026+'+(d.tasks.length-8)+' more tasks \u2014 click to expand</span>';
+        more.onclick=toggle;
+        card.appendChild(more);}
+      (expanded?d.ideas:d.ideas.slice(0,4)).forEach(t=>{
+        const it=document.createElement('div');it.className='titem';
+        it.innerHTML='<span class="st">idea</span><span class="t">'+esc(t.title||t.id)+'</span>';
+        it.onclick=()=>{const o=(S.objects||[]).find(x=>x.id===t.id);if(o)openDrawer(o);};
+        card.appendChild(it);});
+      if(!expanded&&d.ideas.length>4){
+        const more=document.createElement('div');more.className='titem tmore';
+        more.innerHTML='<span class="t" style="color:var(--blue);cursor:pointer">\u2026+'+(d.ideas.length-4)+' more ideas \u2014 click to expand</span>';
+        more.onclick=toggle;
+        card.appendChild(more);}
+      if(d.sessions.length){
+        const ts=document.createElement('div');ts.className='tsess';
+        ts.innerHTML='<div class="lbl">recent sessions</div>';
+        d.sessions.slice(0,expanded?20:4).forEach(s=>{
+          ts.insertAdjacentHTML('beforeend','<div class="titem"><span class="st">'+esc(s.day)+'</span><span class="t">'+esc((s.project_name?'['+s.project_name+'] ':'')+(s.title||'(untitled)'))+'</span></div>');});
+        card.appendChild(ts);
+      }
+      wrap.appendChild(card);
+    }
+    grp.appendChild(wrap);el.appendChild(grp);
+  }
+}
+function openCreate(prefill){
+  const d=$('#drawer');
+  const type=prefill.obj_type||'task';
+  const statusOpts=(LANES[type]||LANES.task).map(x=>'<option'+(x===(DEFAULT_STATUS[type]||'inbox')?' selected':'')+'>'+x+'</option>').join('');
+  const prioOpts=['','p0','p1','p2','p3'].map(x=>'<option value="'+x+'">'+(x||'(none)')+'</option>').join('');
+  const projOpts='<option value="">(none)</option>'+(snap.objects||[]).filter(x=>x.type==='project').map(p=>'<option value="'+esc(p.id)+'">'+esc(p.title||p.id)+'</option>').join('');
+  d.innerHTML='<h2>New '+esc(type)+'</h2><div class="id">creates a '+esc(type)+' in the store</div>'+
+    '<label>Type</label><select id="cType"><option value="task"'+(type==='task'?' selected':'')+'>task</option><option value="idea"'+(type==='idea'?' selected':'')+'>idea</option><option value="plan"'+(type==='plan'?' selected':'')+'>plan</option><option value="thought"'+(type==='thought'?' selected':'')+'>thought</option></select>'+
+    '<label>Title</label><input id="cTitle" value="'+esc(prefill.title||'')+'" placeholder="What needs doing?">'+
+    '<label>Status</label><select id="cStatus">'+statusOpts+'</select>'+
+    '<label>Priority</label><select id="cPrio">'+prioOpts+'</select>'+
+    '<label>Due (optional)</label><input type="date" id="cDue" value="'+esc(prefill.due||'')+'">'+
+    '<label>Domain (optional)</label><input id="cDomain" placeholder="tech / kids / career\u2026">'+
+    '<label>Project (optional)</label><select id="cProject">'+projOpts+'</select>'+
+    '<label>Body (markdown)</label><textarea id="cBody" rows="8" style="width:100%;background:var(--card);border:1px solid var(--line);border-radius:6px;color:var(--fg);padding:8px;font:12px/1.5 ui-monospace,monospace"></textarea>'+
+    '<div class="actions"><button class="act" id="cCreate">Create</button><button class="ghost" id="cClose">Close</button></div>';
+  d.classList.add('open');
+  setTimeout(()=>$('#cTitle').focus(),50);
+  const refreshStatus=()=>{const t=$('#cType').value;
+    $('#cStatus').innerHTML=(LANES[t]||LANES.task).map(x=>'<option>'+x+'</option>').join('');};
+  $('#cType').onchange=refreshStatus;
+  $('#cClose').onclick=()=>d.classList.remove('open');
+  const submit=async()=>{
+    const title=$('#cTitle').value.trim();if(!title){toast('title required');return;}
+    try{const r=await api('/api/action',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify({op:'create',
+      obj_type:$('#cType').value,title,status:$('#cStatus').value,priority:$('#cPrio').value||undefined,
+      due:$('#cDue').value||undefined,domain:$('#cDomain').value.trim()||undefined,
+      project:$('#cProject').value||undefined,body:$('#cBody').value})});
+    d.classList.remove('open');await load();toast('created '+(r.id||'\u2713'));}catch(e){toast('\u2717 '+e.message);}
+  };
+  $('#cCreate').onclick=submit;
+  $('#cTitle').addEventListener('keydown',e=>{if(e.key==='Enter'&&(e.metaKey||e.ctrlKey))submit();});
+}
+async function openDrawer(o){
+  const d=$('#drawer');
+  let body='';
+  try{const full=await api('/api/object?id='+encodeURIComponent(o.id));body=full.body||'';
+    o={...o,...{title:full.data.title??o.title,status:full.data.status??o.status,priority:full.data.priority??o.priority,due:full.data.due??o.due,project:full.data.project??o.project,domain:full.data.domain??o.domain}};}catch(e){}
+  const laneOpts=(LANES[o.type]||LANES.task).map(s=>'<option'+(s===o.status?' selected':'')+'>'+s+'</option>').join('');
+  const prioOpts=['','p0','p1','p2','p3'].map(p=>'<option value="'+p+'"'+((o.priority||'')===p?' selected':'')+'>'+(p||'(none)')+'</option>').join('');
+  const domOpts='<datalist id="domList">'+domainList().map(x=>'<option value="'+esc(x)+'">').join('')+'</datalist>';
+  const projList=(snap.objects||[]).filter(x=>x.type==='project');
+  const projOpts='<option value="">(none)</option>'+projList.map(p=>{
+    const label=(p.title||p.id).replace(/^projects//,'');
+    return '<option value="'+esc(p.id)+'"'+(o.project===p.id?' selected':'')+'>'+esc(label)+'</option>';
+  }).join('');
+  const prov=(o.context?'<div class="id" title="captured under">\u25D4 '+esc(o.context)+(o.surfaced_on?' \xB7 '+esc(o.surfaced_on):'')+'</div>':'');
+  d.innerHTML='<h2>Edit</h2><div class="id">'+esc(o.id)+' \xB7 '+esc(o.type)+'</div>'+prov+
+    '<label>Title</label><input id="dTitle" value="'+esc(o.title||'')+'">'+
+    '<label>Status</label><select id="dStatus">'+laneOpts+'</select>'+
+    '<label>Category / domain</label><input id="dDomain" list="domList" value="'+esc(o.domain||'')+'" placeholder="kids / tech / career\u2026">'+domOpts+
+    '<label>Project</label><select id="dProject">'+projOpts+'</select>'+
+    (o.type==='task'?'<label>Priority</label><select id="dPrio">'+prioOpts+'</select>'+
+    '<label>Due (blank clears)</label><input type="date" id="dDue" value="'+esc(o.due||'')+'">':'')+
+    '<label>Body (markdown)</label><textarea id="dBody" rows="12" style="width:100%;background:var(--card);border:1px solid var(--line);border-radius:6px;color:var(--fg);padding:8px;font:12px/1.5 ui-monospace,monospace"></textarea>'+
+    (o.type==='thought'?'<div class="actions"><button class="ghost" id="dToIdea">\u2192 \u{1F4A1} idea</button><button class="ghost" id="dToTask">\u2192 \u2611 task</button></div>':'')+
+    (o.type==='idea'?'<div class="actions"><button class="ghost" id="dToTask">\u2192 \u2611 task</button></div>':'')+
+    '<div class="actions"><button class="act" id="dApply">Apply</button><button class="ghost" id="dClose">Close</button></div>';
+  $('#dBody').value=body;
+  d.classList.add('open');
+  $('#dClose').onclick=()=>d.classList.remove('open');
+  const convert=async(toType)=>{
+    try{const r=await api('/api/action',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify({op:'recategorize',id:o.id,to_type:toType})});
+      d.classList.remove('open');await load();toast('\u2192 '+(r.newId||toType));}catch(e){toast('\u2717 '+e.message);}
+  };
+  if($('#dToIdea'))$('#dToIdea').onclick=()=>convert('idea');
+  if($('#dToTask'))$('#dToTask').onclick=()=>convert('task');
+  $('#dApply').onclick=async()=>{
+    const st=$('#dStatus').value;
+    if(st!==o.status)await setStatusAsking(o.id,st);
+    const dom=$('#dDomain').value.trim();
+    if(dom!==(o.domain||''))await act2({op:'recategorize',id:o.id,domain:dom});
+    const proj=$('#dProject')?$('#dProject').value:'';
+    if((o.project||'')!==proj)await act('set-project',o.id,proj||'-');
+    if(o.type==='task'){
+      const pr=$('#dPrio').value;
+      if((o.priority||'')!==pr)await act('set-priority',o.id,pr||'-');
+      const du=$('#dDue').value;
+      if((o.due||'')!==du)await act('set-due',o.id,du||'-');
+    }
+    const nt=$('#dTitle').value.trim();
+    const nb=$('#dBody').value;
+    if((nt&&nt!==(o.title||''))||nb!==body){
+      try{await api('/api/action',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify({op:'edit',id:o.id,title:nt,body:nb})});toast('edit \u2713');await load();}catch(e){toast('\u2717 '+e.message);}
+    }
+    d.classList.remove('open');
+  };
+}
+async function act2(payload){try{await api('/api/action',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify(payload)});await load();toast(payload.op+' \u2713');}catch(e){toast('\u2717 '+e.message);}}
+$('#views').onclick=e=>{const b=e.target.closest('button');if(b){view=b.dataset.v;render();}};
+$('#lanes').onclick=e=>{const b=e.target.closest('button');if(b){lane=b.dataset.l;render();}};
+$('#calmodes').onclick=e=>{const b=e.target.closest('button');if(b){calMode=b.dataset.m;render();}};
+let boardField='updated',boardDate='';
+let searchTerm='';
+function applySearch(){
+  const q=searchTerm.toLowerCase();
+  document.querySelectorAll('#board .card, #topics .titem').forEach(c=>{
+    c.classList.toggle('nomatch', !!q && !c.textContent.toLowerCase().includes(q));
+  });
+  // hide now-empty board lanes' counts stay; empty columns just show 0 visible
+}
+document.addEventListener('keydown',e=>{
+  if((e.metaKey||e.ctrlKey)&&e.key==='f'){e.preventDefault();
+    const s=$('#search');s.style.display='inline-block';s.focus();s.select();}
+  if(e.key==='Escape'){const s=$('#search');if(document.activeElement===s){searchTerm='';s.value='';s.style.display='none';applySearch();}}
+});
+$('#search').addEventListener('input',e=>{searchTerm=e.target.value;applySearch();});
+$('#newBtn').onclick=()=>openCreate({});
+// on-demand sync buttons \u2014 one per executable in the KB's scripts/sync/ folder
+// (convention: scripts/sync/README.md; sync.sh is the standard/default action)
+async function renderSyncButtons(){
+  try{
+    const r=await api('/api/sync-scripts');
+    const el=$('#syncBtns');el.innerHTML='';
+    (r.scripts||[]).forEach(s=>{
+      const b=document.createElement('button');
+      b.className=s.standard?'act':'ghost';
+      if(s.standard)b.style.background='var(--green)';
+      b.textContent='\u27F3 '+s.name.replace(/\\.sh$/,'');
+      b.title='run '+r.dir+'/'+s.name;
+      b.onclick=async()=>{
+        b.disabled=true;const t=b.textContent;b.textContent='\u27F3 running\u2026';
+        try{const res=await api('/api/sync',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify({script:s.name})});
+          toast(s.name+' \u2713 (exit 0)');console.log('[sync]',s.name,res.output);await load();}
+        catch(e){toast('\u2717 '+s.name+': '+e.message);}
+        b.disabled=false;b.textContent=t;
+      };
+      el.appendChild(b);
+    });
+  }catch(e){/* no sync folder \u2014 no buttons */}
+}
+renderSyncButtons();
+// \u2500\u2500 store git pull: on open + aggressively while active, backing off when idle \u2500\u2500
+let syncState={status:'idle',lastSyncAt:0}, activeUntil=0, syncTimer=null;
+const ACTIVE_WINDOW=3*60*1000, ACTIVE_POLL=20000, IDLE_POLL=90000;
+function agoStr(t){ if(!t)return 'never'; const s=Math.round((Date.now()-t)/1000);
+  return s<60?s+'s ago':s<3600?Math.round(s/60)+'m ago':Math.round(s/3600)+'h ago'; }
+function renderSyncPill(){ const p=$('#syncPill'); if(!p)return; const s=syncState;
+  const active=Date.now()<activeUntil;
+  const cls=s.status==='syncing'?'syncing':(s.status==='conflict'||s.status==='error'||s.status==='offline')?'warn':(s.status==='ok'||s.status==='unchanged')?'ok':'';
+  p.className=cls+(active?' active':'');
+  const icon=s.status==='syncing'?'\u27F3':(cls==='warn'?'\u26A0':'\u2601');
+  p.textContent=icon+' '+(s.status==='syncing'?'syncing\u2026':agoStr(s.lastSyncAt))+(active?' \u26A1':'');
+  p.title='Store sync \u2014 '+s.status+(s.detail?': '+s.detail:'')+
+    ' \xB7 last '+(s.lastSyncAt?new Date(s.lastSyncAt).toLocaleTimeString():'never')+
+    (active?' \xB7 \u26A1 active':'')+' \xB7 click to pull now'; }
+async function pullNow(){ syncState=Object.assign({},syncState,{status:'syncing'}); renderSyncPill();
+  try{ const st=await api('/api/pull',{method:'POST'}); syncState=st; renderSyncPill(); if(st.changed)await load(); }
+  catch(e){ syncState={status:'error',detail:e.message,lastSyncAt:Date.now()}; renderSyncPill(); } }
+function noteActivity(){ activeUntil=Date.now()+ACTIVE_WINDOW; renderSyncPill(); }
+let lastAct=0;
+['click','keydown','wheel'].forEach(ev=>document.addEventListener(ev,()=>{const n=Date.now();if(n-lastAct>8000){lastAct=n;noteActivity();}},{passive:true}));
+$('#syncPill')&&$('#syncPill').addEventListener('click',()=>{noteActivity();pullNow();});
+function scheduleSync(){ if(syncTimer)clearTimeout(syncTimer);
+  const delay=Date.now()<activeUntil?ACTIVE_POLL:IDLE_POLL;
+  syncTimer=setTimeout(async()=>{ await pullNow(); scheduleSync(); }, delay); }
+setInterval(renderSyncPill,15000); // keep "Xs ago" fresh
+noteActivity();               // opening the page counts as activity
+pullNow().then(load);         // load changes on open
+scheduleSync();
+</script></body></html>`;
+// src/serve/server.ts
+var JSON_HEADERS = { "content-type": "application/json; charset=utf-8" };
+function syncDir(config) {
+  return config.sync_dir ?? join(config.kb_root, "scripts", "sync");
+}
+function listSyncScripts(config) {
+  const dir = syncDir(config);
+  let names = [];
+  try {
+    names = readdirSync(dir).filter((f) => {
+      if (!f.endsWith(".sh")) return false;
+      try {
+        const st = statSync(join(dir, f));
+        return st.isFile() && (st.mode & 73) !== 0;
+      } catch {
+        return false;
+      }
+    });
+  } catch {
+    return [];
+  }
+  return names.sort((a, b) => a === "sync.sh" ? -1 : b === "sync.sh" ? 1 : a.localeCompare(b)).map((name) => ({ name, standard: name === "sync.sh" }));
+}
+function runSyncScript(config, name) {
+  const dir = syncDir(config);
+  const file = resolve(dir, basename(String(name || "sync.sh")));
+  if (!file.startsWith(resolve(dir) + "/") || !listSyncScripts(config).some((s) => s.name === basename(file))) {
+    return Promise.resolve({ ok: false, code: 126, output: `not a sync script: ${name}` });
+  }
+  return new Promise((resolveP) => {
+    execFile(file, { timeout: 5 * 6e4, maxBuffer: 4 * 1024 * 1024 }, (err, stdout, stderr) => {
+      const output = `${stdout ?? ""}${stderr ? "\n" + stderr : ""}`.trim();
+      const code = err ? err.code ?? 1 : 0;
+      resolveP({ ok: !err, code: typeof code === "number" ? code : 1, output: output.slice(-4e3) });
+    });
+  });
+}
+function fresh(root) {
+  const store = new Store(root);
+  return { store, idx: new PlanningIndex(store) };
+}
+var pullState = { status: "idle", lastSyncAt: 0, changed: false };
+var pulling = null;
+function git(dir, args) {
+  return new Promise((res) => {
+    execFile("git", ["-C", dir, ...args], { timeout: 6e4, maxBuffer: 8 * 1024 * 1024 }, (err, stdout, stderr) => {
+      res({ code: err ? err.code ?? 1 : 0, out: `${stdout ?? ""}${stderr ?? ""}`.trim() });
+    });
+  });
+}
+function getPullState() {
+  return { ...pullState };
+}
+function pullStore(config) {
+  if (pulling) return pulling;
+  const dir = config.kb_root;
+  pullState.status = "syncing";
+  pulling = (async () => {
+    try {
+      if (!existsSync(join(dir, ".git"))) {
+        Object.assign(pullState, { status: "unchanged", detail: "not a git repo", lastSyncAt: Date.now(), changed: false });
+        return getPullState();
+      }
+      const before = (await git(dir, ["rev-parse", "HEAD"])).out;
+      const fetched = await git(dir, ["fetch"]);
+      if (fetched.code !== 0) {
+        Object.assign(pullState, { status: "offline", detail: firstLine(fetched.out), lastSyncAt: Date.now(), changed: false });
+        return getPullState();
+      }
+      const pull = await git(dir, ["pull", "--rebase", "--autostash"]);
+      if (pull.code !== 0) {
+        await git(dir, ["rebase", "--abort"]);
+        Object.assign(pullState, { status: "conflict", detail: firstLine(pull.out), lastSyncAt: Date.now(), changed: false });
+        return getPullState();
+      }
+      const after = (await git(dir, ["rev-parse", "HEAD"])).out;
+      const changed = before !== after;
+      Object.assign(pullState, { status: changed ? "ok" : "unchanged", detail: void 0, lastSyncAt: Date.now(), changed });
+      return getPullState();
+    } catch (e) {
+      Object.assign(pullState, { status: "error", detail: String(e), lastSyncAt: Date.now(), changed: false });
+      return getPullState();
+    } finally {
+      pulling = null;
+    }
+  })();
+  return pulling;
+}
+function firstLine(s) {
+  return (s || "").split("\n").find((l) => l.trim()) ?? "";
+}
+async function readBody(req) {
+  const chunks = [];
+  for await (const c of req) chunks.push(c);
+  return Buffer.concat(chunks).toString("utf8");
+}
+async function handle(opts, req, res) {
+  const url = new URL(req.url ?? "/", "http://localhost");
+  try {
+    if (req.method === "GET" && (url.pathname === "/" || url.pathname === "/index.html")) {
+      res.writeHead(200, { "content-type": "text/html; charset=utf-8" });
+      res.end(DASHBOARD_HTML);
+      return;
+    }
+    if (req.method === "GET" && url.pathname === "/api/snapshot") {
+      const { store, idx } = fresh(opts.root);
+      const date = url.searchParams.get("date") || today();
+      const snap = cmdExport(store, idx, opts.config, date);
+      idx.close();
+      res.writeHead(200, JSON_HEADERS);
+      res.end(JSON.stringify(snap));
+      return;
+    }
+    if (req.method === "GET" && url.pathname === "/api/sessions") {
+      const from = url.searchParams.get("from") || "0000-01-01";
+      const to = url.searchParams.get("to") || "9999-12-31";
+      const days = sessionsByDay(readAllSessions(), from, to);
+      res.writeHead(200, JSON_HEADERS);
+      res.end(JSON.stringify({ from, to, days }));
+      return;
+    }
+    if (req.method === "GET" && url.pathname === "/api/lookback") {
+      const date = url.searchParams.get("date") || today();
+      const store = new Store(opts.root);
+      res.writeHead(200, JSON_HEADERS);
+      res.end(JSON.stringify(buildLookback(store, date)));
+      return;
+    }
+    if (req.method === "GET" && url.pathname === "/api/topics") {
+      const store = new Store(opts.root);
+      res.writeHead(200, JSON_HEADERS);
+      res.end(JSON.stringify(buildTopics(store, opts.config)));
+      return;
+    }
+    if (req.method === "GET" && url.pathname === "/api/object") {
+      const id = url.searchParams.get("id") || "";
+      const store = new Store(opts.root);
+      const doc = store.get(id);
+      if (!doc) {
+        res.writeHead(404, JSON_HEADERS);
+        res.end(JSON.stringify({ error: `not found: ${id}` }));
+        return;
+      }
+      res.writeHead(200, JSON_HEADERS);
+      res.end(JSON.stringify({ id: doc.id, type: doc.type, data: doc.data, body: doc.body ?? "" }));
+      return;
+    }
+    if (req.method === "GET" && url.pathname === "/api/calendar") {
+      const { store, idx } = fresh(opts.root);
+      const from = url.searchParams.get("from") || "0000-01-01";
+      const to = url.searchParams.get("to") || "9999-12-31";
+      const rows = idx.calendar(from, to);
+      idx.close();
+      void store;
+      res.writeHead(200, JSON_HEADERS);
+      res.end(JSON.stringify({ from, to, rows }));
+      return;
+    }
+    if (req.method === "GET" && url.pathname === "/api/sync-status") {
+      res.writeHead(200, JSON_HEADERS);
+      res.end(JSON.stringify(getPullState()));
+      return;
+    }
+    if (req.method === "POST" && url.pathname === "/api/pull") {
+      const st = await pullStore(opts.config);
+      res.writeHead(200, JSON_HEADERS);
+      res.end(JSON.stringify(st));
+      return;
+    }
+    if (req.method === "GET" && url.pathname === "/api/sync-scripts") {
+      res.writeHead(200, JSON_HEADERS);
+      res.end(JSON.stringify({ dir: syncDir(opts.config), scripts: listSyncScripts(opts.config) }));
+      return;
+    }
+    if (req.method === "POST" && url.pathname === "/api/sync") {
+      const body = JSON.parse(await readBody(req) || "{}");
+      const r = await runSyncScript(opts.config, body.script ?? "sync.sh");
+      res.writeHead(r.ok ? 200 : 422, JSON_HEADERS);
+      res.end(JSON.stringify(r));
+      return;
+    }
+    if (req.method === "POST" && url.pathname === "/api/action") {
+      const body = JSON.parse(await readBody(req) || "{}");
+      const store = new Store(opts.root);
+      let result = { ok: true };
+      switch (body.op) {
+        case "set-status":
+          cmdSetStatus(store, String(body.id), String(body.value), body.note);
+          break;
+        case "set-due":
+          cmdSetDue(store, String(body.id), String(body.value));
+          break;
+        case "set-priority":
+          cmdSetPriority(store, String(body.id), String(body.value));
+          break;
+        case "set-project":
+          cmdSetProject(store, String(body.id), String(body.value));
+          break;
+        case "capture": {
+          if (!body.text || !body.text.trim()) throw new Error("capture needs text");
+          result = cmdCapture(store, body.text.trim(), body.domain || void 0);
+          break;
+        }
+        case "edit": {
+          const edits = body;
+          cmdEditObject(store, String(body.id), { title: edits.title, body: edits.body });
+          break;
+        }
+        case "recategorize": {
+          const b = body;
+          result = cmdRecategorize(store, String(body.id), { toType: b.to_type, domain: body.domain, lane: b.lane });
+          break;
+        }
+        case "create": {
+          const b = body;
+          result = cmdCreate(store, {
+            type: b.obj_type,
+            title: String(b.title ?? ""),
+            status: b.status,
+            domain: b.domain,
+            project: b.project,
+            priority: b.priority,
+            due: b.due,
+            body: b.body
+          });
+          break;
+        }
+        default:
+          res.writeHead(400, JSON_HEADERS);
+          res.end(JSON.stringify({ error: `unknown op: ${body.op}` }));
+          return;
+      }
+      res.writeHead(200, JSON_HEADERS);
+      res.end(JSON.stringify(result));
+      return;
+    }
+    res.writeHead(404, JSON_HEADERS);
+    res.end(JSON.stringify({ error: "not found" }));
+  } catch (e) {
+    res.writeHead(422, JSON_HEADERS);
+    res.end(JSON.stringify({ error: String(e?.message ?? e) }));
+  }
+}
+function serve(opts) {
+  const server = createServer((req, res) => void handle(opts, req, res));
+  const host = opts.host ?? "127.0.0.1";
+  return new Promise((resolvePromise, reject) => {
+    server.once("error", reject);
+    server.listen(opts.port, host, () => {
+      const addr = server.address();
+      const port = typeof addr === "object" && addr ? addr.port : opts.port;
+      resolvePromise({ server, port });
+    });
+  });
+}
+export {
+  getPullState,
+  handle,
+  listSyncScripts,
+  pullStore,
+  runSyncScript,
+  serve,
+  syncDir
+};