@volter/twin-standard 1.0.59 → 1.0.61

package/dist/src/clients/run.js

@@ -10,11 +10,22 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
 // vendor, the served port, the host, the issued credentials and the scenario file; each case's failures are printed as
 // one JSON line, `{ id, asks, failures }`.
 import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { extname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { clientContext, worldProxy } from "./harness.js";
 const job = JSON.parse(readFileSync(process.argv[2], 'utf8'));
-const { cases } = (await import(__rewriteRelativeImportExtension(`./${job.vendor}.ts`)));
+const { cases } = (await import(__rewriteRelativeImportExtension(`./${job.vendor}${extname(fileURLToPath(import.meta.url))}`)));
 // every connection a case makes goes through the World's proxy, as an application's does in a World
-const context = clientContext(await worldProxy(job.port), job.host, job.env, job.scenarioPath);
+const proxy = await worldProxy(job.port);
+// Bind only this artifact's declared vendor hosts to the assessed server. The enclosing World's
+// injector stays active, and untwinned destinations keep its refusal policy.
+const require = createRequire(import.meta.url);
+require('@volter/world-core/pack-facts').extendPackFacts([job.packFacts]);
+const facts = JSON.parse(readFileSync(job.packFacts, 'utf8')).packs[job.vendor];
+const keys = [...new Set((facts.hosts ?? []).map((rule) => rule.key ?? job.vendor))];
+require('@volter/world-core/inject').install(Object.fromEntries(keys.map((key) => [key, `http://127.0.0.1:${proxy}`])));
+const context = clientContext(proxy, job.host, job.env, job.scenarioPath);
 for (const c of cases) {
     const failures = await Promise.race([
         c.run(context).catch((e) => [`the case threw: ${e.message}`]),

package/dist/src/conformance.js

@@ -23,8 +23,9 @@ import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSy
 import { createRequire } from 'node:module';
 import { connect } from 'node:net';
 import { tmpdir } from 'node:os';
-import { basename, dirname, join, matchesGlob, relative, resolve } from 'node:path';
+import { basename, dirname, extname, join, matchesGlob, relative, resolve } from 'node:path';
 import { citations, sourceHeld } from "./check-sources.js";
+import { fileURLToPath } from 'node:url';
 const pascal = (s) => s.split(/[^a-zA-Z0-9]+/).filter(Boolean).map((w) => w[0].toUpperCase() + w.slice(1)).join('');
 const readJson = (p) => (existsSync(p) ? JSON.parse(readFileSync(p, 'utf8')) : undefined);
 /** The pack's units: the pack and each lane in it (a directory with its own src/manifest.ts and no package.json). */
@@ -331,7 +332,7 @@ function lineConnection(port) {
     return (sink) => {
         const socket = connect(port, '127.0.0.1');
         let heard = 0;
-        socket.on('data', (bytes) => { heard = Date.now(); sink.write(bytes); });
+        socket.on('data', (bytes) => { heard = performance.now(); sink.write(bytes); });
         socket.on('close', () => sink.end());
         socket.on('error', () => socket.destroy());
         const opened = new Promise((resolveOpen) => { socket.once('connect', () => resolveOpen()); socket.once('error', () => resolveOpen()); });
@@ -339,13 +340,13 @@ function lineConnection(port) {
             data: (chunk) => { void opened.then(() => socket.write(chunk)); },
             settled: async () => {
                 await opened;
-                const start = Date.now();
+                const start = performance.now();
                 const since = heard;
-                while (Date.now() - start < 10_000) {
+                while (performance.now() - start < 10_000) {
                     await new Promise((r) => setTimeout(r, 10));
                     if (socket.destroyed)
                         return;
-                    if (heard > since ? Date.now() - heard >= 50 : Date.now() - start >= 500)
+                    if (heard > since ? performance.now() - heard >= 50 : performance.now() - start >= 500)
                         return;
                 }
             },
@@ -411,7 +412,9 @@ async function lifeServed(pack) {
  *  descriptor's clientCasesNone says why none is owed. */
 async function clientCases(pack, scratch) {
     const vendor = (await manifestOf(pack)).vendor ?? basename(pack);
-    if (!existsSync(join(import.meta.dir, 'clients', `${vendor}.ts`))) {
+    const clients = join(dirname(fileURLToPath(import.meta.url)), 'clients');
+    const extension = extname(fileURLToPath(import.meta.url));
+    if (!existsSync(join(clients, `${vendor}${extension}`))) {
         // a vendor whose descriptor names npm clients (adoption.sdks) is held to them: no case is no proof the SDK works,
         // unless the descriptor says why none is owed (clientCasesNone: no official SDK, or none the demand's applications
         // use); one an application calls with no SDK of the vendor's (a raw HTTP catalog) has no client to drive
@@ -455,16 +458,16 @@ async function clientCases(pack, scratch) {
                     issued[name] = String(answer[field]);
         }
         const job = join(scratch, 'client-job.json');
-        writeFileSync(job, JSON.stringify({ vendor, port: server.port, host, env: issued, scenarioPath }));
+        writeFileSync(job, JSON.stringify({ vendor, port: server.port, host, env: issued, scenarioPath, packFacts: join(pack, 'generated', 'pack-facts.json') }));
         // Node, as an application runs its SDK (asynchronous: this process serves the pack meanwhile)
         const out = await new Promise((resolve) => {
-            const child = spawn('node', ['--experimental-strip-types', '--no-warnings', join(import.meta.dir, 'clients', 'run.ts'), job], { stdio: ['ignore', 'pipe', 'pipe'] });
+            const child = spawn('node', ['--experimental-strip-types', '--no-warnings', join(clients, `run${extension}`), job], { stdio: ['ignore', 'pipe', 'pipe'] });
             let text = '';
             let errors = '';
             child.stdout.on('data', (d) => { text += d; });
             child.stderr.on('data', (d) => { errors += d; });
             const timer = setTimeout(() => child.kill(), 300_000);
-            child.on('close', (code) => { clearTimeout(timer); resolve(code === 0 ? text : `${text}\n${JSON.stringify({ id: 'runner', asks: 'the cases run', failures: [`node exited ${code}: ${errors.trim().split('\n').slice(-2).join(' ')}`] })}`); });
+            child.on('close', (code) => { clearTimeout(timer); resolve(code === 0 ? text : `${text}\n${JSON.stringify({ id: 'runner', asks: 'the cases run', failures: [`node exited ${code}: ${errors.trim().split('\n').slice(0, 12).join(' ')}`] })}`); });
         });
         const results = out.split('\n').filter((l) => l.startsWith('{')).map((l) => JSON.parse(l));
         return { failures: results.flatMap((r) => r.failures.map((f) => `${r.id} (${r.asks}): ${f}`)), note: `${results.length} case(s) through the vendor's client` };

package/dist/src/walk/behavior-journey.js

@@ -645,9 +645,9 @@ export async function walk(journey, root, collect, opts) {
     // they arrive (the steps' settle waits until none has come for a moment)
     const wire = new Map();
     const settleWire = async (c, step) => {
-        const deadline = Date.now() + 10_000;
+        const deadline = performance.now() + 10_000;
         let seen = -1;
-        while (Date.now() < deadline) {
+        while (performance.now() < deadline) {
             const body = { frames: c.frames, last: c.frames.at(-1) ?? null, closed: c.closed };
             let expected = true;
             try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/twin-standard",
-  "version": "1.0.59",
+  "version": "1.0.61",
   "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.67",
+    "@volter/world-core": "3.0.69",
     "@volter/world-runtime": "*",
     "playwright": "^1.63.0"
   },

package/src/clients/run.ts

@@ -2,12 +2,23 @@
 // vendor, the served port, the host, the issued credentials and the scenario file; each case's failures are printed as
 // one JSON line, `{ id, asks, failures }`.
 import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { extname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { clientContext, worldProxy, type ClientCase } from './harness.ts';
 
-const job = JSON.parse(readFileSync(process.argv[2]!, 'utf8')) as { vendor: string; port: number; host: string; env: Record<string, string>; scenarioPath: string };
-const { cases } = (await import(`./${job.vendor}.ts`)) as { cases: ClientCase[] };
+const job = JSON.parse(readFileSync(process.argv[2]!, 'utf8')) as { vendor: string; port: number; host: string; env: Record<string, string>; scenarioPath: string; packFacts: string };
+const { cases } = (await import(`./${job.vendor}${extname(fileURLToPath(import.meta.url))}`)) as { cases: ClientCase[] };
 // every connection a case makes goes through the World's proxy, as an application's does in a World
-const context = clientContext(await worldProxy(job.port), job.host, job.env, job.scenarioPath);
+const proxy = await worldProxy(job.port);
+// Bind only this artifact's declared vendor hosts to the assessed server. The enclosing World's
+// injector stays active, and untwinned destinations keep its refusal policy.
+const require = createRequire(import.meta.url);
+require('@volter/world-core/pack-facts').extendPackFacts([job.packFacts]);
+const facts = JSON.parse(readFileSync(job.packFacts, 'utf8')).packs[job.vendor];
+const keys: string[] = [...new Set<string>((facts.hosts ?? []).map((rule: { key?: string }) => rule.key ?? job.vendor))];
+require('@volter/world-core/inject').install(Object.fromEntries(keys.map((key) => [key, `http://127.0.0.1:${proxy}`])));
+const context = clientContext(proxy, job.host, job.env, job.scenarioPath);
 for (const c of cases) {
   const failures = await Promise.race([
     c.run(context).catch((e: Error) => [`the case threw: ${e.message}`]),

package/src/conformance.ts

@@ -15,9 +15,10 @@ import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSy
 import { createRequire } from 'node:module';
 import { connect } from 'node:net';
 import { tmpdir } from 'node:os';
-import { basename, dirname, join, matchesGlob, relative, resolve } from 'node:path';
+import { basename, dirname, extname, join, matchesGlob, relative, resolve } from 'node:path';
 import type { TwinStream } from '@volter/world-core';
 import { citations, sourceHeld, type SourceRecord } from './check-sources.ts';
+import { fileURLToPath } from 'node:url';
 
 export type ConformanceResult = { id: string; asks: string; failures: string[]; note?: string };
 
@@ -297,7 +298,7 @@ function lineConnection(port: number): TwinStream {
   return (sink) => {
     const socket = connect(port, '127.0.0.1');
     let heard = 0;
-    socket.on('data', (bytes: Uint8Array) => { heard = Date.now(); sink.write(bytes); });
+    socket.on('data', (bytes: Uint8Array) => { heard = performance.now(); sink.write(bytes); });
     socket.on('close', () => sink.end());
     socket.on('error', () => socket.destroy());
     const opened = new Promise<void>((resolveOpen) => { socket.once('connect', () => resolveOpen()); socket.once('error', () => resolveOpen()); });
@@ -305,11 +306,11 @@ function lineConnection(port: number): TwinStream {
       data: (chunk) => { void opened.then(() => socket.write(chunk)); },
       settled: async () => {
         await opened;
-        const start = Date.now(); const since = heard;
-        while (Date.now() - start < 10_000) {
+        const start = performance.now(); const since = heard;
+        while (performance.now() - start < 10_000) {
           await new Promise((r) => setTimeout(r, 10));
           if (socket.destroyed) return;
-          if (heard > since ? Date.now() - heard >= 50 : Date.now() - start >= 500) return;
+          if (heard > since ? performance.now() - heard >= 50 : performance.now() - start >= 500) return;
         }
       },
       close: () => socket.destroy(),
@@ -364,7 +365,9 @@ async function lifeServed(pack: string): Promise<string[]> {
  *  descriptor's clientCasesNone says why none is owed. */
 async function clientCases(pack: string, scratch: string): Promise<{ failures: string[]; note?: string }> {
   const vendor = (await manifestOf(pack)).vendor ?? basename(pack);
-  if (!existsSync(join(import.meta.dir, 'clients', `${vendor}.ts`))) {
+  const clients = join(dirname(fileURLToPath(import.meta.url)), 'clients');
+  const extension = extname(fileURLToPath(import.meta.url));
+  if (!existsSync(join(clients, `${vendor}${extension}`))) {
     // a vendor whose descriptor names npm clients (adoption.sdks) is held to them: no case is no proof the SDK works,
     // unless the descriptor says why none is owed (clientCasesNone: no official SDK, or none the demand's applications
     // use); one an application calls with no SDK of the vendor's (a raw HTTP catalog) has no client to drive
@@ -396,16 +399,16 @@ async function clientCases(pack: string, scratch: string): Promise<{ failures: s
       for (const [name, field] of Object.entries(door.fill)) if (answer[field] !== undefined) issued[name] = String(answer[field]);
     }
     const job = join(scratch, 'client-job.json');
-    writeFileSync(job, JSON.stringify({ vendor, port: server.port, host, env: issued, scenarioPath }));
+    writeFileSync(job, JSON.stringify({ vendor, port: server.port, host, env: issued, scenarioPath, packFacts: join(pack, 'generated', 'pack-facts.json') }));
     // Node, as an application runs its SDK (asynchronous: this process serves the pack meanwhile)
     const out = await new Promise<string>((resolve) => {
-      const child = spawn('node', ['--experimental-strip-types', '--no-warnings', join(import.meta.dir, 'clients', 'run.ts'), job], { stdio: ['ignore', 'pipe', 'pipe'] });
+      const child = spawn('node', ['--experimental-strip-types', '--no-warnings', join(clients, `run${extension}`), job], { stdio: ['ignore', 'pipe', 'pipe'] });
       let text = '';
       let errors = '';
       child.stdout.on('data', (d: Buffer) => { text += d; });
       child.stderr.on('data', (d: Buffer) => { errors += d; });
       const timer = setTimeout(() => child.kill(), 300_000);
-      child.on('close', (code) => { clearTimeout(timer); resolve(code === 0 ? text : `${text}\n${JSON.stringify({ id: 'runner', asks: 'the cases run', failures: [`node exited ${code}: ${errors.trim().split('\n').slice(-2).join(' ')}`] })}`); });
+      child.on('close', (code) => { clearTimeout(timer); resolve(code === 0 ? text : `${text}\n${JSON.stringify({ id: 'runner', asks: 'the cases run', failures: [`node exited ${code}: ${errors.trim().split('\n').slice(0, 12).join(' ')}`] })}`); });
     });
     const results = out.split('\n').filter((l) => l.startsWith('{')).map((l) => JSON.parse(l) as { id: string; asks: string; failures: string[] });
     return { failures: results.flatMap((r) => r.failures.map((f) => `${r.id} (${r.asks}): ${f}`)), note: `${results.length} case(s) through the vendor's client` };

package/src/walk/behavior-journey.ts

@@ -483,9 +483,9 @@ export async function walk(journey: Journey, root: string, collect: Failure[], o
   // they arrive (the steps' settle waits until none has come for a moment)
   const wire = new Map<string, WebSocket>();
   const settleWire = async (c: Socket, step?: SocketStep): Promise<void> => {
-    const deadline = Date.now() + 10_000;
+    const deadline = performance.now() + 10_000;
     let seen = -1;
-    while (Date.now() < deadline) {
+    while (performance.now() < deadline) {
       const body = { frames: c.frames, last: c.frames.at(-1) ?? null, closed: c.closed };
       let expected = true;
       try {