@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/tool-names.js

@@ -0,0 +1,227 @@
+/**
+ * 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',
+};
+/** 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,
+];
+/**
+ * Get all tool names as an array.
+ * Useful for validation or iteration.
+ */
+export function getAllToolNames() {
+    return Object.values(TOOL_NAMES);
+}

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

@@ -0,0 +1,31 @@
+/**
+ * Anchor Tools - Agent tools for managing anchors
+ *
+ * Provides anchor_add and anchor_remove tools that allow
+ * the agent to add critical context that survives compaction.
+ */
+interface AnchorAddInput {
+    /** The anchor content - critical information to preserve */
+    content: string;
+    /** Priority level: 'critical' | 'safety' | 'info' (default: 'info') */
+    priority?: 'critical' | 'safety' | 'info';
+    /** Scope: 'global' or 'project' (default: 'project' if active project, else 'global') */
+    scope?: 'global' | 'project';
+    /** Tags for categorization */
+    tags?: string[];
+}
+interface AnchorRemoveInput {
+    /** ID of the anchor to remove */
+    id: string;
+}
+interface AnchorListInput {
+    /** Filter by scope: 'global' | 'project' | 'all' (default: 'all') */
+    scope?: 'global' | 'project' | 'all';
+    /** Filter by priority */
+    priority?: 'critical' | 'safety' | 'info';
+}
+export declare const anchorAddTool: import("@compilr-dev/sdk").Tool<AnchorAddInput>;
+export declare const anchorRemoveTool: import("@compilr-dev/sdk").Tool<AnchorRemoveInput>;
+export declare const anchorListTool: import("@compilr-dev/sdk").Tool<AnchorListInput>;
+export declare const allAnchorTools: (import("@compilr-dev/sdk").Tool<AnchorAddInput> | import("@compilr-dev/sdk").Tool<AnchorRemoveInput>)[];
+export {};

package/dist/tools/anchor-tools.js

