@quickchatai/pi-quickreview 0.0.0-stage → 1.1.0

package/dist/src/storerows.d.ts

@@ -0,0 +1,225 @@
+export interface RoundRow {
+    id: number;
+    pr: number;
+    round_no: number;
+    round_type: string;
+    lenses: string;
+    verdict: string | null;
+    /** Legacy self-reported spend column. Never written — boot folds surviving
+     * values into est_usd and every consumer reads est_usd. Kept in the DDL
+     * because a live DB cannot drop it without a table rebuild. */
+    spend_usd: number | null;
+    duration_s: number | null;
+    /** Session-written 3-4 sentence round summary (verdict file `summary`). */
+    summary: string | null;
+    started_at: string;
+    deadline_at: string;
+    finished_at: string | null;
+    status: string;
+    /** Diffstat of the head this round reviewed (summed over the files API). */
+    additions: number | null;
+    deletions: number | null;
+    changed_files: number | null;
+    /** 1 for rows imported from GitHub history — never live behaviour. */
+    backfilled: number;
+    /** GitHub review databaseId — the backfill idempotence key. */
+    gh_review_id: number | null;
+    gh_commit_id: string | null;
+    /** Deterministic shell-post identity and confirmed outcome. Null key
+     * means a legacy round whose verdict cannot be receipt-gated. */
+    posting_key: string | null;
+    posted_event: string | null;
+    posted_at: string | null;
+    /** The trigger instant this round answered, copied off pr_state at start so
+     * time-to-first-verdict survives the `trigger_ts = null` reset at dispatch. */
+    trigger_ts: string | null;
+    tokens_in: number | null;
+    /** Output tokens including reasoning tokens. */
+    tokens_out: number | null;
+    tokens_cache_read: number | null;
+    /** Daemon-side USD estimate (config pricing); null when a model is unpriced. */
+    est_usd: number | null;
+    /** The tier `pass-validate` ran at this round — recorded so a later audit
+     * can tell which tier judged which finding. Null on rounds started before
+     * the column existed (and on backfilled history), and on a round whose
+     * profile switched the validator off. */
+    validate_tier: string | null;
+    /** Executed-pass telemetry: JSON array of VerdictPassEntry — the
+     * passes the session ACTUALLY ran, as reported in the verdict file. Distinct
+     * from `lenses`, which is the daemon's PLAN. Null = unknown (round predates
+     * the field, or the session ran an older prompt and reported nothing). */
+    executed_passes: string | null;
+    /** Exact dispatch-time policy for classifying reasoned added passes. */
+    pass_plan: string | null;
+    addable_passes: string | null;
+    /** When the lost-prompt net first observed this round
+     * fully silent (prompt consumed, session alive, no JSONL activity). The net
+     * fires only on the SECOND consecutive silent sweep; any non-silent
+     * observation clears the mark. Same persistence idiom as the
+     * reviewed_heads/approval_withheld marks — a mark the daemon writes so a
+     * restart cannot forget it — but round-scoped, so it lives on the round
+     * row rather than in a per-PR table. Null = never seen silent. */
+    silent_since: string | null;
+    /** The receipt token stamped into this round's wake file, echoed
+     * back by pi into the session JSONL when — and only when — the prompt is
+     * ACCEPTED. Null means the round was dispatched by a build that stamped no
+     * marker, so its delivery is UNKNOWABLE rather than unconfirmed: readers
+     * must fall back to the older inference instead of concluding "lost". */
+    prompt_marker: string | null;
+    /** How many times this round's prompt has been re-delivered. Cheap
+     * recovery (rewrite the wake file, same round and session), bounded on its
+     * own rather than out of the `max_self_requeues` budget. */
+    redeliveries: number;
+    /** The per-round comment count: inline comments this round posted,
+     * as the session reports it in its findings record. Null = unknown (no
+     * record, or a record that omitted the count) — never confused with 0. */
+    comments_posted: number | null;
+    /** Why this round was cancelled — null on every round that was not
+     * cancelled, and on older cancellations the boot migration could not
+     * classify from their prose summary. The prose stays in `summary`; this
+     * is the machine-readable half every aggregate groups by. */
+    cancel_cause: string | null;
+    /** Bracket around dispatch-time migration-precheck posting. Existing
+     * rounds migrate as unknown (never auto-replayed); new rounds start none and
+     * move through ambiguous before the gated call resolves. */
+    preflight_posting_state: "unknown" | "none" | "ambiguous" | "executed" | "dryrun" | "refused";
+    /** First exact planned discovery execution observed by the daemon. */
+    fanout_started_at: string | null;
+    /** The end of this round's usage window while
+     * its round-end measurement (usage, the exec-policy audit, the integrity
+     * re-check) is OWED — stamped synchronously when the round end fixes the
+     * window, cleared when the measurement has finished, whatever it found.
+     * A non-null value at boot is a measurement a restart cut short; the
+     * verdict watcher resumes it. Null = nothing owed (and every round before
+     * the column). */
+    usage_owed_to: string | null;
+    /** The head this round was dispatched to review (the prepared tree's). */
+    head_sha: string | null;
+    /** The merge base the round's prepared tree had: the next
+     * follow-up round checks it is still under its own merge base, so a
+     * force-pushed base is a full round, never base drift read as the PR's. */
+    merge_base: string | null;
+    /** `full` | `delta` — what the round reviewed. NULL on a first round and on
+     * every round before the column (a legacy non-first round was a full
+     * re-review). */
+    scope: string | null;
+    /** A delta round's baseline: the last reviewed head it was diffed from. */
+    delta_base_sha: string | null;
+    /** A delta round's PR-owned change: lines (additions + deletions), files. */
+    delta_lines: number | null;
+    delta_files: number | null;
+    /** 1 when the round's order carried the pre-approval sweep, else 0; NULL
+     * on rounds that are not follow-ups. */
+    sweep_owed: number | null;
+    /** The sweep's plan (JSON PassPlanEntry[]), when owed. */
+    sweep_plan: string | null;
+    /** ran | not_owed | not_reached | unknown — what became of the sweep. */
+    sweep_status: string | null;
+}
+/** One parsed row of the durable reasoning record. */
+export interface RoundFindingRow {
+    id: number;
+    pr: number;
+    round_id: number | null;
+    round_no: number;
+    head_sha: string;
+    finding_key: string;
+    path: string | null;
+    line: number | null;
+    lens: string;
+    tier: string | null;
+    /** 1 when the lens is not in the round's plan — the add protocol ran it. */
+    unplanned: number;
+    severity: string | null;
+    confidence: number | null;
+    reachability: string | null;
+    kind: string | null;
+    disposition: string;
+    axis: string | null;
+    word: string | null;
+    reason: string | null;
+    evidence: string | null;
+    posted_as: string | null;
+    raised_in_round: number | null;
+    thread_id: number | null;
+    recorded_at: string;
+    /** The posted comment's title as the record wrote it; null
+     * when the record carries none. */
+    title: string | null;
+    /** Canonical lens ids, a JSON array (`packages/pi-plugin/src/lensids.ts`). Null
+     * only on a row the boot migration has not reached yet. */
+    lens_ids: string | null;
+}
+/** One prior finding a follow-up round was handed, or reported on
+ * (`prior_finding_checks`). */
+export interface PriorFindingCheckRow {
+    pr: number;
+    checked_round: number;
+    head_sha: string;
+    round_no: number;
+    finding_key: string;
+    blocking: number;
+    /** fixed | open | conceded | settled | obsolete | unverifiable; null =
+     * listed and not (yet) reported. */
+    status: string | null;
+    evidence: string | null;
+    listed_at: string | null;
+    reported_at: string | null;
+}
+/**
+ * What the store needs to write one recorded finding. Structural on purpose —
+ * `FindingsRecordEntry` (packages/pi-plugin/src/findingsrecord.ts) satisfies it without state.ts
+ * having to know anything about files, parsing or the record's schema.
+ */
+export interface RoundFindingInput {
+    key: string;
+    path?: string | null;
+    line?: number | null;
+    lens?: string | null;
+    tier?: string | null;
+    severity?: string | null;
+    confidence?: number | null;
+    reachability?: string | null;
+    kind?: string | null;
+    disposition?: string | null;
+    axis?: string | null;
+    word?: string | null;
+    reason?: string | null;
+    evidence?: string | null;
+    posted_as?: string | null;
+    raised_in_round?: number | null;
+    thread_id?: number | null;
+    title?: string | null;
+}
+/**
+ * The reviewed-head mark: the last head this system actually reviewed on a
+ * PR, what it decided there, and the newest author reply seen since. One row
+ * per PR — the mark is a *position*, not a history; the rounds table keeps the
+ * history.
+ *
+ * Two readers: the no-new-evidence guard (posting time and dispatch time) and
+ * the post-approval delta recheck, which needs exactly `head_sha` to diff the
+ * current head against. Lifecycle consumers read it only through
+ * `standing-review.ts`.
+ */
+export interface ReviewedHeadRow {
+    pr: number;
+    head_sha: string;
+    /** When the mark was last (re)stamped — the instant author replies race. */
+    reviewed_at: string;
+    /** The verdict applied at this head, when one was ("APPROVE" | …). */
+    verdict: string | null;
+    /** The review event actually POSTed at this head, when one was. */
+    posted_event: string | null;
+    round_no: number | null;
+    /** Newest author reply observed after the mark was stamped (new evidence). */
+    last_author_reply_at: string | null;
+}
+/**
+ * What the event log says about one migration-collision COMMENT (the dedupe's
+ * delivery read). `unknown` is an unreadable ledger row; `pending` is a
+ * readable intent with unconfirmed delivery. Neither permits another POST.
+ * A dry-run receipt is recorded intent, never a delivered remedy.
+ */
+export type CollisionCommentRecord = "commented" | "dryrun" | "pending" | "not_commented" | "unknown";
+//# sourceMappingURL=storerows.d.ts.map

