@volter/world-core 3.0.62 → 3.0.64

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

@@ -2,7 +2,10 @@
 export declare function packVendor(dir: string): string | undefined;
 /** Nearest installed package wins only over another installation of the SAME package. A World's explicit
  * package choice wins over a catalog recommendation; different publishers' versions never compete. */
-export declare function installedVendorPacks(from: string): Map<string, string>;
+export declare function installedVendorPacks(from: string, options?: {
+    sources?: Readonly<Record<string, string>>;
+    vendors?: readonly string[];
+}): Map<string, string>;
 /** Node's nearest installed package, including linked packages and hoisted workspace dependencies. */
 export declare function installedPackageDir(from: string, name: string): string | undefined;
 /** A pack repository itself, or the P3 repository beside a platform checkout. Applications do not acquire a

package/dist/src/pack-paths.js

@@ -26,10 +26,11 @@ export function packVendor(dir) {
 }
 /** Nearest installed package wins only over another installation of the SAME package. A World's explicit
  * package choice wins over a catalog recommendation; different publishers' versions never compete. */
-export function installedVendorPacks(from) {
+export function installedVendorPacks(from, options = {}) {
     const packages = new Map();
     const seen = new Set();
     const pins = new Map();
+    const savedPins = new Set();
     let at = resolve(from);
     for (;;) {
         const config = join(at, '.volter', 'world.json');
@@ -37,8 +38,10 @@ export function installedVendorPacks(from) {
             const document = JSON.parse(readFileSync(config, 'utf8'));
             for (const service of document.services ?? []) {
                 const name = service.source?.package ?? service.package;
-                if (name && !pins.has(service.id))
+                if (name && !pins.has(service.id)) {
                     pins.set(service.id, name);
+                    savedPins.add(service.id);
+                }
             }
         }
         const modules = join(at, 'node_modules');
@@ -74,16 +77,29 @@ export function installedVendorPacks(from) {
             if (pins.has(vendor) && pins.get(vendor) !== name)
                 throw new Error(`${vendor}: a World must select one package implementation`);
             pins.set(vendor, name);
+            savedPins.add(vendor);
         }
     }
+    for (const [vendor, name] of Object.entries(options.sources ?? {})) {
+        const candidate = packages.get(name);
+        if (!candidate)
+            throw new Error(`${vendor}: selected package ${name} is not installed; install its exact release before initializing`);
+        if (candidate.vendor !== vendor)
+            throw new Error(`${vendor}: selected package ${name} declares vendor ${candidate.vendor}`);
+        if (pins.has(vendor) && pins.get(vendor) !== name)
+            throw new Error(`${vendor}: saved World selects ${pins.get(vendor)}; trial ${name} in a separate app directory instead of replacing the saved pin`);
+        pins.set(vendor, name);
+    }
     const result = new Map();
     for (const vendor of new Set([...packages.values()].map((p) => p.vendor))) {
+        if (options.vendors && !options.vendors.includes(vendor))
+            continue;
         const candidates = [...packages.entries()].filter(([, p]) => p.vendor === vendor);
         const selected = pins.get(vendor) ?? recommendations[vendor];
         const choice = selected ? candidates.find(([name]) => name === selected) : candidates.length === 1 ? candidates[0] : undefined;
         if (!choice)
-            throw new Error(`${vendor}: ${selected ? `selected package ${selected} is not installed` : `multiple implementations installed (${candidates.map(([name]) => name).join(', ')})`}; name the chosen source.package in .volter/world.json`);
-        if (!pins.has(vendor)) {
+            throw new Error(`${vendor}: ${selected ? `selected package ${selected} is not installed` : `multiple implementations installed (${candidates.map(([name]) => name).join(', ')})`}; initialize with --source ${vendor}=<package>, or name the chosen source.package in .volter/world.json`);
+        if (!savedPins.has(vendor)) {
             const version = JSON.parse(readFileSync(join(choice[1].dir, 'package.json'), 'utf8')).version;
             if (revocations.some((r) => r.package === choice[0] && r.version === version))
                 throw new Error(`${vendor}: installed ${choice[0]}@${version} is revoked; install an approved release or retain an existing explicit World pin`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/world-core",
-  "version": "3.0.62",
+  "version": "3.0.64",
   "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",

package/src/pack-paths.ts

@@ -24,10 +24,11 @@ export function packVendor(dir: string): string | undefined {
 
 /** Nearest installed package wins only over another installation of the SAME package. A World's explicit
  * package choice wins over a catalog recommendation; different publishers' versions never compete. */
-export function installedVendorPacks(from: string): Map<string, string> {
+export function installedVendorPacks(from: string, options: { sources?: Readonly<Record<string, string>>; vendors?: readonly string[] } = {}): Map<string, string> {
   const packages = new Map<string, { dir: string; vendor: string }>();
   const seen = new Set<string>();
   const pins = new Map<string, string>();
+  const savedPins = new Set<string>();
   let at = resolve(from);
   for (;;) {
     const config = join(at, '.volter', 'world.json');
@@ -35,7 +36,7 @@ export function installedVendorPacks(from: string): Map<string, string> {
       const document = JSON.parse(readFileSync(config, 'utf8')) as { services?: Array<{ id: string; source?: { package?: string }; package?: string }> };
       for (const service of document.services ?? []) {
         const name = service.source?.package ?? service.package;
-        if (name && !pins.has(service.id)) pins.set(service.id, name);
+        if (name && !pins.has(service.id)) { pins.set(service.id, name); savedPins.add(service.id); }
       }
     }
     const modules = join(at, 'node_modules');
@@ -63,15 +64,24 @@ export function installedVendorPacks(from: string): Map<string, string> {
     if (vendor && vendor !== id) {
       if (pins.has(vendor) && pins.get(vendor) !== name) throw new Error(`${vendor}: a World must select one package implementation`);
       pins.set(vendor, name);
+      savedPins.add(vendor);
     }
   }
+  for (const [vendor, name] of Object.entries(options.sources ?? {})) {
+    const candidate = packages.get(name);
+    if (!candidate) throw new Error(`${vendor}: selected package ${name} is not installed; install its exact release before initializing`);
+    if (candidate.vendor !== vendor) throw new Error(`${vendor}: selected package ${name} declares vendor ${candidate.vendor}`);
+    if (pins.has(vendor) && pins.get(vendor) !== name) throw new Error(`${vendor}: saved World selects ${pins.get(vendor)}; trial ${name} in a separate app directory instead of replacing the saved pin`);
+    pins.set(vendor, name);
+  }
   const result = new Map<string, string>();
   for (const vendor of new Set([...packages.values()].map((p) => p.vendor))) {
+    if (options.vendors && !options.vendors.includes(vendor)) continue;
     const candidates = [...packages.entries()].filter(([, p]) => p.vendor === vendor);
     const selected = pins.get(vendor) ?? recommendations[vendor];
     const choice = selected ? candidates.find(([name]) => name === selected) : candidates.length === 1 ? candidates[0] : undefined;
-    if (!choice) throw new Error(`${vendor}: ${selected ? `selected package ${selected} is not installed` : `multiple implementations installed (${candidates.map(([name]) => name).join(', ')})`}; name the chosen source.package in .volter/world.json`);
-    if (!pins.has(vendor)) {
+    if (!choice) throw new Error(`${vendor}: ${selected ? `selected package ${selected} is not installed` : `multiple implementations installed (${candidates.map(([name]) => name).join(', ')})`}; initialize with --source ${vendor}=<package>, or name the chosen source.package in .volter/world.json`);
+    if (!savedPins.has(vendor)) {
       const version = (JSON.parse(readFileSync(join(choice[1].dir, 'package.json'), 'utf8')) as { version?: string }).version;
       if (revocations.some((r) => r.package === choice[0] && r.version === version)) throw new Error(`${vendor}: installed ${choice[0]}@${version} is revoked; install an approved release or retain an existing explicit World pin`);
     }