@twistezo/ai-review-council 2.1.0 → 3.0.0

package/README.md

@@ -11,7 +11,7 @@ Docs:
 - [CHANGELOG.md](CHANGELOG.md)
 - [ARCHITECTURE.md](ARCHITECTURE.md)
 
-## Supported agents
+## Supported Agents
 
 | Agent   | CLI                      | Reviewer | Council | Models | Effort  | Plan                                |
 | ------- | ------------------------ | :------: | :-----: | ------ | ------- | ----------------------------------- |
@@ -38,17 +38,16 @@ CLIs must be available on `PATH` and logged in. Usage and availability depend on
 npm install -g @twistezo/ai-review-council
 
 # run with optional args
-ai-review-council --dir ~/projects/my-app --lang pl --scope codebase --reviewers 2
+ai-review-council --dir ~/projects/my-app --lang pl --scope codebase
 
 ```
 
-| Option            | Value                                  | Default |
-| ----------------- | -------------------------------------- | ------- |
-| `-d, --dir`       | folder inside a Git repository         | -       |
-| `-l, --lang`      | `en`, `pl`                             | `en`    |
-| `-s, --scope`     | `uncommitted`, `codebase`, commit hash | -       |
-| `-r, --reviewers` | 1 to 8                                 | -       |
-| `-t, --timeout`   | minutes per agent, 1 to 30             | `10`    |
+| Option          | Value                                  | Default |
+| --------------- | -------------------------------------- | ------- |
+| `-d, --dir`     | folder inside a Git repository         | -       |
+| `-l, --lang`    | `en`, `pl`                             | `en`    |
+| `-s, --scope`   | `uncommitted`, `codebase`, commit hash | -       |
+| `-t, --timeout` | minutes per agent, 1 to 30             | `10`    |
 
 ## Develop
 
@@ -59,3 +58,9 @@ npm test
 npm run typecheck
 npm run build # dist/
 ```
