@volter/twin-standard 1.0.155 → 1.0.157

package/dist/src/cli.js

@@ -113,7 +113,7 @@ else if (command === 'grade') {
 else if (command === 'create') {
     if (args.includes('--init') && !args.includes('--package'))
         throw new Error('Name your scoped package with --package');
-    await (await import("./create-pack.js")).createPack(args);
+    await (await import('./create-pack.js')).createPack(args);
 }
 else if (command === 'prepare-consumer') {
     if (!args[0])
@@ -128,7 +128,7 @@ else if (command === 'prepare-consumer') {
     const out = resolve(value('--out'));
     if (existsSync(out))
         throw new Error('Prepared consumer output already exists');
-    const { prepareConsumerApp } = await import("./consumer.js");
+    const { prepareConsumerApp } = await import('./consumer.js');
     const candidateAt = args.indexOf('--candidate');
     const artifact = candidateAt >= 0 ? resolve(value('--candidate')) : undefined;
     const fixture = prepareConsumerApp(resolve(args[0]), appDir, { cli, artifact });
@@ -146,7 +146,7 @@ else if (command === 'walk-consumer') {
     if (outputAt >= 0 && !args[outputAt + 1])
         usage();
     const consumer = JSON.parse(readFileSync(resolve(args[at + 1]), 'utf8'));
-    const { runConsumerWorkflow } = await import("./consumer.js");
+    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) {
@@ -160,7 +160,7 @@ else if (command === 'walk-consumer') {
 else if (command === 'assess') {
     if (!args[0])
         usage();
-    const { assessPack } = await import("./assessment.js");
+    const { assessPack } = await import('./assessment.js');
     const consumerAt = args.indexOf('--prepared-consumer');
     if (consumerAt >= 0 && !args[consumerAt + 1])
         usage();
@@ -180,7 +180,7 @@ else if (command === 'assess') {
 else if (command === 'facts') {
     if (!args[0])
         usage();
-    const { compilePackFacts, renderPackFacts } = await import("./pack-facts.js");
+    const { compilePackFacts, renderPackFacts } = await import('./pack-facts.js');
     const { mkdirSync, writeFileSync } = await import('node:fs');
     const { join, dirname } = await import('node:path');
     const dir = resolve(args[0]);
@@ -203,25 +203,25 @@ else if (command === 'walk' || command === 'examples' || command === 'coverage'
         usage();
     const tool = { walk: 'score-pack', examples: 'vendor-examples', coverage: 'life-coverage', 'judge-brief': 'judge-brief' }[command];
     process.argv = [process.argv[0], process.argv[1], ...args];
-    await import(__rewriteRelativeImportExtension((await import('./tools/packs-root.ts')).toolPath(tool)));
+    await import(__rewriteRelativeImportExtension((await import('./tools/packs-root.js')).toolPath(tool)));
 }
 else if (command === 'derive') {
     if (!args[0])
         usage();
     // the derivation is a script over process.argv: it reads the unit from its first argument
     process.argv = [process.argv[0], process.argv[1], ...args];
-    await import('./derive.ts');
+    await import('./derive.js');
 }
 else if (command === 'check-sources') {
     if (!args[0])
         usage();
-    await (await import('./check-sources.ts')).checkSources(args);
+    await (await import('./check-sources.js')).checkSources(args);
 }
 else if (command === 'read-page') {
     // a documentation page's text, read as the citation check reads it: where an author finds the vendor's examples and words
     if (!args[0])
         usage();
-    const { status, readable, raw, error } = await (await import('./check-sources.ts')).readPage(args[0]);
+    const { status, readable, raw, error } = await (await import('./check-sources.js')).readPage(args[0]);
     if (status !== 200) {
         console.error(`read-page: ${args[0]} answered ${status || 'nothing'}${error ? `: ${error}` : ''}`);
         process.exit(1);
@@ -241,8 +241,8 @@ else if (command === 'conform') {
     // `.tgz` the tarball `npm pack` makes of one, the bytes a publish would send
     const published = target.endsWith('.tgz') || (!existsSync(target) && /^@?[^@]+@[^@]+$/.test(target));
     const results = published
-        ? await (await import('./published.ts')).conformPublished(target, at >= 0 ? { registry: args[at + 1] } : {})
-        : await (await import('./conformance.ts')).conformance(target, { onCheck: (id) => console.error(`  … ${id} (${new Date().toISOString().slice(11, 19)})`) });
+        ? await (await import('./published.js')).conformPublished(target, at >= 0 ? { registry: args[at + 1] } : {})
+        : await (await import('./conformance.js')).conformance(target, { onCheck: (id) => console.error(`  … ${id} (${new Date().toISOString().slice(11, 19)})`) });
     for (const r of results) {
         console.log(`${r.failures.length ? '✗' : '✓'} ${r.id.padEnd(15)} ${r.asks}${r.note ? `  (${r.note})` : ''}`);
         for (const f of r.failures)

package/dist/src/conformance.js

@@ -611,8 +611,8 @@ async function lifeServed(pack) {
             }, server.managedDatabaseUrl ? { managedDatabaseUrl: server.managedDatabaseUrl } : {}),
             // a socket opened as an application opens it: a WebSocket to the served port, the vendor's host in its Host header
             socket: (url, headers) => new WebSocket(`ws://127.0.0.1:${port}${url}`, { headers }),
-            // a line connection opened as an application's client opens it: TCP to the protocol listener (the primary port)
-            stream: lineConnection(server.port),
+            // TCP to the native wire: a separate listener beside HTTP, or the primary protocol port.
+            stream: lineConnection(server.wirePort ?? server.port),
             // bounded: Bun's server.stop(true) never settles once a WebSocket peer has closed under it (discord's life, Bun
             // 1.3.11: the walk ended and the stop spun at full CPU for 45 minutes), so the check waits 5 s and goes on
             stop: async () => { await within(5000, Promise.resolve(server.stop())); },

package/dist/src/consumer.js

@@ -3,7 +3,7 @@ import { createHash } from 'node:crypto';
 import { existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, statSync, writeFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { basename, dirname, isAbsolute, join, relative, resolve } from 'node:path';
-import { spawn } from 'node:child_process';
+import { spawn, spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { standardPackageFile } from "./package-file.js";
 import { dependencyLock } from "./dependency-lock.js";
@@ -91,7 +91,7 @@ export function prepareConsumerApp(packDir, appDir, installation) {
             throw new Error(`${name}: customer SDK dependencies require exact registry versions`);
     }
     const files = Object.entries(recipe.files).map(([path, content]) => {
-        if (isAbsolute(path) || path.includes('\\') || path.split('/').some((part) => !part || part === '.' || part === '..') || path.split('/').includes('node_modules') || ['.env', '.npmrc', '.volter/world.json'].includes(path))
+        if (isAbsolute(path) || path.includes('\\') || path.split('/').some((part) => !part || part === '.' || part === '..' || part === '.git') || path.split('/').includes('node_modules') || ['.env', '.npmrc', '.volter/world.json'].includes(path))
             throw new Error(`Invalid consumer file: ${path}`);
         if (typeof content !== 'string')
             throw new Error('Consumer files must contain text');
@@ -113,6 +113,17 @@ export function prepareConsumerApp(packDir, appDir, installation) {
         mkdirSync(dirname(join(appDir, path)), { recursive: true });
         writeFileSync(join(appDir, path), content);
     }
+    // World init reads committed example values. The recipe is this new application's source.
+    const gitEnv = Object.fromEntries(Object.entries(process.env).filter(([name]) => !name.startsWith('GIT_')));
+    for (const args of [
+        ['init', '--quiet', '--template='],
+        ['add', '--force', '--', ...files.map(([path]) => path)],
+        ['-c', 'user.name=World consumer', '-c', 'user.email=consumer@world.test', '-c', 'commit.gpgsign=false', '-c', `core.hooksPath=${join(appDir, '.git/hooks')}`, 'commit', '--quiet', '-m', 'Materialize customer application'],
+    ]) {
+        const result = spawnSync('git', ['-C', appDir, ...args], { env: gitEnv, encoding: 'utf8' });
+        if (result.error || result.status !== 0)
+            throw new Error(`Consumer source ${args[0]} failed: ${result.error?.message ?? result.stderr.trim()}`);
+    }
     return { recipeSha256: createHash('sha256').update(JSON.stringify(recipe)).digest('hex'), dependencies: app.dependencies ?? {} };
 }
 export async function runConsumerWorkflow(packDir, options) {

package/dist/src/walk/serve-pack.d.ts

@@ -1,6 +1,7 @@
 export type ServedPack = {
     port: number;
     inspectPort?: number;
+    wirePort?: number;
     stop: () => void | Promise<void>;
     managedDatabaseUrl?: () => Promise<string>;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/twin-standard",
-  "version": "1.0.155",
+  "version": "1.0.157",
   "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",

package/src/cli.ts

@@ -78,7 +78,7 @@ if (command === '--version') {
   });
 } else if (command === 'create') {
   if (args.includes('--init') && !args.includes('--package')) throw new Error('Name your scoped package with --package');
-  await (await import('./create-pack.ts')).createPack(args);
+  await (await import('./create-pack.js')).createPack(args);
 } else if (command === 'prepare-consumer') {
   if (!args[0]) usage();
   const value = (name: string) => { const at = args.indexOf(name); if (at < 0 || !args[at + 1]) usage(); return args[at + 1]!; };
@@ -88,7 +88,7 @@ if (command === '--version') {
   if (!/^sha512-[A-Za-z0-9+/]{86}==$/.test(artifactIntegrity)) throw new Error('Consumer preparation requires candidate SHA-512 integrity');
   const out = resolve(value('--out'));
   if (existsSync(out)) throw new Error('Prepared consumer output already exists');
-  const { prepareConsumerApp } = await import('./consumer.ts');
+  const { prepareConsumerApp } = await import('./consumer.js');
   const candidateAt = args.indexOf('--candidate');
   const artifact = candidateAt >= 0 ? resolve(value('--candidate')) : undefined;
   const fixture = prepareConsumerApp(resolve(args[0]!), appDir, { cli, artifact });
@@ -102,7 +102,7 @@ if (command === '--version') {
   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 { runConsumerWorkflow } = await import('./consumer.js');
   const report = await runConsumerWorkflow(resolve(args[0]!), consumer);
   const text = `${JSON.stringify(report, null, 2)}\n`;
   if (outputAt >= 0) {
@@ -112,7 +112,7 @@ if (command === '--version') {
   process.exit(report.passed ? 0 : 1);
 } else if (command === 'assess') {
   if (!args[0]) usage();
-  const { assessPack } = await import('./assessment.ts');
+  const { assessPack } = await import('./assessment.js');
   const consumerAt = args.indexOf('--prepared-consumer');
   if (consumerAt >= 0 && !args[consumerAt + 1]) usage();
   const consumer = consumerAt >= 0 ? JSON.parse(readFileSync(resolve(args[consumerAt + 1]!), 'utf8')) : undefined;
@@ -126,7 +126,7 @@ if (command === '--version') {
   process.exit(report.ready ? 0 : 1);
 } else if (command === 'facts') {
   if (!args[0]) usage();
-  const { compilePackFacts, renderPackFacts } = await import('./pack-facts.ts');
+  const { compilePackFacts, renderPackFacts } = await import('./pack-facts.js');
   const { mkdirSync, writeFileSync } = await import('node:fs');
   const { join, dirname } = await import('node:path');
   const dir = resolve(args[0]!);
@@ -145,19 +145,19 @@ if (command === '--version') {
   if (!args[0] || args[0].startsWith('-')) usage();
   const tool = { walk: 'score-pack', examples: 'vendor-examples', coverage: 'life-coverage', 'judge-brief': 'judge-brief' }[command];
   process.argv = [process.argv[0]!, process.argv[1]!, ...args];
-  await import((await import('./tools/packs-root.ts')).toolPath(tool));
+  await import((await import('./tools/packs-root.js')).toolPath(tool));
 } else if (command === 'derive') {
   if (!args[0]) usage();
   // the derivation is a script over process.argv: it reads the unit from its first argument
   process.argv = [process.argv[0]!, process.argv[1]!, ...args];
-  await import('./derive.ts');
+  await import('./derive.js');
 } else if (command === 'check-sources') {
   if (!args[0]) usage();
-  await (await import('./check-sources.ts')).checkSources(args);
+  await (await import('./check-sources.js')).checkSources(args);
 } else if (command === 'read-page') {
   // a documentation page's text, read as the citation check reads it: where an author finds the vendor's examples and words
   if (!args[0]) usage();
-  const { status, readable, raw, error } = await (await import('./check-sources.ts')).readPage(args[0]);
+  const { status, readable, raw, error } = await (await import('./check-sources.js')).readPage(args[0]);
   if (status !== 200) { console.error(`read-page: ${args[0]} answered ${status || 'nothing'}${error ? `: ${error}` : ''}`); process.exit(1); }
   // --raw: the page's own bytes, as fetched (a spec writer reads its tables, which the readable text drops)
   if (args.includes('--raw')) process.stdout.write(raw); else console.log(readable);
@@ -169,8 +169,8 @@ if (command === '--version') {
   // `.tgz` the tarball `npm pack` makes of one, the bytes a publish would send
   const published = target.endsWith('.tgz') || (!existsSync(target) && /^@?[^@]+@[^@]+$/.test(target));
   const results = published
-    ? await (await import('./published.ts')).conformPublished(target, at >= 0 ? { registry: args[at + 1]! } : {})
-    : await (await import('./conformance.ts')).conformance(target, { onCheck: (id) => console.error(`  … ${id} (${new Date().toISOString().slice(11, 19)})`) });
+    ? await (await import('./published.js')).conformPublished(target, at >= 0 ? { registry: args[at + 1]! } : {})
+    : await (await import('./conformance.js')).conformance(target, { onCheck: (id) => console.error(`  … ${id} (${new Date().toISOString().slice(11, 19)})`) });
   for (const r of results) {
     console.log(`${r.failures.length ? '✗' : '✓'} ${r.id.padEnd(15)} ${r.asks}${r.note ? `  (${r.note})` : ''}`);
     for (const f of r.failures) console.log(`    ${f}`);

package/src/conformance.ts

@@ -499,8 +499,8 @@ async function lifeServed(pack: string): Promise<string[]> {
       }, server.managedDatabaseUrl ? { managedDatabaseUrl: server.managedDatabaseUrl } : {}),
       // a socket opened as an application opens it: a WebSocket to the served port, the vendor's host in its Host header
       socket: (url: string, headers: Record<string, string>) => new WebSocket(`ws://127.0.0.1:${port}${url}`, { headers } as unknown as string[]),
-      // a line connection opened as an application's client opens it: TCP to the protocol listener (the primary port)
-      stream: lineConnection(server.port),
+      // TCP to the native wire: a separate listener beside HTTP, or the primary protocol port.
+      stream: lineConnection(server.wirePort ?? server.port),
       // bounded: Bun's server.stop(true) never settles once a WebSocket peer has closed under it (discord's life, Bun
       // 1.3.11: the walk ended and the stop spun at full CPU for 45 minutes), so the check waits 5 s and goes on
       stop: async () => { await within(5000, Promise.resolve(server.stop())); },

package/src/consumer.ts

@@ -3,7 +3,7 @@ import { createHash } from 'node:crypto';
 import { existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, statSync, writeFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { basename, dirname, isAbsolute, join, relative, resolve } from 'node:path';
-import { spawn } from 'node:child_process';
+import { spawn, spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { standardPackageFile } from './package-file.ts';
 import { dependencyLock } from './dependency-lock.ts';
@@ -87,7 +87,7 @@ export function prepareConsumerApp(packDir: string, appDir: string, installation
     if (typeof version !== 'string' || !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(version)) throw new Error(`${name}: customer SDK dependencies require exact registry versions`);
   }
   const files = Object.entries(recipe.files).map(([path, content]) => {
-    if (isAbsolute(path) || path.includes('\\') || path.split('/').some((part) => !part || part === '.' || part === '..') || path.split('/').includes('node_modules') || ['.env', '.npmrc', '.volter/world.json'].includes(path)) throw new Error(`Invalid consumer file: ${path}`);
+    if (isAbsolute(path) || path.includes('\\') || path.split('/').some((part) => !part || part === '.' || part === '..' || part === '.git') || path.split('/').includes('node_modules') || ['.env', '.npmrc', '.volter/world.json'].includes(path)) throw new Error(`Invalid consumer file: ${path}`);
     if (typeof content !== 'string') throw new Error('Consumer files must contain text');
     return [path, content] as [string, string];
   });
@@ -105,6 +105,16 @@ export function prepareConsumerApp(packDir: string, appDir: string, installation
     mkdirSync(dirname(join(appDir, path)), { recursive: true });
     writeFileSync(join(appDir, path), content);
   }
+  // World init reads committed example values. The recipe is this new application's source.
+  const gitEnv = Object.fromEntries(Object.entries(process.env).filter(([name]) => !name.startsWith('GIT_')));
+  for (const args of [
+    ['init', '--quiet', '--template='],
+    ['add', '--force', '--', ...files.map(([path]) => path)],
+    ['-c', 'user.name=World consumer', '-c', 'user.email=consumer@world.test', '-c', 'commit.gpgsign=false', '-c', `core.hooksPath=${join(appDir, '.git/hooks')}`, 'commit', '--quiet', '-m', 'Materialize customer application'],
+  ]) {
+    const result = spawnSync('git', ['-C', appDir, ...args], { env: gitEnv, encoding: 'utf8' });
+    if (result.error || result.status !== 0) throw new Error(`Consumer source ${args[0]} failed: ${result.error?.message ?? result.stderr.trim()}`);
+  }
   return { recipeSha256: createHash('sha256').update(JSON.stringify(recipe)).digest('hex'), dependencies: app.dependencies ?? {} };
 }
 

package/src/walk/serve-pack.ts

@@ -6,6 +6,7 @@ import { startTwinDatabase, type TwinDatabase } from './walk-database.ts';
 export type ServedPack = {
   port: number;
   inspectPort?: number;
+  wirePort?: number;
   stop: () => void | Promise<void>;
   managedDatabaseUrl?: () => Promise<string>;
 };