@compozy/cli 0.3.0-beta.9 → 0.4.1

package/README.md

@@ -1,7 +1,8 @@
 <div align="center">
   <img src="packages/site/public/icon-512.png" alt="CompozyOS" width="96" height="96">
   <h1>CompozyOS</h1>
-  <p><strong>A local-first operating system for agent work.</strong></p>
+  <p><strong>The system around the agent, already built.</strong></p>
+  <p>An operating system for AI agents.</p>
   <p>
     <a href="https://github.com/compozy/compozy/actions/workflows/ci.yml">
       <img src="https://github.com/compozy/compozy/actions/workflows/ci.yml/badge.svg" alt="CI">
@@ -21,62 +22,68 @@
   </p>
 </div>
 
-CompozyOS gives agent work a durable place to live. One local daemon connects sessions, tasks,
-loops, memory, permissions, automation, and tools. People can see and steer the work through the web
-shell and CLI; agents operate the same state through structured HTTP, UDS, MCP, and native-tool
-surfaces.
+Anyone can prompt an agent. Making agents work continuously is still an engineering project: loops,
+triggers, cron, permissions, approvals, observability, and the glue scripts that hold them
+together. CompozyOS turns that entire agent stack into one product, a complete environment to
+create, automate, and supervise agent work with the agent CLIs you already use (Claude Code,
+Codex, and Cursor). Built first for developers and technical operators.
 
