@unbrained/pm-cli 2026.6.20 → 2026.6.21

package/dist/cli-bundle/chunks/activity-CIHV64UC.js

@@ -0,0 +1,18 @@
+import {
+  _testOnly,
+  runActivity
+} from "./chunk-5IDI42VV.js";
+import "./chunk-RVHYI7SL.js";
+import "./chunk-HIP7WVTL.js";
+import "./chunk-B473GZWW.js";
+import "./chunk-SX75ADBK.js";
+import "./chunk-7D3SAQXM.js";
+import "./chunk-QGG32QHW.js";
+import "./chunk-FRUFKWNK.js";
+import "./chunk-YCJX76PW.js";
+import "./chunk-HMOADQVT.js";
+export {
+  _testOnly,
+  runActivity
+};
+//# sourceMappingURL=activity-CIHV64UC.js.map

package/dist/cli-bundle/chunks/{activity-KEEITOTB.js → activity-KW3IRP44.js}

@@ -3,20 +3,20 @@
 import {
   _testOnly,
   runActivity
-} from "./chunk-5XK2RYJR.js";
-import "./chunk-EKMHDL6Z.js";
-import "./chunk-WMQBNVZL.js";
-import "./chunk-CNPWCUDR.js";
-import "./chunk-XKJDCJEH.js";
-import "./chunk-K2LBDYDC.js";
-import "./chunk-FSOJCFDS.js";
-import "./chunk-KCJZREBI.js";
-import "./chunk-MTQK5ZSB.js";
-import "./chunk-AZ75OVK4.js";
+} from "./chunk-F5NZWFSW.js";
+import "./chunk-UEMNL33O.js";
+import "./chunk-Z6T4PQI2.js";
+import "./chunk-C4N5I7ZW.js";
+import "./chunk-NIUEXCFS.js";
+import "./chunk-D7FYS6PG.js";
+import "./chunk-LEU5GHRC.js";
+import "./chunk-QZTWBFXJ.js";
+import "./chunk-NSBZ2CKF.js";
+import "./chunk-434HM6Z5.js";
 export {
   _testOnly,
   runActivity
 };
-//# sourceMappingURL=activity-KEEITOTB.js.map
+//# sourceMappingURL=activity-KW3IRP44.js.map
 
 //# debugId=45eac7fa-f181-5cca-93b7-cfb58909dbb3

package/dist/cli-bundle/chunks/{aggregate-GB2LJNTZ.js → aggregate-3ZKQG5SW.js}

@@ -6,26 +6,26 @@ import {
 } from "./chunk-5HIZDR5A.js";
 import {
   runList
-} from "./chunk-WFOITX4A.js";
+} from "./chunk-6ZXM2XNF.js";
 import "./chunk-R23CSHGI.js";
