agentic-qe 1.3.4 → 1.3.6

package/dist/agents/memory/AgentMemoryService.d.ts

@@ -0,0 +1,173 @@
+/**
+ * AgentMemoryService - Manages agent memory operations with automatic namespacing
+ *
+ * Responsibilities:
+ * - Namespaced memory operations (agent-specific and shared)
+ * - Task result storage and retrieval
+ * - State persistence and restoration
+ * - Memory key generation and validation
+ *
+ * Part of BaseAgent refactoring (Phase 3)
+ * Reduces BaseAgent complexity by ~150 LOC
+ */
+import { MemoryStore, AgentId, QEAgentType as AgentType } from '../../types';
+export interface AgentMemoryServiceConfig {
+    agentId: AgentId;
+    memoryStore: MemoryStore;
+}
+export interface TaskResultData {
+    result: any;
+    timestamp: Date;
+    agentId: string;
+}
+export interface AgentStateData {
+    performanceMetrics?: any;
+    timestamp: Date;
+    [key: string]: any;
+}
+export interface ErrorRecord {
+    error: {
+        message: string;
+        stack?: string;
+        name: string;
+    };
+    assignment: {
+        id: string;
+        taskType: string;
+    };
+    timestamp: Date;
+    agentId: string;
+}
+export declare class AgentMemoryService {
+    private readonly agentId;
+    private readonly memoryStore;
+    constructor(config: AgentMemoryServiceConfig);
+    /**
+     * Store data in agent-specific memory namespace
+     * @param key Memory key (will be prefixed with agent:agentId:)
+     * @param value Value to store
+     * @param ttl Optional time-to-live in seconds
+     */
+    store(key: string, value: any, ttl?: number): Promise<void>;
+    /**
+     * Retrieve data from agent-specific memory namespace
+     * @param key Memory key (will be prefixed with agent:agentId:)
+     * @returns Stored value or null if not found
+     */
+    retrieve(key: string): Promise<any>;
+    /**
+     * Check if key exists in agent memory
+     * @param key Memory key to check
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Delete data from agent memory
+     * @param key Memory key to delete
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Store data in shared memory accessible by agents of the same type
+     * @param key Memory key (will be prefixed with shared:agentType:)
+     * @param value Value to store
+     * @param ttl Optional time-to-live in seconds
+     */
+    storeShared(key: string, value: any, ttl?: number): Promise<void>;
+    /**
+     * Retrieve data from shared memory of a specific agent type
+     * @param agentType Type of agent that stored the data
+     * @param key Memory key (will be prefixed with shared:agentType:)
+     * @returns Stored value or null if not found
+     */
+    retrieveShared(agentType: AgentType, key: string): Promise<any>;
+    /**
+     * Retrieve shared memory from this agent's type
+     * @param key Memory key
+     */
+    retrieveOwnShared(key: string): Promise<any>;
+    /**
+     * Store task execution result
+     * @param taskId Task identifier
+     * @param result Task result data
+     */
+    storeTaskResult(taskId: string, result: any): Promise<void>;
+    /**
+     * Retrieve task execution result
+     * @param taskId Task identifier
+     * @returns Task result or null if not found
+     */
+    retrieveTaskResult(taskId: string): Promise<TaskResultData | null>;
+    /**
+     * Store task error information
+     * @param taskId Task identifier
+     * @param assignment Task assignment details
+     * @param error Error object
+     */
+    storeTaskError(taskId: string, assignment: {
+        id: string;
+        taskType: string;
+    }, error: Error): Promise<void>;
+    /**
+     * Retrieve task error information
+     * @param taskId Task identifier
+     * @returns Error record or null if not found
+     */
+    retrieveTaskError(taskId: string): Promise<ErrorRecord | null>;
+    /**
+     * Save agent state to memory
+     * @param state State data to persist
+     */
+    saveState(state: AgentStateData): Promise<void>;
+    /**
+     * Restore agent state from memory
+     * @returns Stored state or null if not found
+     */
+    restoreState(): Promise<AgentStateData | null>;
+    /**
+     * Clear saved state
+     */
+    clearState(): Promise<void>;
+    /**
+     * Report agent status to coordination system
+     * @param status Status string
+     * @param metrics Optional metrics data
+     */
+    reportStatus(status: string, metrics?: any): Promise<void>;
+    /**
+     * Retrieve status of another agent of the same type
+     * @param agentId Agent identifier
+     * @returns Status information or null if not found
+     */
+    retrieveAgentStatus(agentId: string): Promise<any>;
+    /**
+     * Build agent-specific namespaced key
+     * @param key Original key
+     * @returns Namespaced key (agent:agentId:key)
+     */
+    private buildAgentKey;
+    /**
+     * Build shared memory key
+     * @param key Original key
+     * @returns Shared key (shared:agentType:key)
+     */
+    private buildSharedKey;
+    /**
+     * Validate memory key format
+     * @param key Key to validate
+     * @throws Error if key is invalid
+     */
+    private validateKey;
+    /**
+     * Get memory usage statistics (if supported by MemoryStore)
+     * @returns Statistics object or null if not supported
+     */
+    getStatistics(): Promise<{
+        totalKeys: number;
+        agentKeys: number;
+        sharedKeys: number;
+    } | null>;
+    /**
+     * Get agent ID
+     */
+    getAgentId(): AgentId;
+}
+//# sourceMappingURL=AgentMemoryService.d.ts.map

