scriveno 2.5.0 → 2.7.1

package/commands/scr/scan.md

@@ -5,7 +5,7 @@ argument-hint: "[--fix] [--quiet]"
 
 # /scr:scan -- Context Drift Scanner
 
-You are the project's drift detector. Trust nothing. Compare what `.manuscript/STATE.md`, `OUTLINE.md`, `RECORD.md`, `config.json`, and the various structural files **claim** against what the filesystem actually contains, and report every mismatch.
+You are the project's drift detector. Trust nothing. Compare what `.manuscript/STATE.md`, `OUTLINE.md`, `RECORD.md`, `PROGRESS.md`, `config.json`, and the various structural files **claim** against what the filesystem actually contains, and report every mismatch.
 
 Follow the auto-invoke policy. In the source repository it is documented at `docs/auto-invoke-policy.md`. `/scr:scan` does not spawn agents. It may run deterministic local checks and, under `--fix` after confirmation, deterministic local repairs.
 
@@ -23,7 +23,7 @@ This complements `/scr:health` (which fixes structural issues like missing direc
 
 ## Instruction
 
-Load `.manuscript/config.json`, `.manuscript/STATE.md`, `.manuscript/OUTLINE.md`, and `.manuscript/RECORD.md` when present. Each check below produces a finding with one of three severities:
+Load `.manuscript/config.json`, `.manuscript/STATE.md`, `.manuscript/OUTLINE.md`, `.manuscript/RECORD.md`, and `.manuscript/PROGRESS.md` when present. Each check below produces a finding with one of three severities:
 
 - **DRIFT** -- recorded state contradicts disk reality. Trust nothing downstream until resolved.
 - **WARNING** -- an artifact is stale or out of date. Downstream work may be silently using outdated input.
@@ -206,6 +206,20 @@ Do not over-claim. RECORD.md is an interpretive store, so uncertain findings sho
 
 ---
 
+### CHECK 12: PROGRESS.md ledger staleness
+
+If `.manuscript/PROGRESS.md` exists, compare its mtime against STATE.md and the newest draft. If PROGRESS.md is older than either, the saved per-unit ledger no longer reflects the work on disk. Emit:
+
+```
+WARNING .manuscript/PROGRESS.md is older than the recorded state.
+        The saved per-unit ledger may show stale unit status.
+        Fix: /scr:save to rebuild it (or /scr:scan --fix).
+```
+
+Recompute per-unit status from disk per `docs/progress-protocol.md`. If the bucket counts (done / in progress / untouched) disagree with what PROGRESS.md records, emit a DRIFT finding citing both. If PROGRESS.md does not exist, emit INFO with a one-line suggestion to run `/scr:save` once to generate the openable ledger.
+
+---
+
 ### REPORT
 
 Output a single structured report:
@@ -248,7 +262,7 @@ If `--quiet` was passed and there are zero findings, exit silently with no outpu
 
 When `--fix` is passed, after the report, group findings by auto-fixability:
 
-- **Auto-fixable now** -- finding has a deterministic fix Scriveno can apply (e.g. update STATE.md unit counts to match disk, initialize missing RECORD.md from the installed template, regenerate stale CONTEXT.md, sort orphan drafts into a `_unsorted/` review directory). For each, ask the writer once:
+- **Auto-fixable now** -- finding has a deterministic fix Scriveno can apply (e.g. update STATE.md unit counts to match disk, initialize missing RECORD.md from the installed template, regenerate stale CONTEXT.md, regenerate stale or missing PROGRESS.md from disk per `docs/progress-protocol.md`, sort orphan drafts into a `_unsorted/` review directory). For each, ask the writer once:
   > Apply [N] auto-fixes? (yes / no / show me what each does)
 - **Requires writer decision** -- finding needs a judgment call (e.g. character orphans, scaffold pending, voice drift). List with suggested next command.
 - **Manual** -- finding requires manual cleanup (e.g. malformed HISTORY.log lines).

package/commands/scr/sensitivity-review.md

@@ -1,5 +1,6 @@
 ---
 description: Flag potential sensitivity issues with context, suggest alternatives, and note intentional craft.
+argument-hint: "[N]"
 ---
 
 # /scr:sensitivity-review -- Sensitivity Review with Craft Awareness

package/commands/scr/submit.md

@@ -20,7 +20,8 @@ Load `.manuscript/config.json` for `command_unit`. The runnable command stays `/
 1. Load `.manuscript/config.json` for project context
 2. Check that the specified unit has been through editor review. Prefer `.manuscript/reviews/{N}-REVIEW.md`; if it is missing, accept legacy `{N}-EDITOR-NOTES.md`.
 3. Mark the unit as submitted in `STATE.md`
-4. Report: "Unit {N} submitted. {remaining} units remaining."
+4. Refresh `.manuscript/PROGRESS.md` so the ledger shows this unit as done, per `docs/progress-protocol.md`.
+5. Report: "Unit {N} submitted. {remaining} units remaining."
 
 ## Response Contract
 

package/commands/scr/synopsis.md

@@ -1,5 +1,6 @@
 ---
 description: Generate plot synopsis at specified length for query and submission packages.
+argument-hint: "[--length <1p|2p|5p>]"
 ---
 
 # /scr:synopsis -- Plot Synopsis Generator

package/commands/scr/theme-tracker.md

@@ -1,5 +1,6 @@
 ---
 description: Track thematic threads across the work with auto-detection suggestions.
+argument-hint: "[--detect]"
 ---
 
 # /scr:theme-tracker -- Track Thematic Threads

package/commands/scr/timeline.md

@@ -1,5 +1,6 @@
 ---
 description: Generate a chronological event timeline from the outline.
+argument-hint: "[--story-order] [--chronological]"
 ---
 
 # /scr:timeline -- Chronological Event Timeline

package/commands/scr/track.md

@@ -48,6 +48,8 @@ Track metadata lives in `.manuscript/tracks.json`. Create this file on first `tr
 
 **Label-to-branch mapping (D-01):** Writer-friendly labels are stored as-is. The git branch name is derived by slugifying the label: lowercase, replace spaces with hyphens, strip special characters (keep alphanumeric and hyphens only), prefix with `track/`. Example: "Second Draft Attempt" becomes `track/second-draft-attempt`.
 
+This slugify step is the one safety boundary that keeps a writer-chosen label out of a shell command, so it is mandatory, never optional. The canonical algorithm ships as `lib/track-safety.js` (installed to `<data-dir>/lib/track-safety.js`). To derive the slug and a collision-free branch deterministically instead of applying the rules by hand, run `node <data-dir>/lib/track-safety.js "<label>"`, which prints `{"slug":"...","branch":"..."}` with collisions already resolved against a comma-separated second argument of existing branch names. A correct slug contains only `[a-z0-9-]`; if it contains anything else, do not pass it to git.
+
 **Canon branch metadata:** `canon_branch` stores the real branch name of the canon manuscript. This may be `main`, `master`, `trunk`, or any other branch name the writer uses.
 
 ## Canon Branch Resolution

package/commands/scr/translate.md

@@ -214,7 +214,7 @@ After all units are translated, show a summary:
 > - Build translation memory: `/scr:translation-memory [lang] --build`
 > - Cultural adaptation review: `/scr:cultural-adaptation [lang]`
 > - Back-translate to verify: `/scr:back-translate [lang]`
-> - Export translation: `/scr:export --format [format] --language [lang]`
+> - Export translation: `/scr:multi-publish --languages [lang] --format [format]` (the translated-export path; `/scr:export` builds the source-language manuscript only)
 
 ## Agent and Automation Status
 

package/commands/scr/voice-check.md

@@ -1,5 +1,6 @@
 ---
 description: Compare drafted prose against STYLE-GUIDE.md to detect voice drift.
+argument-hint: "[N]"
 ---
 
 # /scr:voice-check -- Voice Fidelity Check

package/data/CONSTRAINTS.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./constraints.schema.json",
-  "version": "2.5.0",
+  "version": "2.7.1",
   "description": "Scriveno constraint system: work types, command availability, exports, and dependencies. Every command checks this file at runtime.",
   "_notes": {
     "sacred_keys": "Sacred subcommands live at commands/scr/sacred/<name>.md and run as /scr:sacred:<name>. Their CONSTRAINTS keys use the sacred:<name> form so /scr:help can render the runnable slash-command path directly. The sacred-numbering-format entry is a separate flat command (commands/scr/sacred-numbering-format.md) that surfaces the active tradition's numbering format. It used to be named sacred-verse-numbering, which collided with sacred:verse-numbering at install time -- both flattened to scr-sacred-verse-numbering. Renamed in v1.6.x; the installer now refuses to install when two sources share a flat skill name."
@@ -2340,6 +2340,7 @@
     },
     "beta-reader": {
       "category": "review",
+      "description": "Simulate a beta reader's experience of the manuscript using a fresh-context reader persona (same model, not a second or external AI).",
       "available": [
         "all"
       ],
@@ -3743,6 +3744,7 @@
     "default": {
       "BRIEF.md": "BRIEF.md",
       "RECORD.md": "RECORD.md",
+      "PROGRESS.md": "PROGRESS.md",
       "CHARACTERS.md": "CHARACTERS.md",
       "RELATIONSHIPS.md": "RELATIONSHIPS.md",
       "WORLD.md": "WORLD.md",
@@ -3752,6 +3754,7 @@
     "academic": {
       "BRIEF.md": "PROPOSAL.md",
       "RECORD.md": "RECORD.md",
+      "PROGRESS.md": "PROGRESS.md",
       "CHARACTERS.md": "CONCEPTS.md",
       "WORLD.md": "CONTEXT.md",
       "PLOT-GRAPH.md": "ARGUMENT-MAP.md",
@@ -3760,6 +3763,7 @@
     "technical": {
       "BRIEF.md": "DOC-BRIEF.md",
       "RECORD.md": "RECORD.md",
+      "PROGRESS.md": "PROGRESS.md",
       "CHARACTERS.md": "AUDIENCE.md",
       "RELATIONSHIPS.md": "DEPENDENCIES.md",
       "WORLD.md": "SYSTEM.md",
@@ -3769,6 +3773,7 @@
     "sacred": {
       "BRIEF.md": "FRAMEWORK.md",
       "RECORD.md": "RECORD.md",
+      "PROGRESS.md": "PROGRESS.md",
       "CHARACTERS.md": "FIGURES.md",
       "RELATIONSHIPS.md": "LINEAGES.md",
       "WORLD.md": "COSMOLOGY.md",

package/data/export-templates/scriveno-book.typst

@@ -13,10 +13,10 @@
 #let margin-bottom = $if(margin-bottom)$$margin-bottom$$else$0.75in$endif$
 
 // Text direction: parameterized for RTL compatibility (Phase 7)
-#let text-dir = $if(text-direction)$$text-direction$$else$ltr$endif$
+#let text-dir = $if(dir)$$dir$$else$ltr$endif$
 
 // Language code for CJK detection
-#let lang-code = $if(language)$"$language$"$else$"en"$endif$
+#let lang-code = $if(lang)$"$lang$"$else$"en"$endif$
 
 // CJK detection helper
 #let is-cjk = lang-code in ("zh", "ja", "ko")

package/data/export-templates/scriveno-chapbook.typst

@@ -16,7 +16,7 @@
 #let margin-outside = $if(margin-outside)$$margin-outside$$else$0.625in$endif$
 
 // Text direction
-#let text-dir = $if(text-direction)$$text-direction$$else$ltr$endif$
+#let text-dir = $if(dir)$$dir$$else$ltr$endif$
 
 // Font configuration -- chapbooks default to a clean readable serif
 #let body-font = $if(mainfont)$"$mainfont$"$else$"Libertinus Serif"$endif$

package/data/export-templates/scriveno-picturebook.typst

@@ -20,6 +20,13 @@
 // Override with -V margin-top= etc. if custom margins are needed
 #let margin-all = $if(margin-top)$$margin-top$$else$0.375in$endif$
 
+// Text direction: parameterized for RTL compatibility (set via --metadata dir=rtl).
+// Margins are symmetric and body text is centered, so only the base text
+// direction needs to flip for right-to-left scripts.
+#let text-dir = $if(dir)$$dir$$else$ltr$endif$
+#let is-rtl = text-dir == rtl
+#let lang-code = $if(lang)$"$lang$"$else$"en"$endif$
+
 // Metadata
 #let book-title  = $if(title)$"$title$"$else$"Untitled"$endif$
 #let book-author = $if(author)$"$for(author)$$it.name$$sep$, $endfor$"$else$""$endif$
@@ -46,6 +53,8 @@
 #set text(
   font: $if(mainfont)$"$mainfont$"$else$"Helvetica"$endif$,
   size: $if(fontsize)$$fontsize$$else$16pt$endif$,
+  dir: text-dir,
+  lang: lang-code,
   fallback: true,
 )
 

package/data/export-templates/scriveno-stageplay.typst

@@ -17,6 +17,13 @@
 #let margin-top    = $if(margin-top)$$margin-top$$else$1in$endif$
 #let margin-bottom = $if(margin-bottom)$$margin-bottom$$else$1in$endif$
 
+// Text direction: parameterized for RTL compatibility (set via --metadata dir=rtl).
+// For right-to-left scripts the wider binding margin moves to the right edge and
+// the page number flips to the top-left.
+#let text-dir = $if(dir)$$dir$$else$ltr$endif$
+#let is-rtl = text-dir == rtl
+#let lang-code = $if(lang)$"$lang$"$else$"en"$endif$
+
 // Metadata
 #let play-title  = $if(title)$"$title$"$else$"Untitled"$endif$
 #let play-author = $if(author)$"$for(author)$$it.name$$sep$, $endfor$"$else$""$endif$
@@ -30,16 +37,17 @@
   width: page-width,
   height: page-height,
   margin: (
-    left:   margin-left,
-    right:  margin-right,
+    // The 1.5in binding margin sits on the left for LTR and flips to the right for RTL.
+    left:   if is-rtl { margin-right } else { margin-left },
+    right:  if is-rtl { margin-left } else { margin-right },
     top:    margin-top,
     bottom: margin-bottom,
   ),
-  // Page numbering: top-right, industry standard for scripts
+  // Page numbering: top-right for LTR scripts, top-left for RTL
   header: context {
     let page-num = counter(page).get().first()
     if page-num > 1 {
-      align(right, text(size: 10pt)[#str(page-num).])
+      align(if is-rtl { left } else { right }, text(size: 10pt)[#str(page-num).])
     }
   },
 )
@@ -48,6 +56,8 @@
 #set text(
   font: $if(mainfont)$"$mainfont$"$else$"Courier New"$endif$,
   size: $if(fontsize)$$fontsize$$else$12pt$endif$,
+  dir: text-dir,
+  lang: lang-code,
   fallback: true,
 )
 

package/docs/architecture.md

@@ -164,7 +164,8 @@ scriveno/
       scriveno-book.typst     Book interior PDF
       scriveno-epub.css       EPUB styling
       scriveno-academic.latex Academic paper formatting
-    templates/
+    proof/                 Committed proof bundles (voice-dna, runtime-parity)
+  templates/               Per-project starting content (repo root, sibling of data/)
     config.json            Per-project configuration template
     WORK.md                Work overview template
     OUTLINE.md             Structural outline template
@@ -174,6 +175,8 @@ scriveno/
     WRITING-RULES.md       Universal AI-tell rulebook (1.6.0+)
     THEMES.md              Thematic threads template
     STATE.md               Progress tracking template
+    CONTEXT.md             Session bootstrap scaffold (derived, auto-regenerated)
+    PROGRESS.md            Per-unit progress ledger scaffold (derived, 2.7.0+)
     BRIEF.md               Project brief template
     WORLD.md               World-building template
     pitfalls/              Per-work-type pitfall packs (1.6.0+)
@@ -354,7 +357,7 @@ Codex uses a skill-native variation of this strategy. The installer generates on
 
 Scriveno also ships `lib/auto-invoke-engine.js`, exposed through `scriveno status --project .`, `scriveno status . --json`, `scriveno status --project . --apply-safe`, `scriveno sync --check`, `scriveno smoke`, `scriveno agents`, and `scriveno routes`. The installer copies this library into the shared Scriveno asset directory for global and project installs, so command surfaces can call a single status and audit engine before falling back to embedded markdown logic.
 
-The engine checks disk evidence only: project presence, required project files, STATE.md, CONTEXT.md freshness, plan files, draft files, review coverage, unresolved notes, revision-track proposals, translation work, publishing prerequisites, exports, history, and save signals. It recommends the next command, but it does not mutate files and does not spawn agents by itself. That boundary keeps proactive behavior portable across Claude Code, Codex, Cursor, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Antigravity, Manus, Perplexity Desktop, and the generic fallback.
+The engine checks disk evidence only: project presence, required project files, STATE.md, CONTEXT.md freshness, plan files, draft files, review coverage, unresolved notes, revision-track proposals, translation work, publishing prerequisites, exports, history, and save signals. It also computes the per-unit progress ledger (done / in progress / untouched) through `computeProgressLedger`, which `/scr:progress` and `.manuscript/PROGRESS.md` build on. It recommends the next command, but it does not mutate files and does not spawn agents by itself. That boundary keeps proactive behavior portable across Claude Code, Codex, Cursor, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Antigravity, Manus, Perplexity Desktop, and the generic fallback.
 
 The engine now reports three automation lanes:
 
@@ -422,7 +425,7 @@ The voice-checker agent (`agents/voice-checker.md`) compares drafted prose again
 - Specific issues organized by category (structural voice, lexical voice, character voice, AI-slop indicators)
 - Severity ratings (drift vs critical violation)
 
-The voice-checker is invoked after every drafted unit. If drift exceeds the configured threshold (default: 0.3 in `config.json`), the writer is offered a re-draft.
+The voice-checker is invoked after every drafted unit and returns an Overall score (0-100). Normalized drift is `drift = (100 - score) / 100`, so the default `config.json` threshold of 0.3 means the writer is offered a re-draft when the voice score falls below 70. See the "Normalized drift" section of `agents/voice-checker.md` for the single definition callers share.
 
 ### Calibration
 

package/docs/auto-invoke-policy.md

@@ -63,7 +63,7 @@ Use `Automation status:` for command chains and `Sync status:` for runtime insta
 | Level | Behavior | Default | Examples |
 |-------|----------|---------|----------|
 | 1 | Read-only suggestion | Run by default | `/scr:next` route, progress sweep, review queue surfacing |
-| 2 | Safe local helper | Run when directly triggered | `CONTEXT.md` regeneration, `HISTORY.log` append, scan report, stats count |
+| 2 | Safe local helper | Run when directly triggered | `CONTEXT.md` regeneration, `PROGRESS.md` ledger regeneration, `HISTORY.log` append, scan report, stats count |
 | 3 | Scoped agent | Spawn when the command implies it or evidence is bounded | drafter, plan-checker, voice-checker, continuity-checker, translator, beta-reader |
 | 4 | Writer-owned action | Require confirmation | publishing, destructive edits, merge decisions, accepting review findings |
 
@@ -81,6 +81,7 @@ Run these read-only checks in `/scr:next`, `/scr:progress`, and closeouts for ma
 - If front matter, back matter, blurb, or cover handoff assets are missing, surface the specific publishing prerequisite before packaging.
 - If export outputs are older than source files, suggest `/scr:export` or `/scr:publish`.
 - If no save exists after recent manuscript changes, suggest `/scr:save`.
+- Surface deliverable progress (units done / in progress / untouched) and point at the per-unit ledger `.manuscript/PROGRESS.md`; if it is stale, suggest `/scr:save` to refresh it.
 
 These checks must not mutate files.
 
@@ -88,10 +89,10 @@ These checks must not mutate files.
 
 Run these only when the current command directly owns the file operation:
 
-- `/scr:save` regenerates `.manuscript/CONTEXT.md`, appends `HISTORY.log`, and commits `.manuscript/`.
+- `/scr:save` regenerates `.manuscript/CONTEXT.md` and `.manuscript/PROGRESS.md` (the per-unit ledger), appends `HISTORY.log`, and commits `.manuscript/`.
 - `/scr:scan --fix` applies deterministic state repairs after confirmation and appends `HISTORY.log`.
 - `/scr:resume-work` may regenerate `CONTEXT.md` from disk state.
-- `/scr:progress` may count drafts, submitted units, open record threads, and stale reports, but does not write.
+- `/scr:progress` may count drafts, submitted units, open record threads, and stale reports and render the per-unit ledger live, but does not write. The saved `.manuscript/PROGRESS.md` is refreshed by `/scr:save`, `/scr:draft`, `/scr:autopilot`, and `/scr:scan --fix`.
 - Runtime `/scr:sync --apply` runs the installer and verifies installed command, skill, and agent surfaces.
 
 Report these as local operations, not spawned agents.

package/docs/command-reference.md

@@ -245,7 +245,7 @@ Show the proof-first path, runtime command shapes, demo sequence, proof artifact
 
 ### `/scr:next`
 
-**Description:** Auto-detect what to do next in your workflow and recommend the best path. The one command a writer can always use.
+**Description:** Auto-detect what to do next in your workflow and run it. The one command a writer can always use.
 
 **Usage:** `/scr:next`
 
@@ -277,7 +277,7 @@ Scriveno maps your intent to the right command and runs it.
 
 ### `/scr:help`
 
-**Description:** Show Scriveno commands grouped by inferred writer intent, filtered to what's relevant for your current work type and progress.
+**Description:** Show Scriveno commands grouped by workflow stage, filtered to what's relevant for your current work type and progress.
 
 **Usage:** `/scr:help [category or search term]`
 
@@ -293,17 +293,22 @@ Show publishing-related commands available for your work type. Without a categor
 
 ### `/scr:progress`
 
-**Description:** Show current state and next step. How far along are you, what's drafted, what's pending.
+**Description:** Show project progress: a unit progress bar, what's done / in progress / untouched, pipeline position, and a pointer to the per-unit ledger.
 
 **Usage:** `/scr:progress`
 
 **Prerequisites:** None
 
+**Output includes:**
+- A deliverable progress bar over units (done / in progress / untouched) with percent
+- Pipeline position on the writing lifecycle (e.g., "Stage 6 of 10: Drafting")
+- A pointer to `.manuscript/PROGRESS.md`, the openable per-unit ledger you can read any time
+
 **Example:**
 ```
 /scr:progress
 ```
-See "Chapter 4 of 12 drafted. 32,000 words. Next: discuss-chapter 5."
+See "████████░░ 4/12 chapters done (33%). Pipeline: Stage 6 of 10 (Drafting). Next: discuss chapter 5. Full ledger: .manuscript/PROGRESS.md."
 
 ---
 
@@ -350,7 +355,7 @@ Import an existing Word document and split it into chapters, scenes, and context
 
 **Description:** Spawn parallel analysis agents to understand an existing manuscript's voice, structure, characters, and themes.
 
-**Usage:** `/scr:map-manuscript`
+**Usage:** `/scr:map-manuscript [area]`
 
 **Prerequisites:** None
 
@@ -564,7 +569,7 @@ Visualize your novel's structure mapped to the hero's journey.
 
 **Description:** Generate a chronological event timeline from the outline.
 
-**Usage:** `/scr:timeline`
+**Usage:** `/scr:timeline [--story-order] [--chronological]`
 
 **Prerequisites:** OUTLINE.md must exist
 
@@ -584,7 +589,7 @@ See events in chronological order, even if your narrative is non-linear.
 
 **Description:** Track thematic threads across the work with auto-detection suggestions.
 
-**Usage:** `/scr:theme-tracker`
+**Usage:** `/scr:theme-tracker [--detect]`
 
 **Prerequisites:** THEMES.md must exist
 
@@ -780,7 +785,7 @@ Commands for creating and managing characters, relationships, and world-building
 
 **Description:** Build a complete character profile through guided interactive interview.
 
-**Usage:** `/scr:new-character`
+**Usage:** `/scr:new-character <name>`
 
 **Prerequisites:** WORK.md must exist
 
@@ -962,7 +967,7 @@ Scriveno drafts a sample passage using your voice profile. If it doesn't sound r
 
 **Description:** Perform a line-level prose quality pass with inline annotations.
 
-**Usage:** `/scr:line-edit`
+**Usage:** `/scr:line-edit [N]`
 
 **Prerequisites:** Draft must exist
 
@@ -980,7 +985,7 @@ Scriveno reads your prose line by line, flagging weak verbs, passive voice, redu
 
 **Description:** Perform a correctness pass for grammar, spelling, punctuation, and consistency.
 
-**Usage:** `/scr:copy-edit`
+**Usage:** `/scr:copy-edit [N]`
 
 **Prerequisites:** Draft must exist
 
@@ -998,7 +1003,7 @@ Catch typos, grammar issues, and consistency problems (character name spellings,
 
 **Description:** Chain line-edit, copy-edit, and voice-check for comprehensive prose polish.
 
-**Usage:** `/scr:polish`
+**Usage:** `/scr:polish [N]`
 
 **Prerequisites:** Draft and STYLE-GUIDE.md must exist
 
@@ -1016,7 +1021,7 @@ Run all three quality passes in sequence. The comprehensive final polish before
 
 **Description:** Write a scene, passage, or chapter outside the full planning workflow.
 
-**Usage:** `/scr:quick-write`
+**Usage:** `/scr:quick-write [--discuss] [--research] [--full]`
 
 **Prerequisites:** None
 
@@ -1038,7 +1043,7 @@ Commands for reviewing your manuscript from different angles -- continuity, voic
 
 **Description:** Automated continuity verification to scan for narrative contradictions across the manuscript.
 
-**Usage:** `/scr:continuity-check`
+**Usage:** `/scr:continuity-check [N]`
 
 **Prerequisites:** Draft must exist
 
@@ -1059,7 +1064,7 @@ Find contradictions: "In Chapter 3 Maria has brown eyes, but in Chapter 7 they'r
 
 **Description:** Compare drafted prose against STYLE-GUIDE.md to detect voice drift.
 
-**Usage:** `/scr:voice-check`
+**Usage:** `/scr:voice-check [N]`
 
 **Prerequisites:** Draft and STYLE-GUIDE.md must exist
 
@@ -1080,7 +1085,7 @@ Detect where your drafted prose drifts from your established voice profile.
 
 **Description:** Flag potential sensitivity issues with context, suggest alternatives, and note intentional craft.
 
-**Usage:** `/scr:sensitivity-review`
+**Usage:** `/scr:sensitivity-review [N]`
 
 **Prerequisites:** Draft must exist
 
@@ -1102,7 +1107,7 @@ Flag content that could be unintentionally harmful, with context-aware suggestio
 
 **Description:** Generate a structure-aware pacing report analyzing scene tempo and narrative flow.
 
-**Usage:** `/scr:pacing-analysis`
+**Usage:** `/scr:pacing-analysis [N]`
 
 **Prerequisites:** Draft must exist
 
@@ -1120,7 +1125,7 @@ See where your story drags or rushes. Scriveno maps scene length, tension, and t
 
 **Description:** Audit dialogue for character voice differentiation, attribution clarity, and talking-head detection.
 
-**Usage:** `/scr:dialogue-audit`
+**Usage:** `/scr:dialogue-audit [N]`
 
 **Prerequisites:** Draft must exist with dialogue
 
@@ -1139,9 +1144,9 @@ Check that each character sounds distinct, dialogue tags are clear, and scenes a
 
 ### `/scr:beta-reader`
 
-**Description:** Simulate a beta reader's experience of the manuscript with cross-AI peer review.
+**Description:** Simulate a beta reader's experience of the manuscript using a fresh-context reader persona (same model, not a second or external AI).
 
-**Usage:** `/scr:beta-reader`
+**Usage:** `/scr:beta-reader [N] [--focus <area>]`
 
 **Prerequisites:** Draft must exist
 
@@ -1163,7 +1168,7 @@ Get a simulated reader's reaction: what hooked them, where they got confused, wh
 
 **Description:** Scan drafted prose for AI-generated patterns and unintentional similarity to published works.
 
-**Usage:** `/scr:originality-check`
+**Usage:** `/scr:originality-check [N]`
 
 **Prerequisites:** Draft must exist
 
@@ -1259,7 +1264,7 @@ Get three blurb variations: punchy (Amazon listing), standard (back cover), exte
 
 **Description:** Generate plot synopsis at specified length for query and submission packages.
 
-**Usage:** `/scr:synopsis`
+**Usage:** `/scr:synopsis [--length <1p|2p|5p>]`
 
 **Prerequisites:** Complete draft must exist
 
@@ -1313,7 +1318,7 @@ Generate a full book proposal: overview, market analysis, chapter summaries, aut
 
 **Description:** Generate reading group discussion questions exploring themes, characters, and craft.
 
-**Usage:** `/scr:discussion-questions`
+**Usage:** `/scr:discussion-questions [--count <N>]`
 
 **Prerequisites:** Complete draft must exist
 
@@ -1478,7 +1483,7 @@ Build a poetry-submission DOCX for journal or contest submission using the poetr
 
 **Description:** Run full publishing pipeline unattended with quality gate (voice-check + continuity-check).
 
-**Usage:** `/scr:autopilot-publish --preset <preset>`
+**Usage:** `/scr:autopilot-publish --preset <preset> [--front-level <minimum|balanced|maximum|skip>] [--back-level <minimum|balanced|maximum|skip>]`
 
 **Prerequisites:** Complete draft must exist
 
@@ -1513,7 +1518,7 @@ Commands for generating cover art, scene illustrations, character references, ma
 - `--trim <size>` -- Preferred trim shorthand for prompt framing
 - `--kdp <trim_size>` -- Legacy alias for `--trim`
 - `--series` -- Generate series-consistent cover
-- `--prompt-only` -- Generate prompts without calling image API
+- `--prompt-only` -- Generate prompts without packaging reminders
 - `--element` -- Generate specific cover element
 
 **Example:**

package/docs/configuration.md

@@ -57,22 +57,47 @@ When a writer runs `/scr:new-work`, Scriveno creates `.manuscript/config.json`.
 
 ```json
 {
-  "scriveno_version": "2.5.0",
+  "scriveno_version": "2.7.1",
   "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/context-protocol.md

@@ -6,6 +6,7 @@ It is part of the trust layer:
 - `STATE.md` -- structured snapshot (data)
 - `RECORD.md` -- compact established-content store
 - `.manuscript/CONTEXT.md` -- one-page narrative bootstrap (synthesis)
+- `.manuscript/PROGRESS.md` -- per-unit progress ledger (derived; see `docs/progress-protocol.md`)
 - `.manuscript/HISTORY.log` -- append-only audit trail
 
 ## The rule
@@ -71,7 +72,7 @@ Filesystem mtime is a cheap, durable signal that does not require parsing the fi
 - **Drafter agents** (drafter.md, voice-checker.md, etc.) -- they need the full source files for fidelity.
 - **Read-only data display commands** (`/scr:progress`, `/scr:session-report`) -- already cheap; no orientation files to skip.
 - **First-write commands** (`/scr:new-work`, `/scr:import`) -- no CONTEXT.md exists yet.
-- **The CONTEXT.md regenerators themselves** (`/scr:save`, `/scr:pause-work`, `/scr:resume-work`) -- they MUST load the raw files to rebuild CONTEXT.md correctly. They are the *writers* of CONTEXT.md, not consumers.
+- **The CONTEXT.md and PROGRESS.md regenerators themselves** (`/scr:save`, `/scr:pause-work`, `/scr:resume-work`) -- they MUST load the raw files to rebuild CONTEXT.md and the per-unit PROGRESS.md ledger correctly. They are the *writers* of those derived files, not consumers.
 - **`/scr:scan`** -- its job is to detect drift, so it must read the raw files to compare against CONTEXT.md.
 
 ## Expected savings

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/creative-context.md

@@ -56,7 +56,7 @@ Do not turn `.manuscript/CONTEXT.md` into a glossary. It is an auto-regenerated
 | `cast` | `CHARACTERS.md`, `FIGURES.md` | Character state, voice anchors, relationships, figure continuity |
 | `world` | `WORLD.md`, `COSMOLOGY.md`, `SYSTEM.md` | Setting, constraints, environment, cosmology, operating rules |
 | `themes` | `THEMES.md`, `DOCTRINES.md`, `QUESTIONS.md` | Motifs, doctrine, argument, inquiry, recurring meaning |
-| `continuity` | `STATE.md`, `CONTEXT.md`, `HISTORY.log` | Current position, recent activity, open items, disk truth |
+| `continuity` | `STATE.md`, `CONTEXT.md`, `PROGRESS.md`, `HISTORY.log` | Current position, recent activity, per-unit progress ledger, open items, disk truth |
 | `publication` | front matter, back matter, build files | Export and publishing intent |
 | `translation` | glossary, translation memory, language config | Term consistency and cultural adaptation |
 | `art` | cover, illustration, storyboard assets | Visual continuity and image direction |