npm - dreamcontext - Versions diffs - 0.17.1 → 0.18.0 - Mend

dreamcontext 0.17.1 → 0.18.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 (181) hide show

package/skill-packs/goal-skill/assets/goal-skill-demo.cjs ADDED Viewed

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+// Dummy goal-skill run: drives the live state file through every phase so the
+// viewer (localhost:4747) can be watched end-to-end. No real agents are spawned.
+//   node .claude/goal-skill-demo.cjs
+const fs = require('fs');
+const path = require('path');
+const FILE = path.join(process.cwd(), '_dream_context', 'tmp', '.goal-skill-live.json');
+fs.mkdirSync(path.dirname(FILE), { recursive: true });
+const started = new Date().toISOString();
+const F = (s) => ({ s });
+// [seconds-to-hold, phase, iters, impl]
+const BEATS = [
+  [8,  'plan',       { plan: 1 },                                    null],
+  [8,  'review',     { plan: 1, review: 1 },                         null],
+  [7,  'plan',       { plan: 2, review: 1 },                         null],
+  [7,  'review',     { plan: 2, review: 2 },                         null],
+  [6,  'plan',       { plan: 3, review: 2 },                         null],
+  [6,  'review',     { plan: 3, review: 3 },                         null],
+  [5,  'task',       { plan: 3, review: 3 },                         null],
+  [8,  'impl',       { plan: 3, review: 3 }, { wave: 1, waves: 3, forks: [F('run'), F('run'), F('run')] }],
+  [5,  'impl',       { plan: 3, review: 3 }, { wave: 1, waves: 3, forks: [F('done'), F('run'), F('run')] }],
+  [8,  'impl',       { plan: 3, review: 3 }, { wave: 2, waves: 3, forks: [F('done'), F('done'), F('done'), F('run'), F('run')] }],
+  [6,  'impl',       { plan: 3, review: 3 }, { wave: 2, waves: 3, forks: [F('done'), F('done'), F('done'), F('run'), F('fail')] }],
+  [6,  'impl',       { plan: 3, review: 3 }, { wave: 2, waves: 3, forks: [F('done'), F('done'), F('done'), F('done'), F('run')] }],
+  [8,  'impl',       { plan: 3, review: 3 }, { wave: 3, waves: 3, forks: [F('done'), F('done'), F('done'), F('done'), F('done'), F('run')] }],
+  [7,  'codereview', { plan: 3, review: 3, codereview: 1 }, { wave: 3, waves: 3, forks: Array(6).fill(F('done')) }],
+  [6,  'impl',       { plan: 3, review: 3, codereview: 2 }, { wave: 3, waves: 3, forks: [...Array(5).fill(F('done')), F('run')] }],
+  [6,  'codereview', { plan: 3, review: 3, codereview: 2 }, { wave: 3, waves: 3, forks: Array(6).fill(F('done')) }],
+  [7,  'validate',   { plan: 3, review: 3, codereview: 2, validate: 1 }, { wave: 3, waves: 3, forks: Array(6).fill(F('done')) }],
+  [90, 'done',       { plan: 3, review: 3, codereview: 2, validate: 1 }, { wave: 3, waves: 3, forks: Array(6).fill(F('done')) }],
+];
+let i = 0;
+function step() {
+  if (i >= BEATS.length) {
+    fs.rmSync(FILE, { force: true });
+    console.log('demo finished — state cleared');
+    return;
+  }
+  const [hold, phase, iters, impl] = BEATS[i];
+  const st = { goal: 'demo-dummy-goal', started, updated: new Date().toISOString(), phase, iters };
+  // Scope the demo run to the launching session (if any) — same contract as a real run.
+  if (process.env.CLAUDE_CODE_SESSION_ID) st.session = process.env.CLAUDE_CODE_SESSION_ID;
+  if (impl) st.impl = impl;
+  fs.writeFileSync(FILE, JSON.stringify(st));
+  console.log(`beat ${i + 1}/${BEATS.length}: ${phase}` + (impl ? ` wave ${impl.wave}/${impl.waves}` : ''));
+  i++;
+  setTimeout(step, hold * 1000);
+}
+step();

package/skill-packs/goal-skill/assets/goal-skill-viewer.cjs ADDED Viewed

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+// Live Excalidraw-style viewer for a goal-skill v2 run.
+// Serves a hand-drawn animated graph of _dream_context/tmp/.goal-skill-live.json
+// (the same state file the app's live panel reads — single writer: the orchestrator).
+//   node .claude/goal-skill-viewer.cjs [port]     default port 4747
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const { exec } = require('child_process');
+const PORT = Number(process.argv[2]) || 4747;
+const STATE = path.join(process.cwd(), '_dream_context', 'tmp', '.goal-skill-live.json');
+const HTML = `<!doctype html><html><head><meta charset="utf-8"><title>goal-skill live</title>
+<style>
+  :root { color-scheme: dark; }
+  body { margin:0; background:#121217; color:#e8e8ec; font-family:'Chalkboard SE','Comic Sans MS','Segoe Print',cursive;
+         display:flex; flex-direction:column; align-items:center; min-height:100vh; }
+  header { display:flex; gap:14px; align-items:baseline; padding:18px 0 0; }
+  header .mark { color:#b197fc; font-size:22px; font-weight:700; }
+  header .goal { color:#aaa; font-size:17px; }
+  header .clock { color:#666; font-size:15px; }
+  #wrap { width:min(96vw,1400px); }
+  svg { width:100%; height:auto; }
+  .node rect { stroke-width:2.4px; }
+  .node text { font-family:inherit; font-size:17px; font-weight:700; }
+  .node .sub { font-size:12.5px; font-weight:400; }
+  .pending rect { fill:#1d1d24; stroke:#4a4a55; stroke-dasharray:7 5; }
+  .pending text { fill:#666; }
+  .done rect { fill:#b2f2bb; stroke:#2f9e44; }
+  .done text { fill:#0b2e13; }
+  .active text { fill:#101014; }
+  .active rect { animation:pulse 1.4s ease-in-out infinite; }
+  @keyframes pulse { 0%,100%{ filter:drop-shadow(0 0 3px var(--glow,#4dabf7)); }
+                     50%{ filter:drop-shadow(0 0 16px var(--glow,#4dabf7)); } }
+  .arrow { stroke:#8a8a95; stroke-width:2.2; fill:none; marker-end:url(#arr); }
+  .arrow.dim { stroke:#3a3a44; }
+  .loop { stroke-width:2; fill:none; stroke-dasharray:8 6; marker-end:url(#arr); opacity:.35; }
+  .loop.hot { opacity:1; animation:flow 1s linear infinite; }
+  @keyframes flow { to { stroke-dashoffset:-14; } }
+  .heat { font-size:19px; font-weight:800; }
+  .sat { stroke:#101014; stroke-width:1.4; }
+  .sat.run { animation:blink 1s ease-in-out infinite; }
+  @keyframes blink { 50%{ opacity:.35; } }
+  .wave { fill:#66d9e8; font-size:14px; }
+  #idle { color:#555; font-size:18px; margin-top:8px; display:none; }
+  .rough { filter:url(#rough); }
+  #donebanner { fill:#2f9e44; font-size:30px; font-weight:800; display:none; }
+</style></head><body>
+<header><span class="mark">&#9068; goal-skill live</span><span class="goal" id="goal"></span><span class="clock" id="clock"></span></header>
+<div id="idle">no active goal-skill run &mdash; waiting&hellip;</div>
+<div id="wrap"><svg viewBox="0 0 1400 430">
+<defs>
+  <marker id="arr" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7.5" markerHeight="7.5" orient="auto-start-reverse">
+    <path d="M0,0 L10,5 L0,10 z" fill="#8a8a95"/></marker>
+  <filter id="rough"><feTurbulence type="fractalNoise" baseFrequency="0.035" numOctaves="2" seed="7" result="n"/>
+    <feDisplacementMap in="SourceGraphic" in2="n" scale="2.6"/></filter>
+</defs>
+<g class="rough" id="scene"></g>
+</svg></div>
+<script>
+const PAL = { blue:['#a5d8ff','#1971c2'], yellow:['#ffec99','#f08c00'], mint:['#96f2d7','#087f5b'] };
+const NODES = [
+  { id:'plan',       label:'PLAN',      sub:'planner fork',    color:'blue',   x:40   },
+  { id:'review',     label:'REVIEW',    sub:'clean judges',    color:'yellow', x:262  },
+  { id:'task',       label:'TASK DOC',  sub:'map + registry',  color:'mint',   x:484  },
+  { id:'impl',       label:'IMPL',      sub:'wave forks',      color:'blue',   x:706  },
+  { id:'codereview', label:'CODE-REV',  sub:'clean',           color:'yellow', x:928  },
+  { id:'validate',   label:'VALIDATE',  sub:'evidence',        color:'yellow', x:1150 },
+];
+const NY=180, NW=170, NH=74;
+const svgNS='http://www.w3.org/2000/svg';
+const scene=document.getElementById('scene');
+function el(t,a){const e=document.createElementNS(svgNS,t);for(const k in a)e.setAttribute(k,a[k]);return e;}
+// static skeleton
+NODES.forEach((n,i)=>{
+  const g=el('g',{class:'node pending',id:'n-'+n.id});
+  g.appendChild(el('rect',{x:n.x,y:NY,width:NW,height:NH,rx:14}));
+  const t=el('text',{x:n.x+NW/2,y:NY+32,'text-anchor':'middle'}); t.id='t-'+n.id; g.appendChild(t);
+  const s=el('text',{x:n.x+NW/2,y:NY+54,'text-anchor':'middle',class:'sub'}); s.id='s-'+n.id; s.textContent=n.sub; g.appendChild(s);
+  scene.appendChild(g);
+  if(i<NODES.length-1) scene.appendChild(el('path',{class:'arrow dim',id:'a-'+i,
+    d:'M'+(n.x+NW+4)+','+(NY+NH/2)+' L'+(NODES[i+1].x-8)+','+(NY+NH/2)}));
+});
+// loop arcs: review->plan (top), codereview->impl & validate->impl (bottom)
+function arc(id,x1,x2,y,cy){ scene.appendChild(el('path',{class:'loop',id,stroke:'#ffd43b',
+  d:'M'+x1+','+y+' Q'+((x1+x2)/2)+','+cy+' '+x2+','+y})); }
+arc('l-review', NODES[1].x+60, NODES[0].x+110, NY-6, NY-120);
+arc('l-codereview', NODES[4].x+60, NODES[3].x+120, NY+NH+6, NY+NH+96);
+arc('l-validate', NODES[5].x+60, NODES[3].x+50,  NY+NH+6, NY+NH+150);
+// arc → which iter count it visualizes: the review→plan arc glows with PLAN's revision rounds
+const heats={review:['l-review','plan',(NODES[0].x+110+NODES[1].x+60)/2,NY-70],
+             codereview:['l-codereview','codereview',(NODES[3].x+120+NODES[4].x+60)/2,NY+NH+64],
+             validate:['l-validate','validate',(NODES[3].x+50+NODES[5].x+60)/2,NY+NH+118]};
+for(const k in heats){const h=el('text',{x:heats[k][2],y:heats[k][3],'text-anchor':'middle',class:'heat'});h.id='h-'+k;scene.appendChild(h);}
+const satg=el('g',{id:'sats'}); scene.appendChild(satg);
+const doneT=el('text',{x:NODES[5].x+NW/2,y:NY-40,'text-anchor':'middle',id:'donebanner'}); doneT.textContent='\\u2714 DONE'; scene.appendChild(doneT);
+const ORDER=NODES.map(n=>n.id);
+function heatColor(n){ return n>=4?'#ff6b6b':n===3?'#ffa94d':'#ffd43b'; }
+function render(st){
+  const idle=document.getElementById('idle');
+  if(!st){ idle.style.display='block'; document.getElementById('goal').textContent='';
+    document.getElementById('clock').textContent='';
+    NODES.forEach(n=>{document.getElementById('n-'+n.id).setAttribute('class','node pending');
+      document.getElementById('t-'+n.id).textContent=n.label;});
+    doneT.style.display='none'; satg.innerHTML=''; waveT.textContent='';
+    for(const k in heats){document.getElementById('h-'+k).textContent='';
+      document.getElementById(heats[k][0]).setAttribute('class','loop');}
+    return; }
+  idle.style.display='none';
+  document.getElementById('goal').textContent=st.goal||'';
+  const mins=st.started?Math.max(0,Math.round((Date.now()-Date.parse(st.started))/60000)):null;
+  document.getElementById('clock').textContent=(mins!=null?mins+' min':'');
+  const cur=st.phase==='done'?ORDER.length:Math.max(0,ORDER.indexOf(st.phase));
+  NODES.forEach((n,i)=>{
+    const g=document.getElementById('n-'+n.id), t=document.getElementById('t-'+n.id);
+    const it=(st.iters||{})[n.id]||0;
+    if(st.phase==='done'||i<cur){ g.setAttribute('class','node done'); t.textContent='\\u2714 '+n.label; }
+    else if(i===cur){ g.setAttribute('class','node active');
+      const [f,s]=PAL[n.color]; const r=g.querySelector('rect');
+      r.style.fill=f; r.style.stroke=s; g.style.setProperty('--glow',s); t.textContent='\\u25B6 '+n.label; }
+    else { g.setAttribute('class','node pending'); const r=g.querySelector('rect');
+      r.style.fill=''; r.style.stroke=''; t.textContent=n.label; }
+    if(it>1){ const ts=document.createElementNS(svgNS,'tspan');
+      ts.textContent=' \\u00D7'+it; ts.style.fill=heatColor(it); t.appendChild(ts); }
+    if(i<NODES.length-1) document.getElementById('a-'+i).setAttribute('class','arrow'+(i<cur?'':' dim'));
+  });
+  for(const k in heats){
+    const n=(st.iters||{})[k]||0; const h=document.getElementById('h-'+k); const l=document.getElementById(heats[k][0]);
+    if(n>=2){ h.textContent='\\u00D7'+n; h.style.fill=heatColor(n); l.setAttribute('class','loop hot'); l.style.stroke=heatColor(n); }
+    else { h.textContent=''; l.setAttribute('class','loop'); l.style.stroke='#ffd43b'; }
+  }
+  satg.innerHTML='';
+  const forks=(st.impl&&st.impl.forks)||[];
+  const cx=NODES[3].x+NW/2, cy=NY+NH/2, RX=112, RY=62;
+  forks.forEach((f,i)=>{
+    const a=-Math.PI/2+i*(2*Math.PI/Math.max(forks.length,1));
+    const col=f.s==='done'?'#69db7c':f.s==='run'?'#ffd43b':f.s==='fail'?'#ff6b6b':'#555';
+    satg.appendChild(el('circle',{cx:cx+RX*Math.cos(a),cy:cy+RY*Math.sin(a),r:9,fill:col,
+      class:'sat'+(f.s==='run'?' run':'')}));
+  });
+  document.getElementById('s-impl').textContent=(st.impl&&st.impl.waves)
+    ?('wave '+(st.impl.wave||1)+' / '+st.impl.waves):'wave forks';
+  doneT.style.display=st.phase==='done'?'block':'none';
+}
+async function tick(){ try{ const r=await fetch('/state',{cache:'no-store'});
+    render(r.ok?await r.json():null); }catch(e){ render(null); } }
+tick(); setInterval(tick,800);
+</script></body></html>`;
+const server = http.createServer((req, res) => {
+  if (req.url.startsWith('/state')) {
+    try {
+      const raw = fs.readFileSync(STATE, 'utf8');
+      const st = JSON.parse(raw);
+      const upd = Date.parse(st.updated || st.started || 0);
+      if (!upd || Date.now() - upd > 3 * 3600 * 1000) throw new Error('stale');
+      res.writeHead(200, { 'content-type': 'application/json' });
+      return res.end(raw);
+    } catch {
+      res.writeHead(404); return res.end();
+    }
+  }
+  res.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
+  res.end(HTML);
+});
+server.on('error', (e) => {
+  if (e.code === 'EADDRINUSE') {
+    console.error('port ' + PORT + ' is already in use — a viewer is probably running: http://localhost:' + PORT);
+    process.exit(1);
+  }
+  throw e;
+});
+server.listen(PORT, '127.0.0.1', () => {
+  const url = 'http://localhost:' + PORT;
+  console.log('goal-skill live viewer: ' + url);
+  if (process.platform === 'darwin' && !process.env.NO_OPEN) exec('open ' + url);
+});

package/skill-task-manager/SKILL.md ADDED Viewed

@@ -0,0 +1,93 @@
+---
+name: task-manager
+description: >
+  Load when a Claude session is scoped to ONE dreamcontext task and its job is to MANAGE that
+  task document — not to implement it. Triggers: "manage this task", "revise / summarize /
+  split this task", "reconcile the acceptance criteria", "tighten the Why", "this task has
+  drifted from reality", "/task-manager", or any session opened from a task's Task Manager pane
+  in the dashboard (which loads this skill automatically and names the task in its first
+  message). You maintain the task: sharpen its prose, split it when it holds two jobs, reconcile
+  its status and criteria with what is actually true, and log what you changed. You do NOT write
+  product code — that is the delegate flow's job.
+user-invocable: true
+alwaysApply: false
+tags: [tasks, task-manager, revise, summarize, split, status, dreamcontext, task-detail]
+---
+# Task Manager — maintain ONE task, in place
+You are pinned to a single dreamcontext task. The user is looking at that task's document in
+the dashboard right now, and it re-reads the file as you edit it — so your writes are the UI.
+**Manage ≠ Do.** You maintain the task *document*. You do not implement the task. If the user
+asks you to build the thing, tell them to use **Delegate** (the ▶ button on the task, or
+right-click the card on the board) — that opens a separate agent with the right scope. The one
+exception: reading product code to check whether a criterion is *already true* is management, not
+implementation. Read freely; just don't write outside `_dream_context/`.
+## Start here, every session
+1. **Read the task first.** It lives at `_dream_context/state/<slug>.md`. Read the whole file
+   before you touch anything — frontmatter, Workflow mermaid, Why, User Stories, Acceptance
+   Criteria, Constraints & Decisions, Technical Details, Notes, Changelog.
+   (There is no `dreamcontext tasks show`. Read the file, or use `dreamcontext tasks list --json`.)
+2. **Treat `## Constraints & Decisions` as settled law.** Those are decisions the user already
+   made, with reasons. Don't re-litigate them or quietly reverse them. If one now looks wrong,
+   say so and ask — don't just edit it away.
+3. **Say what you're about to change before you change it**, in one or two lines. The user is
+   watching the document, not a diff.
+## Edit through the CLI, never by rewriting the markdown
+The task file has structure the naked eye doesn't see: frontmatter fields, a Workflow mermaid
+whose nodes must stay in sync with the Acceptance Criteria, a LIFO changelog, and indexes that
+live outside the file. Hand-rewriting the markdown breaks those silently. So:
+| Intent | Command |
+| --- | --- |
+| Add to a section | `dreamcontext tasks insert <slug> <section> "<content>"` — sections: `why`, `user_stories`, `acceptance_criteria`, `constraints`, `technical_details`, `notes`, `changelog` |
+| Record what you did | `dreamcontext tasks log <slug> "<note>"` |
+| Move the lifecycle | `dreamcontext tasks status <slug> <status> "<reason>"` |
+| Finish it | `dreamcontext tasks complete <slug> "<summary>"` |
+| Split out a child | `dreamcontext tasks create "<name>" …` then set `parent_task` on the child |
+| Retitle | `dreamcontext tasks rename <slug> "<new name>"` (keeps file + slug + remote mapping aligned) |
+| Tags / dates / version / feature / objectives / RICE / custom fields | `dreamcontext tasks tag \| start \| due \| version \| feature \| objectives \| rice \| field` |
+`Edit`/`Write` on `state/<slug>.md` is a **last resort** — only for prose inside a section that
+no `insert` shape can express, and only after you've read the file. Never touch frontmatter by
+hand; there is a command for every field.
+**Always finish with `dreamcontext tasks doctor <slug>`.** It verifies the Workflow flowchart is
+still in sync with the Acceptance Criteria. If you added, removed, or reworded a criterion, the
+mermaid needs a matching node — doctor is how you find out you broke it. Green, or keep going.
+## The four moves
+**Revise** — tighten the prose without changing the meaning. Cut hedging, fuse duplicate
+bullets, make each criterion independently testable. If a criterion can't be tested as written,
+that's the bug — rewrite it so it can be, and say what you changed it from.
+**Summarize** — the `description` frontmatter field is the one-liner. It should say what the
+task *is*, not restate its title. Set it with `dreamcontext tasks field` / the create-time flag,
+and keep it under a sentence.
+**Split** — when a task holds two independent jobs, create children with
+`dreamcontext tasks create`, set `parent_task` to this slug, move the relevant criteria to the
+children, and leave the parent's Workflow nodes pointing at the split. Don't split just because
+a task is long — split when the halves could ship separately, or be owned by different people.
+**Status / reconcile** — the honest move. Read the code and check each unticked criterion: is it
+*actually* still open? Tick what's demonstrably true, and say what evidence convinced you. Move
+the status only when the criteria justify it (`dreamcontext tasks status`). Never tick a
+criterion you haven't verified — a green task that isn't done is worse than an honest red one.
+## Rules
+- **The file is the source of truth, and the user is watching it.** Never batch up a mental
+  model and dump it at the end; make one coherent change at a time so the doc updates live.
+- **Log what you changed** (`dreamcontext tasks log`) — the changelog is how the next session
+  knows why the task looks like this.
+- **Ask when a decision is genuinely forked.** You're in an interactive session with the user
+  sitting right there; a question is cheap and a wrong rewrite is not.
+- **Don't invent scope.** Managing a task means the task gets clearer, not bigger. If you notice
+  real work nobody has tracked, propose a *new* task rather than growing this one.

package/dist/dashboard/assets/channel-2YfRjala.js DELETED Viewed

	@@ -1 +0,0 @@
1	- import{aq as o,ar as n}from"./index-BIfrbaFS.js";const t=(r,a)=>o.lang.round(n.parse(r)[a]);export{t as c};

package/dist/dashboard/assets/classDiagram-6PBFFD2Q-DB_UnN1h.js DELETED Viewed

@@ -1 +0,0 @@

- import{s as a,c as s,a as e,C as t}from"./chunk-4TB4RGXK-BnFO5G1t.js";import{_ as i}from"./index-BIfrbaFS.js";import"./chunk-FMBD7UC4-cfSvx35j.js";import"./chunk-YZCP3GAM-CGp_NiRg.js";import"./chunk-55IACEB6-COm2TYEM.js";import"./chunk-EDXVE4YY-CtsGCwZp.js";var u={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{u as diagram};

package/dist/dashboard/assets/classDiagram-v2-HSJHXN6E-DB_UnN1h.js DELETED Viewed

@@ -1 +0,0 @@

package/dist/dashboard/assets/clone-DaDvB3N6.js DELETED Viewed

	@@ -1 +0,0 @@
1	- import{b as r}from"./graph-CZFIeNHZ.js";var e=4;function a(o){return r(o,e)}export{a as c};