Commands and File Map
Commands
| Command | Contract |
|---|---|
npm run build | Rebuild generated CSS/icons and runtime checksum ledger transactionally, without stamping |
npm run release:stamp -- <token> | Rebuild and stamp all seven release sites using a fresh single-use token |
npm run check | Verify syntax, six-file release contract, release markers, and checksums |
npm test | Run Node contract tests |
npm run test:browser | Run Playwright browser contracts |
npm run story -- new <slug> [--title <value>] | Scaffold a story without overwrite |
npm run story -- check <slug|--all> [--strict] | Parse and validate story input |
npm run story -- build <slug> | Write canonical story.json |
npm run story -- render <slug> | Atomically rebuild scene SVG previews |
npm run audit:local | Host audit with absent host resources allowed as skips |
npm run audit:production | Strict host/audio/release audit; skips are failures |
(package.json:4-15, scripts/story.mjs:45-50, docs/OPERATIONS.md:62-68)
File ownership
| Path | Owner contract |
|---|---|
index.html | DOM and accessible-control shell |
studio.js | UI orchestration, commands, transport, persistence, audio coordination |
engine.js | v3 model, migration, normalization, evaluation, rendering, SVG export |
project-history.js | immutable revision history and transactions |
asset-cache.js | IndexedDB image/audio storage, keys, quotas, eviction |
studio.source.css | authored stylesheet input |
studio.css | generated committed stylesheet |
scripts/release-manifest.mjs | release-token sites and six-file manifest contract |
scripts/release-transaction.mjs | staged generated-output transaction |
scripts/story.mjs | story lifecycle |
audio-service/ | optional same-origin audio capability |
q5vault/ | source-owned wiki content |
(README.md:19-34, SVG-Animator-BIBLE.md:95-108)