+
+## Dev-Docs
+
+[`dev-docs/`](dev-docs) is the domain memory for agents and people. Written in the [Matt Pocock skills](https://github.com/mattpocock/skills) style:
+
+- [`dev-docs/GLOSSARY.md`](dev-docs/GLOSSARY.md): Generated and kept up to date with the `domain-modeling` skill.

package/dist/cli-options.js

@@ -1,7 +1,6 @@
 import { parseArgs } from 'node:util';
-import { z } from 'zod';
 import { isCommitHashFormat } from './git/git-repository.js';
-import { defaultTimeoutMinutes, maxReviewers, maxTimeoutMinutes, reportLanguageSchema, reportLanguages, timeoutMinutesSchema, } from './domain/review-session.js';
+import { defaultTimeoutMinutes, maxTimeoutMinutes, reportLanguageSchema, reportLanguages, timeoutMinutesSchema, } from './domain/review-session.js';
 export const usage = `Usage: ai-review-council [options]
 
 Options:
@@ -9,7 +8,6 @@ Options:
   -l, --lang <code>    Report language: ${reportLanguages.join(', ')}; skips the language step
   -s, --scope <value>  uncommitted, codebase for the entire codebase, or a commit hash to review the changes after it;
                        skips the scope step
-  -r, --reviewers <n>  Number of reviewers, 1 to ${maxReviewers}; skips the count question
   -t, --timeout <min>  Minutes each agent may run before it fails (default ${defaultTimeoutMinutes}, max ${maxTimeoutMinutes})
   -h, --help           Show this help`;
 const readRawOptions = (args) => parseArgs({
@@ -18,7 +16,6 @@ const readRawOptions = (args) => parseArgs({
         dir: { type: 'string', short: 'd' },
         lang: { type: 'string', short: 'l' },
         scope: { type: 'string', short: 's' },
-        reviewers: { type: 'string', short: 'r' },
         timeout: { type: 'string', short: 't' },
         help: { type: 'boolean', short: 'h' },
     },
@@ -27,7 +24,6 @@ const readRawOptions = (args) => parseArgs({
 }).values;
 const uncommittedScope = 'uncommitted';
 const codebaseScope = 'codebase';
-const reviewerCountSchema = z.number().int().min(1).max(maxReviewers);
 const parseScope = (value) => {
     if (value === undefined) {
         return null;
@@ -60,10 +56,6 @@ export const parseCliOptions = (args) => {
     if (scope === 'invalid') {
         return { ok: false, error: 'The --scope option needs `uncommitted`, `codebase` or a commit hash (4 to 40 hexadecimal characters).' };
     }
-    const reviewerCount = values.reviewers === undefined ? null : reviewerCountSchema.safeParse(Number(values.reviewers));
-    if (reviewerCount !== null && !reviewerCount.success) {
-        return { ok: false, error: `The --reviewers option needs a whole number from 1 to ${maxReviewers}.` };
-    }
     const timeout = timeoutMinutesSchema.safeParse(values.timeout === undefined ? defaultTimeoutMinutes : Number(values.timeout));
     if (!timeout.success) {
         return { ok: false, error: `The --timeout option needs whole minutes from 1 to ${maxTimeoutMinutes}.` };
@@ -74,7 +66,6 @@ export const parseCliOptions = (args) => {
             directory: values.dir ?? null,
             language: language === null ? null : language.data,
             scope,
-            reviewerCount: reviewerCount === null ? null : reviewerCount.data,
             timeoutMinutes: timeout.data,
             showHelp: values.help ?? false,
         },

package/dist/cli.js

@@ -25,7 +25,6 @@ const main = async () => {
             language: parsed.options.language,
             directory: parsed.options.directory,
             scope: parsed.options.scope,
-            reviewerCount: parsed.options.reviewerCount,
         }, timeoutMinutes: parsed.options.timeoutMinutes, onFinish: (outcome) => {
             result.outcome = outcome;
         } }));

package/dist/domain/review-session.js

@@ -23,7 +23,7 @@ const agentConfigurationSchema = z
 })
     .refine((configuration) => configuration.provider !== 'copilot' ||
     (configuration.model === copilotModelId && configuration.effort === null), { message: 'Copilot supports only Auto without reasoning effort.' });
-export const maxReviewers = 8;
+export const maxReviewers = 10;
 const reviewerAssignmentSchema = z.object({
     configuration: agentConfigurationSchema,
     reviewType: reviewTypeSchema,

package/dist/execution/agent-events.js

@@ -173,7 +173,7 @@ export const parseCopilotLine = (line) => {
                     ? { kind: 'completed', text: null }
                     : {
                         kind: 'error',
-                        message: `Copilot exited with code ${exitCode ?? 'unknown'}. Check Copilot login and usage limits.`,
+                        message: `Copilot exited with code ${exitCode ?? 'unknown'}. Check Copilot usage limits.`,
                     },
             ];
         default:

package/dist/preflight/run-preflight.js

@@ -8,7 +8,7 @@ const checkGit = async (git) => {
             label: 'Git',
             state: 'failed',
             detail: '`git` was not found in PATH. Git is required.',
-            fix: 'Install Git (for example `xcode-select --install`), then run this app again.',
+            fix: null,
         }
         : { label: 'Git', state: 'ok', detail: version, fix: null };
 };
@@ -38,12 +38,11 @@ const checkProvider = async (adapter) => {
         if (models.length === 0) {
             return unavailable('The CLI returned no models.', 'Check your plan and CLI configuration.');
         }
-        const loginNote = status.loginChecked ? '' : '; login checked when the review starts';
         return {
             check: {
                 label: adapter.displayName,
                 state: 'ok',
-                detail: `${status.version ?? ''}, ${models.length} models${loginNote}`,
+                detail: `${status.version ?? ''}, ${models.length} models`,
                 fix: null,
             },
             models,
@@ -65,7 +64,7 @@ export const runPreflight = async ({ git, adapters, findMissingInstructionFiles,
         instructionsCheck.state === 'failed' ? 'Instruction files are missing.' : null,
         models.some((model) => isCouncilProvider(model.provider))
             ? null
-            : 'At least one of Codex or Claude must be installed and logged in.',
+            : 'At least one of Codex or Claude must be available.',
     ].filter((blocker) => blocker !== null);
     return {
         checks: [gitCheck, ...providerChecks.map((result) => result.check), instructionsCheck],

package/dist/providers/check-cli-status.js

@@ -9,7 +9,6 @@ export const checkCliStatus = async (run, check) => {
             version: null,
             problem: `\`${check.command}\` was not found in PATH.`,
             fix: check.installFix,
-            loginChecked: false,
         };
     }
     if (!isSuccessful(versionResult)) {
@@ -18,16 +17,15 @@ export const checkCliStatus = async (run, check) => {
             version: null,
             problem: `\`${check.command} ${versionArgs.join(' ')}\` failed: ${versionResult.stderr.trim()}`,
             fix: check.installFix,
-            loginChecked: false,
         };
     }
     const version = versionResult.stdout.trim();
     if (check.loginStatusArgs === null) {
-        return { provider: check.provider, version, problem: null, fix: null, loginChecked: false };
+        return { provider: check.provider, version, problem: null, fix: null };
     }
     const loginResult = await run(check.command, check.loginStatusArgs);
     if (!isSuccessful(loginResult)) {
-        return { provider: check.provider, version, problem: 'Not logged in.', fix: check.loginFix, loginChecked: true };
+        return { provider: check.provider, version, problem: 'Provider is unavailable.', fix: null };
     }
-    return { provider: check.provider, version, problem: null, fix: null, loginChecked: true };
+    return { provider: check.provider, version, problem: null, fix: null };
 };

package/dist/providers/claude-adapter.js

@@ -51,7 +51,6 @@ export const createClaudeAdapter = (run, startProcess) => ({
         command: 'claude',
         loginStatusArgs: ['auth', 'status'],
         installFix: 'Install Claude Code and make sure `claude` is on PATH, then run this app again.',
-        loginFix: 'Run `claude` in a terminal and sign in with `/login`, then run this app again.',
     }),
     // Catalog from the initialize control response; no user message is sent, so no model is called.
     // Runs in the temp directory so project settings of the current folder are not loaded.

package/dist/providers/codex-adapter.js

@@ -55,7 +55,6 @@ export const createCodexAdapter = (run, startProcess, client) => ({
         command: 'codex',
         loginStatusArgs: ['login', 'status'],
         installFix: 'Install the Codex CLI and make sure `codex` is on PATH, then run this app again.',
-        loginFix: 'Run `codex login` in a terminal, then run this app again.',
     }),
     // Catalog over the local App Server protocol; no prompt is sent to a model.
     listModels: async () => {

package/dist/providers/copilot-adapter.js

@@ -19,7 +19,6 @@ export const createCopilotAdapter = (run) => {
                 versionArgs,
                 loginStatusArgs: null,
                 installFix: 'Install Copilot CLI or GitHub CLI with `gh copilot` support, then run this app again.',
-                loginFix: command === 'gh' ? 'Run `gh copilot -- login`.' : 'Run `copilot login`.',
             });
         },
         // Free can use Auto even when the named-model catalog is empty.

package/dist/ui/agent-choice.js

@@ -33,5 +33,8 @@ export const choiceToConfiguration = (models, choice) => {
     const model = models[choice.modelIndex];
     return model === undefined ? null : toConfiguration(model, choice.effort);
 };
-// Keeps existing reviewers; new ones start from the fallback and cycle through the review types.
-export const resizeReviewers = (reviewers, count, fallback) => Array.from({ length: count }, (_, index) => reviewers[index] ?? { configuration: fallback, reviewType: reviewTypes[index % reviewTypes.length] ?? 'code' });
+// The reviewer at a zero-based position cycles through the review types.
+export const newReviewer = (configuration, position) => ({
+    configuration,
+    reviewType: reviewTypes[position % reviewTypes.length] ?? 'code',
+});

package/dist/ui/app.js

@@ -28,7 +28,7 @@ const buildSessionDraft = (state, timeoutMinutes) => {
         },
         scope: state.scope,
         council: state.council,
-        reviewers: state.reviewers,
+        reviewers: state.reviewers.accepted,
         prompt: state.prompt,
         timeoutMinutes,
     });
@@ -51,7 +51,7 @@ const answersBefore = (state) => {
         repository: isBefore('project') ? state.repository : null,
         scope: isBefore('scope') ? state.scope : null,
         council: isBefore('council') ? state.council : null,
-        reviewers: isBefore('reviewers') ? state.reviewers : null,
+        reviewers: isBefore('reviewers') ? state.reviewers.accepted : null,
         prompt: isBefore('prompt') ? state.prompt : null,
     };
 };
@@ -64,7 +64,6 @@ export const App = ({ title, services, presets, timeoutMinutes, onFinish }) => {
     const { exit } = useApp();
     const [state, setState] = useState({
         step: 'preflight',
-        isGoingBack: false,
         skipped: presetSkips(presets),
         checks: [],
         models: [],
@@ -73,7 +72,7 @@ export const App = ({ title, services, presets, timeoutMinutes, onFinish }) => {
         repository: null,
         scope: null,
         council: null,
-        reviewers: [],
+        reviewers: { accepted: [], draft: null },
         prompt: '',
         running: null,
     });
@@ -86,13 +85,12 @@ export const App = ({ title, services, presets, timeoutMinutes, onFinish }) => {
             ...previous,
             ...patch,
             step: nextStep(previous.step, previous.skipped),
-            isGoingBack: false,
         }));
     };
     const previous = previousStep(state.step, state.skipped);
     const back = previous === null
         ? undefined
-        : () => setState((current) => ({ ...current, step: previous, isGoingBack: true }));
+        : () => setState((current) => ({ ...current, step: previous }));
     // A preset step that was skipped is shown when its value turned out invalid.
     const isAutoSubmit = state.step === 'project' && state.skipped.includes('project');
     const renderStep = () => {
@@ -108,7 +106,7 @@ export const App = ({ title, services, presets, timeoutMinutes, onFinish }) => {
             case 'council':
                 return (_jsx(CouncilStep, { models: state.models.filter((model) => isCouncilProvider(model.provider)), value: state.council, onSubmit: (council) => complete({ council }), onBack: back }));
             case 'reviewers':
-                return (_jsx(ReviewersStep, { models: state.models, value: state.reviewers, resumeAtLast: state.isGoingBack, presetCount: presets.reviewerCount, onSubmit: (reviewers) => complete({ reviewers }), onBack: back }));
+                return (_jsx(ReviewersStep, { models: state.models, value: state.reviewers, onChange: (reviewers) => setState((current) => ({ ...current, reviewers })), onSubmit: (accepted) => complete({ reviewers: { accepted, draft: null } }), onBack: back }));
             case 'prompt':
                 return (_jsx(PromptStep, { value: state.prompt, readClipboard: services.readClipboard, onSubmit: (prompt) => complete({ prompt }), onBack: back }));
             case 'summary': {

package/dist/ui/describe-scope.js

@@ -1,4 +1,5 @@
-const describeRange = (scope) => {
+export const fileNoun = (count) => (count === 1 ? 'file' : 'files');
+export const describeScopeRange = (scope) => {
     const base = scope.base.hash.slice(0, 7);
     switch (scope.kind) {
         case 'uncommitted':
@@ -10,6 +11,8 @@ const describeRange = (scope) => {
     }
 };
 export const describeScope = (scope) => {
-    const excluded = scope.excludedFiles.length === 0 ? '' : `, ${scope.excludedFiles.length} likely secret file(s) excluded`;
-    return `${describeRange(scope)} (${scope.changedFiles.length} files${excluded})`;
+    const changedCount = scope.changedFiles.length;
+    const excludedCount = scope.excludedFiles.length;
+    const excluded = excludedCount === 0 ? '' : `, ${excludedCount} likely secret ${fileNoun(excludedCount)} excluded`;
+    return `${describeScopeRange(scope)} (${changedCount} ${fileNoun(changedCount)}${excluded})`;
 };

package/dist/ui/steps/prompt-step.js

@@ -5,5 +5,5 @@ import { MultilineInput } from '../components/multiline-input.js';
 import { StepFrame } from '../components/step-frame.js';
 export const PromptStep = ({ value, readClipboard, onSubmit, onBack }) => {
     const [prompt, setPrompt] = useState(value);
-    return (_jsxs(StepFrame, { title: "Review prompt", hints: "Enter new line \u00B7 Ctrl+D confirm \u00B7 Cmd+V paste", onBack: onBack, children: [_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { dimColor: true, children: "Review context, goals and skills. Shared by all agents." }), _jsx(Text, { dimColor: true, children: "Read-only local review. No live web access." })] }), _jsx(MultilineInput, { value: prompt, onChange: setPrompt, onSubmit: () => onSubmit(prompt.trim()), readClipboard: readClipboard, placeholder: "Type or paste (Ctrl+V) the review prompt" })] }));
+    return (_jsxs(StepFrame, { title: "Review prompt", hints: "Enter newline \u00B7 Ctrl+D confirm \u00B7 Cmd+V paste", onBack: onBack, children: [_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { dimColor: true, children: "Review context, goals and skills. Shared by all agents." }), _jsx(Text, { dimColor: true, children: "Read-only local review. No live web access." })] }), _jsx(MultilineInput, { value: prompt, onChange: setPrompt, onSubmit: () => onSubmit(prompt.trim()), readClipboard: readClipboard, placeholder: "Type or paste (Ctrl+V) the review prompt" })] }));
 };

