agentic-qe 1.8.4 → 1.9.0

package/dist/cli/init/database-init.js

@@ -0,0 +1,203 @@
+"use strict";
+/**
+ * Database initialization module
+ *
+ * Initializes AgentDB, memory databases, and learning databases
+ *
+ * @module cli/init/database-init
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeDatabases = initializeDatabases;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+const chalk_1 = __importDefault(require("chalk"));
+// Import version from package.json to maintain consistency
+const packageJson = require('../../../package.json');
+const PACKAGE_VERSION = packageJson.version;
+/**
+ * Initialize all databases for the Agentic QE Fleet
+ *
+ * @param config - Fleet configuration
+ */
+async function initializeDatabases(config) {
+    const baseDir = process.cwd();
+    const dataDir = path.join(baseDir, '.agentic-qe', 'data');
+    console.log(chalk_1.default.gray(`  • Initializing databases in ${dataDir}`));
+    // Phase 1: Initialize memory database FIRST (required for agents)
+    await initializeMemoryDatabase();
+    // Phase 2: Initialize AgentDB for learning (v1.8.0 - replaces patterns.db)
+    await initializeAgentDB(config);
+    // Phase 3: Initialize learning system
+    await initializeLearningSystem(config);
+    // Phase 4: Initialize improvement loop
+    await initializeImprovementLoop(config);
+    console.log(chalk_1.default.green('  ✓ All databases initialized'));
+}
+/**
+ * Initialize Memory Manager database
+ *
+ * Creates and initializes the SwarmMemoryManager database with 12 tables
+ * for persistent memory storage across agents.
+ */
+async function initializeMemoryDatabase() {
+    const dbPath = path.join(process.cwd(), '.agentic-qe', 'memory.db');
+    console.log(chalk_1.default.cyan('  💾 Initializing Memory Manager database...'));
+    // Import SwarmMemoryManager dynamically
+    const { SwarmMemoryManager } = await Promise.resolve().then(() => __importStar(require('../../core/memory/SwarmMemoryManager')));
+    const memoryManager = new SwarmMemoryManager(dbPath);
+    await memoryManager.initialize();
+    // Verify tables created
+    const stats = await memoryManager.stats();
+    await memoryManager.close();
+    console.log(chalk_1.default.green('  ✓ Memory Manager initialized'));
+    console.log(chalk_1.default.gray(`    • Database: ${dbPath}`));
+    console.log(chalk_1.default.gray(`    • Tables: 12 tables (memory_entries, hints, events, workflow_state, patterns, etc.)`));
+    console.log(chalk_1.default.gray(`    • Access control: 5 levels (private, team, swarm, public, system)`));
+}
+/**
+ * Initialize AgentDB for Learning (v1.8.0 - replaces patterns.db)
+ *
+ * Consolidated learning storage for all QE agents using AgentDB.
+ * Replaces the deprecated patterns.db with vector-based learning storage.
+ */
+async function initializeAgentDB(config) {
+    const dbPath = path.join(process.cwd(), '.agentic-qe', 'agentdb.db');
+    console.log(chalk_1.default.cyan('  🧠 Initializing AgentDB learning system...'));
+    // Import AgentDB dynamically
+    const { createAgentDBManager } = await Promise.resolve().then(() => __importStar(require('../../core/memory/AgentDBManager')));
+    // Initialize AgentDB with learning configuration
+    const agentDB = await createAgentDBManager({
+        dbPath,
+        enableLearning: true,
+        enableReasoning: true,
+        cacheSize: 1000,
+        quantizationType: 'scalar'
+    });
+    // CRITICAL: Must initialize before calling getStats()
+    await agentDB.initialize();
+    // Verify initialization
+    const stats = await agentDB.getStats();
+    await agentDB.close();
+    console.log(chalk_1.default.green('  ✓ AgentDB learning system initialized'));
+    console.log(chalk_1.default.gray(`    • Database: ${dbPath}`));
+    console.log(chalk_1.default.gray(`    • Episodes stored: ${stats.episodeCount || 0}`));
+    console.log(chalk_1.default.gray(`    • Vector search: HNSW enabled (150x faster)`));
+    console.log(chalk_1.default.gray(`    • Learning: Reflexion pattern + Q-values`));
+    console.log(chalk_1.default.gray(`    • Used by: All 19 QE agents`));
+    console.log(chalk_1.default.yellow(`    ⓘ  patterns.db deprecated - using AgentDB for all learning`));
+}
+/**
+ * Initialize Phase 2 Learning System
+ *
+ * Creates learning configuration and database directory for agent learning.
+ */
+async function initializeLearningSystem(config) {
+    const learningConfig = {
+        enabled: true,
+        learningRate: 0.1,
+        discountFactor: 0.95,
+        explorationRate: 0.2,
+        explorationDecay: 0.995,
+        minExplorationRate: 0.01,
+        targetImprovement: 0.20, // 20% improvement goal
+        maxMemorySize: 100 * 1024 * 1024, // 100MB
+        batchSize: 32,
+        updateFrequency: 10,
+        replayBufferSize: 10000
+    };
+    // Store learning configuration
+    await fs.writeJson('.agentic-qe/config/learning.json', learningConfig, { spaces: 2 });
+    // Create learning database directory
+    await fs.ensureDir('.agentic-qe/data/learning');
+    // Create learning state placeholder
+    const learningState = {
+        initialized: true,
+        version: PACKAGE_VERSION,
+        createdAt: new Date().toISOString(),
+        agents: {} // Will be populated as agents learn
+    };
+    await fs.writeJson('.agentic-qe/data/learning/state.json', learningState, { spaces: 2 });
+    console.log(chalk_1.default.green('  ✓ Learning system initialized'));
+    console.log(chalk_1.default.gray(`    • Learning rate: ${learningConfig.learningRate}`));
+    console.log(chalk_1.default.gray(`    • Target improvement: ${learningConfig.targetImprovement * 100}%`));
+}
+/**
+ * Initialize Improvement Loop
+ *
+ * Creates improvement configuration for continuous optimization with A/B testing.
+ */
+async function initializeImprovementLoop(config) {
+    const improvementConfig = {
+        enabled: true,
+        intervalMs: 3600000, // 1 hour
+        autoApply: false, // Requires user approval
+        enableABTesting: true,
+        strategies: {
+            parallelExecution: { enabled: true, weight: 0.8 },
+            adaptiveRetry: { enabled: true, maxRetries: 3 },
+            resourceOptimization: { enabled: true, adaptive: true }
+        },
+        thresholds: {
+            minImprovement: 0.05, // 5% minimum improvement to apply
+            maxFailureRate: 0.1, // 10% max failure rate
+            minConfidence: 0.8 // 80% confidence required
+        },
+        abTesting: {
+            sampleSize: 100,
+            significanceLevel: 0.05,
+            minSampleDuration: 3600000 // 1 hour
+        }
+    };
+    // Store improvement configuration
+    await fs.writeJson('.agentic-qe/config/improvement.json', improvementConfig, { spaces: 2 });
+    // Create improvement state
+    const improvementState = {
+        version: PACKAGE_VERSION,
+        lastCycle: null,
+        activeCycles: 0,
+        totalImprovement: 0,
+        strategies: {}
+    };
+    await fs.writeJson('.agentic-qe/data/improvement/state.json', improvementState, { spaces: 2 });
+    console.log(chalk_1.default.green('  ✓ Improvement loop initialized'));
+    console.log(chalk_1.default.gray(`    • Cycle interval: ${improvementConfig.intervalMs / 3600000} hour(s)`));
+    console.log(chalk_1.default.gray(`    • A/B testing: enabled (sample size: ${improvementConfig.abTesting.sampleSize})`));
+    console.log(chalk_1.default.gray(`    • Auto-apply: ${improvementConfig.autoApply ? 'enabled' : 'disabled (requires approval)'}`));
+}
+//# sourceMappingURL=database-init.js.map

