Algis DumbrisandClaude Opus 4.6
9dd27c4b9b
Switch Docker runtime from scratch to alpine:3.19 so kubectl exec works for admin CLI operations. Add `synapbus channels create` and `synapbus channels join` CLI commands with corresponding admin socket handlers. Change default socket path to /data/synapbus.sock (absolute). Also add Helm envFrom support and NodePort configuration. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
3.4 KiB
Implementation Plan: Admin CLI & Docker Fixes
Branch: 006-admin-cli-docker-fixes | Date: 2026-03-15 | Spec: spec.md
Input: Feature specification from /specs/006-admin-cli-docker-fixes/spec.md
Summary
Fix four operational issues blocking reliable admin CLI usage in containerized SynapBus: switch Docker base image from scratch to alpine:3.19 so admin socket CLI works via kubectl exec, add synapbus channels create and synapbus channels join CLI commands backed by new admin socket handlers, and change the default socket path from relative ./data/synapbus.sock to absolute /data/synapbus.sock.
Technical Context
Language/Version: Go 1.25+ (per go.mod)
Primary Dependencies: spf13/cobra (CLI), go-chi/chi (HTTP), mark3labs/mcp-go (MCP)
Storage: modernc.org/sqlite (pure Go, zero CGO)
Testing: go test ./... (table-driven tests)
Target Platform: linux/amd64, darwin/arm64 (Docker + local dev)
Project Type: CLI / web-service (single binary)
Performance Goals: Admin socket commands complete in < 1 second
Constraints: Zero CGO, single binary, pure Go
Scale/Scope: Single instance, admin-only operations
Constitution Check
GATE: Must pass before Phase 0 research. Re-check after Phase 1 design.
| Principle | Status | Notes |
|---|---|---|
| I. Local-First, Single Binary | PASS | No new external dependencies. Alpine base image only adds shell availability. |
| II. MCP-Native | PASS | Changes are admin CLI only, no MCP interface changes. |
| III. Pure Go, Zero CGO | PASS | No new Go dependencies. Dockerfile still builds with CGO_ENABLED=0. |
| IV. Multi-Tenant with Ownership | PASS | Admin socket is localhost-only, trusted operator context. |
| V. Embedded OAuth 2.1 | N/A | No auth changes. |
| VI. Semantic-Ready Storage | N/A | No storage schema changes. |
| VII. Swarm Intelligence | N/A | No swarm pattern changes. |
| VIII. Observable by Default | PASS | Channel create/join are traced via existing channel service. |
| IX. Progressive Complexity | PASS | New CLI commands add no complexity for basic usage. |
| X. Web UI | N/A | No UI changes. |
Gate Result: PASS — no violations.
Project Structure
Documentation (this feature)
specs/006-admin-cli-docker-fixes/
├── plan.md # This file
├── research.md # Phase 0 output
├── data-model.md # Phase 1 output
├── quickstart.md # Phase 1 output
├── contracts/ # Phase 1 output (admin socket protocol)
└── tasks.md # Phase 2 output (via /speckit.tasks)
Source Code (repository root)
# Files modified:
Dockerfile # scratch → alpine:3.19
cmd/synapbus/admin.go # Add channels create/join commands, fix default socket path
internal/admin/socket.go # Add channels.create and channels.join handlers
cmd/synapbus/admin_test.go # Tests for new CLI commands
# Files unchanged but referenced:
internal/channels/service.go # CreateChannel, JoinChannel (already exist)
internal/channels/store.go # GetChannelByName (already exists)
internal/admin/server.go # Services struct (already has Channels field)
Structure Decision: This feature modifies 3 existing files and adds no new files. All changes fit within the existing project structure.
Complexity Tracking
No constitution violations to justify.