@unbrained/pm-cli 2026.6.22 → 2026.6.23

package/dist/cli-bundle/chunks/{chunk-GGAXE22C.js → chunk-5UVVASSA.js}

@@ -3,18 +3,18 @@
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-Y4BZEND6.js";
+} from "./chunk-S2RUQSX2.js";
 import {
   canonicalDocument,
   parseItemDocument,
   serializeItemDocument
-} from "./chunk-P7ZU73BO.js";
+} from "./chunk-VAYA4XFX.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-KK4TQ3ZP.js";
+} from "./chunk-YDEXO24S.js";
 import {
   nowIso
-} from "./chunk-PCH2JTEO.js";
+} from "./chunk-2T3JG6V4.js";
 import {
   EMPTY_CANONICAL_DOCUMENT,
   EXIT_CODE,
@@ -44,7 +44,7 @@ import {
   stableStringify,
   toErrorMessage,
   writeFileAtomic
-} from "./chunk-KL5ELX2X.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/core/extensions/item-fields.js
 var RESERVED_ITEM_FIELD_NAMES = new Set(FRONT_MATTER_KEY_ORDER);
@@ -1345,6 +1345,6 @@ export {
   mutateItem,
   deleteItem
 };
-//# sourceMappingURL=chunk-GGAXE22C.js.map
+//# sourceMappingURL=chunk-5UVVASSA.js.map
 
 //# debugId=5960bc7c-dc68-5ab2-b5b1-5d4dda400205

package/dist/cli-bundle/chunks/{chunk-25XZN3JD.js → chunk-5VOINNKT.js}

@@ -3,7 +3,7 @@ import {
   PmCliError,
   isPathWithinDirectory,
   pathExists
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/cli/commands/extension/shared.js
 import fs from "node:fs/promises";
@@ -115,4 +115,4 @@ export {
   parseExtensionManifest,
   validateExtensionDirectory
 };
-//# sourceMappingURL=chunk-25XZN3JD.js.map
+//# sourceMappingURL=chunk-5VOINNKT.js.map

package/dist/cli-bundle/chunks/{chunk-KRJJPDUO.js → chunk-66MEDTUD.js}

@@ -1,6 +1,6 @@
 import {
   toNonEmptyStringOrUndefined
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/core/governance/metadata-coverage.js
 !(function() {
@@ -270,4 +270,4 @@ export {
   computeMetadataCoverage,
   groupItemsByDimension
 };
-//# sourceMappingURL=chunk-KRJJPDUO.js.map
+//# sourceMappingURL=chunk-66MEDTUD.js.map

package/dist/cli-bundle/chunks/{chunk-MD7XKVWI.js → chunk-7AUB5HNA.js}

@@ -2,21 +2,21 @@ import {
   TYPE_PRESET_NAMES,
   normalizeTypePresetName,
   resolveTypePresetDefinitions
-} from "./chunk-A7E4ZXG2.js";
+} from "./chunk-SKH7OGE5.js";
 import {
   parseItemTypesFile,
   serializeItemTypesFile,
   upsertItemType
-} from "./chunk-75VEYQJS.js";
+} from "./chunk-XVF4YARA.js";
 import {
   runExtension
-} from "./chunk-7GCCDXXN.js";
+} from "./chunk-G6PYHBBR.js";
 import {
   normalizePrefix
-} from "./chunk-AJXYOYJV.js";
+} from "./chunk-7MRQ4HMK.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-3VLPDG3J.js";
+} from "./chunk-YJ3SUEPD.js";
 import {
   DEFAULT_RUNTIME_SCHEMA_FILE_PATHS,
   EXIT_CODE,
@@ -35,7 +35,7 @@ import {
   runActiveOnWriteHooks,
   writeFileAtomic,
   writeSettings
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/cli/commands/init.js
 import fs2 from "node:fs/promises";
@@ -846,4 +846,4 @@ export {
   _testOnly,
   runInit
 };
-//# sourceMappingURL=chunk-MD7XKVWI.js.map
+//# sourceMappingURL=chunk-7AUB5HNA.js.map

package/dist/cli-bundle/chunks/{chunk-TJABI6PR.js → chunk-7K2XXO4I.js}

@@ -3,13 +3,13 @@
 import {
   locateItem,
   readLocatedItem
-} from "./chunk-GGAXE22C.js";
+} from "./chunk-5UVVASSA.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-KK4TQ3ZP.js";
+} from "./chunk-YDEXO24S.js";
 import {
   nowIso
-} from "./chunk-PCH2JTEO.js";
+} from "./chunk-2T3JG6V4.js";
 import {
   coercePositiveInteger,
   getActiveExtensionRegistrations,
@@ -24,7 +24,7 @@ import {
   toNonEmptyString,
   trimTrailingSlashes,
   writeFileAtomic
-} from "./chunk-KL5ELX2X.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/core/search/http-client.js
 var DEFAULT_SEARCH_HTTP_TIMEOUT_MS = 3e4;
@@ -1929,6 +1929,6 @@ export {
   refreshSemanticEmbeddingsForMutatedItems,
   refreshSearchArtifactsForMutation
 };
-//# sourceMappingURL=chunk-TJABI6PR.js.map
+//# sourceMappingURL=chunk-7K2XXO4I.js.map
 
 //# debugId=e4dd61f7-7b30-57b1-b453-e99626f6b69a

package/dist/cli-bundle/chunks/{chunk-AJXYOYJV.js → chunk-7MRQ4HMK.js}

@@ -1,7 +1,7 @@
 import {
   TYPE_TO_FOLDER,
   pathExists
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/core/item/id.js
 import crypto from "node:crypto";
@@ -75,4 +75,4 @@ export {
   normalizeItemId,
   generateItemId
 };
-//# sourceMappingURL=chunk-AJXYOYJV.js.map
+//# sourceMappingURL=chunk-7MRQ4HMK.js.map

package/dist/cli-bundle/chunks/{chunk-THKDPOS5.js → chunk-7SV63ZHD.js}

@@ -10,33 +10,33 @@ import {
   hasMissingMetadataFilter,
   itemMatchesMissingMetadata,
   lifecycleClassifierFromStatusRegistry
-} from "./chunk-VB54F347.js";
+} from "./chunk-H4IIJDE4.js";
 import {
   parseIntegerLimit,
   parsePriority,
   parseType
-} from "./chunk-EVPVCE4R.js";
+} from "./chunk-WBRKK5QR.js";
 import {
   HEAVY_METADATA_KEYS,
   listAllFrontMatter,
   listAllFrontMatterLight,
   listAllFrontMatterWithBody,
   toItemRecord
-} from "./chunk-GGAXE22C.js";
+} from "./chunk-5UVVASSA.js";
 import {
   coerceRuntimeFieldValue,
   isTerminalStatus,
   normalizeStatusInput,
   readRuntimeFieldOptionValue
-} from "./chunk-P7ZU73BO.js";
+} from "./chunk-VAYA4XFX.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-KK4TQ3ZP.js";
+} from "./chunk-YDEXO24S.js";
 import {
   compareTimestampStrings,
   nowIso,
   resolveIsoOrRelative
-} from "./chunk-PCH2JTEO.js";
+} from "./chunk-2T3JG6V4.js";
 import {
   EXIT_CODE,
   FRONT_MATTER_KEY_ORDER,
@@ -50,7 +50,7 @@ import {
   resolveRuntimeFieldRegistry,
   resolveRuntimeStatusRegistry,
   stableValueEquals
-} from "./chunk-KL5ELX2X.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/core/item/status-filter.js
 var STATUS_GROUP_ALIASES = {
@@ -931,6 +931,6 @@ export {
   runList,
   _testOnly
 };
-//# sourceMappingURL=chunk-THKDPOS5.js.map
+//# sourceMappingURL=chunk-7SV63ZHD.js.map
 
 //# debugId=abc604da-ab3e-5d0e-b958-a91614dfbbcd

package/dist/cli-bundle/chunks/{chunk-7MALIV5H.js → chunk-7UGEAPRY.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-WW4E2DC3.js";
 import {
   readHistoryEntries
-} from "./chunk-YRLLL5TY.js";
+} from "./chunk-BB6MDVNQ.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   normalizeReplayPatchOps,
@@ -11,7 +11,7 @@ import {
   replayToCanonicalItemDocument,
   replayToItemDocument,
   toReplayDocument
-} from "./chunk-J2TSPY5L.js";
+} from "./chunk-UVC5LOR7.js";
 import {
   acquireLock,
   appendHistoryEntry,
@@ -19,21 +19,21 @@ import {
   enforceHistoryStreamPolicyForItem,
   locateItem,
   readLocatedItem
-} from "./chunk-GNDHOR64.js";
+} from "./chunk-IPKJ6B36.js";
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-AJXYOYJV.js";
+} from "./chunk-7MRQ4HMK.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-CR7KFPAQ.js";
+} from "./chunk-NCVCO3NZ.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-3VLPDG3J.js";
+} from "./chunk-YJ3SUEPD.js";
 import {
   nowIso
-} from "./chunk-4JXWVHMN.js";
+} from "./chunk-P77P2ILI.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -49,7 +49,7 @@ import {
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/cli/commands/restore.js
 import jsonPatch from "fast-json-patch";
@@ -391,4 +391,4 @@ export {
   runRestore,
   _testOnlyRestoreCommand
 };
-//# sourceMappingURL=chunk-7MALIV5H.js.map
+//# sourceMappingURL=chunk-7UGEAPRY.js.map

package/dist/cli-bundle/chunks/{chunk-TIKJAXQW.js → chunk-7XGQXHFB.js}

@@ -3,7 +3,7 @@
 import {
   parseItemDocument,
   serializeItemDocument
-} from "./chunk-P7ZU73BO.js";
+} from "./chunk-VAYA4XFX.js";
 import {
   TYPE_TO_FOLDER,
   getItemFormatFromPath,
@@ -12,7 +12,7 @@ import {
   removeFileIfExists,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-KL5ELX2X.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/core/store/item-format-migration.js
 import fs from "node:fs/promises";
@@ -114,6 +114,6 @@ async function migrateItemFilesToFormat(pmRoot, targetFormat, op = "item_format:
 export {
   migrateItemFilesToFormat
 };
-//# sourceMappingURL=chunk-TIKJAXQW.js.map
+//# sourceMappingURL=chunk-7XGQXHFB.js.map
 
 //# debugId=cc3f7b67-0ee9-5ac6-b79b-74b3d34cb9e2

package/dist/cli-bundle/chunks/{chunk-YJICYNAV.js → chunk-AD3A7ZD6.js}

@@ -5,26 +5,26 @@ import {
   normalizeReplayPatchOps,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-YQSWTVZF.js";
+} from "./chunk-WM5ZVBPE.js";
 import {
   parseLimit
-} from "./chunk-EVPVCE4R.js";
+} from "./chunk-WBRKK5QR.js";
 import {
   enforceHistoryStreamPolicyForItem,
   hashDocument,
   hashEmptyDocument,
   locateItem,
   readLocatedItem
-} from "./chunk-GGAXE22C.js";
+} from "./chunk-5UVVASSA.js";
 import {
   normalizeItemId
-} from "./chunk-Y4BZEND6.js";
+} from "./chunk-S2RUQSX2.js";
 import {
   findFirstMergeConflictMarker
-} from "./chunk-P7ZU73BO.js";
+} from "./chunk-VAYA4XFX.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-KK4TQ3ZP.js";
+} from "./chunk-YDEXO24S.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -36,7 +36,7 @@ import {
   readSettings,
   resolvePmRoot,
   runActiveOnReadHooks
