Hmbown · Hmbown · Aug 23, 2026 · Aug 20, 2026 · Aug 20, 2026 · Aug 20, 2026
@@ -162,7 +162,7 @@ $:
               echo "ERROR: CNB_COMMIT ${commit_sha} does not match checkout ${checkout_sha}" >&2
               exit 1
             fi
-            export DEEPSEEK_BUILD_SHA="$commit_sha"
+            export CODEWHALE_BUILD_SHA="$commit_sha"
             cargo build --jobs 2 --release --locked \
               --target x86_64-unknown-linux-musl \
               -p codewhale-cli   # single binary

@@ -52,6 +52,7 @@ angziii = angziii <177907677+angziii@users.noreply.github.com>
 aboimpinto = aboimpinto <1231687+aboimpinto@users.noreply.github.com>
 Paulo Aboim Pinto = aboimpinto <1231687+aboimpinto@users.noreply.github.com>
 aboimpinto@gmail.com = aboimpinto <1231687+aboimpinto@users.noreply.github.com>
+paulo.aboim.pinto@gmail.com = aboimpinto <1231687+aboimpinto@users.noreply.github.com>
 encyc = encyc <62669951+encyc@users.noreply.github.com>
 Duducoco = Duducoco <69681789+Duducoco@users.noreply.github.com>
 cyq1017 = cyq1017 <61975706+cyq1017@users.noreply.github.com>
@@ -66,6 +67,7 @@ THINKER-ONLY = THINKER-ONLY <181556007+THINKER-ONLY@users.noreply.github.com>
 nightt5879 = nightt5879 <87569709+nightt5879@users.noreply.github.com>
 LmeSzinc = LmeSzinc <37934724+LmeSzinc@users.noreply.github.com>
 Lstarsky0 = Lstarsky0 <59827030+Lstarsky0@users.noreply.github.com>
+RepentStar = RepentStar <87593085+RepentStar@users.noreply.github.com>
 CCChisato = Fushimi Rio <158128433+CCChisato@users.noreply.github.com>
 aznikline = aznikline <27564626+aznikline@users.noreply.github.com>
 Aznable = aznikline <27564626+aznikline@users.noreply.github.com>

