scriveno 2.7.1 → 2.8.0

package/docs/command-reference.md

@@ -1,6 +1,6 @@
 # Command Reference
 
-Scriveno has **113 commands** organized into **14 categories**. Commands adapt automatically to your work type -- for example, `/scr:draft` talks about drafting a surah for Quranic commentary, an act for screenplays, and a section for research papers.
+Scriveno has **115 commands** organized into **14 categories**. Commands adapt automatically to your work type -- for example, `/scr:draft` talks about drafting a surah for Quranic commentary, an act for screenplays, and a section for research papers.
 
 Commands marked with **adaptive terminology** change how Scriveno talks about your work type's `command_unit` in `.manuscript/config.json`, while keeping the runnable command id stable. Commands marked with **group adaptation** have different labels for specific work type groups (academic, sacred, etc.).
 
@@ -146,6 +146,26 @@ Finalize Chapter 3 after editor review. Marks it as complete in the workflow.
 
 ---
 
+### `/scr:proof-unit`
+
+**Description:** Run one manuscript unit through a proof path from voice profile to export readiness.
+
+**Usage:** `/scr:proof-unit [unit] [--demo] [--export-check]`
+
+**Prerequisites:** STYLE-GUIDE.md should exist. If it is missing, run `/scr:profile-writer` or `/scr:voice-test` first.
+
+**Flags:**
+- `--demo` -- Use the demo proof path when available
+- `--export-check` -- Run `/scr:export --check` after review to verify external tools
+
+**Example:**
+```
+/scr:proof-unit 3 --export-check
+```
+Prove one chapter through discuss, plan, draft, review, context health, and export-tool readiness without silently running a full publishing pipeline.
+
+---
+
 ### `/scr:complete-draft`
 
 **Description:** Mark the entire manuscript draft as complete.
@@ -1336,7 +1356,7 @@ Generate 10-15 book club questions that spark real conversation about your theme
 
 **Description:** Publishing wizard or preset-driven pipeline. Chains export commands based on destination.
 
-**Usage:** `/scr:publish [--preset <preset>] [--all] [--skip-validate]`
+**Usage:** `/scr:publish [--preset <preset>] [--all] [--skip-validate] [--preflight]`
 
 **Prerequisites:** None (wraps export commands)
 
@@ -1348,6 +1368,7 @@ Generate 10-15 book club questions that spark real conversation about your theme
   - **Academic / archival:** `academic-submission`, `thesis-defense`, `all-formats`
 - `--all` -- Run all applicable presets
 - `--skip-validate` -- Skip the scaffold-marker validation gate (not recommended)
+- `--preflight` -- Check publishing readiness and external tools, then stop before writing deliverables
 - No flags -- Run the interactive wizard, which asks the writer-facing question "What are you doing?" (Share / Publish / Submit / Academic / Screenplay / Everything / Custom) and drills into the matching branch.
 
 **Available for:** All work types
@@ -1364,7 +1385,7 @@ Run the full KDP paperback publishing pipeline: prepare the interior package, ge
 
 **Description:** Compile and export manuscript to publication-ready formats.
 
-**Usage:** `/scr:export [--format <format>] [--formatted] [--print-ready] [--skip-validate]`
+**Usage:** `/scr:export [--format <format>] [--formatted] [--print-ready] [--skip-validate] [--check]`
 
 **Prerequisites:** Complete draft must exist
 
@@ -1373,6 +1394,7 @@ Run the full KDP paperback publishing pipeline: prepare the interior package, ge
 - `--formatted` -- Use designed/formatted template (vs. manuscript format)
 - `--print-ready` -- Generate the interior print PDF surface used by print-package flows
 - `--skip-validate` -- Skip the scaffold-marker validation gate (not recommended)
+- `--check` -- Verify format availability and required external tools without assembling or writing export files
 
 **Available for:** All work types (format availability varies by work type)
 
@@ -1932,12 +1954,13 @@ See all your writing projects with status, word count, and last activity.
 
 **Description:** Diagnose and repair common project state issues.
 
-**Usage:** `/scr:health [--repair]`
+**Usage:** `/scr:health [--repair] [--context]`
 
 **Prerequisites:** None
 
 **Flags:**
 - `--repair` -- Attempt to fix detected issues
+- `--context` -- Estimate loaded-context size and flag watch, tight, or critical sessions
 
 **Available for:** All work types
 
@@ -1949,6 +1972,30 @@ Check for missing files, broken references, and state inconsistencies, then fix
 
 ---
 
