@unbrained/pm-cli 2026.6.24 → 2026.7.1

package/dist/cli-bundle/chunks/chunk-INPHFO33.js

@@ -1,764 +0,0 @@
-import {
-  normalizeManagedDirectoryName
-} from "./chunk-PEL2NLQE.js";
-import {
-  EXIT_CODE,
-  PmCliError,
-  pathExists
-} from "./chunk-EYPINTFR.js";
-
-// dist/cli/commands/extension/scaffold.js
-import fs from "node:fs/promises";
-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] = "9eecdd82-fe71-5803-9186-a33244c4722d");
-  } catch (e2) {
-  }
-})();
-var SCAFFOLD_MANIFEST_VERSION = 1;
-var SCAFFOLD_PM_MIN_VERSION = "2026.5.0";
-var SCAFFOLD_DECLARED_PERMISSIONS = {
-  fs_read: false,
-  fs_write: false,
-  network: false,
-  env_read: false,
-  env_write: false,
-  process_spawn: false
-};
-var SCAFFOLD_TYPESCRIPT_VERSION = "^6.0.0";
-var SCAFFOLD_TYPES_NODE_VERSION = "^20.0.0";
-var SCAFFOLD_TSCONFIG = {
-  compilerOptions: {
-    target: "ES2022",
-    module: "NodeNext",
-    moduleResolution: "NodeNext",
-    strict: true,
-    esModuleInterop: true,
-    skipLibCheck: true,
-    declaration: false,
-    // `node:test`/`node:assert` in the colocated test (and Node globals) resolve
-    // from `@types/node`; name it explicitly so it is loaded regardless of how the
-    // package manager lays out `node_modules/@types`.
-    types: ["node"]
-  },
-  // Recursive so a package that grows into subdirectory `*.ts` modules still
-  // type-checks and compiles them; tsc excludes `node_modules` by default.
-  include: ["**/*.ts"]
-};
-var SCAFFOLD_CAPABILITIES = ["commands", "hooks", "search", "importers"];
-var SCAFFOLD_MANIFEST_CAPABILITIES = {
-  commands: ["commands"],
-  hooks: ["commands", "hooks"],
-  search: ["commands", "search"],
-  importers: ["commands", "schema", "importers"]
-};
-var SAMPLE_TEST_CAPABILITIES_LITERAL = {
-  commands: '["commands"]',
-  hooks: '["commands", "hooks"]',
-  search: '["commands", "search"]',
-  importers: '["commands", "schema", "importers"]'
-};
-var ENTRYPOINT_BULLETS = {
-  commands: "- `index.ts`: starter command registration plus a `deactivate` teardown stub (compiled to `index.js`).",
-  hooks: "- `index.ts`: starter command registration, an `after_command` lifecycle hook, and a `deactivate` teardown stub (compiled to `index.js`).",
-  search: "- `index.ts`: starter command registration, a search provider, a vector-store adapter, and a `deactivate` teardown stub (compiled to `index.js`).",
-  importers: "- `index.ts`: starter command registration, importer/exporter command registrations, and a `deactivate` teardown stub (compiled to `index.js`)."
-};
-var SAMPLE_TEST_BULLETS = {
-  commands: "- `index.test.ts`: sample `node:test` suite covering activation, command invocation, and teardown via the SDK testing helpers.",
-  hooks: "- `index.test.ts`: sample `node:test` suite covering activation, command invocation, the after_command hook, and teardown via the SDK testing helpers.",
-  search: "- `index.test.ts`: sample `node:test` suite covering activation, command invocation, search provider/vector adapter invocation, and teardown via the SDK testing helpers.",
-  importers: "- `index.test.ts`: sample `node:test` suite covering activation, command invocation, importer/exporter invocation, and teardown via the SDK testing helpers."
-};
-var TSCONFIG_BULLET = "- `tsconfig.json`: strict TypeScript config that compiles `index.ts` to the `./index.js` entry.";
-var PACKAGE_CAPABILITY_README_SECTIONS = {
-  commands: [],
-  hooks: [
-    "",
-    "## Lifecycle Hook",
-    "`index.ts` registers an `after_command` hook via `api.hooks.afterCommand`.",
-    "pm fires it once a command finishes, passing the command outcome and the",
-    "items it mutated (`context.affected`). React there to keep external context",
-    "in sync - sync records, emit telemetry, or refresh derived state. The",
-    "`hooks` capability in `manifest.json` is what grants the hook registration;",
-    "remove it (and the hook) if your package only needs commands."
-  ],
-  search: [
-    "",
-    "## Search Provider",
-    "`index.ts` registers a deterministic in-memory search provider and",
-    "vector-store adapter through `api.registerSearchProvider` and",
-    "`api.registerVectorStoreAdapter`. Replace the sample scoring,",
-    "embedding, and storage behavior with your project-specific retrieval",
-    "logic. The `search` capability in `manifest.json` grants both",
-    "registrations."
-  ],
-  importers: [
-    "",
-    "## Importer and Exporter",
-    "`index.ts` registers paired project-context import/export commands through",
-    "`api.registerImporter` and `api.registerExporter`. Replace the starter",
-    "payloads with your domain adapter: GitHub issues, CSV rows, documents,",
-    "tickets, or another project-management source of truth. The `importers`",
-    "capability grants both registrations, and `schema` grants the example",
-    "command flag metadata."
-  ]
-};
-var EXTENSION_CAPABILITY_README_SECTIONS = {
-  commands: [],
-  hooks: [
-    "",
-    "## Lifecycle Hook",
-    "`index.ts` registers an `after_command` hook via `api.hooks.afterCommand`.",
-    "pm fires it once a command finishes, passing the command outcome and the",
-    "items it mutated (`context.affected`). React there to keep external context",
-    "in sync. The `hooks` capability in `manifest.json` grants the registration;",
-    "remove it (and the hook) if your extension only needs commands."
-  ],
-  search: [
-    "",
-    "## Search Provider",
-    "`index.ts` registers a deterministic in-memory search provider and",
-    "vector-store adapter through `api.registerSearchProvider` and",
-    "`api.registerVectorStoreAdapter`. Replace the sample scoring, embedding,",
-    "and storage behavior with your project-specific retrieval logic. The",
-    "`search` capability in `manifest.json` grants both registrations."
-  ],
-  importers: [
-    "",
-    "## Importer and Exporter",
-    "`index.ts` registers paired project-context import/export commands through",
-    "`api.registerImporter` and `api.registerExporter`. Replace the starter",
-    "payloads with your domain adapter. The `importers` capability grants both",
-    "registrations, and `schema` grants the example command flag metadata."
-  ]
-};
-function buildActivateBodyLines(extensionName, commandName, capability) {
-  const searchProviderName = `${extensionName}-search`;
-  const vectorAdapterName = `${extensionName}-vector`;
-  const adapterName = `${extensionName.replace(/-/g, " ")} items`;
-  const commandLines = [
-    "  api.registerCommand({",
-    `    name: ${JSON.stringify(commandName)},`,
-    '    description: "Starter scaffold command. Replace with your own behavior.",',
-    "    run: async (context) => ({",
-    "      ok: true,",
-    `      source: ${JSON.stringify(extensionName)},`,
-    "      command: context.command,",
-    '      message: "Starter extension scaffold is active.",',
-    "    }),",
-    "  });"
-  ];
-  if (capability === "commands") {
-    return commandLines;
-  }
-  if (capability === "search") {
-    return [
-      ...commandLines,
-      "",
-      "  // Search providers let packages customize how pm ranks and retrieves",
-      "  // project context. This starter is deterministic and dependency-free:",
-      "  // replace the scoring with your domain retrieval, embedding, or rerank",
-      "  // logic as the package grows.",
-      "  api.registerSearchProvider({",
-      `    name: ${JSON.stringify(searchProviderName)},`,
-      "    query: async (context) => {",
-      "      const needle = context.query.toLowerCase();",
-      "      const hits = context.documents",
-      "        .filter((document) => {",
-      '          const title = String(document.metadata.title ?? "").toLowerCase();',
-      "          return title.includes(needle);",
-      "        })",
-      "        .map((document) => ({",
-      "          id: document.metadata.id,",
-      "          score: 1,",
-      '          matched_fields: ["title"],',
-      "        }));",
-      "      return { hits };",
-      "    },",
-      "    embed: async (context) => [context.input.length],",
-      "  });",
-      "",
-      "  // Vector-store adapters let packages own semantic index storage. This",
-      "  // starter returns a stable in-memory hit so generated tests can exercise",
-      "  // the adapter without external services.",
-      "  api.registerVectorStoreAdapter({",
-      `    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") {
-    return [
-      ...commandLines,
-      "",
-      "  // Importers/exporters are the bridge between pm's context graph and",
-      "  // another project-management system. Keep the starter deterministic so",
-      "  // package tests can run without touching the network or filesystem; replace",
-      "  // these payloads with your adapter's real mapping as the package grows.",
-      "  api.registerImporter(",
-      `    ${JSON.stringify(adapterName)},`,
-      "    async (context) => ({",
-      "      imported: 1,",
-      '      source: context.options.source ?? "starter",',
-      "      args: context.args,",
-      "    }),",
-      "    {",
-      `      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)},`,
-      "    async (context) => ({",
-      "      exported: true,",
-      '      destination: context.options.destination ?? "stdout",',
-      "      args: context.args,",
-      "    }),",
-      "    {",
-      `      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.",',
-      "        },",
-      "      ],",
-      "    },",
-      "  );"
-    ];
-  }
-  return [
-    ...commandLines,
-    "",
-    "  // after_command hooks fire once pm finishes a command, receiving the items",
-    "  // it mutated. This is the natural place to react to every change - sync to",
-    "  // an external system, emit telemetry, or refresh derived context",
-    '  // ("project management = context management"). This starter is a documented',
-    "  // no-op on the success path; replace the body with your own reaction.",
-    "  api.hooks.afterCommand((context) => {",
-    "    if (!context.ok) {",
-    "      return;",
-    "    }",
-    "    // `context.affected` lists the items pm mutated (id, status,",
-    "    // changed_fields). React here, e.g.:",
-    "    //   for (const item of context.affected ?? []) { /* ...item.id... */ }",
-    "  });"
-  ];
-}
-function buildSampleTestSource(extensionName, commandName, capability) {
-  const hooksEnabled = capability === "hooks";
-  const searchEnabled = capability === "search";
-  const importersEnabled = capability === "importers";
-  const capabilitiesLiteral = SAMPLE_TEST_CAPABILITIES_LITERAL[capability];
-  const searchProviderName = `${extensionName}-search`;
-  const vectorAdapterName = `${extensionName}-vector`;
-  const adapterName = `${extensionName.replace(/-/g, " ")} items`;
-  const importNames = [
-    "  activateExtensionForTest,",
-    "  assertExtensionDeactivated,",
-    "  assertRegisteredCommandContract,",
-    ...hooksEnabled ? ["  assertRegisteredHook,"] : [],
-    ...searchEnabled ? ["  assertRegisteredSearchProvider,", "  assertRegisteredVectorStoreAdapter,"] : [],
-    ...importersEnabled ? ["  assertRegisteredImporter,", "  assertRegisteredExporter,"] : [],
-    "  deactivateExtensionForTest,",
-    "  runRegisteredCommandForTest,",
-    ...hooksEnabled ? ["  runRegisteredHookForTest,"] : [],
-    ...searchEnabled ? ["  runRegisteredSearchProviderForTest,", "  runRegisteredVectorStoreAdapterForTest,"] : [],
-    ...importersEnabled ? ["  runRegisteredImporterForTest,", "  runRegisteredExporterForTest,"] : []
-  ];
-  const hookTestLines = hooksEnabled ? [
-    `test(${JSON.stringify(`${extensionName} reacts to commands via its after_command hook`)}, async () => {`,
-    "  const activation = await activateExtensionForTest(extension, {",
-    `    name: ${JSON.stringify(extensionName)},`,
-    `    capabilities: ${capabilitiesLiteral},`,
-    "  });",
-    "  // assertRegisteredHook throws unless an after_command hook is registered,",
-    "  // so reaching the next line already proves the hook is wired.",
-    "  assertRegisteredHook(activation.hooks, {",
-    '    kind: "after_command",',
-    `    extensionName: ${JSON.stringify(extensionName)},`,
-    "  });",
-    "  // runRegisteredHookForTest fires the hook through pm's real runner with a",
-    "  // synthetic context and returns the warnings it produced; a clean hook",
-    "  // returns none. Replace the context/assertions as your hook grows.",
-    "  const warnings = await runRegisteredHookForTest(activation.hooks, {",
-    '    kind: "after_command",',
-    "    context: {",
-    `      command: ${JSON.stringify(commandName)},`,
-    "      args: [],",
-    '      pm_root: "",',
-    "      ok: true,",
-    "      affected: [],",
-    "    },",
-    "  });",
-    "  assert.deepEqual(warnings, []);",
-    "});",
-    ""
-  ] : [];
-  const searchTestLines = searchEnabled ? [
-    `test(${JSON.stringify(`${extensionName} registers and invokes search primitives`)}, async () => {`,
-    "  const activation = await activateExtensionForTest(extension, {",
-    `    name: ${JSON.stringify(extensionName)},`,
-    `    capabilities: ${capabilitiesLiteral},`,
-    "  });",
-    "  assertRegisteredSearchProvider(activation.registrations, {",
-    `    provider: ${JSON.stringify(searchProviderName)},`,
-    `    extensionName: ${JSON.stringify(extensionName)},`,
-    "  });",
-    "  assertRegisteredVectorStoreAdapter(activation.registrations, {",
-    `    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 runRegisteredSearchProviderForTest(activation.registrations, {",
-    `    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 runRegisteredSearchProviderForTest(activation.registrations, {",
-    `    provider: ${JSON.stringify(searchProviderName)},`,
-    '    operation: "embed",',
-    '    context: { input: "abc", settings: {} as PmSettings, model: "starter-model" },',
-    "  });",
-    "  assert.deepEqual(embedding, [3]);",
-    "",
-    "  const vectorHits = await runRegisteredVectorStoreAdapterForTest(activation.registrations, {",
-    `    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 importerTestLines = importersEnabled ? [
-    `test(${JSON.stringify(`${extensionName} registers and invokes import/export primitives`)}, async () => {`,
-    "  const activation = await activateExtensionForTest(extension, {",
-    `    name: ${JSON.stringify(extensionName)},`,
-    `    capabilities: ${capabilitiesLiteral},`,
-    "  });",
-    "  assertRegisteredImporter(activation.registrations, {",
-    `    importer: ${JSON.stringify(adapterName)},`,
-    `    extensionName: ${JSON.stringify(extensionName)},`,
-    "  });",
-    "  assertRegisteredExporter(activation.registrations, {",
-    `    exporter: ${JSON.stringify(adapterName)},`,
-    `    extensionName: ${JSON.stringify(extensionName)},`,
-    "  });",
-    "",
-    "  const imported = await runRegisteredImporterForTest(activation, {",
-    `    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 runRegisteredExporterForTest(activation, {",
-    `    exporter: ${JSON.stringify(adapterName)},`,
-    '    options: { destination: "archive" },',
-    '    args: ["done"],',
-    "  });",
-    "  assert.equal(exported.handled, true);",
-    '  assert.deepEqual(exported.result, { exported: true, destination: "archive", args: ["done"] });',
-    "});",
-    ""
-  ] : [];
-  return [
-    'import assert from "node:assert/strict";',
-    'import { test } from "node:test";',
-    "import {",
-    ...importNames,
-    '} from "@unbrained/pm-cli/sdk/testing";',
-    // The search sample's synthetic query/vector contexts reference these SDK types
-    // for their typed-stub fixtures; other capabilities need no extra type imports.
-    ...searchEnabled ? ['import type { ItemDocument, PmSettings } from "@unbrained/pm-cli/sdk";'] : [],
-    '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 capabilities the entrypoint relies on.",
-    "  const activation = await activateExtensionForTest(extension, {",
-    `    name: ${JSON.stringify(extensionName)},`,
-    `    capabilities: ${capabilitiesLiteral},`,
-    "  });",
-    "  // 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");',
-    "",
-    "  // runRegisteredCommandForTest invokes the handler through pm's real",
-    "  // dispatch engine, so this asserts behavior - not just that the command",
-    "  // is wired. Replace these assertions as you flesh out your command.",
-    "  const invocation = await runRegisteredCommandForTest(activation.commands, {",
-    `    command: ${JSON.stringify(commandName)},`,
-    "  });",
-    "  assert.equal(invocation.handled, true);",
-    "  // The handler result is typed `unknown`, so deep-equality on the whole",
-    "  // structured payload keeps the assertion type-safe without a cast.",
-    "  assert.deepEqual(invocation.result, {",
-    "    ok: true,",
-    `    source: ${JSON.stringify(extensionName)},`,
-    `    command: ${JSON.stringify(commandName)},`,
-    '    message: "Starter extension scaffold is active.",',
-    "  });",
-    "});",
-    "",
-    ...hookTestLines,
-    ...searchTestLines,
-    ...importerTestLines,
-    `test(${JSON.stringify(`${extensionName} tears down cleanly via deactivate`)}, async () => {`,
-    "  // deactivateExtensionForTest runs pm's real teardown engine over the",
-    "  // module, so this proves your `deactivate` hook runs without throwing.",
-    "  const teardown = await deactivateExtensionForTest(extension, {",
-    `    name: ${JSON.stringify(extensionName)},`,
-    "  });",
-    "  // assertExtensionDeactivated throws unless exactly one extension tore down",
-    "  // with no failures, so reaching the next line already proves teardown ran.",
-    "  assertExtensionDeactivated(teardown);",
-    "  assert.equal(teardown.deactivated, 1);",
-    "});",
-    ""
-  ].join("\n");
-}
-function buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabulary, capability = "commands") {
-  const packageName = `pm-${extensionName}`;
-  const capabilities = SCAFFOLD_MANIFEST_CAPABILITIES[capability];
-  const manifest = `${JSON.stringify({
-    name: extensionName,
-    version: "0.1.0",
-    entry: "./index.js",
-    manifest_version: SCAFFOLD_MANIFEST_VERSION,
-    pm_min_version: SCAFFOLD_PM_MIN_VERSION,
-    trusted: true,
-    sandbox_profile: "strict",
-    permissions: { ...SCAFFOLD_DECLARED_PERMISSIONS },
-    capabilities
-  }, null, 2)}
-`;
-  const entrypoint = [
-    'import type { ExtensionApi } from "@unbrained/pm-cli/sdk";',
-    "",
-    "export function activate(api: ExtensionApi): void {",
-    ...buildActivateBodyLines(extensionName, commandName, capability),
-    "}",
-    "",
-    "// `deactivate` is the teardown counterpart to `activate`: pm runs it on host",
-    "// shutdown/reload (e.g. the MCP server between requests) to release anything",
-    "// `activate` opened - timers, connections, caches. This starter holds no such",
-    "// resources, so it stays a documented no-op; add cleanup here as you grow.",
-    "export function deactivate(): void {}",
-    "",
-    "export default {",
-    "  activate,",
-    "  deactivate,",
-    "};",
-    ""
-  ].join("\n");
-  const tsconfig = `${JSON.stringify(SCAFFOLD_TSCONFIG, null, 2)}
-`;
-  const entrypointBullet = ENTRYPOINT_BULLETS[capability];
-  if (vocabulary === "package") {
-    const packageJson = `${JSON.stringify({
-      name: packageName,
-      version: "0.1.0",
-      private: true,
-      type: "module",
-      keywords: ["pm-package"],
-      // `build` compiles index.ts to the ./index.js the manifest loads; `test`
-      // compiles first (Node's `node --test` runs the emitted *.test.js, not the
-      // TypeScript source) then runs the colocated sample against the peer SDK
-      // testing helpers — no third-party test runner required.
-      scripts: {
-        build: "tsc",
-        test: "tsc && node --test"
-      },
-      peerDependencies: {
-        "@unbrained/pm-cli": "*"
-      },
-      devDependencies: {
-        "@types/node": SCAFFOLD_TYPES_NODE_VERSION,
-        typescript: SCAFFOLD_TYPESCRIPT_VERSION
-      },
-      pm: {
-        aliases: [extensionName],
-        extensions: ["."],
-        docs: ["README.md"],
-        examples: ["README.md"],
-        catalog: {
-          display_name: extensionName,
-          category: "workflow",
-          summary: "Starter pm package scaffold.",
-          tags: ["starter"]
-        }
-      }
-    }, null, 2)}
-`;
-    const sampleTest = buildSampleTestSource(extensionName, commandName, capability);
-    const sampleTestBullet = SAMPLE_TEST_BULLETS[capability];
-    const gitignore = [
-      "node_modules/",
-      "*.log",
-      "",
-      "# Compiled TypeScript output (npm run build)",
-      "*.js",
-      "*.test.js",
-      "*.js.map",
-      "*.d.ts",
-      "*.d.ts.map",
-      ""
-    ].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 = [
-      "```ts",
-      `import { ${defineBuilderImports} } from "@unbrained/pm-cli/sdk";`,
-      'import type { ExtensionApi } 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: ExtensionApi): void {", "  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(): void {}", "", "export default { activate, deactivate };", "```");
-    const packageReadme = [
-      `# ${packageName}`,
-      "",
-      "Generated by `pm package init`.",
-      "",
-      "## Included Files",
-      "- `package.json`: package metadata, `build`/`test` scripts, and `pm` resource manifest.",
-      "- `manifest.json`: extension metadata and capabilities.",
-      entrypointBullet,
-      sampleTestBullet,
-      TSCONFIG_BULLET,
-      "- `.gitignore`: ignores `node_modules/`, logs, and compiled JavaScript/declaration output.",
-      "",
-      "## Quick Start",
-      "This package is authored in TypeScript; build it once so the manifest's",
-      "`./index.js` entry exists, then install it:",
-      "```bash",
-      "npm install",
-      "npm run build",
-      "pm install --project <package-path>",
-      `pm ${commandName}`,
-      "pm package doctor --project --detail summary",
-      "```",
-      "",
-      "## Validate the Package",
-      "`npm install` pulls the peer SDK and TypeScript; `npm test` compiles and runs",
-      "the colocated sample test:",
-      "```bash",
-      "npm install",
-      "npm test",
-      "```",
-      "`npm test` runs `tsc && node --test`: it compiles `index.ts`/`index.test.ts`",
-      "then executes the emitted `index.test.js` against the",
-      "`@unbrained/pm-cli/sdk/testing` helpers - no extra test runner required.",
-      "",
-      "## Authoring With define* Builders",
-      "`index.ts` is authored fully in TypeScript so every registration is checked",
-      "against the SDK contracts at author time. Use the public SDK authoring",
-      "builders for exported definitions you want literal-type preservation,",
-      "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",
-      "`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.`,
-      `- \`pm_min_version\` (string): lowest pm CLI version that may load this package. Scaffolded as \`${SCAFFOLD_PM_MIN_VERSION}\`. The loader blocks the package on older CLIs.`,
-      "- `pm_max_version` (string, optional): highest pm CLI version that may load this package. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the package when the CLI exceeds this bound.",
-      "",
-      "## Policy Metadata",
-      'The starter command is pure compute, so `manifest.json` declares `trusted: true`, `sandbox_profile: "strict"`, and all six permission keys as `false`. Keep that least-privilege shape for pure packages; relax only the specific permission your package actually needs and verify with `pm package doctor --project --detail deep --trace`.',
-      "",
-      "## Notes",
-      "- Author in `index.ts`; `npm run build` (tsc) emits the `./index.js` the manifest loads, so rebuild after editing before installing or reloading.",
-      "- Move larger runtimes into sibling or subdirectory `*.ts` modules and import them; `tsconfig.json` compiles every `*.ts` in the package (recursively).",
-      "- Add capabilities to the extension manifest only when the entrypoint uses the matching SDK API.",
-      "- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.",
-      ""
-    ].join("\n");
-    return {
-      "package.json": packageJson,
-      "manifest.json": manifest,
-      "index.ts": entrypoint,
-      "index.test.ts": sampleTest,
-      "tsconfig.json": tsconfig,
-      ".gitignore": gitignore,
-      "README.md": packageReadme
-    };
-  }
-  const readme = [
-    `# ${extensionName}`,
-    "",
-    "Generated by `pm extension init`.",
-    "",
-    "## Included Files",
-    "- `manifest.json`: extension metadata and capabilities.",
-    entrypointBullet,
-    TSCONFIG_BULLET,
-    "",
-    "## Quick Start",
-    "This extension is authored in TypeScript; compile `index.ts` to the manifest's",
-    "`./index.js` entry, then install it. The SDK types resolve once",
-    "`@unbrained/pm-cli` is available to the compiler (install it, Node types, and TypeScript, or",
-    "build from a project that already depends on the CLI):",
-    "```bash",
-    "npm install -D typescript @types/node @unbrained/pm-cli",
-    "npx tsc",
-    "pm extension --install --project <scaffold-path>",
-    `pm ${commandName}`,
-    "pm extension --doctor --project --detail summary",
-    "```",
-    ...EXTENSION_CAPABILITY_README_SECTIONS[capability],
-    "",
-    "## 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.`,
-    `- \`pm_min_version\` (string): lowest pm CLI version that may load this extension. Scaffolded as \`${SCAFFOLD_PM_MIN_VERSION}\`. The loader blocks the extension on older CLIs.`,
-    "- `pm_max_version` (string, optional): highest pm CLI version that may load this extension. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the extension when the CLI exceeds this bound.",
-    "",
-    "## Policy Metadata",
-    'The starter command is pure compute, so `manifest.json` declares `trusted: true`, `sandbox_profile: "strict"`, and all six permission keys as `false`. Keep that least-privilege shape for pure extensions; relax only the specific permission your extension actually needs and verify with `pm extension --doctor --project --detail deep --trace`.',
-    "",
-    "## Notes",
-    "- This scaffold uses TypeScript ESM source compiled to ESM output, so it works in package scopes with `type: module`.",
-    "- Author in `index.ts` and recompile to `index.js` (the manifest entry) after editing capabilities or command behavior.",
-    "- Release any resources `activate` opens (timers, connections, caches) in the `deactivate` teardown hook.",
-    ""
-  ].join("\n");
-  return {
-    "manifest.json": manifest,
-    "index.ts": entrypoint,
-    "tsconfig.json": tsconfig,
-    "README.md": readme
-  };
-}
-async function scaffoldExtensionProject(target, vocabulary = "extension", capability = "commands") {
-  const normalizedCapability = capability.trim().toLowerCase();
-  if (!SCAFFOLD_CAPABILITIES.includes(normalizedCapability)) {
-    throw new PmCliError(`Unknown scaffold capability "${capability}". Supported capabilities: ${SCAFFOLD_CAPABILITIES.join(", ")}.`, EXIT_CODE.USAGE);
-  }
-  const resolvedCapability = normalizedCapability;
-  const normalizedTarget = target.trim();
-  const targetPath = path.resolve(process.cwd(), normalizedTarget);
-  const extensionName = normalizeManagedDirectoryName(path.basename(targetPath));
-  const commandName = `${extensionName.replace(/-/g, " ")} ping`;
-  const scaffoldFiles = buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabulary, resolvedCapability);
-  let createdDirectory = false;
-  if (await pathExists(targetPath)) {
-    const existingTargetStats = await fs.stat(targetPath);
-    if (!existingTargetStats.isDirectory()) {
-      throw new PmCliError(`Scaffold target "${targetPath}" exists and is not a directory.`, EXIT_CODE.CONFLICT);
-    }
-  } else {
-    await fs.mkdir(targetPath, { recursive: true });
-    createdDirectory = true;
-  }
-  for (const [relativePath, content] of Object.entries(scaffoldFiles)) {
-    const absolutePath = path.join(targetPath, relativePath);
-    if (!await pathExists(absolutePath)) {
-      continue;
-    }
-    const existingContent = await fs.readFile(absolutePath, "utf8");
-    if (existingContent !== content) {
-      throw new PmCliError(`Scaffold file "${relativePath}" already exists with different content in "${targetPath}". Choose a new target path or remove conflicting files.`, EXIT_CODE.CONFLICT);
-    }
-  }
-  const files = [];
-  for (const [relativePath, content] of Object.entries(scaffoldFiles)) {
-    const absolutePath = path.join(targetPath, relativePath);
-    if (await pathExists(absolutePath)) {
-      files.push({
-        path: relativePath,
-        status: "unchanged"
-      });
-      continue;
-    }
-    await fs.mkdir(path.dirname(absolutePath), { recursive: true });
-    await fs.writeFile(absolutePath, content, "utf8");
-    files.push({
-      path: relativePath,
-      status: "created"
-    });
-  }
-  return {
-    extension_name: extensionName,
-    command_name: commandName,
-    capability: resolvedCapability,
-    target_path: targetPath,
-    created_directory: createdDirectory,
-    files
-  };
-}
-
-export {
-  SCAFFOLD_CAPABILITIES,
-  scaffoldExtensionProject
-};
-//# sourceMappingURL=chunk-INPHFO33.js.map