Claude Code 9f57e48cef
Some checks failed
WHOOSH CI / speclint (push) Has been cancelled
WHOOSH CI / contracts (push) Has been cancelled
WHOOSH CI / speclint (pull_request) Has been cancelled
WHOOSH CI / contracts (pull_request) Has been cancelled
fix: resolve Docker Client API compilation error in swarm_manager.go
Fixed undefined types.ContainerLogsOptions error by using an inline struct
that matches the Docker API interface. This resolves compilation issues
with the GetServiceLogs method while maintaining compatibility with the
existing Docker v24.0.7 dependency.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-21 21:46:54 +10:00
2025-09-20 13:21:56 +10:00

WHOOSH Council & Team Orchestration (Beta)

WHOOSH assembles kickoff councils from Design Brief issues and is evolving toward autonomous team orchestration across the CHORUS stack. Council formation/deployment works today, but persistence, telemetry, and self-organising teams are still under construction.

Current Capabilities

  • Gitea Design Brief detection + council composition (internal/monitor, internal/composer).
  • Docker Swarm agent deployment with role-specific env vars (internal/orchestrator).
  • JWT authentication, rate limiting, OpenTelemetry hooks.
  • 🚧 API persistence: REST handlers still return placeholder data while Postgres wiring is finished (internal/server/server.go).
  • 🚧 Analysis ingestion: composer relies on heuristic classification; LLM/analysis ingestion is logged but unimplemented (internal/composer/service.go).
  • 🚧 Deployment telemetry: results arent persisted yet; monitoring includes TODOs for task details (internal/monitor/monitor.go).
  • 🚧 Autonomous teams: joining/role balancing planned but not live.

The full plan and sequencing live in:

  • docs/progress/WHOOSH-roadmap.md
  • docs/DEVELOPMENT_PLAN.md

Quick Start

git clone https://gitea.chorus.services/tony/WHOOSH.git
cd WHOOSH
cp .env.example .env
# Update DB, JWT, Gitea tokens
make migrate
go run ./cmd/whoosh

By default the API runs on :8080 and expects Postgres + Docker Swarm in the environment. Until persistence lands, project/council endpoints return mock payloads to keep the UI working.

Roadmap Snapshot

  1. Data path hardening replace mock handlers with real Postgres reads/writes.
  2. Telemetry Persist deployment outcomes, emit KACHING events, build dashboards.
  3. Autonomous loop Drive team formation/joining from composer outputs, tighten HMMM collaboration.
  4. UX & governance Admin dashboards, compliance hooks, Decision Records.

Refer to the roadmap for sprint-by-sprint targets and exit criteria.

Working With Councils

  • Monitor issues via the API (GET /api/v1/councils).
  • Inspect generated artifacts (GET /api/v1/councils/{id}/artifacts).
  • Use Swarm to watch agent containers spin up/down during council execution.

Contributing

Before landing features, align with roadmap tickets (WSH-API, WSH-ANALYSIS, WSH-OBS, WSH-AUTO, WSH-UX). Include Decision Records (UCXL addresses) for architectural/security changes so SLURP/BUBBLE can ingest them later.

Description
Autonomous AI Development Teams Orchestration Platform
Readme 120 MiB
Languages
Go 86.9%
JavaScript 4%
HTML 2.6%
Makefile 1.7%
CSS 1.4%
Other 3.4%