@mrclrchtr/supi-review 6.2.0 → 6.4.0

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 (78) hide show
  1. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  2. package/node_modules/@mrclrchtr/supi-agent-runtime/package.json +2 -2
  3. package/node_modules/@mrclrchtr/supi-code-intelligence/README.md +2 -0
  4. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  5. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  6. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/README.md +2 -0
  7. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  8. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  9. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/README.md +52 -0
  10. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/index.js +785 -129
  11. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/legacy.js +660 -98
  12. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/ignore/package.json +10 -4
  13. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/package.json +3 -3
  14. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/api.ts +16 -2
  15. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/workspace-sentinels.ts +4 -32
  16. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/workspace-sources.ts +108 -0
  17. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-process-crash-report.ts +106 -0
  18. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-recovery.ts +4 -4
  19. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +513 -113
  20. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostics.ts +43 -15
  21. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +40 -33
  22. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +36 -6
  23. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/summary.ts +1 -1
  24. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/workspace-path-policy.ts +18 -9
  25. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  26. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  27. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/README.md +29 -1
  28. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.cjs +99 -19
  29. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.cjs.map +4 -4
  30. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.js +94 -18
  31. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.js.map +4 -4
  32. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.wasm +0 -0
  33. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.wasm.map +14 -14
  34. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/package.json +13 -8
  35. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.cjs +97 -19
  36. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.cjs.map +4 -4
  37. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.cts +28 -8
  38. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.cts.map +1 -1
  39. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.ts +28 -8
  40. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.ts.map +1 -1
  41. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.js +92 -18
  42. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.js.map +4 -4
  43. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.wasm +0 -0
  44. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.wasm.map +17 -17
  45. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/package.json +7 -4
  46. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/kotlin/tree-sitter-kotlin.wasm +0 -0
  47. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/kotlin/tree-sitter-kotlin.wasm.json +2 -2
  48. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/sql/tree-sitter-sql.wasm +0 -0
  49. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/sql/tree-sitter-sql.wasm.json +2 -2
  50. package/node_modules/@mrclrchtr/supi-code-intelligence/package.json +5 -5
  51. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-refresh.ts +19 -12
  52. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-types.ts +8 -3
  53. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-workflow.ts +7 -3
  54. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/session.ts +12 -5
  55. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/maintenance.ts +53 -47
  56. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/settings.ts +2 -1
  57. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/source-tracking.ts +247 -0
  58. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/guidance.ts +3 -3
  59. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/guidance.ts +2 -2
  60. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/guidance.ts +3 -3
  61. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/markdown.ts +21 -5
  62. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/refresh-outcome.ts +48 -7
  63. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/refresh-status.ts +83 -16
  64. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/tui.ts +4 -0
  65. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/guidance.ts +5 -3
  66. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/guidance.ts +3 -4
  67. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_apply/guidance.ts +1 -1
  68. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_plan/guidance.ts +3 -5
  69. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/guidance.ts +3 -3
  70. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/guidance.ts +11 -9
  71. package/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  72. package/package.json +4 -4
  73. package/src/tool/review_run/child-session.ts +1 -0
  74. package/src/tool/review_run/debug-summary.ts +32 -1
  75. package/src/tool/review_run/guidance.ts +4 -9
  76. package/src/tool/review_run/input-schema.ts +10 -15
  77. package/src/tool/review_run/schemas.ts +8 -12
  78. package/src/types.ts +2 -0
@@ -1,5 +1,5 @@
1
1
  export const toolDescription =
2
- "Apply one fresh stored refactor plan by planId after safety checks; mutates its files.";
2
+ "Apply a fresh stored refactor plan to change its files. It does not create or regenerate a plan.";
3
3
 
4
4
  export const promptSnippet = "apply a stored refactor plan";
5
5
 
@@ -1,8 +1,6 @@
1
1
  export const toolDescription =
2
- "Preview one semantic rename, extraction, import cleanup, or dead-code deletion and return a planId without mutating files.";
2
+ "Preview a semantic refactor without changing files or falling back to text edits.";
3
3
 
4
- export const promptSnippet = "preview a precise semantic refactor";
4
+ export const promptSnippet = "preview a semantic refactor";
5
5
 
