@mrclrchtr/supi-review 6.3.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 (41) 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/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  4. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  5. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  6. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  7. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/package.json +3 -3
  8. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/api.ts +10 -0
  9. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/workspace-sentinels.ts +4 -32
  10. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/workspace-sources.ts +108 -0
  11. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +165 -14
  12. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +17 -1
  13. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +32 -2
  14. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  15. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  16. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/package.json +3 -3
  17. package/node_modules/@mrclrchtr/supi-code-intelligence/package.json +5 -5
  18. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-refresh.ts +15 -10
  19. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-types.ts +5 -0
  20. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-workflow.ts +7 -3
  21. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/session.ts +12 -5
  22. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/maintenance.ts +53 -47
  23. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/source-tracking.ts +247 -0
  24. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/guidance.ts +3 -3
  25. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/guidance.ts +2 -2
  26. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/guidance.ts +3 -3
  27. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/markdown.ts +21 -5
  28. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/refresh-outcome.ts +11 -0
  29. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/refresh-status.ts +25 -4
  30. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/tui.ts +4 -0
  31. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/guidance.ts +5 -3
  32. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/guidance.ts +3 -4
  33. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_apply/guidance.ts +1 -1
  34. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_plan/guidance.ts +3 -5
  35. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/guidance.ts +3 -3
  36. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/guidance.ts +11 -9
  37. package/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  38. package/package.json +4 -4
  39. package/src/tool/review_run/guidance.ts +4 -9
  40. package/src/tool/review_run/input-schema.ts +10 -15
  41. package/src/tool/review_run/schemas.ts +8 -12
@@ -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
  {