package/dist/src/storerows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storerows.d.ts","sourceRoot":"","sources":["../../src/storerows.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;mEAE+D;IAC/D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,2EAA2E;IAC3E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IAEf,4EAA4E;IAC5E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;qEACiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;mFAC+E;IAC/E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gDAAgD;IAChD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gFAAgF;IAChF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;6CAGyC;IACzC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;8EAG0E;IAC1E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,wEAAwE;IACxE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;;;sEAMkE;IAClE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;6EAIyE;IACzE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;gEAE4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB;;8EAE0E;IAC1E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;iEAG6D;IAC7D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;gEAE4D;IAC5D,uBAAuB,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC9F,sEAAsE;IACtE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;;;;sBAMkB;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;+EAE2E;IAC3E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;qBAEiB;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,6EAA6E;IAC7E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;4CACwC;IACxC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,yEAAyE;IACzE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB;uCACmC;IACnC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;+DAC2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;+BAC+B;AAC/B,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB;wCACoC;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mEAAmE;IACnE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,8EAA8E;IAC9E,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAChC,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAAC"}

package/dist/src/storerows.js

@@ -0,0 +1,7 @@
+// The state records the review core reads and writes: rounds, the findings
+// a round recorded, the prior-finding checks, the reviewed-head mark and the
+// migration-collision delivery read. Plain shapes, so the core can hand them
+// around without the SQLite store; src/state.ts is their one writer and
+// re-exports them.
+export {};
+//# sourceMappingURL=storerows.js.map

