scriveno 2.0.11 → 2.5.0

package/docs/starter-sets.md

@@ -0,0 +1,82 @@
+# Starter Sets
+
+Scriveno has a large command surface because it covers many kinds of writing. Starter sets give each writer a short path instead of asking them to learn every command up front.
+
+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.
+- `/scr:profile-writer` turns the style guide into a real Voice DNA profile.
+- `/scr:discuss` shapes the next unit with a few targeted questions.
+- `/scr:plan` writes the next unit plan.
+- `/scr:draft` drafts the planned unit in fresh context.
+- `/scr:editor-review` reviews the draft for revision.
+- `/scr:next` chooses the safest next move from project state.
+
+## Polish A Manuscript
+
+- `/scr:import` brings existing material into a Scriveno project.
+- `/scr:profile-writer` calibrates the voice profile against your actual prose.
+- `/scr:continuity-check` finds contradictions and timeline drift.
+- `/scr:voice-check` compares drafts against Voice DNA.
+- `/scr:line-edit` improves sentence-level flow.
+- `/scr:copy-edit` catches grammar, clarity, and consistency issues.
+- `/scr:polish` chains the revision passes when the manuscript is ready.
+
+## Publish An Ebook
+
+- `/scr:publish` starts the publication workflow.
+- `/scr:front-matter` prepares title-page, copyright, and dedication pages.
+- `/scr:back-matter` prepares author notes, acknowledgments, and reader materials.
+- `/scr:blurb` drafts store-facing description copy.
+- `/scr:cover-art` prepares cover direction or cover assets.
+- `/scr:build-ebook` builds the ebook package.
+- `/scr:export` writes the selected export format.
+
+## Translate A Work
+
+- `/scr:translation-glossary` defines recurring terms, names, and voice rules.
+- `/scr:translation-memory` records approved translation decisions.
+- `/scr:translate` translates the selected unit or manuscript segment.
+- `/scr:cultural-adaptation` flags idioms and culture-specific phrasing.
+- `/scr:back-translate` checks whether meaning survived translation.
+- `/scr:multi-publish` prepares parallel translated editions.
+
+## Build Sacred Commentary
+
+- `/scr:new-work` creates a commentary, devotional, homiletic, or scripture project.
+- `/scr:sacred:source-tracking` records primary and secondary source anchors.
+- `/scr:sacred:concordance` builds searchable term and passage links.
+- `/scr:sacred:cross-reference` maps related passages and interpretive connections.
+- `/scr:sacred:doctrinal-check` verifies internal consistency and tradition constraints.
+- `/scr:draft` writes the next commentary or sacred text unit.
+- `/scr:editor-review` reviews the unit without flattening the tradition-native vocabulary.
+
+## Repair And Resume
+
+- `/scr:health` diagnoses missing files, stale state, and broken project assumptions.
+- `/scr:sync` checks installed command, agent, and helper surfaces.
+- `/scr:scan` refreshes project inventory.
+- `/scr:check-notes` surfaces open notes and unresolved reminders.
+- `/scr:resume-work` restores the paused thread or project state.
+- `/scr:next` chooses the next safe command.
+
+## Command Shape By Runtime
+
+The starter sets use `/scr:*` because that is the shared command id format in Scriveno docs. Host surfaces differ:
+
+- Claude Code uses flat commands such as `/scr-draft`.
+- Standard command-directory runtimes currently keep `/scr:draft`.
+- Codex uses generated skills such as `$scr-draft`.
+- Guided targets such as Perplexity Desktop follow their generated setup instructions.
+
+See [Runtime Support](runtime-support.md) for the canonical runtime matrix.

package/docs/testing.md

@@ -10,7 +10,8 @@ The root `package.json` defines:
 "scripts": {
   "test": "node --test test/*.test.js",
   "pack:check": "npm pack --dry-run",
-  "release:check": "npm test && npm run pack:check",
+  "policy:check": "node scripts/check-writing-policy.js",
+  "release:check": "npm test && npm run policy:check && npm run pack:check",
   "prepublishOnly": "npm run release:check"
 }
 ```
@@ -19,7 +20,8 @@ That means:
 
 - `npm test` runs the whole test suite
 - `npm run pack:check` verifies the package contents that would ship
-- `npm run release:check` runs both test and package checks
+- `npm run policy:check` scans tracked text files for the repo writing policy
+- `npm run release:check` runs tests, policy checks, and package checks
 - publishing is guarded by `release:check` through `prepublishOnly`
 
 ## Run the suite
@@ -95,8 +97,10 @@ Use these when changing README, docs, shipped-assets claims, or milestone trust
 
 - `test/phase13-launch-surface-integrity.test.js`
 - `test/phase15-proof-artifacts-positioning.test.js`
+- `test/first-run-proof-surface.test.js`
 - `test/phase19-verification-trust-surface-updates.test.js`
 - `test/repository-policy.test.js`
+- `npm run policy:check`
 
 ### Feature-family regression tests
 
@@ -136,6 +140,12 @@ For the standard release gate, prefer:
 npm run release:check
 ```
 
