From 160b0c309d0862baa561d29600d6799a7a2d4b9c Mon Sep 17 00:00:00 2001 From: Fabro Date: Fri, 22 May 2026 20:39:57 -0400 Subject: [PATCH] =?UTF-8?q?init=20run=20=E2=9A=92=EF=B8=8F=20Generated=20w?= =?UTF-8?q?ith=20[Fabro](https://fabro.sh)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- graph.fabro | 37 ++++ run.json | 546 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 583 insertions(+) create mode 100644 graph.fabro create mode 100644 run.json diff --git a/graph.fabro b/graph.fabro new file mode 100644 index 000000000..e1cdc984a --- /dev/null +++ b/graph.fabro @@ -0,0 +1,37 @@ +digraph ImplementPlan { + graph [ + goal="Implement and simplify", + model_stylesheet=" + * { model: claude-opus-4-7; } + " + ] + rankdir=LR + + start [shape=Mdiamond, label="Start"] + exit [shape=Msquare, label="Exit"] + + toolchain [label="Toolchain", shape=parallelogram, script="command -v cargo >/dev/null || { curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && sudo ln -sf $HOME/.cargo/bin/* /usr/local/bin/; }; cargo --version 2>&1", max_retries=0] + preflight_compile [label="Preflight Compile", shape=parallelogram, script="cargo check -q --workspace 2>&1", max_retries=0] + preflight_lint [label="Preflight Lint", shape=parallelogram, script="cargo +nightly-2026-04-14 clippy -q --workspace --all-targets -- -D warnings 2>&1", max_retries=0] + fix_lints [label="Fix Lints", prompt="The preflight lint step failed. Read the build output from context and fix all clippy lint warnings.", max_visits=3] + implement [label="Implement", prompt="Read the plan file referenced in the goal and implement every step. Make all the code changes described in the plan. Use red/green TDD.", model="gpt-55", reasoning_effort="xhigh"] + simplify_opus [label="Simplify (Opus)", prompt="@prompts/simplify.md"] + simplify_gpt [label="Simplify (GPT-55)", prompt="@prompts/simplify.md", model="gpt-55"] + verify [label="Verify", shape=parallelogram, script="cargo +nightly-2026-04-14 clippy -q --workspace --all-targets -- -D warnings 2>&1 && cargo nextest run --cargo-quiet --workspace --status-level fail 2>&1 && cargo dev docs refresh 2>&1 && cargo dev docs check 2>&1", goal_gate=true, retry_target="fixup"] + fixup [label="Fixup", prompt="The verify step failed. Read the build output from context and fix all clippy lint warnings, test failures, and generated docs errors.", max_visits=3] + fmt [label="Format", shape=parallelogram, script="cargo +nightly-2026-04-14 fmt --all 2>&1", max_retries=0] + + start -> toolchain + toolchain -> preflight_compile [condition="outcome=succeeded"] + toolchain -> exit + preflight_compile -> preflight_lint [condition="outcome=succeeded"] + preflight_compile -> exit + preflight_lint -> implement [condition="outcome=succeeded"] + preflight_lint -> fix_lints + fix_lints -> preflight_lint + implement -> simplify_opus -> simplify_gpt -> verify + verify -> fmt [condition="outcome=succeeded"] + verify -> fixup + fixup -> verify + fmt -> exit +} diff --git a/run.json b/run.json new file mode 100644 index 000000000..5d67bf594 --- /dev/null +++ b/run.json @@ -0,0 +1,546 @@ +{ + "title": "Named Environments Implementation Plan", + "spec": { + "run_id": "01KS94BXYG7J8FNW0JWM8EQ3TZ", + "settings": { + "project": { + "name": null, + "description": null, + "metadata": {} + }, + "workflow": { + "name": null, + "description": null, + "graph": "workflow.fabro", + "metadata": {} + }, + "run": { + "goal": { + "type": "inline", + "value": "# Named Environments Implementation Plan\n\n> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task.\n\n**Goal:** Replace run-scoped sandbox configuration with named, provider-explicit environments that runs can select by slug.\n\n**Architecture:** Add a shared top-level environment catalog, resolve a selected environment into the run's dense settings, validate provider capabilities, and convert the resolved environment into the existing sandbox runtime specs. Keep \"environment\" as reusable desired configuration and \"sandbox\" as the concrete runtime instance created for a run.\n\n**Tech Stack:** Rust config/types crates, TOML settings layers, Fabro workflow sandbox providers, OpenAPI-generated clients, public docs.\n\n---\n\n## Summary\n\nReplace run-scoped sandbox configuration with named, provider-explicit environments. A run selects an environment by slug via `[run.environment] id = \"...\"`; Fabro resolves the environment catalog through normal config precedence, applies run-level environment overrides, validates provider capabilities, freezes the resolved environment into the run settings, and creates a concrete sandbox instance from it.\n\nThis is a greenfield break: no `[run.sandbox]` compatibility layer, no server policy layer, and no required/optional volume semantics.\n\n## Key Interface Changes\n\n- Add top-level `[environments.]` to the shared settings schema. It is valid in `settings.toml`, `.fabro/project.toml`, and `workflow.toml`.\n- Replace sandbox selection with:\n\n```toml\n[run.environment]\nid = \"fabro-dev\"\n```\n\n- Allow sparse run-level overrides under the same table:\n\n```toml\n[run.environment.resources]\nmemory = \"32GB\"\n\n[run.environment.lifecycle]\npreserve = true\n```\n\n- Environment shape:\n\n```toml\n[environments.fabro-dev]\nprovider = \"daytona\" # local | docker | daytona\n\n[environments.fabro-dev.image]\nref = \"fabro-v11\" # Docker image or Daytona snapshot name\ndockerfile = { path = \"Dockerfile\" }\n\n[environments.fabro-dev.resources]\ncpu = 8\nmemory = \"16GB\"\ndisk = \"20GB\"\n\n[environments.fabro-dev.network]\nmode = \"block\" # allow_all | block | cidr_allow_list\nallow = [\"10.0.0.0/8\"]\n\n[environments.fabro-dev.lifecycle]\npreserve = false\nstop_on_terminal = true\nauto_stop = \"30m\"\n\n[environments.fabro-dev.labels]\nrepo = \"fabro-sh/fabro\"\n\n[[environments.fabro-dev.volumes]]\nid = \"vol-agent-state\"\nmount_path = \"/home/daytona/agent-state\"\nsubpath = \"auth\"\n\n[environments.fabro-dev.env]\nNODE_ENV = \"development\"\n```\n\n- Built-in default becomes:\n\n```toml\n[run.environment]\nid = \"default\"\n\n[environments.default]\nprovider = \"docker\"\n\n[environments.default.image]\nref = \"buildpack-deps:noble\"\n\n[environments.default.resources]\ncpu = 2\nmemory = \"4GB\"\n\n[environments.default.lifecycle]\npreserve = false\nstop_on_terminal = true\n```\n\n## Implementation Changes\n\n- Add environment sparse and dense types:\n - Sparse layer in `fabro-config` for `EnvironmentLayer`, `RunEnvironmentLayer`, image/resources/network/lifecycle/volume sublayers, and `[environments]` as a `MergeMap`.\n - Dense types in `fabro-types` for `EnvironmentSettings`, `RunEnvironmentSettings`, `EnvironmentProvider`, `EnvironmentNetworkMode`, and related subsettings.\n - Add `environments` to the top-level `SettingsLayer` and resolved `WorkflowSettings`; add selected `environment` to `RunNamespace`.\n- Resolve environments before run consumers use sandbox data:\n - Merge environment definitions by slug.\n - Resolve `[run.environment].id`; error if the slug is missing.\n - Overlay sparse `[run.environment.*]` fields onto the selected environment.\n - Validate provider is `local`, `docker`, or `daytona`.\n - Validate CIDRs with existing `ipnet`.\n - Store the selected resolved environment in `RunNamespace.environment`.\n- Replace sandbox runtime mapping:\n - Convert `RunNamespace.environment` to `SandboxSpec` in workflow start and server preflight paths.\n - Daytona: `image.ref` maps to snapshot name, `dockerfile` to snapshot Dockerfile, resources to snapshot sizing, network to Daytona policy, labels/volumes/env/lifecycle to existing provider fields.\n - Docker: `image.ref` maps to Docker image, `cpu` maps to `cpu_quota = cpu * 100000`, memory maps to memory limit, `network.mode = block` maps to `network_mode = none`, `allow_all` maps to default/bridge.\n - Local: use resolved working directory; env overlays process env as today.\n- Capability diagnostics:\n - Hard error for explicit security/isolation properties a provider cannot enforce:\n - local with `network.mode = block` or `cidr_allow_list`\n - docker with `network.mode = cidr_allow_list`\n - Warnings only for unsupported resource limits, volumes, labels, `auto_stop`, and Docker `image.dockerfile`.\n - If Daytona has `image.dockerfile` without `image.ref`, error because snapshot creation needs a name.\n- Remove old sandbox config surface:\n - Delete `[run.sandbox]` parsing/resolution/types from user-facing config.\n - Replace CLI/API/tool manifest args named `sandbox` with `environment` where they select execution profile.\n - Keep runtime/public \"sandbox\" terminology only for concrete instances, e.g. `fabro sandbox ssh`, `RunSandbox`, sandbox details.\n- Update docs and generated clients:\n - Update run configuration, environments, Daytona, server configuration, CLI reference, and OpenAPI spec.\n - Regenerate Rust API types/client and TypeScript API client after OpenAPI changes.\n\n## Test Plan\n\n- Config tests:\n - default resolves to `run.environment.id = \"default\"` and Docker environment settings.\n - project/workflow/run layers merge environment catalog by slug.\n - `[run.environment]` overrides selected environment fields.\n - `env` and `labels` merge by key; `volumes` replace wholesale.\n - missing environment slug errors.\n - old `[run.sandbox]` is rejected as an unknown field.\n- Provider mapping tests:\n - Daytona environment maps to snapshot/resources/network/labels/volumes/env.\n - Docker environment maps image, CPU, memory, network block, and env.\n - Local environment ignores non-security unsupported fields with warnings.\n- Validation tests:\n - docker plus CIDR allow-list errors.\n - local plus blocked network errors.\n - resource limits unsupported by provider produce warnings, not errors.\n - volumes unsupported by provider produce warnings, not errors.\n - Daytona dockerfile without image ref errors.\n- Integration/API tests:\n - run manifest with `[environments.]` and `[run.environment]` starts with the selected provider.\n - Dockerfile path bundling works from environment image config.\n - preflight reports capability warnings and security errors.\n - CLI/API `environment` override wins over config selection.\n\n## Assumptions\n\n- No compatibility behavior is required for `[run.sandbox]` or `--sandbox`.\n- No server-side environment policy or quota enforcement is in scope.\n- Volumes are simple provider hints; unsupported volume config warns and continues.\n- Resource limits are best-effort hints; unsupported resource fields warn and continue.\n- Provider names remain explicit for now: `local`, `docker`, and `daytona`.\n" + }, + "working_dir": null, + "metadata": {}, + "inputs": {}, + "model": { + "provider": "anthropic", + "name": "claude-sonnet-4-6", + "fallbacks": [], + "controls": { + "reasoning_effort": null, + "speed": null + } + }, + "git": { + "author": null + }, + "prepare": { + "commands": [], + "timeout_ms": 300000 + }, + "execution": { + "mode": "normal", + "approval": "prompt" + }, + "checkpoint": { + "exclude_globs": [], + "skip_git_hooks": false + }, + "clone": { + "enabled": true + }, + "run_branch": { + "enabled": true, + "push": true + }, + "meta_branch": { + "enabled": true, + "push": true + }, + "sandbox": { + "provider": "daytona", + "preserve": false, + "stop_on_terminal": true, + "devcontainer": false, + "env": {}, + "docker": { + "image": "buildpack-deps:noble", + "network_mode": null, + "memory_limit": 4000000000, + "cpu_quota": 200000, + "env_vars": {} + }, + "daytona": { + "auto_stop_interval": 30, + "labels": { + "repo": "fabro-sh/fabro" + }, + "volumes": [], + "snapshot": { + "name": "fabro-v11", + "cpu": 8, + "memory_gb": 16, + "disk_gb": 20, + "dockerfile": { + "type": "inline", + "value": "FROM ubuntu:24.04\n\nRUN apt-get update && apt-get install -y --no-install-recommends \\\n curl git ca-certificates build-essential pkg-config libssl-dev unzip python3 \\\n xvfb xfce4 xfce4-terminal x11vnc novnc dbus-x11 \\\n libx11-6 libxrandr2 libxext6 libxrender1 libxfixes3 libxss1 libxtst6 libxi6 \\\n && rm -rf /var/lib/apt/lists/*\n\n# Install real Chromium (not the snap stub) via xtradeb PPA\nRUN apt-get update && apt-get install -y --no-install-recommends \\\n software-properties-common curl gnupg \\\n && add-apt-repository -y ppa:xtradeb/apps \\\n && apt-get update \\\n && apt-get install -y --no-install-recommends chromium \\\n && rm -rf /var/lib/apt/lists/*\n\n# Wrapper: Chromium needs --no-sandbox when running as root in a container,\n# and --disable-dev-shm-usage avoids crashes from small /dev/shm\nRUN printf '#!/bin/bash\\nexec /usr/bin/chromium --no-sandbox --disable-dev-shm-usage \"$@\"\\n' \\\n > /usr/local/bin/chromium-wrapper \\\n && chmod +x /usr/local/bin/chromium-wrapper\n\n# Make the wrapper the default in the system .desktop file and via alternatives\nRUN sed -i 's|^Exec=.*|Exec=/usr/local/bin/chromium-wrapper %U|' \\\n /usr/share/applications/chromium.desktop \\\n && update-alternatives --install /usr/bin/x-www-browser x-www-browser \\\n /usr/local/bin/chromium-wrapper 100\n\n# Tell XFCE's exo-open that Chromium is the WebBrowser helper (system-wide)\nRUN mkdir -p /etc/xdg/xfce4 /usr/share/xfce4/helpers \\\n && printf 'WebBrowser=custom-WebBrowser\\n' > /etc/xdg/xfce4/helpers.rc \\\n && printf '[Desktop Entry]\\n\\\nVersion=1.0\\n\\\nType=X-XFCE-Helper\\n\\\nName=Chromium\\n\\\nIcon=chromium\\n\\\nX-XFCE-Category=WebBrowser\\n\\\nX-XFCE-CommandsWithParameter=/usr/local/bin/chromium-wrapper \"%%s\"\\n\\\nX-XFCE-Commands=/usr/local/bin/chromium-wrapper\\n' \\\n > /usr/share/xfce4/helpers/custom-WebBrowser.desktop\n\n# GitHub CLI\nRUN curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \\\n | dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg \\\n && echo \"deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main\" \\\n | tee /etc/apt/sources.list.d/github-cli.list > /dev/null \\\n && apt-get update && apt-get install -y --no-install-recommends gh \\\n && rm -rf /var/lib/apt/lists/*\n\n# Rust\nRUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y\nENV PATH=\"/root/.cargo/bin:${PATH}\"\nRUN rustup toolchain install nightly-2026-04-14 --profile minimal --component clippy,rustfmt\nRUN cargo install cargo-nextest --locked\nENV CARGO_INCREMENTAL=0\n\n# Bun\nRUN curl -fsSL https://bun.sh/install | bash\nENV PATH=\"/root/.bun/bin:${PATH}\"\n\nWORKDIR /root\n" + } + }, + "network": null + } + }, + "notifications": {}, + "interviews": { + "provider": null, + "slack": null + }, + "agent": { + "fabro_tools": false, + "permissions": null, + "mcps": {} + }, + "hooks": [], + "scm": { + "provider": null, + "owner": null, + "repository": null, + "github": null + }, + "pull_request": { + "enabled": true, + "draft": false, + "auto_merge": false, + "merge_strategy": "squash" + }, + "artifacts": { + "include": [] + }, + "integrations": { + "github": { + "permissions": {} + } + } + } + }, + "graph": { + "name": "ImplementPlan", + "nodes": { + "toolchain": { + "id": "toolchain", + "attrs": { + "shape": { + "String": "parallelogram" + }, + "script": { + "String": "command -v cargo >/dev/null || { curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && sudo ln -sf $HOME/.cargo/bin/* /usr/local/bin/; }; cargo --version 2>&1" + }, + "max_retries": { + "Integer": 0 + }, + "model": { + "String": "claude-opus-4-7" + }, + "provider": { + "String": "anthropic" + }, + "label": { + "String": "Toolchain" + } + } + }, + "exit": { + "id": "exit", + "attrs": { + "shape": { + "String": "Msquare" + }, + "provider": { + "String": "anthropic" + }, + "model": { + "String": "claude-opus-4-7" + }, + "label": { + "String": "Exit" + } + } + }, + "start": { + "id": "start", + "attrs": { + "model": { + "String": "claude-opus-4-7" + }, + "shape": { + "String": "Mdiamond" + }, + "provider": { + "String": "anthropic" + }, + "label": { + "String": "Start" + } + } + }, + "verify": { + "id": "verify", + "attrs": { + "goal_gate": { + "Boolean": true + }, + "label": { + "String": "Verify" + }, + "shape": { + "String": "parallelogram" + }, + "model": { + "String": "claude-opus-4-7" + }, + "provider": { + "String": "anthropic" + }, + "retry_target": { + "String": "fixup" + }, + "script": { + "String": "cargo +nightly-2026-04-14 clippy -q --workspace --all-targets -- -D warnings 2>&1 && cargo nextest run --cargo-quiet --workspace --status-level fail 2>&1 && cargo dev docs refresh 2>&1 && cargo dev docs check 2>&1" + } + } + }, + "simplify_opus": { + "id": "simplify_opus", + "attrs": { + "label": { + "String": "Simplify (Opus)" + }, + "model": { + "String": "claude-opus-4-7" + }, + "provider": { + "String": "anthropic" + }, + "prompt": { + "String": "# Simplify: Code Review and Cleanup\n\nReview changes vs. origin for reuse, quality, and efficiency. Fix any issues found.\n\n## Phase 1: Identify Changes\n\nRun git diff (or git diff HEAD if there are staged changes) to see what changed. If there are no git changes, review the most recently modified files that the user mentioned or that you edited earlier in this conversation.\n\n## Phase 2: Launch Three Review Agents in Parallel\n\nUse the Agent tool to launch all three agents concurrently in a single message. Pass each agent the full diff so it has the complete context.\n\n### Agent 1: Code Reuse Review\n\nFor each change:\n\n1. Search for existing utilities and helpers that could replace newly written code. Use Grep to find similar patterns elsewhere in the codebase — common locations are utility directories, shared modules, and files adjacent to the changed ones.\n2. Flag any new function that duplicates existing functionality. Suggest the existing function to use instead.\n3. Flag any inline logic that could use an existing utility — hand-rolled string manipulation, manual path handling, custom environment checks, ad-hoc type guards, and similar patterns are common candidates.\n\nNote: This is a greenfield app, so focus on maximizing simplicity and don't worry about changing things to achieve it.\n\n### Agent 2: Code Quality Review\n\nReview the same changes for hacky patterns:\n\n1. Redundant state: state that duplicates existing state, cached values that could be derived, observers/effects that could be direct calls\n2. Parameter sprawl: adding new parameters to a function instead of generalizing or restructuring existing ones\n3. Copy-paste with slight variation: near-duplicate code blocks that should be unified with a shared abstraction\n4. Leaky abstractions: exposing internal details that should be encapsulated, or breaking existing abstraction boundaries\n5. Stringly-typed code: using raw strings where constants, enums (string unions), or branded types already exist in the codebase\n\nNote: This is a greenfield app, so be aggressive in optimizing quality.\n\n### Agent 3: Efficiency Review\n\nReview the same changes for efficiency:\n\n1. Unnecessary work: redundant computations, repeated file reads, duplicate network/API calls, N+1 patterns\n2. Missed concurrency: independent operations run sequentially when they could run in parallel\n3. Hot-path bloat: new blocking work added to startup or per-request/per-render hot paths\n4. Unnecessary existence checks: pre-checking file/resource existence before operating (TOCTOU anti-pattern) — operate directly and handle the error\n5. Memory: unbounded data structures, missing cleanup, event listener leaks\n6. Overly broad operations: reading entire files when only a portion is needed, loading all items when filtering for one\n\n## Phase 3: Fix Issues\n\nWait for all three agents to complete. Aggregate their findings and fix each issue directly. If a finding is a false positive or not worth addressing, note it and move on — do not argue with the finding, just skip it.\n\nWhen done, briefly summarize what was fixed (or confirm the code was already clean)." + } + } + }, + "fixup": { + "id": "fixup", + "attrs": { + "label": { + "String": "Fixup" + }, + "prompt": { + "String": "The verify step failed. Read the build output from context and fix all clippy lint warnings, test failures, and generated docs errors." + }, + "model": { + "String": "claude-opus-4-7" + }, + "provider": { + "String": "anthropic" + }, + "max_visits": { + "Integer": 3 + } + } + }, + "preflight_lint": { + "id": "preflight_lint", + "attrs": { + "model": { + "String": "claude-opus-4-7" + }, + "shape": { + "String": "parallelogram" + }, + "max_retries": { + "Integer": 0 + }, + "label": { + "String": "Preflight Lint" + }, + "script": { + "String": "cargo +nightly-2026-04-14 clippy -q --workspace --all-targets -- -D warnings 2>&1" + }, + "provider": { + "String": "anthropic" + } + } + }, + "fmt": { + "id": "fmt", + "attrs": { + "label": { + "String": "Format" + }, + "shape": { + "String": "parallelogram" + }, + "max_retries": { + "Integer": 0 + }, + "model": { + "String": "claude-opus-4-7" + }, + "provider": { + "String": "anthropic" + }, + "script": { + "String": "cargo +nightly-2026-04-14 fmt --all 2>&1" + } + } + }, + "fix_lints": { + "id": "fix_lints", + "attrs": { + "max_visits": { + "Integer": 3 + }, + "model": { + "String": "claude-opus-4-7" + }, + "prompt": { + "String": "The preflight lint step failed. Read the build output from context and fix all clippy lint warnings." + }, + "provider": { + "String": "anthropic" + }, + "label": { + "String": "Fix Lints" + } + } + }, + "implement": { + "id": "implement", + "attrs": { + "label": { + "String": "Implement" + }, + "reasoning_effort": { + "String": "xhigh" + }, + "model": { + "String": "gpt-5.5" + }, + "provider": { + "String": "openai" + }, + "prompt": { + "String": "Read the plan file referenced in the goal and implement every step. Make all the code changes described in the plan. Use red/green TDD." + } + } + }, + "preflight_compile": { + "id": "preflight_compile", + "attrs": { + "model": { + "String": "claude-opus-4-7" + }, + "shape": { + "String": "parallelogram" + }, + "label": { + "String": "Preflight Compile" + }, + "max_retries": { + "Integer": 0 + }, + "script": { + "String": "cargo check -q --workspace 2>&1" + }, + "provider": { + "String": "anthropic" + } + } + }, + "simplify_gpt": { + "id": "simplify_gpt", + "attrs": { + "label": { + "String": "Simplify (GPT-55)" + }, + "prompt": { + "String": "# Simplify: Code Review and Cleanup\n\nReview changes vs. origin for reuse, quality, and efficiency. Fix any issues found.\n\n## Phase 1: Identify Changes\n\nRun git diff (or git diff HEAD if there are staged changes) to see what changed. If there are no git changes, review the most recently modified files that the user mentioned or that you edited earlier in this conversation.\n\n## Phase 2: Launch Three Review Agents in Parallel\n\nUse the Agent tool to launch all three agents concurrently in a single message. Pass each agent the full diff so it has the complete context.\n\n### Agent 1: Code Reuse Review\n\nFor each change:\n\n1. Search for existing utilities and helpers that could replace newly written code. Use Grep to find similar patterns elsewhere in the codebase — common locations are utility directories, shared modules, and files adjacent to the changed ones.\n2. Flag any new function that duplicates existing functionality. Suggest the existing function to use instead.\n3. Flag any inline logic that could use an existing utility — hand-rolled string manipulation, manual path handling, custom environment checks, ad-hoc type guards, and similar patterns are common candidates.\n\nNote: This is a greenfield app, so focus on maximizing simplicity and don't worry about changing things to achieve it.\n\n### Agent 2: Code Quality Review\n\nReview the same changes for hacky patterns:\n\n1. Redundant state: state that duplicates existing state, cached values that could be derived, observers/effects that could be direct calls\n2. Parameter sprawl: adding new parameters to a function instead of generalizing or restructuring existing ones\n3. Copy-paste with slight variation: near-duplicate code blocks that should be unified with a shared abstraction\n4. Leaky abstractions: exposing internal details that should be encapsulated, or breaking existing abstraction boundaries\n5. Stringly-typed code: using raw strings where constants, enums (string unions), or branded types already exist in the codebase\n\nNote: This is a greenfield app, so be aggressive in optimizing quality.\n\n### Agent 3: Efficiency Review\n\nReview the same changes for efficiency:\n\n1. Unnecessary work: redundant computations, repeated file reads, duplicate network/API calls, N+1 patterns\n2. Missed concurrency: independent operations run sequentially when they could run in parallel\n3. Hot-path bloat: new blocking work added to startup or per-request/per-render hot paths\n4. Unnecessary existence checks: pre-checking file/resource existence before operating (TOCTOU anti-pattern) — operate directly and handle the error\n5. Memory: unbounded data structures, missing cleanup, event listener leaks\n6. Overly broad operations: reading entire files when only a portion is needed, loading all items when filtering for one\n\n## Phase 3: Fix Issues\n\nWait for all three agents to complete. Aggregate their findings and fix each issue directly. If a finding is a false positive or not worth addressing, note it and move on — do not argue with the finding, just skip it.\n\nWhen done, briefly summarize what was fixed (or confirm the code was already clean)." + }, + "provider": { + "String": "openai" + }, + "model": { + "String": "gpt-5.5" + } + } + } + }, + "edges": [ + { + "from": "start", + "to": "toolchain", + "attrs": {} + }, + { + "from": "toolchain", + "to": "preflight_compile", + "attrs": { + "condition": { + "String": "outcome=succeeded" + } + } + }, + { + "from": "toolchain", + "to": "exit", + "attrs": {} + }, + { + "from": "preflight_compile", + "to": "preflight_lint", + "attrs": { + "condition": { + "String": "outcome=succeeded" + } + } + }, + { + "from": "preflight_compile", + "to": "exit", + "attrs": {} + }, + { + "from": "preflight_lint", + "to": "implement", + "attrs": { + "condition": { + "String": "outcome=succeeded" + } + } + }, + { + "from": "preflight_lint", + "to": "fix_lints", + "attrs": {} + }, + { + "from": "fix_lints", + "to": "preflight_lint", + "attrs": {} + }, + { + "from": "implement", + "to": "simplify_opus", + "attrs": {} + }, + { + "from": "simplify_opus", + "to": "simplify_gpt", + "attrs": {} + }, + { + "from": "simplify_gpt", + "to": "verify", + "attrs": {} + }, + { + "from": "verify", + "to": "fmt", + "attrs": { + "condition": { + "String": "outcome=succeeded" + } + } + }, + { + "from": "verify", + "to": "fixup", + "attrs": {} + }, + { + "from": "fixup", + "to": "verify", + "attrs": {} + }, + { + "from": "fmt", + "to": "exit", + "attrs": {} + } + ], + "attrs": { + "model_stylesheet": { + "String": "\n * { model: claude-opus-4-7; }\n " + }, + "goal": { + "String": "# Named Environments Implementation Plan\n\n> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task.\n\n**Goal:** Replace run-scoped sandbox configuration with named, provider-explicit environments that runs can select by slug.\n\n**Architecture:** Add a shared top-level environment catalog, resolve a selected environment into the run's dense settings, validate provider capabilities, and convert the resolved environment into the existing sandbox runtime specs. Keep \"environment\" as reusable desired configuration and \"sandbox\" as the concrete runtime instance created for a run.\n\n**Tech Stack:** Rust config/types crates, TOML settings layers, Fabro workflow sandbox providers, OpenAPI-generated clients, public docs.\n\n---\n\n## Summary\n\nReplace run-scoped sandbox configuration with named, provider-explicit environments. A run selects an environment by slug via `[run.environment] id = \"...\"`; Fabro resolves the environment catalog through normal config precedence, applies run-level environment overrides, validates provider capabilities, freezes the resolved environment into the run settings, and creates a concrete sandbox instance from it.\n\nThis is a greenfield break: no `[run.sandbox]` compatibility layer, no server policy layer, and no required/optional volume semantics.\n\n## Key Interface Changes\n\n- Add top-level `[environments.]` to the shared settings schema. It is valid in `settings.toml`, `.fabro/project.toml`, and `workflow.toml`.\n- Replace sandbox selection with:\n\n```toml\n[run.environment]\nid = \"fabro-dev\"\n```\n\n- Allow sparse run-level overrides under the same table:\n\n```toml\n[run.environment.resources]\nmemory = \"32GB\"\n\n[run.environment.lifecycle]\npreserve = true\n```\n\n- Environment shape:\n\n```toml\n[environments.fabro-dev]\nprovider = \"daytona\" # local | docker | daytona\n\n[environments.fabro-dev.image]\nref = \"fabro-v11\" # Docker image or Daytona snapshot name\ndockerfile = { path = \"Dockerfile\" }\n\n[environments.fabro-dev.resources]\ncpu = 8\nmemory = \"16GB\"\ndisk = \"20GB\"\n\n[environments.fabro-dev.network]\nmode = \"block\" # allow_all | block | cidr_allow_list\nallow = [\"10.0.0.0/8\"]\n\n[environments.fabro-dev.lifecycle]\npreserve = false\nstop_on_terminal = true\nauto_stop = \"30m\"\n\n[environments.fabro-dev.labels]\nrepo = \"fabro-sh/fabro\"\n\n[[environments.fabro-dev.volumes]]\nid = \"vol-agent-state\"\nmount_path = \"/home/daytona/agent-state\"\nsubpath = \"auth\"\n\n[environments.fabro-dev.env]\nNODE_ENV = \"development\"\n```\n\n- Built-in default becomes:\n\n```toml\n[run.environment]\nid = \"default\"\n\n[environments.default]\nprovider = \"docker\"\n\n[environments.default.image]\nref = \"buildpack-deps:noble\"\n\n[environments.default.resources]\ncpu = 2\nmemory = \"4GB\"\n\n[environments.default.lifecycle]\npreserve = false\nstop_on_terminal = true\n```\n\n## Implementation Changes\n\n- Add environment sparse and dense types:\n - Sparse layer in `fabro-config` for `EnvironmentLayer`, `RunEnvironmentLayer`, image/resources/network/lifecycle/volume sublayers, and `[environments]` as a `MergeMap`.\n - Dense types in `fabro-types` for `EnvironmentSettings`, `RunEnvironmentSettings`, `EnvironmentProvider`, `EnvironmentNetworkMode`, and related subsettings.\n - Add `environments` to the top-level `SettingsLayer` and resolved `WorkflowSettings`; add selected `environment` to `RunNamespace`.\n- Resolve environments before run consumers use sandbox data:\n - Merge environment definitions by slug.\n - Resolve `[run.environment].id`; error if the slug is missing.\n - Overlay sparse `[run.environment.*]` fields onto the selected environment.\n - Validate provider is `local`, `docker`, or `daytona`.\n - Validate CIDRs with existing `ipnet`.\n - Store the selected resolved environment in `RunNamespace.environment`.\n- Replace sandbox runtime mapping:\n - Convert `RunNamespace.environment` to `SandboxSpec` in workflow start and server preflight paths.\n - Daytona: `image.ref` maps to snapshot name, `dockerfile` to snapshot Dockerfile, resources to snapshot sizing, network to Daytona policy, labels/volumes/env/lifecycle to existing provider fields.\n - Docker: `image.ref` maps to Docker image, `cpu` maps to `cpu_quota = cpu * 100000`, memory maps to memory limit, `network.mode = block` maps to `network_mode = none`, `allow_all` maps to default/bridge.\n - Local: use resolved working directory; env overlays process env as today.\n- Capability diagnostics:\n - Hard error for explicit security/isolation properties a provider cannot enforce:\n - local with `network.mode = block` or `cidr_allow_list`\n - docker with `network.mode = cidr_allow_list`\n - Warnings only for unsupported resource limits, volumes, labels, `auto_stop`, and Docker `image.dockerfile`.\n - If Daytona has `image.dockerfile` without `image.ref`, error because snapshot creation needs a name.\n- Remove old sandbox config surface:\n - Delete `[run.sandbox]` parsing/resolution/types from user-facing config.\n - Replace CLI/API/tool manifest args named `sandbox` with `environment` where they select execution profile.\n - Keep runtime/public \"sandbox\" terminology only for concrete instances, e.g. `fabro sandbox ssh`, `RunSandbox`, sandbox details.\n- Update docs and generated clients:\n - Update run configuration, environments, Daytona, server configuration, CLI reference, and OpenAPI spec.\n - Regenerate Rust API types/client and TypeScript API client after OpenAPI changes.\n\n## Test Plan\n\n- Config tests:\n - default resolves to `run.environment.id = \"default\"` and Docker environment settings.\n - project/workflow/run layers merge environment catalog by slug.\n - `[run.environment]` overrides selected environment fields.\n - `env` and `labels` merge by key; `volumes` replace wholesale.\n - missing environment slug errors.\n - old `[run.sandbox]` is rejected as an unknown field.\n- Provider mapping tests:\n - Daytona environment maps to snapshot/resources/network/labels/volumes/env.\n - Docker environment maps image, CPU, memory, network block, and env.\n - Local environment ignores non-security unsupported fields with warnings.\n- Validation tests:\n - docker plus CIDR allow-list errors.\n - local plus blocked network errors.\n - resource limits unsupported by provider produce warnings, not errors.\n - volumes unsupported by provider produce warnings, not errors.\n - Daytona dockerfile without image ref errors.\n- Integration/API tests:\n - run manifest with `[environments.]` and `[run.environment]` starts with the selected provider.\n - Dockerfile path bundling works from environment image config.\n - preflight reports capability warnings and security errors.\n - CLI/API `environment` override wins over config selection.\n\n## Assumptions\n\n- No compatibility behavior is required for `[run.sandbox]` or `--sandbox`.\n- No server-side environment policy or quota enforcement is in scope.\n- Volumes are simple provider hints; unsupported volume config warns and continues.\n- Resource limits are best-effort hints; unsupported resource fields warn and continue.\n- Provider names remain explicit for now: `local`, `docker`, and `daytona`.\n" + }, + "rankdir": { + "String": "LR" + } + } + }, + "graph_source": "digraph ImplementPlan {\n graph [\n goal=\"Implement and simplify\",\n model_stylesheet=\"\n * { model: claude-opus-4-7; }\n \"\n ]\n rankdir=LR\n\n start [shape=Mdiamond, label=\"Start\"]\n exit [shape=Msquare, label=\"Exit\"]\n\n toolchain [label=\"Toolchain\", shape=parallelogram, script=\"command -v cargo >/dev/null || { curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && sudo ln -sf $HOME/.cargo/bin/* /usr/local/bin/; }; cargo --version 2>&1\", max_retries=0]\n preflight_compile [label=\"Preflight Compile\", shape=parallelogram, script=\"cargo check -q --workspace 2>&1\", max_retries=0]\n preflight_lint [label=\"Preflight Lint\", shape=parallelogram, script=\"cargo +nightly-2026-04-14 clippy -q --workspace --all-targets -- -D warnings 2>&1\", max_retries=0]\n fix_lints [label=\"Fix Lints\", prompt=\"The preflight lint step failed. Read the build output from context and fix all clippy lint warnings.\", max_visits=3]\n implement [label=\"Implement\", prompt=\"Read the plan file referenced in the goal and implement every step. Make all the code changes described in the plan. Use red/green TDD.\", model=\"gpt-55\", reasoning_effort=\"xhigh\"]\n simplify_opus [label=\"Simplify (Opus)\", prompt=\"@prompts/simplify.md\"]\n simplify_gpt [label=\"Simplify (GPT-55)\", prompt=\"@prompts/simplify.md\", model=\"gpt-55\"]\n verify [label=\"Verify\", shape=parallelogram, script=\"cargo +nightly-2026-04-14 clippy -q --workspace --all-targets -- -D warnings 2>&1 && cargo nextest run --cargo-quiet --workspace --status-level fail 2>&1 && cargo dev docs refresh 2>&1 && cargo dev docs check 2>&1\", goal_gate=true, retry_target=\"fixup\"]\n fixup [label=\"Fixup\", prompt=\"The verify step failed. Read the build output from context and fix all clippy lint warnings, test failures, and generated docs errors.\", max_visits=3]\n fmt [label=\"Format\", shape=parallelogram, script=\"cargo +nightly-2026-04-14 fmt --all 2>&1\", max_retries=0]\n\n start -> toolchain\n toolchain -> preflight_compile [condition=\"outcome=succeeded\"]\n toolchain -> exit\n preflight_compile -> preflight_lint [condition=\"outcome=succeeded\"]\n preflight_compile -> exit\n preflight_lint -> implement [condition=\"outcome=succeeded\"]\n preflight_lint -> fix_lints\n fix_lints -> preflight_lint\n implement -> simplify_opus -> simplify_gpt -> verify\n verify -> fmt [condition=\"outcome=succeeded\"]\n verify -> fixup\n fixup -> verify\n fmt -> exit\n}\n", + "workflow_slug": "implement-plan", + "source_directory": "/Users/bhelmkamp/p/fabro-sh/fabro", + "provenance": { + "server": { + "version": "0.241.0-nightly.1" + }, + "client": { + "user_agent": "fabro-cli/0.241.0-nightly.1", + "name": "fabro-cli", + "version": "0.241.0-nightly.1" + }, + "subject": { + "kind": "user", + "identity": { + "issuer": "https://github.com", + "subject": "19" + }, + "login": "brynary", + "auth_method": "github" + } + }, + "manifest_blob": "8c41a1f3f5105c10d14aba82661c1ab43c90ddbcd5e350782398a889b6c646ac", + "definition_blob": "8b6afc58f5efffd5b117a31134949c59ed0e00534e561c4fbdf8dddfbe8b4bfe", + "git": { + "origin_url": "https://github.com/fabro-sh/fabro", + "branch": "main", + "sha": "37e527a1155eb3305887f5d7d986759d2c718cb2", + "dirty": "dirty", + "push_outcome": { + "type": "succeeded", + "remote": "origin", + "branch": "main" + } + } + }, + "web_url": "http://127.0.0.1:32276/runs/01KS94BXYG7J8FNW0JWM8EQ3TZ", + "start": null, + "status": { + "kind": "starting" + }, + "status_updated_at": "2026-05-23T00:39:37.731098Z", + "last_event_at": "2026-05-23T00:39:55.364789Z", + "pending_control": null, + "checkpoints": [], + "conclusion": null, + "sandbox": { + "provider": "daytona", + "image": "buildpack-deps:noble", + "snapshot": "fabro-v11", + "runtime": { + "id": "fabro-01KS94BXYG7J8FNW0JWM8EQ3TZ", + "working_directory": "/home/daytona/workspace/fabro", + "repo_cloned": true, + "clone_origin_url": "https://github.com/fabro-sh/fabro", + "clone_branch": "main", + "workspace_root": "/home/daytona/workspace", + "repos_root": "/home/daytona/repos", + "primary_repo_path": "/home/daytona/repos/fabro-sh/fabro", + "primary_repo_link": "/home/daytona/workspace/fabro" + } + }, + "pull_request": null, + "superseded_by": null, + "pending_interviews": {}, + "stages": {} +} \ No newline at end of file