@unbrained/pm-cli 2026.5.11 → 2026.5.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.5.11",
+  "version": "2026.5.14",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "author": "unbrained",
@@ -48,22 +48,21 @@
     "docs/**",
     ".claude-plugin/**",
     "plugins/**",
-    ".pi/**",
-    ".agents/skills/**",
-    ".agents/pm/extensions/**",
+    "packages/pm-*/**",
     "scripts/install.sh",
     "scripts/install.ps1",
     "marketplace.json"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc -p tsconfig.packages.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",
     "quality:static": "node scripts/release/static-quality-gate.mjs",
     "quality:docs-skills": "node scripts/release/docs-skills-gate.mjs",
+    "dogfood:package-first": "node scripts/dogfood-package-first.mjs",
     "smoke:codex-plugin": "node scripts/smoke-codex-plugin-mcp.mjs",
     "smoke:claude-plugin": "node scripts/smoke-claude-plugin.mjs",
     "version:check": "node scripts/release-version.mjs check",
@@ -73,6 +72,7 @@
     "release:gates": "node scripts/release/run-gates.mjs --telemetry-mode best-effort",
     "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",
     "security:scan": "node scripts/check-secrets.mjs",
     "smoke:npx": "node scripts/smoke-npx-from-pack.mjs",
     "sentry:inject": "sentry-cli sourcemaps inject dist/",
@@ -88,36 +88,19 @@
     "git-native",
     "typescript",
     "task-tracker",
