Merge pull request #41 from AlleyBo55/kiro/windows-linux-transparency

Kiro/windows linux transparency

Author: AlleyBo55

README.md

@@ -57,12 +57,19 @@ We built this with tears in our eyes, remembering every episode, every gadget, e
 
 ---
 
-## 🆕 One more thing — Doraemon now lives in your IDE. In **792 kilobytes.**
+## 🆕 One more thing — your Kiro agent has a heartbeat.
+
+### Doraemon Coding Companion: a Shimeji-style Kiro desktop pet in **792 kilobytes**
+
+A spinner tells you to wait. Doraemon tells you what is happening.
 
 Install one Kiro extension. Doraemon walks out of the editor and onto your
-desktop — transparent, always on top, draggable, throwable.
+desktop — always on top, draggable, throwable, and reacting to code, tests,
+errors, Git, terminals, debugging and Kiro's AI agent status.
+
+Nothing else to download. No API key. No account. No telemetry. Fully offline.
 
-Nothing else to download. No API key. No account. No network call, ever.
+[**Install Doraemon Coding Companion from Open VSX →**](https://open-vsx.org/extension/AlleyBo55/doraemon-coding-companion)
 
 ### The part nobody else did
 
@@ -79,8 +86,8 @@ Ours is **792 KB**.
 
 Same 247 sprites. Same physics engine. Same everything.
 
-Because 288 lines of Rust borrow the webview your operating system already
-shipped. macOS has WebKit. Windows has WebView2. Linux has WebKitGTK.
+Because a small native Rust companion borrows the webview your operating system
+already shipped. macOS has WebKit. Windows has WebView2. Linux has WebKitGTK.
 
 **Nobody needs a second copy of Chromium to animate a cartoon cat.**
 
@@ -109,8 +116,9 @@ so it can ask the OS. *That is the whole reason this works.*
 
 ### Honest small print
 
-- Built and verified on **macOS arm64**. CI builds Windows, Linux and Intel Mac; those are unverified by hand.
-- A downloaded build needs Apple notarization to clear Gatekeeper. Measured: a quarantined binary starts and prints nothing.
+- CI builds Apple Silicon Mac, Intel Mac, Windows x64 and Linux x64. macOS arm64 is verified end to end; Windows and Linux render, while the 0.1.2 transparency fix still needs field validation.
+- macOS is ad-hoc signed, not notarized. The extension detects quarantine and asks before clearing it from the bundled companion only.
+- Wayland prevents applications from positioning their own windows, so Doraemon animates in place there. X11 restores desktop walking.
 - "Waiting on approval" is **inferred** from the agent going quiet, because Kiro has no such hook trigger. A slow tool looks the same from outside.
 - Approving from the bubble is deliberately not built. It would stall the agent while you're away.
 

kiro-extension/.vscodeignore

@@ -11,3 +11,7 @@ tsconfig.json
 # Rust sources and build artifacts. The compiled binary is staged into bin/
 # by scripts/build-companion.mjs and shipped from there.
 companion/**
+
+# Scratch files scripts leave in dist/. Only the two bundles belong in a VSIX,
+# and a stale one from a verification run was shipping before this rule existed.
+dist/.*

kiro-extension/README.md

@@ -1,12 +1,29 @@
-# Doraemon Coding Companion
+# Doraemon Coding Companion: Kiro Desktop Pet
 
-**A real desktop pet. Inside your IDE. In one install.**
+<p align="center">
+  <a href="https://open-vsx.org/extension/AlleyBo55/doraemon-coding-companion"><img src="https://img.shields.io/open-vsx/v/AlleyBo55/doraemon-coding-companion?label=Open%20VSX&color=1677ff" alt="Open VSX version"></a>
+  <a href="https://open-vsx.org/extension/AlleyBo55/doraemon-coding-companion"><img src="https://img.shields.io/open-vsx/dt/AlleyBo55/doraemon-coding-companion?label=downloads&color=1f9d55" alt="Open VSX downloads"></a>
+  <a href="#platform-support"><img src="https://img.shields.io/badge/macOS%20%C2%B7%20Windows%20%C2%B7%20Linux-supported-20232a" alt="macOS, Windows and Linux"></a>
+  <a href="#privacy"><img src="https://img.shields.io/badge/privacy-fully%20offline-f2b84b" alt="Fully offline"></a>
+</p>
 
-Doraemon walks across your desktop, climbs your windows, naps when you go quiet,
-and tells you when Kiro needs you. Transparent. Always on top. Draggable.
-Throwable.
+## Your AI agent got smarter. Its status indicator didn't.
 
-Install the extension. That's the whole setup.
+A spinner tells you to wait. Doraemon tells you what is happening.
+
+**Doraemon Coding Companion is a Shimeji-style Kiro desktop pet, AI coding
+companion and floating desktop mascot for macOS, Windows and Linux.** He walks
+across your screen and reacts to code, saves, tests, errors, Git, terminals,
+debugging and Kiro's agent status.
+
+Most coding extensions ask you to open another panel. Doraemon walks out of Kiro
+and meets you on the desktop: borderless, always on top, draggable and throwable.
+
+**One Kiro extension. No separate app. No account. No telemetry. Fully offline.**
+
+[**Install from Kiro's Open VSX marketplace →**](https://open-vsx.org/extension/AlleyBo55/doraemon-coding-companion)
+
+[Download the latest universal VSIX](https://github.com/AlleyBo55/doraemon/releases/latest)
 
 ---
 
@@ -23,31 +40,29 @@ window, the same 247 sprites, the same physics engine.
 | Electron runtime | 274 MB |
 | **Doraemon companion** | **792 KB** |
 
-Not a trick, and not a compromise. The companion is 288 lines of Rust wrapping
-the webview your operating system already has. macOS has WebKit. Windows has
+Not a trick, and not a compromise. A small native Rust companion wraps the
+webview your operating system already has. macOS has WebKit. Windows has
 WebView2. Linux has WebKitGTK. Nobody needs a second copy of Chromium to animate
 a cartoon cat.
 
 The whole extension is **4.5 MB to download**, and 92% of that is the artwork.
 
 ---
 
-## Install
+## Install in Kiro
 
-```bash
-cd kiro-extension
-npm install
-npm run package
-```
+1. Open **Extensions** in Kiro (`Ctrl+Shift+X` on Windows/Linux,
+   `Cmd+Shift+X` on macOS).
+2. Search for **Doraemon Coding Companion** or
+   `AlleyBo55.doraemon-coding-companion`.
+3. Select the extension published by **AlleyBo55** and choose **Install**.
+4. Reload Kiro if it asks. Doraemon launches on your desktop automatically.
 
-```bash
-/Applications/Kiro.app/Contents/Resources/app/bin/code \
-  --install-extension doraemon-coding-companion-0.1.0.vsix
-```
-
-Reload the window. Doraemon appears on your desktop.
+Prefer a file? Download the
+[latest universal VSIX](https://github.com/AlleyBo55/doraemon/releases/latest),
+then run **Extensions: Install from VSIX...** from Kiro's command palette.
 
-No desktop app. No API key. No account. No network call, ever.
+No separate desktop app. No API key. No account. No network call, ever.
 
 ---
 
@@ -201,6 +216,34 @@ the IDE cannot wedge anything. Reliability beat the demo.
 
 ---
 
+## Frequently asked questions
+
+### Is this a Kiro extension or a separate desktop app?
+
+It is one Kiro extension. The tiny native companion that creates the transparent,
+always-on-top window is bundled inside the extension and exits with Kiro. There
+is no second installer or background service.
+
+### Is this a Shimeji desktop pet?
+
+Yes. Doraemon uses Shimeji-style physics: walking, climbing, falling, bouncing,
+dragging and throwing. Unlike a decorative mascot, he also reacts to real editor,
+terminal, Git, debugger, diagnostics and Kiro agent events.
+
+### Does it work on macOS, Windows and Linux?
+
+Platform-specific builds are published for Apple Silicon Mac, Intel Mac, Windows
+x64 and Linux x64. Linux transparency needs a compositing window manager; Wayland
+also prevents applications from positioning their own windows, so Doraemon
+animates in place there. See [Platform support](#platform-support).
+
+### Does Doraemon send my code to an AI service?
+
+No. The extension is fully offline and has no telemetry. It reads local editor
+events only long enough to choose a reaction; nothing leaves your machine.
+
+---
+
 ## Settings
 
 | Setting | Default | Meaning |
@@ -267,49 +310,44 @@ to the IDE's process ID, so a hard kill never leaves an orphaned cat on screen.
 | Sidebar mode | verified | yes | yes | yes |
 | Window mode | verified | yes | yes | yes |
 | All 33 signals | verified | yes | yes | yes |
-| Desktop mode | **verified** | not built | not built | not built |
+| Desktop binary | **verified** | CI-built | CI-built | CI-built |
+| Desktop rendering | **verified** | needs field validation | renders; 0.1.2 transparency fix needs field validation | renders; 0.1.2 transparency fix needs field validation |
 
-Sidebar and window mode are pure editor APIs and behave identically everywhere.
-Activity detection too.
+Sidebar and window mode use editor APIs and behave identically everywhere.
+Activity detection does too.
 
-Desktop mode needs the companion compiled for each platform. `darwin-arm64`,
-`darwin-x64`, `win32-x64` and `linux-x64` are built and published. The resolver
-looks for `bin/<platform>-<arch>/`, so adding a platform is a build step rather
-than a code change — but until that build exists, those users fall back to window
-or sidebar mode. `linux-arm64`, `linux-armhf` and `win32-arm64` are not built
-yet.
+Desktop binaries are built and published for `darwin-arm64`, `darwin-x64`,
+`win32-x64` and `linux-x64`. The resolver looks for
+`bin/<platform>-<arch>/`; users on an architecture without a binary fall back to
+window mode. `linux-arm64`, `linux-armhf` and `win32-arm64` are not built yet.
 
-Linux additionally needs a compositing window manager for transparency, and
-WebKitGTK at runtime. On Wayland the mascot appears and animates but cannot walk,
-because the protocol does not let an application position its own window. X11
-sessions have the full range of movement.
+Linux needs WebKitGTK and a compositing window manager for transparency. On
+Wayland the mascot appears and animates but cannot walk, because the protocol
+does not let applications position their own windows. X11 sessions have the full
+range of movement.
 
 ---
 
 ## Known limits
 
-Read this part before shipping it to anyone.
-
-**macOS Gatekeeper will block a downloaded build.** The companion is ad-hoc
-signed, not notarized. Measured, same binary, same command:
+**macOS is ad-hoc signed, not notarized.** Downloads can arrive with Apple's
+quarantine flag, which stops the companion before it starts. The extension
+detects this and asks for explicit consent to clear the flag from its bundled
+binary only. Declining keeps the security control intact and falls back to window
+mode. Full notarization still requires an Apple Developer ID.
 
-| | Output | Started |
-|---|---|---|
-| Local build | `mascot window ready` | yes |
-| With `com.apple.quarantine` | *nothing* | **no** |
-
-A VSIX from a marketplace carries that quarantine flag. It works locally only
-because a locally compiled binary has no flag. Fixing this needs an Apple
-Developer ID with notarization, or stripping the attribute on first run — which
-is deliberately defeating a security control and should be your call.
+**Windows and Linux transparency in 0.1.2 needs field validation.** Both native
+branches compile and package in CI. Windows and Linux users confirmed that the
+mascot renders; 0.1.2 changes how each platform composites the transparent
+surface, and still needs confirmation on real machines before it is called
+verified.
 
-**Only one platform is built.** See the table above.
+**Wayland cannot provide full movement.** It deliberately prevents applications
+from positioning their own windows, so Doraemon animates in place. Use an X11
+session for desktop walking.
 
 **Approve-in-bubble is not implemented.** By choice, explained above.
 
-**Linux desktop mode has never been compiled or run.** The reasoning is sound
-and the crates support it; that is not the same as working.
-
 ---
 
 ## Development
@@ -318,7 +356,7 @@ and the crates support it; that is not the same as working.
 npm run watch            # rebuild JS on change
 npm run typecheck        # tsc --noEmit
 npm run build-companion  # cargo release build, stages into bin/
-npm test                 # typecheck + build + 29 host checks
+npm test                 # typecheck + build + 34 host checks
 npm run release          # platform-specific VSIX into release/
 ```
 

kiro-extension/companion/Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "doraemon-companion"
-version = "0.1.1"
+version = "0.1.2"
 edition = "2021"
 description = "Floating Doraemon mascot window driven by the Kiro extension"
 license = "MIT"

kiro-extension/companion/Cargo.toml

@@ -49,10 +49,23 @@ enum UserEvent {
     Command(String),
     /// User clicked the bubble; bring the IDE forward.
     RaiseIde,
+    /// Time to force the webview to recomposite. Windows only; the other two
+    /// platforms composite the transparent surface correctly on first paint.
+    #[cfg(target_os = "windows")]
+    Repaint,
     /// The IDE that spawned us is gone.
     ParentGone,
 }
 
+/// WebView2 leaves an opaque surface over a transparent window until something
+/// forces it to recomposite, so the mascot arrives inside a white box that only
+/// clears if the user resizes the window. A one-pixel resize round-trip is the
+/// cheapest way to trigger that ourselves. Scheduled a beat after the renderer
+/// reports its first frame, because nudging before anything has painted has
+/// nothing to recomposite.
+#[cfg(target_os = "windows")]
+const REPAINT_DELAY: Duration = Duration::from_millis(120);
+
 /// Brings the IDE window back to the front. An extension cannot un-minimise its
 /// own window, but we are a separate process, so we can ask the OS.
 /// Release builds are linked as a GUI subsystem app, so they own no console.
@@ -268,6 +281,17 @@ fn main() -> wry::Result<()> {
                 Some("openIde") => {
                     let _ = ipc_proxy.send_event(UserEvent::RaiseIde);
                 }
+                // Delayed off the event loop deliberately: sleeping inside the
+                // handler would stall the message pump and prevent the very
+                // paint we are waiting to recomposite.
+                #[cfg(target_os = "windows")]
+                Some("ready") => {
+                    let nudge = ipc_proxy.clone();
+                    thread::spawn(move || {
+                        thread::sleep(REPAINT_DELAY);
+                        let _ = nudge.send_event(UserEvent::Repaint);
+                    });
+                }
                 _ => {}
             }
         })
@@ -283,7 +307,19 @@ fn main() -> wry::Result<()> {
     let webview = {
         use tao::platform::unix::WindowExtUnix;
         use wry::WebViewBuilderExtUnix;
-        webview_builder.build_gtk(window.gtk_window())?
+
+        /*
+         * Hand wry the GtkBox rather than the window. tao fills the window's
+         * single child slot with a vertical box by default, and wry dispatches on
+         * container type: a GtkBox is packed, while anything else falls through to
+         * `add`, which GTK refuses on an already-occupied GtkBin. wry's own
+         * example passes the window, which only holds for windows built without
+         * that default box.
+         */
+        match window.default_vbox() {
+            Some(vbox) => webview_builder.build_gtk(vbox)?,
+            None => webview_builder.build_gtk(window.gtk_window())?,
+        }
     };
     #[cfg(not(target_os = "linux"))]
     let webview = webview_builder.build(&window)?;
