Foundational Harness Improvements

.env.example

@@ -1,6 +1,7 @@
-# Code Puppy API Keys Configuration
-# Copy this file to .env and fill in your API keys
-# The .env file takes priority over ~/.code_puppy/puppy.cfg
+# Mist API Keys Configuration
+# Copy this file to .env and fill in your API keys.
+# The .env file takes priority over ~/.mist/mist.cfg
+# (Legacy path ~/.code_puppy/puppy.cfg is still read on first run and migrated.)
 
 # OpenAI API Key
 # OPENAI_API_KEY=sk-...

.github/workflows/ci.yml

@@ -115,3 +115,22 @@ jobs:
 
       - name: Check formatting with ruff
         run: ruff format --check .
+
+  bun-tests:
+    name: Bun/TS tests
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ts
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Run tests
+        run: bun test

.github/workflows/native-release.yml

@@ -0,0 +1,93 @@
+name: Native release
+
+on:
+  workflow_dispatch:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: write
+
+jobs:
+  binary:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-24.04
+            platform: linux-x64
+            archive: tar
+          - os: macos-15-intel
+            platform: macos-x64
+            archive: tar
+          - os: macos-15
+            platform: macos-arm64
+            archive: tar
+          - os: windows-2022
+            platform: windows-x64
+            archive: zip
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Build standalone executable
+        shell: bash
+        run: |
+          python -m pip install --upgrade pip pyinstaller
+          python -m pip install .
+          pyinstaller --clean --noconfirm packaging/mist.spec
+          dist/mist --version || dist/mist.exe --version
+      - name: Package Unix executable
+        if: matrix.archive == 'tar'
+        shell: bash
+        run: tar -C dist -czf "mist-${{ matrix.platform }}.tar.gz" mist
+      - name: Package Windows executable
+        if: matrix.archive == 'zip'
+        shell: pwsh
+        run: Compress-Archive -Path dist/mist.exe -DestinationPath mist-${{ matrix.platform }}.zip
+      - name: Build Linux AppImage
+        if: matrix.platform == 'linux-x64'
+        shell: bash
+        run: |
+          mkdir -p Mist.AppDir/usr/bin
+          cp dist/mist Mist.AppDir/usr/bin/mist
+          cp packaging/appimage/mist.desktop Mist.AppDir/mist.desktop
+          cp mist_logo.png Mist.AppDir/mist.png
+          printf '#!/bin/sh\nexec "$APPDIR/usr/bin/mist" "$@"\n' > Mist.AppDir/AppRun
+          chmod +x Mist.AppDir/AppRun
+          curl -fsSL -o appimagetool https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage
+          chmod +x appimagetool
+          ARCH=x86_64 ./appimagetool --appimage-extract-and-run Mist.AppDir mist-linux-x64.AppImage
+      - uses: actions/upload-artifact@v4
+        with:
+          name: mist-${{ matrix.platform }}
+          path: |
+            mist-${{ matrix.platform }}.*
+
+  publish:
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: binary
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: mist-*
+          merge-multiple: true
+          path: release
+      - name: Generate package-manager manifests
+        shell: bash
+        run: |
+          version="${GITHUB_REF_NAME#v}"
+          linux_sha=$(sha256sum release/mist-linux-x64.tar.gz | cut -d' ' -f1)
+          mac_x64_sha=$(sha256sum release/mist-macos-x64.tar.gz | cut -d' ' -f1)
+          mac_arm_sha=$(sha256sum release/mist-macos-arm64.tar.gz | cut -d' ' -f1)
+          win_sha=$(sha256sum release/mist-windows-x64.zip | cut -d' ' -f1)
+          sed -e "s/@VERSION@/$version/g" -e "s/@LINUX_X64_SHA256@/$linux_sha/g" -e "s/@MACOS_X64_SHA256@/$mac_x64_sha/g" -e "s/@MACOS_ARM64_SHA256@/$mac_arm_sha/g" packaging/homebrew/mist.rb.template > release/mist.rb
+          sed -e "s/@VERSION@/$version/g" -e "s/@WINDOWS_X64_SHA256@/$win_sha/g" packaging/scoop/mist.json.template > release/mist.json
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: release/*
+          generate_release_notes: true

.gitignore

@@ -45,3 +45,4 @@ code_puppy/bundled_skills/
 .claude/hooks/ts-hooks/dist/
 
 .json
+node_modules/

AGENTS.md

@@ -1,17 +1,26 @@
-# Contributing to Code Puppy
-
-> **Golden rule:** nearly all new functionality should be a **plugin** under `code_puppy/plugins/`
-> that hooks into core via `code_puppy/callbacks.py`. Don't edit `code_puppy/command_line/`.
+# Contributing to Mist
+
+> **⚠️ Legacy Python contributor guide.** Mist is now the **Bun/TypeScript**
+> application in [`ts/`](ts/). New features belong there — see the
+> [Development](README.md#development) section of the README. The plugin system
+> documented below belongs to the deprecated `code_puppy/` package (kept as
+> `mist-py`, bug-fix-only) and is tracked for porting in
+> [`docs/BUN_MIGRATION_PLAN.md`](docs/BUN_MIGRATION_PLAN.md). It is preserved
+> here for contributors still working on the legacy Python codebase.
+>
+> **Legacy golden rule (Python only):** nearly all new functionality should be a
+> **plugin** under `code_puppy/plugins/` that hooks into core via
+> `code_puppy/callbacks.py`. Don't edit `code_puppy/command_line/`.
 
 ## How Plugins Work
 
 Plugins are discovered from three tiers, loaded in order:
 
 | Tier | Location | When to use |
 |------|----------|-------------|
-| **Builtin** | `code_puppy/plugins/<name>/register_callbacks.py` | Core functionality shipped with Code Puppy |
-| **User** | `~/.code_puppy/plugins/<name>/register_callbacks.py` | Personal plugins, applied to every project |
-| **Project** | `<CWD>/.code_puppy/plugins/<name>/register_callbacks.py` | Repo-specific plugins, shared with your team via git |
+| **Builtin** | `code_puppy/plugins/<name>/register_callbacks.py` | Core functionality shipped with Mist |
+| **User** | `~/.mist/plugins/<name>/register_callbacks.py` | Personal plugins, applied to every project |
+| **Project** | `<CWD>/.mist/plugins/<name>/register_callbacks.py` | Repo-specific plugins, shared with your team via git |
 
 All three tiers use the same pattern — drop a `register_callbacks.py` in a named subdirectory:
 
@@ -28,14 +37,14 @@ That's it. The plugin loader auto-discovers `register_callbacks.py` in subdirs.
 
 ### Project Plugins
 
-Project plugins live at `<CWD>/.code_puppy/plugins/<name>/register_callbacks.py`.
-This mirrors the project-level discovery already used by agents (`<CWD>/.code_puppy/agents/`)
-and skills (`<CWD>/.code_puppy/skills/`).
+Project plugins live at `<CWD>/.mist/plugins/<name>/register_callbacks.py`.
+This mirrors the project-level discovery already used by agents (`<CWD>/.mist/agents/`)
+and skills (`<CWD>/.mist/skills/`).
 
 **Key details:**
 
-- **Directory must be created intentionally.** Code Puppy will never auto-create
-  `.code_puppy/plugins/` — your team opts in by creating it.
+- **Directory must be created intentionally.** Mist will never auto-create
+  `.mist/plugins/` — your team opts in by creating it.
 - **Load order is builtin → user → project.** Project plugins load last, giving
   them highest precedence for override-style hooks.
 - **Project wins on name collision.** If a project plugin shares a name with a
@@ -83,7 +92,7 @@ Full list + rarely-used hooks: see `code_puppy/callbacks.py` source.
 
 1. **Plugins over core** — if a hook exists for it, use it
 2. **One `register_callbacks.py` per plugin** — register at module scope
-3. **600-line hard cap** — split into submodules
+3. **Cohesive modules** — split along responsibility boundaries, not line counts
 4. **Fail gracefully** — never crash the app
 5. **Return `None` from commands you don't own**
 6. **Always run linters - `ruff check --fix`, `ruff format .`