alive:mine-for-context

Mine

Deep extraction. Turn raw sources into structured context.

Not a quick search (that's find). Not session timeline (that's history). Mine is the heavy operation — reading source material systematically, extracting everything of value, and routing it into the world.

---

When It Fires

• The human says "mine this", "extract from these", "what's buried in here"
• alive:session-history escalates — "these sessions look rich, want to deep-mine them?"
• The human points at a folder of transcripts, documents, or exports
• A bundle has raw sources that haven't been fully processed
• The human asks "what have I missed?" or "find everything about X in my sources"

---

What It Does

0. Pre-check: Source Location

Before mining, check whether the source file lives inside a bundle's raw/ folder:

• In a bundle — proceed normally. Phase 4 tracking writes to that bundle's context.manifest.yaml discovered: field.
• Loose file (inbox, walnut root, or anywhere without a manifest) — enter loose-mine mode. Mining still works, but tracking state writes to $WORLD_ROOT/.alive/_mining-log.json instead of a bundle manifest. This prevents duplicate work if the same file is mined again before being captured into a bundle.

// .alive/_mining-log.json — created on first loose mine
{
  "mined": [
    {
      "path": "03_Inbox/Will x Ben Standup.md",
      "mined_at": "2026-04-16T10:30:00Z",
      "items_extracted": 14,
      "routed_to": "alive-os"
    }
  ]
}

If the file appears in _mining-log.json already, warn: "This file was mined on {date} ({N} items extracted). Mine again or skip?"

1. Assess Source Material

Scan what's available. Don't read everything — just understand the landscape.

╭─ squirrel scanning sources
│
│  client-calls/raw/ — 12 transcripts (3 unprocessed)
│  research/raw/ — 8 documents (5 unprocessed)
│  .alive/_squirrels/ — 23 sessions (8 with rich stash, 4 unmined transcripts)
│
│  Total: 43 sources, 12 unprocessed, 4 unmined sessions
╰─