@bevel-software/platform-core-backend 0.25.0 → 0.26.0

package/dist/modules/workflow/agent-tools/change-request-read.tools.js

@@ -0,0 +1,582 @@
+import { ToolError } from '../../tool-helpers/tool.contract.js';
+import { toolDef } from '../../tool-helpers/tool-def.js';
+import { PER_PAGE_DEFAULT, PER_PAGE_MAX, fileIsReadable, isAuthor, matchesAuthor, pathsOf, maySeeChangeRequest, pageOf, pagingOf, statesFor, toCrComment, toCrDetail, toCrFile, toCrReviews, toCrSummary, toCrViewer, visibleBlockers, visibleComments, } from './change-request-read-shape.js';
+/**
+ * The five read tools over change requests, named and shaped after GitHub's
+ * pull-request API: `list_change_requests`, `get_change_request`,
+ * `list_change_request_files`, `list_change_request_reviews` and
+ * `list_change_request_comments`. The mapping lives in
+ * `change-request-read-shape.ts`; this file does the IO and the access
+ * filtering.
+ *
+ * They ANSWER in Hexis's own vocabulary, not GitHub's field names (Razvan's
+ * decision on the review of PR #347, 2026-10-02): every field shared with
+ * `open_change_request`'s summary takes that summary's name, and the rest follow
+ * its style, so an agent opens a change request and reads it back in one
+ * vocabulary. Their INPUTS keep GitHub's filter names, which the ticket pins.
+ * The shape module's header says what that changed, field by field.
+ *
+ * None of them writes anything — every handler is registered `write: false`,
+ * so a read-scoped connection key may call all five, and every service call
+ * below is a read.
+ *
+ * ## What the caller may see
+ *
+ * The app's own change-request routes serve the whole list and the whole
+ * detail to any signed-in viewer; only the file CONTENT routes gate per path
+ * (`canReadAtRef` at `origin/<base>`, with an unresolvable verdict as a
+ * denial). These tools apply that same content gate to the whole payload,
+ * because an agent's answer is the content: a file list, a reviewer's comment
+ * and a gate warning all name paths, and an agent hands what it reads to
+ * whoever it is talking to.
+ *
+ * So, per request:
+ *
+ *   - every path is resolved at `origin/<base>` — the target's access tree, the
+ *     one the request is asking to be judged against — in ONE batched lookup;
+ *   - BOTH names of a moved file are resolved, and a file is readable only if
+ *     both are: the diff of a move shows what was at the old path, so a file
+ *     moved out of a closed folder stays closed, however open its new home.
+ *     The LIST decides this over the same `touchedNodeFiles` pairs the detail
+ *     does — a list that judged the flat `touchedNodePaths` could not see a
+ *     move's old side, and advertised requests its own by-number tools
+ *     answered 404 for;
+ *   - files the caller may not read are left out and counted in
+ *     `withheldFiles`, never named (decision 2 on the ticket);
+ *   - comments on a withheld file, and gate blockers naming one, go the same
+ *     way, with their own counts; a REPLY goes when the comment it replies to
+ *     does, up the whole chain;
+ *   - `body` is the author's own description, with the generated
+ *     `## Affected owners` block cut off the end — see `authorsDescription`;
+ *   - a request with no readable file and no claim of authorship answers 404,
+ *     indistinguishable from a number that was never issued.
+ *
+ * ## Reading a request that is no longer open
+ *
+ * A MERGED request is read from the merge commit its row records: its branch is
+ * retired, but the commit holds exactly the change that landed, so its file list
+ * is recovered from there and filtered by access like an open request's (the
+ * 2026-10-02 decision). Nothing in that path touches the network — the commit is
+ * in the clone or it is not.
+ *
+ * A DECLINED request has no merge commit and no branch left to diff, so its file
+ * set cannot be resolved at all; it fails closed, and is therefore readable by
+ * its author alone. "We cannot tell what this request touched" is not "you may
+ * see it", and an empty path set is the same answer `scopeApplyFailures` already
+ * refuses to grant anything on. The same holds for any request whose file set
+ * does not resolve — an access tree that will not load at `origin/<base>`, or a
+ * clone that does not have the merge commit yet.
+ */
+export function registerChangeRequestReadTools(registry, router, toolAuth, toolHandler, accessControl, kb) {
+    /**
+     * Mount one read tool. Every one of them is keyed by a change-request number
+     * (or by nothing at all), never by a draft, so none declares the injected
+     * `branch` input — the clone a verdict is resolved in is a scratch clone of
+     * the one shared origin, not anybody's working branch.
+     */
+    const mount = (spec) => {
+        const path = `/api/agent/tools/${spec.name}`;
+        const def = toolDef({
+            name: spec.name,
+            description: spec.description,
+            path,
+            inputs: spec.inputs,
+            outputs: spec.outputs,
+            tags: ['workflow'],
+        });
+        registry.registerInternalTool(def);
+        registry.registerExternalTool(def);
+        router.post(path.slice('/api'.length), toolAuth, toolHandler(spec.handler, { write: false }));
+    };
+    /**
+     * A clone to resolve access verdicts in. All clones track the same origin and
+     * every verdict here is read at `origin/<base>`, so any existing one answers
+     * identically — reusing one avoids cloning a branch just to read a ref.
+     */
+    const repoGlobalWorkspaceId = async (ctx) => (await ctx.workspaceService.findAnyWorkspaceId()) ?? kb.defaultWorkspaceId();
+    /** A change-request number as the tools accept it. */
+    const numberArg = (args) => {
+        const n = args.number;
+        // A SAFE integer: JSON carries numbers a double cannot hold exactly, and
+        // one of those would reach the database rounded, or as an error the
+        // caller could not have predicted — not as the 400 a wrong number earns.
+        if (typeof n !== 'number' || !Number.isSafeInteger(n) || n <= 0) {
+            throw new ToolError('`number` is required and must be a positive integer.', 400);
+        }
+        return n;
+    };
+    /**
+     * Read verdicts for `paths` at `origin/<base>`, as a membership set of what
+     * the caller MAY read. A null answer (the ref or its `roles.yaml` does not
+     * resolve) withholds everything, which is the same reading the app's
+     * fork-point route gives it.
+     */
+    const readablePaths = async (ctx, workspaceId, base, paths) => {
+        if (paths.length === 0)
+            return new Set();
+        const verdicts = await accessControl.canReadBatchAtRef(workspaceId, `origin/${base}`, ctx.user.email, [...new Set(paths)]);
+        if (!verdicts)
+            return new Set();
+        return new Set([...verdicts].filter(([, allowed]) => allowed).map(([p]) => p));
+    };
+    const scopedDetail = async (ctx, number, opts) => {
+        const workspaceId = await repoGlobalWorkspaceId(ctx);
+        const detail = await ctx.workflowService.getChangeRequestDetail(number, {
+            workspaceId,
+            viewerEmail: ctx.user.email,
+            patches: opts.patches,
+        });
+        if (!detail)
+            throw notFound(number);
+        const viewerIsAuthor = isAuthor(detail, ctx.user.email);
+        // Comment paths join the batch: a comment may name a file the request no
+        // longer changes, and without a verdict of its own it would be withheld
+        // from a caller who can read it perfectly well.
+        const commentPaths = detail.comments.map((c) => c.path).filter((p) => !!p);
+        // BOTH names of every file: a move is judged on its old path as well as
+        // its new one, because the diff of a move shows what was at the old one.
+        const readable = await readablePaths(ctx, workspaceId, detail.base, [
+            ...detail.files.flatMap(pathsOf),
+            ...commentPaths,
+        ]);
+        const mayRead = (path) => readable.has(path);
+        const readableFiles = detail.files.filter((f) => fileIsReadable(f, mayRead));
+        if (!maySeeChangeRequest({ readableFiles: readableFiles.length, isAuthor: viewerIsAuthor })) {
+            throw notFound(number);
+        }
+        // Every name a withheld file goes by, so a gate warning quoting either
+        // spelling is caught by the blocker filter — and so `mayShow` catches
+        // whichever spelling an approval or a comment happens to use.
+        const withheldFilePaths = detail.files
+            .filter((f) => !fileIsReadable(f, mayRead))
+            .flatMap(pathsOf);
+        const withheldNames = new Set(withheldFilePaths);
+        return {
+            detail,
+            mayRead,
+            mayShow: (path) => mayRead(path) && !withheldNames.has(path),
+            readableFiles,
+            withheldFilePaths,
+            withheldFileCount: detail.files.length - readableFiles.length,
+            viewerIsAuthor,
+        };
+    };
+    /**
+     * The same answer for a number that was never issued and for one the caller
+     * may not see — requirement 7. Says nothing a probe could tell apart.
+     */
+    const notFound = (number) => new ToolError(`Change request #${number} not found.`, 404);
+    /**
+     * The changed files of a SUMMARY, as the pairs a read gate decides over.
+     *
+     * Absent `touchedNodeFiles` means no summary builder filled it, and that is
+     * answered with no files rather than by falling back to `touchedNodePaths`:
+     * the fallback cannot pair a move, which is the whole reason this field
+     * exists, and a silent one would restore the list-versus-detail disagreement
+     * the next time a summary reached here from somewhere new. No files means
+     * nothing proven, which means author-only — the same fail-closed reading an
+     * empty path set already gets.
+     */
+    const filesOf = (cr) => cr.touchedNodeFiles ?? [];
+    /** `approvals` is one entry per file, same order; index it by path. */
+    const approvalsByPath = (detail) => new Map(detail.approvals.map((a) => [a.path, a]));
+    // ── Shared output sub-schemas ─────────────────────────────────────────────
+    const userSchema = {
+        type: 'object',
+        properties: {
+            login: { type: 'string', description: 'Hash-derived login (`user-<12 hex>`); no raw address.' },
+            name: { type: 'string' },
+            email: { type: 'string', description: 'Set for comment authors and approvers only.' },
+        },
+        required: ['login'],
+    };
+    const changeRequestSchema = {
+        type: 'object',
+        properties: {
+            url: { type: 'string', description: 'Link a person can open. First field: hand this to the user.' },
+            urlNote: { type: 'string', description: 'Present only when `url` is relative.' },
+            number: { type: 'integer' },
+            title: { type: 'string' },
+            state: { type: 'string', enum: ['open', 'merged', 'closed'], description: "Hexis's own state: `merged` is applied, `closed` declined." },
+            author: userSchema,
+            sourceBranch: { type: 'string', description: 'The branch the change comes from.' },
+            targetBranch: { type: 'string', description: 'The branch it would be applied to.' },
+            createdAt: { type: 'string', description: 'ISO timestamp.' },
+            updatedAt: { type: 'string', description: 'ISO timestamp — the close time of a closed request, else the creation time.' },
+            changedFiles: { type: 'integer', description: 'How many of its files YOU may read.' },
+            withheldFiles: { type: 'integer', description: 'How many of its files you may not read. Never named.' },
+            lastApplyFailure: {
+                type: 'object',
+                description: 'Present while an open request carries the refusal its last Apply met: `reason` in the gate\'s or git\'s ' +
+                    'words when you may read every file of the request, else a line saying the reason is withheld; ' +
+                    '`conflicts` when git refused on conflicts with the target; `at` an ISO timestamp.',
+                properties: {
+                    reason: { type: 'string' },
+                    conflicts: { type: 'boolean' },
+                    at: { type: 'string' },
+                },
+                required: ['reason', 'conflicts', 'at'],
+            },
+        },
+        required: ['url', 'number', 'title', 'state', 'author', 'sourceBranch', 'targetBranch', 'createdAt', 'updatedAt', 'changedFiles', 'withheldFiles'],
+    };
+    const pagingOutputs = {
+        totalCount: { type: 'integer', description: 'Entries you may read, across all pages.' },
+        page: { type: 'integer' },
+        perPage: { type: 'integer' },
+        hasNextPage: { type: 'boolean', description: 'True when a further page exists.' },
+    };
+    const pagingRequired = ['totalCount', 'page', 'perPage', 'hasNextPage'];
+    const pagingInputs = {
+        per_page: { type: 'integer', minimum: 1, maximum: PER_PAGE_MAX, description: `Entries per page (default ${PER_PAGE_DEFAULT}, at most ${PER_PAGE_MAX}).` },
+        page: { type: 'integer', minimum: 1, description: 'Page number, from 1.' },
+    };
+    // ── list_change_requests ──────────────────────────────────────────────────
+    mount({
+        name: 'list_change_requests',
+        description: 'List change requests (GitHub: list pull requests), newest first. Filter by `state` ' +
+            '(`open`, the default, `closed` — which covers applied and declined alike — or `all`), ' +
+            '`head` (source branch), `base` (target branch) and `author` (an email or a `login`). ' +
+            "Each answers in Hexis's own words: `url`, `number`, `title`, `state` (`open`, `merged` or " +
+            '`closed`), `sourceBranch`, `targetBranch`. Read-only, and limited to what you may read: a ' +
+            'request whose files are all closed to you is not listed unless you opened it, and ' +
+            '`withheldFiles` counts the ones left out of each.',
+        inputs: {
+            type: 'object',
+            properties: {
+                state: { type: 'string', enum: ['open', 'closed', 'all'], description: 'Default `open`. `closed` covers applied and declined alike; the answer says which.' },
+                head: { type: 'string', description: 'Source branch — list only requests coming FROM it.' },
+                base: { type: 'string', description: 'Target branch — list only requests going INTO it.' },
+                author: { type: 'string', description: "The author's email, or their `author.login`." },
+                ...pagingInputs,
+            },
+            additionalProperties: false,
+        },
+        outputs: {
+            type: 'object',
+            properties: {
+                changeRequests: { type: 'array', items: changeRequestSchema },
+                ...pagingOutputs,
+            },
+            required: ['changeRequests', ...pagingRequired],
+        },
+        handler: async (args, ctx) => {
+            const state = args.state === 'closed' || args.state === 'all' ? args.state : 'open';
+            const head = typeof args.head === 'string' ? args.head : undefined;
+            const base = typeof args.base === 'string' ? args.base : undefined;
+            const author = typeof args.author === 'string' ? args.author : undefined;
+            const { perPage, page } = pagingOf(args);
+            // The one clone every answer here is read in, resolved ONCE and handed
+            // to the listing too: the summaries' file lists are built in it, and
+            // the by-number tools read the same request in the same clone, so the
+            // list cannot hide a request the detail would serve — or the reverse —
+            // for want of a workspace the other path fell back to.
+            const workspaceId = await repoGlobalWorkspaceId(ctx);
+            const all = await ctx.workflowService.listChangeRequestsByState(statesFor(state), { workspaceId });
+            const matching = all.filter((cr) => (head === undefined || cr.branch === head) &&
+                (base === undefined || cr.base === base) &&
+                (author === undefined || matchesAuthor(cr, author)));
+            // One access lookup per distinct target branch, not per request: the
+            // access tree is read at `origin/<base>`, and a list is usually a dozen
+            // requests into the same two or three targets.
+            //
+            // Over `touchedNodeFiles`, NOT `touchedNodePaths`. The flat list reports a
+            // move under its new name alone, so a file moved out of a folder this
+            // caller cannot open looked readable here while the detail — which pairs
+            // the two names — refused it: the list advertised a change request that
+            // all four by-number tools answered 404 for, and counted its withheld
+            // file as zero. One notion of a readable file, shared with the detail
+            // through the same `fileIsReadable`, is what stops the two disagreeing.
+            const byBase = new Map();
+            for (const cr of matching) {
+                const bucket = byBase.get(cr.base) ?? [];
+                bucket.push(...filesOf(cr).flatMap(pathsOf));
+                byBase.set(cr.base, bucket);
+            }
+            const readableByBase = new Map();
+            await Promise.all([...byBase].map(async ([baseRef, paths]) => {
+                readableByBase.set(baseRef, await readablePaths(ctx, workspaceId, baseRef, paths));
+            }));
+            const visible = [];
+            for (const cr of matching) {
+                const readable = readableByBase.get(cr.base) ?? new Set();
+                const mayRead = (path) => readable.has(path);
+                const files = filesOf(cr);
+                const readableCount = files.filter((f) => fileIsReadable(f, mayRead)).length;
+                const mine = isAuthor(cr, ctx.user.email);
+                if (!maySeeChangeRequest({ readableFiles: readableCount, isAuthor: mine }))
+                    continue;
+                visible.push(toCrSummary(cr, {
+                    readable: readableCount,
+                    // One per withheld FILE, whatever its move names it.
+                    withheld: files.length - readableCount,
+                }));
+            }
+            // Paged AFTER the filter, so a page's length says nothing about what was
+            // withheld — the counts do that.
+            const { items, ...paging } = pageOf(visible, perPage, page);
+            return { changeRequests: items, ...paging };
+        },
+    });
+    // ── get_change_request ────────────────────────────────────────────────────
+    mount({
+        name: 'get_change_request',
+        description: 'Read one change request by `number` (GitHub: get a pull request) — its `url`, `title`, ' +
+            '`body` (what the author wrote, without the generated owners block Hexis appends), ' +
+            '`state`, `sourceBranch`, `targetBranch`, whether it is `mergeable`, the ' +
+            '`mergeBlockedReasons` holding it up, and a `viewer` block saying whether YOU may approve ' +
+            'or apply it. The same field names `open_change_request` answers in. Read-only. Answers ' +
+            '404 both for a number that does not exist and for a request you may not see.',
+        inputs: {
+            type: 'object',
+            properties: { number: { type: 'integer', minimum: 1, description: 'Change request number.' } },
+            required: ['number'],
+            additionalProperties: false,
+        },
+        outputs: {
+            type: 'object',
+            properties: {
+                ...changeRequestSchema.properties,
+                body: { type: 'string', description: "What the AUTHOR wrote. The generated `## Affected owners` block Hexis appends — which names every changed path — is cut off the end; read who must approve each file from `list_change_request_files`." },
+                headSha: { type: 'string', description: 'The source commit this answer describes. Absent when no commit could be resolved.' },
+                baseSha: { type: 'string', description: 'The target commit it is read against. Absent when no commit could be resolved.' },
+                mergeable: { type: 'boolean', description: "Hexis's merge gate, which also waits on the per-file approvals. May be false while `mergeBlockedReasons` is empty, if a blocker names a file you may not read." },
+                mergeBlockedReasons: { type: 'array', items: { type: 'string' }, description: 'Why it cannot be applied yet, in the gate\'s own words. Blockers naming a file you may not read are left out.' },
+                withheldMergeBlockedReasons: { type: 'integer', description: 'How many blockers were left out because they name a file you may not read.' },
+                viewer: {
+                    type: 'object',
+                    description: 'What YOU, specifically, may do with this request.',
+                    properties: {
+                        mayApprove: { type: 'boolean', description: 'Whether you may approve at least one of the files you are shown. False on any request that is not open: approvals are given while it is.' },
+                        mayMerge: { type: 'boolean', description: 'Whether an Apply by you would be accepted right now.' },
+                        isAuthor: { type: 'boolean', description: 'Whether you opened it (your agent counts as you).' },
+                    },
+                    required: ['mayApprove', 'mayMerge', 'isAuthor'],
+                },
+            },
+            required: [
+                ...changeRequestSchema.required,
+                'body',
+                'mergeable',
+                'mergeBlockedReasons',
+                'withheldMergeBlockedReasons',
+                'viewer',
+            ],
+        },
+        handler: async (args, ctx) => {
+            const number = numberArg(args);
+            const scoped = await scopedDetail(ctx, number, { patches: false });
+            const { detail, readableFiles, withheldFilePaths, withheldFileCount, viewerIsAuthor } = scoped;
+            // Unwrapped, as `open_change_request` answers since #349: `url` is the
+            // first field of the answer itself, so a truncation cannot take it.
+            return toCrDetail(detail, { readable: readableFiles.length, withheld: withheldFileCount }, visibleBlockers(detail.mergeBlockedReasons, withheldFilePaths), toCrViewer(detail, viewerIsAuthor, 
+            // `mayApprove` over the approvals of the SHOWN files alone: an
+            // approval keyed on a withheld file must not answer for it.
+            detail.approvals.filter((a) => scoped.mayShow(a.path))));
+        },
+    });
+    // ── list_change_request_files ─────────────────────────────────────────────
+    mount({
+        name: 'list_change_request_files',
+        description: "List a change request's changed files (GitHub: list pull request files). Each answers " +
+            '`path`, `change` (`added`, `changed`, `deleted` or `moved`, a moved one with its ' +
+            '`previousPath`), `additions` and `deletions` — the same words ' +
+            '`open_change_request` uses — plus who must approve it (`requiredApprovers`) and who has ' +
+            '(`approvedBy`). No patch is returned unless you ask with `include: ["patches"]`. ' +
+            'Read-only. Files you may not read are left out and counted in `withheldFiles`, never named.',
+        inputs: {
+            type: 'object',
+            properties: {
+                number: { type: 'integer', minimum: 1, description: 'Change request number.' },
+                include: {
+                    type: 'array',
+                    items: { type: 'string', enum: ['patches'] },
+                    description: 'Pass `["patches"]` to get each file\'s unified diff. Omit it and no patch is returned.',
+                },
+                ...pagingInputs,
+            },
+            required: ['number'],
+            additionalProperties: false,
+        },
+        outputs: {
+            type: 'object',
+            properties: {
+                files: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            path: { type: 'string', description: 'Repository-relative path.' },
+                            previousPath: { type: 'string', description: 'Where a `moved` file came from.' },
+                            change: { type: 'string', enum: ['added', 'changed', 'deleted', 'moved'], description: 'What happened to it.' },
+                            additions: { type: 'integer' },
+                            deletions: { type: 'integer' },
+                            patch: { type: 'string', description: 'Unified diff — only on `include: ["patches"]`, and never for a binary.' },
+                            isBinary: { type: 'boolean' },
+                            requiredApprovers: {
+                                type: 'object',
+                                description: 'Who must approve this file before the request can be applied.',
+                                properties: {
+                                    roles: { type: 'array', items: { type: 'string' } },
+                                    users: { type: 'array', items: userSchema },
+                                },
+                                required: ['roles', 'users'],
+                            },
+                            approversUnknown: { type: 'boolean', description: 'Present when the approver set could not be resolved — then an empty `requiredApprovers` means UNKNOWN, not nobody.' },
+                            approvedBy: {
+                                type: 'array',
+                                description: 'The approvals standing on this file.',
+                                items: {
+                                    type: 'object',
+                                    properties: {
+                                        user: userSchema,
+                                        approvedAt: { type: 'string', description: 'ISO timestamp.' },
+                                        stale: { type: 'boolean', description: 'True when a later push invalidated it.' },
+                                        selfApproval: { type: 'boolean', description: "True when the approver is the request's author." },
+                                    },
+                                    required: ['user', 'approvedAt', 'stale', 'selfApproval'],
+                                },
+                            },
+                            approved: { type: 'boolean', description: 'A current approval by an eligible approver stands.' },
+                            inMergeGate: { type: 'boolean', description: 'Whether the gate waits on this file at all.' },
+                            viewerMayApprove: { type: 'boolean', description: 'Whether YOU may approve it. False on any request that is not open: approvals are given while it is.' },
+                        },
+                        required: ['path', 'change', 'additions', 'deletions', 'isBinary', 'requiredApprovers', 'approvedBy', 'approved', 'inMergeGate', 'viewerMayApprove'],
+                    },
+                },
+                withheldFiles: { type: 'integer', description: 'How many of its files you may not read. Never named.' },
+                ...pagingOutputs,
+            },
+            required: ['files', 'withheldFiles', ...pagingRequired],
+        },
+        handler: async (args, ctx) => {
+            const include = Array.isArray(args.include) ? args.include : [];
+            const patches = include.includes('patches');
+            const number = numberArg(args);
+            const { perPage, page } = pagingOf(args);
+            const scoped = await scopedDetail(ctx, number, { patches });
+            const approvals = approvalsByPath(scoped.detail);
+            const { items, ...paging } = pageOf(scoped.readableFiles, perPage, page);
+            return {
+                files: items.map((f) => toCrFile(f, approvals.get(f.path), { patches, open: scoped.detail.state === 'open' })),
+                withheldFiles: scoped.withheldFileCount,
+                ...paging,
+            };
+        },
+    });
+    // ── list_change_request_reviews ───────────────────────────────────────────
+    mount({
+        name: 'list_change_request_reviews',
+        description: "List a change request's reviews (GitHub: list reviews): who approved what, and when. " +
+            'Hexis approves per FILE, so each entry names a `reviewer`, the `files` they approved and ' +
+            'the time of the latest of them; `stale` is true for approvals a later push invalidated. ' +
+            'Nothing records who DECLINED a request, so no entry reports one — a reviewer\'s objection ' +
+            'is a comment. Read-only: an entry keeps only the files you may read, and one with no ' +
+            'readable file at all is counted in `withheldReviews` rather than named.',
+        inputs: {
+            type: 'object',
+            properties: {
+                number: { type: 'integer', minimum: 1, description: 'Change request number.' },
+                ...pagingInputs,
+            },
+            required: ['number'],
+            additionalProperties: false,
+        },
+        outputs: {
+            type: 'object',
+            properties: {
+                reviews: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            id: { type: 'string', description: 'Stable within the request: the reviewer, and whether their approvals still stand.' },
+                            reviewer: userSchema,
+                            stale: { type: 'boolean', description: 'True when a later push invalidated the approvals gathered here.' },
+                            submittedAt: { type: 'string', description: 'ISO timestamp of the latest approval in this entry.' },
+                            files: { type: 'array', items: { type: 'string' }, description: 'The files this reviewer approved.' },
+                            withheldFiles: { type: 'integer', description: 'Further files of this review you may not read. Never named.' },
+                        },
+                        required: ['id', 'reviewer', 'stale', 'submittedAt', 'files', 'withheldFiles'],
+                    },
+                },
+                withheldReviews: { type: 'integer', description: 'Reviews every file of which you may not read. Neither the reviewer nor the files are named.' },
+                ...pagingOutputs,
+            },
+            required: ['reviews', 'withheldReviews', ...pagingRequired],
+        },
+        handler: async (args, ctx) => {
+            const number = numberArg(args);
+            const { perPage, page } = pagingOf(args);
+            const scoped = await scopedDetail(ctx, number, { patches: false });
+            // The read predicate goes IN rather than a pre-filtered list: a review is
+            // grouped over every file the reviewer approved, so that it can count the
+            // withheld ones under its own id and drop itself when they are all it has.
+            // `mayShow` keeps a withheld move out of the files a review names.
+            const { reviews, withheldReviews } = toCrReviews(scoped.detail.approvals, scoped.mayShow);
+            const { items, ...paging } = pageOf(reviews, perPage, page);
+            return { reviews: items, withheldReviews, ...paging };
+        },
+    });
+    // ── list_change_request_comments ──────────────────────────────────────────
+    mount({
+        name: 'list_change_request_comments',
+        description: "List a change request's comments (GitHub: list review comments and issue comments — Hexis " +
+            'keeps both in one thread). Each carries its `author`, `body`, `path` and `line` when it is ' +
+            'anchored to a file, `parentId` when it is a reply (the same id you pass to ' +
+            '`post_change_request_comment` to reply yourself), and its times. Read-only. A comment on a ' +
+            'file you may not read is left out and counted in `withheldComments`, and so is a reply to ' +
+            'a comment that was left out.',
+        inputs: {
+            type: 'object',
+            properties: {
+                number: { type: 'integer', minimum: 1, description: 'Change request number.' },
+                ...pagingInputs,
+            },
+            required: ['number'],
+            additionalProperties: false,
+        },
+        outputs: {
+            type: 'object',
+            properties: {
+                comments: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            id: { type: 'string', description: 'Pass as `parentId` to `post_change_request_comment` to reply.' },
+                            author: userSchema,
+                            body: { type: 'string' },
+                            path: { type: 'string', description: 'Repository-relative path, on a file-level or inline comment.' },
+                            line: { type: 'integer', description: 'Set on an inline comment.' },
+                            parentId: { type: 'string', description: 'The comment this one replies to.' },
+                            headSha: { type: 'string', description: 'The commit the comment was anchored to.' },
+                            createdAt: { type: 'string', description: 'ISO timestamp.' },
+                            updatedAt: { type: 'string', description: 'ISO timestamp; present once edited.' },
+                        },
+                        required: ['id', 'author', 'body', 'headSha', 'createdAt'],
+                    },
+                },
+                withheldComments: { type: 'integer', description: 'Comments on a file you may not read, and replies to those.' },
+                ...pagingOutputs,
+            },
+            required: ['comments', 'withheldComments', ...pagingRequired],
+        },
+        handler: async (args, ctx) => {
+            const number = numberArg(args);
+            const { perPage, page } = pagingOf(args);
+            const scoped = await scopedDetail(ctx, number, { patches: false });
+            // A comment with no path is about the request as a whole; one with a path
+            // is as readable as that path is NAMEABLE here. A reply inherits its
+            // parent's verdict up the chain — see `visibleComments`.
+            const { visible, withheld } = visibleComments(scoped.detail.comments, scoped.mayShow);
+            const { items, ...paging } = pageOf(visible, perPage, page);
+            return {
+                comments: items.map(toCrComment),
+                withheldComments: withheld,
+                ...paging,
+            };
+        },
+    });
+}
+//# sourceMappingURL=change-request-read.tools.js.map

