@compilr-dev/cli 0.4.0

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

@@ -0,0 +1,86 @@
+/**
+ * Ask User Simple Tool - Single question with flat schema
+ *
+ * A simplified version of ask_user designed for smaller models.
+ * Uses a flat schema (no arrays of objects) that's easier for
+ * models like Haiku, Flash, and GPT-4o-mini to generate correctly.
+ *
+ * Used by /sketch command for quick project outlines.
+ */
+import { defineTool } from '@compilr-dev/agents';
+import { getAskUserSimpleHandler } from '../shared-handlers.js';
+// =============================================================================
+// Tool Definition
+// =============================================================================
+export const askUserSimpleTool = defineTool({
+    name: 'ask_user_simple',
+    description: 'Ask the user a single question. ' +
+        'Provide optional predefined choices or allow free-text input. ' +
+        'Use this for simple question flows - one question at a time. ' +
+        'Best suited for /sketch command and smaller models.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            question: {
+                type: 'string',
+                description: 'The question to ask the user',
+            },
+            options: {
+                type: 'array',
+                description: 'Predefined options for the user to choose from (max 5)',
+                items: { type: 'string' },
+                maxItems: 5,
+            },
+            allowCustom: {
+                type: 'boolean',
+                description: 'Allow free-text input in addition to options (default: true)',
+            },
+        },
+        required: ['question'],
+    },
+    execute: async (input) => {
+        try {
+            // Validate input
+            if (!input.question || input.question.trim().length === 0) {
+                return {
+                    success: false,
+                    error: 'Question text is required',
+                };
+            }
+            if (input.options && input.options.length > 5) {
+                return {
+                    success: false,
+                    error: 'Maximum 5 options allowed',
+                };
+            }
+            // Get the handler from shared-handlers
+            const askUserSimpleHandler = getAskUserSimpleHandler();
+            if (!askUserSimpleHandler) {
+                return {
+                    success: false,
+                    error: 'ask_user_simple handler not initialized. This tool requires the CLI context.',
+                };
+            }
+            // Show the overlay via the handler (which pauses footer)
+            const result = await askUserSimpleHandler({
+                question: input.question,
+                options: input.options,
+                allowCustom: input.allowCustom,
+            });
+            const output = {
+                answer: result.answer,
+                skipped: result.skipped,
+            };
+            return {
+                success: true,
+                result: output,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: `Failed to ask user: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    },
+});

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

@@ -0,0 +1,32 @@
+/**
+ * Ask User Tool - Presents structured questions to the user
+ *
+ * This tool allows the agent to ask questions with predefined options
+ * or free-text input. Used during /design and /refine workflows.
+ *
+ * Note: This tool uses a callback pattern to coordinate with the footer.
+ * The actual overlay is shown via getAskUserHandler() from shared-handlers.ts
+ * which is registered during app initialization and properly pauses the footer.
+ */
+export interface AskUserQuestion {
+    /** Unique identifier for the question (e.g., "app_type", "target_users") */
+    id: string;
+    /** Short label for tab display (e.g., "App Type", "Users") - max 12 chars */
+    header: string;
+    /** The question text */
+    question: string;
+    /** Predefined options (optional) */
+    options?: string[];
+    /** Allow free-text input (default: true) */
+    allowCustom?: boolean;
+    /** Allow multiple selections (default: false) */
+    multiSelect?: boolean;
+}
+interface AskUserInput {
+    /** 1-5 questions to ask */
+    questions: AskUserQuestion[];
+    /** Optional context shown above questions */
+    context?: string;
+}
+export declare const askUserTool: import("@compilr-dev/agents").Tool<AskUserInput>;
+export {};

package/dist/tools/ask-user.js

@@ -0,0 +1,113 @@
+/**
+ * Ask User Tool - Presents structured questions to the user
+ *
+ * This tool allows the agent to ask questions with predefined options
+ * or free-text input. Used during /design and /refine workflows.
+ *
+ * Note: This tool uses a callback pattern to coordinate with the footer.
+ * 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 { getAskUserHandler } from '../shared-handlers.js';
+// =============================================================================
+// Tool Definition
+// =============================================================================
+export const askUserTool = defineTool({
+    name: 'ask_user',
+    description: 'Ask the user structured questions. ' +
+        'Present 1-5 questions with optional predefined answers. ' +
+        'Each question can have options to choose from or allow free-text input. ' +
+        'Use this during design/refine phases to gather requirements efficiently.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            questions: {
+                type: 'array',
+                description: 'Questions to ask the user (1-5 questions)',
+                minItems: 1,
+                maxItems: 5,
+                items: {
+                    type: 'object',
+                    properties: {
+                        id: {
+                            type: 'string',
+                            description: 'Unique identifier for the question',
+                        },
+                        header: {
+                            type: 'string',
+                            description: 'Short label for tab display (max 12 chars)',
+                        },
+                        question: {
+                            type: 'string',
+                            description: 'The question text',
+                        },
+                        options: {
+                            type: 'array',
+                            description: 'Predefined options (optional)',
+                            items: { type: 'string' },
+                        },
+                        allowCustom: {
+                            type: 'boolean',
+                            description: 'Allow free-text input (default: true)',
+                        },
+                        multiSelect: {
+                            type: 'boolean',
+                            description: 'Allow multiple selections (default: false)',
+                        },
+                    },
+                    required: ['id', 'header', 'question'],
+                },
+            },
+            context: {
+                type: 'string',
+                description: 'Optional context shown above questions',
+            },
+        },
+        required: ['questions'],
+    },
+    execute: async (input) => {
+        try {
+            // Validate input
+            if (input.questions.length === 0) {
+                return {
+                    success: false,
+                    error: 'At least one question is required',
+                };
+            }
+            if (input.questions.length > 5) {
+                return {
+                    success: false,
+                    error: 'Maximum 5 questions allowed',
+                };
+            }
+            // Get the handler from index.ts which coordinates with footer
+            const askUserHandler = getAskUserHandler();
+            if (!askUserHandler) {
+                return {
+                    success: false,
+                    error: 'ask_user handler not initialized. This tool requires the CLI context.',
+                };
+            }
+            // Show the overlay via the handler (which pauses footer)
+            const result = await askUserHandler({
+                questions: input.questions,
+                context: input.context,
+            });
+            const output = {
+                answers: result.answers,
+                skipped: result.skipped,
+            };
+            return {
+                success: true,
+                result: output,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: `Failed to ask user: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    },
+});

