@lumenflow/mcp 3.2.0 → 3.2.2

package/dist/bin.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * @file bin.ts
+ * @description CLI entry point for @lumenflow/mcp
+ *
+ * WU-1412: MCP server runs via npx @lumenflow/mcp over stdio
+ *
+ * Usage:
+ *   npx @lumenflow/mcp
+ *
+ * Environment variables:
+ *   LUMENFLOW_PROJECT_ROOT - Project root directory
+ *   LUMENFLOW_MCP_LOG_LEVEL - Log level (debug, info, warn, error)
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAGA;;;;;;;;;;;;GAYG"}

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,iCAAiC;AACjC,yCAAyC;AACzC;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,eAAe,EAAiB,MAAM,aAAa,CAAC;AAE7D;;GAEG;AACH,SAAS,GAAG,CAAC,OAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,uBAA+C,CAAC;IAE7E,MAAM,MAAM,GAAG,eAAe,CAAC;QAC7B,WAAW;QACX,QAAQ;KACT,CAAC,CAAC;IAEH,0DAA0D;IAC1D,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QAChD,GAAG,CAAC,yCAAyC,CAAC,CAAC;QAC/C,GAAG,CAAC,kCAAkC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACnE,GAAG,CAAC,+BAA+B,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7D,GAAG,CACD,2BAA2B,MAAM;aAC9B,SAAS,EAAE;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;QACF,GAAG,CACD,+BAA+B,MAAM;aAClC,aAAa,EAAE;aACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;aACjB,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,MAAM,cAAc,GAAG,CAAC,MAAc,EAAQ,EAAE;QAC9C,GAAG,CAAC,6BAA6B,MAAM,oBAAoB,CAAC,CAAC;QAC7D,MAAM;aACH,IAAI,EAAE;aACN,IAAI,CAAC,GAAG,EAAE;YACT,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,GAAG,CACD,2CAA2C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC9F,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;IAEvD,mBAAmB;IACnB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,WAAW;AACX,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,GAAG,CAAC,iCAAiC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli-runner.d.ts

@@ -0,0 +1,58 @@
+/**
+ * CLI runner options
+ */
+export interface CliRunnerOptions {
+    /** Working directory for command execution (defaults to process.cwd()) */
+    projectRoot?: string;
+    /** Command timeout in milliseconds (defaults to 120000 = 2 minutes) */
+    timeout?: number;
+    /** Additional environment variables */
+    env?: Record<string, string>;
+}
+/**
+ * CLI runner result
+ */
+export interface CliRunnerResult {
+    /** Whether the command succeeded (exit code 0) */
+    success: boolean;
+    /** Standard output */
+    stdout: string;
+    /** Standard error output */
+    stderr: string;
+    /** Exit code (if available) */
+    exitCode?: number;
+    /** Error object (if command failed) */
+    error?: {
+        message: string;
+        code?: string | number;
+    };
+}
+/**
+ * Build ordered command candidates (canonical first, then compatibility aliases).
+ */
+export declare function getCommandCandidates(command: string): string[];
+/**
+ * Execute a LumenFlow CLI command
+ *
+ * @param command - CLI command to execute (e.g., 'wu:status', 'wu:claim', 'gates')
+ * @param args - Command arguments
+ * @param options - Execution options
+ * @returns Command execution result
+ *
+ * @example
+ * // Get WU status
+ * const result = await runCliCommand('wu:status', ['--id', 'WU-1412', '--json']);
+ *
+ * @example
+ * // Run gates
+ * const result = await runCliCommand('gates', ['--docs-only']);
+ */
+export declare function runCliCommand(command: string, args?: string[], options?: CliRunnerOptions): Promise<CliRunnerResult>;
+/**
+ * Parse JSON output from a CLI command
+ *
+ * @param result - CLI runner result
+ * @returns Parsed JSON data or null if parsing fails
+ */
+export declare function parseJsonOutput<T>(result: CliRunnerResult): T | null;
+//# sourceMappingURL=cli-runner.d.ts.map

package/dist/cli-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.d.ts","sourceRoot":"","sources":["../src/cli-runner.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KACxB,CAAC;CACH;AAwBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ9D;AAwED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA6B1B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,GAAG,CAAC,GAAG,IAAI,CAUpE"}

package/dist/cli-runner.js