package/dist/modules/workflow/agent-tools/change-request-read.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-request-read.tools.js","sourceRoot":"","sources":["../../../../src/modules/workflow/agent-tools/change-request-read.tools.ts"],"names":[],"mappings":"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"}

package/dist/modules/workflow/agent-tools/change-request-summary.d.ts

@@ -1,4 +1,4 @@
-import type { ChangeRequestDetail, ChangeRequestState } from '@bevel-software/platform-shared';
+import type { ChangeRequestDetail, ChangeRequestState, PrFileStatus } from '@bevel-software/platform-shared';
 /**
  * What `open_change_request` answers, and why it is not the detail the app's
  * dialog reads.
@@ -83,6 +83,17 @@ export interface ChangeRequestSummary {
     /** How many files the request changes in total, cut or not. */
     totalFiles: number;
 }
+/**
+ * A copy and a rename both carry `previousPath`, and the one thing a reader
+ * does with either is look at where the text came from — so both read `moved`.
+ * `unchanged` is a file the request lists without changing (git reports it on
+ * a mode-only change); `changed` is the honest word for it among these four.
+ *
+ * Exported because `list_change_request_files` answers `change` under this same
+ * name: an agent that opens a request and reads its files back must not be told
+ * `moved` by one tool and `renamed` by the other.
+ */
+export declare function changeKindOf(status: PrFileStatus | undefined): ChangeKind;
 /**
  * Shape the tool's answer out of the detail the service already returns. Pure:
  * the service and the app's routes are untouched, and the detail they serve is