feat: TTSR + blob/artifact storage (ported from oh-my-pi)
* docs(M002): context, requirements, and roadmap
* feat: port TTSR and blob/artifact storage from oh-my-pi
Phase 1 — TTSR (Time Traveling Stream Rules):
- TtsrManager: regex-based stream monitoring with scope filtering,
repeat gating, and buffer isolation (picomatch replaces Bun.Glob)
- Rule loader: scans ~/.gsd/agent/rules/*.md and .gsd/rules/*.md
with YAML frontmatter parsing; project rules override global
- TTSR extension: wires into pi event lifecycle (session_start,
turn_start, message_update, turn_end, agent_end) to abort on
match and inject violation as system reminder via sendMessage
- Interrupt template for rule violation injection
Phase 2 — Blob/Artifact Storage:
- BlobStore: content-addressed storage at ~/.gsd/agent/blobs/ using
Node crypto (sha256), sync I/O, automatic deduplication
- ArtifactManager: session-scoped sequential artifact files stored
alongside session JSONL (lazy dir creation, resume-safe ID scan)
- Session manager integration: prepareForPersistence externalizes
images ≥1KB to blob store before JSONL write; resolveBlobRefs
rehydrates on session load; truncates strings >500KB
- Bash tool artifact spill: uses ArtifactManager instead of temp
files when available, includes artifact:// references in output
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: harden blob store, TTSR manager, and dep classification
- Validate SHA-256 hex format in BlobStore.get/has/parseBlobRef to
prevent path traversal via crafted blob references
- Cap TTSR per-stream buffers at 512KB to prevent unbounded memory growth
- Move picomatch from devDependencies to dependencies (runtime import)
- Warn on invalid regex in TTSR rule conditions instead of silent skip
- Remove .gsd/ planning files that were force-added past .gitignore
- Add trailing newline to ttsr-interrupt.md
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* test: add tests for blob store, artifact manager, TTSR manager, and rule loader
55 tests covering:
- BlobStore put/get/has, idempotency, path traversal rejection
- parseBlobRef/isBlobRef validation, externalize/resolve round-trips
- ArtifactManager sequential IDs, lazy dir creation, session resume
- TtsrManager rule matching, scope filtering, buffer isolation,
repeat gating, buffer size cap, injection persistence
- Rule loader frontmatter parsing, directory scanning, merge logic
Also fixes BlobStore constructor to avoid TS parameter property syntax
(incompatible with Node's strip-only TypeScript mode).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
789a6645da