@xelth/eck-snapshot 6.5.1 → 6.6.0

package/README.md

@@ -200,6 +200,7 @@ By analyzing Claude Code's internal architecture, eckSnapshot replaces the old m
 * **📁 The `.eck/` Manifest:** Automatically maintains project context files (`CONTEXT.md`, `ROADMAP.md`, `TECH_DEBT.md`). Dynamic scanning — any `.md` file you add to `.eck/` is automatically included in snapshots.
 * **☠️ Skeleton Mode:** Uses Tree-sitter and Babel to strip function bodies, drastically reducing token count for huge codebases.
 * **📚 NotebookLM Export:** Semantic chunking for Google's NotebookLM with "Brain + Body" architecture (see below).
+* **🧪 ML Model Compatibility:** Smart metadata extraction for `.safetensors`, `.onnx`, `.pt`, `.pth`, `.h5`, `.pb`, `.bin`, `.ckpt`, `.gguf` — reads the first 4KB header instead of loading multi-GB weights into memory.
 * **🧠 Multi-Agent Protocol:** Junior Architect delegation system for multi-agent coding workflows (see below).
 
 ### 🤖 Autonomous AI Protocols

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xelth/eck-snapshot",
-  "version": "6.5.1",
+  "version": "6.6.0",
   "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/cli.js

@@ -6,6 +6,7 @@ import chalk from 'chalk';
 import { createRequire } from 'module';
 import os from 'os';
 import crypto from 'crypto';
+import { ensureSnapshotsInGitignore } from '../utils/fileUtils.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -163,6 +164,7 @@ Ranked by frequency of use:
         queue.feedback.push({ type, message: msg, date: new Date().toISOString() });
 
         await fs.mkdir(path.dirname(queuePath), { recursive: true }).catch(() => {});
+        await ensureSnapshotsInGitignore(process.cwd()).catch(() => {});
         await fs.writeFile(queuePath, JSON.stringify(queue, null, 2));
 
         console.log(chalk.green('Feedback saved locally. It will be sent to developers during the next telemetry sync.'));
@@ -218,6 +220,7 @@ Ranked by frequency of use:
             } catch(e) { /* no existing queue */ }
             queue.usage[toolName] = (queue.usage[toolName] || 0) + 1;
             await fs.mkdir(path.dirname(queuePath), { recursive: true }).catch(() => {});
+            await ensureSnapshotsInGitignore(cwd).catch(() => {});
             await fs.writeFile(queuePath, JSON.stringify(queue, null, 2));
           } catch(e) { /* ignore tracking errors */ }
         }
@@ -265,6 +268,7 @@ Ranked by frequency of use:
             } catch(e) { /* no existing queue */ }
             queue.errors.push({ tool: toolName, error: err.message, date: new Date().toISOString() });
             await fs.mkdir(path.dirname(queuePath), { recursive: true }).catch(() => {});
+            await ensureSnapshotsInGitignore(cwd).catch(() => {});
             await fs.writeFile(queuePath, JSON.stringify(queue, null, 2));
           } catch(e) { /* ignore tracking errors */ }
         }

package/src/cli/commands/createSnapshot.js

@@ -15,7 +15,7 @@ import {
   scanDirectoryRecursively, loadGitignore, readFileWithSizeCheck,
   generateDirectoryTree, loadConfig, displayProjectInfo, loadProjectEckManifest,
   ensureSnapshotsInGitignore, initializeEckManifest, generateTimestamp,
-  getShortRepoName, SecretScanner, getProjectFiles
+  getShortRepoName, SecretScanner, getProjectFiles, readMlModelMetadata
 } from '../../utils/fileUtils.js';
 import { detectProjectType, getProjectSpecificFiltering, getAllDetectedTypes } from '../../utils/projectDetector.js';
 import { estimateTokensWithPolynomial, generateTrainingCommand } from '../../utils/tokenEstimator.js';
@@ -394,8 +394,12 @@ async function processProjectFiles(repoPath, options, config, projectTypes = nul
           return null;
         }
 
-        // Check if binary file
-        if (isBinaryPath(filePath)) {
+        const mlExt = path.extname(filePath).toLowerCase();
+        const ML_EXTENSIONS = ['.safetensors', '.onnx', '.pt', '.pth', '.h5', '.pb', '.bin', '.ckpt', '.gguf'];
+        const isMlModel = ML_EXTENSIONS.includes(mlExt);
+
+        // Check if binary file (bypass if it's an ML model we want to peek into)
+        if (isBinaryPath(filePath) && !isMlModel) {
           stats.binaryFiles++;
           trackSkippedFile(normalizedPath, 'Binary files');
           return null;
@@ -421,13 +425,18 @@ async function processProjectFiles(repoPath, options, config, projectTypes = nul
         stats.totalSize += fileStats.size;
 
         const maxFileSize = parseSize(config.maxFileSize);
-        if (fileStats.size > maxFileSize) {
-          stats.oversizedFiles++;
-          trackSkippedFile(normalizedPath, `File too large (${formatSize(fileStats.size)} > ${formatSize(maxFileSize)})`);
-          return null;
-        }
+        let content;
 
-        let content = await readFileWithSizeCheck(fullPath, maxFileSize);
+        if (isMlModel) {
+          content = await readMlModelMetadata(fullPath);
+        } else {
+          if (fileStats.size > maxFileSize) {
+            stats.oversizedFiles++;
+            trackSkippedFile(normalizedPath, `File too large (${formatSize(fileStats.size)} > ${formatSize(maxFileSize)})`);
+            return null;
+          }
+          content = await readFileWithSizeCheck(fullPath, maxFileSize);
+        }
 
         // Security scan for secrets
         if (config.security?.scanForSecrets !== false) {