@defai.digital/ax-cli 2.7.0 → 3.0.0

package/dist/planner/plan-storage.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Plan Storage Module
+ *
+ * Handles persistence and retrieval of execution plans.
+ * Plans are stored in ~/.ax-cli/plans/{plan-id}/
+ */
+import { TaskPlan, SavedPlanState, PlanSummary } from "./types.js";
+export declare class PlanStorage {
+    private plansDir;
+    constructor(plansDir?: string);
+    /**
+     * Ensure the plans directory exists
+     */
+    private ensureDirectory;
+    /**
+     * Get the directory path for a specific plan
+     */
+    private getPlanDir;
+    /**
+     * Save a plan to disk
+     */
+    savePlan(plan: TaskPlan): Promise<string>;
+    /**
+     * Load a plan from disk
+     */
+    loadPlan(planId: string): Promise<TaskPlan | null>;
+    /**
+     * Save plan state (for pause/resume)
+     */
+    saveState(plan: TaskPlan, reason: SavedPlanState["saveReason"], context?: {
+        conversationContext?: unknown[];
+        trackedFiles?: Array<{
+            path: string;
+            hash: string;
+        }>;
+    }): Promise<void>;
+    /**
+     * Load plan state
+     */
+    loadState(planId: string): Promise<SavedPlanState | null>;
+    /**
+     * List all saved plans
+     */
+    listPlans(): Promise<PlanSummary[]>;
+    /**
+     * List resumable plans (paused or failed)
+     */
+    listResumablePlans(): Promise<PlanSummary[]>;
+    /**
+     * Delete a plan
+     */
+    deletePlan(planId: string): Promise<boolean>;
+    /**
+     * Clean up old plans (older than retention period)
+     */
+    cleanupOldPlans(retentionDays?: number): Promise<number>;
+    /**
+     * Check if a plan exists
+     */
+    planExists(planId: string): boolean;
+    /**
+     * Get storage stats
+     */
+    getStorageStats(): Promise<{
+        totalPlans: number;
+        resumablePlans: number;
+        completedPlans: number;
+        totalSizeBytes: number;
+    }>;
+    /**
+     * Get directory size recursively
+     */
+    private getDirectorySize;
+    /**
+     * Serialize plan for JSON storage (convert Dates to ISO strings)
+     */
+    private serializePlan;
+    /**
+     * Deserialize plan from JSON storage (convert ISO strings to Dates)
+     */
+    private deserializePlan;
+    /**
+     * Serialize state for JSON storage
+     */
+    private serializeState;
+    /**
+     * Deserialize state from JSON storage
+     */
+    private deserializeState;
+}
+/**
+ * Get the singleton PlanStorage instance
+ */
+export declare function getPlanStorage(): PlanStorage;
+/**
+ * Reset the singleton (for testing)
+ */
+export declare function resetPlanStorage(): void;

package/dist/planner/plan-storage.js

