@volter/world-core 3.0.165 → 3.0.166

package/attach.cjs

@@ -63,12 +63,16 @@ if (ref) {
         });
       });
     }
+    // what this attach sets from the manifest: a stream's transport templates replace these below (a pack's declared
+    // transport templates win over its primary-name HTTP URL, on every path that installs a twin's environment), and
+    // never a value the caller set itself
+    const fromManifest = new Set();
     for (const [vendor, origin] of Object.entries(manifest.vendors ?? {})) {
       const key = `${vendor.toUpperCase()}_TWIN_URL`;
-      if (process.env[key] === undefined) process.env[key] = origin;
+      if (process.env[key] === undefined) { process.env[key] = origin; fromManifest.add(key); }
     }
     for (const [key, value] of Object.entries(manifest.env ?? {})) {
-      if (process.env[key] === undefined) process.env[key] = value;
+      if (process.env[key] === undefined) { process.env[key] = value; fromManifest.add(key); }
     }
     // a World's byte-stream doors (a hosted World's smtp, planetscale's mysql): loopback listeners in
     // this process, bridged over WebSocket (./stream-bridge.cjs). The env names the listener now, so the
@@ -87,7 +91,7 @@ if (ref) {
       const streamToken = manifest.env?.VOLTER_TWINS_KEY ?? token ?? '';
       streams.forEach((stream, i) => {
         for (const [key, value] of Object.entries(streamEnv(stream.env, ports[i]))) {
-          if (process.env[key] === undefined) process.env[key] = value;
+          if (process.env[key] === undefined || fromManifest.has(key)) process.env[key] = value;
         }
         bridgeStream(stream.url, streamToken, ports[i]).then((server) => server.unref(), (error) => {
           process.stderr.write(`[twin-attach] ${stream.url}: could not listen on 127.0.0.1:${ports[i]}: ${error.message}\n`);

package/dist/attach.cjs

@@ -63,12 +63,16 @@ if (ref) {
         });
       });
     }
+    // what this attach sets from the manifest: a stream's transport templates replace these below (a pack's declared
+    // transport templates win over its primary-name HTTP URL, on every path that installs a twin's environment), and
+    // never a value the caller set itself
+    const fromManifest = new Set();
     for (const [vendor, origin] of Object.entries(manifest.vendors ?? {})) {
       const key = `${vendor.toUpperCase()}_TWIN_URL`;
-      if (process.env[key] === undefined) process.env[key] = origin;
+      if (process.env[key] === undefined) { process.env[key] = origin; fromManifest.add(key); }
     }
     for (const [key, value] of Object.entries(manifest.env ?? {})) {
-      if (process.env[key] === undefined) process.env[key] = value;
+      if (process.env[key] === undefined) { process.env[key] = value; fromManifest.add(key); }
     }
     // a World's byte-stream doors (a hosted World's smtp, planetscale's mysql): loopback listeners in
     // this process, bridged over WebSocket (./stream-bridge.cjs). The env names the listener now, so the
@@ -87,7 +91,7 @@ if (ref) {
       const streamToken = manifest.env?.VOLTER_TWINS_KEY ?? token ?? '';
       streams.forEach((stream, i) => {
         for (const [key, value] of Object.entries(streamEnv(stream.env, ports[i]))) {
-          if (process.env[key] === undefined) process.env[key] = value;
+          if (process.env[key] === undefined || fromManifest.has(key)) process.env[key] = value;
         }
         bridgeStream(stream.url, streamToken, ports[i]).then((server) => server.unref(), (error) => {
           process.stderr.write(`[twin-attach] ${stream.url}: could not listen on 127.0.0.1:${ports[i]}: ${error.message}\n`);

package/dist/src/checkout.d.ts

@@ -0,0 +1,4 @@
+/** The checkout a directory is in: the nearest ancestor of the path as given that holds `.git` (a directory, or a
+ *  worktree's file), or undefined outside every checkout. It walks the spelling it is handed; a caller whose base may
+ *  be a symlink passes its physical path. What a checkout tracks, and what a failed Git query means, is each caller's. */
+export declare function checkoutOf(dir: string): string | undefined;

package/dist/src/checkout.js

@@ -0,0 +1,13 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+/** The checkout a directory is in: the nearest ancestor of the path as given that holds `.git` (a directory, or a
+ *  worktree's file), or undefined outside every checkout. It walks the spelling it is handed; a caller whose base may
+ *  be a symlink passes its physical path. What a checkout tracks, and what a failed Git query means, is each caller's. */
+export function checkoutOf(dir) {
+    for (let d = resolve(dir);; d = dirname(d)) {
+        if (existsSync(join(d, '.git')))
+            return d;
+        if (dirname(d) === d)
+            return undefined;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/world-core",
-  "version": "3.0.165",
+  "version": "3.0.166",
   "description": "The kernel of Volter World: one log per twin, branches as pointers, checkpoints, the fold that keeps a twin current, the head that performs a write against the vendor, references, and the git plane. A twin package builds on it; the runtime serves it.",
   "keywords": [
     "twin",
@@ -88,6 +88,10 @@
       "types": "./dist/src/exact-json.d.ts",
       "default": "./dist/src/exact-json.js"
     },
+    "./checkout": {
+      "types": "./dist/src/checkout.d.ts",
+      "default": "./dist/src/checkout.js"
+    },
     "./inject": "./inject.cjs",
     "./attach": "./attach.cjs",
     "./stream-bridge": "./stream-bridge.cjs",

package/src/checkout.ts

@@ -0,0 +1,12 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+
+/** The checkout a directory is in: the nearest ancestor of the path as given that holds `.git` (a directory, or a
+ *  worktree's file), or undefined outside every checkout. It walks the spelling it is handed; a caller whose base may
+ *  be a symlink passes its physical path. What a checkout tracks, and what a failed Git query means, is each caller's. */
+export function checkoutOf(dir: string): string | undefined {
+  for (let d = resolve(dir); ; d = dirname(d)) {
+    if (existsSync(join(d, '.git'))) return d;
+    if (dirname(d) === d) return undefined;
+  }
+}