@lumenflow/mcp 3.1.3 → 3.2.1

package/dist/tools-shared.js

@@ -0,0 +1,410 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file tools-shared.ts
+ * @description Shared types, constants, error codes, and helpers used across MCP tool domain modules.
+ *
+ * WU-1642: Extracted from tools.ts during modular decomposition.
+ */
+import { ExecutionContextSchema, TOOL_ERROR_CODES, } from '@lumenflow/kernel';
+import { z } from 'zod';
+import { runCliCommand } from './cli-runner.js';
+import { getRuntimeForWorkspace, resetMcpRuntimeCache, } from './runtime-cache.js';
+import { packToolCapabilityResolver } from './runtime-tool-resolver.js';
+import { McpEnvironmentVariables, MigrationCompatModes, MigrationFallbackErrorCodes, MigrationFallbackOutcomes, MigrationFallbackReasons, } from './mcp-constants.js';
+// Import core functions for context operations only (async to avoid circular deps)
+let coreModule = null;
+export async function getCore() {
+    if (!coreModule) {
+        coreModule = await import('@lumenflow/core');
+    }
+    return coreModule;
+}
+/**
+ * WU-1859: Narrowed from wildcard write (`**` / `write`) to read-only.
+ * Maintenance-mode operations should only need read access by default;
+ * write scopes are declared explicitly per-tool via `contextInput.allowedScopes`.
+ */
+export const DEFAULT_MAINTENANCE_SCOPE = {
+    type: 'path',
+    pattern: '**',
+    access: 'read',
+};
+const MAINTENANCE_TASK_PREFIX = 'maintenance';
+const MAINTENANCE_SESSION_PREFIX = 'session-maintenance';
+const MAINTENANCE_CONTEXT_MODE = 'maintenance';
+const TASK_CONTEXT_MODE = 'task';
+const DEFAULT_FALLBACK_ERROR_CODE = 'TOOL_EXECUTE_ERROR';
+/**
+ * WU-1866: Allowlist of error codes that MAY trigger CLI fallback.
+ *
+ * Default-deny: any error code NOT in this set is returned directly to the
+ * caller without retrying via CLI. This prevents new kernel denial codes
+ * (e.g., future AUTH_DENIED) from silently falling through to CLI fallback.
+ *
+ * Only TOOL_NOT_FOUND is allowed to fall back, for migration/backward compat
+ * when a tool exists in CLI but hasn't been registered in the kernel yet.
+ */
+export const FALLBACK_ALLOWED_ERROR_CODES = new Set([
+    TOOL_ERROR_CODES.TOOL_NOT_FOUND,
+]);
+/**
+ * Error codes used by tool implementations
+ */
+export const ErrorCodes = {
+    MISSING_PARAMETER: 'MISSING_PARAMETER',
+    CONTEXT_ERROR: 'CONTEXT_ERROR',
+    WU_LIST_ERROR: 'WU_LIST_ERROR',
+    WU_STATUS_ERROR: 'WU_STATUS_ERROR',
+    WU_CREATE_ERROR: 'WU_CREATE_ERROR',
+    WU_CLAIM_ERROR: 'WU_CLAIM_ERROR',
+    WU_DONE_ERROR: 'WU_DONE_ERROR',
+    WRONG_LOCATION: 'WRONG_LOCATION',
+    GATES_ERROR: 'GATES_ERROR',
+    WU_BLOCK_ERROR: 'WU_BLOCK_ERROR',
+    WU_UNBLOCK_ERROR: 'WU_UNBLOCK_ERROR',
+    WU_EDIT_ERROR: 'WU_EDIT_ERROR',
+    WU_RELEASE_ERROR: 'WU_RELEASE_ERROR',
+    WU_RECOVER_ERROR: 'WU_RECOVER_ERROR',
+    WU_REPAIR_ERROR: 'WU_REPAIR_ERROR',
+    WU_DEPS_ERROR: 'WU_DEPS_ERROR',
+    WU_PREP_ERROR: 'WU_PREP_ERROR',
+    WU_PREFLIGHT_ERROR: 'WU_PREFLIGHT_ERROR',
+    WU_PRUNE_ERROR: 'WU_PRUNE_ERROR',
+    WU_DELETE_ERROR: 'WU_DELETE_ERROR',
+    WU_CLEANUP_ERROR: 'WU_CLEANUP_ERROR',
+    WU_BRIEF_ERROR: 'WU_BRIEF_ERROR',
+    WU_DELEGATE_ERROR: 'WU_DELEGATE_ERROR',
+    WU_VALIDATE_ERROR: 'WU_VALIDATE_ERROR',
+    WU_INFER_LANE_ERROR: 'WU_INFER_LANE_ERROR',
+    WU_UNLOCK_LANE_ERROR: 'WU_UNLOCK_LANE_ERROR',
+    TASK_CLAIM_ERROR: 'TASK_CLAIM_ERROR',
+    TASK_CREATE_ERROR: 'TASK_CREATE_ERROR',
+    TASK_COMPLETE_ERROR: 'TASK_COMPLETE_ERROR',
+    TASK_BLOCK_ERROR: 'TASK_BLOCK_ERROR',
+    TASK_UNBLOCK_ERROR: 'TASK_UNBLOCK_ERROR',
+    TASK_INSPECT_ERROR: 'TASK_INSPECT_ERROR',
+    TOOL_EXECUTE_ERROR: 'TOOL_EXECUTE_ERROR',
+    BACKLOG_PRUNE_ERROR: 'BACKLOG_PRUNE_ERROR',
+    DOCS_SYNC_ERROR: 'DOCS_SYNC_ERROR',
+    GATES_ALIAS_ERROR: 'GATES_ALIAS_ERROR',
+    LANE_HEALTH_ERROR: 'LANE_HEALTH_ERROR',
+    LANE_SUGGEST_ERROR: 'LANE_SUGGEST_ERROR',
+    LUMENFLOW_ALIAS_ERROR: 'LUMENFLOW_ALIAS_ERROR',
+    LUMENFLOW_GATES_ERROR: 'LUMENFLOW_GATES_ERROR',
+    LUMENFLOW_VALIDATE_ERROR: 'LUMENFLOW_VALIDATE_ERROR',
+    LUMENFLOW_METRICS_ERROR: 'LUMENFLOW_METRICS_ERROR',
+    METRICS_ERROR: 'METRICS_ERROR',
+    STATE_BOOTSTRAP_ERROR: 'STATE_BOOTSTRAP_ERROR',
+    STATE_CLEANUP_ERROR: 'STATE_CLEANUP_ERROR',
+    STATE_DOCTOR_ERROR: 'STATE_DOCTOR_ERROR',
+    SYNC_TEMPLATES_ALIAS_ERROR: 'SYNC_TEMPLATES_ALIAS_ERROR',
+    FILE_READ_ERROR: 'FILE_READ_ERROR',
+    FILE_WRITE_ERROR: 'FILE_WRITE_ERROR',
+    FILE_EDIT_ERROR: 'FILE_EDIT_ERROR',
+    FILE_DELETE_ERROR: 'FILE_DELETE_ERROR',
+    // WU-1853: Worktree enforcement for MCP file tools
+    WORKTREE_ENFORCEMENT_BLOCKED: 'WORKTREE_ENFORCEMENT_BLOCKED',
+    GIT_STATUS_ERROR: 'GIT_STATUS_ERROR',
+    GIT_DIFF_ERROR: 'GIT_DIFF_ERROR',
+    GIT_LOG_ERROR: 'GIT_LOG_ERROR',
+    GIT_BRANCH_ERROR: 'GIT_BRANCH_ERROR',
+    INIT_PLAN_ERROR: 'INIT_PLAN_ERROR',
+    PLAN_CREATE_ERROR: 'PLAN_CREATE_ERROR',
+    PLAN_EDIT_ERROR: 'PLAN_EDIT_ERROR',
+    PLAN_LINK_ERROR: 'PLAN_LINK_ERROR',
+    PLAN_PROMOTE_ERROR: 'PLAN_PROMOTE_ERROR',
+    SIGNAL_CLEANUP_ERROR: 'SIGNAL_CLEANUP_ERROR',
+    CONFIG_SET_ERROR: 'CONFIG_SET_ERROR',
+    CONFIG_GET_ERROR: 'CONFIG_GET_ERROR',
+    CLOUD_CONNECT_ERROR: 'CLOUD_CONNECT_ERROR',
+    ONBOARD_ERROR: 'ONBOARD_ERROR',
+    LUMENFLOW_ONBOARD_ERROR: 'LUMENFLOW_ONBOARD_ERROR',
+    WORKSPACE_INIT_ERROR: 'WORKSPACE_INIT_ERROR',
+    WU_PROTO_ERROR: 'WU_PROTO_ERROR',
+    // WU-1426: Flow/Metrics error codes
+    FLOW_BOTTLENECKS_ERROR: 'FLOW_BOTTLENECKS_ERROR',
+    FLOW_REPORT_ERROR: 'FLOW_REPORT_ERROR',
+    METRICS_SNAPSHOT_ERROR: 'METRICS_SNAPSHOT_ERROR',
+    // WU-1426: Validation error codes
+    VALIDATE_ERROR: 'VALIDATE_ERROR',
+    VALIDATE_AGENT_SKILLS_ERROR: 'VALIDATE_AGENT_SKILLS_ERROR',
+    VALIDATE_AGENT_SYNC_ERROR: 'VALIDATE_AGENT_SYNC_ERROR',
+    VALIDATE_BACKLOG_SYNC_ERROR: 'VALIDATE_BACKLOG_SYNC_ERROR',
+    VALIDATE_SKILLS_SPEC_ERROR: 'VALIDATE_SKILLS_SPEC_ERROR',
+    // WU-1426: Setup error codes
+    LUMENFLOW_INIT_ERROR: 'LUMENFLOW_INIT_ERROR',
+    LUMENFLOW_DOCTOR_ERROR: 'LUMENFLOW_DOCTOR_ERROR',
+    LUMENFLOW_INTEGRATE_ERROR: 'LUMENFLOW_INTEGRATE_ERROR',
+    LUMENFLOW_UPGRADE_ERROR: 'LUMENFLOW_UPGRADE_ERROR',
+    LUMENFLOW_COMMANDS_ERROR: 'LUMENFLOW_COMMANDS_ERROR',
+    LUMENFLOW_DOCS_SYNC_ERROR: 'LUMENFLOW_DOCS_SYNC_ERROR',
+    LUMENFLOW_RELEASE_ERROR: 'LUMENFLOW_RELEASE_ERROR',
+    LUMENFLOW_SYNC_TEMPLATES_ERROR: 'LUMENFLOW_SYNC_TEMPLATES_ERROR',
+};
+/**
+ * Error messages used by tool implementations
+ */
+export const ErrorMessages = {
+    ID_REQUIRED: 'id is required',
+    LANE_REQUIRED: 'lane is required',
+    TITLE_REQUIRED: 'title is required',
+    PATH_REQUIRED: 'path is required',
+    CONTENT_REQUIRED: 'content is required',
+    OLD_STRING_REQUIRED: 'old_string is required',
+    NEW_STRING_REQUIRED: 'new_string is required',
+    REASON_REQUIRED: 'reason is required',
+    CLIENT_REQUIRED: 'client is required',
+    PARENT_WU_REQUIRED: 'parent_wu is required',
+    SECTION_REQUIRED: 'section is required',
+    PLAN_REQUIRED: 'plan is required',
+    KEY_REQUIRED: 'key is required',
+    VALUE_REQUIRED: 'value is required',
+    ENDPOINT_REQUIRED: 'endpoint is required',
+    ORG_ID_REQUIRED: 'org_id is required',
+    PROJECT_ID_REQUIRED: 'project_id is required',
+};
+/**
+ * CLI argument constants for commonly used flags
+ */
+export const CliArgs = {
+    DESCRIPTION: '--description',
+    INITIATIVE: '--initiative',
+    PHASE: '--phase',
+    JSON: '--json',
+    DOCS_ONLY: '--docs-only',
+    CODE_PATHS: '--code-paths',
+    BASE_DIR: '--base-dir',
+    ENCODING: '--encoding',
+    // WU-1452: Commands using --format json (initiative:*, flow:*, metrics)
+    FORMAT_JSON: ['--format', 'json'],
+    DRY_RUN: '--dry-run',
+    THRESHOLD: '--threshold',
+    RECOVER: '--recover',
+    WU: '--wu',
+    // WU-1851: Governed flags (3+ tool threshold)
+    FORCE: '--force',
+    VERBOSE: '--verbose',
+    QUIET: '--quiet',
+    EXECUTE: '--execute',
+    ID: '--id',
+    LANE: '--lane',
+    REASON: '--reason',
+    PATH: '--path',
+    FORMAT: '--format',
+    SINCE: '--since',
+    STATUS: '--status',
+};
+/**
+ * Shared error messages to avoid duplication across different tool categories
+ */
+export const SharedErrorMessages = {
+    WU_REQUIRED: 'wu is required',
+    INITIATIVE_REQUIRED: 'initiative is required',
+};
+export const SuccessMessages = {
+    ALL_GATES_PASSED: 'All gates passed',
+};
+/**
+ * Create a successful tool result
+ */
+export function success(data) {
+    return { success: true, data };
+}
+/**
+ * Create an error tool result
+ */
+export function error(message, code) {
+    return { success: false, error: { message, code } };
+}
+export function buildGatesArgs(input, options = {}) {
+    const args = [];
+    if (options.forceDocsOnly || input.docs_only)
+        args.push(CliArgs.DOCS_ONLY);
+    if (input.full_lint)
+        args.push('--full-lint');
+    if (input.full_tests)
+        args.push('--full-tests');
+    if (input.full_coverage)
+        args.push('--full-coverage');
+    if (input.coverage_mode)
+        args.push('--coverage-mode', input.coverage_mode);
+    if (input.verbose)
+        args.push(CliArgs.VERBOSE);
+    return args;
+}
+export function buildMetricsArgs(input) {
+    const args = [];
+    if (input.subcommand)
+        args.push(input.subcommand);
+    if (input.days !== undefined)
+        args.push('--days', String(input.days));
+    if (input.format)
+        args.push('--format', input.format);
+    if (input.output)
+        args.push('--output', input.output);
+    if (input.dry_run)
+        args.push('--dry-run');
+    return args;
+}
+/**
+ * Build common argument list for wu:brief / wu:delegate prompt tools.
+ */
+export function buildWuPromptArgs(input) {
+    const args = ['--id', input.id];
+    if (input.client)
+        args.push('--client', input.client);
+    if (input.thinking)
+        args.push('--thinking');
+    if (input.budget)
+        args.push('--budget', String(input.budget));
+    if (input.parent_wu)
+        args.push('--parent-wu', input.parent_wu);
+    if (input.no_context)
+        args.push('--no-context');
+    return args;
+}
+function buildMaintenanceSuffix(timestamp) {
+    return timestamp.getTime().toString(36);
+}
+export function buildExecutionContext(input = {}) {
+    const now = input.now ?? (() => new Date());
+    const timestamp = now();
+    const maintenanceSuffix = buildMaintenanceSuffix(timestamp);
+    const taskId = input.taskId ?? `${MAINTENANCE_TASK_PREFIX}-${maintenanceSuffix}`;
+    const runId = input.runId ?? `run-${taskId}-${maintenanceSuffix}`;
+    const sessionId = input.sessionId ?? `${MAINTENANCE_SESSION_PREFIX}-${maintenanceSuffix}`;
+    const invocationMode = input.taskId ? TASK_CONTEXT_MODE : MAINTENANCE_CONTEXT_MODE;
+    return ExecutionContextSchema.parse({
+        run_id: runId,
+        task_id: taskId,
+        session_id: sessionId,
+        allowed_scopes: input.allowedScopes ?? [DEFAULT_MAINTENANCE_SCOPE],
+        metadata: {
+            invocation_mode: invocationMode,
+            ...(input.metadata ?? {}),
+        },
+    });
+}
+export function resetExecuteViaPackRuntimeCache() {
+    resetMcpRuntimeCache();
+}
+async function runtimeFactoryForPack(workspaceRoot) {
+    return getRuntimeForWorkspace(workspaceRoot, packToolCapabilityResolver);
+}
+function resolveMigrationCompatMode(mode) {
+    if (mode) {
+        return mode;
+    }
+    const envMode = process.env[McpEnvironmentVariables.MIGRATION_COMPAT_MODE]?.trim().toLowerCase();
+    return envMode === MigrationCompatModes.COMPAT
+        ? MigrationCompatModes.COMPAT
+        : MigrationCompatModes.STRICT;
+}
+function buildMigrationFallbackTelemetryEvent(options) {
+    return {
+        toolName: options.toolName,
+        reason: options.reason,
+        workspaceRoot: options.workspaceRoot,
+        command: options.command,
+        args: options.args,
+        mode: options.mode,
+        outcome: options.outcome,
+    };
+}
+export async function executeViaPack(toolName, toolInput, options) {
+    const projectRoot = options.projectRoot ?? process.cwd();
+    const runtimeFactory = options.runtimeFactory ?? runtimeFactoryForPack;
+    const cliRunner = options.cliRunner ?? runCliCommand;
+    const executionContext = options.context ?? buildExecutionContext(options.contextInput);
+    const compatMode = resolveMigrationCompatMode(options.migrationCompatMode);
+    let runtimeFailureMessage;
+    let fallbackReason;
+    // Separate runtime init from tool execution so that init failures
+    // (factory throws) still fall back to CLI, while executeTool failures
+    // are handled by the allowlist below.
+    let runtime;
+    try {
+        runtime = await runtimeFactory(projectRoot);
+    }
+    catch (cause) {
+        runtimeFailureMessage = cause.message;
+        fallbackReason = MigrationFallbackReasons.RUNTIME_INIT_FAILED;
+    }
+    if (runtime) {
+        try {
+            const runtimeResult = await runtime.executeTool(toolName, toolInput, executionContext);
+            if (runtimeResult.success) {
+                return success(runtimeResult);
+            }
+            // WU-1866: Allowlist pattern -- only error codes in
+            // FALLBACK_ALLOWED_ERROR_CODES may trigger CLI fallback.
+            // All other codes (including unknown/future codes) are returned
+            // directly. This is default-deny for fallback.
+            const errorCode = runtimeResult.error?.code;
+            if (!errorCode || !FALLBACK_ALLOWED_ERROR_CODES.has(errorCode)) {
+                return error(runtimeResult.error?.message ?? `${toolName} failed`, errorCode ?? DEFAULT_FALLBACK_ERROR_CODE);
+            }
+            runtimeFailureMessage = runtimeResult.error?.message;
+            fallbackReason = MigrationFallbackReasons.RUNTIME_TOOL_NOT_FOUND;
+        }
+        catch (cause) {
+            // WU-1866: Thrown exceptions from executeTool are returned directly.
+            // They represent unexpected runtime failures that should not be
+            // silently retried via CLI.
+            return error(cause.message, DEFAULT_FALLBACK_ERROR_CODE);
+        }
+    }
+    if (fallbackReason && compatMode === MigrationCompatModes.STRICT) {
+        options.onFallbackTelemetry?.(buildMigrationFallbackTelemetryEvent({
+            toolName,
+            reason: fallbackReason,
+            workspaceRoot: projectRoot,
+            command: options.fallback.command,
+            args: options.fallback.args ?? [],
+            mode: compatMode,
+            outcome: MigrationFallbackOutcomes.BLOCKED,
+        }));
+        const strictMessageDetail = runtimeFailureMessage ??
+            `runtime fallback reason: ${fallbackReason === MigrationFallbackReasons.RUNTIME_INIT_FAILED ? 'runtime initialization failed' : 'runtime reported tool not found'}`;
+        return error(`Migration fallback is disabled in strict mode for ${toolName}: ${strictMessageDetail}`, MigrationFallbackErrorCodes.DISABLED);
+    }
+    const fallbackResult = await cliRunner(options.fallback.command, options.fallback.args ?? [], {
+        projectRoot,
+        ...(options.fallbackCliOptions ?? {}),
+    });
+    const fallbackTelemetry = fallbackReason
+        ? buildMigrationFallbackTelemetryEvent({
+            toolName,
+            reason: fallbackReason,
+            workspaceRoot: projectRoot,
+            command: options.fallback.command,
+            args: options.fallback.args ?? [],
+            mode: compatMode,
+            outcome: fallbackResult.success
+                ? MigrationFallbackOutcomes.SUCCEEDED
+                : MigrationFallbackOutcomes.FAILED,
+        })
+        : undefined;
+    if (fallbackTelemetry) {
+        options.onFallbackTelemetry?.(fallbackTelemetry);
+    }
+    if (fallbackResult.success) {
+        return success({
+            message: fallbackResult.stdout || `${options.fallback.command} succeeded`,
+            ...(fallbackTelemetry ? { fallbackTelemetry } : {}),
+        });
+    }
+    const fallbackErrorCode = fallbackReason && compatMode === MigrationCompatModes.COMPAT
+        ? (options.fallback.migrationErrorCode ??
+            options.fallback.errorCode ??
+            MigrationFallbackErrorCodes.EXECUTION_FAILED)
+        : (options.fallback.errorCode ?? DEFAULT_FALLBACK_ERROR_CODE);
+    return error(fallbackResult.stderr ||
+        fallbackResult.error?.message ||
+        runtimeFailureMessage ||
+        `${options.fallback.command} failed`, fallbackErrorCode);
+}
+// Re-export cli-runner types used by domain modules
+export { runCliCommand };
+//# sourceMappingURL=tools-shared.js.map

