@supercorks/krnl 0.1.2 → 0.1.5

package/README.md

@@ -1,8 +1,8 @@
 # Kernel CLI
 
-Connect [Kernel](https://app.krnl.work) to Codex on your Mac. Choose **Launch in Codex** on a Kernel task, review Plan/Work mode, destination, model, reasoning,
-and folder options in the popup, then open the same task in Codex. Conversations and approvals stay in Codex; Kernel
-shows execution status and a direct link.
+Connect [Kernel](https://app.krnl.work) to Codex on your Mac. Choose **Link to Codex** → **New task**
+on a Kernel task, then choose Draft or Work and a destination. Work also lets you set model and
+reasoning. Conversations and approvals stay in Codex; Kernel shows execution status and a direct link.
 
 ## Install and connect
 
@@ -27,7 +27,7 @@ tasks afterward. The companion detects completed review automatically.
 
 Open **Settings → Integrations → Codex** in Kernel to map an organization or project to a saved
 Codex project. Your Mac and saved projects appear automatically. Each connection card contains its organization and
-project mappings. Choose **Add mapping** or **Edit** to set the destination, model, and reasoning.
+project mappings. Choose **Add mapping** or **Edit** to set the destination, model, reasoning, and an optional task name prefix.
 New mappings default to **GPT-6 Astra · xhigh**; choices come from that Mac’s current Codex model
 catalog. Launches stay disabled until setup is ready; one unavailable project does not disable
 healthy projects. **Delete connection** revokes its authorization and removes its mappings, while
@@ -58,6 +58,10 @@ 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.
 Kernel explains when an older companion needs this update; existing task monitoring continues.
 
 Repeated connection reuses the machine identity. Review changed hook commands in `/hooks` if Node
@@ -86,7 +90,7 @@ handoff history when the existing connection is still authorized.
 
 ## Link an existing task
 
-On a Kernel task, choose **Link existing task**. Search by the current Codex task title
+On a Kernel task, choose **Link to Codex**, then the **Existing task** tab. Search by the current Codex task title
 (at least three characters) or paste a `codex://threads/<task-id>` link, select the match,
 and choose **Link task**. Choose a Mac if more than one is connected. Only tasks in
 compatible, locally authorized saved projects appear. Archived tasks are labeled.
@@ -127,6 +131,49 @@ will reconcile creation before retrying an acknowledgement and will not repeat a
 
 Homebrew, a native setup app, and a one-command `npx` setup flow are not included in this release.
 
+## Draft and Work (0.1.4+)
+
+Draft opens Codex with the saved task prepared in its composer. Choose Plan in Codex if you want,
+then send. Keep the Kernel link in the prompt: its reference lets the local status hook associate
+the new thread automatically. Kernel shows the pending draft until submission, then a direct
+thread link and Running/Done status. If you remove the reference, link the thread through Kernel's
+Existing task tab using its deep link or a title search.
+
+Draft uses the saved project folder and desktop model/reasoning settings. Work applies the mapping's
+settings and starts the first turn through app-server; the task is visible in desktop but cannot
+accept desktop replies until that turn finishes or is released for input. Legacy Plan receipts
+remain supported. Upgrading preserves existing tasks, worktrees, receipts, and hook paths.
+
+Interrupted draft dispatch is not repeated automatically. If Kernel cannot confirm opening, check
+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: