scriveno 2.0.12 → 2.6.0

package/docs/configuration.md

@@ -57,22 +57,47 @@ When a writer runs `/scr:new-work`, Scriveno creates `.manuscript/config.json`.
 
 ```json
 {
-  "scriveno_version": "2.0.12",
+  "scriveno_version": "2.6.0",
   "work_type": "<chosen>",
   "group": "<group>",
   "command_unit": "<unit>",
   "developer_mode": false,
   "created_at": "<ISO timestamp>",
+  "updated_at": "<ISO timestamp>",
   "autopilot": {
     "enabled": false,
-    "profile": "guided"
+    "profile": "guided",
+    "custom_checkpoints": []
+  },
+  "voice": {
+    "calibrated": false,
+    "last_calibration": null,
+    "drift_threshold": 0.3
+  },
+  "draft": {
+    "rigor": "standard",
+    "context_profile": "standard",
+    "pitfalls_enabled": true
+  },
+  "export": {
+    "default_format": "docx_manuscript",
+    "include_front_matter": true,
+    "include_back_matter": true
+  },
+  "translation": {
+    "source_language": "en",
+    "target_languages": []
+  },
+  "collaboration": {
+    "tracks_enabled": false,
+    "default_track": "canon"
   }
 }
 ```
 
 That `scriveno_version` value should track the current package release and the live `/scr:new-work` contract, not an older milestone snapshot.
 
-Every project gets those core keys. Additional blocks are added only when the work type requires them.
+Every project gets those core keys and shared blocks (`autopilot`, `voice`, `draft`, `export`, `translation`, `collaboration`). The `voice.drift_threshold` default of 0.3 is the voice-drift gate: drift is `(100 - score) / 100`, so 0.3 offers a re-draft when the voice score falls below 70 (see [Drafter Quality](drafter-quality.md) and `agents/voice-checker.md`). Additional blocks are added only when the work type requires them: a `technical` block for technical writing, top-level sacred profile keys for sacred work types, and `platform` for work types with an inferred publishing target.
 
 ### Technical writing projects
 

package/docs/contributing.md

@@ -19,7 +19,7 @@ templates/             Base project templates + technical/ and sacred/ variants
 templates/technical/   6 technical-writing context variants
 templates/sacred/      Sacred-specific context templates and tradition manifests
 bin/install.js         Multi-platform installer (Node.js)
-docs/                  Documentation suite (16 guides)
+docs/                  Documentation suite (25 guides)
 ```
 
 Key principle: the AI agent reads these files at runtime. There is no compilation, no bundling, no transpilation. If you can write markdown, you can contribute.
@@ -343,7 +343,7 @@ The export command (`commands/scr/export.md`) needs to know about your format. A
 
 ### Step 3: Add CONSTRAINTS.json entry (if restricted)
 
-If your export format is only available for certain work types, add an entry to the `"export_formats"` section of CONSTRAINTS.json with an `available_for` array specifying which work type groups can use it.
+If your export format is only available for certain work types, add an entry to the `"exports"` section of CONSTRAINTS.json with an `available` array specifying which work type groups can use it (or `["all"]` for universal formats).
 
 ## Testing Your Changes
 

package/docs/drafter-quality.md

@@ -104,7 +104,7 @@ Rough guidance for matching settings to model class. The writer's experience wit
 | Mid-tier (Sonnet 4.x, GPT-4 mini, Haiku 4.x) | Day-to-day drafting, most novels and screenplays | `standard` | `standard` |
 | Budget (Haiku, GPT-3.5, local 7-13B) | Bulk drafting of short scenes, repetitive structural work | `strict` | `minimal` |
 
-If voice fidelity drops below the writer's `voice.drift_threshold`, the first lever is `rigor: strict`. The second is to step up a model tier. The third is to recalibrate STYLE-GUIDE.md via `/scr:voice-test`.
+If voice fidelity drops below the writer's `voice.drift_threshold` (a voice-checker score below 70 at the default 0.3, where drift is `(100 - score) / 100`), the first lever is `rigor: strict`. The second is to step up a model tier. The third is to recalibrate STYLE-GUIDE.md via `/scr:voice-test`.
 
 ## Token economy
 

package/docs/getting-started.md

@@ -22,12 +22,13 @@ npx scriveno@latest
 
 This installs Scriveno into the runtime you choose. Command-directory and skills targets place files where the runtime expects them. Guided targets like Perplexity Desktop instead write setup assets and show the exact connector steps you need. Takes about 30 seconds.
 
-Once installed, Claude Code uses flat `/scr-*` commands such as `/scr-help` and `/scr-new-work`. Other command-directory runtimes currently keep `/scr:*`. Codex uses generated `$scr-*` skills such as `$scr-help` and `$scr-new-work`. Guided targets explain their supported setup path directly in the generated setup files.
+Once installed, Claude Code uses flat `/scr-*` commands such as `/scr-help`, `/scr-first-run`, and `/scr-new-work`. Other command-directory runtimes currently keep `/scr:*`. Codex uses generated `$scr-*` skills such as `$scr-help`, `$scr-first-run`, and `$scr-new-work`. Guided targets explain their supported setup path directly in the generated setup files.
 
 You can also ask Scriveno for a read-only project status from any terminal:
 
 ```
 scriveno status --project .
+scriveno first-run --project .
 scriveno status . --json
 scriveno status --project . --apply-safe
 scriveno sync --check
@@ -37,6 +38,8 @@ That status command is the same shared auto-invoke engine used by `/scr-next`, `
 
 Use `--apply-safe` when you want Scriveno to run the read-only checks and show which helpers are safe, skipped, or agent-ready. Use `sync --check` when you want the installed runtime surfaces checked too.
 
+If you want one guided proof path instead of separate checks, start with `scriveno first-run --project .`.
+
 ## Step 2: Explore the Demo (Optional)
 
 Not sure what Scriveno does? Try the demo before starting your own project:

package/docs/proof-artifacts.md

@@ -5,6 +5,7 @@ This document is the canonical index of Scriveno's proof layer. It points to con
 ## Start Here
 
 - Read **Quick Proof** if you want one 10-minute route through installation checks, demo inspection, runtime command shapes, and the next draft command.
+- Read **First-Run Proof** if you want the committed transcript artifact for `/scr:first-run`, `scriveno first-run --project .`, runtime smoke, and the demo flow.
 - Read the **Watchmaker Sample Flow** if you want one end-to-end writing workflow from setup through drafts, review, and next step.
 - Read **Voice DNA** if you want the shortest possible proof of how style guidance changes output on the same brief.
 - Read **Creative Context** if you want to see one craft choice travel through discuss, plan, draft, and review artifacts.
@@ -32,6 +33,14 @@ This document is the canonical index of Scriveno's proof layer. It points to con
 
 Start with the proof bundle if you want the curated version. Follow the underlying files if you want to inspect the raw sample directly.
 
+## First-Run Proof
+
+**What it proves:** Scriveno has an executable first-run guide and committed transcript artifacts for the first proof path.
+
+**Canonical artifact:** [data/proof/first-run/README.md](../data/proof/first-run/README.md)
+
+**Related parity artifact:** [data/proof/runtime-parity/README.md](../data/proof/runtime-parity/README.md)
+
 ## Voice DNA
 
 **What it proves:** Scriveno's style-guide layer changes draft behavior in visible ways when the same brief is written unguided versus guided.
@@ -57,6 +66,8 @@ Read the bundle in order if you want to inspect sentence rhythm, metaphor select
 - [Shipped Assets](shipped-assets.md) -- canonical inventory of the trust-critical files Scriveno actually bundles
 - [Quick Proof](quick-proof.md) -- 10-minute proof-first path through install checks, the demo, and the next draft
 - [Starter Sets](starter-sets.md) -- small command sets by writing goal
+- [data/proof/first-run/README.md](../data/proof/first-run/README.md) -- committed first-run transcript artifact
+- [data/proof/runtime-parity/README.md](../data/proof/runtime-parity/README.md) -- runtime surface evidence and host-parity boundary
 - [Runtime Support](runtime-support.md) -- canonical runtime matrix and installer-baseline framing
 - [Auto-Invoke Policy](auto-invoke-policy.md) -- proactive status, safe apply, local-helper, and agent-spawn boundaries
 - [Route Graph Audit](route-graph.md) -- generated route graph, automation lanes, and priority fixtures

package/docs/quick-proof.md

@@ -1,10 +1,11 @@
 # Quick Proof
 
-This is the shortest proof-first path through Scriveno. It is meant for a fresh user who wants to see real shipped artifacts, a demo manuscript, runtime expectations, and the first practical commands before reading the full manual.
+This is the shortest proof-first path through Scriveno. It is meant for a fresh user who wants to see real shipped artifacts, a demo manuscript, runtime expectations, and the first practical commands before reading the full manual. If your runtime supports Scriveno commands, the executable version of this page is `/scr:first-run`.
 
 ## What This Proves
 
 - Scriveno ships inspectable proof bundles, not only feature claims.
+- Scriveno ships `/scr:first-run` and `scriveno first-run --project .` as guided first-run surfaces.
 - The watchmaker demo includes real manuscript state, drafts, review notes, and a planned next unit.
 - Voice DNA changes output on the same brief, with guided and unguided samples side by side.
 - Runtime behavior is explicit: Claude Code is the primary reference runtime, Codex uses generated `$scr-*` skills, standard slash-command targets use `/scr:*`, and guided targets document their local setup path.
@@ -27,31 +28,35 @@ node bin/install.js --runtimes claude-code,cursor,gemini-cli,codex,opencode,copi
 ### 2. Check The Installed Surface
 
 ```bash
+scriveno first-run --project .
 scriveno status --project .
 scriveno smoke --json
 scriveno agents --json
 scriveno routes --json
 ```
 
-Expected result: the commands report installed surfaces, agent prompt availability, route lanes, and any manual gates. They do not mutate manuscript files.
+Expected result: the commands report the recommended first path, installed surfaces, agent prompt availability, route lanes, and any manual gates. They do not mutate manuscript files.
 
 ### 3. Open The Demo
 
 Claude Code:
 
 ```text
+/scr-first-run
 /scr-demo
 ```
 
 Standard slash-command runtimes:
 
 ```text
+/scr:first-run
 /scr:demo
 ```
 
 Codex:
 
 ```text
+$scr-first-run
 $scr-demo
 ```
 
@@ -72,6 +77,8 @@ Start here:
 - [data/proof/watchmaker-flow/README.md](../data/proof/watchmaker-flow/README.md)
 - [data/proof/voice-dna/README.md](../data/proof/voice-dna/README.md)
 - [data/proof/creative-context/README.md](../data/proof/creative-context/README.md)
+- [data/proof/first-run/README.md](../data/proof/first-run/README.md)
+- [data/proof/runtime-parity/README.md](../data/proof/runtime-parity/README.md)
 
 The fastest comparison is the Voice DNA pair:
 
@@ -147,6 +154,18 @@ Candidate local helpers: scan, save
 Manual gates: writer approval before publishing or overwriting exports
 ```
 
