agentic-qe 1.8.3 → 1.8.4

package/dist/constitution/schema.d.ts

@@ -0,0 +1,409 @@
+/**
+ * Constitution Schema - TypeScript Type Definitions
+ *
+ * Defines the structure for quality evaluation constitutions that govern
+ * agent behavior and quality criteria in the Agentic QE Fleet.
+ *
+ * @module constitution/schema
+ * @version 1.0.0
+ */
+/**
+ * Priority levels for principles and rules
+ */
+export type PriorityLevel = 'critical' | 'high' | 'medium' | 'low';
+/**
+ * Severity levels for rule violations
+ */
+export type SeverityLevel = 'error' | 'warning' | 'info';
+/**
+ * Aggregation methods for metrics
+ */
+export type AggregationType = 'sum' | 'avg' | 'min' | 'max' | 'count' | 'percentile';
+/**
+ * Condition operators for rule evaluation
+ */
+export type ConditionOperator = 'equals' | 'not_equals' | 'greater_than' | 'less_than' | 'greater_than_or_equal' | 'less_than_or_equal' | 'contains' | 'not_contains' | 'matches' | 'in' | 'not_in' | 'exists' | 'not_exists';
+/**
+ * Action types when rules are triggered
+ */
+export type ActionType = 'fail' | 'warn' | 'notify' | 'log' | 'block' | 'require_review' | 'auto_fix' | 'escalate';
+/**
+ * Threshold comparison modes
+ */
+export type ThresholdMode = 'absolute' | 'percentage' | 'relative';
+/**
+ * Constitution status
+ */
+export type ConstitutionStatus = 'active' | 'deprecated' | 'draft' | 'archived';
+/**
+ * Principle definition within a constitution
+ * Represents a core quality principle that guides evaluation
+ */
+export interface Principle {
+    /** Unique identifier for the principle */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Detailed description of the principle */
+    description: string;
+    /** Priority level for this principle */
+    priority: PriorityLevel;
+    /** Category grouping for the principle */
+    category: string;
+    /** Optional tags for filtering and search */
+    tags?: string[];
+    /** Whether this principle is mandatory */
+    mandatory?: boolean;
+    /** Related principle IDs */
+    relatedPrinciples?: string[];
+}
+/**
+ * Condition for rule evaluation
+ */
+export interface RuleCondition {
+    /** The field or metric to evaluate */
+    field: string;
+    /** Comparison operator */
+    operator: ConditionOperator;
+    /** Value to compare against */
+    value: string | number | boolean | string[] | number[];
+    /** Optional unit for the value */
+    unit?: string;
+    /** Nested conditions for complex logic */
+    and?: RuleCondition[];
+    /** Alternative conditions */
+    or?: RuleCondition[];
+}
+/**
+ * Action to take when a rule is triggered
+ */
+export interface RuleAction {
+    /** Type of action to perform */
+    type: ActionType;
+    /** Message to display or log */
+    message: string;
+    /** Additional parameters for the action */
+    params?: Record<string, unknown>;
+    /** Whether to halt further processing */
+    stopProcessing?: boolean;
+    /** Notification targets */
+    notify?: string[];
+}
+/**
+ * Rule definition linking principles to conditions and actions
+ */
+export interface Rule {
+    /** Unique identifier for the rule */
+    id: string;
+    /** Human-readable name */
+    name?: string;
+    /** Reference to the principle this rule enforces */
+    principleId: string;
+    /** Condition that triggers the rule */
+    condition: RuleCondition;
+    /** Action to take when condition is met */
+    action: RuleAction;
+    /** Severity of rule violation */
+    severity: SeverityLevel;
+    /** Whether this rule is enabled */
+    enabled?: boolean;
+    /** Description of what this rule checks */
+    description?: string;
+    /** Remediation guidance when rule is violated */
+    remediation?: string;
+    /** Example of compliant code/configuration */
+    examples?: string[];
+}
+/**
+ * Metric definition for quality measurement
+ */
+export interface MetricDefinition {
+    /** Unique identifier for the metric */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of what this metric measures */
+    description?: string;
+    /** Unit of measurement */
+    unit: string;
+    /** How to aggregate multiple values */
+    aggregation: AggregationType;
+    /** Target value to achieve */
+    targetValue?: number;
+    /** Value that triggers a warning */
+    warningThreshold?: number;
+    /** Value that triggers a critical alert */
+    criticalThreshold?: number;
+    /** Data type of the metric value */
+    dataType?: 'number' | 'percentage' | 'duration' | 'count' | 'ratio';
+    /** Whether higher values are better */
+    higherIsBetter?: boolean;
+    /** Formula for computed metrics */
+    formula?: string;
+    /** Dependencies on other metrics */
+    dependencies?: string[];
+    /** Percentile for percentile-based metrics */
+    percentile?: number;
+}
+/**
+ * Threshold definition for quality gates
+ */
+export interface Threshold {
+    /** Unique identifier for the threshold */
+    id: string;
+    /** Reference to the metric this threshold applies to */
+    metricId: string;
+    /** Human-readable name */
+    name?: string;
+    /** Comparison mode */
+    mode: ThresholdMode;
+    /** Warning level value */
+    warning: number;
+    /** Critical level value */
+    critical: number;
+    /** Target value to aim for */
+    target?: number;
+    /** Whether to block on threshold violation */
+    blocking?: boolean;
+    /** Time period for the threshold evaluation */
+    period?: string;
+    /** Applicable environments */
+    environments?: string[];
+}
+/**
+ * Metadata about the constitution
+ */
+export interface ConstitutionMetadata {
+    /** When the constitution was created */
+    createdAt: string;
+    /** When the constitution was last updated */
+    updatedAt: string;
+    /** Who created or maintains the constitution */
+    author: string;
+    /** Applicable agent types */
+    applicableTo: string[];
+    /** Parent constitution to inherit from */
+    inheritsFrom?: string;
+    /** Current status of the constitution */
+    status: ConstitutionStatus;
+    /** Optional expiration date */
+    expiresAt?: string;
+    /** Changelog entries */
+    changelog?: ChangelogEntry[];
+    /** Custom properties */
+    customProperties?: Record<string, unknown>;
+}
+/**
+ * Changelog entry for constitution version history
+ */
+export interface ChangelogEntry {
+    /** Version number */
+    version: string;
+    /** Date of change */
+    date: string;
+    /** Description of changes */
+    description: string;
+    /** Who made the change */
+    author?: string;
+}
+/**
+ * Complete constitution definition
+ */
+export interface Constitution {
+    /** Unique identifier for the constitution */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Semantic version string */
+    version: string;
+    /** Description of the constitution's purpose */
+    description: string;
+    /** Core principles */
+    principles: Principle[];
+    /** Evaluation rules */
+    rules: Rule[];
+    /** Metric definitions */
+    metrics: MetricDefinition[];
+    /** Quality thresholds */
+    thresholds: Threshold[];
+    /** Constitution metadata */
+    metadata: ConstitutionMetadata;
+}
+/**
+ * Result of constitution validation
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** List of validation errors */
+    errors: ValidationError[];
+    /** List of validation warnings */
+    warnings: ValidationWarning[];
+}
+/**
+ * Validation error details
+ */
+export interface ValidationError {
+    /** JSON path to the error location */
+    path: string;
+    /** Error message */
+    message: string;
+    /** Error code */
+    code: string;
+    /** Expected value or type */
+    expected?: string;
+    /** Actual value received */
+    actual?: string;
+}
+/**
+ * Validation warning details
+ */
+export interface ValidationWarning {
+    /** JSON path to the warning location */
+    path: string;
+    /** Warning message */
+    message: string;
+    /** Warning code */
+    code: string;
+    /** Suggested improvement */
+    suggestion?: string;
+}
+/**
+ * Options for loading constitutions
+ */
+export interface LoadOptions {
+    /** Whether to validate after loading */
+    validate?: boolean;
+    /** Whether to resolve inheritance */
+    resolveInheritance?: boolean;
+    /** Custom schema path */
+    schemaPath?: string;
+    /** Strict mode for validation */
+    strict?: boolean;
+}
+/**
+ * Options for merging constitutions
+ */
+export interface MergeOptions {
+    /** Strategy for array merging */
+    arrayStrategy?: 'replace' | 'concat' | 'merge';
+    /** Whether to preserve base metadata */
+    preserveMetadata?: boolean;
+    /** Deep merge objects */
+    deepMerge?: boolean;
+}
+/**
+ * Agent type to constitution mapping
+ */
+export interface AgentConstitutionMapping {
+    /** Agent type identifier */
+    agentType: string;
+    /** Primary constitution ID */
+    constitutionId: string;
+    /** Additional constitution IDs to apply */
+    additionalConstitutions?: string[];
+    /** Override settings */
+    overrides?: Partial<Constitution>;
+}
+/**
+ * Constitution evaluation context
+ */
+export interface EvaluationContext {
+    /** Agent performing the evaluation */
+    agentId: string;
+    /** Agent type */
+    agentType: string;
+    /** Target being evaluated */
+    target: string;
+    /** Environment context */
+    environment: string;
+    /** Additional context data */
+    data: Record<string, unknown>;
+    /** Timestamp of evaluation */
+    timestamp: string;
+}
+/**
+ * Result of constitution evaluation
+ */
+export interface EvaluationResult {
+    /** Overall pass/fail status */
+    passed: boolean;
+    /** Constitution that was evaluated */
+    constitutionId: string;
+    /** Individual rule results */
+    ruleResults: RuleEvaluationResult[];
+    /** Metric values collected */
+    metricValues: MetricValue[];
+    /** Threshold violations */
+    thresholdViolations: ThresholdViolation[];
+    /** Overall score (0-100) */
+    score: number;
+    /** Evaluation context */
+    context: EvaluationContext;
+    /** Duration of evaluation in ms */
+    duration: number;
+}
+/**
+ * Result of individual rule evaluation
+ */
+export interface RuleEvaluationResult {
+    /** Rule ID */
+    ruleId: string;
+    /** Whether rule passed */
+    passed: boolean;
+    /** Actual value that was evaluated */
+    actualValue: unknown;
+    /** Message from the rule */
+    message?: string;
+    /** Action that was triggered */
+    actionTaken?: ActionType;
+}
+/**
+ * Collected metric value
+ */
+export interface MetricValue {
+    /** Metric ID */
+    metricId: string;
+    /** Collected value */
+    value: number;
+    /** Unit of measurement */
+    unit: string;
+    /** Timestamp of collection */
+    timestamp: string;
+    /** Additional context */
+    context?: Record<string, unknown>;
+}
+/**
+ * Threshold violation details
+ */
+export interface ThresholdViolation {
+    /** Threshold ID */
+    thresholdId: string;
+    /** Metric ID */
+    metricId: string;
+    /** Actual value */
+    actualValue: number;
+    /** Threshold value that was violated */
+    thresholdValue: number;
+    /** Severity level */
+    severity: 'warning' | 'critical';
+    /** Whether this is blocking */
+    blocking: boolean;
+}
+/**
+ * Type guard to check if an object is a valid Constitution
+ */
+export declare function isConstitution(obj: unknown): obj is Constitution;
+/**
+ * Type guard to check if an object is a valid Principle
+ */
+export declare function isPrinciple(obj: unknown): obj is Principle;
+/**
+ * Type guard to check if an object is a valid Rule
+ */
+export declare function isRule(obj: unknown): obj is Rule;
+/**
+ * Type guard to check if an object is a valid MetricDefinition
+ */
+export declare function isMetricDefinition(obj: unknown): obj is MetricDefinition;
+//# sourceMappingURL=schema.d.ts.map

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

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

