@taodigital/agents 0.0.0-stage → 1.2.0

package/dist/requirements-agent.d.ts

@@ -0,0 +1,59 @@
+/**
+ * ZeTa-AI Requirements Agent
+ *
+ * Converts product specs (PRDs, user stories, acceptance criteria, release notes)
+ * into structured, testable Requirement objects stored in the Requirements store.
+ *
+ * Each Requirement has:
+ *   - reqId: REQ-{AREA}-{NNN} — stable, sequential per area
+ *   - acceptanceCriteria[]: Given/When/Then deterministic statements
+ *   - priority: CRITICAL | HIGH | MEDIUM | LOW (risk-derived)
+ *   - status: pending (until matchCasesToRequirements() runs)
+ *
+ * Also provides:
+ *   - matchCasesToRequirements(): fuzzy matching of test cases → reqIds
+ *   - generateCoverageGapReport(): Prompt 2 pre-plan gap analysis
+ */
+export interface RequirementInput {
+    reqId: string;
+    title: string;
+    actor?: string;
+    type: 'functional' | 'nonfunctional' | 'security' | 'accessibility' | 'data' | 'performance';
+    priority: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+    acceptanceCriteria: string[];
+    businessRules: string[];
+    relatedScreenHints: string[];
+    sourceSection?: string | null;
+    derived?: boolean;
+}
+export interface RequirementCoverageMatch {
+    covered: Array<{
+        reqId: string;
+        caseRefs: string[];
+    }>;
+    untested: string[];
+    unbuilt: string[];
+    byPriority: Record<string, {
+        covered: number;
+        total: number;
+    }>;
+    topGaps: string[];
+}
+export declare function extractRequirements(opts: {
+    tenantId: string;
+    projectId: string;
+    sourceText: string;
+}): Promise<{
+    requirements: RequirementInput[];
+    saved: number;
+    dropped?: number;
+}>;
+export declare function generateCoverageGapReport(opts: {
+    tenantId: string;
+    projectId: string;
+}): Promise<RequirementCoverageMatch>;
+/**
+ * Build a compact requirements block to inject into test generation prompts.
+ * Used by test-case-agent.ts to populate traceTo with real reqIds.
+ */
+export declare function buildRequirementsBlock(requirements: any[]): string;