codevf 1.0.0

package/QUICKSTART.md

@@ -0,0 +1,180 @@
+# Quick Start Guide
+
+Get up and running with CodeVF CLI in 5 minutes.
+
+## Installation
+
+### From NPM (when published)
+```bash
+npm install -g codevf-cli
+```
+
+### From Source
+```bash
+git clone https://github.com/codevf/cli.git
+cd cli
+npm install
+npm run build
+npm link
+```
+
+## Basic Usage
+
+### 1. Login
+```bash
+codevf login
+```
+This will open your browser for OAuth authentication.
+
+### 2. Initialize Your Project
+```bash
+cd /path/to/your/project
+codevf init
+```
+
+You'll be asked:
+- Project type (auto-detected)
+- Test command
+- Build command
+- Allowed AI tools
+- Whether to upload code snapshot
+- Whether to allow engineer access to `codevf` branch
+
+### 3. Start a Debug Session
+```bash
+codevf fix "Users can't login after OAuth update"
+```
+
+You'll be connected to a vetted engineer in real-time. The engineer can:
+- Chat with you
+- Request to run commands (requires your approval)
+- Request to view files (requires your approval)
+- Request screenshare (optional)
+
+**Example session:**
+```
+┌─────────────────────────────────────────────┐
+│ CodeVF Live Session                         │
+│ Engineer: Maria (ex-Google)                 │
+│ Billing: 1 credit used • Press CTRL+C       │
+├─────────────────────────────────────────────┤
+│ [12:34] Maria: Hi! I see you're having      │
+│              authentication issues...       │
+│                                             │
+│ [12:35] You: Yes, after the OAuth change    │
+│                                             │
+│ [12:36] Maria: Let me check your auth flow  │
+│                                             │
+│ ┌─────────────────────────────────────────┐ │
+│ │ Engineer requests to run: npm test      │ │
+│ │ Allow? (y/n):                           │ │
+│ └─────────────────────────────────────────┘ │
+└─────────────────────────────────────────────┘
+```
+
+Press **CTRL+C** to end the session and rate the engineer.
+
+### 4. Sync Your Changes
+```bash
+codevf sync
+```
+
+This syncs your latest commits with CodeVF so engineers can see your latest changes.
+
+## Common Workflows
+
+### Bug Fix Workflow
+```bash
+# 1. Work on your code
+git add .
+git commit -m "Attempted fix for auth bug"
+
+# 2. Sync changes
+codevf sync
+
+# 3. Get help
+codevf fix "Auth still failing on production"
+
+# 4. Engineer helps debug in real-time
+# 5. Rate the engineer when done
+```
+
+### New Feature Help
+```bash
+# 1. Start a session
+codevf fix "Need to implement real-time notifications with WebSockets"
+
+# 2. Engineer helps architect and implement
+# 3. Sync your work as you go
+codevf sync
+```
+
+## Security & Permissions
+
+Every action an engineer takes requires your approval:
+
+- **Commands**: Engineer sees output only if you approve
+- **Files**: Engineer can only read files you share
+- **Branch**: Engineers work in the `codevf` branch only
+- **Code Upload**: Only if you opt-in during `init`
+
+## Billing
+
+- Billed per minute of active engineer time
+- Credits displayed in real-time
+- No charge for waiting time
+- Rate engineer when done
+
+## Configuration
+
+### Project Config (`.codevf/config.json`)
+```json
+{
+  "projectId": "uuid",
+  "allowedTools": ["claude", "gemini"],
+  "testCommand": "npm test",
+  "buildCommand": "npm run build",
+  "repoUploaded": true,
+  "branchMode": "codevf",
+  "createdAt": "2025-11-30T...",
+  "version": "1"
+}
+```
+
+### Auth Token (`~/.config/codevf/auth.json`)
+- Stored securely with 0600 permissions
+- Auto-refreshed when expired
+- Never logged or exposed
+
+## Troubleshooting
+
+### "Not authenticated"
+```bash
+codevf login
+```
+
+### "No CodeVF project found"
+```bash
+codevf init
+```
+
+### "Not on codevf branch"
+```bash
+git checkout -b codevf
+codevf sync
+```
+
+### Connection issues
+Check your internet connection and firewall settings.
+
+## Next Steps
+
+- Read the [full documentation](https://docs.codevf.com)
+- Join our [Discord community](https://discord.gg/codevf)
+- Follow us on [Twitter](https://twitter.com/codevf)
+
+## Support
+
+- **Email**: support@codevf.com
+- **Issues**: https://github.com/codevf/cli/issues
+- **Docs**: https://docs.codevf.com

package/README.md

@@ -0,0 +1,104 @@
+# CodeVF CLI
+
+Live debugging with vetted engineers, right from your terminal.
+
+## Installation
+
+```bash
+npm install -g codevf-cli
+```
+
+## Quick Start
+
+```bash
+# Authenticate
+codevf login
+
+# Initialize your project
+codevf init
+
+# Start a live debugging session (interactive)
+codevf
+
+# Or provide issue directly
+codevf fix "Users can't login after OAuth update"
+
+# Sync your code changes
+codevf sync
+```
+
+## Commands
+
+### `codevf login`
+Authenticate with CodeVF using OAuth.
+
+### `codevf logout`
+Clear local authentication.
+
+### `codevf init`
+Initialize CodeVF in your project. Sets up:
+- Project configuration
+- Test and build commands
+- AI tool preferences
+- Optional code upload for faster debugging
+
+### `codevf` or `codevf fix "<issue description>"`
+Start a live debugging session with a vetted engineer:
+- Just type `codevf` and you'll be prompted to describe your issue
+- Or use `codevf fix "issue"` to provide it directly
+- Real-time chat in your terminal
+- Engineer can request to run commands (with your approval)
+- Engineer can request to view files (with your approval)
+- Track credit usage in real-time
+- Rate the engineer when done
+
+### `codevf sync`
+Sync your local changes to the `codevf` branch for engineer access.
+
+## How It Works
+
+1. **You have a bug** - Start a session with `codevf fix "description"`
+2. **Get matched with an engineer** - Ex-FAANG engineers with expertise in your stack
+3. **Collaborate safely** - Engineer can only run commands and view files with your approval
+4. **Get it fixed** - Engineer works in real-time to solve your issue
+5. **Pay per minute** - Only pay for active debugging time
+
+## Security & Privacy
+
+- Engineers can only access your code with explicit permission
+- All commands require approval before execution
+- File access is granted on a per-file basis
+- All actions are logged and auditable
+- Engineers work in a restricted `codevf` Git branch
+- Your code is never stored without your consent
+
+## Configuration
+
+After running `codevf init`, configuration is stored in `.codevf/config.json`:
+
+```json
+{
+  "projectId": "uuid",
+  "allowedTools": ["claude", "gemini"],
+  "testCommand": "npm test",
+  "buildCommand": "npm run build",
+  "repoUploaded": true,
+  "branchMode": "codevf"
+}
+```
+
+## Requirements
+
+- Node.js 18 or higher
+- Git (for sync command)
+- Internet connection
+
+## Support
+
+- Documentation: https://docs.codevf.com
+- Issues: https://github.com/codevf/cli/issues
+- Email: support@codevf.com
+
+## License
+
+MIT

package/dist/commands/fix.d.ts

@@ -0,0 +1,2 @@
+export declare function fixCommand(issueDescription: string): Promise<void>;
+//# sourceMappingURL=fix.d.ts.map

package/dist/commands/fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.d.ts","sourceRoot":"","sources":["../../src/commands/fix.tsx"],"names":[],"mappings":"AAeA,wBAAsB,UAAU,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwIxE"}

package/dist/commands/fix.js

@@ -0,0 +1,118 @@
+import React from 'react';
+import { render } from 'ink';
+import ora from 'ora';
+import chalk from 'chalk';
+import prompts from 'prompts';
+import { AuthManager } from '../modules/auth.js';
+import { ConfigManager } from '../modules/config.js';
+import { ApiClient } from '../modules/api.js';
+import { WebSocketClient } from '../modules/websocket.js';
+import { PermissionManager } from '../modules/permissions.js';
+import { LiveSession } from '../ui/LiveSession.js';
+const DEFAULT_MAX_CREDITS = 240;
+export async function fixCommand(issueDescription) {
+    const authManager = new AuthManager();
+    const configManager = new ConfigManager();
+    console.log(chalk.bold.blue('\n🔧 CodeVF Fix Session\n'));
+    // Check authentication
+    if (!authManager.isAuthenticated()) {
+        console.log(chalk.red('Error: Not authenticated.'));
+        console.log(chalk.yellow('Please run: codevf login\n'));
+        process.exit(1);
+    }
+    // Check if project is initialized
+    if (!configManager.isInitialized()) {
+        console.log(chalk.red('Error: No CodeVF project found.'));
+        console.log(chalk.yellow('Please run: codevf init\n'));
+        process.exit(1);
+    }
+    const config = configManager.loadConfig();
+    // Validate issue description
+    if (!issueDescription || issueDescription.trim().length === 0) {
+        console.log(chalk.red('Error: Please provide an issue description.'));
+        console.log(chalk.yellow('Usage: codevf fix "your issue description"\n'));
+        process.exit(1);
+    }
+    const spinner = ora('Creating debug task...').start();
+    try {
+        const apiClient = new ApiClient(authManager);
+        // Create task
+        const createRequest = {
+            issueDescription: issueDescription.trim(),
+            projectId: config.projectId,
+            maxCredits: DEFAULT_MAX_CREDITS,
+        };
+        const { taskId, estimatedWaitTime, warning } = await apiClient.createTask(createRequest);
+        spinner.succeed(chalk.green('Task created'));
+        if (warning) {
+            console.log(chalk.yellow(`\n${warning}\n`));
+        }
+        if (estimatedWaitTime > 0) {
+            console.log(chalk.yellow(`\nEstimated wait time: ${Math.ceil(estimatedWaitTime / 60)} minutes`));
+            const { proceed } = await prompts({
+                type: 'confirm',
+                name: 'proceed',
+                message: 'Continue waiting?',
+                initial: true,
+            });
+            if (!proceed) {
+                console.log(chalk.dim('\nTask cancelled.\n'));
+                return;
+            }
+        }
+        // Connect WebSocket
+        spinner.start('Connecting to session...');
+        const wsUrl = apiClient.getWebSocketUrl(taskId, authManager.getAccessToken());
+        const wsClient = new WebSocketClient(wsUrl, authManager.getAccessToken());
+        await wsClient.connect();
+        spinner.succeed(chalk.green('Connected to session'));
+        // Clear console and render live session UI
+        console.clear();
+        const permissionManager = new PermissionManager();
+        const { unmount, waitUntilExit } = render(React.createElement(LiveSession, { taskId: taskId, wsClient: wsClient, apiClient: apiClient, permissionManager: permissionManager }));
+        let exiting = false;
+        // Handle CTRL+C
+        process.on('SIGINT', async () => {
+            if (exiting)
+                return;
+            exiting = true;
+            unmount();
+            console.log(chalk.yellow('\n\n👋 Ending session...'));
+            try {
+                await apiClient.endSession(taskId);
+                wsClient.disconnect();
+                // Ask for rating
+                console.log(chalk.bold('\n⭐ Rate this session\n'));
+                const { rating, feedback } = await prompts([
+                    {
+                        type: 'number',
+                        name: 'rating',
+                        message: 'Rate engineer (1-5):',
+                        min: 1,
+                        max: 5,
+                        initial: 5,
+                    },
+                    {
+                        type: 'text',
+                        name: 'feedback',
+                        message: 'Optional feedback:',
+                    },
+                ]);
+                if (rating) {
+                    await apiClient.rateEngineer(taskId, rating, feedback);
+                    console.log(chalk.green('\n✓ Thank you for your feedback!\n'));
+                }
+            }
+            catch (error) {
+                console.error(chalk.red('Failed to end session properly'));
+            }
+            process.exit(0);
+        });
+        await waitUntilExit();
+    }
+    catch (error) {
+        spinner.fail('Failed to start session');
+        throw error;
+    }
+}
+//# sourceMappingURL=fix.js.map

package/dist/commands/fix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.js","sourceRoot":"","sources":["../../src/commands/fix.tsx"],"names":[],"mappings":"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"}

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function initCommand(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AA8BA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAiRjD"}