internal/

directory
v0.10.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 25, 2026 License: MIT

Directories

Path Synopsis
Package adapters holds concrete Embedder adapters for the embed.Embedder port.
Package adapters holds concrete Embedder adapters for the embed.Embedder port.
Package agentproto is the search→narrow→bounded-read protocol for LLM agents: an agent recalls prior conversations WITHOUT pasting whole transcripts — it gets ranked conversation refs, then reads BOUNDED excerpts on demand.
Package agentproto is the search→narrow→bounded-read protocol for LLM agents: an agent recalls prior conversations WITHOUT pasting whole transcripts — it gets ranked conversation refs, then reads BOUNDED excerpts on demand.
Package archive implements the transcript archive: one git repository shared by all of a user's machines, holding each machine's raw transcript trees under a top-level directory per machine (`<machine>/<source>/...`).
Package archive implements the transcript archive: one git repository shared by all of a user's machines, holding each machine's raw transcript trees under a top-level directory per machine (`<machine>/<source>/...`).
archivetest
Package archivetest stands up throwaway transcript-archive fixtures: an isolated HOME with one local Claude project, a configured archive against a local bare remote, and one FOREIGN machine dir pushed by a simulated second machine and pulled into the local clone.
Package archivetest stands up throwaway transcript-archive fixtures: an isolated HOME with one local Claude project, a configured archive against a local bare remote, and one FOREIGN machine dir pushed by a simulated second machine and pulled into the local clone.
Package cli is the thin composition root: the cobra command tree, flag wiring, the flat-output printers, and the JSON emitters.
Package cli is the thin composition root: the cobra command tree, flag wiring, the flat-output printers, and the JSON emitters.
Package durable is rawclaw's transcript vault: the raw, rawclaw-OWNED copy of every session it indexes, plus the small sidecar of index facts that copy cannot carry by itself.
Package durable is rawclaw's transcript vault: the raw, rawclaw-OWNED copy of every session it indexes, plus the small sidecar of index facts that copy cannot carry by itself.
Package embed defines the optional vector-channel PORTS — Embedder and VectorStore — that the keyword engine degrades around gracefully.
Package embed defines the optional vector-channel PORTS — Embedder and VectorStore — that the keyword engine degrades around gracefully.
Package index owns ingest orchestration over the on-disk SQLite/FTS5 store: schema ensuring (over internal/store's DDL), file fingerprinting, incremental reindexing, and corpus stats.
Package index owns ingest orchestration over the on-disk SQLite/FTS5 store: schema ensuring (over internal/store's DDL), file fingerprinting, incremental reindexing, and corpus stats.
Package lifecycle implements USER-DRIVEN session lifecycle operations over Claude Code transcripts: archiving a session's .jsonl out of the active projects tree, and deleting sessions behind a filter gate.
Package lifecycle implements USER-DRIVEN session lifecycle operations over Claude Code transcripts: archiving a session's .jsonl out of the active projects tree, and deleting sessions behind a filter gate.
Package live implements the live peek: "what is the agent on that machine doing right now".
Package live implements the live peek: "what is the agent on that machine doing right now".
Package model defines the normalized transcript message a Source adapter yields for the index to ingest — the ingest-side data contract, parallel to internal/embed's vector ports (defined ahead of its adapters, ship-empty).
Package model defines the normalized transcript message a Source adapter yields for the index to ingest — the ingest-side data contract, parallel to internal/embed's vector ports (defined ahead of its adapters, ship-empty).
Package parse holds text-extraction and parse primitives — flattening one transcript JSON record into a searchable string, tool-stripping, role lookup, ISO-timestamp parsing, and display formatting.
Package parse holds text-extraction and parse primitives — flattening one transcript JSON record into a searchable string, tool-stripping, role lookup, ISO-timestamp parsing, and display formatting.
Package paths holds transcript-directory discovery: the projects root, cwd→project-dir resolution (by matching the cwd recorded inside transcripts), contained-JSONL enumeration with symlink-out containment, and session-id resolution.
Package paths holds transcript-directory discovery: the projects root, cwd→project-dir resolution (by matching the cwd recorded inside transcripts), contained-JSONL enumeration with symlink-out containment, and session-id resolution.
Package provenance mints and derives the identity facts stamped onto indexed rows (D3): the machine's stable self-minted id, the cheap file content fingerprint used as a change watermark, and the session id derived from a transcript path.
Package provenance mints and derives the identity facts stamped onto indexed rows (D3): the machine's stable self-minted id, the cheap file content fingerprint used as a change watermark, and the session id derived from a transcript path.
Package query holds pure query-layer string functions: term parsing, FTS5 query sanitizing, stopword stripping, boolean-operator translation, and the path / min-messages predicates.
Package query holds pure query-layer string functions: term parsing, FTS5 query sanitizing, stopword stripping, boolean-operator translation, and the path / min-messages predicates.
Package render holds the terminal output formatters for the discovery / scroll / browse shapes.
Package render holds the terminal output formatters for the discovery / scroll / browse shapes.
Package retention is the durable-retention policy tree (D1/D2/D5) applied to an indexed scope: the single decision function shared by acting reconciles and read-only probes, the reconcile pass that acts on it, and the user's mirror-mode opt-out.
Package retention is the durable-retention policy tree (D1/D2/D5) applied to an indexed scope: the single decision function shared by acting reconciles and read-only probes, the reconcile pass that acts on it, and the user's mirror-mode opt-out.
Package retrieve holds FTS5 keyword recall: search, the linear-scan fallback, cross-project the cross-project search, and the anchor helpers (lineage walk + ranked anchor messages) that the view layer composes into bookend windows.
Package retrieve holds FTS5 keyword recall: search, the linear-scan fallback, cross-project the cross-project search, and the anchor helpers (lineage walk + ranked anchor messages) that the view layer composes into bookend windows.
Package scopes builds the search-scope list spanning every runtime — the one place that knows about the concrete Source adapters.
Package scopes builds the search-scope list spanning every runtime — the one place that knows about the concrete Source adapters.
Package semantic is the optional vector channel: a float32-BLOB VectorStore living in the SAME cache db as the keyword index (under its own schema gate), brute-force cosine KNN in plain Go, and reciprocal-rank fusion.
Package semantic is the optional vector channel: a float32-BLOB VectorStore living in the SAME cache db as the keyword index (under its own schema gate), brute-force cosine KNN in plain Go, and reciprocal-rank fusion.
Package source defines the ingest PORT: a small interface each runtime's transcript reader implements, so the index can ingest Claude Code, Codex, and future runtimes without knowing the on-disk format underneath.
Package source defines the ingest PORT: a small interface each runtime's transcript reader implements, so the index can ingest Claude Code, Codex, and future runtimes without knowing the on-disk format underneath.
antigravity
Package antigravity is the Source adapter for Google Antigravity (AGY) session transcripts under ~/.gemini/antigravity-cli/brain/<uuid> (or $ANTIGRAVITY_HOME/brain/<uuid>): one brain directory per conversation, transcript in .system_generated/logs/transcript.jsonl (or transcript_full.jsonl), and workspace associations tracked in history.jsonl.
Package antigravity is the Source adapter for Google Antigravity (AGY) session transcripts under ~/.gemini/antigravity-cli/brain/<uuid> (or $ANTIGRAVITY_HOME/brain/<uuid>): one brain directory per conversation, transcript in .system_generated/logs/transcript.jsonl (or transcript_full.jsonl), and workspace associations tracked in history.jsonl.
claude
Package claude is the Source adapter for Claude Code transcripts under ~/.claude/projects (or $CLAUDE_CONFIG_DIR/projects): one project directory per working dir, one *.jsonl per session, subagents under a subagents/ subdir.
Package claude is the Source adapter for Claude Code transcripts under ~/.claude/projects (or $CLAUDE_CONFIG_DIR/projects): one project directory per working dir, one *.jsonl per session, subagents under a subagents/ subdir.
codex
Package codex is the Source adapter for OpenAI Codex CLI transcripts under $CODEX_HOME/sessions (default ~/.codex/sessions): date-partitioned rollout-<ts>-<uuid>.jsonl files, each a self-contained session whose first record is a session_meta header.
Package codex is the Source adapter for OpenAI Codex CLI transcripts under $CODEX_HOME/sessions (default ~/.codex/sessions): date-partitioned rollout-<ts>-<uuid>.jsonl files, each a self-contained session whose first record is a session_meta header.
goose
Package goose is the Source adapter for Goose AI agent session transcripts under ~/.local/share/goose/sessions/ (or ~/.config/goose/sessions/, $GOOSE_HOME/sessions/).
Package goose is the Source adapter for Goose AI agent session transcripts under ~/.local/share/goose/sessions/ (or ~/.config/goose/sessions/, $GOOSE_HOME/sessions/).
Package sources is the explicit composition root for built-in transcript adapters.
Package sources is the explicit composition root for built-in transcript adapters.
FTS read surface: the two keyword-recall queries (flat hits and anchor rows) over messages_fts + messages + sessions, with dynamic filter composition.
FTS read surface: the two keyword-recall queries (flat hits and anchor rows) over messages_fts + messages + sessions, with dynamic filter composition.
storetest
Package storetest provides interface-built test fixtures for the store schema (D7): a production-schema db via store.Rebuild, plus row inserters.
Package storetest provides interface-built test fixtures for the store schema (D7): a production-schema db via store.Rebuild, plus row inserters.
Package timefmt is the single seam for user-facing time rendering.
Package timefmt is the single seam for user-facing time rendering.
Package view does result-shaping: the bookends+window anchored view, org-wide discovery (lineage-deduped, RRF-fused when an embedder is wired), scroll (keep-reading), and browse (no-query recent sessions).
Package view does result-shaping: the bookends+window anchored view, org-wide discovery (lineage-deduped, RRF-fused when an embedder is wired), scroll (keep-reading), and browse (no-query recent sessions).

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL