diffninja 0.2.0 → 0.3.0

package/dist/review/types.d.ts

@@ -2,6 +2,7 @@ import type { PullRequestIntent, ReviewEvidence } from "./evidence-types.js";
 import type { ChangeFacts } from "./change-facts.js";
 import type { ReviewQuestion } from "./questions.js";
 import type { HunkHistory, ProjectContext } from "./history.js";
+import type { AgentExplanation, ExplainedFunction } from "./explanation.js";
 export type ReviewStatus = "attention" | "uncertain" | "low" | "passed";
 /**
  * Structural status for a call-flow node. The engine only knows `same`,
@@ -184,6 +185,20 @@ export interface ReviewReport {
      * agent's reading rather than a verified claim.
      */
     agentSummary?: AgentSummary;
+    /**
+     * Every function a reader meets in this report (around the hunks and in the
+     * call flows), each with a stable `<file>#<name>` id, for the reviewing agent
+     * to explain in business terms. Empty for a patch, which resolves none;
+     * absent only on a report assembled by hand, which counts as empty.
+     */
+    functions?: ExplainedFunction[];
+    /**
+     * The reviewing agent's business explanation: a plain purpose for every
+     * listed function, the processes the change touches as steps and decisions,
+     * and the business rules it adds, changes, or removes. Attributed to the
+     * client that wrote it; never generated by diffninja.
+     */
+    agentExplanation?: AgentExplanation;
     /**
      * Local repository context for a git-range review: prior reverts, contributor
      * guidelines, and sibling-file conventions. Absent for a patch.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffninja",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Local, deterministic PR review for coding agents over MCP: call flows, change facts, and a human review workspace",
   "type": "module",
   "exports": {