@vpxa/aikit 0.1.22 → 0.1.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpxa/aikit",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "type": "module",
   "description": "Local-first AI developer toolkit — knowledge base, code analysis, context management, and developer tools for LLM agents",
   "license": "MIT",

package/packages/cli/dist/commands/init/constants.d.ts

@@ -37,6 +37,9 @@ declare const FLOW_DIRS: readonly ["aikit-basic", "aikit-advanced"];
  *   web pages inside VS Code's built-in browser.
  * - mcpApps: Enables MCP tool apps so AI Kit tools can be consumed by Copilot
  *   Chat without requiring manual MCP server configuration.
+ * - instructionsFilesLocations: Tells VS Code to load .instructions.md files
+ *   from ~/.copilot/instructions/ (user-level) in addition to workspace-level
+ *   locations. This is where `aikit init` places copilot-instructions.md.
  */
 declare const VSCODE_SETTINGS: Record<string, unknown>;
 //#endregion

package/packages/cli/dist/commands/init/constants.js

@@ -1 +1 @@
-const e=`aikit`,t={type:`stdio`,command:`npx`,args:[`-y`,`@vpxa/aikit`,`serve`]},n=[`aikit`,`brainstorming`,`multi-agents-development`,`session-handoff`,`requirements-clarity`,`lesson-learned`,`c4-architecture`,`adr-skill`,`present`,`frontend-design`,`react`,`typescript`],r=[`aikit-basic`,`aikit-advanced`],i={"chat.agentFilesLocations":{"~/.claude/agents":!1},"github.copilot.chat.copilotMemory.enabled":!0,"chat.customAgentInSubagent.enabled":!0,"chat.useNestedAgentsMdFiles":!0,"chat.useAgentSkills":!0,"github.copilot.chat.switchAgent.enabled":!0,"workbench.browser.enableChatTools":!0,"chat.mcp.apps.enabled":!0};export{r as FLOW_DIRS,t as MCP_SERVER_ENTRY,e as SERVER_NAME,n as SKILL_NAMES,i as VSCODE_SETTINGS};
+const e=`aikit`,t={type:`stdio`,command:`npx`,args:[`-y`,`@vpxa/aikit`,`serve`]},n=[`aikit`,`brainstorming`,`multi-agents-development`,`session-handoff`,`requirements-clarity`,`lesson-learned`,`c4-architecture`,`adr-skill`,`present`,`frontend-design`,`react`,`typescript`],r=[`aikit-basic`,`aikit-advanced`],i={"chat.agentFilesLocations":{"~/.claude/agents":!1},"github.copilot.chat.copilotMemory.enabled":!0,"chat.customAgentInSubagent.enabled":!0,"chat.useNestedAgentsMdFiles":!0,"chat.useAgentSkills":!0,"github.copilot.chat.switchAgent.enabled":!0,"workbench.browser.enableChatTools":!0,"chat.mcp.apps.enabled":!0,"chat.instructionsFilesLocations":{"~/.copilot/instructions":!0,".github/instructions":!0}};export{r as FLOW_DIRS,t as MCP_SERVER_ENTRY,e as SERVER_NAME,n as SKILL_NAMES,i as VSCODE_SETTINGS};

package/scaffold/adapters/claude-code.mjs

@@ -10,6 +10,15 @@
  * Status: STUB — not yet implemented.
  */
 
