happenin 0.0.1

package/LICENSE.md

@@ -0,0 +1,19 @@
+Copyright (c) 2026 YogliB
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,180 @@
+# happenin
+
+A macOS CLI that records Cursor and Claude Code agent events to a local SQLite database and serves a live browser dashboard.
+
+## Why
+
+Cursor and Claude Code can emit local hooks for each session, tool use, prompt, file edit, and lifecycle event. `happenin` adds `record` hooks to those agents, writes the payloads to a local SQLite database, and serves a live browser dashboard. Data never leaves your machine.
+
+## Stability
+
+`happenin` is pre-1.0. The CLI, database schema, and dashboard output may change in small ways between releases until `v1.0.0`. Any breaking changes will be minor and listed in the [changelog](docs/CHANGELOG.md).
+
+## Requirements
+
+- macOS
+- Node.js `>= 24.0.0` (uses the built-in `node:sqlite` module)
+- Zero runtime dependencies
+- The dashboard loads htmx, AlpineJS, and htmx-ext-sse from a CDN
+
+## Install
+
+```bash
+npm install -g happenin
+```
+
+Or run from source:
+
+```bash
+git clone git@github.com:YogliB/happenin.git
+cd happenin
+npm install
+npm run build
+```
+
+## Quick start
+
+```bash
+# Install hooks into Cursor and Claude Code (backs up existing configs)
+happenin install
+
+# Import existing transcripts
+happenin import
+
+# Start the live dashboard
+happenin dashboard
+```
+
+The dashboard opens at `http://localhost:8765`. New events appear automatically.
+
+## Commands
+
+### `happenin install [--cursor] [--claude]`
+
+Backs up and appends `happenin record` hooks to `~/.cursor/hooks.json` and `~/.claude/settings.json`. Backups are written to `~/.happenin/backups/`.
+
+```bash
+happenin install --cursor
+happenin install --claude
+```
+
+### `happenin record <source> [event]`
+
+The hook target. Reads a JSON payload from stdin, writes it to `~/.happenin/happenin.db`, and prints the required non-blocking response for the agent.
+
+- `source` — `cursor` or `claude`.
+- `event` — only required for Claude; Cursor payloads include `hook_event_name`.
+
+This command is normally called by the agent hooks, not directly:
+
+```bash
+echo '{"hook_event_name":"sessionStart","sessionId":"abc123"}' | happenin record cursor
+echo '{"sessionId":"abc123"}' | happenin record claude SessionStart
+```
+
+### `happenin import`
+
+Imports existing transcripts:
+
+- Claude Code JSONL from `~/.claude/projects/<project>/<session>.jsonl`.
+- Cursor `prompt_history.json` and `meta.json` from `~/.cursor/chats/<hash>/<session>/`.
+
+`store.db` is skipped because it is encrypted.
+
+### `happenin query [options]`
+
+Query events from the local database and print them as JSON, JSONL, or a summary.
+
+```bash
+happenin query --limit 10
+happenin query --source cursor --event subagentStart --format jsonl
+happenin query --session abc123 --format summary
+```
+
+See [docs/USAGE.md](docs/USAGE.md) for all filters.
+
+### `happenin dashboard [--port <port>] [--no-open] [--silent]`
+
+Starts a local HTTP server and opens the dashboard.
+
+- `--port` — port to listen on (default: `8765`).
+- `--no-open` — do not open the browser.
+- `--silent` — alias for `--no-open`; used automatically by `npm start`.
+
+```bash
+happenin dashboard --port 9000 --silent
+```
+
+## Configuration
+
+- `HAPPENIN_DB` — override the SQLite database path. Default: `~/.happenin/happenin.db`.
+- `NO_COLOR` — disable colored help output.
+
+## Privacy
+
+`happenin` stores full hook payloads and transcripts locally. No data is sent over the network except for the CDN-loaded dashboard libraries (htmx, AlpineJS, htmx-ext-sse) when the dashboard is open.
+
+## Development
+
+```bash
+nub install
+nub run build
+```
+
+The same scripts also work with npm:
+
+```bash
+npm install
+npm run build
+```
+
+Before opening a pull request, run the full check suite:
+
+```bash
+npm run build
+npm run typecheck
+npm run format
+npm run lint
+npm run duplicates:ci
+npm run knip:ci
+npm run test:ci
+```
+
+See [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) for details.
+
+## Documentation
+
+### User docs
+
+| Doc                                                | Purpose                          |
+| -------------------------------------------------- | -------------------------------- |
+| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)       | How the pieces fit together.     |
+| [docs/USAGE.md](docs/USAGE.md)                     | Full usage guide.                |
+| [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) | Common problems.                 |
+| [docs/CHANGELOG.md](docs/CHANGELOG.md)             | Release notes.                   |
+| [assets/help.md](assets/help.md)                   | CLI help text shown by `--help`. |
+
+### Agent and LLM docs
+
+| Doc                                                  | Purpose                           |
+| ---------------------------------------------------- | --------------------------------- |
+| [AGENTS.md](AGENTS.md)                               | Agent-facing entry point.         |
+| [CLAUDE.md](CLAUDE.md)                               | Symlink to `AGENTS.md`.           |
+| [llms.txt](llms.txt)                                 | LLM/AI index of docs and sources. |
+| [skills/happenin/SKILL.md](skills/happenin/SKILL.md) | Cross-agent skill instructions.   |
+
+## Agent skill
+
+Install the reusable `happenin` skill for agents that support `SKILL.md` files:
+
+```bash
+npx skills add YogliB/happenin --skill happenin
+```
+
+Then ask the agent to record or inspect agent events. The skill covers `install`, `record`, `import`, `query`, and `dashboard`, plus field extraction and required hook responses.
+
+See [skills/happenin/SKILL.md](skills/happenin/SKILL.md) for the full instructions.
+
+## License
+
+[MIT](LICENSE.md)

package/assets/help.md

