---
name: memento:audit
version: 1.3.0
description: >
  Vault health check. Validates structure, detects stale reasoning artifacts
  by priority level, runs forget, processes inbox, and suggests cleanup.
  Triggers: "vault audit", "check vault", "clean up vault", "process inbox",
  "what's stale", "vault health".
user_invocable: true
---

# /memento:audit

Check structure. Flag staleness. Process inbox. Suggest cleanup.

## Steps

### 1. Structure Check

Verify area-level `_context.md` files exist:
- `Projects/_context.md` (cross-project decisions)
- `Personal/_context.md` (hobbies, health, learning)
- `Business/_context.md` (cross-business decisions)
- `Knowledge/_context.md` (general cross-domain insights)

Verify each project under `Projects/` has:
- `_context.md` (required)
- Active Reasoning Artifacts table in `_context.md`
- Subfolders created on-demand (don't flag missing empty folders)

### 2. Staleness Scan

For each project `_context.md`, check Active Reasoning Artifacts table:

**Expiry check (first — overrides priority-based staleness):**
- Scan for `expires: YYYY-MM-DD` in artifact text
- If past expiry date → flag as **EXPIRED** regardless of priority
- Show: `"EXPIRED: #X — <artifact summary> (expired YYYY-MM-DD). Still valid?"`

**Priority-based staleness (for artifacts without expiry):**

| Priority / State | Age | Action |
|----------|-----|--------|
| critical | > 90 days | Flag for review — ask if invalidation trigger has fired |
| volatile | > 30 days | Flag for resolution — upgrade to critical or delete |
| settled | > 90 days | Suggest archiving to Decisions/ folder |
| noise | Any age | Flag for immediate removal |
| superseded | Any age | Should already be evicted — flag if still in L1 |
| embedded | > 30 days no reference | Decision is in code/config — safe to evict to L2 |
| resolved | Any age | Error that produced a `[D]`/`[I]` — evict, keep the derived artifact |

### 3. Inbox Processing

Check `_inbox/` for unprocessed items. For each:
- Identify type (research, note, decision, reference)
- Route to correct project and subfolder
- Add proper frontmatter
- Update project `_context.md` document index

### 4. Fluff Detection

Flag documents that may be stale or redundant:
- Files with `status: draft` older than 30 days
- Duplicate content across projects
- Documents with no wikilinks (orphaned)
- MOC files with no backlinks (orphaned hubs)
- `experiment-context` files past their teardown date
- `[S]` seeds dormant > 90 days (not activated, not decided)

### 5. Forget

Run forget on the vault to find decisions whose invalidation trigger may have fired:

```bash
python3 "${CLAUDE_SKILL_DIR}/../forget/decay.py" --format json <vault root>
```

List each LIKELY STALE and REVIEW candidate in the report with the signal that flagged it. Mark nothing as superseded here; the user runs `/memento:forget` to go through them one by one.

### 6. Report

```
## Vault Audit — {date}

**Structure:** {OK or issues found}
**Stale artifacts:** {count by priority level}
**Possibly stale decisions (forget):** {LIKELY STALE count} likely, {REVIEW count} to review. Run `/memento:forget` to go through them.
**Inbox:** {count processed, count remaining}
**Suggestions:** {cleanup actions}
```
