opencode-swarm 6.68.0 → 6.69.0

package/dist/diff/__tests__/semantic-classifier.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/diff/__tests__/summary-generator.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/diff/semantic-classifier.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Semantic classifier for AST changes.
+ * Classifies AST changes into semantic categories with risk ranking.
+ * @module diff/semantic-classifier
+ */
+import type { ASTDiffResult } from '../diff/ast-diff.js';
+/**
+ * Semantic categories for classified changes.
+ * Describes the nature of the change from a code impact perspective.
+ */
+export type ChangeCategory = 'SIGNATURE_CHANGE' | 'API_CHANGE' | 'GUARD_REMOVED' | 'LOGIC_CHANGE' | 'DELETED_FUNCTION' | 'NEW_FUNCTION' | 'REFACTOR' | 'COSMETIC' | 'UNCLASSIFIED';
+/**
+ * Risk level associated with a classified change.
+ * Indicates the potential impact severity of the change.
+ */
+export type RiskLevel = 'Critical' | 'High' | 'Medium' | 'Low';
+/**
+ * A classified AST change with semantic categorization and risk assessment.
+ */
+export interface ClassifiedChange {
+    /** Semantic category of the change */
+    category: ChangeCategory;
+    /** Risk level indicating potential impact severity */
+    riskLevel: RiskLevel;
+    /** Path to the file containing this change */
+    filePath: string;
+    /** Name of the symbol (function, class, etc.) affected */
+    symbolName: string;
+    /** Type of change operation */
+    changeType: 'added' | 'modified' | 'removed';
+    /** Starting line number of the change */
+    lineStart: number;
+    /** Ending line number of the change */
+    lineEnd: number;
+    /** Human-readable description of what was detected */
+    description: string;
+    /** Original AST change signature detail (if available) */
+    signature?: string;
+}
+/**
+ * Classify an array of AST diff results into semantic categories with risk levels.
+ *
+ * @param astDiffs - Array of ASTDiffResult from the AST differ
+ * @returns Array of ClassifiedChange with semantic categorization
+ *
+ * @example
+ * ```typescript
+ * const diffs = await astDiff(oldCode, newCode);
+ * const classified = classifyChanges(diffs);
+ * for (const change of classified) {
+ *   console.log(`[${change.riskLevel}] ${change.category}: ${change.symbolName}`);
+ * }
+ * ```
+ */
+export declare function classifyChanges(astDiffs: ASTDiffResult[]): ClassifiedChange[];

package/dist/diff/summary-generator.d.ts

@@ -0,0 +1,33 @@
+import type { ChangeCategory, ClassifiedChange, RiskLevel } from './semantic-classifier.js';
+/**
+ * Structured summary of classified semantic diff changes.
+ * Provides multiple views for different review workflows.
+ */
+export interface SemanticDiffSummary {
+    /** Number of files with changes */
+    totalFiles: number;
+    /** Total number of classified changes */
+    totalChanges: number;
+    /** Changes grouped by risk level */
+    byRisk: Record<RiskLevel, ClassifiedChange[]>;
+    /** Changes grouped by category */
+    byCategory: Record<ChangeCategory, ClassifiedChange[]>;
+    /** Quick access to Critical items for gate checks */
+    criticalItems: ClassifiedChange[];
+}
+/**
+ * Generates a structured summary from classified changes.
+ * Provides by-risk and by-category groupings plus critical item quick access.
+ *
+ * @param changes - Array of classified changes to summarize
+ * @returns SemanticDiffSummary with all grouping views
+ */
+export declare function generateSummary(changes: ClassifiedChange[]): SemanticDiffSummary;
+/**
+ * Generates reviewer-ready markdown summary from a SemanticDiffSummary.
+ * Format groups by risk level with file:category annotations.
+ *
+ * @param summary - The structured summary to render as markdown
+ * @returns Markdown-formatted string ready for PR review
+ */
+export declare function generateSummaryMarkdown(summary: SemanticDiffSummary): string;