release: v0.1.5 — auto-wire SessionStart banner in claude-code installer

Closes the v0.1.4 gap: the SessionStart banner hook (`supamem hook
session-start`) shipped but no installer registered it. v0.1.5 makes
`supamem install --client claude-code` add the SessionStart entry to
~/.claude/settings.json automatically. Idempotent — reinstalling on top
of a v0.1.4 user-home that wired SessionStart by hand is a no-op.

Cursor SessionStart already wires `supamem index --snapshot cursor`;
banner not appended there because Cursor's sessionStart hook fires
shell commands, not MCP additionalContext. OpenCode SessionStart
upstream-pending — installer leaves it as no-op.

233/233 tests green; ruff clean; twine PASSED.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: dzmitrys-dev

CHANGELOG.md

@@ -2,6 +2,30 @@
 
 All notable changes to `supamem` will be documented in this file.
 
+## v0.1.5 — 2026-04-29
+
+`supamem install --client claude-code` now wires the **SessionStart banner**
+hook automatically — closes the v0.1.4 gap where the new `supamem hook
+session-start` command shipped but no installer registered it.
+
+### Changed
+
+- `supamem.install.claude_code` adds a `SessionStart` hook entry to
+  `~/.claude/settings.json` that runs `supamem hook session-start` on
+  every Claude Code session open. Idempotent — reinstalling on top of a
+  v0.1.4 user-home that already has the entry is a no-op.
+
+### Notes
+
+- Cursor SessionStart already wires `supamem index --snapshot cursor` via
+  `.cursor/hooks.json` — the v0.1.4 banner is not appended there because
+  Cursor's `sessionStart` hook fires shell commands (not MCP-context
+  injection); the `supamem live` dashboard remains the visibility surface
+  for Cursor users.
+- OpenCode SessionStart hook contract is still upstream-pending, so the
+  OpenCode installer leaves SessionStart wiring as a no-op until the
+  feature lands. Tracked at github.com/anomalyco/opencode#5409.
+
 ## v0.1.4 — 2026-04-29
 
 Visibility round: gives users observable evidence that supamem is alive

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "supamem"
-version = "0.1.4"
+version = "0.1.5"
 description = "Project-agnostic dual-memory tooling for Claude Code, Cursor, and opencode"
 readme = "README.md"
 license = "MIT"

src/supamem/__init__.py

@@ -1,2 +1,2 @@
 """supamem — project-agnostic dual-memory tooling."""
-__version__ = "0.1.4"
+__version__ = "0.1.5"

src/supamem/install/claude_code.py

@@ -55,7 +55,21 @@
                     }
                 ],
             }
-        ]
+        ],
+        # SessionStart banner (v0.1.5+) — one-line status injected at session
+        # open. Gives users visible evidence supamem is alive without polluting
+        # per-edit flow. Honors SUPAMEM_BANNER_DISABLE=1 if a user opts out.
+        "SessionStart": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "supamem hook session-start",
+                        "timeout": 10,
+                    }
+                ],
+            }
+        ],
     }
 }
 
@@ -70,21 +84,37 @@ def _read_json(path: Path) -> dict[str, Any]:
     return raw if isinstance(raw, dict) else {}
 
 
-def _hook_already_present(settings: dict[str, Any]) -> bool:
-    for entry in settings.get("hooks", {}).get("PreToolUse", []) or []:
+def _hook_present(settings: dict[str, Any], event: str, needle: str) -> bool:
+    """Idempotency check — does any hook under ``event`` already invoke ``needle``?"""
+    for entry in settings.get("hooks", {}).get(event, []) or []:
         for h in entry.get("hooks", []) or []:
-            cmd = str(h.get("command", ""))
-            if "supamem hook claude-code" in cmd:
+            if needle in str(h.get("command", "")):
                 return True
     return False
 
 
+def _hook_already_present(settings: dict[str, Any]) -> bool:
+    """Legacy alias preserved for tests — checks the PreToolUse Edit/Write hook."""
+    return _hook_present(settings, "PreToolUse", "supamem hook claude-code")
+
+
 def _settings_with_hook(existing: dict[str, Any]) -> dict[str, Any]:
-    if _hook_already_present(existing):
-        return existing
+    """Add PreToolUse + SessionStart hooks if absent. Idempotent per event."""
     merged = json.loads(json.dumps(existing))
-    pre = merged.setdefault("hooks", {}).setdefault("PreToolUse", [])
-    pre.extend(HOOKS_OVERLAY["hooks"]["PreToolUse"])
+    hooks_root = merged.setdefault("hooks", {})
+
+    if not _hook_present(merged, "PreToolUse", "supamem hook claude-code"):
+        hooks_root.setdefault("PreToolUse", []).extend(
+            HOOKS_OVERLAY["hooks"]["PreToolUse"]
+        )
+
+    # SessionStart banner (v0.1.5+). Skip if any supamem session-start entry
+    # already exists (covers users who installed v0.1.4 by hand earlier).
+    if not _hook_present(merged, "SessionStart", "supamem hook session-start"):
+        hooks_root.setdefault("SessionStart", []).extend(
+            HOOKS_OVERLAY["hooks"]["SessionStart"]
+        )
+
     return merged