package/dist/src/storerows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storerows.js","sourceRoot":"","sources":["../../src/storerows.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,6EAA6E;AAC7E,6EAA6E;AAC7E,wEAAwE;AACxE,mBAAmB"}

package/dist/src/styleguide.d.ts

@@ -0,0 +1,25 @@
+export declare const GUIDE_MIN_LINES = 15;
+export declare const SECTION_MIN_LINES = 8;
+/** The style section of a CONTRIBUTING file as 1-based [from, to] lines, when
+ * it is substantial enough to be a guide. Markdown headings only. */
+export declare function styleSection(text: string): [number, number] | null;
+/**
+ * The same rule over a FILE LISTING rather than a directory tree: the
+ * setup engine reads the reviewed repo through a port, so it hands over the
+ * repo-relative paths it has and a reader that answers null for anything it
+ * cannot or will not read (a directory, a file over the size cap). The
+ * candidates are exactly the ones `findStyleGuide` lists — the root, `docs/`,
+ * `doc/`, `.github/`, and one level down under `docs/`/`doc/` by name only —
+ * plus the agent-directive files — so both spellings return the same
+ * references for the same tree. `identity` says which file a path really is
+ * (findStyleGuide passes realpath); without one a directive file is known by
+ * its text, so a link and its target — which read the same — count once.
+ */
+export declare function styleGuideRefsIn(files: readonly string[], read: (rel: string) => string | null, identity?: (rel: string) => string | null): string[];
+/**
+ * The repo's written style guide(s) under `root`, as repo-relative
+ * references — `path` for a whole guide file, `path:from-to` for a style
+ * section — or [] when there is none worth a lens.
+ */
+export declare function findStyleGuide(root: string): string[];
+//# sourceMappingURL=styleguide.d.ts.map

