@xelth/eck-snapshot 5.9.0 → 6.6.0

package/scripts/mcp-eck-core.js

@@ -23,9 +23,23 @@ const server = new Server(
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
     tools: [
+      {
+        name: "eck_fail_task",
+        description: "Use this if you are stuck, blocked, or unable to complete the task. It saves your report to AnswerToSA.md and generates an emergency snapshot WITHOUT committing broken code. Do NOT use this if tests pass.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            status: {
+              type: "string",
+              description: "Detailed explanation of why you are blocked, what you tried, and what the Architect should know."
+            }
+          },
+          required: ["status"]
+        }
+      },
       {
         name: "eck_finish_task",
-        description: "Completes the current coding task. 1) Overwrites AnswerToSA.md with status for the Architect. 2) Stages all changes. 3) Commits with the provided message. 4) Automatically updates the context snapshot. Use this instead of manual git commands.",
+        description: "Completes the current coding task. 1) Overwrites AnswerToSA.md with status for the Architect. 2) Stages all changes. 3) Commits with the provided message. 4) Automatically updates the context snapshot. WARNING: USE ONLY ONCE PER TASK WHEN 100% FINISHED. Do NOT use this for intermediate saves or testing during your debugging loop.",
         inputSchema: {
           type: "object",
           properties: {
@@ -40,12 +54,128 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           },
           required: ["status", "message"]
         }
+      },
+      {
+        name: "eck_manifest_edit",
+        description: "Atomically edits an .eck manifest file (like TECH_DEBT.md, ROADMAP.md) WITHOUT reading the entire file into context. Use this to save tokens.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            file: {
+              type: "string",
+              description: "Name of the file in .eck/ (e.g., 'TECH_DEBT.md')"
+            },
+            action: {
+              type: "string",
+              enum: ["append_to_section", "replace_text"],
+              description: "Action to perform: append bullet to a section, or replace specific text."
+            },
+            section_header: {
+              type: "string",
+              description: "For 'append_to_section': The exact markdown header to append under (e.g., '## Active', '# Sprint 1')."
+            },
+            content: {
+              type: "string",
+              description: "The text to append (e.g., '- [ ] Fix memory leak'), or the new text for replace_text."
+            },
+            target_text: {
+              type: "string",
+              description: "For 'replace_text': The exact old text you want to find and replace (e.g., '- [ ] Bug 123')."
+            }
+          },
+          required: ["file", "action", "content"]
+        }
       }
     ]
   };
 });
 
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  if (request.params.name === "eck_fail_task") {
+    const { status } = request.params.arguments;
+    const workDir = process.cwd();
+
+    try {
+      const answerDir = path.join(workDir, '.eck', 'lastsnapshot');
+      await fs.mkdir(answerDir, { recursive: true });
+      await fs.writeFile(
+        path.join(answerDir, 'AnswerToSA.md'),
+        `# Agent Report (BLOCKED/FAILED)\n\n${status}\n`,
+        'utf-8'
+      );
+
+      const cliPath = path.join(PROJECT_ROOT, "index.js");
+      const { stdout } = await execa("node", [cliPath, JSON.stringify({ name: "eck_update_auto", arguments: { fail: true } })], { cwd: workDir, timeout: 120000 });
+
+      let result;
+      try {
+        result = JSON.parse(stdout);
+      } catch (e) {
+        return { content: [{ type: "text", text: `⚠️ Task aborted, but snapshot update returned invalid JSON: ${stdout}` }] };
+      }
+
+      return {
+        content: [{
+          type: "text",
+          text: `🚨 Task marked as FAILED.\n📝 AnswerToSA.md updated\n📸 Emergency Snapshot: ${result.snapshot_file} (${result.files_count} files)`
+        }]
+      };
+    } catch (error) {
+      return { content: [{ type: "text", text: `❌ Error: ${error.message}\n${error.stderr || ''}` }], isError: true };
+    }
+  }
+
+  if (request.params.name === "eck_manifest_edit") {
+    const { file, action, section_header, content, target_text } = request.params.arguments;
+    const workDir = process.cwd();
+    const manifestPath = path.join(workDir, '.eck', file);
+
+    try {
+      let fileContent = '';
+      try {
+        fileContent = await fs.readFile(manifestPath, 'utf-8');
+      } catch (e) {
+        if (e.code === 'ENOENT') {
+          fileContent = `# ${file.replace('.md', '')}\n\n`;
+        } else {
+          throw e;
+        }
+      }
+
+      let updatedContent = fileContent;
+
+      if (action === 'replace_text') {
+        if (!target_text) throw new Error("target_text is required for replace_text action");
+        if (!fileContent.includes(target_text)) throw new Error(`Target text not found in ${file}`);
+        updatedContent = fileContent.replace(target_text, content);
+      } else if (action === 'append_to_section') {
+        if (!section_header) throw new Error("section_header is required for append_to_section action");
+        
+        const regex = new RegExp(`^(${section_header.replace(/[.*+?^$\\{}()|[\\]\\\\]/g, '\\$&')}\\s*\\r?\\n)`, 'm');
+        const match = regex.exec(fileContent);
+        
+        if (match) {
+          const insertPos = match.index + match[0].length;
+          updatedContent = fileContent.slice(0, insertPos) + content + '\n' + fileContent.slice(insertPos);
+        } else {
+          const suffix = fileContent.endsWith('\n') ? '' : '\n';
+          updatedContent = fileContent + suffix + '\n' + section_header + '\n' + content + '\n';
+        }
+      }
+
+      await fs.writeFile(manifestPath, updatedContent, 'utf-8');
+      return {
+        content: [{ type: "text", text: `✅ Successfully edited ${file}` }]
+      };
+
+    } catch (error) {
+      return {
+        content: [{ type: "text", text: `❌ Error editing manifest: ${error.message}` }],
+        isError: true
+      };
+    }
+  }
+
   if (request.params.name === "eck_finish_task") {
     const { status, message } = request.params.arguments;
     const workDir = process.cwd();
@@ -68,7 +198,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
       // 4. Auto Update Snapshot
       const cliPath = path.join(PROJECT_ROOT, "index.js");
-      const { stdout } = await execa("node", [cliPath, "update-auto"], { cwd: workDir, timeout: 120000 });
+      const { stdout } = await execa("node", [cliPath, JSON.stringify({ name: "eck_update_auto" })], { cwd: workDir, timeout: 120000 });
 
       let result;
       try {
@@ -106,14 +236,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   };
 });
 
