chat-logbook 0.2.1 → 0.3.1

package/README.md

@@ -1,26 +1,38 @@
 # chat-logbook
 
-A local-first conversation browser for Claude Code.
+> _Where your AI conversations live._
 
-> **Status:** Early release (v0.2.1). Core browsing and rendering work well.
-> Search, filtering, tagging, and annotations are on the roadmap but not yet
-> implemented. See [Roadmap](#roadmap) for what's planned.
+chat-logbook is a local-first library for your AI conversations. It reads the
+files AI assistants write on your machine — starting with Claude Code, with
+more tools planned — and presents them as a single browsable, searchable,
+organizable history.
+
+> **Status:** Early release (v0.3.0). Browsing, rendering, and
+> soft-delete with Trash are working today. Search, tags, and
+> annotations are on the way. See [Roadmap](#roadmap).
 
 ## About
 
-Claude Code stores every conversation as JSONL files in `~/.claude/`, but
-provides no UI to browse or revisit them. chat-logbook fills that gap — it
-reads those files and presents them in a browser, so you can review past
-sessions without digging through raw JSON.
+You open chat-logbook from the command line, and a browser window opens onto
+your conversation history. You can browse it, find anything in it, tag what
+matters, and pick up where you left off.
+
+Nothing leaves your machine. There is no account to create. The original
+files written by your AI tools are never modified.
 
 Design principles:
 
-- **Read-only access to `~/.claude/`** — never modify original conversation files.
-- **Local-only** — no data leaves your machine.
-- **Zero configuration** — install and run, nothing else required.
+- **Read-only access to source directories.** Original conversation files are
+  never modified. Today that means `~/.claude/`; the same rule applies to
+  every agent we add.
+- **Local-only.** No telemetry, no analytics, no third-party calls.
+- **Zero configuration.** Install and run.
+- **Drive everything from the keyboard.** A `/` or `⌘K` overlay finds any
+  past conversation in seconds. The mouse still works, but every primary
+  action has a binding.
 
-The full problem statement, user stories, and implementation decisions live in
-the PRD: [issue #1](https://github.com/evaaaaawu/chat-logbook/issues/1).
+The full problem statement, user stories, and direction live in the
+[PRD](docs/PRD.md).
 
 ## What works today
 
@@ -123,15 +135,53 @@ No. chat-logbook reads from local `~/.claude/` files, which are only created by
 
 ## Roadmap
 
-- **Full-text search** — Find conversations by keywords across all projects
-- **Project filtering** — Focus on conversations within a specific project
-- **Real-time streaming** — Watch active conversations update live via SSE
-- **Keyboard shortcuts** — `↑↓` to switch sessions, `/` to search, `Esc` to go back
-- **Soft delete & restore** — Hide sessions you don't need; restore them anytime
-- **Title editing** — Customize session titles for easier identification
-- **Tag system** — Add color-coded tags to sessions, filter by multiple tags
-- **Annotations** — Add notes next to any message in a conversation
-- **Highlights** — Mark important text within conversations
+The headline feature on the way is **Spotlight Search** — a `⌘K` / `/` overlay
+that searches across sessions, messages, tags, and projects with full keyboard
+navigation, full-text matching (SQLite FTS5 trigram), and message-level jump +
+highlight. It is tracked as the [Spotlight Search epic (#5)](https://github.com/evaaaaawu/chat-logbook/issues/5).
+
+Work is grouped into release milestones:
+
+### [v0.3.0 — Spotlight Alpha](https://github.com/evaaaaawu/chat-logbook/milestone/1)
+
+- **Spotlight overlay skeleton** — `⌘K` / `/` opens an overlay; sessions picker; `Enter` opens, `Esc` closes
+- **SQLite + soft delete & restore** — hide sessions you don't need; recover them anytime
+- **Full keyboard contract** — Browse + Spotlight bindings unified
+
+### [v0.4.0 — Spotlight v1](https://github.com/evaaaaawu/chat-logbook/milestone/2)
+
+- **FTS5 full-text messages search** — fast keyword search across all conversations, including CJK and file paths mentioned in tool calls
+- **Incremental reindex** — newly-arrived messages are searchable within seconds
+- **Message-level jump** — Spotlight matches scroll to the exact message and highlight the matched term, with a `n / m matches  ↑↓ Esc` navigator bar
+- **Tags & Projects pickers** — `Tab`-cycle picker scopes; tag/project selection applies the same filter pipeline as the navigation panel
+- **Tag system + tag filtering** — color-coded tags, multi-tag AND filtering
+- **Project filtering** — focus on conversations within a specific project
+- **Title editing** — customize session titles for easier identification
+
+### [v0.5.0 — Cross-vendor foundation](https://github.com/evaaaaawu/chat-logbook/milestones)
+
+- **Parser plugin architecture** — one plugin per agent, behind a stable
+  interface, so adding a new tool is a contained change
+- **First additional agents** — Codex CLI and Aider plugins, alongside the
+  existing Claude Code reader
+- **`SyncProvider` interface stub** — a no-op default in the OSS core, leaving
+  the integration point open for an opt-in cloud product later
+
+### Later
+
+- **Real-time streaming** — watch active conversations update live via SSE
+- **Annotations** — add notes next to any message in a conversation
+- **Highlights** — mark important text within conversations
+- **`#tag` / `@project` prefix syntax** in Spotlight (fast-follow)
+- **Recent-sessions empty state + onboarding hint** in Spotlight (fast-follow)
+
+Explicit non-goals: semantic / vector search, cloud sync inside the OSS core,
+and any modification of source directories like `~/.claude/`. See the
+[PRD](docs/PRD.md) for the full out-of-scope list.
+
+This project is **not affiliated with Anthropic, OpenAI, or any other AI
+provider.** It reads files those tools write on your machine; it does not
+talk to their servers and is not endorsed by them.
 
 ## License
 

package/api/dist/drizzle/0000_safe_slapstick.sql

@@ -0,0 +1,6 @@
+CREATE TABLE `sessions_meta` (
+	`session_id` text PRIMARY KEY NOT NULL,
+	`is_deleted` integer DEFAULT false NOT NULL,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL
+);

package/api/dist/drizzle/meta/0000_snapshot.json

@@ -0,0 +1,57 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "bc9f920f-c5a0-4f4f-b813-9ea2c69e0f7e",
+  "prevId": "00000000-0000-0000-0000-000000000000",
+  "tables": {
+    "sessions_meta": {
+      "name": "sessions_meta",
+      "columns": {
+        "session_id": {
+          "name": "session_id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "is_deleted": {
+          "name": "is_deleted",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

package/api/dist/drizzle/meta/_journal.json

@@ -0,0 +1,13 @@
+{
+  "version": "7",
+  "dialect": "sqlite",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "6",
+      "when": 1777980160883,
+      "tag": "0000_safe_slapstick",
+      "breakpoints": true
+    }
+  ]
+}