@crossdelta/platform-sdk 0.19.0 → 0.19.3

package/dist/plugin-types-DQOv97Zh.d.mts

@@ -0,0 +1,180 @@
+/**
+ * Plugin System Types
+ *
+ * pf owns and defines these interfaces.
+ * Plugins MUST adapt to these interfaces.
+ * pf is strict and predictable - no duck-typing, no fallbacks.
+ */
+/**
+ * Base effect type - all domain effects must have a kind
+ * pf handles effects generically via kind-based handler registry
+ */
+interface PfEffect {
+    readonly kind: string;
+}
+/**
+ * File write effect - write content to a file
+ */
+interface FileWriteEffect extends PfEffect {
+    readonly kind: 'file:write';
+    readonly path: string;
+    readonly content: string;
+}
+/**
+ * Infrastructure service configuration effect
+ */
+interface InfraAddEffect extends PfEffect {
+    readonly kind: 'infra:add';
+    readonly serviceName: string;
+    readonly port: number;
+    readonly framework: string;
+    readonly runtime: string;
+}
+/**
+ * Environment variable effect
+ */
+interface EnvAddEffect extends PfEffect {
+    readonly kind: 'env:add';
+    readonly key: string;
+    readonly value: string;
+}
+/**
+ * Field definition for input elicitation
+ *
+ * Describes a single field that needs user input.
+ * Host-agnostic - CLI and MCP interpret this differently.
+ */
+interface ElicitInputField {
+    /** Field name (used as key in response) */
+    readonly name: string;
+    /** Human-readable prompt/question */
+    readonly prompt: string;
+    /** Whether the field is required */
+    readonly required?: boolean;
+    /** Detailed description (shown as help text) */
+    readonly description?: string;
+    /** Default value if user provides nothing */
+    readonly defaultValue?: unknown;
+    /** Allowed values (enum constraint) */
+    readonly enum?: readonly string[];
+    /** Field type hint */
+    readonly type?: 'string' | 'number' | 'boolean';
+}
+/**
+ * Input elicitation effect
+ *
+ * Returned by tools when required inputs are missing.
+ * Pure data - no MCP SDK imports, no host-specific logic.
+ *
+ * Hosts interpret this effect differently:
+ * - CLI: Interactive prompt
+ * - MCP: server.elicitInput() or structured error
+ */
+interface ElicitInputEffect extends PfEffect {
+    readonly kind: 'elicit:input';
+    /** Message explaining what's needed */
+    readonly message: string;
+    /** Fields to collect from user */
+    readonly fields: readonly ElicitInputField[];
+}
+/**
+ * Type guard for ElicitInputEffect
+ */
+declare const isElicitInputEffect: (effect: PfEffect) => effect is ElicitInputEffect;
+/**
+ * Result of running a command
+ */
+interface PfCommandResult {
+    /** Domain effects to be applied by the runtime */
+    effects: PfEffect[];
+    /** Optional output to display (for read-only commands) */
+    output?: string | string[];
+}
+/**
+ * Command argument definition
+ */
+interface PfCommandArg {
+    name: string;
+    description: string;
+    required: boolean;
+}
+/**
+ * Command option definition
+ */
+interface PfCommandOption {
+    flags: string;
+    description: string;
+    default?: unknown;
+}
+/**
+ * A CLI command provided by a plugin
+ *
+ * Plugins MUST implement this exact interface.
+ */
+interface PfCommand {
+    name: string;
+    description: string;
+    args: PfCommandArg[];
+    options: PfCommandOption[];
+    run(args: Record<string, unknown>, options: Record<string, unknown>): Promise<PfCommandResult>;
+}
+/**
+ * An interactive flow provided by a plugin
+ */
+interface PfFlow {
+    name: string;
+    description: string;
+    getSteps(initialContext?: Record<string, unknown>): Promise<unknown[]>;
+}
+/**
+ * Workspace context with all discovered information
+ * pf owns this - plugins receive it during setup
+ */
+interface PfWorkspaceContext {
+    /** Absolute path to workspace root */
+    workspaceRoot: string;
+    /** Discovered services (relative paths like 'services/api-gateway') */
+    availableServices: string[];
+    /** Contracts package configuration */
+    contracts: {
+        /** Relative path to contracts source (e.g., 'packages/contracts/src') */
+        path: string;
+        /** Package name (e.g., '@my-platform/contracts') */
+        packageName?: string;
+    };
+}
+/**
+ * Plugin context provided by pf during setup
+ */
+interface PfPluginContext {
+    workspace: PfWorkspaceContext;
+    logger: {
+        debug: (message: string) => void;
+        info: (message: string) => void;
+        warn: (message: string) => void;
+        error: (message: string) => void;
+    };
+}
+/**
+ * A plugin that can be loaded by pf
+ *
+ * Plugins MUST implement this exact interface.
+ * If a plugin has a different internal API, it must provide an adapter.
+ */
+interface PfPlugin {
+    name: string;
+    version: string;
+    description?: string;
+    commands: PfCommand[];
+    flows: PfFlow[];
+    setup: (context: PfPluginContext) => Promise<void> | void;
+}
+/**
+ * Result of loading a plugin
+ */
+interface LoadedPlugin {
+    plugin: PfPlugin;
+    source: string;
+}
+
+export { type ElicitInputEffect as E, type FileWriteEffect as F, type InfraAddEffect as I, type LoadedPlugin as L, type PfWorkspaceContext as P, type PfPluginContext as a, type PfPlugin as b, type PfCommand as c, type PfCommandArg as d, type PfCommandOption as e, type PfFlow as f, type PfEffect as g, type ElicitInputField as h, type EnvAddEffect as i, type PfCommandResult as j, isElicitInputEffect as k };