package/dist/agents/memory/AgentMemoryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentMemoryService.d.ts","sourceRoot":"","sources":["../../../src/agents/memory/AgentMemoryService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7E,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,GAAG,CAAC;IACZ,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,kBAAkB,CAAC,EAAE,GAAG,CAAC;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,MAAM,EAAE,wBAAwB;IAS5C;;;;;OAKG;IACU,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxE;;;;OAIG;IACU,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAahD;;;OAGG;IACU,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/C;;;OAGG;IACU,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/C;;;;;OAKG;IACU,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9E;;;;;OAKG;IACU,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAa5E;;;OAGG;IACU,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQzD;;;;OAIG;IACU,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxE;;;;OAIG;IACU,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI/E;;;;;OAKG;IACU,cAAc,CACzB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAC5C,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,IAAI,CAAC;IAehB;;;;OAIG;IACU,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQ3E;;;OAGG;IACU,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5D;;;OAGG;IACU,YAAY,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAgB3D;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxC;;;;OAIG;IACU,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAavE;;;;OAIG;IACU,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQ/D;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAItB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAkBnB;;;OAGG;IACU,aAAa,IAAI,OAAO,CAAC;QACpC,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;IAMT;;OAEG;IACI,UAAU,IAAI,OAAO;CAG7B"}

package/dist/agents/memory/AgentMemoryService.js

