@compilr-dev/cli 0.5.1 → 0.5.3

package/dist/tools/plan-tools.js

@@ -1,338 +0,0 @@
-/**
- * Plan Database Tools
- *
- * Tools for managing plans in the database.
- * Plans are used in Plan Mode for structured task planning before implementation.
- */
-import { defineTool, createSuccessResult, createErrorResult } from '@compilr-dev/sdk';
-import { planRepository, } from '../db/repositories/index.js';
-import { getActiveProject } from './project-db.js';
-// =============================================================================
-// plan_create - Create a new plan
-// =============================================================================
-export const planCreateTool = defineTool({
-    name: 'plan_create',
-    description: 'Create a new plan for the current project. Plans are used to document implementation approaches before coding. The plan is created with "draft" status.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            name: {
-                type: 'string',
-                description: 'Plan name (kebab-case, 3-5 words). Example: "auth-jwt-migration", "add-dark-mode-toggle"',
-            },
-            content: {
-                type: 'string',
-                description: 'Plan content in markdown format. Should include: Context, Goals, Steps, Verification sections.',
-            },
-            work_item_id: {
-                type: 'number',
-                description: 'Optional: ID of the work item this plan is for. Links the plan to a backlog item.',
-            },
-            project_id: {
-                type: 'number',
-                description: 'Project ID (uses active project if not provided)',
-            },
-        },
-        required: ['name', 'content'],
-    },
-    execute: async (input) => {
-        await Promise.resolve();
-        try {
-            const projectId = input.project_id ?? getActiveProject()?.id;
-            if (!projectId) {
-                return createErrorResult('No project specified and no active project. Use project_get or /projects to select a project first.');
-            }
-            // Validate name format (kebab-case)
-            if (!/^[a-z][a-z0-9-]*[a-z0-9]$/.test(input.name) && input.name.length > 2) {
-                // Allow simple 2-char names, but enforce kebab-case for longer names
-                if (input.name.length > 2 && !/^[a-z0-9-]+$/.test(input.name)) {
-                    return createErrorResult('Plan name should be kebab-case (lowercase letters, numbers, hyphens). Example: "auth-jwt-migration"');
-                }
-            }
-            const createInput = {
-                project_id: projectId,
-                name: input.name,
-                content: input.content,
-                work_item_id: input.work_item_id,
-            };
-            const plan = planRepository.create(createInput);
-            return createSuccessResult({
-                success: true,
-                message: `Plan "${plan.name}" created`,
-                plan: {
-                    id: plan.id,
-                    name: plan.name,
-                    status: plan.status,
-                    workItemId: plan.workItemId,
-                    createdAt: plan.createdAt.toISOString(),
-                },
-            });
-        }
-        catch (error) {
-            return createErrorResult(`Failed to create plan: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    },
-});
-// =============================================================================
-// plan_update - Update an existing plan
-// =============================================================================
-export const planUpdateTool = defineTool({
-    name: 'plan_update',
-    description: 'Update an existing plan. Can update content, status, or work item link. Status transitions: draft→approved→in_progress→completed. Any status can transition to "abandoned".',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            plan_id: {
-                type: 'number',
-                description: 'ID of the plan to update',
-            },
-            content: {
-                type: 'string',
-                description: 'New plan content (optional)',
-            },
-            status: {
-                type: 'string',
-                enum: ['draft', 'approved', 'in_progress', 'completed', 'abandoned'],
-                description: 'New status (optional). Valid transitions: draft→approved, approved→in_progress, in_progress→completed. Any→abandoned. abandoned→draft.',
-            },
-            work_item_id: {
-                type: ['number', 'null'],
-                description: 'Work item ID to link (optional). Use null to unlink.',
-            },
-        },
-        required: ['plan_id'],
-    },
-    execute: async (input) => {
-        await Promise.resolve();
-        try {
-            const updateInput = {};
-            if (input.content !== undefined) {
-                updateInput.content = input.content;
-            }
-            if (input.status !== undefined) {
-                updateInput.status = input.status;
-            }
-            if (input.work_item_id !== undefined) {
-                updateInput.work_item_id = input.work_item_id;
-            }
-            const plan = planRepository.update(input.plan_id, updateInput);
-            if (!plan) {
-                return createErrorResult(`Plan with ID ${String(input.plan_id)} not found`);
-            }
-            return createSuccessResult({
-                success: true,
-                message: `Plan "${plan.name}" updated`,
-                plan: {
-                    id: plan.id,
-                    name: plan.name,
-                    status: plan.status,
-                    workItemId: plan.workItemId,
-                    updatedAt: plan.updatedAt.toISOString(),
-                },
-            });
-        }
-        catch (error) {
-            return createErrorResult(`Failed to update plan: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    },
-});
-// =============================================================================
-// plan_get - Get a plan by ID or name
-// =============================================================================
-export const planGetTool = defineTool({
-    name: 'plan_get',
-    description: 'Get a plan by ID or name. Returns the full plan content and linked work item details.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            plan_id: {
-                type: 'number',
-                description: 'Plan ID (preferred)',
-            },
-            name: {
-                type: 'string',
-                description: 'Plan name (alternative to ID)',
-            },
-            project_id: {
-                type: 'number',
-                description: 'Project ID (required if using name, uses active project if not provided)',
-            },
-        },
-        required: [],
-    },
-    execute: async (input) => {
-        await Promise.resolve();
-        try {
-            let plan;
-            if (input.plan_id) {
-                plan = planRepository.getWithWorkItem(input.plan_id);
-            }
-            else if (input.name) {
-                const projectId = input.project_id ?? getActiveProject()?.id;
-                if (!projectId) {
-                    return createErrorResult('No project specified and no active project. Provide plan_id or project_id.');
-                }
-                const basePlan = planRepository.getByName(projectId, input.name);
-                if (basePlan) {
-                    plan = planRepository.getWithWorkItem(basePlan.id);
-                }
-            }
-            else {
-                return createErrorResult('Either plan_id or name is required');
-            }
-            if (!plan) {
-                return createSuccessResult({
-                    success: true,
-                    plan: null,
-                    message: 'Plan not found',
-                });
-            }
-            return createSuccessResult({
-                success: true,
-                plan: {
-                    id: plan.id,
-                    name: plan.name,
-                    content: plan.content,
-                    status: plan.status,
-                    workItemId: plan.workItemId,
-                    workItem: plan.workItem
-                        ? {
-                            id: plan.workItem.id,
-                            itemId: plan.workItem.itemId,
-                            title: plan.workItem.title,
-                            status: plan.workItem.status,
-                        }
-                        : null,
-                    createdAt: plan.createdAt.toISOString(),
-                    updatedAt: plan.updatedAt.toISOString(),
-                },
-            });
-        }
-        catch (error) {
-            return createErrorResult(`Failed to get plan: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    },
-});
-// =============================================================================
-// plan_list - List plans for a project
-// =============================================================================
-export const planListTool = defineTool({
-    name: 'plan_list',
-    description: 'List plans for a project. Supports filtering by status and work item. Returns plan summaries without full content.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            project_id: {
-                type: 'number',
-                description: 'Project ID (uses active project if not provided)',
-            },
-            status: {
-                type: 'string',
-                enum: ['draft', 'approved', 'in_progress', 'completed', 'abandoned', 'all'],
-                description: 'Filter by status (default: all)',
-            },
-            work_item_id: {
-                type: 'number',
-                description: 'Filter by linked work item',
-            },
-            limit: {
-                type: 'number',
-                description: 'Maximum plans to return (default: 20)',
-            },
-            order_by: {
-                type: 'string',
-                enum: ['updated_desc', 'updated_asc', 'created_desc', 'name_asc'],
-                description: 'Sort order (default: updated_desc)',
-            },
-        },
-        required: [],
-    },
-    execute: async (input) => {
-        await Promise.resolve();
-        try {
-            const projectId = input.project_id ?? getActiveProject()?.id;
-            if (!projectId) {
-                return createErrorResult('No project specified and no active project. Use project_get or /projects to select a project first.');
-            }
-            const options = {
-                limit: input.limit ?? 20,
-                order_by: input.order_by ?? 'updated_desc',
-            };
-            if (input.status && input.status !== 'all') {
-                options.status = input.status;
-            }
-            if (input.work_item_id !== undefined) {
-                options.work_item_id = input.work_item_id;
-            }
-            const plans = planRepository.list(projectId, options);
-            const counts = planRepository.countByStatus(projectId);
-            const planSummaries = plans.map((plan) => ({
-                id: plan.id,
-                name: plan.name,
-                status: plan.status,
-                workItemId: plan.workItemId,
-                workItemTitle: plan.workItemTitle,
-                workItemItemId: plan.workItemItemId,
-                updatedAt: plan.updatedAt.toISOString(),
-            }));
-            return createSuccessResult({
-                success: true,
-                plans: planSummaries,
-                count: planSummaries.length,
-                statusCounts: counts,
-                projectId,
-            });
-        }
-        catch (error) {
-            return createErrorResult(`Failed to list plans: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    },
-});
-// =============================================================================
-// plan_delete - Delete a plan
-// =============================================================================
-export const planDeleteTool = defineTool({
-    name: 'plan_delete',
-    description: 'Delete a plan by ID. This action cannot be undone.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            plan_id: {
-                type: 'number',
-                description: 'ID of the plan to delete',
-            },
-        },
-        required: ['plan_id'],
-    },
-    execute: async (input) => {
-        await Promise.resolve();
-        try {
-            // Get plan first to show name in message
-            const plan = planRepository.getById(input.plan_id);
-            if (!plan) {
-                return createErrorResult(`Plan with ID ${String(input.plan_id)} not found`);
-            }
-            const deleted = planRepository.delete(input.plan_id);
-            if (!deleted) {
-                return createErrorResult(`Failed to delete plan "${plan.name}"`);
-            }
-            return createSuccessResult({
-                success: true,
-                message: `Plan "${plan.name}" deleted`,
-            });
-        }
-        catch (error) {
-            return createErrorResult(`Failed to delete plan: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    },
-});
-// =============================================================================
-// All plan tools
-// =============================================================================
-export const planDbTools = [
-    planCreateTool,
-    planUpdateTool,
-    planGetTool,
-    planListTool,
-    planDeleteTool,
-];

package/dist/tools/recall-work-tool.d.ts

@@ -1,18 +0,0 @@
-/**
- * recall_work Tool — Query Work History
- *
- * Lets agents proactively query episodic work history.
- * Returns episodes with agent attribution, effort level, and affected files.
- */
-interface RecallWorkInput {
-    /** Filter by file paths (returns episodes touching any of these files) */
-    files?: string[];
-    /** Filter by agent ID */
-    agentId?: string;
-    /** Filter by session ID */
-    sessionId?: string;
-    /** Return N most recent episodes (default: 20) */
-    recent?: number;
-}
-export declare const recallWorkTool: import("@compilr-dev/sdk").Tool<RecallWorkInput>;
-export {};

package/dist/tools/recall-work-tool.js

@@ -1,82 +0,0 @@
-/**
- * recall_work Tool — Query Work History
- *
- * Lets agents proactively query episodic work history.
- * Returns episodes with agent attribution, effort level, and affected files.
- */
-import { defineTool } from '@compilr-dev/sdk';
-import { getGlobalEpisodeStore } from '../episodes/index.js';
-// =============================================================================
-// Tool Definition
-// =============================================================================
-export const recallWorkTool = defineTool({
-    name: 'recall_work',
-    description: 'Query work history — episodes of what agents have done in this project. ' +
-        'Returns episodes with agent attribution, effort level, and affected files. ' +
-        'Use before destructive operations to check what work would be affected. ' +
-        'Use to understand what has been done in this session or by other agents.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            files: {
-                type: 'array',
-                items: { type: 'string' },
-                description: 'Filter by file paths — returns episodes touching any of these files',
-            },
-            agentId: {
-                type: 'string',
-                description: 'Filter by agent ID (e.g., "default", "backend")',
-            },
-            sessionId: {
-                type: 'string',
-                description: 'Filter by session ID',
-            },
-            recent: {
-                type: 'number',
-                description: 'Return N most recent episodes (default: 20)',
-            },
-        },
-    },
-    execute: (input) => {
-        const store = getGlobalEpisodeStore();
-        if (!store) {
-            return Promise.resolve({
-                success: false,
-                error: 'No episode store available (no active project)',
-            });
-        }
-        let episodes;
-        if (input.files && input.files.length > 0) {
-            episodes = store.getByFiles(input.files);
-        }
-        else if (input.agentId) {
-            episodes = store.getByAgent(input.agentId);
-        }
-        else if (input.sessionId) {
-            episodes = store.getBySession(input.sessionId);
-        }
-        else {
-            episodes = store.getRecent(input.recent ?? 20);
-        }
-        const summary = store.getWorkSummary();
-        return Promise.resolve({
-            success: true,
-            result: {
-                episodes: episodes.map(ep => ({
-                    id: ep.id,
-                    agentId: ep.agentId,
-                    terminalPrefix: ep.terminalPrefix,
-                    action: ep.action,
-                    summary: ep.summary,
-                    files: ep.files,
-                    effort: ep.effort,
-                    timestamp: ep.timestamp,
-                    toolCalls: ep.toolCalls,
-                })),
-                totalEpisodes: summary.episodeCount,
-                totalEffort: summary.totalEffort,
-                uncommittedCount: summary.uncommittedWork.length,
-            },
-        });
-    },
-});

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

@@ -1,135 +0,0 @@
-/**
- * Work Item Database Tools
- *
- * Tools for managing work items (backlog items, tasks, bugs) in the database.
- */
-/**
- * workitem_query - Query work items with filters
- */
-export declare const workitemQueryTool: import("@compilr-dev/sdk").Tool<{
-    project_id?: number;
-    status?: string;
-    type?: string;
-    priority?: string;
-    owner?: string;
-    search?: string;
-    limit?: number;
-    offset?: number;
-}>;
-/**
- * workitem_add - Add a new work item
- */
-export declare const workitemAddTool: import("@compilr-dev/sdk").Tool<{
-    project_id?: number;
-    type: string;
-    title: string;
-    description?: string;
-    priority?: string;
-    estimated_effort?: string;
-    owner?: string;
-}>;
-/**
- * workitem_update - Update a work item
- */
-export declare const workitemUpdateTool: import("@compilr-dev/sdk").Tool<{
-    item_id: string;
-    project_id?: number;
-    status?: string;
-    priority?: string;
-    owner?: string;
-    guided_step?: string;
-    title?: string;
-    description?: string;
-    commit_hash?: string;
-}>;
-/**
- * workitem_next - Get the next work item to work on
- */
-export declare const workitemNextTool: import("@compilr-dev/sdk").Tool<{
-    project_id?: number;
-    type?: string;
-}>;
-/**
- * workitem_delete - Delete a work item
- */
-export declare const workitemDeleteTool: import("@compilr-dev/sdk").Tool<{
-    item_id: string;
-    project_id?: number;
-}>;
-/**
- * workitem_status_counts - Get work item counts by status
- */
-export declare const workitemStatusCountsTool: import("@compilr-dev/sdk").Tool<{
-    project_id?: number;
-}>;
-/**
- * workitem_advance_step - Advance to the next guided workflow step
- */
-export declare const workitemAdvanceStepTool: import("@compilr-dev/sdk").Tool<{
-    item_id: string;
-    reason: string;
-    force?: boolean;
-    project_id?: number;
-}>;
-/**
- * workitem_claim - Claim an unassigned work item
- */
-export declare const workitemClaimTool: import("@compilr-dev/sdk").Tool<{
-    item_id: string;
-    agent_id: string;
-    project_id?: number;
-}>;
-/**
- * workitem_handoff - Hand off a work item to another agent
- */
-export declare const workitemHandoffTool: import("@compilr-dev/sdk").Tool<{
-    item_id: string;
-    to_agent_id: string;
-    notes?: string;
-    project_id?: number;
-}>;
-/**
- * All work item tools
- */
-export declare const workitemDbTools: (import("@compilr-dev/sdk").Tool<{
-    project_id?: number;
-    status?: string;
-    type?: string;
-    priority?: string;
-    owner?: string;
-    search?: string;
-    limit?: number;
-    offset?: number;
-}> | import("@compilr-dev/sdk").Tool<{
-    project_id?: number;
-    type: string;
-    title: string;
-    description?: string;
-    priority?: string;
-    estimated_effort?: string;
-    owner?: string;
-}> | import("@compilr-dev/sdk").Tool<{
-    item_id: string;
-    project_id?: number;
-    status?: string;
-    priority?: string;
-    owner?: string;
-    guided_step?: string;
-    title?: string;
-    description?: string;
-    commit_hash?: string;
-}> | import("@compilr-dev/sdk").Tool<{
-    item_id: string;
-    reason: string;
-    force?: boolean;
-    project_id?: number;
-}> | import("@compilr-dev/sdk").Tool<{
-    item_id: string;
-    agent_id: string;
-    project_id?: number;
-}> | import("@compilr-dev/sdk").Tool<{
-    item_id: string;
-    to_agent_id: string;
-    notes?: string;
-    project_id?: number;
-}>)[];