feat: implement Ghost Skeptic adversarial validation system

Author: anujsingh-cse

.ghostcoder/team.yml

@@ -0,0 +1,22 @@
+team:
+  lead: backend-architect
+  reviewers:
+    - security-engineer
+    - reality-checker
+  specialists:
+    auth: security-engineer
+    perf: database-optimizer
+    deploy: devops-automator
+
+rules:
+  - pattern: "src/auth/"
+    agent: security-engineer
+    block_merge_on: high_severity_finding
+    
+  - pattern: "migrations/"
+    agent: database-optimizer
+    require: index_check
+    
+  - pattern: ".github/workflows/"
+    agent: devops-automator
+    notify: "#deployments"

.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e .[dev]
+
+    - name: Run Pytest
+      run: |
+        pytest

.gitignore

@@ -0,0 +1,25 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.pytest_cache/
+.venv/
+venv/
+ENV/
+build/
+dist/
+*.egg-info/
+
+# VS Code extension
+vscode/out/
+vscode/node_modules/
+
+# Local/System
+.DS_Store
+Thumbs.db
+*.sock
+daemon.pid
+daemon.log
+audit.log
+sessions/

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GhostCoder Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,66 @@
+# GhostCoder 👻
+
+An invisible coding partner that runs in the background, watches your terminal and IDE sessions, detects when you're stuck, and dispatches the right specialist agent to help without interrupting your flow.
+
+## Core Concept
+GhostCoder does **NOT** have a sidebar or chat interface. It observes:
+- Terminal session (pre/post-commands, exit codes, stderr/stdout stack traces).
+- File system changes (modified files, contents, open buffers).
+
+When it detects errors or complex tasks, it uses local LLMs to classify the situation and selects an appropriate specialist agent from your local Antigravity agency skills to show a concise, inline, dismissible hint.
+
+## Architecture
+
+```
+                                  +-----------------------+
+                                  |   GhostCoder Daemon   |
+                                  |        (Python)       |
+                                  +-----------+-----------+
+                                              |
+                     +------------------------+------------------------+
+                     |                        |                        |
+             [Unix Domain Socket]     [Unix Domain Socket]     [Unix Domain Socket]
+                     |                        |                        |
+                     v                        v                        v
+          +--------------------+    +--------------------+    +--------------------+
+          |   Shell Plugin     |    |   Neovim Plugin    |    | VS Code Extension  |
+          |  (Bash/Zsh/Fish)   |    |       (Lua)        |    |    (TypeScript)    |
+          +--------------------+    +--------------------+    +--------------------+
+```
+
+## Hardware Compatibility & LLMs
+GhostCoder is designed to run efficiently on low-end GPUs (e.g., **NVIDIA GTX 1650 4GB VRAM**):
+1. **Qwen2.5-0.5B (1GB VRAM)**: Kept loaded in memory for fast command and situation classification.
+2. **Qwen2.5-Coder-1.5B (2GB VRAM)**: Loaded on demand for code generation, and automatically unloaded after 30 seconds of idle time.
+3. **Fallback**: Auto-falls back to CPU inference (or Gemini API Free Tier) if GPU memory is constrained.
+
+---
+
+## Installation & Setup
+
+1. **Prerequisites**:
+   - Install [Ollama](https://ollama.ai/) and start the daemon.
+   - Pull the required models:
+     ```bash
+     ollama pull qwen2.5:0.5b
+     ollama pull qwen2.5-coder:1.5b
+     ```
+
+2. **Install package**:
+   ```bash
+   pip install -e .
+   ```
+
+3. **Initialize Plugins**:
+   ```bash
+   ghostcoder init
+   ```
+   This command detects your shell, registers shell hooks, and starts the daemon.
+
+---
+
+## CLI Usage
+
+- `ghostcoder status` - Show loaded models, VRAM usage, and active integrations.
+- `ghostcoder logs` - Tail daemon logs.
+- `ghostcoder stop` - Stop the background daemon gracefully.

ghostcoder/__init__.py

@@ -0,0 +1,2 @@
+# GhostCoder package
+__version__ = "0.1.0"

ghostcoder/agents.py

@@ -0,0 +1,76 @@
+import os
+import yaml
+import pathlib
+from typing import Dict, Any, Optional
+
+class AgentLoader:
+    def __init__(self):
+        self.agents: Dict[str, Dict[str, Any]] = {}
+        self.load_all_agents()
+
+    def load_all_agents(self):
+        # We search in ~/.gemini/config/skills/ and ~/.gemini/antigravity/skills/
+        search_dirs = [
+            os.path.expanduser("~/.gemini/config/skills"),
+            os.path.expanduser("~/.gemini/antigravity/skills")
+        ]
+        
+        for base_dir in search_dirs:
+            if not os.path.isdir(base_dir):
+                continue
+            
+            p = pathlib.Path(base_dir)
+            for skill_dir in p.iterdir():
+                if skill_dir.is_dir() and skill_dir.name.startswith("agency-"):
+                    skill_md_path = skill_dir / "SKILL.md"
+                    if skill_md_path.exists():
+                        self.parse_skill_file(skill_dir.name, skill_md_path)
+
+    def parse_skill_file(self, folder_name: str, file_path: pathlib.Path):
+        try:
+            with open(file_path, "r", encoding="utf-8") as f:
+                content = f.read()
+            
+            # Parse YAML frontmatter
+            # Example format:
+            # ---
+            # name: agency-software-architect
+            # description: ...
+            # ---
+            # Body...
+            parts = content.split("---")
+            if len(parts) >= 3:
+                frontmatter_str = parts[1]
+                body_str = "---".join(parts[2:])
+                
+                try:
+                    metadata = yaml.safe_load(frontmatter_str)
+                except Exception:
+                    metadata = {}
+                
+                name = metadata.get("name", folder_name)
+                description = metadata.get("description", "")
+                
+                self.agents[name] = {
+                    "name": name,
+                    "description": description,
+                    "system_prompt": body_str.strip(),
+                    "folder_name": folder_name,
+                    "path": str(file_path)
+                }
+        except Exception as e:
+            print(f"Error parsing skill file {file_path}: {e}")
+
+    def get_agent(self, name: str) -> Optional[Dict[str, Any]]:
+        # Match by name or folder name (e.g. "agency-reality-checker")
+        if name in self.agents:
+            return self.agents[name]
+        
+        # Try match by suffix
+        for k, v in self.agents.items():
+            if k.endswith(name) or v["folder_name"] == name:
+                return v
+        return None
+
+    def list_available_agents(self) -> Dict[str, str]:
+        return {name: info["description"] for name, info in self.agents.items()}