package/dist/tools/backlog.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Backlog Tools - Read and write project backlog items
+ *
+ * These tools allow the agent to programmatically manage the project backlog,
+ * supporting the /design and /refine workflow.
+ */
+export type BacklogStatus = '📋' | '🚧' | '✅';
+export type BacklogType = 'feature' | 'bug' | 'tech-debt' | 'chore';
+export type BacklogPriority = 'critical' | 'high' | 'medium' | 'low';
+export interface BacklogItem {
+    id: string;
+    type: BacklogType;
+    status: BacklogStatus;
+    priority: BacklogPriority;
+    title: string;
+    description: string;
+    commit?: string;
+}
+/**
+ * Find the backlog file path for the current project.
+ * Checks both single-repo and two-repo patterns.
+ */
+export declare function findBacklogPath(basePath?: string): string | null;
+/**
+ * Parse backlog items from markdown content.
+ */
+export declare function parseBacklogItems(content: string): BacklogItem[];
+interface BacklogReadInput {
+    status?: BacklogStatus | 'all';
+    type?: BacklogType | 'all';
+    priority?: BacklogPriority | 'all';
+    limit?: number;
+    offset?: number;
+    search?: string;
+    id?: string;
+}
+export declare const backlogReadTool: import("@compilr-dev/agents").Tool<BacklogReadInput>;
+interface BacklogWriteInput {
+    action: 'add' | 'update' | 'remove' | 'reorder';
+    items?: Array<{
+        type: BacklogType;
+        status?: BacklogStatus;
+        priority: BacklogPriority;
+        title: string;
+        description: string;
+    }>;
+    id?: string;
+    updates?: Partial<Omit<BacklogItem, 'id'>>;
+    ids?: string[];
+    order?: string[];
+}
+export declare const backlogWriteTool: import("@compilr-dev/agents").Tool<BacklogWriteInput>;
+export {};