@lumenflow/mcp 3.2.0 → 3.2.2

package/dist/tools.js

@@ -0,0 +1,253 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+// Re-export domain tools -- context/read operations
+export { contextGetTool, wuListTool } from './tools/context-tools.js';
+// Re-export domain tools -- WU lifecycle
+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';
+// Re-export runtime tracer-bullet tools
+export { taskBlockTool, taskClaimTool, taskCompleteTool, taskCreateTool, taskInspectTool, taskToolExecuteTool, taskUnblockTool, } from './tools/runtime-task-tools.js';
+// Re-export domain tools -- initiative
+export { initiativeListTool, initiativeStatusTool, initiativeCreateTool, initiativeEditTool, initiativeAddWuTool, initiativeRemoveWuTool, initiatiBulkAssignTool, initiativePlanTool, } from './tools/initiative-tools.js';
+// Re-export domain tools -- memory
+export { memInitTool, memStartTool, memReadyTool, memCheckpointTool, memCleanupTool, memContextTool, memCreateTool, memDeleteTool, memExportTool, memInboxTool, memSignalTool, memSummarizeTool, memTriageTool, memRecoverTool, } from './tools/memory-tools.js';
+// Re-export domain tools -- agent
+export { agentSessionTool, agentSessionEndTool, agentLogIssueTool, agentIssuesQueryTool, } from './tools/agent-tools.js';
+// Re-export domain tools -- orchestration + delegation
+export { orchestrateInitiativeTool, orchestrateInitStatusTool, orchestrateMonitorTool, delegationListTool, } from './tools/orchestration-tools.js';
+// Re-export domain tools -- flow/metrics
+export { flowBottlenecksTool, flowReportTool, metricsSnapshotTool, lumenflowMetricsTool, metricsTool, } from './tools/flow-tools.js';
+// Re-export domain tools -- validation
+export { validateTool, validateAgentSkillsTool, validateAgentSyncTool, validateBacklogSyncTool, validateSkillsSpecTool, lumenflowValidateTool, } from './tools/validation-tools.js';
+// Re-export domain tools -- setup
+export { lumenflowInitTool, lumenflowDoctorTool, lumenflowIntegrateTool, lumenflowUpgradeTool, lumenflowCommandsTool, lumenflowDocsSyncTool, lumenflowReleaseTool, lumenflowSyncTemplatesTool, } from './tools/setup-tools.js';
+// Re-export domain tools -- wave-1/wave-2 parity
+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 { contextGetTool, wuListTool } from './tools/context-tools.js';
+import { 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';
+import { taskBlockTool, taskClaimTool, taskCompleteTool, taskCreateTool, taskInspectTool, taskToolExecuteTool, taskUnblockTool, } from './tools/runtime-task-tools.js';
+import { RuntimeTaskToolNames } from './tools/runtime-task-constants.js';
+import { initiativeListTool, initiativeStatusTool, initiativeCreateTool, initiativeEditTool, initiativeAddWuTool, initiativeRemoveWuTool, initiatiBulkAssignTool, initiativePlanTool, } from './tools/initiative-tools.js';
+import { memInitTool, memStartTool, memReadyTool, memCheckpointTool, memCleanupTool, memContextTool, memCreateTool, memDeleteTool, memExportTool, memInboxTool, memSignalTool, memSummarizeTool, memTriageTool, memRecoverTool, } from './tools/memory-tools.js';
+import { agentSessionTool, agentSessionEndTool, agentLogIssueTool, agentIssuesQueryTool, } from './tools/agent-tools.js';
+import { orchestrateInitiativeTool, orchestrateInitStatusTool, orchestrateMonitorTool, delegationListTool, } from './tools/orchestration-tools.js';
+import { flowBottlenecksTool, flowReportTool, metricsSnapshotTool, lumenflowMetricsTool, metricsTool, } from './tools/flow-tools.js';
+import { validateTool, validateAgentSkillsTool, validateAgentSyncTool, validateBacklogSyncTool, validateSkillsSpecTool, lumenflowValidateTool, } from './tools/validation-tools.js';
+import { lumenflowInitTool, lumenflowDoctorTool, lumenflowIntegrateTool, lumenflowUpgradeTool, lumenflowCommandsTool, lumenflowDocsSyncTool, lumenflowReleaseTool, lumenflowSyncTemplatesTool, } from './tools/setup-tools.js';
+import { 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';
+/**
+ * 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 const MCP_PUBLIC_PARITY_ALLOWED_EXTRA_TOOLS = [
+    'context_get',
+    'gates_run',
+    'initiative_remove_wu',
+    RuntimeTaskToolNames.TASK_BLOCK,
+    RuntimeTaskToolNames.TASK_COMPLETE,
+    RuntimeTaskToolNames.TASK_CREATE,
+    RuntimeTaskToolNames.TASK_INSPECT,
+    RuntimeTaskToolNames.TASK_UNBLOCK,
+    RuntimeTaskToolNames.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 const MCP_PUBLIC_PARITY_ALLOWED_MISSING_TOOLS = [
+    'lane_edit',
+    'lane_lock',
+    'lane_setup',
+    'lane_status',
+    'lane_validate',
+    'pack_scaffold',
+];
+/**
+ * Normalize public CLI command names to MCP tool naming.
+ *
+ * Example:
+ * - "wu:create" -> "wu_create"
+ * - "plan:promote" -> "plan_promote"
+ */
+export function normalizePublicManifestCommandName(commandName) {
+    return commandName.replace(/[:-]/g, '_');
+}
+/**
+ * Compare public CLI manifest command names against MCP tool names.
+ */
+export function buildMcpManifestParityReport(manifestCommandNames, mcpToolNames) {
+    const normalizedManifest = new Set(manifestCommandNames.map((commandName) => normalizePublicManifestCommandName(commandName)));
+    const mcpToolSet = new Set(mcpToolNames);
+    const allowedExtraSet = new Set(MCP_PUBLIC_PARITY_ALLOWED_EXTRA_TOOLS);
+    const allowedMissingSet = new Set(MCP_PUBLIC_PARITY_ALLOWED_MISSING_TOOLS);
+    const missing = [...normalizedManifest]
+        .filter((name) => !mcpToolSet.has(name) && !allowedMissingSet.has(name))
+        .sort();
+    const allowedExtra = [...mcpToolSet]
+        .filter((name) => !normalizedManifest.has(name) && allowedExtraSet.has(name))
+        .sort();
+    const unexpectedExtra = [...mcpToolSet]
+        .filter((name) => !normalizedManifest.has(name) && !allowedExtraSet.has(name))
+        .sort();
+    return { missing, allowedExtra, unexpectedExtra };
+}
+/**
+ * All available tools
+ */
+export const allTools = [
+    contextGetTool,
+    wuListTool,
+    wuStatusTool,
+    wuCreateTool,
+    wuClaimTool,
+    wuSandboxTool,
+    wuDoneTool,
+    gatesRunTool,
+    // WU-1482: Wave-1 public parity tools
+    backlogPruneTool,
+    docsSyncTool,
+    gatesTool,
+    gatesDocsTool,
+    laneHealthTool,
+    laneSuggestTool,
+    lumenflowTool,
+    lumenflowGatesTool,
+    lumenflowValidateTool,
+    lumenflowMetricsTool,
+    metricsTool,
+    stateBootstrapTool,
+    stateCleanupTool,
+    stateDoctorTool,
+    syncTemplatesTool,
+    // WU-1483: Wave-2 public parity tools
+    fileReadTool,
+    fileWriteTool,
+    fileEditTool,
+    fileDeleteTool,
+    gitStatusTool,
+    gitDiffTool,
+    gitLogTool,
+    gitBranchTool,
+    initPlanTool,
+    planCreateTool,
+    planEditTool,
+    planLinkTool,
+    planPromoteTool,
+    signalCleanupTool,
+    // WU-1902: Config tools
+    configSetTool,
+    configGetTool,
+    // WU-1983: Bootstrap/cloud parity tools
+    cloudConnectTool,
+    onboardTool,
+    lumenflowOnboardTool,
+    workspaceInitTool,
+    wuProtoTool,
+    // WU-1422: Additional WU tools
+    wuBlockTool,
+    wuUnblockTool,
+    wuEditTool,
+    wuReleaseTool,
+    wuRecoverTool,
+    wuRepairTool,
+    wuDepsTool,
+    wuPrepTool,
+    wuPreflightTool,
+    wuPruneTool,
+    wuDeleteTool,
+    wuCleanupTool,
+    wuBriefTool,
+    wuDelegateTool,
+    wuValidateTool,
+    wuInferLaneTool,
+    wuUnlockLaneTool,
+    // WU-1424: Initiative tools
+    initiativeListTool,
+    initiativeStatusTool,
+    initiativeCreateTool,
+    initiativeEditTool,
+    initiativeAddWuTool,
+    initiativeRemoveWuTool,
+    initiatiBulkAssignTool,
+    initiativePlanTool,
+    // WU-1424: Memory tools
+    memInitTool,
+    memStartTool,
+    memReadyTool,
+    memCheckpointTool,
+    memCleanupTool,
+    memContextTool,
+    memCreateTool,
+    memDeleteTool,
+    memExportTool,
+    memInboxTool,
+    memSignalTool,
+    memSummarizeTool,
+    memTriageTool,
+    memRecoverTool,
+    // WU-1425: Agent tools
+    agentSessionTool,
+    agentSessionEndTool,
+    agentLogIssueTool,
+    agentIssuesQueryTool,
+    // WU-1425: Orchestration tools
+    orchestrateInitiativeTool,
+    orchestrateInitStatusTool,
+    orchestrateMonitorTool,
+    // WU-1425: Delegation tools
+    delegationListTool,
+    // WU-1426: Flow/Metrics tools
+    flowBottlenecksTool,
+    flowReportTool,
+    metricsSnapshotTool,
+    // WU-1426: Validation tools
+    validateTool,
+    validateAgentSkillsTool,
+    validateAgentSyncTool,
+    validateBacklogSyncTool,
+    validateSkillsSpecTool,
+    // WU-1426: Setup tools
+    lumenflowInitTool,
+    lumenflowDoctorTool,
+    lumenflowIntegrateTool,
+    lumenflowUpgradeTool,
+    lumenflowCommandsTool,
+    lumenflowDocsSyncTool,
+    lumenflowReleaseTool,
+    lumenflowSyncTemplatesTool,
+];
+/**
+ * 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 const runtimeTaskTools = [
+    taskClaimTool,
+    taskCreateTool,
+    taskCompleteTool,
+    taskBlockTool,
+    taskUnblockTool,
+    taskInspectTool,
+    taskToolExecuteTool,
+];
+/**
+ * Production MCP registry consumed by server startup.
+ */
+export const registeredTools = [...allTools, ...runtimeTaskTools];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/worktree-enforcement.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Error code returned when a write is blocked by worktree enforcement.
+ */
+export declare const WORKTREE_ENFORCEMENT_ERROR_CODE = "WORKTREE_ENFORCEMENT_BLOCKED";
+/**
+ * Result of a worktree enforcement check.
+ */
+export interface WorktreeEnforcementResult {
+    /** Whether the write operation is allowed */
+    allowed: boolean;
+    /** Error code when blocked */
+    errorCode?: string;
+    /** Human-readable reason when blocked */
+    reason?: string;
+}
+export interface WorktreeEnforcementInput {
+    /** Path to the file being written (relative or absolute) */
+    filePath: string;
+    /** Project root override (defaults to auto-detection) */
+    projectRoot?: string;
+}
+/**
+ * Check whether a file write/edit should be allowed based on worktree enforcement policy.
+ *
+ * Mirrors the logic in enforce-worktree.sh but runs in-process for MCP tools.
+ *
+ * Graceful degradation: if any check fails (config unreadable, git unavailable,
+ * .lumenflow not configured), the operation is allowed to prevent blocking
+ * legitimate work.
+ */
+export declare function checkWorktreeEnforcement(input: WorktreeEnforcementInput): WorktreeEnforcementResult;
+//# sourceMappingURL=worktree-enforcement.d.ts.map

package/dist/worktree-enforcement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-enforcement.d.ts","sourceRoot":"","sources":["../src/worktree-enforcement.ts"],"names":[],"mappings":"AAwBA;;GAEG;AACH,eAAO,MAAM,+BAA+B,iCAAiC,CAAC;AAkB9E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,wBAAwB,GAC9B,yBAAyB,CA8D3B"}

package/dist/worktree-enforcement.js

@@ -0,0 +1,154 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file worktree-enforcement.ts
+ * @description Worktree enforcement guard for MCP file_write and file_edit tools.
+ *
+ * WU-1853: MCP tool calls do not trigger Claude Code PreToolUse hooks, so
+ * file_write and file_edit can bypass the enforce-worktree.sh hook that blocks
+ * direct writes to the main checkout. This module mirrors the shell hook logic
+ * in TypeScript so the MCP server can enforce the same policy.
+ *
+ * Enforcement check mirrors enforce-worktree.sh:
+ *   - Allow writes inside worktrees/
+ *   - Allow writes to .lumenflow/, .claude/, docs/tasks/wu/, plan/
+ *   - Block everything else when on main/master and enforcement is active
+ *   - Gracefully allow if config cannot be read
+ */
+import path from 'node:path';
+import { existsSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { getConfig, findProjectRoot } from '@lumenflow/core';
+/**
+ * Error code returned when a write is blocked by worktree enforcement.
+ */
+export const WORKTREE_ENFORCEMENT_ERROR_CODE = 'WORKTREE_ENFORCEMENT_BLOCKED';
+/**
+ * Branches that are considered "main" and subject to enforcement.
+ */
+const PROTECTED_BRANCHES = ['main', 'master'];
+/**
+ * Relative path prefixes that are always allowed on main checkout.
+ * Mirrors the allowlist in enforce-worktree.sh.
+ */
+const ALLOWLISTED_PATH_PREFIXES = [
+    'docs/04-operations/tasks/wu/',
+    '.lumenflow/',
+    '.claude/',
+    'plan/',
+];
+/**
+ * Check whether a file write/edit should be allowed based on worktree enforcement policy.
+ *
+ * Mirrors the logic in enforce-worktree.sh but runs in-process for MCP tools.
+ *
+ * Graceful degradation: if any check fails (config unreadable, git unavailable,
+ * .lumenflow not configured), the operation is allowed to prevent blocking
+ * legitimate work.
+ */
+export function checkWorktreeEnforcement(input) {
+    const { filePath } = input;
+    try {
+        const projectRoot = input.projectRoot ?? findProjectRoot();
+        // Graceful degradation: LumenFlow not configured
+        const lumenflowDir = path.join(projectRoot, '.lumenflow');
+        if (!existsSync(lumenflowDir)) {
+            return { allowed: true };
+        }
+        // Read enforcement config
+        const config = getConfig({ projectRoot });
+        const enforcement = config?.agents?.clients?.['claude-code']?.enforcement;
+        if (!enforcement?.block_outside_worktree) {
+            return { allowed: true };
+        }
+        // Detect current branch
+        const currentBranch = detectCurrentBranch(projectRoot);
+        if (!currentBranch) {
+            // Branch detection failed -- graceful degradation
+            return { allowed: true };
+        }
+        // Allow operations on non-main branches
+        if (!isProtectedBranch(currentBranch)) {
+            return { allowed: true };
+        }
+        // Resolve the file path to a relative path within the project
+        const resolvedPath = resolveFilePath(filePath, projectRoot);
+        // Allow if path is outside the project entirely
+        if (resolvedPath === null) {
+            return { allowed: true };
+        }
+        // Allow if path is inside a worktree
+        if (resolvedPath.startsWith('worktrees/')) {
+            return { allowed: true };
+        }
+        // Allow if path matches the allowlist
+        if (isAllowlistedPath(resolvedPath)) {
+            return { allowed: true };
+        }
+        // Block the write
+        return {
+            allowed: false,
+            errorCode: WORKTREE_ENFORCEMENT_ERROR_CODE,
+            reason: `Write to '${filePath}' blocked: you are on the '${currentBranch}' branch. ` +
+                'Direct writes to main checkout are not allowed when worktree enforcement is active. ' +
+                'Use pnpm wu:claim to create a worktree and work there instead.',
+        };
+    }
+    catch {
+        // Graceful degradation: any unexpected error allows the operation
+        return { allowed: true };
+    }
+}
+/**
+ * Detect the current git branch for the given project root.
+ * Returns null if detection fails.
+ */
+function detectCurrentBranch(projectRoot) {
+    try {
+        // eslint-disable-next-line sonarjs/no-os-command-from-path -- git resolved from PATH; workflow tooling requires git
+        const result = execFileSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
+            cwd: projectRoot,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return result.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a branch name is a protected branch (main/master).
+ */
+function isProtectedBranch(branchName) {
+    return PROTECTED_BRANCHES.includes(branchName);
+}
+/**
+ * Resolve a file path to a relative path within the project.
+ * Returns null if the path is outside the project root.
+ */
+function resolveFilePath(filePath, projectRoot) {
+    let resolved;
+    if (path.isAbsolute(filePath)) {
+        resolved = filePath;
+    }
+    else {
+        // Relative path is relative to project root
+        resolved = path.resolve(projectRoot, filePath);
+    }
+    // Normalize both paths for comparison
+    const normalizedProject = projectRoot.endsWith('/') ? projectRoot : `${projectRoot}/`;
+    // Check if the resolved path is inside the project
+    if (!resolved.startsWith(normalizedProject) && resolved !== projectRoot) {
+        return null;
+    }
+    // Return the relative path
+    return path.relative(projectRoot, resolved);
+}
+/**
+ * Check if a relative path matches the allowlist.
+ */
+function isAllowlistedPath(relativePath) {
+    return ALLOWLISTED_PATH_PREFIXES.some((prefix) => relativePath.startsWith(prefix));
+}
+//# sourceMappingURL=worktree-enforcement.js.map

package/dist/worktree-enforcement.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/mcp",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "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.2.0",
-    "@lumenflow/metrics": "3.2.0",
-    "@lumenflow/core": "3.2.0",
-    "@lumenflow/memory": "3.2.0"
+    "@lumenflow/core": "3.2.2",
+    "@lumenflow/memory": "3.2.2",
+    "@lumenflow/kernel": "3.2.2",
+    "@lumenflow/metrics": "3.2.2"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",