package/dist/plugin-types-DQOv97Zh.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Plugin System Types
+ *
+ * pf owns and defines these interfaces.
+ * Plugins MUST adapt to these interfaces.
+ * pf is strict and predictable - no duck-typing, no fallbacks.
+ */
+/**
+ * Base effect type - all domain effects must have a kind
+ * pf handles effects generically via kind-based handler registry
+ */
+interface PfEffect {
+    readonly kind: string;
+}
+/**
+ * File write effect - write content to a file
+ */
+interface FileWriteEffect extends PfEffect {
+    readonly kind: 'file:write';
+    readonly path: string;
+    readonly content: string;
+}
+/**
+ * Infrastructure service configuration effect
+ */
+interface InfraAddEffect extends PfEffect {
+    readonly kind: 'infra:add';
+    readonly serviceName: string;
+    readonly port: number;
+    readonly framework: string;
+    readonly runtime: string;
+}
+/**
+ * Environment variable effect
+ */
+interface EnvAddEffect extends PfEffect {
+    readonly kind: 'env:add';
+    readonly key: string;
+    readonly value: string;
+}
+/**
+ * Field definition for input elicitation
+ *
+ * Describes a single field that needs user input.
+ * Host-agnostic - CLI and MCP interpret this differently.
+ */
+interface ElicitInputField {
+    /** Field name (used as key in response) */
+    readonly name: string;
+    /** Human-readable prompt/question */
+    readonly prompt: string;
+    /** Whether the field is required */
+    readonly required?: boolean;
+    /** Detailed description (shown as help text) */
+    readonly description?: string;
+    /** Default value if user provides nothing */
+    readonly defaultValue?: unknown;
+    /** Allowed values (enum constraint) */
+    readonly enum?: readonly string[];
+    /** Field type hint */
+    readonly type?: 'string' | 'number' | 'boolean';
+}
+/**
+ * Input elicitation effect
+ *
+ * Returned by tools when required inputs are missing.
+ * Pure data - no MCP SDK imports, no host-specific logic.
+ *
+ * Hosts interpret this effect differently:
+ * - CLI: Interactive prompt
+ * - MCP: server.elicitInput() or structured error
+ */
+interface ElicitInputEffect extends PfEffect {
+    readonly kind: 'elicit:input';
+    /** Message explaining what's needed */
+    readonly message: string;
+    /** Fields to collect from user */
+    readonly fields: readonly ElicitInputField[];
+}
+/**
+ * Type guard for ElicitInputEffect
+ */
+declare const isElicitInputEffect: (effect: PfEffect) => effect is ElicitInputEffect;
+/**
+ * Result of running a command
+ */
+interface PfCommandResult {
+    /** Domain effects to be applied by the runtime */
+    effects: PfEffect[];
+    /** Optional output to display (for read-only commands) */
+    output?: string | string[];
+}
+/**
+ * Command argument definition
+ */
+interface PfCommandArg {
+    name: string;
+    description: string;
+    required: boolean;
+}
+/**
+ * Command option definition
+ */
+interface PfCommandOption {
+    flags: string;
+    description: string;
+    default?: unknown;
+}
+/**
+ * A CLI command provided by a plugin
+ *
+ * Plugins MUST implement this exact interface.
+ */
+interface PfCommand {
+    name: string;
+    description: string;
+    args: PfCommandArg[];
+    options: PfCommandOption[];
+    run(args: Record<string, unknown>, options: Record<string, unknown>): Promise<PfCommandResult>;
+}
+/**
+ * An interactive flow provided by a plugin
+ */
+interface PfFlow {
+    name: string;
+    description: string;
+    getSteps(initialContext?: Record<string, unknown>): Promise<unknown[]>;
+}
+/**
+ * Workspace context with all discovered information
+ * pf owns this - plugins receive it during setup
+ */
+interface PfWorkspaceContext {
+    /** Absolute path to workspace root */
+    workspaceRoot: string;
+    /** Discovered services (relative paths like 'services/api-gateway') */
+    availableServices: string[];
+    /** Contracts package configuration */
+    contracts: {
+        /** Relative path to contracts source (e.g., 'packages/contracts/src') */
+        path: string;
+        /** Package name (e.g., '@my-platform/contracts') */
+        packageName?: string;
+    };
+}
+/**
+ * Plugin context provided by pf during setup
+ */
+interface PfPluginContext {
+    workspace: PfWorkspaceContext;
+    logger: {
+        debug: (message: string) => void;
+        info: (message: string) => void;
+        warn: (message: string) => void;
+        error: (message: string) => void;
+    };
+}
+/**
+ * A plugin that can be loaded by pf
+ *
+ * Plugins MUST implement this exact interface.
+ * If a plugin has a different internal API, it must provide an adapter.
+ */
+interface PfPlugin {
+    name: string;
+    version: string;
+    description?: string;
+    commands: PfCommand[];
+    flows: PfFlow[];
+    setup: (context: PfPluginContext) => Promise<void> | void;
+}
+/**
+ * Result of loading a plugin
+ */
+interface LoadedPlugin {
+    plugin: PfPlugin;
+    source: string;
+}
+
+export { type ElicitInputEffect as E, type FileWriteEffect as F, type InfraAddEffect as I, type LoadedPlugin as L, type PfWorkspaceContext as P, type PfPluginContext as a, type PfPlugin as b, type PfCommand as c, type PfCommandArg as d, type PfCommandOption as e, type PfFlow as f, type PfEffect as g, type ElicitInputField as h, type EnvAddEffect as i, type PfCommandResult as j, isElicitInputEffect as k };

