Skip to content

Commit e7a4a4f

Browse files
ShadowfetchStudioShadowfetchStudio
committed
Release ShadowCode 0.21.0 flagship native workflow
1 parent 1cab5b7 commit e7a4a4f

39 files changed

Lines changed: 172 additions & 110 deletions

‎.github/workflows/native.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
name: Native desktop
22
on:
33
push:
4-
branches: [native-0.20]
4+
branches: [main, native-0.20]
55
pull_request:
66
paths: ['native/**', 'src-tauri/**', 'ui/**', 'licenses/native/**', 'packaging/native-runtime/**', 'scripts/*native*.mjs', 'scripts/native-packaging-env.sh', 'scripts/native-mcp-peer/**', 'Cargo.toml', 'Cargo.lock', '.github/workflows/native.yml', '.github/workflows/release.yml']
77
permissions:

‎README.md‎

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ context, tools, permissions, checkpoints, plans, and verification.
1010

1111
![ShadowCode workspace](docs/images/workspace-light.png)
1212

13-
**Native 0.20 development:** the `native-0.20` branch now builds a Rust/Tauri
14-
desktop window with the interface embedded in the executable. It needs no Python
15-
runtime or browser launcher. See the [native development guide](docs/NATIVE_DESKTOP.md)
13+
**Native 0.21 release:** the `main` branch builds a Rust/Tauri desktop window
14+
with the interface embedded in the executable. It needs no Python runtime or
15+
browser launcher. See the [native desktop guide](docs/NATIVE_DESKTOP.md)
1616
and the [goals](docs/NATIVE_GOALS.md) and [model routing](docs/NATIVE_ROUTING.md)
1717
workflows, [managed background processes and model tools](docs/NATIVE_BACKGROUND.md), and
1818
[native slash commands and project skills](docs/NATIVE_WORKFLOWS.md),
@@ -29,15 +29,13 @@ with Codex/Claude Code/Cursor registration output, and a
2929
that share the active desktop engine or run headlessly with their own profile.
3030
The [native desktop can also attach](docs/NATIVE_DESKTOP.md#attaching-to-a-running-engine)
3131
to a running headless/TUI engine and leave its work running when the window closes.
32-
Development AppImage and Debian
32+
Release AppImage and Debian
3333
packages include [dependency inventories and notices](licenses/native/README.md).
34-
Integrations and release checks are tracked under the [migration gates](docs/NATIVE_MIGRATION.md).
35-
The existing 0.19 release remains available until the native tag is verified and
36-
published.
34+
Integrations and release checks are tracked under the [release gates](docs/NATIVE_MIGRATION.md).
3735

3836
## Native AppImage
3937

40-
After the `v0.21.0` native release is tagged, download the **x86_64 AppImage**
38+
Download the `v0.21.0` **x86_64 AppImage**
4139
and its `SHA256SUMS` file from [GitHub releases](https://github.com/ShadowfetchLinux/ShadowCode/releases/latest).
4240
The native application embeds its interface; Python, Node.js and a browser
4341
launcher are not runtime dependencies. The release targets **Ubuntu 24.04 or
@@ -63,7 +61,7 @@ entry automatically. It replaces older ShadowCode AppImages only after the new
6361
executable starts, preserves settings, keys, memory and task history, and refuses
6462
a changed download before it can alter the installed application.
6563

66-
## Native 0.20 highlights
64+
## Native 0.21 highlights
6765

6866
- **A focused workspace.** Persistent projects and tasks, search, pinned tasks,
6967
a refined light/dark interface, and responsive layouts. Files, review, terminal,

‎docs/NATIVE_CLI.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
# Native command line — 0.20 development
1+
# Native command line — 0.21
22

33
The same `shadowcode` executable runs tasks in a terminal and opens the desktop.
44
CLI commands start before GTK or WebKit: they need no display, Python runtime,
55
Node runtime, browser, or HTTP listener. Model inference still runs in Ollama or
6-
your configured compatible provider. This guide describes the native development
7-
branch; [remaining release gates](NATIVE_MIGRATION.md) still apply.
6+
your configured compatible provider. This guide describes the supported native
7+
release; [release gates](NATIVE_MIGRATION.md) record its verification.
88

99
For a fullscreen workspace, use [`shadowcode tui`](NATIVE_TUI.md).
1010

‎docs/NATIVE_DESKTOP.md‎

Lines changed: 8 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,12 @@
1-
# Native desktop development — 0.20
1+
# Native desktop — 0.21
22

3-
The `native-0.20` branch builds one Rust desktop executable with the React
3+
The `main` branch builds one Rust desktop executable with the React
44
interface embedded. Tauri hosts it in the system WebKit webview. The interface
55
calls the Rust engine through IPC; desktop operation needs no HTTP listener,
66
Python interpreter, Node runtime, or browser launcher.
77

8-
This is a development build. The [full migration gates](NATIVE_MIGRATION.md)
9-
still apply, including orchestration/integration parity, packaging, broader UI
10-
stress tests, and installation. Keep the supported 0.19 installation until the
11-
native release is verified.
8+
This is the supported native release. The [release gates](NATIVE_MIGRATION.md)
9+
record the acceptance checks behind the published packages.
1210

1311
## Attaching to a running engine
1412

@@ -163,15 +161,10 @@ dependency resolution on the build host, and absence of Python interpreters,
163161
libraries, and sidecars. It also verifies the SHA-256 digest of every listed
164162
notice in each extracted package. It produces checksums in `artifacts/native-package/`.
165163

166-
The first verified CI packages contain an approximately 17.5 MB executable, an
167-
83 MB AppImage (including native GTK/WebKit libraries), and an 8.2 MB Debian
168-
package (using system GTK/WebKit). CI builds, inspects, and exercises the actual
169-
AppImage on Ubuntu 24.04, with development downloads retained for 14 days.
170-
The downloaded packages also passed inspection and the AppImage window workflow
171-
on the development machine. These remain development artifacts.
172-
Corresponding-source release artifacts, complete feature migration, and final
173-
release verification/installation are still required before publication as the
174-
supported download.
164+
The published packages are built and inspected on Ubuntu 24.04. The AppImage
165+
includes the native GTK/WebKit runtime; the Debian package uses the system
166+
libraries. Both packages are checked for embedded Python/Node runtimes and
167+
include dependency notices and matching SHA-256 checksums.
175168
Concurrent extraction-mode launches use independent private temporary directories.
176169
One CLI exit or secondary activation cannot remove a running window's files.
177170
The runtime regression checks concurrent owners, deferred resources, signals,

‎docs/NATIVE_GOALS.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Goals in the native desktop
22

3-
The native 0.20 development branch stores goals, milestones, their task IDs, and
3+
The native 0.21 release stores goals, milestones, their task IDs, and
44
run state in the same SQLite database as conversation history. Goals imported
55
from 0.19 retain their original checklist and completion state.
66

‎docs/NATIVE_HOOKS.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
1-
# Native lifecycle hooks — 0.20 development
1+
# Native lifecycle hooks — 0.21
22

33
Native hooks run explicitly enabled project commands at fixed points in an
44
agent task. They use the Rust process runner and need no Python interpreter or
5-
callback loader. This guide covers the native development branch; the
6-
[remaining release gates](NATIVE_MIGRATION.md) still apply.
5+
callback loader. This guide covers the supported native release; the
6+
[release gates](NATIVE_MIGRATION.md) record its verification.
77

88
[Project plugins](NATIVE_PLUGINS.md) can supply native hook definitions.
99
Installation leaves them disabled; review their exact commands here before

‎docs/NATIVE_INSPECTION.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Native project inspection, diagnostics and test jobs
22

3-
These workflows run in Rust on the `native-0.20` development branch. The desktop,
3+
These workflows run in Rust in the native 0.21 release. The desktop,
44
CLI and MCP server use the same project and task services. Python is needed only
55
when the user's project itself requires a Python test runner.
66

‎docs/NATIVE_MEMORY.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Native project and task notes
22

3-
The `native-0.20` development build keeps project notes in
3+
The native 0.21 build keeps project notes in
44
`.shadow/memory/project.md` and task notes in the profile's SQLite history.
55
These are explicit notes, distinct from model reasoning and recorded verification
66
results. No Python process is involved.

‎docs/NATIVE_MIGRATION.md‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
# Native desktop migration — 0.20
1+
# Native desktop release gates — 0.21
22

33
The target is a Python-free Rust application with a dedicated Tauri window and
4-
the existing React visual design. This document tracks engineering acceptance;
5-
0.19 remains the supported release until the native gates are proved.
4+
the existing React visual design. This document records the engineering
5+
acceptance gates for the published 0.21 release.
66

77
## Product and compatibility gates
88

@@ -184,8 +184,8 @@ Implemented foundation:
184184
and package inspection for Python runtimes or sidecars. Both packages contain
185185
application dependency notices; the AppImage adds an inventory and copyright
186186
texts for its actual bundled libraries. Package checks verify every listed
187-
notice's checksum. Corresponding-source artifacts and final release validation
188-
remain separate gates.
187+
notice's checksum. The published release includes the corresponding runtime
188+
source archive and SHA-256 manifest.
189189
- Clean Ubuntu 24.04 CI builds and tests both native package formats. The tagged
190190
native-release workflow repeats the Rust, UI, CLI, TUI, MCP, stress, window,
191191
package, runtime-source and packaged-app checks before it publishes checksummed
@@ -197,9 +197,9 @@ Implemented foundation:
197197
local AppImage probes exercise actual Ollama gpt-oss and Qwen coding tasks,
198198
approvals, saved continuation, streaming cancellation, and checkpoint rewind.
199199

200-
The remaining orchestration/integrations, full desktop interaction/stress
201-
coverage, and release packaging are still in progress. The native
202-
branch is not yet a replacement for the 0.19 release.
200+
The native release gates are complete for the published 0.21 Linux packages.
201+
Future work can extend provider and platform coverage without changing the
202+
release's Python-free runtime contract.
203203

204204
The [native MCP client](NATIVE_MCP.md) has bounded Rust stdio and Streamable HTTP
205205
transports, inert Settings/CLI registration, explicit project/content activation, lazy tool

‎docs/NATIVE_PLUGINS.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Native project plugins — 0.20 development
1+
# Native project plugins — 0.21
22

33
A native plugin installs a reviewed collection of skills, slash commands,
44
lifecycle hooks and MCP definitions into one project. The desktop and CLI use

0 commit comments

Comments
 (0)