rpg-audit

rpg-audit — Vault Audit

Run a complete vault audit. Follow the 7 steps below in order.

Run all commands from the vault root (directory containing the regioes/, npcs/, etc. folders).

---

Step 1 — Snapshot (before any modifications)

Ask the user:

"Would you like to make a snapshot commit before continuing?"

If yes:

git add . && git commit -m "snapshot: before audit $(date +%Y-%m-%d)"

---

Step 2 — Deterministic validation

node "${CLAUDE_PLUGIN_ROOT}/scripts/validate.mjs" --vault . --json

Parse the returned JSON. Categorize issues by family:

• schema: missing type, missing required field, invalid enum
• links: broken link (broken-link), orphan entity (orphan)
• coherence: wrong target type (wrong-target-type)

Show a summary: "X error(s), Y warning(s) found."

---

Step 3 — Safe auto-fix (apply without confirmation)

Apply automatically and list each modified file.

3a — Missing or wrong type → infer from folder

For each note with missing-type or type-folder-mismatch in the Step 2 report:

PLUGIN="${CLAUDE_PLUGIN_ROOT}"
node --input-type=module << EOF
import { readFile, writeFile } from 'node:fs/promises';
import { relative } from 'node:path';
import { extractFrontmatter } from "${PLUGIN}/scripts/lib/frontmatter.mjs";
import { inferType, normalizeFrontmatter, stampUpdated } from "${PLUGIN}/scripts/lib/autofix.mjs";
import { serializeFrontmatter } from "${PLUGIN}/scripts/lib/preserve.mjs";
import { typeForFolder } from "${PLUGIN}/scripts/lib/schema.mjs";

const filePath = 'ABSOLUTE_NOTE_PATH';
const raw = await readFile(filePath, 'utf8');
const { frontmatter: fm, body } = extractFrontmatter(raw);
const folder = relative(process.cwd(), filePath).split('/')[0];
const type = typeForFolder(folder);
const note = { type, frontmatter: fm };
const correctedType = inferType(note);
if (correctedType) {
  const newFm = normalizeFrontmatter(stampUpdated({ ...fm, type: correctedType }), correctedType);
  await writeFile(filePath, serializeFrontmatter(newFm) + body, 'utf8');
  console.log('✅ auto-fix type:', filePath);
}
EOF