beeweave: Skill for Codex

Wiki Status — Audit & Delta

You are computing the current state of the wiki: what's been ingested, what's new since last ingest, and what the delta looks like. This helps the user decide whether to append (ingest the delta) or rebuild (archive and reprocess everything).

Before You Start

1. Resolve config — follow the Config Resolution Protocol in beeweave-core/SKILL.md (inline @name override → walk up CWD for .env → ~/.beeweave/config → prompt setup). This gives BEEWEAVE_VAULT_PATH, BEEWEAVE_WORKBENCH_PATH, CLAUDE_HISTORY_PATH, and CODEX_HISTORY_PATH.
2. Read .manifest.json at the vault root — this is the ingest tracking ledger

The Manifest

The manifest lives at $BEEWEAVE_VAULT_PATH/.manifest.json. It tracks every source file that has been ingested. If it doesn't exist, this is a fresh vault with nothing ingested.

Source keys are canonical absolute paths (~ and env vars expanded). Never mix ~-relative and absolute keys — the same file would be tracked twice and re-ingested. See beeweave-core/SKILL.md → .manifest.json. Repair a mixed manifest with scripts/manifest.py normalize <vault>.

{
  "version": 1,
  "last_updated": "2026-04-06T10:30:00Z",
  "sources": {
    "/absolute/path/to/file.md": {
      "ingested_at": "2026-04-06T10:30:00Z",
      "size_bytes": 4523,
      "modified_at": "2026-04-05T08:00:00Z",
      "source_type": "document",
      "project": null,
      "pages_created": ["concepts/transformers.md"],
      "pages_updated": ["entities/vaswani.md"]
    },
    "/Users/name/.claude/projects/-Users-name-my-app/abc123.jsonl": {
      "ingested_at": "2026-04-06T11:00:00Z",
      "size_bytes": 128000,
      "modified_at": "2026-04-06T09:00:00Z",
      "source_type": "claude_conversation",
      "project": "my-app",
      "pages_created": ["entities/my-app.md"],
      "pages_updated": ["skills/react-debugging.md"]
    }
  },
  "projects": {
    "my-app": {
      "source_path": "/Users/name/.claude/projects/-Users-name-my-app",
      "vault_path": "projects/my-app",
      "last_ingested": "2026-04-06T11:00:00Z",
      "conversations_ingested": 5,
      "conversations_total": 8,
      "memory_files_ingested": 3
    }
  },
  "stats": {
    "total_sources_ingested": 42,
    "total_pages": 87,
    "total_projects": 6,
    "last_full_rebuild": null
  }
}