@defai.digital/ax-cli 2.7.0 → 3.0.0

package/dist/planner/prompts/planning-prompt.js

@@ -0,0 +1,289 @@
+/**
+ * Planning Prompts
+ *
+ * System prompts for LLM-based task decomposition.
+ */
+// ============================================================================
+// Planning System Prompt
+// ============================================================================
+export const PLANNING_SYSTEM_PROMPT = `You are a task planning assistant for a CLI coding tool called AX-CLI.
+Your job is to analyze user requests and create structured execution plans.
+
+When given a complex coding task, you should:
+1. Understand the user's goal
+2. Break it down into 2-5 logical phases
+3. Identify dependencies between phases
+4. Assess risk levels for each phase
+5. Determine which phases can run in parallel
+
+Guidelines for creating good plans:
+
+PHASE DECOMPOSITION:
+- Each phase should be independently executable
+- Phases should have clear, measurable objectives
+- Keep phases focused (1-3 objectives max per phase)
+- Order phases logically (analysis → design → implementation → testing → documentation)
+
+DEPENDENCIES:
+- Mark dependencies between phases (e.g., testing depends on implementation)
+- Identify phases that can run in parallel (e.g., testing and documentation)
+- Avoid circular dependencies
+
+RISK ASSESSMENT:
+- low: Read-only operations, non-destructive changes
+- medium: File modifications, adding new code
+- high: Deleting files, modifying critical configs, database changes
+
+TOOL IDENTIFICATION:
+Common tools: view_file, str_replace_editor, bash, search, test
+
+OUTPUT FORMAT:
+You must respond with valid JSON only. No explanations outside the JSON.`;
+// ============================================================================
+// Planning User Prompt Template
+// ============================================================================
+export function buildPlanningPrompt(userRequest, context) {
+    let prompt = `Create an execution plan for this request:
+
+<request>
+${userRequest}
+</request>`;
+    if (context?.projectType) {
+        prompt += `\n\nProject type: ${context.projectType}`;
+    }
+    if (context?.files && context.files.length > 0) {
+        prompt += `\n\nRelevant files:\n${context.files.slice(0, 10).join("\n")}`;
+    }
+    if (context?.recentHistory && context.recentHistory.length > 0) {
+        prompt += `\n\nRecent context:\n${context.recentHistory.slice(-3).join("\n")}`;
+    }
+    prompt += `
+
+Respond with a JSON object in this exact format:
+{
+  "reasoning": "Brief explanation of why this decomposition makes sense",
+  "complexity": "simple|moderate|complex",
+  "phases": [
+    {
+      "name": "Phase Name",
+      "description": "What this phase accomplishes",
+      "objectives": ["Specific goal 1", "Specific goal 2"],
+      "toolsRequired": ["tool1", "tool2"],
+      "dependencies": [],
+      "canRunInParallel": false,
+      "riskLevel": "low|medium|high",
+      "requiresApproval": false
+    }
+  ]
+}
+
+Rules:
+- Generate 1-5 phases depending on complexity
+- Simple requests (single file change) = 1-2 phases
+- Moderate requests (multi-file changes) = 2-3 phases
+- Complex requests (new features, refactoring) = 3-5 phases
+- First phase typically has no dependencies
+- Testing and documentation can often run in parallel
+- Set requiresApproval: true for high-risk phases`;
+    return prompt;
+}
+// ============================================================================
+// Phase Execution Prompt
+// ============================================================================
+export function buildPhaseExecutionPrompt(phase, context) {
+    let prompt = `Execute this phase:
+
+Phase: ${phase.name}
+Description: ${phase.description}
+
+Objectives:
+${phase.objectives.map((o, i) => `${i + 1}. ${o}`).join("\n")}
+
+Expected tools: ${phase.toolsRequired.join(", ") || "any"}`;
+    if (context?.originalRequest) {
+        prompt += `\n\nOriginal user request: ${context.originalRequest}`;
+    }
+    if (context?.previousPhases && context.previousPhases.length > 0) {
+        prompt += `\n\nCompleted phases:\n${context.previousPhases.join("\n")}`;
+    }
+    prompt += `
+
+Instructions:
+- Focus only on the objectives listed above
+- Complete all objectives before finishing
+- Report any blockers or issues encountered
+- Summarize what was accomplished when done`;
+    return prompt;
+}
+// ============================================================================
+// Plan Summary Prompt
+// ============================================================================
+export function buildPlanSummaryPrompt(results) {
+    const phaseResults = results
+        .map((r, i) => `Phase ${i + 1}: ${r.phaseName}\nStatus: ${r.success ? "Success" : "Failed"}\n${r.output ? `Output: ${r.output}` : ""}`)
+        .join("\n\n");
+    return `Summarize the results of this multi-phase execution:
+
+${phaseResults}
+
+Provide:
+1. A brief summary of what was accomplished
+2. Any warnings or issues to note
+3. Suggested next steps (if any)`;
+}
+// ============================================================================
+// Complexity Detection
+// ============================================================================
+/**
+ * Keywords that indicate a complex request
+ */
+export const COMPLEX_KEYWORDS = [
+    // Major code changes
+    "refactor",
+    "rewrite",
+    "migrate",
+    "restructure",
+    "reorganize",
+    "overhaul",
+    // Feature implementation
+    "implement feature",
+    "implement new",
+    "add feature",
+    "create feature",
+    "build feature",
+    "add authentication",
+    "add authorization",
+    "create api",
+    "build api",
+    // Architecture
+    "design",
+    "architect",
+    "system design",
+    // Testing
+    "test coverage",
+    "add tests",
+    "write tests",
+    "unit tests",
+    "integration tests",
+    // Documentation
+    "documentation",
+    "document all",
+    "add docs",
+    // DevOps
+    "deploy",
+    "ci/cd",
+    "pipeline",
+    "docker",
+    "kubernetes",
+    // Database
+    "database",
+    "schema",
+    "migration",
+    // Integration
+    "integration",
+    "integrate",
+    "connect",
+    // Multi-component work
+    "frontend and backend",
+    "client and server",
+    "multiple components",
+    "across modules",
+    // Performance
+    "optimize",
+    "performance",
+    "improve speed",
+    // Complex multi-step
+    "complete implementation",
+    "full implementation",
+    "end to end",
+    "e2e",
+];
+/**
+ * Keywords that indicate a simple request
+ */
+export const SIMPLE_KEYWORDS = [
+    "fix bug",
+    "typo",
+    "rename",
+    "update",
+    "change",
+    "modify",
+    "add import",
+    "remove",
+    "delete",
+    "comment",
+];
+/**
+ * Detect if a request is likely complex
+ */
+export function isComplexRequest(request) {
+    const lowerRequest = request.toLowerCase();
+    // Check for complex indicators
+    const hasComplexKeywords = COMPLEX_KEYWORDS.some((kw) => lowerRequest.includes(kw));
+    // Check for multiple file indicators
+    const hasMultipleFiles = lowerRequest.includes("all files") ||
+        lowerRequest.includes("entire") ||
+        lowerRequest.includes("whole project") ||
+        lowerRequest.includes("across") ||
+        lowerRequest.includes("every file") ||
+        lowerRequest.includes("codebase") ||
+        /\d+ files/.test(lowerRequest);
+    // Check for multi-step indicators
+    const hasMultipleSteps = lowerRequest.includes("first") ||
+        lowerRequest.includes("then") ||
+        lowerRequest.includes("after that") ||
+        lowerRequest.includes("finally") ||
+        lowerRequest.includes("and also") ||
+        lowerRequest.includes("step") ||
+        lowerRequest.includes("next") ||
+        // Multiple action verbs with "and"
+        /\b(create|add|implement|build|write)\b.+\band\b.+\b(create|add|implement|build|write|test|document)\b/i.test(lowerRequest);
+    // Check for request length - very long requests often need decomposition
+    const isLongRequest = request.length > 300;
+    // Check for multiple distinct tasks (comma-separated or numbered)
+    const hasMultipleTasks = (lowerRequest.match(/\d\.\s/g) || []).length >= 2 || // numbered list
+        (lowerRequest.match(/,\s*(add|create|implement|update|fix|remove)/g) || []).length >= 2;
+    // Simple requests override
+    const hasSimpleKeywords = SIMPLE_KEYWORDS.some((kw) => lowerRequest.includes(kw));
+    // Only simple if no other complexity indicators
+    if (hasSimpleKeywords && !hasMultipleFiles && !hasMultipleSteps && !hasMultipleTasks && !isLongRequest) {
+        return false;
+    }
+    return hasComplexKeywords || hasMultipleFiles || hasMultipleSteps || hasMultipleTasks || (isLongRequest && hasComplexKeywords);
+}
+/**
+ * Estimate minimum phases based on request analysis
+ */
+export function estimateMinPhases(request) {
+    const lowerRequest = request.toLowerCase();
+    // Count distinct action verbs
+    const actionVerbs = [
+        "create",
+        "add",
+        "implement",
+        "test",
+        "document",
+        "refactor",
+        "fix",
+        "update",
+        "remove",
+        "migrate",
+        "deploy",
+    ];
+    let distinctActions = 0;
+    for (const verb of actionVerbs) {
+        if (lowerRequest.includes(verb)) {
+            distinctActions++;
+        }
+    }
+    // Count step indicators
+    const stepIndicators = ["first", "then", "next", "after", "finally"];
+    let stepCount = 0;
+    for (const indicator of stepIndicators) {
+        if (lowerRequest.includes(indicator)) {
+            stepCount++;
+        }
+    }
+    return Math.max(1, Math.min(5, distinctActions, stepCount + 1));
+}
+//# sourceMappingURL=planning-prompt.js.map

