@supercorks/krnl 0.1.7 → 0.1.13

package/README.md

@@ -68,7 +68,7 @@ Status and explanatory text share one row, for example **Done · Stopped in Code
 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.
+Kernel and this companion use the current protocol together.
 
 Repeated connection reuses the machine identity. Review changed hook commands in `/hooks` if Node
 moved. After updating Node, run `krnl connect codex` to refresh the service’s executable path.
@@ -81,10 +81,22 @@ projects with one accessible local folder. Git mappings default to a new worktre
 needed. Non-Git projects use their saved folder. Missing folders, multi-root projects, and disabled
 project hooks are explained beside that project in Kernel.
 
-Tested Codex capabilities: desktop **26.901.51231** with bundled CLI **0.153.4**. The companion prefers
+New Work checkouts live in Codex's configured worktree directory (normally
+`~/.codex/worktrees/<full-task-id>/<repository-name>`), so Desktop can group them under
+the selected saved project. Each task still has its own branch and checkout. Existing
+checkouts and their saved paths are preserved when the companion updates.
+
+Tested Codex capabilities: desktop **26.908.40834** with bundled CLI **0.154.0-alpha.6.2**. The companion prefers
 `/Applications/ChatGPT.app/Contents/Resources/codex`, falling back to `codex` on PATH. The app-server
 capabilities are experimental, so other Codex versions require verification.
 
+In Kernel, **Stop** beside **Open in Codex** interrupts the companion-owned first Work turn
+and releases the same saved task to desktop. Kernel shows **Stopping…** until release is
+confirmed, then **Stopped. Continue in Codex.** It stays open and does not send a new message,
+mark the Kernel task complete, or discard completed work. If confirmation takes longer than
+fifteen seconds, **Retry Stop** retains the same durable request. Desktop continuations, Drafts,
+and linked tasks have no Stop control in Kernel.
+
 The companion releases its first-turn app-server after completion or a request for input. Continue
 in desktop after that release; an interrupted structured question may be asked again. Kernel
 observes Running/Done across later desktop turns through hooks. It does not answer questions or
@@ -147,8 +159,25 @@ 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.
+accept desktop replies until that turn finishes or is released for input. Choose Plan inside Codex
+after opening a Draft; Kernel dispatches only Draft and Work.
+
+Both modes use the same concise instructions: gather context from the task before
+starting, and ask the user when something is unclear. Task details appear in a fenced YAML block,
+with null or empty fields omitted and meaningful `false` and `0` values preserved. Draft keeps
+its task title first and its automatic-linking reference in the YAML `href` field.
+The prompt also asks for approval for any proposed Kernel task updates when the work is done.
+
+CLI 0.1.12 requires the prompt rendered and frozen by Kernel at submission. It forwards that text
+unchanged and has no local prompt template. Future wording and YAML changes need only a web
+deployment. Work also requires resolved model/reasoning settings; neither is supplied by a legacy
+fallback. Heartbeats and status reports use the current format without feature negotiation.
+
+Deploy Kernel and update this companion together. Setup uses `krnl login` and `krnl connect codex`
+with all-saved-project consent; manual pairing and per-project allowlist commands are removed.
+For this one-time cutover, convert settled old launch receipts to current watch records while the
+service is stopped and its local lock is held. Preserve a private backup and all task IDs, status
+sequences and delivery state. Do not interrupt an active first turn to perform the cutover.
 
 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
@@ -169,7 +198,7 @@ Healthy tasks continue independently. Do not delete receipts or blocked records
 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
+Kernel expires machine connectivity after 30 seconds. 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
@@ -180,6 +209,22 @@ companion claims the launch; afterward, continue in Codex. Search has a separate
 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.
 
+## Shared threads (0.1.8+)
+
+One Codex thread can be linked to several Kernel tasks through each task's Existing task tab.
+Every linked task receives activity and waiting status; linking or completing a Codex turn does
+not change the Kernel tasks' lifecycle. Linking the same thread to the same task again is safe.
+Install the current CLI and run `krnl connect codex` with the current Kernel server.
+Hooks update every association and retain an event until all receipt writes succeed, including
+across restarts.
+
+CLI 0.1.13 adds first-turn ownership reports and durable stop delivery. Deploy the matching
+Kernel migration and web contract before updating this package. Startup enriches historical
+receipts with unknown ownership; it never assumes that a Desktop turn belongs to the companion.
+An accepted stop survives network failures. After restart, release is confirmed only when the
+saved owner's exit or process-identity replacement can be proved; inaccessible process metadata
+remains unknown. Wait for active first turns to finish before restarting the service to upgrade.
+
 ## Bundled third-party software
 
 This executable includes Zod under the following license: