plan-assistant 1.5.0 → 1.6.0

package/README.md

@@ -18,24 +18,28 @@ This will:
 
 | Command | Description |
 |---------|-------------|
+| `plan-assistant init [--output <file>]` | Generate a plan template (stdout if no `--output`) |
 | `plan-assistant review <file>` | Parse and open plan for review |
 | `plan-assistant status <file-or-id>` | Check review status (exit codes: 0=approved, 3=needs-work, 4=reviewing, 5=no feedback) |
 | `plan-assistant feedback <file-or-id>` | Output feedback JSON |
-| `plan-assistant list` | List all sessions |
-| `plan-assistant init` | Generate a plan template |
-| `plan-assistant clean` | Remove orphaned sessions |
+| `plan-assistant list [--dir <path>]` | List all sessions |
+| `plan-assistant stop [<file-or-id>]` | Stop running server(s) |
+| `plan-assistant clean [--all] [--older-than <dur>]` | Remove old/orphaned sessions |
 | `plan-assistant export <file-or-id>` | Export as self-contained HTML |
-| `plan-assistant help` | Show help |
+| `plan-assistant help [format]` | Show help or plan format reference |
 
 ### Common flags
 
 - `--pretty` — Human-readable output (default: JSON for AI parsing)
-- `--port <N>` — Specific port for review server
-- `--wait` — Block until feedback is submitted (status command)
-- `--unresolved` — Only show unresolved comments (feedback command)
-- `--phase <id>` — Filter to a specific phase (feedback command)
-- `--dry-run` — Preview what would be removed (clean command)
-- `--output <file>` — Write to file instead of stdout (init, export commands)
+- `--port <N>` — Specific port for review server (review)
+- `--host <H>` — Hostname for browser URL, e.g. host IP when running in Docker (review)
+- `--no-wait` — Don't wait for feedback, just start the server (review)
+- `--reuse` — Reuse an already-running server for another session (review)
+- `--wait` — Block until feedback is submitted (status)
+- `--unresolved` — Only show unresolved comments (feedback)
+- `--phase <id>` — Filter to a specific phase (feedback)
+- `--dry-run` — Preview what would be removed (clean)
+- `--output <file>` — Write to file instead of stdout (init, export)
 
 ## Features
 
@@ -252,6 +256,21 @@ Add `.plan-sessions/` to your `.gitignore`.
 npm install
 npm run dev        # SvelteKit dev server on port 5199
 npm run build      # Build CLI + server