@@ -317,6 +353,12 @@ fn main() -> wry::Result<()> {
 
             Event::UserEvent(UserEvent::RaiseIde) => raise_ide(),
 
+            #[cfg(target_os = "windows")]
+            Event::UserEvent(UserEvent::Repaint) => {
+                window.set_inner_size(LogicalSize::new(WINDOW_W + 1.0, WINDOW_H + 1.0));
+                window.set_inner_size(LogicalSize::new(WINDOW_W, WINDOW_H));
+            }
+
             Event::UserEvent(UserEvent::ParentGone) => {
                 println!("[companion] parent exited, shutting down");
                 *control_flow = ControlFlow::Exit;

kiro-extension/companion/src/main.rs

@@ -1,8 +1,8 @@
 {
   "name": "doraemon-coding-companion",
-  "displayName": "Doraemon Coding Companion",
-  "description": "A real desktop pet, not a sidebar widget. Doraemon walks across your screen and reacts to saves, failing tests, red diagnostics and Kiro's agent. One install, 792 KB, fully offline.",
-  "version": "0.1.1",
+  "displayName": "Doraemon Coding Companion: Kiro Desktop Pet",
+  "description": "A Shimeji-style Kiro desktop pet and AI coding companion for macOS, Windows and Linux. Doraemon reacts to code, tests, errors, Git, terminals, debugging and agent status—offline in one install.",
+  "version": "0.1.2",
   "publisher": "AlleyBo55",
   "license": "MIT",
   "author": "AlleyBo55",
@@ -11,15 +11,15 @@
     "url": "git+https://github.com/AlleyBo55/doraemon.git",
     "directory": "kiro-extension"
   },
-  "homepage": "https://github.com/AlleyBo55/doraemon#readme",
+  "homepage": "https://github.com/AlleyBo55/doraemon/tree/master/kiro-extension#readme",
   "bugs": {
     "url": "https://github.com/AlleyBo55/doraemon/issues"
   },
   "engines": {
     "vscode": "^1.84.0"
   },
   "categories": ["Other"],
-  "keywords": ["doraemon", "shimeji", "desktop-pet", "mascot", "companion", "kiro", "agent-status", "floating"],
+  "keywords": ["doraemon", "kiro", "kiro-extension", "desktop-pet", "desktop-mascot", "coding-companion", "ai-coding-companion", "ai-agent", "ai-agent-monitor", "agent-status", "agent-monitor", "shimeji", "virtual-pet", "coding-pet", "code-mascot", "developer-companion", "developer-tools", "productivity", "coding", "tests", "git", "terminal", "debugging", "diagnostics", "offline", "floating", "always-on-top", "macos", "windows", "linux"],
   "icon": "media/icon.png",
   "main": "./dist/extension.js",
   "activationEvents": ["onStartupFinished"],
@@ -99,8 +99,8 @@
           "enum": ["auto", "desktop", "window", "sidebar"],
           "default": "auto",
           "enumDescriptions": [
-            "Use the desktop app if installed, otherwise open a detached window.",
-            "Transparent mascot floating freely over the desktop. Requires the Doraemon desktop app.",
+            "Launch the bundled desktop mascot, with a detached-window fallback when unavailable.",
+            "Transparent, borderless, always-on-top desktop mascot. The native companion is bundled; no separate app is required.",
             "A separate OS window outside the IDE frame, movable to any monitor. No extra install needed.",
             "Docked in the sidebar panel."
           ],
@@ -109,7 +109,7 @@
         "doraemon.desktopAppPath": {
           "type": "string",
           "default": "",
-          "description": "Full path to the Doraemon desktop app executable. Leave empty to auto-detect."
+          "description": "Optional path to an external Doraemon executable. Leave empty to use the bundled desktop companion."
         },
         "doraemon.showThoughts": {
           "type": "boolean",