+// biome-ignore lint/correctness/noUnusedImports: reserved for implementation
+import { AGENTS } from '../definitions/agents.mjs';
+// biome-ignore lint/correctness/noUnusedImports: reserved for implementation
+import { AGENT_BODIES } from '../definitions/bodies.mjs';
+// biome-ignore lint/correctness/noUnusedImports: reserved for implementation
+import { CLAUDE_MODELS, VARIANT_GROUPS } from '../definitions/models.mjs';
+// biome-ignore lint/correctness/noUnusedImports: reserved for implementation
+import { IDE_CAPABILITIES } from '../definitions/tools.mjs';
+
 export const CLAUDE_FLOWS_SECTION = [
   '## Flows',
   '',

package/scaffold/adapters/copilot.mjs

@@ -18,7 +18,7 @@
 
 import { AGENTS } from '../definitions/agents.mjs';
 import { AGENT_BODIES } from '../definitions/bodies.mjs';
-import { MODELS, VARIANT_GROUPS } from '../definitions/models.mjs';
+import { COPILOT_MODELS, VARIANT_GROUPS } from '../definitions/models.mjs';
 import { PROMPTS } from '../definitions/prompts.mjs';
 import { PROTOCOLS, TEMPLATES } from '../definitions/protocols.mjs';
 import { IDE_CAPABILITIES } from '../definitions/tools.mjs';
@@ -64,12 +64,13 @@ function buildToolsYaml(toolRole) {
 }
 
 function copilotModel(agentName) {
-  const models = MODELS[agentName];
+  const models = COPILOT_MODELS[agentName];
   if (!models) return 'Auto (copilot)';
+  // NOTE: Model array syntax (e.g. [model1, model2]) is experimental and
+  // requires a VS Code experiment flag to be enabled. For now, we always
+  // emit the primary (first) model as a plain string.
   if (Array.isArray(models)) {
-    if (models.length === 0) return 'Auto (copilot)';
-    if (models.length === 1) return models[0];
-    return `[${models.join(', ')}]`;
+    return models[0] || 'Auto (copilot)';
   }
   return models;
 }
@@ -90,14 +91,14 @@ function buildAgentTable() {
     if (def.variants) {
       for (const suffix of VARIANT_GROUPS[name] || []) {
         const fullName = `${name}-${suffix}`;
-        const models = MODELS[fullName] || MODELS[name];
+        const models = COPILOT_MODELS[fullName] || COPILOT_MODELS[name];
         const model = Array.isArray(models) ? models[0] : models || 'Unknown';
         const varDef = def.variants[suffix] || {};
         const desc = varDef.description || def.description;
         rows.push(`| **${fullName}** | ${desc} | ${model} | ${def.category} |`);
       }
     } else {
-      const models = MODELS[name];
+      const models = COPILOT_MODELS[name];
       const model = Array.isArray(models) ? models[0] : models || 'Unknown';
       rows.push(`| **${name}** | ${def.description} | ${model} | ${def.category} |`);
     }
@@ -130,7 +131,7 @@ function generateVariantAgent(roleName, suffix, def) {
 
   return `---
 description: '${desc}'
-${def.argumentHint ? `argument-hint: ${def.argumentHint}\n` : ''}tools: ${buildToolsYaml(def.toolRole)}
+${def.argumentHint ? `argument-hint: "${def.argumentHint}"\n` : ''}tools: ${buildToolsYaml(def.toolRole)}
 model: ${model}
 ---
 
@@ -157,7 +158,7 @@ function generateSingleAgent(name, def) {
 
   return `---
 description: '${def.description}'
-${def.argumentHint ? `argument-hint: ${def.argumentHint}\n` : ''}tools: ${buildToolsYaml(def.toolRole)}
+${def.argumentHint ? `argument-hint: "${def.argumentHint}"\n` : ''}tools: ${buildToolsYaml(def.toolRole)}
 model: ${model}
 ---
 

package/scaffold/definitions/models.mjs

@@ -2,14 +2,20 @@
  * Centralized model assignments — THE SINGLE FILE to update when models change.
  *
  * Keys are agent names (stable, model-agnostic).
- * Values are model strings in the format expected by the target IDE.
- * Each IDE adapter may interpret or transform these values.
+ * COPILOT_MODELS keeps the full fallback list in Copilot format.
+ * CLAUDE_MODELS maps each agent to its primary model as a single plain string.
  *
  * Naming convention for variants: {Role}-Alpha, {Role}-Beta, {Role}-Gamma, {Role}-Delta
  * These are abstract labels — the actual model behind each is defined HERE.
+ *
+ * NOTE (Experimental): VS Code supports a model array syntax (e.g. [model1, model2])
+ * for agent files, but it requires an experiment flag to be enabled. Until the flag
+ * is generally available, adapters should emit only the first (primary) model as a
+ * plain string. The full fallback arrays are retained here so adapters can switch to
+ * array output when the flag is GA.
  */
 
-export const MODELS = {
+export const COPILOT_MODELS = {
   // ─── Single-role agents ───────────────────────────────────────────────
   Orchestrator: ['Claude Opus 4.6 (copilot)', 'GPT-5.4 (copilot)', 'Auto (copilot)'],
   Planner: ['Claude Opus 4.6 (copilot)', 'GPT-5.4 (copilot)', 'Auto (copilot)'],
@@ -51,6 +57,13 @@ export const MODELS = {
   'Architect-Reviewer-Beta': ['Claude Opus 4.6 (copilot)', 'Auto (copilot)'],
 };
 
+export const CLAUDE_MODELS = Object.fromEntries(
+  Object.entries(COPILOT_MODELS).map(([agentName, models]) => {
+    const primaryModel = Array.isArray(models) ? models[0] : models;
+    return [agentName, primaryModel?.replace(/ \(copilot\)$/, '') || 'Auto'];
+  }),
+);
+
 /**
  * Variant group definitions — maps role to variant suffixes.
  * Used by adapters to know which agents are variants of the same role.

package/scaffold/general/agents/Architect-Reviewer-Alpha.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Primary architecture reviewer'
-argument-hint: Files, PR, or subsystem to architecture-review
+argument-hint: "Files, PR, or subsystem to architecture-review"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [GPT-5.4 (copilot), Auto (copilot)]
+model: GPT-5.4 (copilot)
 ---
 
 # Architect-Reviewer-Alpha - The Structural Guardian

package/scaffold/general/agents/Architect-Reviewer-Beta.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Architecture reviewer variant — different LLM perspective for dual review'
-argument-hint: Files, PR, or subsystem to architecture-review
+argument-hint: "Files, PR, or subsystem to architecture-review"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Opus 4.6 (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Architect-Reviewer-Beta - The Structural Guardian

package/scaffold/general/agents/Code-Reviewer-Alpha.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Primary code reviewer'
-argument-hint: File path, PR, or code to review
+argument-hint: "File path, PR, or code to review"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [GPT-5.4 (copilot), Auto (copilot)]
+model: GPT-5.4 (copilot)
 ---
 
 # Code-Reviewer-Alpha - The Quality Guardian

package/scaffold/general/agents/Code-Reviewer-Beta.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Code reviewer variant — different LLM perspective for dual review'
-argument-hint: File path, PR, or code to review
+argument-hint: "File path, PR, or code to review"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Opus 4.6 (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Code-Reviewer-Beta - The Quality Guardian

package/scaffold/general/agents/Debugger.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Expert debugger that diagnoses issues, traces errors, and provides solutions'
-argument-hint: Error message, stack trace, or description of issue
+argument-hint: "Error message, stack trace, or description of issue"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalSelection, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, search/changes, search/codebase, search/usages, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Opus 4.6 (copilot), GPT-5.4 (copilot), GPT-5.3-Codex (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Debugger - The Problem Solver

package/scaffold/general/agents/Documenter.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Documentation specialist that creates and maintains comprehensive project documentation'
-argument-hint: Component, API, feature, or area to document
+argument-hint: "Component, API, feature, or area to document"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [GPT-5.4 (copilot), Gemini 3.1 Pro (Preview) (copilot), Auto (copilot)]
+model: GPT-5.4 (copilot)
 ---
 
 # Documenter - The Knowledge Keeper

package/scaffold/general/agents/Explorer.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Rapid codebase exploration to find files, usages, dependencies, and structural context'
-argument-hint: Find files, usages, and context related to: {topic or goal}
+argument-hint: "Find files, usages, and context related to: {topic or goal}"
 tools: [read/problems, read/readFile, search/changes, search/codebase, search/usages, search/fileSearch, search/listDirectory, search/textSearch, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Gemini 3 Flash (Preview) (copilot), Claude Haiku 4.5 (copilot), Auto (copilot)]
+model: Gemini 3 Flash (Preview) (copilot)
 ---
 
 # Explorer - The Rapid Scout

package/scaffold/general/agents/Frontend.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'UI/UX specialist for React, styling, responsive design, and frontend implementation'
-argument-hint: UI component, styling task, or frontend feature
+argument-hint: "UI component, styling task, or frontend feature"
 tools: [execute/createAndRunTask, execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, todo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Gemini 3.1 Pro (Preview) (copilot), GPT-5.4 (copilot), GPT-5.3-Codex (copilot), Auto (copilot)]
+model: Gemini 3.1 Pro (Preview) (copilot)
 ---
 
 # Frontend - The UI Specialist

package/scaffold/general/agents/Implementer.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Persistent implementation agent that writes code following TDD practices until all tasks are complete'
-argument-hint: Implementation task, feature, or phase from plan
+argument-hint: "Implementation task, feature, or phase from plan"
 tools: [execute/createAndRunTask, execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, todo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [GPT-5.4 (copilot), Gemini 3.1 Pro (Preview) (copilot), GPT-5.3-Codex (copilot), Auto (copilot)]
+model: GPT-5.4 (copilot)
 ---
 
 # Implementer - The Code Builder

package/scaffold/general/agents/Orchestrator.agent.md

@@ -1,7 +1,7 @@
 ---
 description: 'Master conductor that orchestrates the full development lifecycle: Planning → Implementation → Review → Recovery → Commit'
 tools: [vscode/memory, vscode/runCommand, vscode/switchAgent, execute/killTerminal, execute/createAndRunTask, execute/runInTerminal, read/terminalSelection, read/terminalLastCommand, read/problems, read/readFile, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, todo, search/searchSubagent, search/textSearch, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, vscode/askQuestions, vscode/resolveMemoryFileUri, aikit/*]
-model: [Claude Opus 4.6 (copilot), GPT-5.4 (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Orchestrator - The Master Conductor

package/scaffold/general/agents/Planner.agent.md

@@ -1,7 +1,7 @@
 ---
 description: 'Autonomous planner that researches codebases and writes comprehensive TDD implementation plans'
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, todo, search/searchSubagent, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Opus 4.6 (copilot), GPT-5.4 (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Planner - The Strategic Architect

package/scaffold/general/agents/Refactor.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Code refactoring specialist that improves structure, readability, and maintainability'
-argument-hint: Code, component, or pattern to refactor
+argument-hint: "Code, component, or pattern to refactor"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [GPT-5.4 (copilot), GPT-5.3-Codex (copilot), Auto (copilot)]
+model: GPT-5.4 (copilot)
 ---
 
 # Refactor - The Code Sculptor

package/scaffold/general/agents/Researcher-Alpha.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Primary deep research agent — also serves as default Researcher'
-argument-hint: Research question, problem statement, or subsystem to investigate
+argument-hint: "Research question, problem statement, or subsystem to investigate"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Opus 4.6 (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Researcher-Alpha - The Context Gatherer

package/scaffold/general/agents/Researcher-Beta.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Research variant — pragmatic analysis with focus on trade-offs and edge cases'
-argument-hint: Research question, problem statement, or subsystem to investigate
+argument-hint: "Research question, problem statement, or subsystem to investigate"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Sonnet 4.6 (copilot), Auto (copilot)]
+model: Claude Sonnet 4.6 (copilot)
 ---
 
 # Researcher-Beta - The Context Gatherer

package/scaffold/general/agents/Researcher-Delta.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Research variant — implementation feasibility and performance implications'
-argument-hint: Research question, problem statement, or subsystem to investigate
+argument-hint: "Research question, problem statement, or subsystem to investigate"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Gemini 3.1 Pro (Preview) (copilot), Auto (copilot)]
+model: Gemini 3.1 Pro (Preview) (copilot)
 ---
 
 # Researcher-Delta - The Context Gatherer

package/scaffold/general/agents/Researcher-Gamma.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Research variant — broad pattern matching across domains and technologies'
-argument-hint: Research question, problem statement, or subsystem to investigate
+argument-hint: "Research question, problem statement, or subsystem to investigate"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [GPT-5.4 (copilot), Auto (copilot)]
+model: GPT-5.4 (copilot)
 ---
 
 # Researcher-Gamma - The Context Gatherer

package/scaffold/general/agents/Security.agent.md

@@ -1,8 +1,8 @@
 ---
 description: 'Security specialist that analyzes code for vulnerabilities and compliance'
-argument-hint: Code, feature, or component to security review
+argument-hint: "Code, feature, or component to security review"
 tools: [execute/runInTerminal, read/problems, read/readFile, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Opus 4.6 (copilot), GPT-5.4 (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Security - The Vulnerability Hunter

package/packages/kb-client/dist/direct-client.d.ts

@@ -1,37 +0,0 @@
-import { IKBClient, KBGraphData, KBKnowledgeEntry, KBSearchResult, KBStatus } from "./types.js";
-import { IEmbedder } from "../../embeddings/dist/index.js";
-import { IGraphStore, IKnowledgeStore } from "../../store/dist/index.js";
-
-//#region packages/kb-client/src/direct-client.d.ts
-interface CuratedEntry {
-  path: string;
-  title: string;
-  category: string;
-  tags: string[];
-  content: string;
-}
-interface DirectClientDeps {
-  store: IKnowledgeStore;
-  embedder: IEmbedder;
-  graphStore?: IGraphStore;
-  /** Function to list curated entries */
-  listCurated?: () => Promise<CuratedEntry[]>;
-  /** Function to read a single curated entry */
-  readCurated?: (path: string) => Promise<CuratedEntry | null>;
-}
-declare class DirectKBClient implements IKBClient {
-  private readonly deps;
-  constructor(deps: DirectClientDeps);
-  getStatus(): Promise<KBStatus>;
-  search(query: string, options?: {
-    limit?: number;
-    mode?: 'hybrid' | 'semantic' | 'keyword';
-  }): Promise<KBSearchResult[]>;
-  listKnowledge(): Promise<KBKnowledgeEntry[]>;
-  readKnowledge(path: string): Promise<KBKnowledgeEntry | null>;
-  getGraph(query?: string): Promise<KBGraphData>;
-  getFileTree(): Promise<string[]>;
-  private getEdgesForNodes;
-}
-//#endregion
-export { DirectClientDeps, DirectKBClient };

package/packages/kb-client/dist/direct-client.js

@@ -1 +0,0 @@
-const e=1e3;var t=class{constructor(e){this.deps=e}async getStatus(){let e=await this.deps.store.getStats();return{totalRecords:e.totalRecords,totalFiles:e.totalFiles,lastIndexedAt:e.lastIndexedAt??null,onboarded:e.totalRecords>0}}async search(e,t){let n=t?.limit??10,i=t?.mode??`hybrid`;if(i===`keyword`)return(await this.deps.store.ftsSearch(e,{limit:n})).map(r);let a=await this.deps.embedder.embedQuery(e);if(i===`semantic`)return(await this.deps.store.search(a,{limit:n})).map(r);let[o,s]=await Promise.all([this.deps.store.search(a,{limit:n*2}),this.deps.store.ftsSearch(e,{limit:n*2}).catch(()=>[])]),c=new Map;for(let e of[...o,...s]){let t=c.get(e.record.id);(!t||e.score>t.score)&&c.set(e.record.id,e)}return[...c.values()].sort((e,t)=>t.score-e.score).slice(0,n).map(r)}async listKnowledge(){return this.deps.listCurated?(await this.deps.listCurated()).map(n):[]}async readKnowledge(e){if(!this.deps.readCurated)return null;let t=await this.deps.readCurated(e);return t?n(t):null}async getGraph(t){if(!this.deps.graphStore)return{nodes:[],edges:[]};let n=await this.deps.graphStore.findNodes(t?{namePattern:t,limit:500}:{limit:500});if(n.length===0)return{nodes:[],edges:[]};let r=t?await this.getEdgesForNodes(n):await this.deps.graphStore.findEdges({limit:e});return{nodes:n.map(e=>({id:e.id,name:e.name,type:e.type,...e.sourcePath?{sourcePath:e.sourcePath}:{}})),edges:i(r).map(e=>({fromId:e.fromId,toId:e.toId,type:e.type}))}}async getFileTree(){return this.deps.store.listSourcePaths()}async getEdgesForNodes(t){let n=this.deps.graphStore;if(!n)return[];let r=t.flatMap(t=>[n.findEdges({fromId:t.id,limit:e}),n.findEdges({toId:t.id,limit:e})]);return(await Promise.all(r)).flat()}};function n(e){return{path:e.path,title:e.title,category:e.category,tags:e.tags,content:e.content}}function r(e){return{sourcePath:e.record.sourcePath,contentType:e.record.contentType,score:e.score,content:e.record.content,headingPath:e.record.headingPath,startLine:e.record.startLine,endLine:e.record.endLine}}function i(e){let t=new Map;for(let n of e)t.set(n.id,n);return[...t.values()]}export{t as DirectKBClient};

package/packages/kb-client/dist/index.d.ts

@@ -1,5 +0,0 @@
-import { IKBClient, KBGraphData, KBKnowledgeEntry, KBSearchResult, KBStatus } from "./types.js";
-import { DirectClientDeps, DirectKBClient } from "./direct-client.js";
-import { McpKBClient } from "./mcp-client.js";
-import { ParsedContent, extractStructured, extractText, parseToolResult, tryParseJson } from "./parsers.js";
-export { type DirectClientDeps, DirectKBClient, type IKBClient, type KBGraphData, type KBKnowledgeEntry, type KBSearchResult, type KBStatus, McpKBClient, type ParsedContent, extractStructured, extractText, parseToolResult, tryParseJson };

package/packages/kb-client/dist/index.js

@@ -1 +0,0 @@
-import{DirectKBClient as e}from"./direct-client.js";import{extractStructured as t,extractText as n,parseToolResult as r,tryParseJson as i}from"./parsers.js";import{McpKBClient as a}from"./mcp-client.js";export{e as DirectKBClient,a as McpKBClient,t as extractStructured,n as extractText,r as parseToolResult,i as tryParseJson};

package/packages/kb-client/dist/mcp-client.d.ts

@@ -1,19 +0,0 @@
-import { IKBClient, KBGraphData, KBKnowledgeEntry, KBSearchResult, KBStatus } from "./types.js";
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-
-//#region packages/kb-client/src/mcp-client.d.ts
-declare class McpKBClient implements IKBClient {
-  private readonly client;
-  constructor(client: Client);
-  getStatus(): Promise<KBStatus>;
-  search(query: string, options?: {
-    limit?: number;
-    mode?: 'hybrid' | 'semantic' | 'keyword';
-  }): Promise<KBSearchResult[]>;
-  listKnowledge(): Promise<KBKnowledgeEntry[]>;
-  readKnowledge(path: string): Promise<KBKnowledgeEntry | null>;
-  getGraph(query?: string): Promise<KBGraphData>;
-  getFileTree(): Promise<string[]>;
-}
-//#endregion
-export { McpKBClient };

package/packages/kb-client/dist/mcp-client.js

@@ -1,4 +0,0 @@
-import{extractStructured as e,extractText as t}from"./parsers.js";var n=class{constructor(e){this.client=e}async getStatus(){let e=await this.client.callTool({name:`status`,arguments:{}}),t=i(e);if(t)return{totalRecords:l(t.totalRecords),totalFiles:l(t.totalFiles),lastIndexedAt:d(t.lastIndexedAt),onboarded:!!t.onboarded};let n=r(e);return{totalRecords:a(n,/Records:\s*(\d+)/i),totalFiles:a(n,/Files:\s*(\d+)/i),lastIndexedAt:null,onboarded:!/not onboarded/i.test(n)}}async search(e,t){let n=await this.client.callTool({name:`search`,arguments:{query:e,limit:t?.limit??10,search_mode:t?.mode??`hybrid`}}),a=i(n);return a?.results?a.results.map(e=>({sourcePath:f(e.sourcePath??e.path),contentType:f(e.contentType,`unknown`),score:l(e.score),content:f(e.content??e.snippet),headingPath:p(e.headingPath),startLine:u(e.startLine),endLine:u(e.endLine)})):o(r(n))}async listKnowledge(){let e=i(await this.client.callTool({name:`list`,arguments:{}}));return e?.entries?e.entries.map(e=>({path:f(e.path),title:f(e.title),category:f(e.category),tags:m(e.tags),content:f(e.content)})):[]}async readKnowledge(e){try{let t=r(await this.client.callTool({name:`read`,arguments:{path:e}}));return!t||/not found/i.test(t)?null:{path:e,title:e.split(`/`).pop()??e,category:e.split(`/`).at(-2)??`uncategorized`,tags:[],content:t}}catch{return null}}async getGraph(e){let t=s(r(await this.client.callTool({name:`graph`,arguments:{action:`find_nodes`,...e?{name_pattern:e}:{},limit:500}})));return t.length===0?{nodes:[],edges:[]}:{nodes:t,edges:c(r(await this.client.callTool({name:`graph`,arguments:{action:`find_edges`,limit:1e3}})))}}async getFileTree(){let e=await this.client.callTool({name:`find`,arguments:{glob:`**/*`,limit:1e4}}),t=i(e);return t?.results?t.results.map(e=>typeof e==`string`?e:e.path??``).filter(e=>e.length>0):r(e).split(`
-`).map(e=>e.trim()).filter(e=>e.length>0)}};function r(e){return t(e)}function i(t){return e(t)}function a(e,t){let n=t.exec(e);return n?Number.parseInt(n[1],10):0}function o(e){let t=[],n=e.split(/\n(?=\d+\.\s|\*\*)/);for(let e of n){let n=/(?:\*\*|`)([^*`]+?)(?:\*\*|`)/.exec(e),r=/score:\s*([\d.]+)/i.exec(e);n&&t.push({sourcePath:n[1].trim(),contentType:`unknown`,score:r?Number.parseFloat(r[1]):0,content:e.replace(/^.*\n/,``).trim().slice(0,200)})}return t}function s(e){let t=[];for(let n of e.split(`
-`)){let e=/\*\*(.+?)\*\*\s*\(([^,)]+)(?:,\s*id:\s*`?([\w-]+)`?)?/.exec(n);e&&t.push({id:e[3]??`node-${t.length}`,name:e[1],type:e[2]})}return t}function c(e){let t=[];for(let n of e.split(`
-`)){let e=/`?([\w-]+)`?\s*[—-]+\[(\w+)\][→>]\s*`?([\w-]+)`?/.exec(n);e&&t.push({fromId:e[1],toId:e[3],type:e[2]})}return t}function l(e){return typeof e==`number`?e:0}function u(e){return typeof e==`number`?e:void 0}function d(e){return typeof e==`string`?e:null}function f(e,t=``){return typeof e==`string`?e:t}function p(e){return typeof e==`string`?e:void 0}function m(e){return Array.isArray(e)?e.filter(e=>typeof e==`string`):[]}export{n as McpKBClient};

package/packages/kb-client/dist/parsers.d.ts

@@ -1,35 +0,0 @@
-//#region packages/kb-client/src/parsers.d.ts
-/**
- * Content parsers for MCP tool responses.
- * Used by McpKBClient to parse structuredContent from tool calls.
- */
-interface ParsedContent<T = unknown> {
-  text: string;
-  structured?: T;
-}
-/**
- * Extract text content from an MCP tool result.
- */
-declare function extractText(result: {
-  content?: unknown;
-} | null | undefined): string;
-/**
- * Extract structured content from an MCP tool result.
- */
-declare function extractStructured<T>(result: {
-  structuredContent?: unknown;
-} | null | undefined): T | undefined;
-/**
- * Parse a tool result, returning both text and structured content.
- */
-declare function parseToolResult<T = unknown>(result: {
-  content?: unknown;
-  structuredContent?: unknown;
-} | null | undefined): ParsedContent<T>;
-/**
- * Try to parse JSON from a text tool result.
- * Returns undefined if parsing fails.
- */
-declare function tryParseJson<T = unknown>(text: string): T | undefined;
-//#endregion
-export { ParsedContent, extractStructured, extractText, parseToolResult, tryParseJson };

package/packages/kb-client/dist/parsers.js

@@ -1,2 +0,0 @@
-function e(e){return!Array.isArray(e?.content)||e.content.length===0?``:e.content.filter(e=>typeof e==`object`&&!!e).filter(e=>e.type===`text`&&typeof e.text==`string`).map(e=>e.text).join(`
-`)}function t(e){return e?.structuredContent}function n(n){return{text:e(n),structured:t(n)}}function r(e){try{return JSON.parse(e)}catch{return}}export{t as extractStructured,e as extractText,n as parseToolResult,r as tryParseJson};

package/packages/kb-client/dist/types.d.ts

@@ -1,62 +0,0 @@
-//#region packages/kb-client/src/types.d.ts
-/**
- * IKBClient — Unified data access interface for KB consumers.
- *
- * Implemented by:
- * - DirectKBClient (in-process, used by TUI)
- * - McpKBClient (over MCP transport, used by Dashboard)
- */
-interface KBStatus {
-  totalRecords: number;
-  totalFiles: number;
-  lastIndexedAt: string | null;
-  onboarded: boolean;
-}
-interface KBSearchResult {
-  sourcePath: string;
-  contentType: string;
-  score: number;
-  content: string;
-  headingPath?: string;
-  startLine?: number;
-  endLine?: number;
-}
-interface KBKnowledgeEntry {
-  path: string;
-  title: string;
-  category: string;
-  tags: string[];
-  content: string;
-}
-interface KBGraphData {
-  nodes: Array<{
-    id: string;
-    name: string;
-    type: string;
-    sourcePath?: string;
-  }>;
-  edges: Array<{
-    fromId: string;
-    toId: string;
-    type: string;
-  }>;
-}
-interface IKBClient {
-  /** Get KB status. */
-  getStatus(): Promise<KBStatus>;
-  /** Search the knowledge base. */
-  search(query: string, options?: {
-    limit?: number;
-    mode?: 'hybrid' | 'semantic' | 'keyword';
-  }): Promise<KBSearchResult[]>;
-  /** List curated knowledge entries. */
-  listKnowledge(): Promise<KBKnowledgeEntry[]>;
-  /** Read a specific curated entry. */
-  readKnowledge(path: string): Promise<KBKnowledgeEntry | null>;
-  /** Get knowledge graph data. */
-  getGraph(query?: string): Promise<KBGraphData>;
-  /** Get file tree of indexed sources. */
-  getFileTree(): Promise<string[]>;
-}
-//#endregion
-export { IKBClient, KBGraphData, KBKnowledgeEntry, KBSearchResult, KBStatus };

package/packages/kb-client/dist/types.js

@@ -1 +0,0 @@
-export{};