package/dist/cli/init/database-init.js.map

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

package/dist/cli/init/directory-structure.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Directory structure creation module
+ *
+ * Creates the standardized Agentic QE Fleet directory structure
+ *
+ * @module cli/init/directory-structure
+ */
+/**
+ * Create the standard Agentic QE directory structure
+ *
+ * @param force - Force overwrite existing directories
+ */
+export declare function createDirectoryStructure(force?: boolean): Promise<void>;
+//# sourceMappingURL=directory-structure.d.ts.map

package/dist/cli/init/directory-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-structure.d.ts","sourceRoot":"","sources":["../../../src/cli/init/directory-structure.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDpF"}

package/dist/cli/init/directory-structure.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Directory structure creation module
+ *
+ * Creates the standardized Agentic QE Fleet directory structure
+ *
+ * @module cli/init/directory-structure
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDirectoryStructure = createDirectoryStructure;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Create the standard Agentic QE directory structure
+ *
+ * @param force - Force overwrite existing directories
+ */
+async function createDirectoryStructure(force = false) {
+    const baseDir = process.cwd();
+    // Define directory structure
+    const directories = [
+        '.agentic-qe',
+        '.agentic-qe/data',
+        '.agentic-qe/data/learning',
+        '.agentic-qe/data/patterns',
+        '.agentic-qe/data/improvement',
+        '.agentic-qe/data/memory',
+        '.agentic-qe/agents',
+        '.agentic-qe/config',
+        '.agentic-qe/docs',
+        'tests',
+        'tests/unit',
+        'tests/integration',
+        'tests/e2e'
+    ];
+    // Create each directory
+    for (const dir of directories) {
+        const fullPath = path.join(baseDir, dir);
+        try {
+            if (await fs.pathExists(fullPath) && !force) {
+                console.log(chalk_1.default.gray(`  ✓ Directory exists: ${dir}`));
+                continue;
+            }
+            await fs.ensureDir(fullPath);
+            console.log(chalk_1.default.green(`  ✓ Created: ${dir}`));
+        }
+        catch (error) {
+            throw new Error(`Failed to create directory ${dir}: ${error}`);
+        }
+    }
+    // Create .gitignore if it doesn't exist
+    const gitignorePath = path.join(baseDir, '.agentic-qe', '.gitignore');
+    if (!await fs.pathExists(gitignorePath) || force) {
+        const gitignoreContent = `# Agentic QE Fleet - Generated files
+data/*.db
+data/*.db-journal
+data/*.db-wal
+data/*.db-shm
+data/learning/*
+data/patterns/*
+data/improvement/*
+data/memory/*
+*.log
+*.tmp
+`;
+        await fs.writeFile(gitignorePath, gitignoreContent);
+        console.log(chalk_1.default.green('  ✓ Created: .agentic-qe/.gitignore'));
+    }
+}
+//# sourceMappingURL=directory-structure.js.map

