memory-boost 0.1.0__py3-none-any.whl

memory_boost/example_transcripts/-work-pixel-notes/0a1b2c3d-2222-4aaa-8bbb-000000000002.jsonl

@@ -0,0 +1,54 @@
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:00:35Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0000", "name": "Read", "input": {"file_path": "/work/pixel-notes/app/sync.ts"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:00:38Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0000", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:01:16Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0001", "name": "Bash", "input": {"command": "npm test -- --run"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:01:17Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0001", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:01:35Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0002", "name": "Edit", "input": {"file_path": "/work/pixel-notes/app/sync.ts", "old_string": "a", "new_string": "b"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:01:44Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0002", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:02:12Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0003", "name": "Bash", "input": {"command": "npm test -- --run"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:02:15Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0003", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:02:54Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0004", "name": "Edit", "input": {"file_path": "/work/pixel-notes/app/sync.ts", "old_string": "a", "new_string": "b"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:02:55Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0004", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:03:33Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0005", "name": "Bash", "input": {"command": "npm test -- --run"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:03:38Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0005", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:03:48Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0006", "name": "Edit", "input": {"file_path": "/work/pixel-notes/app/sync.ts", "old_string": "a", "new_string": "b"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:03:53Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0006", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:04:31Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0007", "name": "Bash", "input": {"command": "npm test -- --run"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:04:37Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0007", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:04:52Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0008", "name": "Edit", "input": {"file_path": "/work/pixel-notes/app/sync.ts", "old_string": "a", "new_string": "b"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:04:58Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0008", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:05:17Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0009", "name": "Bash", "input": {"command": "npm test -- --run"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:05:26Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0009", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:06:05Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0010", "name": "Edit", "input": {"file_path": "/work/pixel-notes/app/sync.ts", "old_string": "a", "new_string": "b"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:06:14Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0010", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:06:40Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0011", "name": "Bash", "input": {"command": "npm test -- --run"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:06:44Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0011", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:07:01Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0012", "name": "Edit", "input": {"file_path": "/work/pixel-notes/app/sync.ts", "old_string": "a", "new_string": "b"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:07:05Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0012", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:07:35Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0013", "name": "Bash", "input": {"command": "npm test -- --run"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:07:39Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0013", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:07:56Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0014", "name": "Edit", "input": {"file_path": "/work/pixel-notes/app/sync.ts", "old_string": "a", "new_string": "b"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:08:05Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0014", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:08:41Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0015", "name": "Bash", "input": {"command": "npm test -- --run"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:08:47Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0015", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:08:53Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0016", "name": "Edit", "input": {"file_path": "/work/pixel-notes/app/sync.ts", "old_string": "a", "new_string": "b"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:08:54Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0016", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:09:16Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0017", "name": "Bash", "input": {"command": "npm test -- --run"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:09:24Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0017", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:09:45Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0018", "name": "Edit", "input": {"file_path": "/work/pixel-notes/app/sync.ts", "old_string": "a", "new_string": "b"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:09:49Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0018", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:10:16Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0019", "name": "Bash", "input": {"command": "npm test -- --run"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:10:24Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0019", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:10:51Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0020", "name": "Edit", "input": {"file_path": "/work/pixel-notes/app/sync.ts", "old_string": "a", "new_string": "b"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:10:57Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0020", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:11:07Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0021", "name": "Bash", "input": {"command": "npm test -- --run"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:11:11Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0021", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:11:22Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0022", "name": "mcp__memory__memory_checkpoint", "input": {"project": "acme-api", "session_id": "x", "task": "t"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:11:26Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0022", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:12:01Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0023", "name": "Edit", "input": {"file_path": "/work/pixel-notes/app/store.ts", "old_string": "a", "new_string": "b"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:12:05Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0023", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:12:31Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0024", "name": "Bash", "input": {"command": "npm run build"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:12:35Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0024", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:13:10Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0025", "name": "mcp__memory__memory_checkpoint", "input": {"project": "acme-api", "session_id": "x", "task": "t"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:13:20Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0025", "content": "(synthetic output)"}]}}
+{"type": "assistant", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:13:25Z", "message": {"role": "assistant", "content": [{"type": "text", "text": "(synthetic)"}, {"type": "tool_use", "id": "toolu_0026", "name": "mcp__memory__memory_save", "input": {"project": "acme-api", "action": "a"}}]}}
+{"type": "user", "cwd": "/work/pixel-notes", "sessionId": "0a1b2c3d-2222-4aaa-8bbb-000000000002", "timestamp": "2026-09-10T15:13:33Z", "message": {"role": "user", "content": [{"type": "tool_result", "tool_use_id": "toolu_0026", "content": "(synthetic output)"}]}}

memory_boost/example_wiki/concepts/money-as-integer-cents.md

@@ -0,0 +1,15 @@
+---
+title: Store money as integer minor units, never float
+created: 2026-01-12
+applies_when: [payments, invoices, postgres, typescript]
+learned_on: acme-api
+---
+# Store money as integer minor units, never float
+
+Sum 0.1 + 0.2 in a float column and an invoice is off by a cent. Store amounts as integers in
+the smallest unit (`amount_cents BIGINT`) and format at the edge. Decimal types work too but the
+integer rule survives every language and serializer.
+
+## When it bit us
+
+- acme-api, 2026-01-12: rounding drift on invoice totals; fixed by migrating to `amount_cents`.

memory_boost/example_wiki/concepts/retry-jobs-idempotently.md

@@ -0,0 +1,16 @@
+---
+title: Make background jobs idempotent before adding retries
+created: 2026-08-30
+applies_when: [background-jobs, offline-sync, queues]
+learned_on: pixel-notes
+---
+# Make background jobs idempotent before adding retries
+
+Retrying a non-idempotent job duplicated notes on every flaky sync. Give each job a stable key
+(entity id + version) and make the handler a no-op when the key was already applied; only then
+add retries with backoff. Tools that helped: a `--replay <job-id>` CLI flag and a test that runs
+the same job twice and asserts one side effect.
+
+## When it bit us
+
+- pixel-notes, 2026-08-30: offline edits synced twice after a timeout, users saw duplicate notes.

memory_boost/example_wiki/context/preferences.md

@@ -0,0 +1,7 @@
+---
+title: Working preferences
+---
+# Working preferences
+
+- Minimal diffs; no speculative abstractions.
+- Tests run with `pytest -q --tb=short`.

memory_boost/example_wiki/decisions/cors-allow-all.md

@@ -0,0 +1,9 @@
+---
+title: Allow all CORS origins in staging, for now
+created: 2026-04-01
+tags: [acme-api, infra]
+---
+# Allow all CORS origins in staging, for now
+
+The mobile preview builds use random hostnames. `allow_origins=["*"]` in staging until we have a
+fixed preview domain. Temporary.

memory_boost/example_wiki/decisions/float-money.md

@@ -0,0 +1,9 @@
+---
+title: Store money as float
+status: superseded
+superseded_by: integer-cents
+created: 2026-01-12
+---
+# Store money as float
+
+Superseded by integer cents (see acme-api gotchas).

memory_boost/example_wiki/decisions/pin-postgres-15.md

@@ -0,0 +1,14 @@
+---
+title: Pin PostgreSQL 15 until the pgvector upgrade is tested
+created: 2026-02-20
+review_by: 2026-06-01
+tags: [acme-api, postgres, infra]
+---
+# Pin PostgreSQL 15 until the pgvector upgrade is tested
+
+PostgreSQL 16 changed the default collation provider; our ORDER BY tests broke. Pin 15 in the
+compose file and revisit once the pgvector image for 16 is tested in staging.
+
+## Revisit
+
+- Review by 2026-06-01: is the 16 image tested? If yes, unpin and delete this decision.

memory_boost/example_wiki/decisions/queue-in-postgres.md

@@ -0,0 +1,15 @@
+---
+title: Job queue in PostgreSQL
+status: current
+created: 2026-03-04
+review_by: 2027-03-01
+---
+# Job queue in PostgreSQL
+
+## Decision
+
+acme-api keeps its job queue in PostgreSQL (`SKIP LOCKED`) instead of adding Redis.
+
+## Why
+
+One less service to run; throughput needed is below 50 jobs/s.

memory_boost/example_wiki/decisions/sessions-in-redis.md

@@ -0,0 +1,9 @@
+---
+title: Keep user sessions in Redis
+status: superseded
+created: 2026-02-02
+tags: [acme-api]
+---
+# Keep user sessions in Redis
+
+Superseded in April. By what, nobody wrote down.

memory_boost/example_wiki/log.md

@@ -0,0 +1,37 @@
+# Log
+
+## [2026-03-12] claude-code | legacy-dashboard | Bumped jQuery from 1.12 to 3.7
+- Two charts stopped rendering; reverted one of them.
+- Pending: the rewrite.
+
+## [2026-03-14] claude-code | legacy-dashboard | Pinned Node 14 in .nvmrc
+- The build only works on Node 14. Nobody knows why.
+
+## [2026-07-10] claude-code | pixel-notes | Offline queue for note edits
+- Edits made offline are queued in SQLite and replayed on reconnect.
+
+## [2026-07-15] codex | pixel-notes | Fixed duplicated notes after flaky sync
+- Retried jobs were creating a note each time; added a stable job key.
+
+## [2026-07-22] claude-code | pixel-notes | Background sync every 15 minutes
+- Uses the OS background task API; iOS decides when "15 minutes" is.
+
+## [2026-07-29] claude-code | pixel-notes | Conflict banner when two devices edit a note
+
+## [2026-08-05] codex | pixel-notes | Reverted the conflict banner
+- It appeared on every note opened on two devices, conflict or not.
+
+## [2026-08-12] claude-code | pixel-notes | Per-field merge prototype
+- Pending: decide between per-field merge and CRDT.
+
+## [2026-08-20] claude-code | pixel-notes | Sync server moved to its own container
+
+## [2026-08-28] claude-code | acme-api | Added idempotency keys to POST /invoices
+- Keys stored 24h in the `idempotency` table.
+
+## [2026-08-30] codex | pixel-notes | Fixed sync conflict on offline edits
+- Last-writer-wins replaced by per-field merge.
+- Pending: test on Android 15.
+
+## [2026-09-01] claude-code | acme-api | Moved PDF rendering to the job queue
+- Pending: load test with 10k invoices.

memory_boost/example_wiki/projects/acme-api.md

@@ -0,0 +1,24 @@
+---
+title: acme-api
+created: 2026-01-10
+updated: 2026-09-01
+tags: [python, fastapi, postgres, background-jobs]
+---
+# acme-api
+
+Invoice API for a fictional shop. FastAPI + PostgreSQL, deployed as a container.
+Run locally with `make dev`; tests with `pytest -q`.
+
+## Architecture
+
+- `app/routes/` HTTP layer, `app/billing/` pure domain logic, `app/db/` repositories.
+- Background jobs use a PostgreSQL table with `SELECT ... FOR UPDATE SKIP LOCKED`, not Redis.
+
+## Gotchas
+
+- The staging database is reset every Sunday: never keep fixtures there.
+- Currency amounts are stored as integer cents; never read the legacy `amount_float` column.
+
+## History
+
+- 2026-02: migrated from Flask to FastAPI.

memory_boost/example_wiki/projects/legacy-dashboard.md

@@ -0,0 +1,13 @@
+---
+title: legacy-dashboard
+created: 2025-11-03
+tags: [javascript, jquery, dashboards]
+---
+# legacy-dashboard
+
+Internal sales dashboard in jQuery. Everyone agrees it will be rewritten next sprint.
+It has been next sprint since November.
+
+## Gotchas
+
+- The build needs Node 14. Do not ask why; nobody remembers.

memory_boost/example_wiki/projects/pixel-notes.md

@@ -0,0 +1,9 @@
+---
+title: pixel-notes
+created: 2026-05-02
+tags: [typescript, react-native, offline-sync, background-jobs]
+---
+# pixel-notes
+
+Offline-first note-taking mobile app (React Native). Sync server lives in `sync/`.
+Release builds are made in CI only; local builds are debug.

memory_boost/lessons.py

@@ -0,0 +1,77 @@
+"""Lessons that travel between projects.
+
+A lesson is a page in wiki/concepts/ with `applies_when: [tag, ...]` in its
+frontmatter. A project page declares `tags: [...]`. brief() surfaces the lessons
+whose applies_when overlaps the current project's tags and that were NOT learned
+on this project, so what worked in one place reaches the next."""
+from __future__ import annotations
+
+from pathlib import Path
+
+from memory_boost import core
+from memory_boost.drift import parse_tags
+
+
+def project_tags(project: str) -> set[str]:
+    p = core.wiki_dir() / "projects" / f"{core.norm_project(project)}.md"
+    if not p.exists():
+        return set()
+    meta, _ = core.parse_frontmatter(p.read_text(encoding="utf-8"))
+    return parse_tags(meta)
+
+
+def all_lessons() -> list[dict]:
+    out = []
+    for p in sorted((core.wiki_dir() / "concepts").glob("*.md")):
+        meta, body = core.parse_frontmatter(p.read_text(encoding="utf-8"))
+        applies = parse_tags(meta, "applies_when")
+        if not applies:
+            continue            # a concept page without applies_when is reference, not a lesson
+        summary = next((ln.strip() for ln in body.splitlines()
+                        if ln.strip() and not ln.startswith("#")), "")
+        out.append({"name": p.stem, "title": meta.get("title", p.stem), "applies_when": applies,
+                    "learned_on": core.norm_project(meta.get("learned_on", "")),
+                    "date": meta.get("updated") or meta.get("created"), "summary": summary})
+    return out
+
+
+def lessons_for(project: str, limit: int = 3) -> list[dict]:
+    """Lessons from other projects whose applies_when matches this project's tags,
+    best overlap first."""
+    tags = project_tags(project)
+    slug = core.norm_project(project)
+    if not tags:
+        return []
+    scored = []
+    for lesson in all_lessons():
+        overlap = lesson["applies_when"] & tags
+        if overlap and lesson["learned_on"] != slug:
+            scored.append((len(overlap), lesson["date"] or "", {**lesson, "matched": sorted(overlap)}))
+    scored.sort(key=lambda t: (t[0], t[1]), reverse=True)
+    return [lesson for _, _, lesson in scored[:limit]]
+
+
+def format_lessons(lessons: list[dict]) -> list[str]:
+    return [f"- {lesson['title']} (from {lesson['learned_on'] or '?'}, matches "
+            f"{', '.join(lesson['matched'])}) — {lesson['summary'][:160]} → memory_page(\"{lesson['name']}\")"
+            for lesson in lessons]
+
+
+def save_lesson(name: str, title: str, applies_when: list[str], body: str,
+                learned_on: str | None = None) -> Path:
+    """Write (or overwrite) wiki/concepts/<name>.md as a lesson."""
+    slug = core.safe_slug(name, "lesson name")
+    tags = sorted({core.norm_project(t) for t in applies_when if t.strip()})
+    if not tags:
+        raise ValueError("applies_when is empty: a lesson needs at least one tag to travel")
+    if not body.strip():
+        raise ValueError("body is empty")
+    p = core.wiki_dir() / "concepts" / f"{slug}.md"
+    p.parent.mkdir(parents=True, exist_ok=True)
+    meta = [f"title: {core._one_line(title) or slug}", f"created: {core._today()}",
+            f"applies_when: [{', '.join(tags)}]"]
+    if learned_on:
+        meta.append(f"learned_on: {core.safe_slug(learned_on, 'learned_on')}")
+    p.write_text("---\n" + "\n".join(meta) + f"\n---\n# {core._one_line(title) or slug}\n\n"
+                 + body.strip() + "\n", encoding="utf-8")
+    return p

memory_boost/mine.py

@@ -0,0 +1,172 @@
+"""Mine local agent transcripts for how you actually work.
+
+Reads Claude Code session files (~/.claude/projects/<cwd-slug>/<session>.jsonl)
+and keeps only aggregates: tool counts, failed commands, re-reads, subagent
+fan-out, checkpoint discipline. Prompt and tool *contents* are never stored
+or printed, so the digest is safe to share."""
+from __future__ import annotations
+
+import json
+import os
+from collections import Counter
+from pathlib import Path
+
+from memory_boost.core import _today, plural
+
+MIN_TURNS = 20          # shorter sessions are one-shot questions, not work sessions
+LONG_SESSION = 60       # from here on a checkpoint is expected
+REREAD_MIN = 4          # a file read this many times in one session is worth naming
+
+
+def transcript_roots() -> list[Path]:
+    if env := os.environ.get("MEMORY_BOOST_TRANSCRIPTS"):
+        return [Path(p).expanduser() for p in env.split(os.pathsep) if p]
+    return [Path.home() / ".claude" / "projects"]
+
+
+def _empty(path: Path) -> dict:
+    return {"file": path.name, "project": None, "turns": 0, "first": None, "last": None,
+            "tools": Counter(), "bash_failed": 0, "failed_cmds": Counter(), "reads": Counter(),
+            "checkpoints": 0, "saves": 0, "agents": 0}
+
+
+def scan_session(path: Path) -> dict:
+    """One JSONL transcript -> aggregate counters. Tolerates broken lines."""
+    s = _empty(path)
+    pending: dict[str, tuple[str, str]] = {}   # tool_use_id -> (tool name, first word of command)
+    with path.open(encoding="utf-8", errors="replace") as fh:
+        for line in fh:
+            try:
+                ev = json.loads(line)
+            except json.JSONDecodeError:
+                continue
+            if not isinstance(ev, dict):
+                continue
+            if cwd := ev.get("cwd"):
+                s["project"] = s["project"] or Path(cwd).name
+            if ts := ev.get("timestamp"):
+                s["first"] = s["first"] or ts
+                s["last"] = ts
+            content = (ev.get("message") or {}).get("content")
+            if not isinstance(content, list):
+                continue
+            if ev.get("type") == "assistant":
+                s["turns"] += 1
+            for c in content:
+                if not isinstance(c, dict):
+                    continue
+                if c.get("type") == "tool_use":
+                    name, inp = c.get("name", "?"), c.get("input") or {}
+                    s["tools"][name] += 1
+                    cmd = (inp.get("command") or "").split()
+                    pending[c.get("id", "")] = (name, cmd[0] if cmd else "?")
+                    if name == "Read":
+                        s["reads"][inp.get("file_path", "")] += 1
+                    elif name == "Agent":
+                        s["agents"] += 1
+                    elif name.endswith("memory_checkpoint"):
+                        s["checkpoints"] += 1
+                    elif name.endswith("memory_save"):
+                        s["saves"] += 1
+                elif c.get("type") == "tool_result" and c.get("is_error"):
+                    name, cmd = pending.get(c.get("tool_use_id", ""), ("?", "?"))
+                    if name == "Bash":
+                        s["bash_failed"] += 1
+                        s["failed_cmds"][cmd] += 1
+    return s
+
+
+def scan(roots: list[Path] | None = None, since: str | None = None,
+         min_turns: int = MIN_TURNS) -> list[dict]:
+    """All sessions under the roots with at least min_turns assistant turns,
+    optionally only those started on/after `since` (YYYY-MM-DD)."""
+    out = []
+    for root in roots or transcript_roots():
+        for f in sorted(root.glob("*/*.jsonl")) if root.exists() else ():
+            s = scan_session(f)
+            if s["turns"] < min_turns:
+                continue
+            if since and (s["first"] or "")[:10] < since:
+                continue
+            out.append(s)
+    return out
+
+
+def aggregate(sessions: list[dict]) -> dict:
+    tools: Counter = Counter()
+    failed: Counter = Counter()
+    rereads: Counter = Counter()
+    per_project: dict[str, dict] = {}
+    reread_total = 0
+    for s in sessions:
+        tools.update(s["tools"])
+        failed.update(s["failed_cmds"])
+        for f, n in s["reads"].items():
+            if n > 1:
+                reread_total += n - 1
+            if n >= REREAD_MIN:
+                rereads[f] += n
+        p = per_project.setdefault(s["project"] or "?", {"sessions": 0, "turns": 0, "bash_failed": 0})
+        p["sessions"] += 1
+        p["turns"] += s["turns"]
+        p["bash_failed"] += s["bash_failed"]
+    long = [s for s in sessions if s["turns"] >= LONG_SESSION]
+    edits = tools["Edit"] + tools["Write"]
+    extremes = sorted(((s["tools"]["Bash"] / max(s["tools"]["Edit"] + s["tools"]["Write"], 1),
+                        s["turns"], s["project"] or "?", s["file"][:8]) for s in sessions), reverse=True)
+    return {
+        "sessions": len(sessions),
+        "tools": dict(tools.most_common(10)),
+        "bash": {"calls": tools["Bash"], "failed": sum(s["bash_failed"] for s in sessions),
+                 "top_failed_cmds": dict(failed.most_common(5))},
+        "bash_per_edit": round(tools["Bash"] / max(edits, 1), 1),
+        "extreme_sessions": [{"ratio": round(r, 1), "turns": t, "project": p, "session": f}
+                             for r, t, p, f in extremes[:3] if r >= 20],
+        "reads": {"calls": tools["Read"], "rereads": reread_total,
+                  "most_reread": [{"file": _short(f), "times": n} for f, n in rereads.most_common(3)]},
+        "long_sessions": {"count": len(long),
+                          "without_checkpoint": sum(s["checkpoints"] == 0 for s in long),
+                          "without_save": sum(s["saves"] == 0 for s in long)},
+        "subagents": {"sessions_using": sum(s["agents"] > 0 for s in sessions),
+                      "total": sum(s["agents"] for s in sessions),
+                      "max_in_one_session": max((s["agents"] for s in sessions), default=0)},
+        "projects": dict(sorted(per_project.items(), key=lambda kv: -kv[1]["turns"])[:8]),
+    }
+
+
+def _short(path: str) -> str:
+    home = str(Path.home())
+    return path.replace(home, "~") if path.startswith(home) else path
+
+
+def _tool_name(tool: str) -> str:
+    """mcp__memory__memory_save -> memory_save: the server prefix is noise in a digest."""
+    return tool.split("__", 2)[-1] if tool.startswith("mcp__") else tool
+
+
+def format_digest(agg: dict, since: str | None = None) -> str:
+    if not agg["sessions"]:
+        return f"No sessions found (need ≥{MIN_TURNS} assistant turns). Set MEMORY_BOOST_TRANSCRIPTS?\n"
+    b, r, ls, sa = agg["bash"], agg["reads"], agg["long_sessions"], agg["subagents"]
+    pct = 100 * b["failed"] / max(b["calls"], 1)
+    lines = [f"# Session digest{' since ' + since if since else ''} — {_today()}",
+             f"sessions      {agg['sessions']} with ≥{MIN_TURNS} turns",
+             "tools         " + " · ".join(f"{_tool_name(k)} {v}" for k, v in list(agg["tools"].items())[:6]),
+             f"bash          {b['calls']} calls, {b['failed']} failed ({pct:.1f}%)"
+             + ("; most failed: " + ", ".join(f"{k} ({v})" for k, v in b["top_failed_cmds"].items())
+                if b["top_failed_cmds"] else ""),
+             f"bash/edit     {agg['bash_per_edit']}x"
+             + ("; extreme: " + ", ".join(f"{e['project']} {e['ratio']}x" for e in agg["extreme_sessions"])
+                if agg["extreme_sessions"] else ""),
+             f"reads         {r['calls']} calls, {r['rereads']} re-reads of a file already read "
+             f"({100 * r['rereads'] / max(r['calls'], 1):.0f}%)"
+             + ("; top: " + ", ".join(f"{m['file']} ×{m['times']}" for m in r["most_reread"])
+                if r["most_reread"] else ""),
+             f"discipline    {plural(ls['count'], 'long session')} (≥{LONG_SESSION} turns): "
+             f"{ls['without_checkpoint']} never checkpointed, {ls['without_save']} never saved",
+             f"subagents     {sa['total']} spawned in {plural(sa['sessions_using'], 'session')}; "
+             f"max in one session: {sa['max_in_one_session']}",
+             "projects      " + ", ".join(f"{p} ({v['sessions']}s/{v['turns']}t)"
+                                          for p, v in agg["projects"].items()),
+             "next: memory-boost lesson --help   # turn one line above into a lesson"]
+    return "\n".join(lines) + "\n"