@vpxa/aikit 0.1.194 → 0.1.195

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vpxa/aikit",
3
- "version": "0.1.194",
3
+ "version": "0.1.195",
4
4
  "type": "module",
5
5
  "description": "Local-first AI developer toolkit — knowledge base, code analysis, context management, and developer tools for LLM agents",
6
6
  "license": "MIT",
@@ -147,6 +147,7 @@ This gives the user a visual dependency graph of the execution plan before dispa
147
147
  8. **Self-Review** — checklist before declaring status
148
148
  9. **No present** — "Do NOT use the \`present\` tool — return all findings as structured text"
149
149
  10. **No get_changed_files** — "Do NOT call \`get_changed_files\` — it returns ALL uncommitted diffs (100K+ tokens), wasting your context window. If you need a specific file's changes, use \`run_in_terminal\` with \`git diff <file>\`."
150
+ 11. **Agent selection (HARD RULE)** — ALWAYS pass \`agentName\` parameter matching the Agent Dispatch Rules table. NEVER dispatch with empty/missing \`agentName\` — the generic default agent runs instead of the specialist. Example: \`runSubagent({ agentName: "Implementer", ... })\`.
150
151
 
151
152
  **Subagent status protocol:** \`DONE\` | \`DONE_WITH_CONCERNS\` | \`NEEDS_CONTEXT\` | \`BLOCKED\`
152
153
  **Per-step review cycle (tier-gated):**
@@ -243,6 +244,8 @@ Subagent \`present\` calls are invisible to user. Always include "Do NOT use \`p
243
244
  - \`create_file\` / \`createFile\`
244
245
  - \`multi_replace_string_in_file\`
245
246
  - \`run_in_terminal\` for code generation (sed, echo >>, etc.)
247
+ - \`run_in_terminal\` for validation/build (\`pnpm validate\`, \`pnpm build\`, \`tsc\`) — use \`check({})\` + \`test_run({})\`
248
+ - \`grep_search\` / \`read_file\` for understanding code — use \`search\`/\`file_summary\`/\`compact\`
246
249
  - \`vscode/switchAgent\` — **NEVER use this to delegate flow work**. Switching agents hands off control and breaks flow orchestration. ALL agent work goes through \`runSubagent\`. \`vscode/switchAgent\` is reserved for explicit user-requested agent switching only.
247
250
 
248
251
  ### Allowed Tools
@@ -68,6 +68,7 @@ Use AI Kit retrieval and compression tools first. Prefer reusable compressed con
68
68
  | \`run_in_terminal\` for test | \`test_run({})\` | Run tests with structured output |
69
69
  | Editing without reading | \`file_summary\` then targeted \`read_file\` | Prevents wrong-position edits |
70
70
  | \`get_changed_files\` | \`run_in_terminal\` with \`git diff <specific-file>\` | Returns ALL uncommitted diffs (100K+ tokens). Target specific files instead |
71
+ | \`run_in_terminal\` for code edits (node -e, scripts, PowerShell -replace, WriteAllText) | \`replace_string_in_file\` | Terminal-based editing wastes tokens on script creation, execution output, and verification loops. Use editor tools directly. |
71
72
 
72
73
  > **Path Note:** \`compact({path})\` and \`file_summary({path})\` accept ANY absolute path — not just indexed workspace files. They read the file directly from disk. Use them freely for cross-workspace and cross-repository file access without needing to index the target workspace first.
73
74