package/dist/ui/steps/reviewers-step.js

@@ -1,11 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Box, Text } from 'ink';
+import { Box, Text, useInput } from 'ink';
 import { useState } from 'react';
 import { maxReviewers } from '../../domain/review-session.js';
-import { choiceFromConfiguration, choiceToConfiguration, resizeReviewers } from '../agent-choice.js';
+import { choiceFromConfiguration, choiceToConfiguration, newReviewer } from '../agent-choice.js';
 import { AgentPicker } from '../components/agent-picker.js';
 import { ReviewerList } from '../components/reviewer-list.js';
-import { SelectList } from '../components/select-list.js';
 import { StepFrame } from '../components/step-frame.js';
 import { theme } from '../theme.js';
 // Keyed by reviewer index so the column focus resets for each reviewer.
@@ -16,52 +15,45 @@ const ReviewerEditor = ({ models, reviewer, onChange, onSubmit }) => {
             if (configuration !== null) {
                 onChange({ ...reviewer, configuration });
             }
-        }, reviewType: { value: reviewer.reviewType, onChange: (reviewType) => onChange({ ...reviewer, reviewType }) }, onSubmit: onSubmit }));
+        }, reviewType: {
+            value: reviewer.reviewType,
+            onChange: (reviewType) => onChange({ ...reviewer, reviewType }),
+        }, onSubmit: onSubmit }));
 };
 // A new reviewer starts from a clean choice: the first model with its default effort.
