repoburg 1.3.22 → 1.3.24

package/backend/packages/gemini-core/CODEMAP.md

@@ -0,0 +1,30 @@
+# Gemini Core Codemap
+
+A robust, standalone wrapper for Google Gemini and Code Assist APIs, handling the complexities of OAuth2, streaming, and token management.
+
+## 🚀 Overview
+This package encapsulates the logic for communicating with Google's LLM infrastructure, providing a clean interface for the rest of the Repoburg backend.
+
+## ✨ Key Components (`src/`)
+
+### Core AI Logic (`core/`)
+- `contentGenerator.ts`: Low-level generator for model responses.
+- `geminiChat.ts`: Manages multi-turn conversation state.
+- `geminiRequest.ts`: Orchestrates the raw HTTP/gRPC requests to Gemini.
+- `tokenLimits.ts`: Logic for calculating and enforcing model context windows.
+
+### Code Assist & Auth (`code_assist/`)
+- `oauth2.ts` & `server.ts`: Handles the OAuth2 flow for Google Cloud credentials.
+- `oauth-credential-storage.ts`: Secure storage interface for persistent tokens.
+- `codeAssist.ts`: Specialized logic for Google's Enterprise Code Assist features.
+
+### Configuration (`config/`)
+- `models.ts`: Registry of supported Gemini model IDs (Flash, Pro, Lite).
+- `storage.ts`: Abstract and concrete implementations for storing session and auth data.
+
+### Utilities (`utils/`)
+- `quotaErrorDetection.ts`: Detects and parses specific Google API quota failures.
+- `retry.ts`: Implementation of exponential backoff for transient failures.
+
+## 🛠 Usage
+The package is exported via `index.ts`, exposing the `ContentGenerator` and model constants. It is primarily consumed by the `InteractiveChatModule` in the NestJS backend.

package/backend/packages/tokenpatch/CODEMAP.md

@@ -0,0 +1,25 @@
+# Tokenpatch Codemap
+
+An intelligent, token-based patching library that applies code snippets using fuzzy prefix/suffix matching instead of rigid character offsets or line numbers.
+
+## 🚀 Overview
+Tokenpatch solves the "fragile diff" problem. By tokenizing both the source and the patch, it can locate the intended change location even if the surrounding code has shifted slightly, provided the unique "anchors" are still present.
+
+## ✨ Key Components
+- `index.ts`: The main entry point. Exports `applySnippetPatch`.
+- `patcher.ts`: The core logic for standard patches, as well as edge-case handlers (`// @begin-of-file`, `// @end-of-file`).
+- `parser.ts`: Manages the loading and initialization of Tree-sitter WASM grammars.
+- `tokenizer.interface.ts`: Defines the common interface for different tokenization approaches.
+
+### Tokenization Strategies (`strategies/`)
+- `tiktoken-tokenizer.ts`: Uses Byte Pair Encoding (BPE) via Tiktoken. Fast and language-agnostic.
+- `tree-sitter-tokenizer.ts`: Uses Tree-sitter for syntax-aware tokenization. More accurate for complex structural matching.
+
+## 🛠 Mechanics
+1. **Tokenize**: Source and Patch are converted into token streams.
+2. **Anchor Identification**: The patch snippet's start and end tokens act as search anchors.
+3. **Fuzzy Search**: The patcher searches the source stream for a unique match for these anchors.
+4. **Replacement**: The content between matched anchors in the source is replaced by the patch content.
+
+## 📦 Grammars
+WASM grammars for TypeScript and TSX are bundled in `grammar/` to support the Tree-sitter strategy.

package/daemon/CODEMAP.md

@@ -0,0 +1,23 @@
+# Repoburg Daemon Codemap
+
+A lightweight, persistent background process that acts as a process manager and authentication proxy for Repoburg `backend` instances. Built with Express.js and `pm2`.
+
+## 🚀 Key Concepts
+The daemon is the "control plane" for the local device. It manages the lifecycle of backend services and ensures that only authorized users can trigger actions on the local filesystem.
+
+## ✨ Key Components (`src/`)
+-   **`index.ts`**: Entry point. Initializes the Express server on port `9998`, sets up middleware, and starts the heartbeat/status services.
+-   **`serviceManager.ts`**: The core logic for interacting with `pm2` programmatically. It handles starting, stopping, and restarting backend instances for specific project paths.
+-   **`stateManager.ts`**: Handles persistence of managed services to `~/.repoburg/services.json`.
+-   **`auth/authManager.ts`**: Manages device-level authentication. Stores and validates the JWT received from the Repoburg website.
+-   **`api/`**: HTTP endpoints for management:
+    -   `services.ts`: CRUD operations and lifecycle control for backend instances.
+    -   `registry.ts`: Simple service discovery (e.g., getting the port of the currently active backend).
+    -   `auth.ts`: Endpoints for initiating and checking the status of device authorization.
+-   **`middleware/checkAuth.ts`**: Secures sensitive daemon endpoints by verifying the device's JWT.
+-   **`utils/get-port.ts`**: A robust utility for finding available ports in a specific range for new backends.
+
+## 🛠 Tech Stack
+-   **Framework**: Express.js
+-   **Process Management**: `pm2`
+-   **Storage**: Local JSON files (via `stateManager`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repoburg",
-  "version": "1.3.22",
+  "version": "1.3.24",
   "description": "A local AI-powered software developer assistant that runs on your own machine.",
   "author": "Celal Ertug",
   "license": "SEE LICENSE IN LICENSE",
@@ -45,6 +45,7 @@
     "@nestjs/platform-ws": "^10.3.10",
     "@nestjs/typeorm": "^10.0.0",
     "@nestjs/websockets": "^10.3.10",
+    "@openrouter/sdk": "^0.3.10",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/auto-instrumentations-node": "^0.48.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.52.0",

package/visual-editor-proxy/CODEMAP.md

@@ -0,0 +1,21 @@
+# Visual Editor Proxy Codemap
+
+A local proxy server that enables in-context component selection. It injects a selection script into a target application, allowing developers to "point and click" to send component context to Repoburg.
+
+## 🚀 Overview
+The proxy transparently forwards traffic to a running web app while intercepting HTML responses to inject the `repoburg-visual-editor.js` client script.
+
+## ✨ Key Components
+
+### Proxy Server (`src/`)
+- **`main.ts`**: Express server using `http-proxy-middleware`. It listens for `TARGET_URL` and `BACKEND_PORT` environment variables. It uses a `responseInterceptor` to inject the client script and configuration into any `text/html` response.
+
+### Selection Client (`client/src/`)
+- **`main.ts`**: Entry point for the injected script. Manages the "Selector Mode" state and global event listeners for hovering and clicking elements.
+- **`inspector.ts`**: Contains logic to find and traverse the **React Fiber tree** (`__reactFiber$`) starting from a DOM element. It extracts component names, props, and internal state while handling circular references and serialization.
+- **`ui.ts`**: Manages the injected DOM elements, including the floating "Repo" action button, the highlight overlay, and the prompt submission modal.
+
+## 🛠 Tech Stack
+- **Server**: Express.js + `http-proxy-middleware`
+- **Client**: Vanilla TypeScript (bundled via `esbuild`)
+- **Integration**: Deep integration with React internals via Fiber nodes.