package/dist/cli/init/directory-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-structure.js","sourceRoot":"","sources":["../../../src/cli/init/directory-structure.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWH,4DAuDC;AAhED,6CAA+B;AAC/B,2CAA6B;AAC7B,kDAA0B;AAE1B;;;;GAIG;AACI,KAAK,UAAU,wBAAwB,CAAC,QAAiB,KAAK;IACnE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE9B,6BAA6B;IAC7B,MAAM,WAAW,GAAG;QAClB,aAAa;QACb,kBAAkB;QAClB,2BAA2B;QAC3B,2BAA2B;QAC3B,8BAA8B;QAC9B,yBAAyB;QACzB,oBAAoB;QACpB,oBAAoB;QACpB,kBAAkB;QAClB,OAAO;QACP,YAAY;QACZ,mBAAmB;QACnB,WAAW;KACZ,CAAC;IAEF,wBAAwB;IACxB,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAEzC,IAAI,CAAC;YACH,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC5C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC,CAAC;gBACxD,SAAS;YACX,CAAC;YAED,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;IACtE,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,KAAK,EAAE,CAAC;QACjD,MAAM,gBAAgB,GAAG;;;;;;;;;;;CAW5B,CAAC;QACE,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/cli/init/documentation.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Documentation copying module
+ *
+ * Copies reference documentation to the project
+ *
+ * @module cli/init/documentation
+ */
+/**
+ * Copy reference documentation to project
+ *
+ * Copies agent reference, skills reference, and usage guides to .agentic-qe/docs
+ */
+export declare function copyDocumentation(): Promise<void>;
+//# sourceMappingURL=documentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documentation.d.ts","sourceRoot":"","sources":["../../../src/cli/init/documentation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAwDvD"}