@@ -0,0 +1,59 @@
+# happenin
+
+A macOS CLI that records Cursor and Claude Code agent events to a local SQLite database and serves a live browser dashboard.
+
+## Commands
+
+### `happenin install [--cursor] [--claude]`
+
+Backs up and appends `happenin record` hooks to your Cursor and Claude Code configuration files.
+
+- `--cursor` — install Cursor hooks only.
+- `--claude` — install Claude Code hooks only.
+
+By default both are installed. Backups are written to `~/.happenin/backups/`.
+
+### `happenin record <source> [event]`
+
+The hook target. Reads a JSON payload from stdin, writes it to `~/.happenin/happenin.db`, and prints the required non-blocking response for the agent.
+
+- `source` — `cursor` or `claude`.
+- `event` — event name, only required for Claude (Cursor payloads include `hook_event_name`).
+
+This command is normally called by the agent hooks, not directly.
+
+### `happenin import`
+
+Imports existing transcripts:
+
+- Claude Code JSONL from `~/.claude/projects/<project>/<session>.jsonl`.
+- Cursor `prompt_history.json` and `meta.json` from `~/.cursor/chats/<hash>/<session>/`.
+
+`store.db` is skipped because it is encrypted.
+
+### `happenin query [options]`
+
+Query events from the local database and print them as JSON, JSONL, or a summary.
+
+- `--source <source>` — filter by source.
+- `--event <event>` — filter by event name.
+- `--session <id>` — filter by session id (partial match).
+- `--q <text>` — search event payloads.
+- `--since <id>` — events with an id greater than `<id>`.
+- `--limit <n>` — maximum rows to return (default: `100`).
+- `--offset <n>` — skip the first `<n>` rows.
+- `--format <json|jsonl|summary>` — output format (default: `json`).
+- `--db <path>` — database path (default: `HAPPENIN_DB` or `~/.happenin/happenin.db`).
+
+### `happenin dashboard [--port <port>] [--no-open] [--silent]`
+
+Starts a local HTTP server and opens the dashboard in your browser.
+
+- `--port` — port to listen on (default: `8765`).
+- `--no-open` — do not open the browser.
+- `--silent` — alias for `--no-open`; used automatically by `npm start`.
+
+## Configuration
+
+- `HAPPENIN_DB` — override the SQLite database path (default: `~/.happenin/happenin.db`).
+- `NO_COLOR` — disable colored help output.

package/dist/bin.js

