@compilr-dev/cli 0.5.4 → 0.5.5

package/dist/commands-v2/handlers/project.js

@@ -10,6 +10,25 @@ import { setCurrentProject, getCurrentProject } from '../../tools/project-db.js'
 import { getSkillPrompt } from '../../repl-helpers.js';
 import { getModelTier, modelMeetsTier } from '../../utils/model-tiers.js';
 import { getCurrentProjectIdForTracking, handleProjectSwitch } from './session.js';
+import { loadCapabilitiesForSkill } from '../../multi-agent/capability-loader.js';
+/**
+ * Load capabilities for a skill and warn about forbidden packs.
+ * Called before queuing a skill-driven agent message.
+ */
+function loadSkillCapabilities(skillName, ctx) {
+    const result = loadCapabilitiesForSkill(skillName);
+    if (!result)
+        return; // No capability loading active or no requirements
+    if (result.forbidden.length > 0) {
+        const suggestions = result.forbidden
+            .map((f) => `${f.packId}${f.suggestedAgent ? ` (try ${f.suggestedAgent})` : ''}`)
+            .join(', ');
+        ctx.ui.print({
+            type: 'warning',
+            message: `Some capabilities are restricted: ${suggestions}`,
+        });
+    }
+}
 // =============================================================================
 // Helper Functions
 // =============================================================================
@@ -335,6 +354,8 @@ export const designCommand = {
                     break;
             }
         }
+        // Load capabilities for the design skill
+        loadSkillCapabilities('design', ctx);
         // Get design skill prompt
         const designPrompt = getSkillPrompt('design');
         if (!designPrompt) {
@@ -384,6 +405,8 @@ export const sketchCommand = {
             ctx.ui.print({ type: 'error', message: 'No project selected. Run /new or /projects first.' });
             return Promise.resolve(true);
         }
+        // Load capabilities for the sketch skill
+        loadSkillCapabilities('sketch', ctx);
         // Get sketch skill prompt
         const sketchPrompt = getSkillPrompt('sketch');
         if (!sketchPrompt) {
@@ -474,8 +497,9 @@ export const refineCommand = {
                 }
             }
         }
-        // Get appropriate skill prompt
+        // Get appropriate skill prompt and load capabilities
         const skillName = isFocusedRefine ? 'refine-item' : 'refine';
+        loadSkillCapabilities(skillName, ctx);
         const refinePrompt = getSkillPrompt(skillName);
         if (!refinePrompt) {
             ctx.ui.print({ type: 'error', message: `${skillName} skill not found.` });
@@ -605,7 +629,8 @@ export const buildCommand = {
                 }
             }
         }
