@compilr-dev/cli 0.5.3 → 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/repl-v2.js

@@ -19,7 +19,7 @@ import { initSessionRegistry, getSessionRegistry, setActiveTerminalSessionId, ge
 import { initFileLockManager } from './multi-agent/file-locks.js';
 import { initNotificationManager, getNotificationManager } from './multi-agent/notification-manager.js';
 import { getSessionsPath } from './settings/paths.js';
-import { setMetaToolFilter } from './tools.js';
+import { setMetaToolFilter, isMetaToolSilent, todoStore } from './tools.js';
 import { getCurrentProject } from './tools/project-db.js';
 import { TerminalUI } from './ui/terminal-ui.js';
 import * as terminal from './ui/terminal.js';
@@ -2357,7 +2357,7 @@ export class ReplV2 {
                                 this.ui.addBashCommand(event.toolUseId, command);
                             }
                             // Update spinner with tool name (skip silent tools)
-                            if (!this.agent?.isToolSilent(event.name)) {
+                            if (!this.agent?.isToolSilent(event.name) && !isMetaToolSilent(event.name)) {
                                 if (event.name === 'task' && event.toolUseId) {
                                     const subagentType = typeof lastToolInput.subagent_type === 'string'
                                         ? lastToolInput.subagent_type
@@ -2434,30 +2434,37 @@ export class ReplV2 {
                                 this.ui.setCurrentTool(null);
                                 continue;
                             }
-                            // Handle todo_write - update UI state
-                            if (toolName === 'todo_write' && toolInput && Array.isArray(toolInput.todos)) {
-                                const todos = toolInput.todos.map((t) => {
-                                    const content = typeof t.content === 'string' ? t.content :
-                                        typeof t.title === 'string' ? t.title :
-                                            typeof t.task === 'string' ? t.task :
-                                                typeof t.description === 'string' ? t.description :
-                                                    typeof t.text === 'string' ? t.text : 'Untitled task';
-                                    const status = (typeof t.status === 'string' && ['pending', 'in_progress', 'completed'].includes(t.status)
-                                        ? t.status
-                                        : 'pending');
-                                    const activeForm = typeof t.activeForm === 'string' ? t.activeForm : undefined;
-                                    const owner = typeof t.owner === 'string' ? t.owner : undefined;
-                                    const blockedBy = Array.isArray(t.blockedBy)
-                                        ? t.blockedBy.filter((n) => typeof n === 'number')
-                                        : undefined;
-                                    return { content, status, activeForm, owner, blockedBy };
+                            // Handle todo_write - update UI state from todoStore
+                            // (store is already updated by the tool's execute handler, regardless of
+                            // whether the tool was called directly or via the meta-registry fallback)
+                            if (toolName === 'todo_write') {
+                                // Get todos in creation order (getAll() sorts by status which breaks
+                                // task numbering — the footer renderer handles status sorting itself)
+                                const storeTodos = todoStore.getAll()
+                                    .sort((a, b) => {
+                                    const aNum = parseInt(a.id.replace('todo-', ''), 10);
+                                    const bNum = parseInt(b.id.replace('todo-', ''), 10);
+                                    return aNum - bNum;
                                 });
-                                this.ui.setTodos(todos);
+                                const allDone = storeTodos.length > 0 && storeTodos.every((t) => t.status === 'completed');
+                                if (allDone) {
+                                    this.ui.setTodos([]);
+                                }
+                                else {
+                                    this.ui.setTodos(storeTodos.map((t) => ({
+                                        content: t.content,
+                                        status: t.status,
+                                        activeForm: t.activeForm,
+                                        owner: t.owner,
+                                        blockedBy: t.blockedBy,
+                                    })));
+                                }
                                 this.ui.setCurrentTool(null);
                                 continue;
                             }
                             // Skip silent tools (no output needed)
-                            if (this.agent?.isToolSilent(toolName)) {
+                            // Check both direct registry and meta-registry for the silent flag
+                            if (this.agent?.isToolSilent(toolName) || isMetaToolSilent(toolName)) {
                                 this.ui.setCurrentTool(null);
                                 continue;
                             }

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

@@ -19,6 +19,11 @@ import { TodoStore, type Tool } from '@compilr-dev/sdk';
 export declare const todoStore: TodoStore;
 import { setMetaToolFilter, getRegisteredMetaTools } from './tools/meta-tools.js';
 export { setMetaToolFilter, getRegisteredMetaTools };
+/**
+ * Check if a tool in the meta-registry is marked as silent.
+ * Used by the repl to suppress output for warm tools like todo_write/todo_read.
+ */
+export declare function isMetaToolSilent(name: string): boolean;
 /**
  * Creates the tool registry with all available tools.
  * Returns tools as-is - the Agent.registerTools() method handles typing.
@@ -65,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,9 +129,18 @@ 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 };
+/**
+ * Check if a tool in the meta-registry is marked as silent.
+ * Used by the repl to suppress output for warm tools like todo_write/todo_read.
+ */
+export function isMetaToolSilent(name) {
+    const tools = getRegisteredMetaTools();
+    const tool = tools.find((t) => t.definition.name === name);
+    return tool?.silent === true;
+}
 // =============================================================================
 // DIRECT TOOLS - Always available, called by name
 // =============================================================================
@@ -315,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.3",
+  "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.22",
+    "@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.18",
+    "@compilr-dev/sdk": "^0.1.21",
     "@compilr-dev/ui-core": "^0.0.1",
     "@modelcontextprotocol/sdk": "^1.23.0",
     "better-sqlite3": "^12.5.0",