@cat-factory/orchestration 0.316.0 → 0.317.1

package/dist/modules/guidedReview/GuidedReviewService.js

@@ -0,0 +1,543 @@
+import { generateText, stepCountIs } from 'ai';
+import { guidedReviewFailure, } from '@cat-factory/contracts';
+import { catFactoryObservability, GUIDED_REVIEW_AGENT_KIND, GUIDED_REVIEW_ANSWER_SYSTEM_PROMPT, GUIDED_REVIEW_DRAFTS_SYSTEM_PROMPT, GUIDED_REVIEW_OVERVIEW_SYSTEM_PROMPT, guidedReviewTools, renderGuidedReviewAnswerPrompt, renderGuidedReviewDraftsPrompt, renderGuidedReviewOverviewPrompt, } from '@cat-factory/agents';
+import { ConflictError, describeError, extractJson, ForbiddenError, getErrorMessage, NotFoundError, noopLogger, redactSecrets, resolveInlineScope, resolveScopedModelProvider, runBestEffort, UnavailableError, ValidationError, VcsCapabilityUnsupportedError, } from '@cat-factory/kernel';
+import { resolveInlineBlockModelRef } from '../../inlineBlockModel.js';
+import { anchorDrafts, coerceAnswer, coerceDraftProposals, coerceOverview, GUIDED_REVIEW_GENERATION_TIMEOUT_MS, GUIDED_REVIEW_LEASE_MS, GUIDED_REVIEW_MAX_STEPS, OVERVIEW_INLINE_PATCH_CHARS, partitionPatches, THREAD_HISTORY_CHARS, threadHistory, threadTitleFrom, } from './guidedReview.logic.js';
+import { PrExplorer } from './PrExplorer.js';
+/** A model failure the job settles onto its row, rather than a fault the driver should retry. */
+class JobFailure extends Error {
+    model;
+    failure;
+    constructor(failure, model) {
+        super(failure.detail ?? failure.reason);
+        this.model = model;
+        this.failure = settledFailure(failure.reason, failure.detail);
+    }
+}
+/**
+ * Guided PR review (docs/initiatives/guided-pr-review.md). Requests persist work and return at
+ * once; a durable driver calls {@link runJob} to produce the overview or an assistant message.
+ *
+ * `runJob` claims its row before any model call, so a duplicate delivery is a no-op. A model or
+ * VCS failure is settled onto the row with a reason the SPA translates. A repository failure
+ * propagates, so the driver retries; the claim lease lets the retry take the job back over.
+ */
+export class GuidedReviewService {
+    deps;
+    logger;
+    constructor(deps) {
+        this.deps = deps;
+        this.logger = deps.logger ?? noopLogger;
+    }
+    async open(workspaceId, owner, input) {
+        const context = await this.repoFor(workspaceId, input);
+        const provider = context.provider ?? input.provider ?? 'github';
+        const pr = await this.readPr(workspaceId, credentialUser(owner.id, owner.kind), context.repo, provider, input.prNumber);
+        const now = this.deps.clock.now();
+        const candidate = {
+            id: this.deps.idGenerator.next('grs'),
+            provider,
+            repoId: context.repoId,
+            owner: context.owner ?? input.owner,
+            repo: context.name ?? input.repo,
+            prNumber: input.prNumber,
+            prTitle: pr.title,
+            reviewedHeadSha: pr.headSha,
+            baseRef: pr.baseRef,
+            createdBy: owner.id,
+            createdByKind: owner.kind,
+            createdAt: now,
+            updatedAt: now,
+        };
+        const session = await this.deps.repository.openSession(workspaceId, candidate, this.deps.driver);
+        if (session.id === candidate.id) {
+            await this.notify(workspaceId, { sessionId: session.id, scope: 'session' });
+            await this.wake(workspaceId, { kind: 'overview', sessionId: session.id, generation: 1 });
+        }
+        return session;
+    }
+    /** Point the session at the PR's current head and regenerate the overview. Threads are kept. */
+    async refresh(workspaceId, userId, sessionId) {
+        const session = await this.ownedSession(workspaceId, userId, sessionId);
+        const context = await this.repoFor(workspaceId, session);
+        const pr = await this.readPr(workspaceId, sessionCredentialUser(session), context.repo, session.provider, session.prNumber);
+        const generation = session.overview.generation;
+        const moved = await this.deps.repository.restartOverview(workspaceId, sessionId, generation, { prTitle: pr.title, reviewedHeadSha: pr.headSha, baseRef: pr.baseRef }, this.deps.driver, this.deps.clock.now());
+        if (moved) {
+            await this.notify(workspaceId, { sessionId, scope: 'session' });
+            await this.wake(workspaceId, { kind: 'overview', sessionId, generation: generation + 1 });
+        }
+        return this.requireSession(workspaceId, sessionId);
+    }
+    listSessions(workspaceId, filter) {
+        return this.deps.repository.listSessions(workspaceId, filter);
+    }
+    /** One keyset page of sessions, newest created first. */
+    pageSessions(workspaceId, filter, page) {
+        return this.deps.repository.pageSessions(workspaceId, filter, page);
+    }
+    async getSession(workspaceId, sessionId) {
+        const session = await this.requireSession(workspaceId, sessionId);
+        const [threads, drafts] = await Promise.all([
+            this.deps.repository.listThreads(workspaceId, sessionId),
+            this.deps.repository.listDrafts(workspaceId, sessionId),
+        ]);
+        return { session, threads, drafts };
+    }
+    async deleteSession(workspaceId, userId, sessionId) {
+        await this.ownedSession(workspaceId, userId, sessionId);
+        await this.deps.repository.deleteSession(workspaceId, sessionId);
+        await this.notify(workspaceId, { sessionId, scope: 'deleted' });
+    }
+    /** Open a thread, asking its first question when one is given. */
+    async openThread(workspaceId, userId, sessionId, input) {
+        await this.ownedSession(workspaceId, userId, sessionId);
+        // Checked before the thread exists, so a refused question leaves no empty thread behind.
+        if (input.question)
+            questionText('answer', input.question.content);
+        const title = input.title?.trim() || (input.question ? threadTitleFrom(input.question.content) : '');
+        const now = this.deps.clock.now();
+        const thread = {
+            id: this.deps.idGenerator.next('grt'),
+            sessionId,
+            title,
+            createdBy: userId,
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.deps.repository.createThread(workspaceId, thread);
+        if (input.question) {
+            await this.exchange(workspaceId, thread, 'answer', input.question);
+        }
+        else {
+            await this.notify(workspaceId, { sessionId, scope: 'thread', threadId: thread.id });
+        }
+        return this.getThread(workspaceId, sessionId, thread.id);
+    }
+    async getThread(workspaceId, sessionId, threadId) {
+        const thread = await this.requireThread(workspaceId, sessionId, threadId);
+        const messages = await this.deps.repository.listMessages(workspaceId, threadId);
+        return { thread, messages };
+    }
+    /** Ask a question in a thread. Refused as `thread_busy` while the thread awaits an answer. */
+    async ask(workspaceId, userId, sessionId, threadId, input) {
+        const thread = await this.ownedThread(workspaceId, userId, sessionId, threadId);
+        return this.exchange(workspaceId, thread, 'answer', input);
+    }
+    /** Turn the thread's conclusions into comment drafts; empty `instructions` asks for all. */
+    async requestDrafts(workspaceId, userId, sessionId, threadId, instructions = '') {
+        const thread = await this.ownedThread(workspaceId, userId, sessionId, threadId);
+        return this.exchange(workspaceId, thread, 'comment-drafts', { content: instructions });
+    }
+    /** Drive one job. Idempotent: an already-claimed or settled job is a no-op. */
+    async runJob(workspaceId, job) {
+        if (job.kind === 'overview')
+            await this.runOverview(workspaceId, job.sessionId, job.generation);
+        else
+            await this.runMessage(workspaceId, job.messageId);
+    }
+    /**
+     * Settle a job its driver has given up on (repeated repository faults) as failed, taking over
+     * any claim, so the thread stops reading as busy. A settled job is left alone.
+     */
+    async abandonJob(workspaceId, job, detail) {
+        const now = this.deps.clock.now();
+        // A cutoff in the future takes over whatever claim the failed attempts left behind.
+        const takeover = now + 1;
+        const failure = settledFailure('generation_failed', detail);
+        if (job.kind === 'overview') {
+            const claimed = await this.deps.repository.claimOverview(workspaceId, job.sessionId, job.generation, takeover, now);
+            if (!claimed)
+                return;
+            const landed = await this.deps.repository.settleOverview(workspaceId, job.sessionId, job.generation, { status: 'failed', failure, model: null }, now, claimed);
+            if (landed)
+                await this.notify(workspaceId, { sessionId: job.sessionId, scope: 'session' });
+            return;
+        }
+        const message = await this.deps.repository.getMessage(workspaceId, job.messageId);
+        if (!message)
+            return;
+        const claimed = await this.deps.repository.claimMessage(workspaceId, job.messageId, takeover, now);
+        if (!claimed)
+            return;
+        const landed = await this.deps.repository.settleMessage(workspaceId, job.messageId, { status: 'failed', failure, model: null }, now, claimed);
+        if (!landed)
+            return;
+        await this.notify(workspaceId, {
+            sessionId: message.sessionId,
+            scope: 'thread',
+            threadId: message.threadId,
+        });
+    }
+    /** Re-wake this driver's jobs that no claim has settled within the lease. */
+    async redriveStale(limit = 50) {
+        const cutoff = this.deps.clock.now() - GUIDED_REVIEW_LEASE_MS;
+        const stale = await this.deps.repository.listStaleJobs(this.deps.driver, cutoff, limit);
+        for (const job of stale) {
+            const { workspaceId, ...rest } = job;
+            await this.wake(workspaceId, rest.kind === 'overview'
+                ? { kind: 'overview', sessionId: rest.sessionId, generation: rest.generation }
+                : { kind: 'message', messageId: rest.messageId });
+        }
+        return stale.length;
+    }
+    async exchange(workspaceId, thread, kind, input) {
+        const content = questionText(kind, input.content);
+        const result = await this.deps.repository.appendExchange(workspaceId, {
+            sessionId: thread.sessionId,
+            threadId: thread.id,
+            kind,
+            depth: input.depth ?? 'inline',
+            questionId: this.deps.idGenerator.next('grm'),
+            question: content,
+            placeholderId: this.deps.idGenerator.next('grm'),
+            at: this.deps.clock.now(),
+        }, this.deps.driver);
+        if (!result.ok) {
+            if (result.reason === 'thread_not_found') {
+                throw new NotFoundError('Guided review thread', thread.id);
+            }
+            throw new ConflictError('This thread is still waiting for its previous answer', 'thread_busy');
+        }
+        await this.notify(workspaceId, {
+            sessionId: thread.sessionId,
+            scope: 'thread',
+            threadId: thread.id,
+        });
+        await this.wake(workspaceId, { kind: 'message', messageId: result.placeholder.id });
+        return { question: result.question, placeholder: result.placeholder };
+    }
+    async runOverview(workspaceId, sessionId, generation) {
+        const now = this.deps.clock.now();
+        const claimed = await this.deps.repository.claimOverview(workspaceId, sessionId, generation, now - GUIDED_REVIEW_LEASE_MS, now);
+        if (!claimed)
+            return;
+        const session = await this.requireSession(workspaceId, sessionId);
+        let outcome;
+        try {
+            const pr = await this.bindPr(workspaceId, session);
+            const body = await this.asUser(workspaceId, sessionCredentialUser(session), () => pr.repo.getPullRequestBody ? pr.repo.getPullRequestBody(session.prNumber) : null);
+            const { inline, omitted } = partitionPatches(pr.files, OVERVIEW_INLINE_PATCH_CHARS);
+            const { text, model } = await this.generate(workspaceId, session, 'overview', {
+                system: GUIDED_REVIEW_OVERVIEW_SYSTEM_PROMPT,
+                prompt: renderGuidedReviewOverviewPrompt({
+                    pr: pr.header,
+                    body: body?.trim() ? body : null,
+                    files: pr.files,
+                    inlinePatches: inline,
+                    omittedPatchPaths: omitted,
+                }),
+                tools: guidedReviewTools(new PrExplorer(pr.repo, this.target(session), pr.files)),
+            });
+            const content = coerceOverview(extractJson(text), () => this.deps.idGenerator.next('grq'));
+            if (!content)
+                throw new JobFailure({ reason: 'unreadable_reply', detail: text }, model);
+            outcome = { status: 'complete', content, model };
+        }
+        catch (error) {
+            outcome = { status: 'failed', ...this.failureOf(error, workspaceId, sessionId) };
+        }
+        const landed = await this.deps.repository.settleOverview(workspaceId, sessionId, generation, outcome, this.deps.clock.now(), claimed);
+        if (landed)
+            await this.notify(workspaceId, { sessionId, scope: 'session' });
+    }
+    async runMessage(workspaceId, messageId) {
+        const message = await this.deps.repository.getMessage(workspaceId, messageId);
+        if (!message || message.role !== 'assistant')
+            return;
+        const now = this.deps.clock.now();
+        const claimed = await this.deps.repository.claimMessage(workspaceId, messageId, now - GUIDED_REVIEW_LEASE_MS, now);
+        if (!claimed)
+            return;
+        const [session, messages] = await Promise.all([
+            this.requireSession(workspaceId, message.sessionId),
+            this.deps.repository.listMessages(workspaceId, message.threadId),
+        ]);
+        const settledAt = () => this.deps.clock.now();
+        let landed = false;
+        let draftsLanded = false;
+        try {
+            if (message.depth === 'deep') {
+                throw new JobFailure({ reason: 'depth_unavailable', detail: null }, null);
+            }
+            const pr = await this.bindPr(workspaceId, session);
+            const thread = threadHistory(messages.filter((m) => m.seq < message.seq), THREAD_HISTORY_CHARS);
+            const promptInput = { pr: pr.header, overview: session.overview.content, ...thread };
+            const tools = guidedReviewTools(new PrExplorer(pr.repo, this.target(session), pr.files));
+            if (message.kind === 'answer') {
+                const { text, model } = await this.generate(workspaceId, session, 'answer', {
+                    system: GUIDED_REVIEW_ANSWER_SYSTEM_PROMPT,
+                    prompt: renderGuidedReviewAnswerPrompt(promptInput),
+                    tools,
+                });
+                const answer = coerceAnswer(extractJson(text));
+                if (!answer)
+                    throw new JobFailure({ reason: 'unreadable_reply', detail: text }, model);
+                landed = await this.deps.repository.settleMessage(workspaceId, messageId, { status: 'complete', ...answer, draftReport: null, model }, settledAt(), claimed);
+            }
+            else {
+                draftsLanded = landed = await this.settleDraftJob(workspaceId, session, {
+                    messageId,
+                    claimed,
+                    files: pr.files,
+                    promptInput,
+                    tools,
+                });
+            }
+        }
+        catch (error) {
+            const { failure, model } = this.failureOf(error, workspaceId, session.id);
+            landed = await this.deps.repository.settleMessage(workspaceId, messageId, { status: 'failed', failure, model }, settledAt(), claimed);
+        }
+        if (landed) {
+            await this.notify(workspaceId, {
+                sessionId: session.id,
+                scope: draftsLanded ? 'drafts' : 'thread',
+                threadId: message.threadId,
+            });
+        }
+    }
+    /** Produce a `comment-drafts` message's drafts and land them with it, atomically. */
+    async settleDraftJob(workspaceId, session, job) {
+        const { messageId, claimed, files, promptInput, tools } = job;
+        const { text, model } = await this.generate(workspaceId, session, 'drafts', {
+            system: GUIDED_REVIEW_DRAFTS_SYSTEM_PROMPT,
+            prompt: renderGuidedReviewDraftsPrompt(promptInput),
+            tools,
+        });
+        const raw = extractJson(text);
+        if (raw === null || typeof raw !== 'object') {
+            throw new JobFailure({ reason: 'unreadable_reply', detail: text }, model);
+        }
+        const { proposals, incomplete } = coerceDraftProposals(raw);
+        const { kept, report } = anchorDrafts(proposals, incomplete, files);
+        const drafts = kept.map((p) => ({
+            id: this.deps.idGenerator.next('grd'),
+            ...p,
+        }));
+        return this.deps.repository.settleDrafts(workspaceId, messageId, drafts, { status: 'complete', content: '', citations: [], draftReport: report, model }, this.deps.clock.now(), claimed);
+    }
+    /** Run one bounded tool loop under the session creator's model scope and budget. */
+    async generate(workspaceId, session, phase, call) {
+        if (await this.deps.isOverBudget?.(workspaceId)) {
+            throw new JobFailure({ reason: 'budget_exhausted', detail: null }, null);
+        }
+        const { modelProvider, ref } = await this.resolveModel(workspaceId, sessionCredentialUser(session));
+        const model = `${ref.provider}:${ref.model}`;
+        const maxSteps = GUIDED_REVIEW_MAX_STEPS[phase];
+        try {
+            // The tools read the VCS, so the whole loop runs under the creator's credential scope.
+            const result = await this.asUser(workspaceId, sessionCredentialUser(session), () => generateText({
+                model: modelProvider.resolve(ref),
+                system: call.system,
+                prompt: call.prompt,
+                tools: call.tools,
+                stopWhen: stepCountIs(maxSteps),
+                // The last step may not call a tool, so a loop that reaches the cap still ends on a reply.
+                prepareStep: ({ stepNumber }) => stepNumber >= maxSteps - 1 ? { toolChoice: 'none' } : {},
+                temperature: 0.2,
+                maxOutputTokens: 8_000,
+                abortSignal: AbortSignal.timeout(GUIDED_REVIEW_GENERATION_TIMEOUT_MS),
+                providerOptions: catFactoryObservability({
+                    agentKind: GUIDED_REVIEW_AGENT_KIND,
+                    workspaceId,
+                }),
+            }));
+            const text = result.text.trim();
+            if (!text)
+                throw new JobFailure({ reason: 'unreadable_reply', detail: null }, model);
+            return { text, model };
+        }
+        catch (error) {
+            if (error instanceof JobFailure)
+                throw error;
+            throw new JobFailure({ reason: 'generation_failed', detail: getErrorMessage(error) }, model);
+        }
+    }
+    /** The model under `userId`'s scope, or the workspace's when the session has no person. */
+    async resolveModel(workspaceId, userId) {
+        const scope = await resolveInlineScope(userId === null ? { kind: 'workspace', workspaceId } : { kind: 'user', workspaceId, userId });
+        const modelProvider = await resolveScopedModelProvider(scope, this.deps);
+        const ref = await resolveInlineBlockModelRef(this.deps, workspaceId, GUIDED_REVIEW_AGENT_KIND, {});
+        if (!modelProvider || !ref) {
+            throw new JobFailure({ reason: 'model_unavailable', detail: null }, null);
+        }
+        return { modelProvider, ref };
+    }
+    /** The PR as reviewed: its changed files at the session's head, bound for reading. */
+    async bindPr(workspaceId, session) {
+        let context;
+        try {
+            context = await this.repoFor(workspaceId, session);
+        }
+        catch (error) {
+            throw new JobFailure({ reason: 'repo_unavailable', detail: getErrorMessage(error) }, null);
+        }
+        const listChangedFiles = context.repo.listChangedFiles?.bind(context.repo);
+        const getPullRequest = context.repo.getPullRequest?.bind(context.repo);
+        if (!listChangedFiles || !getPullRequest) {
+            throw new JobFailure({ reason: 'repo_unavailable', detail: 'This VCS connection cannot read pull requests' }, null);
+        }
+        let files;
+        let currentHead;
+        try {
+            ;
+            [files, currentHead] = await this.asUser(workspaceId, sessionCredentialUser(session), async () => {
+                const listed = await listChangedFiles(session.prNumber);
+                // Read after the listing: a push between the two reads then shows up as a moved head.
+                const pr = await getPullRequest(session.prNumber);
+                if (!pr?.headSha)
+                    throw new Error(`Pull request #${session.prNumber} was not found`);
+                return [listed, pr.headSha];
+            });
+        }
+        catch (error) {
+            throw new JobFailure({ reason: 'repo_unavailable', detail: getErrorMessage(error) }, null);
+        }
+        // The host lists the files of the PR's CURRENT head. Past a push they no longer describe the
+        // commit the session reviews, so answering or anchoring drafts against them would mix commits.
+        if (currentHead !== session.reviewedHeadSha) {
+            throw new JobFailure({ reason: 'head_moved', detail: currentHead }, null);
+        }
+        return {
+            repo: context.repo,
+            files,
+            header: {
+                owner: session.owner,
+                repo: session.repo,
+                prNumber: session.prNumber,
+                title: session.prTitle,
+                headSha: session.reviewedHeadSha,
+                baseRef: session.baseRef,
+            },
+        };
+    }
+    async repoFor(workspaceId, coords) {
+        const resolve = this.deps.resolveRepoFilesForCoords;
+        if (!resolve) {
+            throw new UnavailableError('No source control integration is configured', 'vcs_not_configured');
+        }
+        const context = await resolve(workspaceId, {
+            owner: coords.owner,
+            repo: coords.repo,
+            ...(coords.provider ? { provider: coords.provider } : {}),
+        });
+        if (!context) {
+            throw new NotFoundError('Repository', `${coords.owner}/${coords.repo}`, {
+                reason: 'repo_not_linked',
+            });
+        }
+        return context;
+    }
+    async readPr(workspaceId, userId, repo, provider, prNumber) {
+        const getPullRequest = repo.getPullRequest?.bind(repo);
+        if (!getPullRequest || !repo.listChangedFiles) {
+            throw new VcsCapabilityUnsupportedError(provider, 'pull request reads');
+        }
+        const pr = await this.asUser(workspaceId, userId, () => getPullRequest(prNumber));
+        if (!pr || !pr.headSha || !pr.baseRef) {
+            throw new NotFoundError('Pull request', String(prNumber), { reason: 'pr_not_found' });
+        }
+        return { title: pr.title, headSha: pr.headSha, baseRef: pr.baseRef };
+    }
+    /**
+     * Run a VCS call under `userId`'s credential scope (the initiator-PAT policy applies), or
+     * attributed to nobody when the session has no person behind it.
+     */
+    asUser(workspaceId, userId, fn) {
+        const scope = this.deps.runInitiatorScope;
+        return scope ? scope({ workspaceId, initiatedBy: userId }, fn) : fn();
+    }
+    target(session) {
+        return { headSha: session.reviewedHeadSha, baseRef: session.baseRef };
+    }
+    /** Map a job's failure to what is settled on its row; anything unexpected is logged once. */
+    failureOf(error, workspaceId, sessionId) {
+        if (error instanceof JobFailure)
+            return { failure: error.failure, model: error.model };
+        this.logger.warn('guided review job failed unexpectedly', {
+            workspaceId,
+            sessionId,
+            ...describeError(error),
+        });
+        return {
+            failure: settledFailure('generation_failed', getErrorMessage(error)),
+            model: null,
+        };
+    }
+    async wake(workspaceId, job) {
+        const runner = this.deps.runner;
+        if (!runner)
+            return;
+        // Best-effort: the row is already committed, and a lost wake is re-driven by the sweeper.
+        await runBestEffort(this.logger, 'guidedReview.wake', () => runner.start(workspaceId, job), {
+            workspaceId,
+            job: job.kind,
+        });
+    }
+    async requireSession(workspaceId, sessionId) {
+        const session = await this.deps.repository.getSession(workspaceId, sessionId);
+        if (!session)
+            throw new NotFoundError('Guided review session', sessionId);
+        return session;
+    }
+    async ownedSession(workspaceId, userId, sessionId) {
+        const session = await this.requireSession(workspaceId, sessionId);
+        if (session.createdBy !== userId) {
+            throw new ForbiddenError('Only the reviewer who opened this guided review can change it', {
+                reason: 'not_session_owner',
+            });
+        }
+        return session;
+    }
+    /** A thread of `sessionId`; one belonging to another session is reported as absent. */
+    async requireThread(workspaceId, sessionId, threadId) {
+        const thread = await this.deps.repository.getThread(workspaceId, threadId);
+        if (!thread || thread.sessionId !== sessionId) {
+            throw new NotFoundError('Guided review thread', threadId);
+        }
+        return thread;
+    }
+    async ownedThread(workspaceId, userId, sessionId, threadId) {
+        const thread = await this.requireThread(workspaceId, sessionId, threadId);
+        await this.ownedSession(workspaceId, userId, sessionId);
+        return thread;
+    }
+    async notify(workspaceId, change) {
+        const events = this.deps.events;
+        if (!events?.guidedReviewChanged)
+            return;
+        // Best-effort: the write is committed, and a client re-reads on reconnect.
+        await runBestEffort(this.logger, 'guidedReview.notify', () => events.guidedReviewChanged(workspaceId, change), { workspaceId, sessionId: change.sessionId });
+    }
+}
+/** The text a question or drafting request carries; a question may not be empty. */
+function questionText(kind, content) {
+    const text = content.trim();
+    if (kind === 'answer' && !text) {
+        throw new ValidationError('A question cannot be empty', { reason: 'empty_question' });
+    }
+    return text;
+}
+/**
+ * A failure as stored on a row. The detail is raw model text or a provider error, so it is scrubbed
+ * of secrets and then cut to what the contract admits.
+ */
+function settledFailure(reason, detail) {
+    const scrubbed = detail === null ? '' : (redactSecrets(detail) ?? '').trim();
+    return guidedReviewFailure(reason, scrubbed || null);
+}
+/** The person whose credentials an owner's work runs under; null for an unbound API key. */
+function credentialUser(id, kind) {
+    switch (kind) {
+        case 'user':
+            return id;
+        case 'api-key':
+            return null;
+    }
+}
+function sessionCredentialUser(session) {
+    return credentialUser(session.createdBy, session.createdByKind);
+}
+//# sourceMappingURL=GuidedReviewService.js.map

package/dist/modules/guidedReview/GuidedReviewService.js.map

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

package/dist/modules/guidedReview/PrExplorer.d.ts

@@ -0,0 +1,41 @@
+import type { GuidedReviewExplorer, GuidedReviewFileRequest } from '@cat-factory/agents';
+import type { GitHubChangedFile, RepoFiles } from '@cat-factory/kernel';
+/** How much one job may read, and how much one read may return. */
+export interface PrExplorerLimits {
+    /** Tool reads per job; past it every tool says the budget is spent. */
+    maxReads: number;
+    /** Lines one `read_file` returns before it truncates and says where to resume. */
+    maxFileLines: number;
+    /** Characters one answer returns before it truncates. */
+    maxChars: number;
+}
+export declare const DEFAULT_PR_EXPLORER_LIMITS: PrExplorerLimits;
+export interface PrExplorerTarget {
+    headSha: string;
+    baseRef: string;
+}
+/**
+ * Reads one pull request for a guided-review model call, pinned to the reviewed head. Every
+ * answer is text the model reads directly: the content, or the sentence saying why there is
+ * none, so an unreadable file is a stated fact rather than an aborted generation. Content is
+ * scrubbed of secrets before the model sees it, since answers are stored and shown.
+ */
+export declare class PrExplorer implements GuidedReviewExplorer {
+    private readonly repo;
+    private readonly target;
+    private readonly files;
+    private readonly limits;
+    private reads;
+    private readonly byPath;
+    constructor(repo: RepoFiles, target: PrExplorerTarget, files: GitHubChangedFile[], limits?: PrExplorerLimits);
+    /** Reads this job has spent, for the caller's telemetry. */
+    get readsUsed(): number;
+    listChangedFiles(): Promise<string>;
+    readDiff(path: string): Promise<string>;
+    readFile(request: GuidedReviewFileRequest): Promise<string>;
+    listDirectory(path: string): Promise<string>;
+    private charge;
+    private renderLines;
+    private bound;
+}
+//# sourceMappingURL=PrExplorer.d.ts.map

package/dist/modules/guidedReview/PrExplorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrExplorer.d.ts","sourceRoot":"","sources":["../../../src/modules/guidedReview/PrExplorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGvE,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAA;IAChB,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAA;IACpB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,eAAO,MAAM,0BAA0B,EAAE,gBAIxC,CAAA;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;GAKG;AACH,qBAAa,UAAW,YAAW,oBAAoB;IAKnD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IAEvD,YACmB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,iBAAiB,EAAE,EAC1B,MAAM,GAAE,gBAA6C,EAGvE;IAED,4DAA4D;IAC5D,IAAI,SAAS,IAAI,MAAM,CAEtB;IAEK,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAcxC;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY5C;IAEK,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAehE;IAEK,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAcjD;YAEa,MAAM;IAWpB,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,KAAK;CAOd"}