+```text
+> scriveno first-run --project .
+Scriveno first-run guide
+Current recommendation: /scr:new-work
+Recommended first path:
+1. /scr:demo
+2. cd scriveno-demo
+3. /scr:next
+4. /scr:draft 5
+5. /scr:editor-review 5
+```
+
 ```text
 > /scr:draft 5
 Loaded STYLE-GUIDE.md and the plan for unit 5.
@@ -169,6 +188,8 @@ No runtime claim here should be read as host-runtime parity proof. The repo prov
 ## Where To Go Next
 
 - [Starter Sets](starter-sets.md) for small command paths by writing goal
+- [data/proof/first-run/README.md](../data/proof/first-run/README.md) for committed first-run transcripts
+- [data/proof/runtime-parity/README.md](../data/proof/runtime-parity/README.md) for runtime parity evidence
 - [Getting Started](getting-started.md) for the complete first-project walkthrough
 - [Proof Artifacts](proof-artifacts.md) for the proof hub
 - [Runtime Support](runtime-support.md) for installation and support levels

package/docs/release-notes.md

@@ -2,6 +2,67 @@
 
 This document is the public-facing summary of what changed between package releases. For package history, see the root [CHANGELOG](../CHANGELOG.md).
 
+## 2.6.0 - 2026-05-29
+
+### What changed
+
+- Fixed a Pandoc-variable mismatch so RTL, CJK, and non-Latin fonts now reach the print and PDF path; added RTL support to the picturebook and stageplay templates (all four interior templates verified with `dir=rtl`).
+- Made the voice-drift gate functional: `agents/voice-checker.md` now defines `drift = (100 - score) / 100`, so the default `voice.drift_threshold` of 0.3 means a re-draft is offered below a voice score of 70.
+- Kept `/scr:autopilot-publish` fully unattended and advisory; a severe voice failure is surfaced loudly rather than halting the run.
+- Corrected `/scr:quick-write` and `/scr:beta-reader` framing to match what they actually do.
+- Marked the translation and illustration API tables as future targets, not shipped behavior.
+- Audited and fixed documentation drift across the suite: command reference usage lines, the configuration baseline, the architecture file tree, voice-dna part numbering, the missing speech work type, and stale counts.
+- Added `lib/track-safety.js` with adversarial tests, and `argument-hint` to 17 commands.
+
+### Why it matters
+
+This release closes the gap between what Scriveno documented and what it shipped. The export fix makes RTL and non-Latin print output actually work, the voice gate is now a real computed check instead of a phantom threshold, and the documentation no longer claims integrations or behavior that the prompt system does not provide.
+
+### Affected areas
+
+- export and print templates (RTL, CJK, fonts)
+- voice-checker drift mapping and autopilot gates
+- translation and illustration honesty
+- documentation suite (command reference, configuration, architecture, voice-dna, README)
+- track-safety helper and command argument hints
+- package metadata and release-alignment tests
+
+## 2.5.0 - 2026-05-16
+
+### What changed
+
+- Scriveno now ships `/scr:first-run`, an executable first-run path through install checks, demo proof, starter choices, and next commands.
+- The public CLI now supports `scriveno first-run --project .`, giving terminal users the same proof path without relying on host-specific slash-command behavior.
+- First-run guidance is connected to `/scr:help`, `/scr:demo`, Quick Proof, Starter Sets, Runtime Support, Shipped Assets, Command Reference, README launch copy, and architecture docs.
+- Scriveno now includes committed first-run and runtime-parity proof bundles under `data/proof/`.
+- Runtime smoke now validates the 113-command installed surface across Claude Code, Codex, Cursor, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Antigravity, Manus, Perplexity Desktop, and the generic fallback.
+- README badges, package metadata, constraints metadata, generated config metadata, changelog, release notes, configuration docs, route graph docs, architecture docs, proof docs, and release tests are aligned on `2.5.0`.
+
+### Why it matters
+
+The previous release documented a stronger proof path. This release makes that path executable. A new writer can install Scriveno, run one first-run command, inspect proof artifacts, create the demo, and move into drafting without having to assemble the path from documentation.
+
+### Affected areas
+
+- first-run command surface
+- public CLI installer and smoke checks
+- proof artifact bundles
+- README badges and launch copy
+- runtime support matrix
+- command reference and route graph docs
+- package metadata and generated project examples
+- release-alignment tests
+
+### Verification
+
+- `npm run policy:check`
+- `node --test test/first-run-proof-surface.test.js test/adaptive-concierge.test.js test/auto-invoke-engine.test.js test/command-surface-coherence.test.js test/collaboration-trust-surface.test.js test/package.test.js test/phase15-proof-artifacts-positioning.test.js`
+- `npm test`
+- `npm run release:check`
+- `git diff --check`
+- `scriveno first-run --project .`
+- `scriveno smoke --json`
+
 ## 2.0.12 - 2026-05-16
 
 ### What changed

package/docs/route-graph.md

@@ -13,9 +13,9 @@ The text report summarizes command count, graph edges, agent-capable routes, loc
 
 ## Current Shape
 
-As of `2.0.12`, the route graph contains:
+As of `2.6.0`, the route graph contains:
 
-- 112 commands
+- 113 commands
 - intent-order edges from `command_intents`
 - dependency-chain edges from `dependencies.core_chain`
 - automation lanes from `getCommandAutomationPolicy()`

package/docs/runtime-support.md

@@ -69,12 +69,13 @@ Node is not a runtime dependency for Scriveno's markdown command system itself.
 
 Scriveno docs use `/scr:*` as the shared command id format unless a host-specific example is needed. Installed command surfaces differ by runtime:
 
-- Claude Code: `/scr-demo`, `/scr-new-work`, `/scr-next`
-- Standard command-directory runtimes: `/scr:demo`, `/scr:new-work`, `/scr:next`
-- Codex: `$scr-demo`, `$scr-new-work`, `$scr-next`
+- Claude Code: `/scr-first-run`, `/scr-demo`, `/scr-new-work`, `/scr-next`
+- Standard command-directory runtimes: `/scr:first-run`, `/scr:demo`, `/scr:new-work`, `/scr:next`
+- Codex: `$scr-first-run`, `$scr-demo`, `$scr-new-work`, `$scr-next`
 - Guided targets: follow the generated setup instructions and connector recipe
 
 Use [Quick Proof](quick-proof.md) for the 10-minute proof route and [Starter Sets](starter-sets.md) for goal-based command paths.
+Use [Runtime Parity Evidence](../data/proof/runtime-parity/README.md) for the committed boundary between install-surface proof and host-runtime parity proof.
 
 ## Shared Auto-Invoke Engine
 

package/docs/sacred-texts.md

@@ -292,5 +292,5 @@ Here is a quick walkthrough for starting a sacred writing project:
 ## See Also
 
 - [Getting Started](getting-started.md) -- Install Scriveno and create your first project
-- [Command Reference](command-reference.md) -- Full reference for all 112 commands, including the [Sacred Exclusive](command-reference.md#sacred-exclusive) section
+- [Command Reference](command-reference.md) -- Full reference for all 113 commands, including the [Sacred Exclusive](command-reference.md#sacred-exclusive) section
 - [README](../README.md) -- Project overview and feature list

package/docs/shipped-assets.md

@@ -123,6 +123,8 @@ Sacred commands read top-level sacred profile keys in new projects and preserve
 - `docs/configuration.md` -- canonical project config and package metadata reference
 - `data/proof/watchmaker-flow/README.md` -- canonical sample-flow proof bundle rooted in shipped demo files
 - `data/proof/voice-dna/README.md` -- canonical Voice DNA proof bundle
+- `data/proof/first-run/README.md` -- committed transcript artifact for the executable first-run path
+- `data/proof/runtime-parity/README.md` -- runtime install-surface evidence and host-parity boundary
 - `commands/scr/export.md` -- source of truth for export command behavior
 - `docs/publishing.md` -- user-facing explanation of export formats and publishing packages
 - `docs/contributing.md` -- contributor-facing guidance for extending export support

package/docs/starter-sets.md

@@ -4,6 +4,14 @@ Scriveno has a large command surface because it covers many kinds of writing. St
 
 Each set is intentionally small. Use `/scr-next`, `/scr:next`, or `$scr-next` whenever you are unsure which command should come next.
 
+## First 10 Minutes
+
+- `/scr:first-run` runs the guided proof path and shows runtime-specific command shapes.
+- `/scr:demo` creates the isolated watchmaker demo.
+- `/scr:next` inspects the demo state and recommends the next move.
+- `/scr:draft` drafts the planned fifth unit.
+- `/scr:editor-review` reviews the new draft.
+
 ## Draft A Book
 
 - `/scr:new-work` creates the project and work-type context.

package/docs/translation.md

@@ -2,17 +2,13 @@
 
 Scriveno translates your manuscript into any language while preserving your voice. The translation pipeline handles glossary management, translation memory, cultural adaptation, quality verification, and multi-language publishing -- from setup to finished translated editions.
 
-This guide covers the full pipeline: choosing a translation engine, translating your manuscript, managing terminology, verifying quality, and publishing in multiple languages.
+This guide covers the full pipeline: how translation works, translating your manuscript, managing terminology, verifying quality, and publishing in multiple languages.
 
-## Translation Engines
+## Translation approach
 
-Scriveno uses three translation approaches, each suited to different languages and content types.
+Scriveno translates through the in-context translator agent (`agents/translator.md`), not an external translation API. The agent itself handles literary nuance, sacred-text registers, and cultural adaptation that machine-translation services miss. It applies your voice profile, maintains glossary compliance, and can do formal or dynamic equivalence translation. Every unit is translated by the translator agent in fresh context with your STYLE-GUIDE.md loaded.
 
-**DeepL** -- Primary engine for European languages. Higher quality than alternatives for English, French, German, Spanish, Italian, Portuguese, Dutch, Polish, Japanese, Chinese, and Korean. GDPR-compliant -- your content is not stored or used for training.
-
-**Google Cloud Translation** -- Broad language coverage with 130+ languages. Required for Arabic, Hebrew, Hindi, Swahili, and other languages DeepL does not cover. Best choice for RTL scripts and languages with limited DeepL support.
-
-**AI Agent (Claude/GPT)** -- The AI agent itself handles literary nuance, sacred text translation, and cultural adaptation that machine translation APIs miss. It applies your voice profile, maintains glossary compliance, and can do formal/dynamic equivalence translation. This is Scriveno's default for literary content -- every unit is translated by the translator agent with your STYLE-GUIDE.md loaded.
+DeepL and Google Cloud Translation are documented as possible future integration targets, not current behavior. Scriveno does not call either service today; if an automated machine-translation path is added later, this guide will describe how it plugs in.
 
 The translator agent works unit by unit in fresh context (just like the drafter), ensuring consistent quality and glossary compliance across the entire manuscript.
 
@@ -171,7 +167,7 @@ The TMX export produces industry-standard Translation Memory eXchange format com
 
 ## Cultural Adaptation
 
-Machine translation handles words. Cultural adaptation handles meaning. Scriveno flags culturally sensitive content that needs human attention beyond what translation APIs catch.
+Translation handles words. Cultural adaptation handles meaning. Scriveno flags culturally sensitive content that needs deliberate attention beyond a faithful unit-by-unit rendering.
 
 ```
 /scr:cultural-adaptation fr