package/dist/cli/init/documentation.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Documentation copying module
+ *
+ * Copies reference documentation to the project
+ *
+ * @module cli/init/documentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyDocumentation = copyDocumentation;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const path_utils_1 = require("./utils/path-utils");
+/**
+ * Copy reference documentation to project
+ *
+ * Copies agent reference, skills reference, and usage guides to .agentic-qe/docs
+ */
+async function copyDocumentation() {
+    console.log(chalk_1.default.gray('  • Copying reference documentation'));
+    const docsDir = '.agentic-qe/docs';
+    await fs.ensureDir(docsDir);
+    // 🔧 CENTRALIZED: Use getPackageRoot for robust package location
+    let packageDocsPath;
+    try {
+        packageDocsPath = path.join((0, path_utils_1.getPackageRoot)(), 'docs', 'reference');
+    }
+    catch (error) {
+        console.log(chalk_1.default.yellow('  ⚠️  Could not locate package root'));
+        console.log(chalk_1.default.gray('    Creating minimal documentation stubs...'));
+        await createMinimalDocs(docsDir);
+        return;
+    }
+    // Check if source docs exist
+    const sourceExists = await fs.pathExists(packageDocsPath);
+    if (!sourceExists) {
+        console.log(chalk_1.default.yellow('  ⚠️  Reference documentation not found in package'));
+        console.log(chalk_1.default.gray('    Creating minimal documentation stubs...'));
+        await createMinimalDocs(docsDir);
+        return;
+    }
+    try {
+        // Copy agent reference
+        const agentsSource = path.join(packageDocsPath, 'agents.md');
+        if (await fs.pathExists(agentsSource)) {
+            await fs.copy(agentsSource, path.join(docsDir, 'agents.md'));
+            console.log(chalk_1.default.gray('    • Agents reference'));
+        }
+        // Copy skills reference
+        const skillsSource = path.join(packageDocsPath, 'skills.md');
+        if (await fs.pathExists(skillsSource)) {
+            await fs.copy(skillsSource, path.join(docsDir, 'skills.md'));
+            console.log(chalk_1.default.gray('    • Skills reference'));
+        }
+        // Copy usage guide
+        const usageSource = path.join(packageDocsPath, 'usage.md');
+        if (await fs.pathExists(usageSource)) {
+            await fs.copy(usageSource, path.join(docsDir, 'usage.md'));
+            console.log(chalk_1.default.gray('    • Usage guide'));
+        }
+        console.log(chalk_1.default.green('  ✓ Documentation copied'));
+    }
+    catch (error) {
+        console.log(chalk_1.default.yellow('  ⚠️  Error copying documentation'));
+        console.log(chalk_1.default.gray(`    ${error.message}`));
+        console.log(chalk_1.default.gray('    Creating minimal documentation stubs...'));
+        await createMinimalDocs(docsDir);
+    }
+}
+/**
+ * Create minimal documentation stubs if package docs not available
+ */
+async function createMinimalDocs(docsDir) {
+    // Minimal agents.md
+    const agentsContent = `# Agentic QE Fleet - Agents Reference
+
+## Available Agents
+
+For the complete list of agents and their capabilities, please visit:
+https://github.com/proffesor-for-testing/agentic-qe/blob/main/docs/reference/agents.md
+
+## Quick Reference
+
+- **qe-test-generator**: Generate comprehensive test suites
+- **qe-coverage-analyzer**: Analyze and improve test coverage
+- **qe-integration-tester**: Execute integration test scenarios
+- **qe-performance-tester**: Performance and load testing
+- **qe-security-scanner**: Security vulnerability scanning
+
+Use \`aqe agent list\` to see all available agents.
+`;
+    // Minimal skills.md
+    const skillsContent = `# Agentic QE Fleet - Skills Reference
+
+## Available Skills
+
+For the complete list of skills and their usage, please visit:
+https://github.com/proffesor-for-testing/agentic-qe/blob/main/docs/reference/skills.md
+
+## Quick Reference
+
+- **agentic-quality-engineering**: Core QE principles with AI agents
+- **tdd-london-chicago**: Test-driven development approaches
+- **api-testing-patterns**: Comprehensive API testing strategies
+- **brutal-honesty-review**: Unvarnished code review
+- **sherlock-review**: Evidence-based investigation
+
+Use \`aqe skills list\` to see all available skills.
+`;
+    // Minimal usage.md
+    const usageContent = `# Agentic QE Fleet - Usage Guide
+
+## Getting Started
+
+For comprehensive usage examples and workflows, please visit:
+https://github.com/proffesor-for-testing/agentic-qe/blob/main/docs/reference/usage.md
+
+## Quick Commands
+
+\`\`\`bash
+# Initialize the fleet
+aqe init
+
+# Generate tests
+aqe test generate src/
+
+# Analyze coverage
+aqe coverage analyze
+
+# Check learning status
+aqe learn status
+
+# List learned patterns
+aqe patterns list
+\`\`\`
+
+## MCP Server Integration
+
+\`\`\`bash
+# Add MCP server to Claude Code
+claude mcp add agentic-qe npx aqe-mcp
+
+# Verify connection
+claude mcp list
+\`\`\`
+
+For more details, see the online documentation.
+`;
+    // Write minimal docs
+    await fs.writeFile(path.join(docsDir, 'agents.md'), agentsContent, 'utf-8');
+    await fs.writeFile(path.join(docsDir, 'skills.md'), skillsContent, 'utf-8');
+    await fs.writeFile(path.join(docsDir, 'usage.md'), usageContent, 'utf-8');
+    console.log(chalk_1.default.green('  ✓ Minimal documentation created'));
+    console.log(chalk_1.default.gray('    • agents.md - Agent reference stub'));
+    console.log(chalk_1.default.gray('    • skills.md - Skills reference stub'));
+    console.log(chalk_1.default.gray('    • usage.md - Usage guide stub'));
+}
+//# sourceMappingURL=documentation.js.map

