cc-agy 0.0.0-stage → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Farhat Iqbal
+
+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.

package/README.md

@@ -1,3 +1,158 @@
-# Temporary Holding Version
+<p align="center">
+  <img src="assets/logo.png" alt="cc-agy logo" width="140" />
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# cc-agy
+
+> Decoupled Asymmetric Compute Gateway: Claude Code + Google Antigravity  
+> Run the Anthropic Claude Code agentic loop powered by Google Cloud Code TPU clusters (Gemini 3.8 Flash High Reasoning and Claude Sonnet 4.6) at zero marginal token cost.
+
+---
+
+## Architecture Overview
+
+`cc-agy` bridges the **Claude Code developer interface** with **Google Cloud Code Antigravity compute clusters** via a local, systemd-supervised reverse proxy (`OmniRoute`).
+
+```mermaid
+flowchart TD
+    subgraph Client["Developer Terminal"]
+        CLI["cc-agy CLI Wrapper (Self-Healing)"]
+        CC["Claude Code CLI (claude)"]
+        CLI --> CC
+    end
+
+    subgraph LocalGateway["Localhost Reverse Proxy Gateway (:20128)"]
+        SD["systemd User Service (omniroute.service)"]
+        OR["OmniRoute Protocol Engine"]
+        SQL[("SQLite: claude-auto Priority Cascade<br/>compatFilterFailOpen: true")]
+        TOK["AES-256-GCM Encrypted Token Cache"]
+    end
+
+    subgraph Upstream["Google Cloud Infrastructure (TPU v5p Clusters)"]
+        GCC["daily-cloudcode-pa.googleapis.com"]
+        M1["Tier 1: Gemini 3.8 Flash High (Extended Thinking)"]
+        M2["Tier 2: Claude Sonnet 4.6 (Thinking)"]
+        M3["Tier 3: Gemini 3.1 Flash Lite (Circuit Breaker Fallback)"]
+    end
+
+    CC -->|"Anthropic Messages API v1"| OR
+    SD -->|"Supervises (Restart=always)"| OR
+    OR <--> SQL
+    OR <--> TOK
+    OR -->|"Internal CodeAssist RPC + OAuth"| GCC
+    GCC --> M1
+    M1 -.->|"Quota Exceeded"| M2
+    M2 -.->|"Fallback"| M3
+    GCC -->|"Streamed SSE Token Output"| OR
+    OR -->|"Anthropic SSE Stream"| CC
+```
+
+---
+
+## Technical Problem Register
+
+| Runtime Issue | Standard Failure | cc-agy Production Solution |
+| :--- | :--- | :--- |
+| **API Cost** | Claude Code on Anthropic API costs $15 to $50 daily | Routes through local reverse proxy into authorized Google Antigravity quota at $0 marginal cost. |
+| **Schema Rejection** | 400 error: target combo lacks structured output support | Patches SQLite combo with `compatFilterFailOpen: true` to forward tool definitions cleanly. |
+| **Outage / Reboot Loss** | Terminal-run proxies terminate on logout or reboot | Deploys a hardened `systemd --user` service with `Restart=always` and sub-3s auto-resurrect. |
+| **Token Expiration** | Google OAuth tokens expire after 60 minutes | Rotates tokens automatically using the encrypted refresh token stored in local SQLite. |
+| **Model Degradation** | Default proxy configurations route to Flash Lite | Enforces priority cascade with Gemini 3.8 Flash High Reasoning as primary target. |
+| **Native Binary Bug** | Error: claude native binary not installed post-update | `cc-agy` wrapper runs pre-flight ABI checks and links missing native ELF binaries automatically. |
+
+---
+
+## Quick Start
+
+### Prerequisites
+1. **Linux** (Arch Linux, Ubuntu, Debian, Fedora) with `systemd`, `node` (>=18), `npm`, and `python3`.
+2. **Google Antigravity CLI (`agy`)**: Authenticated with your Google account:
+   ```bash
+   agy
+   ```
+   *(Verify that `~/.gemini/antigravity-cli/antigravity-oauth-token` exists).*
+
+### 1-Line Remote Bootstrap (Active & Recommended)
+```bash
+curl -fsSL https://raw.githubusercontent.com/farhatkoka/cc-agy/main/install.sh | bash
+```
+
+### NPX One-Liner (npm Registry)
+```bash
+npx cc-agy
+```
+*(Note: Direct bootstrap via `curl | bash` is live and verified. The global npm package namespace goes public on October 30, 2026 at 11:42 UTC upon conclusion of the npm registry 72-hour 2FA cooldown window).*
+
+### Alternative: Manual Git Clone
+```bash
+git clone https://github.com/farhatkoka/cc-agy.git
+cd cc-agy
+./install.sh
+```
+
+The bootstrap installer handles setup automatically:
+1. Validates host dependencies and Google OAuth tokens.
+2. Verifies Claude Code and restores platform-native Linux binaries.
+3. Encrypts local Google tokens into OmniRoute SQLite using AES-256-GCM.
+4. Patches model cascade priority and enables fail-open schema filtering.
+5. Deploys and starts the `omniroute.service` systemd user daemon.
+6. Installs the self-healing `cc-agy` CLI binary to `~/.local/bin/cc-agy`.
+
+---
+
+## CLI Usage
+
+Once installed, execute `cc-agy` from any terminal session:
+
+```bash
+# Launch interactive Claude Code session
+cc-agy
+
+# Autonomous execution (bypasses permission prompts)
+cc-agy --dangerously-skip-permissions
+
+# Non-interactive / pipe execution
+cc-agy -p "Scan src/ for potential race conditions"
+
+# System diagnostics and telemetry
+cc-agy doctor
+
+# Restart local proxy gateway
+cc-agy restart
+```
+
+---
+
+## Model Routing Hierarchy
+
+The `claude-auto` combo routes requests through this hierarchy:
+
+1. **Tier 1 (Primary):** `agy/gemini-3.8-flash-high`  
+   *3.7s to 4.9s latency, extended thinking, 1M token context window.*
+2. **Tier 2 (Fallback):** `agy/claude-sonnet-4-6`  
+   *Anthropic agentic model hosted on Google TPU backend.*
+3. **Tier 3 (Circuit Breaker):** `agy/gemini-3.1-flash-lite`  
+   *Sub-second fallback preventing session interruption during upstream rate windows.*
+
+---
+
+## Security Architecture
+
+- **Zero Credential Persistence:** The repository contains executable code only. No tokens, passwords, or personal credentials exist in the codebase.
+- **Client-Side Encryption:** Credentials are encrypted on the local host using AES-256-GCM. Storage encryption keys are generated randomly per machine (`secrets.token_hex(32)`) and stored in `~/.omniroute/.env`.
+- **Localhost Loopback Only:** OmniRoute binds strictly to `127.0.0.1:20128`. No inbound external network connections are accepted.
+
+---
+
+## Uninstallation
+
+To restore original Claude Code settings, disable the systemd daemon, and remove binaries:
+```bash
+./uninstall.sh
+```
+
+---
+
+## License
+
+MIT (c) Farhat Iqbal

package/assets/kit/cc-agy-app-icon.svg

@@ -0,0 +1,45 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="100%" height="100%">
+  <defs>
+    <!-- Claude Code Amber / Terracotta Gradient -->
+    <linearGradient id="claudeAmber" x1="0%" y1="100%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#D97706" />
+      <stop offset="100%" stop-color="#F59E0B" />
+    </linearGradient>
+
+    <!-- Antigravity TPU Cyan Gradient -->
+    <linearGradient id="agyCyan" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#00F0FF" />
+      <stop offset="100%" stop-color="#0284C7" />
+    </linearGradient>
+
+    <!-- Subtle Premium Glow -->
+    <filter id="softGlow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="8" result="blur" />
+      <feMerge>
+        <feMergeNode in="blur" opacity="0.3" />
+        <feMergeNode in="SourceGraphic" />
+      </feMerge>
+    </filter>
+  </defs>
+
+  <!-- PURE TRANSPARENT BACKGROUND -->
+
+  <!-- Perfectly Centered Scaled Encircled Mark -->
+  <g transform="translate(256, 256) scale(1.6) translate(-248, -256)" filter="url(#softGlow)">
+    <!-- Claude Code CLI Prompt Chevron -->
+    <path d="M 148 180 
+             L 236 256 
+             L 148 332 
+             L 180 360 
+             L 296 256 
+             L 180 152 Z" 
+          fill="url(#claudeAmber)" />
+
+    <!-- Antigravity Acceleration Node -->
+    <polygon points="268,256 348,188 348,324" 
+             fill="url(#agyCyan)" />
+
+    <!-- Center Zero-Cost Nexus Flare -->
+    <circle cx="256" cy="256" r="10" fill="#FFFFFF" />
+  </g>
+</svg>

package/assets/kit/cc-agy-black.svg

@@ -0,0 +1,11 @@
+<svg fill="#000000" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" width="100%" height="100%"><title>cc-agy Logo</title>
+  
+  <!-- Concept 3: Escape Velocity Delta (60 degree equilateral geometry) -->
+  <g fill="#000000" fill-rule="evenodd">
+    <!-- Outer Delta Frame with exact 60-degree angles -->
+    <path d="M 128 45.72 L 224 212 L 176 212 L 128 128.86 L 80 212 L 32 212 Z
+             M 128 85 L 152 126.57 L 104 126.57 Z" />
+    <!-- Dynamic Forward Agent Vector -->
+    <polygon points="108,180 156,180 172,164 156,148 108,148 124,164" />
+  </g>
+</svg>

