brooklet 0.1.0__tar.gz

brooklet-0.1.0/.beads/.gitignore

@@ -0,0 +1,49 @@
+# Dolt database (managed by Dolt, not git)
+dolt/
+dolt-access.lock
+
+# Runtime files
+bd.sock
+bd.sock.startlock
+sync-state.json
+last-touched
+
+# Local version tracking (prevents upgrade notification spam after git ops)
+.local_version
+
+# Worktree redirect file (contains relative path to main repo's .beads/)
+# Must not be committed as paths would be wrong in other clones
+redirect
+
+# Sync state (local-only, per-machine)
+# These files are machine-specific and should not be shared across clones
+.sync.lock
+export-state/
+
+# Ephemeral store (SQLite - wisps/molecules, intentionally not versioned)
+ephemeral.sqlite3
+ephemeral.sqlite3-journal
+ephemeral.sqlite3-wal
+ephemeral.sqlite3-shm
+
+# Dolt server management (auto-started by bd)
+dolt-server.pid
+dolt-server.log
+dolt-server.lock
+
+# Legacy files (from pre-Dolt versions)
+*.db
+*.db?*
+*.db-journal
+*.db-wal
+*.db-shm
+db.sqlite
+bd.db
+daemon.lock
+daemon.log
+daemon-*.log.gz
+daemon.pid
+# NOTE: Do NOT add negation patterns here.
+# They would override fork protection in .git/info/exclude.
+# Config files (metadata.json, config.yaml) are tracked by git by default
+# since no pattern above ignores them.

brooklet-0.1.0/.beads/README.md

