Files

dtoro e3a0326c78 docs: codebase review + documentation maintenance pass

Full review (plans/2026-07-17-codebase-review-and-cleanup.md) covering Go,
web SPA, and docs. Applied low-risk doc/tooling fixes; code refactors and
dead-code deletions are listed as actionable recommendations pending approval.

Doc fixes:
- AGENTS.md: remove ghost of retired request_execution (contradicted the
  retire notice above it); fix knowledge/wiki/ -> archive/knowledge/;
  replace brittle counts (33 tools, 36 docs, 20 checks) with pointers to
  source; drop point-in-time dates.
- OIKOS.md: fix broken plan link (now in done/); 001-011 -> 001-020;
  15 MCP tools -> pointer; replace hardcoded knowledge counts.
- README.md: 15 tools -> pointer; fix wails plan link (now in done/);
  complete internal/ package list (add checkdefaults, observability, safego);
  add cmd/desktop/ to repo layout.
- commands.md, page-templates.md: fix broken links; HERMES.md -> NOMOS.md.

Plans housekeeping:
- Move 4 done 2026-07-14 plans from plans/ to plans/done/.
- Reconcile plans/index.md: add the 2 missing 2026-07-14 entries and the
  2 missing 2026-07-15 done entries; add this review.
- Fix stale plan path in migrations/020 comment.

New docs:
- docs/index.md and docs/operations/README.md (folder READMEs per
  writing-style.md).

Tooling:
- web/package.json: add check/typecheck/lint scripts + svelte-check devDep.
- Makefile: desktop-package version now reads from VERSION file instead of
  hardcoded 0.1.0.

VERSION 0.7.6 -> 0.7.7 (patch: docs + tooling only).

2026-07-17 22:04:54 +02:00

5.3 KiB

Raw Blame History

Plans

Pre-flight runbooks for planned changes. When a plan is executed, move it to done/ and add changelog entries on affected node pages. If things went sideways, open an investigation.

Active

Date	Title	Status
2026-07-05	Oikos Prometheus LXC	Planned — not started
2026-07-08	Oikos gaps, broken things, and improvements	In Progress — security items (B1-B5) and doc drift (E) still open
2026-07-08	Control room web UI	In Progress — packaging/auth sections superseded by the Wails plan's Phase 0 (client/server split); M4 still open
2026-07-08	Liveness, drift, and UX cohesion	In Progress — Phase 5 deferred
2026-07-10	General gated execution: unlimited actions, gated by risk	In Progress — `request_execution` enum retired (`60effcb`); only auto-act revival (item 10) still open
2026-07-11	Nomos agent code review: gaps and improvement plan	In Progress — only C1 (unauthenticated nomos gateway) still open, deferred
2026-07-14	Activity gaps	In Progress
2026-07-14	Activity timeline	In Progress
2026-07-17	Codebase review, lint audit, and documentation maintenance	Report delivered — doc/tooling fixes applied; code refactors pending

Done

See done/ for executed plans:

Date	Title
2026-06-01	Slate AX → SODOLA managed switch migration
2026-06-04	Deprecate claudio-bot
2026-06-25	Yuvomi deployment — house.hubris.network
2026-06-29	Grimmory migration — Booklore → dedicated LXC
2026-06-24	TRMNL plugins LXC (128) + middleware deploy pipeline
2026-07-06	Adopt wiki-hq doc architecture
2026-07-07	MCP tool completion — Hermes operator interface
2026-07-07	DB as single source of truth for agent knowledge
2026-07-07	Comprehensive audit: stale files, state gaps, and next steps
2026-07-07	Client lifecycle in Go — enrollment through deprecation
2026-07-08	Fix MCP analysis tools
2026-07-06	Consolidate Oikos control plane onto mac-mini
2026-07-08	Signal triggers: host health checks
2026-07-08	Plan vs implementation cross-reference
2026-07-08	Nomos resident agent (renames Hermes)
2026-07-09	Chat sessions: reliability, cost, and session-management fixes
2026-07-09	Session execution, UX, and learning improvements
2026-07-10	Autonomous plan execution: close the observation gap
2026-07-11	Tasks: the chat page as goal-structured autonomous work
2026-07-11	Concurrent task execution: safety + throughput + frontend correctness
2026-07-11	UI review: information architecture, usability, and best practices
2026-07-11	Task completion safety net: every live task is stuck "Running"
2026-07-12	Wails desktop application
2026-07-13	MCP tool apps: custom in-chat renderers
2026-07-14	Session reliability & UX audit
2026-07-14	Tool timeline in sidebar
2026-07-14	Unified agent activity indicator
2026-07-14	Post-fix session remainders: empty responses & plan drift
2026-07-15	Plan-first and iteration
2026-07-15	WhatsApp session audit

Conventions

File name: YYYY-MM-DD-<slug>.md. Use the target date if known, otherwise the planning date.
Status: Planned → In Progress → Done (move to done/ on completion).
When done: add a changelog entry on every affected node page, then move the file to done/.
Plans are append-only once execution starts — don't rewrite pre-flight intent after the fact.

5.3 KiB Raw Blame History

Plans

Active

Done

Conventions

5.3 KiB

Raw Blame History