-import "./chunk-7MMXBIRZ.js";
-import "./chunk-VE3BUO3R.js";
-import "./chunk-SL233DQD.js";
-import "./chunk-ZHCSGIUX.js";
+import "./chunk-NIGXMNNI.js";
+import "./chunk-B473GZWW.js";
+import "./chunk-SX75ADBK.js";
+import "./chunk-7D3SAQXM.js";
 import {
   normalizeStatusInput
-} from "./chunk-5MWA46UN.js";
-import "./chunk-XNQ3YH6N.js";
+} from "./chunk-QGG32QHW.js";
+import "./chunk-FRUFKWNK.js";
 import {
   nowIso
-} from "./chunk-B3LROPTV.js";
+} from "./chunk-YCJX76PW.js";
 import {
   EXIT_CODE,
   PmCliError,
   readSettings,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-QWAJPGEI.js";
+} from "./chunk-HMOADQVT.js";
 
 // dist/cli/commands/aggregate.js
 !(function() {
@@ -346,4 +346,4 @@ export {
   _testOnlyAggregateCommand,
   runAggregate
 };
-//# sourceMappingURL=aggregate-GB2LJNTZ.js.map
+//# sourceMappingURL=aggregate-3ZKQG5SW.js.map

package/dist/cli-bundle/chunks/{aggregate-5BTHOHW2.js → aggregate-FIGQEIL3.js}

@@ -8,26 +8,26 @@ import {
 } from "./chunk-P4SESZGT.js";
 import {
   runList
-} from "./chunk-X3CD2VUI.js";
+} from "./chunk-EBH56IXK.js";
 import "./chunk-QB7XMHJW.js";
-import "./chunk-6KARQMC6.js";
-import "./chunk-CNPWCUDR.js";
-import "./chunk-XKJDCJEH.js";
-import "./chunk-K2LBDYDC.js";
+import "./chunk-CZUB4XWO.js";
+import "./chunk-C4N5I7ZW.js";
+import "./chunk-NIUEXCFS.js";
+import "./chunk-D7FYS6PG.js";
 import {
   normalizeStatusInput
-} from "./chunk-FSOJCFDS.js";
-import "./chunk-KCJZREBI.js";
+} from "./chunk-LEU5GHRC.js";
+import "./chunk-QZTWBFXJ.js";
 import {
   nowIso
-} from "./chunk-MTQK5ZSB.js";
+} from "./chunk-NSBZ2CKF.js";
 import {
   EXIT_CODE,
   PmCliError,
   readSettings,
   resolvePmRoot,
   resolveRuntimeStatusRegistry
-} from "./chunk-AZ75OVK4.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/cli/commands/aggregate.js
 var AGGREGATE_GROUP_FIELDS = [
@@ -341,6 +341,6 @@ export {
   _testOnlyAggregateCommand,
   runAggregate
 };
-//# sourceMappingURL=aggregate-5BTHOHW2.js.map
+//# sourceMappingURL=aggregate-FIGQEIL3.js.map
 
 //# debugId=52b0a3d1-3745-564a-8059-58b747c77cb3

package/dist/cli-bundle/chunks/{append-BBM4MNVD.js → append-EWJYJ7CH.js}

@@ -5,15 +5,15 @@ import {
 } from "./chunk-T5RRNDA7.js";
 import {
   createStdinTokenResolver
-} from "./chunk-NCGQ27PK.js";
+} from "./chunk-Q2J2HJUN.js";
 import {
   mutateItem,
   toItemRecord
-} from "./chunk-XKJDCJEH.js";
-import "./chunk-K2LBDYDC.js";
-import "./chunk-FSOJCFDS.js";
-import "./chunk-KCJZREBI.js";
-import "./chunk-MTQK5ZSB.js";
+} from "./chunk-NIUEXCFS.js";
+import "./chunk-D7FYS6PG.js";
+import "./chunk-LEU5GHRC.js";
+import "./chunk-QZTWBFXJ.js";
+import "./chunk-NSBZ2CKF.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -21,7 +21,7 @@ import {
   pathExists,
   readSettings,
   resolvePmRoot
-} from "./chunk-AZ75OVK4.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/cli/commands/append.js
 async function runAppend(id, options, global) {
@@ -64,6 +64,6 @@ async function runAppend(id, options, global) {
 export {
   runAppend
 };
-//# sourceMappingURL=append-BBM4MNVD.js.map
+//# sourceMappingURL=append-EWJYJ7CH.js.map
 
 //# debugId=67a77049-8f98-5301-bd39-68896d2c887d

package/dist/cli-bundle/chunks/{append-BFV5UYWS.js → append-QEOLX3XB.js}

@@ -3,15 +3,15 @@ import {
 } from "./chunk-WW4E2DC3.js";
 import {
   createStdinTokenResolver
-} from "./chunk-4PW4C3ZB.js";
+} from "./chunk-UV6IYE5U.js";
 import {
   mutateItem,
   toItemRecord
-} from "./chunk-SL233DQD.js";
-import "./chunk-ZHCSGIUX.js";
-import "./chunk-5MWA46UN.js";
-import "./chunk-XNQ3YH6N.js";
-import "./chunk-B3LROPTV.js";
+} from "./chunk-SX75ADBK.js";
+import "./chunk-7D3SAQXM.js";
+import "./chunk-QGG32QHW.js";
+import "./chunk-FRUFKWNK.js";
+import "./chunk-YCJX76PW.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -19,7 +19,7 @@ import {
   pathExists,
   readSettings,
   resolvePmRoot