package/dist/constitution/schema.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Constitution Schema - TypeScript Type Definitions
+ *
+ * Defines the structure for quality evaluation constitutions that govern
+ * agent behavior and quality criteria in the Agentic QE Fleet.
+ *
+ * @module constitution/schema
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isConstitution = isConstitution;
+exports.isPrinciple = isPrinciple;
+exports.isRule = isRule;
+exports.isMetricDefinition = isMetricDefinition;
+/**
+ * Type guard to check if an object is a valid Constitution
+ */
+function isConstitution(obj) {
+    if (!obj || typeof obj !== 'object')
+        return false;
+    const c = obj;
+    return (typeof c.id === 'string' &&
+        typeof c.name === 'string' &&
+        typeof c.version === 'string' &&
+        typeof c.description === 'string' &&
+        Array.isArray(c.principles) &&
+        Array.isArray(c.rules) &&
+        Array.isArray(c.metrics) &&
+        Array.isArray(c.thresholds) &&
+        c.metadata !== undefined);
+}
+/**
+ * Type guard to check if an object is a valid Principle
+ */
+function isPrinciple(obj) {
+    if (!obj || typeof obj !== 'object')
+        return false;
+    const p = obj;
+    return (typeof p.id === 'string' &&
+        typeof p.name === 'string' &&
+        typeof p.description === 'string' &&
+        ['critical', 'high', 'medium', 'low'].includes(p.priority) &&
+        typeof p.category === 'string');
+}
+/**
+ * Type guard to check if an object is a valid Rule
+ */
+function isRule(obj) {
+    if (!obj || typeof obj !== 'object')
+        return false;
+    const r = obj;
+    return (typeof r.id === 'string' &&
+        typeof r.principleId === 'string' &&
+        r.condition !== undefined &&
+        r.action !== undefined &&
+        ['error', 'warning', 'info'].includes(r.severity));
+}
+/**
+ * Type guard to check if an object is a valid MetricDefinition
+ */
+function isMetricDefinition(obj) {
+    if (!obj || typeof obj !== 'object')
+        return false;
+    const m = obj;
+    return (typeof m.id === 'string' &&
+        typeof m.name === 'string' &&
+        typeof m.unit === 'string' &&
+        ['sum', 'avg', 'min', 'max', 'count', 'percentile'].includes(m.aggregation));
+}
+//# sourceMappingURL=schema.js.map

