minovative-mind-cli 2.2.3 → 2.2.4

package/dist/services/agent.js

@@ -352,7 +352,7 @@ export async function executeSingleTurn(workspaceRoot, userInput, chat, inputHan
                     spinner.message('Thinking...');
                 }
             }
-            if (effectiveTargetAgent === 'EXECUTE' && isSubAgentsEnabled()) {
+            if (!isPlanMode && effectiveTargetAgent === 'EXECUTE' && isSubAgentsEnabled()) {
                 spinner.stop(); // Clear the spinner before delegating
                 process.stdout.write('\x1b[2K\r');
                 const orchestrator = new Orchestrator(workspaceRoot, chatSessionState.id, inputHandler);
@@ -455,7 +455,7 @@ export async function executeSingleTurn(workspaceRoot, userInput, chat, inputHan
             const calls = result.response.functionCalls();
             debugLog(`Initial functionCalls: ${calls && calls.length > 0 ? JSON.stringify(calls) : 'None'}`);
             // Stage 2: Recursive Tool Loops and Automated Self-Correction (delegated to a helper function to avoid nested loop warning)
-            const correctionRes = await executeSelfCorrectionLoop(chat, result, workspaceRoot, inputHandler, effectiveTargetAgent, ac.signal, spinner, userInput);
+            const correctionRes = await executeSelfCorrectionLoop(chat, result, workspaceRoot, inputHandler, effectiveTargetAgent, ac.signal, spinner, userInput, isPlanMode);
             const finalText = correctionRes.finalText;
             // Update latest usage metadata to reflect all completed turns
             latestUsage = chat.getLatestUsageMetadata() || latestUsage;
@@ -717,7 +717,7 @@ async function compressContextFiles(workspaceRoot, contextResult) {
     }
     return compressedFiles;
 }
-async function executeSelfCorrectionLoop(chat, initialResult, workspaceRoot, inputHandler, effectiveTargetAgent, signal, spinner, originalUserInput) {
+async function executeSelfCorrectionLoop(chat, initialResult, workspaceRoot, inputHandler, effectiveTargetAgent, signal, spinner, originalUserInput, isPlanMode) {
     let correctionAttempts = 0;
     const MAX_CORRECTIONS = 5;
     let result = initialResult;
@@ -761,7 +761,7 @@ async function executeSelfCorrectionLoop(chat, initialResult, workspaceRoot, inp
         }
         previousChangeCount = currentChanges.length;
         // ─── Intent Verification Phase ─────────────────────────────────────
-        if (effectiveTargetAgent === 'EXECUTE' && !intentVerified) {
+        if (effectiveTargetAgent === 'EXECUTE' && !intentVerified && !isPlanMode) {
             spinner.start('Verifying task completion...');
             const intentVerificationPrompt = `SYSTEM CHECK: Please objectively verify that you have fully completed the user's original explicit request:
 

package/dist/services/chatHistoryService.d.ts

@@ -1,24 +1,79 @@
 import type { Content } from '@google/generative-ai';
+/**
+ * Represents the structure of a saved chat session.
+ * This data is persisted in the local workspace cache to allow users to resume
+ * previous conversations with the AI agent.
+ */
 export interface ChatSessionData {
+    /** Unique identifier for the chat session, typically a UUID or timestamp-based string. */
     id: string;
+    /** User-friendly title or summary of the chat session. */
     title: string;
+    /** Epoch timestamp (in milliseconds) indicating when the session was last updated or created. */
     timestamp: number;
+    /** The full conversation history, structured as an array of Content objects compatible with the Gemini API. */
     history: Content[];
+    /** Optional number of remaining credits for the user's account at the time of the session update. */
     creditsRemaining?: number;
+    /** Optional human-readable duration of the last turn (e.g., "1.2s"). */
     lastTurnDuration?: string;
+    /** Optional name of the AI model used during this session (e.g., "gemini-1.5-pro"). */
     modelName?: string;
+    /** Optional total cumulative tokens consumed during the session. */
     totalTokens?: number;
+    /** Optional name of the Git branch active when this session was last updated. */
     gitBranch?: string;
+    /** Optional flag indicating whether auto-approval of commands was enabled in this session. */
     autoApprove?: boolean;
+    /** Optional flag indicating whether sub-agents were enabled or active during this session. */
     subAgents?: boolean;
 }
+/**
+ * Service responsible for managing the persistence, retrieval, and deletion of chat session histories.
+ * It stores session metadata and message history in a local JSON cache (`chat_sessions.json`)
+ * within the project's storage directory and enforces a maximum limit of 250 sessions to prevent
+ * unbounded storage growth.
+ */
 declare class ChatHistoryService {
+    /** The root directory of the currently active workspace. Used to locate the project storage and cache files. */
     private workspaceRoot;
+    /** The maximum number of chat sessions allowed in the cache. Oldest sessions are discarded when this limit is exceeded. */
     private readonly MAX_SESSIONS;
+    /**
+     * Initializes the chat history service with the workspace root path.
+     * This must be called before attempting to read, save, or delete sessions.
+     *
+     * @param workspaceRoot - The absolute path to the workspace root directory.
+     */
     init(workspaceRoot: string): void;
+    /**
+     * Retrieves all saved chat sessions from the local workspace cache.
+     * If the service is not initialized or no sessions exist, an empty array is returned.
+     *
+     * @returns An array of saved `ChatSessionData` objects, ordered as stored in the cache.
+     */
     getSessions(): ChatSessionData[];
+    /**
+     * Saves or updates a chat session in the local workspace cache.
+     * If a session with the same ID already exists, it is updated in place. Otherwise, it is appended.
+     * Enforces the maximum session limit of 250 by removing the oldest session if the limit is exceeded.
+     *
+     * @param session - The chat session data to be saved.
+     * @returns A promise that resolves when the session has been successfully written to the cache.
+     */
     saveSession(session: ChatSessionData): Promise<void>;
+    /**
+     * Deletes a chat session from the local workspace cache and removes its associated archived history file.
+     * If the session or its archived history file does not exist, the operation completes without throwing an error.
+     *
+     * @param id - The unique identifier of the chat session to delete.
+     * @returns A promise that resolves when the session and its associated archive have been deleted.
+     */
     deleteSession(id: string): Promise<void>;
 }
+/**
+ * Singleton instance of the `ChatHistoryService` exported for application-wide use.
+ * This instance must be initialized with `init(workspaceRoot)` before use.
+ */
 export declare const chatHistoryService: ChatHistoryService;
 export {};

package/dist/services/chatHistoryService.js

@@ -1,16 +1,44 @@
 import { readCache, writeCache } from '../utils/projectStorage.js';
+/**
+ * Service responsible for managing the persistence, retrieval, and deletion of chat session histories.
+ * It stores session metadata and message history in a local JSON cache (`chat_sessions.json`)
+ * within the project's storage directory and enforces a maximum limit of 250 sessions to prevent
+ * unbounded storage growth.
+ */
 class ChatHistoryService {
+    /** The root directory of the currently active workspace. Used to locate the project storage and cache files. */
     workspaceRoot = '';
+    /** The maximum number of chat sessions allowed in the cache. Oldest sessions are discarded when this limit is exceeded. */
     MAX_SESSIONS = 250;
+    /**
+     * Initializes the chat history service with the workspace root path.
+     * This must be called before attempting to read, save, or delete sessions.
+     *
+     * @param workspaceRoot - The absolute path to the workspace root directory.
+     */
     init(workspaceRoot) {
         this.workspaceRoot = workspaceRoot;
     }
+    /**
+     * Retrieves all saved chat sessions from the local workspace cache.
+     * If the service is not initialized or no sessions exist, an empty array is returned.
+     *
+     * @returns An array of saved `ChatSessionData` objects, ordered as stored in the cache.
+     */
     getSessions() {
         if (!this.workspaceRoot)
             return [];
         const sessions = readCache(this.workspaceRoot, 'chat_sessions.json');
         return sessions || [];
     }
+    /**
+     * Saves or updates a chat session in the local workspace cache.
+     * If a session with the same ID already exists, it is updated in place. Otherwise, it is appended.
+     * Enforces the maximum session limit of 250 by removing the oldest session if the limit is exceeded.
+     *
+     * @param session - The chat session data to be saved.
+     * @returns A promise that resolves when the session has been successfully written to the cache.
+     */
     async saveSession(session) {
         if (!this.workspaceRoot)
             return;
@@ -28,6 +56,13 @@ class ChatHistoryService {
         }
         await writeCache(this.workspaceRoot, 'chat_sessions.json', sessions);
     }
+    /**
+     * Deletes a chat session from the local workspace cache and removes its associated archived history file.
+     * If the session or its archived history file does not exist, the operation completes without throwing an error.
+     *
+     * @param id - The unique identifier of the chat session to delete.
+     * @returns A promise that resolves when the session and its associated archive have been deleted.
+     */
     async deleteSession(id) {
         if (!this.workspaceRoot)
             return;
@@ -48,4 +83,8 @@ class ChatHistoryService {
         }
     }
 }
+/**
+ * Singleton instance of the `ChatHistoryService` exported for application-wide use.
+ * This instance must be initialized with `init(workspaceRoot)` before use.
+ */
 export const chatHistoryService = new ChatHistoryService();

package/dist/services/workspace.d.ts

@@ -1 +1,35 @@
+/**
+ * Synchronizes local workspace metadata with the remote Firestore database.
+ * This function tracks user project activity by updating a "last used" timestamp
+ * and project details in Firestore whenever a workspace is accessed.
+ *
+ * ### Internal Logic & Flow:
+ * 1. **JWT Decoding**:
+ *    - Splits the provided `idToken` (JWT) to extract the payload segment (second part).
+ *    - Decodes the payload from Base64 to a UTF-8 string and parses it as JSON.
+ *    - Extracts the `user_id` (UID) representing the authenticated user.
+ *    - If the token is invalid or does not contain a `user_id`, the function exits early.
+ *
+ * 2. **ID Generation**:
+ *    - Encodes the absolute `workspaceRoot` path into a Base64 string.
+ *    - Transforms the Base64 string to be URL-safe by replacing `/` with `_`, `+` with `-`, and removing `=` padding.
+ *    - This URL-safe string serves as a unique, deterministic document identifier for the workspace in Firestore.
+ *
+ * 3. **Firestore Integration**:
+ *    - Constructs a `PATCH` request URL targeting the user's specific project document in Firestore.
+ *    - Prepares a payload containing:
+ *      - `name`: The base name of the workspace directory.
+ *      - `path`: The absolute path to the workspace.
+ *      - `workspacePath`: The absolute path to the workspace.
+ *      - `lastUsed`: An ISO 8601 timestamp representing the current time.
+ *    - Sends the payload via a `PATCH` request to the Firestore REST API, passing the `idToken` in the `Authorization` header.
+ *
+ * 4. **Error Handling & Logging**:
+ *    - If the Firestore REST API returns a non-OK status, the response body is read and logged using `debugLog`.
+ *    - Any thrown exceptions (such as network failures or JSON parsing errors) are caught and logged using `debugLog`.
+ *
+ * @param idToken - The Firebase ID token (JWT) of the authenticated user.
+ * @param workspaceRoot - The absolute file system path of the workspace root.
+ * @returns A promise that resolves when the update attempt is complete.
+ */
 export declare function updateWorkspaceStatus(idToken: string, workspaceRoot: string): Promise<void>;

package/dist/services/workspace.js

@@ -1,5 +1,39 @@
 import * as path from 'path';
 import { debugLog } from '../utils/logger.js';
+/**
+ * Synchronizes local workspace metadata with the remote Firestore database.
+ * This function tracks user project activity by updating a "last used" timestamp
+ * and project details in Firestore whenever a workspace is accessed.
+ *
+ * ### Internal Logic & Flow:
+ * 1. **JWT Decoding**:
+ *    - Splits the provided `idToken` (JWT) to extract the payload segment (second part).
+ *    - Decodes the payload from Base64 to a UTF-8 string and parses it as JSON.
+ *    - Extracts the `user_id` (UID) representing the authenticated user.
+ *    - If the token is invalid or does not contain a `user_id`, the function exits early.
+ *
+ * 2. **ID Generation**:
+ *    - Encodes the absolute `workspaceRoot` path into a Base64 string.
+ *    - Transforms the Base64 string to be URL-safe by replacing `/` with `_`, `+` with `-`, and removing `=` padding.
+ *    - This URL-safe string serves as a unique, deterministic document identifier for the workspace in Firestore.
+ *
+ * 3. **Firestore Integration**:
+ *    - Constructs a `PATCH` request URL targeting the user's specific project document in Firestore.
+ *    - Prepares a payload containing:
+ *      - `name`: The base name of the workspace directory.
+ *      - `path`: The absolute path to the workspace.
+ *      - `workspacePath`: The absolute path to the workspace.
+ *      - `lastUsed`: An ISO 8601 timestamp representing the current time.
+ *    - Sends the payload via a `PATCH` request to the Firestore REST API, passing the `idToken` in the `Authorization` header.
+ *
+ * 4. **Error Handling & Logging**:
+ *    - If the Firestore REST API returns a non-OK status, the response body is read and logged using `debugLog`.
+ *    - Any thrown exceptions (such as network failures or JSON parsing errors) are caught and logged using `debugLog`.
+ *
+ * @param idToken - The Firebase ID token (JWT) of the authenticated user.
+ * @param workspaceRoot - The absolute file system path of the workspace root.
+ * @returns A promise that resolves when the update attempt is complete.
+ */
 export async function updateWorkspaceStatus(idToken, workspaceRoot) {
     try {
         // 1. Decode JWT to get user_id (uid)
@@ -14,7 +48,8 @@ export async function updateWorkspaceStatus(idToken, workspaceRoot) {
         // 2. Generate a URL-safe ID for the workspace based on its path
         const workspaceId = Buffer.from(workspaceRoot)
             .toString('base64')
-            .replace(/\//g, '_')
+            // eslint-disable-next-line prefer-regex-literals
+            .replace(new RegExp('/', 'g'), '_')
             .replace(/\+/g, '-')
             .replace(/=/g, '');
         // 3. Prepare the Firestore REST API payload

package/oclif.manifest.json

@@ -65,5 +65,5 @@
       ]
     }
   },
-  "version": "2.2.3"
+  "version": "2.2.4"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "minovative-mind-cli",
   "description": "An automated AI agent powered by Vertex AI that helps you write software",
-  "version": "2.2.3",
+  "version": "2.2.4",
   "author": "Daniel Ward",
   "bin": {
     "minovative-mind-cli": "bin/run.js"