@xelth/eck-snapshot 6.0.4 → 6.0.6

package/README.md

@@ -2,6 +2,7 @@
 
 A specialized, AI-native CLI tool designed to create and restore single-file text snapshots of Git repositories. Optimized for providing full project context to Large Language Models (LLMs) and serving as the coordination hub for AI Coders.
 
+
 ## 🎯 The Battle-Tested Workflow & Quick Start
 
 I personally use this tool daily with local AI coding agents (**Claude Code** using Claude, and **OpenCode** using GLM). My reliable, heavily-tested workflow is:
@@ -14,9 +15,9 @@ npm install -g @xelth/eck-snapshot
 ### 2. Initial Context (Full Snapshots)
 Take a full snapshot and feed it to a powerful Web LLM (Senior Architect like **Gemini** or **Grok**). *(Note: **ChatGPT** also works, but you MUST paste the specific prompt provided at the end of the snapshot output as your first prompt).*
 ```bash
-eck-snapshot snapshot
+eck-snapshot
 ```
-*(For massive monorepos, slice the context using profiles: `eck-snapshot snapshot --profile frontend`)*
+*(For massive monorepos, slice the context using profiles: `eck-snapshot --profile frontend`)*
 
 ### 3. Direct Execution
 Pass the Architect's technical plan to your local Coder agent (Claude Code / OpenCode). The Coder will implement the changes directly in your repository.
@@ -48,5 +49,29 @@ This core loop is highly polished, actively maintained, and works exceptionally
 * **☠️ Skeleton Mode:** Uses `Tree-sitter` and `Babel` to strip function bodies (`--skeleton`), drastically reducing token count.
 * **📊 Telemetry Hub:** Integrated with a Rust-based microservice for tracking agent execution metrics and auto-syncing token estimation weights.
 
+
+## 💡 The Philosophy: Why force a full snapshot?
+
+You've probably noticed a pattern: the longer you chat with an LLM about your codebase, the smarter it gets and the better its code becomes. 
+
+How do you get that expert-level understanding from the very first prompt? You can't rely on an agent guessing which isolated files to read based on filenames. You need to force-feed it the entire context at once. 
+
+Think of AI models like human engineers. Imagine a person standing next to a massive bookshelf of programming textbooks. The total amount of information available to them is exactly the same before they go to university and after they graduate. Both can open a book, check the table of contents, and look up a formula. Yet, the results they produce are vastly different. Why? Because the graduate has the structural context *inside their head*. 
+
+LLMs work the exact same way. Giving an AI a "file search" tool is like putting a beginner next to the bookshelf. Forcing a complete project snapshot into the LLM's massive context window is like giving it a university degree in your specific codebase. That is what `eck-snapshot` does.
+
+## 🗺️ Roadmap
+
+* **NotebookLM Optimization:** Our generated snapshots already work exceptionally well with Google NotebookLM. In the near future, we plan to introduce specific adaptations and context profiles tailored specifically for NotebookLM's document architecture, alongside our support for standard Web LLMs.
+
+## 🛑 Ethical Automation Policy
+
+This project strictly respects the Terms of Service of AI providers. We will **never** implement browser automation tools (like Playwright, Puppeteer, etc.) to spoof human behavior, scrape, or exploit web chat interfaces that are subsidized and intended solely for human use. We explicitly forbid the integration of such deceptive API-bypassing techniques in any official branches of this project.
+
 ## License
 MIT © xelth-com
+
+<br>
+<div align="center">
+  <sup>made in Eschborn</sup>
+</div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xelth/eck-snapshot",
-  "version": "6.0.4",
+  "version": "6.0.6",
   "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.",
   "main": "index.js",
   "type": "module",

package/src/cli/commands/createSnapshot.js

@@ -927,9 +927,9 @@ export async function createRepoSnapshot(repoPath, options) {
       // Output AI Prompt Suggestion for stubborn LLMs
       console.log('\n🤖 AI PROMPT SUGGESTION (Crucial for ChatGPT, helpful for others):');
       console.log('---------------------------------------------------');
-      console.log(chalk.yellow('💡 Tip: Claude, Gemini, and Grok handle large files best. ChatGPT works but can be slow.'));
+      console.log(chalk.yellow('💡 Tip: Gemini and Grok handle large files best. ChatGPT works but can be slow.'));
       console.log('If your AI ignores the file instructions and acts as an external reviewer,');
-      console.log('copy and paste this exact prompt along with your snapshot file:\n');
+      console.log('copy and paste this exact text as your FIRST prompt along with the snapshot file:\n');
       console.log(chalk.cyan.bold('Read the SYSTEM DIRECTIVE at the very beginning of the attached file. Immediately assume the role of Senior Architect as instructed, then await my first task.\n'));
 
     } finally {