package/dist/plugin-types.d.mts

@@ -0,0 +1 @@
+export { L as LoadedPlugin, c as PfCommand, d as PfCommandArg, e as PfCommandOption, f as PfFlow, b as PfPlugin, a as PfPluginContext } from './plugin-types-DQOv97Zh.mjs';

package/dist/plugin-types.d.ts

@@ -0,0 +1 @@
+export { L as LoadedPlugin, c as PfCommand, d as PfCommandArg, e as PfCommandOption, f as PfFlow, b as PfPlugin, a as PfPluginContext } from './plugin-types-DQOv97Zh.js';

package/dist/plugin-types.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// cli/src/plugin-types.ts
+var plugin_types_exports = {};
+module.exports = __toCommonJS(plugin_types_exports);
+//# sourceMappingURL=plugin-types.js.map

package/dist/plugin-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../cli/src/plugin-types.ts"],"sourcesContent":["/**\n * Plugin System Types - Public API\n *\n * pf owns and defines these interfaces.\n * Plugins MUST import these and implement them.\n *\n * This is the ONLY public export for plugin development.\n */\n\nexport type {\n  LoadedPlugin,\n  PfCommand,\n  PfCommandArg,\n  PfCommandOption,\n  PfFlow,\n  PfPlugin,\n  PfPluginContext,\n} from './core/plugins'\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/plugin-types.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=plugin-types.mjs.map

