@unbrained/pm-cli 2026.5.12 → 2026.5.18

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

@@ -1,124 +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"],
+    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;
+    return typeof value === "string" ? value : undefined;
 }
-
 function asBoolean(value) {
-  return typeof value === "boolean" ? value : undefined;
+    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),
-  };
+    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)];
+    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 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);
     }
-  }
-
-  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.`,
-  );
+    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);
+    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",
-    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),
-  });
+    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,
+    manifest,
+    activate,
 };

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

@@ -1,7 +1,6 @@
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import type { CommandDefinition, ExtensionApi } from "../../../../src/core/extensions/loader.js";
-import type { GlobalOptions } from "../../../../src/core/shared/command-types.js";
+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";
@@ -95,6 +94,7 @@ async function runBeadsImportFromRuntime(options: BeadsImportOptions, global: Gl
 export function activate(api: ExtensionApi): void {
   api.registerCommand({
     name: "beads import",
+    action: "beads-import",
     description: "Import Beads JSONL records into pm items.",
     flags: [
       {

package/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/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

@@ -1,17 +1,50 @@
 {
-  "name": "@unbrained/pm-package-beads",
+  "name": "@unbrained/pm-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-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 ?? null;
+  });
+}
+
+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 ?? null;
+  });
+}
+
+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"]
+}

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

@@ -0,0 +1,114 @@
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+
+const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+let calendarCore = null;
+let calendarCoreLoadPromise = null;
+
+async function ensureCalendarCoreModule() {
+  if (calendarCore) {
+    return calendarCore;
+  }
+  if (!calendarCoreLoadPromise) {
+    calendarCoreLoadPromise = loadCalendarCoreModule();
+  }
+  calendarCore = await calendarCoreLoadPromise;
+  return calendarCore;
+}
+
+async function loadCalendarCoreModule() {
+  const envRoot = process.env[PM_PACKAGE_ROOT_ENV];
+  if (typeof envRoot !== "string" || envRoot.trim().length === 0) {
+    throw new Error(
+      `builtin-calendar requires ${PM_PACKAGE_ROOT_ENV} to locate core SDK runtime exports.`,
+    );
+  }
+  const modulePath = path.join(path.resolve(envRoot.trim()), "dist", "sdk", "runtime.js");
+  try {
+    const loaded = await import(pathToFileURL(modulePath).href);
+    if (
+      typeof loaded.runCalendar === "function" &&
+      typeof loaded.renderCalendarMarkdown === "function" &&
+      typeof loaded.resolveCalendarOutputFormat === "function"
+    ) {
+      return loaded;
+    }
+  } catch {
+    // Fall through to deterministic failure message below.
+  }
+  throw new Error(
+    `builtin-calendar failed to load calendar SDK runtime exports from ${modulePath}.`,
+  );
+}
+
+function isCalendarResult(value) {
+  return (
+    typeof value === "object" &&
+    value !== null &&
+    value.output_default === "markdown" &&
+    Array.isArray(value.events) &&
+    Array.isArray(value.days)
+  );
+}
+
+function readPayloadFormat(payload) {
+  if (typeof payload === "object" && payload !== null) {
+    const format = payload.format;
+    if (format === "json") {
+      return "json";
+    }
+  }
+  return "toon";
+}
+
+function readPayloadResult(payload) {
+  if (typeof payload === "object" && payload !== null && "result" in payload) {
+    return payload.result;
+  }
+  return payload;
+}
+
+function readPayloadCommandOptions(payload) {
+  if (typeof payload === "object" && payload !== null) {
+    const commandOptions = payload.command_options;
+    if (typeof commandOptions === "object" && commandOptions !== null) {
+      return commandOptions;
+    }
+  }
+  return {};
+}
+
+function readPayloadGlobalOptions(payload) {
+  if (typeof payload === "object" && payload !== null) {
+    const global = payload.global;
+    if (typeof global === "object" && global !== null) {
+      return global;
+    }
+  }
+  return {};
+}
+
+export async function runCalendarPackage(options, global) {
+  const loaded = await ensureCalendarCoreModule();
+  return loaded.runCalendar(options, global);
+}
+
+export function renderCalendarPackageOutput(context) {
+  const result = readPayloadResult(context.payload);
+  if (!calendarCore || !isCalendarResult(result)) {
+    return null;
+  }
+  const options =
+    context.options && Object.keys(context.options).length > 0
+      ? context.options
+      : readPayloadCommandOptions(context.payload);
+  const global = context.global ?? readPayloadGlobalOptions(context.payload);
+  const outputFormat = calendarCore.resolveCalendarOutputFormat(options, global);
+  if (outputFormat === "markdown") {
+    return `${calendarCore.renderCalendarMarkdown(result)}\n`;
+  }
+  if (outputFormat === "json" || readPayloadFormat(context.payload) === "json") {
+    return `${JSON.stringify(result, null, 2)}\n`;
+  }
+  return null;
+}