@volter/twin-standard 1.0.110 → 1.0.111

package/README.md

@@ -35,7 +35,9 @@ assessment World starts. The journey refuses candidate or kernel imports from ev
 app's own lockfile against the assessed integrity. Older evidence without this installation identity does not satisfy
 the current completion check. The public
 `runConsumerWorkflow(packDir, consumer)` lets a builder walk only that entry journey while authoring; it runs no
-grade or conformance checks. Installed readiness requires ordinary CLI initialization against the exact candidate,
+grade or conformance checks. Its CLI is `twin-standard walk-consumer <pack dir> --prepared-consumer <options.json>
+--out <walk.json>`, using the options written by `prepare-consumer`. Run it inside a World after installing the
+prepared app's dependencies. Installed readiness requires ordinary CLI initialization against the exact candidate,
 SDK assertions, read-only state inspection after stop/resume for stored workflows, and verified teardown. A
 stateless workflow records why retained-state inspection does not apply. Empty SDK case execution fails.
 

package/dist/src/cli.js

@@ -31,7 +31,7 @@ import { standardPackageFile } from "./package-file.js";
 import { gatePublished } from "./published.js";
 const [command, ...args] = process.argv.slice(2);
 const usage = () => {
-    console.error('usage: twin-standard gate <repo> [units…] | gate-published <name>@<version>… [--registry <url>] | grade <unit>… [--static] [--form] | derive <unit> [--out <dir>] | read-page <url> [--raw] | check-sources <unit> [--recheck] | conform <pack dir> | <name>@<version> [--registry <url>] | create <dir> --init <vendor> --package <@scope/name> | create <unit> --index | facts <pack dir> [--out <file>] | prepare-consumer <pack dir> --app <new dir> --cli <volter executable> --integrity <sha512> --out <json> [--candidate <tgz>] | assess <pack dir> --prepared-consumer <json> [--browser] [--out <file>] | --version');
+    console.error('usage: twin-standard gate <repo> [units…] | gate-published <name>@<version>… [--registry <url>] | grade <unit>… [--static] [--form] | derive <unit> [--out <dir>] | read-page <url> [--raw] | check-sources <unit> [--recheck] | conform <pack dir> | <name>@<version> [--registry <url>] | create <dir> --init <vendor> --package <@scope/name> | create <unit> --index | facts <pack dir> [--out <file>] | prepare-consumer <pack dir> --app <new dir> --cli <volter executable> --integrity <sha512> --out <json> [--candidate <tgz>] | walk-consumer <pack dir> --prepared-consumer <json> [--out <file>] | assess <pack dir> --prepared-consumer <json> [--browser] [--out <file>] | --version');
     process.exit(2);
 };
 if (command === '--version') {
@@ -130,6 +130,27 @@ else if (command === 'prepare-consumer') {
     writeFileSync(out, JSON.stringify({ appDir, cli, artifactIntegrity }, null, 2) + '\n');
     console.log(JSON.stringify({ appDir, fixture, preparedConsumer: out, next: 'Install the app SDK, candidate and kernel dependencies with scripts disabled before assessing inside a World' }));
 }
+else if (command === 'walk-consumer') {
+    if (!args[0])
+        usage();
+    const at = args.indexOf('--prepared-consumer');
+    if (at < 0 || !args[at + 1])
+        usage();
+    const outputAt = args.indexOf('--out');
+    if (outputAt >= 0 && !args[outputAt + 1])
+        usage();
+    const consumer = JSON.parse(readFileSync(resolve(args[at + 1]), 'utf8'));
+    const { runConsumerWorkflow } = await import("./consumer.js");
+    const report = await runConsumerWorkflow(resolve(args[0]), consumer);
+    const text = `${JSON.stringify(report, null, 2)}\n`;
+    if (outputAt >= 0) {
+        const { writeFileSync } = await import('node:fs');
+        writeFileSync(resolve(args[outputAt + 1]), text);
+    }
+    else
+        console.log(text);
+    process.exit(report.passed ? 0 : 1);
+}
 else if (command === 'assess') {
     if (!args[0])
         usage();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/twin-standard",
-  "version": "1.0.110",
+  "version": "1.0.111",
   "description": "The Protocol 3 standard for Volter twin packs: the criteria a pack is graded by, the grader, the gate a pack repository and the twin catalog run on every change and submission, and the spec derivation the grade checks against. Pin a version: every place a pack is judged judges by that standard.",
   "keywords": [
     "twin",
@@ -75,7 +75,7 @@
     "yaml": "2.9.0"
   },
   "peerDependencies": {
-    "@volter/world-core": "3.0.118",
+    "@volter/world-core": "3.0.119",
     "@volter/world-runtime": "*",
     "playwright": "^1.63.0"
   },

package/src/cli.ts

@@ -24,7 +24,7 @@ import { gatePublished } from './published.ts';
 
 const [command, ...args] = process.argv.slice(2);
 const usage = (): never => {
-  console.error('usage: twin-standard gate <repo> [units…] | gate-published <name>@<version>… [--registry <url>] | grade <unit>… [--static] [--form] | derive <unit> [--out <dir>] | read-page <url> [--raw] | check-sources <unit> [--recheck] | conform <pack dir> | <name>@<version> [--registry <url>] | create <dir> --init <vendor> --package <@scope/name> | create <unit> --index | facts <pack dir> [--out <file>] | prepare-consumer <pack dir> --app <new dir> --cli <volter executable> --integrity <sha512> --out <json> [--candidate <tgz>] | assess <pack dir> --prepared-consumer <json> [--browser] [--out <file>] | --version');
+  console.error('usage: twin-standard gate <repo> [units…] | gate-published <name>@<version>… [--registry <url>] | grade <unit>… [--static] [--form] | derive <unit> [--out <dir>] | read-page <url> [--raw] | check-sources <unit> [--recheck] | conform <pack dir> | <name>@<version> [--registry <url>] | create <dir> --init <vendor> --package <@scope/name> | create <unit> --index | facts <pack dir> [--out <file>] | prepare-consumer <pack dir> --app <new dir> --cli <volter executable> --integrity <sha512> --out <json> [--candidate <tgz>] | walk-consumer <pack dir> --prepared-consumer <json> [--out <file>] | assess <pack dir> --prepared-consumer <json> [--browser] [--out <file>] | --version');
   process.exit(2);
 };
 
@@ -89,6 +89,21 @@ if (command === '--version') {
   const { writeFileSync } = await import('node:fs');
   writeFileSync(out, JSON.stringify({ appDir, cli, artifactIntegrity }, null, 2) + '\n');
   console.log(JSON.stringify({ appDir, fixture, preparedConsumer: out, next: 'Install the app SDK, candidate and kernel dependencies with scripts disabled before assessing inside a World' }));
+} else if (command === 'walk-consumer') {
+  if (!args[0]) usage();
+  const at = args.indexOf('--prepared-consumer');
+  if (at < 0 || !args[at + 1]) usage();
+  const outputAt = args.indexOf('--out');
+  if (outputAt >= 0 && !args[outputAt + 1]) usage();
+  const consumer = JSON.parse(readFileSync(resolve(args[at + 1]!), 'utf8'));
+  const { runConsumerWorkflow } = await import('./consumer.ts');
+  const report = await runConsumerWorkflow(resolve(args[0]!), consumer);
+  const text = `${JSON.stringify(report, null, 2)}\n`;
+  if (outputAt >= 0) {
+    const { writeFileSync } = await import('node:fs');
+    writeFileSync(resolve(args[outputAt + 1]!), text);
+  } else console.log(text);
+  process.exit(report.passed ? 0 : 1);
 } else if (command === 'assess') {
   if (!args[0]) usage();
   const { assessPack } = await import('./assessment.ts');