@compilr-dev/cli 0.5.0 → 0.5.2

package/dist/tool-names.js

@@ -0,0 +1,239 @@
+/**
+ * Tool Names - Single Source of Truth
+ *
+ * This file contains ONLY tool name constants with NO imports.
+ * This breaks circular dependency chains and ensures all modules
+ * can safely import tool names.
+ *
+ * Import from here instead of tools.ts when you only need the names.
+ */
+// =============================================================================
+// TOOL NAMES (Single Source of Truth)
+// =============================================================================
+/**
+ * All tool names as constants. Import these instead of hardcoding strings.
+ * This ensures all tool references stay in sync across the codebase.
+ */
+export const TOOL_NAMES = {
+    // Direct tools (always available)
+    READ_FILE: 'read_file',
+    WRITE_FILE: 'write_file',
+    EDIT: 'edit',
+    BASH: 'bash',
+    BASH_OUTPUT: 'bash_output',
+    KILL_SHELL: 'kill_shell',
+    GLOB: 'glob',
+    GREP: 'grep',
+    TODO_WRITE: 'todo_write',
+    TODO_READ: 'todo_read',
+    TODO_CLAIM: 'todo_claim',
+    TODO_HANDOFF: 'todo_handoff',
+    ASK_USER: 'ask_user',
+    ASK_USER_SIMPLE: 'ask_user_simple',
+    DELEGATE: 'delegate',
+    DELEGATE_BACKGROUND: 'delegate_background',
+    DELEGATION_STATUS: 'delegation_status',
+    HANDOFF: 'handoff',
+    COMPILR_GUIDE: 'compilr_guide',
+    TASK: 'task',
+    SUGGEST: 'suggest',
+    // Meta-tools
+    LIST_TOOLS: 'list_tools',
+    GET_TOOL_INFO: 'get_tool_info',
+    USE_TOOL: 'use_tool',
+    // Git operations (meta-registry)
+    GIT_STATUS: 'git_status',
+    GIT_DIFF: 'git_diff',
+    GIT_LOG: 'git_log',
+    GIT_COMMIT: 'git_commit',
+    GIT_BRANCH: 'git_branch',
+    GIT_STASH: 'git_stash',
+    GIT_BLAME: 'git_blame',
+    GIT_FILE_HISTORY: 'git_file_history',
+    // Project detection (meta-registry)
+    DETECT_PROJECT: 'detect_project',
+    FIND_PROJECT_ROOT: 'find_project_root',
+    // Runners (meta-registry)
+    RUN_TESTS: 'run_tests',
+    RUN_LINT: 'run_lint',
+    RUN_BUILD: 'run_build',
+    RUN_FORMAT: 'run_format',
+    // Code search (meta-registry)
+    FIND_DEFINITION: 'find_definition',
+    FIND_REFERENCES: 'find_references',
+    FIND_TODOS: 'find_todos',
+    // Dependency analysis (meta-registry)
+    CHECK_OUTDATED: 'check_outdated',
+    FIND_VULNERABILITIES: 'find_vulnerabilities',
+    ANALYZE_TEST_COVERAGE: 'analyze_test_coverage',
+    // Unified analysis (meta-registry)
+    GET_FILE_STRUCTURE: 'get_file_structure',
+    GET_COMPLEXITY: 'get_complexity',
+    // Smart file reading (meta-registry)
+    READ_FUNCTION: 'read_function',
+    READ_CLASS: 'read_class',
+    READ_TYPE: 'read_type',
+    // Backlog wrappers (meta-registry)
+    BACKLOG_READ: 'backlog_read',
+    BACKLOG_WRITE: 'backlog_write',
+    // Work item tools (meta-registry)
+    WORKITEM_ADD: 'workitem_add',
+    WORKITEM_UPDATE: 'workitem_update',
+    WORKITEM_DELETE: 'workitem_delete',
+    WORKITEM_QUERY: 'workitem_query',
+    WORKITEM_NEXT: 'workitem_next',
+    WORKITEM_ADVANCE_STEP: 'workitem_advance_step',
+    WORKITEM_STATUS_COUNTS: 'workitem_status_counts',
+    WORKITEM_CLAIM: 'workitem_claim',
+    WORKITEM_HANDOFF: 'workitem_handoff',
+    // Project DB tools (meta-registry)
+    PROJECT_GET: 'project_get',
+    PROJECT_LIST: 'project_list',
+    PROJECT_UPDATE: 'project_update',
+    // Document tools (meta-registry)
+    PROJECT_DOCUMENT_ADD: 'project_document_add',
+    PROJECT_DOCUMENT_GET: 'project_document_get',
+    PROJECT_DOCUMENT_LIST: 'project_document_list',
+    PROJECT_DOCUMENT_DELETE: 'project_document_delete',
+    // Plan tools (meta-registry)
+    PLAN_CREATE: 'plan_create',
+    PLAN_UPDATE: 'plan_update',
+    PLAN_GET: 'plan_get',
+    PLAN_LIST: 'plan_list',
+    PLAN_DELETE: 'plan_delete',
+    // Anchor tools (meta-registry)
+    ANCHOR_ADD: 'anchor_add',
+    ANCHOR_LIST: 'anchor_list',
+    ANCHOR_REMOVE: 'anchor_remove',
+    // Artifact tools (meta-registry)
+    ARTIFACT_SAVE: 'artifact_save',
+    ARTIFACT_GET: 'artifact_get',
+    ARTIFACT_LIST: 'artifact_list',
+    ARTIFACT_DELETE: 'artifact_delete',
+    // Episode tools (meta-registry)
+    RECALL_WORK: 'recall_work',
+    // Factory tools (meta-registry)
+    APP_MODEL_GET: 'app_model_get',
+    APP_MODEL_UPDATE: 'app_model_update',
+    APP_MODEL_VALIDATE: 'app_model_validate',
+    FACTORY_SCAFFOLD: 'factory_scaffold',
+    FACTORY_LIST_TOOLKITS: 'factory_list_toolkits',
+};
+/** Array of all direct tool names (always available) */
+export const DIRECT_TOOL_NAMES = [
+    TOOL_NAMES.READ_FILE,
+    TOOL_NAMES.WRITE_FILE,
+    TOOL_NAMES.EDIT,
+    TOOL_NAMES.BASH,
+    TOOL_NAMES.BASH_OUTPUT,
+    TOOL_NAMES.KILL_SHELL,
+    TOOL_NAMES.GLOB,
+    TOOL_NAMES.GREP,
+    TOOL_NAMES.TODO_WRITE,
+    TOOL_NAMES.TODO_READ,
+    TOOL_NAMES.TODO_CLAIM,
+    TOOL_NAMES.TODO_HANDOFF,
+    TOOL_NAMES.ASK_USER,
+    TOOL_NAMES.ASK_USER_SIMPLE,
+    TOOL_NAMES.DELEGATE,
+    TOOL_NAMES.DELEGATE_BACKGROUND,
+    TOOL_NAMES.HANDOFF,
+    TOOL_NAMES.COMPILR_GUIDE,
+    TOOL_NAMES.TASK,
+    TOOL_NAMES.SUGGEST,
+];
+/** Array of all meta-tool names (tool discovery) */
+export const META_TOOL_NAMES = [
+    TOOL_NAMES.LIST_TOOLS,
+    TOOL_NAMES.GET_TOOL_INFO,
+    TOOL_NAMES.USE_TOOL,
+];
+/** Array of all meta-registry tool names (accessed via use_tool) */
+export const META_REGISTRY_TOOL_NAMES = [
+    // Git
+    TOOL_NAMES.GIT_STATUS,
+    TOOL_NAMES.GIT_DIFF,
+    TOOL_NAMES.GIT_LOG,
+    TOOL_NAMES.GIT_COMMIT,
+    TOOL_NAMES.GIT_BRANCH,
+    TOOL_NAMES.GIT_STASH,
+    TOOL_NAMES.GIT_BLAME,
+    TOOL_NAMES.GIT_FILE_HISTORY,
+    // Project
+    TOOL_NAMES.DETECT_PROJECT,
+    TOOL_NAMES.FIND_PROJECT_ROOT,
+    // Runners
+    TOOL_NAMES.RUN_TESTS,
+    TOOL_NAMES.RUN_LINT,
+    TOOL_NAMES.RUN_BUILD,
+    TOOL_NAMES.RUN_FORMAT,
+    // Code search
+    TOOL_NAMES.FIND_DEFINITION,
+    TOOL_NAMES.FIND_REFERENCES,
+    TOOL_NAMES.FIND_TODOS,
+    // Dependencies
+    TOOL_NAMES.CHECK_OUTDATED,
+    TOOL_NAMES.FIND_VULNERABILITIES,
+    TOOL_NAMES.ANALYZE_TEST_COVERAGE,
+    // Analysis
+    TOOL_NAMES.GET_FILE_STRUCTURE,
+    TOOL_NAMES.GET_COMPLEXITY,
+    // Smart file reading
+    TOOL_NAMES.READ_FUNCTION,
+    TOOL_NAMES.READ_CLASS,
+    TOOL_NAMES.READ_TYPE,
+    // Backlog
+    TOOL_NAMES.BACKLOG_READ,
+    TOOL_NAMES.BACKLOG_WRITE,
+    // Work items
+    TOOL_NAMES.WORKITEM_ADD,
+    TOOL_NAMES.WORKITEM_UPDATE,
+    TOOL_NAMES.WORKITEM_DELETE,
+    TOOL_NAMES.WORKITEM_QUERY,
+    TOOL_NAMES.WORKITEM_NEXT,
+    TOOL_NAMES.WORKITEM_ADVANCE_STEP,
+    TOOL_NAMES.WORKITEM_STATUS_COUNTS,
+    TOOL_NAMES.WORKITEM_CLAIM,
+    TOOL_NAMES.WORKITEM_HANDOFF,
+    // Projects
+    TOOL_NAMES.PROJECT_GET,
+    TOOL_NAMES.PROJECT_LIST,
+    TOOL_NAMES.PROJECT_UPDATE,
+    // Documents
+    TOOL_NAMES.PROJECT_DOCUMENT_ADD,
+    TOOL_NAMES.PROJECT_DOCUMENT_GET,
+    TOOL_NAMES.PROJECT_DOCUMENT_LIST,
+    TOOL_NAMES.PROJECT_DOCUMENT_DELETE,
+    // Plans
+    TOOL_NAMES.PLAN_CREATE,
+    TOOL_NAMES.PLAN_UPDATE,
+    TOOL_NAMES.PLAN_GET,
+    TOOL_NAMES.PLAN_LIST,
+    TOOL_NAMES.PLAN_DELETE,
+    // Anchors
+    TOOL_NAMES.ANCHOR_ADD,
+    TOOL_NAMES.ANCHOR_LIST,
+    TOOL_NAMES.ANCHOR_REMOVE,
+    // Artifacts
+    TOOL_NAMES.ARTIFACT_SAVE,
+    TOOL_NAMES.ARTIFACT_GET,
+    TOOL_NAMES.ARTIFACT_LIST,
+    TOOL_NAMES.ARTIFACT_DELETE,
+    // Episodes
+    TOOL_NAMES.RECALL_WORK,
+    // Delegation
+    TOOL_NAMES.DELEGATION_STATUS,
+    // Factory
+    TOOL_NAMES.APP_MODEL_GET,
+    TOOL_NAMES.APP_MODEL_UPDATE,
+    TOOL_NAMES.APP_MODEL_VALIDATE,
+    TOOL_NAMES.FACTORY_SCAFFOLD,
+    TOOL_NAMES.FACTORY_LIST_TOOLKITS,
+];
+/**
+ * Get all tool names as an array.
+ * Useful for validation or iteration.
+ */
+export function getAllToolNames() {
+    return Object.values(TOOL_NAMES);
+}

