chore: Phase 9 completion - depguard audit, docs, minor bump
Some checks are pending
ci / build-test (push) Waiting to run
ci / docker-build (push) Waiting to run

Final phase of the hexagonal architecture refactor (plans/2026-08-15-hexagonal-architecture.md). Verifies depguard rules, updates CONTRIBUTING.md to reflect final architecture, marks plan as complete, and bumps minor version to 0.34.0.
This commit is contained in:
2026-08-16 00:27:36 +02:00
parent 814e020986
commit cd44501fa9
4 changed files with 24 additions and 21 deletions

View File

@@ -51,24 +51,27 @@ cmd/webhook/ Gitea deploy-webhook receiver (push-to-deploy on mac-mini)
internal/ All Go packages
core/ Hexagon core ([ADR 0016](docs/adr/0016-hexagonal-ports-adapters.md)):
domain/ (pure model, stdlib only), ports/ (driven-port
interfaces), app/ (use-case services)populated by the
phased refactor (plans/2026-08-15-hexagonal-architecture.md);
core may not import adapters, enforced by depguard
adapters/ Ports' implementations (postgres, ssh, probes, remote,
secrets, events) + driving adapters (httpapi, mcpserver,
scheduler, execworker, cli) — scaffolded; packages move
here phase by phase
httpapi/ REST + MCP server (OpenAPI-generated)
mcp/ MCP tool implementations
db/ (moved) → internal/adapters/postgres: pool, migrations,
seeds, sqlc queries — package still named `db` until
the Phase 3 repository split
scheduler/ Observe loop, probes, signals
actuator/ SSH execution
learning/ Pattern recognition, anomaly detection
policy/ Risk classifier
secrets/ Infisical + SOPS backend
ontology/ Type hierarchy, relationship validation
interfaces), app/ (use-case services — EntityService,
RelationshipService, SignalService, ObservationService,
KnowledgeService, LearningService, etc.) — populated by
the phased refactor; core may not import adapters,
enforced by depguard (verified Phase 9 audit)
adapters/ Ports' implementations: postgres/ (pool, migrations, seeds,
sqlcgen, repos — EntityRepo, RelRepo, OntologyRepo,
EntityReader, SignalRepo, MetricsRepo, etc.),
ssh/ (CommandExecutor via actuator),
remote/ (TargetResolver via internal/remote),
probes/ (Checker implementations per probe kind:
HTTP, TCP, ping, DNS, SSH)
httpapi/ REST server (OpenAPI-generated) — driving adapter
mcp/ MCP tool implementations — driving adapter
scheduler/ Observe loop, coverage sweep — driving adapter (moves
to ObservationService/SignalService in Phase 5)
execworker/ Execution worker — driving adapter
actuator/ SSH execution — consumed by adapters/ssh
remote/ Target resolution — consumed by adapters/remote
audit/ Audit report helpers
observability/ Event/Audit recorder helpers
knowledge/ Knowledge YAML seed ingestion
api/openapi.yaml API contract — the source of truth for endpoints
migrations/ Forward-only SQL migrations (TimescaleDB)

View File

@@ -1 +1 @@
0.33.6
0.34.0

View File

@@ -1,7 +1,7 @@
# Hexagonal architecture for Oikos — design and phased refactor plan
**Date:** 2026-08-15
**Status:** In progress — Phases 02 shipped; Phases 39 pending
**Status:** Complete — Phases 09 shipped; all commits pushed to `main`
**Scope:** All Go code (`cmd/oikos`, `cmd/nomos`, `cmd/webhook`) and the UI
split. One hexagon covers the oikos backend; nomos is an external agent
client that gets an internal cleanup (Phase 8) but stays outside the core.

View File

@@ -22,7 +22,7 @@ went sideways, open an investigation.
| 2026-08-04 | [Hermes MCP client integration](done/2026-08-04-hermes-mcp-client-integration.md) | Done — deployed |
| 2026-08-05 | [Agent execution safety: QEMU guest agent gate + host-mutation guard](done/2026-08-05-agent-execution-safety-qemu-guest-agent-gate.md) | Done — implemented (1b9c761) |
| 2026-08-05 | [Backend evaluation: architecture, security, and reliability improvements](2026-08-05-backend-evaluation-improvements.md) | Done — all three phases (B, D, E) implemented as code (0.28.00.29.0), deployed, and hardened via review. Remaining: C (security) and F (performance) backlog. |
| 2026-08-15 | [Hexagonal architecture — design and phased refactor](2026-08-15-hexagonal-architecture.md) | In Progress — Phases 02 done (ADR 0016, client extracted to dtoro/oikos-web, ports + adapters scaffold); Phase 3 next |
| 2026-08-15 | [Hexagonal architecture — design and phased refactor](2026-08-15-hexagonal-architecture.md) | Complete — all 10 phases shipped |
## Done