-} from "./chunk-KL5ELX2X.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/core/history/history-diff.js
 function decodeJsonPointerSegment(segment) {
@@ -264,6 +264,6 @@ export {
   readHistoryEntries,
   runHistory
 };
-//# sourceMappingURL=chunk-YJICYNAV.js.map
+//# sourceMappingURL=chunk-AD3A7ZD6.js.map
 
 //# debugId=bcfc5ee3-530b-5b04-8b4c-6510049c5b19

package/dist/cli-bundle/chunks/{chunk-FK6MV5F5.js → chunk-AONIHR2C.js}

@@ -1,6 +1,6 @@
 import {
   runClose
-} from "./chunk-H6FNDCDI.js";
+} from "./chunk-SKN7LC5W.js";
 import {
   assertNoLegacyNoneToken,
   assertNoLegacyNoneTokens,
@@ -18,7 +18,7 @@ import {
   parseTests,
   parseTypeOptionEntries,
   resolvePriority
-} from "./chunk-V4SM4UAL.js";
+} from "./chunk-JR2LV3M4.js";
 import {
   applyTagRemovals,
   assertNoUnknownCsvKeys,
@@ -28,15 +28,15 @@ import {
   parseCsvKv,
   parseOptionalNumber,
   parseTags
-} from "./chunk-CWPBGUC7.js";
+} from "./chunk-FXR67XVQ.js";
 import {
   normalizeParentReferenceValue,
   validateMissingParentReference,
   validateSprintOrReleaseValue
-} from "./chunk-TZQKEBKF.js";
+} from "./chunk-34EONI5F.js";
 import {
   buildInvalidTypeError
-} from "./chunk-75VEYQJS.js";
+} from "./chunk-XVF4YARA.js";
 import {
   applyRegisteredItemFieldDefaultsAndValidation,
   buildItemNotFoundError,
@@ -46,14 +46,14 @@ import {
   parseRegisteredItemFieldAssignments,
   readLocatedItem,
   toItemRecord
-} from "./chunk-GNDHOR64.js";
+} from "./chunk-IPKJ6B36.js";
 import {
   normalizeItemId
-} from "./chunk-AJXYOYJV.js";
+} from "./chunk-7MRQ4HMK.js";
 import {
   collectRuntimeUpdateFieldValues,
   normalizeStatusInput
-} from "./chunk-CR7KFPAQ.js";
+} from "./chunk-NCVCO3NZ.js";
 import {
   canonicalizeCommandOptionKey,
   commandOptionFlagLabel,
@@ -62,10 +62,10 @@ import {
   resolveTypeDefinition,
   resolveTypeName,
   validateTypeOptions
-} from "./chunk-3VLPDG3J.js";
+} from "./chunk-YJ3SUEPD.js";
 import {
   resolveIsoOrRelative
-} from "./chunk-4JXWVHMN.js";
+} from "./chunk-P77P2ILI.js";
 import {
   DEPENDENCY_KIND_VALUES,
   EXIT_CODE,
@@ -81,7 +81,7 @@ import {
   resolveRuntimeFieldRegistry,
   resolveRuntimeStatusRegistry,
   stableValueEquals
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/core/schema/type-workflows.js
 !(function() {
@@ -1806,4 +1806,4 @@ export {
   runUpdate,
   _testOnlyUpdateCommand
 };
-//# sourceMappingURL=chunk-FK6MV5F5.js.map
+//# sourceMappingURL=chunk-AONIHR2C.js.map

package/dist/cli-bundle/chunks/{chunk-YRLLL5TY.js → chunk-BB6MDVNQ.js}

@@ -3,26 +3,26 @@ import {
   normalizeReplayPatchOps,
   tryApplyReplayPatch,
   verifyHistoryChain
-} from "./chunk-J2TSPY5L.js";
+} from "./chunk-UVC5LOR7.js";
 import {
   parseLimit
-} from "./chunk-PJS2J7Z4.js";
+} from "./chunk-T5472OMV.js";
 import {
   enforceHistoryStreamPolicyForItem,
   hashDocument,
   hashEmptyDocument,
   locateItem,
   readLocatedItem
-} from "./chunk-GNDHOR64.js";
+} from "./chunk-IPKJ6B36.js";
 import {
   normalizeItemId
-} from "./chunk-AJXYOYJV.js";
+} from "./chunk-7MRQ4HMK.js";
 import {
   findFirstMergeConflictMarker
-} from "./chunk-CR7KFPAQ.js";
+} from "./chunk-NCVCO3NZ.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-3VLPDG3J.js";
+} from "./chunk-YJ3SUEPD.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -34,7 +34,7 @@ import {
   readSettings,
   resolvePmRoot,
   runActiveOnReadHooks
