From 78806f9fa023c866764afa3b5a4da0a7bf71a48f Mon Sep 17 00:00:00 2001 From: Michael Chus Date: Sun, 1 Mar 2026 16:38:57 +0300 Subject: [PATCH] Add shared bible submodule, rename local bible to bible-local MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add bible.git as submodule at bible/ - Move docs/bible/ → bible-local/ (project-specific architecture) - Update CLAUDE.md to reference both bible/ and bible-local/ - Add AGENTS.md for Codex with same structure Co-Authored-By: Claude Sonnet 4.6 --- .gitmodules | 3 ++ AGENTS.md | 11 +++++ CLAUDE.md | 12 +++++- bible | 1 + {docs/bible => bible-local}/01-overview.md | 0 .../bible => bible-local}/02-architecture.md | 0 {docs/bible => bible-local}/03-api.md | 0 {docs/bible => bible-local}/04-data-models.md | 0 {docs/bible => bible-local}/05-collectors.md | 0 {docs/bible => bible-local}/06-parsers.md | 42 +++++++++++++++++++ {docs/bible => bible-local}/07-exporters.md | 0 .../bible => bible-local}/08-build-release.md | 0 {docs/bible => bible-local}/09-testing.md | 0 {docs/bible => bible-local}/10-decisions.md | 0 {docs/bible => bible-local}/README.md | 0 15 files changed, 68 insertions(+), 1 deletion(-) create mode 100644 AGENTS.md create mode 160000 bible rename {docs/bible => bible-local}/01-overview.md (100%) rename {docs/bible => bible-local}/02-architecture.md (100%) rename {docs/bible => bible-local}/03-api.md (100%) rename {docs/bible => bible-local}/04-data-models.md (100%) rename {docs/bible => bible-local}/05-collectors.md (100%) rename {docs/bible => bible-local}/06-parsers.md (82%) rename {docs/bible => bible-local}/07-exporters.md (100%) rename {docs/bible => bible-local}/08-build-release.md (100%) rename {docs/bible => bible-local}/09-testing.md (100%) rename {docs/bible => bible-local}/10-decisions.md (100%) rename {docs/bible => bible-local}/README.md (100%) diff --git a/.gitmodules b/.gitmodules index 7ae296d..b869b07 100644 --- a/.gitmodules +++ b/.gitmodules @@ -1,3 +1,6 @@ [submodule "third_party/pciids"] path = third_party/pciids url = https://github.com/pciutils/pciids.git +[submodule "bible"] + path = bible + url = https://git.mchus.pro/mchus/bible.git diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..e858c2d --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,11 @@ +# LOGPile — Instructions for Codex + +## Shared Engineering Rules +Read `bible/` — shared rules for all projects (CSV, logging, DB, tables, background tasks, code style). +Start with `bible/kit/patterns/` for specific contracts. + +## Project Architecture +Read `bible-local/` — LOGPile specific architecture. +Read order: `bible-local/README.md` → `01-overview.md` → relevant files for the task. + +Every architectural decision specific to this project must be recorded in `bible-local/10-decisions.md`. diff --git a/CLAUDE.md b/CLAUDE.md index cc1a235..1922e86 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1 +1,11 @@ -Read and follow [`docs/bible/README.md`](docs/bible/README.md) as the single source of truth, and do not contradict the Bible. +# LOGPile — Instructions for Claude + +## Shared Engineering Rules +Read `bible/` — shared rules for all projects (CSV, logging, DB, tables, background tasks, code style). +Start with `bible/kit/patterns/` for specific contracts. + +## Project Architecture +Read `bible-local/` — LOGPile specific architecture. +Read order: `bible-local/README.md` → `01-overview.md` → relevant files for the task. + +Every architectural decision specific to this project must be recorded in `bible-local/10-decisions.md`. diff --git a/bible b/bible new file mode 160000 index 0000000..8f28cfe --- /dev/null +++ b/bible @@ -0,0 +1 @@ +Subproject commit 8f28cfeac283c9f1b70c4d512e0ab432a6c8d6fa diff --git a/docs/bible/01-overview.md b/bible-local/01-overview.md similarity index 100% rename from docs/bible/01-overview.md rename to bible-local/01-overview.md diff --git a/docs/bible/02-architecture.md b/bible-local/02-architecture.md similarity index 100% rename from docs/bible/02-architecture.md rename to bible-local/02-architecture.md diff --git a/docs/bible/03-api.md b/bible-local/03-api.md similarity index 100% rename from docs/bible/03-api.md rename to bible-local/03-api.md diff --git a/docs/bible/04-data-models.md b/bible-local/04-data-models.md similarity index 100% rename from docs/bible/04-data-models.md rename to bible-local/04-data-models.md diff --git a/docs/bible/05-collectors.md b/bible-local/05-collectors.md similarity index 100% rename from docs/bible/05-collectors.md rename to bible-local/05-collectors.md diff --git a/docs/bible/06-parsers.md b/bible-local/06-parsers.md similarity index 82% rename from docs/bible/06-parsers.md rename to bible-local/06-parsers.md index e53973d..7fb7022 100644 --- a/docs/bible/06-parsers.md +++ b/bible-local/06-parsers.md @@ -214,6 +214,46 @@ with content markers (e.g. `Unraid kernel build`, parity data markers). --- +### H3C SDS G5 (`h3c_g5`) + +**Status:** Ready (v1.0.0). Tested on H3C UniServer R4900 G5 SDS archives. + +**Archive format:** `.sds` (tar archive) + +**Detection:** `hardware_info.ini`, `hardware.info`, `firmware_version.ini`, `user/test*.csv`, plus H3C markers. + +**Extracted data (current):** +- Board/FRU inventory (`FRUInfo.ini`, `board_info.ini`) +- Firmware list (`firmware_version.ini`) +- CPU inventory (`hardware_info.ini`) +- Memory DIMM inventory (`hardware_info.ini`) +- Storage inventory (`hardware.info`, `storage_disk.ini`, `NVMe_info.txt`, RAID text enrichments) +- Logical RAID volumes (`raid.json`, `Storage_RAID-*.txt`) +- Sensor snapshot (`sensor_info.ini`) +- SEL events (`user/test.csv`, `user/test1.csv`, fallback `Sel.json` / `sel_list.txt`) + +--- + +### H3C SDS G6 (`h3c_g6`) + +**Status:** Ready (v1.0.0). Tested on H3C UniServer R4700 G6 SDS archives. + +**Archive format:** `.sds` (tar archive) + +**Detection:** `CPUDetailInfo.xml`, `MemoryDetailInfo.xml`, `firmware_version.json`, `Sel.json`, plus H3C markers. + +**Extracted data (current):** +- Board/FRU inventory (`FRUInfo.ini`, `board_info.ini`) +- Firmware list (`firmware_version.json`) +- CPU inventory (`CPUDetailInfo.xml`) +- Memory DIMM inventory (`MemoryDetailInfo.xml`) +- Storage inventory + capacity/model/interface (`storage_disk.ini`, `Storage_RAID-*.txt`, `NVMe_info.txt`) +- Logical RAID volumes (`raid.json`, fallback from `Storage_RAID-*.txt` when available) +- Sensor snapshot (`sensor_info.ini`) +- SEL events (`user/Sel.json`, fallback `user/sel_list.txt`) + +--- + ### Generic text fallback (`generic`) **Status:** Ready (v1.0.0). @@ -238,4 +278,6 @@ with content markers (e.g. `Unraid kernel build`, parity data markers). | NVIDIA Bug Report | `nvidia_bug_report` | Ready | H100 systems | | Unraid | `unraid` | Ready | Unraid diagnostics archives | | XigmaNAS | `xigmanas` | Ready | FreeBSD NAS logs | +| H3C SDS G5 | `h3c_g5` | Ready | H3C UniServer R4900 G5 SDS archives | +| H3C SDS G6 | `h3c_g6` | Ready | H3C UniServer R4700 G6 SDS archives | | Generic fallback | `generic` | Ready | Any text file | diff --git a/docs/bible/07-exporters.md b/bible-local/07-exporters.md similarity index 100% rename from docs/bible/07-exporters.md rename to bible-local/07-exporters.md diff --git a/docs/bible/08-build-release.md b/bible-local/08-build-release.md similarity index 100% rename from docs/bible/08-build-release.md rename to bible-local/08-build-release.md diff --git a/docs/bible/09-testing.md b/bible-local/09-testing.md similarity index 100% rename from docs/bible/09-testing.md rename to bible-local/09-testing.md diff --git a/docs/bible/10-decisions.md b/bible-local/10-decisions.md similarity index 100% rename from docs/bible/10-decisions.md rename to bible-local/10-decisions.md diff --git a/docs/bible/README.md b/bible-local/README.md similarity index 100% rename from docs/bible/README.md rename to bible-local/README.md