@volter/world-attach 2.0.0

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/cli.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+// volter-attach — the shim-only attach client (docs/guides/route-a-cli-through-the-world.md, rung 0 for
+// machines with no Twins checkout). Deliberately thin: it resolves the
+// kernel's dormant attach entry (`@volter/world-core/attach`), sets VOLTER_WORLD,
+// and execs the command — ALL attach logic (manifest fetch, env synthesis,
+// CA trust, arming the injector) lives in that one shared file.
+//
+//   volter-attach <world-url> [--token <t>] -- <command…>
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const args = process.argv.slice(2);
+const split = args.indexOf('--');
+const head = split >= 0 ? args.slice(0, split) : args;
+const command = split >= 0 ? args.slice(split + 1) : [];
+const ref = head[0];
+const tokenIndex = head.indexOf('--token');
+const token = tokenIndex >= 0 ? head[tokenIndex + 1] : undefined;
+if (!ref || ref.startsWith('-') || command.length === 0) {
+    process.stderr.write('Usage: volter-attach <world-url> [--token <t>] -- <command…>\n');
+    process.exit(2);
+}
+const attachEntry = require.resolve('@volter/world-core/attach');
+const result = spawnSync(command[0], command.slice(1), {
+    env: {
+        ...process.env,
+        NODE_OPTIONS: `${process.env.NODE_OPTIONS ?? ''} --require ${attachEntry}`.trim(),
+        VOLTER_WORLD: ref,
+        ...(token === undefined ? {} : { VOLTER_WORLD_TOKEN: token }),
+    },
+    stdio: 'inherit',
+});
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@volter/world-attach",
+  "version": "2.0.0",
+  "description": "Shim-only attach client for Twins worlds: point any Node app at a local or served world with zero repo integration (docs/guides/route-a-cli-through-the-world.md). No twins in it.",
+  "keywords": [
+    "twin",
+    "attach",
+    "world",
+    "sdk",
+    "localstack"
+  ],
+  "author": "Volter (https://github.com/volter-ai)",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "volter-attach": "dist/src/cli.js"
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "dependencies": {
+    "@volter/world-core": "2.0.0"
+  },
+  "scripts": {
+    "build": "node ../../scripts/publish/build.mjs",
+    "prepack": "node ../../scripts/publish/prepare-publish.mjs prepack",
+    "postpack": "node ../../scripts/publish/prepare-publish.mjs postpack"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+// volter-attach — the shim-only attach client (docs/guides/route-a-cli-through-the-world.md, rung 0 for
+// machines with no Twins checkout). Deliberately thin: it resolves the
+// kernel's dormant attach entry (`@volter/world-core/attach`), sets VOLTER_WORLD,
+// and execs the command — ALL attach logic (manifest fetch, env synthesis,
+// CA trust, arming the injector) lives in that one shared file.
+//
+//   volter-attach <world-url> [--token <t>] -- <command…>
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const args = process.argv.slice(2);
+const split = args.indexOf('--');
+const head = split >= 0 ? args.slice(0, split) : args;
+const command = split >= 0 ? args.slice(split + 1) : [];
+const ref = head[0];
+const tokenIndex = head.indexOf('--token');
+const token = tokenIndex >= 0 ? head[tokenIndex + 1] : undefined;
+
+if (!ref || ref.startsWith('-') || command.length === 0) {
+  process.stderr.write('Usage: volter-attach <world-url> [--token <t>] -- <command…>\n');
+  process.exit(2);
+}
+
+const attachEntry = require.resolve('@volter/world-core/attach');
+const result = spawnSync(command[0]!, command.slice(1), {
+  env: {
+    ...process.env,
+    NODE_OPTIONS: `${process.env.NODE_OPTIONS ?? ''} --require ${attachEntry}`.trim(),
+    VOLTER_WORLD: ref,
+    ...(token === undefined ? {} : { VOLTER_WORLD_TOKEN: token }),
+  },
+  stdio: 'inherit',
+});
+process.exit(result.status ?? 1);