@volter/twin-standard 1.0.109 → 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/dist/src/walk/behavior-journey.js

@@ -227,7 +227,7 @@ export async function walk(journey, root, collect, opts) {
     const factory = await vendorFetch(journey.vendor);
     const views = await vendorAnswerViews(packsDir(), journey.vendor, dependenciesDir());
     if (!factory) {
-        collect.push({ step: '(setup)', beat: 'ADAPTER', detail: `no create<Name>TwinFetch adapter enrolled for ${journey.vendor}` });
+        collect.push({ step: '(setup)', beat: 'ADAPTER', detail: `no create<Name>Fetch adapter resolved for ${journey.vendor}` });
         return {};
     }
     // the life's companions (`companions`): the packs its vendor calls, each over this walk's root, on the same World and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/twin-standard",
-  "version": "1.0.109",
+  "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.117",
+    "@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');

package/src/walk/behavior-journey.ts

@@ -218,7 +218,7 @@ export async function walk(journey: Journey, root: string, collect: Failure[], o
   if (journey.host !== undefined && !/^[A-Za-z0-9.-]+(:\d+)?$/.test(journey.host)) { collect.push({ step: '(setup)', beat: 'HOST', detail: `the life's host "${journey.host}" is no hostname: write the vendor's host alone (api.example.com), no scheme or path` }); return {}; }
   const factory = await vendorFetch(journey.vendor);
   const views = await vendorAnswerViews(packsDir(), journey.vendor, dependenciesDir());
-  if (!factory) { collect.push({ step: '(setup)', beat: 'ADAPTER', detail: `no create<Name>TwinFetch adapter enrolled for ${journey.vendor}` }); return {}; }
+  if (!factory) { collect.push({ step: '(setup)', beat: 'ADAPTER', detail: `no create<Name>Fetch adapter resolved for ${journey.vendor}` }); return {}; }
   // the life's companions (`companions`): the packs its vendor calls, each over this walk's root, on the same World and
   // clock; reached in process by the vendor's ctx.vendorFetch and by a step to a URL their host rules claim
   const companions: Array<{ vendor: string; keys: string[]; fetch: InProcessTwin }> = [];