package/assets/kit/cc-agy-favicon.svg

@@ -0,0 +1,45 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="100%" height="100%">
+  <defs>
+    <!-- Claude Code Amber / Terracotta Gradient -->
+    <linearGradient id="claudeAmber" x1="0%" y1="100%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#D97706" />
+      <stop offset="100%" stop-color="#F59E0B" />
+    </linearGradient>
+
+    <!-- Antigravity TPU Cyan Gradient -->
+    <linearGradient id="agyCyan" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#00F0FF" />
+      <stop offset="100%" stop-color="#0284C7" />
+    </linearGradient>
+
+    <!-- Subtle Premium Glow -->
+    <filter id="softGlow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="8" result="blur" />
+      <feMerge>
+        <feMergeNode in="blur" opacity="0.3" />
+        <feMergeNode in="SourceGraphic" />
+      </feMerge>
+    </filter>
+  </defs>
+
+  <!-- PURE TRANSPARENT BACKGROUND -->
+
+  <!-- Perfectly Centered Scaled Encircled Mark -->
+  <g transform="translate(256, 256) scale(1.6) translate(-248, -256)" filter="url(#softGlow)">
+    <!-- Claude Code CLI Prompt Chevron -->
+    <path d="M 148 180 
+             L 236 256 
+             L 148 332 
+             L 180 360 
+             L 296 256 
+             L 180 152 Z" 
+          fill="url(#claudeAmber)" />
+
+    <!-- Antigravity Acceleration Node -->
+    <polygon points="268,256 348,188 348,324" 
+             fill="url(#agyCyan)" />
+
+    <!-- Center Zero-Cost Nexus Flare -->
+    <circle cx="256" cy="256" r="10" fill="#FFFFFF" />
+  </g>
+</svg>

package/assets/kit/cc-agy-mono-38bdf8.svg

@@ -0,0 +1,11 @@
+<svg fill="#38bdf8" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" width="100%" height="100%"><title>cc-agy Logo</title>
+  
+  <!-- Concept 3: Escape Velocity Delta (60 degree equilateral geometry) -->
+  <g fill="#38bdf8" fill-rule="evenodd">
+    <!-- Outer Delta Frame with exact 60-degree angles -->
+    <path d="M 128 45.72 L 224 212 L 176 212 L 128 128.86 L 80 212 L 32 212 Z
+             M 128 85 L 152 126.57 L 104 126.57 Z" />
+    <!-- Dynamic Forward Agent Vector -->
+    <polygon points="108,180 156,180 172,164 156,148 108,148 124,164" />
+  </g>
+</svg>

package/assets/kit/cc-agy-square.svg

@@ -0,0 +1,45 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="100%" height="100%">
+  <defs>
+    <!-- Claude Code Amber / Terracotta Gradient -->
+    <linearGradient id="claudeAmber" x1="0%" y1="100%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#D97706" />
+      <stop offset="100%" stop-color="#F59E0B" />
+    </linearGradient>
+
+    <!-- Antigravity TPU Cyan Gradient -->
+    <linearGradient id="agyCyan" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#00F0FF" />
+      <stop offset="100%" stop-color="#0284C7" />
+    </linearGradient>
+
+    <!-- Subtle Premium Glow -->
+    <filter id="softGlow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="8" result="blur" />
+      <feMerge>
+        <feMergeNode in="blur" opacity="0.3" />
+        <feMergeNode in="SourceGraphic" />
+      </feMerge>
+    </filter>
+  </defs>
+
+  <!-- PURE TRANSPARENT BACKGROUND -->
+
+  <!-- Perfectly Centered Scaled Encircled Mark -->
+  <g transform="translate(256, 256) scale(1.6) translate(-248, -256)" filter="url(#softGlow)">
+    <!-- Claude Code CLI Prompt Chevron -->
+    <path d="M 148 180 
+             L 236 256 
+             L 148 332 
+             L 180 360 
+             L 296 256 
+             L 180 152 Z" 
+          fill="url(#claudeAmber)" />
+
+    <!-- Antigravity Acceleration Node -->
+    <polygon points="268,256 348,188 348,324" 
+             fill="url(#agyCyan)" />
+
+    <!-- Center Zero-Cost Nexus Flare -->
+    <circle cx="256" cy="256" r="10" fill="#FFFFFF" />
+  </g>
+</svg>

package/assets/kit/cc-agy-white.svg

