wicked-crew-api-types 0.86.0 → 0.88.0

package/index.d.ts

@@ -1797,8 +1797,15 @@ export interface GovernanceHookFiredEvent {
   ord: number;
   attempt: number;
   toolName: string;
-  decision: 'allow' | 'deny';
+  /** `allow_with_conditions` (typed from api-types 0.87.0): the engine permits with obligations. */
+  decision: 'allow' | 'deny' | 'allow_with_conditions';
   denyingPolicy: string | null;
+  /**
+   * (TR-W2, wicked-core-ts >= 0.7.35; api-types 0.87.0) EVERY steering rule that fired on this
+   * call, whatever the decision — the `warn` class included, which an allow decision used to drop.
+   * The watch registry's `risky-call` entry projects the warn-effect ones. Absent on an older engine.
+   */
+  firedPolicies?: string[];
 }
 
 /** P2 — a pinned deterministic validator was attached; confirms the governance floor is armed. */
@@ -2102,6 +2109,32 @@ export type RepoChecksEvaluatedEvent = {
    *  `typecheck`/`lint`/`test` script, …) — the reason an empty `checks` is empty; `null` when
    *  detection succeeded. */
   detectError?: string | null;
+  /**
+   * (wicked-core#469; typed here from api-types 0.87.0) How the floor ended: `passed` | `failed` |
+   * `timed_out` | `not_run`. A floor that did not finish, or could not run at all (no write
+   * boundary — see `sandboxError`), is never "its checks failed". Absent on an older engine.
+   */
+  outcome?: string;
+  /**
+   * (wicked-core#467; typed here from api-types 0.87.0) Whose floor this was: `creator` (the seat
+   * handed back output and the engine ran the repo checks on its tree — a failing one is the
+   * structural "handed back as finished, its own checks failed", TR-W6) or `verify` (the
+   * code-verifying unit's, and the deliver re-check). Absent on an older engine.
+   */
+  floor?: string;
+  /**
+   * (wicked-core#467) A creator transcript's "pre-existing failure" claim, judged against the
+   * baseline diff: `verdict` is `claim_rejected` | `claim_confirmed` | `unverified`. `null` when no
+   * claim was made or the floor was green.
+   */
+  claim?: { phrase: string; check: string; verdict: string } | null;
+  /**
+   * (TR-W1b, wicked-core-ts >= 0.7.35) The repo-relative paths the step changed, `git diff-tree
+   * --name-status` baseline → floor tree. Absent when the tree did not change; capped at 200 with
+   * `changedTruncated: true`.
+   */
+  changed?: Array<{ status: string; path: string }>;
+  changedTruncated?: boolean;
 };
 
 // ── wicked-core#431 gate / deliver evidence (F-3R2-013 / -010 / -009; api-types 0.33.0) ──────────
@@ -4869,6 +4902,63 @@ export interface InteractiveStatusPosted {
   unit_ord?: number;
 }
 
+// ── EP-C2: a document's checks — the four reviewers (api-types 0.88.0) ─────────────────────────
+
+/** The four reviewers, by `wicked.interactive.review.requested`'s schema id (Intent = `match`, Quality = `qe`). */
+export type DocReviewerId = 'match' | 'a11y' | 'copy' | 'qe';
+
+/** Where a document check came from, in the checks panel's words. */
+export type DocCheckSource = 'review:intent' | 'review:a11y' | 'review:copy' | 'review:quality';
+
+/** One thing a reviewer found. A finding never edits the document; fixing it is the operator's choice. */
+export interface DocCheckFinding {
+  /** The `data-wid` the finding is about; `null` = unanchored (the host says so, and checks the anchor against its own inventory). */
+  wid: string | null;
+  severity: 'low' | 'medium' | 'high';
+  sentence: string;
+}
+
+/**
+ * One reviewer's verdict on one saved version of a document — a wicked-ledger verdict row, stamped
+ * with the crew run that produced it (`run_id`). There is no second verdict store.
+ */
+export interface DocCheck {
+  /** The ledger verdict row's id. */
+  id: string;
+  source: DocCheckSource;
+  reviewer: DocReviewerId;
+  /** The version that was reviewed. A check on an older version than the one asked for is shown "on version N". */
+  version: number;
+  /** `pass` (nothing needs changing) · `fail` (changes asked for) · `inconclusive` (the reviewer could not run). */
+  state: 'pass' | 'fail' | 'inconclusive';
+  /** One plain sentence: why this state. */
+  sentence: string;
+  findings: DocCheckFinding[];
+  /**
+   * Who reviewed. `evaluator` is true only when the document's authoring runs are on record AND the
+   * reviewing seat is not one of their seats — shown, never inferred. `author_known: false` (a version
+   * the operator typed, or runs no longer on record) means no seat could be excluded, and says so.
+   */
+  by: { seat: string | null; evaluator: boolean; excluded_seats: string[]; author_known: boolean };
+  /** The skill the reviewer loaded; `null` when it worked from the built-in rubric (the skill is not installed). */
+  skill: string | null;
+  run_id: string;
+  /** ISO-8601: when the verdict was recorded. */
+  at: string;
+}
+
+/**
+ * `GET /projects/:projectId/interactive/docs/:doc/checks?version=` → 200. Per reviewer, the newest
+ * verdict at or below `version` (every version when omitted) — so a newer review replaces an older
+ * one, and an older one stays visible until then. `checks: []` = never reviewed.
+ */
+export interface DocChecksResponse {
+  document_id: string;
+  /** The `version` asked for; `null` when the query named none. */
+  version: number | null;
+  checks: DocCheck[];
+}
+
 /**
  * One row of `GET /projects/:projectId/interactive/api/docs` (crew#472) — the bridge's own
  * `GET /api/docs` row (interactive's `listDocs` shape, relayed field-for-field) stamped with the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-crew-api-types",
-  "version": "0.86.0",
+  "version": "0.88.0",
   "description": "The wire contract of the wicked-crew daemon's /api/v1 REST surface and /ws CoreEvent frames \u2014 types only, zero runtime",
   "type": "module",
   "types": "./index.d.ts",