chore: Phase 9 completion - depguard audit, docs, minor bump
Some checks failed
ci / build-test (push) Has been cancelled
ci / docker-build (push) Has been cancelled

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