6
- export const promptGuidelines = [
7
- "Use code_refactor_plan for preview only, then call code_refactor_apply with its planId.",
8
- ];
6
+ export const promptGuidelines: string[] = [];
@@ -1,8 +1,8 @@
1
1
  export const toolDescription =
2
- "Resolve one provider-backed anchor or semantic symbol query to session handles, or enumerate a file's declarations as a bounded Target group. Anchors must identify real symbols";
2
+ "Resolve a real symbol anchor or semantic query to target handles, or list a file's declarations as a target group. Symbol lookup does not fall back to text search.";
3
3
 
4
- export const promptSnippet = "resolve a precise target or enumerate a file’s target group";
4
+ export const promptSnippet = "resolve symbols or file declarations";
5
5
 
6
6
  export const promptGuidelines = [
7
- "Use code_resolve when a symbol query may be ambiguous, when later calls should share a stable target handle, or when a known file’s declarations should be enumerated.",
7
+ "Use code_resolve when a symbol query can match multiple symbols or when a later tool requires a target handle.",
8
8
  ];
@@ -1,10 +1,8 @@
1
- // Model-facing prompt surfaces for the eight public code-intelligence tools.
2
- //
3
- // Ownership map (docs/pi/tool-guidance.md): each model-facing fact lives in
4
- // exactly one home — the per-tool guidance module. This aggregator assembles
5
- // the canonical surface map consumed by registration.
6
- // Parameter mechanics (formats, enum semantics, cross-field rules) live in
7
- // schemas.ts / per-tool spec.ts and are not repeated here.
1
+ /**
2
+ * Each tool owns its model-facing text. This module assembles the canonical
3
+ * surface map used by registration. Parameter mechanics stay in specs and
4
+ * shared schemas.
5
+ */
8
6
 
9
7
  import type { CodeIntelligenceToolName } from "../types/index.ts";
10
8
  import {
@@ -48,9 +46,13 @@ import {
48
46
  promptSnippet as resolveSnippet,
49
47
  } from "./code_resolve/guidance.ts";
50
48
 
49
+ /** Model-facing fields registered for one public code-intelligence tool. */
51
50
  export interface CodeIntelligenceToolPromptSurface {
51
+ /** Selection contract in the active provider tool definition. */
52
52
  description: string;
53
+ /** One-line capability phrase in the default tool list. */
53
54
  promptSnippet: string;
55
+ /** Optional active-tool routing or ordering reminders. */
54
56
  promptGuidelines: string[];
55
57
  }
56
58
 
@@ -59,7 +61,7 @@ export type CodeIntelligenceToolPromptSurfaceMap = Record<
59
61
  CodeIntelligenceToolPromptSurface
60
62
  >;
61
63
 
62
- export const CODE_INTELLIGENCE_TOOL_PROMPT_SURFACES: CodeIntelligenceToolPromptSurfaceMap = {
64
+ export const CODE_INTELLIGENCE_TOOL_PROMPT_SURFACES = {
63
65
  code_resolve: {
64
66
  description: resolveDescription,
65
67
  promptSnippet: resolveSnippet,
@@ -100,4 +102,4 @@ export const CODE_INTELLIGENCE_TOOL_PROMPT_SURFACES: CodeIntelligenceToolPromptS
100
102
  promptSnippet: applySnippet,
101
103
  promptGuidelines: applyGuidelines,
102
104
  },
103
- };
105
+ } satisfies CodeIntelligenceToolPromptSurfaceMap;
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-core",
3
- "version": "6.2.0",
3
+ "version": "6.4.0",
4
4
  "description": "Shared settings, configuration, reporting, and session infrastructure",
5
5
  "license": "MIT",
6
6
  "repository": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-review",
3
- "version": "6.2.0",
3
+ "version": "6.4.0",
4
4
  "description": "Parallel inspection-only reviews of exact Git targets",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -31,9 +31,9 @@
31
31
  "README.md"
32
32
  ],
33
33
  "dependencies": {
34
- "@mrclrchtr/supi-core": "6.2.0",
35
- "@mrclrchtr/supi-code-intelligence": "6.2.0",
36
- "@mrclrchtr/supi-agent-runtime": "6.2.0"
34
+ "@mrclrchtr/supi-agent-runtime": "6.4.0",
35
+ "@mrclrchtr/supi-code-intelligence": "6.4.0",
36
+ "@mrclrchtr/supi-core": "6.4.0"
37
37
  },
38
38
  "bundledDependencies": [
39
39
  "@mrclrchtr/supi-agent-runtime",
@@ -53,6 +53,7 @@ function toReviewProgress(progress: AgentRunProgress): ReviewProgress {
53
53
  tokens: {
54
54
  input: usage.input,
55
55
  output: usage.output,
56
+ ...(usage.reasoning === undefined ? {} : { reasoning: usage.reasoning }),
56
57
  total: usage.totalTokens,
57
58
  cacheRead: usage.cacheRead,
58
59
  cacheWrite: usage.cacheWrite,
@@ -19,6 +19,34 @@ export interface ReviewTaskDebugSummaryInput {
19
19
  result: ReviewTaskResult;
20
20
  }
21
21
 
22
+ type ReviewDebugTokens = NonNullable<ReviewProgress["tokens"]>;
23
+
24
+ function tokensFromUsage(usage: ReviewTaskResult["usage"]): ReviewDebugTokens | undefined {
25
+ if (!usage) return undefined;
26
+ return {
27
+ input: usage.input,
28
+ output: usage.output,
29
+ ...(usage.reasoning === undefined ? {} : { reasoning: usage.reasoning }),
30
+ total: usage.totalTokens,
31
+ cacheRead: usage.cacheRead,
32
+ cacheWrite: usage.cacheWrite,
33
+ };
34
+ }
35
+
36
+ /**
37
+ * Prefer observed progress totals and supplement only missing final reasoning usage.
38
+ * This preserves live metrics while covering terminal paths without a progress update.
39
+ */
40
+ function resolveDebugTokens(
41
+ observed: ReviewProgress["tokens"],
42
+ usage: ReviewTaskResult["usage"],
43
+ ): ReviewDebugTokens | undefined {
44
+ if (!observed) return tokensFromUsage(usage);
45
+ const reasoning = usage?.reasoning;
46
+ if (observed.reasoning !== undefined || reasoning === undefined) return observed;
47
+ return { ...observed, reasoning };
48
+ }
49
+
22
50
  function cacheHitRate(tokens: ReviewProgress["tokens"]): number | undefined {
23
51
  if (!tokens) return undefined;
24
52
  const cacheRead = tokens.cacheRead ?? 0;
@@ -36,7 +64,8 @@ function cacheHitRate(tokens: ReviewProgress["tokens"]): number | undefined {
36
64
  export function recordReviewTaskDebugSummary(input: ReviewTaskDebugSummaryInput): void {
37
65
  const { result } = input;
38
66
  const diagnostics = "diagnostics" in result ? result.diagnostics : undefined;
39
- const tokens = input.progress?.tokens ?? diagnostics?.tokens;
67
+ const observedTokens = input.progress?.tokens ?? diagnostics?.tokens;
68
+ const tokens = resolveDebugTokens(observedTokens, result.usage);
40
69
  const hitRate = cacheHitRate(tokens);
41
70
  const data = {
42
71
  taskId: input.taskId,
@@ -46,6 +75,8 @@ export function recordReviewTaskDebugSummary(input: ReviewTaskDebugSummaryInput)
46
75
  packetBytes: input.packetBytes,
47
76
  durationMs: input.durationMs,
48
77
  status: result.status,
78
+ requestedThinkingLevel: result.requestedThinkingLevel,
79
+ effectiveThinkingLevel: result.effectiveThinkingLevel,
49
80
  reviewerExtensionSetStatus: input.reviewerExtensionSetStatus,
50
81
  ...(result.status === "completed" ? { verdict: result.verdict } : {}),
51
82
  ...(result.status === "failed" ? { failureCode: result.failureCode } : {}),
@@ -1,11 +1,6 @@
1
- import { MAX_PAGE_CHARACTERS, MAX_PAGE_LINES } from "../output-page.ts";
1
+ export const toolDescription =
2
+ "Run independent review tasks concurrently under an Inspection-only protocol against one frozen Review Target. Use for code reviews or criteria-based inspections instead of generic subagents, not for exploration or simple direct checks.";
2
3
 
3
- export const toolDescription = `Run one to four independent Inspection-only tasks concurrently against one exact frozen target. Use for code reviews instead of generic subagents. Each change task needs a non-empty change; committed change targets require from; all-state targets omit from. Creates a disposable linked Git worktree. A configured bootstrap can run one shell command there, and enabled auditing stores raw local replays. Output pages are limited to ${MAX_PAGE_CHARACTERS} UTF-16 characters and ${MAX_PAGE_LINES.toLocaleString("en-US")} lines.`;
4
+ export const promptSnippet = "Run independent inspection-only reviews";
4
5
 
5
- export const promptSnippet = "Run independent inspection-only review tasks";
6
-
7
- export const promptGuidelines = [
8
- "Use `review_run` for repository reviews and criteria-based inspections. Use task mode `change` for before-and-after changes and `state` for the frozen current code state.",
9
- "Do not use `review_run` for exploration.",
10
- "Do not use `review_run` for simple reviews you can complete directly.",
11
- ];
6
+ export const promptGuidelines: string[] = [];
@@ -6,12 +6,11 @@ import { normalizeReviewTarget, reviewTargetEndpoints } from "../../target/input
6
6
  import type { ReviewInput, ReviewScope, ReviewTargetSpec } from "../../types.ts";
7
7
  import { reviewInputSchema } from "./schemas.ts";
8
8
 
9
- function endpointSchema(role: "before" | "after") {
9
+ function endpointSchema() {
10
10
  return Type.String({
11
11
  minLength: 1,
12
12
  maxLength: 512,
13
13
  pattern: "^\\S+$",
14
- description: `Git revision for the exact ${role} state. Branches, hashes, ~, ^, and lightweight or annotated tags are valid. It must resolve to one commit; whitespace, ranges, trees, blobs, and blank values are not valid.`,
15
14
  });
16
15
  }
17
16
 
@@ -20,37 +19,36 @@ const scopePathsSchema = Type.Array(
20
19
  minLength: 1,
21
20
  maxLength: REVIEW_LIMITS.reviewScopePathCharacters,
22
21
  pattern: "\\S",
23
- description:
24
- "Repository-relative path that focuses every Review Task. A leading @ is accepted. The path must exist in the frozen after state.",
22
+ description: "Repository-relative path in the frozen after state; a leading @ is accepted.",
25
23
  }),
26
24
  {
27
25
  minItems: 1,
28
26
  maxItems: REVIEW_LIMITS.reviewScopePathsPerTarget,
29
27
  description:
30
- "Optional advisory path focus for this batch. This argument sits at the top level of the tool call, alongside target; do not place it inside target. It does not limit repository inspection, changed-path evidence, or findings.",
28
+ "Advisory focus for all tasks; it does not limit inspection, changed-path evidence, or findings.",
31
29
  },
32
30
  );
33
31
 
34
32
  const workingTreeTargetSchema = Type.Object(
35
33
  {
36
- from: Type.Optional(endpointSchema("before")),
34
+ from: Type.Optional(endpointSchema()),
37
35
  },
38
36
  {
39
37
  additionalProperties: false,
40
38
  description:
41
- "Review the frozen current filesystem, including staged, unstaged, and non-ignored untracked files. Optional from sets the committed before state.",
39
+ "Freeze the current filesystem, including staged, unstaged, and non-ignored untracked files; from selects the before commit.",
42
40
  },
43
41
  );
44
42
 
45
43
  const committedTargetSchema = Type.Object(
46
44
  {
47
- from: Type.Optional(endpointSchema("before")),
48
- to: Type.Optional(endpointSchema("after")),
45
+ from: Type.Optional(endpointSchema()),
46
+ to: Type.Optional(endpointSchema()),
49
47
  },
50
48
  {
51
49
  additionalProperties: false,
52
50
  description:
53
- "Review exact committed Git state. Optional from and to select the before and after commits; to defaults to HEAD.",
51
+ "Freeze committed state; from and to select before and after commits. The to endpoint defaults to HEAD. Change tasks require from and cannot use a root commit as to.",
54
52
  },
55
53
  );
56
54
 
@@ -63,7 +61,7 @@ const targetSchema = Type.Object(
63
61
  maxProperties: 1,
64
62
  additionalProperties: false,
65
63
  description:
66
- "Exact Review Target. Omit it, or use {}, for the current filesystem. Select workingTree or committed; endpoints resolve once to full commits.",
64
+ "Omit target or use {} for the current filesystem; otherwise select workingTree or committed. All-state batches must omit from. Endpoints must resolve to commits; ranges, trees, and blobs are invalid.",
67
65
  },
68
66
  );
69
67
 
@@ -74,10 +72,7 @@ export const runReviewSchema = Type.Object(
74
72
  paths: Type.Optional(scopePathsSchema),
75
73
  ...reviewInputSchema.properties,
76
74
  },
77
- {
78
- additionalProperties: false,
79
- description: "Run one complete caller-defined Review against one exact Review Target.",
80
- },
75
+ { additionalProperties: false },
81
76
  );
82
77
 
83
78
  interface RawRunReviewInput extends ReviewInput {
@@ -9,18 +9,17 @@ export const reviewTaskSchema = Type.Object(
9
9
  minLength: 1,
10
10
  maxLength: REVIEW_LIMITS.taskIdCharacters,
11
11
  pattern: "\\S",
12
- description: "Unique task id used to match its result, such as standards or spec.",
12
+ description: "Task id for its result, such as standards or spec.",
13
13
  }),
14
14
  instructions: Type.String({
15
15
  minLength: 1,
16
16
  maxLength: REVIEW_LIMITS.taskInstructionCharacters,
17
17
  pattern: "\\S",
18
- description:
19
- "Self-contained review objective and criteria. Tasks run independently and cannot see each other's progress.",
18
+ description: "Self-contained review objective and criteria for one task.",
20
19
  }),
21
20
  mode: StringEnum(["change", "state"] as const, {
22
21
  description:
23
- "Required evidence view. change reviews one non-empty before-and-after change. state reviews only the frozen after state.",
22
+ "Evidence view: change uses one non-empty before-and-after change; state uses only the frozen after state.",
24
23
  }),
25
24
  criteriaSources: Type.Optional(
26
25
  Type.Array(
@@ -30,15 +29,13 @@ export const reviewTaskSchema = Type.Object(
30
29
  minLength: 1,
31
30
  maxLength: REVIEW_LIMITS.criteriaReferenceCharacters,
32
31
  pattern: "\\S",
33
- description:
34
- "Authoritative source identifier, such as an issue reference, URL, or repository-relative document path.",
32
+ description: "Issue reference, URL, or repository-relative document path.",
35
33
  }),
36
34
  summary: Type.String({
37
35
  minLength: 1,
38
36
  maxLength: REVIEW_LIMITS.criteriaSummaryCharacters,
39
37
  pattern: "\\S",
40
- description:
41
- "Caller summary of the source used before the reviewer retrieves the source itself.",
38
+ description: "Source summary; the reviewer retrieves more detail only when needed.",
42
39
  }),
43
40
  },
44
41
  { additionalProperties: false },
@@ -46,7 +43,7 @@ export const reviewTaskSchema = Type.Object(
46
43
  {
47
44
  minItems: 1,
48
45
  maxItems: REVIEW_LIMITS.criteriaSourcesPerTask,
49
- description: "Authoritative issues or documents this task's Review Criteria derive from.",
46
+ description: "Authoritative sources for this task's Review Criteria.",
50
47
  },
51
48
  ),
52
49
  ),
@@ -61,14 +58,13 @@ export const reviewInputSchema = Type.Object(
61
58
  Type.String({
62
59
  maxLength: REVIEW_LIMITS.sharedContextCharacters,
63
60
  pattern: "\\S",
64
- description: "Context copied to every reviewer; omit task-specific instructions.",
61
+ description: "Context for all tasks; exclude task-specific instructions.",
65
62
  }),
66
63
  ),
67
64
  tasks: Type.Array(reviewTaskSchema, {
68
65
  minItems: 1,
69
66
  maxItems: 4,
70
- description:
71
- "One to four independent tasks, in caller order. Task ids must be unique; tasks run concurrently.",
67
+ description: "Results keep caller order; task ids must be unique.",
72
68
  }),
73
69
  },
74
70
  {
package/src/types.ts CHANGED
@@ -226,6 +226,8 @@ export interface ReviewProgress {
226
226
  tokens?: {
227
227
  input: number;
228
228
  output: number;
229
+ /** Reasoning tokens, when the provider reports them. */
230
+ reasoning?: number;
229
231
  total: number;
230
232
  cacheRead?: number;
231
233
  cacheWrite?: number;