-} from "./chunk-QWAJPGEI.js";
+} from "./chunk-HMOADQVT.js";
 
 // dist/cli/commands/append.js
 !(function() {
@@ -69,4 +69,4 @@ async function runAppend(id, options, global2) {
 export {
   runAppend
 };
-//# sourceMappingURL=append-BFV5UYWS.js.map
+//# sourceMappingURL=append-QEOLX3XB.js.map

package/dist/cli-bundle/chunks/{chunk-RICT5QYR.js → chunk-2EIMPCE4.js}

@@ -2,10 +2,10 @@
 !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]="be0afc71-fb35-553a-bad4-2a34c72a8d48")}catch(e){}}();
 import {
   toDefaultFolder
-} from "./chunk-KCJZREBI.js";
+} from "./chunk-QZTWBFXJ.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES
-} from "./chunk-AZ75OVK4.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/core/schema/item-types-file.js
 var BUILTIN_NAME_LOOKUP = new Map(BUILTIN_ITEM_TYPE_VALUES.map((name) => [name.toLowerCase(), name]));
@@ -257,6 +257,6 @@ export {
   buildInvalidTypeHint,
   buildInvalidTypeError
 };
-//# sourceMappingURL=chunk-RICT5QYR.js.map
+//# sourceMappingURL=chunk-2EIMPCE4.js.map
 
 //# debugId=be0afc71-fb35-553a-bad4-2a34c72a8d48

package/dist/cli-bundle/chunks/{chunk-ZYG4TR32.js → chunk-2GCDRRIF.js}

@@ -2,7 +2,7 @@
 !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]="8a654bfc-1cd8-530f-9195-0e10479a4c7c")}catch(e){}}();
 import {
   runClose
-} from "./chunk-FXKPUMIR.js";
+} from "./chunk-PP2U4NMT.js";
 import {
   assertNoLegacyNoneToken,
   assertNoLegacyNoneTokens,
@@ -20,7 +20,7 @@ import {
   parseTests,
   parseTypeOptionEntries,
   resolvePriority
-} from "./chunk-W2ZESOQE.js";
+} from "./chunk-C3AZ5ZML.js";
 import {
   applyTagRemovals,
   assertNoUnknownCsvKeys,
@@ -30,15 +30,15 @@ import {
   parseCsvKv,
   parseOptionalNumber,
   parseTags
-} from "./chunk-NCGQ27PK.js";
+} from "./chunk-Q2J2HJUN.js";
 import {
   normalizeParentReferenceValue,
   validateMissingParentReference,
   validateSprintOrReleaseValue
-} from "./chunk-XXGAWTH5.js";
+} from "./chunk-PUH4D67U.js";
 import {
   buildInvalidTypeError
-} from "./chunk-RICT5QYR.js";
+} from "./chunk-2EIMPCE4.js";
 import {
   applyRegisteredItemFieldDefaultsAndValidation,
   buildItemNotFoundError,
@@ -48,14 +48,14 @@ import {
   parseRegisteredItemFieldAssignments,
   readLocatedItem,
   toItemRecord
-} from "./chunk-XKJDCJEH.js";
+} from "./chunk-NIUEXCFS.js";
 import {
   normalizeItemId
-} from "./chunk-K2LBDYDC.js";
+} from "./chunk-D7FYS6PG.js";
 import {
   collectRuntimeUpdateFieldValues,
   normalizeStatusInput
-} from "./chunk-FSOJCFDS.js";
+} from "./chunk-LEU5GHRC.js";
 import {
   canonicalizeCommandOptionKey,
   commandOptionFlagLabel,
@@ -64,10 +64,10 @@ import {
   resolveTypeDefinition,
   resolveTypeName,
   validateTypeOptions
-} from "./chunk-KCJZREBI.js";
+} from "./chunk-QZTWBFXJ.js";
 import {
   resolveIsoOrRelative
-} from "./chunk-MTQK5ZSB.js";
+} from "./chunk-NSBZ2CKF.js";
 import {
   DEPENDENCY_KIND_VALUES,
   EXIT_CODE,
@@ -83,7 +83,7 @@ import {
   resolveRuntimeFieldRegistry,
   resolveRuntimeStatusRegistry,
   stableValueEquals
-} from "./chunk-AZ75OVK4.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/core/schema/type-workflows.js
 function normalizeStatusToken(value) {
@@ -1794,6 +1794,6 @@ export {
   runUpdate,
   _testOnlyUpdateCommand
 };
-//# sourceMappingURL=chunk-ZYG4TR32.js.map
+//# sourceMappingURL=chunk-2GCDRRIF.js.map
 
 //# debugId=8a654bfc-1cd8-530f-9195-0e10479a4c7c

package/dist/cli-bundle/chunks/{chunk-DYOJJTCG.js → chunk-2PKHRP6G.js}

@@ -13,7 +13,7 @@ import {
   resolveSearchCorpusFields,
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores
-} from "./chunk-ETJKPURB.js";
+} from "./chunk-NB3PYLQ6.js";
 import {
   buildContentFilterEcho,
   buildGovernanceMissingFilterEcho,
@@ -23,7 +23,7 @@ import {
   parseStatusFilterCsv,
   resolveContentFieldFilters,
   resolveMissingMetadataFilters
-} from "./chunk-WFOITX4A.js";
+} from "./chunk-6ZXM2XNF.js";
 import {
   hasContentFieldFilter,
   itemMatchesContentFilters
@@ -32,30 +32,30 @@ import {
   hasMissingMetadataFilter,
   itemMatchesMissingMetadata,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-7MMXBIRZ.js";
+} from "./chunk-NIGXMNNI.js";
 import {
   parseLimit,
   parsePriority,
   parseType
-} from "./chunk-VE3BUO3R.js";
+} from "./chunk-B473GZWW.js";
 import {
   collectRegisteredItemFieldNames,
   listAllDocumentCandidatesCached,
   listAllFrontMatter,
   toItemRecord
-} from "./chunk-SL233DQD.js";
+} from "./chunk-SX75ADBK.js";
 import {
   isTerminalStatus,
   parseItemDocument
-} from "./chunk-5MWA46UN.js";
+} from "./chunk-QGG32QHW.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,
@@ -74,7 +74,7 @@ import {
   runActiveOnReadHooks,
   toNonEmptyString,
   toNonEmptyStringOrUndefined
-} from "./chunk-QWAJPGEI.js";
+} from "./chunk-HMOADQVT.js";
 
 // dist/cli/commands/search.js
 import fs from "node:fs/promises";
