wicked-crew-api-types 0.108.0 → 0.110.0

package/index.d.ts

@@ -978,6 +978,11 @@ export interface SeatHealth {
  * the seat intact so it round-trips verbatim into `clisJson` on launch.
  */
 export interface RosterSeat {
+  /** (api-types 0.110.0, operator ruling 2026-10-11) An OPT-IN seat (opencode): never in a default
+   *  launch roster — a launch surface shows it unticked with `optInNote` ("opt-in: known to stall")
+   *  and includes it only when the operator ticks it. ABSENT for every other seat. */
+  optIn?: true;
+  optInNote?: string;
   key: string;
   display_name: string;
   binary: string;
@@ -1958,8 +1963,24 @@ export type AssuranceInstrument =
   | 'judge'
   | 'evaluator_pass'
   | 'distinct_evaluator'
+  /** (api-types 0.110.0) The operator judged a gate whose judge could not rule. */
+  | 'operator_judge'
   | (string & {});
 
+/**
+ * (api-types 0.110.0, operator ruling 2026-10-11) "Judged by operator": the operator's explicit
+ * approve at a `judge_unavailable` gate (no eligible judge, or a judge that gave no verdict). `by` is
+ * the actor the gate API recorded (the operator, or the agent acting for them); never automatic.
+ */
+export interface OperatorJudgment {
+  by: string;
+  /** Unix millis. */
+  at: number;
+  note: string | null;
+  /** Why the judge could not rule (the gate's denial reason). */
+  reason: string | null;
+}
+
 /** Why an instrument is absent from a receipt. */
 export type AssuranceSkipReason =
   | 'reduced_assurance'
@@ -2038,6 +2059,13 @@ export interface AssuranceReceipt {
    *  run does not require QE acceptance (or on an older engine). A waived or skipped one is also a
    *  `skipped[]` entry (reason `qe_waived_by_score` | `qe_skipped_by_operator`). */
   qe?: QeAcceptanceDecision;
+  /** (api-types 0.109.0, core#888) The councils this decision's disputes convened, each with WHO
+   *  decided (`seats`) and the draw's `seed`. ABSENT when none was convened (the routine case) or on
+   *  an older engine. A delivery receipt lists every council of the run. */
+  councils?: TeamDispute[];
+  /** (api-types 0.110.0) Every gate the operator judged ("judged by operator"); ABSENT when none or on
+   *  an older engine. A unit receipt carries its own; a delivery receipt lists the run's. */
+  operatorJudges?: OperatorJudgment[];
 }
 
 /**
@@ -5110,6 +5138,21 @@ export interface SystemSettings {
    * the engine default `~/.wicked-worker`.
    */
   worker_config_root?: string;
+  /**
+   * (api-types 0.109.0, operator ruling 2026-10-11) How many seats a council convenes — councils
+   * sit only on concrete decisions (a team dispute). Integer 1..9, default 3; the seats are drawn
+   * AT RANDOM from the run's eligible seats (not benched, not a party to the dispute), distinct
+   * model families first, and the draw's seats + seed ride the gate's receipt
+   * (`AssuranceReceipt.councils`). The daemon exports it as `WICKED_COUNCIL_SIZE` at boot and on
+   * every change; the engine reads it per council. Absent = the default.
+   */
+  councilSize?: number;
+  /**
+   * (api-types 0.109.0) Milliseconds between two council seat spawns of one ballot, so a council
+   * never forks every heavy CLI at once. Integer 0..30000, default 3000 (`0` = all at once).
+   * Exported as `WICKED_COUNCIL_SPAWN_STAGGER_MS`, read per council. Absent = the default.
+   */
+  councilSpawnStaggerMs?: number;
   /*
    * There is NO skills setting (skills keystone, api-types 0.28.0). The daemon-owned skills root is
    * `<state home>/skills` — the directory holding `manifest.json`, `baseline/<hash>/`, `effective/`,
@@ -8433,8 +8476,28 @@ export type TeamCouncilRuledPayload = TeamEnvelope & {
   dissent: string[];
   returned: number;
   seated: number;
+  /** (api-types 0.109.0, core#888) The seats drawn onto the council, the draw's seed, and the
+   *  eligible seats it was drawn from. ABSENT when nothing was convened or on an older engine. */
+  seats?: string[];
+  seed?: number;
+  eligible?: string[];
 };
 
+/**
+ * A one-off council's verdict on a dispute (DES-001 §6.3). (api-types 0.109.0, core#888) `seats`
+ * names WHO decided — the seats drawn onto the council (empty when none was convened, or on an
+ * older engine) — and `seed` is the random draw's seed: re-drawing with it seats the same council.
+ * `seed` is ABSENT when no council was drawn or on an older engine.
+ */
+export interface TeamDispute {
+  verdict: 'yes' | 'no' | 'no_verdict' | (string & {});
+  agreementPct: number | null;
+  dissent: number | null;
+  seats: string[];
+  seed?: number;
+  reason: string | null;
+}
+
 /** DES-001 §7 `teamLedger.findings[]` (camelCase). */
 export interface TeamLedgerFinding {
   findingId: string;
@@ -8454,13 +8517,7 @@ export interface TeamLedgerFinding {
   status: 'accepted' | 'declined' | 'withdrawn' | 'unanswered' | 'superseded' | (string & {});
   workerReason: string | null;
   monitorReply: { kind: 'hold' | 'withdraw' | (string & {}); reason: string } | null;
-  dispute: {
-    verdict: 'yes' | 'no' | 'no_verdict' | (string & {});
-    agreementPct: number | null;
-    dissent: number | null;
-    seats: string[];
-    reason: string | null;
-  } | null;
+  dispute: TeamDispute | null;
   /**
    * (T6, api-types 0.42.0) The enclosing location the finding id is minted over (git's funcname
    * heuristic). Omitted when file-level.
@@ -10333,3 +10390,71 @@ export interface ProductComposeResponse {
   /** How many requirements the draft was handed. */
   requirements: number;
 }
+
+// ── learn schedules (DES-learn-workflow §5) ────────────────────────────────────────────────────
+
+/** A learn schedule's last outcome: `launched` while its run is open; `refused` = the launch failed. */
+export type LearnScheduleOutcome = 'launched' | 'refused' | 'completed' | 'failed' | 'cancelled';
+
+/** One learned topic's refresh schedule (`GET /learn/schedules`). `id` = `<repoRef>:<slug>`. */
+export interface LearnSchedule {
+  id: string;
+  repoRef: string;
+  /** The topic's directory under `.wicked/knowledge/`. */
+  slug: string;
+  /** The topic in plain words (the refresh run's intent names it). */
+  topic: string;
+  projectId?: string;
+  /** Interval, 24..2160 hours. */
+  everyHours: number;
+  enabled: boolean;
+  /** ISO-8601. Missed intervals coalesce into one launch. */
+  nextDueAt: string;
+  lastRunId: string | null;
+  lastRunAt: string | null;
+  lastOutcome: LearnScheduleOutcome | null;
+  /** Consecutive refused launches (backoff = min(2^failures, 24) h). */
+  failures: number;
+  lastError: string | null;
+  /** The git tree id of `.wicked/knowledge/<slug>` last indexed into estate (null = never). */
+  indexedTree: string | null;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface LearnSchedulesResponse {
+  schedules: LearnSchedule[];
+}
+
+/** `PUT /learn/schedules/:id` (`:id` must equal `<repoRef>:<slug>`). */
+export interface LearnSchedulePutBody {
+  repoRef: string;
+  slug: string;
+  topic: string;
+  everyHours: number;
+  enabled?: boolean;
+  projectId?: string;
+}
+
+/** One learned topic of a repository (`GET /learn/topics?repoRef=`), read from `.wicked/knowledge/<slug>/`. */
+export interface LearnTopic {
+  slug: string;
+  title: string;
+  kind: 'topic' | 'event';
+  /** topic.json `refreshed_at` (else `created_at`), ISO-8601; null when absent. */
+  refreshedAt: string | null;
+  claims: { active: number; superseded: number; contradicted: number; retired: number };
+  /** The oldest `last_verified` among active claims (ISO-8601), null when none. */
+  oldestVerifiedAt: string | null;
+  /** Active claims not re-verified within the staleness window (2 intervals when scheduled, else 60 days). */
+  staleActive: number;
+  /** Distinct source URLs across the ledger. */
+  sources: number;
+  /** A plain-words reason a file could not be read, else null. */
+  problem: string | null;
+}
+
+export interface LearnTopicsResponse {
+  repoRef: string;
+  topics: LearnTopic[];
+}

package/package.json

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