-    "coding-agents",
-    "pi-package",
-    "pi-extension"
+    "coding-agents"
   ],
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
-  "pi": {
-    "extensions": [
-      "./.pi/extensions/pm-cli/index.js"
-    ],
-    "skills": [
-      "./.pi/skills"
-    ],
-    "prompts": [
-      "./.pi/prompts"
-    ]
-  },
   "engines": {
     "node": ">=20"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "*",
     "typebox": "*"
   },
   "peerDependenciesMeta": {
-    "@earendil-works/pi-coding-agent": {
-      "optional": true
-    },
     "typebox": {
       "optional": true
     }

package/packages/pm-beads/README.md

@@ -0,0 +1,10 @@
+# pm Beads Package
+
+First-party pm package for importing Beads JSONL records.
+
+```bash
+pm install ./packages/pm-beads --project
+pm beads import --file .beads/issues.jsonl
+```
+
+The package exposes the `beads import` extension command through the `pm.extensions` package manifest. Runtime sources are authored in TypeScript and shipped with JavaScript entry artifacts for Node extension loading.

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

@@ -0,0 +1,113 @@
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
+export const manifest = {
+    name: "builtin-beads-import",
+    version: "0.1.0",
+    entry: "./index.js",
+    priority: 0,
+    capabilities: ["commands", "schema"],
+};
+function asOptionalString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function asBoolean(value) {
+    return typeof value === "boolean" ? value : undefined;
+}
+function toBeadsImportOptions(options) {
+    return {
+        file: asOptionalString(options.file),
+        author: asOptionalString(options.author),
+        message: asOptionalString(options.message),
+        preserveSourceIds: asBoolean(options.preserveSourceIds),
+    };
+}
+function resolvePackageRootCandidates() {
+    const candidates = [];
+    const envRoot = process.env[PM_PACKAGE_ROOT_ENV];
+    if (typeof envRoot === "string" && envRoot.trim().length > 0) {
+        candidates.push(path.resolve(envRoot.trim()));
+    }
+    const argvEntry = typeof process.argv[1] === "string" ? process.argv[1].trim() : "";
+    if (argvEntry.length > 0) {
+        const resolvedEntry = path.resolve(argvEntry);
+        const entryDir = path.dirname(resolvedEntry);
+        candidates.push(path.resolve(entryDir, ".."));
+        candidates.push(path.resolve(entryDir, "../.."));
+        candidates.push(path.resolve(entryDir, "../../.."));
+    }
+    return [...new Set(candidates)];
+}
+async function loadRuntimeModule() {
+    const attempted = [];
+    for (const packageRoot of resolvePackageRootCandidates()) {
+        const modulePaths = [
+            path.join(packageRoot, ".agents", "pm", "extensions", "beads", "runtime.js"),
+            path.join(packageRoot, "packages", "pm-beads", "extensions", "beads", "runtime.js"),
+        ];
+        for (const modulePath of modulePaths) {
+            attempted.push(modulePath);
+            try {
+                return await import(pathToFileURL(modulePath).href);
+            }
+            catch {
+                // Try the next package-root candidate.
+            }
+        }
+    }
+    const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
+    attempted.push(localRuntimePath);
+    try {
+        return await import(pathToFileURL(localRuntimePath).href);
+    }
+    catch {
+        // Fall through to the diagnostic below.
+    }
+    throw new Error("Unable to resolve packaged beads 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.`);
+}
+async function runBeadsImportFromRuntime(options, global) {
+    const runtime = await loadRuntimeModule();
+    if (typeof runtime.runBeadsImport !== "function") {
+        throw new Error("Bundled beads runtime module is missing runBeadsImport().");
+    }
+    return runtime.runBeadsImport(options, global);
+}
+export function activate(api) {
+    api.registerCommand({
+        name: "beads import",
+        action: "beads-import",
+        description: "Import Beads JSONL records into pm items.",
+        flags: [
+            {
+                long: "--file",
+                value_name: "path",
+                value_type: "string",
+                description: "Path to the Beads JSONL source file.",
+            },
+            {
+                long: "--author",
+                value_name: "author",
+                value_type: "string",
+                description: "Override import mutation author.",
+            },
+            {
+                long: "--message",
+                value_name: "text",
+                value_type: "string",
+                description: "Override import history message.",
+            },
+            {
+                long: "--preserve-source-ids",
+                value_type: "boolean",
+                description: "Preserve source IDs from Beads payload records when possible.",
+            },
+        ],
+        run: async (context) => runBeadsImportFromRuntime(toBeadsImportOptions(context.options), context.global),
+    });
+}
+export default {
+    manifest,
+    activate,
+};

package/{.agents/pm/extensions/beads/index.js → packages/pm-beads/extensions/beads/index.ts}

@@ -1,7 +1,10 @@
 import path from "node:path";
-import { pathToFileURL } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import type { CommandDefinition, ExtensionApi, GlobalOptions } from "../../../../src/sdk/index.js";
+import type { BeadsImportOptions, BeadsImportResult } from "./runtime.js";
 
 const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
 
 export const manifest = {
   name: "builtin-beads-import",
@@ -11,15 +14,19 @@ export const manifest = {
   capabilities: ["commands", "schema"],
 };
 
-function asOptionalString(value) {
+type RuntimeModule = {
+  runBeadsImport?: (options: BeadsImportOptions, global: GlobalOptions) => Promise<BeadsImportResult>;
+};
+
+function asOptionalString(value: unknown): string | undefined {
   return typeof value === "string" ? value : undefined;
 }
 
-function asBoolean(value) {
+function asBoolean(value: unknown): boolean | undefined {
   return typeof value === "boolean" ? value : undefined;
 }
 
-function toBeadsImportOptions(options) {
+function toBeadsImportOptions(options: Record<string, unknown>): BeadsImportOptions {
   return {
     file: asOptionalString(options.file),
     author: asOptionalString(options.author),
@@ -28,8 +35,8 @@ function toBeadsImportOptions(options) {
   };
 }
 
-function resolvePackageRootCandidates() {
-  const candidates = [];
+function resolvePackageRootCandidates(): string[] {
+  const candidates: string[] = [];
   const envRoot = process.env[PM_PACKAGE_ROOT_ENV];
   if (typeof envRoot === "string" && envRoot.trim().length > 0) {
     candidates.push(path.resolve(envRoot.trim()));
@@ -45,34 +52,49 @@ function resolvePackageRootCandidates() {
   return [...new Set(candidates)];
 }
 
-async function loadRuntimeModule() {
-  const attempted = [];
+async function loadRuntimeModule(): Promise<RuntimeModule> {
+  const attempted: string[] = [];
   for (const packageRoot of resolvePackageRootCandidates()) {
-    const modulePath = path.join(packageRoot, ".agents", "pm", "extensions", "beads", "runtime.js");
-    attempted.push(modulePath);
-    try {
-      return await import(pathToFileURL(modulePath).href);
-    } catch {
-      // Try the next package-root candidate.
+    const modulePaths = [
+      path.join(packageRoot, ".agents", "pm", "extensions", "beads", "runtime.js"),
+      path.join(packageRoot, "packages", "pm-beads", "extensions", "beads", "runtime.js"),
+    ];
+    for (const modulePath of modulePaths) {
+      attempted.push(modulePath);
+      try {
+        return await import(pathToFileURL(modulePath).href) as RuntimeModule;
+      } catch {
+        // Try the next package-root candidate.
+      }
     }
   }
+
+  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
+  attempted.push(localRuntimePath);
+  try {
+    return await import(pathToFileURL(localRuntimePath).href) as RuntimeModule;
+  } catch {
+    // Fall through to the diagnostic below.
+  }
+
   throw new Error(
-    "Unable to resolve bundled beads extension runtime module. " +
-      `Tried: ${attempted.join(", ")}. Ensure PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
+    "Unable to resolve packaged beads 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.`,
   );
 }
 
-async function runBeadsImportFromRuntime(options, global) {
+async function runBeadsImportFromRuntime(options: BeadsImportOptions, global: GlobalOptions): Promise<BeadsImportResult> {
   const runtime = await loadRuntimeModule();
   if (typeof runtime.runBeadsImport !== "function") {
-    throw new Error('Bundled beads runtime module is missing runBeadsImport().');
+    throw new Error("Bundled beads runtime module is missing runBeadsImport().");
   }
   return runtime.runBeadsImport(options, global);
 }
 
-export function activate(api) {
+export function activate(api: ExtensionApi): void {
   api.registerCommand({
     name: "beads import",
+    action: "beads-import",
     description: "Import Beads JSONL records into pm items.",
     flags: [
       {
@@ -100,7 +122,7 @@ export function activate(api) {
       },
     ],
     run: async (context) => runBeadsImportFromRuntime(toBeadsImportOptions(context.options), context.global),
-  });
+  } satisfies CommandDefinition);
 }
 
 export default {

package/{.agents/pm → packages/pm-beads}/extensions/beads/runtime.js

@@ -1,21 +1,6 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { pathExists, removeFileIfExists, writeFileAtomic } from "../../../../dist/core/fs/fs-utils.js";
-import { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks } from "../../../../dist/core/extensions/index.js";
-import { appendHistoryEntry, createHistoryEntry } from "../../../../dist/core/history/history.js";
-import { generateItemId, normalizeItemId, normalizeRawItemId } from "../../../../dist/core/item/id.js";
-import { canonicalDocument, normalizeFrontMatter, serializeItemDocument } from "../../../../dist/core/item/item-format.js";
-import { normalizeStatusInput } from "../../../../dist/core/item/status.js";
-import { resolveItemTypeRegistry } from "../../../../dist/core/item/type-registry.js";
-import { parseTags } from "../../../../dist/core/item/parse.js";
-import { acquireLock } from "../../../../dist/core/lock/lock.js";
-import { EXIT_CODE } from "../../../../dist/core/shared/constants.js";
-import { PmCliError } from "../../../../dist/core/shared/errors.js";
-import { isTimestampLiteral, nowIso } from "../../../../dist/core/shared/time.js";
-import { locateItem } from "../../../../dist/core/store/item-store.js";
-import { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from "../../../../dist/core/store/paths.js";
-import { readSettings } from "../../../../dist/core/store/settings.js";
-import { DEPENDENCY_KIND_VALUES } from "../../../../dist/types/index.js";
+import { DEPENDENCY_KIND_VALUES, EXIT_CODE, PmCliError, acquireLock, appendHistoryEntry, canonicalDocument, createHistoryEntry, generateItemId, getActiveExtensionRegistrations, getHistoryPath, getItemPath, getSettingsPath, isTimestampLiteral, locateItem, normalizeFrontMatter, normalizeItemId, normalizeRawItemId, normalizeStatusInput, nowIso, parseTags, pathExists, readSettings, removeFileIfExists, resolveItemTypeRegistry, resolvePmRoot, runActiveOnReadHooks, runActiveOnWriteHooks, serializeItemDocument, writeFileAtomic, } from "../../../../dist/sdk/index.js";
 const PRIMARY_AUTO_DISCOVERY_FILES = [
     ".beads/issues.jsonl",
     "issues.jsonl",
@@ -583,4 +568,4 @@ export async function runBeadsImport(options, global) {
         ids,
         warnings,
     };
-}
+}

package/{.agents/pm → packages/pm-beads}/extensions/beads/runtime.ts

@@ -1,23 +1,46 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { pathExists, removeFileIfExists, writeFileAtomic } from "../../../../src/core/fs/fs-utils.js";
-import { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks } from "../../../../src/core/extensions/index.js";
-import { appendHistoryEntry, createHistoryEntry } from "../../../../src/core/history/history.js";
-import { generateItemId, normalizeItemId, normalizeRawItemId } from "../../../../src/core/item/id.js";
-import { canonicalDocument, normalizeFrontMatter, serializeItemDocument } from "../../../../src/core/item/item-format.js";
-import { normalizeStatusInput } from "../../../../src/core/item/status.js";
-import { resolveItemTypeRegistry } from "../../../../src/core/item/type-registry.js";
-import { parseTags } from "../../../../src/core/item/parse.js";
-import { acquireLock } from "../../../../src/core/lock/lock.js";
-import { EXIT_CODE } from "../../../../src/core/shared/constants.js";
-import type { GlobalOptions } from "../../../../src/core/shared/command-types.js";
-import { PmCliError } from "../../../../src/core/shared/errors.js";
-import { isTimestampLiteral, nowIso } from "../../../../src/core/shared/time.js";
-import { locateItem } from "../../../../src/core/store/item-store.js";
-import { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from "../../../../src/core/store/paths.js";
-import { readSettings } from "../../../../src/core/store/settings.js";
-import type { Dependency, ItemDocument, ItemMetadata, ItemStatus, ItemType, LogNote, LinkedFile, LinkedTest, LinkedDoc } from "../../../../src/types/index.js";
-import { DEPENDENCY_KIND_VALUES } from "../../../../src/types/index.js";
+import {
+  DEPENDENCY_KIND_VALUES,
+  EXIT_CODE,
+  PmCliError,
+  acquireLock,
+  appendHistoryEntry,
+  canonicalDocument,
+  createHistoryEntry,
+  generateItemId,
+  getActiveExtensionRegistrations,
+  getHistoryPath,
+  getItemPath,
+  getSettingsPath,
+  isTimestampLiteral,
+  locateItem,
+  normalizeFrontMatter,
+  normalizeItemId,
+  normalizeRawItemId,
+  normalizeStatusInput,
+  nowIso,
+  parseTags,
+  pathExists,
+  readSettings,
+  removeFileIfExists,
+  resolveItemTypeRegistry,
+  resolvePmRoot,
+  runActiveOnReadHooks,
+  runActiveOnWriteHooks,
+  serializeItemDocument,
+  writeFileAtomic,
+  type Dependency,
+  type GlobalOptions,
+  type ItemDocument,
+  type ItemMetadata,
+  type ItemStatus,
+  type ItemType,
+  type LinkedDoc,
+  type LinkedFile,
+  type LinkedTest,
+  type LogNote,
+} from "../../../../src/sdk/index.js";
 
 const PRIMARY_AUTO_DISCOVERY_FILES = [
   ".beads/issues.jsonl",

package/packages/pm-beads/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@unbrained/pm-package-beads",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "First-party pm package for importing Beads JSONL records.",
+  "homepage": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unbraind/pm-cli.git",
+    "directory": "packages/pm-beads"
+  },
+  "bugs": {
+    "url": "https://github.com/unbraind/pm-cli/issues"
+  },
+  "keywords": [
+    "pm-package",
+    "project-management",
+    "beads"
+  ],
+  "pm": {
+    "aliases": [
+      "beads"
+    ],
+    "extensions": [
+      "extensions/beads"
+    ],
+    "catalog": {
+      "display_name": "Beads Import",
+      "category": "migration",
+      "summary": "Import Beads JSONL records into pm while preserving source IDs.",
+      "tags": [
+        "migration",
+        "beads",
+        "import"
+      ],
+      "links": {
+        "docs": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads#readme",
+        "repository": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-beads",
+        "report": "https://github.com/unbraind/pm-cli/issues"
+      }
+    },
+    "docs": [
+      "README.md"
+    ],
+    "examples": [
+      "README.md"
+    ]
+  }
+}

package/packages/pm-calendar/README.md

@@ -0,0 +1,13 @@
+# pm Calendar Package
+
+`@unbrained/pm-package-calendar` provides agenda and calendar views as an installable pm package.
+
+```bash
+pm install calendar
+pm calendar --view week --full-period
+pm cal --json --view agenda --include reminders,events
+```
+
+The package owns presentation commands for deadline, reminder, and scheduled event views. Core pm still owns item metadata such as `deadline`, `reminders`, and `events`, plus create/update parsing for those fields.
+
+Runtime sources are authored in TypeScript and use only the public `@unbrained/pm-cli/sdk` surface.

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

@@ -0,0 +1,56 @@
+import { renderCalendarPackageOutput, runCalendarPackage } from "./runtime.js";
+
+export const manifest = {
+  name: "builtin-calendar",
+  version: "0.1.0",
+  entry: "./index.js",
+  priority: 0,
+  capabilities: ["commands", "schema", "services"],
+};
+
+const calendarFlags = [
+  { long: "--view", value_name: "value", value_type: "string", description: "Calendar view: agenda|day|week|month." },
+  { long: "--date", value_name: "value", value_type: "string", description: "Anchor date/time for view calculations." },
+  { long: "--from", value_name: "value", value_type: "string", description: "Agenda lower bound." },
+  { long: "--to", value_name: "value", value_type: "string", description: "Agenda upper bound." },
+  { long: "--past", value_type: "boolean", description: "Include past entries." },
+  { long: "--full-period", value_type: "boolean", description: "Include the full anchored day/week/month period." },
+  { long: "--type", value_name: "value", value_type: "string", description: "Filter by item type." },
+  { long: "--tag", value_name: "value", value_type: "string", description: "Filter by tag." },
+  { long: "--priority", value_name: "value", value_type: "string", description: "Filter by priority." },
+  { long: "--status", value_name: "value", value_type: "string", description: "Filter by status." },
+  { long: "--assignee", value_name: "value", value_type: "string", description: "Filter by assignee." },
+  { long: "--assignee-filter", value_name: "value", value_type: "string", description: "Filter assignee presence." },
+  { long: "--sprint", value_name: "value", value_type: "string", description: "Filter by sprint." },
+  { long: "--release", value_name: "value", value_type: "string", description: "Filter by release." },
+  { long: "--include", value_name: "value", value_type: "string", description: "Include sources: deadlines|reminders|events|all." },
+  { long: "--recurrence-lookahead-days", value_name: "n", value_type: "string", description: "Bound open-ended recurrence lookahead days." },
+  { long: "--recurrence-lookback-days", value_name: "n", value_type: "string", description: "Bound open-ended recurrence lookback days." },
+  { long: "--occurrence-limit", value_name: "n", value_type: "string", description: "Cap generated occurrences per recurring event." },
+  { long: "--limit", value_name: "n", value_type: "string", description: "Limit returned event count." },
+  { long: "--format", value_name: "value", value_type: "string", description: "Calendar output override: markdown|toon|json." },
+];
+
+function calendarCommand(name) {
+  return {
+    name,
+    action: "calendar",
+    description: "Show deadline, reminder, and scheduled event calendar views.",
+    flags: [...calendarFlags],
+    run: async (context) => runCalendarPackage(context.options, context.global),
+  };
+}
+
+export function activate(api) {
+  api.registerCommand(calendarCommand("calendar"));
+  api.registerCommand(calendarCommand("cal"));
+  api.registerService("output_format", (context) => {
+    const rendered = renderCalendarPackageOutput(context);
+    return rendered ?? context.payload;
+  });
+}
+
+export default {
+  manifest,
+  activate,
+};

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

@@ -0,0 +1,62 @@
+import type {
+  CommandDefinition,
+  ExtensionApi,
+  ServiceOverrideContext,
+} from "../../../../src/sdk/index.js";
+import type { CalendarOptions } from "../../../../src/sdk/runtime.js";
+import { renderCalendarPackageOutput, runCalendarPackage } from "./runtime.js";
+
+export const manifest = {
+  name: "builtin-calendar",
+  version: "0.1.0",
+  entry: "./index.js",
+  priority: 0,
+  capabilities: ["commands", "schema", "services"],
+};
+
+const calendarFlags = [
+  { long: "--view", value_name: "value", value_type: "string", description: "Calendar view: agenda|day|week|month." },
+  { long: "--date", value_name: "value", value_type: "string", description: "Anchor date/time for view calculations." },
+  { long: "--from", value_name: "value", value_type: "string", description: "Agenda lower bound." },
+  { long: "--to", value_name: "value", value_type: "string", description: "Agenda upper bound." },
+  { long: "--past", value_type: "boolean", description: "Include past entries." },
+  { long: "--full-period", value_type: "boolean", description: "Include the full anchored day/week/month period." },
+  { long: "--type", value_name: "value", value_type: "string", description: "Filter by item type." },
+  { long: "--tag", value_name: "value", value_type: "string", description: "Filter by tag." },
+  { long: "--priority", value_name: "value", value_type: "string", description: "Filter by priority." },
+  { long: "--status", value_name: "value", value_type: "string", description: "Filter by status." },
+  { long: "--assignee", value_name: "value", value_type: "string", description: "Filter by assignee." },
+  { long: "--assignee-filter", value_name: "value", value_type: "string", description: "Filter assignee presence." },
+  { long: "--sprint", value_name: "value", value_type: "string", description: "Filter by sprint." },
+  { long: "--release", value_name: "value", value_type: "string", description: "Filter by release." },
+  { long: "--include", value_name: "value", value_type: "string", description: "Include sources: deadlines|reminders|events|all." },
+  { long: "--recurrence-lookahead-days", value_name: "n", value_type: "string", description: "Bound open-ended recurrence lookahead days." },
+  { long: "--recurrence-lookback-days", value_name: "n", value_type: "string", description: "Bound open-ended recurrence lookback days." },
+  { long: "--occurrence-limit", value_name: "n", value_type: "string", description: "Cap generated occurrences per recurring event." },
+  { long: "--limit", value_name: "n", value_type: "string", description: "Limit returned event count." },
+  { long: "--format", value_name: "value", value_type: "string", description: "Calendar output override: markdown|toon|json." },
+] as const;
+
+function calendarCommand(name: "calendar" | "cal"): CommandDefinition {
+  return {
+    name,
+    action: "calendar",
+    description: "Show deadline, reminder, and scheduled event calendar views.",
+    flags: [...calendarFlags],
+    run: async (context) => runCalendarPackage(context.options as CalendarOptions, context.global),
+  };
+}
+
+export function activate(api: ExtensionApi): void {
+  api.registerCommand(calendarCommand("calendar"));
+  api.registerCommand(calendarCommand("cal"));
+  api.registerService("output_format", (context) => {
+    const rendered = renderCalendarPackageOutput(context as ServiceOverrideContext);
+    return rendered ?? context.payload;
+  });
+}
+
+export default {
+  manifest,
+  activate,
+};

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

@@ -0,0 +1,7 @@
+{
+  "name": "builtin-calendar",
+  "version": "0.1.0",
+  "entry": "./index.js",
+  "priority": 0,
+  "capabilities": ["commands", "schema", "services"]
+}