package/dist/plugin-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/plugin.d.mts

@@ -0,0 +1,31 @@
+import { P as PfWorkspaceContext, a as PfPluginContext, L as LoadedPlugin, b as PfPlugin } from './plugin-types-DQOv97Zh.mjs';
+export { c as PfCommand, d as PfCommandArg, e as PfCommandOption, f as PfFlow } from './plugin-types-DQOv97Zh.mjs';
+
+/**
+ * Plugin Loader
+ *
+ * pf owns the plugin interface. Plugins MUST conform exactly.
+ * Strict validation - no duck-typing, no fallbacks.
+ */
+
+/**
+ * Validates that an object conforms to the PfPlugin interface
+ */
+declare const validatePlugin: (obj: unknown) => obj is PfPlugin;
+/**
+ * Detailed validation with error messages
+ */
+declare const validatePluginStrict: (obj: unknown) => string[];
+/**
+ * Create a plugin context from workspace discovery
+ */
+declare const createPluginContext: (workspace: PfWorkspaceContext, logger?: PfPluginContext["logger"]) => PfPluginContext;
+/**
+ * Load and initialize a plugin from a module
+ *
+ * @param moduleName - The module to import (e.g., '@crossdelta/cloudevents')
+ * @param context - Full plugin context with workspace info
+ */
+declare const loadPluginFromModule: (moduleName: string, context: PfPluginContext) => Promise<LoadedPlugin>;
+
+export { LoadedPlugin, PfPlugin, PfPluginContext, PfWorkspaceContext, createPluginContext, loadPluginFromModule, validatePlugin, validatePluginStrict };

package/dist/plugin.d.ts

@@ -0,0 +1,31 @@
+import { P as PfWorkspaceContext, a as PfPluginContext, L as LoadedPlugin, b as PfPlugin } from './plugin-types-DQOv97Zh.js';
+export { c as PfCommand, d as PfCommandArg, e as PfCommandOption, f as PfFlow } from './plugin-types-DQOv97Zh.js';
+
+/**
+ * Plugin Loader
+ *
+ * pf owns the plugin interface. Plugins MUST conform exactly.
+ * Strict validation - no duck-typing, no fallbacks.
+ */
+
+/**
+ * Validates that an object conforms to the PfPlugin interface
+ */
+declare const validatePlugin: (obj: unknown) => obj is PfPlugin;
+/**
+ * Detailed validation with error messages
+ */
+declare const validatePluginStrict: (obj: unknown) => string[];
+/**
+ * Create a plugin context from workspace discovery
+ */
+declare const createPluginContext: (workspace: PfWorkspaceContext, logger?: PfPluginContext["logger"]) => PfPluginContext;
+/**
+ * Load and initialize a plugin from a module
+ *
+ * @param moduleName - The module to import (e.g., '@crossdelta/cloudevents')
+ * @param context - Full plugin context with workspace info
+ */
+declare const loadPluginFromModule: (moduleName: string, context: PfPluginContext) => Promise<LoadedPlugin>;
+
+export { LoadedPlugin, PfPlugin, PfPluginContext, PfWorkspaceContext, createPluginContext, loadPluginFromModule, validatePlugin, validatePluginStrict };

package/dist/plugin.js