@@ -0,0 +1,164 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file cli-runner.ts
+ * @description CLI runner utility for shelling out to LumenFlow CLI commands
+ *
+ * WU-1412: MCP server uses CLI shell-out for write operations (wu_create, wu_claim, wu_done, gates_run)
+ * Read operations use @lumenflow/core directly for better performance and type safety.
+ *
+ * This module provides a safe, consistent way to execute CLI commands with:
+ * - Timeout support
+ * - Project root configuration
+ * - Proper error handling
+ * - Structured output
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/**
+ * Default timeout for CLI commands (2 minutes)
+ */
+const DEFAULT_TIMEOUT_MS = 120000;
+/**
+ * Canonical-first command fallback matrix.
+ *
+ * When a canonical command is unavailable in a target project (missing script),
+ * retry with compatibility aliases to preserve low-cost backwards compatibility.
+ */
+const COMMAND_FALLBACKS = {
+    'agent:session-end': ['agent:session:end'],
+    'initiative:bulk-assign': ['initiative:bulk-assign-wus'],
+    lumenflow: ['lumenflow:init', 'lumenflow-init'],
+    gates: ['lumenflow:gates', 'lumenflow-gates'],
+    validate: ['lumenflow:validate', 'lumenflow-validate'],
+    'lumenflow:release': ['release'],
+    'docs:sync': ['lumenflow:docs-sync', 'lumenflow-docs-sync'],
+    'sync:templates': ['lumenflow:sync-templates', 'lumenflow-sync-templates'],
+};
+/**
+ * Build ordered command candidates (canonical first, then compatibility aliases).
+ */
+export function getCommandCandidates(command) {
+    const seen = new Set();
+    const ordered = [command, ...(COMMAND_FALLBACKS[command] || [])];
+    return ordered.filter((candidate) => {
+        if (seen.has(candidate))
+            return false;
+        seen.add(candidate);
+        return true;
+    });
+}
+/**
+ * Returns true when the command failed because the script/command wasn't found.
+ */
+function isMissingCommandFailure(result) {
+    const detail = `${result.stderr}\n${result.error?.message || ''}`;
+    return (/ERR_PNPM_NO_SCRIPT/i.test(detail) ||
+        /Command\s+["'][^"']+["']\s+not\s+found/i.test(detail) ||
+        /Unknown command/i.test(detail) ||
+        /No matching command found/i.test(detail));
+}
+/**
+ * Execute a single pnpm command without fallback behavior.
+ */
+async function runSingleCommand(command, args = [], options = {}) {
+    const projectRoot = options.projectRoot || process.cwd();
+    const timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
+    // Use pnpm to run the command
+    const pnpmPath = 'pnpm';
+    const pnpmArgs = [command, ...args];
+    try {
+        const { stdout, stderr } = await execFileAsync(pnpmPath, pnpmArgs, {
+            cwd: projectRoot,
+            timeout,
+            env: {
+                ...process.env,
+                ...options.env,
+                // Ensure we're in non-interactive mode
+                CI: 'true',
+                // Pass through project root
+                LUMENFLOW_PROJECT_ROOT: projectRoot,
+            },
+            maxBuffer: 10 * 1024 * 1024, // 10MB buffer
+        });
+        return {
+            success: true,
+            stdout: stdout.trim(),
+            stderr: stderr.trim(),
+            exitCode: 0,
+        };
+    }
+    catch (err) {
+        const error = err;
+        return {
+            success: false,
+            stdout: error.stdout?.trim() || '',
+            stderr: error.stderr?.trim() || '',
+            exitCode: typeof error.code === 'number' ? error.code : 1,
+            error: {
+                message: error.message,
+                code: error.code,
+            },
+        };
+    }
+}
+/**
+ * Execute a LumenFlow CLI command
+ *
+ * @param command - CLI command to execute (e.g., 'wu:status', 'wu:claim', 'gates')
+ * @param args - Command arguments
+ * @param options - Execution options
+ * @returns Command execution result
+ *
+ * @example
+ * // Get WU status
+ * const result = await runCliCommand('wu:status', ['--id', 'WU-1412', '--json']);
+ *
+ * @example
+ * // Run gates
+ * const result = await runCliCommand('gates', ['--docs-only']);
+ */
+export async function runCliCommand(command, args = [], options = {}) {
+    const candidates = getCommandCandidates(command);
+    let lastFailure = null;
+    for (let i = 0; i < candidates.length; i++) {
+        const candidate = candidates[i];
+        if (!candidate)
+            continue;
+        const result = await runSingleCommand(candidate, args, options);
+        if (result.success) {
+            return result;
+        }
+        lastFailure = result;
+        const hasFallbackRemaining = i < candidates.length - 1;
+        if (!hasFallbackRemaining || !isMissingCommandFailure(result)) {
+            return result;
+        }
+    }
+    return (lastFailure || {
+        success: false,
+        stdout: '',
+        stderr: 'Command execution failed',
+        exitCode: 1,
+        error: { message: 'Command execution failed' },
+    });
+}
+/**
+ * Parse JSON output from a CLI command
+ *
+ * @param result - CLI runner result
+ * @returns Parsed JSON data or null if parsing fails
+ */
+export function parseJsonOutput(result) {
+    if (!result.success || !result.stdout) {
+        return null;
+    }
+    try {
+        return JSON.parse(result.stdout);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=cli-runner.js.map

package/dist/cli-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.js","sourceRoot":"","sources":["../src/cli-runner.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @lumenflow/mcp - MCP stdio server for LumenFlow workflow framework
+ * @module @lumenflow/mcp
+ *
+ * WU-1412: Provides MCP server with LumenFlow tools and resources.
+ *
+ * Tools:
+ * - context_get: Get current LumenFlow context
+ * - wu_list: List all Work Units
+ * - wu_status: Get WU status
+ * - wu_create: Create a new WU
+ * - wu_claim: Claim a WU
+ * - wu_done: Complete a WU
+ * - gates_run: Run quality gates
+ *
+ * Resources:
+ * - lumenflow://context: Current context
+ * - lumenflow://wu/{id}: WU by ID
+ * - lumenflow://backlog: Current backlog
+ *
+ * @example
+ * ```typescript
+ * import { createMcpServer } from '@lumenflow/mcp';
+ *
+ * const server = createMcpServer({
+ *   projectRoot: '/path/to/project',
+ *   logLevel: 'info',
+ * });
+ *
+ * await server.start();
+ * ```
+ */
+export { createMcpServer, type McpServer, type McpServerConfig, type LogLevel } from './server.js';
+export { allTools, contextGetTool, wuListTool, wuStatusTool, wuCreateTool, wuClaimTool, wuDoneTool, gatesRunTool, type ToolDefinition, type ToolResult, } from './tools.js';
+export { allResources, staticResources, resourceTemplates, contextResource, wuResource, backlogResource, type ResourceDefinition, type ResourceResult, } from './resources.js';
+export { runCliCommand, parseJsonOutput, type CliRunnerOptions, type CliRunnerResult, } from './cli-runner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGnG,OAAO,EACL,QAAQ,EACR,cAAc,EACd,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,SAAS;AACT,OAAO,EAAE,eAAe,EAAuD,MAAM,aAAa,CAAC;AAEnG,QAAQ;AACR,OAAO,EACL,QAAQ,EACR,cAAc,EACd,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,GAGb,MAAM,YAAY,CAAC;AAEpB,YAAY;AACZ,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,eAAe,GAGhB,MAAM,gBAAgB,CAAC;AAExB,aAAa;AACb,OAAO,EACL,aAAa,EACb,eAAe,GAGhB,MAAM,iBAAiB,CAAC"}

package/dist/mcp-constants.d.ts

@@ -0,0 +1,177 @@
+/**
+ * @file mcp-constants.ts
+ * @description Typed source-of-truth constants for MCP governed literal families.
+ *
+ * Governed families:
+ * 1. CLI command names — canonical map of all commands dispatched via runCliCommand/executeViaPack
+ * 2. Cross-boundary metadata keys — keys used in ExecutionContext.metadata across modules
+ *
+ * Scoping rule: CLI flags are governed in tools-shared.ts (CliArgs). Only flags
+ * appearing in 3 or more tool definitions are centralized there. Tool-local flags
+ * (< 3 uses) remain as local string literals.
+ *
+ * WU-1851: Initial governance module.
+ */
+/**
+ * Canonical CLI command name constants.
+ *
+ * Every string passed to `runCliCommand()`, `executeViaPack()`, or used in
+ * `fallback.command` MUST reference a value from this object.
+ *
+ * Organized by domain to match tool file groupings.
+ */
+export declare const CliCommands: {
+    readonly WU_STATUS: "wu:status";
+    readonly WU_CREATE: "wu:create";
+    readonly WU_CLAIM: "wu:claim";
+    readonly WU_SANDBOX: "wu:sandbox";
+    readonly WU_DONE: "wu:done";
+    readonly WU_BLOCK: "wu:block";
+    readonly WU_UNBLOCK: "wu:unblock";
+    readonly WU_EDIT: "wu:edit";
+    readonly WU_RELEASE: "wu:release";
+    readonly WU_RECOVER: "wu:recover";
+    readonly WU_REPAIR: "wu:repair";
+    readonly WU_DEPS: "wu:deps";
+    readonly WU_PREP: "wu:prep";
+    readonly WU_PREFLIGHT: "wu:preflight";
+    readonly WU_PRUNE: "wu:prune";
+    readonly WU_DELETE: "wu:delete";
+    readonly WU_CLEANUP: "wu:cleanup";
+    readonly WU_BRIEF: "wu:brief";
+    readonly WU_DELEGATE: "wu:delegate";
+    readonly WU_VALIDATE: "wu:validate";
+    readonly WU_INFER_LANE: "wu:infer-lane";
+    readonly WU_UNLOCK_LANE: "wu:unlock-lane";
+    readonly WU_PROTO: "wu:proto";
+    readonly WU_LIST: "wu:list";
+    readonly GATES: "gates";
+    readonly STATE_BOOTSTRAP: "state:bootstrap";
+    readonly STATE_CLEANUP: "state:cleanup";
+    readonly STATE_DOCTOR: "state:doctor";
+    readonly BACKLOG_PRUNE: "backlog:prune";
+    readonly DOCS_SYNC: "docs:sync";
+    readonly SYNC_TEMPLATES: "sync:templates";
+    readonly LUMENFLOW: "lumenflow";
+    readonly LANE_HEALTH: "lane:health";
+    readonly LANE_SUGGEST: "lane:suggest";
+    readonly SIGNAL_CLEANUP: "signal:cleanup";
+    readonly CONFIG_SET: "config:set";
+    readonly CONFIG_GET: "config:get";
+    readonly CLOUD_CONNECT: "cloud:connect";
+    readonly ONBOARD: "onboard";
+    readonly LUMENFLOW_ONBOARD: "lumenflow-onboard";
+    readonly WORKSPACE_INIT: "workspace:init";
+    readonly FILE_READ: "file:read";
+    readonly FILE_WRITE: "file:write";
+    readonly FILE_EDIT: "file:edit";
+    readonly FILE_DELETE: "file:delete";
+    readonly GIT_STATUS: "git:status";
+    readonly GIT_DIFF: "git:diff";
+    readonly GIT_LOG: "git:log";
+    readonly GIT_BRANCH: "git:branch";
+    readonly INIT_PLAN: "init:plan";
+    readonly PLAN_CREATE: "plan:create";
+    readonly PLAN_EDIT: "plan:edit";
+    readonly PLAN_LINK: "plan:link";
+    readonly PLAN_PROMOTE: "plan:promote";
+    readonly LUMENFLOW_DOCTOR: "lumenflow:doctor";
+    readonly LUMENFLOW_INTEGRATE: "lumenflow:integrate";
+    readonly LUMENFLOW_UPGRADE: "lumenflow:upgrade";
+    readonly LUMENFLOW_RELEASE: "lumenflow:release";
+    readonly LUMENFLOW_VALIDATE: "lumenflow:validate";
+    readonly VALIDATE: "validate";
+    readonly VALIDATE_AGENT_SKILLS: "validate:agent-skills";
+    readonly VALIDATE_AGENT_SYNC: "validate:agent-sync";
+    readonly VALIDATE_BACKLOG_SYNC: "validate:backlog-sync";
+    readonly VALIDATE_SKILLS_SPEC: "validate:skills-spec";
+    readonly INITIATIVE_LIST: "initiative:list";
+    readonly INITIATIVE_STATUS: "initiative:status";
+    readonly INITIATIVE_CREATE: "initiative:create";
+    readonly INITIATIVE_EDIT: "initiative:edit";
+    readonly INITIATIVE_ADD_WU: "initiative:add-wu";
+    readonly INITIATIVE_REMOVE_WU: "initiative:remove-wu";
+    readonly INITIATIVE_BULK_ASSIGN: "initiative:bulk-assign";
+    readonly INITIATIVE_PLAN: "initiative:plan";
+    readonly ORCHESTRATE_INITIATIVE: "orchestrate:initiative";
+    readonly ORCHESTRATE_INIT_STATUS: "orchestrate:init-status";
+    readonly ORCHESTRATE_MONITOR: "orchestrate:monitor";
+    readonly DELEGATION_LIST: "delegation:list";
+    readonly AGENT_SESSION: "agent:session";
+    readonly AGENT_SESSION_END: "agent:session-end";
+    readonly AGENT_LOG_ISSUE: "agent:log-issue";
+    readonly AGENT_ISSUES_QUERY: "agent:issues-query";
+    readonly MEM_INIT: "mem:init";
+    readonly MEM_START: "mem:start";
+    readonly MEM_READY: "mem:ready";
+    readonly MEM_CHECKPOINT: "mem:checkpoint";
+    readonly MEM_CLEANUP: "mem:cleanup";
+    readonly MEM_CONTEXT: "mem:context";
+    readonly MEM_CREATE: "mem:create";
+    readonly MEM_DELETE: "mem:delete";
+    readonly MEM_EXPORT: "mem:export";
+    readonly MEM_INBOX: "mem:inbox";
+    readonly MEM_SIGNAL: "mem:signal";
+    readonly MEM_SUMMARIZE: "mem:summarize";
+    readonly MEM_TRIAGE: "mem:triage";
+    readonly MEM_RECOVER: "mem:recover";
+    readonly CONTEXT_GET: "context:get";
+    readonly FLOW_BOTTLENECKS: "flow:bottlenecks";
+    readonly FLOW_REPORT: "flow:report";
+    readonly METRICS_SNAPSHOT: "metrics:snapshot";
+    readonly LUMENFLOW_METRICS: "lumenflow:metrics";
+    readonly METRICS: "metrics";
+};
+export type CliCommandName = (typeof CliCommands)[keyof typeof CliCommands];
+/**
+ * Metadata key constants used in ExecutionContext.metadata across MCP modules.
+ * These cross module boundaries and must be consistent.
+ */
+export declare const MetadataKeys: {
+    readonly PROJECT_ROOT: "project_root";
+    readonly INVOCATION_MODE: "invocation_mode";
+};
+export type MetadataKey = (typeof MetadataKeys)[keyof typeof MetadataKeys];
+/**
+ * Environment variables used by MCP runtime execution policy.
+ */
+export declare const McpEnvironmentVariables: {
+    readonly MIGRATION_COMPAT_MODE: "LUMENFLOW_MCP_MIGRATION_COMPAT_MODE";
+};
+/**
+ * Compatibility modes for executeViaPack migration fallback behavior.
+ *
+ * - compat: allow temporary CLI fallback for migration-only reasons
+ * - strict: fail closed when runtime cannot serve migration-only tools
+ */
+export declare const MigrationCompatModes: {
+    readonly COMPAT: "compat";
+    readonly STRICT: "strict";
+};
+export type MigrationCompatMode = (typeof MigrationCompatModes)[keyof typeof MigrationCompatModes];
+/**
+ * Canonical migration fallback error codes used by executeViaPack guardrails.
+ */
+export declare const MigrationFallbackErrorCodes: {
+    readonly DISABLED: "MCP_MIGRATION_FALLBACK_DISABLED";
+    readonly EXECUTION_FAILED: "MCP_MIGRATION_FALLBACK_ERROR";
+};
+export type MigrationFallbackErrorCode = (typeof MigrationFallbackErrorCodes)[keyof typeof MigrationFallbackErrorCodes];
+/**
+ * Structured reasons for migration fallback attempts.
+ */
+export declare const MigrationFallbackReasons: {
+    readonly RUNTIME_INIT_FAILED: "runtime_init_failed";
+    readonly RUNTIME_TOOL_NOT_FOUND: "runtime_tool_not_found";
+};
+export type MigrationFallbackReason = (typeof MigrationFallbackReasons)[keyof typeof MigrationFallbackReasons];
+/**
+ * Structured outcomes for migration fallback telemetry events.
+ */
+export declare const MigrationFallbackOutcomes: {
+    readonly SUCCEEDED: "succeeded";
+    readonly FAILED: "failed";
+    readonly BLOCKED: "blocked";
+};
+export type MigrationFallbackOutcome = (typeof MigrationFallbackOutcomes)[keyof typeof MigrationFallbackOutcomes];
+//# sourceMappingURL=mcp-constants.d.ts.map

package/dist/mcp-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-constants.d.ts","sourceRoot":"","sources":["../src/mcp-constants.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAMH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkId,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAM5E;;;GAGG;AACH,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAM3E;;GAEG;AACH,eAAO,MAAM,uBAAuB;;CAE1B,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEnG;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;CAI5B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,OAAO,yBAAyB,CAAC,CAAC"}