rpg-preserve

rpg-preserve — Write Gate

You are the single write point of the RPG vault. No entity is written to disk without passing validation. Contract: validate → pass? write : ask.

Mandatory workflow

1. Determine target folder and path

Use targetPath from lib/preserve.mjs. The folder is defined by the schema:

Type	Folder
regiao	regioes/
local	locais/
npc	npcs/
jogador	jogadores/
inimigo	inimigos/
faccao	faccoes/
quest	quests/
sessao	sessoes/
evento	eventos/
ato	atos/
item	itens/
lore	lore/
frente	frentes/
relogio	relogios/
encontro	encontros/

2. Build frontmatter and content

Use buildFrontmatter(type, fields) and buildNoteContent(fm, name) from lib/preserve.mjs.

Mandatory formatting rules:

• Fields with wikilink: always "[[Entity Name]]" (quotes + brackets)
• List of wikilinks: YAML block with one item per line ( - "[[Name]]")
• Default status when not specified: stub
• updated is automatically stamped with today's date

3. Validate the candidate (REQUIRED before writing)

PLUGIN="${CLAUDE_PLUGIN_ROOT}"
node --input-type=module << EOF
import { buildFrontmatter, buildNoteContent, validateCandidate }
  from "${PLUGIN}/scripts/lib/preserve.mjs";
const vaultDir = process.cwd();
const fm = buildFrontmatter('TYPE', { /* fields */ });
const content = buildNoteContent(fm, 'NAME');
const report = await validateCandidate('NAME', content, 'TYPE', vaultDir);
console.log(JSON.stringify(report, null, 2));
EOF

4. Decision based on the report

If report.summary.errors === 0 → write:

PLUGIN="${CLAUDE_PLUGIN_ROOT}"
node --input-type=module << EOF
import { buildFrontmatter, buildNoteContent, writeEntityFile }
  from "${PLUGIN}/scripts/lib/preserve.mjs";
const vaultDir = process.cwd();
const fm = buildFrontmatter('TYPE', { /* fields */ });
const content = buildNoteContent(fm, 'NAME');
const path = await writeEntityFile('TYPE', 'NAME', content, vaultDir);
console.log('Created at: ' + path);
EOF