@@ -230,7 +230,7 @@ assert.match(releaseStaticSmoke, /"\$\{bin_path\}" --version/);
 const builtAssetNames = [
   ...valuesForKey(artifacts, "cli_artifact"),
   ...valuesForKey(artifacts, "shim_artifact"),
-  ...valuesForKey(artifacts, "tui_artifact"),
+  ...valuesForKey(artifacts, "compat_tui_artifact"),
 ];
 assert.equal(builtAssetNames.length, 21);
 assert.deepEqual(
@@ -242,7 +242,7 @@ assert.deepEqual(
 );
 assert.match(
   artifacts,
-  /stage_binary "\$\{\{ matrix\.cli_binary \}\}" "\$\{\{ matrix\.tui_artifact \}\}"/,
+  /stage_binary "\$\{\{ matrix\.cli_binary \}\}" "\$\{\{ matrix\.compat_tui_artifact \}\}"/,
   "legacy TUI bridge assets must be staged from the one compiled codewhale binary",
 );
 const bundleInvocations = [...bundles.matchAll(
@@ -463,7 +463,7 @@ assert.ok(cnbSmoke > cnbAlias, "CNB release preflight must materialize codew bef
 const cnbTagRelease = cnb.match(/\$:\n  tag_push:\n([\s\S]*)$/);
 assert.ok(cnbTagRelease, "CNB must retain a tag release pipeline");
 const cnbTagStamp = cnbTagRelease[1].indexOf(
-  'export DEEPSEEK_BUILD_SHA="$commit_sha"',
+  'export CODEWHALE_BUILD_SHA="$commit_sha"',
 );
 const cnbTagBuild = cnbTagRelease[1].indexOf(
   "cargo build --jobs 2 --release --locked \\",

@@ -135,7 +135,7 @@ jobs:
                 workflow=true
                 ;;
             esac
-            # Mobile runtime surface: the `codewhale-tui serve --mobile`
+            # Mobile runtime surface: the `codewhale serve --mobile`
             # HTTP/SSE stack that scripts/mobile-smoke.sh exercises. Pull
             # requests run the smoke only when one of these changes; every
             # push to main still runs it unconditionally as the pre-release

@@ -21,7 +21,7 @@ env:
   CARGO_TERM_COLOR: always
   CARGO_INCREMENTAL: 0
   RUSTFLAGS: -Dwarnings
-  DEEPSEEK_BUILD_SHA: ${{ github.sha }}
+  CODEWHALE_BUILD_SHA: ${{ github.sha }}
 
 jobs:
   build:

@@ -26,7 +26,7 @@ env:
   RUSTFLAGS: -Dwarnings
   # Build identity is the trusted workflow SHA. Callers pass source_sha only
   # so `pin` can refuse a mismatch; it must not retarget checkout or caches.
-  DEEPSEEK_BUILD_SHA: ${{ github.sha }}
+  CODEWHALE_BUILD_SHA: ${{ github.sha }}
 
 jobs:
   pin:
@@ -67,55 +67,55 @@ jobs:
             shim_binary: codew
             cli_artifact: codewhale-linux-x64
             shim_artifact: codew-linux-x64
-            tui_artifact: codewhale-tui-linux-x64
+            compat_tui_artifact: codewhale-tui-linux-x64
           - os: ubuntu-24.04-arm
             target: aarch64-unknown-linux-musl
             platform: linux-arm64
             cli_binary: codewhale
             shim_binary: codew
             cli_artifact: codewhale-linux-arm64
             shim_artifact: codew-linux-arm64
-            tui_artifact: codewhale-tui-linux-arm64
+            compat_tui_artifact: codewhale-tui-linux-arm64
           - os: ubuntu-latest
             target: aarch64-linux-android
             platform: android-arm64
             cli_binary: codewhale
             shim_binary: codew
             cli_artifact: codewhale-android-arm64
             shim_artifact: codew-android-arm64
-            tui_artifact: codewhale-tui-android-arm64
+            compat_tui_artifact: codewhale-tui-android-arm64
           - os: macos-latest
             target: x86_64-apple-darwin
             platform: macos-x64
             cli_binary: codewhale
             shim_binary: codew
             cli_artifact: codewhale-macos-x64
             shim_artifact: codew-macos-x64
-            tui_artifact: codewhale-tui-macos-x64
+            compat_tui_artifact: codewhale-tui-macos-x64
           - os: macos-latest
             target: aarch64-apple-darwin
             platform: macos-arm64
             cli_binary: codewhale
             shim_binary: codew
             cli_artifact: codewhale-macos-arm64
             shim_artifact: codew-macos-arm64
-            tui_artifact: codewhale-tui-macos-arm64
+            compat_tui_artifact: codewhale-tui-macos-arm64
           - os: windows-latest
             target: x86_64-pc-windows-msvc
             platform: windows-x64
             cli_binary: codewhale.exe
             shim_binary: codew.exe
             cli_artifact: codewhale-windows-x64.exe
             shim_artifact: codew-windows-x64.exe
-            tui_artifact: codewhale-tui-windows-x64.exe
+            compat_tui_artifact: codewhale-tui-windows-x64.exe
           - os: windows-11-arm
             target: aarch64-pc-windows-msvc
             platform: windows-arm64
             cli_binary: codewhale.exe
             shim_binary: codew.exe
             cli_artifact: codewhale-windows-arm64.exe
             shim_artifact: codew-windows-arm64.exe
-            tui_artifact: codewhale-tui-windows-arm64.exe
+            compat_tui_artifact: codewhale-tui-windows-arm64.exe
     runs-on: ${{ matrix.os }}
     needs: pin
     steps:
@@ -253,10 +253,10 @@ jobs:
 
           stage_binary "${{ matrix.cli_binary }}" "${{ matrix.cli_artifact }}"
           stage_binary "${{ matrix.shim_binary }}" "${{ matrix.shim_artifact }}"
-          # One-release compatibility bridge for v0.9.4's hard-coded release
+          # Compatibility bridge for v0.9.4's hard-coded release
           # completeness/updater contract. This is the same runtime, not a
-          # separately compiled TUI binary.
-          stage_binary "${{ matrix.cli_binary }}" "${{ matrix.tui_artifact }}"
+          # separately compiled or installed TUI command.
+          stage_binary "${{ matrix.cli_binary }}" "${{ matrix.compat_tui_artifact }}"
       - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         with:
           name: ${{ matrix.cli_artifact }}
@@ -273,8 +273,8 @@ jobs:
           overwrite: true
       - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         with:
-          name: ${{ matrix.tui_artifact }}
-          path: ${{ matrix.tui_artifact }}
+          name: ${{ matrix.compat_tui_artifact }}
+          path: ${{ matrix.compat_tui_artifact }}
           if-no-files-found: error
           retention-days: ${{ inputs.retention_days }}
           overwrite: true

@@ -153,7 +153,7 @@ jobs:
           platforms: linux/amd64,linux/arm64
           push: true
           build-args: |
-            DEEPSEEK_BUILD_SHA=${{ needs.resolve.outputs.sha }}
+            CODEWHALE_BUILD_SHA=${{ needs.resolve.outputs.sha }}
           tags: |
             ${{ steps.image.outputs.name }}:${{ needs.resolve.outputs.tag }}
             ${{ steps.image.outputs.name }}:${{ needs.resolve.outputs.version }}

@@ -1,7 +1,7 @@
 # Hmbown.CodeWhale — winget singleton manifest for CodeWhale (single binary)
-# This is a mirror of packaging/winget/Hmbown.CodeWhale.yaml for tooling that expects .winget/.
-# Keep both in sync; the canonical source is packaging/winget/Hmbown.CodeWhale.yaml.
-# See packaging/winget/README.md for update instructions.
+# PackageIdentifier follows the publisher convention used by the Homebrew formula (codewhale).
+# Canonical maintenance instructions live in packaging/winget/README.md; the generator mirrors these exact bytes to .winget/.
+# Winget installs only `codewhale` + `codew`; compatibility release filenames are not installed commands.
 
 PackageIdentifier: Hmbown.CodeWhale
 PackageVersion: 0.9.6
@@ -19,10 +19,10 @@ LicenseUrl: https://github.com/Hmbown/CodeWhale/blob/main/LICENSE
 Copyright: Copyright (c) Hmbown
 ShortDescription: Terminal coding agent for supported hosted and local models
 Description: |
-  CodeWhale is a terminal coding agent that runs on your machine. The v0.9.5 single-binary
+  CodeWhale is a terminal coding agent that runs on your machine. The v0.9.5+ single-binary
   release ships one `codewhale` binary per target (plus the `codew` shim) across Linux x64 (musl),
   Linux arm64, Android arm64, macOS x64/arm64, and Windows x64/arm64. See https://github.com/Hmbown/CodeWhale
-  for provider setup, Fleet workflows, and the full install guide.
+  for provider setup, Fleet workflows, and the full install guide (docs/INSTALL.md).
 Author: Hmbown
 Moniker: codewhale
 Tags:
@@ -37,16 +37,31 @@ Tags:
 MinimumOSVersion: 10.0.0.0
 ReleaseNotes: https://github.com/Hmbown/CodeWhale/releases/tag/v0.9.6
 ReleaseNotesUrl: https://github.com/Hmbown/CodeWhale/releases/tag/v0.9.6
+InstallationNotes: |
+  The winget package installs the Windows binaries. For the NSIS installer (CodeWhaleSetup.exe)
+  the installer adds %LOCALAPPDATA%\Programs\CodeWhale\bin to the user PATH. For the portable
+  ZIP, winget extracts codewhale.exe and codew.exe side-by-side and adds the install location to PATH.
+  Verify checksums with codewhale-artifacts-sha256.txt from the same GitHub Release.
+Documentations:
+  - DocumentLabel: Install guide
+    DocumentUrl: https://github.com/Hmbown/CodeWhale/blob/main/docs/INSTALL.md
+  - DocumentLabel: Releases
+    DocumentUrl: https://github.com/Hmbown/CodeWhale/releases
 
 Installers:
+  # Preferred: NSIS installer for Windows x64 (per-user, no elevation, adds user PATH).
   - Architecture: x64
     InstallerType: nullsoft
     Scope: user
     InstallerUrl: https://github.com/Hmbown/CodeWhale/releases/download/v0.9.6/CodeWhaleSetup.exe
     InstallerSha256: 040afa01a70ddae4ea7783e563bacd962a512b4d288ee5c5c5111ef2760755a7
     ProductCode: CodeWhale
     UpgradeBehavior: install
+    FileExtensions:
+      - toml
     ReleaseDate: 2026-08-12
+  # Portable ZIP fallback — same single binary (codewhale.exe + codew.exe). Used when NSIS is blocked
+  # by policy or for winget's portable install flow. NestedInstallerType is portable (no installer).
   - Architecture: x64
     InstallerType: zip
     Scope: user

@@ -35,6 +35,12 @@ instructions or memory. The nearest scoped `AGENTS.md` adds path-specific rules.
   `agent_open`/`agent_eval`/`agent_close`/`delegate_to_agent` surfaces or parallel
   lifecycle/tag systems.
 - `BASE_PROMPT` in `crates/tui/src/prompts/text.rs` is the sole base prompt.
+- There is exactly one turn loop: `Engine::run_turn` in
+  `crates/tui/src/core/engine/turn_loop.rs`. Note that `crates/tui/src/core/`
+  is a module inside the TUI crate — it is not `crates/core`, which owns
+  request construction, bounded fragments, and thread/session types and
+  runs no turns. Do not add a second loop beside the one that exists; a
+  guard test (`crates/core/tests/single_turn_loop.rs`) fails if you do.
 - The system prompt + tool catalog are a session-pinned KV-cache prefix
   (`docs/CACHE.md`). Any new session-context contributor must state its
   KV-cache effect: frozen prefix vs. append-only history. Never splice a