@unbrained/pm-cli 2026.7.3 → 2026.7.4

package/dist/cli-bundle/chunks/{chunk-6KRFL33E.js → chunk-CN4OAA2G.js}

@@ -2,11 +2,11 @@ import {
   canonicalDocument,
   parseItemDocument,
   serializeItemDocument
-} from "./chunk-3W2HJKJX.js";
+} from "./chunk-CQFZRLXQ.js";
 import {
   evictOldestMemoEntries,
   nowIso
-} from "./chunk-AJHYQCBJ.js";
+} from "./chunk-MZG6I2Q2.js";
 import {
   EMPTY_CANONICAL_DOCUMENT,
   EXIT_CODE,
@@ -37,7 +37,7 @@ import {
   stableStringify,
   toErrorMessage,
   writeFileAtomic
-} from "./chunk-KHVGM5CS.js";
+} from "./chunk-BDDYM4LH.js";
 
 // dist/core/extensions/item-fields.js
 !(function() {
@@ -1588,4 +1588,4 @@ export {
   mutateItem,
   deleteItem
 };
-//# sourceMappingURL=chunk-6KRFL33E.js.map
+//# sourceMappingURL=chunk-CN4OAA2G.js.map

package/dist/cli-bundle/chunks/{chunk-3W2HJKJX.js → chunk-CQFZRLXQ.js}

@@ -1,7 +1,7 @@
 import {
   compareTimestampStrings,
   isTimestampLiteral
-} from "./chunk-AJHYQCBJ.js";
+} from "./chunk-MZG6I2Q2.js";
 import {
   CONFIDENCE_TEXT_VALUES,
   EXIT_CODE,
@@ -18,7 +18,7 @@ import {
   resolveRuntimeStatusRegistry,
   runtimeFieldOptionTarget,
   weekdayOrderIndex
-} from "./chunk-KHVGM5CS.js";
+} from "./chunk-BDDYM4LH.js";
 
 // dist/core/schema/runtime-field-values.js
 !(function() {
@@ -1534,4 +1534,4 @@ export {
   serializeItemDocument,
   canonicalDocument
 };
-//# sourceMappingURL=chunk-3W2HJKJX.js.map
+//# sourceMappingURL=chunk-CQFZRLXQ.js.map

package/dist/cli-bundle/chunks/{chunk-K5DT2YKM.js → chunk-CQISNF3Z.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-WW4E2DC3.js";
 import {
   readHistoryEntries
-} from "./chunk-Z5F6XZXE.js";
+} from "./chunk-EB4BBEZD.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   normalizeReplayPatchOps,
@@ -11,7 +11,7 @@ import {
   replayToCanonicalItemDocument,
   replayToItemDocument,
   toReplayDocument
-} from "./chunk-T4XBKJ3F.js";
+} from "./chunk-HL742IBM.js";
 import {
   acquireLock,
   appendHistoryEntry,
@@ -21,14 +21,14 @@ import {
   normalizeItemId,
   normalizeRawItemId,
   readLocatedItem
-} from "./chunk-6KRFL33E.js";
+} from "./chunk-CN4OAA2G.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-3W2HJKJX.js";
+} from "./chunk-CQFZRLXQ.js";
 import {
   nowIso
-} from "./chunk-AJHYQCBJ.js";
+} from "./chunk-MZG6I2Q2.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -45,7 +45,7 @@ import {
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-KHVGM5CS.js";
+} from "./chunk-BDDYM4LH.js";
 
 // dist/cli/commands/restore.js
 import jsonPatch from "fast-json-patch";
@@ -424,4 +424,4 @@ export {
   runRestore,
   _testOnlyRestoreCommand
 };
-//# sourceMappingURL=chunk-K5DT2YKM.js.map
+//# sourceMappingURL=chunk-CQISNF3Z.js.map

package/dist/cli-bundle/chunks/{chunk-5IZUBZBR.js → chunk-D2LDM35X.js}