@@ -247,8 +243,8 @@ Scriveno handles right-to-left and CJK (Chinese, Japanese, Korean) scripts throu
 
 RTL languages (Arabic, Hebrew, Persian, Urdu) receive special handling:
 
-- **Text direction** -- Export commands automatically set `--variable dir=rtl` for Pandoc and `text-dir` for Typst
-- **Template adjustments** -- The Typst book template reverses inside/outside margins for RTL binding
+- **Text direction** -- Export commands pass the Pandoc `dir` variable (`dir=rtl`); the Typst interior templates read that `dir` variable to orient text
+- **Template adjustments** -- The Typst interior templates honor RTL: the book template reverses inside/outside margins for RTL binding, and the stageplay template flips its binding margin and page-number alignment. The chapbook and picturebook templates set text direction from the `dir` variable.
 - **Font requirements** -- RTL exports need fonts with Arabic/Hebrew glyph support. Scriveno uses system-available fonts by default; specify custom fonts in `.manuscript/config.json`
 - **Punctuation** -- Quotation marks use the appropriate convention (e.g., French-style guillemets for Arabic)
 

package/docs/voice-dna.md

@@ -138,7 +138,7 @@ This section governs the speed and flow of narrative.
 - **Between chapters** -- Cliffhangers, echoes, or clean breaks
 - **Time jumps** -- How they're signaled, how frequent, how handled
 
