@unbrained/pm-cli 2026.6.20 → 2026.6.21

package/dist/cli-bundle/chunks/{chunk-E4E7UQBT.js → chunk-52OCIDPG.js}

@@ -8,7 +8,7 @@ import {
   createStdinTokenResolver,
   looksLikeGenericKeyValueEntry,
   parseCsvKv
-} from "./chunk-NCGQ27PK.js";
+} from "./chunk-Q2J2HJUN.js";
 import {
   splitCommaList
 } from "./chunk-P4SESZGT.js";
@@ -17,10 +17,10 @@ import {
   locateItem,
   mutateItem,
   readLocatedItem
-} from "./chunk-XKJDCJEH.js";
+} from "./chunk-NIUEXCFS.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-KCJZREBI.js";
+} from "./chunk-QZTWBFXJ.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -30,7 +30,7 @@ import {
   pathExists,
   readSettings,
   resolvePmRoot
-} from "./chunk-AZ75OVK4.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/cli/commands/linked-artifacts.js
 import fs from "node:fs/promises";
@@ -384,6 +384,6 @@ export {
   runLinkedArtifacts,
   renameArtifactsResultKey
 };
-//# sourceMappingURL=chunk-E4E7UQBT.js.map
+//# sourceMappingURL=chunk-52OCIDPG.js.map
 
 //# debugId=6d31ea9e-2717-5784-9868-be6e4ccfeaeb

package/dist/cli-bundle/chunks/{chunk-FA5O2DEG.js → chunk-5FIEHKEX.js}

@@ -12,15 +12,15 @@ import {
   readFirstStringFromCommanderOptions,
   readFirstValueFromCommanderOptions,
   readStringArrayFromCommanderOptions
-} from "./chunk-MFCFHL27.js";
+} from "./chunk-A4Z7ZOL5.js";
 import {
   refreshSearchArtifactsForMutation,
   shouldRunSearchRefreshInForeground
-} from "./chunk-4YMX7XFI.js";
+} from "./chunk-OTHIWLMB.js";
 import {
   printError,
   writeStdout
-} from "./chunk-F4EYOSNC.js";
+} from "./chunk-AIS5PGI3.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -29,7 +29,7 @@ import {
   readSettings,
   resolvePmRoot,
   setActiveCommandResult
-} from "./chunk-AZ75OVK4.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/cli/registration-helpers.js
 var RESOLVED_GLOBAL_OPTIONS = /* @__PURE__ */ Symbol("pm.resolvedGlobalOptions");
@@ -798,6 +798,6 @@ export {
   normalizeContextOptions,
   invalidateSearchCachesForMutation
 };
-//# sourceMappingURL=chunk-FA5O2DEG.js.map
+//# sourceMappingURL=chunk-5FIEHKEX.js.map
 
 //# debugId=b1b728b2-f5eb-5eb5-9515-7dee4ec31118

package/dist/cli-bundle/chunks/{chunk-2QJLN4KM.js → chunk-5IDI42VV.js}

@@ -1,21 +1,21 @@
 import {
   readHistoryEntries
-} from "./chunk-FBBPCSJM.js";
+} from "./chunk-RVHYI7SL.js";
 import {
   parseLimit
-} from "./chunk-VE3BUO3R.js";
+} from "./chunk-B473GZWW.js";
 import {
   enforceHistoryStreamPolicyForItems,
   listAllFrontMatterLight
-} from "./chunk-SL233DQD.js";
+} from "./chunk-SX75ADBK.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-XNQ3YH6N.js";
+} from "./chunk-FRUFKWNK.js";
 import {
   compareTimestampStrings,
   nowIso,
   resolveIsoOrRelative
-} from "./chunk-B3LROPTV.js";
+} from "./chunk-YCJX76PW.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -25,7 +25,7 @@ import {
   readSettings,
   resolvePmRoot,
   runActiveOnReadHooks
-} from "./chunk-QWAJPGEI.js";
+} from "./chunk-HMOADQVT.js";
 
 // dist/cli/commands/activity.js
 import fs from "node:fs/promises";
@@ -193,4 +193,4 @@ export {
   _testOnly,
   runActivity
 };
-//# sourceMappingURL=chunk-2QJLN4KM.js.map
+//# sourceMappingURL=chunk-5IDI42VV.js.map

package/dist/cli-bundle/chunks/{chunk-H3ZTSYPA.js → chunk-5PCI3UBT.js}

@@ -4,13 +4,13 @@ import {
   normalizeStringList,
   parseExtensionManifest,
   validateExtensionDirectory
-} from "./chunk-DKWIPIJY.js";
+} from "./chunk-CF55WVVS.js";
 import {
   splitCommaList
 } from "./chunk-5HIZDR5A.js";
 import {
   nowIso
-} from "./chunk-B3LROPTV.js";
+} from "./chunk-YCJX76PW.js";
 import {
   EXIT_CODE,
   EXTENSION_CAPABILITY_CONTRACT,
@@ -29,7 +29,7 @@ import {
   resolvePmPackageRootFromModule,
   resolvePmRoot,
   writeSettings
-} from "./chunk-QWAJPGEI.js";
+} from "./chunk-HMOADQVT.js";
 
 // dist/cli/commands/extension.js
 import { execFile as execFile2 } from "node:child_process";
@@ -1184,7 +1184,7 @@ import path5 from "node:path";
 !(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] = "c6f7e50f-9cce-50a2-97ec-7c06be6d85a1");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "3abac9c3-3fc0-575e-8f5d-d2624fe7a20c");
   } catch (e2) {
   }
 })();
@@ -1228,6 +1228,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": "*"
       },
@@ -1245,15 +1250,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",
@@ -1262,6 +1294,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.`,
@@ -1279,6 +1320,8 @@ function buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabula
       "package.json": packageJson,
       "manifest.json": manifest,
       "index.js": entrypoint,
+      "index.test.js": sampleTest,
+      ".gitignore": gitignore,
       "README.md": packageReadme
     };
   }
@@ -1829,7 +1872,7 @@ function buildDoctorConsistencySummary(scope, installedExtensions, loadedExtensi
 !(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] = "4c40a0ee-f2c1-5329-a52d-355491472f77");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "b0b28569-ac5e-5484-8ffb-a578de22fd15");
   } catch (e2) {
   }
 })();
@@ -2536,6 +2579,7 @@ async function runExtension(target, options, global2) {
     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: {
@@ -2548,6 +2592,7 @@ async function runExtension(target, options, global2) {
       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`
       ]
     });
@@ -3276,4 +3321,4 @@ export {
   runExtension,
   _testOnly
 };
-//# sourceMappingURL=chunk-H3ZTSYPA.js.map
+//# sourceMappingURL=chunk-5PCI3UBT.js.map