@@ -0,0 +1,325 @@
+/**
+ * Plan Storage Module
+ *
+ * Handles persistence and retrieval of execution plans.
+ * Plans are stored in ~/.ax-cli/plans/{plan-id}/
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import { PlanStatus, TaskPlanSchema, } from "./types.js";
+// ============================================================================
+// Constants
+// ============================================================================
+const PLANS_DIR = path.join(os.homedir(), ".ax-cli", "plans");
+const PLAN_FILE = "plan.json";
+const STATE_FILE = "state.json";
+const PLAN_RETENTION_DAYS = 30;
+// ============================================================================
+// Plan Storage Class
+// ============================================================================
+export class PlanStorage {
+    plansDir;
+    constructor(plansDir) {
+        this.plansDir = plansDir || PLANS_DIR;
+        this.ensureDirectory();
+    }
+    /**
+     * Ensure the plans directory exists
+     */
+    ensureDirectory() {
+        if (!fs.existsSync(this.plansDir)) {
+            fs.mkdirSync(this.plansDir, { recursive: true });
+        }
+    }
+    /**
+     * Get the directory path for a specific plan
+     */
+    getPlanDir(planId) {
+        return path.join(this.plansDir, planId);
+    }
+    /**
+     * Save a plan to disk
+     */
+    async savePlan(plan) {
+        const planDir = this.getPlanDir(plan.id);
+        // Create plan directory
+        if (!fs.existsSync(planDir)) {
+            fs.mkdirSync(planDir, { recursive: true });
+        }
+        // Update timestamp
+        plan.updatedAt = new Date();
+        // Serialize dates properly
+        const serialized = this.serializePlan(plan);
+        // Write plan file
+        const planPath = path.join(planDir, PLAN_FILE);
+        fs.writeFileSync(planPath, JSON.stringify(serialized, null, 2), "utf-8");
+        return planDir;
+    }
+    /**
+     * Load a plan from disk
+     */
+    async loadPlan(planId) {
+        const planPath = path.join(this.getPlanDir(planId), PLAN_FILE);
+        if (!fs.existsSync(planPath)) {
+            return null;
+        }
+        try {
+            const data = fs.readFileSync(planPath, "utf-8");
+            const parsed = JSON.parse(data);
+            const plan = this.deserializePlan(parsed);
+            // Validate with Zod schema
+            const result = TaskPlanSchema.safeParse(plan);
+            if (!result.success) {
+                console.error(`Invalid plan format for ${planId}:`, result.error);
+                return null;
+            }
+            return plan;
+        }
+        catch (error) {
+            console.error(`Failed to load plan ${planId}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Save plan state (for pause/resume)
+     */
+    async saveState(plan, reason, context) {
+        const planDir = this.getPlanDir(plan.id);
+        // Ensure plan directory exists
+        if (!fs.existsSync(planDir)) {
+            fs.mkdirSync(planDir, { recursive: true });
+        }
+        const state = {
+            plan,
+            savedAt: new Date(),
+            saveReason: reason,
+            conversationContext: context?.conversationContext,
+            trackedFiles: context?.trackedFiles,
+        };
+        const statePath = path.join(planDir, STATE_FILE);
+        const serialized = this.serializeState(state);
+        fs.writeFileSync(statePath, JSON.stringify(serialized, null, 2), "utf-8");
+        // Also update the plan file
+        await this.savePlan(plan);
+    }
+    /**
+     * Load plan state
+     */
+    async loadState(planId) {
+        const statePath = path.join(this.getPlanDir(planId), STATE_FILE);
+        if (!fs.existsSync(statePath)) {
+            return null;
+        }
+        try {
+            const data = fs.readFileSync(statePath, "utf-8");
+            const parsed = JSON.parse(data);
+            return this.deserializeState(parsed);
+        }
+        catch (error) {
+            console.error(`Failed to load state for ${planId}:`, error);
+            return null;
+        }
+    }
+    /**
+     * List all saved plans
+     */
+    async listPlans() {
+        if (!fs.existsSync(this.plansDir)) {
+            return [];
+        }
+        const entries = fs.readdirSync(this.plansDir, { withFileTypes: true });
+        const summaries = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const plan = await this.loadPlan(entry.name);
+            if (plan) {
+                summaries.push({
+                    id: plan.id,
+                    originalPrompt: plan.originalPrompt,
+                    status: plan.status,
+                    totalPhases: plan.phases.length,
+                    completedPhases: plan.phasesCompleted,
+                    createdAt: plan.createdAt,
+                    updatedAt: plan.updatedAt,
+                });
+            }
+        }
+        // Sort by updatedAt descending (most recent first)
+        summaries.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
+        return summaries;
+    }
+    /**
+     * List resumable plans (paused or failed)
+     */
+    async listResumablePlans() {
+        const allPlans = await this.listPlans();
+        return allPlans.filter((p) => p.status === PlanStatus.PAUSED ||
+            p.status === PlanStatus.FAILED ||
+            p.status === PlanStatus.CREATED ||
+            p.status === PlanStatus.APPROVED);
+    }
+    /**
+     * Delete a plan
+     */
+    async deletePlan(planId) {
+        const planDir = this.getPlanDir(planId);
+        if (!fs.existsSync(planDir)) {
+            return false;
+        }
+        try {
+            fs.rmSync(planDir, { recursive: true, force: true });
+            return true;
+        }
+        catch (error) {
+            console.error(`Failed to delete plan ${planId}:`, error);
+            return false;
+        }
+    }
+    /**
+     * Clean up old plans (older than retention period)
+     */
+    async cleanupOldPlans(retentionDays = PLAN_RETENTION_DAYS) {
+        const allPlans = await this.listPlans();
+        const cutoffDate = new Date();
+        cutoffDate.setDate(cutoffDate.getDate() - retentionDays);
+        let deletedCount = 0;
+        for (const plan of allPlans) {
+            // Only delete completed or abandoned plans
+            if ((plan.status === PlanStatus.COMPLETED ||
+                plan.status === PlanStatus.ABANDONED) &&
+                plan.updatedAt < cutoffDate) {
+                const deleted = await this.deletePlan(plan.id);
+                if (deleted)
+                    deletedCount++;
+            }
+        }
+        return deletedCount;
+    }
+    /**
+     * Check if a plan exists
+     */
+    planExists(planId) {
+        return fs.existsSync(path.join(this.getPlanDir(planId), PLAN_FILE));
+    }
+    /**
+     * Get storage stats
+     */
+    async getStorageStats() {
+        const allPlans = await this.listPlans();
+        const resumable = allPlans.filter((p) => p.status === PlanStatus.PAUSED ||
+            p.status === PlanStatus.FAILED ||
+            p.status === PlanStatus.CREATED);
+        const completed = allPlans.filter((p) => p.status === PlanStatus.COMPLETED);
+        // Calculate total size
+        let totalSize = 0;
+        if (fs.existsSync(this.plansDir)) {
+            const entries = fs.readdirSync(this.plansDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const planDir = path.join(this.plansDir, entry.name);
+                    totalSize += this.getDirectorySize(planDir);
+                }
+            }
+        }
+        return {
+            totalPlans: allPlans.length,
+            resumablePlans: resumable.length,
+            completedPlans: completed.length,
+            totalSizeBytes: totalSize,
+        };
+    }
+    /**
+     * Get directory size recursively
+     */
+    getDirectorySize(dirPath) {
+        let size = 0;
+        const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const entryPath = path.join(dirPath, entry.name);
+            if (entry.isDirectory()) {
+                size += this.getDirectorySize(entryPath);
+            }
+            else {
+                size += fs.statSync(entryPath).size;
+            }
+        }
+        return size;
+    }
+    // ============================================================================
+    // Serialization Helpers
+    // ============================================================================
+    /**
+     * Serialize plan for JSON storage (convert Dates to ISO strings)
+     */
+    serializePlan(plan) {
+        return {
+            ...plan,
+            createdAt: plan.createdAt.toISOString(),
+            updatedAt: plan.updatedAt.toISOString(),
+            phases: plan.phases.map((phase) => ({
+                ...phase,
+                startedAt: phase.startedAt?.toISOString(),
+                completedAt: phase.completedAt?.toISOString(),
+            })),
+        };
+    }
+    /**
+     * Deserialize plan from JSON storage (convert ISO strings to Dates)
+     */
+    deserializePlan(data) {
+        const obj = data;
+        return {
+            ...obj,
+            createdAt: new Date(obj.createdAt),
+            updatedAt: new Date(obj.updatedAt),
+            phases: obj.phases.map((phase) => ({
+                ...phase,
+                startedAt: phase.startedAt ? new Date(phase.startedAt) : undefined,
+                completedAt: phase.completedAt ? new Date(phase.completedAt) : undefined,
+            })),
+        };
+    }
+    /**
+     * Serialize state for JSON storage
+     */
+    serializeState(state) {
+        return {
+            ...state,
+            plan: this.serializePlan(state.plan),
+            savedAt: state.savedAt.toISOString(),
+        };
+    }
+    /**
+     * Deserialize state from JSON storage
+     */
+    deserializeState(data) {
+        const obj = data;
+        return {
+            ...obj,
+            plan: this.deserializePlan(obj.plan),
+            savedAt: new Date(obj.savedAt),
+        };
+    }
+}
+// ============================================================================
+// Singleton Instance
+// ============================================================================
+let planStorageInstance = null;
+/**
+ * Get the singleton PlanStorage instance
+ */
+export function getPlanStorage() {
+    if (!planStorageInstance) {
+        planStorageInstance = new PlanStorage();
+    }
+    return planStorageInstance;
+}
+/**
+ * Reset the singleton (for testing)
+ */
+export function resetPlanStorage() {
+    planStorageInstance = null;
+}
+//# sourceMappingURL=plan-storage.js.map

package/dist/planner/plan-storage.js.map

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

package/dist/planner/prompts/planning-prompt.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Planning Prompts
+ *
+ * System prompts for LLM-based task decomposition.
+ */
+export declare const PLANNING_SYSTEM_PROMPT = "You are a task planning assistant for a CLI coding tool called AX-CLI.\nYour job is to analyze user requests and create structured execution plans.\n\nWhen given a complex coding task, you should:\n1. Understand the user's goal\n2. Break it down into 2-5 logical phases\n3. Identify dependencies between phases\n4. Assess risk levels for each phase\n5. Determine which phases can run in parallel\n\nGuidelines for creating good plans:\n\nPHASE DECOMPOSITION:\n- Each phase should be independently executable\n- Phases should have clear, measurable objectives\n- Keep phases focused (1-3 objectives max per phase)\n- Order phases logically (analysis \u2192 design \u2192 implementation \u2192 testing \u2192 documentation)\n\nDEPENDENCIES:\n- Mark dependencies between phases (e.g., testing depends on implementation)\n- Identify phases that can run in parallel (e.g., testing and documentation)\n- Avoid circular dependencies\n\nRISK ASSESSMENT:\n- low: Read-only operations, non-destructive changes\n- medium: File modifications, adding new code\n- high: Deleting files, modifying critical configs, database changes\n\nTOOL IDENTIFICATION:\nCommon tools: view_file, str_replace_editor, bash, search, test\n\nOUTPUT FORMAT:\nYou must respond with valid JSON only. No explanations outside the JSON.";
+export declare function buildPlanningPrompt(userRequest: string, context?: {
+    projectType?: string;
+    files?: string[];
+    recentHistory?: string[];
+}): string;
+export declare function buildPhaseExecutionPrompt(phase: {
+    name: string;
+    description: string;
+    objectives: string[];
+    toolsRequired: string[];
+}, context?: {
+    originalRequest?: string;
+    previousPhases?: string[];
+}): string;
+export declare function buildPlanSummaryPrompt(results: Array<{
+    phaseName: string;
+    success: boolean;
+    output?: string;
+}>): string;
+/**
+ * Keywords that indicate a complex request
+ */
+export declare const COMPLEX_KEYWORDS: string[];
+/**
+ * Keywords that indicate a simple request
+ */
+export declare const SIMPLE_KEYWORDS: string[];
+/**
+ * Detect if a request is likely complex
+ */
+export declare function isComplexRequest(request: string): boolean;
+/**
+ * Estimate minimum phases based on request analysis
+ */
+export declare function estimateMinPhases(request: string): number;