-### Part 7: Reference Influences
+### Part 8: Reference Influences
 
 This section captures the authors, works, and passages that anchor your voice.
 
@@ -210,7 +210,7 @@ The 10 registers are:
 | **Parabolic** | Allegorical, story-within-story | "The kingdom of heaven is like..." concrete daily-life imagery |
 | **Didactic** | Instructional, systematic, expository | Topic-by-topic structure, teacher-student dynamic, Q&A format |
 
-Each unit's plan file specifies which register to use. Your STYLE-GUIDE.md Part 8 (Sacred Voice Registers) describes how YOU handle each register -- the drafter always defers to your personalized register style over the generic descriptions.
+Each unit's plan file specifies which register to use. Your STYLE-GUIDE.md "Sacred voice registers" part (Part 8 in the shipped template) describes how YOU handle each register -- the drafter always defers to your personalized register style over the generic descriptions.
 
 If no register is specified in a plan file, the drafter defaults to narrative-historical.
 
@@ -276,7 +276,7 @@ See [docs/drafter-quality.md](drafter-quality.md) for the full system, including
 ### Too many metaphors / not enough metaphors
 
 **Symptom:** Prose is either overwritten or too bare.
-**Fix:** Adjust metaphor density in STYLE-GUIDE.md Part 4 (Figurative Language). "Sparse" means one metaphor per page at most. "Dense" means multiple per paragraph. Find your natural density by looking at your existing writing.
+**Fix:** Adjust metaphor density in STYLE-GUIDE.md Part 3 (vocabulary and figurative language). "Sparse" means one metaphor per page at most. "Dense" means multiple per paragraph. Find your natural density by looking at your existing writing.
 
 ### AI-sounding hedging
 
@@ -293,5 +293,5 @@ See [docs/drafter-quality.md](drafter-quality.md) for the full system, including
 - [Proof Artifacts](proof-artifacts.md) -- inspect the Voice DNA before/after bundle first if you want the fastest concrete evidence
 - [Getting Started](getting-started.md) -- Install Scriveno and write your first draft
 - [Drafter Quality](drafter-quality.md) -- the three rule layers, the `draft` config block, and model-tier recommendations
