wicked-core-ts 0.7.23 → 0.7.25

package/index.d.ts

@@ -38,6 +38,13 @@ export interface LaunchOptions {
   entityMode?: string
   /** Human-confirm gate policy: `none` (default) | `all` | `before:<ord>`. */
   humanConfirm?: string
+  /**
+   * EXPLICIT opt-out of the engine's deliver gate (F-E2E-030). The run's `deliver` Tool unit
+   * (the crew-composed phase that pushes the run branch and opens the PR) pauses for a human
+   * before it runs — whatever `humanConfirm` says — unless this is `true`. Omit (or `false`)
+   * for the gate; `true` only when the caller has named the launch "auto-deliver" to its user.
+   */
+  autoDeliver?: boolean
   /** The id of a registered repo to run within (creates an isolated worktree). Omit for a repo-less run. */
   repoRef?: string
   /**
@@ -111,6 +118,21 @@ export declare class Core {
    * `sinceBoot` from a boot baseline; an addon without this static answers `null` there.
    */
   static eventStoreCount(dbPath: string): Promise<string>
+  /**
+   * The state-home PREFLIGHT crew runs at `serve` (wicked-core#411 / wicked-crew#497): survey
+   * the state home the worker Read fence classifies and report every entry its registry cannot
+   * classify — the condition that would otherwise refuse EVERY worker launch, discovered today
+   * at the run's first worker after a planning council and the intake gate. `snapshotPath` is
+   * the published generation crew hands the engine (`WICKED_SKILLS_SNAPSHOT`; the state home is
+   * derived from its shape), or absent when none is handed — the store's parent (`dbPath`) is
+   * then surveyed for information. Resolves to the JSON `{ stateHome, derivedFrom:
+   * 'snapshot' | 'db' | null, unregistered: [{ name, path, level }], refusesLaunches, error,
+   * remedy }` — `refusesLaunches` is true exactly when a handed snapshot derives a state home
+   * with unregistered entries, which is also what `launchRun` now rejects synchronously with a
+   * typed configuration error (no session persisted). Read-only; never touches the process
+   * environment. An addon without this static answers `null` in crew's `GET /diagnostics.stateHome`.
+   */
+  static preflightStateHome(snapshotPath: string | undefined | null, dbPath: string): Promise<string>
   /**
    * Replay a dead-letter outbox — the emit seam's NDJSON spool (`WICKED_APPS_EMIT_DEADLETTER`)
    * of governance events it could not store — into the estate store at `dbPath`, writing each
@@ -680,6 +702,30 @@ export declare class Subscription {
  * carrier, role, tool, command, reason, remedy} (a worker seat's `git push` / `gh pr create` /
  * `gh api` mutation refused — delivery is the deliver phase's job); acpFallback.fallbackKind gains
  * 'auth_failed' | 'unauthenticated' (no single-shot fallback follows an auth kind).
+ * F-E2E-030/029/028 additions (all additive): awaitingHuman carries `gateKind: 'run_level' | 'def' |
+ * 'deliver' | 'terminal' | 'escalation' | 'failure' | 'triage'` (WHY the run paused — key on it,
+ * never on the prompt's wording; the engine's deliver gate is 'deliver'); workerToolCallDenied.reason
+ * may start with 'install fence:' (a package-manager install outside the unit's worktree, judged
+ * from the seat's shell cwd tracked across its tool calls — best-effort, never hermetic);
+ * sandboxPosture {session, ord, cli, posture: 'os' | 'advisory', reason} (the write containment
+ * the assigned seat runs under — 'advisory' = no OS write boundary on the seat record, command-text
+ * fences + worktree guard only); worktreeRetained {session, path, reason} (a terminal run's worktree
+ * kept because it holds uncommitted work — cancel included).
+ * core#468 (additive): unitDispatched carries `baseSkill: {name, role} | null` — the run's
+ * role-keyed BASE skill directive (`role` is 'creator' | 'evaluator' | 'neutral'), null when the
+ * run declares none; the generation it is handed from is the same unit's skillsSnapshotHanded.gen.
+ * core#467/#469/F-RC2-009 additions (all additive): repoChecksEvaluated carries `outcome: 'passed' |
+ * 'failed' | 'timed_out' | 'not_run'` (a timed-out floor denies under source 'repo_checks_timeout',
+ * never 'repo_checks'), `floor: 'creator' | 'verify'`, `claim: {phrase, check, verdict} | null` and
+ * `env: {home, tmpdir, locale, network, sandboxLevel, path, passthrough} | null`; every `checks[]`
+ * entry carries `outcome`, `boundS`, `boundNote`, `failureIds`, `classification: 'regression' |
+ * 'pre_existing_in_sandbox' | 'floor_env_mismatch' | null` (only a regression denies), `preExisting`,
+ * `regressions` and `base: {head, cached, run, error} | null` (the same check run on the run base).
+ * core#461 (additive): unitDistributed.distinctnessFallback ('creator_seat' | null — the
+ * evaluator ≠ creator fallback as a field, see UnitDistributedEventJson); gateEscalated.condition
+ * gains the class 'dead_seat' (denialSource 'dead_seat'): a worker exited on a dead-seat refusal
+ * (signed out / quota / not installed) and no eligible seat remains — the attended run pauses at
+ * the escalation gate instead of failing.
  */
 export interface CoreEventJson {
   type: string
@@ -719,6 +765,14 @@ export interface UnitDistributedEventJson extends CoreEventJson {
    * `routingMethod` and its fields read exactly as before.
    */
   seatConstraint: string | null
+  /**
+   * (core#461) The evaluator ≠ creator DISCLOSURE as a field: `'creator_seat'` when a review/test
+   * unit STAYS on a seat that built what it checks because no eligible seat distinct from the
+   * builders admits it — a single-eligible-seat roster, or a bench that emptied the pool
+   * (`degradedReason` then says which). `null` otherwise. The fallback seat is always a
+   * still-eligible one: a benched or dead seat is never the fallback. Additive.
+   */
+  distinctnessFallback: 'creator_seat' | null
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-core-ts",
-  "version": "0.7.23",
+  "version": "0.7.25",
   "description": "Node/TypeScript bindings (napi-rs) for wicked-core: drive the in-process orchestration engine from JS/TS.",
   "license": "MIT",
   "repository": {
@@ -43,11 +43,11 @@
     "typecheck": "tsc --noEmit -p types-test/tsconfig.json"
   },
   "optionalDependencies": {
-    "wicked-core-ts-darwin-arm64": "0.7.23",
-    "wicked-core-ts-darwin-x64": "0.7.23",
-    "wicked-core-ts-linux-arm64-gnu": "0.7.23",
-    "wicked-core-ts-linux-x64-gnu": "0.7.23",
-    "wicked-core-ts-win32-x64-msvc": "0.7.23"
+    "wicked-core-ts-darwin-arm64": "0.7.25",
+    "wicked-core-ts-darwin-x64": "0.7.25",
+    "wicked-core-ts-linux-arm64-gnu": "0.7.25",
+    "wicked-core-ts-linux-x64-gnu": "0.7.25",
+    "wicked-core-ts-win32-x64-msvc": "0.7.25"
   },
   "devDependencies": {
     "@napi-rs/cli": "^2.18.4",