Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
464 changes: 281 additions & 183 deletions CHANGELOG.md

Large diffs are not rendered by default.

18 changes: 9 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ maps service tasks, user tasks, gateways, and timers to Weave steps.

## What you get

The **v0.1.0a15 alpha** release provides the **API, CLI, Python SDK, and Studio**
The **v0.1.0a16 alpha** release provides the **API, CLI, Python SDK, and Studio**
visual workspace, with human-task inboxes, email conversations, execution
management, and administration of people and access. Run Weave as a standalone
service or embed it in another product.
Expand Down Expand Up @@ -81,7 +81,7 @@ See the illustrated [AI workflow guide](docs/guides/ai-workers.md) and
Read the [capability matrix](docs/capabilities.md) for tested boundaries and
live-provider checks that remain environment-specific.

Studio runs in your browser from the [installed CLI](docs/guides/studio.md#install-the-alpha15-browser-application)
Studio runs in your browser from the [installed CLI](docs/guides/studio.md#install-the-alpha16-browser-application)
or as a [desktop app](docs/guides/desktop.md). The macOS desktop bundles
are ad-hoc signed, not Developer ID signed or notarized, so macOS may ask you to
approve them; do not use the alpha5 macOS installers, which were damaged. The
Expand Down Expand Up @@ -119,20 +119,20 @@ integration code. Each has its own guide, so you can stop at the result you need
## Install and discover the CLI

On macOS, Linux, or WSL, install **Python 3.12 or newer** with `venv` support,
then run this block in Bash or Zsh. It installs the pinned **v0.1.0a15 alpha**
then run this block in Bash or Zsh. It installs the pinned **v0.1.0a16 alpha**
into your user account without `sudo`, Git, or Docker:

```sh
(
# Stop if downloading the installer fails.
set -o pipefail
curl --proto '=https' --tlsv1.2 -fsSL \
https://github.com/fireflyframework/firefly-weave/releases/download/v0.1.0a15/install.sh \
| sh -s -- --version v0.1.0a15
https://github.com/fireflyframework/firefly-weave/releases/download/v0.1.0a16/install.sh \
| sh -s -- --version v0.1.0a16
)
```

Expected: `Installed Firefly Weave 0.1.0a15:` followed by the command's path. Then
Expected: `Installed Firefly Weave 0.1.0a16:` followed by the command's path. Then
make the default command directory available in this terminal and look around:

```sh
Expand All @@ -146,7 +146,7 @@ weave help workflow
weave docs platform
```

Expected: `Firefly Weave 0.1.0a15`, the command overview, the `workflow`
Expected: `Firefly Weave 0.1.0a16`, the command overview, the `workflow`
commands, and the address of the platform guide. You do not need to learn every
command first: help explains each family and its next steps. The
[installation guide](docs/installation.md) covers choosing Python, a permanent
Expand Down Expand Up @@ -179,7 +179,7 @@ Compose files and setup helpers. Clone the tag that matches the CLI:

```sh
# Keep the platform files at the same version as the CLI.
git clone --branch v0.1.0a15 --single-branch https://github.com/fireflyframework/firefly-weave.git
git clone --branch v0.1.0a16 --single-branch https://github.com/fireflyframework/firefly-weave.git
cd firefly-weave

# Check prerequisites, then start a persistent Docker platform and a sign-in account.
Expand Down Expand Up @@ -265,7 +265,7 @@ path, and the detailed diagrams.

## Current release and limits

The recommended installation is **v0.1.0a15**, an **alpha** release. Download
The recommended installation is **v0.1.0a16**, an **alpha** release. Download
packages and checksums from
[GitHub Releases](https://github.com/fireflyframework/firefly-weave/releases).
The documentation on a branch describes the source on that branch; a release tag
Expand Down
8 changes: 4 additions & 4 deletions desktop/RELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,16 +17,16 @@ SPDX-License-Identifier: Apache-2.0
-->
# Desktop release versions

The alpha15 product version is `0.1.0-alpha.15` in npm, Cargo and Tauri. It corresponds
to Python `0.1.0a15` and the repository prerelease tag `v0.1.0a15`.
The alpha16 product version is `0.1.0-alpha.16` in npm, Cargo and Tauri. It corresponds
to Python `0.1.0a16` and the repository prerelease tag `v0.1.0a16`.

Windows MSI uses the explicit numeric version `0.1.15`. Tauri's pinned bundler rejects
Windows MSI uses the explicit numeric version `0.1.16`. Tauri's pinned bundler rejects
nonnumeric prerelease identifiers when deriving MSI versions; its `windows.wix.version`
override supplies the valid numeric installer version while filenames retain the product
version. MSI compares only the first three fields. Future desktop alpha and stable
releases must advance this numeric installer counter: the stable product `0.1.0`
must not reset the MSI counter to `0.1.0`. The macOS internal bundle version also uses
numeric `0.1.15`; its displayed product version remains the alpha product version.
numeric `0.1.16`; its displayed product version remains the alpha product version.

The Desktop installers workflow builds on four native runners and is dispatchable by
an exact branch/tag ref. Versioned, target-specific unsigned artifacts contain only
Expand Down
4 changes: 2 additions & 2 deletions desktop/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion desktop/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@firefly-weave/desktop",
"version": "0.1.0-alpha.15",
"version": "0.1.0-alpha.16",
"private": true,
"license": "Apache-2.0",
"scripts": {
Expand Down
2 changes: 1 addition & 1 deletion desktop/src-tauri/Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion desktop/src-tauri/Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@

[package]
name = "firefly-weave-studio"
version = "0.1.0-alpha.15"
version = "0.1.0-alpha.16"
description = "Firefly Weave Studio desktop"
authors = ["Firefly Software Foundation"]
license = "Apache-2.0"
Expand Down
6 changes: 3 additions & 3 deletions desktop/src-tauri/tauri.conf.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"$schema": "https://schema.tauri.app/config/2",
"productName": "Firefly Weave Studio",
"version": "0.1.0-alpha.15",
"version": "0.1.0-alpha.16",
"identifier": "io.getfirefly.weave.studio",
"build": {
"frontendDist": "../bootstrap"
Expand Down Expand Up @@ -53,7 +53,7 @@
"y": 160
}
},
"bundleVersion": "0.1.15",
"bundleVersion": "0.1.16",
"signingIdentity": "-",
"entitlements": "entitlements.plist"
},
Expand All @@ -62,7 +62,7 @@
"type": "downloadBootstrapper"
},
"wix": {
"version": "0.1.15"
"version": "0.1.16"
}
},
"icon": [
Expand Down
4 changes: 2 additions & 2 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ gives the steps and what you finish with.
| An administrator | Install the platform, configure sign-in, and give people access | [Start a local platform](guides/local-platform.md) | [Identity and secrets](operations/identity-and-secrets.md), [remote deployment](operations/remote-deployment.md), [people and access](guides/people-and-access.md), and [configuration](operations/configuration.md) |
| An operator | Keep runs healthy, fix incidents, upgrade, and back up | [Connect the CLI](guides/connect-to-api.md), then [manage runs](guides/execution-management.md) | [Incidents](reference/incident-operations.md), [troubleshooting](operations/troubleshooting.md), [observability](operations/observability.md), [upgrades](operations/upgrades.md), [backup](operations/backup-restore.md), and [debug-session retention](operations/retention.md) |

Start each path by [installing the CLI](installation.md) from the v0.1.0a15
Start each path by [installing the CLI](installation.md) from the v0.1.0a16
release.

[Who does what](guides/roles-and-lifecycle.md) explains these roles with an
Expand Down Expand Up @@ -101,7 +101,7 @@ Run one command block, check its **Expected** result, then continue. Comments
inside code blocks explain why each command is there. When a terminal shows
server logs, keep it open and use a second terminal for client commands.

The guides pin the **v0.1.0a15 alpha** release, a preview, which includes every
The guides pin the **v0.1.0a16 alpha** release, a preview, which includes every
feature they describe, such as saved platforms, REST calls without code, and the
Studio editor. When a guide shows how to work with an alpha6 or earlier client
or server, it says so.
Expand Down
10 changes: 8 additions & 2 deletions docs/capabilities.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,8 +51,14 @@ permissions, and real delivery still need checking in your deployment.
## Which release this page describes

Weave is an alpha workflow and integration platform. This documentation targets
**`0.1.0a15`**, with PyFly 26.9.15 and database schema revision
`0030_worker_presence`, unchanged from alpha12. Alpha15 adds text templates
**`0.1.0a16`**, with PyFly 26.9.15 and database schema revision
`0033_language_workflow_calls`. Alpha16 adds loops over items and calls between
workflows, Studio's Operate area with its Overview, Runs, Incidents, Workers and
Clusters pages, the new editor's canvas, step details, **Add a step** and
formulas (off by default), and AI tasks on a local Ollama model set up from
**Settings › AI models**; it adds three migrations, described in the
[upgrade procedure](operations/upgrades.md#what-changes-in-alpha16). Alpha15
kept schema revision `0030_worker_presence` and adds text templates
(`concat` and `join`), development-only private origins for the Docker
development platform, plain-HTTP no-code connections with a "Not encrypted"
warning, and the Firefly identity in Studio, the desktop app, the CLI and this
Expand Down
2 changes: 1 addition & 1 deletion docs/guides/ai-workers.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Use [Weave AI](weave-ai.md) when *you*, the person using Studio, want an
explanation or a proposed definition change. Weave AI has separate configuration
and does not execute workflow AI tasks.

The examples here use Weave **0.1.0a15** and the **0.1.7 Agentic worker package**,
The examples here use Weave **0.1.0a16** and the **0.1.8 Agentic worker package**,
whose core dependency is
pinned to that Weave version. The catalog references below retain their own
`1.0.0` definition and task versions.
Expand Down
50 changes: 25 additions & 25 deletions docs/guides/desktop.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,31 +44,31 @@ start them:
## Choose an installer

Choose a matching installer **actually attached** to the
[v0.1.0a15 release](https://github.com/fireflyframework/firefly-weave/releases/tag/v0.1.0a15).
The desktop product version is `0.1.0-alpha.15`; its bundled Python host is
`0.1.0a15`. macOS bundles use **ad-hoc signing** for resource integrity; they are
[v0.1.0a16 release](https://github.com/fireflyframework/firefly-weave/releases/tag/v0.1.0a16).
The desktop product version is `0.1.0-alpha.16`; its bundled Python host is
`0.1.0a16`. macOS bundles use **ad-hoc signing** for resource integrity; they are
**not Developer ID signed and not notarized**. Windows installers remain unsigned.
Build and frozen-host smoke checks do not establish interactive GUI testing on
every operating system. Your organization's installation policy still applies.

| Computer | Target | Installer filename |
| --- | --- | --- |
| macOS Apple silicon | `aarch64-apple-darwin` | `firefly-weave-studio-0.1.0-alpha.15-aarch64-apple-darwin.dmg` |
| macOS Intel | `x86_64-apple-darwin` | `firefly-weave-studio-0.1.0-alpha.15-x86_64-apple-darwin.dmg` |
| Windows x64 | `x86_64-pc-windows-msvc` | `firefly-weave-studio-0.1.0-alpha.15-x86_64-pc-windows-msvc.exe` or `.msi` |
| Linux x64 | `x86_64-unknown-linux-gnu` | `firefly-weave-studio-0.1.0-alpha.15-x86_64-unknown-linux-gnu.deb` or `.AppImage` |
| macOS Apple silicon | `aarch64-apple-darwin` | `firefly-weave-studio-0.1.0-alpha.16-aarch64-apple-darwin.dmg` |
| macOS Intel | `x86_64-apple-darwin` | `firefly-weave-studio-0.1.0-alpha.16-x86_64-apple-darwin.dmg` |
| Windows x64 | `x86_64-pc-windows-msvc` | `firefly-weave-studio-0.1.0-alpha.16-x86_64-pc-windows-msvc.exe` or `.msi` |
| Linux x64 | `x86_64-unknown-linux-gnu` | `firefly-weave-studio-0.1.0-alpha.16-x86_64-unknown-linux-gnu.deb` or `.AppImage` |

Download the chosen installer and its target's checksum inventory,
`weave-studio-TARGET-SHA256SUMS`, from that same release. The matrix describes
filenames, not a promise that every asset is already available. If your matching
asset is absent, use the [browser installation](studio.md#install-the-alpha15-browser-application)
asset is absent, use the [browser installation](studio.md#install-the-alpha16-browser-application)
instead. Alpha4 Python releases do not contain Studio or desktop installers.

**Do not use the alpha5 macOS installers.** Their outer application bundle lacked
its resource seal, causing macOS to report that the application was damaged.
Alpha6 added explicit ad-hoc bundle signing and a strict verification gate for both
the built application and the application enclosed in its DMG, and alpha15 keeps
them. Download the matching alpha15 asset rather than attempting to bypass the
the built application and the application enclosed in its DMG, and alpha16 keeps
them. Download the matching alpha16 asset rather than attempting to bypass the
alpha5 failure.
Ad-hoc integrity does not establish publisher trust or Gatekeeper acceptance.

Expand Down Expand Up @@ -110,9 +110,9 @@ This follows Tauri's [sidecar model](https://v2.tauri.app/develop/sidecar/) and
```sh
# Inspect the downloaded installer without opening it.
cd ~/Downloads
shasum -a 256 firefly-weave-studio-0.1.0-alpha.15-aarch64-apple-darwin.dmg
shasum -a 256 firefly-weave-studio-0.1.0-alpha.16-aarch64-apple-darwin.dmg
# Show the expected digest for this exact filename.
grep 'firefly-weave-studio-0.1.0-alpha.15-aarch64-apple-darwin.dmg$' weave-studio-aarch64-apple-darwin-SHA256SUMS
grep 'firefly-weave-studio-0.1.0-alpha.16-aarch64-apple-darwin.dmg$' weave-studio-aarch64-apple-darwin-SHA256SUMS
```

Both displayed digests must match. For Intel, replace `aarch64-apple-darwin`
Expand Down Expand Up @@ -150,18 +150,18 @@ matching `weave-studio-x86_64-pc-windows-msvc-SHA256SUMS` inventory first.
```powershell
# Inspect the downloaded EXE before running it.
Set-Location "$HOME\Downloads"
Get-FileHash .\firefly-weave-studio-0.1.0-alpha.15-x86_64-pc-windows-msvc.exe -Algorithm SHA256
Get-FileHash .\firefly-weave-studio-0.1.0-alpha.16-x86_64-pc-windows-msvc.exe -Algorithm SHA256
# Compare the digest with the line for this exact filename.
Select-String -Path .\weave-studio-x86_64-pc-windows-msvc-SHA256SUMS -Pattern 'firefly-weave-studio-0.1.0-alpha.15-x86_64-pc-windows-msvc.exe$'
Select-String -Path .\weave-studio-x86_64-pc-windows-msvc-SHA256SUMS -Pattern 'firefly-weave-studio-0.1.0-alpha.16-x86_64-pc-windows-msvc.exe$'
```

Expected: `Get-FileHash` prints a `Hash` value, and `Select-String` prints the
inventory line for the same file. For MSI, substitute `.msi` in both commands.
Compare the two digests without regard to letter case; stop on a mismatch. Double-click the verified installer, complete its
setup, then open **Firefly Weave Studio** from the Start menu. The installer may
need network access to provision WebView2. Unsigned-installation warnings remain
subject to your organization's policy. The MSI's internal version is `0.1.15`, a
monotonic Windows Installer counter; the displayed product remains alpha15.
subject to your organization's policy. The MSI's internal version is `0.1.16`, a
monotonic Windows Installer counter; the displayed product remains alpha16.

## Install on Linux

Expand All @@ -172,8 +172,8 @@ application where your distribution supports its runtime. Download the matching
```sh
# Enter the download directory, verify this exact file, then install only on success.
cd ~/Downloads &&
grep 'firefly-weave-studio-0.1.0-alpha.15-x86_64-unknown-linux-gnu.deb$' weave-studio-x86_64-unknown-linux-gnu-SHA256SUMS | sha256sum --check &&
sudo apt install ./firefly-weave-studio-0.1.0-alpha.15-x86_64-unknown-linux-gnu.deb
grep 'firefly-weave-studio-0.1.0-alpha.16-x86_64-unknown-linux-gnu.deb$' weave-studio-x86_64-unknown-linux-gnu-SHA256SUMS | sha256sum --check &&
sudo apt install ./firefly-weave-studio-0.1.0-alpha.16-x86_64-unknown-linux-gnu.deb
```

Expected: `sha256sum` prints the file name followed by `OK`, and only then does
Expand All @@ -183,9 +183,9 @@ application launcher. For AppImage:
```sh
# Verify this exact portable file; a failed or missing checksum prevents launch.
cd ~/Downloads &&
grep 'firefly-weave-studio-0.1.0-alpha.15-x86_64-unknown-linux-gnu.AppImage$' weave-studio-x86_64-unknown-linux-gnu-SHA256SUMS | sha256sum --check &&
chmod +x firefly-weave-studio-0.1.0-alpha.15-x86_64-unknown-linux-gnu.AppImage &&
./firefly-weave-studio-0.1.0-alpha.15-x86_64-unknown-linux-gnu.AppImage
grep 'firefly-weave-studio-0.1.0-alpha.16-x86_64-unknown-linux-gnu.AppImage$' weave-studio-x86_64-unknown-linux-gnu-SHA256SUMS | sha256sum --check &&
chmod +x firefly-weave-studio-0.1.0-alpha.16-x86_64-unknown-linux-gnu.AppImage &&
./firefly-weave-studio-0.1.0-alpha.16-x86_64-unknown-linux-gnu.AppImage
```

Linux requires the distribution's WebKitGTK runtime, and AppImage execution may
Expand Down Expand Up @@ -480,7 +480,7 @@ with a text editor.
**Untested platform cases.** On macOS 11.0 to 11.2 the webview lacks the
download support the app relies on, so an export may save nothing even though
the confirmation appears; use macOS 11.3 or later, or the
[browser installation](studio.md#install-the-alpha15-browser-application). macOS
[browser installation](studio.md#install-the-alpha16-browser-application). macOS
may ask whether Firefly Weave Studio can use your Downloads folder the first
time you export. On Windows, WebView2 may ask whether to allow the second of the
two files.
Expand Down Expand Up @@ -637,8 +637,8 @@ source checkout, you can run that same gate on an explicitly downloaded DMG:

```sh
# Verify resource integrity without launching the application.
# Replace the path with the actual alpha15 installer you downloaded.
.venv/bin/python desktop/scripts/verify_macos_bundle.py /path/to/firefly-weave-studio-0.1.0-alpha.15-aarch64-apple-darwin.dmg
# Replace the path with the actual alpha16 installer you downloaded.
.venv/bin/python desktop/scripts/verify_macos_bundle.py /path/to/firefly-weave-studio-0.1.0-alpha.16-aarch64-apple-darwin.dmg
```

The build also smoke-tests the frozen host after Tauri signs it. Hardened runtime
Expand Down Expand Up @@ -693,7 +693,7 @@ After this workflow exists on `main` and on the reviewed release tag, dispatch i

```sh
# Replace this example with the exact reviewed tag that contains the workflow.
gh workflow run desktop-notarized.yml --ref v0.1.0a15 -f notarize=true
gh workflow run desktop-notarized.yml --ref v0.1.0a16 -f notarize=true
```

Approve the protected environment only after checking the tag and commit. Both
Expand Down
4 changes: 2 additions & 2 deletions docs/guides/docker-development.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,10 +40,10 @@ application development.
```sh
# Confirm that the installed CLI matches the source version below.
weave --version
# Expected: Firefly Weave 0.1.0a15.
# Expected: Firefly Weave 0.1.0a16.

# Download the matching operator files into a new, dedicated directory.
git clone --branch v0.1.0a15 --depth 1 \
git clone --branch v0.1.0a16 --depth 1 \
https://github.com/fireflyframework/firefly-weave.git weave-platform-a15
cd weave-platform-a15
```
Expand Down
Loading
Loading