2026-05-11

Focus

• Ghost overlay sensor pipeline correctness

Log

Session 17:31 (tRAGar)

• Closed tRAG-vae — resolved rerank ordering ambiguity: explicit guarantee "rerank-all-then-yield" for v0.1, forward-compat note for v0.3 streaming opt-in via Reranker.supportsStreaming + QueryOptions.streamingRerank
• Updated openspec/specs/public-api/spec.md with the explicit ordering guarantee
• Archived add-tracer-bullet-vertical-slice OpenSpec (implementation was already done, tasks hadn't been checked off)
• Implemented add-vector-access-export OpenSpec fully (9/9 tasks):
  • getVector(id) → Float32Array copy, throws NotFound for unknown ids
  • getAllVectors() → snapshot array of { id, v: Float32Array }
  • export('json') → { meta, chunks, vectors_b64 } Blob
  • export('binary') → STORE-method zip (pure JS, no deps)
  • DequantizationRequested warn-once pattern
  • 19 new tests (98 total, all passing)
• Implemented add-file-store OpenSpec (tasks 1.1–1.4, 1.7–1.8 done):
  • stores.file(dirPath) factory in js/tragar.ts
  • NodeFsFileBackend with dynamic node: imports for browser-safe bundling
  • 13 tests; tasks 1.5–1.6 blocked on add-vocabulary-chunker
• Rule-of-5 review pass on add-vector-access-export:
  • Fixed #fireDequeueWarn typo → #fireDequantWarn
  • Improved export() JSDoc to describe binary format schema
  • Clarified misleading test name
• Next: pick next OpenSpec track (add-vocabulary-chunker unblocks file-store 1.5–1.6; or start another 0% track)

Sessions 17:31 (dont — 2 sessions)

• Planned four change proposals: --file git provenance (dont-lpk), rename dont lock → dont forget (dont-4j4), dt alias (dont-kxg), ephemeral session wrapper (dont-w36)
• Created beads issues with dependencies; Ro5/issue-review passes completed
• Implemented all 6 ready issues via tdd-ro5 pipeline: dont-lpk, dont-4j4, dont-9fv (explain cmd), dont-8h2 (completions tests), dont-gl0 (config blocks), dont-buz (--json envelope)
• Ran rule-of-5-universal; fixed all findings: monorepo-safe git toplevel resolution, mode-change baseline bootstrapping, I/O error surfacing, shell.to_string() cleanup
• All changes pushed to remote
• Arc: 6 ready issues → 0; full tdd-ro5 cycle with quality review
• Next: dont-kxg (dt alias) and dont-w36 (ephemeral sessions) are now unblocked

Tasks created

Decisions

Session 17:31 (miblioteca)

• Ran issue-review on 8 GhostMotionPipeline extraction issues; collapsed 4 tiny Phase 0 issues into mibilioteca-e2s, added E2E acceptance issue mibilioteca-898, fixed stale test count on mibilioteca-0d3
• mibilioteca-e2s (TDD): removed double gyro integration in motionHandler, fixed scanAxis hard-coded 'y', consolidated focalLengthPx to ghostOverlay.ts, added clampYawToViewport to onGyroReading
• mibilioteca-i77: created GhostMotionPipeline class; fixed no-gyro guard to prevent zero-shift frame spam pre-snapshot
• Wired GhostOverlayCanvas and GhostCalibrationPage to GhostMotionPipeline (mibilioteca-0d3, mibilioteca-d1w); removed focalLengthPx re-export from page
• Fixed /ghost rectangle not moving: ghost/main.ts was passing no deps → gyro: null; fixed to mirror App.ts sensor detection
• Removed translation double-integration from GhostOverlayCanvas (accel drift produced 400px+ vertical shift in 30s; now pure-rotation)
• Fixed motion gate reset bug: yawIntegral/pitchIntegral were zeroed on gate close; integrals now accumulate across gate cycles
• Added ghost overlay (50% opacity captured frame) to /ghost page; allowed off-screen rectangle drag; added start/end cycle snapshots to exported JSON
• Fixed DeviceMotionGyroAdapter axis: x = alpha (not gamma) — calibration proved alpha dominates vertical tilt on Firefox Android
• Fixed H_FOV_DEG 65°→40° from calibration showing consistent 1.83× undershoot; fixed rectInitLeft/Top to persist from last GT position
• Next: on-device verify FOV fix; close mibilioteca-898 E2E acceptance when both pages confirmed to track identically