@supercorks/krnl 0.1.4 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -58,6 +58,13 @@ krnl connect codex
58
58
 
59
59
  Version **0.1.1 or later** is required to launch with mapping model and reasoning settings.
60
60
  Version **0.1.2 or later** also supports linking an existing Codex task.
61
+ Version **0.1.5 or later** adds durable delivery recovery, cancellation support, and task-status freshness when the Kernel server supports it.
62
+ Version **0.1.6 or later** recognizes interrupted turns with a saved completion timestamp as Done
63
+ with “Stopped in Codex.”, including after reconnecting. An interrupted status without that timestamp
64
+ remains uncertain because it can also describe a turn still running in desktop.
65
+ Version **0.1.7 or later** keeps the Kernel card's title synchronized with renames in Codex,
66
+ including completed tasks, when the server supports it. This does not rename the Kernel task.
67
+ Status and explanatory text share one row, for example **Done · Stopped in Codex.**
61
68
  Version **0.1.3 or later** supports mapping task name prefixes. For example, a prefix of `👩‍⚕️`
62
69
  creates `👩‍⚕️ MELLA-284: Investigate an issue`. A blank prefix keeps the normal name. Project
63
70
  mapping settings take precedence over organization settings, and changes apply only to new tasks.
@@ -147,6 +154,32 @@ Interrupted draft dispatch is not repeated automatically. If Kernel cannot confi
147
154
  Codex before opening another draft. Hooks inspect only the submitted prompt to match a pending
148
155
  reference; they do not retain or upload the edited prompt or read transcripts.
149
156
 
157
+ ## Network recovery (0.1.5+)
158
+
159
+ Heartbeats, project discovery, local observations, task launches, and delivery run independently.
160
+ Temporary network failures and server throttling retry automatically with bounded backoff and
161
+ `Retry-After` support. Local receipt acknowledgments and retry progress survive a restart. A lost
162
+ creation or turn acknowledgment is reconciled without executing the task again. Expired launch
163
+ offers are never executed after reconnecting.
164
+
165
+ `krnl status` also shows the last successful delivery, pending and blocked counts, oldest pending
166
+ age, and recovery instructions. Permanently rejected items and damaged journals remain on disk
167
+ for diagnosis. This command reads local diagnostics and works without network access.
168
+ Healthy tasks continue independently. Do not delete receipts or blocked records to retry
169
+ an uncertain launch. Remote revocation stops dispatch; run `krnl login` and `krnl connect codex`
170
+ to authorize again. A connection replaced by another process requires `krnl connect codex`.
171
+
172
+ Kernel expires machine connectivity after 30 seconds. With a compatible server it also expires
173
+ each task observation after at most 90 seconds; a heartbeat alone does not make an old task
174
+ status current. Uncertain or expired observations show Disconnected until trustworthy evidence
175
+ returns. Supported Codex metadata cannot reconstruct every missed desktop event, especially a
176
+ turn already running or waiting for input. Open the task in Codex when its state cannot be verified.
177
+
178
+ Kernel's launch form offers Cancel during extended waits. Cancellation is effective before the
179
+ companion claims the launch; afterward, continue in Codex. Search has a separate Cancel action,
180
+ a 30-second total deadline, and never applies late results after cancellation. Browser timeouts
181
+ preserve input and cached content so the same request can be reconciled safely.
182
+
150
183
  ## Bundled third-party software
151
184
 
152
185
  This executable includes Zod under the following license: