@unbrained/pm-cli 2026.6.24 → 2026.7.1

package/docs/TESTING.md

@@ -20,6 +20,7 @@ Tracked documentation work: [pm-u9d0](../.agents/pm/epics/pm-u9d0.toon).
 
 ```bash
 pnpm build
+pnpm lint
 pnpm typecheck
 node scripts/run-tests.mjs test
 node scripts/run-tests.mjs coverage
@@ -27,6 +28,17 @@ node scripts/run-tests.mjs coverage
 
 `node scripts/run-tests.mjs` wraps Vitest in temporary tracker roots, then cleans them up.
 
+`pnpm lint` is the local CodeFactor parity check. It layers ESLint rules for
+shipped source, package, plugin, and script surfaces that match the CodeFactor
+maintainability findings this repo tracks (`complexity`,
+`no-unsafe-optional-chaining`, and the relevant `eslint-plugin-unicorn`
+mechanical rules), jscpd duplicate detection across source and tests, and the
+repo-specific `quality:static` gate. The dedicated `quality:static` gate remains
+authoritative for source/exported docstring coverage, orphan-module checks,
+directory-load caps, and the TypeScript-aware duplicate/complexity checks that
+are tailored to pm's source layout; `pnpm lint` delegates to it instead of
+running a second threshold profile.
+
 ## Focused Test Runs
 
 ```bash

package/docs/examples/policy-restricted-extension/README.md

@@ -2,6 +2,12 @@
 
 This example demonstrates governance policy behavior with real registrations.
 
+It is authored **and loaded** as TypeScript (ADR pm-2c28 / pm-m1uz): `index.ts` is
+both the source and the manifest `entry`, imported directly via Node's native type
+stripping — there is no compile step and no committed `index.js`. Edit `index.ts`
+and the change takes effect on the next install/reload; run `npx tsc --noEmit` to
+type-check.
+
 The extension declares:
 
 - `commands` (handler registration)

package/docs/examples/policy-restricted-extension/index.ts

@@ -0,0 +1,40 @@
+/**
+ * @module docs/examples/policy-restricted-extension
+ *
+ * Minimal TypeScript-first reference extension for governance-policy demos. It
+ * registers exactly three surfaces — a command handler, a `beforeCommand` hook,
+ * and an `output_format` service override — so an operator can enforce policy
+ * that keeps the command and hook allowed while blocking the service override
+ * (see the accompanying README).
+ *
+ * As with the starter example, the source is authored in TypeScript against the
+ * published SDK types and is itself the `./index.ts` manifest entry the loader
+ * imports directly via Node's native type stripping (ADR pm-2c28 / pm-m1uz) — no
+ * compile step and no committed `.js`. Typing `activate(api: ExtensionApi)` is
+ * enough for the service override's `context` parameter to be inferred as a
+ * `ServiceOverrideContext`, which is why this handler returns `context.payload`
+ * (the value to format) rather than the whole context object.
+ */
+import { defineExtension } from "@unbrained/pm-cli/sdk";
+import type { ExtensionApi } from "@unbrained/pm-cli/sdk";
+
+export default defineExtension({
+  activate(api: ExtensionApi): void {
+    api.registerCommand({
+      name: "policy demo",
+      action: "policy-demo",
+      description: "Emit a deterministic payload to validate policy-gated activation.",
+      run: async (context) => ({
+        ok: true,
+        command: context.command,
+        source: "policy-restricted-extension",
+      }),
+    });
+
+    api.hooks.beforeCommand(() => {});
+
+    // This registration is intentionally useful for policy demos: an identity
+    // output_format override that returns the formatting payload unchanged.
+    api.registerService("output_format", (context) => context.payload);
+  },
+});

package/docs/examples/policy-restricted-extension/manifest.json

