{"_id":"@atsmith2k/guppi","_rev":"3-1ba0d27a9a84c55bf48962738cf1b193","name":"@atsmith2k/guppi","dist-tags":{"latest":"2.0.2"},"versions":{"2.0.0":{"name":"@atsmith2k/guppi","version":"2.0.0","keywords":["agentic","mcp","rag","sidecar","memory","onboarding","telemetry","model-context-protocol","developer-tools","codebase-indexing"],"author":{"name":"GUPPI Development Team"},"license":"MIT","_id":"@atsmith2k/guppi@2.0.0","maintainers":[{"name":"atsmith2k","email":"atsmith2k@gmail.com"}],"homepage":"https://github.com/atsmith2k/guppi#readme","bugs":{"url":"https://github.com/atsmith2k/guppi/issues"},"bin":{"guppi":"bin/guppi.js"},"dist":{"shasum":"aa5466cfca5b9c4c30d9d15dba1615af55d15b3e","tarball":"https://registry.npmjs.org/@atsmith2k/guppi/-/guppi-2.0.0.tgz","fileCount":81,"integrity":"sha512-V00PwzIq2v/1Ci6jfQ2GBW0a4fHL6jHHL6BOLmYTACTBjf9vUTx2VXkcxNyjwpBQjSYEDQ8xBM1eRYQKlGdylA==","signatures":[{"sig":"MEQCIA8bBqvCs6bFAX+/erNGQUG/rUD+I6GS2xwjo+7kQn5oAiBOnHYZwDZhuIbmjS2GYw6sAQnEsMT7PfwVZgzu4YejnQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":552714},"main":"dist/server/index.js","type":"module","types":"dist/server/index.d.ts","module":"dist/server/index.js","gitHead":"e9bc46d2252907de2d2442058a4ce881fce127a1","scripts":{"dev":"tsx src/cli/main.ts start","test":"node --import tsx --test --test-concurrency=1 test/poached_features.spec.ts test/agentic_assist.spec.ts test/lst_traversal.spec.ts","build":"npm run build:cli && npm run build:ui","start":"node bin/guppi.js start","build:ui":"vite build","build:cli":"tsc","pack:check":"npm pack --dry-run","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"atsmith2k","email":"atsmith2k@gmail.com"},"repository":{"url":"git+https://github.com/atsmith2k/guppi.git","type":"git"},"_npmVersion":"10.9.8","description":"GUPPI — General-purpose Unifying Pluggable Intelligence & Agentic Sidecar","directories":{},"_nodeVersion":"22.23.1","dependencies":{"ws":"^8.17.0","glob":"^10.3.10","react":"^18.3.1","ignore":"^5.3.1","express":"^4.19.2","commander":"^12.0.0","react-dom":"^18.3.1","lucide-react":"^0.378.0","better-sqlite3":"^13.0.3","@modelcontextprotocol/sdk":"^1.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.10.5","vite":"^5.2.11","@types/ws":"^8.5.10","typescript":"^5.4.5","@types/node":"^20.12.12","@types/react":"^18.3.3","@types/express":"^4.17.21","@playwright/test":"^1.62.1","@types/react-dom":"^18.3.0","@vitejs/plugin-react":"^4.2.1","@types/better-sqlite3":"^7.6.10"},"_npmOperationalInternal":{"tmp":"tmp/guppi_2.0.0_1786286353391_0.4222428455549785","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@atsmith2k/guppi","version":"2.0.1","keywords":["agentic","mcp","rag","sidecar","memory","onboarding","telemetry","model-context-protocol","developer-tools","codebase-indexing"],"author":{"name":"GUPPI Development Team"},"license":"MIT","_id":"@atsmith2k/guppi@2.0.1","maintainers":[{"name":"atsmith2k","email":"atsmith2k@gmail.com"}],"homepage":"https://github.com/atsmith2k/guppi#readme","bugs":{"url":"https://github.com/atsmith2k/guppi/issues"},"bin":{"guppi":"bin/guppi.js"},"dist":{"shasum":"c7854b857bc216cd2a14e11b3a5e8ada66000750","tarball":"https://registry.npmjs.org/@atsmith2k/guppi/-/guppi-2.0.1.tgz","fileCount":81,"integrity":"sha512-i2H5IBGPK4l0orAmXnGgHPmAr2A8Z1qoqupH8RrPuOiePN9O0CkCU8rDx66l0eNY6pP5/6b6MZQFHNR9lAAdYQ==","signatures":[{"sig":"MEUCIEUK/lj552vAoCocwGJBt1e1Kh+DUkB/Y6fa3KQ7sMy+AiEA6ZAF7ZruiX6pO7QxuWF1/FsdYr5MbWgdddLPSvCqMFY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":552714},"main":"dist/server/index.js","type":"module","types":"dist/server/index.d.ts","module":"dist/server/index.js","gitHead":"615d1583e8d1d95aacb3ff0e1cae87b6fb064c44","scripts":{"dev":"tsx src/cli/main.ts start","test":"node --import tsx --test --test-concurrency=1 test/poached_features.spec.ts test/agentic_assist.spec.ts test/lst_traversal.spec.ts","build":"npm run build:cli && npm run build:ui","start":"node bin/guppi.js start","build:ui":"vite build","build:cli":"tsc","pack:check":"npm pack --dry-run","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"atsmith2k","email":"atsmith2k@gmail.com"},"repository":{"url":"git+https://github.com/atsmith2k/guppi.git","type":"git"},"_npmVersion":"10.9.8","description":"GUPPI — General-purpose Unifying Pluggable Intelligence & Agentic Sidecar","directories":{},"_nodeVersion":"22.23.1","dependencies":{"ws":"^8.17.0","glob":"^10.3.10","react":"^18.3.1","ignore":"^5.3.1","express":"^4.19.2","commander":"^12.0.0","react-dom":"^18.3.1","lucide-react":"^0.378.0","better-sqlite3":"^13.0.3","@modelcontextprotocol/sdk":"^1.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.10.5","vite":"^5.2.11","@types/ws":"^8.5.10","typescript":"^5.4.5","@types/node":"^20.12.12","@types/react":"^18.3.3","@types/express":"^4.17.21","@playwright/test":"^1.62.1","@types/react-dom":"^18.3.0","@vitejs/plugin-react":"^4.2.1","@types/better-sqlite3":"^7.6.10"},"_npmOperationalInternal":{"tmp":"tmp/guppi_2.0.1_1786286487228_0.6308605101413367","host":"s3://npm-registry-packages-npm-production"}},"2.0.2":{"name":"@atsmith2k/guppi","version":"2.0.2","description":"GUPPI — General-purpose Unifying Pluggable Intelligence & Agentic Sidecar","main":"dist/server/index.js","module":"dist/server/index.js","types":"dist/server/index.d.ts","type":"module","bin":{"guppi":"bin/guppi.js"},"scripts":{"build:cli":"tsc","build:ui":"vite build","build":"npm run build:cli && npm run build:ui","test":"node --import tsx --test --test-concurrency=1 test/poached_features.spec.ts test/agentic_assist.spec.ts test/lst_traversal.spec.ts","prepublishOnly":"npm run build && npm test","pack:check":"npm pack --dry-run","start":"node bin/guppi.js start","dev":"tsx src/cli/main.ts start"},"repository":{"type":"git","url":"git+https://github.com/atsmith2k/guppi.git"},"bugs":{"url":"https://github.com/atsmith2k/guppi/issues"},"homepage":"https://github.com/atsmith2k/guppi#readme","publishConfig":{"access":"public"},"keywords":["agentic","mcp","rag","sidecar","memory","onboarding","telemetry","model-context-protocol","developer-tools","codebase-indexing"],"author":{"name":"GUPPI Development Team"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.2.0","better-sqlite3":"^13.0.3","commander":"^12.0.0","express":"^4.19.2","glob":"^10.3.10","ignore":"^5.3.1","lucide-react":"^0.378.0","react":"^18.3.1","react-dom":"^18.3.1","typescript":"^5.4.5","ws":"^8.17.0"},"devDependencies":{"@playwright/test":"^1.62.1","@types/better-sqlite3":"^7.6.10","@types/express":"^4.17.21","@types/node":"^20.12.12","@types/react":"^18.3.3","@types/react-dom":"^18.3.0","@types/ws":"^8.5.10","@vitejs/plugin-react":"^4.2.1","tsx":"^4.10.5","vite":"^5.2.11"},"_id":"@atsmith2k/guppi@2.0.2","gitHead":"fd5547b83c3a14499c7a6d529d0e01c03f1c7efa","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-H3oilnxCHjTgTa3Kpf7PJmKiBuhklhVMI6FMzSFFFthEAvBs9lN4V96DR78lJgkSMWuASSu0ygGRjP8MrLhV6w==","shasum":"e546664fa6d446b9cac65f0e9ecc943538b6e9af","tarball":"https://registry.npmjs.org/@atsmith2k/guppi/-/guppi-2.0.2.tgz","fileCount":87,"unpackedSize":564224,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIH5+ajymF2jNd0hYzW/s78pq5sEgOTY5F4RL2JuL6ABBAiEA7rjK4w/vlLgDNzlAZEQC/AYsEZN4jTXrOMfz7W8niU8="}]},"_npmUser":{"name":"atsmith2k","email":"atsmith2k@gmail.com"},"directories":{},"maintainers":[{"name":"atsmith2k","email":"atsmith2k@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/guppi_2.0.2_1786286972784_0.515490254719033"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-09T14:39:13.207Z","modified":"2026-08-09T14:49:33.081Z","2.0.0":"2026-08-09T14:39:13.547Z","2.0.1":"2026-08-09T14:41:27.416Z","2.0.2":"2026-08-09T14:49:32.939Z"},"bugs":{"url":"https://github.com/atsmith2k/guppi/issues"},"author":{"name":"GUPPI Development Team"},"license":"MIT","homepage":"https://github.com/atsmith2k/guppi#readme","keywords":["agentic","mcp","rag","sidecar","memory","onboarding","telemetry","model-context-protocol","developer-tools","codebase-indexing"],"repository":{"type":"git","url":"git+https://github.com/atsmith2k/guppi.git"},"description":"GUPPI — General-purpose Unifying Pluggable Intelligence & Agentic Sidecar","maintainers":[{"name":"atsmith2k","email":"atsmith2k@gmail.com"}],"readme":"

\n \"GUPPI\n

\n\n

\n The high-performance agentic sidecar, LST memory engine, & telemetry control deck built for real AI workflows.\n

\n\n

\n \"Node.js\"\n \"TypeScript\"\n \"MCP\n \"SQLite\"\n \"License\"\n \"Privacy\n

\n\n---\n\n## 🌟 Overview\n\n**GUPPI** (*General-purpose Unifying Pluggable Intelligence*) is an enterprise-grade, plug-and-play agentic sidecar daemon, RAG memory engine, and real-time telemetry deck. GUPPI hooks directly into development workspaces alongside primary AI coding tools (**Antigravity CLI**, **Claude Code**, **Cursor**, **Windsurf**, **Pi**, **AutoGen**, **CrewAI**, **Aider**).\n\nRather than replacing your existing AI agentic workflows, GUPPI acts as an **\"intelligent second brain\"** operating in the background:\n- ⚡ **Programmatically indexes AST symbols** & Lossless Semantic Trees (LST) for instant token-compressed code navigation (~70-80% token savings).\n- 🧠 **Maintains long-term decay-ranked RAG memory** and extracts subject-relation-object Fact Graphs across agent sessions.\n- 📋 **Orchestrates multi-agent DAG task plans** with structured session handoff checkpoints.\n- 🛡️ **Enforces pre-flight safety guardrails**, secret detection, and non-destructive shadow file backups before code mutations.\n- 🧪 **Benchmarks agent precision, faithfulness & latency** (DeepEval/AgentOps style) with auto-generated AST unit test suites.\n- 🎛️ **Serves a glassmorphic Web Control Deck** at `http://localhost:3737`.\n\n---\n\n## ✨ 6 Core Functional Pillars\n\nGUPPI organizes its capabilities into 6 condensed functional pillars:\n\n| Pillar Module | Core Purpose | Key Tools & Engines |\n| :--- | :--- | :--- |\n| 📦 **1. Context & Compression** | Traverses workspace files, parses AST signatures, extracts rules (`AGENTS.md`, `CLAUDE.md`), and compresses prompt context. | `guppi_onboard`, `guppi_skeletonize`, `guppi_inspect_symbol`, `guppi_git_rag` |\n| 🧠 **2. Memory & Knowledge Graph** | Hybrid BM25/FTS5 text search, Ebbinghaus decay-ranked episodic memory, and subject-relation-object Fact Graph extraction. | `guppi_remember`, `guppi_episodic_remember`, `guppi_query_facts`, `guppi_working_memory` |\n| 📋 **3. Multi-Agent Planning & Handoff** | Decomposes complex goals into multi-agent DAG task plans and manages subagent context handoff checkpoints. | `guppi_task_plan_create`, `guppi_task_step_update`, `guppi_compact_session`, `guppi_subagent_checkpoint` |\n| 🛡️ **4. Safety, Mutation & Self-Healing** | Pre-flight safety audit, secret detection, shadow backup snapshot creation, symbol call graph mutation simulation, and traceback auto-fix. | `guppi_guard_check`, `guppi_guard_enforce`, `guppi_rollback_file`, `guppi_signature_mutate_simulate` |\n| 🧪 **5. Quality & Telemetry** | Agent RAG precision benchmarking (DeepEval/AgentOps), automated unit test generation, and interactive Q&A spec brainstorming. | `guppi_evaluate_run`, `guppi_log_telemetry`, `guppi_brainstorm_start`, `guppi_generate_tests` |\n| 🌳 **6. LST & Codebase Traversal** | Serena-style scope-aware symbol search, Lossless Semantic Tree (LST) structural querying, cross-file reference tracing, and atomic code body replacement. | `guppi_lst_find_symbols`, `guppi_lst_query_tree`, `guppi_lst_find_references`, `guppi_lst_replace_symbol` |\n\n---\n\n## ⚡ Quick Start CLI Guide\n\n```bash\n# 1. Install dependencies & build GUPPI\nnpm install\nnpm run build\nnpm link\n\n# 2. Initialize GUPPI in your project (creates .guppi/guppi.db and .guppi/mcp.json)\nguppi init\n\n# 3. Start the background daemon & Web Control Deck\nguppi start\n\n# 4. Serena-Style Symbol Search (LST Engine)\nguppi symbol LSTTraversalEngine\n\n# 5. Query Lossless Semantic Tree (LST) Structure\nguppi tree src/engine/lst_traversal.ts ClassDeclaration\n\n# 6. Find Cross-File Call References\nguppi refs GuppiDB\n\n# 7. Query Hybrid RAG Memory\nguppi query \"SQLite WAL mode\"\n\n# 8. Record an Architectural Decision\nguppi remember \"Use SQLite WAL\" \"SQLite WAL mode enables sub-millisecond concurrent reads/writes.\"\n\n# 9. Decompose Goal into a Multi-Agent DAG Task Plan\nguppi plan \"Build OAuth2 authentication engine\"\n\n# 10. Run AST Call Graph & Signature Mutation Simulator\nguppi callgraph GuppiDB\n\n# 11. Run stdio MCP server for agent pipes\nguppi mcp\n```\n\n---\n\n## 🔌 Agentic Integration (Model Context Protocol - MCP)\n\nAdd this configuration snippet to your primary agent's settings (e.g., `mcp_config.json` or `.guppi/mcp.json`):\n\n```json\n{\n \"mcpServers\": {\n \"guppi\": {\n \"command\": \"guppi\",\n \"args\": [\"mcp\"],\n \"env\": {\n \"GUPPI_WORKSPACE\": \"/path/to/your/project\"\n }\n }\n }\n}\n```\n\n> 📖 **Full Agentic Integration Guide**: See [`docs/AGENT_WORKFLOW_GUIDE.md`](file:///Users/ashton/git/something/docs/AGENT_WORKFLOW_GUIDE.md) for detailed instructions on instrumenting GUPPI within CLI agents, custom scripts, and system prompts.\n\n---\n\n## 🛠️ Complete MCP Tools Reference (25 Tools)\n\n### 📦 Pillar 1: Context & Compression\n- `guppi_onboard`: Programmatically scan workspace & re-index AST symbols.\n- `guppi_query_context`: Hybrid RAG search over memories, rules, and symbols.\n- `guppi_skeletonize`: Generate token-compressed AST code skeleton (~70-80% token savings).\n- `guppi_inspect_symbol`: Query function/class AST signatures without opening full files.\n- `guppi_git_rag`: Query Git commit history & diff database.\n\n### 🧠 Pillar 2: Memory & Knowledge Graph\n- `guppi_remember`: Save long-term architectural decisions and rules.\n- `guppi_episodic_remember`: Store decay-ranked episodic memory & extract Fact Triples.\n- `guppi_query_facts`: Query extracted subject-relation-object Fact Graph triples.\n- `guppi_working_memory`: Read/write ephemeral working memory scratchpad.\n- `guppi_link_knowledge`: Create Knowledge Graph edge (`memory_id` $\\rightarrow$ `target_symbol_or_file`).\n\n### 📋 Pillar 3: Multi-Agent Planning & Handoff\n- `guppi_task_plan_create`: Decompose goal into multi-agent DAG task plan.\n- `guppi_task_step_update`: Update step status in DAG orchestrator.\n- `guppi_compact_session`: Save structured Handoff Checkpoint to Working Memory.\n- `guppi_subagent_checkpoint`: Manage subagent checkpoints and context handoffs.\n\n### 🛡️ Pillar 4: Safety, Mutation & Self-Healing\n- `guppi_guard_check`: Run pre-flight safety & secret detection checks.\n- `guppi_guard_enforce`: Run safety audit & create non-destructive shadow backup snapshot.\n- `guppi_rollback_file`: Roll back a file to its latest shadow backup snapshot.\n- `guppi_self_heal`: Analyze error traceback and receive surgical auto-repair diff.\n- `guppi_auto_fix_suggest`: Parse error logs and receive auto-repair patch recommendation.\n- `guppi_impact_analysis`: Evaluate downstream breaking changes across callers and files.\n- `guppi_signature_mutate_simulate`: Simulate signature mutation & evaluate breaking change risk.\n\n### 🧪 Pillar 5: Quality & Telemetry\n- `guppi_evaluate_run`: Benchmark agent precision, faithfulness, latency, and token cost.\n- `guppi_log_telemetry`: Log tool call traces, latencies, and token counts.\n- `guppi_generate_tests`: Auto-generate unit test suites from AST signatures.\n- `guppi_brainstorm_start`: Start interactive Q&A brainstorming session (Starbursting, SCAMPER, 5-Whys).\n- `guppi_brainstorm_answer`: Submit answer & advance phase or synthesize spec blueprint.\n\n### 🌳 Pillar 6: LST & Codebase Traversal\n- `guppi_lst_find_symbols`: Scope-aware and fuzzy symbol lookup enriched with memories and Fact Triples.\n- `guppi_lst_query_tree`: Query Lossless Semantic Tree (LST) nodes using structural path selectors.\n- `guppi_lst_find_references`: Locate all caller sites, instantiations, type usages, and imports across workspace.\n- `guppi_lst_skeleton_slice`: Generate token-efficient folded code slice collapsing implementation bodies.\n- `guppi_lst_replace_symbol`: Replace target symbol body losslessly while preserving formatting, with automatic shadow backup.\n\n---\n\n## 🗂️ Virtual Context Filesystem (`guppi://`)\n\nGUPPI exposes standard MCP Resources that agents can browse or read:\n\n| Resource URI | Description | MIME Type |\n| :--- | :--- | :--- |\n| `guppi://memories/all` | All stored workspace architectural decisions & rules. | `application/json` |\n| `guppi://symbols/all` | Complete codebase AST symbol map. | `application/json` |\n| `guppi://lst/symbols/all` | Lossless Semantic Symbols index enriched with memory links. | `application/json` |\n| `guppi://recipes/codebase_traversal` | LST Traversal & symbol navigation decision matrix. | `application/json` |\n| `guppi://recipes/tool_selection` | Agentic Tool Selection recipes matrix. | `application/json` |\n| `guppi://git/history` | Git commit log & diff summaries. | `application/json` |\n| `guppi://brainstorm/blueprint` | Latest synthesized Brainstorm Spec Blueprint markdown. | `text/markdown` |\n| `guppi://tasks/active` | Active task execution plans and DAG step progress. | `application/json` |\n| `guppi://facts/graph` | Extracted subject-relation-object Fact Graph triples. | `application/json` |\n| `guppi://eval/reports` | Agent RAG precision, faithfulness & latency reports. | `application/json` |\n| `guppi://graph/callgraph` | AST symbol call graph nodes and hierarchy edges. | `application/json` |\n| `guppi://checkpoints/active` | Subagent session handoff checkpoints. | `application/json` |\n| `guppi://backups/recent` | Active shadow file backup snapshots. | `application/json` |\n| `guppi://guardrails/rules` | Active safety guardrails & secret patterns. | `application/json` |\n\n---\n\n## 🏗️ Project Architecture Layout\n\n```\n/guppi\n├── assets/\n│ ├── logo.svg # Vector SVG brand emblem\n│ └── banner.svg # Header hero banner SVG\n├── bin/\n│ └── guppi.js # Executable CLI entrypoint\n├── docs/\n│ └── AGENT_WORKFLOW_GUIDE.md # Complete Agentic Instrumentation & Workflow Guide\n├── src/\n│ ├── cli/\n│ │ └── main.ts # Commander CLI definition & commands\n│ ├── server/\n│ │ ├── index.ts # Server daemon manager\n│ │ ├── mcp.ts # MCP Server (Stdio & HTTP transport)\n│ │ └── pillars/ # 6 Condensed Functional Pillar Modules\n│ │ ├── context_pillar.ts # Pillar 1: Context & Compression\n│ │ ├── memory_pillar.ts # Pillar 2: Memory & Knowledge Graph\n│ │ ├── planning_pillar.ts # Pillar 3: Multi-Agent Planning & Handoff\n│ │ ├── safety_pillar.ts # Pillar 4: Safety & Mutation\n│ │ ├── quality_pillar.ts # Pillar 5: Quality & Telemetry\n│ │ └── lst_pillar.ts # Pillar 6: LST & Codebase Traversal\n│ ├── db/\n│ │ ├── schema.ts # SQLite WAL schema & FTS5 virtual tables\n│ │ └── client.ts # GuppiDB client & query helpers\n│ ├── engine/\n│ │ ├── lst_traversal.ts # Serena-style LST Engine & Reference Tracer\n│ │ ├── task_planner.ts # Task DAG Orchestrator (Aider/Superpowers)\n│ │ ├── episodic_memory.ts # Decay-Ranked Memory & Fact Graph (Mem0/MemGPT)\n│ │ ├── agent_eval.ts # RAG Precision Benchmark Studio (DeepEval/AgentOps)\n│ │ ├── symbol_call_graph.ts # Call Graph & Mutation Simulator (Tree-Sitter/GraphRAG)\n│ │ ├── guard_enforcer.ts # Shadow backup & rollback engine\n│ │ ├── onboarder.ts # Codebase & rule traversal engine\n│ │ └── brainstorm.ts # Interactive Q&A ideation engine\n│ └── dashboard/ # React + Vite Glassmorphic Dashboard UI\n├── test/\n│ ├── agentic_assist.spec.ts # Agentic assistance engine tests\n│ └── poached_features.spec.ts # Poached feature pillar tests\n└── CHANGELOG.md # Release changelog\n```\n\n---\n\n## 🛡️ Privacy & Security Guarantees\n\n1. **100% Local & Offline**: All databases (`guppi.db`), RAG indexes, and backups remain strictly on your local machine. No code or context is sent to external cloud servers.\n2. **Non-Destructive Shadow Backups**: GUPPI automatically creates timestamped backup snapshots in `.guppi/backups/` before applying any atomic code replacement.\n3. **Pre-flight Secret Guardrails**: Pre-flight audits flag hardcoded API keys, credentials, or empty exception catch blocks before edits are saved.\n\n---\n\n## 📄 License\n\nMIT © GUPPI Development Team\n","readmeFilename":"README.md"}