@unbrained/pm-cli 2026.6.23 → 2026.6.24

package/docs/EXTENSIONS.md

@@ -87,7 +87,7 @@ Package roots declare resources in `package.json` under `pm`:
 
 Installation activates `pm.extensions`. `pm.docs`, `pm.examples`, `pm.assets`, and `pm.prompts` are catalog metadata (metadata-only — they are discovered and surfaced in the catalog but not executed). Declare agent-facing prompt/slash-command markdown under `pm.prompts` and non-code assets (images, skills, fixtures) under `pm.assets`; their conventional roots are `prompts/` (also `.agents/pm/prompts/`) and `assets/` (also `.agents/pm/assets/`).
 
-`pm package init` emits a root extension (`"extensions": ["."]`) so local package installs can activate without dependency bootstrapping. The generated entrypoint stays import-free for that first local install, while the generated package README shows how to graduate exported command/hook definitions to the SDK [define* builders](../.agents/pm/decisions/pm-3mph.toon) after `npm install` materializes the peer SDK. The default `--capability commands` scaffold registers a starter command and a colocated `node:test` suite. `--capability hooks` keeps the starter command and adds an `after_command` lifecycle hook plus SDK testing coverage with `assertRegisteredHook` and `runRegisteredHookForTest`, giving package authors a runnable template for reacting to pm mutations when project management is context management. `--capability search` keeps the starter command and adds a deterministic search provider/vector-store adapter pair plus SDK tests with `assertRegisteredSearchProvider`, `assertRegisteredVectorStoreAdapter`, `runRegisteredSearchProviderForTest`, and `runRegisteredVectorStoreAdapterForTest`, giving retrieval packages a copyable context-management primitive without external services. `--capability importers` keeps the starter command and adds paired import/export command registrations plus SDK tests with `assertRegisteredImporter`, `assertRegisteredExporter`, `runRegisteredImporterForTest`, and `runRegisteredExporterForTest`, giving integration packages a copyable context-movement primitive for synchronizing external project systems; the generated manifest declares both `importers` and `schema` because the starter includes schema-governed flag metadata. Starter manifests use the same least-privilege policy metadata as pure first-party command packages: `trusted: true`, `sandbox_profile: "strict"`, and explicit `false` permissions for `fs_read`, `fs_write`, `network`, `env_read`, `env_write`, and `process_spawn`. Larger packages may point at nested extension directories after declaring runtime dependencies, relaxing only the permissions they actually need, and validating with `pm package doctor`.
+`pm package init` emits a root extension (`"extensions": ["."]`) authored fully in TypeScript (ADR [pm-2c28](../.agents/pm/decisions/pm-2c28.toon)): a typed `index.ts`, a strict `tsconfig.json`, and `build`/`test` scripts, with the manifest `entry` pointing at the compiled `./index.js`. Run `npm install && npm run build` to produce that entry before `pm install`. The generated README shows how to author exported command/hook definitions with the SDK [define* builders](../.agents/pm/decisions/pm-3mph.toon). The default `--capability commands` scaffold registers a starter command and a colocated `node:test` suite. `--capability hooks` keeps the starter command and adds an `after_command` lifecycle hook plus SDK testing coverage with `assertRegisteredHook` and `runRegisteredHookForTest`, giving package authors a runnable template for reacting to pm mutations when project management is context management. `--capability search` keeps the starter command and adds a deterministic search provider/vector-store adapter pair plus SDK tests with `assertRegisteredSearchProvider`, `assertRegisteredVectorStoreAdapter`, `runRegisteredSearchProviderForTest`, and `runRegisteredVectorStoreAdapterForTest`, giving retrieval packages a copyable context-management primitive without external services. `--capability importers` keeps the starter command and adds paired import/export command registrations plus SDK tests with `assertRegisteredImporter`, `assertRegisteredExporter`, `runRegisteredImporterForTest`, and `runRegisteredExporterForTest`, giving integration packages a copyable context-movement primitive for synchronizing external project systems; the generated manifest declares both `importers` and `schema` because the starter includes schema-governed flag metadata. Starter manifests use the same least-privilege policy metadata as pure first-party command packages: `trusted: true`, `sandbox_profile: "strict"`, and explicit `false` permissions for `fs_read`, `fs_write`, `network`, `env_read`, `env_write`, and `process_spawn`. Larger packages may point at nested extension directories after declaring runtime dependencies, relaxing only the permissions they actually need, and validating with `pm package doctor`.
 
 Package tests can pair `readPmPackageManifest(packageRoot)` with
 `assertPackageManifest(manifest, { resources: ... })` from
@@ -112,7 +112,7 @@ Runtime path overrides:
 - `PM_PATH`: project tracker root
 - `PM_GLOBAL_PATH`: global profile root
 
-A minimal standalone extension has a `manifest.json` and an import-free entrypoint. Standalone entries are loaded by file URL from the extension directory, so they should not import `@unbrained/pm-cli` unless the extension is installed as a package with its own dependencies.
+Extensions are authored fully in TypeScript (ADR [pm-2c28](../.agents/pm/decisions/pm-2c28.toon)): a minimal standalone extension has a `manifest.json` and a TypeScript `index.ts` entrypoint compiled to the `./index.js` the loader imports by file URL. Author against the SDK types with `import type { ExtensionApi }` — the type-only import is erased at compile time, so the emitted `index.js` carries **no runtime import** of `@unbrained/pm-cli` (standalone entries are loaded outside any `node_modules`, so a runtime SDK import would fail). Compile with `npx tsc` after installing `typescript` and `@unbrained/pm-cli` for the type resolution.
 
 ```json
 {
@@ -136,9 +136,10 @@ A minimal standalone extension has a `manifest.json` and an import-free entrypoi
 }
 ```
 
-```js
-/** @param {import("@unbrained/pm-cli/sdk").ExtensionApi} api */
-export function activate(api) {
+```ts
+// index.ts — `import type` is erased at compile; the emitted index.js has no runtime import.
+import type { ExtensionApi } from "@unbrained/pm-cli/sdk";
+export function activate(api: ExtensionApi): void {
   api.registerCommand({
     name: "hello",
     description: "Print a deterministic hello payload.",
@@ -151,9 +152,9 @@ export function activate(api) {
 }
 ```
 
-Package-backed extensions can use the SDK helper after declaring `@unbrained/pm-cli` in `package.json` and installing dependencies. Registry installs satisfy that SDK import from the running host CLI instead of downloading a nested CLI copy into each project extension directory, so package authors can declare `@unbrained/pm-cli` as a peer dependency without adding the CLI's own telemetry/runtime dependencies to every workspace. Use this shape for packages published to npm or installed from a package root:
+Package-backed extensions can also import the SDK's runtime helpers (e.g. `defineExtension`, `composeExtension`) after declaring `@unbrained/pm-cli` in `package.json` and installing dependencies. Registry installs satisfy that SDK import from the running host CLI instead of downloading a nested CLI copy into each project extension directory, so package authors can declare `@unbrained/pm-cli` as a peer dependency without adding the CLI's own telemetry/runtime dependencies to every workspace. Use this shape for packages published to npm or installed from a package root:
 
-```js
+```ts
 import { defineExtension } from "@unbrained/pm-cli/sdk";
 
 export default defineExtension({
@@ -196,7 +197,7 @@ Rules:
 - `manifest_version` is an optional integer identifying the manifest schema generation. Runtime contracts currently support manifest versions `1` and `2`, and first-party runnable examples use `2`. First-party packages declare it; the manifest governance test requires it on every first-party package.
 - `pm_min_version` is an inclusive minimum pm CLI version. If the running CLI is older, discovery emits `extension_pm_min_version_unmet:<layer>:<name>:required=<version>:current=<version>` and skips the extension before import.
 - `pm_max_version` is an optional inclusive maximum pm CLI version (the upper compatibility bound). If the running CLI is newer than this value, discovery emits `extension_pm_max_version_exceeded:<layer>:<name>:allowed=<version>:current=<version>` and skips the extension before import. Use it to stop a CLI major release from loading a stale package that would crash at activation. Operators can temporarily set `extensions.policy.pm_max_version_exceeded_mode` to `"warn"` (or `{ "project": "warn" }`) during controlled upgrade windows; the default remains `"block"`.
-- Both bounds share the same warning-code shapes: `*_invalid` blocks, `*_unchecked` allows with a warning, and `extension_pm_min_version_unmet` / `extension_pm_max_version_exceeded` blocks unless the max-version warn mode is enabled.
+- Both bounds share the same warning-code shapes: `*_invalid` blocks, `*_unchecked` allows with a warning, and `extension_pm_min_version_unmet` / `extension_pm_max_version_exceeded` blocks unless the max-version warn mode is enabled. Verify the supported window at author time — before publishing — with the `checkExtensionManifestCompatibility` SDK helper (or its throwing `assertExtensionManifestCompatible` test guard), which mirrors these exact outcomes against a target pm version. To check the version window, the blueprint lint, and the synthesized manifest in one call, use the `preflightExtension` capstone (or its throwing `assertExtensionPreflight` CI guard).
 - An empty-string or non-string `pm_min_version`/`pm_max_version` makes the whole manifest malformed (`extension_manifest_invalid:<layer>:<name>`). Omit the field instead of leaving it blank.
 - Optional `engines.pm` and `engines.node` metadata is accepted for tooling, but `pm_min_version`/`pm_max_version` are the loader-enforced compatibility fields.
 - Declare only capabilities the extension actually uses. Declaring a capability it never registers against is over-broad: `pm package doctor` emits an advisory `extension_capability_unused:<layer>:<name>:<capability>` warning (never blocking) so you can trim the manifest, while the inverse — registering a surface whose capability is undeclared — is the blocking `extension_capability_missing` activation failure. Catch over-declaration earlier with the `assertExtensionCapabilityUsage` SDK testing helper.
@@ -287,7 +288,7 @@ Doctor JSON also includes `triage.collision_plan` with grouped surfaces, ranked
 
 Use the public SDK barrel. Do not deep-import from `src/core` or `dist/core`.
 
-```js
+```ts
 import { defineExtension } from "@unbrained/pm-cli/sdk";
 ```
 
@@ -415,7 +416,7 @@ If a package-owned command is invoked before installation, usage guidance includ
 
 Third-party packages should import only stable public SDK subpaths:
 
-```js
+```ts
 import { defineExtension, createPmCliExpectedError } from "@unbrained/pm-cli/sdk";
 import { createExtensionTestHarness, activateExtensionForTest } from "@unbrained/pm-cli/sdk/testing";
 ```

package/docs/SDK.md

@@ -37,7 +37,12 @@ Common authoring exports:
 
 - `defineExtension`
 - `composeExtension` / `deriveExtensionCapabilities`
+- `mergeExtensionBlueprints` (combine partial blueprints into one for modular authoring)
+- `composeExtensionPackage` (author-once capstone: returns both the module and its synthesized manifest)
+- `synthesizeExtensionManifest` (generate a complete least-privilege manifest from a blueprint)
 - `describeExtensionBlueprint` (static surface map of a blueprint) / `lintExtensionBlueprint` (author-time preflight)
+- `checkExtensionManifestCompatibility` (author-time `pm_min_version`/`pm_max_version` check against a target pm version)
+- `preflightExtension` (one-call capstone: lint + manifest synthesis + version-compat in a single consolidated report)
 - `EXTENSION_CAPABILITIES`
 - `EXTENSION_CAPABILITY_CONTRACT`
 - `EXTENSION_CAPABILITY_CONTRACT_VERSION`
@@ -117,6 +122,9 @@ Testing helper exports (also under `@unbrained/pm-cli/sdk/testing`):
 - `assertRegisteredMigration`
 - `assertExtensionCapabilityUsage`
 - `assertExtensionBlueprint` (throwing preflight; pairs with `lintExtensionBlueprint`)
+- `assertExtensionManifestMatchesBlueprint` (strict manifest↔blueprint capability guard)
+- `assertExtensionManifestCompatible` (throwing version-bound guard; pairs with `checkExtensionManifestCompatibility`)
+- `assertExtensionPreflight` (one-line throwing capstone over `preflightExtension`; replaces chaining the three asserts above)
 - `describeExtensionActivation`
 - `describeExtensionBlueprint` / `lintExtensionBlueprint` (also surfaced here for the full author → describe → preflight → test loop)
 
@@ -637,17 +645,20 @@ argument unchanged), exactly like `defineExtension` and the wider
 `defineConfig`/`defineComponent` ecosystem convention — the value is entirely at
 the type level.
 
-This matters most in **plain-JavaScript packages** (the default `pm package init`
-scaffold). A bare `const cmd = { ... }` is unchecked because JS has no type
-annotations; wrapping it in a builder restores full contract checking and infers
-the nested handler's `context` parameter through the editor's TypeScript language
-service. It also lets you colocate, export, reuse, and unit-test a definition
+pm packages are authored fully in TypeScript (ADR
+[pm-2c28](../.agents/pm/decisions/pm-2c28.toon)). A bare `const cmd = { ... }`
+satisfies the registration types only structurally and widens its literals;
+wrapping it in a builder checks the object against the contract *and* preserves
+the narrow literal types, while inferring the nested handler's `context`
+parameter from the builder signature — the same ergonomics `defineConfig` gives a
+Vite config. It also lets you colocate, export, reuse, and unit-test a definition
 apart from `activate`:
 
-```js
+```ts
 import { defineCommand, defineAfterCommandHook } from "@unbrained/pm-cli/sdk";
+import type { ExtensionApi } from "@unbrained/pm-cli/sdk";
 
-// `context` is inferred even though this is a .js file with no annotations.
+// `context` is inferred from the builder signature; the literal name/action are preserved.
 export const greetCommand = defineCommand({
   name: "greet hello",
   action: "greet-hello",
@@ -660,7 +671,7 @@ export const auditHook = defineAfterCommandHook((context) => {
   // react to context.affected — "project management = context management"
 });
 
-export function activate(api) {
+export function activate(api: ExtensionApi): void {
   api.registerCommand(greetCommand);
   api.hooks.afterCommand(auditHook);
 }
@@ -693,8 +704,9 @@ SDK generate the `activate` for you. Every field is optional; populate the
 surfaces you use (ideally with `define*`-authored definitions) and leave the rest
 out:
 
-```js
+```ts
 import { composeExtension, defineCommand, deriveExtensionCapabilities } from "@unbrained/pm-cli/sdk";
+import type { ExtensionBlueprint } from "@unbrained/pm-cli/sdk";
 
 const echo = defineCommand({
   name: "command-kit echo",
@@ -703,7 +715,7 @@ const echo = defineCommand({
   run: (context) => ({ message: context.args.join(" ") }),
 });
 
-const blueprint = {
+const blueprint: ExtensionBlueprint = {
   commands: [echo],
   parsers: { "command-kit echo": (context) => ({ options: context.options }) },
   flags: { list: [{ long: "--kit-note", value_type: "string", value_name: "text" }] },
@@ -724,7 +736,7 @@ drift. It is the author-time inverse of the runtime
 it returns is the set `composeExtension`'s generated `activate` requires — they
 agree by construction:
 
-```js
+```ts
 deriveExtensionCapabilities(blueprint); // ["commands", "parser", "schema"]
 ```
 
@@ -738,6 +750,114 @@ malformed definition surfaces the same activation diagnostic as a hand-written
 hand-written `activate` bodies so they load in extension-only installs; reach for
 `composeExtension` in npm package-mode authoring where the SDK is a dependency.
 
+### Modular blueprints
+
+Tracked: [pm-high](../.agents/pm/tasks/pm-high.toon),
+[pm-nvgy](../.agents/pm/tasks/pm-nvgy.toon).
+
+A large extension's surface does not have to live in one object. `mergeExtensionBlueprints(...blueprints)`
+combines several partial blueprints into one — a commands module, a search module,
+a hooks module — so each concern is authored (and tested) in its own file and
+assembled at the entry point. Wrap each fragment in `defineExtensionBlueprint(...)`
+so it is contract-checked at its own definition site (with editor completion) —
+the blueprint-level companion to `defineExtension` (a whole module) and
+`defineExtensionManifest` (a manifest):
+
+```ts
+// commands.ts
+import { defineExtensionBlueprint } from "@unbrained/pm-cli/sdk";
+export const commandsModule = defineExtensionBlueprint({
+  commands: [{ name: "kit run", action: "kit-run", run: () => ({ ok: true }) }],
+});
+```
+
+```ts
+// index.ts — NodeNext import specifiers keep the .js extension; they resolve to the .ts source.
+import { composeExtension, mergeExtensionBlueprints } from "@unbrained/pm-cli/sdk";
+import { commandsModule } from "./commands.js";
+import { searchModule } from "./search.js";
+
+export default composeExtension(mergeExtensionBlueprints(commandsModule, searchModule));
+```
+
+The merge is pure, deterministic, and never mutates an input. Each surface combines
+the way its `api.register*` call composes: array surfaces (`commands`, `itemTypes`,
+`migrations`, `searchProviders`, `importers`, …) concatenate in order; `flags`
+concatenates the flag arrays of a shared target command; single-handler records
+(`commandOverrides`, `parsers`, `renderers`, `services`) take last-defined-wins
+precedence on a key collision; `hooks` concatenate per lifecycle kind; imperative
+`activate` hatches chain forward (acquisition order) while `deactivate` hooks chain
+in reverse (LIFO teardown); the `manifest` mirror is last-defined-wins. Because the
+result is an ordinary blueprint, every downstream helper (`deriveExtensionCapabilities`,
+`describeExtensionBlueprint`, `lintExtensionBlueprint`, `preflightExtension`) reads it
+exactly as it would a hand-written one — a command two modules both define survives
+as a duplicate and `lintExtensionBlueprint` flags it. Merging zero blueprints returns
+an empty blueprint (`{}`).
+
+### Generate the manifest (author once)
+
+Tracked: [pm-u5le](../.agents/pm/features/pm-u5le.toon).
+
+`deriveExtensionCapabilities` gives you only the capability set; every other
+manifest field is still yours to hand-write. `synthesizeExtensionManifest(blueprint, identity)`
+closes that gap — it is the **generate** verb that completes the declarative loop
+(`compose → derive → describe/lint → synthesize`). Supply the identity fields a
+blueprint cannot determine (`name`, `version`, `entry`, `priority`, plus any
+optional `engines`/`permissions`/version floors/etc.) and it returns a complete
+`ExtensionManifest` with `capabilities` derived, sorted, and de-duplicated. Write
+the blueprint once; never hand-sync `capabilities` again:
+
+```ts
+import { synthesizeExtensionManifest } from "@unbrained/pm-cli/sdk";
+
+const manifest = synthesizeExtensionManifest(blueprint, {
+  name: "command-kit",
+  version: "1.0.0",
+  entry: "./index.js",
+  priority: 0,
+});
+manifest.capabilities; // ["commands", "parser", "schema"] — derived, not hand-written
+```
+
+Where `defineExtensionManifest` only *types* a manifest you wrote by hand, this
+*generates* it. For the rare surface registered through the imperative `activate`
+escape hatch (invisible to static derivation — e.g. a renderer wired in
+`activate`), pass `additionalCapabilities` and they are unioned in (legacy-alias
+resolved, unknown names dropped). Use the result as the on-disk `manifest.json`
+content or the in-module `manifest` mirror; guard a hand-maintained manifest
+against drift with `assertExtensionManifestMatchesBlueprint` (below).
+
+### Ship both halves (author once)
+
+Tracked: [pm-cn0c](../.agents/pm/tasks/pm-cn0c.toon).
+
+`composeExtension` produces the runtime module; `synthesizeExtensionManifest`
+produces the manifest. `composeExtensionPackage(blueprint, identity)` is the
+author-once capstone that returns both halves of a shippable package from one call,
+with the synthesized manifest set as the module's authoritative in-module mirror —
+so the runtime module and the on-disk `manifest.json` are generated from one source
+and cannot drift:
+
+```ts
+import { composeExtensionPackage } from "@unbrained/pm-cli/sdk";
+
+const { module, manifest } = composeExtensionPackage(blueprint, {
+  name: "command-kit",
+  version: "1.0.0",
+  entry: "./index.js",
+  priority: 0,
+});
+export default module;          // the package entry's default export
+// write `manifest` verbatim as manifest.json — capabilities derived, never hand-synced
+```
+
+It is a pure assembler (no validation, loading, or filesystem access), exactly like
+the two functions it composes; pair it with `preflightExtension` /
+`assertExtensionPreflight` for the author-time verify step. Combined with
+`mergeExtensionBlueprints`, the full declarative loop is: author each concern with
+`define*`, assemble them modularly with `mergeExtensionBlueprints`, then ship both
+halves with `composeExtensionPackage`.
+
 ### Author-time introspection and preflight
 
 Tracked: [pm-tlpv](../.agents/pm/features/pm-tlpv.toon),
@@ -749,7 +869,7 @@ inspectable and verifiable before it is ever loaded — the author-time inverse
 the runtime guardrails (the same discipline as `deriveExtensionCapabilities`
 inverting [`reconcileExtensionCapabilityUsage`](#capability-requirements)):
 
-```js
+```ts
 import { describeExtensionBlueprint, lintExtensionBlueprint } from "@unbrained/pm-cli/sdk";
 
 // describeExtensionBlueprint returns the same ExtensionActivationSummary shape as
@@ -836,6 +956,86 @@ import { assertExtensionBlueprint } from "@unbrained/pm-cli/sdk/testing";
 const report = assertExtensionBlueprint(blueprint);
 ```
 
+`assertExtensionManifestMatchesBlueprint(manifest, blueprint)` is the **strict**
+bookend to that lenient preflight: where `assertExtensionBlueprint` only fails on
+an *undeclared* capability and merely warns on an unused one, this assertion fails
+on **both** — so a hand-maintained `manifest.json` stays exactly the least-privilege
+set the blueprint requires (assert what `synthesizeExtensionManifest` would
+otherwise generate). Only `capabilities` are reconciled, since that is the one
+manifest field a blueprint determines:
+
+```ts
+import { assertExtensionManifestMatchesBlueprint } from "@unbrained/pm-cli/sdk/testing";
+
+// Throws if manifest.capabilities is missing any capability the blueprint uses, or
+// declares any the blueprint never exercises. Returns { used, declared, missing,
+// unused, findings } on an exact match.
+assertExtensionManifestMatchesBlueprint(manifest, blueprint);
+```
+
+Where the blueprint guards `capabilities`, a manifest's `pm_min_version` /
+`pm_max_version` bounds guard *which pm CLI versions the package supports*.
+Tracker references: `pm-knma` introduced `checkExtensionManifestCompatibility`;
+`pm-hng2` introduced `assertExtensionManifestCompatible`.
+`checkExtensionManifestCompatibility(manifest, { pmVersion, pmMaxVersionExceededMode? })`
+is the author-time inverse of the loader's runtime version gate: it takes the pm
+version you target and returns structured per-bound findings (the same
+`extension_pm_*_version_*` outcomes the loader emits), so you can verify the window
+without installing the package against a real CLI. `assertExtensionManifestCompatible`
+is the throwing CI guard — it fails on a blocking incompatibility (a malformed
+bound, a `pm_min_version` the target is below, or a `block`-mode `pm_max_version`
+the target exceeds) and stays quiet on advisory `*_unchecked` / `*_exceeded_warn`
+warnings, which still load:
+
+```ts
+import { checkExtensionManifestCompatibility } from "@unbrained/pm-cli/sdk";
+import { assertExtensionManifestCompatible } from "@unbrained/pm-cli/sdk/testing";
+
+// Inspect every bound outcome against a target version…
+const report = checkExtensionManifestCompatibility(manifest, { pmVersion: "2026.6.23" });
+//   report.compatible === false, report.findings[0].code === "pm_min_version_unmet", …
+
+// …or fail the package's own suite when a bound would block the load.
+assertExtensionManifestCompatible(manifest, { pmVersion: "2026.6.23" });
+```
+
+Tracked: [pm-ozaf](../.agents/pm/features/pm-ozaf.toon).
+
+`preflightExtension(blueprint, { identity?, target?, declaredCapabilities? })` is the
+author-time **capstone** that runs all of the above in one call — the static analog
+of `createExtensionTestHarness`, which unified the runtime-test helpers. Rather than
+chaining `lintExtensionBlueprint`, `synthesizeExtensionManifest`, and
+`checkExtensionManifestCompatibility` (and reconciling their separate results)
+before publishing, you read one `ExtensionPreflightReport`: the blueprint is always
+linted; when `identity` is given the complete least-privilege manifest is synthesized
+and returned; when `target` is given the synthesized bounds (or, absent an identity,
+the blueprint's in-module `manifest` mirror) are version-checked. The per-stage
+results are exposed unmodified (`report.blueprint` / `report.manifest` /
+`report.compatibility`) alongside a flattened `report.findings` where each entry is
+tagged by `source` (`"blueprint"` | `"compatibility"`); `report.ok` is `false` if any
+stage produced an `error`. `assertExtensionPreflight(blueprint, options?)` is the
+throwing one-line CI guard over it — it fails listing every blocking finding tagged
+`[source:code]` and stays quiet on advisory warnings, returning the full report on
+success:
+
+```ts
+import { preflightExtension } from "@unbrained/pm-cli/sdk";
+import { assertExtensionPreflight } from "@unbrained/pm-cli/sdk/testing";
+
+// Inspect every author-time stage in one report…
+const report = preflightExtension(blueprint, {
+  identity: { name: "command-kit", version: "1.0.0", entry: "./index.js", priority: 0 },
+  target: { pmVersion: "2026.6.23" },
+});
+//   report.manifest.capabilities (derived), report.compatibility.compatible, report.findings[]
+
+// …or guard the whole package in one CI line.
+assertExtensionPreflight(blueprint, {
+  identity: { name: "command-kit", version: "1.0.0", entry: "./index.js", priority: 0 },
+  target: { pmVersion: "2026.6.23" },
+});
+```
+
 Invoke a registered command handler to assert its behavior (not just that it was
 registered). `runRegisteredCommandForTest` dispatches through pm's real engine and
 returns the `CommandHandlerResult`:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.6.23",
+  "version": "2026.6.24",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "author": "unbrained",

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

@@ -1,18 +0,0 @@
-import {
-  _testOnly,
-  runActivity
-} from "./chunk-M4T5DXD5.js";
-import "./chunk-BB6MDVNQ.js";
-import "./chunk-UVC5LOR7.js";
-import "./chunk-T5472OMV.js";
-import "./chunk-IPKJ6B36.js";
-import "./chunk-7MRQ4HMK.js";
-import "./chunk-NCVCO3NZ.js";
-import "./chunk-YJ3SUEPD.js";
-import "./chunk-P77P2ILI.js";
-import "./chunk-MJTSZKK5.js";
-export {
-  _testOnly,
-  runActivity
-};
-//# sourceMappingURL=activity-XUZ2AHCW.js.map

package/dist/cli-bundle/chunks/chunk-C5AOG6D2.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/extension/scaffold.ts"],"sourcesContent":["/**\n * @module cli/commands/extension/scaffold\n *\n * Implements extension package-management support for Scaffold.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists } from \"../../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\nimport { normalizeManagedDirectoryName } from \"./shared.js\";\n\n// Safe compatibility floor emitted into scaffolded manifests. Mirrors the\n// first-party package manifests (pm-nf2q): every current 2026.5.x CLI\n// satisfies it, and it models the field for external authors. manifest_version\n// tracks the manifest schema generation (currently 1).\nconst SCAFFOLD_MANIFEST_VERSION = 1;\nconst SCAFFOLD_PM_MIN_VERSION = \"2026.5.0\";\nconst SCAFFOLD_DECLARED_PERMISSIONS = {\n  fs_read: false,\n  fs_write: false,\n  network: false,\n  env_read: false,\n  env_write: false,\n  process_spawn: false,\n};\n\n/**\n * Capability shapes the package/extension scaffolder can target via the\n * `--capability` selector. `commands` emits the default command-only starter;\n * `hooks` additionally wires an `after_command` lifecycle reactor, `search`\n * wires an in-memory provider/adapter pair, and `importers` wires importer and\n * exporter command primitives so authors can customize project context movement\n * without starting from a blank extension.\n */\nexport const SCAFFOLD_CAPABILITIES = [\"commands\", \"hooks\", \"search\", \"importers\"] as const;\n\n/**\n * Restricts the `--capability` selector to a {@link SCAFFOLD_CAPABILITIES} value.\n */\nexport type ExtensionScaffoldCapability = (typeof SCAFFOLD_CAPABILITIES)[number];\n\nconst SCAFFOLD_MANIFEST_CAPABILITIES: Record<ExtensionScaffoldCapability, readonly string[]> = {\n  commands: [\"commands\"],\n  hooks: [\"commands\", \"hooks\"],\n  search: [\"commands\", \"search\"],\n  importers: [\"commands\", \"schema\", \"importers\"],\n};\n\nconst SAMPLE_TEST_CAPABILITIES_LITERAL: Record<ExtensionScaffoldCapability, string> = {\n  commands: '[\"commands\"]',\n  hooks: '[\"commands\", \"hooks\"]',\n  search: '[\"commands\", \"search\"]',\n  importers: '[\"commands\", \"schema\", \"importers\"]',\n};\n\nconst ENTRYPOINT_BULLETS: Record<ExtensionScaffoldCapability, string> = {\n  commands: \"- `index.js`: starter command registration plus a `deactivate` teardown stub.\",\n  hooks:\n    \"- `index.js`: starter command registration, an `after_command` lifecycle hook, and a `deactivate` teardown stub.\",\n  search:\n    \"- `index.js`: starter command registration, a search provider, a vector-store adapter, and a `deactivate` teardown stub.\",\n  importers:\n    \"- `index.js`: starter command registration, importer/exporter command registrations, and a `deactivate` teardown stub.\",\n};\n\nconst SAMPLE_TEST_BULLETS: Record<ExtensionScaffoldCapability, string> = {\n  commands:\n    \"- `index.test.js`: sample `node:test` suite covering activation, command invocation, and teardown via the SDK testing helpers.\",\n  hooks:\n    \"- `index.test.js`: sample `node:test` suite covering activation, command invocation, the after_command hook, and teardown via the SDK testing helpers.\",\n  search:\n    \"- `index.test.js`: sample `node:test` suite covering activation, command invocation, search provider/vector adapter invocation, and teardown via the SDK testing helpers.\",\n  importers:\n    \"- `index.test.js`: sample `node:test` suite covering activation, command invocation, importer/exporter invocation, and teardown via the SDK testing helpers.\",\n};\n\nconst PACKAGE_CAPABILITY_README_SECTIONS: Record<ExtensionScaffoldCapability, readonly string[]> = {\n  commands: [],\n  hooks: [\n    \"\",\n    \"## Lifecycle Hook\",\n    \"`index.js` registers an `after_command` hook via `api.hooks.afterCommand`.\",\n    \"pm fires it once a command finishes, passing the command outcome and the\",\n    \"items it mutated (`context.affected`). React there to keep external context\",\n    \"in sync - sync records, emit telemetry, or refresh derived state. The\",\n    \"`hooks` capability in `manifest.json` is what grants the hook registration;\",\n    \"remove it (and the hook) if your package only needs commands.\",\n  ],\n  search: [\n    \"\",\n    \"## Search Provider\",\n    \"`index.js` registers a deterministic in-memory search provider and\",\n    \"vector-store adapter through `api.registerSearchProvider` and\",\n    \"`api.registerVectorStoreAdapter`. Replace the sample scoring,\",\n    \"embedding, and storage behavior with your project-specific retrieval\",\n    \"logic. The `search` capability in `manifest.json` grants both\",\n    \"registrations.\",\n  ],\n  importers: [\n    \"\",\n    \"## Importer and Exporter\",\n    \"`index.js` registers paired project-context import/export commands through\",\n    \"`api.registerImporter` and `api.registerExporter`. Replace the starter\",\n    \"payloads with your domain adapter: GitHub issues, CSV rows, documents,\",\n    \"tickets, or another project-management source of truth. The `importers`\",\n    \"capability grants both registrations, and `schema` grants the example\",\n    \"command flag metadata.\",\n  ],\n};\n\nconst EXTENSION_CAPABILITY_README_SECTIONS: Record<ExtensionScaffoldCapability, readonly string[]> = {\n  commands: [],\n  hooks: [\n    \"\",\n    \"## Lifecycle Hook\",\n    \"`index.js` registers an `after_command` hook via `api.hooks.afterCommand`.\",\n    \"pm fires it once a command finishes, passing the command outcome and the\",\n    \"items it mutated (`context.affected`). React there to keep external context\",\n    \"in sync. The `hooks` capability in `manifest.json` grants the registration;\",\n    \"remove it (and the hook) if your extension only needs commands.\",\n  ],\n  search: [\n    \"\",\n    \"## Search Provider\",\n    \"`index.js` registers a deterministic in-memory search provider and\",\n    \"vector-store adapter through `api.registerSearchProvider` and\",\n    \"`api.registerVectorStoreAdapter`. Replace the sample scoring, embedding,\",\n    \"and storage behavior with your project-specific retrieval logic. The\",\n    \"`search` capability in `manifest.json` grants both registrations.\",\n  ],\n  importers: [\n    \"\",\n    \"## Importer and Exporter\",\n    \"`index.js` registers paired project-context import/export commands through\",\n    \"`api.registerImporter` and `api.registerExporter`. Replace the starter\",\n    \"payloads with your domain adapter. The `importers` capability grants both\",\n    \"registrations, and `schema` grants the example command flag metadata.\",\n  ],\n};\n\ninterface ExtensionScaffoldFileResult {\n  path: string;\n  status: \"created\" | \"unchanged\";\n}\n\ninterface ExtensionScaffoldResult {\n  extension_name: string;\n  command_name: string;\n  capability: ExtensionScaffoldCapability;\n  target_path: string;\n  created_directory: boolean;\n  files: ExtensionScaffoldFileResult[];\n}\n\n/**\n * Build the `activate` body lines for the starter entrypoint. The base body\n * always registers the starter command; capability-specific variants append\n * the matching SDK surface so generated packages demonstrate one runnable\n * customization primitive end to end.\n */\nfunction buildActivateBodyLines(\n  extensionName: string,\n  commandName: string,\n  capability: ExtensionScaffoldCapability,\n): string[] {\n  const searchProviderName = `${extensionName}-search`;\n  const vectorAdapterName = `${extensionName}-vector`;\n  const adapterName = `${extensionName.replace(/-/g, \" \")} items`;\n  const commandLines = [\n    \"  api.registerCommand({\",\n    `    name: ${JSON.stringify(commandName)},`,\n    '    description: \"Starter scaffold command. Replace with your own behavior.\",',\n    \"    run: async (context) => ({\",\n    \"      ok: true,\",\n    `      source: ${JSON.stringify(extensionName)},`,\n    \"      command: context.command,\",\n    '      message: \"Starter extension scaffold is active.\",',\n    \"    }),\",\n    \"  });\",\n  ];\n  if (capability === \"commands\") {\n    return commandLines;\n  }\n  if (capability === \"search\") {\n    return [\n      ...commandLines,\n      \"\",\n      \"  // Search providers let packages customize how pm ranks and retrieves\",\n      \"  // project context. This starter is deterministic and dependency-free:\",\n      \"  // replace the scoring with your domain retrieval, embedding, or rerank\",\n      \"  // logic as the package grows.\",\n      \"  api.registerSearchProvider({\",\n      `    name: ${JSON.stringify(searchProviderName)},`,\n      \"    query: async (context) => {\",\n      \"      const needle = context.query.toLowerCase();\",\n      \"      const hits = context.documents\",\n      \"        .filter((document) => {\",\n      \"          const title = String(document.metadata.title ?? \\\"\\\").toLowerCase();\",\n      \"          return title.includes(needle);\",\n      \"        })\",\n      \"        .map((document) => ({\",\n      \"          id: document.metadata.id,\",\n      \"          score: 1,\",\n      '          matched_fields: [\"title\"],',\n      \"        }));\",\n      \"      return { hits };\",\n      \"    },\",\n      \"    embed: async (context) => [context.input.length],\",\n      \"  });\",\n      \"\",\n      \"  // Vector-store adapters let packages own semantic index storage. This\",\n      \"  // starter returns a stable in-memory hit so generated tests can exercise\",\n      \"  // the adapter without external services.\",\n      \"  api.registerVectorStoreAdapter({\",\n      `    name: ${JSON.stringify(vectorAdapterName)},`,\n      \"    query: async (context) => [{ id: \\\"starter-vector-hit\\\", score: context.limit }],\",\n      \"    upsert: async (context) => ({ upserted: context.points.length }),\",\n      \"    delete: async (context) => ({ deleted: context.ids.length }),\",\n      \"  });\",\n    ];\n  }\n  if (capability === \"importers\") {\n    return [\n      ...commandLines,\n      \"\",\n      \"  // Importers/exporters are the bridge between pm's context graph and\",\n      \"  // another project-management system. Keep the starter deterministic so\",\n      \"  // package tests can run without touching the network or filesystem; replace\",\n      \"  // these payloads with your adapter's real mapping as the package grows.\",\n      \"  api.registerImporter(\",\n      `    ${JSON.stringify(adapterName)},`,\n      \"    async (context) => ({\",\n      \"      imported: 1,\",\n      \"      source: context.options.source ?? \\\"starter\\\",\",\n      \"      args: context.args,\",\n      \"    }),\",\n      \"    {\",\n      `      action: ${JSON.stringify(`${adapterName} import`)},`,\n      '      description: \"Import starter records into pm context.\",',\n      \"      flags: [\",\n      \"        {\",\n      '          long: \"--source\",',\n      '          value_name: \"name\",',\n      '          value_type: \"string\",',\n      '          description: \"Source name or path to import from.\",',\n      \"        },\",\n      \"      ],\",\n      \"    },\",\n      \"  );\",\n      \"\",\n      \"  api.registerExporter(\",\n      `    ${JSON.stringify(adapterName)},`,\n      \"    async (context) => ({\",\n      \"      exported: true,\",\n      \"      destination: context.options.destination ?? \\\"stdout\\\",\",\n      \"      args: context.args,\",\n      \"    }),\",\n      \"    {\",\n      `      action: ${JSON.stringify(`${adapterName} export`)},`,\n      '      description: \"Export pm context into starter records.\",',\n      \"      flags: [\",\n      \"        {\",\n      '          long: \"--destination\",',\n      '          value_name: \"name\",',\n      '          value_type: \"string\",',\n      '          description: \"Destination name or path to export to.\",',\n      \"        },\",\n      \"      ],\",\n      \"    },\",\n      \"  );\",\n    ];\n  }\n  return [\n    ...commandLines,\n    \"\",\n    \"  // after_command hooks fire once pm finishes a command, receiving the items\",\n    \"  // it mutated. This is the natural place to react to every change - sync to\",\n    \"  // an external system, emit telemetry, or refresh derived context\",\n    '  // (\"project management = context management\"). This starter is a documented',\n    \"  // no-op on the success path; replace the body with your own reaction.\",\n    \"  api.hooks.afterCommand((context) => {\",\n    \"    if (!context.ok) {\",\n    \"      return;\",\n    \"    }\",\n    \"    // `context.affected` lists the items pm mutated (id, status,\",\n    \"    // changed_fields). React here, e.g.:\",\n    \"    //   for (const item of context.affected ?? []) { /* ...item.id... */ }\",\n    \"  });\",\n  ];\n}\n\n/**\n * Build the colocated `node:test` sample suite for the chosen capability. Every\n * variant covers activation, command invocation, and teardown via the SDK\n * testing helpers; the `hooks` variant adds a test that asserts the\n * `after_command` hook is registered and fires cleanly through the public SDK\n * testing helper `runRegisteredHookForTest`.\n */\nfunction buildSampleTestSource(\n  extensionName: string,\n  commandName: string,\n  capability: ExtensionScaffoldCapability,\n): string {\n  const hooksEnabled = capability === \"hooks\";\n  const searchEnabled = capability === \"search\";\n  const importersEnabled = capability === \"importers\";\n  const capabilitiesLiteral = SAMPLE_TEST_CAPABILITIES_LITERAL[capability];\n  const searchProviderName = `${extensionName}-search`;\n  const vectorAdapterName = `${extensionName}-vector`;\n  const adapterName = `${extensionName.replace(/-/g, \" \")} items`;\n  const importNames = [\n    \"  activateExtensionForTest,\",\n    \"  assertExtensionDeactivated,\",\n    \"  assertRegisteredCommandContract,\",\n    ...(hooksEnabled ? [\"  assertRegisteredHook,\"] : []),\n    ...(searchEnabled ? [\"  assertRegisteredSearchProvider,\", \"  assertRegisteredVectorStoreAdapter,\"] : []),\n    ...(importersEnabled ? [\"  assertRegisteredImporter,\", \"  assertRegisteredExporter,\"] : []),\n    \"  deactivateExtensionForTest,\",\n    \"  runRegisteredCommandForTest,\",\n    ...(hooksEnabled ? [\"  runRegisteredHookForTest,\"] : []),\n    ...(searchEnabled ? [\"  runRegisteredSearchProviderForTest,\", \"  runRegisteredVectorStoreAdapterForTest,\"] : []),\n    ...(importersEnabled ? [\"  runRegisteredImporterForTest,\", \"  runRegisteredExporterForTest,\"] : []),\n  ];\n  const hookTestLines = hooksEnabled\n    ? [\n        `test(${JSON.stringify(`${extensionName} reacts to commands via its after_command hook`)}, async () => {`,\n        \"  const activation = await activateExtensionForTest(extension, {\",\n        `    name: ${JSON.stringify(extensionName)},`,\n        `    capabilities: ${capabilitiesLiteral},`,\n        \"  });\",\n        \"  // assertRegisteredHook throws unless an after_command hook is registered,\",\n        \"  // so reaching the next line already proves the hook is wired.\",\n        \"  assertRegisteredHook(activation.hooks, {\",\n        '    kind: \"after_command\",',\n        `    extensionName: ${JSON.stringify(extensionName)},`,\n        \"  });\",\n        \"  // runRegisteredHookForTest fires the hook through pm's real runner with a\",\n        \"  // synthetic context and returns the warnings it produced; a clean hook\",\n        \"  // returns none. Replace the context/assertions as your hook grows.\",\n        \"  const warnings = await runRegisteredHookForTest(activation.hooks, {\",\n        '    kind: \"after_command\",',\n        \"    context: {\",\n        `      command: ${JSON.stringify(commandName)},`,\n        \"      args: [],\",\n        '      pm_root: \"\",',\n        \"      ok: true,\",\n        \"      affected: [],\",\n        \"    },\",\n        \"  });\",\n        \"  assert.deepEqual(warnings, []);\",\n        \"});\",\n        \"\",\n      ]\n    : [];\n  const searchTestLines = searchEnabled\n    ? [\n        `test(${JSON.stringify(`${extensionName} registers and invokes search primitives`)}, async () => {`,\n        \"  const activation = await activateExtensionForTest(extension, {\",\n        `    name: ${JSON.stringify(extensionName)},`,\n        `    capabilities: ${capabilitiesLiteral},`,\n        \"  });\",\n        \"  assertRegisteredSearchProvider(activation.registrations, {\",\n        `    provider: ${JSON.stringify(searchProviderName)},`,\n        `    extensionName: ${JSON.stringify(extensionName)},`,\n        \"  });\",\n        \"  assertRegisteredVectorStoreAdapter(activation.registrations, {\",\n        `    adapter: ${JSON.stringify(vectorAdapterName)},`,\n        `    extensionName: ${JSON.stringify(extensionName)},`,\n        \"  });\",\n        \"\",\n        \"  const query = await runRegisteredSearchProviderForTest(activation.registrations, {\",\n        `    provider: ${JSON.stringify(searchProviderName)},`,\n        '    operation: \"query\",',\n        \"    context: {\",\n        '      query: \"sync\",',\n        '      mode: \"semantic\",',\n        '      tokens: [\"sync\"],',\n        \"      options: {},\",\n        \"      settings: {},\",\n        \"      documents: [\",\n        '        { metadata: { id: \"pm-1\", title: \"Sync external context\" }, body: \"\" },',\n        '        { metadata: { id: \"pm-2\", title: \"Unrelated task\" }, body: \"\" },',\n        \"      ],\",\n        \"    },\",\n        \"  });\",\n        '  assert.deepEqual(query, { hits: [{ id: \"pm-1\", score: 1, matched_fields: [\"title\"] }] });',\n        \"\",\n        \"  const embedding = await runRegisteredSearchProviderForTest(activation.registrations, {\",\n        `    provider: ${JSON.stringify(searchProviderName)},`,\n        '    operation: \"embed\",',\n        '    context: { input: \"abc\", settings: {}, model: \"starter-model\" },',\n        \"  });\",\n        \"  assert.deepEqual(embedding, [3]);\",\n        \"\",\n        \"  const vectorHits = await runRegisteredVectorStoreAdapterForTest(activation.registrations, {\",\n        `    adapter: ${JSON.stringify(vectorAdapterName)},`,\n        '    operation: \"query\",',\n        \"    context: { vector: [0.1, 0.2], limit: 2, settings: {} },\",\n        \"  });\",\n        '  assert.deepEqual(vectorHits, [{ id: \"starter-vector-hit\", score: 2 }]);',\n        \"});\",\n        \"\",\n      ]\n    : [];\n  const importerTestLines = importersEnabled\n    ? [\n        `test(${JSON.stringify(`${extensionName} registers and invokes import/export primitives`)}, async () => {`,\n        \"  const activation = await activateExtensionForTest(extension, {\",\n        `    name: ${JSON.stringify(extensionName)},`,\n        `    capabilities: ${capabilitiesLiteral},`,\n        \"  });\",\n        \"  assertRegisteredImporter(activation.registrations, {\",\n        `    importer: ${JSON.stringify(adapterName)},`,\n        `    extensionName: ${JSON.stringify(extensionName)},`,\n        \"  });\",\n        \"  assertRegisteredExporter(activation.registrations, {\",\n        `    exporter: ${JSON.stringify(adapterName)},`,\n        `    extensionName: ${JSON.stringify(extensionName)},`,\n        \"  });\",\n        \"\",\n        \"  const imported = await runRegisteredImporterForTest(activation, {\",\n        `    importer: ${JSON.stringify(adapterName)},`,\n        '    options: { source: \"tickets\" },',\n        '    args: [\"batch-1\"],',\n        \"  });\",\n        \"  assert.equal(imported.handled, true);\",\n        '  assert.deepEqual(imported.result, { imported: 1, source: \"tickets\", args: [\"batch-1\"] });',\n        \"\",\n        \"  const exported = await runRegisteredExporterForTest(activation, {\",\n        `    exporter: ${JSON.stringify(adapterName)},`,\n        '    options: { destination: \"archive\" },',\n        '    args: [\"done\"],',\n        \"  });\",\n        \"  assert.equal(exported.handled, true);\",\n        '  assert.deepEqual(exported.result, { exported: true, destination: \"archive\", args: [\"done\"] });',\n        \"});\",\n        \"\",\n      ]\n    : [];\n  return [\n    'import assert from \"node:assert/strict\";',\n    'import { test } from \"node:test\";',\n    \"import {\",\n    ...importNames,\n    '} from \"@unbrained/pm-cli/sdk/testing\";',\n    'import extension from \"./index.js\";',\n    \"\",\n    `test(${JSON.stringify(`${extensionName} registers its starter command`)}, async () => {`,\n    \"  // `capabilities` mirrors manifest.json so the in-memory activation grants\",\n    \"  // the capabilities the entrypoint relies on.\",\n    \"  const activation = await activateExtensionForTest(extension, {\",\n    `    name: ${JSON.stringify(extensionName)},`,\n    `    capabilities: ${capabilitiesLiteral},`,\n    \"  });\",\n    \"  // assertRegisteredCommandContract throws if the command is not\",\n    \"  // registered, so reaching here already proves the wiring; assert on the\",\n    \"  // returned definition to demonstrate inspecting registered metadata.\",\n    \"  const registered = assertRegisteredCommandContract(activation.registrations, {\",\n    `    command: ${JSON.stringify(commandName)},`,\n    `    extensionName: ${JSON.stringify(extensionName)},`,\n    \"  });\",\n    '  assert.equal(typeof registered.command.description, \"string\");',\n    \"\",\n    \"  // runRegisteredCommandForTest invokes the handler through pm's real\",\n    \"  // dispatch engine, so this asserts behavior - not just that the command\",\n    \"  // is wired. Replace these assertions as you flesh out your command.\",\n    \"  const invocation = await runRegisteredCommandForTest(activation.commands, {\",\n    `    command: ${JSON.stringify(commandName)},`,\n    \"  });\",\n    \"  assert.equal(invocation.handled, true);\",\n    \"  assert.equal(invocation.result.ok, true);\",\n    `  assert.equal(invocation.result.command, ${JSON.stringify(commandName)});`,\n    \"});\",\n    \"\",\n    ...hookTestLines,\n    ...searchTestLines,\n    ...importerTestLines,\n    `test(${JSON.stringify(`${extensionName} tears down cleanly via deactivate`)}, async () => {`,\n    \"  // deactivateExtensionForTest runs pm's real teardown engine over the\",\n    \"  // module, so this proves your `deactivate` hook runs without throwing.\",\n    \"  const teardown = await deactivateExtensionForTest(extension, {\",\n    `    name: ${JSON.stringify(extensionName)},`,\n    \"  });\",\n    \"  // assertExtensionDeactivated throws unless exactly one extension tore down\",\n    \"  // with no failures, so reaching the next line already proves teardown ran.\",\n    \"  assertExtensionDeactivated(teardown);\",\n    \"  assert.equal(teardown.deactivated, 1);\",\n    \"});\",\n    \"\",\n  ].join(\"\\n\");\n}\n\n/**\n * Implements build starter extension scaffold files for the public runtime surface of this module.\n */\nexport function buildStarterExtensionScaffoldFiles(\n  extensionName: string,\n  commandName: string,\n  vocabulary: \"extension\" | \"package\",\n  capability: ExtensionScaffoldCapability = \"commands\",\n): Record<string, string> {\n  const packageName = `pm-${extensionName}`;\n  const capabilities = SCAFFOLD_MANIFEST_CAPABILITIES[capability];\n  const manifest = `${JSON.stringify(\n    {\n      name: extensionName,\n      version: \"0.1.0\",\n      entry: \"./index.js\",\n      manifest_version: SCAFFOLD_MANIFEST_VERSION,\n      pm_min_version: SCAFFOLD_PM_MIN_VERSION,\n      trusted: true,\n      sandbox_profile: \"strict\",\n      permissions: { ...SCAFFOLD_DECLARED_PERMISSIONS },\n      capabilities,\n    },\n    null,\n    2,\n  )}\\n`;\n  // Keep scaffolds dependency-light by default: even package mode can be\n  // installed before peer dependencies are materialized in the generated root.\n  // The JSDoc import preserves editor narrowing without forcing the runtime\n  // loader to resolve @unbrained/pm-cli/sdk from a freshly generated scaffold.\n  const entrypoint = [\n    '/** @param {import(\"@unbrained/pm-cli/sdk\").ExtensionApi} api */',\n    \"export function activate(api) {\",\n    ...buildActivateBodyLines(extensionName, commandName, capability),\n    \"}\",\n    \"\",\n    \"// `deactivate` is the teardown counterpart to `activate`: pm runs it on host\",\n    \"// shutdown/reload (e.g. the MCP server between requests) to release anything\",\n    \"// `activate` opened - timers, connections, caches. This starter holds no such\",\n    \"// resources, so it stays a documented no-op; add cleanup here as you grow.\",\n    \"export function deactivate() {}\",\n    \"\",\n    \"export default {\",\n    \"  activate,\",\n    \"  deactivate,\",\n    \"};\",\n    \"\",\n  ].join(\"\\n\");\n  // README bullet describing what index.js wires, kept in sync with the chosen\n  // capability so the generated docs match the generated code.\n  const entrypointBullet = ENTRYPOINT_BULLETS[capability];\n  if (vocabulary === \"package\") {\n    const packageJson = `${JSON.stringify(\n      {\n        name: packageName,\n        version: \"0.1.0\",\n        private: true,\n        type: \"module\",\n        keywords: [\"pm-package\"],\n        // `node --test` runs the colocated *.test.js sample against the peer SDK\n        // testing helpers; no extra dev-dependency or test runner is required.\n        scripts: {\n          test: \"node --test\",\n        },\n        peerDependencies: {\n          \"@unbrained/pm-cli\": \"*\",\n        },\n        pm: {\n          aliases: [extensionName],\n          extensions: [\".\"],\n          docs: [\"README.md\"],\n          examples: [\"README.md\"],\n          catalog: {\n            display_name: extensionName,\n            category: \"workflow\",\n            summary: \"Starter pm package scaffold.\",\n            tags: [\"starter\"],\n          },\n        },\n      },\n      null,\n      2,\n    )}\\n`;\n    // node:test sample: demonstrates validating the package with the SDK testing\n    // helpers without adding a third-party test runner. The suite covers the\n    // capability the scaffold targets (command invocation, and for the hooks\n    // capability, the after_command lifecycle hook).\n    const sampleTest = buildSampleTestSource(extensionName, commandName, capability);\n    const sampleTestBullet = SAMPLE_TEST_BULLETS[capability];\n    const gitignore = [\"node_modules/\", \"*.log\", \"\"].join(\"\\n\");\n    const searchProviderName = `${extensionName}-search`;\n    const vectorAdapterName = `${extensionName}-vector`;\n    const adapterName = `${extensionName.replace(/-/g, \" \")} items`;\n    const defineBuilderImports = [\n      \"defineCommand\",\n      ...(capability === \"hooks\" ? [\"defineAfterCommandHook\"] : []),\n      ...(capability === \"search\" ? [\"defineSearchProvider\", \"defineVectorStoreAdapter\"] : []),\n      ...(capability === \"importers\" ? [\"defineImporter\", \"defineExporter\"] : []),\n    ].join(\", \");\n    const defineBuilderSnippet = [\n      \"```js\",\n      `import { ${defineBuilderImports} } from \"@unbrained/pm-cli/sdk\";`,\n      \"\",\n      \"export const pingCommand = defineCommand({\",\n      `  name: ${JSON.stringify(commandName)},`,\n      '  description: \"Starter scaffold command. Replace with your own behavior.\",',\n      \"  run: (context) => ({ ok: true, command: context.command }),\",\n      \"});\",\n    ];\n    if (capability === \"hooks\") {\n      defineBuilderSnippet.push(\n        \"\",\n        \"export const afterCommandHook = defineAfterCommandHook((context) => {\",\n        \"  if (!context.ok) return;\",\n        \"  // React to context.affected here as your package grows.\",\n        \"});\",\n      );\n    }\n    if (capability === \"search\") {\n      defineBuilderSnippet.push(\n        \"\",\n        \"export const searchProvider = defineSearchProvider({\",\n        `  name: ${JSON.stringify(searchProviderName)},`,\n        \"  query: async (context) => ({\",\n        \"    hits: context.documents\",\n        \"      .filter((document) => String(document.metadata.title ?? \\\"\\\").toLowerCase().includes(context.query.toLowerCase()))\",\n        \"      .map((document) => ({ id: document.metadata.id, score: 1, matched_fields: [\\\"title\\\"] })),\",\n        \"  }),\",\n        \"  embed: async (context) => [context.input.length],\",\n        \"});\",\n        \"\",\n        \"export const vectorStoreAdapter = defineVectorStoreAdapter({\",\n        `  name: ${JSON.stringify(vectorAdapterName)},`,\n        \"  query: async (context) => [{ id: \\\"starter-vector-hit\\\", score: context.limit }],\",\n        \"  upsert: async (context) => ({ upserted: context.points.length }),\",\n        \"  delete: async (context) => ({ deleted: context.ids.length }),\",\n        \"});\",\n      );\n    }\n    if (capability === \"importers\") {\n      defineBuilderSnippet.push(\n        \"\",\n        \"export const importer = defineImporter(async (context) => ({\",\n        \"  imported: 1,\",\n        \"  source: context.options.source ?? \\\"starter\\\",\",\n        \"  args: context.args,\",\n        \"}));\",\n        \"\",\n        \"export const exporter = defineExporter(async (context) => ({\",\n        \"  exported: true,\",\n        \"  destination: context.options.destination ?? \\\"stdout\\\",\",\n        \"  args: context.args,\",\n        \"}));\",\n      );\n    }\n    defineBuilderSnippet.push(\n      \"\",\n      \"export function activate(api) {\",\n      \"  api.registerCommand(pingCommand);\",\n    );\n    if (capability === \"hooks\") {\n      defineBuilderSnippet.push(\"  api.hooks.afterCommand(afterCommandHook);\");\n    }\n    if (capability === \"search\") {\n      defineBuilderSnippet.push(\"  api.registerSearchProvider(searchProvider);\", \"  api.registerVectorStoreAdapter(vectorStoreAdapter);\");\n    }\n    if (capability === \"importers\") {\n      defineBuilderSnippet.push(\n        `  api.registerImporter(${JSON.stringify(adapterName)}, importer, {`,\n        `    action: ${JSON.stringify(`${adapterName} import`)},`,\n        '    description: \"Import starter records into pm context.\",',\n        \"    flags: [\",\n        \"      {\",\n        '        long: \"--source\",',\n        '        value_name: \"name\",',\n        '        value_type: \"string\",',\n        '        description: \"Source name or path to import from.\",',\n        \"      },\",\n        \"    ],\",\n        \"  });\",\n        `  api.registerExporter(${JSON.stringify(adapterName)}, exporter, {`,\n        `    action: ${JSON.stringify(`${adapterName} export`)},`,\n        '    description: \"Export pm context into starter records.\",',\n        \"    flags: [\",\n        \"      {\",\n        '        long: \"--destination\",',\n        '        value_name: \"name\",',\n        '        value_type: \"string\",',\n        '        description: \"Destination name or path to export to.\",',\n        \"      },\",\n        \"    ],\",\n        \"  });\",\n      );\n    }\n    defineBuilderSnippet.push(\n      \"}\",\n      \"\",\n      \"export function deactivate() {}\",\n      \"\",\n      \"export default { activate, deactivate };\",\n      \"```\",\n    );\n    const packageReadme = [\n      `# ${packageName}`,\n      \"\",\n      \"Generated by `pm package init`.\",\n      \"\",\n      \"## Included Files\",\n      \"- `package.json`: package metadata, `test` script, and `pm` resource manifest.\",\n      \"- `manifest.json`: extension metadata and capabilities.\",\n      entrypointBullet,\n      sampleTestBullet,\n      \"- `.gitignore`: ignores `node_modules/` and log files.\",\n      \"\",\n      \"## Quick Start\",\n      \"```bash\",\n      \"pm install --project <package-path>\",\n      `pm ${commandName}`,\n      \"pm package doctor --project --detail summary\",\n      \"```\",\n      \"\",\n      \"## Validate the Package\",\n      \"Install the peer SDK once, then run the colocated sample test:\",\n      \"```bash\",\n      \"npm install\",\n      \"npm test\",\n      \"```\",\n      \"`npm test` runs `node --test`, which executes `index.test.js` against the\",\n      \"`@unbrained/pm-cli/sdk/testing` helpers - no extra test runner required.\",\n      \"\",\n      \"## Authoring With define* Builders\",\n      \"`index.js` stays import-free so the package can be installed locally before\",\n      \"`npm install` materializes peer dependencies. After installing dependencies,\",\n      \"use the public SDK authoring builders for exported definitions you want\",\n      \"editor type-checking, contextual handler inference, and direct unit tests for:\",\n      ...defineBuilderSnippet,\n      \"The builders return their argument unchanged; runtime validation still lives\",\n      \"in `api.register*`, and behavior validation lives in `sdk/testing`.\",\n      ...PACKAGE_CAPABILITY_README_SECTIONS[capability],\n      \"\",\n      \"## Compatibility Bounds\",\n      \"`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:\",\n      `- \\`manifest_version\\` (integer): manifest schema generation. Leave at \\`${SCAFFOLD_MANIFEST_VERSION}\\` unless you adopt a newer manifest schema.`,\n      `- \\`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.`,\n      \"- `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.\",\n      \"\",\n      \"## Policy Metadata\",\n      \"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`.\",\n      \"\",\n      \"## Notes\",\n      \"- Keep simple starter runtime behavior at the package root so local installs work without dependency bootstrapping.\",\n      \"- Move larger runtimes into subdirectories only after adding package dependencies and validating `pm package doctor`.\",\n      \"- Add capabilities to the extension manifest only when the entrypoint uses the matching SDK API.\",\n      \"- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.\",\n      \"\",\n    ].join(\"\\n\");\n    return {\n      \"package.json\": packageJson,\n      \"manifest.json\": manifest,\n      \"index.js\": entrypoint,\n      \"index.test.js\": sampleTest,\n      \".gitignore\": gitignore,\n      \"README.md\": packageReadme,\n    };\n  }\n  const readme = [\n    `# ${extensionName}`,\n    \"\",\n    \"Generated by `pm extension init`.\",\n    \"\",\n    \"## Included Files\",\n    \"- `manifest.json`: extension metadata and capabilities.\",\n    entrypointBullet,\n    \"\",\n    \"## Quick Start\",\n    \"```bash\",\n    \"pm extension --install --project <scaffold-path>\",\n    `pm ${commandName}`,\n    \"pm extension --doctor --project --detail summary\",\n    \"```\",\n    ...EXTENSION_CAPABILITY_README_SECTIONS[capability],\n    \"\",\n    \"## Compatibility Bounds\",\n    \"`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:\",\n    `- \\`manifest_version\\` (integer): manifest schema generation. Leave at \\`${SCAFFOLD_MANIFEST_VERSION}\\` unless you adopt a newer manifest schema.`,\n    `- \\`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.`,\n    \"- `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.\",\n    \"\",\n    \"## Policy Metadata\",\n    \"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`.\",\n    \"\",\n    \"## Notes\",\n    \"- This scaffold uses ESM exports so it works in package scopes with `type: module`.\",\n    \"- Update `manifest.json` capabilities and `index.js` command behavior as your extension evolves.\",\n    \"- Release any resources `activate` opens (timers, connections, caches) in the `deactivate` teardown hook.\",\n    \"\",\n  ].join(\"\\n\");\n  return {\n    \"manifest.json\": manifest,\n    \"index.js\": entrypoint,\n    \"README.md\": readme,\n  };\n}\n\n/**\n * Implements scaffold extension project for the public runtime surface of this module.\n */\nexport async function scaffoldExtensionProject(\n  target: string,\n  vocabulary: \"extension\" | \"package\" = \"extension\",\n  capability: string = \"commands\",\n): Promise<ExtensionScaffoldResult> {\n  const normalizedCapability = capability.trim().toLowerCase();\n  if (!(SCAFFOLD_CAPABILITIES as readonly string[]).includes(normalizedCapability)) {\n    throw new PmCliError(\n      `Unknown scaffold capability \"${capability}\". Supported capabilities: ${SCAFFOLD_CAPABILITIES.join(\", \")}.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  const resolvedCapability = normalizedCapability as ExtensionScaffoldCapability;\n  const normalizedTarget = target.trim();\n  const targetPath = path.resolve(process.cwd(), normalizedTarget);\n  const extensionName = normalizeManagedDirectoryName(path.basename(targetPath));\n  // Hyphenated top-level command groups can surface in help but fail dispatch in\n  // Commander, so generated starters use space-separated command words while the\n  // manifest and package identity keep their normalized directory names.\n  const commandName = `${extensionName.replace(/-/g, \" \")} ping`;\n  const scaffoldFiles = buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabulary, resolvedCapability);\n\n  let createdDirectory = false;\n  if (await pathExists(targetPath)) {\n    const existingTargetStats = await fs.stat(targetPath);\n    if (!existingTargetStats.isDirectory()) {\n      throw new PmCliError(\n        `Scaffold target \"${targetPath}\" exists and is not a directory.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n  } else {\n    await fs.mkdir(targetPath, { recursive: true });\n    createdDirectory = true;\n  }\n\n  for (const [relativePath, content] of Object.entries(scaffoldFiles)) {\n    const absolutePath = path.join(targetPath, relativePath);\n    if (!(await pathExists(absolutePath))) {\n      continue;\n    }\n    const existingContent = await fs.readFile(absolutePath, \"utf8\");\n    if (existingContent !== content) {\n      throw new PmCliError(\n        `Scaffold file \"${relativePath}\" already exists with different content in \"${targetPath}\". Choose a new target path or remove conflicting files.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n  }\n\n  const files: ExtensionScaffoldFileResult[] = [];\n  for (const [relativePath, content] of Object.entries(scaffoldFiles)) {\n    const absolutePath = path.join(targetPath, relativePath);\n    if (await pathExists(absolutePath)) {\n      files.push({\n        path: relativePath,\n        status: \"unchanged\",\n      });\n      continue;\n    }\n    await fs.mkdir(path.dirname(absolutePath), { recursive: true });\n    await fs.writeFile(absolutePath, content, \"utf8\");\n    files.push({\n      path: relativePath,\n      status: \"created\",\n    });\n  }\n\n  return {\n    extension_name: extensionName,\n    command_name: commandName,\n    capability: resolvedCapability,\n    target_path: targetPath,\n    created_directory: createdDirectory,\n    files,\n  };\n}\n"],"names":[],"mappings":"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S;AAC1B,2BAAqB,KAAK,6CAA6C;IACzE;AACA,QAAI,eAAe,UAAU;AAC3B,2BAAqB,KAAK,iDAAiD,uDAAuD;IACpI;AACA,QAAI,eAAe,aAAa;AAC9B,2BAAqB,KACnB,0BAA0B,KAAK,UAAU,WAAW,CAAC,iBACrD,eAAe,KAAK,UAAU,GAAG,WAAW,SAAS,CAAC,KACtD,+DACA,gBACA,WACA,6BACA,+BACA,iCACA,+DACA,YACA,UACA,SACA,0BAA0B,KAAK,UAAU,WAAW,CAAC,iBACrD,eAAe,KAAK,UAAU,GAAG,WAAW,SAAS,CAAC,KACtD,+DACA,gBACA,WACA,kCACA,+BACA,iCACA,kEACA,YACA,UACA,OAAO;IAEX;AACA,yBAAqB,KACnB,KACA,IACA,mCACA,IACA,4CACA,KAAK;AAEP,UAAM,gBAAgB;MACpB,KAAK,WAAW;MAChB;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA,MAAM,WAAW;MACjB;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA,GAAG;MACH;MACA;MACA,GAAG,mCAAmC,UAAU;MAChD;MACA;MACA;MACA,4EAA4E,yBAAyB;MACrG,oGAAoG,uBAAuB;MAC3H;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA,KAAK,IAAI;AACX,WAAO;MACL,gBAAgB;MAChB,iBAAiB;MACjB,YAAY;MACZ,iBAAiB;MACjB,cAAc;MACd,aAAa;;EAEjB;AACA,QAAM,SAAS;IACb,KAAK,aAAa;IAClB;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,MAAM,WAAW;IACjB;IACA;IACA,GAAG,qCAAqC,UAAU;IAClD;IACA;IACA;IACA,4EAA4E,yBAAyB;IACrG,sGAAsG,uBAAuB;IAC7H;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,KAAK,IAAI;AACX,SAAO;IACL,iBAAiB;IACjB,YAAY;IACZ,aAAa;;AAEjB;AAKA,eAAsB,yBACpB,QACA,aAAsC,aACtC,aAAqB,YAAU;AAE/B,QAAM,uBAAuB,WAAW,KAAI,EAAG,YAAW;AAC1D,MAAI,CAAE,sBAA4C,SAAS,oBAAoB,GAAG;AAChF,UAAM,IAAI,WACR,gCAAgC,UAAU,8BAA8B,sBAAsB,KAAK,IAAI,CAAC,KACxG,UAAU,KAAK;EAEnB;AACA,QAAM,qBAAqB;AAC3B,QAAM,mBAAmB,OAAO,KAAI;AACpC,QAAM,aAAa,KAAK,QAAQ,QAAQ,IAAG,GAAI,gBAAgB;AAC/D,QAAM,gBAAgB,8BAA8B,KAAK,SAAS,UAAU,CAAC;AAI7E,QAAM,cAAc,GAAG,cAAc,QAAQ,MAAM,GAAG,CAAC;AACvD,QAAM,gBAAgB,mCAAmC,eAAe,aAAa,YAAY,kBAAkB;AAEnH,MAAI,mBAAmB;AACvB,MAAI,MAAM,WAAW,UAAU,GAAG;AAChC,UAAM,sBAAsB,MAAM,GAAG,KAAK,UAAU;AACpD,QAAI,CAAC,oBAAoB,YAAW,GAAI;AACtC,YAAM,IAAI,WACR,oBAAoB,UAAU,oCAC9B,UAAU,QAAQ;IAEtB;EACF,OAAO;AACL,UAAM,GAAG,MAAM,YAAY,EAAE,WAAW,KAAI,CAAE;AAC9C,uBAAmB;EACrB;AAEA,aAAW,CAAC,cAAc,OAAO,KAAK,OAAO,QAAQ,aAAa,GAAG;AACnE,UAAM,eAAe,KAAK,KAAK,YAAY,YAAY;AACvD,QAAI,CAAE,MAAM,WAAW,YAAY,GAAI;AACrC;IACF;AACA,UAAM,kBAAkB,MAAM,GAAG,SAAS,cAAc,MAAM;AAC9D,QAAI,oBAAoB,SAAS;AAC/B,YAAM,IAAI,WACR,kBAAkB,YAAY,+CAA+C,UAAU,4DACvF,UAAU,QAAQ;IAEtB;EACF;AAEA,QAAM,QAAuC,CAAA;AAC7C,aAAW,CAAC,cAAc,OAAO,KAAK,OAAO,QAAQ,aAAa,GAAG;AACnE,UAAM,eAAe,KAAK,KAAK,YAAY,YAAY;AACvD,QAAI,MAAM,WAAW,YAAY,GAAG;AAClC,YAAM,KAAK;QACT,MAAM;QACN,QAAQ;OACT;AACD;IACF;AACA,UAAM,GAAG,MAAM,KAAK,QAAQ,YAAY,GAAG,EAAE,WAAW,KAAI,CAAE;AAC9D,UAAM,GAAG,UAAU,cAAc,SAAS,MAAM;AAChD,UAAM,KAAK;MACT,MAAM;MACN,QAAQ;KACT;EACH;AAEA,SAAO;IACL,gBAAgB;IAChB,cAAc;IACd,YAAY;IACZ,aAAa;IACb,mBAAmB;IACnB;;AAEJ","debugId":"3f18c01e-ca66-5960-9c35-194a3ad7d38c"}