-const resize = (models, reviewers, count) => {
-    const fresh = choiceToConfiguration(models, choiceFromConfiguration(models, null));
-    return fresh === null ? [...reviewers] : resizeReviewers(reviewers, count, fresh);
+const freshReviewer = (models, position) => {
+    const configuration = choiceToConfiguration(models, choiceFromConfiguration(models, null));
+    return configuration === null ? null : newReviewer(configuration, position);
 };
-export const ReviewersStep = ({ models, value, resumeAtLast, presetCount, onSubmit, onBack, }) => {
-    const [reviewers, setReviewers] = useState(() => presetCount === null ? [...value] : resize(models, value, presetCount));
-    // null shows the count question; a number edits that reviewer. `--reviewers` skips the question.
-    // Esc from the prompt opens the last reviewer, with every choice kept.
-    const [editing, setEditing] = useState(() => {
-        if (resumeAtLast && value.length > 0) {
-            return reviewers.length - 1;
+// The next draft, or null when the accepted reviewers reach the limit.
+const nextDraft = (models, accepted) => accepted.length < maxReviewers ? freshReviewer(models, accepted.length) : null;
+export const ReviewersStep = ({ models, value, onChange, onSubmit, onBack }) => {
+    // coming back from the prompt, every accepted reviewer stays and a new one opens
+    const [selection, setSelection] = useState(() => ({
+        accepted: value.accepted,
+        draft: value.draft ?? nextDraft(models, value.accepted),
+    }));
+    const { accepted, draft } = selection;
+    const isAtLimit = accepted.length === maxReviewers;
+    const updateSelection = (next) => {
+        setSelection(next);
+        onChange(next);
+    };
+    useInput((input, key) => {
+        if (key.ctrl && input === 'd' && accepted.length > 0) {
+            onSubmit(accepted);
         }
-        return presetCount === null ? null : 0;
     });
-    if (editing === null) {
-        return (_jsxs(StepFrame, { title: "Reviewers", hints: "\u2191\u2193 row \u00B7 Enter confirm", onBack: onBack, children: [_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { dimColor: true, children: "How many reviewers? Each works independently." }), _jsx(Text, { dimColor: true, children: "Mix providers and models to catch more." })] }), _jsx(SelectList, { items: Array.from({ length: maxReviewers }, (_, index) => ({
-                        key: String(index + 1),
-                        label: String(index + 1),
-                    })), initialKey: String(Math.max(1, value.length)), onSelect: (key) => {
-                        setReviewers((previous) => resize(models, previous, Number(key)));
-                        setEditing(0);
-                    } })] }));
-    }
-    const reviewer = reviewers[editing];
-    if (reviewer === undefined) {
-        return _jsx(Text, { color: theme.failure, children: "Reviewer not found." });
-    }
-    return (_jsxs(StepFrame, { title: `Reviewer ${editing + 1} of ${reviewers.length}`, hints: "\u2191\u2193 row \u00B7 \u2190\u2192 column \u00B7 Enter confirm", onBack: () => {
-            if (editing > 0) {
-                setEditing(editing - 1);
-            }
-            else if (presetCount === null) {
-                setEditing(null);
+    return (_jsxs(StepFrame, { title: isAtLimit ? 'Reviewers' : `Reviewer ${accepted.length + 1}`, hints: "\u2191\u2193 row \u00B7 \u2190\u2192 column \u00B7 Enter next \u00B7 Ctrl+D confirm", onBack: () => {
+            const last = accepted.at(-1);
+            if (last === undefined) {
+                onBack?.();
             }
             else {
-                onBack?.();
+                updateSelection({ accepted: accepted.slice(0, -1), draft: last });
             }
-        }, children: [editing > 0 && (_jsx(Box, { flexDirection: "column", marginBottom: 1, children: _jsx(ReviewerList, { reviewers: reviewers.slice(0, editing), dimmed: true }) })), _jsx(ReviewerEditor, { models: models, reviewer: reviewer, onChange: (next) => setReviewers((previous) => previous.map((item, index) => (index === editing ? next : item))), onSubmit: () => {
-                    if (editing + 1 < reviewers.length) {
-                        setEditing(editing + 1);
-                    }
-                    else {
-                        onSubmit(reviewers);
-                    }
-                } }, editing)] }));
+        }, children: [accepted.length > 0 && (_jsx(Box, { flexDirection: "column", marginBottom: 1, children: _jsx(ReviewerList, { reviewers: accepted, dimmed: true }) })), isAtLimit && (_jsxs(Text, { dimColor: true, children: ["Maximum ", maxReviewers, " reviewers. Press Ctrl+D to confirm them or Esc to edit the last one."] })), !isAtLimit && draft === null && _jsx(Text, { color: theme.failure, children: "No model is available for reviewers." }), draft !== null && (_jsx(ReviewerEditor, { models: models, reviewer: draft, onChange: (next) => updateSelection({ accepted, draft: next }), onSubmit: () => {
+                    const nextAccepted = [...accepted, draft];
+                    updateSelection({ accepted: nextAccepted, draft: nextDraft(models, nextAccepted) });
+                } }, accepted.length))] }));
 };

package/dist/ui/steps/run-screen.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { basename } from 'node:path';
 import { Box, Text } from 'ink';
 import { useEffect, useState } from 'react';
 import { waitingProgress } from '../../execution/agent-progress.js';
@@ -8,6 +9,7 @@ import { councilAgentId, numberReviewers, reviewerAgentId, runReview } from '../
 import { describeReviewResult } from '../../review/review-output.js';
 import { ReportResult } from '../components/report-result.js';
 import { RunProgress } from '../components/run-progress.js';
+import { describeScopeRange, fileNoun } from '../describe-scope.js';
 const agentColumns = (configuration) => ({
     provider: providerDisplayNames[configuration.provider],
     model: configuration.modelLabel,
@@ -52,7 +54,6 @@ export const RunScreen = ({ session, dependencies, writeClipboard, openReport, o
         runReview(session, dependencies, (agentId, change) => setRows((previous) => previous.map((row) => (row.id === agentId ? { ...row, progress: change(row.progress) } : row))), controller.signal).then((result) => setOutcome({ kind: 'finished', result }), (error) => setOutcome({ kind: 'failed', error: error instanceof Error ? error.message : String(error) }));
         return () => controller.abort();
     }, []);
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: outcome === null
-                    ? `Reviewing ${session.scope.changedFiles.length} file(s)`
-                    : `Reviewed ${session.scope.changedFiles.length} file(s)` }), _jsx(Box, { marginTop: 1, children: _jsx(RunProgress, { rows: rows }) }), outcome === null && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "Ctrl+C cancels all agents" }) })), outcome !== null && report !== null && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ReportResult, { report: report, writeClipboard: writeClipboard, openReport: openReport, onQuit: onQuit }) }))] }));
+    const changedCount = session.scope.changedFiles.length;
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: [outcome === null ? 'Reviewing' : 'Reviewed', " ", changedCount, " ", fileNoun(changedCount), " \u00B7", ' ', basename(session.repository.root), " \u00B7 ", describeScopeRange(session.scope)] }), _jsx(Box, { marginTop: 1, children: _jsx(RunProgress, { rows: rows }) }), outcome === null && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "Ctrl+C cancels all agents" }) })), outcome !== null && report !== null && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(ReportResult, { report: report, writeClipboard: writeClipboard, openReport: openReport, onQuit: onQuit }) }))] }));
 };