@@ -0,0 +1,391 @@
+#!/usr/bin/env node
+import{existsSync as e,mkdirSync as t,readFileSync as n,readdirSync as r,renameSync as i,statSync as a,writeFileSync as o}from"node:fs";import s from"node:process";import c from"node:path";import{homedir as l}from"node:os";import{DatabaseSync as u}from"node:sqlite";import d from"node:http";import{execFile as f}from"node:child_process";const p=[`sessionStart`,`sessionEnd`,`beforeSubmitPrompt`,`preToolUse`,`postToolUse`,`postToolUseFailure`,`subagentStart`,`subagentStop`,`beforeShellExecution`,`afterShellExecution`,`beforeMCPExecution`,`afterMCPExecution`,`beforeReadFile`,`afterFileEdit`,`afterAgentResponse`,`afterAgentThought`,`preCompact`,`stop`],m=`SessionStart.SessionEnd.Setup.UserPromptSubmit.UserPromptExpansion.PreToolUse.PermissionRequest.PermissionDenied.PostToolUse.PostToolUseFailure.PostToolBatch.Notification.MessageDisplay.SubagentStart.SubagentStop.TaskCreated.TaskCompleted.Stop.StopFailure.TeammateIdle.InstructionsLoaded.ConfigChange.CwdChanged.DirectoryAdded.FileChanged.WorktreeCreate.WorktreeRemove.PreCompact.PostCompact.Elicitation.ElicitationResult`.split(`.`),h=new Set([`beforeSubmitPrompt`]),g=new Set([`preToolUse`,`beforeShellExecution`,`beforeMCPExecution`,`beforeReadFile`,`subagentStart`]),_=new Set([`UserPromptSubmit`,`UserPromptExpansion`]),v=new Set([`PreToolUse`,`PermissionRequest`,`SubagentStart`,`SubagentStop`,`TaskCreated`,`TaskCompleted`,`Stop`,`WorktreeCreate`,`WorktreeRemove`]),ee=(e,t)=>{if(e===`cursor`)return h.has(t)?JSON.stringify({continue:!0}):g.has(t)?JSON.stringify({permission:`allow`}):void 0;if(e===`claude`)return _.has(t)?JSON.stringify({continue:!0}):v.has(t)?JSON.stringify({decision:`approve`}):void 0},y=e=>typeof e==`object`&&!!e&&!Array.isArray(e),te=e=>e instanceof Error?e.message:String(e),b=()=>s.env.HOME||l(),ne=()=>{let e=s.argv[1];return e&&c.isAbsolute(e)?e:`happenin`},x=e=>{t(e,{recursive:!0})},S=t=>e(t),C=e=>{let t=n(e,`utf8`);return JSON.parse(t)},w=(e,t)=>{let n=`${e}.${Date.now()}.tmp`;x(c.dirname(e)),o(n,JSON.stringify(t,null,2)+`
+`,`utf8`),i(n,e)},T=(e,t)=>{if(x(t),!S(e))return;let r=c.join(t,`${c.basename(e)}.${Date.now()}.bak`);return o(r,n(e,`utf8`),`utf8`),r},re=e=>{if(!S(e))return{version:1,hooks:{}};let t=C(e);if(!y(t))throw Error(`Invalid JSON object in ${e}`);let n=y(t.hooks)?t.hooks:{};return{...t,version:typeof t.version==`number`?t.version:1,hooks:n}},ie=e=>{if(!S(e))return{hooks:{}};let t=C(e);if(!y(t))throw Error(`Invalid JSON object in ${e}`);let n=y(t.hooks)?t.hooks:{};return{...t,hooks:n}},ae=(e,t,n)=>{e[t]=[...Array.isArray(e[t])?e[t]:[],{command:`${n} record cursor`}]},oe=(e,t,n)=>{e[t]=[...Array.isArray(e[t])?e[t]:[],{matcher:``,hooks:[{type:`command`,command:`${n} record claude ${t}`}]}]},se=e=>{let t=b(),n=c.join(t,`.cursor`,`hooks.json`),r=c.join(t,`.happenin`,`backups`,`cursor`),i=T(n,r),a=re(n);for(let t of p)ae(a.hooks,t,e);return w(n,a),{target:n,backup:i}},ce=e=>{let t=b(),n=c.join(t,`.claude`,`settings.json`),r=c.join(t,`.happenin`,`backups`,`claude`),i=T(n,r),a=ie(n);for(let t of m)oe(a.hooks,t,e);return w(n,a),{target:n,backup:i}},le=e=>{let t=!1,n=!1;for(let r of e)r===`--cursor`&&(t=!0),r===`--claude`&&(n=!0);return!t&&!n&&(t=!0,n=!0),{cursor:t,claude:n}};async function ue(e={}){let{cursor:t=!0,claude:n=!0}=e,r=ne(),i=[];t&&i.push(se(r)),n&&i.push(ce(r));for(let{target:e,backup:t}of i)s.stdout.write(`${e} written
+`),t&&s.stdout.write(`  backup: ${t}\n`)}async function de(e=[]){try{let{cursor:t,claude:n}=le(e);await ue({cursor:t,claude:n})}catch(e){s.stderr.write(`install failed: ${te(e)}\n`),s.exitCode=1}}const fe=[`CREATE INDEX IF NOT EXISTS idx_events_source ON events(source);`,`CREATE INDEX IF NOT EXISTS idx_events_event ON events(event);`,`CREATE INDEX IF NOT EXISTS idx_events_session_id ON events(session_id);`,`CREATE INDEX IF NOT EXISTS idx_events_happened_at ON events(happened_at);`,`CREATE INDEX IF NOT EXISTS idx_events_received_at ON events(received_at);`,`CREATE INDEX IF NOT EXISTS idx_events_source_path ON events(source_path);`];function E(e){let t=e.prepare(`PRAGMA user_version`).get();return Number(t?.user_version??0)}function pe(e){let t=E(e);if(!(t>=1)){if(e.exec(`BEGIN IMMEDIATE;`),t=E(e),t>=1){e.exec(`ROLLBACK;`);return}try{let t=e.prepare(`PRAGMA table_info(events)`).all(),n=new Set(t.map(e=>e.name)),r=t=>{n.has(t)||e.exec(`ALTER TABLE events ADD COLUMN ${t} TEXT;`)};r(`subagent_id`),r(`subagent_type`),r(`transcript_path`),e.exec(`PRAGMA user_version = 1;`),e.exec(`COMMIT;`)}catch(t){try{e.exec(`ROLLBACK;`)}catch{}throw t}}}const me=e=>{e.exec(`PRAGMA busy_timeout = 30000;`);let t=E(e);if(t<1)throw Error(`Database schema must be migrated before backfilling subagent metadata`);if(e.exec(`BEGIN IMMEDIATE;`),t=E(e),t<1){e.exec(`ROLLBACK;`);return}try{e.exec(`
+			UPDATE events
+			SET
+				subagent_id = NULLIF(trim(json_extract(payload, '$.subagent_id')), ''),
+				subagent_type = NULLIF(trim(json_extract(payload, '$.subagent_type')), ''),
+				transcript_path = NULLIF(trim(json_extract(payload, '$.transcript_path')), ''),
+				session_id = COALESCE(
+					NULLIF(trim(json_extract(payload, '$.parent_conversation_id')), ''),
+					NULLIF(trim(json_extract(payload, '$.conversation_id')), ''),
+					NULLIF(trim(session_id), '')
+				)
+			WHERE
+				source = 'cursor'
+				AND event = 'subagentStart'
+				AND json_valid(payload) = 1
+				AND (
+					subagent_id IS NULL
+					OR subagent_type IS NULL
+					OR transcript_path IS NULL
+				);
+		`),e.exec(`COMMIT;`)}catch(t){try{e.exec(`ROLLBACK;`)}catch{}throw t}},D=()=>s.env.HAPPENIN_DB?s.env.HAPPENIN_DB:c.join(l(),`.happenin`,`happenin.db`),O=(e,n=5e3)=>{let r=e??D();t(c.dirname(r),{recursive:!0});let i=new u(r);try{i.exec(`PRAGMA busy_timeout = ${n};`),i.exec(`PRAGMA journal_mode = WAL;`),i.exec(`CREATE TABLE IF NOT EXISTS events (
+	id INTEGER PRIMARY KEY AUTOINCREMENT,
+	source TEXT NOT NULL,
+	client TEXT,
+	event TEXT,
+	session_id TEXT,
+	happened_at TEXT,
+	received_at INTEGER NOT NULL,
+	project_path TEXT,
+	file_path TEXT,
+	tool_name TEXT,
+	payload TEXT NOT NULL,
+	source_path TEXT,
+	subagent_id TEXT,
+	subagent_type TEXT,
+	transcript_path TEXT
+);`),i.exec(`
+			CREATE TABLE IF NOT EXISTS imports (
+				path TEXT PRIMARY KEY,
+				mtime INTEGER NOT NULL,
+				imported_at INTEGER NOT NULL
+			);
+		`),pe(i);for(let e of fe)i.exec(e);return i}catch(e){try{i.close()}catch{}throw e}},k=(e,t)=>{e.prepare(`
+	INSERT INTO events (
+		source,
+		client,
+		event,
+		session_id,
+		happened_at,
+		received_at,
+		project_path,
+		file_path,
+		tool_name,
+		payload,
+		source_path,
+		subagent_id,
+		subagent_type,
+		transcript_path
+	) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+`).run(t.source,t.client??null,t.event??null,t.sessionId??null,t.happenedAt??null,Date.now(),t.projectPath??null,t.filePath??null,t.toolName??null,t.payload,t.sourcePath??null,t.subagentId??null,t.subagentType??null,t.transcriptPath??null)};function A(e){let t=[],n=[];return e.since!==void 0&&(t.push(`id > ?`),n.push(e.since)),e.source!==void 0&&(t.push(`source = ?`),n.push(e.source)),e.event!==void 0&&(t.push(`event = ?`),n.push(e.event)),e.sessionId!==void 0&&e.sessionId!==``&&(t.push(`session_id LIKE ?`),n.push(`%${e.sessionId}%`)),e.q!==void 0&&e.q!==``&&(t.push(`payload LIKE ?`),n.push(`%${e.q}%`)),{clause:t.length>0?`WHERE ${t.join(` AND `)}`:``,params:n}}const j=(e,t)=>{let{clause:n,params:r}=A(t),i=t.limit??100,a=t.offset??0,o=`
+	SELECT
+		id,
+		source,
+		client,
+		event,
+		session_id AS sessionId,
+		happened_at AS happenedAt,
+		received_at AS receivedAt,
+		project_path AS projectPath,
+		file_path AS filePath,
+		tool_name AS toolName,
+		payload,
+		source_path AS sourcePath,
+		subagent_id AS subagentId,
+		subagent_type AS subagentType,
+		transcript_path AS transcriptPath
+	FROM events
+ ${n} ORDER BY id DESC LIMIT ?${a>0?` OFFSET ?`:``}`;return r.push(i),a>0&&r.push(a),e.prepare(o).all(...r)},M=(e,t)=>{let{clause:n,params:r}=A(t),i=`SELECT COUNT(*) AS count FROM events ${n}`,a=e.prepare(i).get(...r);return a?Number(a.count):0},he=(e,t)=>{let{clause:n,params:r}=A(t);return{total:M(e,t),bySource:e.prepare(`SELECT source, COUNT(*) AS count FROM events ${n} GROUP BY source ORDER BY count DESC`).all(...r),byEvent:e.prepare(`SELECT event, COUNT(*) AS count FROM events ${n} GROUP BY event ORDER BY count DESC`).all(...r),bySession:e.prepare(`SELECT session_id AS sessionId, COUNT(*) AS count, MIN(happened_at) AS firstAt, MAX(happened_at) AS lastAt FROM events ${n} GROUP BY session_id ORDER BY count DESC`).all(...r)}},N=e=>{let t=e.prepare(`SELECT id FROM events ORDER BY id DESC LIMIT 1`).get();return t?Number(t.id):0},ge=e=>({sources:[`claude`,`cursor`],events:e.prepare(`SELECT DISTINCT event FROM events WHERE event IS NOT NULL AND event <> '' ORDER BY event`).all().map(e=>e.event)}),P=(e,t,n)=>{e.prepare(`
+		INSERT INTO imports (path, mtime, imported_at)
+		VALUES (?, ?, ?)
+		ON CONFLICT(path) DO UPDATE SET
+			mtime = excluded.mtime,
+			imported_at = excluded.imported_at
+	`).run(t,n,Date.now())},_e=(e,t)=>{let n=e.prepare(`SELECT mtime FROM imports WHERE path = ?`).get(t);return n?Number(n.mtime):void 0};function F(e){if(e==null||typeof e==`object`)return;let t=String(e).trim();return t.length>0?t:void 0}function ve(e){if(typeof e==`number`)return new Date(e).toISOString();if(typeof e==`string`&&e.length>0)return/^\d+$/.test(e)?new Date(Number(e)).toISOString():e}function ye(e){if(typeof e!=`object`||!e)return!1;let t=e,n=t.errcode??0;return t.code===`ERR_SQLITE_ERROR`&&((n&255)==5||(n&255)==6)}function be(e,t,n){if(t.length===0)return;let r;try{r=JSON.parse(t)}catch{return}let i=e[0];if(i!==`cursor`&&i!==`claude`)return;let a;a=i===`cursor`?F(r.hook_event_name):e[1];let o=i===`cursor`&&a===`subagentStart`,s=o?F(r.parent_conversation_id)??F(r.conversation_id)??F(r.sessionId)??F(r.session_id):F(r.sessionId)??F(r.session_id),c=ve(r.happenedAt??r.timestamp??r.happened_at??r.time),l=F(r.projectPath??r.cwd??r.project_path??r.workspaceRoot??r.workspace_path),u=F(r.filePath??r.file_path??r.path),d=F(r.toolName??r.tool_name??r.tool),f=F(r.client)??(i===`cursor`?`cursor`:`claude_code`),p=o?F(r.subagent_id):void 0,m=o?F(r.subagent_type):void 0,h=o?F(r.transcript_path):void 0,g={source:i,client:f,event:a,sessionId:s,happenedAt:c,projectPath:l,filePath:u,toolName:d,payload:t,subagentId:p,subagentType:m,transcriptPath:h},_=ee(i,a??``),v;try{v=O(n,500),k(v,g)}catch(e){if(ye(e))console.warn(`happenin: dropping event due to database lock`,e);else throw e}finally{try{v?.close()}catch{}}return _}async function xe(e){let t=[];for await(let e of s.stdin)t.push(Buffer.isBuffer(e)?e:Buffer.from(e,`utf8`));let n=be(e,Buffer.concat(t).toString(`utf8`).trim());n!==void 0&&s.stdout.write(`${n}\n`)}const I=`claude-transcript`,L=`cursor-transcript`,R=`cursor`,z=e=>{try{return r(e,{withFileTypes:!0})}catch{return[]}},Se=e=>{try{return n(e,`utf8`)}catch{return}},Ce=e=>{try{return Math.floor(a(e).mtimeMs)}catch{return}},B=(e,t)=>{let n=Ce(t);if(n===void 0||_e(e,t)===n)return;let r=Se(t);if(r!==void 0)return{content:r,mtime:n}};function V(e){let t=[];for(let n of z(e)){if(n.isSymbolicLink())continue;let r=c.join(e,n.name);n.isDirectory()?t.push(...V(r)):n.isFile()&&n.name.endsWith(`.jsonl`)&&n.name!==`store.db`&&t.push(r)}return t}function we(e){let t=[];for(let n of z(e)){if(!n.isDirectory()||n.isSymbolicLink())continue;let r=c.join(e,n.name);for(let e of z(r))e.isDirectory()&&!e.isSymbolicLink()&&t.push(c.join(r,e.name))}return t}async function Te(e,t){let n=B(e,t);if(n===void 0)return;let{content:r,mtime:i}=n,a=c.basename(t,`.jsonl`),o=[];for(let e of r.split(/\r?\n/)){if(e.trim().length===0)continue;let t;try{t=JSON.parse(e)}catch{continue}typeof t==`object`&&t&&o.push({obj:t,line:e})}e.prepare(`DELETE FROM events WHERE source = ? AND source_path = ?`).run(I,t);for(let{obj:n,line:r}of o)k(e,{source:I,client:`claude_code`,event:typeof n.type==`string`?n.type:`transcript`,sessionId:typeof n.sessionId==`string`?n.sessionId:a,happenedAt:typeof n.timestamp==`string`?n.timestamp:typeof n.timestamp==`number`?String(n.timestamp):void 0,projectPath:typeof n.cwd==`string`?n.cwd:void 0,payload:r,sourcePath:t});P(e,t,i)}async function Ee(e){let t=c.resolve(l(),`.claude/projects`);for(let n of V(t))await Te(e,n)}async function De(e,t,n){let r=B(e,t);if(r===void 0)return;let{content:i,mtime:a}=r,o=[],s;try{s=JSON.parse(i)}catch{return}Array.isArray(s)&&(o=s),e.prepare(`DELETE FROM events WHERE source = ? AND source_path = ?`).run(L,t);for(let r of o)typeof r==`string`&&k(e,{source:L,client:R,event:`prompt`,sessionId:n,payload:JSON.stringify({prompt:r}),sourcePath:t});P(e,t,a)}async function Oe(e,t,n){let r=B(e,t);if(r===void 0)return;let{content:i,mtime:a}=r;e.prepare(`DELETE FROM events WHERE source = ? AND source_path = ?`).run(L,t),k(e,{source:L,client:R,event:`session_meta`,sessionId:n,payload:i,sourcePath:t}),P(e,t,a)}async function ke(e,t){let n=c.basename(t);await De(e,c.join(t,`prompt_history.json`),n),await Oe(e,c.join(t,`meta.json`),n)}async function Ae(e){let t=c.resolve(l(),`.cursor/chats`);for(let n of we(t))await ke(e,n)}async function H(e){let t=O(D());try{me(t),await je(t)}finally{t.close()}}async function je(e){await Ee(e),await Ae(e)}function Me(e){if(e)try{return JSON.parse(e)}catch{return}}function U(e){return{id:e.id,source:e.source,client:e.client,event:e.event,sessionId:e.sessionId,happenedAt:e.happenedAt,receivedAt:e.receivedAt,projectPath:e.projectPath,filePath:e.filePath,toolName:e.toolName,sourcePath:e.sourcePath,subagentId:e.subagentId,subagentType:e.subagentType,transcriptPath:e.transcriptPath,payload:Me(e.payload??``)??e.payload}}let W;const G=new Set;function K(e){return e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`).replace(/'/g,`&#39;`)}function q(e){return e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`)}function J(e,t=30){return e.length<=t?e:`${e.slice(0,t-1)}…`}function Ne(e,t){let n=t?.includeSession??!0,r=U(e),i=q(JSON.stringify({event:r})),a=e.happenedAt?String(e.happenedAt):new Date(Number(e.receivedAt??0)).toISOString(),o=[];return n&&e.sessionId&&o.push(`session:${K(String(e.sessionId))}`),e.toolName&&o.push(`tool:${K(String(e.toolName))}`),e.filePath&&o.push(`file:${K(String(e.filePath))}`),e.subagentType&&o.push(`subagent:${K(J(e.subagentType))}`),e.transcriptPath&&o.push(`transcript:${K(J(c.basename(e.transcriptPath)))}`),`<div class="event-row" x-data="${i}" @click="detail = event"><span class="id">#${K(String(e.id))}</span> <span class="source">${K(String(e.source??``))}</span> <span class="event">${K(String(e.event??``))}</span> <span class="meta">${o.join(` `)}</span> <span class="when">${K(a)}</span></div>`}function Pe(e){let t=[],n=new Map;for(let r of e){let e=r.sessionId??void 0,i=n.get(e);i?i.push(r):(t.push(e),n.set(e,[r]))}return t.map(e=>({sessionId:e,rows:n.get(e)}))}function Fe(e,t){let n=e?K(String(e)):`no session`,r=t.length;return`<details class="session-group" data-session="${q(String(e??``))}" open><summary class="session-header"><span class="session-title">${n}</span><span class="session-count">${r}</span></summary><div class="session-events">${t.map(e=>Ne(e,{includeSession:!1})).join(``)}</div></details>`}function Y(e){let t=e.searchParams.get(`since`),n=e.searchParams.get(`source`)||void 0,r=e.searchParams.get(`event`)||void 0,i=e.searchParams.get(`session`)||void 0,a=e.searchParams.get(`q`)||void 0,o=e.searchParams.get(`page`),s;if(t){let e=parseInt(t,10);Number.isNaN(e)||(s=e)}let c=1;if(o){let e=parseInt(o,10);!Number.isNaN(e)&&e>0&&(c=e)}let l=(c-1)*50;return{since:s,source:n,event:r,sessionId:i,q:a,limit:50,offset:l,page:c}}function Ie(e,t){let n=new URLSearchParams;return e.since&&n.set(`since`,String(e.since)),e.source&&n.set(`source`,e.source),e.event&&n.set(`event`,e.event),e.sessionId&&n.set(`session`,e.sessionId),e.q&&n.set(`q`,e.q),t!==void 0&&t>1&&n.set(`page`,String(t)),n}function X(e,t){let n=Ie(e,t);return n.size>0?`/fragments/events?${n.toString()}`:`/fragments/events`}function Le(e,t,n){let{page:r,offset:i}=e,a=r>1,o=t>i+n.length,s=a?X(e,r-1):``,c=o?X(e,r+1):``,l=a?`hx-get="${q(s)}" `:``,u=o?`hx-get="${q(c)}" `:``;return`<div id="feed-pager" hx-swap-oob="true" hx-target="#feed-items" hx-swap="innerHTML"><div class="pager"><button type="button" ${l}${a?``:`disabled `}>Prev</button><span class="page-number">${r}</span><button type="button" ${u}${o?``:`disabled `}>Next</button></div></div>`}function Re(e){e.writeHead(200,{"Content-Type":`text/html; charset=utf-8`}),e.end(Ue(ge(W)))}function ze(e,t,n){let r=Y(n),i=j(W,r),a=M(W,r),o=Pe(i),s=o.length?o.map(e=>Fe(e.sessionId,e.rows)).join(``):`<p class="empty">No events found.</p>`,c=Le(r,a,i);t.writeHead(200,{"Content-Type":`text/html; charset=utf-8`}),t.end(`${s}${c}`)}function Be(e,t,n){let r=Y(n),i=j(W,r);t.writeHead(200,{"Content-Type":`application/json`}),t.end(JSON.stringify(i))}function Ve(e,t){t.writeHead(200,{"Content-Type":`text/event-stream`,"Cache-Control":`no-cache`,Connection:`keep-alive`}),t.setTimeout(0),t.write(`retry: 500
+
+`);let n=e.headers[`last-event-id`],r=Array.isArray(n)?n[0]:n,i=r?parseInt(r,10):NaN,a={res:t,lastId:Number.isNaN(i)?N(W)??0:i,timer:null};a.timer=setInterval(()=>{try{let e=N(W);e>a.lastId&&(t.write(`event: message
+data: ping
+
+`),a.lastId=e)}catch(e){console.error(`SSE poll error:`,e),clearInterval(a.timer),G.delete(a)}},300),G.add(a),e.on(`close`,()=>{clearInterval(a.timer),G.delete(a)})}function He(e,t){let n=new URL(e.url??`/`,`http://localhost`);try{if(e.method===`GET`){if(n.pathname===`/`){Re(t);return}if(n.pathname===`/fragments/events`){ze(e,t,n);return}if(n.pathname===`/events`){Be(e,t,n);return}if(n.pathname===`/events/stream`){Ve(e,t);return}}t.writeHead(404,{"Content-Type":`text/plain`}),t.end(`Not found`)}catch(e){console.error(`Dashboard request error:`,e),t.headersSent||(t.writeHead(500,{"Content-Type":`text/plain`}),t.end(`Internal server error`))}}function Z(e){return`<option value="" selected>all</option>${e.map(e=>`<option value="${q(e)}">${K(e)}</option>`).join(``)}`}function Ue(e={sources:[],events:[]}){return`<!DOCTYPE html>
+<html lang="en" hx-ext="sse">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>happenin</title>
+<script>
+(function () {
+	const THEME_KEY = 'happenin-theme';
+	const FILTER_KEY = 'happenin-filters';
+	const DARK_MQL = window.matchMedia('(prefers-color-scheme: dark)');
+
+	function getItem(key) {
+		try {
+			return localStorage.getItem(key);
+		} catch {
+			return null;
+		}
+	}
+
+	function setItem(key, value) {
+		try {
+			localStorage.setItem(key, value);
+		} catch {}
+	}
+
+	function getSystemTheme() {
+		return DARK_MQL.matches ? 'dark' : 'light';
+	}
+
+	function getSavedTheme() {
+		const stored = getItem(THEME_KEY);
+		return stored === 'light' || stored === 'dark' ? stored : null;
+	}
+
+	function getTheme() {
+		return getSavedTheme() || getSystemTheme();
+	}
+
+	function applyTheme(theme) {
+		document.documentElement.setAttribute('data-theme', theme);
+	}
+
+	function updateThemeButton(theme) {
+		const button = document.querySelector('[data-theme-toggle]');
+		if (button) button.textContent = theme === 'dark' ? '🌙' : '☀️';
+	}
+
+	function initTheme() {
+		const theme = getTheme();
+		applyTheme(theme);
+		updateThemeButton(theme);
+
+		DARK_MQL.addEventListener('change', () => {
+			if (!getSavedTheme()) {
+				const next = getSystemTheme();
+				applyTheme(next);
+				updateThemeButton(next);
+			}
+		});
+
+		const button = document.querySelector('[data-theme-toggle]');
+		if (button) {
+			button.addEventListener('click', () => {
+				const current = document.documentElement.getAttribute('data-theme') === 'dark' ? 'dark' : 'light';
+				const next = current === 'dark' ? 'light' : 'dark';
+				setItem(THEME_KEY, next);
+				applyTheme(next);
+				updateThemeButton(next);
+			});
+		}
+	}
+
+	function loadFilters() {
+		const raw = getItem(FILTER_KEY);
+		if (!raw) return;
+		try {
+			const values = JSON.parse(raw);
+			const form = document.querySelector('[data-filter-form]');
+			if (!form) return;
+			for (const [name, value] of Object.entries(values)) {
+				const field = form.elements[name];
+				if (field && value != null && value !== '') {
+					field.value = String(value);
+				}
+			}
+		} catch {}
+	}
+
+	function getCurrentPage() {
+		const el = document.querySelector('#feed-pager .page-number');
+		const n = el ? Number(el.textContent) : 1;
+		return Number.isNaN(n) || n < 1 ? 1 : n;
+	}
+
+	function updateFeedUrl() {
+		const form = document.querySelector('[data-filter-form]');
+		const feed = document.getElementById('feed-items');
+		if (!form || !feed) return;
+		const data = new FormData(form);
+		const params = new URLSearchParams();
+		for (const [key, value] of data.entries()) {
+			if (value) params.set(key, String(value));
+		}
+		params.set('page', String(getCurrentPage()));
+		feed.setAttribute('hx-get', '/fragments/events' + (params.size > 0 ? '?' + params.toString() : ''));
+	}
+
+	function saveFilters(form) {
+		const data = new FormData(form);
+		const filters = {};
+		for (const [key, value] of data.entries()) {
+			if (value) filters[key] = String(value);
+		}
+		setItem(FILTER_KEY, JSON.stringify(filters));
+	}
+
+	function initFilters() {
+		const form = document.querySelector('[data-filter-form]');
+		if (!form) return;
+		loadFilters();
+		form.addEventListener('change', () => saveFilters(form));
+		form.addEventListener('input', (event) => {
+			if (event.target.classList.contains('search')) saveFilters(form);
+		});
+		updateFeedUrl();
+	}
+
+	const openSessions = new Map();
+
+	function saveSessionState() {
+		const feed = document.getElementById('feed-items');
+		if (!feed) return;
+		for (const details of feed.querySelectorAll('.session-group')) {
+			openSessions.set(details.getAttribute('data-session') ?? '', details.hasAttribute('open'));
+		}
+	}
+
+	function restoreSessionState() {
+		const feed = document.getElementById('feed-items');
+		if (!feed) return;
+		for (const details of feed.querySelectorAll('.session-group')) {
+			const session = details.getAttribute('data-session') ?? '';
+			if (openSessions.has(session) && !openSessions.get(session)) {
+				details.removeAttribute('open');
+			}
+		}
+	}
+
+	function initFeedItems() {
+		const el = document.getElementById('feed-items');
+		if (el && window.Alpine) Alpine.initTree(el);
+	}
+
+	document.addEventListener('htmx:beforeSwap', (event) => {
+		if (event.detail.target.id === 'feed-items') saveSessionState();
+	});
+
+	document.addEventListener('htmx:afterSettle', (event) => {
+		if (event.detail.target.id === 'feed-items') restoreSessionState();
+		updateFeedUrl();
+		initFeedItems();
+	});
+
+	document.addEventListener('alpine:initialized', initFeedItems);
+
+	applyTheme(getTheme());
+
+	if (document.readyState === 'loading') {
+		document.addEventListener('DOMContentLoaded', initTheme);
+		document.addEventListener('DOMContentLoaded', initFilters);
+	} else {
+		initTheme();
+		initFilters();
+	}
+})();
+<\/script>
+<style>
+:root {
+	color-scheme: dark;
+	--bg: #0d0d0f;
+	--surface: #111216;
+	--surface-2: #14161b;
+	--surface-3: #16181d;
+	--surface-4: #1c1f26;
+	--surface-5: #252830;
+	--border: #23262d;
+	--border-2: #24282f;
+	--text: #e6e6e6;
+	--text-2: #9aa3b2;
+	--text-3: #9ca3af;
+	--text-4: #6b7280;
+	--accent: #60a5fa;
+	--accent-2: #c084fc;
+}
+[data-theme="light"] {
+	color-scheme: light;
+	--bg: #ffffff;
+	--surface: #f9fafb;
+	--surface-2: #f3f4f6;
+	--surface-3: #ffffff;
+	--surface-4: #f3f4f6;
+	--surface-5: #e5e7eb;
+	--border: #e5e7eb;
+	--border-2: #d1d5db;
+	--text: #111827;
+	--text-2: #6b7280;
+	--text-3: #6b7280;
+	--text-4: #9ca3af;
+	--accent: #2563eb;
+	--accent-2: #7c3aed;
+}
+* { box-sizing: border-box; }
+body { font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: var(--bg); color: var(--text); margin: 0; padding: 1rem; line-height: 1.4; }
+.app-header { display: flex; justify-content: space-between; align-items: center; gap: 1rem; margin-bottom: 0.75rem; flex-wrap: wrap; }
+h1 { margin: 0; font-size: 1.25rem; }
+.theme { display: inline-flex; align-items: center; justify-content: center; font-size: 1.1rem; padding: 0.35rem 0.5rem; }
+.layout { display: grid; grid-template-columns: minmax(0, 1fr) 22rem; gap: 1rem; }
+form { display: flex; flex-wrap: wrap; gap: 0.5rem; margin-bottom: 1rem; align-items: end; }
+label { display: flex; flex-direction: column; font-size: 0.75rem; gap: 0.2rem; color: var(--text-2); }
+input, select, button { background: var(--surface-2); color: var(--text); border: 1px solid var(--border); border-radius: 0.35rem; padding: 0.4rem 0.6rem; font-size: 0.85rem; }
+button { cursor: pointer; background: var(--surface-4); }
+button:hover { background: var(--surface-5); }
+#feed { background: var(--surface); border: 1px solid var(--border); border-radius: 0.5rem; min-height: 4rem; overflow: hidden; }
+#feed-items { display: flex; flex-direction: column; gap: 0.25rem; padding: 0.5rem; }
+.event-row { display: flex; gap: 0.5rem; align-items: baseline; flex-wrap: wrap; padding: 0.5rem 0.6rem; border-radius: 0.35rem; background: var(--surface-3); border: 1px solid var(--border-2); cursor: pointer; }
+.event-row:hover { background: var(--surface-4); }
+.event-row .id { color: var(--text-4); font-size: 0.7rem; min-width: 2.5rem; }
+.event-row .source { color: var(--accent); font-weight: 600; }
+.event-row .event { color: var(--accent-2); }
+.event-row .meta { color: var(--text-3); font-size: 0.75rem; }
+.event-row .when { color: var(--text-4); font-size: 0.7rem; margin-left: auto; }
+.session-group { margin-bottom: 0.75rem; border: 1px solid var(--border); border-radius: 0.5rem; overflow: hidden; }
+.session-group:last-child { margin-bottom: 0; }
+.session-header { display: flex; align-items: baseline; gap: 0.5rem; padding: 0.4rem 0.6rem; background: var(--surface-4); border-bottom: 1px solid var(--border); font-size: 0.85rem; }
+.session-header .session-title { font-weight: 600; color: var(--accent); word-break: break-all; }
+.session-header .session-count { color: var(--text-4); font-size: 0.75rem; }
+.session-events { display: flex; flex-direction: column; gap: 0.25rem; padding: 0.5rem; background: var(--surface); }
+.session-events .event-row { background: var(--surface-3); border: 1px solid var(--border-2); }
+details.session-group > summary { list-style: none; cursor: pointer; }
+details.session-group > summary::-webkit-details-marker { display: none; }
+details.session-group > summary::before { content: "+"; color: var(--text-4); margin-right: 0.5rem; font-size: 0.85rem; }
+details[open].session-group > summary::before { content: "−"; }
+.detail { background: var(--surface); border: 1px solid var(--border); border-radius: 0.5rem; padding: 0.75rem; position: sticky; top: 1rem; height: fit-content; }
+.detail pre { white-space: pre-wrap; overflow-x: auto; background: var(--bg); padding: 0.75rem; border-radius: 0.35rem; border: 1px solid var(--border); font-size: 0.8rem; line-height: 1.3; }
+.detail .actions { display: flex; gap: 0.5rem; margin-bottom: 0.5rem; }
+.empty { color: var(--text-4); padding: 1rem; text-align: center; }
+#feed-pager { padding: 0.5rem; border-top: 1px solid var(--border); }
+.pager { display: flex; justify-content: center; align-items: center; gap: 0.75rem; }
+.pager button { min-width: 4rem; }
+.pager button:disabled { opacity: 0.4; cursor: not-allowed; }
+.pager .page-number { color: var(--text-3); font-size: 0.85rem; }
+@media (max-width: 720px) { .layout { grid-template-columns: 1fr; } .detail { position: static; } }
+</style>
+<script src="https://unpkg.com/htmx.org@2.0.10/dist/htmx.min.js"><\/script>
+<script src="https://unpkg.com/htmx-ext-sse@2.2.4/dist/sse.js"><\/script>
+<script defer src="https://unpkg.com/alpinejs@3.14.8/dist/cdn.min.js"><\/script>
+</head>
+<body>
+<div class="app-header">
+	<h1>happenin</h1>
+	<button type="button" class="theme" data-theme-toggle aria-label="toggle theme">🌙</button>
+</div>
+<form data-filter-form hx-get="/fragments/events" hx-target="#feed-items" hx-swap="innerHTML" hx-trigger="change, input changed delay:300ms from:.search">
+	<label>source <select name="source">${Z(e.sources)}</select></label>
+	<label>event <select name="event">${Z(e.events)}</select></label>
+	<label>session <input type="text" name="session" class="search" placeholder="session"></label>
+	<label>q <input type="text" name="q" class="search" placeholder="search"></label>
+</form>
+<div class="layout" x-data="{ detail: null }">
+	<div id="feed" sse-connect="/events/stream">
+		<div id="feed-items" hx-get="/fragments/events?page=1" hx-trigger="load, sse:message" hx-target="#feed-items" hx-swap="innerHTML"></div>
+		<div id="feed-pager" hx-target="#feed-items" hx-swap="innerHTML"></div>
+	</div>
+	<aside class="detail" x-show="detail">
+		<div class="actions">
+			<button @click="navigator.clipboard.writeText(JSON.stringify(detail, null, 2))">Copy JSON</button>
+			<button @click="detail = null">Close</button>
+		</div>
+		<pre x-text="JSON.stringify(detail, null, 2)"></pre>
+	</aside>
+</div>
+</body>
+</html>`}async function We(e,t){let n=d.createServer((e,t)=>{He(e,t)});await new Promise((r,i)=>{let a=e=>{function o(t){n.off(`error`,o),n.off(`listening`,c),t.code===`EADDRINUSE`&&e<65535?a(e+1):i(t)}function c(){n.off(`error`,o);let i=`http://localhost:${e}`;console.log(`Dashboard: ${i}`),t&&s.platform===`darwin`&&f(`open`,[i],e=>{e&&console.error(`open failed:`,e.message)}),r()}n.once(`error`,o),n.once(`listening`,c),n.listen(e)};a(e)})}async function Ge(e){let t=8765,n=!0,r=!1;for(let i of e){if(r){let e=parseInt(i,10);(Number.isNaN(e)||e<1||e>65535)&&(console.error(`Invalid --port`),s.exit(1)),t=e,r=!1;continue}if(i===`--port`){r=!0;continue}if(i.startsWith(`--port=`)){let e=parseInt(i.slice(7),10);(Number.isNaN(e)||e<1||e>65535)&&(console.error(`Invalid --port`),s.exit(1)),t=e}else(i===`--no-open`||i===`--silent`)&&(n=!1)}r&&(console.error(`Missing value for --port`),s.exit(1)),await H(),W=O(D()),await We(t,n)}const Q=[`json`,`jsonl`,`summary`];function $(e){let t=Number(e);return Number.isNaN(t)?void 0:t}function Ke(){s.stdout.write(`Usage: happenin query [options]
+
+Options:
+  --source <source>    filter by source (cursor, claude, ...)
+  --event <event>      filter by event name
+  --session <id>       filter by session id (partial match)
+  --q <text>           search event payloads
+  --since <id>         events with id greater than <id>
+  --limit <n>          maximum rows to return (default: 100)
+  --offset <n>         skip first <n> rows
+  --format <format>    output format: json (default), jsonl, summary
+  --db <path>          database path (default: HAPPENIN_DB or ~/.happenin/happenin.db)
+  -h, --help           show this help
+`)}function qe(e){let t={},n=`json`,r,i;for(let a of e){if(i){switch(i){case`source`:t.source=a;break;case`event`:t.event=a;break;case`session`:t.sessionId=a;break;case`q`:t.q=a;break;case`since`:{let e=$(a);e!==void 0&&(t.since=e);break}case`limit`:{let e=$(a);e!==void 0&&(t.limit=e);break}case`offset`:{let e=$(a);e!==void 0&&(t.offset=e);break}case`format`:Q.includes(a)&&(n=a);break;case`db`:r=a;break}i=void 0;continue}if((a===`-h`||a===`--help`)&&(Ke(),s.exit(0)),a===`--source`||a===`--event`||a===`--session`||a===`--q`||a===`--since`||a===`--limit`||a===`--offset`||a===`--format`||a===`--db`){i=a.slice(2);continue}if(a.startsWith(`--`)){let e=a.indexOf(`=`);if(e!==-1){let i=a.slice(2,e),o=a.slice(e+1);switch(i){case`source`:t.source=o;break;case`event`:t.event=o;break;case`session`:t.sessionId=o;break;case`q`:t.q=o;break;case`since`:{let e=$(o);e!==void 0&&(t.since=e);break}case`limit`:{let e=$(o);e!==void 0&&(t.limit=e);break}case`offset`:{let e=$(o);e!==void 0&&(t.offset=e);break}case`format`:Q.includes(o)&&(n=o);break;case`db`:r=o;break}}}}return{options:t,format:n,dbPath:r}}async function Je(e){let{options:t,format:n,dbPath:r}=qe(e),i=O(r);try{if(n===`summary`){let e=he(i,t);s.stdout.write(`${JSON.stringify(e,null,2)}\n`);return}let e={total:M(i,t),rows:j(i,t).map(U)};if(n===`jsonl`)for(let t of e.rows)s.stdout.write(`${JSON.stringify(t)}\n`);else s.stdout.write(`${JSON.stringify(e,null,2)}\n`)}finally{i.close()}}const Ye=new URL(`../assets/help.md`,import.meta.url),Xe=new URL(`../package.json`,import.meta.url);function Ze(e){let t=!!s.stdout.isTTY&&!s.env.NO_COLOR,n=t?`\x1B[1m`:``,r=t?`\x1B[2m`:``,i=t?`\x1B[36m`:``,a=t?`\x1B[0m`:``;return e.replace(/^# (.+)$/gm,`${n}$1${a}`).replace(/^## (.+)$/gm,`${n}$1${a}`).replace(/^### `(.+)`$/gm,`${n}$1${a}`).replace(/^### (.+)$/gm,`${n}$1${a}`).replace(/^#### (.+)$/gm,`${r}$1${a}`).replace(/^- /gm,`  • `).replace(/`([^`]+)`/g,`${i}$1${a}`)}function Qe(){let e;try{e=n(Ye,`utf8`)}catch{e=`# happenin
+
+Run \`happenin <command>\`.
+`}s.stdout.write(`\n${Ze(e)}\n`)}function $e(){let e=`0.0.0`;try{let t=n(Xe,`utf8`);e=JSON.parse(t).version??e}catch{}s.stdout.write(`${e}\n`)}async function et(){let[e,...t]=s.argv.slice(2);if(!e||e===`--help`||e===`-h`){Qe();return}if(e===`--version`||e===`-v`){$e();return}if(e===`install`){await de(t);return}if(e===`record`){await xe(t);return}if(e===`import`){await H(t);return}if(e===`dashboard`){await Ge(t);return}if(e===`query`){await Je(t);return}s.stderr.write(`Unknown command: ${e}\n`),Qe(),s.exitCode=1}et();export{};

package/package.json

@@ -0,0 +1,74 @@
+{
+	"name": "happenin",
+	"version": "0.0.1",
+	"description": "A macOS CLI that records Cursor and Claude Code agent events to a local SQLite database and serves a live browser dashboard.",
+	"keywords": [
+		"agents",
+		"ai-agents",
+		"claude",
+		"claude-code",
+		"cli",
+		"cursor",
+		"dashboard",
+		"logging",
+		"macos",
+		"sqlite"
+	],
+	"homepage": "https://github.com/YogliB/happenin#readme",
+	"bugs": {
+		"url": "https://github.com/YogliB/happenin/issues"
+	},
+	"license": "MIT",
+	"author": "YogliB",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/YogliB/happenin.git"
+	},
+	"bin": {
+		"happenin": "dist/bin.js"
+	},
+	"files": [
+		"assets",
+		"dist",
+		"LICENSE.md",
+		"README.md"
+	],
+	"type": "module",
+	"scripts": {
+		"build": "tsdown --config tsdown.config.ts",
+		"dev": "tsdown --config tsdown.config.ts --watch",
+		"start": "node scripts/dev-server.js dashboard",
+		"typecheck": "tsc --noEmit",
+		"lint": "oxlint --fix src",
+		"lint:ci": "oxlint src",
+		"format": "oxfmt --write .",
+		"format:ci": "oxfmt --check .",
+		"duplicates:ci": "jscpd --threshold 5 src",
+		"knip:ci": "knip",
+		"test": "vitest run",
+		"test:ci": "vitest run --coverage",
+		"prepare": "husky",
+		"prepublishOnly": "npm run build"
+	},
+	"devDependencies": {
+		"@types/node": "24",
+		"@vitest/coverage-v8": "^4.1.10",
+		"eslint-plugin-security": "4.0.1",
+		"husky": "9.1.7",
+		"jscpd": "4.0.9",
+		"knip": "6.11.0",
+		"lint-staged": "17.1.1",
+		"oxfmt": "0.61.0",
+		"oxlint": "1.76.0",
+		"tsdown": "0.22.14",
+		"typescript": "7.0.2",
+		"vitest": "^4.1.10"
+	},
+	"lint-staged": {
+		"**/*": "oxfmt --write --no-error-on-unmatched-pattern",
+		"**/*.ts": "oxlint --fix"
+	},
+	"engines": {
+		"node": ">=24.0.0"
+	}
+}