@@ -1,9 +1,9 @@
 {
   "name": "policy-restricted-extension",
   "version": "0.1.0",
-  "entry": "./index.js",
+  "entry": "./index.ts",
   "manifest_version": 2,
-  "pm_min_version": "2026.5.0",
+  "pm_min_version": "2026.6.24",
   "trusted": true,
   "provenance": {
     "source": "docs/examples/policy-restricted-extension",

package/docs/examples/starter-extension/README.md

@@ -6,9 +6,21 @@ Use it to learn APIs, then narrow capabilities for production extensions.
 
 ## Contents
 
-- `manifest.json` -> extension metadata/capabilities
+- `manifest.json` -> extension metadata/capabilities (the `entry` points at `index.ts`)
 - `package.json` -> local dependency metadata
-- `index.js` -> capability demonstrations
+- `index.ts` -> TypeScript source AND the manifest entry the loader imports directly
+
+## Authoring (TypeScript-first)
+
+Per ADR pm-2c28 / pm-m1uz, pm extensions are authored **and loaded** as TypeScript:
+`index.ts` is both the source and the manifest `entry`, and pm imports it directly
+via Node's native type stripping (Node >=22.18) — there is no compile step and no
+committed `index.js`, exactly like the first-party `packages/pm-*` extensions. Copy
+this example and run it as-is; after editing `index.ts` the change takes effect on
+the next install/reload. Run `npx tsc --noEmit` to type-check, or scaffold a new
+extension via `pm extension init`. Typing only `activate(api: ExtensionApi)` is
+enough for every nested handler's `context` to be inferred from the SDK
+registration contracts.
 
 ## End-to-End Run
 

package/docs/examples/starter-extension/{index.js → index.ts}

@@ -1,6 +1,38 @@
+/**
+ * @module docs/examples/starter-extension
+ *
+ * TypeScript-first reference extension that exercises every pm extension
+ * capability surface (commands, parser, preflight, services, renderers, hooks,
+ * schema, importers/exporters, search). It is the author-facing companion to the
+ * first-party `packages/pm-*` extensions: the source is authored in TypeScript
+ * against the published SDK types (`@unbrained/pm-cli/sdk`) and is itself the
+ * `./index.ts` manifest entry the loader imports directly via Node's native type
+ * stripping (Node >=22.18) — no compile step and no committed `.js`, per ADR
+ * pm-2c28 ("authored fully in TypeScript") and pm-m1uz ("authored AND loaded as
+ * TypeScript").
+ *
+ * Typing `activate(api: ExtensionApi)` is the only annotation an author needs:
+ * every nested handler (`run`, parser/preflight/service/renderer overrides,
+ * search provider, vector store adapter) then has its `context` parameter
+ * inferred from the SDK registration contracts, so capability misuse is caught
+ * at author time instead of at `api.register*`/load time.
+ */
 import { defineExtension } from "@unbrained/pm-cli/sdk";
+import type { ExtensionApi } from "@unbrained/pm-cli/sdk";
 
-const runtimeState = {
+/**
+ * Mutable per-activation counters the lifecycle hooks increment so the
+ * `starter ping` command can echo how many times each hook kind has fired.
+ */
+interface StarterRuntimeState {
+  beforeCommandCount: number;
+  afterCommandCount: number;
+  onWriteCount: number;
+  onReadCount: number;
+  onIndexCount: number;
+}
+
+const runtimeState: StarterRuntimeState = {
   beforeCommandCount: 0,
   afterCommandCount: 0,
   onWriteCount: 0,
@@ -8,18 +40,31 @@ const runtimeState = {
   onIndexCount: 0,
 };
 
-function asRecord(value) {
+/**
+ * Narrow an unknown value to a plain string-keyed record, returning an empty
+ * object for arrays, `null`, and non-objects so handlers can index defensively
+ * even when invoked with partially-shaped runtime payloads.
+ */
+function asRecord(value: unknown): Record<string, unknown> {
   if (typeof value === "object" && value !== null && !Array.isArray(value)) {
-    return value;
+    return value as Record<string, unknown>;
   }
   return {};
 }
 
-function asString(value, fallback = "") {
+/**
+ * Coerce an unknown value to a string, falling back to `fallback` (default `""`)
+ * for any non-string input.
+ */
+function asString(value: unknown, fallback = ""): string {
   return typeof value === "string" ? value : fallback;
 }
 
-function stableJson(value) {
+/**
+ * Serialize a value to pretty JSON, degrading to a deterministic error envelope
+ * when the value cannot be stringified (for example a circular structure).
+ */
+function stableJson(value: unknown): string {
   try {
     return JSON.stringify(value, null, 2);
   } catch {
@@ -28,7 +73,7 @@ function stableJson(value) {
 }
 
 export default defineExtension({
-  activate(api) {
+  activate(api: ExtensionApi): void {
     // commands
     api.registerCommand({
       name: "starter ping",

package/docs/examples/starter-extension/manifest.json

@@ -2,9 +2,9 @@
   "name": "starter-extension",
   "version": "0.1.0",
   "description": "SDK-first starter extension demonstrating all pm extension capabilities.",
-  "entry": "./index.js",
+  "entry": "./index.ts",
   "manifest_version": 2,
-  "pm_min_version": "2026.5.0",
+  "pm_min_version": "2026.6.24",
   "trusted": true,
   "provenance": {
     "source": "docs/examples/starter-extension",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.6.24",
+  "version": "2026.7.1",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "author": "unbrained",
@@ -68,11 +68,17 @@
   ],
   "scripts": {
     "build": "node scripts/prepare-build-cache.mjs && tsc -p tsconfig.json && node scripts/bundle-cli.mjs && node scripts/finalize-build.mjs",
-    "typecheck": "tsc --noEmit -p tsconfig.json && tsc -p tsconfig.packages.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc -p tsconfig.packages.json && tsc -p tsconfig.examples.json",
     "start": "node dist/cli.js",
     "dev": "tsx src/cli.ts",
     "test": "node scripts/run-tests.mjs test",
     "test:coverage": "node scripts/run-tests.mjs coverage",
+    "lint": "pnpm lint:eslint && pnpm lint:duplicates && pnpm lint:codefactor",
+    "lint:eslint": "eslint . --max-warnings=0",
+    "lint:eslint:prune": "eslint . --prune-suppressions",
+    "lint:complexity:baseline": "eslint . --suppress-rule complexity",
+    "lint:duplicates": "jscpd --config .jscpd.json",
+    "lint:codefactor": "pnpm quality:static",
     "quality:static": "node scripts/release/static-quality-gate.mjs",
     "quality:docs-skills": "node scripts/release/docs-skills-gate.mjs",
     "quality:docs-links": "node scripts/release/docs-skills-gate.mjs --links-only",
@@ -92,6 +98,8 @@
     "release:pipeline": "node scripts/release/run-release-pipeline.mjs",
     "release:pipeline:dry-run": "node scripts/release/run-release-pipeline.mjs --dry-run",
     "release:verify-published": "node scripts/release/verify-published-release.mjs",
+    "review:greptile": "greptile review --agent",
+    "review:greptile:gate": "node scripts/release/greptile-review-gate.mjs",
     "security:scan": "node scripts/check-secrets.mjs",
     "smoke:npx": "node scripts/smoke-npx-from-pack.mjs",
     "sentry:inject": "sentry-cli sourcemaps inject dist/",
@@ -114,7 +122,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22.18.0"
   },
   "peerDependencies": {
     "typebox": "*"
@@ -125,19 +133,24 @@
     }
   },
   "dependencies": {
-    "@sentry/node": "^10.59.0",
+    "@sentry/node": "^10.62.0",
     "@toon-format/toon": "^2.3.0",
-    "commander": "^14.0.3",
+    "commander": "^15.0.0",
     "fast-glob": "^3.3.3",
     "fast-json-patch": "^3.1.1"
   },
   "devDependencies": {
-    "@sentry/cli": "^3.5.1",
-    "@types/node": "^20.0.0",
+    "@sentry/cli": "^3.6.0",
+    "@types/node": "^22.20.0",
     "@vitest/coverage-v8": "^4.1.9",
     "esbuild": "0.28.1",
+    "eslint": "^10.6.0",
+    "eslint-plugin-unicorn": "^69.0.0",
+    "greptile": "^3.1.1",
+    "jscpd": "^5.0.11",
     "tsx": "^4.22.4",
     "typescript": "^6.0.3",
+    "typescript-eslint": "^8.62.1",
     "vitest": "^4.1.9"
   },
   "pnpm": {

package/packages/pm-beads/extensions/beads/index.ts

@@ -3,9 +3,9 @@ import type {
   GlobalOptions,
   ImportExportContext,
   ImportExportRegistrationOptions,
-} from "../../../../src/sdk/index.js";
-import type { BeadsImportOptions, BeadsImportResult } from "./runtime.js";
-import { loadPackageRuntimeModule } from "./runtime-loader.js";
+} from "@unbrained/pm-cli/sdk";
+import type { BeadsImportOptions, BeadsImportResult } from "./runtime.ts";
+import { loadPackageRuntimeModule } from "./runtime-loader.ts";
 
 export const manifest = {
   name: "builtin-beads-import",

package/packages/pm-beads/extensions/beads/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "builtin-beads-import",
   "version": "0.1.0",
-  "entry": "./index.js",
+  "entry": "./index.ts",
   "priority": 0,
   "trusted": true,
   "sandbox_profile": "restricted",
@@ -19,7 +19,7 @@
     "importers"
   ],
   "manifest_version": 1,
-  "pm_min_version": "2026.5.0",
+  "pm_min_version": "2026.6.24",
   "activation": {
     "commands": [
       "beads import"

package/packages/pm-beads/extensions/beads/runtime-loader.ts

@@ -3,7 +3,8 @@ import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 
 /**
- * GENERATED by scripts/gen-package-runtime-loaders.mjs - do not edit directly.
+ * This file is auto-generated by scripts/gen-package-runtime-loaders.mjs.
+ * Do not edit directly.
  * This file is shipped with the package extension and intentionally avoids
  * static SDK imports so project-local installed extensions can load it.
  */
@@ -24,9 +25,20 @@ function isMissingRuntimeModuleError(error: unknown, modulePath: string): boolea
   if (!isRecord(error) || error.code !== "ERR_MODULE_NOT_FOUND") {
     return false;
   }
-  const message = typeof error.message === "string" ? error.message : "";
   const moduleUrl = pathToFileURL(modulePath).href;
-  return message.includes(modulePath) || message.includes(moduleUrl);
+  if (error.url === moduleUrl) {
+    return true;
+  }
+  if (typeof error.path === "string" && path.resolve(error.path) === path.resolve(modulePath)) {
+    return true;
+  }
+  const message = typeof error.message === "string" ? error.message : "";
+  const normalizedModulePath = modulePath.replace(/\\/g, "/");
+  return (
+    message.startsWith(`Cannot find module '${modulePath}'`) ||
+    message.startsWith(`Cannot find module '${normalizedModulePath}'`) ||
+    message.startsWith(`Cannot find module '${moduleUrl}'`)
+  );
 }
 
 function resolvePackageRootCandidates(): string[] {
@@ -50,8 +62,8 @@ export async function loadPackageRuntimeModule(): Promise<PackageRuntimeModule>
   const attempted: string[] = [];
   for (const packageRoot of resolvePackageRootCandidates()) {
     const modulePaths = [
-      path.join(packageRoot, ".agents", "pm", "extensions", EXTENSION_NAME, "runtime.js"),
-      path.join(packageRoot, "packages", PACKAGE_NAME, "extensions", EXTENSION_NAME, "runtime.js"),
+      path.join(packageRoot, ".agents", "pm", "extensions", EXTENSION_NAME, "runtime.ts"),
+      path.join(packageRoot, "packages", PACKAGE_NAME, "extensions", EXTENSION_NAME, "runtime.ts"),
     ];
     for (const modulePath of modulePaths) {
       attempted.push(modulePath);
@@ -69,7 +81,7 @@ export async function loadPackageRuntimeModule(): Promise<PackageRuntimeModule>
     }
   }
 
-  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
+  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.ts");
   attempted.push(localRuntimePath);
   if (existsSync(localRuntimePath)) {
     try {
@@ -83,6 +95,6 @@ export async function loadPackageRuntimeModule(): Promise<PackageRuntimeModule>
 
   throw new Error(
     `Unable to resolve packaged ${DIAGNOSTIC_NAME} extension runtime module. ` +
-      `Tried: ${attempted.join(", ")}. Ensure the installed extension includes runtime.js or PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
+      `Tried: ${attempted.join(", ")}. Ensure the installed extension includes runtime.ts or PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
   );
 }

package/packages/pm-beads/extensions/beads/runtime.ts

@@ -1,42 +1,24 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import {
-  DEPENDENCY_KIND_VALUES,
-  EXIT_CODE,
-  PmCliError,
-  canonicalDocument,
-  commitImportedItem,
-  generateItemId,
-  getActiveExtensionRegistrations,
-  getItemPath,
-  isTimestampLiteral,
-  locateItem,
-  normalizeFrontMatter,
-  normalizeItemId,
-  normalizeRawItemId,
-  nowIso,
-  pathExists,
-  readSettings,
-  resolveItemTypeRegistry,
-  resolvePmRoot,
-  runActiveOnReadHooks,
-  ensureTrackerInitialized,
-  selectImportAuthor,
-  toEstimatedMinutesValue,
-  toImportPriority,
-  toImportStatus,
-  toImportTags,
-  toNonEmptyImportString,
-  type Dependency,
-  type GlobalOptions,
-  type ItemStatus,
-  type ItemType,
-  type LinkedDoc,
-  type LinkedFile,
-  type LinkedTest,
-  type LogNote,
-} from "../../../../src/sdk/index.js";
-
+import { fileURLToPath, pathToFileURL } from "node:url";
+import type {
+  CommitImportedItemParams,
+  CommitImportedItemResult,
+  Dependency,
+  GlobalOptions,
+  ItemDocument,
+  ItemMetadata,
+  ItemStatus,
+  ItemType,
+  LinkedDoc,
+  LinkedFile,
+  LinkedTest,
+  LogNote,
+  PmSettings,
+} from "@unbrained/pm-cli/sdk";
+
+const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+const CURRENT_RUNTIME_ROOT = path.dirname(fileURLToPath(import.meta.url));
 const PRIMARY_AUTO_DISCOVERY_FILES = [
   ".beads/issues.jsonl",
   "issues.jsonl",
@@ -97,6 +79,142 @@ interface BeadsRecord extends Record<string, unknown> {
   docs?: unknown;
 }
 
+interface ActiveExtensionRegistrations {
+  types?: unknown;
+}
+
+interface ItemTypeRegistry {
+  types: string[];
+  type_to_folder: Record<string, string>;
+}
+
+interface BeadsSdkModule {
+  DEPENDENCY_KIND_VALUES: readonly Dependency["kind"][];
+  EXIT_CODE: {
+    NOT_FOUND: number;
+    USAGE: number;
+  };
+  PmCliError: new (message: string, exitCode?: number) => Error;
+  canonicalDocument: (document: ItemDocument) => ItemDocument;
+  commitImportedItem: (params: CommitImportedItemParams) => Promise<CommitImportedItemResult>;
+  ensureTrackerInitialized: (pmRoot: string) => Promise<void>;
+  generateItemId: (pmRoot: string, prefix: string) => Promise<string>;
+  getActiveExtensionRegistrations: () => ActiveExtensionRegistrations | null;
+  getItemPath: (
+    pmRoot: string,
+    type: ItemType,
+    id: string,
+    itemFormat: "toon",
+    typeToFolder: Record<string, string>,
+  ) => string;
+  isTimestampLiteral: (value: string) => boolean;
+  locateItem: (
+    pmRoot: string,
+    id: string,
+    prefix: string,
+    itemFormat: PmSettings["item_format"],
+    typeToFolder: Record<string, string>,
+  ) => Promise<unknown>;
+  normalizeFrontMatter: (frontMatter: Partial<ItemMetadata>) => ItemMetadata;
+  normalizeItemId: (id: string, prefix: string) => string;
+  normalizeRawItemId: (id: string) => string;
+  nowIso: () => string;
+  pathExists: (targetPath: string) => Promise<boolean>;
+  readSettings: (pmRoot: string) => Promise<PmSettings>;
+  resolveItemTypeRegistry: (
+    settings: PmSettings,
+    registrations: ActiveExtensionRegistrations | null,
+  ) => ItemTypeRegistry;
+  resolvePmRoot: (cwd: string, overridePath?: string) => string;
+  runActiveOnReadHooks: (context: { path: string; scope: "project" | "global" }) => Promise<string[]>;
+  selectImportAuthor: (explicitAuthor: string | undefined, settingsAuthor: string) => string;
+  toEstimatedMinutesValue: (value: unknown) => number | undefined;
+  toImportPriority: (value: unknown) => 0 | 1 | 2 | 3 | 4;
+  toImportStatus: (value: unknown) => ItemStatus;
+  toImportTags: (value: unknown) => string[];
+  toNonEmptyImportString: (value: unknown) => string | undefined;
+}
+
+async function loadBeadsSdkModule(): Promise<BeadsSdkModule> {
+  const envRoot = process.env[PM_PACKAGE_ROOT_ENV];
+  const hasConfiguredPackageRoot = typeof envRoot === "string" && envRoot.trim().length > 0;
+  const packageRoot =
+    hasConfiguredPackageRoot
+      ? path.resolve(envRoot.trim())
+      : path.resolve(CURRENT_RUNTIME_ROOT, "../../../..");
+  const modulePath = hasConfiguredPackageRoot
+    ? path.join(packageRoot, "dist", "sdk", "index.js")
+    : path.join(packageRoot, "src", "sdk", "index.ts");
+  try {
+    const loaded = (await import(pathToFileURL(modulePath).href)) as Partial<BeadsSdkModule>;
+    if (
+      Array.isArray(loaded.DEPENDENCY_KIND_VALUES) &&
+      typeof loaded.EXIT_CODE === "object" &&
+      loaded.EXIT_CODE !== null &&
+      typeof loaded.EXIT_CODE.NOT_FOUND === "number" &&
+      typeof loaded.EXIT_CODE.USAGE === "number" &&
+      typeof loaded.PmCliError === "function" &&
+      typeof loaded.canonicalDocument === "function" &&
+      typeof loaded.commitImportedItem === "function" &&
+      typeof loaded.ensureTrackerInitialized === "function" &&
+      typeof loaded.generateItemId === "function" &&
+      typeof loaded.getActiveExtensionRegistrations === "function" &&
+      typeof loaded.getItemPath === "function" &&
+      typeof loaded.isTimestampLiteral === "function" &&
+      typeof loaded.locateItem === "function" &&
+      typeof loaded.normalizeFrontMatter === "function" &&
+      typeof loaded.normalizeItemId === "function" &&
+      typeof loaded.normalizeRawItemId === "function" &&
+      typeof loaded.nowIso === "function" &&
+      typeof loaded.pathExists === "function" &&
+      typeof loaded.readSettings === "function" &&
+      typeof loaded.resolveItemTypeRegistry === "function" &&
+      typeof loaded.resolvePmRoot === "function" &&
+      typeof loaded.runActiveOnReadHooks === "function" &&
+      typeof loaded.selectImportAuthor === "function" &&
+      typeof loaded.toEstimatedMinutesValue === "function" &&
+      typeof loaded.toImportPriority === "function" &&
+      typeof loaded.toImportStatus === "function" &&
+      typeof loaded.toImportTags === "function" &&
+      typeof loaded.toNonEmptyImportString === "function"
+    ) {
+      return loaded as BeadsSdkModule;
+    }
+  } catch (error: unknown) {
+    throw new Error(`builtin-beads failed to load SDK exports from ${modulePath}.`, { cause: error });
+  }
+  throw new Error(`builtin-beads failed to load SDK exports from ${modulePath}.`);
+}
+
+const {
+  DEPENDENCY_KIND_VALUES,
+  EXIT_CODE,
+  PmCliError,
+  canonicalDocument,
+  commitImportedItem,
+  ensureTrackerInitialized,
+  generateItemId,
+  getActiveExtensionRegistrations,
+  getItemPath,
+  isTimestampLiteral,
+  locateItem,
+  normalizeFrontMatter,
+  normalizeItemId,
+  normalizeRawItemId,
+  nowIso,
+  pathExists,
+  readSettings,
+  resolveItemTypeRegistry,
+  resolvePmRoot,
+  runActiveOnReadHooks,
+  selectImportAuthor,
+  toEstimatedMinutesValue,
+  toImportPriority,
+  toImportStatus,
+  toImportTags,
+  toNonEmptyImportString,
+} = await loadBeadsSdkModule();
+
 // Shared, behavior-identical value coercers are sourced from the SDK adapter
 // surface; package-specific mappings (timestamps, item types, dependencies,
 // linked artifacts) stay local below.

package/packages/pm-calendar/extensions/calendar/index.ts

@@ -2,9 +2,9 @@ import type {
   CommandDefinition,
   ExtensionApi,
   ServiceOverrideContext,
-} from "../../../../src/sdk/index.js";
-import type { CalendarOptions } from "../../../../src/sdk/runtime.js";
-import { renderCalendarPackageOutput, runCalendarPackage } from "./runtime.js";
+} from "@unbrained/pm-cli/sdk";
+import type { CalendarOptions } from "@unbrained/pm-cli/sdk/runtime";
+import { renderCalendarPackageOutput, runCalendarPackage } from "./runtime.ts";
 
 const CALENDAR_VIEW_NAMES = ["agenda", "day", "week", "month"] as const;
 

package/packages/pm-calendar/extensions/calendar/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "builtin-calendar",
   "version": "0.1.0",
-  "entry": "./index.js",
+  "entry": "./index.ts",
   "priority": 0,
   "trusted": true,
   "sandbox_profile": "strict",
@@ -15,7 +15,7 @@
   },
   "capabilities": ["commands", "schema", "services"],
   "manifest_version": 1,
-  "pm_min_version": "2026.5.0",
+  "pm_min_version": "2026.6.24",
   "activation": {
     "commands": ["cal", "calendar"]
   }

package/packages/pm-calendar/extensions/calendar/runtime.ts

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { pathToFileURL } from "node:url";
-import type { CalendarOptions, CalendarResult } from "../../../../src/sdk/runtime.js";
-import type { GlobalOptions, ServiceOverrideContext } from "../../../../src/sdk/index.js";
+import type { CalendarOptions, CalendarResult } from "@unbrained/pm-cli/sdk/runtime";
+import type { GlobalOptions, ServiceOverrideContext } from "@unbrained/pm-cli/sdk";
 
 const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
 

package/packages/pm-command-kit/extensions/command-kit/index.ts

@@ -19,7 +19,7 @@ import type {
   FlagDefinition,
   ParserOverrideContext,
   ParserOverrideDelta,
-} from "../../../../src/sdk/index.js";
+} from "@unbrained/pm-cli/sdk";
 
 export const manifest = {
   name: "builtin-command-kit",

package/packages/pm-command-kit/extensions/command-kit/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "builtin-command-kit",
   "version": "0.1.0",
-  "entry": "./index.js",
+  "entry": "./index.ts",
   "priority": 0,
   "trusted": true,
   "sandbox_profile": "strict",
@@ -15,7 +15,7 @@
   },
   "capabilities": ["commands", "schema", "parser"],
   "manifest_version": 1,
-  "pm_min_version": "2026.5.0",
+  "pm_min_version": "2026.6.24",
   "activation": {
     "commands": ["command-kit echo", "list"]
   }