wicked-crew-api-types 0.99.0 → 0.100.1

package/index.d.ts

@@ -711,6 +711,136 @@ export interface WorkUnit {
    * marker was MISSING (that denies; the denial is the record), and on an older engine.
    */
   capture_report?: CaptureReport;
+  /**
+   * TRUE when the worktree guard governs this unit (a def-driven, agent-executed
+   * `executes_code: false` phase — a READ-ONLY phase; wicked-core `WorkUnit.worktree_guarded`,
+   * derived at plan time). Skip-if-false on the wire: ABSENT on every other unit and on an older
+   * engine. Typed here for crew#891 (the floor-fix gate is a read-only phase's).
+   */
+  worktree_guarded?: boolean;
+  /**
+   * TRUE when this unit runs the repository's own checks as its floor (wicked-core
+   * `WorkUnit.repo_checks_floor`). Skip-if-false on the wire: ABSENT otherwise.
+   */
+  repo_checks_floor?: boolean;
+  /**
+   * The repo-checks evidence the fold attached to this unit (wicked-core `RepoChecksReport`),
+   * typed only as far as a skin reads it (crew#891); the rest of the report rides the index
+   * signature. ABSENT until the unit's gate folds, and when the floor does not apply.
+   */
+  repo_checks?: WorkUnitRepoChecks;
+  /**
+   * Every human gate note that amended this unit, oldest first (wicked-core#760
+   * `WorkUnit.operator_rulings`) — the record the evaluator reviewing it reads. ABSENT when empty.
+   */
+  operator_rulings?: OperatorRuling[];
+  /** (crew#894, wicked-core#810) The phase's worker pool (one creator plus monitors). ABSENT = 1. */
+  pool?: number;
+  /** (crew#894) How that pool was seated, once distributed (see {@link UnitPoolSeating}). ABSENT
+   *  for a pool of 1 and before distribution. */
+  pool_seating?: UnitPoolSeating;
+  /**
+   * (wicked-core#761) The FAIL items an operator landed this Evaluator unit over at its
+   * `review_adjudication` gate, carried forward with the work. ABSENT when empty.
+   */
+  carried_items?: string[];
+  /**
+   * (wicked-core#686) The phase's AUTHORED instructions as a field: for the deliver phase, the gate
+   * card the workflow wrote. {@link WorkUnit.description} still carries them after ` ||| ` (it is
+   * the worker's prompt), but a reader takes them from here when
+   * {@link WorkUnit.structured_description} is true. ABSENT when the phase has none, and on a
+   * record that predates the field.
+   */
+  instructions?: string;
+  /**
+   * (wicked-core#686) Every approved intent amendment folded onto this unit, oldest first, as the
+   * operator's text (the description also carries each one after the amendment prefix).
+   * ABSENT when empty.
+   */
+  amendments?: string[];
+  /**
+   * (wicked-core#686) TRUE when the unit was planned with {@link WorkUnit.instructions} and
+   * {@link WorkUnit.amendments} as fields: read them there and never split the description.
+   * ABSENT (false) on a record that predates the fields; only then may a skin fall back to
+   * re-parsing the description, as a legacy path.
+   */
+  structured_description?: boolean;
+}
+
+/**
+ * How an operator's floor-only re-run ran (wicked-core `FloorRerunMode`, snake_case on the wire):
+ * `extend` | `targeted` | `accept_partial` (wicked-core#469, the escalation arms of a floor that did
+ * not finish) and `floor_fix` (crew#891, wicked-core#782 / #811 — a seat distinct from the
+ * read-only phase made the operator's fix first; reached only through an approve with a note at
+ * that phase's floor gate, never as its own `GateDecision.action`).
+ */
+export type FloorRerunMode = 'extend' | 'targeted' | 'accept_partial' | 'floor_fix';
+
+/** (crew#891, wicked-core#782) The fix a `floor_fix` re-run makes before its floor runs. */
+export interface FloorFix {
+  /** The operator's note, verbatim — the fixing seat's whole task. */
+  note: string;
+  /** The seat that makes the fix: distinct from the read-only phase's own (evaluator ≠ fixer). */
+  seat: string;
+}
+
+/** (wicked-core#469) A floor-only re-run the escalation gate armed on a unit, read by its next dispatch. */
+export interface FloorRerun {
+  mode: FloorRerunMode;
+  /** `accept_partial`: the checks waived. Absent when empty. */
+  waive?: string[];
+  /** The seat's output from the attempt the gate reviewed (the fold reads it; the seat does not re-run).
+   *  Always serialised (`""` when none). */
+  output: string;
+  /** `floor_fix` only (crew#891): the note and the distinct seat that makes it. */
+  fix?: FloorFix;
+}
+
+/** {@link WorkUnit.repo_checks}: the parts of wicked-core's `RepoChecksReport` a skin reads. */
+export interface WorkUnitRepoChecks {
+  /** Whether the floor passed (vacuously true when nothing was detected). The engine always sends
+   *  it; optional here because this type is a partial reading, and consumers (fixtures included)
+   *  already hold units whose report they only partly know. */
+  passed?: boolean;
+  /** The operator's re-run this report answers; absent for the ordinary floor. */
+  rerun?: FloorRerunMode;
+  /** Checks the operator waived for this unit. Absent when empty. */
+  waived?: string[];
+  /** The re-run armed at the gate and not yet consumed. Absent otherwise. */
+  requested_rerun?: FloorRerun;
+  [k: string]: unknown;
+}
+
+/**
+ * One human gate note on a unit (wicked-core#760 `OperatorRuling`): `request_changes` | `amend`,
+ * and `floor_fix` (crew#891, wicked-core#782) for an approve-with-note a distinct seat made as a
+ * floor fix. Read an unknown token as a note, never as an error.
+ */
+export interface OperatorRuling {
+  action: 'request_changes' | 'amend' | 'floor_fix' | (string & {});
+  /** The operator's own words. */
+  text: string;
+  /** The amended unit's attempt when the ruling was given. */
+  attempt: number;
+  /** Unix millis. */
+  at: number;
+}
+
+/**
+ * (crew#894, wicked-core#810) A unit's worker-pool fill — `unitDistributed.pool` and
+ * `WorkUnit.pool_seating` (the same keys; core-ts `UnitPoolSeatingJson`).
+ */
+export interface UnitPoolSeating {
+  /** The phase's `pool` (after any plan step lowered it). */
+  requested: number;
+  /** Seats filled: the creator plus `monitors.length`. */
+  seated: number;
+  /** The monitor seat instances (`claude#2`), in the order the team supervisor summons them. */
+  monitors: string[];
+  /** Configured instances that could have filled the shortfall but are not signed in. */
+  missing: string[];
+  /** Why `seated < requested`; `null` when the pool was filled. */
+  shortfall: string | null;
 }
 
 /** The counts a capture phase reported (`WorkUnit.capture_report`; wicked-core#535). */