@@ -0,0 +1,255 @@
+/**
+ * Anchor Tools - Agent tools for managing anchors
+ *
+ * Provides anchor_add and anchor_remove tools that allow
+ * the agent to add critical context that survives compaction.
+ */
+import { defineTool } from '@compilr-dev/sdk';
+import { getGlobalAnchorManager, getAnchorManager, } from '../anchors/index.js';
+import { getActiveProject } from './project-db.js';
+// =============================================================================
+// anchor_add Tool
+// =============================================================================
+export const anchorAddTool = defineTool({
+    name: 'anchor_add',
+    description: 'Add critical information that must survive context compaction. ' +
+        'Use this for: project context, important decisions, user preferences, ' +
+        'architectural constraints, or any information that should persist across the entire conversation. ' +
+        'Anchors are always included at the top of the context window.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            content: {
+                type: 'string',
+                description: 'The critical information to preserve. Keep it concise but complete.',
+            },
+            priority: {
+                type: 'string',
+                enum: ['critical', 'safety', 'info'],
+                description: 'Priority level. "critical" for must-never-forget info (user preferences, key constraints), ' +
+                    '"safety" for safety-related context, "info" for general helpful context.',
+            },
+            scope: {
+                type: 'string',
+                enum: ['global', 'project'],
+                description: 'Scope for the anchor. "global" persists across all projects, ' +
+                    '"project" is specific to the current project (requires active project).',
+            },
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Optional tags for categorization (e.g., ["architecture", "decision"])',
+            },
+        },
+        required: ['content'],
+    },
+    execute: (input) => {
+        try {
+            // Validate content
+            if (!input.content || input.content.trim().length === 0) {
+                return Promise.resolve({
+                    success: false,
+                    error: 'Anchor content is required and cannot be empty',
+                });
+            }
+            const content = input.content.trim();
+            const priority = input.priority ?? 'info';
+            const activeProject = getActiveProject();
+            // Determine scope
+            let scope = input.scope;
+            if (!scope) {
+                scope = activeProject ? 'project' : 'global';
+            }
+            // Validate project scope
+            if (scope === 'project' && !activeProject) {
+                return Promise.resolve({
+                    success: false,
+                    error: 'Cannot add project-scoped anchor: no active project. Use scope: "global" instead.',
+                });
+            }
+            // Get project ID for project-scoped anchors (validated above that activeProject exists)
+            const projectId = scope === 'project' && activeProject
+                ? String(activeProject.id)
+                : undefined;
+            // Get the appropriate manager
+            const manager = scope === 'global'
+                ? getGlobalAnchorManager()
+                : getAnchorManager(projectId ?? '');
+            // Add the anchor
+            const anchor = manager.add({
+                content,
+                priority,
+                scope: 'persistent', // Anchors persist across sessions
+                tags: input.tags,
+                projectId,
+            });
+            return Promise.resolve({
+                success: true,
+                result: {
+                    id: anchor.id,
+                    content: anchor.content,
+                    priority: anchor.priority,
+                    scope: scope,
+                    tags: anchor.tags,
+                    message: `Anchor added successfully (${scope} scope, ${priority} priority)`,
+                },
+            });
+        }
+        catch (err) {
+            return Promise.resolve({
+                success: false,
+                error: `Failed to add anchor: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    },
+});
+// =============================================================================
+// anchor_remove Tool
+// =============================================================================
+export const anchorRemoveTool = defineTool({
+    name: 'anchor_remove',
+    description: 'Remove an anchor by its ID. Use this to clean up outdated or no longer relevant anchors. ' +
+        'Use anchor_list first to see available anchors and their IDs.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: {
+                type: 'string',
+                description: 'The ID of the anchor to remove',
+            },
+        },
+        required: ['id'],
+    },
+    execute: (input) => {
+        try {
+            if (!input.id || input.id.trim().length === 0) {
+                return Promise.resolve({
+                    success: false,
+                    error: 'Anchor ID is required',
+                });
+            }
+            const id = input.id.trim();
+            const activeProject = getActiveProject();
+            // Try to remove from project anchors first, then global
+            let removed = false;
+            let scope = 'unknown';
+            if (activeProject) {
+                const projectManager = getAnchorManager(String(activeProject.id));
+                if (projectManager.has(id)) {
+                    removed = projectManager.remove(id);
+                    scope = 'project';
+                }
+            }
+            if (!removed) {
+                const globalManager = getGlobalAnchorManager();
+                if (globalManager.has(id)) {
+                    removed = globalManager.remove(id);
+                    scope = 'global';
+                }
+            }
+            if (!removed) {
+                return Promise.resolve({
+                    success: false,
+                    error: `Anchor with ID "${id}" not found`,
+                });
+            }
+            return Promise.resolve({
+                success: true,
+                result: {
+                    id,
+                    scope,
+                    message: `Anchor removed successfully (was ${scope} scope)`,
+                },
+            });
+        }
+        catch (err) {
+            return Promise.resolve({
+                success: false,
+                error: `Failed to remove anchor: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    },
+});
+// =============================================================================
+// anchor_list Tool
+// =============================================================================
+export const anchorListTool = defineTool({
+    name: 'anchor_list',
+    description: 'List all anchors. Returns anchor IDs, content, priority, and scope. ' +
+        'Use this to see what persistent context is available before adding or removing anchors.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            scope: {
+                type: 'string',
+                enum: ['global', 'project', 'all'],
+                description: 'Filter by scope: "global", "project", or "all" (default: "all")',
+            },
+            priority: {
+                type: 'string',
+                enum: ['critical', 'safety', 'info'],
+                description: 'Filter by priority level',
+            },
+        },
+    },
+    execute: (input) => {
+        try {
+            const activeProject = getActiveProject();
+            const scope = input.scope ?? 'all';
+            const anchors = [];
+            // Collect global anchors
+            if (scope === 'global' || scope === 'all') {
+                const globalManager = getGlobalAnchorManager();
+                const globalAnchors = globalManager.getAll({ priority: input.priority });
+                for (const anchor of globalAnchors) {
+                    anchors.push({
+                        id: anchor.id,
+                        content: anchor.content,
+                        priority: anchor.priority,
+                        scope: 'global',
+                        tags: anchor.tags,
+                    });
+                }
+            }
+            // Collect project anchors
+            if ((scope === 'project' || scope === 'all') && activeProject) {
+                const projectManager = getAnchorManager(String(activeProject.id));
+                const projectAnchors = projectManager.getAll({ priority: input.priority });
+                for (const anchor of projectAnchors) {
+                    anchors.push({
+                        id: anchor.id,
+                        content: anchor.content,
+                        priority: anchor.priority,
+                        scope: 'project',
+                        tags: anchor.tags,
+                    });
+                }
+            }
+            // Sort by priority (critical first)
+            const priorityOrder = { critical: 0, safety: 1, info: 2 };
+            anchors.sort((a, b) => {
+                const pa = priorityOrder[a.priority] ?? 2;
+                const pb = priorityOrder[b.priority] ?? 2;
+                return pa - pb;
+            });
+            return Promise.resolve({
+                success: true,
+                result: {
+                    count: anchors.length,
+                    activeProject: activeProject?.displayName ?? null,
+                    anchors,
+                },
+            });
+        }
+        catch (err) {
+            return Promise.resolve({
+                success: false,
+                error: `Failed to list anchors: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    },
+});
+// =============================================================================
+// Export all anchor tools
+// =============================================================================
+export const allAnchorTools = [anchorAddTool, anchorRemoveTool, anchorListTool];

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

@@ -0,0 +1,42 @@
+/**
+ * Artifact Tools
+ *
+ * Tools for managing team artifacts - named pieces of work that agents
+ * can publish and reference across the team.
+ *
+ * Artifact types:
+ * - design: Architecture, API specs, data models
+ * - plan: Sprint plans, task breakdowns, timelines
+ * - review: Code reviews, security audits, feedback
+ * - decision: Architectural decisions, trade-off analysis
+ * - note: General notes, meeting summaries
+ */
+export declare const artifactSaveTool: import("@compilr-dev/sdk").Tool<{
+    name: string;
+    type: string;
+    content: string;
+    summary?: string;
+    agent?: string;
+}>;
+export declare const artifactGetTool: import("@compilr-dev/sdk").Tool<{
+    name: string;
+}>;
+export declare const artifactListTool: import("@compilr-dev/sdk").Tool<{
+    type?: string;
+    agent?: string;
+    search?: string;
+}>;
+export declare const artifactDeleteTool: import("@compilr-dev/sdk").Tool<{
+    name: string;
+}>;
+export declare const allArtifactTools: (import("@compilr-dev/sdk").Tool<{
+    name: string;
+    type: string;
+    content: string;
+    summary?: string;
+    agent?: string;
+}> | import("@compilr-dev/sdk").Tool<{
+    type?: string;
+    agent?: string;
+    search?: string;
+}>)[];