-} from "./chunk-RZZMSY4P.js";
+} from "./chunk-MJTSZKK5.js";
 
 // dist/core/history/history-diff.js
 !(function() {
@@ -276,4 +276,4 @@ export {
   readHistoryEntries,
   runHistory
 };
-//# sourceMappingURL=chunk-YRLLL5TY.js.map
+//# sourceMappingURL=chunk-BB6MDVNQ.js.map

package/dist/cli-bundle/chunks/{chunk-3GL6LTUL.js → chunk-C5AOG6D2.js}

@@ -1,13 +1,13 @@
 
-!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]="d666bfbb-94ee-5886-993c-ca3e13327017")}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]="3f18c01e-ca66-5960-9c35-194a3ad7d38c")}catch(e){}}();
 import {
   normalizeManagedDirectoryName
-} from "./chunk-DMT4ODVN.js";
+} from "./chunk-4BHT5VDC.js";
 import {
   EXIT_CODE,
   PmCliError,
   pathExists
-} from "./chunk-KL5ELX2X.js";
+} from "./chunk-UELRKQQU.js";
 
 // dist/cli/commands/extension/scaffold.js
 import fs from "node:fs/promises";
@@ -484,6 +484,45 @@ function buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabula
     const sampleTest = buildSampleTestSource(extensionName, commandName, capability);
     const sampleTestBullet = SAMPLE_TEST_BULLETS[capability];
     const gitignore = ["node_modules/", "*.log", ""].join("\n");
+    const searchProviderName = `${extensionName}-search`;
+    const vectorAdapterName = `${extensionName}-vector`;
+    const adapterName = `${extensionName.replace(/-/g, " ")} items`;
+    const defineBuilderImports = [
+      "defineCommand",
+      ...capability === "hooks" ? ["defineAfterCommandHook"] : [],
+      ...capability === "search" ? ["defineSearchProvider", "defineVectorStoreAdapter"] : [],
+      ...capability === "importers" ? ["defineImporter", "defineExporter"] : []
+    ].join(", ");
+    const defineBuilderSnippet = [
+      "```js",
+      `import { ${defineBuilderImports} } from "@unbrained/pm-cli/sdk";`,
+      "",
+      "export const pingCommand = defineCommand({",
+      `  name: ${JSON.stringify(commandName)},`,
+      '  description: "Starter scaffold command. Replace with your own behavior.",',
+      "  run: (context) => ({ ok: true, command: context.command }),",
+      "});"
+    ];
+    if (capability === "hooks") {
+      defineBuilderSnippet.push("", "export const afterCommandHook = defineAfterCommandHook((context) => {", "  if (!context.ok) return;", "  // React to context.affected here as your package grows.", "});");
+    }
+    if (capability === "search") {
+      defineBuilderSnippet.push("", "export const searchProvider = defineSearchProvider({", `  name: ${JSON.stringify(searchProviderName)},`, "  query: async (context) => ({", "    hits: context.documents", '      .filter((document) => String(document.metadata.title ?? "").toLowerCase().includes(context.query.toLowerCase()))', '      .map((document) => ({ id: document.metadata.id, score: 1, matched_fields: ["title"] })),', "  }),", "  embed: async (context) => [context.input.length],", "});", "", "export const vectorStoreAdapter = defineVectorStoreAdapter({", `  name: ${JSON.stringify(vectorAdapterName)},`, '  query: async (context) => [{ id: "starter-vector-hit", score: context.limit }],', "  upsert: async (context) => ({ upserted: context.points.length }),", "  delete: async (context) => ({ deleted: context.ids.length }),", "});");
+    }
+    if (capability === "importers") {
+      defineBuilderSnippet.push("", "export const importer = defineImporter(async (context) => ({", "  imported: 1,", '  source: context.options.source ?? "starter",', "  args: context.args,", "}));", "", "export const exporter = defineExporter(async (context) => ({", "  exported: true,", '  destination: context.options.destination ?? "stdout",', "  args: context.args,", "}));");
+    }
+    defineBuilderSnippet.push("", "export function activate(api) {", "  api.registerCommand(pingCommand);");
+    if (capability === "hooks") {
+      defineBuilderSnippet.push("  api.hooks.afterCommand(afterCommandHook);");
+    }
+    if (capability === "search") {
+      defineBuilderSnippet.push("  api.registerSearchProvider(searchProvider);", "  api.registerVectorStoreAdapter(vectorStoreAdapter);");
+    }
+    if (capability === "importers") {
+      defineBuilderSnippet.push(`  api.registerImporter(${JSON.stringify(adapterName)}, importer, {`, `    action: ${JSON.stringify(`${adapterName} import`)},`, '    description: "Import starter records into pm context.",', "    flags: [", "      {", '        long: "--source",', '        value_name: "name",', '        value_type: "string",', '        description: "Source name or path to import from.",', "      },", "    ],", "  });", `  api.registerExporter(${JSON.stringify(adapterName)}, exporter, {`, `    action: ${JSON.stringify(`${adapterName} export`)},`, '    description: "Export pm context into starter records.",', "    flags: [", "      {", '        long: "--destination",', '        value_name: "name",', '        value_type: "string",', '        description: "Destination name or path to export to.",', "      },", "    ],", "  });");
+    }
+    defineBuilderSnippet.push("}", "", "export function deactivate() {}", "", "export default { activate, deactivate };", "```");
     const packageReadme = [
       `# ${packageName}`,
       "",
@@ -511,6 +550,15 @@ function buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabula
       "```",
       "`npm test` runs `node --test`, which executes `index.test.js` against the",
       "`@unbrained/pm-cli/sdk/testing` helpers - no extra test runner required.",
+      "",
+      "## Authoring With define* Builders",
+      "`index.js` stays import-free so the package can be installed locally before",
+      "`npm install` materializes peer dependencies. After installing dependencies,",
+      "use the public SDK authoring builders for exported definitions you want",
+      "editor type-checking, contextual handler inference, and direct unit tests for:",
+      ...defineBuilderSnippet,
+      "The builders return their argument unchanged; runtime validation still lives",
+      "in `api.register*`, and behavior validation lives in `sdk/testing`.",
       ...PACKAGE_CAPABILITY_README_SECTIONS[capability],
       "",
       "## Compatibility Bounds",
@@ -638,6 +686,6 @@ export {
   SCAFFOLD_CAPABILITIES,
   scaffoldExtensionProject
 };
-//# sourceMappingURL=chunk-3GL6LTUL.js.map
+//# sourceMappingURL=chunk-C5AOG6D2.js.map
 
-//# debugId=d666bfbb-94ee-5886-993c-ca3e13327017
+//# debugId=3f18c01e-ca66-5960-9c35-194a3ad7d38c