package/dist/cli/init/documentation.js.map

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

package/dist/cli/init/fleet-config.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Fleet Configuration Module
+ * Handles creation and persistence of fleet configuration
+ */
+import { FleetConfig } from '../../types';
+/**
+ * Create and write fleet configuration to disk
+ * @param config - Fleet configuration object
+ */
+export declare function createFleetConfig(config: FleetConfig): Promise<void>;
+/**
+ * Validate fleet configuration
+ * @param config - Fleet configuration to validate
+ * @throws Error if configuration is invalid
+ */
+export declare function validateFleetConfig(config: FleetConfig): void;
+/**
+ * Check if fleet configuration already exists
+ * @returns true if fleet.json exists
+ */
+export declare function fleetConfigExists(): Promise<boolean>;
+/**
+ * Load existing fleet configuration
+ * @returns Existing fleet configuration or null if not found
+ */
+export declare function loadFleetConfig(): Promise<FleetConfig | null>;
+/**
+ * Merge new configuration with existing configuration
+ * @param existing - Existing fleet configuration
+ * @param newConfig - New fleet configuration
+ * @returns Merged configuration
+ */
+export declare function mergeFleetConfig(existing: FleetConfig, newConfig: FleetConfig): FleetConfig;
+//# sourceMappingURL=fleet-config.d.ts.map

package/dist/cli/init/fleet-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-config.d.ts","sourceRoot":"","sources":["../../../src/cli/init/fleet-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB1E;AA4JD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAiB7D;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAE1D;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAMnE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,GAAG,WAAW,CAc3F"}