@@ -0,0 +1,297 @@
+"use strict";
+/**
+ * AgentMemoryService - Manages agent memory operations with automatic namespacing
+ *
+ * Responsibilities:
+ * - Namespaced memory operations (agent-specific and shared)
+ * - Task result storage and retrieval
+ * - State persistence and restoration
+ * - Memory key generation and validation
+ *
+ * Part of BaseAgent refactoring (Phase 3)
+ * Reduces BaseAgent complexity by ~150 LOC
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentMemoryService = void 0;
+class AgentMemoryService {
+    constructor(config) {
+        this.agentId = config.agentId;
+        this.memoryStore = config.memoryStore;
+    }
+    // ============================================================================
+    // Agent-Specific Memory (Namespaced by agent ID)
+    // ============================================================================
+    /**
+     * Store data in agent-specific memory namespace
+     * @param key Memory key (will be prefixed with agent:agentId:)
+     * @param value Value to store
+     * @param ttl Optional time-to-live in seconds
+     */
+    async store(key, value, ttl) {
+        this.validateKey(key);
+        const namespacedKey = this.buildAgentKey(key);
+        try {
+            await this.memoryStore.store(namespacedKey, value, ttl);
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Failed to store memory at ${namespacedKey}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Retrieve data from agent-specific memory namespace
+     * @param key Memory key (will be prefixed with agent:agentId:)
+     * @returns Stored value or null if not found
+     */
+    async retrieve(key) {
+        this.validateKey(key);
+        const namespacedKey = this.buildAgentKey(key);
+        try {
+            return await this.memoryStore.retrieve(namespacedKey);
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Failed to retrieve memory from ${namespacedKey}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Check if key exists in agent memory
+     * @param key Memory key to check
+     */
+    async has(key) {
+        const value = await this.retrieve(key);
+        return value !== null && value !== undefined;
+    }
+    /**
+     * Delete data from agent memory
+     * @param key Memory key to delete
+     */
+    async delete(key) {
+        this.validateKey(key);
+        const namespacedKey = this.buildAgentKey(key);
+        try {
+            // MemoryStore interface doesn't have delete, so we store null with TTL=1
+            await this.memoryStore.store(namespacedKey, null, 1);
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Failed to delete memory at ${namespacedKey}:`, error);
+        }
+    }
+    // ============================================================================
+    // Shared Memory (Accessible by other agents)
+    // ============================================================================
+    /**
+     * Store data in shared memory accessible by agents of the same type
+     * @param key Memory key (will be prefixed with shared:agentType:)
+     * @param value Value to store
+     * @param ttl Optional time-to-live in seconds
+     */
+    async storeShared(key, value, ttl) {
+        this.validateKey(key);
+        const sharedKey = this.buildSharedKey(key);
+        try {
+            await this.memoryStore.store(sharedKey, value, ttl);
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Failed to store shared memory at ${sharedKey}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Retrieve data from shared memory of a specific agent type
+     * @param agentType Type of agent that stored the data
+     * @param key Memory key (will be prefixed with shared:agentType:)
+     * @returns Stored value or null if not found
+     */
+    async retrieveShared(agentType, key) {
+        this.validateKey(key);
+        const sharedKey = `shared:${agentType}:${key}`;
+        try {
+            return await this.memoryStore.retrieve(sharedKey);
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Failed to retrieve shared memory from ${sharedKey}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Retrieve shared memory from this agent's type
+     * @param key Memory key
+     */
+    async retrieveOwnShared(key) {
+        return this.retrieveShared(this.agentId.type, key);
+    }
+    // ============================================================================
+    // Task-Specific Memory
+    // ============================================================================
+    /**
+     * Store task execution result
+     * @param taskId Task identifier
+     * @param result Task result data
+     */
+    async storeTaskResult(taskId, result) {
+        const data = {
+            result,
+            timestamp: new Date(),
+            agentId: this.agentId.id
+        };
+        await this.store(`task:${taskId}:result`, data);
+    }
+    /**
+     * Retrieve task execution result
+     * @param taskId Task identifier
+     * @returns Task result or null if not found
+     */
+    async retrieveTaskResult(taskId) {
+        return await this.retrieve(`task:${taskId}:result`);
+    }
+    /**
+     * Store task error information
+     * @param taskId Task identifier
+     * @param assignment Task assignment details
+     * @param error Error object
+     */
+    async storeTaskError(taskId, assignment, error) {
+        const errorRecord = {
+            error: {
+                message: error.message,
+                stack: error.stack,
+                name: error.name
+            },
+            assignment,
+            timestamp: new Date(),
+            agentId: this.agentId.id
+        };
+        await this.store(`error:${taskId}`, errorRecord);
+    }
+    /**
+     * Retrieve task error information
+     * @param taskId Task identifier
+     * @returns Error record or null if not found
+     */
+    async retrieveTaskError(taskId) {
+        return await this.retrieve(`error:${taskId}`);
+    }
+    // ============================================================================
+    // State Persistence
+    // ============================================================================
+    /**
+     * Save agent state to memory
+     * @param state State data to persist
+     */
+    async saveState(state) {
+        const stateWithTimestamp = {
+            ...state,
+            timestamp: new Date()
+        };
+        await this.store('state', stateWithTimestamp);
+    }
+    /**
+     * Restore agent state from memory
+     * @returns Stored state or null if not found
+     */
+    async restoreState() {
+        try {
+            const state = await this.retrieve('state');
+            if (!state) {
+                console.info(`[${this.agentId.id}] No saved state found`);
+                return null;
+            }
+            return state;
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Could not restore state:`, error);
+            return null;
+        }
+    }
+    /**
+     * Clear saved state
+     */
+    async clearState() {
+        await this.delete('state');
+    }
+    // ============================================================================
+    // Status Reporting
+    // ============================================================================
+    /**
+     * Report agent status to coordination system
+     * @param status Status string
+     * @param metrics Optional metrics data
+     */
+    async reportStatus(status, metrics) {
+        try {
+            await this.storeShared('status', {
+                agentId: this.agentId.id,
+                status,
+                metrics,
+                timestamp: new Date()
+            });
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Failed to report status:`, error);
+        }
+    }
+    /**
+     * Retrieve status of another agent of the same type
+     * @param agentId Agent identifier
+     * @returns Status information or null if not found
+     */
+    async retrieveAgentStatus(agentId) {
+        return await this.retrieveOwnShared('status');
+    }
+    // ============================================================================
+    // Helper Methods
+    // ============================================================================
+    /**
+     * Build agent-specific namespaced key
+     * @param key Original key
+     * @returns Namespaced key (agent:agentId:key)
+     */
+    buildAgentKey(key) {
+        return `agent:${this.agentId.id}:${key}`;
+    }
+    /**
+     * Build shared memory key
+     * @param key Original key
+     * @returns Shared key (shared:agentType:key)
+     */
+    buildSharedKey(key) {
+        return `shared:${this.agentId.type}:${key}`;
+    }
+    /**
+     * Validate memory key format
+     * @param key Key to validate
+     * @throws Error if key is invalid
+     */
+    validateKey(key) {
+        if (!key || typeof key !== 'string') {
+            throw new Error('Memory key must be a non-empty string');
+        }
+        if (key.includes('..')) {
+            throw new Error('Memory key cannot contain ".." (path traversal)');
+        }
+        if (key.length > 256) {
+            throw new Error('Memory key too long (max 256 characters)');
+        }
+    }
+    // ============================================================================
+    // Statistics
+    // ============================================================================
+    /**
+     * Get memory usage statistics (if supported by MemoryStore)
+     * @returns Statistics object or null if not supported
+     */
+    async getStatistics() {
+        // This would require additional methods on MemoryStore interface
+        // For now, return null
+        return null;
+    }
+    /**
+     * Get agent ID
+     */
+    getAgentId() {
+        return this.agentId;
+    }
+}
+exports.AgentMemoryService = AgentMemoryService;
+//# sourceMappingURL=AgentMemoryService.js.map

package/dist/agents/memory/AgentMemoryService.js.map

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

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAe,MAAM,aAAa,CAAC;AAMvD,qBAAa,WAAW;WACT,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;mBAiOpC,wBAAwB;mBAuCxB,kBAAkB;mBAsElB,iBAAiB;mBAiSjB,mBAAmB;mBAyFnB,eAAe;IAMpC;;OAEG;mBACkB,kBAAkB;IA+IvC;;OAEG;mBACkB,cAAc;IAiBnC;;OAEG;mBACkB,oBAAoB;IAoFzC;;OAEG;mBACkB,iBAAiB;mBAMjB,gBAAgB;IAyBrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;mBA4BR,kBAAkB;IAkDvC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IA0BnC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAWnC,OAAO,CAAC,MAAM,CAAC,0BAA0B;mBAwBpB,0BAA0B;mBAoC1B,kBAAkB;mBAclB,sBAAsB;mBAoDtB,cAAc;IAwdnC;;OAEG;mBACkB,yBAAyB;IAoC9C;;OAEG;mBACkB,wBAAwB;IAsB7C;;OAEG;mBACkB,wBAAwB;IAqC7C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IA8GnC;;OAEG;mBACkB,yBAAyB;IA2C9C;;OAEG;mBACkB,yBAAyB;IA6F9C;;OAEG;mBACkB,2BAA2B;IAoGhD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAwB7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAoBrC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAe,MAAM,aAAa,CAAC;AAMvD,qBAAa,WAAW;WACT,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;mBAiOpC,wBAAwB;mBAuCxB,kBAAkB;mBAsElB,iBAAiB;mBAiSjB,mBAAmB;mBAyFnB,eAAe;IAMpC;;OAEG;mBACkB,kBAAkB;IA+IvC;;OAEG;mBACkB,cAAc;IAiBnC;;OAEG;mBACkB,oBAAoB;IAoFzC;;OAEG;mBACkB,iBAAiB;mBAMjB,gBAAgB;IAyBrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;mBA4BR,kBAAkB;IAkDvC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IA0BnC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAWnC,OAAO,CAAC,MAAM,CAAC,0BAA0B;mBAwBpB,0BAA0B;mBAoC1B,kBAAkB;mBAclB,sBAAsB;mBAoDtB,cAAc;IAmgBnC;;OAEG;mBACkB,yBAAyB;IAoC9C;;OAEG;mBACkB,wBAAwB;IAsB7C;;OAEG;mBACkB,wBAAwB;IAqC7C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IA8GnC;;OAEG;mBACkB,yBAAyB;IA2C9C;;OAEG;mBACkB,yBAAyB;IA6F9C;;OAEG;mBACkB,2BAA2B;IAoGhD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAwB7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAoBrC"}

package/dist/cli/commands/init.js

@@ -185,7 +185,7 @@ class InitCommand {
             }
             spinner.text = 'Creating CLAUDE.md documentation...';
             // Create or update CLAUDE.md with agent documentation
-            await this.createClaudeMd(fleetConfig);
+            await this.createClaudeMd(fleetConfig, options.yes);
             // Initialize Claude Flow coordination
             await this.initializeCoordination(fleetConfig);
             // Phase 2: Initialize memory database FIRST (required for agents)
@@ -1173,16 +1173,42 @@ echo "[AQE] Post-execution coordination complete"
         await fs.ensureDir('.agentic-qe/logs');
         await fs.ensureDir('.agentic-qe/state/coordination');
     }
-    static async createClaudeMd(config) {
+    static async createClaudeMd(config, isYesMode = false) {
         const claudeMdPath = 'CLAUDE.md';
         const agentCount = await this.countAgentFiles('.claude/agents');
         // Check if CLAUDE.md exists
         const exists = await fs.pathExists(claudeMdPath);
+        let existingContent = '';
+        let appendPosition = 'append'; // default for --yes mode (v1.3.7 fix)
         if (exists) {
             // Backup existing CLAUDE.md
             const backupPath = 'CLAUDE.md.backup';
             await fs.copy(claudeMdPath, backupPath);
             console.log(chalk_1.default.yellow(`  ℹ️  Existing CLAUDE.md backed up to ${backupPath}`));
+            // Read existing content
+            existingContent = await fs.readFile(claudeMdPath, 'utf8');
+            // In interactive mode, ask where to add AQE instructions (v1.3.7 fix)
+            if (!isYesMode) {
+                const { position } = await inquirer_1.default.prompt([
+                    {
+                        type: 'list',
+                        name: 'position',
+                        message: 'Existing CLAUDE.md detected. Where should we add AQE instructions?',
+                        choices: [
+                            {
+                                name: 'At the end (append) - Recommended',
+                                value: 'append',
+                            },
+                            {
+                                name: 'At the beginning (prepend)',
+                                value: 'prepend',
+                            },
+                        ],
+                        default: 'append',
+                    },
+                ]);
+                appendPosition = position;
+            }
         }
         const claudeMdContent = `# Claude Code Configuration - Agentic QE Fleet
 
@@ -1634,7 +1660,23 @@ tail -f .agentic-qe/logs/fleet.log
 **Initialization Date**: ${new Date().toISOString()}
 **Fleet Topology**: ${config.topology}
 `;
-        await fs.writeFile(claudeMdPath, claudeMdContent);
+        // Write CLAUDE.md based on append strategy (v1.3.7 fix)
+        let finalContent;
+        if (exists && existingContent) {
+            const separator = '\n\n---\n\n';
+            if (appendPosition === 'append') {
+                finalContent = existingContent + separator + claudeMdContent;
+                console.log(chalk_1.default.green(`  ✓ AQE instructions appended to existing CLAUDE.md`));
+            }
+            else {
+                finalContent = claudeMdContent + separator + existingContent;
+                console.log(chalk_1.default.green(`  ✓ AQE instructions prepended to existing CLAUDE.md`));
+            }
+        }
+        else {
+            finalContent = claudeMdContent;
+        }
+        await fs.writeFile(claudeMdPath, finalContent);
     }
     // ============================================================================
     // Phase 2 Initialization Methods (v1.1.0)