@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/tools/artifact-tools.js

@@ -0,0 +1,328 @@
+/**
+ * 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/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-wrappers.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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 {};