@compilr-dev/cli 0.5.1 → 0.5.2

package/dist/tools/artifact-tools.js

@@ -1,328 +0,0 @@
-/**
- * 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
- */
-import { defineTool, createSuccessResult, createErrorResult } from '@compilr-dev/sdk';
-import { getTeamCheckpointer, recordTeamActivity } from '../multi-agent/index.js';
-import { getCurrentProject } from './project-db.js';
-// =============================================================================
-// Helper Functions
-// =============================================================================
-/**
- * Get the artifact store for the current project
- */
-function getArtifactStore() {
-    const currentProject = getCurrentProject();
-    const projectId = currentProject?.id ?? null;
-    const checkpointer = getTeamCheckpointer();
-    return checkpointer.getArtifactStore(projectId);
-}
-/**
- * Get the current agent ID (for artifact authorship)
- * Falls back to 'default' if not available
- */
-function getCurrentAgentId() {
-    // Note: In a future enhancement, we could pass the agent ID through context
-    // For now, we'll use 'default' and the caller can override
-    return 'default';
-}
-// =============================================================================
-// artifact_save - Save or update an artifact
-// =============================================================================
-export const artifactSaveTool = defineTool({
-    name: 'artifact_save',
-    description: 'Save a new artifact or update an existing one. Artifacts are named pieces of work that can be referenced by other agents. ' +
-        'Types: design (architecture/API specs), plan (task breakdowns), review (code reviews), decision (architectural decisions), note (general notes).',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            name: {
-                type: 'string',
-                description: 'Artifact name (human-readable, unique within team). Example: "API Design v2", "Sprint 5 Plan", "Auth Module Review"',
-            },
-            type: {
-                type: 'string',
-                enum: ['design', 'plan', 'review', 'decision', 'note'],
-                description: 'Artifact type: design (architecture), plan (task breakdown), review (feedback), decision (trade-off analysis), note (general)',
-            },
-            content: {
-                type: 'string',
-                description: 'Full artifact content in markdown format. Should be complete and self-contained.',
-            },
-            summary: {
-                type: 'string',
-                description: 'Optional one-line summary (auto-generated if not provided). Max 200 characters.',
-            },
-            agent: {
-                type: 'string',
-                description: 'Optional agent ID who created this artifact. Defaults to current agent.',
-            },
-        },
-        required: ['name', 'type', 'content'],
-    },
-    execute: async (input) => {
-        await Promise.resolve();
-        try {
-            const store = getArtifactStore();
-            const agentId = input.agent ?? getCurrentAgentId();
-            const artifactType = input.type;
-            // Check if artifact exists
-            const existing = store.getByName(input.name);
-            if (existing) {
-                // Update existing artifact
-                const updated = store.update(existing.id, {
-                    content: input.content,
-                    summary: input.summary,
-                    type: artifactType,
-                });
-                if (!updated) {
-                    return createErrorResult(`Failed to update artifact "${input.name}"`);
-                }
-                // Save to disk
-                store.save();
-                // Record activity for team awareness
-                recordTeamActivity(agentId, 'artifact_updated', `updated artifact "${updated.name}"`);
-                const output = [
-                    `Updated artifact "${updated.name}" (v${String(updated.version)})`,
-                    ``,
-                    `Type:    ${updated.type}`,
-                    `Agent:   ${updated.agent}`,
-                    `Summary: ${updated.summary}`,
-                    `Updated: ${updated.updatedAt.toISOString()}`,
-                ].join('\n');
-                return createSuccessResult(output);
-            }
-            else {
-                // Create new artifact
-                const artifact = store.create({
-                    name: input.name,
-                    agent: agentId,
-                    type: artifactType,
-                    content: input.content,
-                    summary: input.summary,
-                });
-                // Save to disk
-                store.save();
-                // Record activity for team awareness
-                recordTeamActivity(agentId, 'artifact_created', `created artifact "${artifact.name}"`);
-                const output = [
-                    `Created artifact "${artifact.name}"`,
-                    ``,
-                    `Type:    ${artifact.type}`,
-                    `Agent:   ${artifact.agent}`,
-                    `Summary: ${artifact.summary}`,
-                    `Created: ${artifact.createdAt.toISOString()}`,
-                ].join('\n');
-                return createSuccessResult(output);
-            }
-        }
-        catch (error) {
-            return createErrorResult(`Failed to save artifact: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    },
-});
-// =============================================================================
-// artifact_get - Retrieve an artifact by name
-// =============================================================================
-export const artifactGetTool = defineTool({
-    name: 'artifact_get',
-    description: 'Retrieve an artifact by name. Returns the full content and metadata. ' +
-        'Use artifact_list first to see available artifacts.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            name: {
-                type: 'string',
-                description: 'Name of the artifact to retrieve (case-insensitive)',
-            },
-        },
-        required: ['name'],
-    },
-    execute: async (input) => {
-        await Promise.resolve();
-        try {
-            const store = getArtifactStore();
-            const artifact = store.getByName(input.name);
-            if (!artifact) {
-                // Suggest similar artifacts
-                const all = store.list();
-                const searchLower = input.name.toLowerCase();
-                const suggestions = all
-                    .filter(a => a.name.toLowerCase().includes(searchLower) ||
-                    searchLower.includes(a.name.toLowerCase()))
-                    .slice(0, 3)
-                    .map(a => `"${a.name}"`);
-                let message = `Artifact "${input.name}" not found.`;
-                if (suggestions.length > 0) {
-                    message += ` Did you mean: ${suggestions.join(', ')}?`;
-                }
-                else if (all.length > 0) {
-                    message += ` Available artifacts: ${all.slice(0, 5).map(a => `"${a.name}"`).join(', ')}`;
-                    if (all.length > 5) {
-                        message += ` (+${String(all.length - 5)} more)`;
-                    }
-                }
-                else {
-                    message += ' No artifacts exist yet. Use artifact_save to create one.';
-                }
-                return createErrorResult(message);
-            }
-            const output = [
-                `Artifact: ${artifact.name}`,
-                ``,
-                `Type:    ${artifact.type}`,
-                `Agent:   ${artifact.agent}`,
-                `Version: ${String(artifact.version)}`,
-                `Summary: ${artifact.summary}`,
-                `Created: ${artifact.createdAt.toISOString()}`,
-                `Updated: ${artifact.updatedAt.toISOString()}`,
-                ``,
-                `--- Content ---`,
-                artifact.content,
-            ].join('\n');
-            return createSuccessResult(output);
-        }
-        catch (error) {
-            return createErrorResult(`Failed to get artifact: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    },
-});
-// =============================================================================
-// artifact_list - List all artifacts
-// =============================================================================
-export const artifactListTool = defineTool({
-    name: 'artifact_list',
-    description: 'List all artifacts in the team. Can filter by type or agent. ' +
-        'Returns summaries only - use artifact_get for full content.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            type: {
-                type: 'string',
-                enum: ['design', 'plan', 'review', 'decision', 'note'],
-                description: 'Optional: filter by artifact type',
-            },
-            agent: {
-                type: 'string',
-                description: 'Optional: filter by agent ID',
-            },
-            search: {
-                type: 'string',
-                description: 'Optional: search by name or content',
-            },
-        },
-        required: [],
-    },
-    execute: async (input) => {
-        await Promise.resolve();
-        try {
-            const store = getArtifactStore();
-            let artifacts = store.list();
-            // Apply filters
-            if (input.type) {
-                artifacts = artifacts.filter(a => a.type === input.type);
-            }
-            if (input.agent) {
-                artifacts = artifacts.filter(a => a.agent === input.agent);
-            }
-            if (input.search) {
-                artifacts = store.search(input.search);
-                // Re-apply type/agent filters after search
-                if (input.type) {
-                    artifacts = artifacts.filter(a => a.type === input.type);
-                }
-                if (input.agent) {
-                    artifacts = artifacts.filter(a => a.agent === input.agent);
-                }
-            }
-            // Sort by most recently updated
-            artifacts.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
-            if (artifacts.length === 0) {
-                let message = 'No artifacts found';
-                if (input.type || input.agent || input.search) {
-                    message += ' matching the filter criteria';
-                }
-                message += '. Use artifact_save to create one.';
-                return createSuccessResult(message);
-            }
-            const lines = [
-                `Found ${String(artifacts.length)} artifact${artifacts.length === 1 ? '' : 's'}:`,
-                ``,
-            ];
-            for (const a of artifacts) {
-                lines.push(`* ${a.name} [${a.type}]`);
-                lines.push(`  Agent: ${a.agent} | v${String(a.version)} | Updated: ${a.updatedAt.toISOString().split('T')[0]}`);
-                if (a.summary) {
-                    lines.push(`  ${a.summary}`);
-                }
-                lines.push(``);
-            }
-            lines.push(`Use artifact_get(name) to view full content.`);
-            return createSuccessResult(lines.join('\n'));
-        }
-        catch (error) {
-            return createErrorResult(`Failed to list artifacts: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    },
-});
-// =============================================================================
-// artifact_delete - Delete an artifact
-// =============================================================================
-export const artifactDeleteTool = defineTool({
-    name: 'artifact_delete',
-    description: 'Delete an artifact by name. This action cannot be undone.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            name: {
-                type: 'string',
-                description: 'Name of the artifact to delete (case-insensitive)',
-            },
-        },
-        required: ['name'],
-    },
-    execute: async (input) => {
-        await Promise.resolve();
-        try {
-            const store = getArtifactStore();
-            const artifact = store.getByName(input.name);
-            if (!artifact) {
-                return createErrorResult(`Artifact "${input.name}" not found.`);
-            }
-            const deleted = store.delete(artifact.id);
-            if (!deleted) {
-                return createErrorResult(`Failed to delete artifact "${input.name}"`);
-            }
-            // Save changes to disk
-            store.save();
-            const output = [
-                `Deleted artifact "${artifact.name}"`,
-                ``,
-                `Type:  ${artifact.type}`,
-                `Agent: ${artifact.agent}`,
-            ].join('\n');
-            return createSuccessResult(output);
-        }
-        catch (error) {
-            return createErrorResult(`Failed to delete artifact: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    },
-});
-// =============================================================================
-// Export all artifact tools
-// =============================================================================
-export const allArtifactTools = [
-    artifactSaveTool,
-    artifactGetTool,
-    artifactListTool,
-    artifactDeleteTool,
-];

