internal/

Package capture fetches external URLs into note content behind SSRF guards.

Package config loads Seamless configuration from a single YAML file with SEAMLESS_* environment overrides.

Package console serves the Seamless observability UI: server-rendered html/template pages plus an SSE feed, with no node/npm/React or build step.

Package core holds Seamless domain types shared across packages: Project, Memory, Session, Task, Trial, Event, and their enums.

Package demokit is the shared seeding core that fills a THROWAWAY Seamless data dir with backdated fixtures.

Package events is the append-only event log: the single write path for the record of everything (session lifecycle, memory write/read/supersede, injection, task transition, gardener action).

Package files is the markdown layer: memory and note files are the source of truth for durable knowledge.

Package gardener runs the propose-only maintenance passes over the memory corpus: it finds near-duplicate memories (dedup), memories that have gone untouched for too long (staleness), stage memories that stopped carrying a live gate (stale-stage), captured plans that were never approved (stale-plan), and rolls recent sessions into a monthly digest.

Package hooks serves the Claude Code SessionStart and UserPromptSubmit hook endpoints and installs/removes their entries in a settings.json.

Package importer migrates Seam v1 data (~/.seam) into Seamless.

Package lifecycle carries a memory's bi-temporal lifecycle: supersession (one memory replacing another) and provenance.

Package llm provides embedding clients for the configured provider.

Package markdown renders agent-authored markdown as sanitized HTML for the Seamless console.

Package mcp hosts the Seamless MCP tool surface over streamable HTTP with a single static bearer key.

Package plans holds the shared vocabulary of captured Claude Code plans: the note-slug prefixes, the plan-status tag lifecycle, and the tracking-task composition.

Package retrieve assembles what an agent sees from its memory: the session-start briefing, the user-prompt-submit recall block, and the recall tool's fused search.

Free-text search over the structured entities -- tasks, sessions, projects, plans.

Package validate provides shared input-validation helpers enforcing the filesystem-safety invariants in AGENTS.md: