@jphutchins/code-review 0.1.0-alpha.2 → 0.1.0-alpha.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/README.md +27 -7
  2. package/dist/index.js +1646 -195
  3. package/dist/index.js.map +1 -1
  4. package/package.json +2 -1
  5. package/schema/VERSIONING.md +3 -1
  6. package/schema/findings.schema.json +30 -13
  7. package/schema/v0.2/findings.schema.json +88 -0
  8. package/templates/comment.eta +71 -44
  9. package/templates/inline.eta +28 -5
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jphutchins/code-review",
3
- "version": "0.1.0-alpha.2",
3
+ "version": "0.1.0-alpha.21",
4
4
  "description": "Deterministic commenter for agentic PR review — gather, render, inline, post, adapt, extract, cost, validate, print-schema",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -48,6 +48,7 @@
48
48
  "eslint-config-prettier": "^10.1.8",
49
49
  "prettier": "^3.9.4",
50
50
  "tsup": "^8.3.5",
51
+ "tsx": "^4.23.0",
51
52
  "typescript": "^5.7.3",
52
53
  "typescript-eslint": "^8.62.1",
53
54
  "vitest": "^3.0.4"
package/schema/VERSIONING.md CHANGED
@@ -65,7 +65,9 @@ ignored); a version outside the supported set degrades to a §5.5 sticky notice.
65
65
  | Version | Status | Notes |
66
66
  |---|---|---|
67
67
  | `v0.1.0` | superseded | Initial schema. Matches the proven camas reference implementation. |
68
- | `v0.2.0` | **current** | Adds required `schema_version`; optional `code`/`code_url` finding fields; normative `suggestion` `""`/`null` semantics; abstract vendor-neutral envelope (see SPEC §6.1). |
68
+ | `v0.2.0` | superseded | Adds required `schema_version`; optional `code`/`code_url` finding fields; normative `suggestion` `""`/`null` semantics; abstract vendor-neutral envelope (see SPEC §6.1). |
69
+ | `v0.3.0` | superseded | Adds optional `reasoning` finding field. |
70
+ | `v0.4.0` | **current** | Breaking: renames finding `body` → `description`; makes `reasoning` and `confidence` **required**; adds optional `recommendation` (prose fix); removes the free-text `suggestion` field (a `patch`, now `string \| null`, is the sole mechanical fix, projected into a suggestion by the commenter). The CLI supports only `0.4` — `0.2`/`0.3` documents cannot supply the now-required `reasoning`/`confidence`, so they degrade to a §5.5 unsupported-version notice rather than being upcast. |
69
71
 
70
72
  ### Price-map schema
71
73
 
package/schema/findings.schema.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "$id": "https://raw.githubusercontent.com/JPHutchins/code-review/main/schema/findings.schema.json",
4
4
  "title": "Code Review — findings",
5
- "description": "Structured output of an agentic PR review. The review agent emits this object (e.g. via a coding-agent CLI's structured-output mode, such as Claude Code's `--json-schema`, whose result lands in `.structured_output`); a deterministic commenter renders it into a sticky summary comment and inline PR review comments. Agent- and provider-agnostic: any model driven by a compatible CLI adapter may produce it. Kept free of $ref/$defs so the same file works for both JSON-Schema validators and CLI structured-output enforcement.",
5
+ "description": "Structured output of an agentic PR code review. The review agent emits this object (e.g. via a coding-agent CLI's structured-output mode, such as Claude Code's `--json-schema`, whose result lands in `.structured_output`, or a file).",
6
6
  "type": "object",
7
7
  "additionalProperties": false,
8
8
  "required": ["schema_version", "summary", "verdict", "findings"],
@@ -10,24 +10,33 @@
10
10
  "schema_version": {
11
11
  "type": "string",
12
12
  "pattern": "^(0|[1-9]\\d*)\\.(\\d+)\\.(\\d+)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$",
13
- "description": "Semver version of this findings schema the object conforms to (e.g. \"0.1.0\"). Lets a commenter detect a version mismatch rather than silently dropping fields."
13
+ "description": "Semver version of this findings schema the object conforms to (e.g. \"0.1.0\")."
14
14
  },
