wicked-crew-api-types 0.87.0 → 0.91.0

package/index.d.ts

@@ -1010,7 +1010,7 @@ export interface RunFileContent {
 export interface RunDiff {
   /** Unified diff text (`git diff --no-color --no-ext-diff HEAD`), cut at 1 MB when `truncated`. */
   diff: string;
-  /** The diff exceeded the 1 MB output cap and was cut. */
+  /** The diff exceeded the 1 MB output cap and was cut (or, crew#790, ran out of its time budget). */
   truncated: boolean;
   /**
    * Where the diff was read from (wave 6, F-7R2-013; api-types 0.36.0): `worktree` — the live run
@@ -1025,7 +1025,12 @@ export interface RunDiff {
   branch?: string;
   /** `source: 'branch'` — the base commit the branch was diffed against: the engine's recorded
    *  `AgentSession.base_commit` when it has one, else the branch's merge-base with the default
-   *  branch; `?base=<ref>` overrides it with a plain in-repo ref. */
+   *  branch; `?base=<ref>` overrides it with a plain in-repo ref. `source: 'worktree'` (crew#790)
+   *  — present when no `?base=` was sent and the worktree was diffed against the recorded
+   *  `base_commit` (committed AND uncommitted run work); absent when the baseline was HEAD (no
+   *  recorded base, or it does not resolve in the worktree). `truncated` is also `true` when the
+   *  untracked-file pass stopped at its time budget on a busy host; a git stopped before it
+   *  answered is 503 `{ code: "diff_busy" }` with `Retry-After`. */
   base?: string;
 }
 
@@ -4542,6 +4547,17 @@ export interface BlastRadius {
    * hot symbol. When non-zero, an empty `dependents` still never means "safe".
    */
   unresolved: number;
+  /**
+   * Completeness causes from estate (wicked-estate#222, estate >= 0.18.0; api-types 0.91.0, crew#751),
+   * ABSENT on an older estate. `depth_horizon_reached`: the depth horizon stopped the walk with
+   * dependents beyond it; `node_cap_reached`: the node budget dropped reachable nodes;
+   * `searched_depth`: the horizon that applied (re-ask with a larger one); `truncated_dependents`:
+   * rows estate had but cut to fit its output budget. Any of them set ⇒ `dependents` is partial.
+   */
+  depth_horizon_reached?: boolean;
+  node_cap_reached?: boolean;
+  searched_depth?: number;
+  truncated_dependents?: number;
 }
 
 /** An open elicitation as `GET /runs/:id/elicitation` returns it (DES-002). */
@@ -4902,6 +4918,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
@@ -4947,8 +5020,10 @@ export interface InteractiveDocsListing {
   unreachable: InteractiveDocsUnreachable[];
 }
 
-/** The seams that can answer a document (the handoff ledgers). */
-export type InteractiveSeamKind = 'draft' | 'edit' | 'chat' | 'demo' | (string & {});
+/** The seams that can answer a document (the handoff ledgers). `theme` (EP-C4 theme learning) and
+ *  `review` (EP-C2 reviews) keep their rows in the edit seam's ledger and are told apart by the row
+ *  key (api-types 0.90.0, crew#785): a document only reviewed reads `review`, never `edit`. */
+export type InteractiveSeamKind = 'draft' | 'edit' | 'chat' | 'demo' | 'theme' | 'review' | (string & {});
 
 /** One document on the daemon-wide listing (api-types 0.36.0). */
 export interface InteractiveDocIndexRow {
@@ -5599,6 +5674,17 @@ export interface ProjectBlastRadius {
   missingRepos: string[];
   linkage: ProjectGraphLinkage;
   note: string;
+  /**
+   * Completeness causes from estate (wicked-estate#222, estate >= 0.18.0; api-types 0.91.0, crew#751),
+   * ABSENT on an older estate. `depth_horizon_reached`: the depth horizon stopped the walk with
+   * dependents beyond it; `node_cap_reached`: the node budget dropped reachable nodes;
+   * `searched_depth`: the horizon that applied (re-ask with a larger one); `truncated_dependents`:
+   * rows estate had but cut to fit its output budget. Any of them set ⇒ `dependents` is partial.
+   */
+  depth_horizon_reached?: boolean;
+  node_cap_reached?: boolean;
+  searched_depth?: number;
+  truncated_dependents?: number;
 }
 
 /** `GET /projects/:id/graph/search?name=` — exact-name symbol resolution across member repos. */
@@ -6782,7 +6868,8 @@ export interface WalkthroughView {
   /** Proof-root-relative paths of the stitched take; `null` until there is one. */
   video: { mp4: string | null; poster: string | null; markers: DemoMarker[] };
   chapters: WalkthroughChapter[];
-  /** Per creator step, the check state from THIS pair's take — computed at every read from its re-verified seal (WT-W2). */
+  /** Per creator step, the check state from THIS pair's take — computed at every read from its re-verified seal (WT-W2).
+   *  With no pair because the accepted plan's override removed it, every finished creator step `owned_by_you` (0.88.1). */
   steps: WalkthroughStepState[];
 }
 
@@ -6793,7 +6880,9 @@ export interface WalkthroughView {
  * engine-captured output), `bundle_sha` recomputed from the proof root, and the proof root's stamped
  * ledger verdicts against the sealed chapter verdicts. The gate is deny-dominates across the repo
  * ledger and every row: a missing, mismatched ("changed after it was sealed") or non-PASS seal
- * denies. ABSENT when the requirement names no walkthrough step.
+ * denies. ABSENT when the requirement names no walkthrough step — except when the accepted plan's floor
+ * override removed the walkthrough pair (§4.9; api-types 0.88.1): then it is present with `roots: []`,
+ * `sealed: true` (nothing to seal) and every finished creator step `owned_by_you`.
  */
 export interface RunAcceptanceWalkthrough {
   roots: Array<{ stepId: string; sealed: boolean; satisfied: boolean; reason: string }>;
@@ -6814,7 +6903,8 @@ export interface RunAcceptanceSummary {
   /** Deny-dominates across the repo ledger and every walkthrough (`gate.satisfied`). */
   satisfied: boolean;
   line: string;
-  /** From the newest walkthrough; `null` when the requirement names none. */
+  /** From the newest walkthrough; `null` when the requirement names none — unless the accepted plan's
+   *  override removed the pair (then `tree` is `null` and `ownedByYou` counts the operator's steps). */
   walkthrough: {
     checked: number;
     failed: number;
@@ -6847,6 +6937,24 @@ export interface PutStorylineResponse {
   at: string;
 }
 
+/**
+ * `GET /runs/:id/walkthrough/storyline?step=` → 200 (#782; api-types 0.89.0): the author's storyline
+ * — `author/<planStepId>/storyline.mjs` — so "Edit the check" can prefill the box and send the edit
+ * back through `PUT` ({@link PutStorylineBody}). Readable at any run status. `step` names the author or
+ * its recorder (default: the newest pair). 404 `no_storyline` before the author wrote one; 409
+ * `no_author` / `no_evidence_root` / `read_refused` (a link or a non-file, never followed); 413 over
+ * 256 KB. `edited_by` / `at` come from crew's edit marker only when its `sha256` names THIS text.
+ */
+export interface WalkthroughStorylineView {
+  runId: string;
+  planStepId: string;
+  storyline: string;
+  sha256: string;
+  edited_by: 'human' | null;
+  /** ISO-8601 of the operator's edit; `null` when the text is the author's. */
+  at: string | null;
+}
+
 /** `POST /proposals/:id/reject` → 200. */
 export interface RejectProposalResponse {
   ok: true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-crew-api-types",
-  "version": "0.87.0",
+  "version": "0.91.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",