package/dist/planner/prompts/planning-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-prompt.js","sourceRoot":"","sources":["../../../src/planner/prompts/planning-prompt.ts"],"names":[],"mappings":"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"}

package/dist/planner/task-planner.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Task Planner
+ *
+ * Main orchestrator for multi-phase task planning and execution.
+ * Coordinates plan generation, storage, and phase execution.
+ */
+import { EventEmitter } from "events";
+import { TaskPlan, TaskPhase, PhaseResult, PlanResult, ExecutionOptions, PlannerOptions } from "./types.js";
+import { ExecutionBatch } from "./dependency-resolver.js";
+export interface TaskPlannerEvents {
+    "plan:created": (plan: TaskPlan) => void;
+    "plan:approved": (plan: TaskPlan) => void;
+    "plan:started": (plan: TaskPlan) => void;
+    "plan:paused": (plan: TaskPlan) => void;
+    "plan:completed": (plan: TaskPlan, result: PlanResult) => void;
+    "plan:failed": (plan: TaskPlan, error: Error) => void;
+    "phase:started": (plan: TaskPlan, phase: TaskPhase) => void;
+    "phase:completed": (plan: TaskPlan, phase: TaskPhase, result: PhaseResult) => void;
+    "phase:failed": (plan: TaskPlan, phase: TaskPhase, error: Error) => void;
+    "phase:skipped": (plan: TaskPlan, phase: TaskPhase) => void;
+    "phase:approval-required": (plan: TaskPlan, phase: TaskPhase) => void;
+    "batch:started": (plan: TaskPlan, batch: ExecutionBatch) => void;
+    "batch:completed": (plan: TaskPlan, batch: ExecutionBatch) => void;
+}
+export declare class TaskPlanner extends EventEmitter {
+    private options;
+    private storage;
+    private generator;
+    private resolver;
+    private estimator;
+    private currentPlan;
+    private isPaused;
+    private isExecuting;
+    constructor(options?: Partial<PlannerOptions>);
+    /**
+     * Check if a request should trigger multi-phase planning
+     */
+    shouldCreatePlan(request: string): boolean;
+    /**
+     * Generate a plan from user request using LLM
+     *
+     * @param request - User's request
+     * @param llmCaller - Function to call LLM with prompts
+     * @param context - Additional context
+     */
+    generatePlan(request: string, llmCaller: (systemPrompt: string, userPrompt: string) => Promise<string>, context?: {
+        projectType?: string;
+        files?: string[];
+        recentHistory?: string[];
+    }): Promise<TaskPlan | null>;
+    /**
+     * Create a plan directly (without LLM, for testing or manual creation)
+     */
+    createPlan(plan: TaskPlan): Promise<TaskPlan>;
+    /**
+     * Execute a plan
+     *
+     * @param plan - Plan to execute
+     * @param phaseExecutor - Function to execute a single phase
+     * @param options - Execution options
+     */
+    executePlan(plan: TaskPlan, phaseExecutor: (phase: TaskPhase, planContext: {
+        planId: string;
+        originalRequest: string;
+        completedPhases: string[];
+    }) => Promise<PhaseResult>, options?: Partial<ExecutionOptions>): Promise<PlanResult>;
+    /**
+     * Execute a batch of phases
+     */
+    private executeBatch;
+    /**
+     * Execute a single phase
+     */
+    private executePhase;
+    /**
+     * Generate summary from results
+     */
+    private generateSummary;
+    /**
+     * Pause plan execution
+     */
+    pausePlan(): Promise<void>;
+    /**
+     * Resume a paused plan
+     */
+    resumePlan(planId: string, phaseExecutor: (phase: TaskPhase, context: {
+        planId: string;
+        originalRequest: string;
+        completedPhases: string[];
+    }) => Promise<PhaseResult>, options?: Partial<ExecutionOptions>): Promise<PlanResult | null>;
+    /**
+     * Skip a specific phase
+     */
+    skipPhase(planId: string, phaseId: string): Promise<boolean>;
+    /**
+     * Abandon a plan
+     */
+    abandonPlan(planId: string): Promise<boolean>;
+    /**
+     * Get current plan
+     */
+    getCurrentPlan(): TaskPlan | null;
+    /**
+     * Load a plan from storage
+     */
+    loadPlan(planId: string): Promise<TaskPlan | null>;
+    /**
+     * List all plans
+     */
+    listPlans(): Promise<import("./types.js").PlanSummary[]>;
+    /**
+     * List resumable plans
+     */
+    listResumablePlans(): Promise<import("./types.js").PlanSummary[]>;
+    /**
+     * Get execution batches for a plan
+     */
+    getExecutionBatches(plan: TaskPlan): ExecutionBatch[];
+    /**
+     * Check if currently executing
+     */
+    isCurrentlyExecuting(): boolean;
+    /**
+     * Check if paused
+     */
+    isCurrentlyPaused(): boolean;
+}
+/**
+ * Get the singleton TaskPlanner instance
+ */
+export declare function getTaskPlanner(): TaskPlanner;
+/**
+ * Reset the singleton (for testing)
+ */
+export declare function resetTaskPlanner(): void;