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>
75 lines
3.4 KiB
Markdown
75 lines
3.4 KiB
Markdown
# Implementation Plan: Admin CLI & Docker Fixes
|
|
|
|
**Branch**: `006-admin-cli-docker-fixes` | **Date**: 2026-03-15 | **Spec**: [spec.md](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)
|
|
|
|
```text
|
|
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)
|
|
|
|
```text
|
|
# 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.
|