package/dist/tools-shared.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @file tools.ts
+ * @description MCP tool barrel - re-exports all domain tool modules and assembles the allTools registry.
+ *
+ * WU-1642: Decomposed from monolithic tools.ts into domain-scoped modules:
+ *   - tools-shared.ts: Types, constants, helpers shared across domains
+ *   - tools/context-tools.ts: context_get, wu_list
+ *   - tools/wu-tools.ts: WU lifecycle (create, claim, done, block, edit, etc.)
+ *   - tools/initiative-tools.ts: Initiative operations
+ *   - tools/memory-tools.ts: Memory operations
+ *   - tools/agent-tools.ts: Agent session/issue operations
+ *   - tools/orchestration-tools.ts: Orchestration + spawn operations
+ *   - tools/flow-tools.ts: Flow/metrics operations
+ *   - tools/validation-tools.ts: Validation operations
+ *   - tools/setup-tools.ts: Setup/LumenFlow operations
+ *   - tools/parity-tools.ts: Wave-1 + Wave-2 public parity operations
+ *
+ * WU-1412: Tools available: context_get, wu_list, wu_status, wu_create, wu_claim, wu_done, gates_run
+ * WU-1422: Additional WU tools
+ * WU-1424: Initiative tools, Memory tools
+ * WU-1425: Agent tools, Orchestration tools, Spawn tools
+ * WU-1426: Flow/Metrics tools, Validation tools, Setup tools
+ * WU-1431: Uses shared Zod schemas from @lumenflow/core for CLI/MCP parity
+ * WU-1454: All 16 WU lifecycle commands now use shared schemas
+ * WU-1456: Memory commands use shared schemas where available
+ * WU-1457: All remaining commands use shared schemas
+ * WU-1482: Wave-1 public parity tools
+ * WU-1483: Wave-2 public parity tools
+ * WU-1952: CLI added pack:author; MCP parity follow-up remains tracked explicitly in INIT-032.
+ * WU-1980: CLI added cloud:connect; MCP parity implementation is intentionally
+ * tracked in WU-1983 (INIT-033 phase sequence).
+ */
+export type { ToolResult, ToolDefinition } from './tools-shared.js';
+export { contextGetTool, wuListTool } from './tools/context-tools.js';
+export { wuStatusTool, wuCreateTool, wuClaimTool, wuSandboxTool, wuDoneTool, gatesRunTool, wuBlockTool, wuUnblockTool, wuEditTool, wuReleaseTool, wuRecoverTool, wuRepairTool, wuDepsTool, wuPrepTool, wuPreflightTool, wuPruneTool, wuDeleteTool, wuCleanupTool, wuBriefTool, wuDelegateTool, wuValidateTool, wuInferLaneTool, wuUnlockLaneTool, } from './tools/wu-tools.js';
+export { taskBlockTool, taskClaimTool, taskCompleteTool, taskCreateTool, taskInspectTool, taskToolExecuteTool, taskUnblockTool, } from './tools/runtime-task-tools.js';
+export { initiativeListTool, initiativeStatusTool, initiativeCreateTool, initiativeEditTool, initiativeAddWuTool, initiativeRemoveWuTool, initiatiBulkAssignTool, initiativePlanTool, } from './tools/initiative-tools.js';
+export { memInitTool, memStartTool, memReadyTool, memCheckpointTool, memCleanupTool, memContextTool, memCreateTool, memDeleteTool, memExportTool, memInboxTool, memSignalTool, memSummarizeTool, memTriageTool, memRecoverTool, } from './tools/memory-tools.js';
+export { agentSessionTool, agentSessionEndTool, agentLogIssueTool, agentIssuesQueryTool, } from './tools/agent-tools.js';
+export { orchestrateInitiativeTool, orchestrateInitStatusTool, orchestrateMonitorTool, delegationListTool, } from './tools/orchestration-tools.js';
+export { flowBottlenecksTool, flowReportTool, metricsSnapshotTool, lumenflowMetricsTool, metricsTool, } from './tools/flow-tools.js';
+export { validateTool, validateAgentSkillsTool, validateAgentSyncTool, validateBacklogSyncTool, validateSkillsSpecTool, lumenflowValidateTool, } from './tools/validation-tools.js';
+export { lumenflowInitTool, lumenflowDoctorTool, lumenflowIntegrateTool, lumenflowUpgradeTool, lumenflowCommandsTool, lumenflowDocsSyncTool, lumenflowReleaseTool, lumenflowSyncTemplatesTool, } from './tools/setup-tools.js';
+export { backlogPruneTool, docsSyncTool, gatesTool, gatesDocsTool, laneHealthTool, laneSuggestTool, lumenflowTool, lumenflowGatesTool, stateBootstrapTool, stateCleanupTool, stateDoctorTool, syncTemplatesTool, fileReadTool, fileWriteTool, fileEditTool, fileDeleteTool, gitStatusTool, gitDiffTool, gitLogTool, gitBranchTool, initPlanTool, planCreateTool, planEditTool, planLinkTool, planPromoteTool, signalCleanupTool, configSetTool, configGetTool, cloudConnectTool, onboardTool, lumenflowOnboardTool, workspaceInitTool, wuProtoTool, } from './tools/parity-tools.js';
+import type { ToolDefinition } from './tools-shared.js';
+/**
+ * MCP parity exclusions for tools that are intentionally MCP-only or maintainer-only.
+ *
+ * These names are excluded from strict public CLI parity comparison because
+ * they have no public command in packages/@lumenflow/cli/src/public-manifest.ts.
+ */
+export declare const MCP_PUBLIC_PARITY_ALLOWED_EXTRA_TOOLS: readonly ["context_get", "gates_run", "initiative_remove_wu", "task_block", "task_complete", "task_create", "task_inspect", "task_unblock", "tool_execute", "validate_agent_skills", "validate_agent_sync", "validate_backlog_sync", "validate_skills_spec", "wu_list"];
+/**
+ * Public CLI commands intentionally out of MCP scope.
+ *
+ * These normalized command names are excluded from the "missing" parity
+ * calculation so MCP parity reflects the supported public MCP surface.
+ */
+export declare const MCP_PUBLIC_PARITY_ALLOWED_MISSING_TOOLS: readonly ["lane_edit", "lane_lock", "lane_setup", "lane_status", "lane_validate", "pack_scaffold"];
+export interface McpManifestParityReport {
+    missing: string[];
+    allowedExtra: string[];
+    unexpectedExtra: string[];
+}
+/**
+ * Normalize public CLI command names to MCP tool naming.
+ *
+ * Example:
+ * - "wu:create" -> "wu_create"
+ * - "plan:promote" -> "plan_promote"
+ */
+export declare function normalizePublicManifestCommandName(commandName: string): string;
+/**
+ * Compare public CLI manifest command names against MCP tool names.
+ */
+export declare function buildMcpManifestParityReport(manifestCommandNames: readonly string[], mcpToolNames: readonly string[]): McpManifestParityReport;
+/**
+ * All available tools
+ */
+export declare const allTools: ToolDefinition[];
+/**
+ * Runtime-backed additive MCP tools.
+ *
+ * These are intentionally isolated from legacy CLI-shell tools so we can
+ * migrate command-by-command without breaking parity gates.
+ *
+ * NOTE:
+ * `allTools` remains the legacy parity baseline for strict CLI parity checks
+ * that intentionally ignore runtime migration deltas.
+ *
+ * Phase-4 closure metrics use `registeredTools` (production registry) so
+ * runtime-migrated tools are measured against the real server surface.
+ */
+export declare const runtimeTaskTools: ToolDefinition[];
+/**
+ * Production MCP registry consumed by server startup.
+ */
+export declare const registeredTools: ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

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