wicked-core-ts 0.7.16 → 0.7.17

package/index.d.ts

@@ -439,7 +439,12 @@ export declare class Core {
    * passes it through verbatim as the pinned wire contract):
    * `{ results: [{ sample: { id, description, kind, steering_type }, expected: "deny"|"allow",
    * fired: [rule-id…], verdict: "caught"|"gap"|"false_positive", nearest_rules? }],
-   * summary: { total, caught, gaps, false_positives }, degraded: "facet-only"|null }`.
+   * summary: { total, caught, gaps, false_positives }, degraded: "facet-only"|null,
+   * rule_coverage: { exercised, unexercised: [{ rule_id, steering_type }], recall_only,
+   * per_type: { <steering-type>: { exercised, unexercised } } } }` — `rule_coverage` (core#394)
+   * partitions the decide-lane rules eligible for the run (narrowed to `type` when given) by
+   * whether any sample fired them; `recall_only` counts the effect-less rules the gate never
+   * fires (core#395 — zero decide-lane rules means the verdicts are the corpus split).
    *
    * Fail-closed: malformed args, an unknown steering type, a corpus name outside the
    * `evals:` scope, or a missing store reject the Promise with the engine's reason — crew maps
@@ -600,7 +605,9 @@ export declare class Subscription {
  * A CoreEvent, delivered as a JSON string to the {@link Core.subscribe} callback. Discriminated on
  * `type`. Fields vary by variant (see wicked-core `CoreEvent`): e.g.
  * `sessionStarted` `{session, problem}`, `unitPlanned` `{session, ord, description}`,
- * `unitDistributed` `{session, ord, cli}`, `awaitingHuman` `{session, ord, prompt}`,
+ * `unitDistributed` `{session, ord, cli, routingMethod, seatConstraint}` (`seatConstraint` is
+ * `null` unless the unit's skill narrowed the candidate seats before the council voted),
+ * `awaitingHuman` `{session, ord, prompt}`,
  * `gateDecided` `{session, ord, allow}`, `unitDone`/`unitExecuting`/`resumed` `{session, ord}`,
  * `sessionCompleted` `{session}`, `sessionFailed` `{session, ord}`, `error` `{session, message}`.
  * PTY terminal sessions emit `terminalOpened` `{id, cwd}`, `terminalOutput` `{id, seq, bytesB64}`
@@ -612,4 +619,37 @@ export interface CoreEventJson {
   ord?: number
   [k: string]: unknown
 }
+
+/**
+ * The `unitDistributed` event — a CLI was assigned to a unit — as delivered to the
+ * {@link Core.subscribe} callback: the shape to read a parsed {@link CoreEventJson} as once
+ * `type === 'unitDistributed'`. Every field is emitted unconditionally; the engine's `Option`
+ * fields arrive as `null`, never absent. Pinned against wicked-core's `event_to_json` by the
+ * binding's own tests (`cargo test` in this crate) and asserted at compile time by
+ * `types-test/` (`npm run typecheck`).
+ */
+export interface UnitDistributedEventJson extends CoreEventJson {
+  type: 'unitDistributed'
+  session: string
+  ord: number
+  /** The roster key of the assigned seat. */
+  cli: string
+  /** How the seat was chosen: the council verdict, a degrade to the first candidate, an
+   * evaluator ≠ creator reassignment, or a deterministic tool execution. */
+  routingMethod: 'council' | 'degraded' | 'evaluator_distinct' | 'tool'
+  agreementPct: number | null
+  returned: number | null
+  /** Seats convened for the council that produced this assignment (`null` = unknown). */
+  seated: number | null
+  dissent: number | null
+  degradedReason: string | null
+  /**
+   * WHY the candidate seats were narrowed BEFORE the council voted (core#401): the unit's skill
+   * (or a transitive mandate) is `portable: false` in the handed skills snapshot — or the root is
+   * the Claude-only live-cache fallback — so only a claude seat could be handed it, and the
+   * council chose among those. `null` when every roster seat was a candidate. Additive:
+   * `routingMethod` and its fields read exactly as before.
+   */
+  seatConstraint: string | null
+}
 // ─── end hand-authored ───

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-core-ts",
-  "version": "0.7.16",
+  "version": "0.7.17",
   "description": "Node/TypeScript bindings (napi-rs) for wicked-core: drive the in-process orchestration engine from JS/TS.",
   "license": "MIT",
   "repository": {
@@ -39,16 +39,18 @@
     "smoke:lifecycle": "node smoke-lifecycle.mjs",
     "smoke:terminal": "node smoke-terminal.mjs",
     "smoke:evals": "node smoke-evals.mjs",
-    "smoke:all": "node smoke.mjs && node smoke-lifecycle.mjs && node smoke-terminal.mjs && node smoke-evals.mjs"
+    "smoke:all": "node smoke.mjs && node smoke-lifecycle.mjs && node smoke-terminal.mjs && node smoke-evals.mjs",
+    "typecheck": "tsc --noEmit -p types-test/tsconfig.json"
   },
   "optionalDependencies": {
-    "wicked-core-ts-darwin-arm64": "0.7.16",
-    "wicked-core-ts-darwin-x64": "0.7.16",
-    "wicked-core-ts-linux-arm64-gnu": "0.7.16",
-    "wicked-core-ts-linux-x64-gnu": "0.7.16",
-    "wicked-core-ts-win32-x64-msvc": "0.7.16"
+    "wicked-core-ts-darwin-arm64": "0.7.17",
+    "wicked-core-ts-darwin-x64": "0.7.17",
+    "wicked-core-ts-linux-arm64-gnu": "0.7.17",
+    "wicked-core-ts-linux-x64-gnu": "0.7.17",
+    "wicked-core-ts-win32-x64-msvc": "0.7.17"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^2.18.4"
+    "@napi-rs/cli": "^2.18.4",
+    "typescript": "~6.0.2"
   }
 }