agentic-qe 1.8.3 → 1.9.0

package/dist/constitution/index.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * Constitution Module - Main Entry Point
+ *
+ * Provides the complete constitution framework for the Agentic QE Fleet,
+ * enabling quality evaluation criteria definition and validation.
+ *
+ * @module constitution
+ * @version 1.0.0
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   loadConstitution,
+ *   validateConstitution,
+ *   getConstitutionForAgent,
+ *   Constitution,
+ *   Principle,
+ *   Rule
+ * } from './constitution';
+ *
+ * // Load a specific constitution
+ * const constitution = loadConstitution('./path/to/constitution.json');
+ *
+ * // Get constitution for an agent type
+ * const agentConstitution = getConstitutionForAgent('test-generator');
+ *
+ * // Validate a constitution object
+ * const result = validateConstitution(myConstitution);
+ * if (!result.valid) {
+ *   console.error('Validation errors:', result.errors);
+ * }
+ * ```
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_CONSTITUTION_MAP = exports.DEFAULT_CONSTITUTIONS = exports.SCHEMA_VERSION = exports.CONSTITUTION_VERSION = exports.listAvailableConstitutions = exports.getBaseConstitutionsPath = exports.getConstitutionForAgent = exports.validateConstitution = exports.mergeConstitutions = exports.loadConstitutions = exports.loadConstitution = exports.getDefaultLoader = exports.ConstitutionLoader = exports.isMetricDefinition = exports.isRule = exports.isPrinciple = exports.isConstitution = void 0;
+exports.loadDefaultConstitution = loadDefaultConstitution;
+exports.loadTestGenerationConstitution = loadTestGenerationConstitution;
+exports.loadCodeReviewConstitution = loadCodeReviewConstitution;
+exports.loadPerformanceConstitution = loadPerformanceConstitution;
+exports.loadAllBaseConstitutions = loadAllBaseConstitutions;
+exports.getRecommendedConstitutionId = getRecommendedConstitutionId;
+exports.getConstitutionModuleInfo = getConstitutionModuleInfo;
+// Export type guards
+var schema_1 = require("./schema");
+Object.defineProperty(exports, "isConstitution", { enumerable: true, get: function () { return schema_1.isConstitution; } });
+Object.defineProperty(exports, "isPrinciple", { enumerable: true, get: function () { return schema_1.isPrinciple; } });
+Object.defineProperty(exports, "isRule", { enumerable: true, get: function () { return schema_1.isRule; } });
+Object.defineProperty(exports, "isMetricDefinition", { enumerable: true, get: function () { return schema_1.isMetricDefinition; } });
+// Export loader class and functions
+var loader_1 = require("./loader");
+Object.defineProperty(exports, "ConstitutionLoader", { enumerable: true, get: function () { return loader_1.ConstitutionLoader; } });
+Object.defineProperty(exports, "getDefaultLoader", { enumerable: true, get: function () { return loader_1.getDefaultLoader; } });
+Object.defineProperty(exports, "loadConstitution", { enumerable: true, get: function () { return loader_1.loadConstitution; } });
+Object.defineProperty(exports, "loadConstitutions", { enumerable: true, get: function () { return loader_1.loadConstitutions; } });
+Object.defineProperty(exports, "mergeConstitutions", { enumerable: true, get: function () { return loader_1.mergeConstitutions; } });
+Object.defineProperty(exports, "validateConstitution", { enumerable: true, get: function () { return loader_1.validateConstitution; } });
+Object.defineProperty(exports, "getConstitutionForAgent", { enumerable: true, get: function () { return loader_1.getConstitutionForAgent; } });
+Object.defineProperty(exports, "getBaseConstitutionsPath", { enumerable: true, get: function () { return loader_1.getBaseConstitutionsPath; } });
+Object.defineProperty(exports, "listAvailableConstitutions", { enumerable: true, get: function () { return loader_1.listAvailableConstitutions; } });
+// Re-export for convenience
+const loader_2 = require("./loader");
+const path = __importStar(require("path"));
+/**
+ * Load the default constitution
+ *
+ * @returns The default base constitution
+ */
+function loadDefaultConstitution() {
+    const loader = new loader_2.ConstitutionLoader();
+    const basePath = (0, loader_2.getBaseConstitutionsPath)();
+    return loader.loadConstitution(path.join(basePath, 'default.constitution.json'));
+}
+/**
+ * Load the test generation constitution
+ *
+ * @returns The test generation constitution (merged with default)
+ */
+function loadTestGenerationConstitution() {
+    const loader = new loader_2.ConstitutionLoader();
+    const basePath = (0, loader_2.getBaseConstitutionsPath)();
+    return loader.loadConstitution(path.join(basePath, 'test-generation.constitution.json'), { resolveInheritance: true });
+}
+/**
+ * Load the code review constitution
+ *
+ * @returns The code review constitution (merged with default)
+ */
+function loadCodeReviewConstitution() {
+    const loader = new loader_2.ConstitutionLoader();
+    const basePath = (0, loader_2.getBaseConstitutionsPath)();
+    return loader.loadConstitution(path.join(basePath, 'code-review.constitution.json'), { resolveInheritance: true });
+}
+/**
+ * Load the performance testing constitution
+ *
+ * @returns The performance testing constitution (merged with default)
+ */
+function loadPerformanceConstitution() {
+    const loader = new loader_2.ConstitutionLoader();
+    const basePath = (0, loader_2.getBaseConstitutionsPath)();
+    return loader.loadConstitution(path.join(basePath, 'performance.constitution.json'), { resolveInheritance: true });
+}
+/**
+ * Get all available base constitutions
+ *
+ * @returns Map of constitution ID to Constitution object
+ */
+function loadAllBaseConstitutions() {
+    const loader = new loader_2.ConstitutionLoader();
+    const basePath = (0, loader_2.getBaseConstitutionsPath)();
+    return loader.loadConstitutions(basePath, { resolveInheritance: true });
+}
+/**
+ * Constitution module version
+ */
+exports.CONSTITUTION_VERSION = '1.0.0';
+/**
+ * Supported constitution schema version
+ */
+exports.SCHEMA_VERSION = 'draft-07';
+/**
+ * Default constitution IDs
+ */
+exports.DEFAULT_CONSTITUTIONS = {
+    DEFAULT: 'default',
+    TEST_GENERATION: 'test-generation',
+    CODE_REVIEW: 'code-review',
+    PERFORMANCE: 'performance'
+};
+/**
+ * Agent type to default constitution mapping
+ */
+exports.AGENT_CONSTITUTION_MAP = {
+    'test-generator': 'test-generation',
+    'qe-test-generator': 'test-generation',
+    'code-reviewer': 'code-review',
+    'qe-code-reviewer': 'code-review',
+    'quality-analyzer': 'code-review',
+    'performance-tester': 'performance',
+    'qe-performance-tester': 'performance',
+    // Other agents fall back to default
+    'coverage-analyzer': 'default',
+    'security-scanner': 'default',
+    'quality-gate': 'default',
+    'flaky-test-hunter': 'default',
+    'requirements-validator': 'default',
+    'production-intelligence': 'default',
+    'deployment-readiness': 'default',
+    'regression-risk-analyzer': 'default',
+    'test-data-architect': 'default',
+    'api-contract-validator': 'default'
+};
+/**
+ * Get the recommended constitution ID for an agent type
+ *
+ * @param agentType - The agent type
+ * @returns The recommended constitution ID
+ */
+function getRecommendedConstitutionId(agentType) {
+    return exports.AGENT_CONSTITUTION_MAP[agentType] || 'default';
+}
+/**
+ * Summary information about the constitution module
+ */
+function getConstitutionModuleInfo() {
+    return {
+        version: exports.CONSTITUTION_VERSION,
+        schemaVersion: exports.SCHEMA_VERSION,
+        availableConstitutions: (0, loader_2.listAvailableConstitutions)(),
+        basePath: (0, loader_2.getBaseConstitutionsPath)()
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/constitution/index.js.map

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

package/dist/constitution/loader.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Constitution Loader - Load, validate, and manage constitutions
+ *
+ * Provides functionality to load constitution files, validate against schema,
+ * and support inheritance/composition patterns.
+ *
+ * @module constitution/loader
+ * @version 1.0.0
+ */
+import { Constitution, ValidationResult, LoadOptions, MergeOptions } from './schema';
+/**
+ * Constitution loader class for managing quality constitutions
+ */
+export declare class ConstitutionLoader {
+    private ajv;
+    private validateFn;
+    private constitutionCache;
+    private schemaLoaded;
+    constructor();
+    /**
+     * Load and compile the JSON schema for validation
+     */
+    private loadSchema;
+    /**
+     * Load a single constitution from a file path
+     *
+     * @param filePath - Path to the constitution JSON file
+     * @param options - Loading options
+     * @returns Loaded and optionally validated constitution
+     */
+    loadConstitution(filePath: string, options?: LoadOptions): Constitution;
+    /**
+     * Load all constitutions from a directory
+     *
+     * @param directory - Directory containing constitution files
+     * @param options - Loading options
+     * @returns Map of constitution ID to Constitution object
+     */
+    loadConstitutions(directory: string, options?: LoadOptions): Map<string, Constitution>;
+    /**
+     * Merge two constitutions with inheritance support
+     *
+     * @param base - Base constitution to inherit from
+     * @param override - Constitution with overrides
+     * @param options - Merge options
+     * @returns Merged constitution
+     */
+    mergeConstitutions(base: Constitution, override: Constitution, options?: MergeOptions): Constitution;
+    /**
+     * Merge arrays based on strategy
+     */
+    private mergeArrays;
+    /**
+     * Validate a constitution against the JSON schema
+     *
+     * @param constitution - Constitution object to validate
+     * @returns Validation result with errors and warnings
+     */
+    validateConstitution(constitution: unknown): ValidationResult;
+    /**
+     * Convert Ajv error to ValidationError
+     */
+    private ajvErrorToValidationError;
+    /**
+     * Get constitution for a specific agent type
+     *
+     * @param agentType - Type of agent
+     * @param constitutionsDir - Directory containing constitutions
+     * @returns Constitution applicable to the agent
+     */
+    getConstitutionForAgent(agentType: string, constitutionsDir?: string): Constitution;
+    /**
+     * Clear the constitution cache
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    };
+}
+/**
+ * Get the default constitution loader instance
+ */
+export declare function getDefaultLoader(): ConstitutionLoader;
+/**
+ * Load a single constitution from file
+ * Convenience function using default loader
+ *
+ * @param filePath - Path to constitution file
+ * @param options - Loading options
+ * @returns Loaded constitution
+ */
+export declare function loadConstitution(filePath: string, options?: LoadOptions): Constitution;
+/**
+ * Load all constitutions from directory
+ * Convenience function using default loader
+ *
+ * @param directory - Directory containing constitutions
+ * @param options - Loading options
+ * @returns Map of constitution ID to Constitution
+ */
+export declare function loadConstitutions(directory: string, options?: LoadOptions): Map<string, Constitution>;
+/**
+ * Merge two constitutions
+ * Convenience function using default loader
+ *
+ * @param base - Base constitution
+ * @param override - Override constitution
+ * @param options - Merge options
+ * @returns Merged constitution
+ */
+export declare function mergeConstitutions(base: Constitution, override: Constitution, options?: MergeOptions): Constitution;
+/**
+ * Validate a constitution
+ * Convenience function using default loader
+ *
+ * @param constitution - Constitution to validate
+ * @returns Validation result
+ */
+export declare function validateConstitution(constitution: unknown): ValidationResult;
+/**
+ * Get constitution for agent type
+ * Convenience function using default loader
+ *
+ * @param agentType - Agent type
+ * @param constitutionsDir - Optional directory
+ * @returns Constitution for agent
+ */
+export declare function getConstitutionForAgent(agentType: string, constitutionsDir?: string): Constitution;
+/**
+ * Get the base constitutions directory path
+ */
+export declare function getBaseConstitutionsPath(): string;
+/**
+ * List available constitution files in the base directory
+ */
+export declare function listAvailableConstitutions(): string[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/constitution/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/constitution/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAGhB,WAAW,EACX,YAAY,EAKb,MAAM,UAAU,CAAC;AAKlB;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,iBAAiB,CAAwC;IACjE,OAAO,CAAC,YAAY,CAAkB;;IAWtC;;OAEG;IACH,OAAO,CAAC,UAAU;IAmBlB;;;;;;OAMG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,YAAY;IAwD3E;;;;;;OAMG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IA+B1F;;;;;;;OAOG;IACH,kBAAkB,CAChB,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,YAAiB,GACzB,YAAY;IAiDf;;OAEG;IACH,OAAO,CAAC,WAAW;IAuCnB;;;;;OAKG;IACH,oBAAoB,CAAC,YAAY,EAAE,OAAO,GAAG,gBAAgB;IAuG7D;;OAEG;IACH,OAAO,CAAC,yBAAyB;IASjC;;;;;;OAMG;IACH,uBAAuB,CACrB,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,MAAM,GACxB,YAAY;IA4Cf;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;CAMlD;AAKD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,CAKrD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,YAAY,CAEd;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAE3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,YAAY,GACrB,YAAY,CAEd;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,OAAO,GAAG,gBAAgB,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,MAAM,GACxB,YAAY,CAEd;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAYjD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CASrD"}