@@ -2228,4 +2228,4 @@ export {
   resolveSearchTuning,
   runSearch
 };
-//# sourceMappingURL=chunk-DYOJJTCG.js.map
+//# sourceMappingURL=chunk-2PKHRP6G.js.map

package/dist/cli-bundle/chunks/{chunk-LTUB7ARL.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]="0b7f7865-bed4-596b-a8fb-f30d5c0b1923")}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-6FSPWUBI.js";
+} from "./chunk-SRYYRVPB.js";
 import {
   splitCommaList
 } from "./chunk-P4SESZGT.js";
 import {
   nowIso
-} from "./chunk-MTQK5ZSB.js";
+} from "./chunk-NSBZ2CKF.js";
 import {
   EXIT_CODE,
   EXTENSION_CAPABILITY_CONTRACT,
@@ -31,7 +31,7 @@ import {
   resolvePmPackageRootFromModule,
   resolvePmRoot,
   writeSettings
-} from "./chunk-AZ75OVK4.js";
+} from "./chunk-434HM6Z5.js";
 
 // dist/cli/commands/extension.js
 import { execFile as execFile2 } from "node:child_process";
@@ -1195,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": "*"
       },
@@ -1212,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",
@@ -1229,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.`,
@@ -1246,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
     };
   }
@@ -2489,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: {
@@ -2501,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`
       ]
     });
@@ -3229,6 +3274,6 @@ export {
   runExtension,
   _testOnly
 };
-//# sourceMappingURL=chunk-LTUB7ARL.js.map
+//# sourceMappingURL=chunk-32R4PIC6.js.map
 
-//# debugId=0b7f7865-bed4-596b-a8fb-f30d5c0b1923
+//# debugId=5b1918c3-a3a1-53f2-b547-2724ff2a4f28