@@ -1,7 +1,7 @@
 import {
   parseItemDocument,
   serializeItemDocument
-} from "./chunk-3W2HJKJX.js";
+} from "./chunk-CQFZRLXQ.js";
 import {
   TYPE_TO_FOLDER,
   getItemFormatFromPath,
@@ -10,7 +10,7 @@ import {
   removeFileIfExists,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-KHVGM5CS.js";
+} from "./chunk-BDDYM4LH.js";
 
 // dist/core/store/item-format-migration.js
 import fs from "node:fs/promises";
@@ -119,4 +119,4 @@ async function migrateItemFilesToFormat(pmRoot, targetFormat, op = "item_format:
 export {
   migrateItemFilesToFormat
 };
-//# sourceMappingURL=chunk-5IZUBZBR.js.map
+//# sourceMappingURL=chunk-D2LDM35X.js.map

package/dist/cli-bundle/chunks/{chunk-NZ7QIUP5.js → chunk-DEIDJQZK.js}

@@ -2,17 +2,17 @@ import {
   EXECUTABLE_COMMAND_ALIASES,
   normalizeExtensionNameForMatch,
   normalizeManagedDirectoryName
-} from "./chunk-T6AXEBOP.js";
+} from "./chunk-4OXNQHKQ.js";
 import {
   PM_CORE_COMMAND_NAMES
-} from "./chunk-RAHINBVP.js";
+} from "./chunk-7745CXNI.js";
 import {
   EXIT_CODE,
   PmCliError,
   collectUsedExtensionCapabilities,
   normalizeExtensionName,
   pathExists
-} from "./chunk-KHVGM5CS.js";
+} from "./chunk-BDDYM4LH.js";
 
 // dist/cli/commands/extension/scaffold.js
 import fs from "node:fs/promises";
@@ -20,7 +20,7 @@ import path 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] = "9cc4cb5f-313d-5e8c-8c63-545a7a8d2a03");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "5589c81c-9c3e-57ed-936e-0b149319e990");
   } catch (e2) {
   }
 })();
@@ -63,6 +63,39 @@ var SAMPLE_HARNESS_FINALLY_LINES = [
   "    await deactivateIfNeeded(ext, deactivated);",
   "  }"
 ];
