@xelth/eck-snapshot 6.4.0 → 6.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xelth/eck-snapshot",
-  "version": "6.4.0",
+  "version": "6.4.1",
   "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/setup.json

@@ -368,7 +368,11 @@
       ".jpg",
       ".jpeg",
       ".gif",
-      ".svg"
+      ".svg",
+      ".wal",
+      ".pcapng",
+      ".jsonl",
+      ".csv"
     ],
     "dirsToIgnore": [
       "node_modules/",

package/src/templates/multiAgent.md

@@ -34,6 +34,31 @@ The `.eck/` directory files are your "Source of Knowledge".
 
 **Documentation is part of the "Definition of Done". A task is not finished if the relevant manifest files still contain [STUB] warnings.**
 
+### 🧹 CONTEXT HYGIENE PROTOCOL (CRITICAL)
+
+You are responsible for keeping your own context window clean and efficient.
+If you notice in the "Directory Structure" or file list that the snapshot has captured irrelevant data (e.g., compiled binaries, database dumps like .wal, huge generated logs, raw data arrays, or decompiled third-party code):
+1. **Take Immediate Action:** You MUST instruct the Coder to create or update a `.eckignore` file in the project root.
+2. **Syntax:** Use standard `.gitignore` syntax (e.g., `data/surreal_data/`, `*.wal`, `decompiled_dll/`).
+3. **Reasoning:** A bloated snapshot wastes your tokens and degrades your reasoning capabilities. Be aggressive in hiding non-source-code artifacts.
+
+### 📝 PROACTIVE TECH DEBT & TODO PROTOCOL
+
+As a Senior Architect, you must actively manage code quality. When analyzing files in this snapshot, do not ignore developer comments:
+1. **Spot:** Actively look for `TODO`, `FIXME`, `HACK`, or `BUG` comments in the provided source code.
+2. **Evaluate:** Compare the comment against the actual implementation. Developers often fix things but forget to remove the comment.
+3. **Resolve (The 3 Actions):**
+   - **Obsolete:** If the code already does what the TODO asks, instruct the Coder to **delete the comment**.
+   - **Quick Fix:** If it's a small missing piece or an obvious bug, instruct the Coder to **implement the fix and remove the comment**.
+   - **Real Debt:** If it requires significant architectural work, instruct the Coder to **document it in `.eck/TECH_DEBT.md`** so it is officially tracked, and leave the comment in the code for now.
+
+### 🏕️ THE BOY SCOUT RULE (Docstrings & Comments)
+
+Leave the codebase better than you found it.
+Whenever you instruct the Coder to **modify an existing function/class** or **create a new one**, you MUST explicitly add this requirement to their task:
+> *"Ensure the JSDoc / Docstring for this function is created or updated to accurately reflect its new behavior, parameters, and return types. Explain WHY it exists, not just WHAT it does."*
+Do not rewrite documentation for the entire file—only strictly for the components you are touching.
+
 ### CRITICAL WORKFLOW: Structured Commits via `journal_entry`
 
 To ensure proper project history, all code changes **MUST** be committed using the project's built-in structured workflow.

package/src/utils/fileUtils.js

@@ -205,7 +205,10 @@ export async function scanDirectoryRecursively(dirPath, config, relativeTo = dir
         if (entry.name === 'node_modules' ||
             entry.name === '.git' ||
             entry.name === '.idea' ||
-            entry.name === '.vscode') {
+            entry.name === '.vscode' ||
+            entry.name === '.gradle' ||
+            entry.name === 'build' ||
+            entry.name === '__pycache__') {
           continue;
         }
       } else {
@@ -270,14 +273,23 @@ export async function scanDirectoryRecursively(dirPath, config, relativeTo = dir
 }
 
 export async function loadGitignore(repoPath) {
+  const ig = ignore();
+
   try {
     const gitignoreContent = await fs.readFile(path.join(repoPath, '.gitignore'), 'utf-8');
-    const ig = ignore().add(gitignoreContent);
-    return ig;
+    ig.add(gitignoreContent);
   } catch {
     console.log('ℹ️ No .gitignore file found or could not be read');
-    return ignore();
   }
+
+  try {
+    const eckignoreContent = await fs.readFile(path.join(repoPath, '.eckignore'), 'utf-8');
+    ig.add(eckignoreContent);
+  } catch {
+    // .eckignore is optional, silently skip if missing
+  }
+
+  return ig;
 }
 
 export async function readFileWithSizeCheck(filePath, maxFileSize) {