pikakit 3.9.136 → 3.9.139

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.
Files changed (3) hide show
  1. package/package.json +2 -2
  2. package/packages/pikakit-extension/README.md +51 -122
  3. package/packages/pikakit-extension/pikakit.vsix +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pikakit",
3
- "version": "3.9.136",
3
+ "version": "3.9.139",
4
4
  "description": "PikaKit FAANG-Grade AI Operating System — Install 51 skills, 18 workflows.",
5
5
  "license": "Proprietary",
6
6
  "author": "pikakit <pikakit@gmail.com>",
@@ -73,4 +73,4 @@
73
73
  "prettier": "^3.2.5",
74
74
  "vitest": "^4.0.18"
75
75
  }
76
- }
76
+ }
package/packages/pikakit-extension/README.md CHANGED
@@ -1,152 +1,81 @@
1
- # PikaKit Engine - VS Code Extension
1
+ <div align="center">
2
2
 
3
- > 🤖 FAANG-Grade AI Operating System. Real-time Knowledge Compilation from IDE diagnostics → Generate skills automatically
3
+ # 🤖 PikaKit Engine
4
+ ### The Execution Layer for Autonomous Programming
4
5
 
5
- ## Features
6
+ [![npm](https://img.shields.io/badge/npm-v3.9.138-7c3aed?style=for-the-badge&logo=npm&logoColor=white&labelColor=18181b)](https://www.npmjs.com/package/pikakit)
6
7
 
7
- - **Real-time Diagnostics** - Listen to TypeScript, ESLint errors in real-time
8
- - **Knowledge Ingestion** - Extract raw signals from IDE fixes and corrections into `.agent/knowledge/raw/`
9
- - **Knowledge Compilation** - Cluster signals into cross-linked concept articles (`concepts/`), decisions (`decisions/`), and patterns (`patterns/`)
10
- - **Knowledge Base** - Maintain a centralized project index (`_index.md` & `_graph.md`)
11
- - **Skill Generation** - Produce agent `SKILL.md` from mature patterns
12
- - **Autopilot** - Automatically accept edits + run proposed terminal commands (dangerous commands blocked)
13
- - **CDP** - Auto-click "Allow file access?" permission dialogs via Chrome DevTools Protocol
14
- - **Status Bar** - Display Knowledge Engine status + Autopilot/CDP toggles
8
+ </div>
15
9
 
16
- ## Keyboard Shortcuts
10
+ PikaKit Engine is the execution and memory core of the **PikaKit AI Operating System**. It runs natively inside VS Code, granting AI agents real-world IDE control, deterministic execution, and a permanent, offline-first vector memory engine.
17
11
 
18
- | Shortcut | Action | Description |
19
- |----------|--------|-------------|
20
- | `Ctrl+Shift+Enter` | Toggle Autopilot | Auto-accept edits + auto-run commands (dangerous blocked) |
12
+ *This extension is the crucial bridge that turns an AI Assistant into a deterministic Self-Healing Developer.*
21
13
 
22
- > On macOS: `Cmd+Shift+Enter`
14
+ ---
23
15
 
24
- ## Installation
16
+ ## ⚡ Core Architecture (Brain v2)
25
17
 
26
- ### Via PikaKit CLI (recommended)
18
+ With the release of Brain v2, PikaKit Engine introduces the Autonomous Self-Healing Pipeline directly into your IDE:
27
19
 
28
- ```bash
29
- npx pikakit
30
- ```
20
+ ### 1️⃣ Local Memory Engine (WASM)
21
+ - Powered by `sql.js` (WASM), storing permanent knowledge, AST hashes, and execution patterns entirely locally without external database dependencies.
22
+ - **5-Table Relational Trust:** Manages `lessons`, `embeddings`, `signals`, `fixes_applied`, and `fix_templates`.
31
23
 
32
- The extension is installed automatically during skill installation.
24
+ ### 2️⃣ Autonomous Execution Engine
25
+ A real-time Background Worker that automatically resolves simple and complex codebase regressions:
26
+ - **Fast Path:** Applies deterministic regex solutions (Level 1/2) for common patterns directly via `WorkspaceEdit` with strict Scope bounding to ensure Safety.
27
+ - **Deep Path (Semantic Fallback):** When naive regex fails, it converts IDE diagnostics into Embeddings and performs **Cosine Similarity Vector Search** on your historical bugs/commits to retrieve solutions contextually.
33
28
 
34
- ### Install from VSIX
29
+ ### 3️⃣ Pattern Generalization
30
+ When an IDE fix proves successful multiple times, PikaKit abstracts the specific logic into generic reusable AST/Regex rules, generating `.agent/skills/` templates natively within your workspace.
31
+
32
+ ### 4️⃣ CDP Auto-Pilot (Zero-Friction)
33
+ - Operates Chrome DevTools Protocol to auto-dismiss VS Code extension dialogues (e.g., "Allow file access?") seamlessly.
34
+ - Enforces strict safety gates against dangerous CLI commands (`rm -rf`, `fork bombs`).
35
+
36
+ ---
37
+
38
+ ## 🚀 Installation & Setup
39
+
40
+ If you install PikaKit via CLI, the extension binds automatically to your workspace:
35
41
 
36
42
  ```bash
37
- cd packages/pikakit-extension
38
- npm install && npm run compile
39
- npx @vscode/vsce package --allow-missing-repository
40
- code --install-extension pikakit-engine-3.9.136.vsix
43
+ npx pikakit
41
44
  ```
42
45
 
43
- ### Local Development
44
-
46
+ ### Manual VSIX Build
45
47
  ```bash
46
48
  cd packages/pikakit-extension
47
49
  npm install && npm run compile
50
+ npx @vscode/vsce package --allow-missing-repository
51
+ code --install-extension pikakit.vsix
48
52
  ```
49
53
 
50
- Press F5 → "Extension Development Host" → Extension runs in new window.
51
-
52
- ## Commands
53
-
54
- Press `Ctrl+Shift+P` → type "PikaKit":
55
-
56
- | Command | Description |
57
- |---------|-------------|
58
- | `PikaKit: Start Learning` | Start compiling knowledge from diagnostics |
59
- | `PikaKit: Stop Learning` | Stop compiling knowledge |
60
- | `PikaKit: Generate Skill` | Manually generate skill from patterns |
61
- | `PikaKit: View Knowledge Wiki` | View the compiled Knowledge Wiki |
62
- | `PikaKit: Clear Lessons` | Clear all saved patterns |
63
- | `PikaKit: Toggle Autopilot` | Toggle autopilot (Ctrl+Shift+Enter) |
64
- | `PikaKit: Toggle CDP` | Toggle CDP file access auto-click |
65
- | `PikaKit: CDP Setup Guide` | Show CDP setup instructions |
66
-
67
- ## Configuration
54
+ ## ⚙️ Configuration
55
+ Open VS Code Settings (`Ctrl + ,`) and search for `PikaKit`:
68
56
 
69
57
  | Setting | Default | Description |
70
58
  |---------|---------|-------------|
71
- | `pikakit.autoStart` | `true` | Auto-start knowledge compiler on VS Code startup |
72
- | `pikakit.threshold` | `3` | Error count before generating a skill |
73
- | `pikakit.lessonsPath` | `.agent/lessons.json` | Path to pattern/lesson storage |
74
- | `pikakit.autopilotEnabled` | `false` | Enable Autopilot on startup |
75
-
76
- ## Architecture
77
-
78
- ### 1. Knowledge Engine
79
-
80
- ```text
81
- ┌─────────────────────────────────────────────────┐
82
- │ PikaKit Knowledge Engine │
83
- │ │
84
- │ ┌──────────────────────────────┐ │
85
- │ │ 📥 1. Ingestion │ ← Phase 1 │
86
- │ │ Extract signals from IDE │ raw/ │
87
- │ └──────────────┬───────────────┘ │
88
- │ │ │
89
- │ ┌──────────────┴───────────────┐ │
90
- │ │ 📚 2. Compilation │ ← Phase 2 │
91
- │ │ Cluster into Concept Wiki │ concepts/ │
92
- │ └──────────────┬───────────────┘ │
93
- │ │ │
94
- │ ┌──────────────┴───────────────┐ │
95
- │ │ ⚙️ 3. Generation │ ← Phase 3 │
96
- │ │ Produce agent SKILL.md │ skills/ │
97
- │ └──────────────────────────────┘ │
98
- └─────────────────────────────────────────────────┘
99
- ```
59
+ | `pikakit.autoStart` | `true` | Start knowledge compilation on startup. |
60
+ | `pikakit.apiProvider` | `gemini` | Semantic Search Provider (`gemini` or `openai`). |
61
+ | `pikakit.apiKey` | `""` | API Key for embedding generation & Deep Path Fallback. |
62
+ | `pikakit.autopilotEnabled` | `false` | Enable VS Code command interception. |
100
63
 
101
- **Ingest** captures raw IDE errors. **Compile** structures them into cross-linked concept articles. **Generate** converts mature patterns into executable `SKILL.md` files.
102
-
103
- ### 2. Autonomous Mode
104
-
105
- ```text
106
- ┌─────────────────────────────────────────────────┐
107
- │ PikaKit Autonomous Mode │
108
- │ │
109
- │ ┌──────────────────────────────┐ │
110
- │ │ ⚡ Autopilot │ ← Layer 1 │
111
- │ │ (10 VS Code commands) │ Command API │
112
- │ │ Accept edits + Run cmds │ │
113
- │ └──────────────┬───────────────┘ │
114
- │ │ │
115
- │ ┌──────────────┴───────────────┐ │
116
- │ │ 🔌 CDP │ ← Layer 2 │
117
- │ │ "Allow file access?" etc. │ DOM Click │
118
- │ └──────────────────────────────┘ │
119
- └─────────────────────────────────────────────────┘
120
- ```
121
-
122
- **Autopilot** handles VS Code commands (accept edits, run terminals).
123
- **CDP** handles permission dialogs that have no VS Code Command API.
124
-
125
- ## Status Bar
64
+ > **Note:** The API Key is purely utilized for *local vector embedding generation* and offline analysis. No source code is sent externally beyond context snippets for vectorization.
126
65
 
127
- | Icon | State | Action |
128
- |------|-------|--------|
129
- | `$(rocket) Autopilot` | ON | Click or Ctrl+Shift+Enter to toggle |
130
- | `$(circle-slash) Autopilot` | OFF | Click or Ctrl+Shift+Enter to toggle |
131
- | `$(plug) CDP: ON` | Connected | Click to disconnect |
132
- | `$(debug-disconnect) CDP: OFF` | Disconnected | Click to connect |
66
+ ## 🛡️ The Autopilot Safety Protocol
67
+ Autopilot includes hardcoded blocks against destructive operations:
68
+ - Deleting root/home (`rm -rf /`)
69
+ - Disk formatting
70
+ - Destructive git rewrites
71
+ - Unbounded loops
133
72
 
134
- ## Safety
73
+ *Autonomy is meaningless without control.*
135
74
 
136
- Autopilot includes dangerous command blocking for:
137
- - `rm -rf /`, `rm -rf ~`, `rm -rf *`
138
- - `format c:`, `del /f /s /q`, `rmdir /s /q`
139
- - Fork bombs (`:(){:|:&};:`)
140
- - `dd if=`, `mkfs.`, `chmod -R 777 /`
141
- - `Remove-Item -Recurse -Force C:\`
142
-
143
- ## Supported Error Types
75
+ ---
144
76
 
145
- - TypeScript: Cannot find name, Property does not exist, Type mismatch
146
- - ESLint: Unused variables, Missing semicolons
147
- - React: Invalid hook calls, Missing dependencies
148
- - General: Import errors, Module not found
77
+ <div align="center">
149
78
 
150
- ---
79
+ **[Pikakit.com](https://pikakit.com) • FAANG-Grade AI OS**
151
80
 
152
- ⚡ PikaKit Engine v3.9.136
81
+ </div>