+function indentGeneratedLines(lines, prefix) {
+  return lines.map((line) => line === "" ? line : `${prefix}${line}`);
+}
+function buildSchemaCapabilityAssertionLines(options) {
+  const migrationHint = options.includeMigrationReplacementHint === true ? ["  // as your migration grows."] : [];
+  return [
+    "  // assertItemType/Field/Migration throw unless the registration is present, so",
+    "  // reaching each next line already proves the wiring; assert on the returned",
+    "  // definitions to demonstrate inspecting registered metadata.",
+    `  const itemType = ext.assertItemType({ itemType: ${JSON.stringify(options.itemTypeName)}, extensionName: ${JSON.stringify(options.extensionName)} });`,
+    `  assert.equal(itemType.itemType.folder, ${JSON.stringify(options.itemTypeFolder)});`,
+    `  const itemField = ext.assertItemField({ field: ${JSON.stringify(options.fieldName)}, extensionName: ${JSON.stringify(options.extensionName)} });`,
+    '  assert.equal(itemField.field.type, "string");',
+    `  ext.assertMigration({ migration: ${JSON.stringify(options.migrationId)}, extensionName: ${JSON.stringify(options.extensionName)}, mandatory: false });`,
+    "",
+    "  // runMigration invokes the migration through pm's real runner with a synthetic",
+    "  // context and returns its result.",
+    ...migrationHint,
+    `  const migrated = await ext.runMigration({ migration: ${JSON.stringify(options.migrationId)} });`,
+    `  assert.deepEqual(migrated, { migrated: true, id: ${JSON.stringify(options.migrationId)} });`
+  ];
+}
+function buildProfileCapabilityAssertionLines(extensionName) {
+  return [
+    "  // assertProfile throws unless the profile is registered, so reaching the next",
+    "  // line already proves the wiring; assert on the returned definition to inspect",
+    "  // the bundled archetype dimensions.",
+    `  const { profile } = ext.assertProfile({ profile: ${JSON.stringify(extensionName)}, extensionName: ${JSON.stringify(extensionName)} });`,
+    `  assert.equal(profile.title, ${JSON.stringify(`${extensionName} archetype`)});`,
+    "  assert.equal(profile.types.length, 1);",
+    "  assert.equal(profile.workflows.length, 1);"
+  ];
+}
 var SCAFFOLD_TSCONFIG = {
   compilerOptions: {
     target: "ES2022",
@@ -828,9 +861,6 @@ function buildSampleTestSource(extensionName, commandName, capability) {
   const preflightEnabled = capability === "preflight";
   const servicesEnabled = capability === "services";
   const capabilitiesLiteral = SAMPLE_TEST_CAPABILITIES_LITERAL[capability];
-  const searchProviderName = `${extensionName}-search`;
-  const vectorAdapterName = `${extensionName}-vector`;
-  const adapterName = `${extensionName.replace(/-/g, " ")} items`;
   const itemTypeName = extensionName;
   const itemTypeFolder = `${extensionName}s`;
   const fieldName = `${extensionName.replace(/-/g, "_")}_note`;
@@ -874,89 +904,8 @@ function buildSampleTestSource(extensionName, commandName, capability) {
     "});",
     ""
   ] : [];
-  const searchTestLines = searchEnabled ? [
-    `test(${JSON.stringify(`${extensionName} registers and invokes search primitives`)}, async () => {`,
-    "  const ext = await createExtensionTestHarness(extension, {",
-    `    name: ${JSON.stringify(extensionName)},`,
-    `    capabilities: ${capabilitiesLiteral},`,
-    "  });",
-    "  let deactivated = false;",
-    "  try {",
-    `    ext.assertSearchProvider({ provider: ${JSON.stringify(searchProviderName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    `    ext.assertVectorStoreAdapter({ adapter: ${JSON.stringify(vectorAdapterName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    "",
-    "    // The starter provider reads only document title/id, so `settings` is a",
-    "    // minimal typed stub and `documents` carry just the fields it inspects.",
-    "    const query = await ext.runSearchProvider({",
-    `      provider: ${JSON.stringify(searchProviderName)},`,
-    '      operation: "query",',
-    "      context: {",
-    '        query: "sync",',
-    '        mode: "semantic",',
-    '        tokens: ["sync"],',
-    "        options: {},",
-    "        settings: {} as PmSettings,",
-    "        documents: [",
-    '          { metadata: { id: "pm-1", title: "Sync external context" }, body: "" },',
-    '          { metadata: { id: "pm-2", title: "Unrelated task" }, body: "" },',
-    "        ] as ItemDocument[],",
-    "      },",
-    "    });",
-    '    assert.deepEqual(query, { hits: [{ id: "pm-1", score: 1, matched_fields: ["title"] }] });',
-    "",
-    "    const embedding = await ext.runSearchProvider({",
-    `      provider: ${JSON.stringify(searchProviderName)},`,
-    '      operation: "embed",',
-    '      context: { input: "abc", settings: {} as PmSettings, model: "starter-model" },',
-    "    });",
-    "    assert.deepEqual(embedding, [3]);",
-    "",
-    "    const vectorHits = await ext.runVectorStoreAdapter({",
-    `      adapter: ${JSON.stringify(vectorAdapterName)},`,
-    '      operation: "query",',
-    "      context: { vector: [0.1, 0.2], limit: 2, settings: {} as PmSettings },",
-    "    });",
-    '    assert.deepEqual(vectorHits, [{ id: "starter-vector-hit", score: 2 }]);',
-    "    const teardown = await ext.deactivate();",
-    "    assertExtensionDeactivated(teardown);",
-    "    deactivated = true;",
-    ...SAMPLE_HARNESS_FINALLY_LINES,
-    "});",
-    ""
-  ] : [];
-  const importerTestLines = importersEnabled ? [
-    `test(${JSON.stringify(`${extensionName} registers and invokes import/export primitives`)}, async () => {`,
-    "  const ext = await createExtensionTestHarness(extension, {",
-    `    name: ${JSON.stringify(extensionName)},`,
-    `    capabilities: ${capabilitiesLiteral},`,
-    "  });",
-    "  let deactivated = false;",
-    "  try {",
-    `    ext.assertImporter({ importer: ${JSON.stringify(adapterName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    `    ext.assertExporter({ exporter: ${JSON.stringify(adapterName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    "",
-    "    const imported = await ext.runImporter({",
-    `      importer: ${JSON.stringify(adapterName)},`,
-    '      options: { source: "tickets" },',
-    '      args: ["batch-1"],',
-    "    });",
-    "    assert.equal(imported.handled, true);",
-    '    assert.deepEqual(imported.result, { imported: 1, source: "tickets", args: ["batch-1"] });',
-    "",
-    "    const exported = await ext.runExporter({",
-    `      exporter: ${JSON.stringify(adapterName)},`,
-    '      options: { destination: "archive" },',
-    '      args: ["done"],',
-    "    });",
-    "    assert.equal(exported.handled, true);",
-    '    assert.deepEqual(exported.result, { exported: true, destination: "archive", args: ["done"] });',
-    "    const teardown = await ext.deactivate();",
-    "    assertExtensionDeactivated(teardown);",
-    "    deactivated = true;",
-    ...SAMPLE_HARNESS_FINALLY_LINES,
-    "});",
-    ""
-  ] : [];
+  const searchTestLines = searchEnabled ? buildDeclarativeCapabilityTestBlock(extensionName, commandName, "search", capabilitiesLiteral) : [];
+  const importerTestLines = importersEnabled ? buildDeclarativeCapabilityTestBlock(extensionName, commandName, "importers", capabilitiesLiteral) : [];
   const schemaTestLines = schemaEnabled ? [
     `test(${JSON.stringify(`${extensionName} registers and runs its custom schema`)}, async () => {`,
     "  const ext = await createExtensionTestHarness(extension, {",
@@ -965,20 +914,14 @@ function buildSampleTestSource(extensionName, commandName, capability) {
     "  });",
     "  let deactivated = false;",
     "  try {",
-    "    // assertItemType/Field/Migration throw unless the registration is",
-    "    // present, so reaching each next line already proves the wiring; assert on",
-    "    // the returned definitions to demonstrate inspecting registered metadata.",
-    `    const itemType = ext.assertItemType({ itemType: ${JSON.stringify(itemTypeName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    `    assert.equal(itemType.itemType.folder, ${JSON.stringify(itemTypeFolder)});`,
-    `    const itemField = ext.assertItemField({ field: ${JSON.stringify(fieldName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    '    assert.equal(itemField.field.type, "string");',
-    `    ext.assertMigration({ migration: ${JSON.stringify(migrationId)}, extensionName: ${JSON.stringify(extensionName)}, mandatory: false });`,
-    "",
-    "    // runMigration invokes the migration through pm's real runner with a",
-    "    // synthetic context and returns its result. Replace the context/assertions",
-    "    // as your migration grows.",
-    `    const migrated = await ext.runMigration({ migration: ${JSON.stringify(migrationId)} });`,
-    `    assert.deepEqual(migrated, { migrated: true, id: ${JSON.stringify(migrationId)} });`,
+    ...indentGeneratedLines(buildSchemaCapabilityAssertionLines({
+      extensionName,
+      itemTypeName,
+      itemTypeFolder,
+      fieldName,
+      migrationId,
+      includeMigrationReplacementHint: true
+    }), "  "),
     "    const teardown = await ext.deactivate();",
     "    assertExtensionDeactivated(teardown);",
     "    deactivated = true;",
@@ -994,13 +937,7 @@ function buildSampleTestSource(extensionName, commandName, capability) {
     "  });",
     "  let deactivated = false;",
     "  try {",
-    "    // assertProfile throws unless the profile is registered, so reaching the next",
-    "    // line already proves the wiring; assert on the returned definition to inspect",
-    "    // the bundled archetype dimensions.",
-    `    const { profile } = ext.assertProfile({ profile: ${JSON.stringify(extensionName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    `    assert.equal(profile.title, ${JSON.stringify(`${extensionName} archetype`)});`,
-    "    assert.equal(profile.types.length, 1);",
-    "    assert.equal(profile.workflows.length, 1);",
+    ...indentGeneratedLines(buildProfileCapabilityAssertionLines(extensionName), "  "),
     "    const teardown = await ext.deactivate();",
     "    assertExtensionDeactivated(teardown);",
     "    deactivated = true;",
@@ -1532,36 +1469,20 @@ function buildDeclarativeCapabilityTestBlock(extensionName, commandName, capabil
     case "schema":
       return [
         `test(${JSON.stringify(`${extensionName} registers and runs its custom schema`)}, async () => {`,
-        ...withHarnessCleanup([
-          "  // assertItemType/Field/Migration throw unless the registration is present, so",
-          "  // reaching each next line already proves the wiring; assert on the returned",
-          "  // definitions to demonstrate inspecting registered metadata.",
-          `  const itemType = ext.assertItemType({ itemType: ${JSON.stringify(itemTypeName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-          `  assert.equal(itemType.itemType.folder, ${JSON.stringify(itemTypeFolder)});`,
-          `  const itemField = ext.assertItemField({ field: ${JSON.stringify(fieldName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-          '  assert.equal(itemField.field.type, "string");',
-          `  ext.assertMigration({ migration: ${JSON.stringify(migrationId)}, extensionName: ${JSON.stringify(extensionName)}, mandatory: false });`,
-          "",
-          "  // runMigration invokes the migration through pm's real runner with a synthetic",
-          "  // context and returns its result.",
-          `  const migrated = await ext.runMigration({ migration: ${JSON.stringify(migrationId)} });`,
-          `  assert.deepEqual(migrated, { migrated: true, id: ${JSON.stringify(migrationId)} });`
-        ]),
+        ...withHarnessCleanup(buildSchemaCapabilityAssertionLines({
+          extensionName,
+          itemTypeName,
+          itemTypeFolder,
+          fieldName,
+          migrationId
+        })),
         "});",
         ""
       ];
     case "profile":
       return [
         `test(${JSON.stringify(`${extensionName} registers its project profile`)}, async () => {`,
-        ...withHarnessCleanup([
-          "  // assertProfile throws unless the profile is registered, so reaching the next",
-          "  // line already proves the wiring; assert on the returned definition to inspect",
-          "  // the bundled archetype dimensions.",
-          `  const { profile } = ext.assertProfile({ profile: ${JSON.stringify(extensionName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-          `  assert.equal(profile.title, ${JSON.stringify(`${extensionName} archetype`)});`,
-          "  assert.equal(profile.types.length, 1);",
-          "  assert.equal(profile.workflows.length, 1);"
-        ]),
+        ...withHarnessCleanup(buildProfileCapabilityAssertionLines(extensionName)),
         "});",
         ""
       ];
@@ -2465,4 +2386,4 @@ export {
   buildExtensionDescribeResult,
   renderExtensionDescribeMarkdown
 };
-//# sourceMappingURL=chunk-NZ7QIUP5.js.map
+//# sourceMappingURL=chunk-DEIDJQZK.js.map