@@ -2532,10 +2662,14 @@ export interface UnitReworkAmendedEvent {
    * (`amendScope: 'creator'`); `'request_changes'` — the creator phase the gate rewound to, and
    * `amendment` then carries the evaluator's full findings + the operator's note;
    * `'accept_suggestion'` (wicked-core#467) — the same rewind after the operator adopted the
-   * evaluator's pinned edit, and `amendment` names it. ABSENT on an engine before the field — read
-   * as `'cursor'`.
+   * evaluator's pinned edit, and `amendment` names it. `'floor_fix'` (crew#891, wicked-core#782 /
+   * #811) — an approve WITH A NOTE at the escalation gate of a READ-ONLY phase (worktree-guarded,
+   * `executes_code: false`) whose own repo-checks floor denied it: a seat DISTINCT from that phase
+   * makes the note's fix in the worktree, then only the floor re-runs (the phase does not run again;
+   * its verdict stands and the floor decides). ABSENT on an engine before the field — read as
+   * `'cursor'`.
    */
-  scope?: 'cursor' | 'creator' | 'request_changes' | 'accept_suggestion';
+  scope?: 'cursor' | 'creator' | 'request_changes' | 'accept_suggestion' | 'floor_fix';
 }
 
 /** P2 — a worker's ApplyStepResult arrived and output is ready to be gated. Fires before GateDecided.
@@ -2646,6 +2780,13 @@ export interface UnitDistributedEvent {
    * unrecognised value as a disclosure too, never as "distinct".
    */
   distinctnessFallback?: 'creator_seat' | 'same_cli_instance' | null;
+  /**
+   * (crew#894, wicked-core#810 / #813; core-ts >= 0.7.44) How the unit's WORKER POOL was filled:
+   * one creator plus monitors. `null` for a pool of 1 (the default) and a tool unit; ABSENT on an
+   * older engine. A pool larger than the signed-in instances is seated SHORT and disclosed here
+   * (`seated < requested`, `missing`, `shortfall`), never refused. Guard with `== null`.
+   */
+  pool?: UnitPoolSeating | null;
   /** @deprecated api-types 0.36.0 — the engine emits `routingMethod`; removed in 0.37. */
   routing_method?: 'council' | 'degraded' | 'evaluator_distinct' | 'tool' | 'teamed';
   /** @deprecated api-types 0.36.0 — the engine emits `agreementPct`; removed in 0.37. */
