Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.
JavaScript agent-orchestrationagentic-workflowai-agentsai-codingclaude-codecode-reviewcodebuddycodexcoding-agentscursordeveloper-toolshuman-on-the-loopllmmcpmulti-agentsdlcself-hostedsopworkflow-automationworkflow-engine
fix(release): ship ARM64 platform images in 0.3.4 (#119)
Robert0622e47dcd0e86e0
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex b90531e0..19d6005e 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -2,13 +2,14 @@Platform releases use `vX.Y.Z` tags and publish `ghcr.io/tencent/loopforge`. LoopForge Local packages use `local-vX.Y.Z` tags and are published by manually running the `release-local` workflow.-## Unreleased+## 0.3.4 — ARM64 platform images and shared CodeBuddy keys- Platform administrators create accounts and reset passwords under 平台管理 → 成员账号, so teams that turn off self sign-up no longer need the `loopforge-account` command.- Platform administrators can share one CodeBuddy API Key under 平台管理 → 共享 CodeBuddy Key and choose the models it may run. Members without their own key chat and run SOPs on it within those models; `AGENTFLOW_ASSISTANT_SPONSOR_LOGIN` still applies while none is configured. Members with their own key keep their own network environment's models and default model; previously a configured sponsor also changed their default.- A stored CodeBuddy network environment such as `china` can be saved again as-is to rewrite it, and the quick-access wizard no longer keeps an environment switched back to 国际站 elsewhere.- In English, the navigation, the top bar and the 个人配置 page (now "Personal settings") no longer show Chinese labels, tooltips or credential descriptions.- The platform image is published for linux/amd64 and linux/arm64, so Apple silicon Macs and arm servers can pull it. On a native arm64 host the bundled CodeBuddy and Codex CLIs, chat, and SOP runs in the Docker sandbox behave and perform like amd64. Under QEMU emulation (an arm64 image on an x86 host) CodeBuddy starts about ten times slower and the model list cannot be read; use the amd64 image there.+- Prepare nested sandbox mount targets before Docker starts, so Docker Desktop can launch SOP containers with VirtioFS-backed workspaces.Existing installations may apply `migrations/024_platform_codebuddy_key.sql`; the platform also creates the table on startup.diff --git a/compose.yaml b/compose.yamlindex 7c301c1c..3f1e1d9a 100644--- a/compose.yaml+++ b/compose.yaml@@ -21,7 +21,7 @@ services:profiles: [platform]# Published release stack: never builds. Bump the pinned tag (here and in# AGENTFLOW_ISOLATED_IMAGE) with each release; source builds use compose.dev.yaml.- image: ${LOOPFORGE_IMAGE:-ghcr.io/tencent/loopforge:0.3.3}+ image: ${LOOPFORGE_IMAGE:-ghcr.io/tencent/loopforge:0.3.4}ports:- "${LOOPFORGE_BIND:-0.0.0.0}:${AGENTFLOW_HTTP_PORT:-8090}:8080"environment:@@ -40,7 +40,7 @@ services:AGENTFLOW_PLATFORM_MCP_URL: ${AGENTFLOW_PLATFORM_MCP_URL:-http://platform:8080}AGENTFLOW_DOCKER_NETWORK: ${COMPOSE_PROJECT_NAME:-loopforge}_defaultAGENTFLOW_LOCAL_SANDBOX: docker- AGENTFLOW_ISOLATED_IMAGE: ${LOOPFORGE_IMAGE:-ghcr.io/tencent/loopforge:0.3.3}+ AGENTFLOW_ISOLATED_IMAGE: ${LOOPFORGE_IMAGE:-ghcr.io/tencent/loopforge:0.3.4}HOME: ${LOOPFORGE_DATA_DIR:?Run scripts/configure.sh first}/homeAGENTFLOW_RUNNER_BINARY: /app/bin/agentflow-runner-{os}-{arch}AGENTFLOW_GATE_MCP_BINARY: /app/bin/agentflow-gate-mcp-{os}-{arch}diff --git a/docs/deployment.md b/docs/deployment.mdindex 70189487..2f00712b 100644--- a/docs/deployment.md+++ b/docs/deployment.md@@ -35,7 +35,7 @@ The installer checks Docker, Compose and Python (and offers to install Docker whRun it as the installation owner, including an ordinary Linux user. If that user cannot access Docker directly, the installer validates sudo and uses `sudo -n docker` consistently for Compose, schema installation and seeds. Before each operation it checks whether sudo credentials expired during a long build, prompting again in a terminal or failing with instructions in unattended mode. It does not require adding the user to the Docker group or logging out. For unattended installations run `sudo -v` first; `LOOPFORGE_YES=1` accepts installation prompts but does not bypass operating-system permissions. Without sudo or Docker access it fails immediately with instructions. Rootless Docker uses its active context's Unix socket; remote Docker contexts need a separately configured deployment because sandbox workspaces are local bind mounts.-`compose.yaml` is the published-image stack and never builds: `./start.sh`, `scripts/install.sh` and a plain `docker compose --profile platform up` all pull the GHCR release pinned there (currently `ghcr.io/tencent/loopforge:0.3.3`). The pin matches the checkout's migrations and seeds, so check out a release tag when you install. Set `LOOPFORGE_IMAGE` (for example to an `@sha256:` digest) only to override it; a value saved in `.env` takes precedence over later pin changes.+`compose.yaml` is the published-image stack and never builds: `./start.sh`, `scripts/install.sh` and a plain `docker compose --profile platform up` all pull the GHCR release pinned there (currently `ghcr.io/tencent/loopforge:0.3.4`). The pin matches the checkout's migrations and seeds, so check out a release tag when you install. Set `LOOPFORGE_IMAGE` (for example to an `@sha256:` digest) only to override it; a value saved in `.env` takes precedence over later pin changes.`./start.sh dev` (or `LOOPFORGE_BUILD_FROM_SOURCE=1 bash scripts/install.sh`) builds this checkout as `loopforge-platform:local` from `compose.dev.yaml`. It saves `COMPOSE_FILE=compose.yaml:compose.dev.yaml` in `.env`, so later runs and plain `docker compose` commands keep using the source build until `./start.sh release`. Source builds reuse npm, Go module and Go compiler caches.diff --git a/internal/runtime/runtime_test.go b/internal/runtime/runtime_test.goindex 544bbd9c..aaf5d856 100644--- a/internal/runtime/runtime_test.go+++ b/internal/runtime/runtime_test.go@@ -863,11 +863,18 @@ func TestBwrapAndDockerMaskRepositoryAgentConfig(t *testing.T) {if err := os.WriteFile(filepath.Join(workspace, "services", "api", "CLAUDE.md"), []byte("nested prompt"), 0o600); err != nil {t.Fatal(err)}- bwrap, err := bwrapAgentConfigMasks(workspace)+ docker, err := dockerAgentConfigMasks(workspace)if err != nil {t.Fatal(err)}- docker, err := dockerAgentConfigMasks(workspace)+ for name, isDir := range map[string]bool{"empty-dir": true, "empty-file": false} {+ target := filepath.Join(workspace, ".agentflow", "isolation", name)+ info, err := os.Lstat(target)+ if err != nil || (isDir && !info.IsDir()) || (!isDir && !info.Mode().IsRegular()) {+ t.Fatalf("Docker mount target %s: %v, %v", target, info, err)+ }+ }+ bwrap, err := bwrapAgentConfigMasks(workspace)if err != nil {t.Fatal(err)}diff --git a/internal/runtime/sandbox_owner_linux_test.go b/internal/runtime/sandbox_owner_linux_test.goindex 8455e3cc..2e7fe9f1 100644--- a/internal/runtime/sandbox_owner_linux_test.go+++ b/internal/runtime/sandbox_owner_linux_test.go@@ -22,14 +22,6 @@ func TestDockerSandboxNativeOwner(t *testing.T) {if err := os.Chmod(workspace, 0o700); err != nil {t.Fatal(err)}- // Materialize the mount targets as the host user, as normal run setup does.- // Otherwise the Docker daemon creates root-owned placeholder directories.- if err := os.MkdirAll(filepath.Join(workspace, ".agentflow", "isolation", "empty-dir"), 0o700); err != nil {- t.Fatal(err)- }- if err := os.WriteFile(filepath.Join(workspace, ".agentflow", "isolation", "empty-file"), nil, 0o600); err != nil {- t.Fatal(err)- }name := fmt.Sprintf("native-owner-%d", time.Now().UnixNano())sandbox, err := createDocker(ctx, name, workspace, domain.SandboxProfile{Driver: "docker"}, SandboxRequirements{}, domain.DockerfileDefinition{ID: name, Content: "FROM alpine:3.20\nWORKDIR /workspace\n",diff --git a/internal/runtime/sandbox_process.go b/internal/runtime/sandbox_process.goindex af079711..272318bc 100644--- a/internal/runtime/sandbox_process.go+++ b/internal/runtime/sandbox_process.go@@ -517,6 +517,33 @@ func dockerIsolationMaskRoot(workspace string) string {}func dockerAgentConfigMasks(workspace string) ([]string, error) {+ // Docker Desktop cannot create missing nested mount targets on a VirtioFS share.+ if _, err := EnsureControlDirectory(workspace, "isolation", "empty-dir"); err != nil {+ return nil, err+ }+ target := filepath.Join(workspace, ".agentflow", "isolation", "empty-file")+ root, rel, err := openWorkspacePath(workspace, target)+ if err != nil {+ return nil, err+ }+ defer root.Close()+ file, err := root.OpenFile(rel, os.O_CREATE|os.O_EXCL|os.O_WRONLY, 0o600)+ if err == nil {+ if err := file.Close(); err != nil {+ return nil, err+ }+ } else if os.IsExist(err) {+ info, err := root.Lstat(rel)+ if err != nil {+ return nil, err+ }+ if !info.Mode().IsRegular() {+ return nil, fmt.Errorf("sandbox mask target is not a regular file: %s", target)+ }+ } else {+ return nil, err+ }+emptyDir, emptyFile, err := isolationMaskSourcesAt(dockerIsolationMaskRoot(workspace))if err != nil {return nil, err