+For docs, prompt, command markdown, and release-note changes, run:
+
+```bash
+npm run policy:check
+```
+
 When changing proactive routing, runtime install paths, or agent surfaces, also run:
 
 ```bash
@@ -148,6 +158,8 @@ scriveno routes --json
 
 Use those for release prep so you can inspect what would ship without mutating the registry.
 
+For the full publish path, including clearing local installs, packing, publishing, pushing, creating the GitHub release, and verifying `scriveno@latest`, use [Release Checklist](release-checklist.md).
+
 ## Practical workflow
 
 For most changes:
@@ -156,11 +168,14 @@ For most changes:
 2. make the fix
 3. rerun the targeted files
 4. run `npm test`
-5. if packaging or release docs changed, run `npm run release:check`
+5. if docs, prompts, commands, or release notes changed, run `npm run policy:check`
+6. if packaging or release docs changed, run `npm run release:check`
 
 ## Related docs
 
 - [Development](development.md)
 - [Configuration](configuration.md)
 - [Contributing](contributing.md)
+- [Quick Proof](quick-proof.md)
+- [Release Checklist](release-checklist.md)
 - [Release Notes](release-notes.md)

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 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scriveno",
-  "version": "2.0.11",
+  "version": "2.5.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"
@@ -9,7 +9,8 @@
     "start": "node bin/install.js",
     "test": "node --test test/*.test.js",
     "pack:check": "npm pack --dry-run",
-    "release:check": "npm test && npm run pack:check",
+    "policy:check": "node scripts/check-writing-policy.js",
+    "release:check": "npm test && npm run policy:check && npm run pack:check",
     "prepublishOnly": "npm run release:check"
   },
   "publishConfig": {
@@ -47,6 +48,7 @@
     "commands/",
     "agents/",
     "templates/",
+    "scripts/",
     "docs/",
     "README.md",
     "LICENSE"

package/scripts/check-writing-policy.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { execSync } = require('node:child_process');
+
+const ROOT = path.join(__dirname, '..');
+const BINARY_EXTENSIONS = new Set([
+  '.docx',
+  '.gif',
+  '.ico',
+  '.jpeg',
+  '.jpg',
+  '.pdf',
+  '.png',
+  '.tgz',
+  '.zip',
+]);
+
+function trackedFiles() {
+  const output = execSync('git ls-files', { cwd: ROOT, encoding: 'utf8' }).trim();
+  return output ? output.split(/\n/) : [];
+}
+
+function isBinaryPath(relativePath) {
+  return BINARY_EXTENSIONS.has(path.extname(relativePath).toLowerCase());
+}
+
+function lineNumberFor(source, index) {
+  return source.slice(0, index).split('\n').length;
+}
+
+function shouldFlag(codePoint, char) {
+  return codePoint === 0x2013
+    || codePoint === 0x2014
+    || /\p{Extended_Pictographic}/u.test(char);
+}
+
+function scan() {
+  const findings = [];
+
+  for (const relativePath of trackedFiles()) {
+    if (isBinaryPath(relativePath)) {
+      continue;
+    }
+
+    const absolutePath = path.join(ROOT, relativePath);
+    const buffer = fs.readFileSync(absolutePath);
+    if (buffer.includes(0)) {
+      continue;
+    }
+
+    const source = buffer.toString('utf8');
+    for (let index = 0; index < source.length; index += 1) {
+      const codePoint = source.codePointAt(index);
+      const char = String.fromCodePoint(codePoint);
+      if (shouldFlag(codePoint, char)) {
+        findings.push({
+          codePoint,
+          line: lineNumberFor(source, index),
+          relativePath,
+        });
+      }
+
+      if (codePoint > 0xffff) {
+        index += 1;
+      }
+    }
+  }
+
+  return findings;
+}
+
+const findings = scan();
+
+for (const finding of findings) {
+  const hex = finding.codePoint.toString(16).toUpperCase().padStart(4, '0');
+  console.error(`${finding.relativePath}:${finding.line}: forbidden U+${hex}`);
+}
+
+if (findings.length > 0) {
+  console.error(`Writing policy scan failed: ${findings.length} forbidden marker(s).`);
+  process.exit(1);
+}
+
+console.log('Writing policy scan passed.');

package/templates/config.json

@@ -1,5 +1,5 @@
 {
-  "scriveno_version": "2.0.11",
+  "scriveno_version": "2.5.0",
   "work_type": "",
   "group": "",
   "command_unit": "",