chore: Phase 9 completion - depguard audit, docs, minor bump
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:
@@ -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)
|
||||||
|
|||||||
@@ -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 0–2 shipped; Phases 3–9 pending
|
**Status:** Complete — Phases 0–9 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.
|
||||||
|
|||||||
@@ -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.0–0.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.0–0.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 0–2 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
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user