ledger-kit

Shared PKM infrastructure and launchd tooling used by multiple domain repos.

What Lives Here

• scripts/lib.sh: shared shell utilities
• scripts/derive-state.sh: event-sourced derivation pipeline
• hooks/: Claude hooks (load-context.sh, router.sh)
• launchd tooling lives in ~/dev/launchd-kit (separate repo)

Domain Integration (per repo)

Symlink shared scripts and hooks into each domain repo:

• scripts/lib.sh → ~/dev/ledger-kit/scripts/lib.sh
• scripts/derive-state.sh → ~/dev/ledger-kit/scripts/derive-state.sh
• .claude/hooks/load-context.sh → ~/dev/ledger-kit/hooks/load-context.sh
• .claude/hooks/router.sh → ~/dev/ledger-kit/hooks/router.sh

Domain Config (config.json)

Each domain repo should provide a config.json at repo root. Minimum fields:

• domain_id
• sessions_dir
• ledger_start_date

Optional fields:

• events_dir, state_dir, logs_dir
• derive.* (window sizes)
• router.* (regex patterns and Todoist action)

Examples and schema live in config/:

• config/examples/
• config/config.schema.json

Quick validation:

• scripts/validate-config.sh /path/to/config.json

Backfill / Schema

derive-state.sh checks state/metadata.json for schema_version and auto-rebuilds on mismatch.