From 345ee68b3be9d92a2bc93441bb29b213f057cd35 Mon Sep 17 00:00:00 2001 From: bchanot Date: Fri, 30 Oct 2026 17:44:33 +0100 Subject: [PATCH] =?UTF-8?q?chore(memory):=20registries=20v2=20=E2=80=94=20?= =?UTF-8?q?memory.sh=20upgrade=20(phase=204a)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .claude/memory/blockers.md | 20 ++++++++++++++++++++ .claude/memory/decisions.md | 20 ++++++++++++++++++++ .claude/memory/evals.md | 19 +++++++++++++++++++ .claude/memory/journal.md | 3 +++ .claude/memory/learnings.md | 17 +++++++++++++++++ 5 files changed, 79 insertions(+) diff --git a/.claude/memory/blockers.md b/.claude/memory/blockers.md index f06f326..ff515d6 100644 --- a/.claude/memory/blockers.md +++ b/.claude/memory/blockers.md @@ -1,3 +1,21 @@ +--- +format: 2 +type: blockers_registry +entry_prefix: BLK +schema: + id: BLK-XXX + date: YYYY-MM-DD + friction: string (what was blocked) + real_cause: string (root cause, not symptom) + solution: string (workaround or fix) + status: [open | resolved | upstream] +rules: + - Open a blocker as soon as friction > 15 min wasted. Close it with a real cause, not "moved on". + - Link to upstream issue / PR / commit when applicable. + - If cause is a bug in a dependency, set status upstream with a pointer to the tracker. + - Entries in English, caveman format (BDR-009): drop articles + filler, fragments OK, technical terms exact. +--- + # Blockers Friction + root cause + status. Caveman + English. @@ -14,6 +32,7 @@ repo (remote git.bchanot.fr) would leak it. Root cause: key inlined in `write_op Fix: repo copy `bin/claude-provider` reads `${OPENROUTER_API_KEY:?...}` from env; key never in repo. Verified `git grep sk-or` clean. Status: resolved in repo. ACTION user: revoke old key at openrouter.ai (compromised — was in plaintext + exposed in chat). +- **Status (2026-10-30, upgrade)**: resolved ## BLK-003 — xrdp block: `systemctl enable xrdb` typo aborted installer — RESOLVED 2026-06-23. Uncommitted install.sh xrdp block had `sudo systemctl enable xrdb` (typo: `xrdb` = X @@ -31,6 +50,7 @@ despite: daemon LISTEN *:3389, ufw inactive, TLS cert readable, service active. PAM login at GDM. Empty gate creds → RDP nego refused before GDM → 0x904. Fix: set-credentials, connect (gate creds → GDM `bchanot`). Connection CONFIRMED live. Automated in install.sh via ensure_rdp_credentials (prompt, TTY-guarded, idempotent). Supersedes BLK-003 (xrdp). Status: resolved. +- **Status (2026-10-30, upgrade)**: resolved ## BLK-005 — secrets still on NAS share: /mnt/cloudpex/transfert/root/ — OPEN (user action) 2026-09-22. RECOVERY checklist 06 + doc 04: delete `CloudPex/transfert/root/` (root ssh keys, .smbcredentials, diff --git a/.claude/memory/decisions.md b/.claude/memory/decisions.md index 0f83723..a00ead2 100644 --- a/.claude/memory/decisions.md +++ b/.claude/memory/decisions.md @@ -1,3 +1,23 @@ +--- +format: 2 +type: decisions_registry +entry_prefix: BDR +schema: + id: BDR-XXX + date: YYYY-MM-DD + title: string (<= 80 chars) + decision: string (what was chosen) + why: string (motivation, context) + alternatives: list of strings (what was rejected + why) + status: [proposed | accepted | deprecated | superseded] + supersedes: BDR-XXX (optional) +rules: + - Append-only. Never rewrite past entries - add a new one with status superseded if needed. + - One entry per non-trivial choice. Trivial = reversible in under 10 min with no cross-file impact. + - Capture why more carefully than what - the what rots, the why lasts. + - Entries in English, caveman format (BDR-009): drop articles + filler, fragments OK, technical terms exact. +--- + # Decisions Design/architecture choices. Caveman + English. diff --git a/.claude/memory/evals.md b/.claude/memory/evals.md index 67dd849..12b8c0e 100644 --- a/.claude/memory/evals.md +++ b/.claude/memory/evals.md @@ -1,3 +1,22 @@ +--- +format: 2 +type: evals_registry +entry_prefix: EVAL +schema: + id: EVAL-XXX + date: YYYY-MM-DD + output: string (what was produced) + method: string (how it was evaluated - manual read, test, benchmark, user feedback) + anomalies: list of strings (what was wrong, missing, surprising) + action: [keep | correct | deprecate] +rules: + - Log an eval whenever you validate the quality of something Claude produced (report, audit, plan, generated code). + - Action keep - the output is fit for purpose as-is. + - Action correct - needs revision; capture what. + - Action deprecate - the approach itself is flawed; link to the decision that replaces it. + - Entries in English, caveman format (BDR-009): drop articles + filler, fragments OK, technical terms exact. +--- + # Evals Quality check of Claude output. Caveman + English. diff --git a/.claude/memory/journal.md b/.claude/memory/journal.md index f71ca18..185a1a8 100644 --- a/.claude/memory/journal.md +++ b/.claude/memory/journal.md @@ -156,3 +156,6 @@ Done: 3 rc files exec `tmux new-session -A -s main` on interactive SSH (not in t ## 2026-10-15 (2) — tmux-before-router fix not live: ~/.bashrc never redeployed Done: feature merged in develop but ~/.bashrc predated it (only install.sh writes it); diff template vs deployed = tmux block only. User copied rendered template to ~/.bashrc; stub-tmux sim + real SSH login confirmed tmux opens before dtach menu. No repo code change. + +## 2026-10-30 +- Memory registries → v2 (`memory.sh upgrade`, claude-config BDR-129 phase 4a): `check` green, open blockers unchanged. diff --git a/.claude/memory/learnings.md b/.claude/memory/learnings.md index a1e575a..e667687 100644 --- a/.claude/memory/learnings.md +++ b/.claude/memory/learnings.md @@ -1,3 +1,20 @@ +--- +format: 2 +type: learnings_registry +entry_prefix: LRN +schema: + id: LRN-XXX + date: YYYY-MM-DD + pattern: string (what was observed, abstracted) + context: string (where/when it happened - concrete) + future_application: string (when to recall this) +rules: + - Capture learnings that apply beyond the current task. + - Abstract from the incident - the pattern is what is reusable, not the one-shot fact. + - Link to source (commit, file, PR) when possible. + - Entries in English, caveman format (BDR-009): drop articles + filler, fragments OK, technical terms exact. +--- + # Learnings Reusable patterns. Caveman + English.