wicked-crew 0.16.4 → 0.16.6

package/dist/insights/review-service.d.ts

@@ -0,0 +1,127 @@
+/**
+ * The run review around its workflow (DES-RUNS-REVIEW-001 §3, §5, §6):
+ *
+ *  - {@link ReviewService.prepareLaunch} — every launch of `review-recent-work` (a schedule, Run it now, or
+ *    `POST /runs`) goes through it: it reads the run store, writes `<reviews dir>/<run>/snapshot.json` and the
+ *    handoff, and makes the launch repo-less, delivering nothing, with that directory as its ONLY write root and
+ *    `report.json` as its deliverable, on ONE seat.
+ *  - {@link ReviewService.reconcile} — once a review run is terminal, crew reads `facts.json` (the script's) and
+ *    `report.json` (the seat's), keeps at most five recommendations ranked by crew's impact score, files the
+ *    steering-rule and memory ones into the approve queue, and records the review.
+ *  - {@link ReviewService.accept} / {@link ReviewService.dismiss} — a person's decision on one recommendation.
+ *
+ * The seat never files anything and never writes a number crew stores.
+ */
+import type { SessionStatus, SessionView } from 'wicked-crew-api-types';
+import type { LaunchRunInput } from '../core/types.js';
+import type { Facts, Snapshot, Window } from './analyze.js';
+import { type LooseEvent } from './run-facts.js';
+import type { InsightsStore, Recommendation, Review } from './store.js';
+export declare const HANDOFF_FILE = "handoff.json";
+/** The seat's ONLY write root inside its review directory: the snapshot and the numbers beside it stay out of reach. */
+export declare const OUT_DIR = "out";
+/** The first review looks back this far; later ones start where the last completed review's window ended. */
+export declare const FIRST_WINDOW_MS: number;
+/** A window never spans more than this (a review after a long pause looks at the last two weeks). */
+export declare const MAX_WINDOW_MS: number;
+/** The baseline: this many previous windows of the same length. */
+export declare const BASELINE_WINDOWS = 4;
+export interface ReviewServiceDeps {
+    store: InsightsStore;
+    adapter: {
+        sessionsDetail(): Promise<SessionView[]>;
+        runEvents(runId: string): Promise<LooseEvent[] | null>;
+        seatsForWorkflow(workflowId: string): Promise<unknown[]>;
+        listRepos?(): Promise<Array<{
+            id: string;
+            git_url?: string;
+        }>>;
+    };
+    reviewsDir: string;
+    /** The approve queue (estate `proposal.*`), the same seam `/proposals` uses. */
+    estateTool: (tool: string, args: Record<string, unknown>) => Promise<unknown>;
+    log: (msg: string) => void;
+    now?: () => Date;
+}
+export interface PrepareOptions {
+    trigger: 'schedule' | 'manual';
+    scheduleId?: string | null;
+    /** Limit the review to these projects; empty = every run. */
+    projectIds?: readonly string[];
+}
+/** What a person's Accept opens in studio. */
+export type AcceptTarget = {
+    kind: 'proposal';
+    proposalId: string;
+} | {
+    kind: 'settings';
+    section: string;
+} | {
+    kind: 'issue';
+    repoRef: string | null;
+    title: string;
+    body: string;
+    url: string | null;
+} | {
+    kind: 'runs';
+    runIds: string[];
+} | {
+    kind: 'none';
+};
+export declare class RecommendationError extends Error {
+    readonly status: 400 | 404 | 409 | 502;
+    constructor(status: 400 | 404 | 409 | 502, message: string);
+}
+export declare class ReviewService {
+    private readonly deps;
+    constructor(deps: ReviewServiceDeps);
+    private now;
+    runDir(runId: string): string;
+    /** The review window: from the end of the last completed review OF THE SAME SCOPE (else 48 h back), capped at
+     *  14 days. A review of other projects never moves this scope's cursor. */
+    windowFor(nowMs: number, projectIds?: readonly string[]): {
+        window: Window;
+        baselineWindows: Window[];
+    };
+    /** Fold the run store into a snapshot (the analyze script's only input). */
+    snapshot(projectIds: readonly string[], nowMs: number): Promise<Snapshot>;
+    /**
+     * Make a launch a review launch. Mutates and returns `input`: repo-less, no deliver, one seat, the run directory
+     * as the only write root, `report.json` as the only deliverable. Records the review as running.
+     */
+    prepareLaunch(input: LaunchRunInput, opts: PrepareOptions): Promise<LaunchRunInput>;
+    /** A launch the engine refused: the review never ran. */
+    launchRefused(runId: string, reason: string): void;
+    /** Fold every running review whose run is terminal. Never throws. */
+    reconcile(status: ReadonlyMap<string, SessionStatus | string>): Promise<void>;
+    private readJson;
+    ingest(review: Review, status: 'completed' | 'failed' | 'cancelled'): Promise<Review | undefined>;
+    /** Accept: record it, and say what to open. A proposal-backed one opens its proposal (approval stays there). */
+    accept(id: string): Promise<{
+        recommendation: Recommendation;
+        open: AcceptTarget;
+    }>;
+    /** Dismiss with a reason. A proposal-backed one rejects its proposal in the approve queue too. */
+    dismiss(id: string, reason: string): Promise<{
+        recommendation: Recommendation;
+    }>;
+    private targetOf;
+}
+/** The scope a review covers, as one comparable key (its projects, sorted; `''` = every run). */
+export declare function scopeKey(projectIds: readonly string[]): string;
+/** The one seat a review runs on: the first the roster says is eligible and not failing. `null` when none is. */
+export declare function pickSeat(roster: readonly unknown[]): unknown | null;
+/** `https://github.com/<owner>/<repo>/issues/new?title=&body=` for a GitHub remote, else `null`. */
+export declare function githubNewIssueUrl(gitUrl: string | undefined, title: string, body: string): string | null;
+/**
+ * Crew's candidates, worded by the seat where its report says so. Crew decides WHICH recommendations (its top five
+ * by impact) and their evidence; the seat may only retitle, describe the effect, say what would change its mind,
+ * and LOWER the confidence. A report entry naming no recommended candidate is dropped.
+ */
+export declare function mergeReport(runId: string, facts: Facts, report: Record<string, unknown> | null): {
+    summary: string | null;
+    interpreted: boolean;
+    recommendations: Recommendation[];
+    watching: Review['watching'];
+};
+//# sourceMappingURL=review-service.d.ts.map