15
15
  "summary": {
16
16
  "type": "string",
17
- "description": "Markdown walkthrough of the change and the overall assessment; rendered as the body of the sticky summary comment."
17
+ "description": "1-4 sentence markdown walkthrough of the overall assessment."
18
18
  },
19
19
  "verdict": {
20
20
  "type": "string",
21
21
  "enum": ["approve", "comment", "changes"],
22
- "description": "Overall stance. Advisory only: a conforming commenter posts the GitHub review as COMMENT and never REQUEST_CHANGES, surfacing this value as a badge."
22
+ "description": "Overall stance."
23
23
  },
24
24
  "findings": {
25
25
  "type": "array",
26
- "description": "Zero or more specific findings. Each becomes one inline review comment when its line is inside the diff; otherwise it is demoted into the summary.",
26
+ "description": "Zero or more specific findings.",
27
27
  "items": {
28
28
  "type": "object",
29
29
  "additionalProperties": false,
30
- "required": ["path", "start_line", "end_line", "severity", "title", "body"],
30
+ "required": [
31
+ "path",
32
+ "start_line",
33
+ "end_line",
34
+ "severity",
35
+ "title",
36
+ "description",
37
+ "reasoning",
38
+ "confidence"
39
+ ],
31
40
  "properties": {
32
41
  "path": {
33
42
  "type": "string",
@@ -47,7 +56,7 @@
47
56
  "type": "string",
48
57
  "enum": ["RIGHT", "LEFT"],
49
58
  "default": "RIGHT",
50
- "description": "RIGHT for added/changed lines, LEFT for removed lines; matches the GitHub pulls reviews API."
59
+ "description": "As in a unified-diff view: RIGHT for added/changed lines, LEFT for removed lines."
51
60
  },
52
61
  "severity": {
53
62
  "type": "string",
@@ -67,19 +76,27 @@
67
76
  "type": "string",
68
77
  "description": "One-line summary of the finding."
69
78
  },
70
- "body": {
79
+ "description": {
71
80
  "type": "string",
72
- "description": "Markdown explanation; rendered as the inline comment body."
81
+ "description": "1-3 sentence markdown explanation of what is wrong. Details belong in `reasoning`."
73
82
  },
74
- "suggestion": {
75
- "type": ["string", "null"],
76
- "description": "null = no mechanical fix (render no suggestion block); \"\" (empty string) = delete start_line..end_line (render an empty suggestion block); non-empty = exact replacement text for start_line..end_line (render a GitHub suggestion block). A suggestion spanning more than GitHub's single-block line limit is demoted to the summary."
83
+ "recommendation": {
84
+ "type": "string",
85
+ "description": "1-2 sentence markdown prose describing what to do about the finding — distinct from `patch`, which is a machine-applicable unified diff. Use this when the fix is best explained rather than mechanically applied, or to accompany a `patch` with rationale."
77
86
  },
78
87
  "confidence": {
79
88
  "type": "number",
80
89
  "minimum": 0,
81
90
  "maximum": 1,
82
- "description": "Optional 0..1 confidence; a commenter MAY suppress findings below a configurable threshold to control noise, but MUST NOT suppress a critical-severity finding on confidence alone."
91
+ "description": "0..1 confidence; a commenter MAY suppress findings below a configurable threshold to control noise, but MUST NOT suppress a critical-severity finding on confidence alone."
92
+ },
93
+ "reasoning": {
94
+ "type": "string",
95
+ "description": "Rationale/evidence for why the finding holds, so a human or downstream agent can judge its soundness — distinct from `description`, which explains the finding to the reader."
96
+ },
97
+ "patch": {
98
+ "type": "string",
99
+ "description": "Optional single-hunk unified diff of one mechanical fix to this file, expressed against its current (post-change) content — e.g. the `git diff` of just that edit after you apply it. It MUST be exactly one hunk and one contiguous change, and its context and removed lines MUST match the file verbatim so it applies cleanly. Omit this field when there is no clean mechanical fix — never invent one; put prose guidance in `recommendation` instead."
83
100
  }
84
101
  }
85
102
  }
package/schema/v0.2/findings.schema.json ADDED
@@ -0,0 +1,88 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://raw.githubusercontent.com/JPHutchins/code-review/schema-v0.2.0/schema/findings.schema.json",
4
+ "title": "Code Review — findings",
5
+ "description": "Structured output of an agentic PR review. The review agent emits this object (e.g. via a coding-agent CLI's structured-output mode, such as Claude Code's `--json-schema`, whose result lands in `.structured_output`); a deterministic commenter renders it into a sticky summary comment and inline PR review comments. Agent- and provider-agnostic: any model driven by a compatible CLI adapter may produce it. Kept free of $ref/$defs so the same file works for both JSON-Schema validators and CLI structured-output enforcement.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": ["schema_version", "summary", "verdict", "findings"],
9
+ "properties": {
10
+ "schema_version": {
11
+ "type": "string",
12
+ "pattern": "^(0|[1-9]\\d*)\\.(\\d+)\\.(\\d+)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$",
13
+ "description": "Semver version of this findings schema the object conforms to (e.g. \"0.1.0\"). Lets a commenter detect a version mismatch rather than silently dropping fields."
14
+ },
15
+ "summary": {
16
+ "type": "string",
17
+ "description": "Markdown walkthrough of the change and the overall assessment; rendered as the body of the sticky summary comment."
18
+ },
19
+ "verdict": {
20
+ "type": "string",
21
+ "enum": ["approve", "comment", "changes"],
22
+ "description": "Overall stance. Advisory only: a conforming commenter posts the GitHub review as COMMENT and never REQUEST_CHANGES, surfacing this value as a badge."
23
+ },
24
+ "findings": {
25
+ "type": "array",
26
+ "description": "Zero or more specific findings. Each becomes one inline review comment when its line is inside the diff; otherwise it is demoted into the summary.",
27
+ "items": {
28
+ "type": "object",
29
+ "additionalProperties": false,
30
+ "required": ["path", "start_line", "end_line", "severity", "title", "body"],
31
+ "properties": {
32
+ "path": {
33
+ "type": "string",
34
+ "description": "Repo-relative file path the finding anchors to."
35
+ },
36
+ "start_line": {
37
+ "type": "integer",
38
+ "minimum": 1,
39
+ "description": "1-indexed first line of the anchored range (post-change state when side is RIGHT)."
40
+ },
41
+ "end_line": {
42
+ "type": "integer",
43
+ "minimum": 1,
44
+ "description": "1-indexed last line of the range; MUST be >= start_line. A suggestion replaces exactly start_line..end_line."
45
+ },
46
+ "side": {
47
+ "type": "string",
48
+ "enum": ["RIGHT", "LEFT"],
49
+ "default": "RIGHT",
50
+ "description": "RIGHT for added/changed lines, LEFT for removed lines; matches the GitHub pulls reviews API."
51
+ },
52
+ "severity": {
53
+ "type": "string",
54
+ "enum": ["critical", "major", "minor", "nit"],
55
+ "description": "Used for grouping and for folding nits into a collapsed section."
56
+ },
57
+ "code": {
58
+ "type": "string",
59
+ "description": "Stable rule identifier (e.g. \"null-check-missing\") for rule-based filtering, suppression, and cross-run dedup."
60
+ },
61
+ "code_url": {
62
+ "type": "string",
63
+ "format": "uri",
64
+ "description": "URL documenting the rule named by code."
65
+ },
66
+ "title": {
67
+ "type": "string",
68
+ "description": "One-line summary of the finding."
69
+ },
70
+ "body": {
71
+ "type": "string",
72
+ "description": "Markdown explanation; rendered as the inline comment body."
73
+ },
74
+ "suggestion": {
75
+ "type": ["string", "null"],
76
+ "description": "null = no mechanical fix (render no suggestion block); \"\" (empty string) = delete start_line..end_line (render an empty suggestion block); non-empty = exact replacement text for start_line..end_line (render a GitHub suggestion block). A suggestion spanning more than GitHub's single-block line limit is demoted to the summary."
77
+ },
78
+ "confidence": {
79
+ "type": "number",
80
+ "minimum": 0,
81
+ "maximum": 1,
82
+ "description": "Optional 0..1 confidence; a commenter MAY suppress findings below a configurable threshold to control noise, but MUST NOT suppress a critical-severity finding on confidence alone."
83
+ }
84
+ }
85
+ }
86
+ }
87
+ }
88
+ }
package/templates/comment.eta CHANGED
@@ -1,43 +1,68 @@
1
1
  <!-- code-review -->
2
2
  <!-- reviewed-sha: <%= it.reviewedSha %> -->
3
+ <% if (it.findingsPointer) { -%>
4
+ <%~ it.findingsPointer %>
5
+ <% } -%>
3
6
 
4
7
  ### <%= it.verdictBadge(it.findings.verdict) %>
5
8
 
6
- <% const meta = [] %><% if (it.route) { meta.push('**Route:** ' + it.route) } %><% if (it.effort) { meta.push('**effort:** ' + it.effort) } %><% if (it.usageAvailable) { meta.push('**turns:** ' + it.envelope.turns); meta.push('**wall:** ' + it.formatDuration(it.envelope.duration_ms)) } else { meta.push('_usage unavailable_') } %><%~ meta.join(' · ') %>
9
+ <% const meta = [] %><% if (it.postedAt) { meta.push('**Reviewed** `' + it.reviewedSha.slice(0, 7) + '` at ' + it.postedAt) } %><% if (it.route) { meta.push('**route:** ' + it.route) } %><% if (it.effort) { meta.push('**effort:** ' + it.effort) } %><% if (it.usageAvailable) { meta.push('**turns:** ' + it.envelope.turns); meta.push('**wall:** ' + it.formatDuration(it.envelope.duration_ms)); meta.push('**models:** ' + it.modelNames); meta.push('**cost:** ' + it.formatCost(it.costReport.totalCostUSD)) } else { meta.push('_usage unavailable_') } %><sub><%~ meta.join(' · ') %></sub>
7
10
 
8
11
  <%~ it.findings.summary %>
9
12
 
10
13
  ---
11
14
 
12
- <% if (it.totalCount > 0) { %>
13
- #### 📊 Findings summary — <%= it.totalCount %> finding<%= it.totalCount === 1 ? '' : 's' %> on <%= it.fileCount %> file<%= it.fileCount === 1 ? '' : 's' %>
14
-
15
- <% if (it.visibleFindings.length > 0) { %>
16
- | Severity | File | Line | Summary |
17
- |---|---|---|---|
18
- <% it.visibleFindings.forEach(function(f) { %>
19
- | <%= it.severityEmoji(f.severity) %> <%= f.severity %> | `<%= f.path %>` | <%= f.start_line %><% if (f.start_line !== f.end_line) { %>–<%= f.end_line %><% } %> | <%= f.title %> |
20
- <% }) %>
21
-
15
+ <% const c = it.severityCounts %><% const findingsTotal = c.critical + c.major + c.minor + c.nit %>
16
+ <% if (findingsTotal > 0) { %>
17
+ <% const parts = [] %><% if (c.critical) { parts.push(it.severityEmoji('critical') + ' ' + c.critical) } %><% if (c.major) { parts.push(it.severityEmoji('major') + ' ' + c.major) } %><% if (c.minor) { parts.push(it.severityEmoji('minor') + ' ' + c.minor) } %><% if (c.nit) { parts.push(it.severityEmoji('nit') + ' ' + c.nit) } %>
18
+ **Findings:** <%~ parts.join(' · ') %>
19
+ <% } else { %>
20
+ _No findings — clean review._
22
21
  <% } %>
23
- <% if (it.nitFindings.length > 0) { %>
24
- <details>
25
- <summary>⚪ <%= it.nitFindings.length %> nit<%= it.nitFindings.length === 1 ? '' : 's' %> (folded)</summary>
26
-
27
- | File | Line | Summary |
28
- |---|---|---|
29
- <% it.nitFindings.forEach(function(f) { %>
30
- | `<%= f.path %>` | <%= f.start_line %><% if (f.start_line !== f.end_line) { %>–<%= f.end_line %><% } %> | <%= f.title %> |
31
- <% }) %>
32
22
 
33
- </details>
23
+ <% if (it.inlineDisposition && it.inlineDisposition.kind === 'posted') { %>
24
+ → <%= it.inlineDisposition.count %> comment<%= it.inlineDisposition.count === 1 ? '' : 's' %> posted inline on `<%= it.inlineDisposition.sha.slice(0, 7) %>` — <% if (it.reviewUrl) { %>[see the review](<%~ it.reviewUrl %>)<% } else { %>see the review<% } %>.
25
+ <% } else if (it.inlineDisposition && it.inlineDisposition.kind === 'none-in-diff') { %>
26
+ → No inline comments — all findings are outside the diff (listed below).
27
+ <% } else if (it.inlineDisposition && it.inlineDisposition.kind === 'inline-unavailable') { %>
28
+ → ⚠️ Inline comments couldn't be posted for this review (GitHub rejected a comment's position) — every finding is listed below instead.
34
29
  <% } %>
35
30
 
36
- <% if (it.suggestionCount > 0) { %>
37
- <%= it.suggestionCount %> finding<%= it.suggestionCount === 1 ? '' : 's' %> included suggestions — see inline comments for details.
31
+ <% if (it.strays.length > 0) { %>
32
+ ### <%= (it.unanchoredCount && it.unanchoredCount > 0) ? 'Findings' : 'Findings outside the diff' %>
33
+ <% if (it.unanchoredCount && it.unanchoredCount > 0) { %>
34
+ _<%= it.unanchoredCount %> finding<%= it.unanchoredCount === 1 ? '' : 's' %> below couldn't be posted as inline comment<%= it.unanchoredCount === 1 ? '' : 's' %> (GitHub rejected the position)<% if (it.strays.length > it.unanchoredCount) { %>; the rest are outside the diff<% } %>._
38
35
  <% } %>
39
- <% } else { %>
40
- _No findings — clean review._
36
+
37
+ <% it.strays.forEach(function(f) { -%>
38
+ #### <%= it.severityEmoji(f.severity) %> (<%= f.severity %>) `<%= f.path %>:<%= f.start_line %><% if (f.start_line !== f.end_line) { %>–<%= f.end_line %><% } %>` — <%= f.title %> · confidence <%= it.formatConfidence(f.confidence) %>
39
+
40
+ <%~ f.description %>
41
+ <% if (f.recommendation) { -%>
42
+
43
+ **Recommended fix:** <%~ f.recommendation %>
44
+ <% } -%>
45
+ <% if (f.patchProjection.kind === "suggestion") { -%>
46
+
47
+ ```suggestion
48
+ <%~ f.patchProjection.text %>
49
+ ```
50
+ <% } else if (f.patchProjection.kind === "patch") { -%>
51
+
52
+ ```patch
53
+ <%~ f.patchProjection.raw %>
54
+ ```
55
+ <% } -%>
56
+
57
+ > [!TIP]
58
+ > <details><summary>Reasoning (<%= it.formatConfidence(f.confidence) %> confidence)</summary>
59
+ >
60
+ <% f.reasoning.split("\n").forEach(function(rl) { -%>
61
+ > <%= rl %>
62
+ <% }) -%>
63
+ >
64
+ > </details>
65
+ <% }) %>
41
66
  <% } %>
42
67
 
43
68
  <% if (it.testReport) { %>
@@ -47,7 +72,7 @@ _No findings — clean review._
47
72
  <summary>📊 Test results — <%= it.testReport.passed %> passed, <%= it.testReport.failed %> failed</summary>
48
73
 
49
74
  <% if (it.testReport.failed > 0 && it.testReport.failures) { %>
50
- <% it.testReport.failures.forEach(function(f) { %>
75
+ <% it.testReport.failures.forEach(function(f) { -%>
51
76
  - **<%= f.name %>**<% if (f.message) { %> — <%~ f.message %><% } %>
52
77
  <% }) %>
53
78
  <% } else { %>
@@ -59,22 +84,24 @@ All <%= it.testReport.total %> tests passed.
59
84
 
60
85
  ---
61
86
 
62
- <% if (it.usageAvailable) { %>
63
- <sub>
64
-
65
- | Model | Input | Output | Cache read | Cache write | Cost |
66
- |---|--:|--:|--:|--:|--:|
67
- <% it.costReport.lines.forEach(function(l) { %>
68
- | <%= l.model %> | <%= it.formatTokens(l.inputTokens) %> | <%= it.formatTokens(l.outputTokens) %> | <%= it.formatTokens(l.cacheReadTokens) %> | <%= it.formatTokens(l.cacheWriteTokens) %> | <%= it.formatCost(l.costUSD) %> |
69
- <% }) %>
70
- | **Total** | **<%= it.formatTokens(it.costReport.totalInputTokens) %>** | **<%= it.formatTokens(it.costReport.totalOutputTokens) %>** | **<%= it.formatTokens(it.costReport.totalCacheReadTokens) %>** | **<%= it.formatTokens(it.costReport.totalCacheWriteTokens) %>** | **<%= it.formatCost(it.costReport.totalCostUSD) %>** |
71
-
72
- </sub>
73
- <% } else { %>
87
+ > [!WARNING]
88
+ > **LLM Disclosure** — this review was produced by <%= it.modelNames || "unknown model" %>.
89
+ >
90
+ <% if (it.usageAvailable && it.costReport.lines.length > 0) { -%>
91
+ > | Model | Input | Output | Cache read | Cache write | Cost |
92
+ > |---|--:|--:|--:|--:|--:|
93
+ <% it.costReport.lines.forEach(function(l) { -%>
94
+ > | <%= l.model %> | <%= it.formatTokens(l.inputTokens) %> | <%= it.formatTokens(l.outputTokens) %> | <%= it.formatTokens(l.cacheReadTokens) %> | <%= it.formatTokens(l.cacheWriteTokens) %> | <%= it.formatCost(l.costUSD) %> |
95
+ <% }) -%>
96
+ > | **Total** | **<%= it.formatTokens(it.costReport.totalInputTokens) %>** | **<%= it.formatTokens(it.costReport.totalOutputTokens) %>** | **<%= it.formatTokens(it.costReport.totalCacheReadTokens) %>** | **<%= it.formatTokens(it.costReport.totalCacheWriteTokens) %>** | **<%= it.formatCost(it.costReport.totalCostUSD) %>** |
97
+ <% } else if (it.usageAvailable) { -%>
98
+ > No per-model usage was recorded for this run.
99
+ <% } else { -%>
74
100
  > **Usage/cost unavailable** — the result envelope for this run was missing or malformed.
75
- <% } %>
76
-
77
- > [!NOTE]
78
- > **LLM Disclosure** — this review was produced by <%= it.modelNames || "unknown model" %> running
79
- > headless in an ephemeral, egress-locked CI runner with no write access to the repository. It is
80
- > advisory and does not block merge.
101
+ <% } -%>
102
+ <% if (it.usageAvailable && !it.pricesProvided) { -%>
103
+ >
104
+ > _Cost shown as **N/A** — [No `.github/prices.json`](https://github.com/JPHutchins/code-review/blob/main/schema/prices.example.json) price map to recompute from._
105
+ <% } -%>
106
+ >
107
+ > _Generated by [code-review](https://github.com/JPHutchins/code-review)<% if (it.runUrl) { %> · [view the run & traces](<%~ it.runUrl %>)<% } %>._
package/templates/inline.eta CHANGED
@@ -1,9 +1,32 @@
1
- <%~ it.body %>
1
+ <% if (it.findingsPointer) { -%>
2
+ <%~ it.findingsPointer %>
3
+ <% } -%>
4
+ <%= it.severityEmoji(it.severity) %> <%= it.severity.charAt(0).toUpperCase() + it.severity.slice(1) %>: **<%= it.title %>** · <%= it.formatConfidence(it.confidence) %> confidence
5
+
6
+ <%~ it.description %>
7
+ <% if (it.recommendation) { -%>
8
+
9
+ **Recommended fix:** <%~ it.recommendation %>
10
+ <% } -%>
11
+ <% if (it.patchProjection.kind === "suggestion") { -%>
2
12
 
3
- <% if (it.suggestion !== null && it.suggestion !== undefined) { %>
4
13
  ```suggestion
5
- <%~ it.suggestion %>
14
+ <%~ it.patchProjection.text %>
15
+ ```
16
+ <% } else if (it.patchProjection.kind === "patch") { -%>
17
+
18
+ ```patch
19
+ <%~ it.patchProjection.raw %>
6
20
  ```
7
- <% } %>
21
+ <% } -%>
8
22
 
9
- <sub>🤖 AI-generated — advisory only</sub>
23
+ > [!TIP]
24
+ > Generated by <%~ it.modelsText %>.
25
+ > <details>
26
+ > <summary>Reasoning</summary>
27
+ >
28
+ <% it.reasoning.split("\n").forEach(function(rl) { -%>
29
+ > <%= rl %>
30
+ <% }) -%>
31
+ >
32
+ > </details>