A local, read-only 3D observatory for Markdown project plans. Inspired by the column-and-dependency structure in tmp/idea.png, with floating task cards, a spatial grid, five delivery lanes and an acceptance inspector.
npm install
npm run dev -- --port 4193 --strictPortOpen http://127.0.0.1:4193/. The development server loads local checkout plans first, then lazily checks the selected repository’s origin. The static build contains the sample workflow and supports Markdown import; it does not include your local project data.
Select a local Three.js checkout with THREE_JS_SOURCE=/path/to/three.js (fallback: ~/Code/three.js), using its existing build/three.module.js and examples/jsm/controls/OrbitControls.js. This checkout is consumed without modification. Fonts and Phosphor icons are installed locally; the browser makes no external asset requests.
- Select a local project in the sidebar, then choose its plan and epic.
- Drag the canvas to orbit; right-drag to pan; scroll or pinch to zoom. Map view disables rotation.
- Select a task to see its acceptance criteria, source line, dependencies and the work it unlocks. Use Focus in space to move closer; R resets the camera.
- Status controls emphasize matching tasks. The dependency toggle controls the connection paths.
- Import a Markdown file or paste its text. Imports remain in memory for this browser session.
- Use the task list to inspect every task, especially on a small screen. The scene shows up to four tasks per lane (20 total); selecting another task brings it into the scene. Cross-file dependencies outside the selected plan are recorded but are not drawn as phantom nodes.
The server scans repository roots under ~/Code for plan.md, docs/plan.md and docs/plans/*.md. Override the root with WAZI_PLAN_ROOT=/path/to/workspace. Discovery stops at Git roots, skips common build/dependency/worktree directories and bounds file sizes, depth and counts. Repositories are sorted. A visible notice reports scan limits or read failures; unsupported metadata is not fabricated.
Local checkout plans load first without network access. Selecting a repository lazily fetches only its origin's advertised default-branch HEAD and updates the displayed plans when successful. Origin failures keep the local checkout visible; revisiting a project restores its local snapshot before checking origin again. Source badges distinguish local and origin records. Git and noninteractive credentials are needed only for origin refresh. Standalone files/imports remain local. Local code analysis requires matching plan bytes; origin display snapshots do not replace local analysis state.
Tasks support checkboxes ([ ], [x], [~], [-]), stable IDs (T1.1, S1.2.1), Owner:, stage:, status:, acc:, deps: and blocked-by:. An incomplete known dependency derives a blocked status; unresolved dependencies produce warnings. Checkboxes remain the source for completed status. Import does not rewrite source plans.
The API is read only and loopback-only, rejects cross-site browser requests and does not cache or bundle plan data. A local development prototype is not a hosted service.
npm test
npm run buildFor this session, dependencies, caches, build output and screenshots are on the external SSD. The implementation and parser tests are tracked in this repository; private plan snapshots are not tracked. Verification details live in design-qa.md and docs/devlog.md.
The experimental headless portable plan contract and Go validator are documented in contracts/plan/v0/README.md. They validate coherent assertions; they do not authenticate receipts or create execution authority.