agentic-qe 3.3.3 → 3.3.4

package/v3/dist/domains/requirements-validation/qcsd-ideation-plugin.d.ts

@@ -0,0 +1,245 @@
+/**
+ * Agentic QE v3 - QCSD Ideation Swarm Plugin
+ *
+ * Implements the QCSD (Quality Conscious Software Delivery) Ideation phase
+ * using James Bach's HTSM v6.3 framework for shift-left quality engineering.
+ *
+ * This plugin registers workflow actions that enable the qcsd-ideation-swarm
+ * workflow to orchestrate multi-agent quality assessment during PI/Sprint Planning.
+ *
+ * HTSM Quality Categories:
+ * 1. Capability - Core functionality
+ * 2. Reliability - Consistency under stress
+ * 3. Usability - User experience
+ * 4. Charisma - Aesthetics and appeal
+ * 5. Security - Protection mechanisms
+ * 6. Scalability - Growth handling
+ * 7. Compatibility - Integration factors
+ * 8. Performance - Speed and efficiency
+ * 9. Installability - Deployment ease
+ * 10. Supportability - Maintenance factors
+ */
+import { MemoryBackend } from '../../kernel/interfaces.js';
+import type { WorkflowOrchestrator } from '../../../src/coordination/workflow-orchestrator.js';
+/**
+ * HTSM v6.3 Quality Category
+ */
+export interface QualityCriterion {
+    id: string;
+    category: HTSMCategory;
+    name: string;
+    description: string;
+    weight: number;
+    testabilityScore: number;
+    risks: string[];
+    testIdeas: string[];
+}
+/**
+ * HTSM Categories
+ */
+export type HTSMCategory = 'capability' | 'reliability' | 'usability' | 'charisma' | 'security' | 'scalability' | 'compatibility' | 'performance' | 'installability' | 'supportability';
+/**
+ * Testability Assessment using 10 Principles
+ */
+export interface TestabilityAssessment {
+    id: string;
+    targetId: string;
+    overallScore: number;
+    principles: {
+        controllability: number;
+        observability: number;
+        isolability: number;
+        separationOfConcerns: number;
+        simplicity: number;
+        stability: number;
+        informationCapture: number;
+        automationSupport: number;
+        selfDocumenting: number;
+        independence: number;
+    };
+    blockers: string[];
+    recommendations: string[];
+}
+/**
+ * Risk Assessment
+ */
+export interface RiskAssessment {
+    id: string;
+    targetId: string;
+    overallRisk: 'low' | 'medium' | 'high' | 'critical';
+    riskScore: number;
+    factors: RiskFactor[];
+    mitigations: string[];
+}
+export interface RiskFactor {
+    category: string;
+    description: string;
+    likelihood: number;
+    impact: number;
+    score: number;
+}
+/**
+ * Security Threat Model (STRIDE)
+ */
+export interface ThreatModel {
+    id: string;
+    targetId: string;
+    threats: STRIDEThreat[];
+    overallRisk: 'low' | 'medium' | 'high' | 'critical';
+    recommendations: string[];
+}
+export interface STRIDEThreat {
+    category: 'spoofing' | 'tampering' | 'repudiation' | 'informationDisclosure' | 'denial' | 'elevation';
+    name: string;
+    description: string;
+    likelihood: number;
+    impact: number;
+    mitigations: string[];
+}
+/**
+ * Ideation Report (aggregate output)
+ */
+export interface IdeationReport {
+    id: string;
+    timestamp: string;
+    targetId: string;
+    targetType: 'epic' | 'feature' | 'story' | 'requirement';
+    qualityCriteria: QualityCriterion[];
+    qualityScore: number;
+    testability: TestabilityAssessment;
+    risk: RiskAssessment;
+    threatModel?: ThreatModel;
+    insights: {
+        strengths: string[];
+        weaknesses: string[];
+        opportunities: string[];
+        threats: string[];
+    };
+    recommendations: {
+        priority: 'critical' | 'high' | 'medium' | 'low';
+        category: string;
+        description: string;
+        effort: 'low' | 'medium' | 'high';
+    }[];
+    testStrategy: {
+        approach: string;
+        coverage: string[];
+        riskAreas: string[];
+        estimatedEffort: string;
+    };
+    readyForDevelopment: boolean;
+    blockers: string[];
+}
+/**
+ * Website extraction result for live URL analysis
+ */
+export interface WebsiteExtractionResult {
+    url: string;
+    isWebsite: boolean;
+    extractedDescription: string;
+    extractedFeatures: string[];
+    extractedAcceptanceCriteria: string[];
+    detectedFlags: {
+        hasUI: boolean;
+        hasSecurity: boolean;
+        hasUX: boolean;
+    };
+    metadata?: {
+        title: string;
+        pageCount: number;
+        extractedAt: string;
+    };
+}
+export declare class QCSDIdeationPlugin {
+    private initialized;
+    private memory;
+    constructor(memory: MemoryBackend);
+    initialize(): Promise<void>;
+    dispose(): Promise<void>;
+    /**
+     * Register workflow actions with the orchestrator
+     */
+    registerWorkflowActions(orchestrator: WorkflowOrchestrator): void;
+    /**
+     * Extract content from a live website URL for QCSD analysis
+     * Converts website features into epic-like content for quality assessment
+     */
+    private extractWebsiteContent;
+    /**
+     * Fetch website content via HTTP
+     */
+    private fetchWebsiteContent;
+    /**
+     * Parse HTML content to extract website features
+     */
+    private parseWebsiteContent;
+    /**
+     * Build epic-like description from extracted content
+     */
+    private buildEpicDescription;
+    /**
+     * Generate acceptance criteria from detected features
+     */
+    private generateAcceptanceCriteria;
+    /**
+     * Detect content flags for conditional agent spawning
+     */
+    private detectContentFlags;
+    /**
+     * Analyze quality criteria using HTSM v6.3 framework
+     */
+    private analyzeQualityCriteria;
+    /**
+     * Assess testability using 10 principles
+     */
+    private assessTestability;
+    /**
+     * Assess risks
+     */
+    private assessRisks;
+    /**
+     * Validate requirements for completeness
+     */
+    private validateRequirements;
+    /**
+     * Model security threats using STRIDE
+     */
+    private modelSecurityThreats;
+    /**
+     * Generate aggregated ideation report
+     */
+    private generateIdeationReport;
+    /**
+     * Store learnings for future pattern matching
+     */
+    private storeIdeationLearnings;
+    private analyzeHTSMCategories;
+    private analyzeCategory;
+    private getCategoryDescription;
+    private generateCategoryRisks;
+    private generateCategoryTestIdeas;
+    private calculateQualityScore;
+    private assessTestabilityPrinciples;
+    private identifyTestabilityIssues;
+    private analyzeRiskFactors;
+    private determineRiskLevel;
+    private generateMitigations;
+    private analyzeSTRIDEThreats;
+    private generateSecurityRecommendations;
+    private generateSWOTInsights;
+    private generateRecommendations;
+    private generateTestStrategy;
+    /**
+     * Audit accessibility for websites with UI components (HAS_UI flag)
+     * Triggered when website extraction detects UI elements
+     */
+    private auditAccessibility;
+    /**
+     * Analyze quality experience for websites with UX concerns (HAS_UX flag)
+     * Triggered when website extraction detects user experience patterns
+     */
+    private analyzeQualityExperience;
+    private identifyBlockers;
+}
+export declare function createQCSDIdeationPlugin(memory: MemoryBackend): QCSDIdeationPlugin;
+//# sourceMappingURL=qcsd-ideation-plugin.d.ts.map

package/v3/dist/domains/requirements-validation/qcsd-ideation-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qcsd-ideation-plugin.d.ts","sourceRoot":"","sources":["../../../src/domains/requirements-validation/qcsd-ideation-plugin.ts"],"names":[],"mappings":"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"}