From 00de8107ea791b7f9f54070a89e05c1e6eccc630 Mon Sep 17 00:00:00 2001 From: oskar Date: Tue, 4 Aug 2026 14:59:48 +0200 Subject: [PATCH] feat(kb): przenosiny type=subsystem do kb/subsystems/ (18 plikow, bez SPLIT) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit public (wzorce/schematy, bez IP/portow/sciezek hostow): observer, capability-model, event-system, standards, agent-operating-procedures, service-model, action-approval-model. private: recon-multiagent, fleet-inventory, fleet-inventory-verify, kb-mail-pillar, kb-documents-pillar, topology, agent-system. deprecated (martwe stuby z 2026-04-15) — visibility private wg rozstrzygniecia 6: access-model, core-stack, legacy-services-list, networking. git mv + frontmatter, tresc nietknieta. Co-Authored-By: Claude Opus 5 (1M context) --- docs/access.md => kb/subsystems/access-model.md | 10 ++++++++++ .../subsystems/action-approval-model.md | 9 +++++++++ .../subsystems/agent-operating-procedures.md | 9 +++++++++ .../README.md => kb/subsystems/agent-system.md | 9 +++++++++ .../subsystems/capability-model.md | 9 +++++++++ {docs => kb/subsystems}/core-stack.md | 10 ++++++++++ {docs => kb/subsystems}/event-system.md | 9 +++++++++ .../subsystems/fleet-inventory-verify.md | 9 +++++++++ .../subsystems/fleet-inventory.md | 9 +++++++++ .../subsystems/kb-documents-pillar.md | 9 +++++++++ .../subsystems/kb-mail-pillar.md | 9 +++++++++ .../subsystems/legacy-services-list.md | 10 ++++++++++ {docs => kb/subsystems}/networking.md | 10 ++++++++++ docs/observer-runtime.md => kb/subsystems/observer.md | 9 +++++++++ .../subsystems/recon-multiagent.md | 9 +++++++++ {docs => kb/subsystems}/service-model.md | 9 +++++++++ {docs => kb/subsystems}/standards.md | 9 +++++++++ {docs => kb/subsystems}/topology.md | 9 +++++++++ 18 files changed, 166 insertions(+) rename docs/access.md => kb/subsystems/access-model.md (83%) rename services/agent-system/action-model.md => kb/subsystems/action-approval-model.md (95%) rename docs/agents.md => kb/subsystems/agent-operating-procedures.md (96%) rename services/agent-system/README.md => kb/subsystems/agent-system.md (94%) rename docs/capabilities.md => kb/subsystems/capability-model.md (97%) rename {docs => kb/subsystems}/core-stack.md (79%) rename {docs => kb/subsystems}/event-system.md (97%) rename docs/infra/inventory-verify-2026-07-02.md => kb/subsystems/fleet-inventory-verify.md (99%) rename docs/infra/inventory-2026-06-30.md => kb/subsystems/fleet-inventory.md (99%) rename docs/kb/kb-02-documents-design.md => kb/subsystems/kb-documents-pillar.md (98%) rename docs/kb/kb-01-email-design.md => kb/subsystems/kb-mail-pillar.md (97%) rename docs/services.md => kb/subsystems/legacy-services-list.md (85%) rename {docs => kb/subsystems}/networking.md (84%) rename docs/observer-runtime.md => kb/subsystems/observer.md (98%) rename docs/architecture/RECON-multiagent-2026-07-27.md => kb/subsystems/recon-multiagent.md (99%) rename {docs => kb/subsystems}/service-model.md (96%) rename {docs => kb/subsystems}/standards.md (97%) rename {docs => kb/subsystems}/topology.md (95%) diff --git a/docs/access.md b/kb/subsystems/access-model.md similarity index 83% rename from docs/access.md rename to kb/subsystems/access-model.md index 9591b4f..46c2274 100644 --- a/docs/access.md +++ b/kb/subsystems/access-model.md @@ -1,3 +1,13 @@ +--- +okf: "0.1" +type: subsystem +visibility: private +status: deprecated +updated: 2026-04-15 +links: [] +superseded_by: "kb/subsystems/fleet-inventory.md + hosts//capabilities.yaml (stub z 2026-04-15, sprzed floty)" +--- + # Access ## Description diff --git a/services/agent-system/action-model.md b/kb/subsystems/action-approval-model.md similarity index 95% rename from services/agent-system/action-model.md rename to kb/subsystems/action-approval-model.md index 29c2253..14aad54 100644 --- a/services/agent-system/action-model.md +++ b/kb/subsystems/action-approval-model.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: public +status: active +updated: 2026-05-20 +links: [] +--- + ### Action Approval Data Model Actions are JSON files stored in `/opt/homelab/actions/{status}/{action_id}.json`. diff --git a/docs/agents.md b/kb/subsystems/agent-operating-procedures.md similarity index 96% rename from docs/agents.md rename to kb/subsystems/agent-operating-procedures.md index 8861c31..4bedc6a 100644 --- a/docs/agents.md +++ b/kb/subsystems/agent-operating-procedures.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: public +status: active +updated: 2026-05-20 +links: [] +--- + # Agent Operating Procedures This document defines the operating procedures, constraints, and interaction protocols for non-human agents (AI agents, autonomous scripts) within the Homelab Codex ecosystem. diff --git a/services/agent-system/README.md b/kb/subsystems/agent-system.md similarity index 94% rename from services/agent-system/README.md rename to kb/subsystems/agent-system.md index d433c86..3355204 100644 --- a/services/agent-system/README.md +++ b/kb/subsystems/agent-system.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: private +status: active +updated: 2026-05-17 +links: [] +--- + ### Agent System Central runtime materializer and Operator Control Plane UI. diff --git a/docs/capabilities.md b/kb/subsystems/capability-model.md similarity index 97% rename from docs/capabilities.md rename to kb/subsystems/capability-model.md index 3c56b4b..809e9dd 100644 --- a/docs/capabilities.md +++ b/kb/subsystems/capability-model.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: public +status: active +updated: 2026-05-20 +links: [] +--- + # Node Capability Model This document defines the capability model for the homelab infrastructure. The goal is to provide a declarative way to describe what each node can do, its constraints, and its suitability for various workloads. diff --git a/docs/core-stack.md b/kb/subsystems/core-stack.md similarity index 79% rename from docs/core-stack.md rename to kb/subsystems/core-stack.md index bbd3064..2af5b62 100644 --- a/docs/core-stack.md +++ b/kb/subsystems/core-stack.md @@ -1,3 +1,13 @@ +--- +okf: "0.1" +type: subsystem +visibility: private +status: deprecated +updated: 2026-04-15 +links: [] +superseded_by: "kb/subsystems/fleet-inventory.md + hosts//capabilities.yaml (stub z 2026-04-15, sprzed floty)" +--- + # Core Stack ## Description diff --git a/docs/event-system.md b/kb/subsystems/event-system.md similarity index 97% rename from docs/event-system.md rename to kb/subsystems/event-system.md index acaae73..fe0ab63 100644 --- a/docs/event-system.md +++ b/kb/subsystems/event-system.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: public +status: active +updated: 2026-05-12 +links: [] +--- + # Homelab Event System The homelab multi-agent platform uses a filesystem-first event architecture for observability, auditability, and agent reasoning. diff --git a/docs/infra/inventory-verify-2026-07-02.md b/kb/subsystems/fleet-inventory-verify.md similarity index 99% rename from docs/infra/inventory-verify-2026-07-02.md rename to kb/subsystems/fleet-inventory-verify.md index 94402cb..409b4b2 100644 --- a/docs/infra/inventory-verify-2026-07-02.md +++ b/kb/subsystems/fleet-inventory-verify.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: private +status: active +updated: 2026-07-02 +links: [] +--- + # Weryfikacja inwentaryzacji floty 2026-06-30 — stan na 2026-07-02 Zebrano: 2026-07-02 ~15:20 CEST (read-only recon, zero zmian na nodach). diff --git a/docs/infra/inventory-2026-06-30.md b/kb/subsystems/fleet-inventory.md similarity index 99% rename from docs/infra/inventory-2026-06-30.md rename to kb/subsystems/fleet-inventory.md index f920612..35a57d5 100644 --- a/docs/infra/inventory-2026-06-30.md +++ b/kb/subsystems/fleet-inventory.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: private +status: active +updated: 2026-07-03 +links: [] +--- + # Inwentaryzacja floty homelab-codex — 2026-06-30 Zebrano: 2026-06-30 17:09 CEST diff --git a/docs/kb/kb-02-documents-design.md b/kb/subsystems/kb-documents-pillar.md similarity index 98% rename from docs/kb/kb-02-documents-design.md rename to kb/subsystems/kb-documents-pillar.md index a153c73..51ee2aa 100644 --- a/docs/kb/kb-02-documents-design.md +++ b/kb/subsystems/kb-documents-pillar.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: private +status: active +updated: 2026-07-01 +links: [] +--- + # KB filar #2 — Dokumenty (Nextcloud + Paperless) — design > Dokument-master filaru dokumentow. Stoi pod `kb-00-overview.md`. diff --git a/docs/kb/kb-01-email-design.md b/kb/subsystems/kb-mail-pillar.md similarity index 97% rename from docs/kb/kb-01-email-design.md rename to kb/subsystems/kb-mail-pillar.md index 39fd6b1..9db7766 100644 --- a/docs/kb/kb-01-email-design.md +++ b/kb/subsystems/kb-mail-pillar.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: private +status: active +updated: 2026-06-24 +links: [] +--- + # Filar maili — projekt (homelab-codex · KB · projekt #1) > Pierwszy filar. Wzorzec referencyjny dla pozostałych (archiwum, embeddingi na SOLARIA, szkielet agenta, deploy). diff --git a/docs/services.md b/kb/subsystems/legacy-services-list.md similarity index 85% rename from docs/services.md rename to kb/subsystems/legacy-services-list.md index 522190b..52724b4 100644 --- a/docs/services.md +++ b/kb/subsystems/legacy-services-list.md @@ -1,3 +1,13 @@ +--- +okf: "0.1" +type: subsystem +visibility: private +status: deprecated +updated: 2026-04-15 +links: [] +superseded_by: "kb/subsystems/fleet-inventory.md + hosts//capabilities.yaml (stub z 2026-04-15, sprzed floty)" +--- + # Services ## Description diff --git a/docs/networking.md b/kb/subsystems/networking.md similarity index 84% rename from docs/networking.md rename to kb/subsystems/networking.md index b04f03b..ebcc25f 100644 --- a/docs/networking.md +++ b/kb/subsystems/networking.md @@ -1,3 +1,13 @@ +--- +okf: "0.1" +type: subsystem +visibility: private +status: deprecated +updated: 2026-04-15 +links: [] +superseded_by: "kb/subsystems/fleet-inventory.md + hosts//capabilities.yaml (stub z 2026-04-15, sprzed floty)" +--- + # Networking ## Description diff --git a/docs/observer-runtime.md b/kb/subsystems/observer.md similarity index 98% rename from docs/observer-runtime.md rename to kb/subsystems/observer.md index ab57a79..ca92f99 100644 --- a/docs/observer-runtime.md +++ b/kb/subsystems/observer.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: public +status: active +updated: 2026-06-17 +links: [] +--- + # Observer Runtime The Observer Runtime is a lightweight agent responsible for synthesizing the operational world state of the homelab from raw events, logs, and state files. diff --git a/docs/architecture/RECON-multiagent-2026-07-27.md b/kb/subsystems/recon-multiagent.md similarity index 99% rename from docs/architecture/RECON-multiagent-2026-07-27.md rename to kb/subsystems/recon-multiagent.md index ab637eb..50ce545 100644 --- a/docs/architecture/RECON-multiagent-2026-07-27.md +++ b/kb/subsystems/recon-multiagent.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: private +status: active +updated: 2026-07-30 +links: [] +--- + # Architecture Recon — multi-agent systems (2026-07-27) Read-only recon of the two multi-agent systems (control-plane, ai-cluster) across vps, diff --git a/docs/service-model.md b/kb/subsystems/service-model.md similarity index 96% rename from docs/service-model.md rename to kb/subsystems/service-model.md index ec3d4ad..7d3a52e 100644 --- a/docs/service-model.md +++ b/kb/subsystems/service-model.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: public +status: active +updated: 2026-05-11 +links: [] +--- + # Service Model and Healthchecks This document defines the normalized service model for the homelab. diff --git a/docs/standards.md b/kb/subsystems/standards.md similarity index 97% rename from docs/standards.md rename to kb/subsystems/standards.md index 69e9318..1f42756 100644 --- a/docs/standards.md +++ b/kb/subsystems/standards.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: public +status: active +updated: 2026-05-20 +links: [] +--- + # Infrastructure Standards This document defines the standards and conventions for the homelab GitOps-lite environment. diff --git a/docs/topology.md b/kb/subsystems/topology.md similarity index 95% rename from docs/topology.md rename to kb/subsystems/topology.md index 31eb5c0..1796d88 100644 --- a/docs/topology.md +++ b/kb/subsystems/topology.md @@ -1,3 +1,12 @@ +--- +okf: "0.1" +type: subsystem +visibility: private +status: active +updated: 2026-05-11 +links: [] +--- + # Homelab Topology ## Nodes