codevf 1.0.0 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +30 -21
- package/README.md +7 -2
- package/bin/codevf-mcp.js +11 -0
- package/dist/commands/fix.d.ts +5 -1
- package/dist/commands/fix.d.ts.map +1 -1
- package/dist/commands/fix.js +170 -13
- package/dist/commands/fix.js.map +1 -1
- package/dist/commands/init.d.ts.map +1 -1
- package/dist/commands/init.js +72 -2
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/mcp-tools.d.ts +17 -0
- package/dist/commands/mcp-tools.d.ts.map +1 -0
- package/dist/commands/mcp-tools.js +237 -0
- package/dist/commands/mcp-tools.js.map +1 -0
- package/dist/commands/setup.d.ts +8 -0
- package/dist/commands/setup.d.ts.map +1 -0
- package/dist/commands/setup.js +250 -0
- package/dist/commands/setup.js.map +1 -0
- package/dist/commands/welcome.d.ts +9 -0
- package/dist/commands/welcome.d.ts.map +1 -0
- package/dist/commands/welcome.js +175 -0
- package/dist/commands/welcome.js.map +1 -0
- package/dist/index.js +263 -207
- package/dist/index.js.map +1 -1
- package/dist/lib/api/client.d.ts +28 -0
- package/dist/lib/api/client.d.ts.map +1 -0
- package/dist/lib/api/client.js +66 -0
- package/dist/lib/api/client.js.map +1 -0
- package/dist/lib/api/projects.d.ts +32 -0
- package/dist/lib/api/projects.d.ts.map +1 -0
- package/dist/lib/api/projects.js +61 -0
- package/dist/lib/api/projects.js.map +1 -0
- package/dist/lib/api/tasks.d.ts +36 -0
- package/dist/lib/api/tasks.d.ts.map +1 -0
- package/dist/lib/api/tasks.js +62 -0
- package/dist/lib/api/tasks.js.map +1 -0
- package/dist/lib/api/websocket.d.ts +50 -0
- package/dist/lib/api/websocket.d.ts.map +1 -0
- package/dist/lib/api/websocket.js +153 -0
- package/dist/lib/api/websocket.js.map +1 -0
- package/dist/lib/auth/oauth-flow.d.ts +37 -0
- package/dist/lib/auth/oauth-flow.d.ts.map +1 -0
- package/dist/lib/auth/oauth-flow.js +119 -0
- package/dist/lib/auth/oauth-flow.js.map +1 -0
- package/dist/lib/auth/token-manager.d.ts +26 -0
- package/dist/lib/auth/token-manager.d.ts.map +1 -0
- package/dist/lib/auth/token-manager.js +87 -0
- package/dist/lib/auth/token-manager.js.map +1 -0
- package/dist/lib/config/manager.d.ts +50 -0
- package/dist/lib/config/manager.d.ts.map +1 -0
- package/dist/lib/config/manager.js +84 -0
- package/dist/lib/config/manager.js.map +1 -0
- package/dist/lib/utils/errors.d.ts +28 -0
- package/dist/lib/utils/errors.d.ts.map +1 -0
- package/dist/lib/utils/errors.js +44 -0
- package/dist/lib/utils/errors.js.map +1 -0
- package/dist/lib/utils/logger.d.ts +20 -0
- package/dist/lib/utils/logger.d.ts.map +1 -0
- package/dist/lib/utils/logger.js +40 -0
- package/dist/lib/utils/logger.js.map +1 -0
- package/dist/mcp/index.d.ts +7 -0
- package/dist/mcp/index.d.ts.map +1 -0
- package/dist/mcp/index.js +160 -0
- package/dist/mcp/index.js.map +1 -0
- package/dist/mcp/tools/chat.d.ts +30 -0
- package/dist/mcp/tools/chat.d.ts.map +1 -0
- package/dist/mcp/tools/chat.js +82 -0
- package/dist/mcp/tools/chat.js.map +1 -0
- package/dist/mcp/tools/instant.d.ts +38 -0
- package/dist/mcp/tools/instant.d.ts.map +1 -0
- package/dist/mcp/tools/instant.js +106 -0
- package/dist/mcp/tools/instant.js.map +1 -0
- package/dist/modules/aiAgent.d.ts +75 -0
- package/dist/modules/aiAgent.d.ts.map +1 -0
- package/dist/modules/aiAgent.js +707 -0
- package/dist/modules/aiAgent.js.map +1 -0
- package/dist/modules/api.d.ts +7 -0
- package/dist/modules/api.d.ts.map +1 -1
- package/dist/modules/api.js +13 -4
- package/dist/modules/api.js.map +1 -1
- package/dist/modules/commandHandler.d.ts +40 -0
- package/dist/modules/commandHandler.d.ts.map +1 -0
- package/dist/modules/commandHandler.js +328 -0
- package/dist/modules/commandHandler.js.map +1 -0
- package/dist/modules/config.d.ts +2 -0
- package/dist/modules/config.d.ts.map +1 -1
- package/dist/modules/config.js +9 -0
- package/dist/modules/config.js.map +1 -1
- package/dist/modules/constants.d.ts +83 -0
- package/dist/modules/constants.d.ts.map +1 -0
- package/dist/modules/constants.js +75 -0
- package/dist/modules/constants.js.map +1 -0
- package/dist/modules/permissions.d.ts +14 -0
- package/dist/modules/permissions.d.ts.map +1 -1
- package/dist/modules/permissions.js +94 -0
- package/dist/modules/permissions.js.map +1 -1
- package/dist/modules/toolRegistry.d.ts +50 -0
- package/dist/modules/toolRegistry.d.ts.map +1 -0
- package/dist/modules/toolRegistry.js +114 -0
- package/dist/modules/toolRegistry.js.map +1 -0
- package/dist/modules/tunnel.d.ts +33 -0
- package/dist/modules/tunnel.d.ts.map +1 -0
- package/dist/modules/tunnel.js +79 -0
- package/dist/modules/tunnel.js.map +1 -0
- package/dist/modules/vibeHelper.d.ts +16 -0
- package/dist/modules/vibeHelper.d.ts.map +1 -0
- package/dist/modules/vibeHelper.js +38 -0
- package/dist/modules/vibeHelper.js.map +1 -0
- package/dist/modules/websocket.d.ts +9 -0
- package/dist/modules/websocket.d.ts.map +1 -1
- package/dist/modules/websocket.js +70 -0
- package/dist/modules/websocket.js.map +1 -1
- package/dist/tools/consultEngineer.d.ts +13 -0
- package/dist/tools/consultEngineer.d.ts.map +1 -0
- package/dist/tools/consultEngineer.js +161 -0
- package/dist/tools/consultEngineer.js.map +1 -0
- package/dist/tools/realtimeChat.d.ts +9 -0
- package/dist/tools/realtimeChat.d.ts.map +1 -0
- package/dist/tools/realtimeChat.js +101 -0
- package/dist/tools/realtimeChat.js.map +1 -0
- package/dist/types/index.d.ts +183 -0
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/index.js.map +1 -1
- package/dist/ui/InteractiveApp.d.ts +13 -0
- package/dist/ui/InteractiveApp.d.ts.map +1 -0
- package/dist/ui/InteractiveApp.js +84 -0
- package/dist/ui/InteractiveApp.js.map +1 -0
- package/dist/ui/InteractivePrompt.d.ts +53 -0
- package/dist/ui/InteractivePrompt.d.ts.map +1 -0
- package/dist/ui/InteractivePrompt.js +422 -0
- package/dist/ui/InteractivePrompt.js.map +1 -0
- package/dist/ui/LiveSession.d.ts +2 -0
- package/dist/ui/LiveSession.d.ts.map +1 -1
- package/dist/ui/LiveSession.js +461 -180
- package/dist/ui/LiveSession.js.map +1 -1
- package/dist/ui/PromptInput.d.ts +14 -0
- package/dist/ui/PromptInput.d.ts.map +1 -0
- package/dist/ui/PromptInput.js +206 -0
- package/dist/ui/PromptInput.js.map +1 -0
- package/dist/ui/SessionUI.d.ts +40 -0
- package/dist/ui/SessionUI.d.ts.map +1 -0
- package/dist/ui/SessionUI.js +218 -0
- package/dist/ui/SessionUI.js.map +1 -0
- package/dist/ui/input/Command.d.ts +22 -0
- package/dist/ui/input/Command.d.ts.map +1 -0
- package/dist/ui/input/Command.js +30 -0
- package/dist/ui/input/Command.js.map +1 -0
- package/dist/ui/input/CustomInput.d.ts +15 -0
- package/dist/ui/input/CustomInput.d.ts.map +1 -0
- package/dist/ui/input/CustomInput.js +182 -0
- package/dist/ui/input/CustomInput.js.map +1 -0
- package/dist/ui/input/handlers/handleCursor.d.ts +22 -0
- package/dist/ui/input/handlers/handleCursor.d.ts.map +1 -0
- package/dist/ui/input/handlers/handleCursor.js +53 -0
- package/dist/ui/input/handlers/handleCursor.js.map +1 -0
- package/dist/ui/input/handlers/handleEdit.d.ts +18 -0
- package/dist/ui/input/handlers/handleEdit.d.ts.map +1 -0
- package/dist/ui/input/handlers/handleEdit.js +55 -0
- package/dist/ui/input/handlers/handleEdit.js.map +1 -0
- package/dist/ui/input/handlers/handleHistory.d.ts +18 -0
- package/dist/ui/input/handlers/handleHistory.d.ts.map +1 -0
- package/dist/ui/input/handlers/handleHistory.js +85 -0
- package/dist/ui/input/handlers/handleHistory.js.map +1 -0
- package/dist/ui/input/handlers/handlePaste.d.ts +19 -0
- package/dist/ui/input/handlers/handlePaste.d.ts.map +1 -0
- package/dist/ui/input/handlers/handlePaste.js +49 -0
- package/dist/ui/input/handlers/handlePaste.js.map +1 -0
- package/dist/ui/input/handlers/handleSubmit.d.ts +18 -0
- package/dist/ui/input/handlers/handleSubmit.d.ts.map +1 -0
- package/dist/ui/input/handlers/handleSubmit.js +39 -0
- package/dist/ui/input/handlers/handleSubmit.js.map +1 -0
- package/dist/ui/input/helpers.d.ts +4 -0
- package/dist/ui/input/helpers.d.ts.map +1 -0
- package/dist/ui/input/helpers.js +13 -0
- package/dist/ui/input/helpers.js.map +1 -0
- package/dist/ui/input/keyMatchers.d.ts +14 -0
- package/dist/ui/input/keyMatchers.d.ts.map +1 -0
- package/dist/ui/input/keyMatchers.js +49 -0
- package/dist/ui/input/keyMatchers.js.map +1 -0
- package/dist/ui/input/types.d.ts +33 -0
- package/dist/ui/input/types.d.ts.map +1 -0
- package/dist/ui/input/types.js +2 -0
- package/dist/ui/input/types.js.map +1 -0
- package/dist/ui/promptWithModes.d.ts +12 -0
- package/dist/ui/promptWithModes.d.ts.map +1 -0
- package/dist/ui/promptWithModes.js +24 -0
- package/dist/ui/promptWithModes.js.map +1 -0
- package/dist/ui/renderPrompt.d.ts +12 -0
- package/dist/ui/renderPrompt.d.ts.map +1 -0
- package/dist/ui/renderPrompt.js +14 -0
- package/dist/ui/renderPrompt.js.map +1 -0
- package/dist/ui/simplePrompt.d.ts +7 -0
- package/dist/ui/simplePrompt.d.ts.map +1 -0
- package/dist/ui/simplePrompt.js +38 -0
- package/dist/ui/simplePrompt.js.map +1 -0
- package/dist/ui/spinner.d.ts +7 -0
- package/dist/ui/spinner.d.ts.map +1 -0
- package/dist/ui/spinner.js +13 -0
- package/dist/ui/spinner.js.map +1 -0
- package/package.json +36 -26
- package/ARCHITECTURE.md +0 -285
- package/BUILD_SUMMARY.md +0 -340
- package/QUICKSTART.md +0 -180
package/QUICKSTART.md
DELETED
|
@@ -1,180 +0,0 @@
|
|
|
1
|
-
# Quick Start Guide
|
|
2
|
-
|
|
3
|
-
Get up and running with CodeVF CLI in 5 minutes.
|
|
4
|
-
|
|
5
|
-
## Installation
|
|
6
|
-
|
|
7
|
-
### From NPM (when published)
|
|
8
|
-
```bash
|
|
9
|
-
npm install -g codevf-cli
|
|
10
|
-
```
|
|
11
|
-
|
|
12
|
-
### From Source
|
|
13
|
-
```bash
|
|
14
|
-
git clone https://github.com/codevf/cli.git
|
|
15
|
-
cd cli
|
|
16
|
-
npm install
|
|
17
|
-
npm run build
|
|
18
|
-
npm link
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
## Basic Usage
|
|
22
|
-
|
|
23
|
-
### 1. Login
|
|
24
|
-
```bash
|
|
25
|
-
codevf login
|
|
26
|
-
```
|
|
27
|
-
This will open your browser for OAuth authentication.
|
|
28
|
-
|
|
29
|
-
### 2. Initialize Your Project
|
|
30
|
-
```bash
|
|
31
|
-
cd /path/to/your/project
|
|
32
|
-
codevf init
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
You'll be asked:
|
|
36
|
-
- Project type (auto-detected)
|
|
37
|
-
- Test command
|
|
38
|
-
- Build command
|
|
39
|
-
- Allowed AI tools
|
|
40
|
-
- Whether to upload code snapshot
|
|
41
|
-
- Whether to allow engineer access to `codevf` branch
|
|
42
|
-
|
|
43
|
-
### 3. Start a Debug Session
|
|
44
|
-
```bash
|
|
45
|
-
codevf fix "Users can't login after OAuth update"
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
You'll be connected to a vetted engineer in real-time. The engineer can:
|
|
49
|
-
- Chat with you
|
|
50
|
-
- Request to run commands (requires your approval)
|
|
51
|
-
- Request to view files (requires your approval)
|
|
52
|
-
- Request screenshare (optional)
|
|
53
|
-
|
|
54
|
-
**Example session:**
|
|
55
|
-
```
|
|
56
|
-
┌─────────────────────────────────────────────┐
|
|
57
|
-
│ CodeVF Live Session │
|
|
58
|
-
│ Engineer: Maria (ex-Google) │
|
|
59
|
-
│ Billing: 1 credit used • Press CTRL+C │
|
|
60
|
-
├─────────────────────────────────────────────┤
|
|
61
|
-
│ [12:34] Maria: Hi! I see you're having │
|
|
62
|
-
│ authentication issues... │
|
|
63
|
-
│ │
|
|
64
|
-
│ [12:35] You: Yes, after the OAuth change │
|
|
65
|
-
│ │
|
|
66
|
-
│ [12:36] Maria: Let me check your auth flow │
|
|
67
|
-
│ │
|
|
68
|
-
│ ┌─────────────────────────────────────────┐ │
|
|
69
|
-
│ │ Engineer requests to run: npm test │ │
|
|
70
|
-
│ │ Allow? (y/n): │ │
|
|
71
|
-
│ └─────────────────────────────────────────┘ │
|
|
72
|
-
└─────────────────────────────────────────────┘
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
Press **CTRL+C** to end the session and rate the engineer.
|
|
76
|
-
|
|
77
|
-
### 4. Sync Your Changes
|
|
78
|
-
```bash
|
|
79
|
-
codevf sync
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
This syncs your latest commits with CodeVF so engineers can see your latest changes.
|
|
83
|
-
|
|
84
|
-
## Common Workflows
|
|
85
|
-
|
|
86
|
-
### Bug Fix Workflow
|
|
87
|
-
```bash
|
|
88
|
-
# 1. Work on your code
|
|
89
|
-
git add .
|
|
90
|
-
git commit -m "Attempted fix for auth bug"
|
|
91
|
-
|
|
92
|
-
# 2. Sync changes
|
|
93
|
-
codevf sync
|
|
94
|
-
|
|
95
|
-
# 3. Get help
|
|
96
|
-
codevf fix "Auth still failing on production"
|
|
97
|
-
|
|
98
|
-
# 4. Engineer helps debug in real-time
|
|
99
|
-
# 5. Rate the engineer when done
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
### New Feature Help
|
|
103
|
-
```bash
|
|
104
|
-
# 1. Start a session
|
|
105
|
-
codevf fix "Need to implement real-time notifications with WebSockets"
|
|
106
|
-
|
|
107
|
-
# 2. Engineer helps architect and implement
|
|
108
|
-
# 3. Sync your work as you go
|
|
109
|
-
codevf sync
|
|
110
|
-
```
|
|
111
|
-
|
|
112
|
-
## Security & Permissions
|
|
113
|
-
|
|
114
|
-
Every action an engineer takes requires your approval:
|
|
115
|
-
|
|
116
|
-
- **Commands**: Engineer sees output only if you approve
|
|
117
|
-
- **Files**: Engineer can only read files you share
|
|
118
|
-
- **Branch**: Engineers work in the `codevf` branch only
|
|
119
|
-
- **Code Upload**: Only if you opt-in during `init`
|
|
120
|
-
|
|
121
|
-
## Billing
|
|
122
|
-
|
|
123
|
-
- Billed per minute of active engineer time
|
|
124
|
-
- Credits displayed in real-time
|
|
125
|
-
- No charge for waiting time
|
|
126
|
-
- Rate engineer when done
|
|
127
|
-
|
|
128
|
-
## Configuration
|
|
129
|
-
|
|
130
|
-
### Project Config (`.codevf/config.json`)
|
|
131
|
-
```json
|
|
132
|
-
{
|
|
133
|
-
"projectId": "uuid",
|
|
134
|
-
"allowedTools": ["claude", "gemini"],
|
|
135
|
-
"testCommand": "npm test",
|
|
136
|
-
"buildCommand": "npm run build",
|
|
137
|
-
"repoUploaded": true,
|
|
138
|
-
"branchMode": "codevf",
|
|
139
|
-
"createdAt": "2025-11-30T...",
|
|
140
|
-
"version": "1"
|
|
141
|
-
}
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
### Auth Token (`~/.config/codevf/auth.json`)
|
|
145
|
-
- Stored securely with 0600 permissions
|
|
146
|
-
- Auto-refreshed when expired
|
|
147
|
-
- Never logged or exposed
|
|
148
|
-
|
|
149
|
-
## Troubleshooting
|
|
150
|
-
|
|
151
|
-
### "Not authenticated"
|
|
152
|
-
```bash
|
|
153
|
-
codevf login
|
|
154
|
-
```
|
|
155
|
-
|
|
156
|
-
### "No CodeVF project found"
|
|
157
|
-
```bash
|
|
158
|
-
codevf init
|
|
159
|
-
```
|
|
160
|
-
|
|
161
|
-
### "Not on codevf branch"
|
|
162
|
-
```bash
|
|
163
|
-
git checkout -b codevf
|
|
164
|
-
codevf sync
|
|
165
|
-
```
|
|
166
|
-
|
|
167
|
-
### Connection issues
|
|
168
|
-
Check your internet connection and firewall settings.
|
|
169
|
-
|
|
170
|
-
## Next Steps
|
|
171
|
-
|
|
172
|
-
- Read the [full documentation](https://docs.codevf.com)
|
|
173
|
-
- Join our [Discord community](https://discord.gg/codevf)
|
|
174
|
-
- Follow us on [Twitter](https://twitter.com/codevf)
|
|
175
|
-
|
|
176
|
-
## Support
|
|
177
|
-
|
|
178
|
-
- **Email**: support@codevf.com
|
|
179
|
-
- **Issues**: https://github.com/codevf/cli/issues
|
|
180
|
-
- **Docs**: https://docs.codevf.com
|