@@ -4340,6 +4481,12 @@ export type PhaseExecutor =
 export interface PhaseDef {
   id: string;
   kind: StageKindPhase;
+  /**
+   * (crew#894, wicked-core#810) The phase's worker pool, `1..=4` (absent = 1): one creator plus
+   * `pool - 1` monitors, inside a TEAM run only. A user workflow declaring `pool > 1` is refused at
+   * registration (`pool outside a team run`), and so is a value outside `1..=4` (`pool out of range`).
+   */
+  pool?: number;
   /** How the phase executes. Omitted = Agent (engine default). Tool phases bypass the council and
    *  run `cmd` directly. */
   executor?: PhaseExecutor;
@@ -5245,6 +5392,9 @@ export interface InteractiveDocSummary {
   name: string;
   /** Manifest `kind`; a manifest without one lists as `doc`. */
   kind: 'doc' | 'html' | 'source' | 'demo';
+  /** Manifest `style` (the bridge's set: `web` | `ppt` | `brochure` | `doc`); ABSENT when the
+   *  manifest carries none (the bridge renders that as `web`). */
+  style?: 'web' | 'ppt' | 'brochure' | 'doc' | (string & {});
   /** Head version. */
   head: number;
   /** Lineage size. */
@@ -5315,6 +5465,16 @@ export interface InteractiveDocIndexRow {
   kinds: InteractiveSeamKind[];
   /** The governed runs those seams launched for it (ledger order) — the doc ↔ run binding. */
   runs: string[];
+  /** (crew#896) Manifest `style`, as the per-project list relays it; ABSENT when the manifest
+   *  carries none. */
+  style?: 'web' | 'ppt' | 'brochure' | 'doc' | (string & {});
+  /**
+   * (crew#896) The repository grounding the draft seam resolved for this document, read from the
+   * same `crew-grounding.json` sidecar the per-project list reads (see
+   * {@link InteractiveDocSummary.grounding}). ABSENT until a draft launch resolved it, and on a
+   * daemon before api-types 0.100.1.
+   */
+  grounding?: InteractiveDocGrounding;
 }
 
 /** A project docs root the listing could not read (api-types 0.36.0). */
@@ -5372,7 +5532,12 @@ export interface InteractionRequest {
   reviewing_ord: number | null;
   prompt: string;
   status: 'open' | 'answered' | 'expired' | 'cancelled';
-  /** The decision payload (JSON text, e.g. `{"approve":true,"amend":null}`) once resolved. */
+  /**
+   * The decision payload (JSON text, e.g. `{"approve":true,"amend":null}`) once resolved. Its
+   * `action` names the arm; `"floor_fix"` (crew#891, wicked-core#782) replaces `"approve"` when an
+   * approve with a note at a read-only phase's floor gate was taken as a floor fix — it IS an
+   * approve.
+   */
   answer: string | null;
   /** Unix millis. */
   created_at: number;
@@ -7501,6 +7666,10 @@ export interface TeamPlanStep {
   added_by?: 'plan' | 'floor' | (string & {});
   floor_reason?: string;
   late?: boolean;
+  /** (crew#894, wicked-core#810) The step's worker pool. A plan step may only LOWER the catalog
+   *  phase's pool; a raise is refused (`wicked.team.plan.refused`, reason `pool_raised`). Omitted
+   *  when unset. */
+  pool?: number;
 }
 
 export interface TeamPlanOverride {
@@ -7585,6 +7754,8 @@ export type TeamPlanAcceptedPayload = TeamEnvelope & {
 export type TeamPlanRefusedPayload = TeamEnvelope & {
   proposal_id: string;
   base_rev: number | null;
+  /** The engine's refusal reason, verbatim — e.g. `pool_raised` (crew#894, wicked-core#810: a plan
+   *  step raised a phase's `pool`; a step may only lower it). */
   reason: string;
 };
 
@@ -7621,6 +7792,9 @@ export type TeamStepClaimedPayload = TeamEnvelope & {
   baseline_tree: string | null;
   repo: { workdir: string; git_dir: string } | null;
   code_graph_db: string | null;
+  /** (crew#894, wicked-core#810) The monitor seat instances summoned beside the claiming creator
+   *  (a pool > 1). Omitted when empty. */
+  monitors?: string[];
 };
 
 export type TeamCheckpointReachedPayload = TeamEnvelope & {
@@ -8360,6 +8534,13 @@ export interface CatalogEntry {
   skill_ref: string | null;
   /** The entry's one-line description; `null` when it has none. */
   description: string | null;
+  /**
+   * (wicked-core#816) The entry's worker pool (`PhaseDef::pool_size()`): the most a plan step of
+   * this entry may ask for, since the planner refuses a raise as `pool_raised`; a step may only
+   * lower it. The engine always sends it (1 when the entry declares none). ABSENT from an engine
+   * before core-ts carries #816: read absent as 1.
+   */
+  pool?: number;
 }
 
 /** `GET /catalog`. */

package/package.json

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