package/dist/src/styleguide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styleguide.d.ts","sourceRoot":"","sources":["../../src/styleguide.ts"],"names":[],"mappings":"AAsCA,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAqEnC;qEACqE;AACrE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAElE;AAiFD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,EACpC,QAAQ,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAGnC,GACA,MAAM,EAAE,CAuBV;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAuCrD"}

package/dist/src/styleguide.js

@@ -0,0 +1,272 @@
+// Does this repo write its code style down? (`[review] style_lens`)
+//
+// Style is the one review concern with no universal answer: every repo has
+// its own, and a reviewer's taste is not it. So the style lens runs only
+// where the repo has a WELL-DEFINED written guide, and it judges only against
+// that guide. "Well defined" is structural and cheap to check here, before a
+// round is planned:
+//
+//   - a dedicated guide file — STYLEGUIDE / STYLE_GUIDE / STYLE / CODE_STYLE /
+//     CODING_STYLE / CODING_STANDARDS / CODING_GUIDELINES / CONVENTIONS, as
+//     .md/.rst/.txt/.adoc, at the root or under docs/, doc/ or .github/ (or a
+//     docs file whose NAME says style guide / coding standards) — with at
+//     least GUIDE_MIN_LINES lines of content;
+//   - or a style section in CONTRIBUTING (a heading such as "Code style",
+//     "Coding standards", "Style guide") with at least SECTION_MIN_LINES
+//     lines of content under it;
+//   - or style rules the repo wrote for its agents: a style section
+//     — the same headings, plus a bare "Conventions", "Style", "Formatting"
+//     or "Naming" — of at least SECTION_MIN_LINES lines in an agent-directive
+//     file (AGENTS.md / CLAUDE.md at the root, .github/copilot-instructions.md,
+//     .github/instructions/*.md), or a whole directive file whose NAME says
+//     style or conventions (`.github/instructions/code-style.instructions.md`)
+//     with at least SECTION_MIN_LINES lines. What a team already told its
+//     agents about style is a written guide; a separate file is not required.
+//     A directive file that is a link to another one (CLAUDE.md → AGENTS.md)
+//     is read once.
+//
+// A guide the repo writes WINS over one a profile points the lens at
+// (`[lenses.pass-style] guide`, packages/pi-plugin/src/lenstuning.ts): that one is used only
+// when this finds nothing (src/dispatch.ts buildPassPlan).
+//
+// Linter and formatter configs are NOT a style guide here: what a tool
+// enforces is CI's job, and the review reads CI, it never re-runs it.
+// Total: an unreadable tree is "no guide", never an error.
+import { existsSync, readdirSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+import { resolveInsideCheckout } from "./lintconfig.js";
+export const GUIDE_MIN_LINES = 15;
+export const SECTION_MIN_LINES = 8;
+const MAX_GUIDE_BYTES = 512 * 1024;
+const GUIDE_NAME_RE = /^(style[-_ ]?guide|style|code[-_ ]?style|coding[-_ ]?(style|standards|guidelines|conventions)|conventions)(\.(md|markdown|rst|txt|adoc))$/i;
+const DOCS_NAME_RE = /(style[-_ ]?guide|code[-_ ]?style|coding[-_ ]?(style|standards|guidelines|conventions))[^/]*\.(md|markdown|rst|txt|adoc)$/i;
+const CONTRIBUTING_RE = /^contributing\.(md|markdown|rst|txt|adoc)$/i;
+const STYLE_HEADING_RE = /^(#{1,6}\s+|=+\s*$|-+\s*$)?.*\b(code|coding)\s+(style|standards|conventions|guidelines)\b|\bstyle\s*guide\b/i;
+const HEADING_RE = /^#{1,6}\s+\S/;
+/** A directive file's style heading: the guide headings above, or a bare
+ * "Conventions" / "Style" / "Formatting" / "Naming" — agent files name the
+ * section for the agent, not as a guide — or a section of written RULES
+ * ("Rules", "Compliance"): what a team tells
+ * its agents the code must follow is its written guide whatever the heading
+ * says (repos commonly keep naming, header and formatting rules under a
+ * heading such as "# Compliance Rules").
+ * pass-style still applies only the style rules in it and still skips what a
+ * configured tool enforces; the section only decides that the lens runs. */
+const DIRECTIVE_HEADING_RE = /\b(style|conventions|formatting|naming|rules|compliance)\b/i;
+const ROOT_DIRECTIVE_RE = /^(agents|claude)\.md$/i;
+const DIRECTIVE_NAME_RE = /(style|conventions)[^/]*\.(md|markdown)$/i;
+function contentLines(text) {
+    return text.split("\n").filter((l) => l.trim() && !/^[#=\-*_`\s]+$/.test(l.trim())).length;
+}
+function read(path) {
+    try {
+        const st = statSync(path);
+        if (!st.isFile() || st.size > MAX_GUIDE_BYTES)
+            return null;
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+function list(dir) {
+    try {
+        return readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+}
+/** Which lines sit inside a fenced code block (the fences included): a
+ * `# comment` in a shell example is code, not a heading. A fence opens on
+ * three or more backticks or tildes (indented at most three spaces) and
+ * closes on a run of the same character at least as long; one left open runs
+ * to the end of the file, as Markdown renders it. */
+function fencedLines(lines) {
+    const out = [];
+    let open = null;
+    for (const line of lines) {
+        const m = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
+        if (open === null) {
+            if (m && !(m[1][0] === "`" && m[2].includes("`")))
+                open = { char: m[1][0], len: m[1].length };
+            out.push(open !== null);
+        }
+        else {
+            out.push(true);
+            if (m && m[1][0] === open.char && m[1].length >= open.len && m[2].trim() === "")
+                open = null;
+        }
+    }
+    return out;
+}
+/** The style section of a CONTRIBUTING file as 1-based [from, to] lines, when
+ * it is substantial enough to be a guide. Markdown headings only. */
+export function styleSection(text) {
+    return styleSections(text, (l) => STYLE_HEADING_RE.test(l))[0] ?? null;
+}
+/** Every substantial style section of `text` whose heading passes `isStyle`,
+ * as 1-based [from, to] lines, in file order; a heading inside a section
+ * already taken is part of it, not a section of its own. */
+function styleSections(text, isStyle) {
+    const lines = text.split("\n");
+    const fenced = fencedLines(lines);
+    const out = [];
+    for (let i = 0; i < lines.length; i++) {
+        const l = lines[i];
+        if (fenced[i] || !HEADING_RE.test(l) || !isStyle(l))
+            continue;
+        const level = /^#+/.exec(l)[0].length;
+        let end = lines.length;
+        for (let j = i + 1; j < lines.length; j++) {
+            const m = fenced[j] ? null : /^(#{1,6})\s+\S/.exec(lines[j]);
+            if (m && m[1].length <= level) {
+                end = j;
+                break;
+            }
+        }
+        // The span ends at its last non-blank line (a file's trailing newline too).
+        while (end > i + 1 && lines[end - 1].trim() === "")
+            end--;
+        if (contentLines(lines.slice(i + 1, end).join("\n")) >= SECTION_MIN_LINES) {
+            out.push([i + 1, end]);
+            i = end - 1;
+        }
+    }
+    return out;
+}
+const isDirectiveHeading = (l) => STYLE_HEADING_RE.test(l) || DIRECTIVE_HEADING_RE.test(l);
+/** Style rules in the repo's agent-directive files, as references:
+ * `path:from-to` per style section, `path` for a directive file whose name
+ * says style. Over a listing: `identity` names the file a path really is, so a
+ * directive file that links to another is read once; null = skip the path. */
+function directiveStyleRules(listing, read, identity) {
+    const files = listing.filter((rel) => {
+        const parts = rel.split("/");
+        if (parts.length === 1)
+            return ROOT_DIRECTIVE_RE.test(parts[0]);
+        if (parts.length === 2 && parts[0] === ".github")
+            return /^copilot-instructions\.md$/i.test(parts[1]);
+        return (parts.length === 3 &&
+            parts[0] === ".github" &&
+            parts[1] === "instructions" &&
+            /\.(md|markdown)$/i.test(parts[2]));
+    });
+    const named = (rel) => rel.startsWith(".github/instructions/") && DIRECTIVE_NAME_RE.test(rel);
+    // A file named for style is read first, so an alias of it that sorts
+    // earlier (base.md → code-style.instructions.md) cannot claim the file's
+    // identity and read it by headings alone.
+    const ordered = [...new Set(files)].sort((a, b) => Number(named(b)) - Number(named(a)) || (a < b ? -1 : a > b ? 1 : 0));
+    const out = [];
+    const seen = new Set();
+    for (const rel of ordered) {
+        const real = identity(rel);
+        if (real === null || seen.has(real))
+            continue;
+        seen.add(real);
+        const text = read(rel);
+        if (text === null)
+            continue;
+        if (named(rel)) {
+            if (contentLines(text) >= SECTION_MIN_LINES)
+                out.push(rel);
+            continue;
+        }
+        for (const [from, to] of styleSections(text, isDirectiveHeading))
+            out.push(`${rel}:${from}-${to}`);
+    }
+    return out;
+}
+/**
+ * The same rule over a FILE LISTING rather than a directory tree: the
+ * setup engine reads the reviewed repo through a port, so it hands over the
+ * repo-relative paths it has and a reader that answers null for anything it
+ * cannot or will not read (a directory, a file over the size cap). The
+ * candidates are exactly the ones `findStyleGuide` lists — the root, `docs/`,
+ * `doc/`, `.github/`, and one level down under `docs/`/`doc/` by name only —
+ * plus the agent-directive files — so both spellings return the same
+ * references for the same tree. `identity` says which file a path really is
+ * (findStyleGuide passes realpath); without one a directive file is known by
+ * its text, so a link and its target — which read the same — count once.
+ */
+export function styleGuideRefsIn(files, read, identity = (rel) => {
+    const text = read(rel);
+    return text === null ? null : `text:${text}`;
+}) {
+    const out = [];
+    for (const rel of files) {
+        const parts = rel.split("/");
+        const name = parts[parts.length - 1];
+        const dir = parts.slice(0, -1).join("/");
+        if (dir === "" || dir === "docs" || dir === "doc" || dir === ".github") {
+            if (GUIDE_NAME_RE.test(name) || (dir !== "" && DOCS_NAME_RE.test(name))) {
+                const text = read(rel);
+                if (text !== null && contentLines(text) >= GUIDE_MIN_LINES)
+                    out.push(rel);
+            }
+            else if (CONTRIBUTING_RE.test(name)) {
+                const text = read(rel);
+                const sec = text === null ? null : styleSection(text);
+                if (sec)
+                    out.push(`${rel}:${sec[0]}-${sec[1]}`);
+            }
+        }
+        else if (parts.length === 3 && (parts[0] === "docs" || parts[0] === "doc")) {
+            if (!DOCS_NAME_RE.test(name))
+                continue;
+            const text = read(rel);
+            if (text !== null && contentLines(text) >= GUIDE_MIN_LINES)
+                out.push(rel);
+        }
+    }
+    out.push(...directiveStyleRules(files, read, identity));
+    return [...new Set(out)].sort();
+}
+/**
+ * The repo's written style guide(s) under `root`, as repo-relative
+ * references — `path` for a whole guide file, `path:from-to` for a style
+ * section — or [] when there is none worth a lens.
+ */
+export function findStyleGuide(root) {
+    if (!existsSync(root))
+        return [];
+    // Every path read here must RESOLVE inside the checkout: the tree is the
+    // PR's, and a guide symlinked (or reached through a symlinked docs/) to a
+    // file outside it — a secret the container can read — would be named in
+    // the plan and read in full by pass-style. A link that stays inside is fine.
+    let realRoot;
+    try {
+        realRoot = realpathSync(root);
+    }
+    catch {
+        return [];
+    }
+    const inside = (rel) => resolveInsideCheckout(root, realRoot, rel);
+    const listing = [];
+    for (const d of ["", "docs", "doc", ".github", ".github/instructions"]) {
+        for (const name of list(join(root, d)))
+            listing.push(relative(root, join(root, d, name)));
+    }
+    // docs/<sub>/ one level down, by name only (a docs site's style page).
+    for (const d of ["docs", "doc"]) {
+        for (const sub of list(join(root, d))) {
+            const subdir = join(root, d, sub);
+            let isDir = false;
+            try {
+                isDir = statSync(subdir).isDirectory();
+            }
+            catch {
+                continue;
+            }
+            if (!isDir)
+                continue;
+            for (const name of list(subdir))
+                listing.push(relative(root, join(subdir, name)));
+        }
+    }
+    return styleGuideRefsIn(listing, (rel) => {
+        const real = inside(rel);
+        return real === null ? null : read(real);
+    }, inside);
+}
+//# sourceMappingURL=styleguide.js.map

package/dist/src/styleguide.js.map

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

package/dist/src/sweepstatus.d.ts

@@ -0,0 +1,42 @@
+/** What a session may CLAIM became of its owed sweep (the verdict's
+ * `sweep`): `ran`, `not_owed` (the order carried none), `not_reached` (the
+ * round decided REQUEST_CHANGES first) or `skipped` (decided not needed). */
+export declare const SWEEP_CLAIMS: readonly ["ran", "not_owed", "not_reached", "skipped"];
+export type SweepClaim = (typeof SWEEP_CLAIMS)[number];
+export declare function isSweepClaim(word: unknown): word is SweepClaim;
+/** A pass entry's `phase`: `delta` | `sweep`, case and separators
+ * forgiven; anything else is unusable (null). */
+export declare function normalizePassPhase(raw: unknown): "delta" | "sweep" | null;
+/** The verdict's top-level `sweep`: `ran` | `not_owed` | `not_reached` |
+ * `skipped`, case forgiven and `-`/space read as `_`; anything else is
+ * unusable (null). */
+export declare function normalizeSweepClaim(raw: unknown): SweepClaim | null;
+/** What became of a follow-up round's pre-approval sweep
+ * (`rounds.sweep_status`). */
+export type SweepStatus = SweepClaim | "unknown";
+/** An APPROVE that left its owed sweep un-run: neither ran nor decided not
+ * needed (`followup_sweep_skipped`). */
+export declare function sweepSkippedOnApprove(verdict: string | null | undefined, owed: boolean, status: SweepStatus): boolean;
+/**
+ * The sweep status a follow-up round's verdict earns. `ran` only
+ * when the session CLAIMED it and its executed telemetry carries sweep-phase
+ * passes; every contradiction or gap is `unknown` with a note — never `ran`,
+ * because a run sweep is a full look and an unknown one must stay owed. Pure.
+ *
+ * `sweepPasses`: the count of executed `phase: "sweep"` entries, null when the
+ * verdict carried no usable pass telemetry. `verdict`: the round's decided
+ * verdict — `not_reached` means "decided REQUEST_CHANGES first", so an
+ * APPROVE claiming it (or `not_owed` beside an owed sweep) is a
+ * contradiction, recorded `unknown`.
+ */
+export declare function sweepStatusOf(args: {
+    owed: boolean;
+    claim: SweepClaim | null;
+    sweepPasses: number | null;
+    receiptSettled: boolean;
+    verdict?: string | null;
+}): {
+    status: SweepStatus;
+    note?: string;
+};
+//# sourceMappingURL=sweepstatus.d.ts.map

package/dist/src/sweepstatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweepstatus.d.ts","sourceRoot":"","sources":["../../src/sweepstatus.ts"],"names":[],"mappings":"AAKA;;6EAE6E;AAC7E,eAAO,MAAM,YAAY,wDAAyD,CAAC;AACnF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,UAAU,CAE9D;AAED;iDACiD;AACjD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,CAOzE;AAED;;sBAEsB;AACtB,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAOnE;AAED;8BAC8B;AAC9B,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAEjD;wCACwC;AACxC,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,WAAW,GAClB,OAAO,CAET;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAyCzC"}