alive-cleanup

name	alive-cleanup
description	System maintenance -- stale tasks, orphan folders, unsaved sessions, world health check
version	1.0.0
author	ALIVE Context System
license	MIT
toolsets	["terminal","file"]
triggers	["cleanup","system cleanup","tidy up","maintenance","health check"]
metadata	{"hermes":{"tags":["ALIVE","context","cleanup","maintenance"]}}

System Cleanup

Scan across all walnuts for entropy. Surface issues one at a time.

Checks

1. Unsaved Sessions

grep -l "saves: 0" "$ALIVE_WORLD_ROOT/.alive/_squirrels/"*.yaml 2>/dev/null

For each: check transcript file size before dismissing. saves: 0 + stash: [] does NOT mean empty -- the stash is only written at save.

[N] unsaved sessions found.
  [id] -- [date] -- [walnut] -- transcript: [size]

Review transcripts for lost work?
  1. Yes, check them all
  2. Show me the list first
  3. Clear and move on

2. Stale Bundles

Find bundles in draft status unchanged for 30+ days:

find "$ALIVE_WORLD_ROOT" -name "context.manifest.yaml" -mtime +30 2>/dev/null

For each stale bundle:

"[bundle-name]" has been in draft for [N] days.
  1. Advance it (prototype/published)
  2. Archive it (set status: done)
  3. Kill it (delete -- drafts are disposable)
  4. Leave it

3. Stale Walnuts

Walnuts past 2x their rhythm with no recent sessions:

[walnut] -- waiting -- [N] days past weekly rhythm
  1. Load it (check what's there)
  2. Archive it (move to 01_Archive)
  3. Update rhythm (maybe it's monthly now)
  4. Leave it

4. Empty Tasks

Walnuts with stale or empty task files:

find "$ALIVE_WORLD_ROOT" -name "tasks.json" -exec python3 -c "
import json, sys
data = json.load(open(sys.argv[1]))
tasks = data.get('tasks', [])
active = [t for t in tasks if t.get('status') not in ('done', 'archived')]
if active:
    print(f'{sys.argv[1]}: {len(active)} open tasks')
" {} \;

5. Legacy Structure Detection

Look for v1/v2 patterns that should be migrated:

• _core/ directories (v1)
• _kernel/_generated/ directories (v2)
• now.md files (v1)
• tasks.md files (v1)

Found [N] walnuts with legacy structure.
  1. Migrate now
  2. Show me which ones
  3. Skip

One at a Time

Surface issues one at a time. Don't overwhelm. Fix one, then ask if they want to continue.