-- [Command Reference](command-reference.md) -- Full list of all 112 commands with usage and examples
+- [Command Reference](command-reference.md) -- Full list of all 113 commands with usage and examples
 - [Work Types Guide](work-types.md) -- How work types adapt Scriveno's vocabulary and commands

package/docs/work-types.md

@@ -335,5 +335,5 @@ Your work type is stored in `.manuscript/config.json` and can be changed later b
 ## See Also
 
 - [Getting Started](getting-started.md) -- Install Scriveno and write your first draft
-- [Command Reference](command-reference.md) -- Full list of all 112 commands with usage and examples
+- [Command Reference](command-reference.md) -- Full list of all 113 commands with usage and examples
 - [Voice DNA Guide](voice-dna.md) -- How Scriveno profiles and preserves your writing voice

package/lib/track-safety.js

@@ -0,0 +1,72 @@
+// lib/track-safety.js
+// Canonical, dependency-free slug + branch derivation for /scr:track (D-01).
+//
+// The track.md prompt instructs the agent to slugify a writer-provided track
+// label before it ever touches a git or shell command. This module is the
+// single source of truth for that algorithm. The installer copies lib/ into the
+// writer's data dir, so it ships as <data-dir>/lib/track-safety.js and a runtime
+// can derive a guaranteed-safe slug deterministically instead of relying on the
+// model to apply the rules by hand:
+//
+//   node <data-dir>/lib/track-safety.js "Editor's Suggestions"
+//   -> {"slug":"editors-suggestions","branch":"track/editors-suggestions"}
+//
+// Safety property: a sanitized slug contains only [a-z0-9-]. It can never carry
+// a shell metacharacter, quote, whitespace, path separator, or command
+// substitution, so interpolating `track/<slug>` into a git command line is safe.
+
+'use strict';
+
+// A slug is shell-safe iff it is a non-empty run of lowercase alphanumerics and
+// hyphens with no leading/trailing hyphen.
+const SLUG_SAFE = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
+const FALLBACK_SLUG = 'untitled';
+
+// Apply the D-01 rules: lowercase, whitespace/underscores to hyphen, strip
+// everything that is not [a-z0-9-], collapse hyphen runs, trim edge hyphens.
+// Returns FALLBACK_SLUG when the label has no usable characters (e.g. "***",
+// "日本", "") so the caller never produces an empty branch name.
+function sanitizeTrackSlug(label) {
+  const slug = String(label == null ? '' : label)
+    .toLowerCase()
+    .replace(/[\s_]+/g, '-')
+    .replace(/[^a-z0-9-]+/g, '')
+    .replace(/-+/g, '-')
+    .replace(/^-+|-+$/g, '');
+  return slug.length > 0 ? slug : FALLBACK_SLUG;
+}
+
+function isShellSafeSlug(slug) {
+  return typeof slug === 'string' && SLUG_SAFE.test(slug);
+}
+
+// Resolve a collision-free branch name. `existingBranches` is the set of branch
+// names already present in the repo (e.g. parsed from `git branch`). Mirrors
+// track.md create-step 6: append -2, -3, ... to the slug until the branch name
+// is free.
+function resolveTrackBranch(label, existingBranches = []) {
+  const taken = new Set(existingBranches);
+  const baseSlug = sanitizeTrackSlug(label);
+  let slug = baseSlug;
+  let n = 2;
+  while (taken.has(`track/${slug}`)) {
+    slug = `${baseSlug}-${n}`;
+    n += 1;
+  }
+  return { slug, branch: `track/${slug}` };
+}
+
+module.exports = {
+  sanitizeTrackSlug,
+  isShellSafeSlug,
+  resolveTrackBranch,
+  FALLBACK_SLUG,
+};
+
+if (require.main === module) {
+  const label = process.argv[2] || '';
+  const existing = process.argv[3]
+    ? process.argv[3].split(',').map((s) => s.trim()).filter(Boolean)
+    : [];
+  process.stdout.write(JSON.stringify(resolveTrackBranch(label, existing)) + '\n');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scriveno",
-  "version": "2.0.12",
+  "version": "2.6.0",
   "description": "Spec-driven creative writing, publishing, and translation pipeline for AI coding agents. From blank page to published book.",
   "bin": {
     "scriveno": "bin/install.js"

package/templates/config.json

@@ -1,5 +1,5 @@
 {
-  "scriveno_version": "2.0.12",
+  "scriveno_version": "2.6.0",
   "work_type": "",
   "group": "",
   "command_unit": "",