@clearlydev/nx-archweave 0.1.0 → 0.1.1

package/README.md

@@ -32,7 +32,7 @@ bun nx g @clearlydev/nx-archweave:doctor           # bun
 - **Requirements:** Node >= 22.18, plus one of npm, pnpm >= 10, yarn (classic or berry) or bun. All four package managers are first-class.
 - Generators detect the workspace's real package manager from its lockfiles.
 - The examples below use `pnpm nx g`. With another package manager, run the same generator the way the `doctor` commands above show.
-- The package ships as a self-contained bundle. Its only runtime dependencies are `@nx/devkit` and `tslib`.
+- The package ships as a self-contained bundle. Its only runtime dependency is `@nx/devkit`.
 
 ## Quick start
 

package/dist/eslint/fsd-boundaries.d.ts

@@ -12,8 +12,8 @@
  * measured source of false positives. Locations are computed from path strings alone: the
  * rule never reads the file system.
  *
- * Self-contained on purpose: no `eslint` import, so the plugin's runtime dependencies stay
- * @nx/devkit + tslib. The handful of ESLint shapes it touches are typed structurally below.
+ * Self-contained on purpose: no `eslint` import, so the plugin's only runtime dependency stays
+ * @nx/devkit. The handful of ESLint shapes it touches are typed structurally below.
  */
 export type FsdEnforcementSeverity = 'error' | 'warn';
 export interface FsdBoundariesOptions {

package/dist/generators/add-integration/generator.js

@@ -104,33 +104,6 @@ function getCatalogEntry(id) {
   return PLUGIN_CATALOG.find((entry) => entry.id === id);
 }
 
-// ../integrations/dist/catalog/resolve-version.js
-import { get } from "node:https";
-function resolveVersionFromNpmRegistry(npmPackage) {
-  const registryUrl = `https://registry.npmjs.org/${encodeURIComponent(npmPackage)}`;
-  return new Promise((resolve2, reject) => {
-    get(registryUrl, (response) => {
-      let body = "";
-      response.on("data", (chunk) => {
-        body += chunk;
-      });
-      response.on("end", () => {
-        try {
-          const parsed = JSON.parse(body);
-          const latest = parsed?.["dist-tags"]?.["latest"];
-          if (typeof latest !== "string") {
-            reject(new Error(`Could not resolve the latest version of ${npmPackage} from the npm registry.`));
-            return;
-          }
-          resolve2(latest);
-        } catch (error) {
-          reject(error instanceof Error ? error : new Error(String(error)));
-        }
-      });
-    }).on("error", reject);
-  });
-}
-
 // ../integrations/dist/hosts/claude-code/detect.js
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
@@ -171,14 +144,14 @@ var WORKSPACE_FILES_BY_SCOPE = {
   local: [".claude/settings.local.json"]
 };
 var DEFAULT_PLUGIN_SCOPE = "project";
-function createClaudeMarketplacePlan(entry, deps) {
+function createClaudeMarketplacePlan(entry) {
   return async (options) => {
     const distribution = entry.hosts["claude-code"];
     if (options.targetEnvironment !== "claude-code" || distribution === void 0) {
       const supported = Object.entries(entry.hosts).filter(([, value]) => value !== void 0).map(([host]) => host).join(", ");
       throw new Error(`Target environment "${options.targetEnvironment}" is not supported by this integration. Supported: ${supported}.`);
     }
-    const resolvedVersion = options.versionRange ?? (options.resolveLatestVersion === false ? VERSION_DECIDED_BY_MARKETPLACE : await deps.resolveVersion(options.versionRange));
+    const resolvedVersion = options.versionRange ?? VERSION_DECIDED_BY_MARKETPLACE;
     const scope = options.scope ?? DEFAULT_PLUGIN_SCOPE;
     return {
       officialCommand: {
@@ -605,10 +578,6 @@ function createClaudeMarketplaceVerifier(entry, deps) {
 }
 
 // ../integrations/dist/catalog/create-catalog-integration.js
-function defaultResolveVersion(entry) {
-  const npmPackage = entry.npmPackage;
-  return npmPackage === void 0 ? async () => VERSION_DECIDED_BY_MARKETPLACE : () => resolveVersionFromNpmRegistry(npmPackage);
-}
 function createCatalogIntegration(entry, deps) {
   return {
     id: entry.id,
@@ -618,7 +587,7 @@ function createCatalogIntegration(entry, deps) {
     license: entry.license,
     supportedEnvironments: PLUGIN_HOSTS.filter((host) => entry.hosts[host] !== void 0),
     detect: (context) => detectWorkspacePackage(entry, context),
-    plan: createClaudeMarketplacePlan(entry, { resolveVersion: deps.resolveVersion ?? defaultResolveVersion(entry) }),
+    plan: createClaudeMarketplacePlan(entry),
     install: createClaudeMarketplaceInstall(entry, { runner: deps.runner }),
     verify: createClaudeMarketplaceVerifier(entry, { runner: deps.runner }),
     uninstallInstructions: async () => [...entry.uninstallSteps]
@@ -795,7 +764,7 @@ var NodeCommandRunner = class {
 // src/runtime/integrations-composition-root.ts
 function createIntegrationsCompositionRoot(deps = {}) {
   const runner = deps.runner ?? new NodeCommandRunner();
-  const registry = createIntegrationRegistry(createCatalogIntegrations({ runner, resolveVersion: deps.resolveVersion }));
+  const registry = createIntegrationRegistry(createCatalogIntegrations({ runner }));
   return {
     registry,
     runner,

package/dist/generators/doctor/generator.js

@@ -1770,33 +1770,6 @@ var PLUGIN_CATALOG = [
 ];
 var PLUGIN_IDS = PLUGIN_CATALOG.map((entry) => entry.id);
 
-// ../integrations/dist/catalog/resolve-version.js
-import { get } from "node:https";
-function resolveVersionFromNpmRegistry(npmPackage) {
-  const registryUrl = `https://registry.npmjs.org/${encodeURIComponent(npmPackage)}`;
-  return new Promise((resolve2, reject) => {
-    get(registryUrl, (response) => {
-      let body = "";
-      response.on("data", (chunk) => {
-        body += chunk;
-      });
-      response.on("end", () => {
-        try {
-          const parsed = JSON.parse(body);
-          const latest = parsed?.["dist-tags"]?.["latest"];
-          if (typeof latest !== "string") {
-            reject(new Error(`Could not resolve the latest version of ${npmPackage} from the npm registry.`));
-            return;
-          }
-          resolve2(latest);
-        } catch (error) {
-          reject(error instanceof Error ? error : new Error(String(error)));
-        }
-      });
-    }).on("error", reject);
-  });
-}
-
 // ../integrations/dist/hosts/claude-code/detect.js
 import { existsSync as existsSync9, readFileSync as readFileSync7 } from "node:fs";
 import { join as join9 } from "node:path";
@@ -1837,14 +1810,14 @@ var WORKSPACE_FILES_BY_SCOPE = {
   local: [".claude/settings.local.json"]
 };
 var DEFAULT_PLUGIN_SCOPE = "project";
-function createClaudeMarketplacePlan(entry, deps) {
+function createClaudeMarketplacePlan(entry) {
   return async (options) => {
     const distribution = entry.hosts["claude-code"];
     if (options.targetEnvironment !== "claude-code" || distribution === void 0) {
       const supported = Object.entries(entry.hosts).filter(([, value]) => value !== void 0).map(([host]) => host).join(", ");
       throw new Error(`Target environment "${options.targetEnvironment}" is not supported by this integration. Supported: ${supported}.`);
     }
-    const resolvedVersion = options.versionRange ?? (options.resolveLatestVersion === false ? VERSION_DECIDED_BY_MARKETPLACE : await deps.resolveVersion(options.versionRange));
+    const resolvedVersion = options.versionRange ?? VERSION_DECIDED_BY_MARKETPLACE;
     const scope = options.scope ?? DEFAULT_PLUGIN_SCOPE;
     return {
       officialCommand: {
@@ -2262,10 +2235,6 @@ function createClaudeMarketplaceVerifier(entry, deps) {
 }
 
 // ../integrations/dist/catalog/create-catalog-integration.js
-function defaultResolveVersion(entry) {
-  const npmPackage = entry.npmPackage;
-  return npmPackage === void 0 ? async () => VERSION_DECIDED_BY_MARKETPLACE : () => resolveVersionFromNpmRegistry(npmPackage);
-}
 function createCatalogIntegration(entry, deps) {
   return {
     id: entry.id,
@@ -2275,7 +2244,7 @@ function createCatalogIntegration(entry, deps) {
     license: entry.license,
     supportedEnvironments: PLUGIN_HOSTS.filter((host) => entry.hosts[host] !== void 0),
     detect: (context) => detectWorkspacePackage(entry, context),
-    plan: createClaudeMarketplacePlan(entry, { resolveVersion: deps.resolveVersion ?? defaultResolveVersion(entry) }),
+    plan: createClaudeMarketplacePlan(entry),
     install: createClaudeMarketplaceInstall(entry, { runner: deps.runner }),
     verify: createClaudeMarketplaceVerifier(entry, { runner: deps.runner }),
     uninstallInstructions: async () => [...entry.uninstallSteps]
@@ -2352,7 +2321,7 @@ var NodeCommandRunner = class {
 // src/runtime/integrations-composition-root.ts
 function createIntegrationsCompositionRoot(deps = {}) {
   const runner = deps.runner ?? new NodeCommandRunner();
-  const registry = createIntegrationRegistry(createCatalogIntegrations({ runner, resolveVersion: deps.resolveVersion }));
+  const registry = createIntegrationRegistry(createCatalogIntegrations({ runner }));
   return {
     registry,
     runner,

package/dist/generators/install-integration/generator.js

@@ -247,33 +247,6 @@ function recordMetadataFor(entry) {
   return { source: claude.marketplace, repository: entry.repository, method: CLAUDE_MARKETPLACE_METHOD };
 }
 
-// ../integrations/dist/catalog/resolve-version.js
-import { get } from "node:https";
-function resolveVersionFromNpmRegistry(npmPackage) {
-  const registryUrl = `https://registry.npmjs.org/${encodeURIComponent(npmPackage)}`;
-  return new Promise((resolve2, reject) => {
-    get(registryUrl, (response) => {
-      let body = "";
-      response.on("data", (chunk) => {
-        body += chunk;
-      });
-      response.on("end", () => {
-        try {
-          const parsed = JSON.parse(body);
-          const latest = parsed?.["dist-tags"]?.["latest"];
-          if (typeof latest !== "string") {
-            reject(new Error(`Could not resolve the latest version of ${npmPackage} from the npm registry.`));
-            return;
-          }
-          resolve2(latest);
-        } catch (error) {
-          reject(error instanceof Error ? error : new Error(String(error)));
-        }
-      });
-    }).on("error", reject);
-  });
-}
-
 // ../integrations/dist/hosts/claude-code/detect.js
 import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
 import { join as join3 } from "node:path";
@@ -314,14 +287,14 @@ var WORKSPACE_FILES_BY_SCOPE = {
   local: [".claude/settings.local.json"]
 };
 var DEFAULT_PLUGIN_SCOPE = "project";
-function createClaudeMarketplacePlan(entry, deps) {
+function createClaudeMarketplacePlan(entry) {
   return async (options) => {
     const distribution = entry.hosts["claude-code"];
     if (options.targetEnvironment !== "claude-code" || distribution === void 0) {
       const supported = Object.entries(entry.hosts).filter(([, value]) => value !== void 0).map(([host]) => host).join(", ");
       throw new Error(`Target environment "${options.targetEnvironment}" is not supported by this integration. Supported: ${supported}.`);
     }
-    const resolvedVersion = options.versionRange ?? (options.resolveLatestVersion === false ? VERSION_DECIDED_BY_MARKETPLACE : await deps.resolveVersion(options.versionRange));
+    const resolvedVersion = options.versionRange ?? VERSION_DECIDED_BY_MARKETPLACE;
     const scope = options.scope ?? DEFAULT_PLUGIN_SCOPE;
     return {
       officialCommand: {
@@ -752,10 +725,6 @@ function createClaudeMarketplaceVerifier(entry, deps) {
 }
 
 // ../integrations/dist/catalog/create-catalog-integration.js
-function defaultResolveVersion(entry) {
-  const npmPackage = entry.npmPackage;
-  return npmPackage === void 0 ? async () => VERSION_DECIDED_BY_MARKETPLACE : () => resolveVersionFromNpmRegistry(npmPackage);
-}
 function createCatalogIntegration(entry, deps) {
   return {
     id: entry.id,
@@ -765,7 +734,7 @@ function createCatalogIntegration(entry, deps) {
     license: entry.license,
     supportedEnvironments: PLUGIN_HOSTS.filter((host) => entry.hosts[host] !== void 0),
     detect: (context) => detectWorkspacePackage(entry, context),
-    plan: createClaudeMarketplacePlan(entry, { resolveVersion: deps.resolveVersion ?? defaultResolveVersion(entry) }),
+    plan: createClaudeMarketplacePlan(entry),
     install: createClaudeMarketplaceInstall(entry, { runner: deps.runner }),
     verify: createClaudeMarketplaceVerifier(entry, { runner: deps.runner }),
     uninstallInstructions: async () => [...entry.uninstallSteps]
@@ -1074,7 +1043,7 @@ var NodeCommandRunner = class {
 // src/runtime/integrations-composition-root.ts
 function createIntegrationsCompositionRoot(deps = {}) {
   const runner = deps.runner ?? new NodeCommandRunner();
-  const registry = createIntegrationRegistry(createCatalogIntegrations({ runner, resolveVersion: deps.resolveVersion }));
+  const registry = createIntegrationRegistry(createCatalogIntegrations({ runner }));
   return {
     registry,
     runner,
@@ -1110,8 +1079,7 @@ async function runInstallIntegration(tree, options, deps = {}) {
   const plan = await integration.plan({
     targetEnvironment: target,
     versionRange: options.versionRange,
-    scope,
-    resolveLatestVersion: false
+    scope
   });
   const pre = await verifyViaClaudeCli(root.runner, pluginId, tree.root);
   let currentState;

package/dist/generators/record-integration/generator.js

@@ -221,33 +221,6 @@ function recordMetadataFor(entry) {
   return { source: claude.marketplace, repository: entry.repository, method: CLAUDE_MARKETPLACE_METHOD };
 }
 
-// ../integrations/dist/catalog/resolve-version.js
-import { get } from "node:https";
-function resolveVersionFromNpmRegistry(npmPackage) {
-  const registryUrl = `https://registry.npmjs.org/${encodeURIComponent(npmPackage)}`;
-  return new Promise((resolve2, reject) => {
-    get(registryUrl, (response) => {
-      let body = "";
-      response.on("data", (chunk) => {
-        body += chunk;
-      });
-      response.on("end", () => {
-        try {
-          const parsed = JSON.parse(body);
-          const latest = parsed?.["dist-tags"]?.["latest"];
-          if (typeof latest !== "string") {
-            reject(new Error(`Could not resolve the latest version of ${npmPackage} from the npm registry.`));
-            return;
-          }
-          resolve2(latest);
-        } catch (error) {
-          reject(error instanceof Error ? error : new Error(String(error)));
-        }
-      });
-    }).on("error", reject);
-  });
-}
-
 // ../integrations/dist/hosts/claude-code/detect.js
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
 import { join as join2 } from "node:path";
@@ -288,14 +261,14 @@ var WORKSPACE_FILES_BY_SCOPE = {
   local: [".claude/settings.local.json"]
 };
 var DEFAULT_PLUGIN_SCOPE = "project";
-function createClaudeMarketplacePlan(entry, deps) {
+function createClaudeMarketplacePlan(entry) {
   return async (options) => {
     const distribution = entry.hosts["claude-code"];
     if (options.targetEnvironment !== "claude-code" || distribution === void 0) {
       const supported = Object.entries(entry.hosts).filter(([, value]) => value !== void 0).map(([host]) => host).join(", ");
       throw new Error(`Target environment "${options.targetEnvironment}" is not supported by this integration. Supported: ${supported}.`);
     }
-    const resolvedVersion = options.versionRange ?? (options.resolveLatestVersion === false ? VERSION_DECIDED_BY_MARKETPLACE : await deps.resolveVersion(options.versionRange));
+    const resolvedVersion = options.versionRange ?? VERSION_DECIDED_BY_MARKETPLACE;
     const scope = options.scope ?? DEFAULT_PLUGIN_SCOPE;
     return {
       officialCommand: {
@@ -713,10 +686,6 @@ function createClaudeMarketplaceVerifier(entry, deps) {
 }
 
 // ../integrations/dist/catalog/create-catalog-integration.js
-function defaultResolveVersion(entry) {
-  const npmPackage = entry.npmPackage;
-  return npmPackage === void 0 ? async () => VERSION_DECIDED_BY_MARKETPLACE : () => resolveVersionFromNpmRegistry(npmPackage);
-}
 function createCatalogIntegration(entry, deps) {
   return {
     id: entry.id,
@@ -726,7 +695,7 @@ function createCatalogIntegration(entry, deps) {
     license: entry.license,
     supportedEnvironments: PLUGIN_HOSTS.filter((host) => entry.hosts[host] !== void 0),
     detect: (context) => detectWorkspacePackage(entry, context),
-    plan: createClaudeMarketplacePlan(entry, { resolveVersion: deps.resolveVersion ?? defaultResolveVersion(entry) }),
+    plan: createClaudeMarketplacePlan(entry),
     install: createClaudeMarketplaceInstall(entry, { runner: deps.runner }),
     verify: createClaudeMarketplaceVerifier(entry, { runner: deps.runner }),
     uninstallInstructions: async () => [...entry.uninstallSteps]
@@ -803,7 +772,7 @@ var NodeCommandRunner = class {
 // src/runtime/integrations-composition-root.ts
 function createIntegrationsCompositionRoot(deps = {}) {
   const runner = deps.runner ?? new NodeCommandRunner();
-  const registry = createIntegrationRegistry(createCatalogIntegrations({ runner, resolveVersion: deps.resolveVersion }));
+  const registry = createIntegrationRegistry(createCatalogIntegrations({ runner }));
   return {
     registry,
     runner,
@@ -858,7 +827,7 @@ async function recordIntegrationGenerator(tree, options, deps = {}) {
   if (!metadata) {
     throw new Error(`No manifest metadata is defined for "${options.tool}".`);
   }
-  await integration.plan({ targetEnvironment: target, resolveLatestVersion: false });
+  await integration.plan({ targetEnvironment: target });
   const outcome = await runRecordPipeline({
     id: integration.id,
     runner: root.runner,

package/dist/generators/shared/project-type.js

@@ -9,8 +9,8 @@ import { parseJson } from '@nx/devkit';
  * application, as in Nx); then `tsconfig.lib.json` → library; `tsconfig.app.json`
  * → application; a readable package.json with none of exports/main/module/bin
  * set → application; anything else — including a missing or unparseable
- * package.json — → library. Mirrored, not imported: the plugin's runtime
- * dependencies stay @nx/devkit + tslib. Not mirrored: the package-json plugin's
+ * package.json — → library. Mirrored, not imported: the plugin's only runtime
+ * dependency stays @nx/devkit. Not mirrored: the package-json plugin's
  * `workspaceLayout.appsDir`/`libsDir` override, which devkit's tree-based
  * `getProjects` never applies either.
  */

package/dist/index.js

@@ -111,33 +111,6 @@ var PLUGIN_CATALOG = [
 ];
 var PLUGIN_IDS = PLUGIN_CATALOG.map((entry) => entry.id);
 
-// ../integrations/dist/catalog/resolve-version.js
-import { get } from "node:https";
-function resolveVersionFromNpmRegistry(npmPackage) {
-  const registryUrl = `https://registry.npmjs.org/${encodeURIComponent(npmPackage)}`;
-  return new Promise((resolve2, reject) => {
-    get(registryUrl, (response) => {
-      let body = "";
-      response.on("data", (chunk) => {
-        body += chunk;
-      });
-      response.on("end", () => {
-        try {
-          const parsed = JSON.parse(body);
-          const latest = parsed?.["dist-tags"]?.["latest"];
-          if (typeof latest !== "string") {
-            reject(new Error(`Could not resolve the latest version of ${npmPackage} from the npm registry.`));
-            return;
-          }
-          resolve2(latest);
-        } catch (error) {
-          reject(error instanceof Error ? error : new Error(String(error)));
-        }
-      });
-    }).on("error", reject);
-  });
-}
-
 // ../integrations/dist/hosts/claude-code/detect.js
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
@@ -178,14 +151,14 @@ var WORKSPACE_FILES_BY_SCOPE = {
   local: [".claude/settings.local.json"]
 };
 var DEFAULT_PLUGIN_SCOPE = "project";
-function createClaudeMarketplacePlan(entry, deps) {
+function createClaudeMarketplacePlan(entry) {
   return async (options) => {
     const distribution = entry.hosts["claude-code"];
     if (options.targetEnvironment !== "claude-code" || distribution === void 0) {
       const supported = Object.entries(entry.hosts).filter(([, value]) => value !== void 0).map(([host]) => host).join(", ");
       throw new Error(`Target environment "${options.targetEnvironment}" is not supported by this integration. Supported: ${supported}.`);
     }
-    const resolvedVersion = options.versionRange ?? (options.resolveLatestVersion === false ? VERSION_DECIDED_BY_MARKETPLACE : await deps.resolveVersion(options.versionRange));
+    const resolvedVersion = options.versionRange ?? VERSION_DECIDED_BY_MARKETPLACE;
     const scope = options.scope ?? DEFAULT_PLUGIN_SCOPE;
     return {
       officialCommand: {
@@ -603,10 +576,6 @@ function createClaudeMarketplaceVerifier(entry, deps) {
 }
 
 // ../integrations/dist/catalog/create-catalog-integration.js
-function defaultResolveVersion(entry) {
-  const npmPackage = entry.npmPackage;
-  return npmPackage === void 0 ? async () => VERSION_DECIDED_BY_MARKETPLACE : () => resolveVersionFromNpmRegistry(npmPackage);
-}
 function createCatalogIntegration(entry, deps) {
   return {
     id: entry.id,
@@ -616,7 +585,7 @@ function createCatalogIntegration(entry, deps) {
     license: entry.license,
     supportedEnvironments: PLUGIN_HOSTS.filter((host) => entry.hosts[host] !== void 0),
     detect: (context) => detectWorkspacePackage(entry, context),
-    plan: createClaudeMarketplacePlan(entry, { resolveVersion: deps.resolveVersion ?? defaultResolveVersion(entry) }),
+    plan: createClaudeMarketplacePlan(entry),
     install: createClaudeMarketplaceInstall(entry, { runner: deps.runner }),
     verify: createClaudeMarketplaceVerifier(entry, { runner: deps.runner }),
     uninstallInstructions: async () => [...entry.uninstallSteps]
@@ -693,7 +662,7 @@ var NodeCommandRunner = class {
 // src/runtime/integrations-composition-root.ts
 function createIntegrationsCompositionRoot(deps = {}) {
   const runner = deps.runner ?? new NodeCommandRunner();
-  const registry = createIntegrationRegistry(createCatalogIntegrations({ runner, resolveVersion: deps.resolveVersion }));
+  const registry = createIntegrationRegistry(createCatalogIntegrations({ runner }));
   return {
     registry,
     runner,

package/dist/runtime/integrations-composition-root.js

@@ -10,7 +10,7 @@ import { NodeCommandRunner } from "./node-command-runner.js";
 // equal to it by a test (catalog-schema-enums.spec.ts).
 export function createIntegrationsCompositionRoot(deps = {}) {
     const runner = deps.runner ?? new NodeCommandRunner();
-    const registry = createIntegrationRegistry(createCatalogIntegrations({ runner, resolveVersion: deps.resolveVersion }));
+    const registry = createIntegrationRegistry(createCatalogIntegrations({ runner }));
     return {
         registry,
         runner,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clearlydev/nx-archweave",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Nx generators that make a workspace ready to work on in one preset: FSD Lite structure with enforced module boundaries, AI agent rules, GitHub templates, and optional AI PR review (Claude, Gemini, GPT, Cursor)",
   "license": "MIT",
   "author": "clearlydev (https://github.com/clearlydev)",
@@ -92,7 +92,6 @@
     }
   },
   "dependencies": {
-    "@nx/devkit": "^23.1.0",
-    "tslib": "^2.3.0"
+    "@nx/devkit": "^23.1.0"
   }
 }

package/src/generators/add-integration/schema.json

@@ -23,7 +23,7 @@
     },
     "versionRange": {
       "type": "string",
-      "description": "Exact version to pin. If omitted, the official npm registry is queried for the latest version (one real network call)."
+      "description": "Version to show as requested. Without it, the preview says the marketplace decides — it installs its own latest. No network access."
     },
     "dryRun": {
       "type": "boolean",