-const transport = new StdioServerTransport();
-await server.connect(transport);
-
-// --- Graceful Shutdown Handler ---
-process.stdout.on('error', (err) => {
-  if (err.code === 'EPIPE') {
-    process.exit(0);
-  }
-});
-process.on('SIGINT', () => process.exit(0));
-process.on('SIGTERM', () => process.exit(0));
+const transport = new StdioServerTransport();
+await server.connect(transport);
+
+// --- Graceful Shutdown Handler ---
+process.stdout.on('error', (err) => {
+  if (err.code === 'EPIPE') {
+    process.exit(0);
+  }
+});
+process.on('SIGINT', () => process.exit(0));
+process.on('SIGTERM', () => process.exit(0));

package/setup.json

@@ -1,23 +1,12 @@
 {
   "_comment": "Central configuration file for eck-snapshot. ALL settings are configured here.",
   "projectContext": {
-    "name": "eckasse",
-    "type": "monorepo",
+    "name": "",
+    "type": "",
     "architecture": {
-      "workspaces": [
-        "@eckasse/core",
-        "@eckasse/desktop",
-        "@eckasse/adapters",
-        "@eckasse/shared-frontend"
-      ],
-      "stack": [
-        "Node.js",
-        "Express",
-        "Electron",
-        "PostgreSQL",
-        "WebSocket"
-      ],
-      "aiIntegration": "Google Gemini for POS natural language control"
+      "workspaces": [],
+      "stack": [],
+      "aiIntegration": ""
     }
   },
   "projectDetection": {
@@ -188,6 +177,19 @@
           "lib"
         ],
         "priority": 6
+      },
+      "postgresql": {
+        "files": [
+          "postgresql.conf",
+          "pg_hba.conf",
+          "PG_VERSION"
+        ],
+        "directories": [
+          "data/base",
+          "data/global",
+          "data/pg_wal"
+        ],
+        "priority": 10
       }
     }
   },
@@ -366,7 +368,11 @@
       ".jpg",
       ".jpeg",
       ".gif",
-      ".svg"
+      ".svg",
+      ".wal",
+      ".pcapng",
+      ".jsonl",
+      ".csv"
     ],
     "dirsToIgnore": [
       "node_modules/",
@@ -532,6 +538,38 @@
           ".so",
           ".out"
         ]
+      },
+      "postgresql": {
+        "filesToIgnore": [
+          "PG_VERSION",
+          "postmaster.pid",
+          "postmaster.opts",
+          "pg_ident.conf",
+          "*.log"
+        ],
+        "dirsToIgnore": [
+          "base/",
+          "global/",
+          "pg_wal/",
+          "pg_xact/",
+          "pg_commit_ts/",
+          "pg_dynshmem/",
+          "pg_logical/",
+          "pg_multixact/",
+          "pg_notify/",
+          "pg_replslot/",
+          "pg_serial/",
+          "pg_snapshots/",
+          "pg_stat/",
+          "pg_stat_tmp/",
+          "pg_subtrans/",
+          "pg_tblspc/",
+          "pg_twophase/"
+        ],
+        "extensionsToIgnore": [
+          ".fsm",
+          ".vm"
+        ]
       }
     }
   },
