scriveno 2.0.7 → 2.0.9

package/README.md

@@ -2,9 +2,11 @@
 
 [![CI](https://github.com/aihxp/scriveno/actions/workflows/ci.yml/badge.svg)](https://github.com/aihxp/scriveno/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-2.0.7-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.0.9-blue)](CHANGELOG.md)
 [![npm](https://img.shields.io/npm/v/scriveno.svg)](https://www.npmjs.com/package/scriveno)
 [![Downloads](https://img.shields.io/npm/dm/scriveno.svg)](https://www.npmjs.com/package/scriveno)
+[![Status CLI](https://img.shields.io/badge/status%20CLI-scriveno%20status-blue)](docs/runtime-support.md#shared-auto-invoke-engine)
+[![Route Intelligence](https://img.shields.io/badge/route%20intelligence-agent%20lanes-blue)](docs/auto-invoke-policy.md)
 
 **[scriveno on npm](https://www.npmjs.com/package/scriveno)**
 
@@ -18,6 +20,9 @@ Scriveno is best understood as **AI-native longform writing software built aroun
 
 ```bash
 npx scriveno@latest
+
+# Optional project status check
+scriveno status --project .
 ```
 
 ---
@@ -68,6 +73,21 @@ If you want the shortest proof-first route, read [Proof Artifacts](docs/proof-ar
 
 ---
 
+## Proactive status
+
+Scriveno ships a shared read-only status engine for every installer target. The public CLI is:
+
+```bash
+scriveno status --project .
+scriveno status . --json
+```
+
+It inspects disk evidence such as `.manuscript/`, `STATE.md`, `CONTEXT.md`, plan files, drafts, review coverage, notes, revision proposals, translation work, publishing prerequisites, exports, and history, then recommends the safest next command. The engine does not mutate files and does not spawn agents by itself. Command surfaces such as `/scr-next`, `/scr:next`, `/scr:progress`, `/scr:session-report`, and `/scr:sync` call it when local command execution is available, then fall back to embedded markdown logic when a host cannot run Node. See [Auto-Invoke Policy](docs/auto-invoke-policy.md) and [Runtime Support](docs/runtime-support.md#shared-auto-invoke-engine).
+
+The status report separates `Candidate agents`, `Candidate local helpers`, and `Manual gates`. That means Scriveno can say when a route is ready for a drafter, voice-checker, translator, continuity-checker, or review worker, when a deterministic helper such as save or scan is enough, and when writer approval is required for publishing, export overwrites, track merges, or undo.
+
+---
+
 ## The Voice DNA system
 
 Scriveno's core insight: drafted prose should sound like *you*, not like an AI. Before drafting begins, `/scr:profile-writer` builds a detailed voice profile across 15+ dimensions:
@@ -171,6 +191,7 @@ Scriveno is built on five principles:
 - [Contributing](docs/contributing.md) -- How to add commands, agents, work types, and templates
 - [Architecture](docs/architecture.md) -- How Scriveno works under the hood
 - [Configuration](docs/configuration.md) -- Package, installer, constraints, and `.manuscript/config.json` surfaces
+- [Auto-Invoke Policy](docs/auto-invoke-policy.md) -- Shared status engine, route intelligence lanes, visible automation status, and agent-spawn boundaries
 - [Development](docs/development.md) -- Contributor workflow for changing commands, templates, installer logic, and docs
 - [Testing](docs/testing.md) -- What the test suite covers and which checks to run before shipping
 - [Release Notes](docs/release-notes.md) -- Public summary of what changed between package releases
@@ -195,7 +216,7 @@ Scriveno currently ships installer targets for these AI tooling environments:
 - **Perplexity Desktop** (guided local-MCP setup)
 - **Generic (SKILL.md)** fallback
 
-**Installer baseline:** `Node.js >=20.0.0` for `npx scriveno@latest` and `bin/install.js`. For new installs, use a currently supported LTS such as Node.js 24; Node.js 20 is now a compatibility floor, not the recommended fresh-install target.
+**Installer baseline:** `Node.js >=20.0.0` for `npx scriveno@latest`, `bin/install.js`, and `scriveno status --project .`. For new installs, use a currently supported LTS such as Node.js 24; Node.js 20 is now a compatibility floor, not the recommended fresh-install target.
 
 **Support note:** Claude Code is the primary reference runtime and now installs a flat `/scr-*` command surface. The environments listed above are installer targets, not a claim that every host runtime has verified parity today. Codex currently installs a skill-native `$scr-*` surface, while Perplexity Desktop is a guided local-MCP target rather than a writable command runtime. See the [runtime compatibility matrix](docs/runtime-support.md) for install type, support level, and verification status.
 
@@ -203,11 +224,11 @@ Scriveno currently ships installer targets for these AI tooling environments:
 
 ## Status
 
-**Version:** 2.0.7
+**Version:** 2.0.9
 
- Scriveno's core command surface is stable across 112 commands, 50 work types, and 11 installer targets. The current repo baseline includes shipped planning milestones through `v2.0 Publishing Cover Packaging`, plus the creative-context, record-store, branching-next, runtime-sync, adaptive concierge, human-first writing-safeguard, authenticity-diagnostic, domain-grilling, installer-marker cleanup, cross-runtime agent metadata, and proactive auto-invoke visibility work through `2.0.7`. See [Shipped Assets](docs/shipped-assets.md) for the canonical asset inventory and [Runtime Support](docs/runtime-support.md) for the runtime compatibility matrix.
+ Scriveno's core command surface is stable across 112 commands, 50 work types, and 11 installer targets. The current repo baseline includes shipped planning milestones through `v2.0 Publishing Cover Packaging`, plus the creative-context, record-store, branching-next, runtime-sync, adaptive concierge, human-first writing-safeguard, authenticity-diagnostic, domain-grilling, installer-marker cleanup, cross-runtime agent metadata, visible automation status, the shared `scriveno status --project .` auto-invoke engine, and route-intelligence lanes through `2.0.9`. See [Shipped Assets](docs/shipped-assets.md) for the canonical asset inventory and [Runtime Support](docs/runtime-support.md) for the runtime compatibility matrix.
 
- Version `2.0.7` publishes Scriveno under the package name `scriveno`, so the current install command is `npx scriveno@latest`. The older `scriveno-cli` package name is historical and was unpublished during the rename, so npm cannot attach a deprecation notice to it while it has no active registry record. The older `scriven-cli` package remains on npm only as a deprecated legacy name that points users to `scriveno`. Do not treat either legacy package name as active unless a deliberate compatibility shim is republished. See [CHANGELOG](CHANGELOG.md) for the full list and [docs/release-notes.md](docs/release-notes.md) for the public-facing summary.
+ Version `2.0.9` publishes Scriveno under the package name `scriveno`, so the current install command is `npx scriveno@latest`. The older `scriveno-cli` package name is historical and was unpublished during the rename, so npm cannot attach a deprecation notice to it while it has no active registry record. The older `scriven-cli` package remains on npm only as a deprecated legacy name that points users to `scriveno`. Do not treat either legacy package name as active unless a deliberate compatibility shim is republished. See [CHANGELOG](CHANGELOG.md) for the full list and [docs/release-notes.md](docs/release-notes.md) for the public-facing summary.
 
 Package history is tracked in [CHANGELOG.md](CHANGELOG.md), and the public-facing summary for this release is in [docs/release-notes.md](docs/release-notes.md).
 

package/bin/install.js

@@ -6,6 +6,7 @@ const os = require('os');
 const readline = require('readline');
 const crypto = require('crypto');
 const architecturalProfiles = require('../lib/architectural-profiles.js');
+const autoInvokeEngine = require('../lib/auto-invoke-engine.js');
 
 const PKG_ROOT = path.join(__dirname, '..');
 const PKG = require('../package.json');
@@ -820,6 +821,8 @@ function printHelp() {
   console.log(BANNER);
   console.log(`Usage:
   scriveno
+  scriveno status --project .
+  scriveno status . --json
   scriveno --runtimes codex,claude-code --global --writer --silent
 
 Options:
@@ -834,6 +837,12 @@ Options:
   --help              Show this help text
   --version           Show the Scriveno package version
 
+Status options:
+  status              Inspect a project and recommend the next command
+  --project <path>    Project root to inspect (default: current directory)
+  --trigger <name>    Status trigger label (default: scriveno status)
+  --json              Print machine-readable status JSON
+
 Runtime keys:
   ${Object.keys(RUNTIMES).join(', ')}
 `);
@@ -841,6 +850,7 @@ Runtime keys:
 
 function parseArgs(argv) {
   const options = {
+    command: 'install',
     runtimeKeys: [],
     installDetected: false,
     isGlobal: null,
@@ -848,8 +858,44 @@ function parseArgs(argv) {
     silent: false,
     showHelp: false,
     showVersion: false,
+    statusProjectRoot: process.cwd(),
+    statusTrigger: 'scriveno status',
+    statusJson: false,
   };
 
+  if (argv[0] === 'status') {
+    options.command = 'status';
+    for (let i = 1; i < argv.length; i++) {
+      const arg = argv[i];
+      if (arg === '--help' || arg === '-h') {
+        options.showHelp = true;
+      } else if (arg === '--version' || arg === '-v') {
+        options.showVersion = true;
+      } else if (arg === '--json') {
+        options.statusJson = true;
+      } else if (arg === '--project') {
+        const value = argv[i + 1];
+        if (!value) throw new Error('--project requires a value for status');
+        options.statusProjectRoot = value;
+        i++;
+      } else if (arg.startsWith('--project=')) {
+        options.statusProjectRoot = arg.slice('--project='.length);
+      } else if (arg === '--trigger') {
+        const value = argv[i + 1];
+        if (!value) throw new Error('--trigger requires a value');
+        options.statusTrigger = value;
+        i++;
+      } else if (arg.startsWith('--trigger=')) {
+        options.statusTrigger = arg.slice('--trigger='.length);
+      } else if (arg.startsWith('-')) {
+        throw new Error(`Unknown status argument "${arg}"`);
+      } else {
+        options.statusProjectRoot = arg;
+      }
+    }
+    return options;
+  }
+
   function addRuntimeList(value) {
     for (const key of String(value).split(',').map((item) => item.trim()).filter(Boolean)) {
       if (!Object.prototype.hasOwnProperty.call(RUNTIMES, key)) {
@@ -901,6 +947,16 @@ function parseArgs(argv) {
   return options;
 }
 
+function runStatus({ projectRoot, trigger, json }) {
+  const analysis = autoInvokeEngine.analyzeProject(projectRoot);
+  if (json) {
+    console.log(JSON.stringify(analysis, null, 2));
+  } else {
+    console.log(autoInvokeEngine.formatReport(analysis, { trigger }));
+  }
+  return analysis;
+}
+
 function resolveInstallRequest(parsed, detectedRuntimeKeys, { isTTY }) {
   const hasRuntimeDirective = parsed.runtimeKeys.length > 0 || parsed.installDetected;
   const hasModifierOverrides = parsed.isGlobal !== null || parsed.developerMode !== null;
@@ -1324,6 +1380,15 @@ async function main() {
     return;
   }
 
+  if (parsed.command === 'status') {
+    runStatus({
+      projectRoot: parsed.statusProjectRoot,
+      trigger: parsed.statusTrigger,
+      json: parsed.statusJson,
+    });
+    return;
+  }
+
   const detectedRuntimeKeys = Object.entries(RUNTIMES).filter(([, runtime]) => runtime.detect()).map(([key]) => key);
   const installRequest = resolveInstallRequest(parsed, detectedRuntimeKeys, { isTTY: Boolean(process.stdin.isTTY) });
 
@@ -1545,11 +1610,13 @@ function installGuidedRuntime(runtime, isGlobal, dataDir, log) {
 function writeSharedAssets(dataDir, runtimeKeys, isGlobal, developerMode, installMode, log) {
   fs.mkdirSync(path.join(dataDir, 'templates'), { recursive: true });
   fs.mkdirSync(path.join(dataDir, 'data'), { recursive: true });
+  fs.mkdirSync(path.join(dataDir, 'lib'), { recursive: true });
   const templateResult = copyDirWithPreservation(path.join(PKG_ROOT, 'templates'), path.join(dataDir, 'templates'));
   const dataResult = copyDirWithPreservation(path.join(PKG_ROOT, 'data'), path.join(dataDir, 'data'));
+  const libResult = copyDirWithPreservation(path.join(PKG_ROOT, 'lib'), path.join(dataDir, 'lib'));
   const sum = (r) => r.fresh + r.replaced + r.backedUp;
-  log(`  ${c('green', 'OK')} ${sum(templateResult)} templates + ${sum(dataResult)} data files -> ${c('dim', dataDir)}`);
-  const totalBackedUp = templateResult.backedUp + dataResult.backedUp;
+  log(`  ${c('green', 'OK')} ${sum(templateResult)} templates + ${sum(dataResult)} data files + ${sum(libResult)} lib files -> ${c('dim', dataDir)}`);
+  const totalBackedUp = templateResult.backedUp + dataResult.backedUp + libResult.backedUp;
   if (totalBackedUp > 0) {
     log(`  ${c('yellow', 'i')} Preserved ${totalBackedUp} user-modified file(s) as .backup.<timestamp>`);
   }
@@ -1706,6 +1773,7 @@ module.exports = {
   RUNTIMES,
   parseArgs,
   resolveInstallRequest,
+  runStatus,
   collectCommandEntries,
   collectAgentEntries,
   assertNoSkillNameCollisions,
@@ -1754,4 +1822,10 @@ module.exports = {
   // Per-work-type pitfall packs
   listPitfallPacks: architecturalProfiles.listPitfallPacks,
   getPitfallPackPath: architecturalProfiles.getPitfallPackPath,
+  // Shared proactive status engine
+  autoInvokeEngine,
+  analyzeProject: autoInvokeEngine.analyzeProject,
+  formatAutoInvokeReport: autoInvokeEngine.formatReport,
+  getRuntimeAgentSupport: autoInvokeEngine.getRuntimeAgentSupport,
+  listRuntimeAgentSupport: autoInvokeEngine.listRuntimeAgentSupport,
 };

package/commands/scr/health.md

@@ -96,9 +96,15 @@ Automation status:
 Trigger: /scr:health {flags}
 Spawned agents:
 - none
+Candidate agents:
+- none
 Local operations:
 - health checks run: {count}
 - repairs applied: {count}
+Candidate local helpers:
+- /scr:scan or /scr:save when health detects repairable drift
+Manual gates:
+- repairs that require writer confirmation
 Auto-invoked:
 - none
 Why: health uses deterministic local checks; non-deterministic repairs stay manual

package/commands/scr/new-work.md

@@ -69,7 +69,7 @@ Always create `RECORD.md` from `templates/RECORD.md` without renaming it. It is
 Write `.manuscript/config.json` by starting from `templates/config.json` and filling the project-specific values. The generated config must include the shared settings blocks that later commands read:
 ```json
 {
-  "scriveno_version": "2.0.7",
+  "scriveno_version": "2.0.9",
   "work_type": "<chosen>",
   "group": "<group>",
   "command_unit": "<unit>",

package/commands/scr/next.md

@@ -8,6 +8,17 @@ You are routing the writer to the right next step in their workflow. This comman
 
 Follow the auto-invoke policy. In the source repository it is documented at `docs/auto-invoke-policy.md`. `/scr:next` is Level 1 only by default: it may inspect disk state and suggest the safest next command, but it does not spawn agents or mutate files unless autopilot mode explicitly routes into another command.
 
+Use the shared executable engine before falling back to manual inspection. Try the first available path:
+
+```bash
+scriveno status --project "$PWD" --trigger /scr:next
+node lib/auto-invoke-engine.js --project "$PWD" --trigger /scr:next
+node "$HOME/.scriveno/lib/auto-invoke-engine.js" --project "$PWD" --trigger /scr:next
+node .scriveno/lib/auto-invoke-engine.js --project "$PWD" --trigger /scr:next
+```
+
+This engine is installed into Scriveno shared assets for every runtime, including Claude Code, Codex, Cursor, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Antigravity, Manus, Perplexity Desktop, and the generic skill fallback. If the engine is not present, perform the read-only sweep below.
+
 ## What to do
 
 1. **Check for `.manuscript/` directory.** If none, the writer has no project. Run `/scr:new-work` to start one (or tell them to).
@@ -123,9 +134,15 @@ Automation status:
 Trigger: /scr:next
 Spawned agents:
 - none
+Candidate agents:
+- <recommended agent route or none>
 Local operations:
 - proactive sweep: read-only
 - state route computed: yes/no
+Candidate local helpers:
+- <recommended helper or none>
+Manual gates:
+- <writer-owned route or none>
 Auto-invoked:
 - <recommended command>: yes/no
 Why: /scr:next routes from disk state; it only runs follow-up commands under autopilot or explicit writer intent

package/commands/scr/progress.md

@@ -9,6 +9,17 @@ You are showing the writer their current project progress.
 
 Follow the auto-invoke policy. In the source repository it is documented at `docs/auto-invoke-policy.md`. `/scr:progress` is read-only: it can count, compare, and recommend, but it must not spawn agents or write files.
 
+Use the shared executable engine before falling back to manual counts. Try the first available path:
+
+```bash
+scriveno status --project "$PWD" --trigger /scr:progress
+node lib/auto-invoke-engine.js --project "$PWD" --trigger /scr:progress
+node "$HOME/.scriveno/lib/auto-invoke-engine.js" --project "$PWD" --trigger /scr:progress
+node .scriveno/lib/auto-invoke-engine.js --project "$PWD" --trigger /scr:progress
+```
+
+This engine is installed into Scriveno shared assets for every runtime, including Claude Code, Codex, Cursor, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Antigravity, Manus, Perplexity Desktop, and the generic skill fallback. If the engine is not present, perform the read-only progress logic below.
+
 ## Prerequisites
 
 - `.manuscript/STATE.md` must exist
@@ -40,9 +51,15 @@ Automation status:
 Trigger: /scr:progress
 Spawned agents:
 - none
+Candidate agents:
+- <recommended agent route or none>
 Local operations:
 - progress counts computed: yes/no
 - proactive sweep: read-only
+Candidate local helpers:
+- <recommended helper or none>
+Manual gates:
+- <writer-owned route or none>
 Auto-invoked:
 - none
 Why: progress is read-only; it recommends next commands without mutating files

package/commands/scr/save.md

@@ -80,11 +80,17 @@ Automation status:
 Trigger: /scr:save
 Spawned agents:
 - none
+Candidate agents:
+- none
 Local operations:
 - STATE.md updated: yes/no
 - CONTEXT.md regenerated: yes/no
 - HISTORY.log appended: yes/no
 - manuscript files saved: yes/no
+Candidate local helpers:
+- /scr:scan if saved state and disk still disagree
+Manual gates:
+- none
 Auto-invoked:
 - /scr:next route computed for CONTEXT.md: yes/no
 Why: save uses deterministic local bookkeeping, not a spawned agent

package/commands/scr/scan.md

@@ -272,10 +272,16 @@ Automation status:
 Trigger: /scr:scan {flags}
 Spawned agents:
 - none
+Candidate agents:
+- none
 Local operations:
 - drift checks run: {count}
 - auto-fixes applied: {count}
 - HISTORY.log appended: yes/no
+Candidate local helpers:
+- /scr:save if scan repairs changed state
+Manual gates:
+- fixes that require writer confirmation
 Auto-invoked:
 - none
 Why: scan compares disk state locally; fixes require writer confirmation

package/commands/scr/session-report.md

@@ -9,6 +9,17 @@ You are summarizing the writer's current session. Your job is to compute actiona
 
 Follow the auto-invoke policy. In the source repository it is documented at `docs/auto-invoke-policy.md`. `/scr:session-report` is read-only and does not spawn agents.
 
+Use the shared executable engine for the read-only status portion before computing session-specific metrics. Try the first available path:
+
+```bash
+scriveno status --project "$PWD" --trigger /scr:session-report
+node lib/auto-invoke-engine.js --project "$PWD" --trigger /scr:session-report
+node "$HOME/.scriveno/lib/auto-invoke-engine.js" --project "$PWD" --trigger /scr:session-report
+node .scriveno/lib/auto-invoke-engine.js --project "$PWD" --trigger /scr:session-report
+```
+
+This engine is installed into Scriveno shared assets for every runtime, including Claude Code, Codex, Cursor, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Antigravity, Manus, Perplexity Desktop, and the generic skill fallback. If the engine is not present, continue with the read-only report logic below.
+
 ## What to do
 
 1. **Read STATE.md "Last actions" table** to get the full history of actions.
@@ -55,9 +66,15 @@ Automation status:
 Trigger: /scr:session-report
 Spawned agents:
 - none
+Candidate agents:
+- <recommended agent route or none>
 Local operations:
 - session metrics computed: yes/no
 - quality pass summary computed: yes/no
+Candidate local helpers:
+- <recommended helper or none>
+Manual gates:
+- <writer-owned route or none>
 Auto-invoked:
 - none
 Why: session-report summarizes disk state without mutating files

package/commands/scr/sync.md

@@ -11,6 +11,17 @@ This command is for local runtime drift: Codex skills, Codex command mirrors, Cl
 
 This is not a package upgrade command. Do not fetch a newer Scriveno release, do not change npm dependencies, and do not modify manuscript content. If the writer wants a newer published package version, that belongs to a future `/scr:update` command.
 
+The auto-invoke status engine is a shared runtime asset. It is copied for every install target and can be checked with one of these paths:
+
+```bash
+scriveno status --project "$PWD" --trigger /scr:sync
+node lib/auto-invoke-engine.js --project "$PWD" --trigger /scr:sync
+node "$HOME/.scriveno/lib/auto-invoke-engine.js" --project "$PWD" --trigger /scr:sync
+node .scriveno/lib/auto-invoke-engine.js --project "$PWD" --trigger /scr:sync
+```
+
+Use it for read-only project status and next-command reasoning. Use `bin/install.js` for runtime file synchronization.
+
 ## Prerequisites
 
 - Node.js >=20.0.0