From e38eac1a3367a19cbb599c8e558090809b62439f Mon Sep 17 00:00:00 2001 From: Dai Ha Date: Sun, 23 Aug 2026 07:00:30 +0200 Subject: [PATCH] CB-632: ignore fleetd.yaml too, and fix the docs that named the old example Unit 3 renamed bridged.example.yaml to fleetd.example.yaml and taught Fleetd to read fleetd.yaml first. Two things it left behind. bridged/.gitignore still ignored only bridged.yaml. An operator who follows the new comment and copies the example to fleetd.yaml gets an untracked live config holding tokens, and git offers to commit it. Both names are ignored now, because both names work until the cutover. Three design docs still pointed readers at bridged.example.yaml, a file that no longer exists under that name. --- bridged/.gitignore | 4 +++- docs/CB-301-ext-Worktree-Provisioning.md | 2 +- docs/CB-402-OpenCode-Adapter.md | 4 ++-- docs/M4-Fleet-Health.md | 2 +- 4 files changed, 7 insertions(+), 5 deletions(-) diff --git a/bridged/.gitignore b/bridged/.gitignore index 8fbfc48..78ee14c 100644 --- a/bridged/.gitignore +++ b/bridged/.gitignore @@ -2,7 +2,9 @@ target/ dependency-reduced-pom.xml -# Local runtime config (copy from fleetd.example.yaml) +# Local runtime config (copy from fleetd.example.yaml). Both names: the live file is still +# bridged.yaml until the cutover, and Fleetd reads either one. +fleetd.yaml bridged.yaml # CB-505 audit trail + daemon stdout/stderr — runtime records, never source diff --git a/docs/CB-301-ext-Worktree-Provisioning.md b/docs/CB-301-ext-Worktree-Provisioning.md index eac46c6..a06c540 100644 --- a/docs/CB-301-ext-Worktree-Provisioning.md +++ b/docs/CB-301-ext-Worktree-Provisioning.md @@ -3,7 +3,7 @@ **Status:** ✅ shipped — implemented at commit `97ecc71` (per-worker git worktree + config-parity overlay). As-built: `session/GitWorktrees.java` behind the `Worktrees` port, wired in `Fleetd.main` and configurable via `worktreeRoot` / per-profile `parityOverlay` -(see `bridged.example.yaml`). Branch/worktree surface in `fleet_list` landed with CB-304 +(see `fleetd.example.yaml`). Branch/worktree surface in `fleet_list` landed with CB-304 (`9fe04bf`); the worker-opened-PR checkpoint landed as CB-302 (`64e70ef`). **Extends:** [CB-301 Session Manager](CB-301-Session-Manager.md) (shipped, commit `54d907c`). **Realizes:** the config-parity requirement in [Worker Git Workflow](Worker-Git-Workflow.md). diff --git a/docs/CB-402-OpenCode-Adapter.md b/docs/CB-402-OpenCode-Adapter.md index 5fe59f0..034c18d 100644 --- a/docs/CB-402-OpenCode-Adapter.md +++ b/docs/CB-402-OpenCode-Adapter.md @@ -138,7 +138,7 @@ String kind // "claude-code" (default) | "opencode" so the record stays declarative.) - Keep the existing back-compat constructors; `kind` is additive and optional. -`bridged.example.yaml` documents a two-kind `workers:` block. +`fleetd.example.yaml` documents a two-kind `workers:` block. ### C. `OpenCodeLauncher` — the adapter hooks for opencode @@ -208,7 +208,7 @@ sequenceDiagram `ClaudeCodeLauncher` extend it with `namePrefix()="claude"` and `buildLaunch()` wrapping today's guard+env+argv logic. Green build, identical tests — pure refactor. *(IDE `refactor` where possible; the primary re-runs the gate workers can't.)* -2. **`kind:` discriminator.** Add the field + normalization + `bridged.example.yaml`. Default +2. **`kind:` discriminator.** Add the field + normalization + `fleetd.example.yaml`. Default path unchanged (`kind=claude-code`). 3. **`OpenCodeLauncher`.** Implement the three hooks; unit-test `buildLaunch` (env has no `ANTHROPIC_BASE_URL`; `OPENCODE_CONFIG` points at a file carrying the bridge MCP block + diff --git a/docs/M4-Fleet-Health.md b/docs/M4-Fleet-Health.md index ff1343b..19bc515 100644 --- a/docs/M4-Fleet-Health.md +++ b/docs/M4-Fleet-Health.md @@ -927,7 +927,7 @@ Acceptance criteria: 15. Webhook response bodies are ignored and cannot direct recovery. 16. Tests cover disabled mode, one lead without sink, open/update/reminder/resolve, restart, dedup, reassignment, disable/re-enable, and sink failure while local health continues. -17. `bridged.example.yaml` documents all hot keys and compiled floors. +17. `fleetd.example.yaml` documents all hot keys and compiled floors. 18. The operator Features wiki is updated separately. The portable `CLAUDE.md` block is checked and changed only if shipped tool or inbox semantics make it untrue. 19. `mvn clean install` passes.