vault-update

/vault-anything:vault-update

Incrementally updates an existing vault. Detects code changes via git diff and static-file changes via SHA256 hash, then re-analyzes and rewrites only the pages that need to change.

Arguments

Argument	Default	Description
project-dir	current directory	Project being updated
--workspace	<project>/vault-anything/	Where existing raw/ and vault/ live

---

Phase 0 — Pre-flight

set -e
PLUGIN_ROOT=$(node "$CLAUDE_SKILL_DIR/../vault/resolve-plugin-root.mjs")
WORKSPACE=$(node "$PLUGIN_ROOT/skills/vault/resolve-workspace.mjs" "$@")

PROJECT_DIR=$(echo "$WORKSPACE"  | jq -r '.projectDir')
PROJECT_NAME=$(echo "$WORKSPACE" | jq -r '.projectName')
RAW_DIR=$(echo "$WORKSPACE"      | jq -r '.rawDir')
VAULT_DIR=$(echo "$WORKSPACE"    | jq -r '.vaultDir')
EXISTS=$(echo "$WORKSPACE"       | jq -r '.exists')
VAULT_LANG="en"  # parse from --lang if provided

If $EXISTS is "false":

• Tell the user: No vault found. Run /vault-anything:vault <project-dir> first.
• STOP.

Set up progress tracking

Before running the phases, use the TaskCreate tool to create the task list:

1. Phase 1: Detect changes
2. Phase 2: Re-analyze changed code files
3. Phase 3: Route new static files
4. Phase 4: Regenerate affected pages
5. Phase 5: Review and save

Note that phases 2-4 are conditional:

• Phase 2 is skipped if there are no code changes.
• Phase 3 is skipped if there are no new static files in raw/.
• Phase 4 is skipped if no vault pages are affected.

For each skipped phase, mark its task as cancelled (not completed) so the user can see what was skipped.

Mark each running phase in_progress when it starts, completed when it finishes.

---

Phase 1 — DETECT CHANGES

Mark "Phase 1" as in_progress.

PLAN=$(node "$PLUGIN_ROOT/skills/vault/run-update.mjs" \
  "$PROJECT_DIR" "$RAW_DIR" "$PROJECT_NAME")

CODE_CHANGED=$(echo   "$PLAN" | jq -r '.codeChanges.hasChanges')
RAW_CHANGED=$(echo    "$PLAN" | jq -r '.rawChanges.hasChanges')
FULL_REANALYZE=$(echo "$PLAN" | jq -r '.codeChanges.fullReanalyze')
FULL_GENERATE=$(echo  "$PLAN" | jq -r '.requiresFullGenerate')