@xelth/eck-snapshot 6.0.8 → 6.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xelth/eck-snapshot",
-  "version": "6.0.8",
+  "version": "6.0.9",
   "description": "A powerful CLI tool to create and restore single-file text snapshots of Git repositories. Optimized for AI context, LLM workflows, and multi-agent Swarm coordination.",
   "keywords": [
     "ai",

package/src/cli/commands/createSnapshot.js

@@ -25,6 +25,7 @@ import { saveGitAnchor } from '../../utils/gitUtils.js';
 import { skeletonize } from '../../core/skeletonizer.js';
 import { updateClaudeMd } from '../../utils/claudeMdGenerator.js';
 import { generateOpenCodeAgents } from '../../utils/opencodeAgentsGenerator.js';
+import { ensureProjectMcpConfig } from './setupMcp.js';
 
 /**
  * Creates dynamic project context based on detection results
@@ -824,6 +825,15 @@ export async function createRepoSnapshot(repoPath, options) {
       // Claude Code exclusively uses CLAUDE.md
       if (isJas || isJao || (!isJaz && !options.withJa)) {
         await updateClaudeMd(processedRepoPath, claudeMode, directoryTree, confidentialFiles, { zh: options.zh });
+        // Ensure .mcp.json with eck-core is present so Claude Code agents have MCP tools
+        try {
+          const mcpCreated = await ensureProjectMcpConfig(processedRepoPath);
+          if (mcpCreated) {
+            console.log(chalk.green('🔌 Created .mcp.json with eck-core MCP server'));
+          }
+        } catch (e) {
+          // Non-critical — agent can still use manual fallback
+        }
       }
 
       // OpenCode exclusively uses AGENTS.md

package/src/cli/commands/setupMcp.js

@@ -262,3 +262,60 @@ async function setupForOpenCode(packageRoot, eckCorePath, glmZaiPath, options) {
   console.log(chalk.gray('\n  OpenCode will read MCP servers from opencode.json on next start.'));
   console.log(chalk.gray('  Use `eck-snapshot --jas` or `--jao` to generate AGENTS.md for OpenCode.\n'));
 }
+
+/**
+ * Silently ensure .mcp.json exists in the target project root with eck-core configured.
+ * Called automatically during snapshot creation so any Claude Code session
+ * in that project will have eck_finish_task / eck_fail_task available.
+ *
+ * @param {string} repoPath - Target project root
+ * @returns {boolean} true if file was created/updated, false if already OK
+ */
+export async function ensureProjectMcpConfig(repoPath) {
+  const packageRoot = path.resolve(__dirname, '../../..');
+  const eckCorePath = path.join(packageRoot, 'scripts', 'mcp-eck-core.js');
+  const mcpJsonPath = path.join(repoPath, '.mcp.json');
+
+  // Read existing .mcp.json if present
+  let config = {};
+  try {
+    const content = await fs.readFile(mcpJsonPath, 'utf-8');
+    config = JSON.parse(content);
+  } catch { /* doesn't exist yet */ }
+
+  // Ensure root mcpServers key exists (required by Claude Code schema)
+  if (!config.mcpServers) {
+    config.mcpServers = {};
+  }
+
+  // Check if eck-core is already configured with correct path
+  if (config.mcpServers['eck-core'] &&
+      config.mcpServers['eck-core'].command === 'node' &&
+      config.mcpServers['eck-core'].args?.[0] === eckCorePath) {
+    return false; // Already up to date
+  }
+
+  // Add/update eck-core inside mcpServers
+  config.mcpServers['eck-core'] = {
+    command: 'node',
+    args: [eckCorePath]
+  };
+
+  await fs.writeFile(mcpJsonPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+
+  // Ensure .mcp.json is in .gitignore (it contains absolute paths)
+  try {
+    const gitignorePath = path.join(repoPath, '.gitignore');
+    let gitignore = '';
+    try {
+      gitignore = await fs.readFile(gitignorePath, 'utf-8');
+    } catch { /* no .gitignore */ }
+
+    if (!gitignore.includes('.mcp.json')) {
+      const suffix = gitignore.endsWith('\n') || gitignore === '' ? '' : '\n';
+      await fs.writeFile(gitignorePath, gitignore + suffix + '.mcp.json\n', 'utf-8');
+    }
+  } catch { /* non-critical */ }
+
+  return true;
+}

package/src/utils/claudeMdGenerator.js

@@ -51,9 +51,14 @@ Your task is NOT complete until code works globally.
    - **DO NOT** try to manually write to \`.eck/lastsnapshot/AnswerToSA.md\` with the \`Write\` tool.
    - **WARNING:** USE ONLY ONCE PER TASK. Do not use this tool or \`eck-snapshot update\` for intermediate testing.
 
-**FALLBACK METHOD (Only if MCP tool is missing):**
-If \`eck_finish_task\` is NOT in your available tools, you MUST do the following:
-0. **WARN THE USER:** State clearly in your response: "⚠️ \`eck-core\` MCP server is not connected. Proceeding with manual fallback."
+**IF \`eck_finish_task\` IS NOT VISIBLE in your tool list:**
+The tool may be registered as a **deferred tool**. Before falling back, you MUST try:
+1. **Search:** Call \`ToolSearch\` with query \`"select:mcp__eck-core__eck_finish_task,mcp__eck-core__eck_fail_task"\` to load deferred MCP tools.
+2. If ToolSearch returns the tools — use them normally.
+3. If ToolSearch confirms they don't exist — run \`eck-snapshot setup-mcp\` in the terminal, then retry ToolSearch.
+
+**MANUAL FALLBACK (Only if ToolSearch AND setup-mcp both fail):**
+0. **WARN THE USER:** State clearly: "⚠️ \`eck-core\` MCP server is not connected. Proceeding with manual fallback."
 1. **READ:** Read \`.eck/lastsnapshot/AnswerToSA.md\` using your \`Read\` tool (REQUIRED before overwriting).
 2. **WRITE:** Overwrite that file with your report.
 3. **COMMIT (CRITICAL):** Run \`git add .\` and \`git commit -m "chore: task report"\` in the terminal.
@@ -87,9 +92,14 @@ Pass your detailed markdown report into the \`status\` argument.
 - **DO NOT** manually write to \`AnswerToSA.md\` with your file editing tools.
 - **WARNING: USE ONLY ONCE.** Do not use for intermediate testing.
 
-**FALLBACK METHOD (Only if MCP tool is missing):**
-If \`eck_finish_task\` is NOT in your available tools, you MUST do the following:
-0. **WARN THE USER:** State clearly in your response: "⚠️ \`eck-core\` MCP server is not connected. Proceeding with manual fallback."
+**IF \`eck_finish_task\` IS NOT VISIBLE in your tool list:**
+The tool may be registered as a **deferred tool**. Before falling back, you MUST try:
+1. **Search:** Call \`ToolSearch\` with query \`"select:mcp__eck-core__eck_finish_task,mcp__eck-core__eck_fail_task"\` to load deferred MCP tools.
+2. If ToolSearch returns the tools — use them normally.
+3. If ToolSearch confirms they don't exist — run \`eck-snapshot setup-mcp\` in the terminal, then retry ToolSearch.
+
+**MANUAL FALLBACK (Only if ToolSearch AND setup-mcp both fail):**
+0. **WARN THE USER:** State clearly: "⚠️ \`eck-core\` MCP server is not connected. Proceeding with manual fallback."
 1. **READ:** Read \`.eck/lastsnapshot/AnswerToSA.md\` using your \`Read\` tool (REQUIRED before overwriting).
 2. **WRITE:** Overwrite that file with your report.
 3. **COMMIT (CRITICAL):** Run \`git add .\` and \`git commit -m "chore: task report"\` in the terminal.