-npm test           # Run parser tests
-npm run check      # Type check
+npm run build:cli  # CLI only (tsconfig.cli.json → bin/)
+npm test           # Vitest (parser, diff, status, export tests)
+npm run check      # svelte-check + TypeScript
+```
+
+### Architecture
+
+```
+src/
+  cli/              CLI entry point, commands, markdown parser
+  lib/
+    components/     Svelte 5 components (plan/, feedback/)
+    stores/         Rune-based stores (plan, feedback)
+    server/         Session manager, file watcher, SSE, idle timer
+    types/          TypeScript type definitions
+    utils/          Diff engine, status helpers
+  routes/           SvelteKit pages and API routes
 ```

package/build/client/_app/immutable/chunks/{CLpU78SQ.js → 5KpFG7Y3.js}

@@ -1,4 +1,4 @@
-import{g as qt}from"./D82Ibe2Y.js";import{_ as m,n as Ot,l as t1,c as b1,d as S1,o as Ht,r as Xt,u as it,b as Qt,s as Jt,p as Zt,a as $t,g as te,q as ee,k as se,t as ie,J as re,v as ae,x as st,y as ne,z as ue,A as oe}from"./DwtNXPRV.js";import{g as le}from"./B5dqmTZt.js";import{s as ce}from"./Bv2Fvpd-.js";import{c as he}from"./DcuidqoU.js";var de="flowchart-",P1,pe=(P1=class{constructor(){this.vertexCounter=0,this.config=b1(),this.vertices=new Map,this.edges=[],this.classes=new Map,this.subGraphs=[],this.subGraphLookup=new Map,this.tooltips=new Map,this.subCount=0,this.firstGraphFlag=!0,this.secCount=-1,this.posCrossRef=[],this.funs=[],this.setAccTitle=Qt,this.setAccDescription=Jt,this.setDiagramTitle=Zt,this.getAccTitle=$t,this.getAccDescription=te,this.getDiagramTitle=ee,this.funs.push(this.setupToolTips.bind(this)),this.addVertex=this.addVertex.bind(this),this.firstGraph=this.firstGraph.bind(this),this.setDirection=this.setDirection.bind(this),this.addSubGraph=this.addSubGraph.bind(this),this.addLink=this.addLink.bind(this),this.setLink=this.setLink.bind(this),this.updateLink=this.updateLink.bind(this),this.addClass=this.addClass.bind(this),this.setClass=this.setClass.bind(this),this.destructLink=this.destructLink.bind(this),this.setClickEvent=this.setClickEvent.bind(this),this.setTooltip=this.setTooltip.bind(this),this.updateLinkInterpolate=this.updateLinkInterpolate.bind(this),this.setClickFun=this.setClickFun.bind(this),this.bindFunctions=this.bindFunctions.bind(this),this.lex={firstGraph:this.firstGraph.bind(this)},this.clear(),this.setGen("gen-2")}sanitizeText(i){return se.sanitizeText(i,this.config)}lookUpDomId(i){for(const a of this.vertices.values())if(a.id===i)return a.domId;return i}addVertex(i,a,n,u,o,f,c={},A){var L,C;if(!i||i.trim().length===0)return;let r;if(A!==void 0){let d;A.includes(`
+import{g as qt}from"./Drf3oeac.js";import{_ as m,n as Ot,l as t1,c as b1,d as S1,o as Ht,r as Xt,u as it,b as Qt,s as Jt,p as Zt,a as $t,g as te,q as ee,k as se,t as ie,J as re,v as ae,x as st,y as ne,z as ue,A as oe}from"./DqaGnr0n.js";import{g as le}from"./qFFXeAvY.js";import{s as ce}from"./BkkBWYh4.js";import{c as he}from"./AMggw8F_.js";var de="flowchart-",P1,pe=(P1=class{constructor(){this.vertexCounter=0,this.config=b1(),this.vertices=new Map,this.edges=[],this.classes=new Map,this.subGraphs=[],this.subGraphLookup=new Map,this.tooltips=new Map,this.subCount=0,this.firstGraphFlag=!0,this.secCount=-1,this.posCrossRef=[],this.funs=[],this.setAccTitle=Qt,this.setAccDescription=Jt,this.setDiagramTitle=Zt,this.getAccTitle=$t,this.getAccDescription=te,this.getDiagramTitle=ee,this.funs.push(this.setupToolTips.bind(this)),this.addVertex=this.addVertex.bind(this),this.firstGraph=this.firstGraph.bind(this),this.setDirection=this.setDirection.bind(this),this.addSubGraph=this.addSubGraph.bind(this),this.addLink=this.addLink.bind(this),this.setLink=this.setLink.bind(this),this.updateLink=this.updateLink.bind(this),this.addClass=this.addClass.bind(this),this.setClass=this.setClass.bind(this),this.destructLink=this.destructLink.bind(this),this.setClickEvent=this.setClickEvent.bind(this),this.setTooltip=this.setTooltip.bind(this),this.updateLinkInterpolate=this.updateLinkInterpolate.bind(this),this.setClickFun=this.setClickFun.bind(this),this.bindFunctions=this.bindFunctions.bind(this),this.lex={firstGraph:this.firstGraph.bind(this)},this.clear(),this.setGen("gen-2")}sanitizeText(i){return se.sanitizeText(i,this.config)}lookUpDomId(i){for(const a of this.vertices.values())if(a.id===i)return a.domId;return i}addVertex(i,a,n,u,o,f,c={},A){var L,C;if(!i||i.trim().length===0)return;let r;if(A!==void 0){let d;A.includes(`
 `)?d=A+`
 `:d=`{
 `+A+`

package/build/client/_app/immutable/chunks/AMggw8F_.js

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