dtoro
638e313c66
Problem: Repo had no developer guide, no client onboarding doc, no agent dev instructions. Stale files (675KB SQL dump, one-off convert script, legacy MCP builder) cluttered the tree. Client enrollment was a documented intention with no Go implementation. Changes: - New docs: CONTRIBUTING.md (dev setup), CLIENTS.md (client onboarding), .agents/dev/CONTRIBUTING.md (agent codebase map) - New plan: plans/2026-07-07-client-lifecycle-in-go.md — full client lifecycle (planned→provisioning→active→deprecated→destroyed) in Go, replacing archived Python secrets-issuance, adding client API endpoints and 6 missing MCP tools - Cleanup: deleted archive/convert-wiki.py (one-off), archive/mcp/ build_host_files.py (legacy), backups/pre-deploy-7f7d039.sql (local) - Fixes: plans/index.md duplicate row removed, README.md repo layout updated for current state, AGENTS.md header points to new guides Risk: low. Docs only + stale file deletion. No code changes. New plan is proposal, not implementation. Verification: git diff reviewed, all changes are prose/docs/plans.
2.1 KiB
2.1 KiB
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 |
| 2026-07-06 | Consolidate Oikos control plane onto mac-mini | In Progress (Phase 1-6 implemented, pending cutover) |
| 2026-07-07 | Client lifecycle in Go — enrollment through deprecation | Planned |
| 2026-07-07 | Comprehensive audit: stale files, state gaps, and next steps | Planned |
| 2026-07-07 | DB as single source of truth for agent knowledge | Proposed |
| 2026-07-07 | Migrate bin/homelab CLI to Go oikos homelab | Planned |
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 |
Conventions
- File name:
YYYY-MM-DD-<slug>.md. Use the target date if known, otherwise the planning date. - Status:
Planned→In Progress→Done(move todone/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.