@supercorks/krnl 0.1.4 → 0.1.5

package/README.md

@@ -58,6 +58,7 @@ krnl connect codex
 
 Version **0.1.1 or later** is required to launch with mapping model and reasoning settings.
 Version **0.1.2 or later** also supports linking an existing Codex task.
+Version **0.1.5 or later** adds durable delivery recovery, cancellation support, and task-status freshness when the Kernel server supports it.
 Version **0.1.3 or later** supports mapping task name prefixes. For example, a prefix of `👩‍⚕️`
 creates `👩‍⚕️ MELLA-284: Investigate an issue`. A blank prefix keeps the normal name. Project
 mapping settings take precedence over organization settings, and changes apply only to new tasks.
@@ -147,6 +148,32 @@ Interrupted draft dispatch is not repeated automatically. If Kernel cannot confi
 Codex before opening another draft. Hooks inspect only the submitted prompt to match a pending
 reference; they do not retain or upload the edited prompt or read transcripts.
 
+## Network recovery (0.1.5+)
+
+Heartbeats, project discovery, local observations, task launches, and delivery run independently.
+Temporary network failures and server throttling retry automatically with bounded backoff and
+`Retry-After` support. Local receipt acknowledgments and retry progress survive a restart. A lost
+creation or turn acknowledgment is reconciled without executing the task again. Expired launch
+offers are never executed after reconnecting.
+
+`krnl status` also shows the last successful delivery, pending and blocked counts, oldest pending
+age, and recovery instructions. Permanently rejected items and damaged journals remain on disk
+for diagnosis. This command reads local diagnostics and works without network access.
+Healthy tasks continue independently. Do not delete receipts or blocked records to retry
+an uncertain launch. Remote revocation stops dispatch; run `krnl login` and `krnl connect codex`
+to authorize again. A connection replaced by another process requires `krnl connect codex`.
+
+Kernel expires machine connectivity after 30 seconds. With a compatible server it also expires
+each task observation after at most 90 seconds; a heartbeat alone does not make an old task
+status current. Uncertain or expired observations show Disconnected until trustworthy evidence
+returns. Supported Codex metadata cannot reconstruct every missed desktop event, especially a
+turn already running or waiting for input. Open the task in Codex when its state cannot be verified.
+
+Kernel's launch form offers Cancel during extended waits. Cancellation is effective before the
+companion claims the launch; afterward, continue in Codex. Search has a separate Cancel action,
+a 30-second total deadline, and never applies late results after cancellation. Browser timeouts
+preserve input and cached content so the same request can be reconciled safely.
+
 ## Bundled third-party software
 
 This executable includes Zod under the following license: