memhook 0.3.0 → 0.4.1

package/dist/src/version.js

@@ -9,5 +9,4 @@
  * the literal in lockstep with `package.json` + `.release-please-manifest.json`.
  * Do not bump it by hand.
  */
-export const MEMHOOK_VERSION = "0.3.0"; // x-release-please-version
-//# sourceMappingURL=version.js.map
+export const MEMHOOK_VERSION = "0.4.1"; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memhook",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Semantic memory router for Claude Code — picks relevant feedbacks & rules per prompt via Haiku, injects them as additionalContext.",
   "type": "module",
   "license": "MIT",
@@ -25,7 +25,9 @@
     "hook",
     "userpromptsubmit",
     "semantic-router",
-    "haiku"
+    "haiku",
+    "skills",
+    "slash-commands"
   ],
   "bin": {
     "memhook": "./dist/bin/memhook.js"
@@ -42,6 +44,7 @@
   },
   "files": [
     "dist",
+    "skills",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"

package/skills/curate/SKILL.md

@@ -0,0 +1,181 @@
+---
+name: curate
+description: Audit and tidy your Claude Code memory directory so memhook routes against a clean catalog. Detects MEMORY.md index drift, unindexed files, semantic duplicates, conflicting overrides, stale entries, and oversized files; proposes merges, deletions, and splits. Proposes only — destructive changes need your approval. Invoke when you want to clean up, consolidate, or audit your memories, or say "/curate".
+disable-model-invocation: true
+allowed-tools: Read Glob Grep Edit Write Bash WebFetch
+argument-hint: [current|all]
+---
+
+# /curate — memory hygiene
+
+A companion skill for [memhook](https://github.com/utilia-ai-wox/memhook).
+memhook only routes well when the memory directory is clean: one fact per file,
+an accurate `MEMORY.md` index, a meaningful `description:` on every file, and no
+duplicates. This skill keeps it that way.
+
+## Objective
+
+Keep the memory directory **minimal and coherent**: `MEMORY.md` reflects exactly
+the files present, no semantic duplicates, no unresolved override conflicts,
+oversized files split, stale entries removed — and the memhook catalog rebuilt
+so routing matches reality.
+
+## Scope
+
+The `$ARGUMENTS` value selects the scope:
+
+| Scope               | Directories                                  |
+| ------------------- | -------------------------------------------- |
+| `current` (default) | `~/.claude/projects/<cwd-sanitised>/memory/` |
+| `all`               | every `~/.claude/projects/*/memory/`         |
+
+If no argument is given, default to `current`.
+
+## Facts to keep in mind
+
+1. **`description:` frontmatter is load-bearing.** `memhook build-catalog` reads
+   the one-line `description:` of each memory file into the catalog, and the
+   router uses it to decide relevance. Any merge / rewrite **must preserve or
+   improve** the `description:`, never strip it.
+2. **`MEMORY.md` is maintained by hand**, not auto-generated — edits stay
+   conservative.
+3. **The first ~200 lines of `MEMORY.md`** load every session; anything beyond
+   is read on demand. Keep it lean.
+4. **Memory files over ~200 lines** should be split into focused topic files,
+   each with its own distinct `description:`.
+5. **The `journal/` subdirectory is out of scope.** `journal/YYYY-MM-DD.md`
+   entries are session logs written by `/wrap`, not topic memories — never flag
+   them as orphaned, stale, or unindexed.
+6. **`feedback_` / `project_` / `rule_` prefixes and a `metadata.type`** are a
+   convention, not a hard requirement — don't force them onto files that don't
+   use them.
+
+## Optional — refresh the official guidance
+
+If the network is available, you may fetch the current Claude Code memory docs
+to confirm size limits and best practices:
+
+- `https://code.claude.com/docs/en/memory`
+
+This is **optional and non-blocking**: if the fetch fails, proceed on the
+conventions in this skill. Never abort the audit just because a doc fetch failed.
+
+## Process (7 steps)
+
+See [reference.md](reference.md) for the detection heuristics (duplicate
+similarity, split criteria, override handling, backup template).
+
+### 1. Inventory
+
+```bash
+# Exclude journal/ — those are session logs, not topic memories.
+find <scope-dir> -maxdepth 1 -name '*.md' -type f
+```
+
+For each file: line count, bytes, frontmatter (`name`, `description`, `type`),
+the H1 title, last-modified time. Read `MEMORY.md` in full and extract every
+indexed entry (`- [Title](file.md)`).
+
+### 2. Detect problems
+
+Five classes (heuristics in [reference.md](reference.md)):
+
+- **Index ↔ filesystem sync** — entry in `MEMORY.md` pointing at a missing file
+  (orphan); a `*.md` file present but absent from `MEMORY.md` (unindexed).
+- **Line budget** — `MEMORY.md` > 200 lines, or a memory file > 200 lines.
+- **Semantic duplicates** — near-identical H1 titles, or two files saying the
+  same thing in different words.
+- **Override conflicts** — two `feedback_*` files that contradict each other with
+  no explicit override declared. Flag as unresolved; ask the user.
+- **Stale entries** — a `project_*` memory past its deadline with no "resolved"
+  note, or a reference to a file / function that no longer exists (verify with
+  Grep before proposing removal).
+
+### 3. Plan
+
+```markdown
+## Curate plan for <scope>
+
+### Delete — file.md (orphan)
+
+### Add to index — other.md (present but unindexed, topic = X)
+
+### Merge — a.md + b.md → a.md (semantic duplicate, ~85% overlap)
+
+### Split (>200ln) — big.md → big-topic1.md + big-topic2.md
+
+### Unresolved conflicts (need your decision)
+
+- feedback_A.md vs feedback_B.md: contradiction on <subject>
+
+### Leave as-is — <list>
+```
+
+### 4. Approval
+
+Wait for the go-ahead. Apply non-conflicting changes once approved; **override
+conflicts always require an explicit user decision** (an override encodes human
+intent).
+
+### 5. Apply
+
+- **Delete**: remove the file (report each deletion).
+- **Merge**: create the merged file, delete the sources. Keep the most precise
+  `description:` (or write a better one — it drives routing, not just humans).
+- **Split**: create topic files (each with its own distinct `description:`),
+  trim the original, update `MEMORY.md`.
+- **Index**: Edit `MEMORY.md`, preserving existing sections.
+- **Rebuild the catalog after any destructive change** so the router stops
+  pointing at deleted files (and picks up new ones):
+
+  ```bash
+  memhook build-catalog
+  ```
+
+  Log the rebuild in the final report.
+
+### 6. Report
+
+```markdown
+# Curate report
+
+**Scope**: <path> **Date**: <ISO>
+
+## Before → After
+
+- files: N → N' total lines: M → M' index entries: K → K'
+- problems: O → 0 orphan, 0 unindexed
+
+## Changes
+
+<table>
+
+## Unresolved conflicts (still open)
+
+<list>
+```
+
+## Rules
+
+- **Preserve `description:`** on every file — it is what memhook routes on.
+- **Never touch `journal/`** — session logs, out of scope.
+- **Always rebuild the catalog** (`memhook build-catalog`) after delete / merge /
+  split / create.
+- **Never delete a memory** without stating the reason (and keeping a backup —
+  see [reference.md](reference.md)).
+- **Never resolve an override conflict** without user validation.
+- **Source every "stale" claim** with a Grep that proves the reference is dead.
+
+## Anti-patterns
+
+- Stripping a `description:` (breaks memhook routing silently).
+- Flagging `journal/` files as orphaned or stale.
+- Forgetting the catalog rebuild — leaves the router pointing at deleted files.
+- Forcing a frontmatter convention onto files that never used it.
+- Resolving a contradiction the user explicitly declared as an override.
+
+## Related skills
+
+- `/wrap` — end-of-session capture; run `/curate` periodically to tidy what it
+  accumulates.
+- `/relay` — generate a handoff prompt for a fresh session.

package/skills/curate/reference.md

@@ -0,0 +1,105 @@
+# /curate — detection heuristics
+
+Detailed reference for the `/curate` skill. Loaded on demand, so it can be as
+long as it needs to be without costing context on every prompt.
+
+## Semantic duplicate detection
+
+Two memory files are candidate duplicates when **any** of these hold:
+
+- **Title near-match** — normalise both H1 titles (lowercase, strip punctuation,
+  collapse whitespace); a Levenshtein distance < 3 is a strong signal.
+- **Same claim, different words** — both assert the same rule or fact (e.g. two
+  files that both say "never force-push to main"). Read both bodies; if one is a
+  strict superset of the other, the narrower one is redundant.
+- **Same target** — both files govern the same file / command / workflow and
+  give the same guidance.
+
+When duplicates are found, propose a **merge** (not a blind delete):
+
+1. Keep the file whose `description:` is the most precise router hint — or write
+   a better combined `description:` than either had.
+2. Fold any unique detail from the other file into the kept one.
+3. Delete the redundant file and fix its `MEMORY.md` entry.
+
+Do **not** auto-merge files that merely share a topic but make _different_
+points — overlap is not duplication.
+
+## Split criteria (files > ~200 lines)
+
+A memory file should hold roughly one fact or one coherent topic. Split when:
+
+- It exceeds ~200 lines, **and**
+- It contains two or more independently-routable topics (each could be relevant
+  to a different prompt on its own).
+
+When splitting:
+
+- Give each resulting file a **distinct, specific `description:`** — generic
+  descriptions ("notes about the project") make routing useless.
+- Trim the original to the remaining topic, or delete it if fully redistributed.
+- Update `MEMORY.md`: one index line per resulting file.
+- Rebuild the catalog afterwards.
+
+Do **not** split a long-but-single-topic file just to hit a line count — a
+coherent 250-line doctrine file is fine.
+
+## Override conflicts
+
+Two `feedback_*` files conflict when they give contradictory instructions for
+the same situation (e.g. one says "always ask before committing", another says
+"commit without asking").
+
+- If one file **explicitly declares** it overrides the other (a line like
+  "overrides feedback_X"), that is intentional — leave it.
+- Otherwise, **flag it as unresolved** and surface both to the user. An override
+  encodes human intent; never pick a winner automatically.
+
+Present a conflict like this:
+
+```markdown
+### Unresolved conflict
+
+- feedback_A.md: "<verbatim instruction>"
+- feedback_B.md: "<verbatim contradicting instruction>"
+  → Which wins? (or declare an explicit override in one of them)
+```
+
+## Stale-entry detection
+
+A memory is a stale candidate when:
+
+- It is a `project_*` memory referencing a **deadline or date that has passed**
+  with no "resolved" / "done" marker, **or**
+- It references a **file, function, route, or symbol that no longer exists** —
+  prove this with a `Grep` across the relevant repo before proposing removal.
+
+Always prefer **update over delete** when the underlying fact still matters but
+the details drifted.
+
+## Backup before destructive changes
+
+Before a delete / merge / split, keep a local backup so a mistaken curation is
+recoverable:
+
+```bash
+# Timestamped copy alongside the file, ignored by the catalog (not *.md in the
+# memory dir root).
+cp memory/feedback_x.md "/tmp/curate-backup-$(date +%Y%m%dT%H%M%S)-feedback_x.md"
+```
+
+State each backup path in the final report. These backups live outside the
+memory directory, so `memhook build-catalog` never indexes them.
+
+## Why the catalog rebuild is mandatory
+
+`memhook build-catalog` regenerates the one-line-per-file catalog that the
+router feeds to its model. If you delete or rename a memory and skip the
+rebuild:
+
+- the router may still pick a basename that no longer exists on disk (the
+  router treats that as `all_unfound` and injects nothing), and
+- a freshly-added memory stays invisible until the next rebuild.
+
+So: any create / delete / merge / split → `memhook build-catalog` immediately,
+and note it in the report.

package/skills/relay/SKILL.md

@@ -0,0 +1,162 @@
+---
+name: relay
+description: Generate a self-contained prompt to resume your work in a fresh Claude Code session. Anchors every fact on real state (current branch, commits since session start, uncommitted files, open PRs, today's journal). Read-only — writes nothing; the output is a copy-paste block. Invoke when the context is saturated but work continues, or say "/relay". Pairs with /wrap.
+disable-model-invocation: true
+allowed-tools: Read Glob Grep Bash
+argument-hint: [optional note — a topic or next step to prioritise]
+---
+
+# /relay — handoff to a fresh session
+
+A companion skill for [memhook](https://github.com/utilia-ai-wox/memhook). When
+the current session's context fills up but the work isn't finished, `/relay`
+produces a **ready-to-paste prompt** so a new Claude Code session can pick up
+exactly where this one stopped — without access to this session's history.
+
+Typical flow:
+
+```
+1. Current session: work in progress, context filling up
+2. /wrap   → capture lessons into memory + journal
+3. /relay  → generate a prompt to resume in a fresh session
+4. Paste the block into a new Claude Code session
+```
+
+If the session is genuinely finished (nothing to resume), `/wrap` alone is
+enough — `/relay` is for when work remains but this context must be abandoned.
+
+## Cardinal constraint — writes nothing
+
+**`/relay` never writes to disk.** Its only output is a text block shown to you.
+No Edit, no Write. Idempotent by construction: re-run it any time and it
+reflects the state at that moment.
+
+## Scope — read-only, every fact sourced
+
+Each fact in the generated prompt must be anchored on a real source:
+
+| Source            | Tool                                                          | What to capture                     |
+| ----------------- | ------------------------------------------------------------- | ----------------------------------- |
+| Current branch    | `git -C "$(pwd)" branch --show-current`                       | Branch name                         |
+| Session commits   | `git -C "$(pwd)" log --since=<start> --oneline`               | Verbatim — not paraphrased          |
+| Uncommitted files | `git -C "$(pwd)" status --short`                              | Exact list                          |
+| Work-in-progress  | `git -C "$(pwd)" stash list`                                  | Any stashed WIP                     |
+| Today's journal   | `~/.claude/projects/<project>/memory/journal/YYYY-MM-DD.md`   | Decided / Learned / Blocked         |
+| Open PRs          | `gh pr list --author @me --state open` (if `gh` is available) | URLs + titles + CI state            |
+| User note         | the `$ARGUMENTS` hint                                         | Explicit priority for the next step |
+
+Out of scope: reading application code in depth — the resuming session
+re-explores that itself. Never infer a fact you can't source.
+
+## Workflow
+
+### Phase 1 — capture state
+
+```bash
+cd "$(pwd)"
+git branch --show-current
+git status --short
+git log --since="<session_start>" --oneline   # session_start: oldest .claude/ mtime, else last few hours
+git stash list
+```
+
+If `gh` is installed and authenticated, also capture open PRs and their CI
+state. If it isn't, omit that section rather than guessing.
+
+### Phase 2 — infer the next step
+
+In priority order:
+
+| Signal                                      | Inferred next step                                            |
+| ------------------------------------------- | ------------------------------------------------------------- |
+| `$ARGUMENTS` note provided                  | The user's note wins — put it at the top of "next step"       |
+| Uncommitted changes on a feature/fix branch | Finish the in-progress commit (cite the files)                |
+| Open PR with failing CI                     | Investigate the failure (cite the run URL + failing step)     |
+| Open PR awaiting review                     | Wait / respond to review comments                             |
+| Today's journal says "Blocked: X"           | Unblock X first                                               |
+| Nothing clear                               | "Audit the state and decide direction" — honest, not invented |
+
+### Phase 3 — write the prompt
+
+Output format (the final block is the copy-paste payload):
+
+````markdown
+## Resume prompt — generated <ISO date>
+
+Source: /relay from <repo> on branch `<branch>`
+
+---
+
+```
+You are resuming a work session interrupted at <ISO date>.
+The previous session was wrapped (memory + journal are up to date).
+This context is fresh — re-load whatever you need with your tools.
+
+## Where things stand (verbatim at handoff)
+
+Repo:   <path>
+Branch: <branch>
+Open PR(s): <urls or "none">
+
+### git status
+<verbatim `git status --short`>
+
+### Recent commits this session
+<verbatim `git log --oneline`, de-duplicated>
+
+### Today's journal
+<Decided / Learned / Blocked, if the entry exists>
+
+## What's left to do
+<inferred next step — cite the source: "3 uncommitted files on branch X",
+ or "PR #N CI failing at step Y", or the user's note>
+
+### First concrete action
+<an exact command or a precise instruction — e.g. `/wrap`, or
+ `gh run view <id> --log-failed`, or "finish the commit for <files>">
+
+## User note (explicit priority)
+<the $ARGUMENTS note, verbatim — omit this section if none was given>
+```
+
+---
+
+Copy the block between the `---` markers into a new Claude Code session.
+If anything is missing or wrong, tell me and I'll regenerate.
+````
+
+### Phase 4 — self-check before showing
+
+Re-read the generated prompt:
+
+1. Does **every** factual line have a verbatim source? If not → re-capture.
+2. Is it truly **self-contained**? The new session must resume with only its
+   tools + this prompt.
+3. Is the "first concrete action" **unambiguous**? If it's a placeholder, say so
+   and ask the user to specify.
+4. Are there **no implicit references** to this session ("as we saw", "the bug
+   from earlier")?
+
+If any check fails, rewrite — don't show it.
+
+## Rules
+
+- **Writes nothing** — output is a text block only.
+- **Source every fact verbatim** — no paraphrase, no invention.
+- **Cap output at ~200 lines** — if it's longer, the work should be split across
+  two sessions.
+- **The `$ARGUMENTS` note wins** over inference for the next step.
+- **No git or `gh` mutations** — strictly read-only.
+
+## Anti-patterns
+
+- Inventing a branch, PR, or task to look complete.
+- Paraphrasing a commit message instead of quoting it.
+- Implicit references the new session can't resolve ("you know what we were doing").
+- A vague next action ("continue the work") with no command or scope.
+- Writing to any file (this skill is output-only).
+
+## Related skills
+
+- `/wrap` — run it **before** `/relay` to capture the session's lessons.
+- `/curate` — periodic memory hygiene.

package/skills/wrap/SKILL.md

@@ -0,0 +1,173 @@
+---
+name: wrap
+description: End-of-session wrap-up for Claude Code. Detects what changed during the session (git commits, working-tree edits, new/edited memory & rule files) and proposes structured updates to your memory directory, MEMORY.md index, and a dated journal entry. Proposes only — never writes without your approval. Invoke at the end of a work session, when you say "wrap up", "end session", or "/wrap".
+disable-model-invocation: true
+allowed-tools: Read Glob Grep Bash Edit Write
+argument-hint: [optional one-line note about the session]
+---
+
+# /wrap — end-of-session wrap-up
+
+A companion skill for [memhook](https://github.com/utilia-ai-wox/memhook).
+memhook routes your `feedback_*.md` / `project_*.md` / `rule_*.md` files into
+each prompt; this skill keeps that memory current. Run it at the end of a
+session so the lessons of the session are captured before the context is gone.
+
+## Objective
+
+Close the session loop: collect what changed (commits, working-tree edits,
+detected lessons), propose a set of structured updates to **your memory
+system** (memory files, `MEMORY.md` index, a dated journal entry), and let
+**you** approve each one before anything is written.
+
+## Cardinal constraint — nothing is written without approval
+
+**No file is modified before explicit user approval.** The skill produces a
+report and a plan; you approve, reject, or amend each proposal. It is
+idempotent: running it again after a session is already wrapped should produce
+an empty or minimal report.
+
+## Scope
+
+This skill touches **memory + doctrine + journal** only. It never edits your
+application code (`src/`, `apps/`, `packages/`, tests).
+
+| Category      | Path                                           | What to detect                                              |
+| ------------- | ---------------------------------------------- | ----------------------------------------------------------- |
+| Memory        | `~/.claude/projects/<project>/memory/*.md`     | New lessons to capture; `MEMORY.md` index drift             |
+| Global rules  | `~/.claude/rules/*.md`                         | A rule edited this session; an anti-pattern worth recording |
+| Project rules | `<repo>/.claude/rules/*.md`                    | Same, scoped to the current repo                            |
+| Journal       | `~/.claude/projects/<project>/memory/journal/` | Today's journal entry missing after a real session          |
+| Skills        | `~/.claude/skills/*/SKILL.md`                  | A repeated pattern worth formalising into a skill           |
+
+The `<project>` directory is the sanitised form of the current working
+directory used by Claude Code (e.g. `/Users/me/dev/app` →
+`-Users-me-dev-app`). When unsure, glob `~/.claude/projects/*/memory/` and pick
+the one matching the cwd.
+
+## Workflow
+
+### Phase 1 — capture session state
+
+1. **Estimate session start.** Heuristic: the oldest mtime among files touched
+   under `.claude/` this session, or fall back to the last few hours.
+
+2. **List commits made during the session** in the current repo:
+
+   ```bash
+   git -C "$(pwd)" log --since="<session_start>" --oneline
+   ```
+
+3. **List changed / created files:**
+   - `git -C "$(pwd)" status --short` (uncommitted)
+   - `git -C "$(pwd)" log --name-only --since="<session_start>"` (committed)
+   - `find ~/.claude/rules ~/.claude/skills -newer <marker>` (global doctrine)
+   - `find ~/.claude/projects/<project>/memory -maxdepth 1 -name '*.md' -newer <marker>` (memory)
+
+4. **Cross-reference each change** to a cause: which decision motivated a rule
+   edit? Which lesson does a new memory capture? A correction repeated 3+ times
+   is a candidate anti-pattern worth formalising.
+
+### Phase 2 — detect weak signals
+
+For each category, ask what _should_ be recorded but isn't:
+
+| Signal                                                     | Proposed action                                                        |
+| ---------------------------------------------------------- | ---------------------------------------------------------------------- |
+| A technical decision made in conversation with no trace    | Propose a `project_*.md` memory                                        |
+| A user preference expressed ("stop doing X") with no trace | Propose a `feedback_*.md` memory                                       |
+| A correction repeated 3+ times                             | Propose an anti-pattern note in the relevant rule                      |
+| A rule mentions something the code no longer contains      | Propose trimming the stale mention (verify with Grep first)            |
+| Today's journal entry missing after a real session         | Propose `journal/YYYY-MM-DD.md` (Decided / Learned / Blocked, ≤ 50 ln) |
+
+### Phase 3 — structured report
+
+Present a single report:
+
+````markdown
+## Session wrap — YYYY-MM-DD HH:MM (duration ~Xh)
+
+### Activity
+
+- Commits: N in <repo>
+- System files touched: P rules, Q memory, R skills
+- Note: "<optional argument>"
+
+### Signals detected (N proposals)
+
+1. **[CATEGORY]** what was detected
+   - Source: <file:line or commit hash>
+   - Action: create / edit / delete
+   - Target: <path>
+   - Diff:
+     ```diff
+     - <old>
+     + <new>
+     ```
+
+### Approval
+
+- "ok 1, 2, 5" → apply 1, 2, 5
+- "ok all" → apply everything
+- "skip 3" → leave it out
+- "change X…" → adjust before applying
+````
+
+### Phase 4 — apply approved changes
+
+For each approved proposal:
+
+- Read the target (when editing), then Edit / Write the exact approved diff.
+- A new memory file **must keep a one-line `description:` in its frontmatter**
+  — memhook's catalog and router read that line to decide relevance, so an
+  empty or missing description makes the memory invisible to routing.
+- A journal entry uses three fixed sections (Decided / Learned / Blocked),
+  capped at ~50 lines.
+- **After any memory create / edit / delete, rebuild the catalog** so memhook
+  routes against the new state:
+
+  ```bash
+  memhook build-catalog
+  ```
+
+- Add the new memory to the `MEMORY.md` index (one line: `- [Title](file.md)`).
+- **Never commit automatically** — the user keeps control of the git message and scope.
+
+### Phase 5 — recap
+
+```markdown
+## Applied
+
+- ✅ memory/feedback_x.md created (+ MEMORY.md index + catalog rebuilt)
+- ✅ ~/.claude/rules/y.md: stale mention removed
+- ✅ journal/2026-06-02.md created
+
+## To commit (your call)
+
+git add … && git commit -m "…"
+```
+
+## Rules
+
+- **Explicit approval required** — `/wrap` writes nothing without confirmation.
+- **Idempotent** — re-running after a wrapped session yields an empty report.
+- **Cap the report at ~200 lines** — if there are > 10 proposals, batch and
+  prioritise (high / medium / low).
+- **Source every signal** on a real `file:line` or commit hash — never invent one.
+- **Preserve `description:`** on every memory file (load-bearing for memhook).
+- **Rebuild the catalog** (`memhook build-catalog`) after memory changes.
+- **No automatic commits** — leave the final git decision to the user.
+
+## Anti-patterns
+
+- Writing to the memory system without approval.
+- Proposing 30 trivial edits instead of a prioritised handful.
+- Inventing a signal with no verifiable source.
+- Editing application code (out of scope).
+- Forgetting the catalog rebuild after deleting or merging a memory.
+
+## Related skills
+
+- `/curate` — periodic memory hygiene (dedupe, stale, index sync). Chains well
+  after `/wrap`.
+- `/relay` — generate a handoff prompt to continue in a fresh session.

package/dist/bin/memhook.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memhook.d.ts","sourceRoot":"","sources":["../../bin/memhook.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/bin/memhook.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"memhook.js","sourceRoot":"","sources":["../../bin/memhook.ts"],"names":[],"mappings":"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"}

package/dist/src/ansi.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../../src/ansi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,WAAW,GAAG,OAAO,CAMjE;AAED,uDAAuD;AACvD,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;CAeD,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,KAAK,CAAC;AAE3C,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAehD;AAKD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,6DAA6D;AAC7D,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD"}