@quenty/nevermore-cli 4.39.0 → 4.41.0

package/dist/utils/testing/runner/test-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-runner.js","sourceRoot":"","sources":["../../../../src/utils/testing/runner/test-runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"test-runner.js","sourceRoot":"","sources":["../../../../src/utils/testing/runner/test-runner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quenty/nevermore-cli",
-  "version": "4.39.0",
+  "version": "4.41.0",
   "description": "CLI interface for Nevermore",
   "type": "module",
   "keywords": [
@@ -57,5 +57,5 @@
   "engines": {
     "node": ">=16"
   },
-  "gitHead": "647acfad93dca41c38f59cda247d2bfc0fff36d4"
+  "gitHead": "8bd905a5c7e7f1fd4e178b54beeadef94a615d1d"
 }

package/src/commands/batch-command/batch-deploy-command.ts

@@ -34,7 +34,10 @@ import {
   discoverChangedTargetPackagesAsync,
   flattenToBatchTargets,
 } from '../../utils/batch/changed-packages-utils.js';
-import { isCI } from '../../utils/nevermore-cli-utils.js';
+import {
+  isCI,
+  readPackageVersionAsync,
+} from '../../utils/nevermore-cli-utils.js';
 import { parseTestLogs } from '../../utils/testing/test-log-parser.js';
 
 const SMOKE_TEST_SCRIPT_PATH = resolvePackagePath(
@@ -236,13 +239,18 @@ async function _runAsync(args: BatchDeployArgs): Promise<void> {
 
         const injected = await injectDeployMetadataAsync(
           builtPlace,
-          buildDeployMetadataAttributes(deployGitInfo, {
-            target: targetName,
-            published: publish,
-            timestamp: deployTimestamp,
-            universeId: buildTarget.target.universeId,
-            placeId: buildTarget.target.placeId,
-          })
+          buildDeployMetadataAttributes(
+            deployGitInfo,
+            {
+              target: targetName,
+              published: publish,
+              timestamp: deployTimestamp,
+              universeId: buildTarget.target.universeId,
+              placeId: buildTarget.target.placeId,
+              packageVersion: await readPackageVersionAsync(buildTarget.path),
+            },
+            buildTarget.manifestPlaces
+          )
         );
 
         let version: number;

package/src/commands/deploy-command/index.ts

@@ -29,11 +29,16 @@ import { RateLimiter } from '../../utils/open-cloud/rate-limiter.js';
 import { CloudJobContext } from '../../utils/job-context/cloud-job-context.js';
 import { runBatchAsync } from '../../utils/batch/batch-runner.js';
 import { type BatchTarget } from '../../utils/batch/changed-packages-utils.js';
-import { isCI, readPackageNameAsync } from '../../utils/nevermore-cli-utils.js';
+import {
+  isCI,
+  readPackageNameAsync,
+  readPackageVersionAsync,
+} from '../../utils/nevermore-cli-utils.js';
 import {
   loadDeployConfigAsync,
   resolveDeployConfigPath,
   resolveDeployTargetPlaces,
+  toManifestPlaceInfo,
 } from '../../utils/build/deploy-config.js';
 import { handleInitAsync } from './deploy-init.js';
 import {
@@ -247,6 +252,7 @@ export class DeployCommand<T> implements CommandModule<T, DeployArgs> {
 
     const cwd = process.cwd();
     const packageName = (await readPackageNameAsync(cwd)) ?? path.basename(cwd);
+    const packageVersion = await readPackageVersionAsync(cwd);
 
     const { targetName, autoDetected: targetAutoDetected } =
       await selectTargetAsync(cwd, {
@@ -256,6 +262,7 @@ export class DeployCommand<T> implements CommandModule<T, DeployArgs> {
 
     const config = await loadDeployConfigAsync(resolveDeployConfigPath(cwd));
     const places = resolveDeployTargetPlaces(config, targetName);
+    const manifestPlaces = places.map(toManifestPlaceInfo);
     const isMultiPlace = places.length > 1;
 
     if (isMultiPlace) {
@@ -279,6 +286,7 @@ export class DeployCommand<T> implements CommandModule<T, DeployArgs> {
             packageName,
             path: cwd,
             target: place,
+            manifestPlaces,
           };
         })
       : [
@@ -287,6 +295,7 @@ export class DeployCommand<T> implements CommandModule<T, DeployArgs> {
             packageName,
             path: cwd,
             target: places[0]!,
+            manifestPlaces,
           },
         ];
 
@@ -402,13 +411,18 @@ export class DeployCommand<T> implements CommandModule<T, DeployArgs> {
 
           const injected = await injectDeployMetadataAsync(
             builtPlace,
-            buildDeployMetadataAttributes(deployGitInfo, {
-              target: targetName,
-              published: publish,
-              timestamp: deployTimestamp,
-              universeId: args.universeId ?? buildTarget.target.universeId,
-              placeId: args.placeId ?? buildTarget.target.placeId,
-            })
+            buildDeployMetadataAttributes(
+              deployGitInfo,
+              {
+                target: targetName,
+                published: publish,
+                timestamp: deployTimestamp,
+                universeId: args.universeId ?? buildTarget.target.universeId,
+                placeId: args.placeId ?? buildTarget.target.placeId,
+                packageVersion,
+              },
+              buildTarget.manifestPlaces
+            )
           );
 
           let uploadResult: Awaited<ReturnType<typeof uploadPlaceAsync>>;

package/src/utils/batch/changed-packages-utils.ts

@@ -3,9 +3,11 @@ import { execa } from 'execa';
 import { OutputHelper } from '@quenty/cli-output-helpers';
 import {
   DeployTarget,
+  ManifestPlaceInfo,
   loadDeployConfigAsync,
   resolveDeployConfigPath,
   resolveDeployTargetPlaces,
+  toManifestPlaceInfo,
 } from '../build/deploy-config.js';
 
 export interface TargetPackage {
@@ -33,6 +35,13 @@ export interface BatchTarget {
   path: string;
   /** The single resolved place this BatchTarget represents. */
   target: DeployTarget;
+  /**
+   * Every place of this package's target (including `target` itself), stamped
+   * into the runtime manifest so a deployed place can resolve its siblings' IDs.
+   * Same for every BatchTarget fanned out from one package. Only the deploy
+   * paths populate this; test/script BatchTargets omit it.
+   */
+  manifestPlaces?: ManifestPlaceInfo[];
 }
 
 /**
@@ -119,19 +128,27 @@ export function flattenToBatchTargets(
 ): BatchTarget[] {
   const result: BatchTarget[] = [];
   for (const pkg of packages) {
+    const manifestPlaces = pkg.activeTargets.map(toManifestPlaceInfo);
     if (pkg.activeTargets.length === 1) {
       result.push({
         name: pkg.name,
         packageName: pkg.name,
         path: pkg.path,
         target: pkg.activeTargets[0]!,
+        manifestPlaces,
       });
       continue;
     }
     for (const target of pkg.activeTargets) {
       const suffix = target.name;
       const name = suffix ? `${pkg.name} - ${suffix}` : pkg.name;
-      result.push({ name, packageName: pkg.name, path: pkg.path, target });
+      result.push({
+        name,
+        packageName: pkg.name,
+        path: pkg.path,
+        target,
+        manifestPlaces,
+      });
     }
   }
   return result;

package/src/utils/build/deploy-config.ts

@@ -36,6 +36,28 @@ export interface DeployConfig {
   targets: Record<string, DeployTargetConfig>;
 }
 
+/**
+ * The subset of a resolved place that gets baked into the runtime manifest
+ * (see the nevermore-cli-manifest package). A deployed place carries the whole
+ * target's place table so it can resolve its siblings' IDs at runtime — e.g. a
+ * chapter place teleporting to another chapter without hard-coding place IDs.
+ */
+export interface ManifestPlaceInfo {
+  /** Place name from a multi-place target (e.g. "chapter0"); absent for single-place targets. */
+  name?: string;
+  placeId: number;
+  universeId: number;
+}
+
+/** Project a resolved deploy place down to the fields stamped into the manifest. */
+export function toManifestPlaceInfo(place: DeployTarget): ManifestPlaceInfo {
+  return {
+    name: place.name,
+    placeId: place.placeId,
+    universeId: place.universeId,
+  };
+}
+
 function _isMultiPlace(
   target: DeployTargetConfig
 ): target is MultiPlaceTargetConfig {

package/src/utils/deploy/deploy-metadata.test.ts

@@ -77,6 +77,19 @@ describe('buildDeployMetadataAttributes', () => {
     expect('Branch' in attributes).toBe(false);
   });
 
+  it('includes the package version when present', () => {
+    const attributes = buildDeployMetadataAttributes(
+      {},
+      { ...PLACE, packageVersion: '1.0.0' }
+    );
+    expect(attributes.PackageVersion).toBe('1.0.0');
+  });
+
+  it('omits the package version when unavailable', () => {
+    const attributes = buildDeployMetadataAttributes({}, PLACE);
+    expect('PackageVersion' in attributes).toBe(false);
+  });
+
   it('reflects a Saved (unpublished) deploy', () => {
     const attributes = buildDeployMetadataAttributes(
       {},
@@ -84,6 +97,34 @@ describe('buildDeployMetadataAttributes', () => {
     );
     expect(attributes.Published).toBe(false);
   });
+
+  it('omits Places when no place table is given', () => {
+    const attributes = buildDeployMetadataAttributes({}, PLACE);
+    expect('Places' in attributes).toBe(false);
+  });
+
+  it('stamps Places as a JSON string preserving large IDs exactly', () => {
+    const attributes = buildDeployMetadataAttributes({}, PLACE, [
+      { name: 'chapter0', placeId: 97235312452456, universeId: 10192566764 },
+      { name: 'chapter1', placeId: 87639818897831, universeId: 10192566764 },
+    ]);
+    expect(typeof attributes.Places).toBe('string');
+    const parsed = JSON.parse(attributes.Places as string);
+    // Large place IDs must survive exactly (JSON text, not a float32 attribute).
+    expect(parsed).toEqual([
+      { name: 'chapter0', placeId: 97235312452456, universeId: 10192566764 },
+      { name: 'chapter1', placeId: 87639818897831, universeId: 10192566764 },
+    ]);
+  });
+
+  it('omits the name key for a single-place (nameless) target', () => {
+    const attributes = buildDeployMetadataAttributes({}, PLACE, [
+      { placeId: 123, universeId: 456 },
+    ]);
+    const parsed = JSON.parse(attributes.Places as string);
+    expect(parsed).toEqual([{ placeId: 123, universeId: 456 }]);
+    expect('name' in parsed[0]).toBe(false);
+  });
 });
 
 describe('packageUsesManifestAsync', () => {

package/src/utils/deploy/deploy-metadata.ts

@@ -7,6 +7,7 @@ import {
 } from '@quenty/nevermore-template-helpers';
 import { OutputHelper } from '@quenty/cli-output-helpers';
 import { type BuiltPlace } from '../build/build.js';
+import { type ManifestPlaceInfo } from '../build/deploy-config.js';
 
 /** npm name of the package that ships the manifest module. */
 export const MANIFEST_PACKAGE_NAME = '@quenty/nevermoreclimanifest';
@@ -74,6 +75,8 @@ export interface DeployPlaceInfo {
   timestamp: string;
   placeId: number;
   universeId: number;
+  /** `version` from the deploying package's package.json (e.g. "1.0.0"), if any. */
+  packageVersion?: string;
 }
 
 /**
@@ -85,10 +88,16 @@ export interface DeployPlaceInfo {
  * round-trip through Lune serialization as float32, which silently corrupts IDs
  * above 2^24 (e.g. 123456789 -> 123456792). Strings are exact; the Luau reader
  * converts them back with `tonumber`.
+ *
+ * When `places` is given (the whole target's place table), it is stamped as a
+ * `Places` JSON-string attribute. The IDs inside stay numeric — a JSON string
+ * is exact text, and the Luau reader decodes it to 64-bit numbers, so the
+ * float32 hazard that forces the top-level IDs to be stringified doesn't apply.
  */
 export function buildDeployMetadataAttributes(
   git: GitDeployInfo,
-  place: DeployPlaceInfo
+  place: DeployPlaceInfo,
+  places?: readonly ManifestPlaceInfo[]
 ): DeployMetadataAttributes {
   const attributes: DeployMetadataAttributes = {
     Deployed: true,
@@ -101,6 +110,16 @@ export function buildDeployMetadataAttributes(
   if (git.commit) attributes.Commit = git.commit;
   if (git.version) attributes.Version = git.version;
   if (git.branch) attributes.Branch = git.branch;
+  if (place.packageVersion) attributes.PackageVersion = place.packageVersion;
+  if (places && places.length > 0) {
+    attributes.Places = JSON.stringify(
+      places.map((p) => ({
+        name: p.name,
+        placeId: p.placeId,
+        universeId: p.universeId,
+      }))
+    );
+  }
   return attributes;
 }
 

package/src/utils/nevermore-cli-utils.ts

@@ -51,6 +51,21 @@ export async function readPackageNameAsync(
   }
 }
 
+export async function readPackageVersionAsync(
+  packagePath: string
+): Promise<string | undefined> {
+  try {
+    const content = await fs.readFile(
+      path.join(packagePath, 'package.json'),
+      'utf-8'
+    );
+    const pkg = JSON.parse(content) as { version?: string };
+    return pkg.version;
+  } catch {
+    return undefined;
+  }
+}
+
 export async function fileExistsAsync(filePath: string): Promise<boolean> {
   try {
     await fs.access(filePath);

package/src/utils/testing/runner/test-runner.ts

@@ -14,6 +14,7 @@ import {
   injectDeployMetadataInPlaceAsync,
   packageUsesManifestAsync,
 } from '../../deploy/deploy-metadata.js';
+import { readPackageVersionAsync } from '../../nevermore-cli-utils.js';
 
 export interface SingleTestResult {
   success: boolean;
@@ -78,6 +79,7 @@ export async function runSingleTestAsync(
         timestamp: new Date().toISOString(),
         placeId: builtPlace.target.placeId,
         universeId: builtPlace.target.universeId,
+        packageVersion: await readPackageVersionAsync(packagePath),
       })
     );
   }