@unbrained/pm-cli 2026.6.19 → 2026.6.21

package/dist/cli-bundle/chunks/{chunk-YWAYOWDQ.js → chunk-32R4PIC6.js}

@@ -1,18 +1,18 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="22164ee8-de20-5c39-8e47-10a59c3f2d56")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5b1918c3-a3a1-53f2-b547-2724ff2a4f28")}catch(e){}}();
 import {
   normalizeExtensionNameForMatch,
   normalizeManagedDirectoryName,
   normalizeStringList,
   parseExtensionManifest,
   validateExtensionDirectory
-} from "./chunk-VP4Z36GO.js";
+} from "./chunk-SRYYRVPB.js";
 import {
   splitCommaList
 } from "./chunk-P4SESZGT.js";
 import {
   nowIso
-} from "./chunk-5P2LQV2F.js";
+} from "./chunk-NSBZ2CKF.js";
 import {
   EXIT_CODE,
   EXTENSION_CAPABILITY_CONTRACT,
@@ -31,7 +31,7 @@ import {
   resolvePmPackageRootFromModule,
   resolvePmRoot,
   writeSettings
-} from "./chunk-I2VJM36R.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/cli/commands/extension.js
 import { execFile as execFile2 } from "node:child_process";
@@ -417,6 +417,7 @@ async function collectPackageExtensionDirectories(packageRoot) {
 
 // dist/cli/commands/extension/install-sources.js
 var execFileAsync = promisify(execFile);
+var PM_CLI_PACKAGE_NAME = "@unbrained/pm-cli";
 function parseGithubPathSpec(pathSpec, input, refOverride) {
   const segments = pathSpec.split("/").map((segment) => segment.trim()).filter((segment) => segment.length > 0);
   if (segments.length < 2) {
@@ -740,18 +741,75 @@ async function installNpmPackageRuntimeDependencies(packageRoot) {
   }
   const manifest = parsed;
   const dependencySpecs = runtimeDependencyInstallSpecs(manifest);
-  if (dependencySpecs.length === 0) {
+  const shouldLinkHostedPmCli = hasHostedPmCliDependency(manifest);
+  if (dependencySpecs.length === 0 && !shouldLinkHostedPmCli) {
     return;
   }
   const runtimeOnlyManifest = { ...parsed };
   delete runtimeOnlyManifest.devDependencies;
-  await fs3.writeFile(packageJsonPath, `${JSON.stringify(runtimeOnlyManifest, null, 2)}
+  const installManifest = { ...runtimeOnlyManifest };
+  removeHostedPmCliDependency(installManifest);
+  await fs3.writeFile(packageJsonPath, `${JSON.stringify(installManifest, null, 2)}
 `, "utf8");
-  await Promise.all([
-    fs3.rm(path3.join(packageRoot, "package-lock.json"), { force: true }),
-    fs3.rm(path3.join(packageRoot, "npm-shrinkwrap.json"), { force: true })
-  ]);
-  await runNpmCommand(["install", "--ignore-scripts", "--no-audit", "--fund=false", "--package-lock=false", "--no-save", ...dependencySpecs], packageRoot);
+  try {
+    await Promise.all([
+      fs3.rm(path3.join(packageRoot, "package-lock.json"), { force: true }),
+      fs3.rm(path3.join(packageRoot, "npm-shrinkwrap.json"), { force: true })
+    ]);
+    if (dependencySpecs.length > 0) {
+      await runNpmCommand([
+        "install",
+        "--ignore-scripts",
+        "--no-audit",
+        "--fund=false",
+        "--package-lock=false",
+        "--no-save",
+        "--omit=peer",
+        ...dependencySpecs
+      ], packageRoot);
+    }
+    if (shouldLinkHostedPmCli) {
+      await linkHostedPmCliDependency(packageRoot);
+    }
+  } finally {
+    await fs3.writeFile(packageJsonPath, `${JSON.stringify(runtimeOnlyManifest, null, 2)}
+`, "utf8");
+  }
+}
+function hasHostedPmCliDependency(manifest) {
+  for (const dependencyMap of [manifest.dependencies, manifest.optionalDependencies, manifest.peerDependencies]) {
+    if (typeof dependencyMap === "object" && dependencyMap !== null && PM_CLI_PACKAGE_NAME in dependencyMap) {
+      return true;
+    }
+  }
+  return false;
+}
+function removeHostedPmCliDependency(manifest) {
+  for (const field of ["dependencies", "optionalDependencies", "peerDependencies"]) {
+    const dependencyMap = manifest[field];
+    if (typeof dependencyMap !== "object" || dependencyMap === null) {
+      continue;
+    }
+    const nextMap = { ...dependencyMap };
+    delete nextMap[PM_CLI_PACKAGE_NAME];
+    if (Object.keys(nextMap).length === 0) {
+      delete manifest[field];
+    } else {
+      manifest[field] = nextMap;
+    }
+  }
+}
+async function linkHostedPmCliDependency(packageRoot) {
+  const hostPackageRoot = resolvePmPackageRootFromModule(import.meta.url, ["../../../.."]);
+  const [scope, packageName] = PM_CLI_PACKAGE_NAME.split("/");
+  const scopedDirectory = path3.join(packageRoot, "node_modules", scope);
+  const linkPath = path3.join(scopedDirectory, packageName);
+  await fs3.mkdir(scopedDirectory, { recursive: true });
+  await fs3.rm(linkPath, { recursive: true, force: true });
+  await fs3.symlink(hostPackageRoot, linkPath, resolveDirectorySymlinkType(process.platform));
+}
+function resolveDirectorySymlinkType(platform) {
+  return platform === "win32" ? "junction" : "dir";
 }
 function runtimeDependencyInstallSpecs(manifest) {
   const specs = /* @__PURE__ */ new Map();
@@ -760,7 +818,7 @@ function runtimeDependencyInstallSpecs(manifest) {
       continue;
     }
     for (const [name, version] of Object.entries(dependencyMap)) {
-      if (typeof version !== "string" || version.trim().length === 0 || specs.has(name)) {
+      if (name === PM_CLI_PACKAGE_NAME || typeof version !== "string" || version.trim().length === 0 || specs.has(name)) {
         continue;
       }
       specs.set(name, `${name}@${version.trim()}`);
@@ -1137,6 +1195,11 @@ function buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabula
       private: true,
       type: "module",
       keywords: ["pm-package"],
+      // `node --test` runs the colocated *.test.js sample against the peer SDK
+      // testing helpers; no extra dev-dependency or test runner is required.
+      scripts: {
+        test: "node --test"
+      },
       peerDependencies: {
         "@unbrained/pm-cli": "*"
       },
@@ -1154,15 +1217,42 @@ function buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabula
       }
     }, null, 2)}
 `;
+    const sampleTest = [
+      'import assert from "node:assert/strict";',
+      'import { test } from "node:test";',
+      'import { activateExtensionForTest, assertRegisteredCommandContract } from "@unbrained/pm-cli/sdk/testing";',
+      'import extension from "./index.js";',
+      "",
+      `test(${JSON.stringify(`${extensionName} registers its starter command`)}, async () => {`,
+      "  // `capabilities` mirrors manifest.json so the in-memory activation grants",
+      "  // the `commands` capability the entrypoint relies on.",
+      "  const activation = await activateExtensionForTest(extension, {",
+      `    name: ${JSON.stringify(extensionName)},`,
+      '    capabilities: ["commands"],',
+      "  });",
+      "  // assertRegisteredCommandContract throws if the command is not",
+      "  // registered, so reaching here already proves the wiring; assert on the",
+      "  // returned definition to demonstrate inspecting registered metadata.",
+      "  const registered = assertRegisteredCommandContract(activation.registrations, {",
+      `    command: ${JSON.stringify(commandName)},`,
+      `    extensionName: ${JSON.stringify(extensionName)},`,
+      "  });",
+      '  assert.equal(typeof registered.command.description, "string");',
+      "});",
+      ""
+    ].join("\n");
+    const gitignore = ["node_modules/", "*.log", ""].join("\n");
     const packageReadme = [
       `# ${packageName}`,
       "",
       "Generated by `pm package init`.",
       "",
       "## Included Files",
-      "- `package.json`: package metadata and `pm` resource manifest.",
+      "- `package.json`: package metadata, `test` script, and `pm` resource manifest.",
       "- `manifest.json`: extension metadata and capabilities.",
       "- `index.js`: starter command registration using the `commands` capability.",
+      "- `index.test.js`: sample `node:test` suite using the SDK testing helpers.",
+      "- `.gitignore`: ignores `node_modules/` and log files.",
       "",
       "## Quick Start",
       "```bash",
@@ -1171,6 +1261,15 @@ function buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabula
       "pm package doctor --project --detail summary",
       "```",
       "",
+      "## Validate the Package",
+      "Install the peer SDK once, then run the colocated sample test:",
+      "```bash",
+      "npm install",
+      "npm test",
+      "```",
+      "`npm test` runs `node --test`, which executes `index.test.js` against the",
+      "`@unbrained/pm-cli/sdk/testing` helpers \u2014 no extra test runner required.",
+      "",
       "## Compatibility Bounds",
       "`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:",
       `- \`manifest_version\` (integer): manifest schema generation. Leave at \`${SCAFFOLD_MANIFEST_VERSION}\` unless you adopt a newer manifest schema.`,
@@ -1188,6 +1287,8 @@ function buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabula
       "package.json": packageJson,
       "manifest.json": manifest,
       "index.js": entrypoint,
+      "index.test.js": sampleTest,
+      ".gitignore": gitignore,
       "README.md": packageReadme
     };
   }
@@ -2431,6 +2532,7 @@ async function runExtension(target, options, global) {
     const scaffoldTarget = requireTarget(normalizedTarget, action);
     const scaffold = await scaffoldExtensionProject(scaffoldTarget, options.vocabulary ?? "extension");
     const quotedTargetPath = JSON.stringify(scaffold.target_path);
+    const quotedShellTargetPath = JSON.stringify(scaffold.target_path.replace(/\\/g, "/"));
     return withResult({
       scaffolded: scaffold.created_directory || scaffold.files.some((entry) => entry.status === "created"),
       extension: {
@@ -2443,6 +2545,7 @@ async function runExtension(target, options, global) {
       next_steps: [
         `Install the scaffold: ${options.vocabulary === "package" ? "pm install --project" : "pm extension --install --project"} ${quotedTargetPath}`,
         `Smoke-test command path: pm ${scaffold.command_name}`,
+        ...options.vocabulary === "package" ? [`Validate the sample test: cd ${quotedShellTargetPath}, then run "npm install" and "npm test"`] : [],
         `Run diagnostics: ${options.vocabulary === "package" ? "pm package doctor" : "pm extension --doctor"} --project --detail summary`
       ]
     });
@@ -3171,6 +3274,6 @@ export {
   runExtension,
   _testOnly
 };
-//# sourceMappingURL=chunk-YWAYOWDQ.js.map
+//# sourceMappingURL=chunk-32R4PIC6.js.map
 
-//# debugId=22164ee8-de20-5c39-8e47-10a59c3f2d56
+//# debugId=5b1918c3-a3a1-53f2-b547-2724ff2a4f28