package/dist/tools/backlog-wrappers.d.ts

@@ -1,56 +0,0 @@
-/**
- * Backlog Tool Wrappers
- *
- * These wrappers provide `backlog_read` and `backlog_write` tools that skills expect,
- * but internally delegate to the `workitem_*` database tools.
- *
- * This allows library skills (which reference backlog_*) to work seamlessly
- * with the CLI's database-backed workitem system.
- */
-interface BacklogReadInput {
-    /** Get a specific item by ID */
-    id?: string;
-    /** Filter by status */
-    status?: 'backlog' | 'in-progress' | 'done' | 'blocked';
-    /** Filter by type */
-    type?: 'feature' | 'bug' | 'chore' | 'spike';
-    /** Filter by priority */
-    priority?: 'critical' | 'high' | 'medium' | 'low';
-    /** Search in title and description */
-    search?: string;
-    /** Maximum items to return (default: 20) */
-    limit?: number;
-}
-export declare const backlogReadTool: import("@compilr-dev/sdk").Tool<BacklogReadInput>;
-interface BacklogWriteInput {
-    /** Action to perform */
-    action: 'add' | 'update' | 'delete' | 'replace';
-    /** Item to add or update (required for add/update) */
-    item?: {
-        id?: string;
-        type?: 'feature' | 'bug' | 'chore' | 'spike';
-        title?: string;
-        description?: string;
-        status?: 'backlog' | 'in-progress' | 'done' | 'blocked';
-        priority?: 'critical' | 'high' | 'medium' | 'low';
-        owner?: string;
-        commit_hash?: string;
-    };
-    /** Item ID to delete (required for delete) */
-    deleteId?: string;
-    /** Full list of items (required for replace action) */
-    items?: Array<{
-        id?: string;
-        type: 'feature' | 'bug' | 'chore' | 'spike';
-        title: string;
-        description?: string;
-        status?: 'backlog' | 'in-progress' | 'done' | 'blocked';
-        priority?: 'critical' | 'high' | 'medium' | 'low';
-    }>;
-}
-export declare const backlogWriteTool: import("@compilr-dev/sdk").Tool<BacklogWriteInput>;
-/**
- * All backlog wrapper tools
- */
-export declare const backlogWrapperTools: (import("@compilr-dev/sdk").Tool<BacklogReadInput> | import("@compilr-dev/sdk").Tool<BacklogWriteInput>)[];
-export {};