+### `/scr:surface`
+
+**Description:** Inspect or change the installed Scriveno command profile.
+
+**Usage:** `/scr:surface [list|status|profile <name>] [--runtime <runtime>] [--dry-run]`
+
+**Prerequisites:** Node.js >=20.0.0 and a Scriveno package or repo checkout with `bin/install.js`
+
+**Flags:**
+- `list` -- Show available profiles and command counts
+- `status` -- Show the currently installed profile and runtime surface
+- `profile <name>` -- Reinstall a named profile: core, writing, publishing, translation, specialist, or full
+- `--dry-run` -- Show the planned install changes without writing files
+
+**Available for:** All work types
+
+**Example:**
+```
+/scr:surface profile writing --dry-run
+```
+Preview a smaller drafting-focused command surface before changing installed runtime files.
+
+---
+
 ### `/scr:scan`
 
 **Description:** Detect drift between recorded state (STATE.md, OUTLINE.md, config.json) and what is actually on disk.

package/docs/configuration.md

@@ -57,7 +57,7 @@ When a writer runs `/scr:new-work`, Scriveno creates `.manuscript/config.json`.
 
 ```json
 {
-  "scriveno_version": "2.7.1",
+  "scriveno_version": "2.8.0",
   "work_type": "<chosen>",
   "group": "<group>",
   "command_unit": "<unit>",

package/docs/development.md

@@ -159,7 +159,7 @@ For release-oriented documentation surfaces, the main files are:
 - `docs/runtime-support.md`
 - `docs/route-graph.md`
 - `templates/*/README.md` when shipped profiles or templates change
-- `.planning/` milestone summaries when you are still using the GSD planning layer
+- `.planning/` milestone summaries when you are still using an external planning layer
 
 ## Before shipping
 

package/docs/release-notes.md

@@ -2,11 +2,37 @@
 
 This document is the public-facing summary of what changed between package releases. For package history, see the root [CHANGELOG](../CHANGELOG.md).
 
+## 2.8.0 - 2026-05-30
+
+### What changed
+
+- Scriveno can now install focused command profiles: `core`, `writing`, `publishing`, `translation`, `specialist`, or `full`. The new `/scr:surface` command and `scriveno surface` CLI helpers let writers inspect, dry-run, and switch profiles.
+- Added `/scr:proof-unit`, a one-unit proof path that checks voice context, plans, drafts, reviews, context health, and optional export-tool readiness.
+- Added context-health estimation to `scriveno status`, `/scr:next`, and `/scr:health --context`, with watch, tight, and critical thresholds.
+- Added `/scr:export --check` and `/scr:publish --preflight` so tool readiness and publishing prerequisites can be verified before writing deliverables.
+- Updated the public command inventory to 115 commands and added regression tests for profiles, dry-run installs, context health, proof-unit, and preflight surfaces.
+
+### Why it matters
+
+Writers can keep Scriveno small when they only need the active workflow, prove the product on one real unit before trusting a larger run, and check export or publishing readiness before generating packages.
+
+## 2.7.2 - 2026-05-30
+
+### What changed
+
+- Progress ledger correctness: reviewed units with open editor notes now stay in progress instead of being counted as done. Submitted units still count as done, and clean reviews count as done when the workflow stops at review.
+- `/scr:scan` now points its plan and review counts at the canonical `.manuscript/plans/` and `.manuscript/reviews/` directories, with legacy root-level fallbacks.
+- The 2.7.1 release text now matches the actual `scriveno status` output.
+
+### Why it matters
+
+The progress bar now reflects the writer's real state of work: review notes still waiting on revision no longer look finished.
+
 ## 2.7.1 - 2026-05-30
 
 ### What changed
 
-- `scriveno status` now prints the progress ledger directly (a `Progress:` line with bar, done / in progress / untouched, and pipeline position), so the deliverable view is visible from the bundled CLI, not only to runtimes that load the engine module.
+- `scriveno status` now prints the progress ledger directly (a `Progress:` line with the bar and done / in progress / untouched counts), so the deliverable view is visible from the bundled CLI, not only to runtimes that load the engine module.
 - Documentation-integrity pass: corrected the context-integrity layer description (now five files), added `PROGRESS.md` to the scan trust-file lists and the architecture template tree, and refreshed stale version and count references across the docs.
 
 ### Why it matters
@@ -64,7 +90,7 @@ This release closes the gap between what Scriveno documented and what it shipped
 - 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.
+- Runtime smoke now validates the 115-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

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.7.1`, the route graph contains:
+As of `2.8.0`, the route graph contains:
 
-- 113 commands
+- 115 commands
 - intent-order edges from `command_intents`
 - dependency-chain edges from `dependencies.core_chain`
 - automation lanes from `getCommandAutomationPolicy()`

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 113 commands, including the [Sacred Exclusive](command-reference.md#sacred-exclusive) section
+- [Command Reference](command-reference.md) -- Full reference for all 115 commands, including the [Sacred Exclusive](command-reference.md#sacred-exclusive) section
 - [README](../README.md) -- Project overview and feature list

package/docs/voice-dna.md

@@ -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 113 commands with usage and examples
+- [Command Reference](command-reference.md) -- Full list of all 115 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 113 commands with usage and examples
+- [Command Reference](command-reference.md) -- Full list of all 115 commands with usage and examples
 - [Voice DNA Guide](voice-dna.md) -- How Scriveno profiles and preserves your writing voice

package/lib/auto-invoke-engine.js

@@ -91,6 +91,7 @@ const REVIEW_KEYWORDS = [
   'VOICE DRIFT',
   'CONTINUITY',
 ];
+const OPEN_REVIEW_KEYWORDS = REVIEW_KEYWORDS.filter((keyword) => keyword !== 'CONTINUITY');
 
 const CORE_PROJECT_FILES = [
   'WORK.md',
@@ -580,6 +581,72 @@ function detectContextSignal(manuscriptDir, draftFiles) {
   return { state: 'fresh', suggest: null };
 }
 
+const CONTEXT_HEALTH_LIMITS = {
+  watch: 45000,
+  tight: 80000,
+  critical: 120000,
+};
+
+function estimateTextTokens(byteCount) {
+  return Math.ceil(byteCount / 4);
+}
+
+function fileByteSize(filePath) {
+  const stat = safeStat(filePath);
+  return stat && stat.isFile() ? stat.size : 0;
+}
+
+function newestFiles(files, limit) {
+  return files
+    .map((file) => ({ file, mtime: safeStat(file)?.mtimeMs || 0 }))
+    .sort((a, b) => b.mtime - a.mtime)
+    .slice(0, limit)
+    .map((entry) => entry.file);
+}
+
+function detectContextHealth(manuscriptDir, draftFiles) {
+  const coreFiles = [
+    'STYLE-GUIDE.md',
+    'CONTEXT.md',
+    'STATE.md',
+    'OUTLINE.md',
+    'RECORD.md',
+    'WORK.md',
+    'config.json',
+  ].map((name) => path.join(manuscriptDir, name));
+  const reviewFiles = newestFiles(listFiles(path.join(manuscriptDir, 'reviews'), { extensions: ['.md', '.txt'], recursive: true }), 3);
+  const planFiles = newestFiles(listFiles(path.join(manuscriptDir, 'plans'), { extensions: ['.md'], recursive: true }), 3);
+  const recentDrafts = newestFiles(draftFiles, 5);
+  const uniqueFiles = [...new Set([...coreFiles, ...planFiles, ...recentDrafts, ...reviewFiles])].filter(pathExists);
+  const files = uniqueFiles.map((file) => ({
+    file: path.relative(manuscriptDir, file),
+    bytes: fileByteSize(file),
+  }));
+  const estimatedBytes = files.reduce((sum, file) => sum + file.bytes, 0);
+  const estimatedTokens = estimateTextTokens(estimatedBytes);
+  let state = 'ok';
+  let suggest = null;
+  if (estimatedTokens >= CONTEXT_HEALTH_LIMITS.critical) {
+    state = 'critical';
+    suggest = '/scr:thread';
+  } else if (estimatedTokens >= CONTEXT_HEALTH_LIMITS.tight) {
+    state = 'tight';
+    suggest = '/scr:save';
+  } else if (estimatedTokens >= CONTEXT_HEALTH_LIMITS.watch) {
+    state = 'watch';
+    suggest = '/scr:health --context';
+  }
+  return {
+    state,
+    estimatedTokens,
+    estimatedBytes,
+    fileCount: files.length,
+    limits: { ...CONTEXT_HEALTH_LIMITS },
+    largestFiles: files.sort((a, b) => b.bytes - a.bytes).slice(0, 5),
+    suggest,
+  };
+}
+
 function detectExportSignal(manuscriptDir, sourceFiles) {
   const newestSource = newestMtime(sourceFiles);
   const newestOutput = findNewestOutput(manuscriptDir);
@@ -756,6 +823,12 @@ function buildAutomationPlan(signals, recommendation) {
   if (signals.context?.state === 'stale') {
     localCandidates.push({ command: signals.context.suggest || '/scr:scan', reason: 'refresh stale context before chaining work' });
   }
+  if (signals.contextHealth?.state === 'tight' || signals.contextHealth?.state === 'critical') {
+    localCandidates.push({
+      command: signals.contextHealth.suggest || '/scr:health --context',
+      reason: `loaded context estimate is ${signals.contextHealth.state}`,
+    });
+  }
   if (signals.notes?.count > 0) {
     localCandidates.push({ command: '/scr:check-notes', reason: 'surface unresolved notes before the next writing route' });
   }
@@ -800,6 +873,7 @@ function analyzeProject(projectRoot = process.cwd(), options = {}) {
       hasProject: false,
       hasState: false,
       context: { state: 'none', suggest: null },
+      contextHealth: { state: 'none', estimatedTokens: 0, estimatedBytes: 0, fileCount: 0, largestFiles: [], suggest: null },
       history: { state: 'none', lastFailed: false },
       reviews: { state: 'none', count: 0, files: [] },
       reviewCoverage: { state: 'none', suggest: null },
@@ -843,6 +917,7 @@ function analyzeProject(projectRoot = process.cwd(), options = {}) {
     hasProject: true,
     hasState: pathExists(statePath),
     context: detectContextSignal(manuscriptDir, draftFiles),
+    contextHealth: detectContextHealth(manuscriptDir, draftFiles),
     history: historySignal,
     readiness: detectProjectReadiness(manuscriptDir),
     plan: detectPlanSignal(manuscriptDir, draftFiles),
@@ -894,6 +969,7 @@ function formatProactiveChecks(analysis) {
     progressLine,
     `  Readiness: ${signals.readiness?.state || 'none'}${signals.readiness?.missing?.length ? `, missing ${signals.readiness.missing.join(', ')}` : ''}`,
     `  Session: ${signals.context.state}${signals.context.suggest ? `, suggest ${signals.context.suggest}` : ''}`,
+    `  Context health: ${signals.contextHealth?.state || 'none'}${signals.contextHealth?.estimatedTokens ? `, about ${signals.contextHealth.estimatedTokens} tokens` : ''}${signals.contextHealth?.suggest ? `, suggest ${signals.contextHealth.suggest}` : ''}`,
     `  Plans: ${signals.plan?.state || 'none'}${signals.plan?.suggest ? `, suggest ${signals.plan.suggest}` : ''}`,
     `  Reviews: ${signals.reviews.count ? `${signals.reviews.count} pending, suggest /scr:editor-review` : 'none'}`,
     `  Review coverage: ${signals.reviewCoverage?.state || 'none'}${signals.reviewCoverage?.suggest ? `, suggest ${signals.reviewCoverage.suggest}` : ''}`,
@@ -1404,6 +1480,30 @@ function ledgerUnitNumbers(dir, suffixRegex) {
   return found;
 }
 
+function ledgerUnitFileMap(dir, suffixRegex) {
+  const found = new Map();
+  let entries;
+  try {
+    entries = fs.readdirSync(dir);
+  } catch (err) {
+    return found;
+  }
+  for (const name of entries) {
+    const match = name.match(suffixRegex);
+    if (match) {
+      found.set(parseInt(match[1], 10), path.join(dir, name));
+    }
+  }
+  return found;
+}
+
+function mergeUnitFileMaps(target, source) {
+  for (const [unit, file] of source.entries()) {
+    if (!target.has(unit)) target.set(unit, file);
+  }
+  return target;
+}
+
 function ledgerOutlineUnitCount(manuscriptDir) {
   let text;
   try {
@@ -1426,6 +1526,39 @@ function ledgerBar(done, total, width) {
   return '█'.repeat(clamped) + '░'.repeat(cells - clamped);
 }
 
+function ledgerReferencedUnits(text) {
+  const units = new Set();
+  const pattern = /\b(?:unit|chapter|scene|section|act|part|surah|procedure|poem)\s*#?\s*(\d+)\b/gi;
+  let match;
+  while ((match = pattern.exec(text)) !== null) {
+    const unit = parseInt(match[1], 10);
+    if (unit > 0) units.add(unit);
+  }
+  return units;
+}
+
+function stateOpenRevisionUnits(manuscriptDir) {
+  const text = readText(path.join(manuscriptDir, 'STATE.md'));
+  const open = new Set();
+  for (const line of text.split(/\r?\n/)) {
+    if (!/(open revisions|unresolved review|editor notes.*awaiting revision|awaiting revision|revisions pending)/i.test(line)) {
+      continue;
+    }
+    for (const unit of ledgerReferencedUnits(line)) open.add(unit);
+  }
+  return open;
+}
+
+function stateSubmittedUnits(manuscriptDir) {
+  const text = readText(path.join(manuscriptDir, 'STATE.md'));
+  const submitted = new Set();
+  for (const line of text.split(/\r?\n/)) {
+    if (!/\b(submit|submitted)\b/i.test(line)) continue;
+    for (const unit of ledgerReferencedUnits(line)) submitted.add(unit);
+  }
+  return submitted;
+}
+
 // Returns deliverable progress for a project's .manuscript directory: total
 // units, per-stage counts, the done / in-progress / untouched buckets, a
 // percent, a rendered bar, and the unit-number sets. Derived purely from disk
@@ -1439,17 +1572,30 @@ function computeProgressLedger(manuscriptDir) {
   for (const unit of ledgerUnitNumbers(manuscriptDir, /^(\d+)\D.*PLAN\.md$/i)) {
     planned.add(unit);
   }
-  const reviewed = ledgerUnitNumbers(path.join(manuscriptDir, 'reviews'), /^(\d+)\D.*REVIEW\.md$/i);
-  for (const unit of ledgerUnitNumbers(manuscriptDir, /^(\d+)\D.*EDITOR-NOTES\.md$/i)) {
-    reviewed.add(unit);
+  const reviewFiles = ledgerUnitFileMap(path.join(manuscriptDir, 'reviews'), /^(\d+)\D.*REVIEW\.md$/i);
+  mergeUnitFileMaps(reviewFiles, ledgerUnitFileMap(manuscriptDir, /^(\d+)\D.*EDITOR-NOTES\.md$/i));
+  const reviewed = new Set(reviewFiles.keys());
+  const submitted = stateSubmittedUnits(manuscriptDir);
+  const openReviews = stateOpenRevisionUnits(manuscriptDir);
+  for (const [unit, file] of reviewFiles.entries()) {
+    if (containsAny(readText(file), OPEN_REVIEW_KEYWORDS)) {
+      openReviews.add(unit);
+    }
+  }
+  for (const unit of submitted) {
+    openReviews.delete(unit);
+  }
+  const doneUnits = new Set(submitted);
+  for (const unit of reviewed) {
+    if (!openReviews.has(unit)) doneUnits.add(unit);
   }
 
-  const worked = new Set([...planned, ...drafted, ...reviewed]);
+  const worked = new Set([...planned, ...drafted, ...reviewed, ...submitted]);
   const maxWorked = worked.size ? Math.max(...worked) : 0;
   const total = Math.max(ledgerOutlineUnitCount(manuscriptDir), worked.size, maxWorked);
 
-  const done = reviewed.size;
-  const inProgress = [...worked].filter((unit) => !reviewed.has(unit)).length;
+  const done = doneUnits.size;
+  const inProgress = [...worked].filter((unit) => !doneUnits.has(unit)).length;
   const untouched = Math.max(0, total - worked.size);
   const percent = total > 0 ? Math.round((done / total) * 100) : 0;
 
@@ -1458,6 +1604,7 @@ function computeProgressLedger(manuscriptDir) {
     drafted: drafted.size,
     planned: planned.size,
     reviewed: reviewed.size,
+    submitted: submitted.size,
     done,
     inProgress,
     untouched,
@@ -1467,6 +1614,9 @@ function computeProgressLedger(manuscriptDir) {
       drafted: [...drafted].sort((a, b) => a - b),
       planned: [...planned].sort((a, b) => a - b),
       reviewed: [...reviewed].sort((a, b) => a - b),
+      submitted: [...submitted].sort((a, b) => a - b),
+      openReviews: [...openReviews].sort((a, b) => a - b),
+      done: [...doneUnits].sort((a, b) => a - b),
     },
   };
 }
@@ -1499,4 +1649,6 @@ module.exports = {
   listRuntimeAgentSupport,
   parseCliArgs,
   computeProgressLedger,
+  detectContextHealth,
+  estimateTextTokens,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scriveno",
-  "version": "2.7.1",
+  "version": "2.8.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.7.1",
+  "scriveno_version": "2.8.0",
   "work_type": "",
   "group": "",
   "command_unit": "",