package/docs/council/council.md

@@ -2,14 +2,14 @@
 
 You verify independent reviews against the supplied change and produce one trustworthy, actionable report. Judge evidence, not reviewer agreement.
 
-- Verify every claim, merge duplicates and resolve contradictions. Separate confirmed findings, rejected claims with reasons and unresolved questions with missing evidence.
+- Verify every claim, merge duplicates and resolve contradictions. Separate confirmed findings, rejected claims with counterevidence and unresolved questions with missing evidence.
 - Preserve evidence, repository-relative locations, attribution, smallest fixes and coverage gaps. Include severity and confidence; prioritize by impact. Mark incidental new findings as council.
 - Return only a self-contained Markdown report in the session language. State when no issues were confirmed.
 - Use level-3 headings only for confirmed findings, most severe first; the application counts them and lists them in its preview.
 
 ## Report opening
 
-The application previews the title, the first paragraph and the finding headings. Open the report like this, translated, without an enclosing code fence:
+The application previews the title, the first paragraph and the finding headings. Include any failed reviews and material coverage gaps in the first paragraph. Open the report like this, translated, without an enclosing code fence:
 
 ```markdown
 # <one-line verdict>

package/docs/reviewer/code-review.md

@@ -1,3 +1,4 @@
 # Code review
 
 - Focus on behaviour, contracts and compatibility. Tie test gaps and structural concerns to concrete consequences.
+- When requirements are supplied, check for missing, partial or conflicting behaviour; cite the requirement behind each mismatch.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twistezo/ai-review-council",
-  "version": "2.1.0",
+  "version": "3.0.0",
   "description": "Terminal app that runs independent Codex, Claude Code and GitHub Copilot reviewers and merges their results",
   "license": "MIT",
   "keywords": [