package/dist/insights/review-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-service.d.ts","sourceRoot":"","sources":["../../src/insights/review-service.ts"],"names":[],"mappings":"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"}

package/dist/insights/review-service.js

@@ -0,0 +1,392 @@
+/**
+ * The run review around its workflow (DES-RUNS-REVIEW-001 §3, §5, §6):
+ *
+ *  - {@link ReviewService.prepareLaunch} — every launch of `review-recent-work` (a schedule, Run it now, or
+ *    `POST /runs`) goes through it: it reads the run store, writes `<reviews dir>/<run>/snapshot.json` and the
+ *    handoff, and makes the launch repo-less, delivering nothing, with that directory as its ONLY write root and
+ *    `report.json` as its deliverable, on ONE seat.
+ *  - {@link ReviewService.reconcile} — once a review run is terminal, crew reads `facts.json` (the script's) and
+ *    `report.json` (the seat's), keeps at most five recommendations ranked by crew's impact score, files the
+ *    steering-rule and memory ones into the approve queue, and records the review.
+ *  - {@link ReviewService.accept} / {@link ReviewService.dismiss} — a person's decision on one recommendation.
+ *
+ * The seat never files anything and never writes a number crew stores.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { MAX_RECOMMENDATIONS, analyze } from './analyze.js';
+import { FACTS_FILE, REPORT_FILE, SNAPSHOT_FILE } from './analyze-cli.js';
+import { runFactOf } from './run-facts.js';
+import { REVIEW_WORKFLOW } from './workflow.js';
+export const HANDOFF_FILE = 'handoff.json';
+/** The seat's ONLY write root inside its review directory: the snapshot and the numbers beside it stay out of reach. */
+export const OUT_DIR = 'out';
+const HOUR = 3_600_000;
+/** The first review looks back this far; later ones start where the last completed review's window ended. */
+export const FIRST_WINDOW_MS = 48 * HOUR;
+/** A window never spans more than this (a review after a long pause looks at the last two weeks). */
+export const MAX_WINDOW_MS = 14 * 24 * HOUR;
+/** The baseline: this many previous windows of the same length. */
+export const BASELINE_WINDOWS = 4;
+const TERMINAL = new Set(['completed', 'failed', 'cancelled']);
+/** A review run the daemon no longer lists is given up on after this long. */
+const LOST_AFTER_MS = 48 * HOUR;
+export class RecommendationError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+const CONFIDENCE_RANK = { low: 0, medium: 1, high: 2 };
+const line = (v, max) => {
+    if (typeof v !== 'string')
+        return null;
+    const t = v.replace(/\s+/gu, ' ').trim();
+    return t === '' ? null : t.slice(0, max);
+};
+export class ReviewService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    now() {
+        return this.deps.now?.() ?? new Date();
+    }
+    runDir(runId) {
+        return join(this.deps.reviewsDir, runId);
+    }
+    /** The review window: from the end of the last completed review OF THE SAME SCOPE (else 48 h back), capped at
+     *  14 days. A review of other projects never moves this scope's cursor. */
+    windowFor(nowMs, projectIds = []) {
+        const last = this.deps.store.lastCompleted(scopeKey(projectIds));
+        const start = Math.max(last?.window.endMs ?? nowMs - FIRST_WINDOW_MS, nowMs - MAX_WINDOW_MS);
+        // A review run seconds after the last one still compares a meaningful span.
+        const len = Math.max(nowMs - start, HOUR);
+        const window = { startMs: nowMs - len, endMs: nowMs };
+        const baselineWindows = [];
+        for (let i = 1; i <= BASELINE_WINDOWS; i += 1)
+            baselineWindows.push({ startMs: window.startMs - i * len, endMs: window.startMs - (i - 1) * len });
+        return { window, baselineWindows };
+    }
+    /** Fold the run store into a snapshot (the analyze script's only input). */
+    async snapshot(projectIds, nowMs) {
+        const { window, baselineWindows } = this.windowFor(nowMs, projectIds);
+        const earliest = Math.min(...baselineWindows.map((w) => w.startMs), window.startMs);
+        const views = await this.deps.adapter.sessionsDetail();
+        const runs = [];
+        for (const view of views) {
+            const s = view.session;
+            if (s['workflow_id'] === REVIEW_WORKFLOW)
+                continue;
+            if (projectIds.length > 0 && !projectIds.includes(String(s['project_id'] ?? '')))
+                continue;
+            const dated = typeof s['created_at'] === 'number' ? (s['created_at'] < 1e12 ? s['created_at'] * 1000 : s['created_at']) : null;
+            // A run dated by the daemon's launch record outside every window is skipped without reading its events.
+            if (dated !== null && (dated < earliest || dated >= window.endMs))
+                continue;
+            let events = [];
+            try {
+                events = (await this.deps.adapter.runEvents(String(s['id']))) ?? [];
+            }
+            catch (err) {
+                this.deps.log(`[review] events of ${String(s['id'])} unreadable, counted from its record only: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            // An undated run (no launch record: onboarding, campaign nodes, older runs) is dated by its first event.
+            const created = dated ?? Math.min(...events.map((e) => (typeof e.ts === 'number' ? e.ts : Number.POSITIVE_INFINITY)));
+            if (!Number.isFinite(created) || created < earliest || created >= window.endMs)
+                continue;
+            runs.push(runFactOf(view, events, nowMs));
+        }
+        return { version: 1, generatedAtMs: nowMs, window, baselineWindows, projectIds: [...projectIds], runs };
+    }
+    /**
+     * Make a launch a review launch. Mutates and returns `input`: repo-less, no deliver, one seat, the run directory
+     * as the only write root, `report.json` as the only deliverable. Records the review as running.
+     */
+    async prepareLaunch(input, opts) {
+        const now = this.now();
+        const runId = input.sessionId;
+        if (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u.test(runId) || runId.includes('..'))
+            throw new Error(`a review run id must be one plain path segment: ${runId}`);
+        // One review per run id: a repeated id never touches the review already recorded under it.
+        if (this.deps.store.get(runId) !== undefined)
+            throw new Error(`a review is already recorded for run ${runId}`);
+        const seat = pickSeat(await this.deps.adapter.seatsForWorkflow(REVIEW_WORKFLOW));
+        if (seat === null)
+            throw new Error('no signed-in, eligible agent seat to interpret the review: sign one in (Agents) and run it again');
+        const projectIds = [...(opts.projectIds ?? [])];
+        const snap = await this.snapshot(projectIds, now.getTime());
+        const dir = this.runDir(runId);
+        mkdirSync(this.deps.reviewsDir, { recursive: true });
+        try {
+            mkdirSync(dir); // exclusive: the filesystem decides who owns this id
+        }
+        catch (err) {
+            if (err.code === 'EEXIST')
+                throw new Error(`a review directory already exists for run ${runId}`);
+            throw err;
+        }
+        const out = join(dir, OUT_DIR);
+        mkdirSync(out);
+        writeFileSync(join(dir, SNAPSHOT_FILE), JSON.stringify(snap), 'utf8');
+        const factsPath = join(dir, FACTS_FILE);
+        const reportPath = join(out, REPORT_FILE);
+        const handoffPath = join(dir, HANDOFF_FILE);
+        writeFileSync(handoffPath, JSON.stringify({ facts_path: factsPath, report_path: reportPath, max_recommendations: MAX_RECOMMENDATIONS }, null, 2), 'utf8');
+        const asked = input.problem.trim();
+        input.problem =
+            `Review recent work: interpret the run review computed for ${snap.runs.length} runs ` +
+                `(${new Date(snap.window.startMs).toISOString()} to ${new Date(snap.window.endMs).toISOString()}). ` +
+                `Read the handoff file at ${handoffPath}. It names facts_path (the numbers, computed by a script) and ` +
+                `report_path (the one file you write).` +
+                (asked !== '' && asked !== REVIEW_WORKFLOW ? `\n\nThe person also asked: ${asked.slice(0, 2000)}` : '');
+        input.workflow = REVIEW_WORKFLOW;
+        input.clisJson = JSON.stringify([seat]);
+        // The seat reads the review directory and writes ONLY `out/`: the snapshot and facts.json are not its to change.
+        input.extraWriteRoots = [out];
+        input.requireDeliverables = [reportPath];
+        delete input.repoRef;
+        delete input.deliver;
+        delete input.baseRef;
+        delete input.revisesPr;
+        delete input.plan;
+        delete input.projectGraph;
+        input.extraReadRoots = [dir];
+        this.deps.store.add({
+            runId,
+            trigger: opts.trigger,
+            scheduleId: opts.scheduleId ?? null,
+            launchedAt: now.toISOString(),
+            endedAt: null,
+            status: 'running',
+            window: snap.window,
+            baselineWindows: snap.baselineWindows,
+            projectIds,
+            summary: null,
+            interpreted: false,
+            totals: null,
+            series: [],
+            improvements: [],
+            regressions: [],
+            recommendations: [],
+            watching: [],
+            error: null,
+        });
+        return input;
+    }
+    /** A launch the engine refused: the review never ran. */
+    launchRefused(runId, reason) {
+        this.deps.store.update(runId, { status: 'failed', endedAt: this.now().toISOString(), error: `the launch was refused: ${reason.slice(0, 500)}` });
+    }
+    /** Fold every running review whose run is terminal. Never throws. */
+    async reconcile(status) {
+        for (const review of this.deps.store.running()) {
+            try {
+                const s = status.get(review.runId);
+                if (s === undefined) {
+                    if (this.now().getTime() - Date.parse(review.launchedAt) > LOST_AFTER_MS) {
+                        this.deps.store.update(review.runId, { status: 'failed', endedAt: this.now().toISOString(), error: 'the review run is no longer on the daemon' });
+                    }
+                    continue;
+                }
+                if (!TERMINAL.has(s))
+                    continue;
+                await this.ingest(review, s);
+            }
+            catch (err) {
+                this.deps.log(`[review] ingest of ${review.runId} failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    readJson(path) {
+        if (!existsSync(path))
+            return null;
+        try {
+            return JSON.parse(readFileSync(path, 'utf8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    async ingest(review, status) {
+        const dir = this.runDir(review.runId);
+        const endedAt = this.now().toISOString();
+        // The Tool step must have run (its facts.json is the seat's input), but the numbers crew STORES are
+        // re-derived here from the snapshot crew wrote, by the same deterministic code: nothing the run wrote can
+        // change a metric, a candidate, a ranking or a proposal.
+        const ran = existsSync(join(dir, FACTS_FILE));
+        const snapshot = this.readJson(join(dir, SNAPSHOT_FILE));
+        const facts = ran && snapshot !== null && snapshot.version === 1 && Array.isArray(snapshot.runs) ? analyze(snapshot) : null;
+        if (facts === null) {
+            return this.deps.store.update(review.runId, {
+                status: status === 'completed' ? 'failed' : status,
+                endedAt,
+                error: status === 'cancelled' ? 'the review was cancelled before its numbers were computed' : 'the analyze step wrote no facts.json',
+            });
+        }
+        const report = this.readJson(join(dir, OUT_DIR, REPORT_FILE));
+        const merged = mergeReport(review.runId, facts, report);
+        for (const rec of merged.recommendations) {
+            const p = rec.action.proposal;
+            if (p === undefined || (rec.kind !== 'steering-rule' && rec.kind !== 'memory'))
+                continue;
+            try {
+                const payload = rec.kind === 'memory'
+                    ? { content: p.content, tier: 'semantic', capture: 'review', source: REVIEW_WORKFLOW }
+                    : { rule: p.content, severity: p.severity ?? 'warn', source: REVIEW_WORKFLOW };
+                const res = (await this.deps.estateTool('proposal.submit', { kind_type: p.kindType, payload, facets: {} }));
+                if (typeof res?.id === 'string' && res.id !== '')
+                    rec.proposalId = res.id;
+                else
+                    rec.proposalError = 'proposal.submit returned no id';
+            }
+            catch (err) {
+                rec.proposalError = (err instanceof Error ? err.message : String(err)).slice(0, 300);
+            }
+        }
+        return this.deps.store.update(review.runId, {
+            // A run that computed its numbers but was cancelled or failed afterwards still shows them, said plainly.
+            status: status === 'completed' ? 'completed' : status,
+            endedAt,
+            summary: merged.summary,
+            interpreted: merged.interpreted,
+            totals: facts.totals,
+            series: facts.metrics.filter((m) => m.segment === 'all').map((m) => ({ metric: m.metric, window: m.window, baseline: m.baseline, verdict: m.verdict })),
+            improvements: facts.improvements.map((f) => ({ metric: f.metric, segment: f.segment, line: f.line })),
+            regressions: facts.regressions.map((f) => ({ metric: f.metric, segment: f.segment, line: f.line })),
+            recommendations: merged.recommendations,
+            watching: merged.watching,
+            error: status === 'completed' ? null : `the review run ended ${status}${merged.interpreted ? '' : ' before its report was written'}`,
+        });
+    }
+    /** Accept: record it, and say what to open. A proposal-backed one opens its proposal (approval stays there). */
+    async accept(id) {
+        const found = this.deps.store.findRecommendation(id);
+        if (found === undefined)
+            throw new RecommendationError(404, `no recommendation ${id}`);
+        if (found.rec.state === 'dismissed')
+            throw new RecommendationError(409, 'this recommendation was dismissed');
+        const rec = this.deps.store.updateRecommendation(id, { state: 'accepted', decidedAt: this.now().toISOString(), reason: null });
+        return { recommendation: rec, open: await this.targetOf(rec) };
+    }
+    /** Dismiss with a reason. A proposal-backed one rejects its proposal in the approve queue too. */
+    async dismiss(id, reason) {
+        const text = line(reason, 500);
+        if (text === null)
+            throw new RecommendationError(400, 'a dismissal needs a reason');
+        const found = this.deps.store.findRecommendation(id);
+        if (found === undefined)
+            throw new RecommendationError(404, `no recommendation ${id}`);
+        if (found.rec.state === 'accepted')
+            throw new RecommendationError(409, 'this recommendation was accepted');
+        if (found.rec.proposalId !== null && found.rec.state === 'new') {
+            try {
+                await this.deps.estateTool('proposal.reject', { id: found.rec.proposalId });
+            }
+            catch (err) {
+                throw new RecommendationError(502, `its proposal could not be rejected: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        const rec = this.deps.store.updateRecommendation(id, { state: 'dismissed', reason: text, decidedAt: this.now().toISOString() });
+        return { recommendation: rec };
+    }
+    async targetOf(rec) {
+        if (rec.proposalId !== null)
+            return { kind: 'proposal', proposalId: rec.proposalId };
+        if (rec.action.setting !== undefined)
+            return { kind: 'settings', section: rec.action.setting };
+        if (rec.action.runs !== undefined)
+            return { kind: 'runs', runIds: rec.action.runs };
+        const issue = rec.action.issue;
+        if (issue !== undefined) {
+            let url = null;
+            if (issue.repoRef !== null && this.deps.adapter.listRepos !== undefined) {
+                const repo = (await this.deps.adapter.listRepos().catch(() => [])).find((r) => r.id === issue.repoRef);
+                url = githubNewIssueUrl(repo?.git_url, issue.title, issue.body);
+            }
+            return { kind: 'issue', repoRef: issue.repoRef, title: issue.title, body: issue.body, url };
+        }
+        return { kind: 'none' };
+    }
+}
+/** The scope a review covers, as one comparable key (its projects, sorted; `''` = every run). */
+export function scopeKey(projectIds) {
+    return [...projectIds].sort().join(',');
+}
+/** The one seat a review runs on: the first the roster says is eligible and not failing. `null` when none is. */
+export function pickSeat(roster) {
+    for (const seat of roster) {
+        if (typeof seat !== 'object' || seat === null)
+            continue;
+        const s = seat;
+        if (s['council_eligible'] === false)
+            continue;
+        const health = s['health'];
+        if (health !== null && health !== undefined && typeof health.status === 'string' && health.status !== 'active')
+            continue;
+        return seat;
+    }
+    return null;
+}
+/** `https://github.com/<owner>/<repo>/issues/new?title=&body=` for a GitHub remote, else `null`. */
+export function githubNewIssueUrl(gitUrl, title, body) {
+    if (gitUrl === undefined)
+        return null;
+    const m = /github\.com[:/]([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+?)(?:\.git)?\/?$/u.exec(gitUrl.trim());
+    if (m === null)
+        return null;
+    const q = new URLSearchParams({ title: title.slice(0, 200), body: body.slice(0, 4000) });
+    return `https://github.com/${m[1]}/${m[2]}/issues/new?${q.toString()}`;
+}
+/**
+ * Crew's candidates, worded by the seat where its report says so. Crew decides WHICH recommendations (its top five
+ * by impact) and their evidence; the seat may only retitle, describe the effect, say what would change its mind,
+ * and LOWER the confidence. A report entry naming no recommended candidate is dropped.
+ */
+export function mergeReport(runId, facts, report) {
+    const byId = new Map(facts.candidates.map((c) => [c.id, c]));
+    const words = new Map();
+    const entries = Array.isArray(report?.['recommendations']) ? report['recommendations'] : [];
+    for (const e of entries) {
+        if (typeof e !== 'object' || e === null)
+            continue;
+        const cand = e['candidate'];
+        if (typeof cand === 'string' && facts.recommended.includes(cand) && !words.has(cand))
+            words.set(cand, e);
+    }
+    const summary = line(report?.['summary'], 1200);
+    const interpreted = report !== null && summary !== null;
+    const recommendations = facts.recommended.flatMap((cid) => {
+        const c = byId.get(cid);
+        if (c === undefined)
+            return [];
+        const w = words.get(cid);
+        const asked = w?.['confidence'];
+        const confidence = (asked === 'high' || asked === 'medium' || asked === 'low') && CONFIDENCE_RANK[asked] < CONFIDENCE_RANK[c.confidence] ? asked : c.confidence;
+        return [{
+                id: `${runId}:${c.id}`,
+                candidate: c.id,
+                kind: c.kind,
+                title: line(w?.['title'], 90) ?? c.title,
+                evidence: c.evidence,
+                expectedEffect: line(w?.['expectedEffect'], 300) ?? c.expectedEffect,
+                confidence,
+                changeMind: line(w?.['changeMind'], 300) ?? c.changeMind,
+                impact: c.impact,
+                basis: c.basis,
+                action: c.action,
+                state: 'new',
+                reason: null,
+                decidedAt: null,
+                proposalId: null,
+                proposalError: null,
+            }];
+    });
+    const watching = facts.watching.flatMap((cid) => {
+        const c = byId.get(cid);
+        return c === undefined ? [] : [{ id: c.id, title: c.title, line: c.evidence.line }];
+    });
+    return { summary, interpreted, recommendations, watching };
+}
+//# sourceMappingURL=review-service.js.map

package/dist/insights/review-service.js.map

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

package/dist/insights/routes.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `/api/v1/insights` (DES-RUNS-REVIEW-001 §6): the review history the Run insights plugin draws, and a person's
+ * decision on one recommendation. Reads are open to any actor; Accept and Dismiss are a person's only.
+ */
+import type { FastifyInstance } from 'fastify';
+import type { AuditLog } from '../api/audit.js';
+import { type ReviewService } from './review-service.js';
+import type { InsightsStore } from './store.js';
+export interface InsightsRouteDeps {
+    store: InsightsStore;
+    service: Pick<ReviewService, 'accept' | 'dismiss'>;
+    audit: AuditLog;
+}
+export declare function registerInsightsRoutes(app: FastifyInstance, deps: InsightsRouteDeps): void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/insights/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/insights/routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,SAAS,CAAC;AAK7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIhD,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IACnD,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CA6D1F"}

package/dist/insights/routes.js

@@ -0,0 +1,66 @@
+/**
+ * `/api/v1/insights` (DES-RUNS-REVIEW-001 §6): the review history the Run insights plugin draws, and a person's
+ * decision on one recommendation. Reads are open to any actor; Accept and Dismiss are a person's only.
+ */
+import { z } from 'zod';
+import { API_PREFIX } from '../api/api-prefix.js';
+import { LOCAL_ACTOR } from '../api/auth.js';
+import { isHumanOperator } from '../api/watch-routes.js';
+import { METRICS } from './analyze.js';
+import { MIN_SAMPLE } from './stats.js';
+import { RecommendationError } from './review-service.js';
+const V = API_PREFIX;
+const DismissSchema = z.object({ reason: z.string().trim().min(1).max(500) }).strict();
+export function registerInsightsRoutes(app, deps) {
+    const actorOf = (req) => req.actor ?? LOCAL_ACTOR;
+    const refuse = (reply) => reply.code(403).send({ error: 'Only a person can accept or dismiss a recommendation' });
+    const fail = (reply, err) => {
+        if (err instanceof RecommendationError)
+            return reply.code(err.status).send({ error: err.message });
+        throw err;
+    };
+    app.get(`${V}/insights`, { config: { manifest: { responseType: 'InsightsResponse', statusCodes: [200] } } }, async () => {
+        const reviews = deps.store.list();
+        const latest = reviews.find((r) => r.status !== 'running') ?? null;
+        return {
+            reviews,
+            newRecommendations: deps.store.newCount(),
+            running: reviews.some((r) => r.status === 'running'),
+            lastReview: latest === null ? null : { runId: latest.runId, launchedAt: latest.launchedAt, endedAt: latest.endedAt, status: latest.status },
+            metrics: METRICS,
+            minSample: MIN_SAMPLE,
+        };
+    });
+    app.post(`${V}/insights/recommendations/:id/accept`, { config: { manifest: { responseType: 'AcceptRecommendationResponse', statusCodes: [200, 403, 404, 409] } } }, async (req, reply) => {
+        const actor = actorOf(req);
+        if (!isHumanOperator(actor))
+            return refuse(reply);
+        const { id } = req.params;
+        try {
+            const res = await deps.service.accept(id);
+            deps.audit.record('insights.recommendation.accepted', actor, { detail: { id, kind: res.recommendation.kind } });
+            return res;
+        }
+        catch (err) {
+            return fail(reply, err);
+        }
+    });
+    app.post(`${V}/insights/recommendations/:id/dismiss`, { config: { manifest: { requestType: 'DismissRecommendationBody', responseType: 'DismissRecommendationResponse', statusCodes: [200, 400, 403, 404, 409, 502] } } }, async (req, reply) => {
+        const actor = actorOf(req);
+        if (!isHumanOperator(actor))
+            return refuse(reply);
+        const parsed = DismissSchema.safeParse(req.body);
+        if (!parsed.success)
+            return reply.code(400).send({ error: 'body must be { reason: <why, 1 to 500 characters> }' });
+        const { id } = req.params;
+        try {
+            const res = await deps.service.dismiss(id, parsed.data.reason);
+            deps.audit.record('insights.recommendation.dismissed', actor, { detail: { id, reason: parsed.data.reason } });
+            return res;
+        }
+        catch (err) {
+            return fail(reply, err);
+        }
+    });
+}
+//# sourceMappingURL=routes.js.map