@simonren/quorum 0.13.0 → 0.14.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.
- package/README.md +2 -2
- package/commands/multi-review.md +4 -4
- package/dist/adapters/claude.d.ts +17 -6
- package/dist/adapters/claude.js +18 -10
- package/dist/adapters/cli-adapter.js +4 -3
- package/dist/adapters/codex.d.ts +0 -1
- package/dist/adapters/codex.js +0 -1
- package/dist/config.d.ts +4 -2
- package/dist/config.js +5 -3
- package/dist/consult-prompt.js +1 -1
- package/dist/handoff.d.ts +3 -7
- package/dist/handoff.js +96 -27
- package/dist/integrity.d.ts +13 -4
- package/dist/integrity.js +46 -11
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -83,13 +83,13 @@ You have a question → /multi-consult → question + criteria → Codex, Gemi
|
|
|
83
83
|
|
|
84
84
|
**Key principles:**
|
|
85
85
|
- **Claude Code is primary.** External models assist; Claude Code verifies and decides.
|
|
86
|
-
- **Working-directory strategy.** Claude Code passes the cwd and a small brief; reviewers read the files themselves. Read-only by contract: Codex runs with `--sandbox read-only`; Claude runs in default permission mode with prompts disabled,
|
|
86
|
+
- **Working-directory strategy.** Claude Code passes the cwd and a small brief; reviewers read the files themselves. Read-only by contract: Codex runs with `--sandbox read-only`; Claude runs in default permission mode with prompts disabled and holds only the Read, Grep, Glob and Bash tools, with Bash limited to read-only commands; agy runs with `--sandbox`, which covers only its terminal, and agy lets the model rerun a command outside it unless agy's `toolPermission` is `proceed-in-sandbox` (`doctor` warns on `always-proceed`). agy cannot make its file tools read-only, so quorum fingerprints the working tree (`git status`, plus the size and mtime of every file it lists) before and after every run and flags any change at the top of the result. Ignored files and `.git/` are outside that check.
|
|
87
87
|
- **Structured, verifiable answers.** Reviewers respond with `Verdict` / `Findings` (severity, location, evidence, impact, fix, confidence) / `Answers` / `Decisions`; drift from the contract is flagged so Claude Code can discount it.
|
|
88
88
|
- **Synthesis, not passthrough.** Raw model output never reaches you unless you ask for it; the provenance footer always does.
|
|
89
89
|
|
|
90
90
|
## Configuration
|
|
91
91
|
|
|
92
|
-
`~/.config/quorum/config.json` is created
|
|
92
|
+
`~/.config/quorum/config.json` is created empty on first launch and hot-reloaded when edited. Every key is optional, and a key you leave out follows the current release's default.
|
|
93
93
|
|
|
94
94
|
```json
|
|
95
95
|
{
|
package/commands/multi-review.md
CHANGED
|
@@ -71,16 +71,16 @@ The call takes minutes. Do not call it twice for the same work.
|
|
|
71
71
|
|
|
72
72
|
## Step 3 — Verify, then judge
|
|
73
73
|
|
|
74
|
-
The result is a `# Multi-Model Review` header followed by `## Standard review` and `## Adversarial review`, each holding one `<review model=… pass=… status=…>` block per model. Each block is a reviewer's raw response in the shape `## Verdict` / `## Findings` (`[S1|S2]` with Location, Evidence, Impact, Fix, Confidence; `[S3]` as one-liners) / `## Answers` / `## Decisions`. A block may carry `status="failed"` or a `⚠️ Format drift` line.
|
|
74
|
+
The result is a `# Multi-Model Review` header followed by `## Standard review` and `## Adversarial review`, each holding one `<review model=… pass=… status=…>` block per model. Each block is a reviewer's raw response in the shape `## Verdict` / `## Findings` (`[S1|S2]` with Location, Evidence, Impact, Fix, Confidence; `[S3]` as one-liners) / `## Answers` / `## Decisions`. Answer and decision lines start with an id — `U1`, `Q1`, `D1` — that numbers your brief's uncertainties, questions and decisions in the order you wrote them, the same in every block. A block may carry `status="failed"` or a `⚠️ Format drift` line.
|
|
75
75
|
|
|
76
76
|
1. **Read every block.** Note which model/pass failed and why; that goes in your report.
|
|
77
77
|
2. **Merge findings** into one deduplicated list across models and passes. Record who raised each. Agreement raises priority but does not replace verification.
|
|
78
78
|
3. **Verify the findings that decide the verdict, once each:** every S1/S2, and any finding that would change your verdict. Read only the cited ranges, batching several locations into one tool call; trace the failure path and mark it:
|
|
79
79
|
- ✓✓ verified — you confirmed the failure path in the code
|
|
80
80
|
- ✓ plausible — consistent with the code, not fully traced
|
|
81
|
-
- ✗ rejected — say why in one line
|
|
82
|
-
S3 findings are listed as `? unverified` unless you verify them because you are about to fix them. Adversarial-only findings are speculative by design: verify before acting. A finding with no location or evidence is unverified, not accepted.
|
|
83
|
-
4. **Resolve your own uncertainties** from the Answers sections, load-bearing first. Do the same for your questions and decisions; note where reviewers disagree with each other.
|
|
81
|
+
- ✗ rejected — say why in one line, citing the `path:line` that refutes it. A failure no real caller or input can produce is rejected, not fixed.
|
|
82
|
+
S3 findings are listed as `? unverified` unless you verify them because you are about to fix them; a security, authorization or data-loss finding is verified whatever its severity. Adversarial-only findings are speculative by design: verify before acting. A finding with no location or evidence is unverified, not accepted.
|
|
83
|
+
4. **Resolve your own uncertainties** from the Answers sections, matching by id, load-bearing first. Do the same for your questions and decisions; note where reviewers disagree with each other.
|
|
84
84
|
5. **Decide.** Your verdict, judged against your bar, not a tally of the panel's.
|
|
85
85
|
|
|
86
86
|
## Step 4 — Report
|
|
@@ -13,8 +13,21 @@
|
|
|
13
13
|
* Code's planning workflow (write a plan file,
|
|
14
14
|
* spawn Explore agents, end with ExitPlanMode)
|
|
15
15
|
* which fights the review brief.
|
|
16
|
-
* 2. --
|
|
17
|
-
*
|
|
16
|
+
* 2. --tools the session holds only Read, Grep, Glob and
|
|
17
|
+
* Bash. An allowlist, not a denylist: each
|
|
18
|
+
* Claude Code release adds built-in tools,
|
|
19
|
+
* and one that needs no permission runs
|
|
20
|
+
* whatever layer 1 says — EnterWorktree
|
|
21
|
+
* created a branch and a worktree in the
|
|
22
|
+
* repository under review
|
|
23
|
+
* 3. no --allowed-tools Bash runs only what Claude Code itself
|
|
24
|
+
* judges read-only, which covers the git a
|
|
25
|
+
* review needs (status, diff, log, show,
|
|
26
|
+
* blame, grep, ls-files). An allow rule such
|
|
27
|
+
* as `Bash(git diff *)` must not come back:
|
|
28
|
+
* it bypassed that judgement, so
|
|
29
|
+
* `git diff --output=<file>` wrote the file
|
|
30
|
+
* and `git grep -O<cmd>` ran the command
|
|
18
31
|
* 4. --strict-mcp-config none of the user's MCP servers are started
|
|
19
32
|
* 5. --setting-sources '' no user/project/local settings, hooks or
|
|
20
33
|
* plugins from settings files
|
|
@@ -27,10 +40,8 @@
|
|
|
27
40
|
*/
|
|
28
41
|
import { ReviewerCapabilities } from './base.js';
|
|
29
42
|
import { CliAdapter, CliOutcome, RunContext, RunLimits } from './cli-adapter.js';
|
|
30
|
-
/**
|
|
31
|
-
export declare const
|
|
32
|
-
/** The only shell commands the reviewer may run: read-only git, as the prompt's ground rules promise. */
|
|
33
|
-
export declare const ALLOWED_TOOLS: string;
|
|
43
|
+
/** Every tool the reviewer session has. Grep and Glob need no permission, so a search can never be refused. */
|
|
44
|
+
export declare const REVIEWER_TOOLS = "Read,Grep,Glob,Bash";
|
|
34
45
|
export declare class ClaudeAdapter extends CliAdapter {
|
|
35
46
|
readonly id = "claude";
|
|
36
47
|
protected readonly binary = "claude";
|
package/dist/adapters/claude.js
CHANGED
|
@@ -13,8 +13,21 @@
|
|
|
13
13
|
* Code's planning workflow (write a plan file,
|
|
14
14
|
* spawn Explore agents, end with ExitPlanMode)
|
|
15
15
|
* which fights the review brief.
|
|
16
|
-
* 2. --
|
|
17
|
-
*
|
|
16
|
+
* 2. --tools the session holds only Read, Grep, Glob and
|
|
17
|
+
* Bash. An allowlist, not a denylist: each
|
|
18
|
+
* Claude Code release adds built-in tools,
|
|
19
|
+
* and one that needs no permission runs
|
|
20
|
+
* whatever layer 1 says — EnterWorktree
|
|
21
|
+
* created a branch and a worktree in the
|
|
22
|
+
* repository under review
|
|
23
|
+
* 3. no --allowed-tools Bash runs only what Claude Code itself
|
|
24
|
+
* judges read-only, which covers the git a
|
|
25
|
+
* review needs (status, diff, log, show,
|
|
26
|
+
* blame, grep, ls-files). An allow rule such
|
|
27
|
+
* as `Bash(git diff *)` must not come back:
|
|
28
|
+
* it bypassed that judgement, so
|
|
29
|
+
* `git diff --output=<file>` wrote the file
|
|
30
|
+
* and `git grep -O<cmd>` ran the command
|
|
18
31
|
* 4. --strict-mcp-config none of the user's MCP servers are started
|
|
19
32
|
* 5. --setting-sources '' no user/project/local settings, hooks or
|
|
20
33
|
* plugins from settings files
|
|
@@ -30,12 +43,8 @@ import { CliAdapter } from './cli-adapter.js';
|
|
|
30
43
|
import { CliExecutor } from '../executor.js';
|
|
31
44
|
import { ClaudeEventDecoder } from '../decoders/index.js';
|
|
32
45
|
import { getConfig } from '../config.js';
|
|
33
|
-
/**
|
|
34
|
-
export const
|
|
35
|
-
/** The only shell commands the reviewer may run: read-only git, as the prompt's ground rules promise. */
|
|
36
|
-
export const ALLOWED_TOOLS = [
|
|
37
|
-
'git status', 'git diff', 'git log', 'git show', 'git blame', 'git ls-files', 'git grep', 'git rev-parse', 'git merge-base',
|
|
38
|
-
].flatMap((cmd) => [`Bash(${cmd})`, `Bash(${cmd} *)`]).join(' ');
|
|
46
|
+
/** Every tool the reviewer session has. Grep and Glob need no permission, so a search can never be refused. */
|
|
47
|
+
export const REVIEWER_TOOLS = 'Read,Grep,Glob,Bash';
|
|
39
48
|
export class ClaudeAdapter extends CliAdapter {
|
|
40
49
|
id = 'claude';
|
|
41
50
|
binary = 'claude';
|
|
@@ -73,8 +82,7 @@ export class ClaudeAdapter extends CliAdapter {
|
|
|
73
82
|
'--output-format', 'stream-json',
|
|
74
83
|
'--no-session-persistence', // ephemeral — leaves no session on disk
|
|
75
84
|
'--disable-slash-commands', // no skills — minimal startup
|
|
76
|
-
'--
|
|
77
|
-
'--allowed-tools', ALLOWED_TOOLS, // read-only git in Bash (layer 3)
|
|
85
|
+
'--tools', REVIEWER_TOOLS, // nothing but read tools exists in the session (layer 2)
|
|
78
86
|
];
|
|
79
87
|
}
|
|
80
88
|
async runCli(prompt, workingDir, ctx) {
|
|
@@ -158,16 +158,17 @@ export class CliAdapter {
|
|
|
158
158
|
}
|
|
159
159
|
const rateLimit = [
|
|
160
160
|
'rate limit', 'rate_limit', 'too many requests', 'quota exceeded', 'insufficient_quota', 'exceeded your current quota',
|
|
161
|
-
'overloaded', ...this.extraRateLimitPatterns,
|
|
161
|
+
'overloaded', 'usage limit', 'spend limit', 'at capacity', ...this.extraRateLimitPatterns,
|
|
162
162
|
];
|
|
163
|
-
|
|
163
|
+
// "You've hit your session limit · resets 5:40pm" is how Claude Code reports a subscription cap.
|
|
164
|
+
if (has(rateLimit) || httpStatus('429') || /hit your [\w ]{0,20}limit/i.test(stderr)) {
|
|
164
165
|
return { type: 'rate_limit', message: `${this.getCapabilities().name} rate limit or quota: ${excerpt}` };
|
|
165
166
|
}
|
|
166
167
|
return { type: 'cli_error', message: excerpt || 'Unknown error' };
|
|
167
168
|
}
|
|
168
169
|
getSuggestion(error) {
|
|
169
170
|
switch (error.type) {
|
|
170
|
-
case 'rate_limit': return
|
|
171
|
+
case 'rate_limit': return `Wait and retry (the message may name a reset time). If it persists, check the plan limits for this CLI or set ${this.id}.model to another model in ~/.config/quorum/config.json`;
|
|
171
172
|
case 'auth_error': return this.authHint;
|
|
172
173
|
case 'cli_not_found': return this.installHint;
|
|
173
174
|
case 'timeout': return `Narrow the scope or raise ${this.id}.inactivityTimeoutMs in ~/.config/quorum/config.json`;
|
package/dist/adapters/codex.d.ts
CHANGED
|
@@ -13,7 +13,6 @@ export declare class CodexAdapter extends CliAdapter {
|
|
|
13
13
|
protected readonly binary = "codex";
|
|
14
14
|
protected readonly installHint = "Install with: npm install -g @openai/codex-cli, then run `codex login`";
|
|
15
15
|
protected readonly authHint = "Run `codex login` to authenticate";
|
|
16
|
-
protected extraRateLimitPatterns: string[];
|
|
17
16
|
getCapabilities(): ReviewerCapabilities;
|
|
18
17
|
protected getLimits(ctx: RunContext): RunLimits;
|
|
19
18
|
/** Request value > per-kind config default. */
|
package/dist/adapters/codex.js
CHANGED
|
@@ -17,7 +17,6 @@ export class CodexAdapter extends CliAdapter {
|
|
|
17
17
|
binary = 'codex';
|
|
18
18
|
installHint = 'Install with: npm install -g @openai/codex-cli, then run `codex login`';
|
|
19
19
|
authHint = 'Run `codex login` to authenticate';
|
|
20
|
-
extraRateLimitPatterns = ['usage limit', 'insufficient_quota'];
|
|
21
20
|
getCapabilities() {
|
|
22
21
|
return {
|
|
23
22
|
name: 'Codex',
|
package/dist/config.d.ts
CHANGED
|
@@ -7,7 +7,9 @@
|
|
|
7
7
|
* - Lazy, cached load with mtime-based hot reload. `getConfig()` returns the
|
|
8
8
|
* cached config or re-reads when the file changed on disk.
|
|
9
9
|
* - Missing file → defaults in memory (no write). `initConfig()` (server
|
|
10
|
-
* start-up) creates
|
|
10
|
+
* start-up) creates an empty `{}` on first launch. It never writes the
|
|
11
|
+
* defaults: a default pinned on disk would shadow every later release's
|
|
12
|
+
* default for that user (a fixed default model would not reach them).
|
|
11
13
|
* - Invalid JSON → defaults, warn on stderr. A schema violation resets only
|
|
12
14
|
* the offending fields; the rest of that section and the others survive.
|
|
13
15
|
* - Partial user configs are deep-merged against defaults via Zod `.default()`.
|
|
@@ -349,7 +351,7 @@ export declare const DEFAULT_CONFIG: Config;
|
|
|
349
351
|
export declare function getConfigPath(): string;
|
|
350
352
|
export declare function getConfig(): Config;
|
|
351
353
|
/**
|
|
352
|
-
* Create
|
|
354
|
+
* Create an empty config file if none exists. Uses the
|
|
353
355
|
* exclusive `wx` flag for atomic creation — safe against TOCTOU races when
|
|
354
356
|
* multiple server instances start concurrently. Refreshes the cache so
|
|
355
357
|
* subsequent `getConfig()` calls see disk state.
|
package/dist/config.js
CHANGED
|
@@ -7,7 +7,9 @@
|
|
|
7
7
|
* - Lazy, cached load with mtime-based hot reload. `getConfig()` returns the
|
|
8
8
|
* cached config or re-reads when the file changed on disk.
|
|
9
9
|
* - Missing file → defaults in memory (no write). `initConfig()` (server
|
|
10
|
-
* start-up) creates
|
|
10
|
+
* start-up) creates an empty `{}` on first launch. It never writes the
|
|
11
|
+
* defaults: a default pinned on disk would shadow every later release's
|
|
12
|
+
* default for that user (a fixed default model would not reach them).
|
|
11
13
|
* - Invalid JSON → defaults, warn on stderr. A schema violation resets only
|
|
12
14
|
* the offending fields; the rest of that section and the others survive.
|
|
13
15
|
* - Partial user configs are deep-merged against defaults via Zod `.default()`.
|
|
@@ -146,7 +148,7 @@ export function getConfig() {
|
|
|
146
148
|
return _cached;
|
|
147
149
|
}
|
|
148
150
|
/**
|
|
149
|
-
* Create
|
|
151
|
+
* Create an empty config file if none exists. Uses the
|
|
150
152
|
* exclusive `wx` flag for atomic creation — safe against TOCTOU races when
|
|
151
153
|
* multiple server instances start concurrently. Refreshes the cache so
|
|
152
154
|
* subsequent `getConfig()` calls see disk state.
|
|
@@ -155,7 +157,7 @@ export function initConfig() {
|
|
|
155
157
|
const path = _configPath;
|
|
156
158
|
mkdirSync(dirname(path), { recursive: true });
|
|
157
159
|
try {
|
|
158
|
-
writeFileSync(path,
|
|
160
|
+
writeFileSync(path, '{}\n', { encoding: 'utf-8', flag: 'wx' });
|
|
159
161
|
_cached = DEFAULT_CONFIG;
|
|
160
162
|
_cachedMtimeMs = statSync(path).mtimeMs;
|
|
161
163
|
return { path, created: true };
|
package/dist/consult-prompt.js
CHANGED
|
@@ -30,7 +30,7 @@ export function buildConsultPrompt(request) {
|
|
|
30
30
|
sections.push([
|
|
31
31
|
'GROUND RULES — READ-ONLY:',
|
|
32
32
|
'- Do not create, modify, or delete files.',
|
|
33
|
-
'- Do not run
|
|
33
|
+
'- Do not run anything that changes state: no git commit/checkout/stash/reset/push, no installs, no formatters.',
|
|
34
34
|
'- Do not read files outside WORKING DIRECTORY.',
|
|
35
35
|
].join('\n'));
|
|
36
36
|
sections.push(`WORKING DIRECTORY: ${workingDir}`);
|
package/dist/handoff.d.ts
CHANGED
|
@@ -104,13 +104,9 @@ export declare function buildAdversarialHandoffPrompt(options: PromptOptions): s
|
|
|
104
104
|
/** Build the prompt for a ReviewRequest, selecting the pass from `reviewMode`. */
|
|
105
105
|
export declare function buildReviewPrompt(request: ReviewRequest): string;
|
|
106
106
|
/**
|
|
107
|
-
* Parse CC's structured brief into Handoff fields.
|
|
108
|
-
*
|
|
109
|
-
*
|
|
110
|
-
* (`SUMMARY:`, `UNCERTAINTIES (verify these):`, ...). Headers are matched
|
|
111
|
-
* case-sensitively at the start of a line so prose such as "Questions: none"
|
|
112
|
-
* inside a section cannot open a new one. Unstructured input falls back to
|
|
113
|
-
* `{ summary: ccOutput }`.
|
|
107
|
+
* Parse CC's structured brief into Handoff fields. A brief is in the colon
|
|
108
|
+
* form if it has a `SUMMARY:` line, else in the markdown form if it has a
|
|
109
|
+
* `## SUMMARY` heading, else unstructured: `{ summary: ccOutput }`.
|
|
114
110
|
*/
|
|
115
111
|
export declare function parseStructuredCcOutput(ccOutput: string): Pick<Handoff, 'summary'> & Partial<Handoff>;
|
|
116
112
|
/**
|
package/dist/handoff.js
CHANGED
|
@@ -189,7 +189,7 @@ export const REQUIRED_REVIEW_SECTIONS = ['Verdict', 'Findings'];
|
|
|
189
189
|
function renderTask(handoff) {
|
|
190
190
|
const kind = TASK_BY_OUTPUT_TYPE[handoff.outputType ?? 'implementation'];
|
|
191
191
|
const base = handoff.baseRef
|
|
192
|
-
? `\n\nThe
|
|
192
|
+
? `\n\nThe change is committed: \`git diff ${handoff.baseRef}...HEAD\` (\`--stat\` first, then the files). Anything \`git status\` shows as uncommitted is part of it too.`
|
|
193
193
|
: '';
|
|
194
194
|
return `## WHAT YOU ARE REVIEWING
|
|
195
195
|
|
|
@@ -209,7 +209,7 @@ function renderGroundRules() {
|
|
|
209
209
|
- Read-only. Do not create, modify, or delete files. Do not run anything that changes state: no git commit/checkout/stash/reset/push, no installs, no formatters, no test runs that write.
|
|
210
210
|
- Stay inside the working directory: do not read, list, or search paths outside it — no hunting parent or sibling directories for AGENTS.md or CLAUDE.md.
|
|
211
211
|
- No web access: do not fetch URLs or search the web. The code in the working directory is the evidence.
|
|
212
|
-
- Read what you need:
|
|
212
|
+
- Read what you need: search for the symbol first, then read the line range around it rather than a whole large file. Aim for about 12 tool calls; go beyond that only to confirm a finding that would change the verdict.
|
|
213
213
|
- If the directory is a git repository, \`git status\`, \`git diff\`, \`git diff --cached\` and \`git log -3 --stat\` are the fastest way to find the change; when the brief names a base ref, \`git diff <base>...HEAD\` is the change. If it is not a repository, or the tree is clean and no base ref is given, work from PRIORITY FILES and the brief.
|
|
214
214
|
- Verify before you report. Open the file, quote the line. A finding without a location and evidence is not a finding.
|
|
215
215
|
- Stay in scope: the change and the code it touches. Report a pre-existing problem elsewhere only if the change activates it or the bar depends on it, and label it "pre-existing".
|
|
@@ -223,8 +223,8 @@ function renderUncertainties(handoff) {
|
|
|
223
223
|
// When the topic is just the question minus its punctuation, one line is enough.
|
|
224
224
|
const topicIsQuestion = u.question.startsWith(u.topic) && u.question.length - u.topic.length <= 1;
|
|
225
225
|
const lines = topicIsQuestion
|
|
226
|
-
? [`### ${i + 1}. ${u.question}${tag}`]
|
|
227
|
-
: [`### ${i + 1}. ${u.topic}${tag}`, `- Question: ${u.question}`];
|
|
226
|
+
? [`### U${i + 1}. ${u.question}${tag}`]
|
|
227
|
+
: [`### U${i + 1}. ${u.topic}${tag}`, `- Question: ${u.question}`];
|
|
228
228
|
if (u.ccAssumption)
|
|
229
229
|
lines.push(`- The agent assumed: ${u.ccAssumption}`);
|
|
230
230
|
if (u.relevantFiles && u.relevantFiles.length > 0)
|
|
@@ -241,7 +241,7 @@ function renderQuestions(handoff) {
|
|
|
241
241
|
if (!handoff.questions || handoff.questions.length === 0)
|
|
242
242
|
return null;
|
|
243
243
|
const items = handoff.questions.map((q, i) => {
|
|
244
|
-
const lines = [
|
|
244
|
+
const lines = [`Q${i + 1}. **${q.question}**`];
|
|
245
245
|
if (q.context)
|
|
246
246
|
lines.push(` Context: ${q.context}`);
|
|
247
247
|
if (q.ccGuess)
|
|
@@ -256,7 +256,7 @@ function renderDecisions(handoff, mode) {
|
|
|
256
256
|
if (!handoff.decisions || handoff.decisions.length === 0)
|
|
257
257
|
return null;
|
|
258
258
|
const items = handoff.decisions.map((d, i) => {
|
|
259
|
-
const lines = [
|
|
259
|
+
const lines = [`D${i + 1}. **${d.decision}**`];
|
|
260
260
|
if (d.rationale)
|
|
261
261
|
lines.push(` Rationale: ${d.rationale}`);
|
|
262
262
|
if (d.alternatives && d.alternatives.length > 0)
|
|
@@ -326,10 +326,10 @@ After them, at most 5 S3 findings, one line each: \`- [S3] <short title> — pat
|
|
|
326
326
|
Severity: S1 = blocks the bar (data loss, security, wrong results, crash on a common path). S2 = real bug or gap; ship only after fixing. S3 = worth fixing, not blocking.
|
|
327
327
|
|
|
328
328
|
## Answers
|
|
329
|
-
|
|
329
|
+
One line per uncertainty and question in the brief, each starting with its id: \`- U1: verified — <evidence>\`. Use \`verified\` / \`refuted\` / \`could not verify\`, plus the evidence in one or two sentences. Write \`None asked.\` if the brief had neither.
|
|
330
330
|
|
|
331
331
|
## Decisions
|
|
332
|
-
One line per decision in the brief:
|
|
332
|
+
One line per decision in the brief, each starting with its id: \`- D1: agree\`, or \`- D1: disagree — <better alternative and why>\`. Write \`None listed.\` if the brief listed none.`;
|
|
333
333
|
}
|
|
334
334
|
function joinSections(sections) {
|
|
335
335
|
return sections.filter((s) => typeof s === 'string' && s.length > 0).join('\n\n');
|
|
@@ -457,26 +457,20 @@ export function buildReviewPrompt(request) {
|
|
|
457
457
|
// =============================================================================
|
|
458
458
|
const KNOWN_HEADERS = ['SUMMARY', 'UNCERTAINTIES', 'QUESTIONS', 'DECISIONS', 'KNOWN GAPS', 'PRIORITY FILES'];
|
|
459
459
|
/**
|
|
460
|
-
*
|
|
461
|
-
*
|
|
462
|
-
*
|
|
463
|
-
*
|
|
464
|
-
* case-sensitively at the start of a line so prose such as "Questions: none"
|
|
465
|
-
* inside a section cannot open a new one. Unstructured input falls back to
|
|
466
|
-
* `{ summary: ccOutput }`.
|
|
460
|
+
* The slash command's form: `SUMMARY:`, `UNCERTAINTIES (verify these):`, ...
|
|
461
|
+
* Names are matched case-sensitively at the start of a line so prose such as
|
|
462
|
+
* "Questions: none" inside a section cannot open a new one. A markdown heading
|
|
463
|
+
* is ordinary text here, so a quoted `## SUMMARY` example stays where it is.
|
|
467
464
|
*/
|
|
468
|
-
|
|
469
|
-
if (!/^SUMMARY[^:\n]*:/m.test(ccOutput)) {
|
|
470
|
-
return { summary: ccOutput };
|
|
471
|
-
}
|
|
465
|
+
function splitColonBrief(ccOutput) {
|
|
472
466
|
const headerPattern = new RegExp(`^(${KNOWN_HEADERS.join('|')})[^:\\n]*:[ \\t]*`, 'gm');
|
|
473
467
|
const found = [];
|
|
474
468
|
let match;
|
|
475
469
|
while ((match = headerPattern.exec(ccOutput)) !== null) {
|
|
476
470
|
found.push({ name: match[1], start: match.index, contentStart: match.index + match[0].length });
|
|
477
471
|
}
|
|
478
|
-
if (found.
|
|
479
|
-
return
|
|
472
|
+
if (!found.some((header) => header.name === 'SUMMARY'))
|
|
473
|
+
return null;
|
|
480
474
|
const sections = new Map();
|
|
481
475
|
for (let i = 0; i < found.length; i++) {
|
|
482
476
|
const end = i + 1 < found.length ? found[i + 1].start : ccOutput.length;
|
|
@@ -485,33 +479,83 @@ export function parseStructuredCcOutput(ccOutput) {
|
|
|
485
479
|
if (!sections.has(found[i].name))
|
|
486
480
|
sections.set(found[i].name, body);
|
|
487
481
|
}
|
|
482
|
+
return { sections, lead: [ccOutput.slice(0, found[0].start).trim()], extra: [] };
|
|
483
|
+
}
|
|
484
|
+
/**
|
|
485
|
+
* The markdown form a third of real briefs use: `## SUMMARY`,
|
|
486
|
+
* `## KNOWN GAPS (do not report again)`. Every heading outside a code fence
|
|
487
|
+
* ends the section above it. A heading that is not one of the six, or repeats
|
|
488
|
+
* one, is kept with the summary instead of being glued onto the last list item
|
|
489
|
+
* of the section above, so nothing the agent wrote is lost.
|
|
490
|
+
*/
|
|
491
|
+
function splitMarkdownBrief(ccOutput) {
|
|
492
|
+
const fences = [...ccOutput.matchAll(/^```[\s\S]*?^```/gm)].map((m) => [m.index, m.index + m[0].length]);
|
|
493
|
+
const headings = [...ccOutput.matchAll(/^#{1,6}[ \t]+([^\n]*)$/gm)]
|
|
494
|
+
.filter((m) => !fences.some(([from, to]) => m.index > from && m.index < to));
|
|
495
|
+
const knownName = (text) => KNOWN_HEADERS.find((name) => new RegExp(`^${name}\\b`).test(text));
|
|
496
|
+
if (!headings.some((m) => knownName(m[1]) === 'SUMMARY'))
|
|
497
|
+
return null;
|
|
498
|
+
const sections = new Map();
|
|
499
|
+
const lead = [ccOutput.slice(0, headings[0].index).trim()];
|
|
500
|
+
const extra = [];
|
|
501
|
+
headings.forEach((heading, i) => {
|
|
502
|
+
const text = heading[1].trim();
|
|
503
|
+
const end = i + 1 < headings.length ? headings[i + 1].index : ccOutput.length;
|
|
504
|
+
const below = ccOutput.slice(heading.index + heading[0].length, end);
|
|
505
|
+
const name = knownName(text);
|
|
506
|
+
if (name && !sections.has(name)) {
|
|
507
|
+
// `## SUMMARY: did X` carries content on the heading line; `(…)` decoration is dropped.
|
|
508
|
+
const colon = text.indexOf(':');
|
|
509
|
+
sections.set(name, `${colon === -1 ? '' : text.slice(colon + 1)}\n${below}`.trim());
|
|
510
|
+
}
|
|
511
|
+
else {
|
|
512
|
+
(sections.has('SUMMARY') ? extra : lead).push(`${text}\n${below.trim()}`.trim());
|
|
513
|
+
}
|
|
514
|
+
});
|
|
515
|
+
return { sections, lead, extra };
|
|
516
|
+
}
|
|
517
|
+
/**
|
|
518
|
+
* Parse CC's structured brief into Handoff fields. A brief is in the colon
|
|
519
|
+
* form if it has a `SUMMARY:` line, else in the markdown form if it has a
|
|
520
|
+
* `## SUMMARY` heading, else unstructured: `{ summary: ccOutput }`.
|
|
521
|
+
*/
|
|
522
|
+
export function parseStructuredCcOutput(ccOutput) {
|
|
523
|
+
const brief = splitColonBrief(ccOutput) ?? splitMarkdownBrief(ccOutput);
|
|
524
|
+
if (!brief)
|
|
525
|
+
return { summary: ccOutput };
|
|
526
|
+
const { sections } = brief;
|
|
488
527
|
const result = { summary: ccOutput };
|
|
489
528
|
const rawSummary = sections.get('SUMMARY');
|
|
490
529
|
if (rawSummary && rawSummary.length > 0) {
|
|
491
530
|
const { summary, bar } = splitBar(rawSummary);
|
|
492
|
-
result.summary = summary.length > 0 ? summary : ccOutput;
|
|
531
|
+
result.summary = summary.length > 0 ? [...brief.lead, summary, ...brief.extra].filter(Boolean).join('\n\n') : ccOutput;
|
|
493
532
|
if (bar)
|
|
494
533
|
result.bar = bar;
|
|
495
534
|
}
|
|
496
|
-
const uncertainties =
|
|
535
|
+
const uncertainties = parseListOrProse(sections.get('UNCERTAINTIES') ?? '');
|
|
497
536
|
if (uncertainties.length > 0) {
|
|
498
537
|
result.uncertainties = uncertainties.map((item) => {
|
|
499
538
|
const { weight, text } = splitWeightTag(item);
|
|
500
539
|
return { topic: extractTopic(text), question: text, weight };
|
|
501
540
|
});
|
|
502
541
|
}
|
|
503
|
-
const questions =
|
|
542
|
+
const questions = parseListOrProse(sections.get('QUESTIONS') ?? '');
|
|
504
543
|
if (questions.length > 0) {
|
|
505
544
|
result.questions = questions.map((question) => ({ question }));
|
|
506
545
|
}
|
|
507
|
-
const decisions =
|
|
546
|
+
const decisions = parseListOrProse(sections.get('DECISIONS') ?? '');
|
|
508
547
|
if (decisions.length > 0) {
|
|
509
548
|
result.decisions = decisions.map((item) => splitRationale(item));
|
|
510
549
|
}
|
|
511
|
-
const gaps =
|
|
550
|
+
const gaps = parseListOrProse(sections.get('KNOWN GAPS') ?? '');
|
|
512
551
|
if (gaps.length > 0)
|
|
513
552
|
result.knownGaps = gaps;
|
|
514
|
-
const
|
|
553
|
+
const fileSection = sections.get('PRIORITY FILES') ?? '';
|
|
554
|
+
const fileItems = parseListItems(fileSection);
|
|
555
|
+
const files = fileItems.length > 0
|
|
556
|
+
? fileItems.flatMap(splitInlineFiles)
|
|
557
|
+
// No list at all: take what looks like a path from `a.ts, b.ts`, and nothing from a sentence.
|
|
558
|
+
: fileSection.split(/[,\n]/).map((part) => stripBackticks(part.trim())).filter((part) => part.length > 0 && !/\s/.test(part));
|
|
515
559
|
if (files.length > 0)
|
|
516
560
|
result.priorityFiles = files;
|
|
517
561
|
return result;
|
|
@@ -550,6 +594,17 @@ function splitRationale(item) {
|
|
|
550
594
|
function stripBackticks(s) {
|
|
551
595
|
return s.replace(/^`+|`+$/g, '').trim();
|
|
552
596
|
}
|
|
597
|
+
/**
|
|
598
|
+
* `src/a.ts, src/b.ts` in one list item is several files. An item whose
|
|
599
|
+
* pieces contain spaces is one annotated file (`src/a.ts — the parser, the
|
|
600
|
+
* tests`), and a single backtick-quoted path keeps its own commas.
|
|
601
|
+
*/
|
|
602
|
+
function splitInlineFiles(item) {
|
|
603
|
+
if (/^`[^`]*`$/.test(item))
|
|
604
|
+
return [stripBackticks(item)];
|
|
605
|
+
const parts = item.replace(/,\s*$/, '').split(/,\s+/).map(stripBackticks);
|
|
606
|
+
return parts.length > 1 && parts.every((part) => part.length > 0 && !/\s/.test(part)) ? parts : [stripBackticks(item)];
|
|
607
|
+
}
|
|
553
608
|
/**
|
|
554
609
|
* Short topic from an item — the first clause, up to 60 chars. Clause
|
|
555
610
|
* boundaries are punctuation followed by whitespace (or a trailing `?`/`.`),
|
|
@@ -585,6 +640,20 @@ function parseListItems(text) {
|
|
|
585
640
|
items.push(current.trim());
|
|
586
641
|
return items;
|
|
587
642
|
}
|
|
643
|
+
/**
|
|
644
|
+
* A section with no list markers at all was written as prose: keep it, one
|
|
645
|
+
* item per paragraph, rather than drop what the agent wrote. A paragraph that
|
|
646
|
+
* only says there is nothing ("None known.", "Nothing material.") is no item.
|
|
647
|
+
*/
|
|
648
|
+
function parseListOrProse(text) {
|
|
649
|
+
const items = parseListItems(text);
|
|
650
|
+
if (items.length > 0)
|
|
651
|
+
return items;
|
|
652
|
+
return text
|
|
653
|
+
.split(/\n\s*\n/)
|
|
654
|
+
.map((paragraph) => paragraph.replace(/\s*\n\s*/g, ' ').trim())
|
|
655
|
+
.filter((paragraph) => paragraph.length > 0 && !/^(none|nothing|n\/a)\b(?! of\b)/i.test(paragraph));
|
|
656
|
+
}
|
|
588
657
|
// =============================================================================
|
|
589
658
|
// HANDOFF FROM TOOL INPUTS
|
|
590
659
|
// =============================================================================
|
package/dist/integrity.d.ts
CHANGED
|
@@ -8,9 +8,18 @@
|
|
|
8
8
|
* silently trusted. Best-effort: outside a git repository there is nothing to
|
|
9
9
|
* compare and the check is skipped.
|
|
10
10
|
*/
|
|
11
|
-
/**
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
11
|
+
/**
|
|
12
|
+
* One string per `git status --porcelain` entry, each followed by a tab and
|
|
13
|
+
* the file's size and mtime; null when `dir` is not a git repository (or git
|
|
14
|
+
* is missing). Ignored files and `.git/` are outside what git status lists,
|
|
15
|
+
* so a write there is not seen.
|
|
16
|
+
*
|
|
17
|
+
* The status code alone cannot show a second edit: a file under review is
|
|
18
|
+
* already ` M` (or `??`) before the panel starts and still is after a reviewer
|
|
19
|
+
* rewrites it, and those are the files a reviewer is most likely to touch.
|
|
20
|
+
*/
|
|
21
|
+
export declare function snapshotWorkingTree(dir: string): string[] | null;
|
|
22
|
+
/** Paths whose status entry or content stamp differs between two snapshots (added, modified, deleted, renamed, edited again). */
|
|
23
|
+
export declare function changedPaths(before: string[] | null, after: string[] | null): string[];
|
|
15
24
|
/** Tool-result warning for a working tree that changed while reviewers ran. */
|
|
16
25
|
export declare function tamperWarning(paths: string[]): string;
|
package/dist/integrity.js
CHANGED
|
@@ -9,32 +9,67 @@
|
|
|
9
9
|
* compare and the check is skipped.
|
|
10
10
|
*/
|
|
11
11
|
import { execFileSync } from 'child_process';
|
|
12
|
-
|
|
12
|
+
import { lstatSync } from 'fs';
|
|
13
|
+
import { join } from 'path';
|
|
14
|
+
/**
|
|
15
|
+
* One string per `git status --porcelain` entry, each followed by a tab and
|
|
16
|
+
* the file's size and mtime; null when `dir` is not a git repository (or git
|
|
17
|
+
* is missing). Ignored files and `.git/` are outside what git status lists,
|
|
18
|
+
* so a write there is not seen.
|
|
19
|
+
*
|
|
20
|
+
* The status code alone cannot show a second edit: a file under review is
|
|
21
|
+
* already ` M` (or `??`) before the panel starts and still is after a reviewer
|
|
22
|
+
* rewrites it, and those are the files a reviewer is most likely to touch.
|
|
23
|
+
*/
|
|
13
24
|
export function snapshotWorkingTree(dir) {
|
|
14
25
|
try {
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
26
|
+
const git = (args) => execFileSync('git', ['-C', dir, ...args], { encoding: 'utf-8', timeout: 15_000, stdio: ['ignore', 'pipe', 'ignore'] });
|
|
27
|
+
// Porcelain paths are relative to the repository root, not to `dir`.
|
|
28
|
+
const root = git(['rev-parse', '--show-toplevel']).trim();
|
|
29
|
+
const entries = git(['status', '--porcelain', '-z', '--untracked-files=all']).split('\0');
|
|
30
|
+
const lines = [];
|
|
31
|
+
for (let i = 0; i < entries.length; i++) {
|
|
32
|
+
const entry = entries[i];
|
|
33
|
+
if (entry.length < 4)
|
|
34
|
+
continue;
|
|
35
|
+
// A rename or copy is followed by its source path as an entry of its own.
|
|
36
|
+
if ('RC'.includes(entry[0]) || 'RC'.includes(entry[1]))
|
|
37
|
+
i++;
|
|
38
|
+
lines.push(`${entry}\t${fileStamp(join(root, entry.slice(3)))}`);
|
|
39
|
+
}
|
|
40
|
+
return lines;
|
|
20
41
|
}
|
|
21
42
|
catch {
|
|
22
43
|
return null;
|
|
23
44
|
}
|
|
24
45
|
}
|
|
25
|
-
|
|
46
|
+
// ponytail: size+mtime, not a content hash. A rewrite with identical bytes is
|
|
47
|
+
// reported, and a same-size write that restores the old mtime (`touch -r`,
|
|
48
|
+
// `cp -p`) is missed. Hash the file here if either matters.
|
|
49
|
+
function fileStamp(path) {
|
|
50
|
+
try {
|
|
51
|
+
// lstat: a symlink's own size and mtime change when it is retargeted.
|
|
52
|
+
const stat = lstatSync(path);
|
|
53
|
+
return `${stat.size}:${stat.mtimeMs}`;
|
|
54
|
+
}
|
|
55
|
+
catch {
|
|
56
|
+
return 'gone';
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
/** Paths whose status entry or content stamp differs between two snapshots (added, modified, deleted, renamed, edited again). */
|
|
26
60
|
export function changedPaths(before, after) {
|
|
27
61
|
if (before === null || after === null)
|
|
28
62
|
return [];
|
|
29
|
-
const a = new Set(before
|
|
30
|
-
const b = new Set(after
|
|
63
|
+
const a = new Set(before);
|
|
64
|
+
const b = new Set(after);
|
|
65
|
+
const path = (line) => line.slice(3, line.lastIndexOf('\t'));
|
|
31
66
|
const changed = new Set();
|
|
32
67
|
for (const line of a)
|
|
33
68
|
if (!b.has(line))
|
|
34
|
-
changed.add(line
|
|
69
|
+
changed.add(path(line));
|
|
35
70
|
for (const line of b)
|
|
36
71
|
if (!a.has(line))
|
|
37
|
-
changed.add(line
|
|
72
|
+
changed.add(path(line));
|
|
38
73
|
return [...changed].sort();
|
|
39
74
|
}
|
|
40
75
|
/** Tool-result warning for a working tree that changed while reviewers ran. */
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@simonren/quorum",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.14.0",
|
|
4
4
|
"description": "MCP server for Claude Code — a quorum of AI models (Codex, Gemini, Claude Fable with fresh context) for standard + adversarial review and consultation, synthesized by Claude Code",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|