@volter/twin-standard 1.0.143 → 1.0.145

package/dist/src/conformance.js

@@ -23,7 +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, extname, join, matchesGlob, relative, resolve } from 'node:path';
+import { basename, dirname, extname, join, matchesGlob, relative, resolve, sep } from 'node:path';
+// A path relative to another with '/' between its parts on every platform (Windows' relative() joins with '\').
+const rel = (from, to) => relative(from, to).split(sep).join('/');
 import { citations, sourceHeld } from "./check-sources.js";
 import { fileURLToPath } from 'node:url';
 import { servedHttpFetch } from "./clients/harness.js";
@@ -34,7 +36,7 @@ const readJson = (p) => (existsSync(p) ? JSON.parse(readFileSync(p, 'utf8')) : u
 function unitsIn(pack) {
     return [pack, ...readdirSync(pack).sort().map((n) => join(pack, n)).filter((d) => !existsSync(join(d, 'package.json')) && existsSync(join(d, 'src', 'manifest.ts')))];
 }
-const nameOf = (pack, unit) => relative(resolve(pack, '..'), unit);
+const nameOf = (pack, unit) => rel(resolve(pack, '..'), unit);
 /** The files conformance reads from a unit: its manifest, its spec's record, its vendor's life and its decision table
  *  (a lane's journeys are its own `journeys/` or else its vendor's). A release publishes each (published()), and a
  *  pack's standing counts it in the form only when every unit holds them (twin-world's scripts/pack-standing.ts, by
@@ -192,7 +194,7 @@ function published(pack) {
     }
     const out = [];
     for (const unit of unitsIn(pack)) {
-        const at = relative(pack, unit);
+        const at = rel(pack, unit);
         const of = (p) => (at ? `${at}/${p}` : p);
         for (const need of UNIT_FILES) {
             if (existsSync(join(unit, need)) && !files.has(of(need)))

package/dist/src/create-pack.d.ts

@@ -28,7 +28,10 @@ export declare function packIndexFile(dir: string, vendor: string): string;
  *  itself: "Other wires"), or, for a unit whose spec is a proto, the gRPC seam over the schema derive-pack generated
  *  (src/generated/proto.gen.json, imported by its literal path). `--init` writes the plain one, `--index` the gRPC one once
  *  the unit's proto is derived. */
-export declare function serverFile(vendor: string, grpc: boolean, wire?: boolean): string;
+export declare function serverFile(vendor: string, grpc: boolean, wire?: boolean, live?: boolean): string;
+/** A pack's `src/cli.ts` (a fixed file): its bin, serving the twin with the options a World hands it; a unit that takes
+ *  broadcasts over RTMP (`live`) takes its ingest's side port too (`--ingest-port`, the manifest's sidePorts). */
+export declare function cliFile(vendor: string, live?: boolean): string;
 /** A pack's tsconfig.json, a fixed file: what the grade's typecheck (soundness) compiles, the pack and its lanes. */
 export declare const TSCONFIG: string;
 export declare function initFiles(vendor: string): Record<string, string>;

package/dist/src/create-pack.js

@@ -42,7 +42,7 @@ import { coreFor } from '@volter/world-core';
 import { decisionTableProblems } from "./conformance.js";
 import { handlerName } from "./protocol-3.js";
 import { hasOwnSurface } from "./lanes.js";
-const FIXED = new Set(['answer-views.ts', 'states.ts', 'index.ts', 'shared.ts', 'doors.ts', 'seed.ts', 'around.ts', 'events.ts', 'clock.ts', 'tenant.ts', 'scenario.ts', 'gap.ts', 'graphql.ts', 'sockets.ts', 'board.ts']);
+const FIXED = new Set(['answer-views.ts', 'states.ts', 'index.ts', 'shared.ts', 'doors.ts', 'seed.ts', 'around.ts', 'events.ts', 'clock.ts', 'tenant.ts', 'scenario.ts', 'gap.ts', 'graphql.ts', 'sockets.ts', 'live.ts', 'board.ts']);
 /** A family file's name as a JavaScript identifier (`well-known` is `well_known`). */
 /** A family's name in code: as a handler's (a name JavaScript reserves, the family `default`, takes a trailing `_`). */
 const identifier = (family) => handlerName(family);
@@ -156,6 +156,8 @@ export function packFetchFile(dir, name) {
     const hasScenario = existsSync(join(semantics, 'scenario.ts'));
     const hasGap = existsSync(join(semantics, 'gap.ts'));
     const hasSockets = existsSync(join(dir, 'src', 'semantics', 'sockets.ts'));
+    // the broadcasts the vendor takes over RTMP: each ingest's dialect (world-core live)
+    const hasLive = existsSync(join(semantics, 'live.ts'));
     // a GraphQL API beside the REST one: its resolvers and the vendor's schema (graphql-wire.ts)
     const hasGraphql = existsSync(join(semantics, 'graphql.ts')) && existsSync(join(dir, 'src', 'generated', 'graphql-sdl.gen.json'));
     const screensDir = join(dir, 'src', 'screens');
@@ -196,6 +198,7 @@ export function packFetchFile(dir, name) {
         ...(hasScenario ? ["import { scenario } from './semantics/scenario.ts';"] : []),
         ...(hasGap ? ["import { gap } from './semantics/gap.ts';"] : []),
         ...(hasSockets ? ["import * as sockets from './semantics/sockets.ts';"] : []),
+        ...(hasLive ? ["import * as live from './semantics/live.ts';"] : []),
         ...(hasGraphql ? ["import { graphql } from './semantics/graphql.ts';", "import schema from './generated/graphql-sdl.gen.json' with { type: 'json' };", "import graphqlSurface from './generated/graphql.gen.json' with { type: 'json' };"] : []),
         ...(hasDoors ? ["import * as doors from './semantics/doors.ts';"] : []),
         ...(map ? [`import { ${map} } from './semantics/index.ts';`] : []),
@@ -215,6 +218,7 @@ export function packFetchFile(dir, name) {
         ...(hasScenario ? ['    scenario,'] : []),
         ...(hasGap ? ['    gap,'] : []),
         ...(hasSockets ? ['    sockets,'] : []),
+        ...(hasLive ? ['    live,'] : []),
         ...(hasGraphql ? ['    graphql: { ...graphql, operations: graphqlSurface.operations as NonNullable<typeof graphql.operations>, sdl: schema.sdl },'] : []),
         ...(screens.length ? [`    screens: { ${screens.map((f) => `${JSON.stringify(id(f))}: ${identifier(`screen_${id(f)}`)}`).join(', ')} },`] : []),
         ...(lanes.length ? [`    lanes: ${laneParts},`] : []),
@@ -338,9 +342,14 @@ export function packIndexFile(dir, vendor) {
  *  itself: "Other wires"), or, for a unit whose spec is a proto, the gRPC seam over the schema derive-pack generated
  *  (src/generated/proto.gen.json, imported by its literal path). `--init` writes the plain one, `--index` the gRPC one once
  *  the unit's proto is derived. */
-export function serverFile(vendor, grpc, wire = false) {
+export function serverFile(vendor, grpc, wire = false, live = false) {
     const Name = pascal(vendor);
     const head = `// FETCH-FIRST (runtime contract R12b): a fixed file, the kernel's serve seam around the pack's fetch (./fetch.ts).\n`;
+    if (live && !grpc) {
+        // a unit that takes broadcasts over RTMP (its manifest's `live`) serves its fetch's ingest on a side port, `ingestPort`,
+        // which the manifest's sidePorts declares (architecture, "Other wires": live media)
+        return `${head}import { serveHttp, serveStream, StreamListenerUnavailable, type PackFetchOptions } from '@volter/world-core';\nimport { create${Name}Fetch } from './fetch.ts';\n\nexport async function create${Name}TwinServer(options: PackFetchOptions & { port?: number; ingestPort?: number } = {}): Promise<{ port: number; ingestPort: number; stop: () => void }> {\n  const fetch = create${Name}Fetch(options);\n  const server = await serveHttp({ port: options.port ?? 0, idleTimeout: 60, fetch });\n  // the vendor's RTMP ingest beside its HTTP host, on its side port (the manifest's live and sidePorts: \`ingestPort\`).\n  // A runtime with no TCP listener at all serves the twin without one (ingestPort 0); a listen that fails (the port\n  // taken) fails the twin's start, as its HTTP listener's would, so the World never records an ingest nothing serves\n  let ingest: { port: number; stop: () => void } | undefined;\n  try { ingest = await serveStream({ port: options.ingestPort ?? 0, stream: fetch.ingest! }); }\n  catch (error) {\n    if (!(error instanceof StreamListenerUnavailable)) { await server.stop(true); throw error; }\n    console.error(\`${vendor} twin: no RTMP ingest here (\${error.message}); serving without one\`);\n  }\n  return { port: server.port ?? options.port ?? 0, ingestPort: ingest?.port ?? 0, stop: () => { ingest?.stop(); void server.stop(true); } };\n}\n`;
+    }
     const signature = `export async function create${Name}TwinServer(options: PackFetchOptions & { port?: number } = {}): Promise<{ port: number; stop: () => void }> {\n`;
     if (grpc && wire) {
         // a unit with a wire of its own beside its API (./stream.ts: the PlanetScale twin's MySQL protocol) serves it on a side
@@ -352,6 +361,14 @@ export function serverFile(vendor, grpc, wire = false) {
     }
     return `${head}import { serveHttp, type PackFetchOptions } from '@volter/world-core';\nimport { create${Name}Fetch } from './fetch.ts';\n\n${signature}  const server = await serveHttp({ port: options.port ?? 0, idleTimeout: 60, fetch: create${Name}Fetch(options) });\n  return { port: server.port ?? options.port ?? 0, stop: () => server.stop(true) };\n}\n`;
 }
+/** A pack's `src/cli.ts` (a fixed file): its bin, serving the twin with the options a World hands it; a unit that takes
+ *  broadcasts over RTMP (`live`) takes its ingest's side port too (`--ingest-port`, the manifest's sidePorts). */
+export function cliFile(vendor, live = false) {
+    const Name = pascal(vendor);
+    const ingest = live ? `// the RTMP ingest's side port, which the World allocates (the manifest's sidePorts)\nconst ingestPort = Number(optionValue(rest, '--ingest-port', '0')) || undefined;\n` : '';
+    const served = live ? `  process.stdout.write(s.ingestPort ? \`${vendor} twin ingest at rtmp://127.0.0.1:\${s.ingestPort}\\n\` : '${vendor} twin: no RTMP ingest\\n');\n` : '';
+    return `#!/usr/bin/env node\n// world-${vendor}: serve the ${vendor} twin.\nimport { hasFlag, optionValue } from '@volter/world-core/args';\nimport { keepProcessAlive } from '@volter/world-core/lifecycle';\nimport { create${Name}TwinServer } from './server.ts';\n\nconst [cmd, ...rest] = process.argv.slice(2);\nconst port = Number(optionValue(rest, '--port', '0')) || undefined;\nconst root = optionValue(rest, '--root') || undefined;\nconst readOnly = hasFlag(rest, '--read-only');\n// the World's managed Postgres, which the runtime binds a pack declaring managedDatabase to\nconst database = optionValue(rest, '--database') || undefined;\n// the World's scenario file, for a model vendor's turns\nconst scenarioPath = optionValue(rest, '--scenario') || undefined;\n${ingest}\nif (cmd === 'serve' || cmd === undefined) {\n  const s = await create${Name}TwinServer({ readOnly, ...(root ? { root } : {}), ...(port ? { port } : {}), ...(database ? { database } : {}), ...(scenarioPath ? { scenarioPath } : {})${live ? ', ...(ingestPort ? { ingestPort } : {})' : ''} });\n  process.stdout.write(\`${vendor} twin\${readOnly ? ' [read-only]' : ''} at http://127.0.0.1:\${s.port}\\n\`);\n${served}  await keepProcessAlive();\n} else {\n  process.stdout.write('Usage: world-${vendor} serve [--port N] [--root DIR] [--read-only] [--database URL] [--scenario FILE]${live ? ' [--ingest-port N]' : ''}\\n');\n}\n`;
+}
 /** A vendor id as a name in code: `npm-registry` is `NpmRegistry`. */
 const pascal = (vendor) => vendor.split(/[^A-Za-z0-9]+/).filter(Boolean).map((w) => w[0].toUpperCase() + w.slice(1)).join('');
 /** A pack's tsconfig.json, a fixed file: what the grade's typecheck (soundness) compiles, the pack and its lanes. */
@@ -425,7 +442,7 @@ export function initFiles(vendor) {
         'src/semantics/doors.ts': `// The World's doors (architecture, "Doors, screens and the gap"): what the vendor's own pages do that its API does\n// not, each declared in the manifest's \`doors\` (its id, method and path under \`/_twin/\`) and answered here by the\n// export its id names, over the contract's context.\nimport type { HandlerContext } from '@volter/world-core';\n\nexport type { HandlerContext };\n`,
         'src/manifest.ts': `// ${vendor}'s manifest: the vendor facts its spec does not carry (architecture, "Protocol 3"). The surface is generated\n// (./generated/surface.gen.json, from ../spec by derive-pack). Every line marked FILL is a vendor fact to state from\n// the vendor's pages, cited.\nimport type { DerivedManifest } from '@volter/world-core';\n\nexport const manifest: DerivedManifest = {\n  vendor: '${vendor}',\n  service: '${vendor}',\n  body: { json: 'always' },\n  ids: { template: '{uuid}' }, // FILL: the vendor's id form\n  time: 'iso', // FILL: iso, unix or unix-ms\n  error: { error: { message: '{message}', code: '{code}' } }, // FILL: the vendor's error body\n  readOnly: { status: 403, message: 'This twin was started read-only; writes are refused.' }, // FILL: the vendor's refusal\n  notFound: { status: 404, message: 'Not found' }, // FILL: the vendor's not-found\n  list: { style: 'envelope', envelope: { data: '{data}' }, limit: { param: 'limit', default: 20, max: 100 } }, // FILL: its paging\n  deleted: {},\n  resources: {}, // FILL: the resources the core serves (plain create, read, update, delete, list)\n  discovery: { twinOf: 'FILL: what the twin is of', stores: 'FILL: what it keeps' },\n  // the descriptor, as data (twin-world's architecture, "The descriptor"): the pack registers packOf(manifest)\n  descriptor: {\n    protocol: '3',\n    transport: 'rest',\n    archetype: 'crud',\n    bin: 'world-${vendor}',\n    resources: [], // FILL: the stored types\n    specSource: 'FILL: the vendored spec (spec/SOURCE.md)',\n    description: 'FILL: one line',\n    adoption: { sdks: [], envStems: [] }, // FILL: its npm clients, and each credential variable's stem (TRIPO for TRIPO_API_KEY: the suffix removed)\n    hosts: [], // FILL: the vendor's hosts\n    endpointEnvNone: 'FILL: the SDK\\'s base-URL variable (endpointEnv) or why none',\n  },\n};\n`,
         'src/server.ts': serverFile(vendor, false),
-        'src/cli.ts': `#!/usr/bin/env node\n// world-${vendor}: serve the ${vendor} twin.\nimport { hasFlag, optionValue } from '@volter/world-core/args';\nimport { keepProcessAlive } from '@volter/world-core/lifecycle';\nimport { create${Name}TwinServer } from './server.ts';\n\nconst [cmd, ...rest] = process.argv.slice(2);\nconst port = Number(optionValue(rest, '--port', '0')) || undefined;\nconst root = optionValue(rest, '--root') || undefined;\nconst readOnly = hasFlag(rest, '--read-only');\n// the World's managed Postgres, which the runtime binds a pack declaring managedDatabase to\nconst database = optionValue(rest, '--database') || undefined;\n// the World's scenario file, for a model vendor's turns\nconst scenarioPath = optionValue(rest, '--scenario') || undefined;\n\nif (cmd === 'serve' || cmd === undefined) {\n  const s = await create${Name}TwinServer({ readOnly, ...(root ? { root } : {}), ...(port ? { port } : {}), ...(database ? { database } : {}), ...(scenarioPath ? { scenarioPath } : {}) });\n  process.stdout.write(\`${vendor} twin\${readOnly ? ' [read-only]' : ''} at http://127.0.0.1:\${s.port}\\n\`);\n  await keepProcessAlive();\n} else {\n  process.stdout.write('Usage: world-${vendor} serve [--port N] [--root DIR] [--read-only] [--database URL] [--scenario FILE]\\n');\n}\n`,
+        'src/cli.ts': cliFile(vendor),
         'src/index.ts': `// @volter/twin-${vendor} — the ${vendor} twin (Protocol 3). A fixed file: the descriptor is the manifest's.\nimport { packOf, registerPack } from '@volter/world-core';\nimport { manifest } from './manifest.ts';\n\nexport { create${Name}Fetch } from './fetch.ts';\nexport { create${Name}TwinServer } from './server.ts';\nexport { manifest };\n\n// The descriptor: twin-world's architecture, "The descriptor"; declared in manifest.ts.\nexport const pack = registerPack(packOf(manifest));\n`,
     };
 }
@@ -603,6 +620,22 @@ export async function createPack(args) {
                 writeFileSync(join(dir, 'src', 'server.ts'), serverFile(vendor, true, existsSync(join(dir, 'src', 'stream.ts'))));
                 console.log(`create-pack: wrote ${join(dir, 'src', 'server.ts')}`);
             }
+            else if (manifest?.live?.length) {
+                // a unit that takes broadcasts over RTMP serves its ingest beside its HTTP host, and its bin takes the ingest's
+                // side port: each written over its plain --init form only (never over a server of a wire of the pack's own)
+                const fixed = (file, forms, next) => {
+                    const at = join(dir, 'src', file);
+                    const now = existsSync(at) ? readFileSync(at, 'utf8').replace(/\r\n/g, '\n') : undefined;
+                    if (now !== undefined && !forms.includes(now)) {
+                        console.error(`create-pack: ${at} is not the generated form; serve the ingest there as architecture, "Other wires": live media, says`);
+                        return;
+                    }
+                    writeFileSync(at, next);
+                    console.log(`create-pack: wrote ${at}`);
+                };
+                fixed('server.ts', [serverFile(vendor, false), serverFile(vendor, false, false, true)], serverFile(vendor, false, false, true));
+                fixed('cli.ts', [cliFile(vendor), cliFile(vendor, true)], cliFile(vendor, true));
+            }
         }
         // a handler is an exported async function, one per operation (the handler contract); anything else a family file
         // exports is not in the map, said at once rather than found by the grade

package/dist/src/derive.js

@@ -16,7 +16,7 @@ import { parseExactJson, exactInteger } from '@volter/world-core/exact-json';
 // Usage: twin-standard derive <pack dir> [--out <dir>]   (twin-world: bun scripts/derive-pack.ts <vendor>)
 import { parse as parseYaml } from 'yaml';
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { basename, join } from 'node:path';
 import { gunzipSync } from 'node:zlib';
 import { CRUD_CLASSES, fromOpenAPI, fromSmithy, fromSwagger2, slug } from "./spec-ir.js";
 import { fromCommandReplies } from "./spec-ir-lines.js";
@@ -46,10 +46,10 @@ if (!specPath) {
     console.error(`derive-pack: no spec at ${join(PKG, 'spec')}/openapi.{json,yaml}[.gz], smithy.json[.gz], rfcNNNN.txt, proto/, commands/ or client-ops.json`);
     process.exit(1);
 }
-const rpcService = specPath.endsWith('/proto');
-const severalDocuments = specPath.endsWith('/openapi');
+const rpcService = basename(specPath) === 'proto';
+const severalDocuments = basename(specPath) === 'openapi';
 // a command language's table, one vendored file per command (Redis's src/commands/*.json), with its version in SOURCE.md
-const commandTable = specPath.endsWith('/commands');
+const commandTable = basename(specPath) === 'commands';
 const protoTree = (dir, at = '') => Object.fromEntries(readdirSync(join(dir, at), { withFileTypes: true }).flatMap((e) => (e.isDirectory() ? Object.entries(protoTree(dir, join(at, e.name))) : e.name.endsWith('.proto') ? [[join(at, e.name), readFileSync(join(dir, at, e.name), 'utf8')]] : [])));
 const bytes = rpcService || commandTable || severalDocuments ? Buffer.from('') : readFileSync(specPath);
 const text = (specPath.endsWith('.gz') ? gunzipSync(bytes) : bytes).toString('utf8');
@@ -195,7 +195,7 @@ mkdirSync(out, { recursive: true });
 // name commands and cite the RFC.
 if (lineProtocol || commandTable) {
     const spec = doc;
-    writeFileSync(join(out, 'surface.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: specPath.split('/').pop(), ...spec })}\n`);
+    writeFileSync(join(out, 'surface.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: basename(specPath), ...spec })}\n`);
     const manifestPath = join(PKG, 'src', 'manifest.ts');
     if (existsSync(manifestPath)) {
         const { manifest } = (await import(__rewriteRelativeImportExtension(manifestPath)));
@@ -254,7 +254,7 @@ if (sdlPath) {
     for (const o of gql.operations)
         graphqlOperations.add(o.id);
     mkdirSync(out, { recursive: true });
-    writeFileSync(join(out, 'graphql.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: sdlPath.split('/').pop(), ...gql })}\n`);
+    writeFileSync(join(out, 'graphql.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: basename(sdlPath), ...gql })}\n`);
     // the schema itself, for the pack's GraphQL wire to validate and execute against (imported lazily)
     writeFileSync(join(out, 'graphql-sdl.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', sdl })}\n`);
     const g = new Map();
@@ -266,7 +266,7 @@ if (sdlPath) {
 if (rpcService)
     writeFileSync(join(out, 'proto.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', ...protoSchema(doc) })}\n`);
 // Data, not code: the surface is JSON so it adds nothing to a typecheck and ships as an asset.
-writeFileSync(join(out, 'surface.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: specPath.split('/').pop(), ...ir })}\n`);
+writeFileSync(join(out, 'surface.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: basename(specPath), ...ir })}\n`);
 // The event types a vendor delivers, when its spec enumerates them where a webhook subscription names the events it
 // wants (a request body's `enabled_events`): the pack records an event only under a type the vendor sends.
 const eventTypes = new Set();
@@ -280,7 +280,7 @@ for (const item of Object.values((doc?.paths ?? {}))) {
     }
 }
 if (eventTypes.size)
-    writeFileSync(join(out, 'events.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: specPath.split('/').pop(), types: [...eventTypes].sort() })}\n`);
+    writeFileSync(join(out, 'events.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: basename(specPath), types: [...eventTypes].sort() })}\n`);
 // What the pack's UI needs to know about each resource its manifest declares: where it is listed,
 // read, created and moved, which values its state fields take and which moves are legal from which,
 // and which fields name another resource. Data the browser bundle reads; it never imports the manifest.

package/dist/src/pack-facts.d.ts

@@ -92,6 +92,7 @@ export type PackFacts = {
         option: string;
         flag: string;
         path?: string;
+        scheme?: string;
         note: string;
     }>;
     /** DERIVED, never declared: the pack's `create<Name>TwinServer` factory export — the

package/dist/src/pack-facts.js

@@ -207,6 +207,8 @@ export async function compilePackFacts(dirs) {
                     throw new Error(`pack-facts: ${vendor} side port ${side.name}: flag "${String(side.flag)}" is the serve flag (--name)`);
                 if (side.path !== undefined && (typeof side.path !== 'string' || !side.path.startsWith('/')))
                     throw new Error(`pack-facts: ${vendor} side port ${side.name}: path "${String(side.path)}" starts with /`);
+                if (side.scheme !== undefined && (typeof side.scheme !== 'string' || !/^[a-z][a-z0-9+.-]*$/.test(side.scheme)))
+                    throw new Error(`pack-facts: ${vendor} side port ${side.name}: scheme "${String(side.scheme)}" is the URL's scheme (rtmp)`);
                 if (typeof side.note !== 'string' || side.note.trim() === '')
                     throw new Error(`pack-facts: ${vendor} side port ${side.name} has no note`);
             }

package/dist/src/protocol-3.js

@@ -19,12 +19,15 @@ import { AsyncLocalStorage } from 'node:async_hooks';
 import { createHash } from 'node:crypto';
 import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync } from 'node:fs';
 import { tmpdir } from 'node:os';
-import { basename, dirname, join, relative } from 'node:path';
+import { basename, dirname, join, relative, sep } from 'node:path';
 import { gunzipSync } from 'node:zlib';
 import ts from 'typescript';
 import { fileURLToPath } from 'node:url';
 import { sharingLanesIn } from "./lanes.js";
 import { isPackArtifact } from "./pack-files.js";
+// A path relative to another with '/' between its parts on every platform: git lists files that way, and every rule
+// here compares and splits on '/'; Windows' relative() joins with '\', which hid every lane's files and spec.
+const rel = (from, to) => relative(from, to).split(sep).join('/');
 /** The lanes over the unit's vendor's state, when the unit is one of them ("Pack layout"), else none: a lane over its
  *  vendor's state takes the vendor's states, shared helpers, manifest and engine from the vendor's src/, and nothing of
  *  another lane. */
@@ -101,9 +104,9 @@ function filesUnder(dir, base = dir) {
         files = [...new Set(String(run.stdout).split('\0').filter(Boolean))];
         listing?.set(top, files);
     }
-    const under = relative(top, dir);
+    const under = rel(top, dir);
     const mine = under === '' ? files : files.filter((f) => f.startsWith(`${under}/`)).map((f) => f.slice(under.length + 1));
-    return mine.map((f) => relative(base, join(dir, f))).filter((f) => existsSync(join(base, f)));
+    return mine.map((f) => rel(base, join(dir, f))).filter((f) => existsSync(join(base, f)));
 }
 /** Disk files outside a checkout, or the complete output of the grader's own derivation. */
 function allFilesUnder(dir, base = dir, excludeArtifacts = false) {
@@ -112,12 +115,12 @@ function allFilesUnder(dir, base = dir, excludeArtifacts = false) {
     const out = [];
     for (const name of readdirSync(dir)) {
         const path = join(dir, name);
-        if (excludeArtifacts && isPackArtifact(relative(base, path)))
+        if (excludeArtifacts && isPackArtifact(rel(base, path)))
             continue;
         if (statSync(path).isDirectory())
             out.push(...allFilesUnder(path, base, excludeArtifacts));
         else
-            out.push(relative(base, path));
+            out.push(rel(base, path));
     }
     return out;
 }
@@ -142,7 +145,7 @@ function srcFileInForm(unit, name) {
     return (isLane(unit) ? ['manifest.ts', 'index.ts', 'fetch.ts', 'budget.ts'] : ['manifest.ts', 'index.ts', 'cli.ts', 'fetch.ts', 'server.ts', 'stream.ts', 'budget.ts']).includes(name);
 }
 /** The fixed files of semantics/ besides the families' handler files and their tests. */
-const SEMANTICS_FIXED = new Set(['answer-views.ts', 'states.ts', 'index.ts', 'shared.ts', 'doors.ts', 'seed.ts', 'around.ts', 'events.ts', 'clock.ts', 'tenant.ts', 'scenario.ts', 'gap.ts', 'graphql.ts', 'sockets.ts', 'board.ts']);
+const SEMANTICS_FIXED = new Set(['answer-views.ts', 'states.ts', 'index.ts', 'shared.ts', 'doors.ts', 'seed.ts', 'around.ts', 'events.ts', 'clock.ts', 'tenant.ts', 'scenario.ts', 'gap.ts', 'graphql.ts', 'sockets.ts', 'live.ts', 'board.ts']);
 /** journeys/'s closed set. */
 const JOURNEY_FILES = new Set(['customer-life.outline.md', 'customer-life.outline.verdict.json', 'customer-life.json', 'customer-life.verdict.json', 'decisions.json',
     'vendor-examples.json', 'vendor-examples.verdict.json', 'demand.json', 'unreachable.json', 'score.json', 'coverage.json', 'first-use.json',
@@ -229,7 +232,7 @@ const criteria = [
                 return fail('no vendored spec under spec/ (openapi, smithy, discovery, asyncapi or an RFC)');
             if (!existsSync(join(unit.dir, 'spec', 'SOURCE.md')))
                 return fail('spec/SOURCE.md is missing');
-            return pass(files.length > 4 ? `${files.length} documents` : files.map((f) => relative(join(unit.dir, 'spec'), f)).join(', '));
+            return pass(files.length > 4 ? `${files.length} documents` : files.map((f) => rel(join(unit.dir, 'spec'), f)).join(', '));
         },
     },
     {
@@ -452,6 +455,12 @@ const criteria = [
                         found.push('sockets.ts exports otherwise than one const engine per socket');
                     continue;
                 }
+                if (f === 'live.ts') {
+                    // the manifest's live (world-core live): one exported engine per ingest id, and nothing else
+                    if (/^export\s+(?:async\s+)?function\s|^export\s+(let|var|class)\s|^export\s*\{/m.test(text))
+                        found.push('live.ts exports otherwise than one const engine per ingest');
+                    continue;
+                }
                 if (f === 'gap.ts') {
                     const names = [...text.matchAll(/^export\s+(?:async\s+)?function\s+([A-Za-z0-9_$]+)/gm)].map((m) => m[1]);
                     if (names.join() !== 'gap' || /^export\s+(const|let|var|class)\s|^export\s*\{/m.test(text))
@@ -764,7 +773,7 @@ const criteria = [
         asks: "the pack's own tests pass",
         check(unit) {
             const pkg = packageOf(unit);
-            const scope = `./${relative(pkg, join(unit.dir, 'src'))}/`;
+            const scope = `./${rel(pkg, join(unit.dir, 'src'))}/`;
             // T0's per-test timeout: the 5 s default goes red on a random pack under load (verify-pack.ts)
             const suites = () => spawnSync('bun', ['test', '--timeout', '60000', scope], { cwd: pkg, stdio: ['ignore', 'pipe', 'pipe'], timeout: 900_000 });
             let run = suites();

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

@@ -594,9 +594,10 @@ export function stateCoverage(lcov, files, readSource = () => undefined) {
     let current;
     for (const raw of lcov.split('\n')) {
         const line = raw.trim();
+        // bun's lcov names a file with the platform's separator: Windows' '\' is read as '/', as every path here is
         if (line.startsWith('SF:')) {
             current = { fns: [], hits: new Map() };
-            records.set(line.slice(3), current);
+            records.set(line.slice(3).replaceAll('\\', '/'), current);
             continue;
         }
         if (!current)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/twin-standard",
-  "version": "1.0.143",
+  "version": "1.0.145",
   "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.151",
+    "@volter/world-core": "3.0.152",
     "@volter/world-runtime": "*",
     "playwright": "^1.63.0"
   },

package/src/conformance.ts

@@ -15,7 +15,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, extname, join, matchesGlob, relative, resolve } from 'node:path';
+import { basename, dirname, extname, join, matchesGlob, relative, resolve, sep } from 'node:path';
+// A path relative to another with '/' between its parts on every platform (Windows' relative() joins with '\').
+const rel = (from: string, to: string): string => relative(from, to).split(sep).join('/');
 import type { TwinStream } from '@volter/world-core';
 import { citations, sourceHeld, type SourceRecord } from './check-sources.ts';
 import { fileURLToPath } from 'node:url';
@@ -41,7 +43,7 @@ const readJson = (p: string): unknown => (existsSync(p) ? JSON.parse(readFileSyn
 function unitsIn(pack: string): string[] {
   return [pack, ...readdirSync(pack).sort().map((n) => join(pack, n)).filter((d) => !existsSync(join(d, 'package.json')) && existsSync(join(d, 'src', 'manifest.ts')))];
 }
-const nameOf = (pack: string, unit: string): string => relative(resolve(pack, '..'), unit);
+const nameOf = (pack: string, unit: string): string => rel(resolve(pack, '..'), unit);
 
 /** The files conformance reads from a unit: its manifest, its spec's record, its vendor's life and its decision table
  *  (a lane's journeys are its own `journeys/` or else its vendor's). A release publishes each (published()), and a
@@ -182,7 +184,7 @@ function published(pack: string): string[] {
   try { files = new Set(((JSON.parse(run.stdout) as Array<{ files: Array<{ path: string }> }>)[0]?.files ?? []).map((f) => f.path)); } catch { return [`npm pack lists no files (${String(run.stderr).trim().split('\n').at(-1) ?? ''})`]; }
   const out: string[] = [];
   for (const unit of unitsIn(pack)) {
-    const at = relative(pack, unit);
+    const at = rel(pack, unit);
     const of = (p: string): string => (at ? `${at}/${p}` : p);
     for (const need of UNIT_FILES) {
       if (existsSync(join(unit, need)) && !files.has(of(need))) out.push(`${nameOf(pack, unit)}: ${of(need)} is not published (package.json's files)`);

package/src/create-pack.ts

@@ -35,7 +35,7 @@ import { decisionTableProblems } from './conformance.ts';
 import { handlerName } from './protocol-3.ts';
 import { hasOwnSurface } from './lanes.ts';
 
-const FIXED = new Set(['answer-views.ts', 'states.ts', 'index.ts', 'shared.ts', 'doors.ts', 'seed.ts', 'around.ts', 'events.ts', 'clock.ts', 'tenant.ts', 'scenario.ts', 'gap.ts', 'graphql.ts', 'sockets.ts', 'board.ts']);
+const FIXED = new Set(['answer-views.ts', 'states.ts', 'index.ts', 'shared.ts', 'doors.ts', 'seed.ts', 'around.ts', 'events.ts', 'clock.ts', 'tenant.ts', 'scenario.ts', 'gap.ts', 'graphql.ts', 'sockets.ts', 'live.ts', 'board.ts']);
 
 /** A family file's name as a JavaScript identifier (`well-known` is `well_known`). */
 /** A family's name in code: as a handler's (a name JavaScript reserves, the family `default`, takes a trailing `_`). */
@@ -146,6 +146,8 @@ export function packFetchFile(dir: string, name: string): string {
   const hasScenario = existsSync(join(semantics, 'scenario.ts'));
   const hasGap = existsSync(join(semantics, 'gap.ts'));
   const hasSockets = existsSync(join(dir, 'src', 'semantics', 'sockets.ts'));
+  // the broadcasts the vendor takes over RTMP: each ingest's dialect (world-core live)
+  const hasLive = existsSync(join(semantics, 'live.ts'));
   // a GraphQL API beside the REST one: its resolvers and the vendor's schema (graphql-wire.ts)
   const hasGraphql = existsSync(join(semantics, 'graphql.ts')) && existsSync(join(dir, 'src', 'generated', 'graphql-sdl.gen.json'));
   const screensDir = join(dir, 'src', 'screens');
@@ -186,6 +188,7 @@ export function packFetchFile(dir: string, name: string): string {
     ...(hasScenario ? ["import { scenario } from './semantics/scenario.ts';"] : []),
     ...(hasGap ? ["import { gap } from './semantics/gap.ts';"] : []),
     ...(hasSockets ? ["import * as sockets from './semantics/sockets.ts';"] : []),
+    ...(hasLive ? ["import * as live from './semantics/live.ts';"] : []),
     ...(hasGraphql ? ["import { graphql } from './semantics/graphql.ts';", "import schema from './generated/graphql-sdl.gen.json' with { type: 'json' };", "import graphqlSurface from './generated/graphql.gen.json' with { type: 'json' };"] : []),
     ...(hasDoors ? ["import * as doors from './semantics/doors.ts';"] : []),
     ...(map ? [`import { ${map} } from './semantics/index.ts';`] : []),
@@ -205,6 +208,7 @@ export function packFetchFile(dir: string, name: string): string {
     ...(hasScenario ? ['    scenario,'] : []),
     ...(hasGap ? ['    gap,'] : []),
     ...(hasSockets ? ['    sockets,'] : []),
+    ...(hasLive ? ['    live,'] : []),
     ...(hasGraphql ? ['    graphql: { ...graphql, operations: graphqlSurface.operations as NonNullable<typeof graphql.operations>, sdl: schema.sdl },'] : []),
     ...(screens.length ? [`    screens: { ${screens.map((f) => `${JSON.stringify(id(f))}: ${identifier(`screen_${id(f)}`)}`).join(', ')} },`] : []),
     ...(lanes.length ? [`    lanes: ${laneParts},`] : []),
@@ -326,9 +330,14 @@ export function packIndexFile(dir: string, vendor: string): string {
  *  itself: "Other wires"), or, for a unit whose spec is a proto, the gRPC seam over the schema derive-pack generated
  *  (src/generated/proto.gen.json, imported by its literal path). `--init` writes the plain one, `--index` the gRPC one once
  *  the unit's proto is derived. */
-export function serverFile(vendor: string, grpc: boolean, wire = false): string {
+export function serverFile(vendor: string, grpc: boolean, wire = false, live = false): string {
   const Name = pascal(vendor);
   const head = `// FETCH-FIRST (runtime contract R12b): a fixed file, the kernel's serve seam around the pack's fetch (./fetch.ts).\n`;
+  if (live && !grpc) {
+    // a unit that takes broadcasts over RTMP (its manifest's `live`) serves its fetch's ingest on a side port, `ingestPort`,
+    // which the manifest's sidePorts declares (architecture, "Other wires": live media)
+    return `${head}import { serveHttp, serveStream, StreamListenerUnavailable, type PackFetchOptions } from '@volter/world-core';\nimport { create${Name}Fetch } from './fetch.ts';\n\nexport async function create${Name}TwinServer(options: PackFetchOptions & { port?: number; ingestPort?: number } = {}): Promise<{ port: number; ingestPort: number; stop: () => void }> {\n  const fetch = create${Name}Fetch(options);\n  const server = await serveHttp({ port: options.port ?? 0, idleTimeout: 60, fetch });\n  // the vendor's RTMP ingest beside its HTTP host, on its side port (the manifest's live and sidePorts: \`ingestPort\`).\n  // A runtime with no TCP listener at all serves the twin without one (ingestPort 0); a listen that fails (the port\n  // taken) fails the twin's start, as its HTTP listener's would, so the World never records an ingest nothing serves\n  let ingest: { port: number; stop: () => void } | undefined;\n  try { ingest = await serveStream({ port: options.ingestPort ?? 0, stream: fetch.ingest! }); }\n  catch (error) {\n    if (!(error instanceof StreamListenerUnavailable)) { await server.stop(true); throw error; }\n    console.error(\`${vendor} twin: no RTMP ingest here (\${error.message}); serving without one\`);\n  }\n  return { port: server.port ?? options.port ?? 0, ingestPort: ingest?.port ?? 0, stop: () => { ingest?.stop(); void server.stop(true); } };\n}\n`;
+  }
   const signature = `export async function create${Name}TwinServer(options: PackFetchOptions & { port?: number } = {}): Promise<{ port: number; stop: () => void }> {\n`;
   if (grpc && wire) {
     // a unit with a wire of its own beside its API (./stream.ts: the PlanetScale twin's MySQL protocol) serves it on a side
@@ -341,6 +350,15 @@ export function serverFile(vendor: string, grpc: boolean, wire = false): string
   return `${head}import { serveHttp, type PackFetchOptions } from '@volter/world-core';\nimport { create${Name}Fetch } from './fetch.ts';\n\n${signature}  const server = await serveHttp({ port: options.port ?? 0, idleTimeout: 60, fetch: create${Name}Fetch(options) });\n  return { port: server.port ?? options.port ?? 0, stop: () => server.stop(true) };\n}\n`;
 }
 
+/** A pack's `src/cli.ts` (a fixed file): its bin, serving the twin with the options a World hands it; a unit that takes
+ *  broadcasts over RTMP (`live`) takes its ingest's side port too (`--ingest-port`, the manifest's sidePorts). */
+export function cliFile(vendor: string, live = false): string {
+  const Name = pascal(vendor);
+  const ingest = live ? `// the RTMP ingest's side port, which the World allocates (the manifest's sidePorts)\nconst ingestPort = Number(optionValue(rest, '--ingest-port', '0')) || undefined;\n` : '';
+  const served = live ? `  process.stdout.write(s.ingestPort ? \`${vendor} twin ingest at rtmp://127.0.0.1:\${s.ingestPort}\\n\` : '${vendor} twin: no RTMP ingest\\n');\n` : '';
+  return `#!/usr/bin/env node\n// world-${vendor}: serve the ${vendor} twin.\nimport { hasFlag, optionValue } from '@volter/world-core/args';\nimport { keepProcessAlive } from '@volter/world-core/lifecycle';\nimport { create${Name}TwinServer } from './server.ts';\n\nconst [cmd, ...rest] = process.argv.slice(2);\nconst port = Number(optionValue(rest, '--port', '0')) || undefined;\nconst root = optionValue(rest, '--root') || undefined;\nconst readOnly = hasFlag(rest, '--read-only');\n// the World's managed Postgres, which the runtime binds a pack declaring managedDatabase to\nconst database = optionValue(rest, '--database') || undefined;\n// the World's scenario file, for a model vendor's turns\nconst scenarioPath = optionValue(rest, '--scenario') || undefined;\n${ingest}\nif (cmd === 'serve' || cmd === undefined) {\n  const s = await create${Name}TwinServer({ readOnly, ...(root ? { root } : {}), ...(port ? { port } : {}), ...(database ? { database } : {}), ...(scenarioPath ? { scenarioPath } : {})${live ? ', ...(ingestPort ? { ingestPort } : {})' : ''} });\n  process.stdout.write(\`${vendor} twin\${readOnly ? ' [read-only]' : ''} at http://127.0.0.1:\${s.port}\\n\`);\n${served}  await keepProcessAlive();\n} else {\n  process.stdout.write('Usage: world-${vendor} serve [--port N] [--root DIR] [--read-only] [--database URL] [--scenario FILE]${live ? ' [--ingest-port N]' : ''}\\n');\n}\n`;
+}
+
 /** A vendor id as a name in code: `npm-registry` is `NpmRegistry`. */
 const pascal = (vendor: string): string => vendor.split(/[^A-Za-z0-9]+/).filter(Boolean).map((w) => w[0]!.toUpperCase() + w.slice(1)).join('');
 
@@ -417,7 +435,7 @@ export function initFiles(vendor: string): Record<string, string> {
     'src/semantics/doors.ts': `// The World's doors (architecture, "Doors, screens and the gap"): what the vendor's own pages do that its API does\n// not, each declared in the manifest's \`doors\` (its id, method and path under \`/_twin/\`) and answered here by the\n// export its id names, over the contract's context.\nimport type { HandlerContext } from '@volter/world-core';\n\nexport type { HandlerContext };\n`,
     'src/manifest.ts': `// ${vendor}'s manifest: the vendor facts its spec does not carry (architecture, "Protocol 3"). The surface is generated\n// (./generated/surface.gen.json, from ../spec by derive-pack). Every line marked FILL is a vendor fact to state from\n// the vendor's pages, cited.\nimport type { DerivedManifest } from '@volter/world-core';\n\nexport const manifest: DerivedManifest = {\n  vendor: '${vendor}',\n  service: '${vendor}',\n  body: { json: 'always' },\n  ids: { template: '{uuid}' }, // FILL: the vendor's id form\n  time: 'iso', // FILL: iso, unix or unix-ms\n  error: { error: { message: '{message}', code: '{code}' } }, // FILL: the vendor's error body\n  readOnly: { status: 403, message: 'This twin was started read-only; writes are refused.' }, // FILL: the vendor's refusal\n  notFound: { status: 404, message: 'Not found' }, // FILL: the vendor's not-found\n  list: { style: 'envelope', envelope: { data: '{data}' }, limit: { param: 'limit', default: 20, max: 100 } }, // FILL: its paging\n  deleted: {},\n  resources: {}, // FILL: the resources the core serves (plain create, read, update, delete, list)\n  discovery: { twinOf: 'FILL: what the twin is of', stores: 'FILL: what it keeps' },\n  // the descriptor, as data (twin-world's architecture, "The descriptor"): the pack registers packOf(manifest)\n  descriptor: {\n    protocol: '3',\n    transport: 'rest',\n    archetype: 'crud',\n    bin: 'world-${vendor}',\n    resources: [], // FILL: the stored types\n    specSource: 'FILL: the vendored spec (spec/SOURCE.md)',\n    description: 'FILL: one line',\n    adoption: { sdks: [], envStems: [] }, // FILL: its npm clients, and each credential variable's stem (TRIPO for TRIPO_API_KEY: the suffix removed)\n    hosts: [], // FILL: the vendor's hosts\n    endpointEnvNone: 'FILL: the SDK\\'s base-URL variable (endpointEnv) or why none',\n  },\n};\n`,
     'src/server.ts': serverFile(vendor, false),
-    'src/cli.ts': `#!/usr/bin/env node\n// world-${vendor}: serve the ${vendor} twin.\nimport { hasFlag, optionValue } from '@volter/world-core/args';\nimport { keepProcessAlive } from '@volter/world-core/lifecycle';\nimport { create${Name}TwinServer } from './server.ts';\n\nconst [cmd, ...rest] = process.argv.slice(2);\nconst port = Number(optionValue(rest, '--port', '0')) || undefined;\nconst root = optionValue(rest, '--root') || undefined;\nconst readOnly = hasFlag(rest, '--read-only');\n// the World's managed Postgres, which the runtime binds a pack declaring managedDatabase to\nconst database = optionValue(rest, '--database') || undefined;\n// the World's scenario file, for a model vendor's turns\nconst scenarioPath = optionValue(rest, '--scenario') || undefined;\n\nif (cmd === 'serve' || cmd === undefined) {\n  const s = await create${Name}TwinServer({ readOnly, ...(root ? { root } : {}), ...(port ? { port } : {}), ...(database ? { database } : {}), ...(scenarioPath ? { scenarioPath } : {}) });\n  process.stdout.write(\`${vendor} twin\${readOnly ? ' [read-only]' : ''} at http://127.0.0.1:\${s.port}\\n\`);\n  await keepProcessAlive();\n} else {\n  process.stdout.write('Usage: world-${vendor} serve [--port N] [--root DIR] [--read-only] [--database URL] [--scenario FILE]\\n');\n}\n`,
+    'src/cli.ts': cliFile(vendor),
     'src/index.ts': `// @volter/twin-${vendor} — the ${vendor} twin (Protocol 3). A fixed file: the descriptor is the manifest's.\nimport { packOf, registerPack } from '@volter/world-core';\nimport { manifest } from './manifest.ts';\n\nexport { create${Name}Fetch } from './fetch.ts';\nexport { create${Name}TwinServer } from './server.ts';\nexport { manifest };\n\n// The descriptor: twin-world's architecture, "The descriptor"; declared in manifest.ts.\nexport const pack = registerPack(packOf(manifest));\n`,
   };
 }
@@ -561,6 +579,18 @@ export async function createPack(args: string[]): Promise<void> {
       if (!lanesOnly && existsSync(join(dir, 'src', 'generated', 'proto.gen.json'))) {
         writeFileSync(join(dir, 'src', 'server.ts'), serverFile(vendor, true, existsSync(join(dir, 'src', 'stream.ts'))));
         console.log(`create-pack: wrote ${join(dir, 'src', 'server.ts')}`);
+      } else if ((manifest as { live?: unknown[] } | undefined)?.live?.length) {
+        // a unit that takes broadcasts over RTMP serves its ingest beside its HTTP host, and its bin takes the ingest's
+        // side port: each written over its plain --init form only (never over a server of a wire of the pack's own)
+        const fixed = (file: string, forms: string[], next: string): void => {
+          const at = join(dir, 'src', file);
+          const now = existsSync(at) ? readFileSync(at, 'utf8').replace(/\r\n/g, '\n') : undefined;
+          if (now !== undefined && !forms.includes(now)) { console.error(`create-pack: ${at} is not the generated form; serve the ingest there as architecture, "Other wires": live media, says`); return; }
+          writeFileSync(at, next);
+          console.log(`create-pack: wrote ${at}`);
+        };
+        fixed('server.ts', [serverFile(vendor, false), serverFile(vendor, false, false, true)], serverFile(vendor, false, false, true));
+        fixed('cli.ts', [cliFile(vendor), cliFile(vendor, true)], cliFile(vendor, true));
       }
     }
     // a handler is an exported async function, one per operation (the handler contract); anything else a family file

package/src/derive.ts

@@ -9,7 +9,7 @@ import { parseExactJson, exactInteger } from '@volter/world-core/exact-json';
 
 import { parse as parseYaml } from 'yaml';
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { basename, join } from 'node:path';
 import { gunzipSync } from 'node:zlib';
 import { CRUD_CLASSES, fromOpenAPI, fromSmithy, fromSwagger2, slug, type SpecIR } from './spec-ir.ts';
 import { fromCommandReplies, type LineSpec } from './spec-ir-lines.ts';
@@ -40,10 +40,10 @@ if (!specPath) {
   console.error(`derive-pack: no spec at ${join(PKG, 'spec')}/openapi.{json,yaml}[.gz], smithy.json[.gz], rfcNNNN.txt, proto/, commands/ or client-ops.json`);
   process.exit(1);
 }
-const rpcService = specPath.endsWith('/proto');
-const severalDocuments = specPath.endsWith('/openapi');
+const rpcService = basename(specPath) === 'proto';
+const severalDocuments = basename(specPath) === 'openapi';
 // a command language's table, one vendored file per command (Redis's src/commands/*.json), with its version in SOURCE.md
-const commandTable = specPath.endsWith('/commands');
+const commandTable = basename(specPath) === 'commands';
 const protoTree = (dir: string, at = ''): Record<string, string> => Object.fromEntries(readdirSync(join(dir, at), { withFileTypes: true }).flatMap((e) => (e.isDirectory() ? Object.entries(protoTree(dir, join(at, e.name))) : e.name.endsWith('.proto') ? [[join(at, e.name), readFileSync(join(dir, at, e.name), 'utf8')]] : [])));
 const bytes = rpcService || commandTable || severalDocuments ? Buffer.from('') : readFileSync(specPath);
 const text = (specPath.endsWith('.gz') ? gunzipSync(bytes) : bytes).toString('utf8');
@@ -168,7 +168,7 @@ mkdirSync(out, { recursive: true });
 // name commands and cite the RFC.
 if (lineProtocol || commandTable) {
   const spec = doc as LineSpec | CommandTableSpec;
-  writeFileSync(join(out, 'surface.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: specPath.split('/').pop(), ...spec })}\n`);
+  writeFileSync(join(out, 'surface.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: basename(specPath), ...spec })}\n`);
   const manifestPath = join(PKG, 'src', 'manifest.ts');
   if (existsSync(manifestPath)) {
     const { manifest } = (await import(manifestPath)) as { manifest: { resources: Record<string, { state?: Record<string, { transitions: Array<{ operation?: string; actor?: string; to?: string; source?: string }> }> }> } };
@@ -222,7 +222,7 @@ if (sdlPath) {
   graphqlSchema = graphqlLib.buildSchema(sdl, { assumeValidSDL: true });
   for (const o of gql.operations) graphqlOperations.add(o.id);
   mkdirSync(out, { recursive: true });
-  writeFileSync(join(out, 'graphql.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: sdlPath.split('/').pop(), ...gql })}\n`);
+  writeFileSync(join(out, 'graphql.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: basename(sdlPath), ...gql })}\n`);
   // the schema itself, for the pack's GraphQL wire to validate and execute against (imported lazily)
   writeFileSync(join(out, 'graphql-sdl.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', sdl })}\n`);
   const g = new Map<string, number>();
@@ -233,7 +233,7 @@ if (sdlPath) {
 // a proto unit's schema, for the kernel's protobuf codec and gRPC wire: fields by number, enums by number, rpcs by path
 if (rpcService) writeFileSync(join(out, 'proto.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', ...protoSchema(doc) })}\n`);
 // Data, not code: the surface is JSON so it adds nothing to a typecheck and ships as an asset.
-writeFileSync(join(out, 'surface.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: specPath.split('/').pop(), ...ir })}\n`);
+writeFileSync(join(out, 'surface.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: basename(specPath), ...ir })}\n`);
 
 // The event types a vendor delivers, when its spec enumerates them where a webhook subscription names the events it
 // wants (a request body's `enabled_events`): the pack records an event only under a type the vendor sends.
@@ -245,7 +245,7 @@ for (const item of Object.values((doc?.paths ?? {}) as Record<string, Record<str
     }
   }
 }
-if (eventTypes.size) writeFileSync(join(out, 'events.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: specPath.split('/').pop(), types: [...eventTypes].sort() })}\n`);
+if (eventTypes.size) writeFileSync(join(out, 'events.gen.json'), `${JSON.stringify({ generatedBy: 'scripts/derive-pack.ts', spec: basename(specPath), types: [...eventTypes].sort() })}\n`);
 
 // What the pack's UI needs to know about each resource its manifest declares: where it is listed,
 // read, created and moved, which values its state fields take and which moves are legal from which,

package/src/pack-facts.ts

@@ -41,7 +41,7 @@ export type PackFacts = {
   /** The World's managed database the runtime binds the twin to (see TwinPack.managedDatabase). */
   managedDatabase?: { kind: 'postgres'; arg: string; note: string };
   /** Listeners the twin opens beside its main port (see TwinPack.sidePorts). */
-  sidePorts?: Array<{ name: string; option: string; flag: string; path?: string; note: string }>;
+  sidePorts?: Array<{ name: string; option: string; flag: string; path?: string; scheme?: string; note: string }>;
   /** DERIVED, never declared: the pack's `create<Name>TwinServer` factory export — the
    *  `({port,root,readOnly}) => {port,stop}` contract the colocated host mounts
    *  (world-runtime/src/host.ts). Read off the module's own exports because the name is not
@@ -206,6 +206,7 @@ export async function compilePackFacts(dirs: Array<{ vendor: string; dir: string
         if (typeof side.option !== 'string' || !/^[a-z][A-Za-z0-9]*$/.test(side.option)) throw new Error(`pack-facts: ${vendor} side port ${side.name}: option "${String(side.option)}" is the factory's camelCase option`);
         if (typeof side.flag !== 'string' || !/^--[a-z][a-z-]*$/.test(side.flag)) throw new Error(`pack-facts: ${vendor} side port ${side.name}: flag "${String(side.flag)}" is the serve flag (--name)`);
         if (side.path !== undefined && (typeof side.path !== 'string' || !side.path.startsWith('/'))) throw new Error(`pack-facts: ${vendor} side port ${side.name}: path "${String(side.path)}" starts with /`);
+        if (side.scheme !== undefined && (typeof side.scheme !== 'string' || !/^[a-z][a-z0-9+.-]*$/.test(side.scheme))) throw new Error(`pack-facts: ${vendor} side port ${side.name}: scheme "${String(side.scheme)}" is the URL's scheme (rtmp)`);
         if (typeof side.note !== 'string' || side.note.trim() === '') throw new Error(`pack-facts: ${vendor} side port ${side.name} has no note`);
       }
       facts.sidePorts = pack.sidePorts;

package/src/protocol-3.ts

@@ -11,7 +11,7 @@ import { AsyncLocalStorage } from 'node:async_hooks';
 import { createHash } from 'node:crypto';
 import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync } from 'node:fs';
 import { tmpdir } from 'node:os';
-import { basename, dirname, join, relative } from 'node:path';
+import { basename, dirname, join, relative, sep } from 'node:path';
 import { gunzipSync } from 'node:zlib';
 import ts from 'typescript';
 import { fileURLToPath } from 'node:url';
@@ -19,6 +19,10 @@ import { sharingLanesIn } from './lanes.ts';
 import { isPackArtifact } from './pack-files.ts';
 import type { Criterion, GradeUnit, Standard } from './types.ts';
 
+// A path relative to another with '/' between its parts on every platform: git lists files that way, and every rule
+// here compares and splits on '/'; Windows' relative() joins with '\', which hid every lane's files and spec.
+const rel = (from: string, to: string): string => relative(from, to).split(sep).join('/');
+
 /** The lanes over the unit's vendor's state, when the unit is one of them ("Pack layout"), else none: a lane over its
  *  vendor's state takes the vendor's states, shared helpers, manifest and engine from the vendor's src/, and nothing of
  *  another lane. */
@@ -87,9 +91,9 @@ function filesUnder(dir: string, base = dir): string[] {
     files = [...new Set(String(run.stdout).split('\0').filter(Boolean))];
     listing?.set(top, files);
   }
-  const under = relative(top, dir);
+  const under = rel(top, dir);
   const mine = under === '' ? files : files.filter((f) => f.startsWith(`${under}/`)).map((f) => f.slice(under.length + 1));
-  return mine.map((f) => relative(base, join(dir, f))).filter((f) => existsSync(join(base, f)));
+  return mine.map((f) => rel(base, join(dir, f))).filter((f) => existsSync(join(base, f)));
 }
 /** Disk files outside a checkout, or the complete output of the grader's own derivation. */
 function allFilesUnder(dir: string, base = dir, excludeArtifacts = false): string[] {
@@ -97,9 +101,9 @@ function allFilesUnder(dir: string, base = dir, excludeArtifacts = false): strin
   const out: string[] = [];
   for (const name of readdirSync(dir)) {
     const path = join(dir, name);
-    if (excludeArtifacts && isPackArtifact(relative(base, path))) continue;
+    if (excludeArtifacts && isPackArtifact(rel(base, path))) continue;
     if (statSync(path).isDirectory()) out.push(...allFilesUnder(path, base, excludeArtifacts));
-    else out.push(relative(base, path));
+    else out.push(rel(base, path));
   }
   return out;
 }
@@ -124,7 +128,7 @@ function srcFileInForm(unit: GradeUnit, name: string): boolean {
   return (isLane(unit) ? ['manifest.ts', 'index.ts', 'fetch.ts', 'budget.ts'] : ['manifest.ts', 'index.ts', 'cli.ts', 'fetch.ts', 'server.ts', 'stream.ts', 'budget.ts']).includes(name);
 }
 /** The fixed files of semantics/ besides the families' handler files and their tests. */
-const SEMANTICS_FIXED = new Set(['answer-views.ts', 'states.ts', 'index.ts', 'shared.ts', 'doors.ts', 'seed.ts', 'around.ts', 'events.ts', 'clock.ts', 'tenant.ts', 'scenario.ts', 'gap.ts', 'graphql.ts', 'sockets.ts', 'board.ts']);
+const SEMANTICS_FIXED = new Set(['answer-views.ts', 'states.ts', 'index.ts', 'shared.ts', 'doors.ts', 'seed.ts', 'around.ts', 'events.ts', 'clock.ts', 'tenant.ts', 'scenario.ts', 'gap.ts', 'graphql.ts', 'sockets.ts', 'live.ts', 'board.ts']);
 /** journeys/'s closed set. */
 const JOURNEY_FILES = new Set(['customer-life.outline.md', 'customer-life.outline.verdict.json', 'customer-life.json', 'customer-life.verdict.json', 'decisions.json',
   'vendor-examples.json', 'vendor-examples.verdict.json', 'demand.json', 'unreachable.json', 'score.json', 'coverage.json', 'first-use.json',
@@ -210,7 +214,7 @@ const criteria: Criterion[] = [
       const files = specFiles(unit);
       if (!files.length) return fail('no vendored spec under spec/ (openapi, smithy, discovery, asyncapi or an RFC)');
       if (!existsSync(join(unit.dir, 'spec', 'SOURCE.md'))) return fail('spec/SOURCE.md is missing');
-      return pass(files.length > 4 ? `${files.length} documents` : files.map((f) => relative(join(unit.dir, 'spec'), f)).join(', '));
+      return pass(files.length > 4 ? `${files.length} documents` : files.map((f) => rel(join(unit.dir, 'spec'), f)).join(', '));
     },
   },
   {
@@ -396,6 +400,11 @@ const criteria: Criterion[] = [
           if (/^export\s+(?:async\s+)?function\s|^export\s+(let|var|class)\s|^export\s*\{/m.test(text)) found.push('sockets.ts exports otherwise than one const engine per socket');
           continue;
         }
+        if (f === 'live.ts') {
+          // the manifest's live (world-core live): one exported engine per ingest id, and nothing else
+          if (/^export\s+(?:async\s+)?function\s|^export\s+(let|var|class)\s|^export\s*\{/m.test(text)) found.push('live.ts exports otherwise than one const engine per ingest');
+          continue;
+        }
         if (f === 'gap.ts') {
           const names = [...text.matchAll(/^export\s+(?:async\s+)?function\s+([A-Za-z0-9_$]+)/gm)].map((m) => m[1]);
           if (names.join() !== 'gap' || /^export\s+(const|let|var|class)\s|^export\s*\{/m.test(text)) found.push(`gap.ts exports ${names.join(', ') || 'nothing'}, not only gap`);
@@ -652,7 +661,7 @@ const criteria: Criterion[] = [
     asks: "the pack's own tests pass",
     check(unit) {
       const pkg = packageOf(unit);
-      const scope = `./${relative(pkg, join(unit.dir, 'src'))}/`;
+      const scope = `./${rel(pkg, join(unit.dir, 'src'))}/`;
       // T0's per-test timeout: the 5 s default goes red on a random pack under load (verify-pack.ts)
       const suites = () => spawnSync('bun', ['test', '--timeout', '60000', scope], { cwd: pkg, stdio: ['ignore', 'pipe', 'pipe'], timeout: 900_000 });
       let run = suites();

package/src/walk/journey-kit.ts

@@ -757,7 +757,8 @@ export function stateCoverage(lcov: string, files: string[], readSource: (file:
   let current: Rec | undefined;
   for (const raw of lcov.split('\n')) {
     const line = raw.trim();
-    if (line.startsWith('SF:')) { current = { fns: [], hits: new Map() }; records.set(line.slice(3), current); continue; }
+    // bun's lcov names a file with the platform's separator: Windows' '\' is read as '/', as every path here is
+    if (line.startsWith('SF:')) { current = { fns: [], hits: new Map() }; records.set(line.slice(3).replaceAll('\\', '/'), current); continue; }
     if (!current) continue;
     if (line.startsWith('FN:')) { const [l, ...name] = line.slice(3).split(','); current.fns.push({ line: Number(l), name: name.join(',') }); continue; }
     if (line.startsWith('FNF:')) { current.fnf = Number(line.slice(4)); continue; }