@the-bearded-bear/claude-craft 7.34.0 → 7.35.0

package/Dev/scripts/memory-lifecycle/README.md

@@ -0,0 +1,117 @@
+# Memory Lifecycle — Persistent memory across Claude Code sessions
+
+**Inspiré de** [thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) (49.6k stars).
+
+Système de mémoire persistante **100% local** qui capture sessions, prompts, et utilisation d'outils dans une base SQLite locale, permettant le rappel cross-sessions sans cloud ni télémétrie.
+
+## Architecture
+
+```
+Session lifecycle
+  ├─ SessionStart      → init DB + recall previous session summary
+  ├─ UserPromptSubmit  → log prompt preview (200 chars max)
+  ├─ PostToolUse       → log Edit/Write/Bash events (target + summary)
+  ├─ PreCompact        → preserve context + re-inject before compaction
+  └─ SessionEnd        → compute session summary
+```
+
+## Schéma SQLite
+
+```sql
+sessions     (id, started_at, ended_at, project_dir, git_branch, git_commit, summary)
+prompts      (id, session_id, submitted_at, prompt_preview, token_estimate)
+tool_events  (id, session_id, occurred_at, tool_name, target_path, summary)
+compactions  (id, session_id, compacted_at, preserved_context)
+```
+
+## Installation
+
+### 1. Prérequis
+
+- `sqlite3` (package système : `apt install sqlite3` / `brew install sqlite3`)
+- `jq` (package système : `apt install jq` / `brew install jq`)
+- `bash` 4+
+
+### 2. Activer les hooks
+
+Copier le contenu de `.claude/templates/hooks/memory-lifecycle.json` dans votre `.claude/settings.json` :
+
+```bash
+# Fusion manuelle dans .claude/settings.json
+cat .claude/templates/hooks/memory-lifecycle.json
+```
+
+Ou via la commande Claude Craft (à venir) : `/common:setup-memory-lifecycle`.
+
+### 3. Vérifier
+
+Démarrer une nouvelle session Claude Code. La base est créée automatiquement :
+
+```bash
+ls -la .claude/memory.db
+sqlite3 .claude/memory.db "SELECT * FROM sessions LIMIT 1;"
+```
+
+## Usage
+
+### Consulter les sessions passées
+
+```bash
+sqlite3 .claude/memory.db \
+  "SELECT id, started_at, summary FROM sessions ORDER BY started_at DESC LIMIT 10;"
+```
+
+### Top fichiers édités cette semaine
+
+```bash
+sqlite3 .claude/memory.db <<SQL
+SELECT target_path, COUNT(*) as edits
+FROM tool_events
+WHERE tool_name IN ('Edit', 'Write')
+  AND occurred_at > datetime('now', '-7 days')
+GROUP BY target_path
+ORDER BY edits DESC
+LIMIT 10;
+SQL
+```
+
+### Recall depuis une autre session
+
+Automatique via `SessionStart` — le résumé de la dernière session est injecté en `systemMessage`.
+
+## Confidentialité
+
+- **100% local** — base SQLite dans `.claude/memory.db`
+- **Zéro télémétrie** — pas de network call
+- **Gitignored** — jamais commité (`.claude/memory.db` dans `.gitignore`)
+- **Previews only** — prompts tronqués à 200 chars, tool output à 300 chars
+- **Hash projet** — session ID contient un hash SHA1 du path, pas le path complet
+
+## Nettoyage
+
+Purger les sessions de plus de 90 jours :
+
+```bash
+sqlite3 .claude/memory.db \
+  "DELETE FROM sessions WHERE started_at < datetime('now', '-90 days');
+   DELETE FROM prompts WHERE session_id NOT IN (SELECT id FROM sessions);
+   DELETE FROM tool_events WHERE session_id NOT IN (SELECT id FROM sessions);
+   VACUUM;"
+```
+
+## Désactivation
+
+Retirer les hooks de `.claude/settings.json`. La base `.claude/memory.db` peut être supprimée sans impact.
+
+## Limitations (v7.35.0)
+
+- Pas de compression IA des sessions (claude-mem original utilise Anthropic API pour summarize → hors scope local-first)
+- Pas de Web UI (prévu en v8+ si demande)
+- Pas de recherche sémantique (SQL LIKE uniquement)
+- Un session ID par jour par projet (simplicité vs granularité)
+
+## Ressources
+
+- [claude-mem](https://github.com/thedotmack/claude-mem) — implémentation originale
+- `.claude/templates/hooks/memory-lifecycle.json` — template hook
+- `.claude/rules/12-context-management.md` — stratégie contexte

package/Dev/scripts/memory-lifecycle/_db.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# _db.sh — Shared DB helpers for memory-lifecycle hooks.
+# Sourced by other scripts, not executed directly.
+
+set -euo pipefail
+
+MEMORY_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}/.claude"
+MEMORY_DB="$MEMORY_DIR/memory.db"
+
+mkdir -p "$MEMORY_DIR"
+
+# Initialize schema if DB doesn't exist
+init_memory_db() {
+  if [[ ! -f "$MEMORY_DB" ]]; then
+    sqlite3 "$MEMORY_DB" <<'SQL'
+CREATE TABLE IF NOT EXISTS sessions (
+  id TEXT PRIMARY KEY,
+  started_at TEXT NOT NULL,
+  ended_at TEXT,
+  project_dir TEXT,
+  git_branch TEXT,
+  git_commit TEXT,
+  summary TEXT
+);
+
+CREATE TABLE IF NOT EXISTS prompts (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT NOT NULL REFERENCES sessions(id),
+  submitted_at TEXT NOT NULL,
+  prompt_preview TEXT,
+  token_estimate INTEGER
+);
+
+CREATE TABLE IF NOT EXISTS tool_events (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT NOT NULL REFERENCES sessions(id),
+  occurred_at TEXT NOT NULL,
+  tool_name TEXT,
+  target_path TEXT,
+  summary TEXT
+);
+
+CREATE TABLE IF NOT EXISTS compactions (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT NOT NULL REFERENCES sessions(id),
+  compacted_at TEXT NOT NULL,
+  preserved_context TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_sessions_started ON sessions(started_at DESC);
+CREATE INDEX IF NOT EXISTS idx_prompts_session ON prompts(session_id);
+CREATE INDEX IF NOT EXISTS idx_tools_session ON tool_events(session_id);
+SQL
+  fi
+}
+
+# Get or create current session id (one per day per project)
+current_session_id() {
+  local today
+  today=$(date -u +%Y%m%d)
+  local project_hash
+  project_hash=$(echo -n "${CLAUDE_PROJECT_DIR:-$(pwd)}" | sha1sum | cut -c1-8)
+  echo "${today}-${project_hash}"
+}
+
+# Safe SQL escape (basic)
+sql_escape() {
+  printf '%s' "$1" | sed "s/'/''/g"
+}

package/Dev/scripts/memory-lifecycle/post-tool.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# PostToolUse hook — log significant tool events (Edit/Write/Bash only per matcher).
+
+set -euo pipefail
+
+SCRIPT_DIR="$(dirname "${BASH_SOURCE[0]}")"
+# shellcheck source=./_db.sh
+source "$SCRIPT_DIR/_db.sh"
+
+if ! command -v sqlite3 &>/dev/null; then
+  echo '{}' ; exit 0
+fi
+
+init_memory_db
+
+SESSION_ID=$(current_session_id)
+NOW=$(date -u -Iseconds)
+
+INPUT=$(cat 2>/dev/null || echo "")
+TOOL_NAME=""
+TARGET=""
+SUMMARY=""
+
+if [[ -n "$INPUT" ]] && command -v jq &>/dev/null; then
+  TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // ""' 2>/dev/null || echo "")
+  TARGET=$(echo "$INPUT" | jq -r '.tool_input.file_path // .tool_input.command // ""' 2>/dev/null | cut -c1-300)
+  SUMMARY=$(echo "$INPUT" | jq -r '.tool_response.summary // ""' 2>/dev/null | cut -c1-300)
+fi
+
+[[ -z "$TOOL_NAME" ]] && { echo '{}'; exit 0; }
+
+sqlite3 "$MEMORY_DB" <<SQL
+INSERT INTO tool_events(session_id, occurred_at, tool_name, target_path, summary)
+VALUES ('$(sql_escape "$SESSION_ID")', '$NOW', '$(sql_escape "$TOOL_NAME")', '$(sql_escape "$TARGET")', '$(sql_escape "$SUMMARY")');
+SQL
+
+echo '{}'

package/Dev/scripts/memory-lifecycle/pre-compact.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+# PreCompact hook — capture critical context before compaction, re-inject it.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(dirname "${BASH_SOURCE[0]}")"
+# shellcheck source=./_db.sh
+source "$SCRIPT_DIR/_db.sh"
+
+if ! command -v sqlite3 &>/dev/null || ! command -v jq &>/dev/null; then
+  echo '{}' ; exit 0
+fi
+
+init_memory_db
+
+SESSION_ID=$(current_session_id)
+NOW=$(date -u -Iseconds)
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+
+# Build preserved context: essentials + recent tool events + recent prompts
+ESSENTIALS=""
+if [[ -f "$PROJECT_DIR/.claude/context-essentials.md" ]]; then
+  ESSENTIALS=$(head -60 "$PROJECT_DIR/.claude/context-essentials.md")
+fi
+
+RECENT_TOOLS=$(sqlite3 "$MEMORY_DB" "SELECT tool_name || ' → ' || COALESCE(target_path,'') FROM tool_events WHERE session_id='$SESSION_ID' ORDER BY occurred_at DESC LIMIT 10;" 2>/dev/null || echo "")
+
+RECENT_PROMPTS=$(sqlite3 "$MEMORY_DB" "SELECT prompt_preview FROM prompts WHERE session_id='$SESSION_ID' ORDER BY submitted_at DESC LIMIT 3;" 2>/dev/null || echo "")
+
+CONTEXT="=== CRITICAL CONTEXT PRESERVED ==="
+[[ -n "$ESSENTIALS" ]] && CONTEXT+=$'\n\n## Project essentials\n'"$ESSENTIALS"
+[[ -n "$RECENT_PROMPTS" ]] && CONTEXT+=$'\n\n## Recent prompts\n'"$RECENT_PROMPTS"
+[[ -n "$RECENT_TOOLS" ]] && CONTEXT+=$'\n\n## Recent tool events\n'"$RECENT_TOOLS"
+
+# Persist
+sqlite3 "$MEMORY_DB" <<SQL
+INSERT INTO compactions(session_id, compacted_at, preserved_context)
+VALUES ('$(sql_escape "$SESSION_ID")', '$NOW', '$(sql_escape "$CONTEXT")');
+SQL
+
+# Re-inject
+jq -n --arg msg "$CONTEXT" '{"systemMessage": $msg}'

package/Dev/scripts/memory-lifecycle/prompt-submit.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# UserPromptSubmit hook — log each user prompt (preview only, no full content).
+
+set -euo pipefail
+
+SCRIPT_DIR="$(dirname "${BASH_SOURCE[0]}")"
+# shellcheck source=./_db.sh
+source "$SCRIPT_DIR/_db.sh"
+
+if ! command -v sqlite3 &>/dev/null; then
+  echo '{}' ; exit 0
+fi
+
+init_memory_db
+
+SESSION_ID=$(current_session_id)
+NOW=$(date -u -Iseconds)
+
+# Read prompt from stdin (Claude Code passes it as JSON)
+INPUT=$(cat 2>/dev/null || echo "")
+PROMPT=""
+if [[ -n "$INPUT" ]] && command -v jq &>/dev/null; then
+  PROMPT=$(echo "$INPUT" | jq -r '.prompt // .user_prompt // ""' 2>/dev/null || echo "")
+fi
+
+# Preview : first 200 chars, sanitized
+PREVIEW=$(printf '%s' "$PROMPT" | tr -d '\n' | cut -c1-200)
+TOKEN_EST=$(( ${#PROMPT} / 4 ))
+
+sqlite3 "$MEMORY_DB" <<SQL
+INSERT INTO prompts(session_id, submitted_at, prompt_preview, token_estimate)
+VALUES ('$(sql_escape "$SESSION_ID")', '$NOW', '$(sql_escape "$PREVIEW")', $TOKEN_EST);
+SQL
+
+echo '{}'

package/Dev/scripts/memory-lifecycle/session-end.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# SessionEnd hook — finalize session, compute summary from tool events + prompts.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(dirname "${BASH_SOURCE[0]}")"
+# shellcheck source=./_db.sh
+source "$SCRIPT_DIR/_db.sh"
+
+if ! command -v sqlite3 &>/dev/null; then
+  echo '{}' ; exit 0
+fi
+
+init_memory_db
+
+SESSION_ID=$(current_session_id)
+NOW=$(date -u -Iseconds)
+
+PROMPT_COUNT=$(sqlite3 "$MEMORY_DB" "SELECT COUNT(*) FROM prompts WHERE session_id='$SESSION_ID';" 2>/dev/null || echo 0)
+TOOL_COUNT=$(sqlite3 "$MEMORY_DB" "SELECT COUNT(*) FROM tool_events WHERE session_id='$SESSION_ID';" 2>/dev/null || echo 0)
+FILES_EDITED=$(sqlite3 "$MEMORY_DB" "SELECT COUNT(DISTINCT target_path) FROM tool_events WHERE session_id='$SESSION_ID' AND tool_name IN ('Edit','Write');" 2>/dev/null || echo 0)
+
+# Top 5 edited files
+TOP_FILES=$(sqlite3 "$MEMORY_DB" "SELECT target_path FROM tool_events WHERE session_id='$SESSION_ID' AND tool_name IN ('Edit','Write') AND target_path != '' GROUP BY target_path ORDER BY COUNT(*) DESC LIMIT 5;" 2>/dev/null | tr '\n' '|' || echo "")
+
+SUMMARY="Session $SESSION_ID: $PROMPT_COUNT prompts, $TOOL_COUNT tool events, $FILES_EDITED files edited. Top: $TOP_FILES"
+
+sqlite3 "$MEMORY_DB" <<SQL
+UPDATE sessions SET ended_at='$NOW', summary='$(sql_escape "$SUMMARY")' WHERE id='$(sql_escape "$SESSION_ID")';
+SQL
+
+echo '{}'

package/Dev/scripts/memory-lifecycle/session-start.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# SessionStart hook — open or reuse today's session row.
+# Output: JSON with systemMessage recalling last session summary (if any).
+
+set -euo pipefail
+
+SCRIPT_DIR="$(dirname "${BASH_SOURCE[0]}")"
+# shellcheck source=./_db.sh
+source "$SCRIPT_DIR/_db.sh"
+
+if ! command -v sqlite3 &>/dev/null; then
+  echo '{}' ; exit 0
+fi
+
+init_memory_db
+
+SESSION_ID=$(current_session_id)
+NOW=$(date -u -Iseconds)
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+
+GIT_BRANCH=$(git -C "$PROJECT_DIR" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
+GIT_COMMIT=$(git -C "$PROJECT_DIR" rev-parse --short HEAD 2>/dev/null || echo "")
+
+sqlite3 "$MEMORY_DB" <<SQL
+INSERT OR IGNORE INTO sessions(id, started_at, project_dir, git_branch, git_commit)
+VALUES ('$(sql_escape "$SESSION_ID")', '$NOW', '$(sql_escape "$PROJECT_DIR")', '$(sql_escape "$GIT_BRANCH")', '$(sql_escape "$GIT_COMMIT")');
+SQL
+
+# Recall last completed session summary (if any)
+LAST_SUMMARY=$(sqlite3 "$MEMORY_DB" "SELECT summary FROM sessions WHERE id != '$SESSION_ID' AND summary IS NOT NULL ORDER BY started_at DESC LIMIT 1;" 2>/dev/null || echo "")
+
+if [[ -n "$LAST_SUMMARY" ]] && command -v jq &>/dev/null; then
+  MSG="📚 Recall from last session:\n\n$LAST_SUMMARY"
+  jq -n --arg msg "$MSG" '{"systemMessage": $msg}'
+else
+  echo '{}'
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-bearded-bear/claude-craft",
-  "version": "7.34.0",
+  "version": "7.35.0",
   "description": "A comprehensive framework for AI-assisted development with Claude Code. Install standardized rules, agents, and commands for your projects.",
   "type": "module",
   "main": "cli/index.js",