@ivorycanvas/qamap 0.3.5 → 0.4.0

package/dist/change-intent.d.ts

@@ -0,0 +1,71 @@
+import type { TestPlanChangedFile } from "./test-plan.js";
+export type ChangeIntentConfidence = "low" | "medium" | "high";
+export type ChangeIntentEvidenceKind = "commit" | "diff" | "source";
+export type BehaviorLifecycleStageKind = "trigger" | "condition" | "action" | "state-change" | "side-effect" | "observable-outcome";
+export type IntentQaScenarioKind = "primary" | "failure" | "boundary" | "state-transition";
+export type IntentQaScenarioPriority = "critical" | "recommended";
+export interface ChangeIntentEvidence {
+    kind: ChangeIntentEvidenceKind;
+    value: string;
+    commit?: string;
+    file?: string;
+    symbol?: string;
+}
+export interface ChangeIntentCommit {
+    sha: string;
+    subject: string;
+    body?: string;
+    conventionalType?: string;
+    scope?: string;
+    statement: string;
+}
+export interface BehaviorLifecycleStage {
+    id: string;
+    kind: BehaviorLifecycleStageKind;
+    label: string;
+    confidence: ChangeIntentConfidence;
+    evidence: ChangeIntentEvidence[];
+    files: string[];
+}
+export interface IntentQaScenario {
+    id: string;
+    kind: IntentQaScenarioKind;
+    priority: IntentQaScenarioPriority;
+    title: string;
+    rationale: string;
+    setup: string[];
+    steps: string[];
+    assertions: string[];
+    edgeCases: string[];
+    evidence: ChangeIntentEvidence[];
+}
+export interface ChangeIntent {
+    id: string;
+    title: string;
+    summary: string;
+    confidence: ChangeIntentConfidence;
+    commits: ChangeIntentCommit[];
+    files: string[];
+    keywords: string[];
+    evidence: ChangeIntentEvidence[];
+    lifecycle: BehaviorLifecycleStage[];
+    scenarios: IntentQaScenario[];
+    reviewRequired: boolean;
+}
+export interface ChangeIntentAnalysis {
+    base: string;
+    head: string;
+    source: "commits-and-diff" | "commits" | "diff-only" | "none";
+    commits: ChangeIntentCommit[];
+    intents: ChangeIntent[];
+    diagnostics: string[];
+}
+export interface ChangeIntentAnalysisOptions {
+    base: string;
+    head: string;
+    workspaceRoot?: string;
+    includeWorkingTree?: boolean;
+    changedFiles: TestPlanChangedFile[];
+    addedDiffText?: Record<string, string>;
+}
+export declare function analyzeChangeIntents(rootInput: string, options: ChangeIntentAnalysisOptions): Promise<ChangeIntentAnalysis>;