@@ -0,0 +1,11 @@
+<svg fill="#ffffff" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" width="100%" height="100%"><title>cc-agy Logo</title>
+  
+  <!-- Concept 3: Escape Velocity Delta (60 degree equilateral geometry) -->
+  <g fill="#ffffff" fill-rule="evenodd">
+    <!-- Outer Delta Frame with exact 60-degree angles -->
+    <path d="M 128 45.72 L 224 212 L 176 212 L 128 128.86 L 80 212 L 32 212 Z
+             M 128 85 L 152 126.57 L 104 126.57 Z" />
+    <!-- Dynamic Forward Agent Vector -->
+    <polygon points="108,180 156,180 172,164 156,148 108,148 124,164" />
+  </g>
+</svg>

package/assets/kit/favicon.svg

@@ -0,0 +1,45 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="100%" height="100%">
+  <defs>
+    <!-- Claude Code Amber / Terracotta Gradient -->
+    <linearGradient id="claudeAmber" x1="0%" y1="100%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#D97706" />
+      <stop offset="100%" stop-color="#F59E0B" />
+    </linearGradient>
+
+    <!-- Antigravity TPU Cyan Gradient -->
+    <linearGradient id="agyCyan" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#00F0FF" />
+      <stop offset="100%" stop-color="#0284C7" />
+    </linearGradient>
+
+    <!-- Subtle Premium Glow -->
+    <filter id="softGlow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="8" result="blur" />
+      <feMerge>
+        <feMergeNode in="blur" opacity="0.3" />
+        <feMergeNode in="SourceGraphic" />
+      </feMerge>
+    </filter>
+  </defs>
+
+  <!-- PURE TRANSPARENT BACKGROUND -->
+
+  <!-- Perfectly Centered Scaled Encircled Mark -->
+  <g transform="translate(256, 256) scale(1.6) translate(-248, -256)" filter="url(#softGlow)">
+    <!-- Claude Code CLI Prompt Chevron -->
+    <path d="M 148 180 
+             L 236 256 
+             L 148 332 
+             L 180 360 
+             L 296 256 
+             L 180 152 Z" 
+          fill="url(#claudeAmber)" />
+
+    <!-- Antigravity Acceleration Node -->
+    <polygon points="268,256 348,188 348,324" 
+             fill="url(#agyCyan)" />
+
+    <!-- Center Zero-Cost Nexus Flare -->
+    <circle cx="256" cy="256" r="10" fill="#FFFFFF" />
+  </g>
+</svg>

package/assets/kit/head-snippet.html

@@ -0,0 +1,5 @@
+<link rel="icon" href="/favicon.ico" sizes="48x48">
+<link rel="icon" href="/favicon.svg" type="image/svg+xml">
+<link rel="apple-touch-icon" href="/apple-touch-icon.png">
+<link rel="manifest" href="/site.webmanifest">
+<meta name="theme-color" content="#090D16">

package/assets/kit/site.webmanifest

@@ -0,0 +1,24 @@
+{
+  "name": "cc-agy Logo",
+  "icons": [
+    {
+      "src": "/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    },
+    {
+      "src": "/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    },
+    {
+      "src": "/maskable-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "maskable"
+    }
+  ],
+  "theme_color": "#090D16",
+  "background_color": "#090D16",
+  "display": "standalone"
+}

package/assets/logo.svg

@@ -0,0 +1,45 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="100%" height="100%">
+  <defs>
+    <!-- Claude Code Amber / Terracotta Gradient -->
+    <linearGradient id="claudeAmber" x1="0%" y1="100%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#D97706" />
+      <stop offset="100%" stop-color="#F59E0B" />
+    </linearGradient>
+
+    <!-- Antigravity TPU Cyan Gradient -->
+    <linearGradient id="agyCyan" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#00F0FF" />
+      <stop offset="100%" stop-color="#0284C7" />
+    </linearGradient>
+
+    <!-- Subtle Premium Glow -->
+    <filter id="softGlow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="8" result="blur" />
+      <feMerge>
+        <feMergeNode in="blur" opacity="0.3" />
+        <feMergeNode in="SourceGraphic" />
+      </feMerge>
+    </filter>
+  </defs>
+
+  <!-- PURE TRANSPARENT BACKGROUND -->
+
+  <!-- Perfectly Centered Scaled Encircled Mark -->
+  <g transform="translate(256, 256) scale(1.6) translate(-248, -256)" filter="url(#softGlow)">
+    <!-- Claude Code CLI Prompt Chevron -->
+    <path d="M 148 180 
+             L 236 256 
+             L 148 332 
+             L 180 360 
+             L 296 256 
+             L 180 152 Z" 
+          fill="url(#claudeAmber)" />
+
+    <!-- Antigravity Acceleration Node -->
+    <polygon points="268,256 348,188 348,324" 
+             fill="url(#agyCyan)" />
+
+    <!-- Center Zero-Cost Nexus Flare -->
+    <circle cx="256" cy="256" r="10" fill="#FFFFFF" />
+  </g>
+</svg>