@lumenflow/mcp 3.1.2 → 3.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/mcp",
-  "version": "3.1.2",
+  "version": "3.2.0",
   "description": "MCP stdio server for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -53,10 +53,10 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
     "zod": "^4.3.6",
-    "@lumenflow/kernel": "3.1.2",
-    "@lumenflow/memory": "3.1.2",
-    "@lumenflow/metrics": "3.1.2",
-    "@lumenflow/core": "3.1.2"
+    "@lumenflow/kernel": "3.2.0",
+    "@lumenflow/metrics": "3.2.0",
+    "@lumenflow/core": "3.2.0",
+    "@lumenflow/memory": "3.2.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",

package/dist/bin.d.ts

@@ -1,16 +0,0 @@
-#!/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

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

package/dist/bin.js.map

@@ -1 +0,0 @@
-{"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

@@ -1,58 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,164 +0,0 @@
-// 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

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

package/dist/index.d.ts

@@ -1,37 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1 +0,0 @@
-{"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

@@ -1,173 +0,0 @@
-/**
- * @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 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

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-constants.d.ts","sourceRoot":"","sources":["../src/mcp-constants.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAMH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Hd,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"}