-        // Get build skill prompt and replace placeholders
+        // Load capabilities and get build skill prompt
+        loadSkillCapabilities('build', ctx);
         let buildPrompt = getSkillPrompt('build');
         if (!buildPrompt) {
             ctx.ui.print({ type: 'error', message: 'Build skill not found.' });
@@ -683,7 +708,8 @@ export const noteCommand = {
             ctx.ui.print({ type: 'error', message: 'No project selected. Run /new or /projects first.' });
             return Promise.resolve(true);
         }
-        // Get session-notes skill prompt
+        // Load capabilities and get session-notes skill prompt
+        loadSkillCapabilities('session-notes', ctx);
         const notePrompt = getSkillPrompt('session-notes');
         if (!notePrompt) {
             ctx.ui.print({ type: 'error', message: 'Session-notes skill not found.' });
@@ -741,7 +767,8 @@ export const prdCommand = {
             ctx.ui.print({ type: 'error', message: 'No project selected. Run /new or /projects first.' });
             return Promise.resolve(true);
         }
-        // Get PRD skill prompt
+        // Load capabilities and get PRD skill prompt
+        loadSkillCapabilities('prd', ctx);
         const prdPrompt = getSkillPrompt('prd');
         if (!prdPrompt) {
             ctx.ui.print({ type: 'error', message: 'PRD skill not found.' });
@@ -866,6 +893,8 @@ export const scaffoldCommand = {
         else {
             skillName = 'scaffold';
         }
+        // Load capability packs for this skill
+        loadSkillCapabilities(skillName, ctx);
         // Get skill prompt and replace path placeholder
         let scaffoldPrompt = getSkillPrompt(skillName);
         if (!scaffoldPrompt) {
@@ -946,7 +975,8 @@ export const archCommand = {
             // User cancelled
             return true;
         }
-        // Get architecture skill prompt
+        // Load capabilities and get architecture skill prompt
+        loadSkillCapabilities('architecture', ctx);
         const archPrompt = getSkillPrompt('architecture');
         if (!archPrompt) {
             ctx.ui.print({ type: 'error', message: 'Architecture skill not found.' });

package/dist/multi-agent/capability-loader.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Capability Loader — Bridge between slash commands and the CapabilityManager.
+ *
+ * Stores a module-level reference to the current CapabilityManager
+ * (set by agent.ts during createAgent()). Provides a high-level function
+ * for slash command handlers to load capability packs required by a skill.
+ */
+import type { CapabilityManager, CapabilityLoadResult } from '@compilr-dev/sdk';
+/**
+ * Set the current CapabilityManager instance.
+ * Called by createAgent() after constructing the manager.
+ */
+export declare function setCapabilityManager(manager: CapabilityManager | null): void;
+/**
+ * Get the current CapabilityManager instance.
+ * Returns null if capability loading is not active.
+ */
+export declare function getCapabilityManager(): CapabilityManager | null;
+/**
+ * Load capability packs required by a skill invocation.
+ *
+ * Maps the skill's required + optional tool names to capability pack IDs,
+ * then loads each loadable pack. Returns a result indicating what was loaded,
+ * what was already loaded, and what is forbidden.
+ *
+ * @param skillName - Skill name (e.g., 'design', 'build', 'refactor')
+ * @returns Load result, or null if capability loading is not active or skill has no requirements
+ */
+export declare function loadCapabilitiesForSkill(skillName: string): CapabilityLoadResult | null;

package/dist/multi-agent/capability-loader.js

@@ -0,0 +1,54 @@
+/**
+ * Capability Loader — Bridge between slash commands and the CapabilityManager.
+ *
+ * Stores a module-level reference to the current CapabilityManager
+ * (set by agent.ts during createAgent()). Provides a high-level function
+ * for slash command handlers to load capability packs required by a skill.
+ */
+import { SKILL_REQUIREMENTS } from './skill-requirements.js';
+// =============================================================================
+// Module-level state
+// =============================================================================
+let currentManager = null;
+/**
+ * Set the current CapabilityManager instance.
+ * Called by createAgent() after constructing the manager.
+ */
+export function setCapabilityManager(manager) {
+    currentManager = manager;
+}
+/**
+ * Get the current CapabilityManager instance.
+ * Returns null if capability loading is not active.
+ */
+export function getCapabilityManager() {
+    return currentManager;
+}
+// =============================================================================
+// Skill-based capability loading
+// =============================================================================
+/**
+ * Load capability packs required by a skill invocation.
+ *
+ * Maps the skill's required + optional tool names to capability pack IDs,
+ * then loads each loadable pack. Returns a result indicating what was loaded,
+ * what was already loaded, and what is forbidden.
+ *
+ * @param skillName - Skill name (e.g., 'design', 'build', 'refactor')
+ * @returns Load result, or null if capability loading is not active or skill has no requirements
+ */
+export function loadCapabilitiesForSkill(skillName) {
+    if (!currentManager) {
+        return null;
+    }
+    if (!(skillName in SKILL_REQUIREMENTS)) {
+        return null;
+    }
+    const requirements = SKILL_REQUIREMENTS[skillName];
+    // Combine required + optional tools
+    const allTools = [
+        ...requirements.required,
+        ...(requirements.optional ?? []),
+    ];
+    return currentManager.loadForSkill(allTools, 'slash-command');
+}

package/dist/tool-names.d.ts

@@ -97,6 +97,7 @@ export declare const TOOL_NAMES: {
     readonly APP_MODEL_VALIDATE: "app_model_validate";
     readonly FACTORY_SCAFFOLD: "factory_scaffold";
     readonly FACTORY_LIST_TOOLKITS: "factory_list_toolkits";
+    readonly LOAD_CAPABILITY: "load_capability";
 };
 /** Type for all valid tool names */
 export type ToolName = (typeof TOOL_NAMES)[keyof typeof TOOL_NAMES];

package/dist/tool-names.js

@@ -118,6 +118,8 @@ export const TOOL_NAMES = {
     APP_MODEL_VALIDATE: 'app_model_validate',
     FACTORY_SCAFFOLD: 'factory_scaffold',
     FACTORY_LIST_TOOLKITS: 'factory_list_toolkits',
+    // Capability loading
+    LOAD_CAPABILITY: 'load_capability',
 };
 /** Array of all direct tool names (always available) */
 export const DIRECT_TOOL_NAMES = [

package/dist/tools/meta-tools.d.ts

@@ -23,4 +23,9 @@ export declare const getToolInfoTool: Tool<object>;
 export declare const useToolTool: Tool<object>;
 export declare const metaTools: Tool<object>[];
 export declare function createMetaToolFallback(): (name: string, input: Record<string, unknown>) => Promise<ToolExecutionResult | null>;
+/**
+ * Generate a filtered tool index showing only tools in the given set.
+ * Sets the registry filter, generates the index, then restores the previous filter.
+ */
+export declare function generateFilteredToolIndex(activeToolNames: string[]): string;
 export declare const META_TOOLS_SYSTEM_PROMPT_PREFIX = "\n## Tool Index (Specialized Tools)\n\nThese tools are called **exactly like direct tools** \u2014 just use the tool name with parameters. No special syntax or wrapper needed. The system routes them automatically.\n\n**IMPORTANT \u2014 These are CLI system tools, NOT your project's backend. Never use localhost/curl to access them.**\n\n**Parameter Rules:**\n- For **zero-parameter calls**: call the tool directly (e.g., `workitem_query()`, `git_status()`).\n- For **calls WITH parameters**: you MUST call `get_tool_info(\"tool_name\")` first to get parameter details. The signatures below are summaries only \u2014 do NOT guess parameter structure from them.\n- After a failed tool call, always call `get_tool_info()` before retrying.\n\n";

package/dist/tools/meta-tools.js

@@ -44,4 +44,15 @@ export const metaTools = [listToolsTool, getToolInfoTool, useToolTool];
 export function createMetaToolFallback() {
     return metaToolSet.createFallback();
 }
+/**
+ * Generate a filtered tool index showing only tools in the given set.
+ * Sets the registry filter, generates the index, then restores the previous filter.
+ */
+export function generateFilteredToolIndex(activeToolNames) {
+    const previousFilter = registry.getFilter();
+    registry.setFilter(activeToolNames);
+    const index = registry.generateToolIndex();
+    registry.setFilter(previousFilter ? [...previousFilter] : null);
+    return index;
+}
 export const META_TOOLS_SYSTEM_PROMPT_PREFIX = SDK_META_TOOLS_SYSTEM_PROMPT_PREFIX;

package/dist/tools.d.ts

@@ -70,6 +70,12 @@ export declare function initializeMetaTools(includeWarmTools?: boolean): void;
  * This lists all meta-registry tools with their signatures.
  */
 export declare function getToolIndexForSystemPrompt(): string;
+/**
+ * Get a filtered tool index for the system prompt.
+ * Only includes tools whose names are in the given set.
+ * Used by the capability-aware BeforeLLM hook.
+ */
+export declare function getFilteredToolIndexForSystemPrompt(activeToolNames: string[]): string;
 /**
  * Get count of meta-registry tools.
  */

package/dist/tools.js

@@ -129,7 +129,7 @@ import { guideTool } from './tools/guide-tool.js';
 // DB tools for project, work item, document, plan, backlog, anchor, artifact, and episode management
 import { allDbTools, allFactoryTools } from './tools/db-tools.js';
 // Meta-tools for dynamic tool loading
-import { initializeMetaToolRegistry, generateToolIndex, getMetaToolCount, META_TOOLS_SYSTEM_PROMPT_PREFIX, setMetaToolFilter, getRegisteredMetaTools, createMetaToolFallback, getToolInfoTool, } from './tools/meta-tools.js';
+import { initializeMetaToolRegistry, generateToolIndex, generateFilteredToolIndex, getMetaToolCount, META_TOOLS_SYSTEM_PROMPT_PREFIX, setMetaToolFilter, getRegisteredMetaTools, createMetaToolFallback, getToolInfoTool, } from './tools/meta-tools.js';
 // Re-export for use in agent.ts
 export { setMetaToolFilter, getRegisteredMetaTools };
 /**
@@ -324,6 +324,14 @@ export function initializeMetaTools(includeWarmTools) {
 export function getToolIndexForSystemPrompt() {
     return META_TOOLS_SYSTEM_PROMPT_PREFIX + generateToolIndex();
 }
+/**
+ * Get a filtered tool index for the system prompt.
+ * Only includes tools whose names are in the given set.
+ * Used by the capability-aware BeforeLLM hook.
+ */
+export function getFilteredToolIndexForSystemPrompt(activeToolNames) {
+    return META_TOOLS_SYSTEM_PROMPT_PREFIX + generateFilteredToolIndex(activeToolNames);
+}
 /**
  * Get count of meta-registry tools.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/cli",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "AI-powered coding assistant CLI using @compilr-dev/agents",
   "type": "module",
   "main": "dist/index.js",
@@ -54,11 +54,11 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.74.0",
-    "@compilr-dev/agents": "^0.3.23",
+    "@compilr-dev/agents": "^0.3.24",
     "@compilr-dev/agents-coding": "^1.0.4",
     "@compilr-dev/editor-core": "^0.0.2",
     "@compilr-dev/factory": "^0.1.12",
-    "@compilr-dev/sdk": "^0.1.20",
+    "@compilr-dev/sdk": "^0.1.21",
     "@compilr-dev/ui-core": "^0.0.1",
     "@modelcontextprotocol/sdk": "^1.23.0",
     "better-sqlite3": "^12.5.0",