@volter/twin-standard 1.0.135 → 1.0.136

package/README.md

@@ -20,6 +20,10 @@ twin-standard assess <pack dir> --prepared-consumer <json> [--browser] [--out <f
 twin-standard --version                                      # this package's version and each standard's
 ```
 
+The commands run with this package and its `@volter/world-core` peer installed. `@volter/world-runtime` is an
+optional peer, needed only to serve or walk a pack whose descriptor declares a `managedDatabase` (`conform`, `assess`):
+install it beside this package for those, which name it when it is absent.
+
 What each criterion asks, and the rules for changing one, are twin-world's
 [architecture, "The grade"](https://github.com/volter-ai/twin-world/blob/main/docs/contributing/architecture.md#the-grade).
 A changed criterion is a release of this package: a criterion's id never changes meaning; a changed criterion takes a

package/dist/src/walk/walk-database.js

@@ -5,10 +5,18 @@ import { createServer } from 'node:net';
 import { tmpdir } from 'node:os';
 import { createRequire } from 'node:module';
 import { dirname, extname, join } from 'node:path';
-import { runWorld, setWorldClock, worldConfigDocument } from '@volter/world-runtime';
 import { worldNow } from '@volter/world-core/runtime';
-const runtimeEntry = createRequire(import.meta.url).resolve('@volter/world-runtime');
-const infrastructureCli = join(dirname(runtimeEntry), `infra-cli${extname(runtimeEntry)}`);
+let loaded;
+const worldRuntime = () => loaded ??= (async () => {
+    let entry;
+    try {
+        entry = createRequire(import.meta.url).resolve('@volter/world-runtime');
+    }
+    catch {
+        throw new Error('A managed database walk needs @volter/world-runtime installed beside @volter/twin-standard: npm i @volter/world-runtime');
+    }
+    return { runtime: await import('@volter/world-runtime'), infrastructureCli: join(dirname(entry), `infra-cli${extname(entry)}`) };
+})();
 async function freePort() {
     return new Promise((done, fail) => {
         const server = createServer();
@@ -26,6 +34,7 @@ let declaredHeld = false;
 export async function startPgliteHost() {
     if (!process.env.VOLTER_WORLD)
         throw new Error('A managed database walk requires its enclosing World');
+    const { runtime: { runWorld, setWorldClock, worldConfigDocument }, infrastructureCli } = await worldRuntime();
     const root = mkdtempSync(join(tmpdir(), 'walk-database-world-'));
     const name = 'pack-walk-postgres';
     const port = declaredPort !== undefined && !declaredHeld ? declaredPort : await freePort();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/twin-standard",
-  "version": "1.0.135",
+  "version": "1.0.136",
   "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.143",
+    "@volter/world-core": "3.0.144",
     "@volter/world-runtime": "*",
     "playwright": "^1.63.0"
   },

package/src/walk/walk-database.ts

@@ -5,11 +5,18 @@ import { createServer } from 'node:net';
 import { tmpdir } from 'node:os';
 import { createRequire } from 'node:module';
 import { dirname, extname, join } from 'node:path';
-import { runWorld, setWorldClock, worldConfigDocument } from '@volter/world-runtime';
 import { worldNow } from '@volter/world-core/runtime';
 
-const runtimeEntry = createRequire(import.meta.url).resolve('@volter/world-runtime');
-const infrastructureCli = join(dirname(runtimeEntry), `infra-cli${extname(runtimeEntry)}`);
+// The runtime is this package's optional peer: only a walk over a managed database needs it, so it is loaded here, on
+// that walk's first database, and every command that starts none runs with the standard alone installed.
+type Runtime = typeof import('@volter/world-runtime');
+let loaded: Promise<{ runtime: Runtime; infrastructureCli: string }> | undefined;
+const worldRuntime = () => loaded ??= (async () => {
+  let entry: string;
+  try { entry = createRequire(import.meta.url).resolve('@volter/world-runtime'); }
+  catch { throw new Error('A managed database walk needs @volter/world-runtime installed beside @volter/twin-standard: npm i @volter/world-runtime'); }
+  return { runtime: await import('@volter/world-runtime'), infrastructureCli: join(dirname(entry), `infra-cli${extname(entry)}`) };
+})();
 
 async function freePort(): Promise<number> {
   return new Promise((done, fail) => {
@@ -31,6 +38,7 @@ let declaredHeld = false;
 
 export async function startPgliteHost(): Promise<PgliteHost> {
   if (!process.env.VOLTER_WORLD) throw new Error('A managed database walk requires its enclosing World');
+  const { runtime: { runWorld, setWorldClock, worldConfigDocument }, infrastructureCli } = await worldRuntime();
   const root = mkdtempSync(join(tmpdir(), 'walk-database-world-'));
   const name = 'pack-walk-postgres';
   const port = declaredPort !== undefined && !declaredHeld ? declaredPort : await freePort();
@@ -67,7 +75,7 @@ export async function startPgliteHost(): Promise<PgliteHost> {
     writeFileSync(ready + '.tmp', JSON.stringify({ url: process.env.DATABASE_URL }));
     renameSync(ready + '.tmp', ready);
     done();`;
-  let finished: { result?: Awaited<ReturnType<typeof runWorld>>; error?: unknown; failed: boolean } | undefined;
+  let finished: { result?: Awaited<ReturnType<Runtime['runWorld']>>; error?: unknown; failed: boolean } | undefined;
   const task = runWorld(config, [process.execPath, '--input-type=module', '-e', hold, readyFile, releaseFile], {
     root, cwd: root, owner: 'pack-walk-managed-database',
   }).then(result => { finished = { result, failed: false }; return result; }, error => {