package/dist/tools/ask-user-simple.d.ts

@@ -15,5 +15,5 @@ interface AskUserSimpleInput {
     /** Allow free-text input (default: true) */
     allowCustom?: boolean;
 }
-export declare const askUserSimpleTool: import("@compilr-dev/agents").Tool<AskUserSimpleInput>;
+export declare const askUserSimpleTool: import("@compilr-dev/sdk").Tool<AskUserSimpleInput>;
 export {};

package/dist/tools/ask-user-simple.js

@@ -7,7 +7,7 @@
  *
  * Used by /sketch command for quick project outlines.
  */
-import { defineTool } from '@compilr-dev/agents';
+import { defineTool } from '@compilr-dev/sdk';
 import { getAskUserSimpleHandler } from '../shared-handlers.js';
 // =============================================================================
 // Tool Definition
@@ -83,4 +83,5 @@ export const askUserSimpleTool = defineTool({
             };
         }
     },
+    silent: true,
 });

package/dist/tools/ask-user.d.ts

@@ -28,5 +28,5 @@ interface AskUserInput {
     /** Optional context shown above questions */
     context?: string;
 }
-export declare const askUserTool: import("@compilr-dev/agents").Tool<AskUserInput>;
+export declare const askUserTool: import("@compilr-dev/sdk").Tool<AskUserInput>;
 export {};