-> [!WARNING]
-> The v0.3 line is in beta. The previous v0.2.15 product is deprecated and maintained only for
-> critical fixes on [`legacy/v0.2`](https://github.com/compozy/compozy/tree/legacy/v0.2). Start with
-> the [migration guide](MIGRATION_GUIDE.md) before replacing an existing v0.2 installation.
+> [!NOTE]
+> v0.4.0 is the first stable CompozyOS release. The previous v0.2 product has reached end of life
+> and receives no further releases. Start with the [migration guide](MIGRATION_GUIDE.md) before
+> replacing an existing v0.2 installation.
 
 <div align="center">
-  <img src="imgs/screenshot.png" alt="CompozyOS workspace with durable agent work" width="100%">
+  <img src="imgs/screenshot.png" alt="CompozyOS web shell" width="100%">
 </div>
 
 ## ✨ Highlights
 
+- **Create.** Sessions, agents, Loops, and capabilities are objects you author once and reuse, not
+  scripts you rewrite per run.
+- **Automate.** Cron schedules, webhooks, and triggers keep work running with no terminal open.
+- **Supervise.** Approvals, permissions, run state, artifacts, and agent activity stay inspectable
+  while work continues in the background.
 - **Work survives the terminal.** Sessions and Loop runs belong to the daemon, so closing one client
   does not erase the work.
-- **One state, several control surfaces.** Web, CLI, HTTP/SSE, UDS, MCP, and native tools expose the
-  same runtime-owned resources.
-- **People stay in control.** Approvals, permissions, run state, artifacts, and agent activity remain
-  inspectable while work continues in the background.
+- **Runs the agents you already use.** ACP-compatible CLIs (Claude Code, Codex, and Cursor)
+  operate the same daemon-owned state.
+- **Batteries included.** One runtime, one state model: loops and approvals are core
+  objects, not plugins, reachable from web, CLI, HTTP/SSE, UDS, MCP, and native tools.
 - **Local-first by default.** One Go binary and SQLite-backed stores keep runtime state on the
   operator's machine unless a configured provider or extension owns an external boundary.
 - **Remote access stays explicit.** The [Gateway](https://compozy.com/docs/gateway)
   pairs devices and exposes only the private or public surfaces an operator enables.
-- **Built to extend.** Agents, skills, capabilities, hooks, bridges, and extension kits plug into
+- **Built to extend.** Agents, skills, capabilities, hooks, and extension kits plug into
   explicit runtime contracts.
-- **Compozy Network.** Sessions can discover peers, exchange typed messages, delegate work, and close
-  it with receipts over `compozy-network/v0`.
 
 ## 📦 Installation
 
-The v0.3 beta ships through the channels below. Homebrew continues to serve the deprecated v0.2 line
-during the beta window and is intentionally omitted here. The `compozy` formula returns with v0.3.0
-stable.
-
 #### Verified installer
 
-The installer pins the latest published beta and verifies Sigstore provenance before installing the
-binary on macOS or Linux.
+The installer pins the latest published release and verifies Sigstore provenance before installing
+the binary on macOS or Linux.
 
 ```bash
 curl -fsSL https://compozy.com/install.sh | sh
 ```
 
+#### Homebrew
+
+```bash
+brew install compozy/compozy/compozy
+```
+
 #### NPM
 
 ```bash
-npm install -g @compozy/cli@beta
+npm install -g @compozy/cli
 ```
 
 #### Go
 
-Go's `@latest` still resolves the v0.2 stable line while v0.3 is in beta, so install with the
-explicit tag shown on the [latest release](https://github.com/compozy/compozy/releases/latest):
+Install with the explicit tag shown on the
+[latest release](https://github.com/compozy/compozy/releases/latest):
 
 ```bash
 go install github.com/compozy/compozy@<release-tag>
@@ -107,8 +114,8 @@ parallel model.
 ### Daemon Runtime Model
 
 `compozy daemon start`, `compozy status`, and `compozy daemon stop` manage the local daemon.
-Sessions, tasks, Loop runs, memory,
-automation, tools, and Compozy Network activity keep explicit owners and workspace boundaries. Use
+Sessions, tasks, Loop runs,
+automation and tools keep explicit owners and workspace boundaries. Use
 structured CLI output (`-o json`), HTTP/SSE, UDS, MCP, or native tools when another agent or program
 needs to manage the same resources.
 
@@ -160,8 +167,9 @@ compozy extension dev hello
 compozy tool invoke ext__hello__search --workspace . --input '{"query":"compozy"}'
 ```
 
-Authoring is code-first: you declare the tool once in code and `compozy extension build` generates
-the manifest. Walkthrough:
+Executable extensions are code-first: declare the tool once in code and `compozy extension build`
+generates the manifest. Resource-only extensions can instead hand-write `extension.toml` and use the
+same build, dev, reload, and watch loop without running extension code. Walkthrough:
 [Build your first extension](https://compozy.com/docs/guides/build-your-first-extension).
 
 ### SDK support
@@ -187,6 +195,17 @@ compozy extension logs <name> --follow
 - [Official CompozyOS skill](skills/compozy/)
 - [Migration guide](MIGRATION_GUIDE.md)
 
+## Build an app
+
+Use `@compozy/client` for TypeScript or `github.com/compozy/compozy/sdk/go/client` for Go to connect
+an external app to your running daemon. Both clients provide typed operations and agent streams;
+app tokens authorize trusted browser origins on the local listener.
+
+Follow the [Build an app tutorials](https://compozy.com/docs/apps) for Node, a server-backed chat UI,
+browser access, Go, and token administration. The [API reference](https://compozy.com/docs/api)
+includes generated SDK calls for each operation. These app SDK surfaces are experimental in 0.4;
+pin the exact version matching your daemon.
+
 ## 🚀 Quick Start
 
 Bootstrap the home, start the daemon, enter the repository you want agents to work in, and create one
@@ -215,9 +234,9 @@ compozy marketplace search --kind skill --query <term> -o json
 
 ### 🧠 Workflow Memory
 
-Durable memory is scoped and daemon-owned. Agents can inspect, propose, and consolidate memory through
-the same public contracts as people. The v0.2 workflow-memory files remain ordinary repository
-artifacts; they are not imported as hidden runtime state.
+Workflow memory is ordinary repository files under `.compozy/tasks/<name>/memory/`, written and read by
+the spec-cycle skills. The v0.2 workflow-memory files remain repository artifacts; they are not
+imported as hidden runtime state.
 
 ### 🤖 Supported Agents
 
@@ -244,7 +263,6 @@ compozy doctor -o json
 - [Quick Start](https://compozy.com/docs/getting-started/quick-start)
 - [Migrate from v0.2.15](MIGRATION_GUIDE.md)
 - [CLI reference](https://compozy.com/docs/cli-reference)
-- [Compozy Network protocol](https://compozy.com/protocol)
 - [GitHub releases](https://github.com/compozy/compozy/releases)
 
 ## 🛠️ Development
@@ -256,12 +274,42 @@ Vite HMR:
 make dev
 ```
 
-Run the full repository gate once the change is ready:
+To populate the Northstar Pay demo and leave its daemon running in the background:
 
 ```bash
-make verify
+make demo-seed
+# Optional isolated home and secondary port:
+make demo-seed DEMO_HOME="$HOME/.compozy-demo-other" DEMO_PORT=2125
 ```
 
+This builds the daemon and Web bundle, replaces the seed-owned scenario, and starts
+the demo at `http://localhost:2124` using `~/.compozy-demo` by default. The main
+instance is unchanged. To reseed a running demo, first stop its daemon with
+`COMPOZY_HOME="$HOME/.compozy-demo" ./bin/compozy daemon stop` (use your custom home
+if overridden). The raw `go run ./scripts/demo-seed --home <path>` command remains
+available for data-only seeding. Existing demos in `~/.agh` can still be selected
+explicitly with `DEMO_HOME`.
+
+To prepare the same demo and open it in the Electron desktop shell:
+
+```bash
+make demo-seed-desktop
+# The same overrides apply:
+make demo-seed-desktop DEMO_HOME="$HOME/.compozy-demo-other" DEMO_PORT=2125
+```
+
+The desktop shell uses the demo home for its runtime connection and Electron
+profile. Quitting Electron leaves the demo daemon running in the background.
+As with `demo-seed`, stop an already-running demo before reseeding it.
+
+Run the affected local gate before committing or pushing:
+
+```bash
+make gate
+```
+
+Delivery finishes in the draft PR: wait for every required CI check to pass on its current head.
+
 Read [AGENTS.md](AGENTS.md) and the surface-specific instructions before editing.
 
 ## Star History
@@ -277,7 +325,7 @@ Read [AGENTS.md](AGENTS.md) and the surface-specific instructions before editing
 ## 🤝 Contributing
 
 Contributions are welcome. Open an issue or pull request, keep public behavior agent-manageable, and
-run `make verify` before sending changes. [Security reports](SECURITY.md) belong in the repository's
+run `make gate` before sending changes, then keep the PR until its current-head CI is green. [Security reports](SECURITY.md) belong in the repository's
 private security channel, not a public issue.
 
 ## Contributors

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@compozy/cli",
   "type": "module",
-  "version": "0.3.0-beta.9",
-  "description": "A local-first operating system for agent work.",
+  "version": "0.4.1",
+  "description": "One complete environment to create, automate, and supervise agent work.",
   "scripts": {
     "postinstall": "node install.js",
     "run": "node run-compozy.js"
@@ -28,50 +28,50 @@
   "archives": {
     "darwin-arm64": {
       "name": "compozy_darwin_arm64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.9/compozy_darwin_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.4.1/compozy_darwin_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "9710c3d02df19b3e2d0e63746a577495619fda2d508d024dde6ca6caffb44a5a"
+        "digest": "fa002927cc9f6e6a2b81640314628e2b49a5e7a32a1663390f2a5a41b8c62b44"
       }
     },
     "darwin-x64": {
       "name": "compozy_darwin_x86_64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.9/compozy_darwin_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.4.1/compozy_darwin_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "df65b0a49794245c9b36ffad4009a11c15f5507a5727f3b9dbdd96e73e76fc7f"
+        "digest": "6b30e16172ab4fd67f9e48f2a3045a63b192641b124748d41e517cf634ee6ba3"
       }
     },
     "linux-arm64": {
       "name": "compozy_linux_arm64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.9/compozy_linux_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.4.1/compozy_linux_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "cd328cc0f709f9cda4cf0c795d041fbd1869ae6fb5009d8a4dab577de2d925ee"
+        "digest": "42ad778ef649fed145f956d1818c4dd1da45508795ecbf2e8c17adc817f2cd0c"
       }
     },
     "linux-x64": {
       "name": "compozy_linux_x86_64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.3.0-beta.9/compozy_linux_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.4.1/compozy_linux_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "ca590110212d3c926a11990774d3d12d19fbcd5c165af99dc66edaa76e95abb1"
+        "digest": "ae5c2006da5be8270c72be66a2fda1bfa16a5de3194ace21074bc1e4ee784330"
       }
     }
   }