@@ -0,0 +1,105 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// cli/src/core/plugins/index.ts
+var plugins_exports = {};
+__export(plugins_exports, {
+  createPluginContext: () => createPluginContext,
+  loadPluginFromModule: () => loadPluginFromModule,
+  validatePlugin: () => validatePlugin,
+  validatePluginStrict: () => validatePluginStrict
+});
+module.exports = __toCommonJS(plugins_exports);
+
+// cli/src/core/plugins/loader.ts
+var defaultLogger = {
+  debug: () => {
+  },
+  info: console.log,
+  warn: console.warn,
+  error: console.error
+};
+var isObject = (val) => val !== null && typeof val === "object";
+var isNonEmptyString = (val) => typeof val === "string" && val.length > 0;
+var isString = (val) => typeof val === "string";
+var isFunction = (val) => typeof val === "function";
+var validateCommand = (cmd, index) => {
+  if (!isObject(cmd)) return [`commands[${index}]: must be an object`];
+  return [
+    !isNonEmptyString(cmd.name) && `commands[${index}]: missing or invalid 'name'`,
+    !isString(cmd.description) && `commands[${index}]: missing or invalid 'description'`,
+    !Array.isArray(cmd.args) && `commands[${index}]: missing 'args' array`,
+    !Array.isArray(cmd.options) && `commands[${index}]: missing 'options' array`,
+    !isFunction(cmd.run) && `commands[${index}]: missing 'run' function`
+  ].filter((e) => e !== false);
+};
+var validatePlugin = (obj) => {
+  if (!isObject(obj)) return false;
+  return isNonEmptyString(obj.name) && isString(obj.version) && Array.isArray(obj.commands) && Array.isArray(obj.flows) && isFunction(obj.setup);
+};
+var validatePluginStrict = (obj) => {
+  if (!isObject(obj)) return ["Plugin must be an object"];
+  const baseErrors = [
+    !isNonEmptyString(obj.name) && "Missing or invalid 'name'",
+    !isString(obj.version) && "Missing or invalid 'version'",
+    !Array.isArray(obj.commands) && "Missing 'commands' array",
+    !Array.isArray(obj.flows) && "Missing 'flows' array",
+    !isFunction(obj.setup) && "Missing 'setup' function"
+  ].filter((e) => e !== false);
+  const commandErrors = Array.isArray(obj.commands) ? obj.commands.flatMap((cmd, i) => validateCommand(cmd, i)) : [];
+  return [...baseErrors, ...commandErrors];
+};
+var createPluginContext = (workspace, logger = defaultLogger) => ({
+  workspace,
+  logger
+});
+var loadPluginFromModule = async (moduleName, context) => {
+  const { logger } = context;
+  logger.debug(`Loading plugin from module: ${moduleName}`);
+  const mod = await import(moduleName);
+  const createPlugin = mod.createPfPlugin || mod.default?.createPfPlugin;
+  if (!isFunction(createPlugin)) {
+    throw new Error(`Module ${moduleName} does not export createPfPlugin`);
+  }
+  const plugin = createPlugin({
+    contractsPath: context.workspace.contracts.path,
+    contractsPackage: context.workspace.contracts.packageName,
+    availableServices: context.workspace.availableServices
+  });
+  const errors = validatePluginStrict(plugin);
+  if (errors.length > 0) {
+    throw new Error(`Plugin from ${moduleName} does not conform to PfPlugin interface:
+  - ${errors.join("\n  - ")}`);
+  }
+  const validatedPlugin = plugin;
+  logger.debug(`Loaded plugin: ${validatedPlugin.name} v${validatedPlugin.version}`);
+  await validatedPlugin.setup(context);
+  return {
+    plugin: validatedPlugin,
+    source: moduleName
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createPluginContext,
+  loadPluginFromModule,
+  validatePlugin,
+  validatePluginStrict
+});
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../cli/src/core/plugins/index.ts","../cli/src/core/plugins/loader.ts"],"sourcesContent":["/**\n * Plugin System\n *\n * pf owns and defines the plugin interfaces.\n * Plugins MUST adapt to these interfaces.\n */\n\nexport {\n  createPluginContext,\n  loadPluginFromModule,\n  validatePlugin,\n  validatePluginStrict,\n} from './loader'\nexport type {\n  LoadedPlugin,\n  PfCommand,\n  PfCommandArg,\n  PfCommandOption,\n  PfFlow,\n  PfPlugin,\n  PfPluginContext,\n  PfWorkspaceContext,\n} from './types'\n","/**\n * Plugin Loader\n *\n * pf owns the plugin interface. Plugins MUST conform exactly.\n * Strict validation - no duck-typing, no fallbacks.\n */\nimport type { LoadedPlugin, PfPlugin, PfPluginContext, PfWorkspaceContext } from './types'\n\nconst defaultLogger: PfPluginContext['logger'] = {\n  debug: () => {},\n  info: console.log,\n  warn: console.warn,\n  error: console.error,\n}\n\nconst isObject = (val: unknown): val is Record<string, unknown> =>\n  val !== null && typeof val === 'object'\n\nconst isNonEmptyString = (val: unknown): val is string =>\n  typeof val === 'string' && val.length > 0\n\nconst isString = (val: unknown): val is string =>\n  typeof val === 'string'\n\nconst isFunction = (val: unknown): val is (...args: unknown[]) => unknown =>\n  typeof val === 'function'\n\n/**\n * Validates a single command conforms to PfCommand interface\n */\nconst validateCommand = (cmd: unknown, index: number): string[] => {\n  if (!isObject(cmd)) return [`commands[${index}]: must be an object`]\n\n  return [\n    !isNonEmptyString(cmd.name) && `commands[${index}]: missing or invalid 'name'`,\n    !isString(cmd.description) && `commands[${index}]: missing or invalid 'description'`,\n    !Array.isArray(cmd.args) && `commands[${index}]: missing 'args' array`,\n    !Array.isArray(cmd.options) && `commands[${index}]: missing 'options' array`,\n    !isFunction(cmd.run) && `commands[${index}]: missing 'run' function`,\n  ].filter((e): e is string => e !== false)\n}\n\n/**\n * Validates that an object conforms to the PfPlugin interface\n */\nexport const validatePlugin = (obj: unknown): obj is PfPlugin => {\n  if (!isObject(obj)) return false\n\n  return (\n    isNonEmptyString(obj.name) &&\n    isString(obj.version) &&\n    Array.isArray(obj.commands) &&\n    Array.isArray(obj.flows) &&\n    isFunction(obj.setup)\n  )\n}\n\n/**\n * Detailed validation with error messages\n */\nexport const validatePluginStrict = (obj: unknown): string[] => {\n  if (!isObject(obj)) return ['Plugin must be an object']\n\n  const baseErrors = [\n    !isNonEmptyString(obj.name) && \"Missing or invalid 'name'\",\n    !isString(obj.version) && \"Missing or invalid 'version'\",\n    !Array.isArray(obj.commands) && \"Missing 'commands' array\",\n    !Array.isArray(obj.flows) && \"Missing 'flows' array\",\n    !isFunction(obj.setup) && \"Missing 'setup' function\",\n  ].filter((e): e is string => e !== false)\n\n  const commandErrors = Array.isArray(obj.commands)\n    ? obj.commands.flatMap((cmd, i) => validateCommand(cmd, i))\n    : []\n\n  return [...baseErrors, ...commandErrors]\n}\n\n/**\n * Create a plugin context from workspace discovery\n */\nexport const createPluginContext = (\n  workspace: PfWorkspaceContext,\n  logger: PfPluginContext['logger'] = defaultLogger,\n): PfPluginContext => ({\n  workspace,\n  logger,\n})\n\n/**\n * Load and initialize a plugin from a module\n *\n * @param moduleName - The module to import (e.g., '@crossdelta/cloudevents')\n * @param context - Full plugin context with workspace info\n */\nexport const loadPluginFromModule = async (\n  moduleName: string,\n  context: PfPluginContext,\n): Promise<LoadedPlugin> => {\n  const { logger } = context\n\n  logger.debug(`Loading plugin from module: ${moduleName}`)\n\n  const mod = await import(moduleName)\n\n  const createPlugin = mod.createPfPlugin || mod.default?.createPfPlugin\n  if (!isFunction(createPlugin)) {\n    throw new Error(`Module ${moduleName} does not export createPfPlugin`)\n  }\n\n  const plugin = createPlugin({\n    contractsPath: context.workspace.contracts.path,\n    contractsPackage: context.workspace.contracts.packageName,\n    availableServices: context.workspace.availableServices,\n  })\n\n  const errors = validatePluginStrict(plugin)\n  if (errors.length > 0) {\n    throw new Error(`Plugin from ${moduleName} does not conform to PfPlugin interface:\\n  - ${errors.join('\\n  - ')}`)\n  }\n\n  const validatedPlugin = plugin as PfPlugin\n\n  logger.debug(`Loaded plugin: ${validatedPlugin.name} v${validatedPlugin.version}`)\n\n  await validatedPlugin.setup(context)\n\n  return {\n    plugin: validatedPlugin,\n    source: moduleName,\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/plugin.mjs

@@ -0,0 +1,75 @@
+// cli/src/core/plugins/loader.ts
+var defaultLogger = {
+  debug: () => {
+  },
+  info: console.log,
+  warn: console.warn,
+  error: console.error
+};
+var isObject = (val) => val !== null && typeof val === "object";
+var isNonEmptyString = (val) => typeof val === "string" && val.length > 0;
+var isString = (val) => typeof val === "string";
+var isFunction = (val) => typeof val === "function";
+var validateCommand = (cmd, index) => {
+  if (!isObject(cmd)) return [`commands[${index}]: must be an object`];
+  return [
+    !isNonEmptyString(cmd.name) && `commands[${index}]: missing or invalid 'name'`,
+    !isString(cmd.description) && `commands[${index}]: missing or invalid 'description'`,
+    !Array.isArray(cmd.args) && `commands[${index}]: missing 'args' array`,
+    !Array.isArray(cmd.options) && `commands[${index}]: missing 'options' array`,
+    !isFunction(cmd.run) && `commands[${index}]: missing 'run' function`
+  ].filter((e) => e !== false);
+};
+var validatePlugin = (obj) => {
+  if (!isObject(obj)) return false;
+  return isNonEmptyString(obj.name) && isString(obj.version) && Array.isArray(obj.commands) && Array.isArray(obj.flows) && isFunction(obj.setup);
+};
+var validatePluginStrict = (obj) => {
+  if (!isObject(obj)) return ["Plugin must be an object"];
+  const baseErrors = [
+    !isNonEmptyString(obj.name) && "Missing or invalid 'name'",
+    !isString(obj.version) && "Missing or invalid 'version'",
+    !Array.isArray(obj.commands) && "Missing 'commands' array",
+    !Array.isArray(obj.flows) && "Missing 'flows' array",
+    !isFunction(obj.setup) && "Missing 'setup' function"
+  ].filter((e) => e !== false);
+  const commandErrors = Array.isArray(obj.commands) ? obj.commands.flatMap((cmd, i) => validateCommand(cmd, i)) : [];
+  return [...baseErrors, ...commandErrors];
+};
+var createPluginContext = (workspace, logger = defaultLogger) => ({
+  workspace,
+  logger
+});
+var loadPluginFromModule = async (moduleName, context) => {
+  const { logger } = context;
+  logger.debug(`Loading plugin from module: ${moduleName}`);
+  const mod = await import(moduleName);
+  const createPlugin = mod.createPfPlugin || mod.default?.createPfPlugin;
+  if (!isFunction(createPlugin)) {
+    throw new Error(`Module ${moduleName} does not export createPfPlugin`);
+  }
+  const plugin = createPlugin({
+    contractsPath: context.workspace.contracts.path,
+    contractsPackage: context.workspace.contracts.packageName,
+    availableServices: context.workspace.availableServices
+  });
+  const errors = validatePluginStrict(plugin);
+  if (errors.length > 0) {
+    throw new Error(`Plugin from ${moduleName} does not conform to PfPlugin interface:
+  - ${errors.join("\n  - ")}`);
+  }
+  const validatedPlugin = plugin;
+  logger.debug(`Loaded plugin: ${validatedPlugin.name} v${validatedPlugin.version}`);
+  await validatedPlugin.setup(context);
+  return {
+    plugin: validatedPlugin,
+    source: moduleName
+  };
+};
+export {
+  createPluginContext,
+  loadPluginFromModule,
+  validatePlugin,
+  validatePluginStrict
+};
+//# sourceMappingURL=plugin.mjs.map

package/dist/plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../cli/src/core/plugins/loader.ts"],"sourcesContent":["/**\n * Plugin Loader\n *\n * pf owns the plugin interface. Plugins MUST conform exactly.\n * Strict validation - no duck-typing, no fallbacks.\n */\nimport type { LoadedPlugin, PfPlugin, PfPluginContext, PfWorkspaceContext } from './types'\n\nconst defaultLogger: PfPluginContext['logger'] = {\n  debug: () => {},\n  info: console.log,\n  warn: console.warn,\n  error: console.error,\n}\n\nconst isObject = (val: unknown): val is Record<string, unknown> =>\n  val !== null && typeof val === 'object'\n\nconst isNonEmptyString = (val: unknown): val is string =>\n  typeof val === 'string' && val.length > 0\n\nconst isString = (val: unknown): val is string =>\n  typeof val === 'string'\n\nconst isFunction = (val: unknown): val is (...args: unknown[]) => unknown =>\n  typeof val === 'function'\n\n/**\n * Validates a single command conforms to PfCommand interface\n */\nconst validateCommand = (cmd: unknown, index: number): string[] => {\n  if (!isObject(cmd)) return [`commands[${index}]: must be an object`]\n\n  return [\n    !isNonEmptyString(cmd.name) && `commands[${index}]: missing or invalid 'name'`,\n    !isString(cmd.description) && `commands[${index}]: missing or invalid 'description'`,\n    !Array.isArray(cmd.args) && `commands[${index}]: missing 'args' array`,\n    !Array.isArray(cmd.options) && `commands[${index}]: missing 'options' array`,\n    !isFunction(cmd.run) && `commands[${index}]: missing 'run' function`,\n  ].filter((e): e is string => e !== false)\n}\n\n/**\n * Validates that an object conforms to the PfPlugin interface\n */\nexport const validatePlugin = (obj: unknown): obj is PfPlugin => {\n  if (!isObject(obj)) return false\n\n  return (\n    isNonEmptyString(obj.name) &&\n    isString(obj.version) &&\n    Array.isArray(obj.commands) &&\n    Array.isArray(obj.flows) &&\n    isFunction(obj.setup)\n  )\n}\n\n/**\n * Detailed validation with error messages\n */\nexport const validatePluginStrict = (obj: unknown): string[] => {\n  if (!isObject(obj)) return ['Plugin must be an object']\n\n  const baseErrors = [\n    !isNonEmptyString(obj.name) && \"Missing or invalid 'name'\",\n    !isString(obj.version) && \"Missing or invalid 'version'\",\n    !Array.isArray(obj.commands) && \"Missing 'commands' array\",\n    !Array.isArray(obj.flows) && \"Missing 'flows' array\",\n    !isFunction(obj.setup) && \"Missing 'setup' function\",\n  ].filter((e): e is string => e !== false)\n\n  const commandErrors = Array.isArray(obj.commands)\n    ? obj.commands.flatMap((cmd, i) => validateCommand(cmd, i))\n    : []\n\n  return [...baseErrors, ...commandErrors]\n}\n\n/**\n * Create a plugin context from workspace discovery\n */\nexport const createPluginContext = (\n  workspace: PfWorkspaceContext,\n  logger: PfPluginContext['logger'] = defaultLogger,\n): PfPluginContext => ({\n  workspace,\n  logger,\n})\n\n/**\n * Load and initialize a plugin from a module\n *\n * @param moduleName - The module to import (e.g., '@crossdelta/cloudevents')\n * @param context - Full plugin context with workspace info\n */\nexport const loadPluginFromModule = async (\n  moduleName: string,\n  context: PfPluginContext,\n): Promise<LoadedPlugin> => {\n  const { logger } = context\n\n  logger.debug(`Loading plugin from module: ${moduleName}`)\n\n  const mod = await import(moduleName)\n\n  const createPlugin = mod.createPfPlugin || mod.default?.createPfPlugin\n  if (!isFunction(createPlugin)) {\n    throw new Error(`Module ${moduleName} does not export createPfPlugin`)\n  }\n\n  const plugin = createPlugin({\n    contractsPath: context.workspace.contracts.path,\n    contractsPackage: context.workspace.contracts.packageName,\n    availableServices: context.workspace.availableServices,\n  })\n\n  const errors = validatePluginStrict(plugin)\n  if (errors.length > 0) {\n    throw new Error(`Plugin from ${moduleName} does not conform to PfPlugin interface:\\n  - ${errors.join('\\n  - ')}`)\n  }\n\n  const validatedPlugin = plugin as PfPlugin\n\n  logger.debug(`Loaded plugin: ${validatedPlugin.name} v${validatedPlugin.version}`)\n\n  await validatedPlugin.setup(context)\n\n  return {\n    plugin: validatedPlugin,\n    source: moduleName,\n  }\n}\n"],"mappings":"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","names":[]}