vibelearn 0.1.1
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 +630 -0
- package/README.md +287 -0
- package/package.json +129 -0
- package/plugin/.claude-plugin/CLAUDE.md +4 -0
- package/plugin/.claude-plugin/plugin.json +23 -0
- package/plugin/.cli-installed +1 -0
- package/plugin/CLAUDE.md +6 -0
- package/plugin/hooks/CLAUDE.md +6 -0
- package/plugin/hooks/bugfixes-2026-01-10.md +92 -0
- package/plugin/hooks/hooks.json +79 -0
- package/plugin/modes/code--ar.json +24 -0
- package/plugin/modes/code--bn.json +24 -0
- package/plugin/modes/code--chill.json +8 -0
- package/plugin/modes/code--cs.json +24 -0
- package/plugin/modes/code--da.json +24 -0
- package/plugin/modes/code--de.json +24 -0
- package/plugin/modes/code--el.json +24 -0
- package/plugin/modes/code--es.json +24 -0
- package/plugin/modes/code--fi.json +24 -0
- package/plugin/modes/code--fr.json +24 -0
- package/plugin/modes/code--he.json +24 -0
- package/plugin/modes/code--hi.json +24 -0
- package/plugin/modes/code--hu.json +24 -0
- package/plugin/modes/code--id.json +24 -0
- package/plugin/modes/code--it.json +24 -0
- package/plugin/modes/code--ja.json +24 -0
- package/plugin/modes/code--ko.json +24 -0
- package/plugin/modes/code--nl.json +24 -0
- package/plugin/modes/code--no.json +24 -0
- package/plugin/modes/code--pl.json +24 -0
- package/plugin/modes/code--pt-br.json +24 -0
- package/plugin/modes/code--ro.json +24 -0
- package/plugin/modes/code--ru.json +24 -0
- package/plugin/modes/code--sv.json +24 -0
- package/plugin/modes/code--th.json +24 -0
- package/plugin/modes/code--tr.json +24 -0
- package/plugin/modes/code--uk.json +24 -0
- package/plugin/modes/code--ur.json +25 -0
- package/plugin/modes/code--vi.json +24 -0
- package/plugin/modes/code--zh.json +24 -0
- package/plugin/modes/code.json +125 -0
- package/plugin/modes/email-investigation.json +120 -0
- package/plugin/modes/law-study--chill.json +7 -0
- package/plugin/modes/law-study-CLAUDE.md +85 -0
- package/plugin/modes/law-study.json +120 -0
- package/plugin/package.json +23 -0
- package/plugin/scripts/CLAUDE.md +5 -0
- package/plugin/scripts/bun-runner.js +176 -0
- package/plugin/scripts/mcp-server.cjs +141 -0
- package/plugin/scripts/smart-install.js +592 -0
- package/plugin/scripts/statusline-counts.js +61 -0
- package/plugin/scripts/vl-cli.cjs +104 -0
- package/plugin/scripts/worker-cli.js +19 -0
- package/plugin/scripts/worker-service.cjs +1919 -0
- package/plugin/scripts/worker-wrapper.cjs +2 -0
- package/plugin/skills/smart-explore/SKILL.md +145 -0
- package/plugin/skills/timeline-report/SKILL.md +91 -0
package/README.md
ADDED
|
@@ -0,0 +1,287 @@
|
|
|
1
|
+
<h1 align="center">
|
|
2
|
+
<br>
|
|
3
|
+
<a href="https://vibelearn.dev">
|
|
4
|
+
<picture>
|
|
5
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/anergcorp/vibelearn/main/docs/public/vibelearn-logo-for-dark-mode.webp">
|
|
6
|
+
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/anergcorp/vibelearn/main/docs/public/vibelearn-logo-for-light-mode.webp">
|
|
7
|
+
<img src="https://raw.githubusercontent.com/anergcorp/vibelearn/main/docs/public/vibelearn-logo-for-light-mode.webp" alt="VibeLearn" width="400">
|
|
8
|
+
</picture>
|
|
9
|
+
</a>
|
|
10
|
+
<br>
|
|
11
|
+
</h1>
|
|
12
|
+
|
|
13
|
+
<h4 align="center">Learn from every session. Built for <a href="https://claude.com/claude-code" target="_blank">Claude Code</a>.</h4>
|
|
14
|
+
|
|
15
|
+
<p align="center">
|
|
16
|
+
<a href="LICENSE">
|
|
17
|
+
<img src="https://img.shields.io/badge/License-AGPL%203.0-blue.svg" alt="License">
|
|
18
|
+
</a>
|
|
19
|
+
<a href="package.json">
|
|
20
|
+
<img src="https://img.shields.io/badge/version-0.1.0-green.svg" alt="Version">
|
|
21
|
+
</a>
|
|
22
|
+
<a href="package.json">
|
|
23
|
+
<img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg" alt="Node">
|
|
24
|
+
</a>
|
|
25
|
+
</p>
|
|
26
|
+
|
|
27
|
+
<p align="center">
|
|
28
|
+
<a href="#quick-start">Quick Start</a> •
|
|
29
|
+
<a href="#how-it-works">How It Works</a> •
|
|
30
|
+
<a href="#vl-cli">VL CLI</a> •
|
|
31
|
+
<a href="#configuration">Configuration</a> •
|
|
32
|
+
<a href="#privacy">Privacy</a> •
|
|
33
|
+
<a href="#troubleshooting">Troubleshooting</a>
|
|
34
|
+
</p>
|
|
35
|
+
|
|
36
|
+
<p align="center">
|
|
37
|
+
VibeLearn is a Claude Code plugin that silently watches what you build, extracts the concepts you encounter, and turns them into quiz questions — so you actually retain what you learn while coding.
|
|
38
|
+
</p>
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
## What It Does
|
|
43
|
+
|
|
44
|
+
Every time you end a Claude Code session, VibeLearn automatically:
|
|
45
|
+
|
|
46
|
+
1. **Detects your tech stack** — reads `package.json`, `pyproject.toml`, `go.mod`, etc.
|
|
47
|
+
2. **Analyzes your code changes** — identifies patterns: custom hooks, API routes, TypeScript types, design patterns
|
|
48
|
+
3. **Extracts learning concepts** — a single LLM call produces a session summary and a list of concepts you encountered
|
|
49
|
+
4. **Generates quiz questions** — a second LLM call creates targeted questions per concept across 7 formats: `multiple_choice`, `code_reading`, `spot_the_bug`, `fill_in_blank`, `open_ended`, `true_false`, and `ordering` — selected based on concept difficulty (junior / mid / senior)
|
|
50
|
+
5. **Syncs to vibelearn.dev** — your learning profile is stored securely (optional, requires `vl login`)
|
|
51
|
+
|
|
52
|
+
Then run `vl quiz` to review what you learned.
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## Quick Start
|
|
57
|
+
|
|
58
|
+
Install the plugin in a Claude Code session:
|
|
59
|
+
|
|
60
|
+
```
|
|
61
|
+
/plugin marketplace add anergcorp/vibelearn
|
|
62
|
+
/plugin install vibelearn
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Restart Claude Code. VibeLearn will start capturing learning data automatically from your next session.
|
|
66
|
+
|
|
67
|
+
**Optional — connect to vibelearn.dev:**
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
vl login <your-api-key>
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Get your API key at [vibelearn.dev](https://vibelearn.dev).
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## vl CLI
|
|
78
|
+
|
|
79
|
+
The `vl` command lets you review and interact with your learning data:
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
vl quiz # Interactive quiz — all pending questions
|
|
83
|
+
vl quiz --session # Quiz questions from the last session only
|
|
84
|
+
|
|
85
|
+
vl status # Sessions analyzed, top concept categories, mastery stats
|
|
86
|
+
vl gaps # Concepts you haven't mastered yet (mastery < 50%)
|
|
87
|
+
|
|
88
|
+
vl login <api-key> # Connect to vibelearn.dev
|
|
89
|
+
vl login --status # Check login status
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
**Example session:**
|
|
93
|
+
|
|
94
|
+
```
|
|
95
|
+
$ vl quiz
|
|
96
|
+
|
|
97
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
98
|
+
VibeLearn Quiz — 3 questions
|
|
99
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
100
|
+
|
|
101
|
+
Q1/3 (intermediate) [React Server Actions]
|
|
102
|
+
|
|
103
|
+
Code:
|
|
104
|
+
'use server'
|
|
105
|
+
export async function createPost(data: FormData) { ... }
|
|
106
|
+
|
|
107
|
+
What does the 'use server' directive tell Next.js?
|
|
108
|
+
|
|
109
|
+
A) Run this function in a Web Worker
|
|
110
|
+
B) Execute this function on the server, not the client
|
|
111
|
+
C) Cache the function result server-side
|
|
112
|
+
D) Mark the function as async-only
|
|
113
|
+
|
|
114
|
+
Your answer (A/B/C/D): B
|
|
115
|
+
|
|
116
|
+
✓ Correct!
|
|
117
|
+
|
|
118
|
+
Explanation: 'use server' creates a Server Action — a function that
|
|
119
|
+
runs exclusively on the server. The client receives only the result.
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
### Adaptive Difficulty
|
|
123
|
+
|
|
124
|
+
VibeLearn tracks your mastery per concept and adjusts difficulty automatically:
|
|
125
|
+
|
|
126
|
+
- **3 correct in a row** → promoted to the next level (junior → mid → senior)
|
|
127
|
+
- **1 wrong answer** → dropped back a level
|
|
128
|
+
- **Follow-up questions** are inserted mid-quiz when you nail a junior question, to probe deeper understanding
|
|
129
|
+
- **Open-ended answers** at senior level are evaluated by a 5-dimension rubric (accuracy, depth, trade-offs, practical reasoning, completeness)
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## How It Works
|
|
134
|
+
|
|
135
|
+
### 5 Lifecycle Hooks
|
|
136
|
+
|
|
137
|
+
```
|
|
138
|
+
SessionStart → Worker starts, session initialized
|
|
139
|
+
UserPromptSubmit → Session linked to user prompt
|
|
140
|
+
PostToolUse → File edits/writes/bash commands captured
|
|
141
|
+
Stop (Summary) → 5-step analysis pipeline runs
|
|
142
|
+
SessionEnd → Session finalized
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
### Analysis Pipeline (runs at session end)
|
|
146
|
+
|
|
147
|
+
```
|
|
148
|
+
1. StackDetector — reads package.json/config files → vl_stack_profiles
|
|
149
|
+
2. StaticAnalyzer — regex/AST patterns on code changes (hooks, routes, types…)
|
|
150
|
+
3. ConceptExtractor — LLM call → session summary + concept list → vl_concepts
|
|
151
|
+
4. QuizGenerator — LLM call → quiz questions per concept → vl_questions
|
|
152
|
+
5. UpstreamSync — HMAC-signed POST to api.vibelearn.dev (queued offline if unavailable)
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
### Worker Service
|
|
156
|
+
|
|
157
|
+
An Express HTTP server on port **37778**, managed by Bun. Hooks talk to it over localhost. It handles all database writes and the analysis pipeline.
|
|
158
|
+
|
|
159
|
+
### Database
|
|
160
|
+
|
|
161
|
+
SQLite at `~/.vibelearn/vibelearn.db`. Key tables:
|
|
162
|
+
|
|
163
|
+
| Table | Purpose |
|
|
164
|
+
|-------|---------|
|
|
165
|
+
| `vibelearn_session_summaries` | Human-readable session narratives |
|
|
166
|
+
| `vl_concepts` | Extracted concepts per session |
|
|
167
|
+
| `vl_questions` | Generated quiz questions |
|
|
168
|
+
| `vl_quiz_attempts` | Your answers (HMAC-signed before sync) |
|
|
169
|
+
| `vl_developer_profile` | Mastery score per concept |
|
|
170
|
+
| `vl_stack_profiles` | Detected tech stack per session |
|
|
171
|
+
| `vl_sync_queue` | Offline retry queue |
|
|
172
|
+
|
|
173
|
+
---
|
|
174
|
+
|
|
175
|
+
## Configuration
|
|
176
|
+
|
|
177
|
+
Settings are auto-created at `~/.vibelearn/settings.json` on first run.
|
|
178
|
+
|
|
179
|
+
**Key settings:**
|
|
180
|
+
|
|
181
|
+
```json
|
|
182
|
+
{
|
|
183
|
+
"VIBELEARN_WORKER_PORT": "37778",
|
|
184
|
+
"VIBELEARN_DATA_DIR": "~/.vibelearn",
|
|
185
|
+
"VIBELEARN_LOG_LEVEL": "INFO",
|
|
186
|
+
"VIBELEARN_PROVIDER": "claude",
|
|
187
|
+
"VIBELEARN_GEMINI_API_KEY": "",
|
|
188
|
+
"VIBELEARN_OPENROUTER_API_KEY": "",
|
|
189
|
+
"VIBELEARN_AUTO_SYNC": "true",
|
|
190
|
+
"VIBELEARN_EXCLUDED_PROJECTS": ""
|
|
191
|
+
}
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
**AI Provider for Analysis**
|
|
195
|
+
|
|
196
|
+
The analysis pipeline (concept extraction + quiz generation) uses your configured LLM provider. Priority order:
|
|
197
|
+
|
|
198
|
+
1. **Gemini** — set `VIBELEARN_GEMINI_API_KEY` (free tier available)
|
|
199
|
+
2. **OpenRouter** — set `VIBELEARN_OPENROUTER_API_KEY`
|
|
200
|
+
3. **Anthropic** — uses `ANTHROPIC_API_KEY` from environment (claude-haiku-4-5)
|
|
201
|
+
|
|
202
|
+
**Excluding projects:**
|
|
203
|
+
|
|
204
|
+
```json
|
|
205
|
+
{
|
|
206
|
+
"VIBELEARN_EXCLUDED_PROJECTS": "/path/to/skip,~/personal/*"
|
|
207
|
+
}
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
---
|
|
211
|
+
|
|
212
|
+
## Privacy
|
|
213
|
+
|
|
214
|
+
Wrap any content in `<private>` tags to prevent it from being stored or synced:
|
|
215
|
+
|
|
216
|
+
```
|
|
217
|
+
Please review <private>my-secret-api-key: sk-...</private> configuration
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
Everything inside `<private>` is stripped at the hook layer before reaching the worker or database.
|
|
221
|
+
|
|
222
|
+
**What is never stored:**
|
|
223
|
+
- Absolute file paths (only basenames are sent upstream)
|
|
224
|
+
- Raw file contents (only short snippets from the analysis)
|
|
225
|
+
- Full user prompts
|
|
226
|
+
|
|
227
|
+
**Anti-tamper:** Quiz attempt records are HMAC-signed with your API key before syncing. The server recomputes your streak from accepted attempt records — local SQLite data cannot be used to fake progress.
|
|
228
|
+
|
|
229
|
+
---
|
|
230
|
+
|
|
231
|
+
## System Requirements
|
|
232
|
+
|
|
233
|
+
- **Node.js**: 18.0.0 or higher
|
|
234
|
+
- **Claude Code**: Latest version with plugin support
|
|
235
|
+
- **Bun**: JavaScript runtime (auto-installed if missing)
|
|
236
|
+
|
|
237
|
+
---
|
|
238
|
+
|
|
239
|
+
## Windows Notes
|
|
240
|
+
|
|
241
|
+
If you see `npm : The term 'npm' is not recognized`:
|
|
242
|
+
|
|
243
|
+
Install [Node.js](https://nodejs.org) and restart your terminal. Bun is auto-installed by the plugin setup script.
|
|
244
|
+
|
|
245
|
+
---
|
|
246
|
+
|
|
247
|
+
## Build
|
|
248
|
+
|
|
249
|
+
```bash
|
|
250
|
+
npm install
|
|
251
|
+
npm run build-and-sync # Build + sync to marketplace + restart worker
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
Built outputs land in `plugin/scripts/`:
|
|
255
|
+
- `worker-service.cjs` — the worker daemon
|
|
256
|
+
- `mcp-server.cjs` — MCP tools
|
|
257
|
+
- `vl-cli.cjs` — the `vl` binary
|
|
258
|
+
|
|
259
|
+
---
|
|
260
|
+
|
|
261
|
+
## Contributing
|
|
262
|
+
|
|
263
|
+
1. Fork the repository
|
|
264
|
+
2. Create a feature branch
|
|
265
|
+
3. Make your changes with tests
|
|
266
|
+
4. Update documentation
|
|
267
|
+
5. Submit a Pull Request
|
|
268
|
+
|
|
269
|
+
---
|
|
270
|
+
|
|
271
|
+
## License
|
|
272
|
+
|
|
273
|
+
GNU Affero General Public License v3.0 (AGPL-3.0).
|
|
274
|
+
|
|
275
|
+
See the [LICENSE](LICENSE) file for full details.
|
|
276
|
+
|
|
277
|
+
---
|
|
278
|
+
|
|
279
|
+
## Support
|
|
280
|
+
|
|
281
|
+
- **Issues**: [GitHub Issues](https://github.com/anergcorp/vibelearn/issues)
|
|
282
|
+
- **Website**: [vibelearn.dev](https://vibelearn.dev)
|
|
283
|
+
- **Repository**: [github.com/anergcorp/vibelearn](https://github.com/anergcorp/vibelearn)
|
|
284
|
+
|
|
285
|
+
---
|
|
286
|
+
|
|
287
|
+
**Built with Claude Agent SDK** | **Powered by Claude Code** | **Made with TypeScript**
|
package/package.json
ADDED
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "vibelearn",
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "Developer learning tool — analyze coding sessions, extract concepts, generate quiz questions",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"claude",
|
|
7
|
+
"claude-code",
|
|
8
|
+
"learning",
|
|
9
|
+
"quiz",
|
|
10
|
+
"spaced-repetition",
|
|
11
|
+
"hooks",
|
|
12
|
+
"analysis",
|
|
13
|
+
"typescript",
|
|
14
|
+
"nodejs"
|
|
15
|
+
],
|
|
16
|
+
"author": "Ahun Atajanov",
|
|
17
|
+
"license": "AGPL-3.0",
|
|
18
|
+
"repository": {
|
|
19
|
+
"type": "git",
|
|
20
|
+
"url": "https://github.com/anergcorp/vibelearn.git"
|
|
21
|
+
},
|
|
22
|
+
"homepage": "https://vibelearn.dev",
|
|
23
|
+
"bugs": {
|
|
24
|
+
"url": "https://github.com/anergcorp/vibelearn/issues"
|
|
25
|
+
},
|
|
26
|
+
"type": "module",
|
|
27
|
+
"bin": {
|
|
28
|
+
"vl": "plugin/scripts/vl-cli.cjs"
|
|
29
|
+
},
|
|
30
|
+
"exports": {
|
|
31
|
+
".": {
|
|
32
|
+
"types": "./dist/index.d.ts",
|
|
33
|
+
"import": "./dist/index.js"
|
|
34
|
+
},
|
|
35
|
+
"./sdk": {
|
|
36
|
+
"types": "./dist/sdk/index.d.ts",
|
|
37
|
+
"import": "./dist/sdk/index.js"
|
|
38
|
+
},
|
|
39
|
+
"./modes/*": "./plugin/modes/*"
|
|
40
|
+
},
|
|
41
|
+
"files": [
|
|
42
|
+
"dist",
|
|
43
|
+
"plugin"
|
|
44
|
+
],
|
|
45
|
+
"engines": {
|
|
46
|
+
"node": ">=18.0.0",
|
|
47
|
+
"bun": ">=1.0.0"
|
|
48
|
+
},
|
|
49
|
+
"scripts": {
|
|
50
|
+
"dev": "npm run build-and-sync",
|
|
51
|
+
"build": "node scripts/build-hooks.js",
|
|
52
|
+
"build-and-sync": "npm run build && npm run sync-marketplace && sleep 1 && cd ~/.claude/plugins/marketplaces/vibelearn && npm run worker:restart",
|
|
53
|
+
"sync-marketplace": "node scripts/sync-marketplace.cjs",
|
|
54
|
+
"sync-marketplace:force": "node scripts/sync-marketplace.cjs --force",
|
|
55
|
+
"build:binaries": "node scripts/build-worker-binary.js",
|
|
56
|
+
"worker:logs": "tail -n 50 ~/.vibelearn/logs/worker-$(date +%Y-%m-%d).log",
|
|
57
|
+
"worker:tail": "tail -f 50 ~/.vibelearn/logs/worker-$(date +%Y-%m-%d).log",
|
|
58
|
+
"changelog:generate": "node scripts/generate-changelog.js",
|
|
59
|
+
"discord:notify": "node scripts/discord-release-notify.js",
|
|
60
|
+
"worker:start": "bun plugin/scripts/worker-service.cjs start",
|
|
61
|
+
"worker:stop": "bun plugin/scripts/worker-service.cjs stop",
|
|
62
|
+
"worker:restart": "bun plugin/scripts/worker-service.cjs restart",
|
|
63
|
+
"worker:status": "bun plugin/scripts/worker-service.cjs status",
|
|
64
|
+
"queue": "bun scripts/check-pending-queue.ts",
|
|
65
|
+
"queue:process": "bun scripts/check-pending-queue.ts --process",
|
|
66
|
+
"queue:clear": "bun scripts/clear-failed-queue.ts --all --force",
|
|
67
|
+
"claude-md:regenerate": "bun scripts/regenerate-claude-md.ts",
|
|
68
|
+
"claude-md:dry-run": "bun scripts/regenerate-claude-md.ts --dry-run",
|
|
69
|
+
"translate-readme": "bun scripts/translate-readme/cli.ts -v -o docs/i18n README.md",
|
|
70
|
+
"translate:tier1": "npm run translate-readme -- zh zh-tw ja pt-br ko es de fr",
|
|
71
|
+
"translate:tier2": "npm run translate-readme -- he ar ru pl cs nl tr uk",
|
|
72
|
+
"translate:tier3": "npm run translate-readme -- vi id th hi bn ro sv",
|
|
73
|
+
"translate:tier4": "npm run translate-readme -- it el hu fi da no",
|
|
74
|
+
"translate:all": "npm run translate:tier1 & npm run translate:tier2 & npm run translate:tier3 & npm run translate:tier4 & wait",
|
|
75
|
+
"bug-report": "npx tsx scripts/bug-report/cli.ts",
|
|
76
|
+
"cursor:install": "bun plugin/scripts/worker-service.cjs cursor install",
|
|
77
|
+
"cursor:uninstall": "bun plugin/scripts/worker-service.cjs cursor uninstall",
|
|
78
|
+
"cursor:status": "bun plugin/scripts/worker-service.cjs cursor status",
|
|
79
|
+
"cursor:setup": "bun plugin/scripts/worker-service.cjs cursor setup",
|
|
80
|
+
"test": "bun test",
|
|
81
|
+
"test:sqlite": "bun test tests/sqlite/",
|
|
82
|
+
"test:agents": "bun test tests/worker/agents/",
|
|
83
|
+
"test:search": "bun test tests/worker/search/",
|
|
84
|
+
"test:context": "bun test tests/context/",
|
|
85
|
+
"test:infra": "bun test tests/infrastructure/",
|
|
86
|
+
"test:server": "bun test tests/server/",
|
|
87
|
+
"prepublishOnly": "npm run build",
|
|
88
|
+
"release": "np",
|
|
89
|
+
"release:patch": "np patch --no-cleanup",
|
|
90
|
+
"release:minor": "np minor --no-cleanup",
|
|
91
|
+
"release:major": "np major --no-cleanup"
|
|
92
|
+
},
|
|
93
|
+
"np": {
|
|
94
|
+
"yarn": false,
|
|
95
|
+
"contents": ".",
|
|
96
|
+
"testScript": "test",
|
|
97
|
+
"2fa": false
|
|
98
|
+
},
|
|
99
|
+
"dependencies": {
|
|
100
|
+
"@anthropic-ai/claude-agent-sdk": "^0.1.76",
|
|
101
|
+
"@modelcontextprotocol/sdk": "^1.25.1",
|
|
102
|
+
"express": "^4.18.2",
|
|
103
|
+
"glob": "^11.0.3",
|
|
104
|
+
"yaml": "^2.8.2",
|
|
105
|
+
"zod-to-json-schema": "^3.24.6"
|
|
106
|
+
},
|
|
107
|
+
"devDependencies": {
|
|
108
|
+
"@types/cors": "^2.8.19",
|
|
109
|
+
"@types/express": "^4.17.21",
|
|
110
|
+
"@types/node": "^20.0.0",
|
|
111
|
+
"esbuild": "^0.27.2",
|
|
112
|
+
"np": "^11.0.2",
|
|
113
|
+
"tree-sitter-c": "^0.24.1",
|
|
114
|
+
"tree-sitter-cli": "^0.26.5",
|
|
115
|
+
"tree-sitter-cpp": "^0.23.4",
|
|
116
|
+
"tree-sitter-go": "^0.25.0",
|
|
117
|
+
"tree-sitter-java": "^0.23.5",
|
|
118
|
+
"tree-sitter-javascript": "^0.25.0",
|
|
119
|
+
"tree-sitter-python": "^0.25.0",
|
|
120
|
+
"tree-sitter-ruby": "^0.23.1",
|
|
121
|
+
"tree-sitter-rust": "^0.24.0",
|
|
122
|
+
"tree-sitter-typescript": "^0.23.2",
|
|
123
|
+
"tsx": "^4.20.6",
|
|
124
|
+
"typescript": "^5.3.0"
|
|
125
|
+
},
|
|
126
|
+
"optionalDependencies": {
|
|
127
|
+
"tree-kill": "^1.2.2"
|
|
128
|
+
}
|
|
129
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "vibelearn",
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "Learn from every coding session — automatically extracts concepts from your Claude Code sessions, generates adaptive quiz questions across 7 formats, and tracks mastery with spaced repetition.",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "Ahun Atajanov"
|
|
7
|
+
},
|
|
8
|
+
"repository": "https://github.com/anergcorp/vibelearn",
|
|
9
|
+
"license": "AGPL-3.0",
|
|
10
|
+
"keywords": [
|
|
11
|
+
"learning",
|
|
12
|
+
"quiz",
|
|
13
|
+
"spaced-repetition",
|
|
14
|
+
"adaptive",
|
|
15
|
+
"concept-extraction",
|
|
16
|
+
"code-analysis",
|
|
17
|
+
"mastery",
|
|
18
|
+
"hooks",
|
|
19
|
+
"education",
|
|
20
|
+
"claude",
|
|
21
|
+
"mcp"
|
|
22
|
+
]
|
|
23
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
2026-03-22T11:05:17.265Z
|
package/plugin/CLAUDE.md
ADDED
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
# Bugfix Sprint: 2026-01-10
|
|
2
|
+
|
|
3
|
+
## Critical Priority (Blocks Users)
|
|
4
|
+
|
|
5
|
+
### #646 - Plugin bricks Claude Code - stdin fstat EINVAL crash
|
|
6
|
+
- **Impact**: Plugin completely bricks Claude Code on Linux. Users cannot recover without manual config editing.
|
|
7
|
+
- **Root Cause**: Bun's stdin handling causes fstat EINVAL when reading piped input
|
|
8
|
+
- **Related Discussion**: Check if this is a Bun upstream issue
|
|
9
|
+
- [ ] Investigate stdin handling in hook scripts
|
|
10
|
+
- [ ] Test on Linux with stdin piping
|
|
11
|
+
- [ ] Implement fix
|
|
12
|
+
|
|
13
|
+
### #623 - Crash-recovery loop when memory_session_id not captured
|
|
14
|
+
- **Impact**: Infinite loop consuming API tokens, growing queue unbounded
|
|
15
|
+
- **Root Cause**: memory_session_id not captured, causes repeated crash-recovery
|
|
16
|
+
- [ ] Add null/undefined check for memory_session_id
|
|
17
|
+
- [ ] Add circuit breaker for crash-recovery attempts
|
|
18
|
+
|
|
19
|
+
## High Priority
|
|
20
|
+
|
|
21
|
+
### #638 - Worker startup missing JSON output causes hooks to appear stuck
|
|
22
|
+
- **Impact**: UI appears stuck during worker startup
|
|
23
|
+
- [ ] Ensure worker startup emits proper JSON status
|
|
24
|
+
- [ ] Add progress feedback to hook output
|
|
25
|
+
|
|
26
|
+
### #641/#609 - CLAUDE.md files in subdirectories
|
|
27
|
+
- **Impact**: CLAUDE.md files scattered throughout project directories
|
|
28
|
+
- **Note**: This is a documented feature request that was never implemented (setting exists but doesn't work)
|
|
29
|
+
- [ ] Implement the `disableSubdirectoryCLAUDEmd` setting properly
|
|
30
|
+
- [ ] Or change default behavior to not create subdirectory files
|
|
31
|
+
|
|
32
|
+
### #635 - JSON parsing error prevents folder context generation
|
|
33
|
+
- **Impact**: Folder context not generating, breaks context injection
|
|
34
|
+
- **Root Cause**: String spread instead of array spread
|
|
35
|
+
- [ ] Fix the JSON parsing logic
|
|
36
|
+
- [ ] Add proper error handling
|
|
37
|
+
|
|
38
|
+
## Medium Priority
|
|
39
|
+
|
|
40
|
+
### #582 - Tilde paths create literal ~ directories
|
|
41
|
+
- **Impact**: Directories named "~" created instead of expanding to home
|
|
42
|
+
- [ ] Use path expansion for tilde in all path operations
|
|
43
|
+
- [ ] Audit all path handling code
|
|
44
|
+
|
|
45
|
+
### #642/#643 - ChromaDB search fails due to initialization timing
|
|
46
|
+
- **Impact**: Search fails with JSON parse error
|
|
47
|
+
- **Note**: #643 is a duplicate of #642
|
|
48
|
+
- [ ] Fix initialization timing issue
|
|
49
|
+
- [ ] Add proper async/await handling
|
|
50
|
+
|
|
51
|
+
### #626 - HealthMonitor hardcodes ~/.claude path
|
|
52
|
+
- **Impact**: Fails for users with custom config directories
|
|
53
|
+
- [ ] Use configurable path instead of hardcoded ~/.claude
|
|
54
|
+
- [ ] Respect CLAUDE_CONFIG_DIR or similar env var
|
|
55
|
+
|
|
56
|
+
### #598 - Too many messages pollute conversation history
|
|
57
|
+
- **Impact**: Hook messages clutter conversation
|
|
58
|
+
- [ ] Reduce verbosity of hook messages
|
|
59
|
+
- [ ] Make message frequency configurable
|
|
60
|
+
|
|
61
|
+
## Low Priority (Code Quality)
|
|
62
|
+
|
|
63
|
+
### #648 - Empty catch blocks swallow JSON parse errors
|
|
64
|
+
- [ ] Add proper error logging to catch blocks in SessionSearch.ts
|
|
65
|
+
|
|
66
|
+
### #649 - Inconsistent logging in CursorHooksInstaller
|
|
67
|
+
- [ ] Replace console.log with structured logger
|
|
68
|
+
- **Note**: 177 console.log calls across 20 files identified
|
|
69
|
+
|
|
70
|
+
## Won't Fix / Not a Bug
|
|
71
|
+
|
|
72
|
+
### #632 - Feature request for disabling CLAUDE.md in subdirectories
|
|
73
|
+
- **Note**: Covered by #641 implementation
|
|
74
|
+
|
|
75
|
+
### #633 - Help request about Cursor integration
|
|
76
|
+
- **Note**: Documentation/support issue, not a bug
|
|
77
|
+
|
|
78
|
+
### #640 - Arabic README translation
|
|
79
|
+
- **Note**: Documentation PR, not a bugfix
|
|
80
|
+
|
|
81
|
+
### #624 - Beta testing strategy proposal
|
|
82
|
+
- **Note**: Enhancement proposal, not a bugfix
|
|
83
|
+
|
|
84
|
+
## Already Fixed in v9.0.2
|
|
85
|
+
|
|
86
|
+
- Windows Terminal tab accumulation (#625/#628)
|
|
87
|
+
- Windows 11 compatibility - WMIC to PowerShell migration
|
|
88
|
+
- Claude Code 2.1.1 compatibility + path validation (#614)
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
**Recommended Approach**: Fix #646 first (critical blocker), then #623 (crash loop), then work through high priority issues in order of impact.
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
{
|
|
2
|
+
"description": "VibeLearn developer learning hooks",
|
|
3
|
+
"hooks": {
|
|
4
|
+
"Setup": [
|
|
5
|
+
{
|
|
6
|
+
"matcher": "*",
|
|
7
|
+
"hooks": [
|
|
8
|
+
{
|
|
9
|
+
"type": "command",
|
|
10
|
+
"command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/vibelearn/plugin\"; \"$_R/scripts/setup.sh\"",
|
|
11
|
+
"timeout": 300
|
|
12
|
+
}
|
|
13
|
+
]
|
|
14
|
+
}
|
|
15
|
+
],
|
|
16
|
+
"SessionStart": [
|
|
17
|
+
{
|
|
18
|
+
"matcher": "startup|clear|compact",
|
|
19
|
+
"hooks": [
|
|
20
|
+
{
|
|
21
|
+
"type": "command",
|
|
22
|
+
"command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/vibelearn/plugin\"; node \"$_R/scripts/smart-install.js\"",
|
|
23
|
+
"timeout": 300
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"type": "command",
|
|
27
|
+
"command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/vibelearn/plugin\"; node \"$_R/scripts/bun-runner.js\" \"$_R/scripts/worker-service.cjs\" start",
|
|
28
|
+
"timeout": 60
|
|
29
|
+
}
|
|
30
|
+
]
|
|
31
|
+
}
|
|
32
|
+
],
|
|
33
|
+
"UserPromptSubmit": [
|
|
34
|
+
{
|
|
35
|
+
"hooks": [
|
|
36
|
+
{
|
|
37
|
+
"type": "command",
|
|
38
|
+
"command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/vibelearn/plugin\"; node \"$_R/scripts/bun-runner.js\" \"$_R/scripts/worker-service.cjs\" hook claude-code session-init",
|
|
39
|
+
"timeout": 60
|
|
40
|
+
}
|
|
41
|
+
]
|
|
42
|
+
}
|
|
43
|
+
],
|
|
44
|
+
"PostToolUse": [
|
|
45
|
+
{
|
|
46
|
+
"matcher": "*",
|
|
47
|
+
"hooks": [
|
|
48
|
+
{
|
|
49
|
+
"type": "command",
|
|
50
|
+
"command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/vibelearn/plugin\"; node \"$_R/scripts/bun-runner.js\" \"$_R/scripts/worker-service.cjs\" hook claude-code observation",
|
|
51
|
+
"timeout": 120
|
|
52
|
+
}
|
|
53
|
+
]
|
|
54
|
+
}
|
|
55
|
+
],
|
|
56
|
+
"Stop": [
|
|
57
|
+
{
|
|
58
|
+
"hooks": [
|
|
59
|
+
{
|
|
60
|
+
"type": "command",
|
|
61
|
+
"command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/vibelearn/plugin\"; node \"$_R/scripts/bun-runner.js\" \"$_R/scripts/worker-service.cjs\" hook claude-code summarize",
|
|
62
|
+
"timeout": 120
|
|
63
|
+
}
|
|
64
|
+
]
|
|
65
|
+
}
|
|
66
|
+
],
|
|
67
|
+
"SessionEnd": [
|
|
68
|
+
{
|
|
69
|
+
"hooks": [
|
|
70
|
+
{
|
|
71
|
+
"type": "command",
|
|
72
|
+
"command": "_R=\"${CLAUDE_PLUGIN_ROOT}\"; [ -z \"$_R\" ] && _R=\"$HOME/.claude/plugins/marketplaces/vibelearn/plugin\"; node \"$_R/scripts/bun-runner.js\" \"$_R/scripts/worker-service.cjs\" hook claude-code session-complete",
|
|
73
|
+
"timeout": 30
|
|
74
|
+
}
|
|
75
|
+
]
|
|
76
|
+
}
|
|
77
|
+
]
|
|
78
|
+
}
|
|
79
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "Code Development (Arabic)",
|
|
3
|
+
"prompts": {
|
|
4
|
+
"footer": "IMPORTANT! DO NOT do any work right now other than generating this OBSERVATIONS from tool use messages - and remember that you are a memory agent designed to summarize a DIFFERENT claude code session, not this one.\n\nNever reference yourself or your own actions. Do not output anything other than the observation content formatted in the XML structure above. All other output is ignored by the system, and the system has been designed to be smart about token usage. Please spend your tokens wisely on useful observations.\n\nRemember that we record these observations as a way of helping us stay on track with our progress, and to help us keep important decisions and changes at the forefront of our minds! :) Thank you so much for your help!\n\nLANGUAGE REQUIREMENTS: Please write the observation data in العربية",
|
|
5
|
+
|
|
6
|
+
"xml_title_placeholder": "[**title**: عنوان قصير يلخص الإجراء أو الموضوع الأساسي]",
|
|
7
|
+
"xml_subtitle_placeholder": "[**subtitle**: شرح في جملة واحدة (بحد أقصى 24 كلمة)]",
|
|
8
|
+
"xml_fact_placeholder": "[بيان موجز ومكتفٍ ذاتياً]",
|
|
9
|
+
"xml_narrative_placeholder": "[**narrative**: السياق الكامل: ما تم إنجازه، كيف يعمل، لماذا هو مهم]",
|
|
10
|
+
"xml_concept_placeholder": "[فئة-نوع-المعرفة]",
|
|
11
|
+
"xml_file_placeholder": "[المسار/إلى/الملف]",
|
|
12
|
+
|
|
13
|
+
"xml_summary_request_placeholder": "[عنوان قصير يلخص طلب المستخدم وجوهر ما تمت مناقشته/إنجازه]",
|
|
14
|
+
"xml_summary_investigated_placeholder": "[ما الذي تم استكشافه حتى الآن؟ ما الذي تم فحصه؟]",
|
|
15
|
+
"xml_summary_learned_placeholder": "[ما الذي تعلمته عن كيفية عمل الأشياء؟]",
|
|
16
|
+
"xml_summary_completed_placeholder": "[ما العمل الذي تم إنجازه حتى الآن؟ ما الذي تم شحنه أو تغييره؟]",
|
|
17
|
+
"xml_summary_next_steps_placeholder": "[ما الذي تعمل عليه بنشاط أو تخطط للعمل عليه بعد ذلك في هذه الجلسة؟]",
|
|
18
|
+
"xml_summary_notes_placeholder": "[رؤى أو ملاحظات إضافية حول التقدم الحالي]",
|
|
19
|
+
|
|
20
|
+
"continuation_instruction": "IMPORTANT: Continue generating observations from tool use messages using the XML structure below.\n\nLANGUAGE REQUIREMENTS: Please write the observation data in العربية",
|
|
21
|
+
|
|
22
|
+
"summary_footer": "IMPORTANT! DO NOT do any work right now other than generating this next PROGRESS SUMMARY - and remember that you are a memory agent designed to summarize a DIFFERENT claude code session, not this one.\n\nNever reference yourself or your own actions. Do not output anything other than the summary content formatted in the XML structure above. All other output is ignored by the system, and the system has been designed to be smart about token usage. Please spend your tokens wisely on useful summary content.\n\nThank you, this summary will be very useful for keeping track of our progress!\n\nLANGUAGE REQUIREMENTS: Please write ALL summary content (request, investigated, learned, completed, next_steps, notes) in العربية"
|
|
23
|
+
}
|
|
24
|
+
}
|