package/dist/constitution/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/constitution/schema.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAobH,wCAcC;AAKD,kCAUC;AAKD,wBAUC;AAKD,gDASC;AA7DD;;GAEG;AACH,SAAgB,cAAc,CAAC,GAAY;IACzC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,CAAC,GAAG,GAA4B,CAAC;IACvC,OAAO,CACL,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;QACxB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAC7B,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QACjC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;QAC3B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QACtB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACxB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;QAC3B,CAAC,CAAC,QAAQ,KAAK,SAAS,CACzB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,GAAY;IACtC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,CAAC,GAAG,GAAyB,CAAC;IACpC,OAAO,CACL,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;QACxB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QACjC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAkB,CAAC;QACpE,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAAC,GAAY;IACjC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,CAAC,GAAG,GAAoB,CAAC;IAC/B,OAAO,CACL,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;QACxB,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QACjC,CAAC,CAAC,SAAS,KAAK,SAAS;QACzB,CAAC,CAAC,MAAM,KAAK,SAAS;QACtB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAkB,CAAC,CAC5D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,GAAY;IAC7C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,CAAC,GAAG,GAAgC,CAAC;IAC3C,OAAO,CACL,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;QACxB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAqB,CAAC,CACtF,CAAC;AACJ,CAAC"}