@@ -576,70 +614,70 @@
         "capabilities": ["npm", "git", "basic editing"],
         "restrictions": ["Do not use for complex architectural tasks"]
       },
-      "jas": {
-        "active": true,
-        "name": "Junior Architect (Sonnet 4.5)",
-        "description": "Project Mode Orchestrator (Claude Code only). Smart & Fast Manager. Manages GLM Z.AI workers for efficient task delegation.",
-        "guiSupport": true,
-        "identification": {
-          "markers": ["sonnet", "fast_architect"]
-        },
-        "capabilities": [
-          "glm_zai_frontend",
-          "glm_zai_backend",
-          "glm_zai_qa",
-          "glm_zai_refactor",
-          "glm_zai_general",
-          "git operations",
-          "npm run dev"
-        ],
-        "restrictions": [
-          "Prefer delegating heavy coding to GLM Z.AI workers",
-          "Focus on glue code and logic verification"
-        ]
-      },
-      "jao": {
-        "active": true,
-        "name": "Junior Architect (Opus 4.5)",
-        "description": "Project Mode Orchestrator (Claude Code only). Deep Thinker & Planner. Expensive. Use for critical architecture, security, and complex logic.",
-        "guiSupport": true,
-        "identification": {
-          "markers": ["opus", "deep_architect"]
-        },
-        "capabilities": [
-          "glm_zai_frontend",
-          "glm_zai_backend",
-          "glm_zai_qa",
-          "glm_zai_refactor",
-          "glm_zai_general",
-          "analysis"
-        ],
-        "restrictions": [
-          "STRICTLY DELEGATE boilerplate to GLM Z.AI",
-          "Verify every line of code generated by workers",
-          "Plan before execution"
-        ]
-      },
-      "jaz": {
-        "active": true,
-        "name": "Junior Architect (GLM-4.7 via OpenCode)",
-        "description": "Project Orchestrator for OpenCode. Highly accessible/budget-friendly. Manages the GLM Z.AI worker swarm.",
-        "guiSupport": true,
-        "identification": {
-          "markers": ["opencode", "glm-4.7"]
-        },
-        "capabilities": [
-          "glm_zai_frontend",
-          "glm_zai_backend",
-          "glm_zai_qa",
-          "glm_zai_refactor",
-          "glm_zai_general",
-          "git operations"
-        ],
-        "restrictions": [
-          "Strictly delegate complex/large logic to workers to preserve context window"
-        ]
-      },
+      "jas": {
+        "active": true,
+        "name": "Junior Architect (Sonnet 4.5)",
+        "description": "Project Mode Orchestrator (Claude Code only). Smart & Fast Manager. Manages GLM Z.AI workers for efficient task delegation.",
+        "guiSupport": true,
+        "identification": {
+          "markers": ["sonnet", "fast_architect"]
+        },
+        "capabilities": [
+          "glm_zai_frontend",
+          "glm_zai_backend",
+          "glm_zai_qa",
+          "glm_zai_refactor",
+          "glm_zai_general",
+          "git operations",
+          "npm run dev"
+        ],
+        "restrictions": [
+          "Prefer delegating heavy coding to GLM Z.AI workers",
+          "Focus on glue code and logic verification"
+        ]
+      },
+      "jao": {
+        "active": true,
+        "name": "Junior Architect (Opus 4.5)",
+        "description": "Project Mode Orchestrator (Claude Code only). Deep Thinker & Planner. Expensive. Use for critical architecture, security, and complex logic.",
+        "guiSupport": true,
+        "identification": {
+          "markers": ["opus", "deep_architect"]
+        },
+        "capabilities": [
+          "glm_zai_frontend",
+          "glm_zai_backend",
+          "glm_zai_qa",
+          "glm_zai_refactor",
+          "glm_zai_general",
+          "analysis"
+        ],
+        "restrictions": [
+          "STRICTLY DELEGATE boilerplate to GLM Z.AI",
+          "Verify every line of code generated by workers",
+          "Plan before execution"
+        ]
+      },
+      "jaz": {
+        "active": true,
+        "name": "Junior Architect (GLM-4.7 via OpenCode)",
+        "description": "Project Orchestrator for OpenCode. Highly accessible/budget-friendly. Manages the GLM Z.AI worker swarm.",
+        "guiSupport": true,
+        "identification": {
+          "markers": ["opencode", "glm-4.7"]
+        },
+        "capabilities": [
+          "glm_zai_frontend",
+          "glm_zai_backend",
+          "glm_zai_qa",
+          "glm_zai_refactor",
+          "glm_zai_general",
+          "git operations"
+        ],
+        "restrictions": [
+          "Strictly delegate complex/large logic to workers to preserve context window"
+        ]
+      },
       "production_server": {
         "active": true,
         "name": "Production Server Agent (AGENT_PROD_SERVER)",