@@ -0,0 +1,81 @@
+# Beads - AI-Native Issue Tracking
+
+Welcome to Beads! This repository uses **Beads** for issue tracking - a modern, AI-native tool designed to live directly in your codebase alongside your code.
+
+## What is Beads?
+
+Beads is issue tracking that lives in your repo, making it perfect for AI coding agents and developers who want their issues close to their code. No web UI required - everything works through the CLI and integrates seamlessly with git.
+
+**Learn more:** [github.com/steveyegge/beads](https://github.com/steveyegge/beads)
+
+## Quick Start
+
+### Essential Commands
+
+```bash
+# Create new issues
+bd create "Add user authentication"
+
+# View all issues
+bd list
+
+# View issue details
+bd show <issue-id>
+
+# Update issue status
+bd update <issue-id> --claim
+bd update <issue-id> --status done
+
+# Sync with Dolt remote
+bd dolt push
+```
+
+### Working with Issues
+
+Issues in Beads are:
+- **Git-native**: Stored in `.beads/issues.jsonl` and synced like code
+- **AI-friendly**: CLI-first design works perfectly with AI coding agents
+- **Branch-aware**: Issues can follow your branch workflow
+- **Always in sync**: Auto-syncs with your commits
+
+## Why Beads?
+
+✨ **AI-Native Design**
+- Built specifically for AI-assisted development workflows
+- CLI-first interface works seamlessly with AI coding agents
+- No context switching to web UIs
+
+🚀 **Developer Focused**
+- Issues live in your repo, right next to your code
+- Works offline, syncs when you push
+- Fast, lightweight, and stays out of your way
+
+🔧 **Git Integration**
+- Automatic sync with git commits
+- Branch-aware issue tracking
+- Intelligent JSONL merge resolution
+
+## Get Started with Beads
+
+Try Beads in your own projects:
+
+```bash
+# Install Beads
+curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
+
+# Initialize in your repo
+bd init
+
+# Create your first issue
+bd create "Try out Beads"
+```
+
+## Learn More
+
+- **Documentation**: [github.com/steveyegge/beads/docs](https://github.com/steveyegge/beads/tree/main/docs)
+- **Quick Start Guide**: Run `bd quickstart`
+- **Examples**: [github.com/steveyegge/beads/examples](https://github.com/steveyegge/beads/tree/main/examples)
+
+---
+
+*Beads: Issue tracking that moves at the speed of thought* ⚡

brooklet-0.1.0/.beads/backup/backup_state.json

@@ -0,0 +1,13 @@
+{
+  "last_dolt_commit": "v15tq1j1hfei89ikmihtn40r162pl7c9",
+  "last_event_id": 0,
+  "timestamp": "2026-03-22T23:50:18.895382Z",
+  "counts": {
+    "issues": 8,
+    "events": 12,
+    "comments": 0,
+    "dependencies": 5,
+    "labels": 0,
+    "config": 11
+  }
+}

brooklet-0.1.0/.beads/backup/config.jsonl

@@ -0,0 +1,11 @@
+{"key":"auto_compact_enabled","value":"false"}
+{"key":"compact_batch_size","value":"50"}
+{"key":"compact_parallel_workers","value":"5"}
+{"key":"compact_tier1_days","value":"30"}
+{"key":"compact_tier1_dep_levels","value":"2"}
+{"key":"compact_tier2_commits","value":"100"}
+{"key":"compact_tier2_days","value":"90"}
+{"key":"compact_tier2_dep_levels","value":"5"}
+{"key":"compaction_enabled","value":"false"}
+{"key":"issue_prefix","value":"brooklet"}
+{"key":"schema_version","value":"6"}

brooklet-0.1.0/.beads/backup/dependencies.jsonl

@@ -0,0 +1,5 @@
+{"created_at":"2026-03-22T14:05:02Z","created_by":"Joshua Oliphant","depends_on_id":"brooklet-cnu","issue_id":"brooklet-0gb","type":"blocks"}
+{"created_at":"2026-03-22T14:05:02Z","created_by":"Joshua Oliphant","depends_on_id":"brooklet-cnu","issue_id":"brooklet-cfq","type":"blocks"}
+{"created_at":"2026-03-22T14:05:02Z","created_by":"Joshua Oliphant","depends_on_id":"brooklet-d23","issue_id":"brooklet-cnu","type":"blocks"}
+{"created_at":"2026-03-22T14:05:02Z","created_by":"Joshua Oliphant","depends_on_id":"brooklet-cnu","issue_id":"brooklet-cs0","type":"blocks"}
+{"created_at":"2026-03-22T14:05:02Z","created_by":"Joshua Oliphant","depends_on_id":"brooklet-d23","issue_id":"brooklet-yh5","type":"blocks"}

brooklet-0.1.0/.beads/backup/events.jsonl

@@ -0,0 +1,12 @@
+{"actor":"Joshua Oliphant","comment":null,"created_at":"2026-03-15T07:13:12Z","event_type":"created","id":1,"issue_id":"brooklet-a3m","new_value":"","old_value":""}
+{"actor":"Joshua Oliphant","comment":null,"created_at":"2026-03-15T07:13:15Z","event_type":"created","id":2,"issue_id":"brooklet-1mw","new_value":"","old_value":""}
+{"actor":"Joshua Oliphant","comment":null,"created_at":"2026-03-22T14:04:49Z","event_type":"created","id":3,"issue_id":"brooklet-d23","new_value":"","old_value":""}
+{"actor":"Joshua Oliphant","comment":null,"created_at":"2026-03-22T14:04:51Z","event_type":"created","id":4,"issue_id":"brooklet-cnu","new_value":"","old_value":""}
+{"actor":"Joshua Oliphant","comment":null,"created_at":"2026-03-22T14:04:52Z","event_type":"created","id":5,"issue_id":"brooklet-cs0","new_value":"","old_value":""}
+{"actor":"Joshua Oliphant","comment":null,"created_at":"2026-03-22T14:04:53Z","event_type":"created","id":6,"issue_id":"brooklet-cfq","new_value":"","old_value":""}
+{"actor":"Joshua Oliphant","comment":null,"created_at":"2026-03-22T14:04:55Z","event_type":"created","id":7,"issue_id":"brooklet-0gb","new_value":"","old_value":""}
+{"actor":"Joshua Oliphant","comment":null,"created_at":"2026-03-22T14:04:57Z","event_type":"created","id":8,"issue_id":"brooklet-yh5","new_value":"","old_value":""}
+{"actor":"Joshua Oliphant","comment":null,"created_at":"2026-03-22T15:14:28Z","event_type":"closed","id":9,"issue_id":"brooklet-a3m","new_value":"Fixed and merged to main","old_value":""}
+{"actor":"Joshua Oliphant","comment":null,"created_at":"2026-03-22T15:14:28Z","event_type":"closed","id":10,"issue_id":"brooklet-1mw","new_value":"Fixed and merged to main","old_value":""}
+{"actor":"Joshua Oliphant","comment":null,"created_at":"2026-03-22T15:29:36Z","event_type":"closed","id":11,"issue_id":"brooklet-d23","new_value":"Closed","old_value":""}
+{"actor":"Joshua Oliphant","comment":null,"created_at":"2026-03-22T15:29:36Z","event_type":"closed","id":12,"issue_id":"brooklet-cnu","new_value":"Closed","old_value":""}

brooklet-0.1.0/.beads/backup/issues.jsonl

@@ -0,0 +1,8 @@
+{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"a4706606998f7122c072f4a9c85307daa848c5a01418ccb59bc06e4d22218255","created_at":"2026-03-22T21:04:56Z","created_by":"Joshua Oliphant","crystallizes":0,"defer_until":null,"description":"Aggregation consumer that reads from multiple project pytest topics and produces a combined pytest/portfolio topic with health metrics per project.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"brooklet-0gb","is_template":0,"issue_type":"feature","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"joshua.oliphant@hey.com","payload":"","pinned":0,"priority":4,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"open","target":"","timeout_ns":0,"title":"pytest adapter: cross-project aggregation (AC-9)","updated_at":"2026-03-22T21:04:56Z","waiters":"","wisp_type":"","work_type":""}
+{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Fixed and merged to main","closed_at":"2026-03-22T22:14:29Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"9197d082668987cf50556be198a23f5b568b44c7f6c055afe43c1ba0951296f7","created_at":"2026-03-15T14:13:15Z","created_by":"Joshua Oliphant","crystallizes":0,"defer_until":null,"description":"observer.join() in _iterate_glob_follow(), _iterate_follow(), and close() has no timeout. If the watchdog thread hangs, the application hangs on shutdown with no indication. Add a 5s timeout and log a warning if exceeded.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"brooklet-1mw","is_template":0,"issue_type":"bug","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"joshua.oliphant@hey.com","payload":"","pinned":0,"priority":3,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"closed","target":"","timeout_ns":0,"title":"Add timeout to observer.join() calls to prevent hang on shutdown","updated_at":"2026-03-22T22:14:29Z","waiters":"","wisp_type":"","work_type":""}
+{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Fixed and merged to main","closed_at":"2026-03-22T22:14:29Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"e0c235b2a2f41623c5d3c22f25129b5c05dfc50b394236a205e004fa5a058471","created_at":"2026-03-15T14:13:12Z","created_by":"Joshua Oliphant","crystallizes":0,"defer_until":null,"description":"The offset stores an integer index into a sorted file list. If files are added or removed between sessions, the index points to the wrong file — causing silent re-processing, skipped events, or IndexError. Needs a design decision (DEC-013) about switching to filename-based offset tracking. As a short-term mitigation, add a bounds check with warning log in _catch_up_glob().","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"brooklet-a3m","is_template":0,"issue_type":"bug","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"joshua.oliphant@hey.com","payload":"","pinned":0,"priority":2,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"closed","target":"","timeout_ns":0,"title":"GlobOffset file_index is unstable across sessions with file adds/removes","updated_at":"2026-03-22T22:14:29Z","waiters":"","wisp_type":"","work_type":""}
+{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"d9c19b6de578b58e0f71a66a11bb3aa197bbdc1e5e2b9267c7b7240b0c42a338","created_at":"2026-03-22T21:04:54Z","created_by":"Joshua Oliphant","crystallizes":0,"defer_until":null,"description":"Cross-run analytics consumer that tracks per-test duration over time. Flags tests with \u003e50% duration increase vs baseline (first 3 runs average). Produces pytest/slow-trends topic.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"brooklet-cfq","is_template":0,"issue_type":"feature","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"joshua.oliphant@hey.com","payload":"","pinned":0,"priority":3,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"open","target":"","timeout_ns":0,"title":"pytest adapter: duration trend detection (AC-8)","updated_at":"2026-03-22T21:04:54Z","waiters":"","wisp_type":"","work_type":""}
+{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Closed","closed_at":"2026-03-22T22:29:37Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"c2cd4470eabe50d44cc39e4ebde4a044ae1d95e5559d8564432726c88760cda2","created_at":"2026-03-22T21:04:52Z","created_by":"Joshua Oliphant","crystallizes":0,"defer_until":null,"description":"First analytics consumer for the pytest adapter. Process a test run and produce a summary event to a derived topic: total/passed/failed/skipped/errored, duration, slowest 5 tests, failure details. Follows the scout 3-layer pattern (parse, consume, render).","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"brooklet-cnu","is_template":0,"issue_type":"feature","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"joshua.oliphant@hey.com","payload":"","pinned":0,"priority":2,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"closed","target":"","timeout_ns":0,"title":"pytest adapter: summary stats consumer (AC-6)","updated_at":"2026-03-22T22:29:37Z","waiters":"","wisp_type":"","work_type":""}
+{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"0243f9827d4ca5d2937c615845b013df03167161748f072460c4167d8a982476","created_at":"2026-03-22T21:04:52Z","created_by":"Joshua Oliphant","crystallizes":0,"defer_until":null,"description":"Cross-run analytics consumer that identifies tests alternating between passed/failed. Reports flake rate and produces pytest/flaky topic. Simple heuristic: outcomes_differing_from_majority / total_runs.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"brooklet-cs0","is_template":0,"issue_type":"feature","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"joshua.oliphant@hey.com","payload":"","pinned":0,"priority":3,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"open","target":"","timeout_ns":0,"title":"pytest adapter: flaky test detection (AC-7)","updated_at":"2026-03-22T21:04:52Z","waiters":"","wisp_type":"","work_type":""}
+{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"Closed","closed_at":"2026-03-22T22:29:37Z","closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"3f1b1bce949867624447eda096ac6c00b29d62e322892481acc4df2aa11c05cc","created_at":"2026-03-22T21:04:50Z","created_by":"Joshua Oliphant","crystallizes":0,"defer_until":null,"description":"Part 1 of the pytest adapter. Register pytest-reportlog JSONL as brooklet topics (single-file and glob), filter to test outcomes, incremental consumption, and follow mode. Validates brooklet's three-layer architecture with a non-Claude-Code source.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"brooklet-d23","is_template":0,"issue_type":"feature","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"joshua.oliphant@hey.com","payload":"","pinned":0,"priority":2,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"closed","target":"","timeout_ns":0,"title":"pytest adapter: registration \u0026 consumption (AC-1 through AC-5)","updated_at":"2026-03-22T22:29:37Z","waiters":"","wisp_type":"","work_type":""}
+{"acceptance_criteria":"","actor":"","agent_state":"","assignee":null,"await_id":"","await_type":"","close_reason":"","closed_at":null,"closed_by_session":"","compacted_at":null,"compacted_at_commit":null,"compaction_level":0,"content_hash":"de82f28a7cb1eb35a8f442ca7eb53aa8593762ffad4ad50e424d45e3f167beee","created_at":"2026-03-22T21:04:57Z","created_by":"Joshua Oliphant","crystallizes":0,"defer_until":null,"description":"Rich live terminal dashboard showing real-time test progress (pass/fail/skip counts, current test, progress bar) and historical run comparison view. Follows the scout render_rich pattern.","design":"","due_at":null,"ephemeral":0,"estimated_minutes":null,"event_kind":"","external_ref":null,"hook_bead":"","id":"brooklet-yh5","is_template":0,"issue_type":"feature","last_activity":null,"metadata":"{}","mol_type":"","notes":"","original_size":null,"owner":"joshua.oliphant@hey.com","payload":"","pinned":0,"priority":4,"quality_score":null,"rig":"","role_bead":"","role_type":"","sender":"","source_repo":"","source_system":"","spec_id":"","status":"open","target":"","timeout_ns":0,"title":"pytest adapter: live dashboard (AC-10, AC-11)","updated_at":"2026-03-22T21:04:57Z","waiters":"","wisp_type":"","work_type":""}

brooklet-0.1.0/.beads/config.yaml

@@ -0,0 +1,55 @@
+# Beads Configuration File
+# This file configures default behavior for all bd commands in this repository
+# All settings can also be set via environment variables (BD_* prefix)
+# or overridden with command-line flags
+
+# Issue prefix for this repository (used by bd init)
+# If not set, bd init will auto-detect from directory name
+# Example: issue-prefix: "myproject" creates issues like "myproject-1", "myproject-2", etc.
+# issue-prefix: ""
+
+# Use no-db mode: load from JSONL, write back after each command
+# When true, bd will use .beads/issues.jsonl as the source of truth
+# instead of the Dolt database
+# no-db: false
+
+# Enable JSON output by default
+# json: false
+
+# Feedback title formatting for mutating commands (create/update/close/dep/edit)
+# 0 = hide titles, N > 0 = truncate to N characters
+# output:
+#   title-length: 255
+
+# Default actor for audit trails (overridden by BD_ACTOR or --actor)
+# actor: ""
+
+# Export events (audit trail) to .beads/events.jsonl on each flush/sync
+# When enabled, new events are appended incrementally using a high-water mark.
+# Use 'bd export --events' to trigger manually regardless of this setting.
+# events-export: false
+
+# Multi-repo configuration (experimental - bd-307)
+# Allows hydrating from multiple repositories and routing writes to the correct JSONL
+# repos:
+#   primary: "."  # Primary repo (where this database lives)
+#   additional:   # Additional repos to hydrate from (read-only)
+#     - ~/beads-planning  # Personal planning repo
+#     - ~/work-planning   # Work planning repo
+
+# JSONL backup (periodic export for off-machine recovery)
+# Auto-enabled when a git remote exists. Override explicitly:
+# backup:
+#   enabled: false     # Disable auto-backup entirely
+#   interval: 15m      # Minimum time between auto-exports
+#   git-push: false    # Disable git push (export locally only)
+#   git-repo: ""       # Separate git repo for backups (default: project repo)
+
+# Integration settings (access with 'bd config get/set')
+# These are stored in the database, not in this file:
+# - jira.url
+# - jira.project
+# - linear.url
+# - linear.api-key
+# - github.org
+# - github.repo

brooklet-0.1.0/.beads/dolt-monitor.pid

@@ -0,0 +1 @@
+93692

brooklet-0.1.0/.beads/dolt-server.activity

@@ -0,0 +1 @@
+1774217668

brooklet-0.1.0/.beads/dolt-server.port

@@ -0,0 +1 @@
+14299

brooklet-0.1.0/.beads/hooks/post-checkout

@@ -0,0 +1,9 @@
+#!/usr/bin/env sh
+# --- BEGIN BEADS INTEGRATION v0.57.0 ---
+# This section is managed by beads. Do not remove these markers.
+if command -v bd >/dev/null 2>&1; then
+  export BD_GIT_HOOK=1
+  bd hooks run post-checkout "$@"
+  _bd_exit=$?; if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
+fi
+# --- END BEADS INTEGRATION ---

brooklet-0.1.0/.beads/hooks/post-merge

@@ -0,0 +1,9 @@
+#!/usr/bin/env sh
+# --- BEGIN BEADS INTEGRATION v0.57.0 ---
+# This section is managed by beads. Do not remove these markers.
+if command -v bd >/dev/null 2>&1; then
+  export BD_GIT_HOOK=1
+  bd hooks run post-merge "$@"
+  _bd_exit=$?; if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
+fi
+# --- END BEADS INTEGRATION ---

brooklet-0.1.0/.beads/hooks/pre-commit

@@ -0,0 +1,9 @@
+#!/usr/bin/env sh
+# --- BEGIN BEADS INTEGRATION v0.57.0 ---
+# This section is managed by beads. Do not remove these markers.
+if command -v bd >/dev/null 2>&1; then
+  export BD_GIT_HOOK=1
+  bd hooks run pre-commit "$@"
+  _bd_exit=$?; if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
+fi
+# --- END BEADS INTEGRATION ---

brooklet-0.1.0/.beads/hooks/pre-push

@@ -0,0 +1,9 @@
+#!/usr/bin/env sh
+# --- BEGIN BEADS INTEGRATION v0.57.0 ---
+# This section is managed by beads. Do not remove these markers.
+if command -v bd >/dev/null 2>&1; then
+  export BD_GIT_HOOK=1
+  bd hooks run pre-push "$@"
+  _bd_exit=$?; if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
+fi
+# --- END BEADS INTEGRATION ---

brooklet-0.1.0/.beads/hooks/prepare-commit-msg

@@ -0,0 +1,9 @@
+#!/usr/bin/env sh
+# --- BEGIN BEADS INTEGRATION v0.57.0 ---
+# This section is managed by beads. Do not remove these markers.
+if command -v bd >/dev/null 2>&1; then
+  export BD_GIT_HOOK=1
+  bd hooks run prepare-commit-msg "$@"
+  _bd_exit=$?; if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi
+fi
+# --- END BEADS INTEGRATION ---

brooklet-0.1.0/.beads/metadata.json

@@ -0,0 +1,6 @@
+{
+  "database": "dolt",
+  "backend": "dolt",
+  "dolt_mode": "server",
+  "dolt_database": "brooklet"
+}

brooklet-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+name: publish
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - run: uv python install 3.12
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

brooklet-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,39 @@
+name: tests
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --locked
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Run tests with report logging
+        run: uv run pytest -v --report-log=reports/test-results.jsonl
+
+      - name: Analyze test results with brooklet-pytest
+        run: uv run brooklet-pytest reports/test-results.jsonl
+
+      - name: Produce summaries and run CI health check
+        run: |
+          uv run brooklet-pytest reports/test-results.jsonl --output pytest/summaries
+          uv run python examples/ci_health_check.py reports/

brooklet-0.1.0/.gitignore

@@ -0,0 +1,17 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Dolt database files (added by bd init)
+.dolt/
+*.db
+
+# Runtime logs
+logs/

brooklet-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

brooklet-0.1.0/CLAUDE.md

@@ -0,0 +1,78 @@
+# Brooklet — The SQLite of Event Streaming
+
+Lightweight JSONL-based event streaming library. Adds consumer coordination (offsets, tailing, topic discovery) on top of append-only JSONL files that other tools already produce.
+
+## Architecture
+
+Brooklet is a **consumer coordination layer**, not a message broker. External tools write JSONL; brooklet reads it with offset tracking.
+
+### Core Modules
+- `envelope.py` — Metadata injection (_ts, _seq, _src): `wrap()` on read, `serialize()` on write
+- `offsets.py` — Byte offset persistence per consumer group
+- `registry.py` — Maps topic names to sources; supports external (registered) and local (produced)
+- `consumer.py` — Batch and follow-mode iterators over JSONL files
+- `stream.py` — Orchestrator: `register()`, `produce()`, `consume()`, `topics()`
+- `__init__.py` — Public API: `brooklet.open(path)`
+
+### Contrib Adapters (3-layer pattern: parsing → consumer integration → CLI)
+- `contrib/claude_analytics.py` — Claude Code session analytics (`brooklet-scout`)
+- `contrib/pytest_analytics.py` — pytest-reportlog test run analytics (`brooklet-pytest`)
+
+### Key Decisions
+- `produce()` is in core — consumers that transform and re-emit need a clean write path (DEC-011)
+- Unified topic namespace with auto-registration — `produce()` auto-registers local topics (DEC-012)
+- Source registration maps arbitrary external JSONL paths to topic names (DEC-007)
+- Thin envelope with `_ts`, `_seq`, `_src` auto-injected on both read and write (DEC-004)
+- watchdog for filesystem watching in follow mode (DEC-008)
+- Python 3.12+ minimum (DEC-009)
+- Path-style topic names (`scout/stats`) create nested directories
+- Full design docs at `second_brain/projects/_active/brooklet/`
+
+### Data Layout
+```
+<stream_dir>/
+├── <topic>/
+│   └── data.jsonl            # Produced events (local topics)
+├── <parent>/<child>/
+│   └── data.jsonl            # Path-style nested topics
+└── .brooklet/
+    ├── sources.json          # Registry (external + local sources)
+    └── offsets/
+        └── <group>-<topic>.json  # Byte offset per consumer group
+```
+
+## Dev Commands
+
+```bash
+uv run pytest -v              # Run tests
+uv run pytest -v --tb=short   # Run tests with short traceback
+uv run ruff check .           # Lint
+uv run ruff format .          # Format
+```
+
+## Conventions
+- All `.py` files start with 2-line `ABOUTME:` comment
+- TDD: tests first, then minimal implementation
+- Simple over clever — readability is the priority
+
+## Non-Interactive Shell Commands
+
+**ALWAYS use non-interactive flags** with file operations to avoid hanging on confirmation prompts.
+
+```bash
+cp -f source dest           # NOT: cp source dest
+mv -f source dest           # NOT: mv source dest
+rm -f file                  # NOT: rm file
+rm -rf directory            # NOT: rm -r directory
+```
+
+Other commands: `apt-get -y`, `HOMEBREW_NO_AUTO_UPDATE=1 brew`, `scp -o BatchMode=yes`.
+
+## Session Completion
+
+When ending a work session, complete ALL steps:
+
+1. Run quality gates (tests, linters) if code changed
+2. Commit all changes
+3. Push to remote — work is NOT complete until `git push` succeeds
+4. Provide context for next session

brooklet-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joshua Oliphant
+
+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.