package/dist/core/memory/MemoryManagerFactory.d.ts

@@ -0,0 +1,77 @@
+/**
+ * MemoryManagerFactory - Singleton Pattern for Shared Memory Management
+ *
+ * Resolves the persistence issue where multiple SwarmMemoryManager instances
+ * cause data fragmentation - data written to one instance is not visible to others.
+ *
+ * Key Issues Fixed:
+ * 1. Multiple isolated instances (MCP server, AgentRegistry, Phase2Tools each created their own)
+ * 2. sql.js persistence model requires explicit save()/close() calls
+ * 3. Ensures all components share the same database connection
+ *
+ * @module MemoryManagerFactory
+ * @version 1.0.0
+ */
+import { SwarmMemoryManager } from './SwarmMemoryManager.js';
+/**
+ * Resolve database path - ensures we use an absolute path in user's project
+ *
+ * Database should be in the USER'S project directory (process.cwd()),
+ * NOT in the package installation directory.
+ */
+export declare function resolveDbPath(inputPath?: string): string;
+/**
+ * Ensure the database directory exists
+ */
+export declare function ensureDbDirectoryExists(dbPath: string): void;
+/**
+ * Get the shared SwarmMemoryManager singleton
+ *
+ * Ensures all components use the same database connection for consistent
+ * persistence across MCP server, AgentRegistry, handlers, and agents.
+ *
+ * @param dbPath Optional database path (relative paths resolved from cwd)
+ * @returns Shared SwarmMemoryManager instance
+ */
+export declare function getSharedMemoryManager(dbPath?: string): SwarmMemoryManager;
+/**
+ * Initialize the shared memory manager asynchronously
+ *
+ * This method ensures only ONE initialization happens even if called multiple times.
+ * All callers will receive the same initialized instance.
+ *
+ * @param dbPath Optional database path
+ * @returns Promise that resolves to the initialized SwarmMemoryManager
+ */
+export declare function initializeSharedMemoryManager(dbPath?: string): Promise<SwarmMemoryManager>;
+/**
+ * Check if shared memory manager is initialized
+ */
+export declare function hasSharedMemoryManager(): boolean;
+/**
+ * Get the path of the current shared memory manager
+ */
+export declare function getSharedMemoryManagerPath(): string | null;
+/**
+ * Reset the shared memory manager singleton
+ *
+ * Use with caution - this should only be called during testing or
+ * when explicitly changing database paths.
+ */
+export declare function resetSharedMemoryManager(): Promise<void>;
+/**
+ * Get database path info for debugging
+ */
+export declare function getDbPathInfo(): {
+    defaultPath: string;
+    currentSharedPath: string | null;
+    processCwd: string;
+    envPath: string | undefined;
+};
+/**
+ * Setup process exit handlers to ensure database is properly closed
+ *
+ * This is critical for sql.js which only persists to disk on close()
+ */
+export declare function setupExitHandlers(): void;
+//# sourceMappingURL=MemoryManagerFactory.d.ts.map

package/dist/core/memory/MemoryManagerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryManagerFactory.d.ts","sourceRoot":"","sources":["../../../src/core/memory/MemoryManagerFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAO7D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BxD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAW5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CA0B1E;AAED;;;;;;;;GAQG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8BhG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,GAAG,IAAI,CAE1D;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAY9D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAOA;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CA2CxC"}