package/dist/tools/ask-user.js

@@ -8,7 +8,7 @@
  * The actual overlay is shown via getAskUserHandler() from shared-handlers.ts
  * which is registered during app initialization and properly pauses the footer.
  */
-import { defineTool } from '@compilr-dev/agents';
+import { defineTool } from '@compilr-dev/sdk';
 import { getAskUserHandler } from '../shared-handlers.js';
 // =============================================================================
 // Tool Definition
@@ -110,4 +110,5 @@ export const askUserTool = defineTool({
             };
         }
     },
+    silent: true,
 });

package/dist/tools/backlog.d.ts

@@ -34,7 +34,7 @@ interface BacklogReadInput {
     search?: string;
     id?: string;
 }
-export declare const backlogReadTool: import("@compilr-dev/agents").Tool<BacklogReadInput>;
+export declare const backlogReadTool: import("@compilr-dev/sdk").Tool<BacklogReadInput>;
 interface BacklogWriteInput {
     action: 'add' | 'update' | 'remove' | 'reorder';
     items?: Array<{
@@ -49,5 +49,5 @@ interface BacklogWriteInput {
     ids?: string[];
     order?: string[];
 }
-export declare const backlogWriteTool: import("@compilr-dev/agents").Tool<BacklogWriteInput>;
+export declare const backlogWriteTool: import("@compilr-dev/sdk").Tool<BacklogWriteInput>;
 export {};

package/dist/tools/backlog.js

@@ -6,7 +6,7 @@
  */
 import * as fs from 'fs';
 import * as path from 'path';
-import { defineTool } from '@compilr-dev/agents';
+import { defineTool } from '@compilr-dev/sdk';
 // =============================================================================
 // Backlog File Detection
 // =============================================================================

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

@@ -1,65 +1,17 @@
 /**
  * Database Tools Index
  *
- * Exports all database-related tools for project, work item, and document management.
+ * All 24 platform tools (project, workitem, document, plan, backlog) are now
+ * provided by the SDK via platform-adapter.ts. This file re-exports them
+ * along with state management functions still needed by ~15+ CLI files.
  */
-export { projectDbTools, projectGetTool, projectCreateTool, projectUpdateTool, projectListTool, getActiveProject, setActiveProject } from './project-db.js';
-export { workitemDbTools, workitemQueryTool, workitemAddTool, workitemUpdateTool, workitemNextTool, workitemDeleteTool, workitemStatusCountsTool } from './workitem-db.js';
-export { documentDbTools, projectDocumentAddTool, projectDocumentGetTool, projectDocumentListTool, projectDocumentDeleteTool } from './document-db.js';
-export declare const allDbTools: (import("@compilr-dev/agents").Tool<{
-    project_id?: number;
-    name?: string;
-    path?: string;
-}> | import("@compilr-dev/agents").Tool<{
-    name: string;
-    display_name: string;
-    description?: string;
-    path?: string;
-    type?: string;
-    workflow_mode?: string;
-    language?: string;
-    framework?: string;
-    package_manager?: string;
-}> | import("@compilr-dev/agents").Tool<{
-    project_id?: number;
-    status?: string;
-    description?: string;
-    workflow_mode?: string;
-    lifecycle_state?: string;
-    current_item_id?: string;
-    last_context?: Record<string, unknown>;
-}> | import("@compilr-dev/agents").Tool<{
-    project_id?: number;
-    status?: string;
-    type?: string;
-    priority?: string;
-    search?: string;
-    limit?: number;
-    offset?: number;
-}> | import("@compilr-dev/agents").Tool<{
-    project_id?: number;
-    type: string;
-    title: string;
-    description?: string;
-    priority?: string;
-    estimated_effort?: string;
-}> | import("@compilr-dev/agents").Tool<{
-    item_id: string;
-    project_id?: number;
-    status?: string;
-    priority?: string;
-    guided_step?: string;
-    title?: string;
-    description?: string;
-    commit_hash?: string;
-}> | import("@compilr-dev/agents").Tool<{
-    item_id: string;
-    reason: string;
-    force?: boolean;
-    project_id?: number;
-}> | import("@compilr-dev/agents").Tool<{
-    project_id?: number;
-    doc_type: string;
-    title: string;
-    content: string;
-}>)[];
+import { allFactoryTools } from './platform-adapter.js';
+export { getActiveProject, setActiveProject } from './project-db.js';
+/**
+ * All database tools combined (32 tools from SDK)
+ */
+export declare const allDbTools: import("@compilr-dev/agents").Tool<never>[];
+/**
+ * All factory tools (5 tools from @compilr-dev/factory)
+ */
+export { allFactoryTools };

package/dist/tools/db-tools.js

@@ -1,19 +1,18 @@
 /**
  * Database Tools Index
  *
- * Exports all database-related tools for project, work item, and document management.
+ * All 24 platform tools (project, workitem, document, plan, backlog) are now
+ * provided by the SDK via platform-adapter.ts. This file re-exports them
+ * along with state management functions still needed by ~15+ CLI files.
  */
-export { projectDbTools, projectGetTool, projectCreateTool, projectUpdateTool, projectListTool, getActiveProject, setActiveProject } from './project-db.js';
-export { workitemDbTools, workitemQueryTool, workitemAddTool, workitemUpdateTool, workitemNextTool, workitemDeleteTool, workitemStatusCountsTool } from './workitem-db.js';
-export { documentDbTools, projectDocumentAddTool, projectDocumentGetTool, projectDocumentListTool, projectDocumentDeleteTool } from './document-db.js';
+import { allPlatformTools, allFactoryTools } from './platform-adapter.js';
+// Re-export state management functions (still needed by many CLI files)
+export { getActiveProject, setActiveProject } from './project-db.js';
 /**
- * All database tools combined
+ * All database tools combined (32 tools from SDK)
  */
-import { projectDbTools } from './project-db.js';
-import { workitemDbTools } from './workitem-db.js';
-import { documentDbTools } from './document-db.js';
-export const allDbTools = [
-    ...projectDbTools,
-    ...workitemDbTools,
-    ...documentDbTools,
-];
+export const allDbTools = allPlatformTools;
+/**
+ * All factory tools (5 tools from @compilr-dev/factory)
+ */
+export { allFactoryTools };

package/dist/tools/delegate-background.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Delegate Background Tool - Coordinator Mode
+ *
+ * Allows the coordinator to delegate tasks to specialists running in background.
+ * Unlike the foreground `delegate` tool (which switches the active agent),
+ * this tool keeps the coordinator in the foreground while the specialist
+ * works independently in the background.
+ *
+ * Flow:
+ * 1. Coordinator calls delegate_background(agentId, task)
+ * 2. DelegationTracker registers the delegation
+ * 3. Specialist starts as background agent (or queued if busy)
+ * 4. Coordinator continues working
+ * 5. On completion, coordinator is notified via completion events (Phase 2)
+ */
+interface DelegateBackgroundInput {
+    /** Target specialist agent ID (e.g., 'arch', 'dev', 'qa') */
+    agentId: string;
+    /** Detailed task description for the specialist */
+    task: string;
+    /** Optional todo index to associate with this delegation */
+    todoIndex?: number;
+    /** What the specialist should produce (e.g., "architecture document") */
+    expectedOutput?: string;
+}
+export declare const delegateBackgroundTool: import("@compilr-dev/sdk").Tool<DelegateBackgroundInput>;
+export {};

package/dist/tools/delegate-background.js

@@ -0,0 +1,115 @@
+/**
+ * Delegate Background Tool - Coordinator Mode
+ *
+ * Allows the coordinator to delegate tasks to specialists running in background.
+ * Unlike the foreground `delegate` tool (which switches the active agent),
+ * this tool keeps the coordinator in the foreground while the specialist
+ * works independently in the background.
+ *
+ * Flow:
+ * 1. Coordinator calls delegate_background(agentId, task)
+ * 2. DelegationTracker registers the delegation
+ * 3. Specialist starts as background agent (or queued if busy)
+ * 4. Coordinator continues working
+ * 5. On completion, coordinator is notified via completion events (Phase 2)
+ */
+import { defineTool } from '@compilr-dev/sdk';
+import { getDelegateBackgroundHandler } from '../shared-handlers.js';
+// =============================================================================
+// Tool Definition
+// =============================================================================
+export const delegateBackgroundTool = defineTool({
+    name: 'delegate_background',
+    description: 'Delegate a task to a specialist running in background. ' +
+        'The specialist executes independently while you continue working. ' +
+        'You will be notified when the specialist completes. ' +
+        'Use delegation_status to check progress. ' +
+        'Prefer this over delegate — it keeps you in control and tracks status. ' +
+        'Only available to the coordinator.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            agentId: {
+                type: 'string',
+                description: 'Target specialist agent ID (e.g., "arch", "dev", "qa")',
+            },
+            task: {
+                type: 'string',
+                description: 'Detailed task description for the specialist',
+            },
+            todoIndex: {
+                type: 'number',
+                description: 'Optional todo index to associate with this delegation',
+            },
+            expectedOutput: {
+                type: 'string',
+                description: 'What the specialist should produce (e.g., "architecture document", "implementation")',
+            },
+        },
+        required: ['agentId', 'task'],
+    },
+    execute: async (input) => {
+        try {
+            // Validate input
+            if (!input.agentId || input.agentId.trim().length === 0) {
+                return {
+                    success: false,
+                    error: 'Agent ID is required',
+                };
+            }
+            if (!input.task || input.task.trim().length === 0) {
+                return {
+                    success: false,
+                    error: 'Task description is required',
+                };
+            }
+            // Prevent self-delegation
+            if (input.agentId.trim() === 'default') {
+                return {
+                    success: false,
+                    error: 'Cannot delegate to yourself (the coordinator). Delegate to a specialist agent.',
+                };
+            }
+            // Get the delegate background handler from shared-handlers
+            const handler = getDelegateBackgroundHandler();
+            if (!handler) {
+                return {
+                    success: false,
+                    error: 'Delegate background handler not initialized. ' +
+                        'This tool requires multi-agent mode with coordinator role.',
+                };
+            }
+            // Execute background delegation
+            const result = await handler({
+                agentId: input.agentId.trim(),
+                task: input.task.trim(),
+                todoIndex: input.todoIndex,
+                expectedOutput: input.expectedOutput?.trim(),
+            });
+            if (result.error) {
+                return {
+                    success: false,
+                    error: result.error,
+                };
+            }
+            const output = {
+                delegated: true,
+                delegationId: result.delegationId,
+                status: result.status,
+                message: result.status === 'queued'
+                    ? `Task queued for $${input.agentId} (currently busy). It will start when they're free.`
+                    : `Task delegated to $${input.agentId} running in background. You'll be notified on completion.`,
+            };
+            return {
+                success: true,
+                result: output,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: `Background delegation failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    },
+});

package/dist/tools/delegate.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Delegate Tool - Multi-Agent Task Delegation
+ *
+ * Allows the coordinator to delegate tasks to specialist agents.
+ * Only available to the coordinator (default agent).
+ *
+ * Flow:
+ * 1. Coordinator calls delegate(agentId, task, reason?)
+ * 2. CLI shows approval prompt
+ * 3. If approved: auto-switch to specialist, inject task
+ * 4. If denied: return "User declined" to coordinator
+ */
+interface DelegateInput {
+    /** Target agent ID (e.g., 'arch', 'dev', 'qa') */
+    agentId: string;
+    /** Task description for the specialist */
+    task: string;
+    /** Optional reason for delegation (shown to user for context) */
+    reason?: string;
+}
+export declare const delegateTool: import("@compilr-dev/sdk").Tool<DelegateInput>;
+export {};