From 99a2ddd0595c32ecdca174e7ea703aaf1292161a Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 26 Aug 2026 06:25:33 +0000 Subject: [PATCH 01/10] Initial plan From 6c951928b3bc845b81a0b79abb2d916d8ab7e2d8 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 26 Aug 2026 06:40:25 +0000 Subject: [PATCH 02/10] ci: install Vulkan deps in CodeQL workflow Co-authored-by: makr-code <150588092+makr-code@users.noreply.github.com> --- .github/workflows/security-codeql.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/security-codeql.yml b/.github/workflows/security-codeql.yml index 1e847e9399..02656c4742 100644 --- a/.github/workflows/security-codeql.yml +++ b/.github/workflows/security-codeql.yml @@ -98,6 +98,7 @@ jobs: librocksdb-dev libgtest-dev libssl-dev zlib1g-dev libzstd-dev \ libfmt-dev libspdlog-dev nlohmann-json3-dev libtbb-dev \ libyaml-cpp-dev libmimalloc-dev libcurl4-openssl-dev \ + libvulkan-dev glslc \ libboost-system-dev libboost-filesystem-dev \ libgrpc++-dev libprotobuf-dev protobuf-compiler-grpc \ libpugixml-dev From 765cae740753fa4945026078c2f8cb039ba60d36 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 26 Aug 2026 06:56:08 +0000 Subject: [PATCH 03/10] fix workflow lint and restore AI wiki playbook Co-authored-by: makr-code <150588092+makr-code@users.noreply.github.com> --- .github/workflows/gate-pr-core.yml | 5 +- AI_WIKI_INTEGRATION_PLAYBOOK.md | 374 +++++++++++++++++++++++++++++ 2 files changed, 378 insertions(+), 1 deletion(-) create mode 100644 AI_WIKI_INTEGRATION_PLAYBOOK.md diff --git a/.github/workflows/gate-pr-core.yml b/.github/workflows/gate-pr-core.yml index 8da30a6fd9..eb4ee452a0 100644 --- a/.github/workflows/gate-pr-core.yml +++ b/.github/workflows/gate-pr-core.yml @@ -924,9 +924,12 @@ jobs: echo " Detector : verified secrets only (--only-verified)" echo "============================================================" - - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + - name: Checkout repository + uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 with: fetch-depth: 0 # TruffleHog --since-commit requires full commit history + + - name: Install TruffleHog run: | echo " Installing TruffleHog from official install script..." T0=$(date +%s) diff --git a/AI_WIKI_INTEGRATION_PLAYBOOK.md b/AI_WIKI_INTEGRATION_PLAYBOOK.md new file mode 100644 index 0000000000..bdccb3f549 --- /dev/null +++ b/AI_WIKI_INTEGRATION_PLAYBOOK.md @@ -0,0 +1,374 @@ +# AI Wiki Integration Playbook fuer ThemisDB + +Datum: 2026-07-28 +Status: Active +Bezug: Uebertragung des LLM-Wiki-Musters auf ThemisDB Development-Management und AI Vibe Coding +Primary (Quelle der Wahrheit): ROADMAP.md, FUTURE_ENHANCEMENTS.md, DOCUMENTATION_GOVERNANCE.md, BRANCHING_STRATEGY.md, RELEASE_STRATEGY.md, ai_context/COPILOT_INSTRUCTIONS.md + +--- + +## 1. Zielbild + +Dieses Dokument definiert, wie ThemisDB ein LLM-Wiki als produktives AI-Arbeitswerkzeug betreibt. + +Kernziel: +- Kontextverlust in grossen, komplexen Modulen reduzieren +- Entscheidungen, Invarianten und Testwissen persistent kompilieren +- AI-Agenten mit einem reproduzierbaren, governance-konformen Arbeitsprozess betreiben +- Offline-Ollama gezielt fuer Inference- und Coding-Workloads einsetzen + +Das Modell folgt dem LLM-Wiki-Prinzip: +- Nicht nur Retrieval aus Rohdokumenten +- Sondern kontinuierliche Verdichtung in eine persistente, verlinkte Wissensschicht + +--- + +## 2. Uebertragbarkeitsanalyse fuer ThemisDB + +### 2.1 Ergebnis + +Die Uebertragbarkeit auf ThemisDB ist hoch. + +Bereits vorhanden: +- Eigene AI-Kontextschicht in ai_context/ +- Arbeits- und Evidenzschicht in ai_working/ +- Modulnahe, strukturierte Dokumentation in src//*.md +- Governance fuer Source-of-Truth, Dokumentationsfluss und Branching + +Luecken fuer eine vollstaendige LLM-Wiki-Operationalisierung: +- Einheitlicher Ingest-Query-Lint Loop +- Globaler Knowledge-Index mit stabiler Seitentypisierung +- Chronologisches Knowledge-Log als Audit-Trail +- Verbindliche Drift- und Widerspruchspruefungen +- Tool-Routing-Regeln (offline/online) als operative SOP + +### 2.2 Erwarteter Nutzen + +- Schnellere Einarbeitung in Module trotz hoher Codebasis-Komplexitaet +- Weniger Wiederholungsarbeit bei Agenten-Sessions +- Reduzierte Halluzinationsrate durch kompilierte Wissensbasis +- Bessere Nachvollziehbarkeit von Architektur- und Testentscheidungen +- Reproduzierbare AI-Lieferprozesse statt ad-hoc Prompting + +--- + +## 3. Zielarchitektur (4 Schichten) + +### 3.1 Layer A: Raw Sources (immutable) + +Beispiele: +- Code, Header, Tests, Benchmarks +- PRs, Issues, Incident-Logs +- Build- und Test-Reports +- Externe Spezifikationen + +Regeln: +- Raw Sources werden nicht von AI umgeschrieben +- Nur append/aktualisieren ueber normalen Dev-Prozess + +### 3.2 Layer B: Compiled Wiki (LLM-maintained) + +Beispiele: +- Modul-Status-Synthesen +- Entity/Subsystem-Pages +- Decision-Pages +- Incident-Pages +- Contract- und Benchmark-Pages + +Regeln: +- AI darf diese Schicht aktiv schreiben/aktualisieren +- Jede relevante Query-Erkenntnis kann als neue Wiki-Seite persistiert werden + +### 3.3 Layer C: Schema and Rules (governance) + +Beispiele: +- ai_context/COPILOT_INSTRUCTIONS.md +- .github/copilot-instructions.md +- DOCUMENTATION_GOVERNANCE.md +- Dieses Playbook + +Regeln: +- Schema-Aenderungen mit hoeherer Review-Huerde +- Regeln muessen branch- und release-konform bleiben + +### 3.4 Layer D: Delivery/Publication + +Beispiele: +- Root-Reports +- docs/ Publikationsartefakte +- Release-nahe Uebersichten + +Regeln: +- Nur downstream aus A bis C +- Keine isolierte Parallel-Wahrheit + +--- + +## 4. Pflichtobjekte des LLM-Wiki-Betriebs + +Im Root sind folgende Dateien verpflichtend bzw. empfohlen: + +Pflicht: +- Ein globaler Index: INDEX.md +- Ein append-only Log: LOG.md +- Dieses Betriebsdokument: AI_WIKI_INTEGRATION_PLAYBOOK.md + +Empfohlen: +- ai_context/KNOWLEDGE_LINT_REPORT.md (periodische Lint-Ergebnisse) +- ai_context/KNOWLEDGE_CONFLICTS.md (offene Widersprueche und Klaerungen) + +Formatregeln: +- Jede Wiki-Seite hat klaren Scope +- Jede starke Status-Behauptung verweist auf kanonische Quellen +- Keine semantischen Duplikatseiten + +--- + +## 5. Standard-Workflow (Ingest -> Query -> Lint) + +### 5.1 Ingest + +Trigger: +- Neue Quelle (Issue, PR, Incident, Benchmark, Design-Entscheidung) + +Schritte: +1. Quelle klassifizieren (Modul, SOT-Domain, Kritikalitaet) +2. Zielseiten im Wiki bestimmen (bestehende Seite aktualisieren oder neue Seite) +3. Index aktualisieren +4. Log-Eintrag schreiben +5. Bei Konflikten conflict-Entry erzeugen + +### 5.2 Query + +Schritte: +1. Zuerst INDEX.md lesen +2. Relevante 3-7 Seiten priorisieren +3. Antwort mit Quellenverweisen erzeugen +4. Bei hoher Wiederverwendungswahrscheinlichkeit Ergebnis als Wiki-Seite persistieren + +### 5.3 Lint + +Minimale Lint-Pruefungen: +- Orphan-Seiten +- Defekte interne Links +- Stale Claims gegen neuere Quellen +- Widerspruechliche Kern-Claims +- Fehlende Cross-Links bei stark gekoppelten Modulen + +Frequenz: +- Nach groesseren Ingest-Batches +- Mindestens nightly +- Zusaetzlich vor Release-Readiness-Gates + +--- + +## 6. Tooling-Integration Offline und Online + +## 6.1 Offline-Werkzeuge (Default-Backbone) + +### VS Code (offline) + +Use Cases: +- Code Navigation, Symbolsuche, lokale Aufgaben +- CMake/CTest-Tasks +- Problems/Diagnostics +- Lokale Markdown-Pflege und Review + +Regeln: +- Erst lokale Build/Test-Evidenz, dann Wiki-Status aktualisieren +- Task-Ausgaben als Evidenz in Ingest/Log beruecksichtigen + +### Git lokal (offline) + +Use Cases: +- Versionierung des Wikis +- Reviewbare Diffs fuer Wissensaenderungen +- Branch-basierte Wissensarbeit + +Regeln: +- Knowledge-Aenderungen in nachvollziehbaren Commits +- Kein ungepruefter Massenrewrite + +### Ollama lokal/remote-im-LAN als Offline-AI + +Rolle: +- Primärer Inference- und Coding-Beschleuniger fuer wiederholbare technische Aufgaben +- Erstellung/Update von Wiki-Seiten aus lokalen Quellen +- Cross-Linking und Strukturpflege im Compiled Layer + +Konfiguration: +- Endpoint gemaess Repo-Setup: http://192.168.178.106:11434 +- Delegation-Modus vorzugsweise auto mit klaren Routing-Regeln + +ThemisDB-Routingregeln (verbindlich): +- C/C++ Dateien: an @ollama /local delegieren +- CMake/Build-System-Themen: an @ollama delegieren +- Security/Audit/Architektur-Entscheidungen: Standard-Copilot (Cloud) priorisieren +- ROADMAP/FUTURE_ENHANCEMENTS Governance-Updates: Standard-Copilot + +Empfohlene Ollama-Modelle nach Zweck: +- qwen2.5-coder:14b fuer C/C++-Implementierungs- und Refactor-Aufgaben +- deepseek-coder-v2:16b fuer groessere CMake-/Massenrefactor-Themen (ohne Tool-Use) +- gemma4:latest fuer Agent-Chat/Tooling mit breiter Aufgabenabdeckung +- phi4:latest fuer Reasoning-Textarbeit ohne Tool-Use + +Inference-Aufgaben fuer Ollama (priorisiert): +- API-nahe Boilerplate und strukturelle C++-Generierung +- Unit-Test-Generierung und Edge-Case-Listen +- Doxygen-Kommentarentwuerfe +- CMake-Target-Erweiterungen +- Konsolidierung wiederkehrender Pattern in Modulcode + +Nicht an Ollama delegieren: +- Sicherheitskritische Endbewertung +- Release-Go/No-Go Entscheidungen +- Governance-Policy-Aenderungen ohne Human-Review + +## 6.2 Online-Werkzeuge (Erweiterung) + +### GitHub Online + +Use Cases: +- Issues/PRs als Quellen und Governance-Trigger +- Review-Threads als Wissensinput +- Milestones/Labels fuer Dokumentationsorchestrierung + +Regeln: +- Jede kritische Wissensaenderung auf nachvollziehbare PR/Issue-Evidenz stuetzen +- Keine unverifizierten Behauptungen aus Chat allein + +### GitHub Actions / CI + +Use Cases: +- Automatische Lint- und Drift-Pruefung +- Link-Validierung +- Optional: Scheduled Knowledge-Lint + +Implementierung in diesem Repository: +- `.github/workflows/maintenance-docs.yml` +- `scripts/ai-context-lint.py` +- Auto-Write-Back nur per `workflow_dispatch` mit `apply_ai_updates=true` +- Update-Modus: + - `direct-commit` (schneller Sync) + - `pull-request` (review-gate-konformer Sync mit automatischer PR-Erstellung) + +Regeln: +- CI-Fehler in Wissensartefakten blockieren bei kritischen Claims +- Rein kosmetische Findings separat behandeln + +### Cloud-Copilot / Cloud-LLMs + +Use Cases: +- Security-Review +- Komplexe, moduluebergreifende Architekturentscheidungen +- Externe Aktualitaetspruefungen (z. B. CVE-relevante Kontexte) + +Regeln: +- Ergebnisse in Compiled Wiki nur mit Quellenbezug persistieren + +--- + +## 7. Rollenmodell (Human-in-the-loop) + +### Role: Knowledge Maintainer +- Pflegt Schema-Regeln +- Priorisiert Konfliktaufloesung +- Gibt kritische Claims frei + +### Role: AI Compiler (Ollama/Copilot) +- Kompiliert neue Quellen in Wiki-Seiten +- Aktualisiert Cross-Links, Index und Log +- Fuehrt Erstklassifikation von Konflikten durch + +### Role: Reviewer +- Prueft Evidenzkette und SOT-Konformitaet +- Kontrolliert Drift-, Duplikat- und Widerspruchsrisiken + +--- + +## 8. Umsetzungsrichtlinie (SOP) fuer ThemisDB + +### 8.1 Phase 1 (1-2 Wochen) + +1. Root-Dateien INDEX.md und LOG.md anlegen +2. Seitentypen finalisieren (Entity, Decision, Incident, Contract, Benchmark) +3. Pilotmodule bestimmen (empfohlen: graph, scheduler, rag) +4. Minimalen Lint-Job (Links + Orphans) lokal und CI-seitig definieren + +### 8.2 Phase 2 (2-4 Wochen) + +1. Ingest-Template und Query-Persist-Regel verpflichtend machen +2. Konfliktregister ai_context/KNOWLEDGE_CONFLICTS.md einfuehren +3. Nightly-Lint fuer Stale Claims und Widersprueche etablieren +4. Ollama-Routing fuer Inference-Tasks operationalisieren + +### 8.3 Phase 3 (ab Woche 5) + +1. KPI-Messung pro Sprint +2. Qualitaetsgates vor Release-Hardening +3. Kontinuierliche Schema-Nachschaerfung aus wiederkehrenden Fehlern + +--- + +## 9. KPI- und Qualitaetsmetriken + +Empfohlene Kennzahlen: +- Time-to-Context pro Modul-Onboarding +- Anteil beantwortbarer Fragen ohne Rohquellen-Recherche +- Anzahl erkannter/aufgeloester Wissenskonflikte pro Sprint +- Anteil veralteter Claims ueber Zeit +- Delta Build/Test-Failures durch bessere Wissensfuehrung + +Qualitaetsziel: +- Die Wiki ist nicht nur Dokumentablage, sondern aktives AI-Betriebssystem fuer Entwicklungsentscheidungen. + +--- + +## 10. Verbindliche Regeln fuer AI Vibe Coding + +1. Vor jeder groesseren Codeaenderung: Query gegen Compiled Wiki + Moduldocs +2. Nach jeder relevanten Erkenntnis: Entscheidung/Ergebnis in Wiki persistieren +3. Bei Widerspruch zwischen Seiten: Konflikt markieren, nicht still ueberbuegeln +4. Bei fehlender Evidenz: Claim als unsicher kennzeichnen +5. Fuer C/C++ und CMake-Heavy-Arbeit: Ollama-Inference zuerst nutzen, danach Human-Review +6. Fuer Security/Governance/Release-Entscheidung: Cloud-Review + Human-Signoff verpflichtend +7. Branch-Governance strikt einhalten (develop/community/military etc. nach Regelwerk) +8. Keine Legacy- oder Stub-Pfade ohne explizite menschliche Freigabe + +--- + +## 11. Risiken und Gegenmassnahmen + +Risiko: +- Wiki-Drift durch inkonsistente Agentenupdates + +Gegenmassnahme: +- Scheduled Lint + PR-Gate + klare Schema-Regeln + +Risiko: +- Tool-Sprawl ohne klare Zustandsgrenzen + +Gegenmassnahme: +- Layer-Verantwortung strikt trennen (Raw unveraenderlich, Compiled editierbar) + +Risiko: +- Ueberdelegation an lokale Modelle bei sicherheitskritischen Themen + +Gegenmassnahme: +- Harte Routingregel: Security/Audit/Go-NoGo niemals rein lokal final entscheiden + +--- + +## 12. Entscheidungsvorlage fuer sofortige Aktivierung + +Go-Live-Checkliste: +- INDEX.md vorhanden +- LOG.md vorhanden +- ai_context/KNOWLEDGE_LINT_REPORT.md vorhanden +- ai_context/KNOWLEDGE_CONFLICTS.md vorhanden +- Pilotmodule benannt +- Ollama-Routing-Regeln dokumentiert +- Lint-Minimum aktiv +- Reviewer-Rolle benannt + +Wenn alle Punkte erfuellt sind, ist das LLM-Wiki-Modell fuer ThemisDB operativ einsetzbar. From 1aa20a2d728273e6a4dff769098bdbbbdfbadf00 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 26 Aug 2026 07:13:41 +0000 Subject: [PATCH 04/10] Apply remaining changes Co-authored-by: makr-code <150588092+makr-code@users.noreply.github.com> --- ai_context/AI_CONTEXT_NAMESPACE_INDEX.md | 2 +- ai_context/API_CONTRACT_TEMPLATES.md | 8 ++-- ai_context/API_MODULE_STATUS_2026_07_18.md | 2 +- ai_context/ARCHITECTURE_CLASSIFICATION.md | 2 +- ...ION_UPDATE_EXECUTION_SUMMARY_2026_08_09.md | 2 +- ai_context/FUNCTION_CLASSIFICATION.md | 2 +- .../GOVERNANCE_MODULE_STATUS_2026_07_18.md | 2 +- ...NCE_PHASE2B_3A_3B_IMPLEMENTATION_REPORT.md | 2 +- ...VERNANCE_PHASE2_3_IMPLEMENTATION_REPORT.md | 2 +- ai_context/INDEX_MODULE_STATUS_2026_08_09.md | 2 +- ai_context/ISSUE_5647_CLOSURE_SUMMARY.md | 5 +++ ai_context/MODULES_AND_NAMESPACES.md | 2 +- ...ULE_DOCUMENTATION_REMEDIATION_CHECKLIST.md | 2 +- ai_context/OOP_AND_SOC_PRINCIPLES.md | 2 +- ai_context/PHASE_1_6_CHECKLIST.md | 2 +- .../PHASE_1_6_IMPLEMENTATION_FRAMEWORK.md | 2 +- .../RESEARCH_INTEGRATION_AUDIT_2026_08_09.md | 2 +- ai_context/UTILS_MODULE_STATUS_2026_07_18.md | 2 +- ai_context/api_contracts/api.md | 2 +- ai_context/api_contracts/auth.md | 2 +- ai_context/api_contracts/index.md | 2 +- ai_context/api_contracts/llm.md | 2 +- ai_context/api_contracts/storage.md | 2 +- ai_context/api_contracts/transaction.md | 2 +- .../GOVERNANCE_AND_ROADMAP.md | 42 +++++++++---------- ai_context/memory_management_policy.md | 4 +- ...ht ThemisDB 2025_THEMISDB_PUBLIC_REPORT.md | 2 +- 27 files changed, 55 insertions(+), 50 deletions(-) diff --git a/ai_context/AI_CONTEXT_NAMESPACE_INDEX.md b/ai_context/AI_CONTEXT_NAMESPACE_INDEX.md index 635c4b2d05..5d270bbccd 100644 --- a/ai_context/AI_CONTEXT_NAMESPACE_INDEX.md +++ b/ai_context/AI_CONTEXT_NAMESPACE_INDEX.md @@ -1,6 +1,6 @@ # Namespace Index (Alphabetical) -**Datum:** 2026-08-03 +Datum: 2026-08-03 **Status:** Active **Primary:** include//*.h, src//*.cpp **Bezug:** AI-freundliche Namespace-Navigation diff --git a/ai_context/API_CONTRACT_TEMPLATES.md b/ai_context/API_CONTRACT_TEMPLATES.md index daa4e808c9..fce3038b10 100644 --- a/ai_context/API_CONTRACT_TEMPLATES.md +++ b/ai_context/API_CONTRACT_TEMPLATES.md @@ -1,6 +1,6 @@ # API Contract Templates & Filling Guidelines -**Datum:** 2026-08-03 +Datum: 2026-08-03 **Status:** Active **Primary:** api_contracts/README.md, include/**/*.h **Bezug:** Maschinenlesbare API-Verträge pro Modul @@ -17,7 +17,7 @@ ### API Column - Function/method name with signature -- Link to header file if possible: `[name](link)` +- Link to header file if possible: `name (path/to/header.h)` or `name -> ../include/module/header.h` **Example:** ``` @@ -129,7 +129,7 @@ Script: `scripts/ai-context-lint.py` (optional future work) ## Integration with CI/CD -**Workflow:** `.github/workflows/08-maintenance_ai-context-wiki-sync.yml` +**Workflow:** `.github/workflows/maintenance-docs.yml` - On PR: validate API contract rows exist for modified public APIs - On merge: regenerate skeleton rows for new functions (optional) @@ -137,7 +137,7 @@ Script: `scripts/ai-context-lint.py` (optional future work) ## Example: api.md (Complete Sample) -See [api_contracts/api.md](./api/api.md) for filled example. +See [api_contracts/api.md](./api_contracts/api.md) for filled example. Key sections: - Transport layer APIs (HTTP, gRPC) diff --git a/ai_context/API_MODULE_STATUS_2026_07_18.md b/ai_context/API_MODULE_STATUS_2026_07_18.md index 4c060be7f9..44cc3ae066 100644 --- a/ai_context/API_MODULE_STATUS_2026_07_18.md +++ b/ai_context/API_MODULE_STATUS_2026_07_18.md @@ -1,6 +1,6 @@ # API Module Status 2026-07-18 -Datum: 2026-07-18 +Datum: 2026-08-26 Status: Synchronized Bezug: Issue #5618 - Development Status 2026-07-18 Primary (Quelle der Wahrheit): src/api/ROADMAP.md, src/api/FUTURE_ENHANCEMENTS.md, src/api/AUDIT.md, tests/api/test_api_contracts.cpp diff --git a/ai_context/ARCHITECTURE_CLASSIFICATION.md b/ai_context/ARCHITECTURE_CLASSIFICATION.md index b675baea95..21510b029e 100644 --- a/ai_context/ARCHITECTURE_CLASSIFICATION.md +++ b/ai_context/ARCHITECTURE_CLASSIFICATION.md @@ -1,6 +1,6 @@ # ThemisDB Module Classification: Core, Integrated Modules, and Plugins -**Datum:** 2026-08-07 +Datum: 2026-08-07 **Status:** Active (Wave-1 Private Plugin Strategy) **Primary (Quelle der Wahrheit):** ARCHITECTURE.md, ROADMAP.md, FUTURE_ENHANCEMENTS.md, src/plugins/ROADMAP.md **Bezug:** Architecture division clarification, Wave-1 plugin externalization diff --git a/ai_context/DOCUMENTATION_UPDATE_EXECUTION_SUMMARY_2026_08_09.md b/ai_context/DOCUMENTATION_UPDATE_EXECUTION_SUMMARY_2026_08_09.md index bd1ba06f17..d081c50b75 100644 --- a/ai_context/DOCUMENTATION_UPDATE_EXECUTION_SUMMARY_2026_08_09.md +++ b/ai_context/DOCUMENTATION_UPDATE_EXECUTION_SUMMARY_2026_08_09.md @@ -1,6 +1,6 @@ # ThemisDB Documentation Update — Execution Summary (2026-08-09) -**Datum:** 2026-08-09 +Datum: 2026-08-09 **Status:** COMPLETE ✅ **Scope:** Full 4-phase documentation update implementation **Effort:** ~6-8 hours (all phases combined) diff --git a/ai_context/FUNCTION_CLASSIFICATION.md b/ai_context/FUNCTION_CLASSIFICATION.md index d4fac7fb9f..fa28cd0712 100644 --- a/ai_context/FUNCTION_CLASSIFICATION.md +++ b/ai_context/FUNCTION_CLASSIFICATION.md @@ -1,6 +1,6 @@ # Function Classification Framework -**Datum:** 2026-08-03 +Datum: 2026-08-03 **Status:** Active **Primary:** src/*/ROADMAP.md, include/**/*.h **Bezug:** API-Ebenen, Aufgaben, Performance-Kritikalität diff --git a/ai_context/GOVERNANCE_MODULE_STATUS_2026_07_18.md b/ai_context/GOVERNANCE_MODULE_STATUS_2026_07_18.md index 917b1cba0a..265a21377a 100644 --- a/ai_context/GOVERNANCE_MODULE_STATUS_2026_07_18.md +++ b/ai_context/GOVERNANCE_MODULE_STATUS_2026_07_18.md @@ -1,6 +1,6 @@ # Governance Module Status 2026-07-18 -Datum: 2026-07-18 +Datum: 2026-08-26 Status: Synchronized Bezug: Issue #5647 - Development Status 2026-07-18 Primary (Quelle der Wahrheit): src/governance/ROADMAP.md, src/governance/FUTURE_ENHANCEMENTS.md, src/governance/PRODUCTION_REQUIREMENTS.md, tests/governance/test_governance_contract_hardening_focused.cpp diff --git a/ai_context/GOVERNANCE_PHASE2B_3A_3B_IMPLEMENTATION_REPORT.md b/ai_context/GOVERNANCE_PHASE2B_3A_3B_IMPLEMENTATION_REPORT.md index a433d7cfd6..c3a7a4b1a4 100644 --- a/ai_context/GOVERNANCE_PHASE2B_3A_3B_IMPLEMENTATION_REPORT.md +++ b/ai_context/GOVERNANCE_PHASE2B_3A_3B_IMPLEMENTATION_REPORT.md @@ -1,6 +1,6 @@ # Governance Module Phase 2B-3A-3B Hardening Implementation Report -**Date**: 2026-08-02 +Datum: 2026-08-02 **Issue**: Phase 2B-3A-3B continuation hardening **Status**: Implementation Complete **Total Changes**: 1,687 lines (1,176 production + 511 tests) diff --git a/ai_context/GOVERNANCE_PHASE2_3_IMPLEMENTATION_REPORT.md b/ai_context/GOVERNANCE_PHASE2_3_IMPLEMENTATION_REPORT.md index 7ebb2300dd..99bcefad99 100644 --- a/ai_context/GOVERNANCE_PHASE2_3_IMPLEMENTATION_REPORT.md +++ b/ai_context/GOVERNANCE_PHASE2_3_IMPLEMENTATION_REPORT.md @@ -1,6 +1,6 @@ # Governance Module Phase 2-3 Implementation Report -**Date**: 2026-08-01 +Datum: 2026-08-01 **Issue**: #5647 (Development Status 2026-07-18) - Phase 2-3 Followup **Status**: Phase 1 Implementation Complete **Total Changes**: 1,308 lines (800 production + 511 tests) diff --git a/ai_context/INDEX_MODULE_STATUS_2026_08_09.md b/ai_context/INDEX_MODULE_STATUS_2026_08_09.md index 52e366a6b3..6e6ad97ade 100644 --- a/ai_context/INDEX_MODULE_STATUS_2026_08_09.md +++ b/ai_context/INDEX_MODULE_STATUS_2026_08_09.md @@ -1,6 +1,6 @@ # ThemisDB Module Status Index (2026-08-09) -**Datum:** 2026-08-09 +Datum: 2026-08-09 **Status:** Synchronized with root ROADMAP.md and module-level ROADMAP.md files **Bezug:** Root ROADMAP.md (canonical source), 66 module ROADMAP.md files, recent Phase 1-6 delivery evidence **Primary (Quelle der Wahrheit):** ROADMAP.md, src//ROADMAP.md files, corresponding FUTURE_ENHANCEMENTS.md, PHASE_*_ACCEPTANCE_CHECKLIST.md diff --git a/ai_context/ISSUE_5647_CLOSURE_SUMMARY.md b/ai_context/ISSUE_5647_CLOSURE_SUMMARY.md index 08afc71f4c..669f1b4dc8 100644 --- a/ai_context/ISSUE_5647_CLOSURE_SUMMARY.md +++ b/ai_context/ISSUE_5647_CLOSURE_SUMMARY.md @@ -1,5 +1,10 @@ # Issue #5647 Closure Summary +Datum: 2026-08-01 +Status: Active +Bezug: Issue #5647 closure summary for governance module status synchronization +Primary (Quelle der Wahrheit): src/governance/ROADMAP.md, src/governance/FUTURE_ENHANCEMENTS.md, ai_context/GOVERNANCE_MODULE_STATUS_2026_07_18.md + **Issue**: [#5647] Development Status 2026-07-18 (Governance Module) **Type**: Module Status Validation and Synchronization **Status**: ✅ COMPLETED diff --git a/ai_context/MODULES_AND_NAMESPACES.md b/ai_context/MODULES_AND_NAMESPACES.md index 57d9edbb9a..db1f34ab3f 100644 --- a/ai_context/MODULES_AND_NAMESPACES.md +++ b/ai_context/MODULES_AND_NAMESPACES.md @@ -1,6 +1,6 @@ # Modules & Namespaces Overview -**Datum:** 2026-08-03 +Datum: 2026-08-03 **Status:** Active **Primary:** src//ROADMAP.md, include//*.h **Bezug:** AI-Context für schnelle Modul-/Namespace-Navigation diff --git a/ai_context/MODULE_DOCUMENTATION_REMEDIATION_CHECKLIST.md b/ai_context/MODULE_DOCUMENTATION_REMEDIATION_CHECKLIST.md index 1ce8e9b649..e5194fd980 100644 --- a/ai_context/MODULE_DOCUMENTATION_REMEDIATION_CHECKLIST.md +++ b/ai_context/MODULE_DOCUMENTATION_REMEDIATION_CHECKLIST.md @@ -1,6 +1,6 @@ # Module Documentation Remediation Checklist (2026-08-09) -**Datum:** 2026-08-09 +Datum: 2026-08-09 **Status:** Phase 3 Documentation Gap Analysis **Scope:** 66 tracked modules in ROADMAP.md vs existing src//README.md files **Priority:** High Impact — Phase 6 Documentation Acceptance Gate diff --git a/ai_context/OOP_AND_SOC_PRINCIPLES.md b/ai_context/OOP_AND_SOC_PRINCIPLES.md index 95fe237bcc..3fef1a35ff 100644 --- a/ai_context/OOP_AND_SOC_PRINCIPLES.md +++ b/ai_context/OOP_AND_SOC_PRINCIPLES.md @@ -1,6 +1,6 @@ # OOP & Separation of Concerns Principles -**Datum:** 2026-08-03 +Datum: 2026-08-03 **Status:** Active **Primary:** include/**/*.h, src/*/ARCHITECTURE.md **Bezug:** Design patterns, interfaces, module boundaries diff --git a/ai_context/PHASE_1_6_CHECKLIST.md b/ai_context/PHASE_1_6_CHECKLIST.md index a4c1159879..deb7145e9d 100644 --- a/ai_context/PHASE_1_6_CHECKLIST.md +++ b/ai_context/PHASE_1_6_CHECKLIST.md @@ -1,7 +1,7 @@ # Phase 1-6 Implementation Checklist — Quick Reference **Version:** 2.4.0 -**Date:** 2026-08-15 +Datum: 2026-08-15 **Status:** 🟢 Active **Purpose:** Rapid tracking of Phase 1-6 completion for module implementation diff --git a/ai_context/PHASE_1_6_IMPLEMENTATION_FRAMEWORK.md b/ai_context/PHASE_1_6_IMPLEMENTATION_FRAMEWORK.md index 7f991d8538..6017cece83 100644 --- a/ai_context/PHASE_1_6_IMPLEMENTATION_FRAMEWORK.md +++ b/ai_context/PHASE_1_6_IMPLEMENTATION_FRAMEWORK.md @@ -1,7 +1,7 @@ # Phase 1-6 Implementation Framework for Module Development **Version:** 2.4.0 -**Date Created:** 2026-08-15 +Datum: 2026-08-15 **Status:** 🟢 Active Guidance Document **Scope:** Canonical implementation structure for all ThemisDB module development diff --git a/ai_context/RESEARCH_INTEGRATION_AUDIT_2026_08_09.md b/ai_context/RESEARCH_INTEGRATION_AUDIT_2026_08_09.md index 5c0569743a..c6eedd57eb 100644 --- a/ai_context/RESEARCH_INTEGRATION_AUDIT_2026_08_09.md +++ b/ai_context/RESEARCH_INTEGRATION_AUDIT_2026_08_09.md @@ -1,6 +1,6 @@ # Research Integration Audit (2026-08-09) -**Datum:** 2026-08-09 +Datum: 2026-08-09 **Status:** Phase 4 Audit Complete **Scope:** research/implementation_influence/by_module.md analysis **Primary (Quelle der Wahrheit):** research/implementation_influence/by_module.md (last updated 2026-07-27) diff --git a/ai_context/UTILS_MODULE_STATUS_2026_07_18.md b/ai_context/UTILS_MODULE_STATUS_2026_07_18.md index c9bb1f0166..9008e1bb79 100644 --- a/ai_context/UTILS_MODULE_STATUS_2026_07_18.md +++ b/ai_context/UTILS_MODULE_STATUS_2026_07_18.md @@ -1,6 +1,6 @@ # Utils Module Status 2026-07-18 -Datum: 2026-07-18 +Datum: 2026-08-26 Status: Synchronized Bezug: Issue #5682 - Development Status 2026-07-18 Primary (Quelle der Wahrheit): src/utils/ROADMAP.md, src/utils/FUTURE_ENHANCEMENTS.md, src/utils/PRODUCTION_REQUIREMENTS.md, tests/utils/test_utils_*.cpp diff --git a/ai_context/api_contracts/api.md b/ai_context/api_contracts/api.md index 061dda16b9..730a4c322d 100644 --- a/ai_context/api_contracts/api.md +++ b/ai_context/api_contracts/api.md @@ -1,6 +1,6 @@ # API Module Contract -**Datum:** 2026-08-03 +Datum: 2026-08-03 **Status:** Active **Module:** api (HTTP/gRPC/GraphQL transport) **Primary:** include/api/api_transport_contracts.h, src/api/ROADMAP.md diff --git a/ai_context/api_contracts/auth.md b/ai_context/api_contracts/auth.md index b0072f3698..1397fe241a 100644 --- a/ai_context/api_contracts/auth.md +++ b/ai_context/api_contracts/auth.md @@ -1,6 +1,6 @@ # Auth Module Contract -**Datum:** 2026-08-03 +Datum: 2026-08-03 **Status:** Active **Module:** auth (Authentication, authorization, principal contracts) **Primary:** include/auth/auth_principal_contract.h, src/auth/ROADMAP.md diff --git a/ai_context/api_contracts/index.md b/ai_context/api_contracts/index.md index f099a6d0c0..63decc0a48 100644 --- a/ai_context/api_contracts/index.md +++ b/ai_context/api_contracts/index.md @@ -1,6 +1,6 @@ # Index Module Contract -**Datum:** 2026-08-03 +Datum: 2026-08-03 **Status:** Active **Module:** index (HNSW, B-tree, R-tree, index lifecycle) **Primary:** include/index/hnsw_index.h, include/index/index_manager.h, src/index/ROADMAP.md diff --git a/ai_context/api_contracts/llm.md b/ai_context/api_contracts/llm.md index 8365c98af2..469d7e7ff9 100644 --- a/ai_context/api_contracts/llm.md +++ b/ai_context/api_contracts/llm.md @@ -1,6 +1,6 @@ # LLM Module Contract -**Datum:** 2026-08-03 +Datum: 2026-08-03 **Status:** Active **Module:** llm (LLM inference, model switching, context mgmt) **Primary:** include/llm/inference_engine.h, src/llm/ROADMAP.md diff --git a/ai_context/api_contracts/storage.md b/ai_context/api_contracts/storage.md index 4ebd76e379..9d580d22b7 100644 --- a/ai_context/api_contracts/storage.md +++ b/ai_context/api_contracts/storage.md @@ -1,6 +1,6 @@ # Storage Module Contract -**Datum:** 2026-08-03 +Datum: 2026-08-03 **Status:** Active **Module:** storage (RocksDB backend, K-V layer, LSM-tree) **Primary:** include/storage/storage_engine.h, src/storage/ROADMAP.md diff --git a/ai_context/api_contracts/transaction.md b/ai_context/api_contracts/transaction.md index 7d10b2ae95..5f1e64e492 100644 --- a/ai_context/api_contracts/transaction.md +++ b/ai_context/api_contracts/transaction.md @@ -1,6 +1,6 @@ # Transaction Module Contract -**Datum:** 2026-08-03 +Datum: 2026-08-03 **Status:** Active **Module:** transaction (Coordinator, 2PC/3PC/SAGA patterns) **Primary:** include/transaction/transaction_coordinator.h, src/transaction/ROADMAP.md diff --git a/ai_context/developer_llm_wiki/GOVERNANCE_AND_ROADMAP.md b/ai_context/developer_llm_wiki/GOVERNANCE_AND_ROADMAP.md index 587896507c..5999ae8b52 100644 --- a/ai_context/developer_llm_wiki/GOVERNANCE_AND_ROADMAP.md +++ b/ai_context/developer_llm_wiki/GOVERNANCE_AND_ROADMAP.md @@ -53,7 +53,7 @@ Status: Active - Hash: `1191d102ff820880` - Titel: Namespace Index (Alphabetical) - Auszug: - - **Datum:** 2026-08-03 + - Datum: 2026-08-03 - **Status:** Active - **Primary:** include//*.h, src//*.cpp @@ -62,7 +62,7 @@ Status: Active - Hash: `2f59faee2096b8a7` - Titel: API Contract Templates & Filling Guidelines - Auszug: - - **Datum:** 2026-08-03 + - Datum: 2026-08-03 - **Status:** Active - **Primary:** api_contracts/README.md, include/**/*.h @@ -80,7 +80,7 @@ Status: Active - Hash: `35b13b26268ace89` - Titel: ThemisDB Module Classification: Core, Integrated Modules, and Plugins - Auszug: - - **Datum:** 2026-08-07 + - Datum: 2026-08-07 - **Status:** Active (Wave-1 Private Plugin Strategy) - **Primary (Quelle der Wahrheit):** ARCHITECTURE.md, ROADMAP.md, FUTURE_ENHANCEMENTS.md, src/plugins/ROADMAP.md @@ -107,7 +107,7 @@ Status: Active - Hash: `6a9b9d0aceb8879c` - Titel: ThemisDB Documentation Update — Execution Summary (2026-08-09) - Auszug: - - **Datum:** 2026-08-09 + - Datum: 2026-08-09 - **Status:** COMPLETE ✅ - **Scope:** Full 4-phase documentation update implementation @@ -116,7 +116,7 @@ Status: Active - Hash: `9da5e7fc7ab4d90e` - Titel: Function Classification Framework - Auszug: - - **Datum:** 2026-08-03 + - Datum: 2026-08-03 - **Status:** Active - **Primary:** src/*/ROADMAP.md, include/**/*.h @@ -161,7 +161,7 @@ Status: Active - Hash: `259bbaf90872547f` - Titel: ThemisDB Module Status Index (2026-08-09) - Auszug: - - **Datum:** 2026-08-09 + - Datum: 2026-08-09 - **Status:** Synchronized with root ROADMAP.md and module-level ROADMAP.md files - **Bezug:** Root ROADMAP.md (canonical source), 66 module ROADMAP.md files, recent Phase 1-6 delivery evidence @@ -197,7 +197,7 @@ Status: Active - Hash: `56c77ac57e84cbff` - Titel: Modules & Namespaces Overview - Auszug: - - **Datum:** 2026-08-03 + - Datum: 2026-08-03 - **Status:** Active - **Primary:** src//ROADMAP.md, include//*.h @@ -206,7 +206,7 @@ Status: Active - Hash: `845ae81695565fda` - Titel: Module Documentation Remediation Checklist (2026-08-09) - Auszug: - - **Datum:** 2026-08-09 + - Datum: 2026-08-09 - **Status:** Phase 3 Documentation Gap Analysis - **Scope:** 66 tracked modules in ROADMAP.md vs existing src//README.md files @@ -215,7 +215,7 @@ Status: Active - Hash: `33e2e37db17cef40` - Titel: OOP & Separation of Concerns Principles - Auszug: - - **Datum:** 2026-08-03 + - Datum: 2026-08-03 - **Status:** Active - **Primary:** include/**/*.h, src/*/ARCHITECTURE.md @@ -251,7 +251,7 @@ Status: Active - Hash: `4e91583c0e772d58` - Titel: Research Integration Audit (2026-08-09) - Auszug: - - **Datum:** 2026-08-09 + - Datum: 2026-08-09 - **Status:** Phase 4 Audit Complete - **Scope:** research/implementation_influence/by_module.md analysis @@ -278,7 +278,7 @@ Status: Active - Hash: `dcdd431d23597332` - Titel: API Module Contract - Auszug: - - **Datum:** 2026-08-03 + - Datum: 2026-08-03 - **Status:** Active - **Module:** api (HTTP/gRPC/GraphQL transport) @@ -287,7 +287,7 @@ Status: Active - Hash: `79a353afc8db2bf7` - Titel: Auth Module Contract - Auszug: - - **Datum:** 2026-08-03 + - Datum: 2026-08-03 - **Status:** Active - **Module:** auth (Authentication, authorization, principal contracts) @@ -296,7 +296,7 @@ Status: Active - Hash: `25469f6237ebeb04` - Titel: Index Module Contract - Auszug: - - **Datum:** 2026-08-03 + - Datum: 2026-08-03 - **Status:** Active - **Module:** index (HNSW, B-tree, R-tree, index lifecycle) @@ -305,7 +305,7 @@ Status: Active - Hash: `2b4e807c3d995bac` - Titel: LLM Module Contract - Auszug: - - **Datum:** 2026-08-03 + - Datum: 2026-08-03 - **Status:** Active - **Module:** llm (LLM inference, model switching, context mgmt) @@ -314,7 +314,7 @@ Status: Active - Hash: `7fde80c33b8b5670` - Titel: Storage Module Contract - Auszug: - - **Datum:** 2026-08-03 + - Datum: 2026-08-03 - **Status:** Active - **Module:** storage (RocksDB backend, K-V layer, LSM-tree) @@ -323,7 +323,7 @@ Status: Active - Hash: `c95cb832d5066070` - Titel: Transaction Module Contract - Auszug: - - **Datum:** 2026-08-03 + - Datum: 2026-08-03 - **Status:** Active - **Module:** transaction (Coordinator, 2PC/3PC/SAGA patterns) @@ -386,7 +386,7 @@ Status: Active - Hash: `05a08a3523bf5e7d` - Titel: Memory Management Policy — Core Rules - Auszug: - - **Datum:** 2026-08-03 + - Datum: 2026-08-03 - **Status:** Active, Enforced - **Primary:** src/base/resource.h, include/base/*.h @@ -504,7 +504,7 @@ Status: Active - Titel: GAP-004: API Reference - PolicyManager & Integration - Auszug: - **Version:** 1.0 - - **Datum:** 5. Februar 2026 + - Datum: 5. Februar 2026 - --- ## docs/ARCHIVED/gaps/GAP_004_CONFIGURATION_GUIDE.md @@ -513,7 +513,7 @@ Status: Active - Titel: GAP-004: Configuration Guide - PolicyManager Setup - Auszug: - **Version:** 1.0 - - **Datum:** 5. Februar 2026 + - Datum: 5. Februar 2026 - --- ## docs/ARCHIVED/gaps/GAP_004_PHASE5_DOCUMENTATION.md @@ -550,7 +550,7 @@ Status: Active - Auszug: - **Dokument:** Roadmap und Implementierungsplan - **Version:** 1.0 - - **Datum:** 4. Februar 2026 + - Datum: 4. Februar 2026 ## docs/ARCHIVED/gaps/GAP_004_SECURITY_GOVERNANCE.md - Kategorie: governance_and_docs @@ -558,7 +558,7 @@ Status: Active - Titel: GAP-004: Security & Governance - Implementierungsübersicht (Aktualisiert) - Auszug: - **Status:** ✅ Basisimplementierung abgeschlossen (ohne Duplikate) - - **Datum:** 4. Februar 2026 + - Datum: 4. Februar 2026 - **Version:** 2.0 (Dedupliziert) ## docs/ARCHIVED/gaps/GAP_006_DUPLICATE_REMOVAL.md diff --git a/ai_context/memory_management_policy.md b/ai_context/memory_management_policy.md index 27fd766734..bae1a031e7 100644 --- a/ai_context/memory_management_policy.md +++ b/ai_context/memory_management_policy.md @@ -1,6 +1,6 @@ # Memory Management Policy — Core Rules -**Datum:** 2026-08-03 +Datum: 2026-08-03 **Status:** Active, Enforced **Primary:** src/base/resource.h, include/base/*.h **Bezug:** RAII, smart pointers, ownership contracts @@ -71,7 +71,7 @@ std::unique_ptr allocate(size_t sz) { ## Further Reading -- Full guidance: [src/base/resource.h](../src/base/resource.h), [PERFORMANCE_EXPECTATIONS](../src/PERFORMANCE_EXPECTATIONS.md) +- Full guidance: [src/base/ROADMAP.md](../src/base/ROADMAP.md), [base/PERFORMANCE_EXPECTATIONS](../src/base/PERFORMANCE_EXPECTATIONS.md) - Approved singletons (immutable config, append-only registries) documented separately --- diff --git a/ai_context/research/gemini_exports/Forschungsbericht ThemisDB 2025_THEMISDB_PUBLIC_REPORT.md b/ai_context/research/gemini_exports/Forschungsbericht ThemisDB 2025_THEMISDB_PUBLIC_REPORT.md index faf569dda2..3f3efc9efc 100644 --- a/ai_context/research/gemini_exports/Forschungsbericht ThemisDB 2025_THEMISDB_PUBLIC_REPORT.md +++ b/ai_context/research/gemini_exports/Forschungsbericht ThemisDB 2025_THEMISDB_PUBLIC_REPORT.md @@ -1,7 +1,7 @@ # **THEMISDB: ARCHITEKTUR- UND STRATEGIEANALYSE 2025** **Ein umfassender Forschungsbericht zur technologischen Souveränität in der öffentlichen Verwaltung** -**Datum:** 21\. November 2025 **Status:** Öffentlich / Public Release **Version:** 7.0 (Final Comprehensive) **Basis:** Technisches Audit (Github), Sachstandsbericht Nov. 2025, Expertenbericht Wissenschaft **Lizenz:** Open Source (MIT License mit Government-Klausel) +Datum: 21\. November 2025 **Status:** Öffentlich / Public Release **Version:** 7.0 (Final Comprehensive) **Basis:** Technisches Audit (Github), Sachstandsbericht Nov. 2025, Expertenbericht Wissenschaft **Lizenz:** Open Source (MIT License mit Government-Klausel) ## **MANAGEMENT SUMMARY** From 372299c0f62df3159e3e16c84bad8884ebdba7f6 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 26 Aug 2026 07:33:32 +0000 Subject: [PATCH 05/10] docs: require GitHub Copilot to use developer wiki Co-authored-by: makr-code <150588092+makr-code@users.noreply.github.com> --- .github/ISSUE_TEMPLATE/docs_audit.md | 1 + .github/copilot-instructions.md | 23 ++++++++++++ .github/copilot/AI_WIKI_CONTEXT.md | 54 ++++++++++++++++++++++++++++ .github/copilot/README.md | 9 +++++ ai_context/COPILOT_INSTRUCTIONS.md | 22 ++++++++++++ 5 files changed, 109 insertions(+) create mode 100644 .github/copilot/AI_WIKI_CONTEXT.md diff --git a/.github/ISSUE_TEMPLATE/docs_audit.md b/.github/ISSUE_TEMPLATE/docs_audit.md index bb485ad420..8246184368 100644 --- a/.github/ISSUE_TEMPLATE/docs_audit.md +++ b/.github/ISSUE_TEMPLATE/docs_audit.md @@ -67,6 +67,7 @@ Describe what the documentation should say or cover after fixing this issue. - [ ] Issue is assigned to the correct docs milestone - [ ] Release-gate evidence is linked when the SOT domain is `build-test` or `release-versioning` - [ ] Private-plugin findings do not leak confidential repository paths, URLs, or implementation details into public docs +- [ ] If AI coding context is affected: `AI_WIKI_INTEGRATION_PLAYBOOK.md` and `ai_context/developer_llm_wiki/*` references are reviewed for sync and drift ## Additional Context diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index b488fddb20..2691b0e706 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -13,6 +13,29 @@ Pflichtregeln: 3. Änderungen, die Architektur, Betrieb, Prozesse oder Governance betreffen, müssen die zugehörigen Wiki-Inhalte synchron halten. 4. Fehlende Wiki-Inhalte sind als Lücke zu melden und in den Arbeitsartefakten/PR-Hinweisen zu markieren statt stillschweigend zu ignorieren. +## 0.1) Developer LLM Wiki fuer GitHub Copilot auf GitHub (MUST) + +Wenn GitHub Copilot als Coding Agent auf GitHub implementiert, reviewt oder refactort, muss es das Developer LLM Wiki aktiv als Vibe-Coding-Kontext nutzen. + +Pflichtablauf: + +1. Zuerst `AI_WIKI_INTEGRATION_PLAYBOOK.md` lesen. +2. Vor Codeaenderungen die relevanten Developer-Wiki-Artefakte aus `ai_context/developer_llm_wiki/` konsultieren: + - `INDEX.md` + - `MODULES_AND_APIS.md` + - `BUILD_TEST_CI_AND_OPERATIONS.md` + - `GOVERNANCE_AND_ROADMAP.md` +3. `ai_context/developer_llm_wiki/WIKI_STATUS.json` als Frische-/Health-Signal pruefen (`generated_at`, `source_count`, Delta-Status). +4. Wiki-Kontext nach Task-Typ priorisieren: + - API-/Modularbeit → `MODULES_AND_APIS.md` + - Build/CI/Test → `BUILD_TEST_CI_AND_OPERATIONS.md` + - Governance/Roadmap/Release → `GOVERNANCE_AND_ROADMAP.md` + - allgemeiner Einstieg/Link-Hub → `INDEX.md` +5. Bei Konflikten gilt: Root-SOT und Modulquellen vor kompilierter Wiki-Synthese. +6. Wenn Wiki-Artefakte fehlen, stale wirken oder der Aufgabe widersprechen, diese Luecke explizit nennen statt das Wiki still zu ignorieren. + +Details und Dateizwecke: [AI_WIKI_CONTEXT.md](copilot/AI_WIKI_CONTEXT.md) + ## 1) Ziel Roadmap-Einträge müssen so konkret sein, dass Copilot **produktiven Sourcecode** statt Stub/Rumpf erzeugen kann. diff --git a/.github/copilot/AI_WIKI_CONTEXT.md b/.github/copilot/AI_WIKI_CONTEXT.md new file mode 100644 index 0000000000..88975f2a30 --- /dev/null +++ b/.github/copilot/AI_WIKI_CONTEXT.md @@ -0,0 +1,54 @@ +# Developer LLM Wiki Context for GitHub Copilot + +Use this module when GitHub Copilot on GitHub is implementing, refactoring, reviewing, or debugging code in ThemisDB. + +## Goal + +- Make the curated Developer LLM Wiki a first-class context source for GitHub Copilot coding tasks. +- Reduce ad-hoc repository scanning when relevant wiki syntheses already exist. +- Keep Copilot anchored to source-of-truth precedence instead of treating wiki pages as independent truth. + +## Required Read Order + +1. [../../AI_WIKI_INTEGRATION_PLAYBOOK.md](../../AI_WIKI_INTEGRATION_PLAYBOOK.md) +2. [../../ai_context/developer_llm_wiki/INDEX.md](../../ai_context/developer_llm_wiki/INDEX.md) +3. One or more task-specific wiki pages: + - [../../ai_context/developer_llm_wiki/MODULES_AND_APIS.md](../../ai_context/developer_llm_wiki/MODULES_AND_APIS.md) + - [../../ai_context/developer_llm_wiki/BUILD_TEST_CI_AND_OPERATIONS.md](../../ai_context/developer_llm_wiki/BUILD_TEST_CI_AND_OPERATIONS.md) + - [../../ai_context/developer_llm_wiki/GOVERNANCE_AND_ROADMAP.md](../../ai_context/developer_llm_wiki/GOVERNANCE_AND_ROADMAP.md) +4. [../../ai_context/developer_llm_wiki/WIKI_STATUS.json](../../ai_context/developer_llm_wiki/WIKI_STATUS.json) as freshness/sync evidence + +## File Selection Rules + +### Module and API work +- Start with `MODULES_AND_APIS.md` +- Cross-check with module-local `src//ROADMAP.md`, `FUTURE_ENHANCEMENTS.md`, `README.md` + +### Build, test, CI, and operations work +- Start with `BUILD_TEST_CI_AND_OPERATIONS.md` +- Cross-check with `.github/workflows/*.yml`, `scripts/*`, and root build docs + +### Governance, roadmap, release, and process work +- Start with `GOVERNANCE_AND_ROADMAP.md` +- Cross-check with `ROADMAP.md`, `FUTURE_ENHANCEMENTS.md`, `RELEASE_STRATEGY.md`, `BRANCHING_STRATEGY.md`, `VERSIONING.md` + +### General onboarding or multi-area tasks +- Start with `INDEX.md` +- Follow its links before falling back to broad repository search + +## Freshness and Trust Rules + +- Check `WIKI_STATUS.json` for: + - `generated_at` + - `source_count` + - delta metadata (`added_count`, `removed_count`, `changed_count`) +- Treat the Developer LLM Wiki as compiled guidance, not primary truth. +- If root SOT, module docs, tests, or code disagree with the wiki, prefer the primary source and report wiki drift. +- If the needed wiki page is missing, stale, or irrelevant, state that explicitly in the task output. + +## GitHub Copilot Behavior Expectations + +- On GitHub coding tasks, cite the consulted wiki page(s) when they materially informed the implementation. +- Do not claim the wiki was used unless the referenced files were actually consulted. +- Use the wiki to narrow search space, identify likely files, and recover module/build/governance context faster. +- Still verify behavior against code, tests, and workflows before making changes. diff --git a/.github/copilot/README.md b/.github/copilot/README.md index 0f3140728b..8c58aed076 100644 --- a/.github/copilot/README.md +++ b/.github/copilot/README.md @@ -51,12 +51,14 @@ cp -r .vscode.example .vscode 2. Read the team workflow in [AI_CUSTOMIZATION_WORKFLOW.md](AI_CUSTOMIZATION_WORKFLOW.md). 3. Follow links into the relevant module guides. 4. Use [VSCODE_CONTEXT.md](VSCODE_CONTEXT.md) for local environment setup. +5. Use [AI_WIKI_CONTEXT.md](AI_WIKI_CONTEXT.md) when GitHub Copilot on GitHub should ground coding work in the Developer LLM Wiki. ## AI Workflow Quick Links - Team workflow playbook: [AI_CUSTOMIZATION_WORKFLOW.md](AI_CUSTOMIZATION_WORKFLOW.md) - PR AI report template: [PR_AI_REPORT_TEMPLATE.md](PR_AI_REPORT_TEMPLATE.md) - Review severity policy: [REVIEW_SEVERITY_POLICY.md](REVIEW_SEVERITY_POLICY.md) +- Developer wiki context for GitHub Copilot: [AI_WIKI_CONTEXT.md](AI_WIKI_CONTEXT.md) - Agents: [../agents/themisdb-implementer.agent.md](../agents/themisdb-implementer.agent.md), [../agents/themisdb-reviewer.agent.md](../agents/themisdb-reviewer.agent.md) - Prompts: [../prompts/roadmap-to-production.prompt.md](../prompts/roadmap-to-production.prompt.md), [../prompts/build-triage-windows-release.prompt.md](../prompts/build-triage-windows-release.prompt.md), [../prompts/pr-diff-findings-review.prompt.md](../prompts/pr-diff-findings-review.prompt.md), [../prompts/security-hardening-review.prompt.md](../prompts/security-hardening-review.prompt.md), [../prompts/api-change-impact-review.prompt.md](../prompts/api-change-impact-review.prompt.md), [../prompts/release-readiness-check.prompt.md](../prompts/release-readiness-check.prompt.md), [../prompts/compose-ai-pr-report.prompt.md](../prompts/compose-ai-pr-report.prompt.md), [../prompts/verify-high-exception-record.prompt.md](../prompts/verify-high-exception-record.prompt.md) @@ -156,6 +158,13 @@ cp -r .vscode.example .vscode - Debugging workflows. - Formatting support. +### AI_WIKI_CONTEXT.md + +- Required Developer LLM Wiki read order for GitHub Copilot on GitHub. +- Which curated wiki files to use for module/API, CI/build, and governance tasks. +- Freshness checks via `WIKI_STATUS.json`. +- Source-of-truth fallback rules when wiki synthesis drifts. + ### PROMPT_ENGINEERING.md - Step-by-step decomposition for implementation prompts. diff --git a/ai_context/COPILOT_INSTRUCTIONS.md b/ai_context/COPILOT_INSTRUCTIONS.md index c11e28df5e..be307e06ee 100644 --- a/ai_context/COPILOT_INSTRUCTIONS.md +++ b/ai_context/COPILOT_INSTRUCTIONS.md @@ -36,6 +36,28 @@ Before starting any implementation task, consult these curated references: **Usage:** Link to contract row when reviewing/implementing public APIs in these modules. +## Developer LLM Wiki for GitHub Copilot (MUST) + +When GitHub Copilot acts as a coding agent on GitHub, it must actively use the Developer LLM Wiki as implementation context instead of relying only on raw repository search. + +Required flow: + +1. Read `../AI_WIKI_INTEGRATION_PLAYBOOK.md` first. +2. Consult the relevant curated wiki artifacts in `./developer_llm_wiki/` before editing: + - `INDEX.md` + - `MODULES_AND_APIS.md` + - `BUILD_TEST_CI_AND_OPERATIONS.md` + - `GOVERNANCE_AND_ROADMAP.md` +3. Check `./developer_llm_wiki/WIKI_STATUS.json` for freshness and sync health (`generated_at`, `source_count`, delta metadata). +4. Prioritize wiki sources by task type: + - API/module work → `MODULES_AND_APIS.md` + - build/test/CI/operations work → `BUILD_TEST_CI_AND_OPERATIONS.md` + - roadmap/governance/release work → `GOVERNANCE_AND_ROADMAP.md` + - general onboarding/navigation → `INDEX.md` +5. If the wiki conflicts with root SOT or module-local source docs, prefer the root/module source and flag the wiki drift explicitly. + +Reference module: [../.github/copilot/AI_WIKI_CONTEXT.md](../.github/copilot/AI_WIKI_CONTEXT.md) + ## Documentation tasks (MUST) If the task involves documentation (any markdown docs change; `docs/**` keeps the stricter format rules below): From 290b53a02b31cc786f67df2b2f0df78be58519a0 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 26 Aug 2026 07:51:42 +0000 Subject: [PATCH 06/10] docs: add task-specific Copilot wiki priorities Co-authored-by: makr-code <150588092+makr-code@users.noreply.github.com> --- .github/copilot-instructions.md | 8 +++++++ .github/copilot/AI_WIKI_CONTEXT.md | 35 ++++++++++++++++++++++++++++++ .github/copilot/README.md | 2 +- ai_context/COPILOT_INSTRUCTIONS.md | 8 +++++++ 4 files changed, 52 insertions(+), 1 deletion(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 2691b0e706..07862b41e2 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -30,10 +30,18 @@ Pflichtablauf: - API-/Modularbeit → `MODULES_AND_APIS.md` - Build/CI/Test → `BUILD_TEST_CI_AND_OPERATIONS.md` - Governance/Roadmap/Release → `GOVERNANCE_AND_ROADMAP.md` + - C/C++-Implementierung → `MODULES_AND_APIS.md` plus `MEMORY_MANAGEMENT_POLICY.md`, `OOP_AND_SOC_PRINCIPLES.md`, `FUNCTION_CLASSIFICATION.md` - allgemeiner Einstieg/Link-Hub → `INDEX.md` 5. Bei Konflikten gilt: Root-SOT und Modulquellen vor kompilierter Wiki-Synthese. 6. Wenn Wiki-Artefakte fehlen, stale wirken oder der Aufgabe widersprechen, diese Luecke explizit nennen statt das Wiki still zu ignorieren. +Task-spezifische Mindestregeln: + +- API-/Modularbeit: zuerst `ai_context/developer_llm_wiki/MODULES_AND_APIS.md`, danach relevante `ai_context/api_contracts/*.md` und modulnahe `src//*.md`. +- Build/CI/Test: zuerst `ai_context/developer_llm_wiki/BUILD_TEST_CI_AND_OPERATIONS.md`; bei Fehlern zusaetzlich immer konkrete GitHub-Actions-Logs und betroffene Workflow-Dateien pruefen. +- Governance/Roadmap/Release: zuerst `ai_context/developer_llm_wiki/GOVERNANCE_AND_ROADMAP.md`, danach Root-SOT-Dateien (`ROADMAP.md`, `FUTURE_ENHANCEMENTS.md`, `RELEASE_STRATEGY.md`, `BRANCHING_STRATEGY.md`, `VERSIONING.md`). +- C/C++-Arbeit: zuerst `ai_context/developer_llm_wiki/MODULES_AND_APIS.md`, danach `ai_context/MEMORY_MANAGEMENT_POLICY.md`, `ai_context/OOP_AND_SOC_PRINCIPLES.md`, `ai_context/FUNCTION_CLASSIFICATION.md` sowie die einschlaegigen `.github/instructions/*cpp*` Regeln. + Details und Dateizwecke: [AI_WIKI_CONTEXT.md](copilot/AI_WIKI_CONTEXT.md) ## 1) Ziel diff --git a/.github/copilot/AI_WIKI_CONTEXT.md b/.github/copilot/AI_WIKI_CONTEXT.md index 88975f2a30..0d8970f187 100644 --- a/.github/copilot/AI_WIKI_CONTEXT.md +++ b/.github/copilot/AI_WIKI_CONTEXT.md @@ -23,19 +23,54 @@ Use this module when GitHub Copilot on GitHub is implementing, refactoring, revi ### Module and API work - Start with `MODULES_AND_APIS.md` - Cross-check with module-local `src//ROADMAP.md`, `FUTURE_ENHANCEMENTS.md`, `README.md` +- Then consult API contract pages under `ai_context/api_contracts/` when the change touches public interfaces: + - `api.md` + - `llm.md` + - `index.md` + - `storage.md` + - `transaction.md` + - `auth.md` +- Prefer module/API wiki context before broad repository search when the task asks to implement, extend, or review an API contract. ### Build, test, CI, and operations work - Start with `BUILD_TEST_CI_AND_OPERATIONS.md` - Cross-check with `.github/workflows/*.yml`, `scripts/*`, and root build docs +- For CI/build failures, inspect the failing GitHub Actions run/job first, then use the wiki to narrow the relevant workflow/build files. +- Prioritize workflow/package/dependency sections in the wiki before scanning unrelated modules. ### Governance, roadmap, release, and process work - Start with `GOVERNANCE_AND_ROADMAP.md` - Cross-check with `ROADMAP.md`, `FUTURE_ENHANCEMENTS.md`, `RELEASE_STRATEGY.md`, `BRANCHING_STRATEGY.md`, `VERSIONING.md` +- Treat root governance files as the final authority for branch names, release lanes, documentation sync, and acceptance gates. +- Use the wiki as an index into those root governance sources, not as a replacement for them. + +### C and C++ implementation work +- Start with `MODULES_AND_APIS.md` +- Then consult: + - `../../ai_context/MEMORY_MANAGEMENT_POLICY.md` + - `../../ai_context/OOP_AND_SOC_PRINCIPLES.md` + - `../../ai_context/FUNCTION_CLASSIFICATION.md` +- Cross-check with: + - `../../.github/instructions/cpp-best-practices.instructions.md` + - `../../.github/instructions/cpp-language-service-tools.instructions.md` + - `../../.github/instructions/documentation-enforcement.instructions.md` +- For public C++ API changes, also read the relevant file in `../../ai_context/api_contracts/` before editing. +- Prefer the wiki and instruction files to establish invariants, ownership, and test expectations before touching `.cpp`/`.h`/`.hpp` files. ### General onboarding or multi-area tasks - Start with `INDEX.md` - Follow its links before falling back to broad repository search +## Task-Type Priority Matrix + +| Task type | Read first | Then verify against | +|---|---|---| +| API / module implementation | `developer_llm_wiki/MODULES_AND_APIS.md` | `src//*.md`, `ai_context/api_contracts/*.md`, headers/tests | +| CI / build / workflow triage | `developer_llm_wiki/BUILD_TEST_CI_AND_OPERATIONS.md` | GitHub Actions logs, `.github/workflows/*.yml`, `scripts/*` | +| Governance / roadmap / release | `developer_llm_wiki/GOVERNANCE_AND_ROADMAP.md` | `ROADMAP.md`, `FUTURE_ENHANCEMENTS.md`, `RELEASE_STRATEGY.md`, `BRANCHING_STRATEGY.md`, `VERSIONING.md` | +| C / C++ coding | `developer_llm_wiki/MODULES_AND_APIS.md` | `MEMORY_MANAGEMENT_POLICY.md`, `OOP_AND_SOC_PRINCIPLES.md`, C++ instruction files, module sources/tests | +| Multi-area / discovery | `developer_llm_wiki/INDEX.md` | linked task-specific wiki pages and primary sources | + ## Freshness and Trust Rules - Check `WIKI_STATUS.json` for: diff --git a/.github/copilot/README.md b/.github/copilot/README.md index 8c58aed076..5962cd5af8 100644 --- a/.github/copilot/README.md +++ b/.github/copilot/README.md @@ -161,7 +161,7 @@ cp -r .vscode.example .vscode ### AI_WIKI_CONTEXT.md - Required Developer LLM Wiki read order for GitHub Copilot on GitHub. -- Which curated wiki files to use for module/API, CI/build, and governance tasks. +- Which curated wiki files to use for module/API, CI/build, governance, and C/C++ tasks. - Freshness checks via `WIKI_STATUS.json`. - Source-of-truth fallback rules when wiki synthesis drifts. diff --git a/ai_context/COPILOT_INSTRUCTIONS.md b/ai_context/COPILOT_INSTRUCTIONS.md index be307e06ee..aa86100315 100644 --- a/ai_context/COPILOT_INSTRUCTIONS.md +++ b/ai_context/COPILOT_INSTRUCTIONS.md @@ -53,9 +53,17 @@ Required flow: - API/module work → `MODULES_AND_APIS.md` - build/test/CI/operations work → `BUILD_TEST_CI_AND_OPERATIONS.md` - roadmap/governance/release work → `GOVERNANCE_AND_ROADMAP.md` + - C/C++ implementation work → `MODULES_AND_APIS.md` plus `MEMORY_MANAGEMENT_POLICY.md`, `OOP_AND_SOC_PRINCIPLES.md`, `FUNCTION_CLASSIFICATION.md` - general onboarding/navigation → `INDEX.md` 5. If the wiki conflicts with root SOT or module-local source docs, prefer the root/module source and flag the wiki drift explicitly. +Task-specific minimum expectations: + +- API/module work: consult `./developer_llm_wiki/MODULES_AND_APIS.md` first, then the relevant files under `./api_contracts/` and the module-local `src//*.md`. +- Build/test/CI/operations work: consult `./developer_llm_wiki/BUILD_TEST_CI_AND_OPERATIONS.md` first, then verify against GitHub Actions logs, `.github/workflows/*.yml`, and affected scripts. +- Roadmap/governance/release work: consult `./developer_llm_wiki/GOVERNANCE_AND_ROADMAP.md` first, then verify against `ROADMAP.md`, `FUTURE_ENHANCEMENTS.md`, `RELEASE_STRATEGY.md`, `BRANCHING_STRATEGY.md`, and `VERSIONING.md`. +- C/C++ work: consult `./developer_llm_wiki/MODULES_AND_APIS.md` first, then `MEMORY_MANAGEMENT_POLICY.md`, `OOP_AND_SOC_PRINCIPLES.md`, `FUNCTION_CLASSIFICATION.md`, and the relevant `.github/instructions/*cpp*` rule files before editing code. + Reference module: [../.github/copilot/AI_WIKI_CONTEXT.md](../.github/copilot/AI_WIKI_CONTEXT.md) ## Documentation tasks (MUST) From bf491106b1d4eecdb9ac1e190ca8a914ab52b734 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 26 Aug 2026 08:08:04 +0000 Subject: [PATCH 07/10] Changes before error encountered Agent-Logs-Url: https://github.com/makr-code/ThemisDB/sessions/7c2f4490-62f2-46d6-9db7-04d2babebf04 Co-authored-by: makr-code <150588092+makr-code@users.noreply.github.com> --- .github/copilot-instructions.md | 8 ++++++-- .github/copilot/AI_WIKI_CONTEXT.md | 27 +++++++++++++++++++++++++-- .github/copilot/README.md | 1 + ai_context/COPILOT_INSTRUCTIONS.md | 8 ++++++-- 4 files changed, 38 insertions(+), 6 deletions(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 07862b41e2..22cc833a10 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -30,7 +30,7 @@ Pflichtablauf: - API-/Modularbeit → `MODULES_AND_APIS.md` - Build/CI/Test → `BUILD_TEST_CI_AND_OPERATIONS.md` - Governance/Roadmap/Release → `GOVERNANCE_AND_ROADMAP.md` - - C/C++-Implementierung → `MODULES_AND_APIS.md` plus `MEMORY_MANAGEMENT_POLICY.md`, `OOP_AND_SOC_PRINCIPLES.md`, `FUNCTION_CLASSIFICATION.md` + - C/C++-Implementierung → `MODULES_AND_APIS.md` plus `memory_management_policy.md`, `OOP_AND_SOC_PRINCIPLES.md`, `FUNCTION_CLASSIFICATION.md` - allgemeiner Einstieg/Link-Hub → `INDEX.md` 5. Bei Konflikten gilt: Root-SOT und Modulquellen vor kompilierter Wiki-Synthese. 6. Wenn Wiki-Artefakte fehlen, stale wirken oder der Aufgabe widersprechen, diese Luecke explizit nennen statt das Wiki still zu ignorieren. @@ -40,7 +40,11 @@ Task-spezifische Mindestregeln: - API-/Modularbeit: zuerst `ai_context/developer_llm_wiki/MODULES_AND_APIS.md`, danach relevante `ai_context/api_contracts/*.md` und modulnahe `src//*.md`. - Build/CI/Test: zuerst `ai_context/developer_llm_wiki/BUILD_TEST_CI_AND_OPERATIONS.md`; bei Fehlern zusaetzlich immer konkrete GitHub-Actions-Logs und betroffene Workflow-Dateien pruefen. - Governance/Roadmap/Release: zuerst `ai_context/developer_llm_wiki/GOVERNANCE_AND_ROADMAP.md`, danach Root-SOT-Dateien (`ROADMAP.md`, `FUTURE_ENHANCEMENTS.md`, `RELEASE_STRATEGY.md`, `BRANCHING_STRATEGY.md`, `VERSIONING.md`). -- C/C++-Arbeit: zuerst `ai_context/developer_llm_wiki/MODULES_AND_APIS.md`, danach `ai_context/MEMORY_MANAGEMENT_POLICY.md`, `ai_context/OOP_AND_SOC_PRINCIPLES.md`, `ai_context/FUNCTION_CLASSIFICATION.md` sowie die einschlaegigen `.github/instructions/*cpp*` Regeln. +- C/C++-Arbeit: zuerst `ai_context/developer_llm_wiki/MODULES_AND_APIS.md`, danach `ai_context/memory_management_policy.md`, `ai_context/OOP_AND_SOC_PRINCIPLES.md`, `ai_context/FUNCTION_CLASSIFICATION.md` sowie die einschlaegigen `.github/instructions/*cpp*` Regeln. + - Public API / Header-Vertraege: zusaetzlich zuerst relevante `ai_context/api_contracts/*.md` und Doxygen-/Thread-Safety-/Ownership-Pflichten pruefen. + - Internal Core / Implementierungslogik: Ownership, RAII, `detail::`-Grenzen und unbeabsichtigte API-Flaechenerweiterungen gegen `memory_management_policy.md` und `OOP_AND_SOC_PRINCIPLES.md` pruefen. + - Concurrency / Performance: Locking, Atomics, Hot-Path-Klassifikation, Timeout/Cancellation und Benchmark-Bezug gegen `FUNCTION_CLASSIFICATION.md` und C++-Best-Practice-Regeln pruefen. + - Plugin-Boundaries / Extensibility: Adapter-/Interface-Grenzen sowie Public-vs-Private-Grenzen gegen `OOP_AND_SOC_PRINCIPLES.md` und `GOVERNANCE_AND_ROADMAP.md` pruefen. Details und Dateizwecke: [AI_WIKI_CONTEXT.md](copilot/AI_WIKI_CONTEXT.md) diff --git a/.github/copilot/AI_WIKI_CONTEXT.md b/.github/copilot/AI_WIKI_CONTEXT.md index 0d8970f187..baccb0eb47 100644 --- a/.github/copilot/AI_WIKI_CONTEXT.md +++ b/.github/copilot/AI_WIKI_CONTEXT.md @@ -47,7 +47,7 @@ Use this module when GitHub Copilot on GitHub is implementing, refactoring, revi ### C and C++ implementation work - Start with `MODULES_AND_APIS.md` - Then consult: - - `../../ai_context/MEMORY_MANAGEMENT_POLICY.md` + - `../../ai_context/memory_management_policy.md` - `../../ai_context/OOP_AND_SOC_PRINCIPLES.md` - `../../ai_context/FUNCTION_CLASSIFICATION.md` - Cross-check with: @@ -57,6 +57,26 @@ Use this module when GitHub Copilot on GitHub is implementing, refactoring, revi - For public C++ API changes, also read the relevant file in `../../ai_context/api_contracts/` before editing. - Prefer the wiki and instruction files to establish invariants, ownership, and test expectations before touching `.cpp`/`.h`/`.hpp` files. +#### Public C++ API work +- Prioritize `ai_context/api_contracts/*.md` after `MODULES_AND_APIS.md`. +- Verify public/header-level stability, ownership, thread-safety, deprecation, and documentation expectations before editing `include/**`. +- Cross-check with `FUNCTION_CLASSIFICATION.md` for public API level and `documentation-enforcement.instructions.md` for Doxygen obligations. + +#### Internal core C++ work +- Prioritize `memory_management_policy.md` and `OOP_AND_SOC_PRINCIPLES.md` after `MODULES_AND_APIS.md`. +- Focus on invariants, ownership transfer, adapter boundaries, and whether logic belongs in `include/**`, `src/**`, or `detail::`. +- Verify that any internal helper/API drift does not accidentally widen the public surface. + +#### Concurrency and performance C++ work +- Prioritize `FUNCTION_CLASSIFICATION.md` and `memory_management_policy.md` after `MODULES_AND_APIS.md`. +- Check thread-safety class, locking expectations, timeout/cancellation behavior, and hot-path criticality before editing. +- Cross-check with `cpp-best-practices.instructions.md` for lock ordering, atomics, false-sharing, and profiling-first constraints. + +#### Plugin boundary and extensibility C++ work +- Prioritize `OOP_AND_SOC_PRINCIPLES.md` and `GOVERNANCE_AND_ROADMAP.md` after `MODULES_AND_APIS.md`. +- Verify public/private boundary rules, adapter/plugin interface contracts, and that no private implementation details leak into Community/Minimal surfaces. +- Treat plugin-related interface additions as governance-sensitive changes, not just local refactors. + ### General onboarding or multi-area tasks - Start with `INDEX.md` - Follow its links before falling back to broad repository search @@ -68,7 +88,10 @@ Use this module when GitHub Copilot on GitHub is implementing, refactoring, revi | API / module implementation | `developer_llm_wiki/MODULES_AND_APIS.md` | `src//*.md`, `ai_context/api_contracts/*.md`, headers/tests | | CI / build / workflow triage | `developer_llm_wiki/BUILD_TEST_CI_AND_OPERATIONS.md` | GitHub Actions logs, `.github/workflows/*.yml`, `scripts/*` | | Governance / roadmap / release | `developer_llm_wiki/GOVERNANCE_AND_ROADMAP.md` | `ROADMAP.md`, `FUTURE_ENHANCEMENTS.md`, `RELEASE_STRATEGY.md`, `BRANCHING_STRATEGY.md`, `VERSIONING.md` | -| C / C++ coding | `developer_llm_wiki/MODULES_AND_APIS.md` | `MEMORY_MANAGEMENT_POLICY.md`, `OOP_AND_SOC_PRINCIPLES.md`, C++ instruction files, module sources/tests | +| C++ public API | `developer_llm_wiki/MODULES_AND_APIS.md` | `ai_context/api_contracts/*.md`, `FUNCTION_CLASSIFICATION.md`, headers/tests | +| C++ internal core | `developer_llm_wiki/MODULES_AND_APIS.md` | `memory_management_policy.md`, `OOP_AND_SOC_PRINCIPLES.md`, module sources/tests | +| C++ concurrency / performance | `developer_llm_wiki/MODULES_AND_APIS.md` | `FUNCTION_CLASSIFICATION.md`, `memory_management_policy.md`, C++ instruction files, benchmarks/tests | +| C++ plugin boundary | `developer_llm_wiki/MODULES_AND_APIS.md` | `OOP_AND_SOC_PRINCIPLES.md`, `GOVERNANCE_AND_ROADMAP.md`, plugin docs/interfaces | | Multi-area / discovery | `developer_llm_wiki/INDEX.md` | linked task-specific wiki pages and primary sources | ## Freshness and Trust Rules diff --git a/.github/copilot/README.md b/.github/copilot/README.md index 5962cd5af8..569f6e5482 100644 --- a/.github/copilot/README.md +++ b/.github/copilot/README.md @@ -162,6 +162,7 @@ cp -r .vscode.example .vscode - Required Developer LLM Wiki read order for GitHub Copilot on GitHub. - Which curated wiki files to use for module/API, CI/build, governance, and C/C++ tasks. +- Which C++ workflow profile to use for public API, internal core, concurrency/performance, and plugin-boundary work. - Freshness checks via `WIKI_STATUS.json`. - Source-of-truth fallback rules when wiki synthesis drifts. diff --git a/ai_context/COPILOT_INSTRUCTIONS.md b/ai_context/COPILOT_INSTRUCTIONS.md index aa86100315..2fdf94712c 100644 --- a/ai_context/COPILOT_INSTRUCTIONS.md +++ b/ai_context/COPILOT_INSTRUCTIONS.md @@ -53,7 +53,7 @@ Required flow: - API/module work → `MODULES_AND_APIS.md` - build/test/CI/operations work → `BUILD_TEST_CI_AND_OPERATIONS.md` - roadmap/governance/release work → `GOVERNANCE_AND_ROADMAP.md` - - C/C++ implementation work → `MODULES_AND_APIS.md` plus `MEMORY_MANAGEMENT_POLICY.md`, `OOP_AND_SOC_PRINCIPLES.md`, `FUNCTION_CLASSIFICATION.md` + - C/C++ implementation work → `MODULES_AND_APIS.md` plus `memory_management_policy.md`, `OOP_AND_SOC_PRINCIPLES.md`, `FUNCTION_CLASSIFICATION.md` - general onboarding/navigation → `INDEX.md` 5. If the wiki conflicts with root SOT or module-local source docs, prefer the root/module source and flag the wiki drift explicitly. @@ -62,7 +62,11 @@ Task-specific minimum expectations: - API/module work: consult `./developer_llm_wiki/MODULES_AND_APIS.md` first, then the relevant files under `./api_contracts/` and the module-local `src//*.md`. - Build/test/CI/operations work: consult `./developer_llm_wiki/BUILD_TEST_CI_AND_OPERATIONS.md` first, then verify against GitHub Actions logs, `.github/workflows/*.yml`, and affected scripts. - Roadmap/governance/release work: consult `./developer_llm_wiki/GOVERNANCE_AND_ROADMAP.md` first, then verify against `ROADMAP.md`, `FUTURE_ENHANCEMENTS.md`, `RELEASE_STRATEGY.md`, `BRANCHING_STRATEGY.md`, and `VERSIONING.md`. -- C/C++ work: consult `./developer_llm_wiki/MODULES_AND_APIS.md` first, then `MEMORY_MANAGEMENT_POLICY.md`, `OOP_AND_SOC_PRINCIPLES.md`, `FUNCTION_CLASSIFICATION.md`, and the relevant `.github/instructions/*cpp*` rule files before editing code. +- C/C++ work: consult `./developer_llm_wiki/MODULES_AND_APIS.md` first, then `memory_management_policy.md`, `OOP_AND_SOC_PRINCIPLES.md`, `FUNCTION_CLASSIFICATION.md`, and the relevant `.github/instructions/*cpp*` rule files before editing code. + - Public API / header work: also consult the relevant files under `./api_contracts/` before editing `include/**`, and verify ownership, deprecation, documentation, and thread-safety expectations. + - Internal core work: verify RAII rules, adapter boundaries, and internal-vs-public surface separation before editing `src/**` or internal headers. + - Concurrency / performance work: verify locking model, atomic usage, timeout/cancellation behavior, hot-path classification, and benchmark expectations before changing behavior. + - Plugin boundary / extensibility work: verify public/private boundary constraints, adapter contracts, and governance-sensitive plugin surface rules before changing interfaces. Reference module: [../.github/copilot/AI_WIKI_CONTEXT.md](../.github/copilot/AI_WIKI_CONTEXT.md) From f1839d6f8d1311a856def558f49dcfbe56e8a424 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 26 Aug 2026 09:20:12 +0000 Subject: [PATCH 08/10] docs: refine C++ Copilot wiki routing Co-authored-by: makr-code <150588092+makr-code@users.noreply.github.com> --- .github/copilot-instructions.md | 6 +++++ .github/copilot/AI_WIKI_CONTEXT.md | 36 ++++++++++++++++++++++++++++++ ai_context/COPILOT_INSTRUCTIONS.md | 6 +++++ 3 files changed, 48 insertions(+) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 22cc833a10..ca3e72a96b 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -45,6 +45,12 @@ Task-spezifische Mindestregeln: - Internal Core / Implementierungslogik: Ownership, RAII, `detail::`-Grenzen und unbeabsichtigte API-Flaechenerweiterungen gegen `memory_management_policy.md` und `OOP_AND_SOC_PRINCIPLES.md` pruefen. - Concurrency / Performance: Locking, Atomics, Hot-Path-Klassifikation, Timeout/Cancellation und Benchmark-Bezug gegen `FUNCTION_CLASSIFICATION.md` und C++-Best-Practice-Regeln pruefen. - Plugin-Boundaries / Extensibility: Adapter-/Interface-Grenzen sowie Public-vs-Private-Grenzen gegen `OOP_AND_SOC_PRINCIPLES.md` und `GOVERNANCE_AND_ROADMAP.md` pruefen. + - Einordnungshilfe: + - `include/**` oder externe Vertragsaenderung → Public API + - `src/**`, interne Header oder `detail::` → Internal Core + - Locking/Atomics/Latenz/Benchmarks/Timeouts → Concurrency / Performance + - Plugin-Interfaces/Adapter/Edition-Grenzen → Plugin-Boundaries / Extensibility + - Wenn mehrere C++-Subtypen zugleich betroffen sind, gelten alle relevanten Wiki-/Governance-Pflichten kumulativ. Details und Dateizwecke: [AI_WIKI_CONTEXT.md](copilot/AI_WIKI_CONTEXT.md) diff --git a/.github/copilot/AI_WIKI_CONTEXT.md b/.github/copilot/AI_WIKI_CONTEXT.md index baccb0eb47..cff981211e 100644 --- a/.github/copilot/AI_WIKI_CONTEXT.md +++ b/.github/copilot/AI_WIKI_CONTEXT.md @@ -61,21 +61,57 @@ Use this module when GitHub Copilot on GitHub is implementing, refactoring, revi - Prioritize `ai_context/api_contracts/*.md` after `MODULES_AND_APIS.md`. - Verify public/header-level stability, ownership, thread-safety, deprecation, and documentation expectations before editing `include/**`. - Cross-check with `FUNCTION_CLASSIFICATION.md` for public API level and `documentation-enforcement.instructions.md` for Doxygen obligations. +- Default file order: + 1. `developer_llm_wiki/MODULES_AND_APIS.md` + 2. relevant `ai_context/api_contracts/*.md` + 3. `ai_context/FUNCTION_CLASSIFICATION.md` + 4. public headers in `include/**` + 5. affected tests and module docs +- Must verify: ownership/lifetime contract, `@thread_safety`, deprecation/versioning impact, and whether the change expands the supported public surface. #### Internal core C++ work - Prioritize `memory_management_policy.md` and `OOP_AND_SOC_PRINCIPLES.md` after `MODULES_AND_APIS.md`. - Focus on invariants, ownership transfer, adapter boundaries, and whether logic belongs in `include/**`, `src/**`, or `detail::`. - Verify that any internal helper/API drift does not accidentally widen the public surface. +- Default file order: + 1. `developer_llm_wiki/MODULES_AND_APIS.md` + 2. `ai_context/memory_management_policy.md` + 3. `ai_context/OOP_AND_SOC_PRINCIPLES.md` + 4. internal headers / `src/**` + 5. focused module tests +- Must verify: RAII ownership, `detail::` boundaries, exception/result-handling pattern, and no accidental promotion of internal helpers into public headers. #### Concurrency and performance C++ work - Prioritize `FUNCTION_CLASSIFICATION.md` and `memory_management_policy.md` after `MODULES_AND_APIS.md`. - Check thread-safety class, locking expectations, timeout/cancellation behavior, and hot-path criticality before editing. - Cross-check with `cpp-best-practices.instructions.md` for lock ordering, atomics, false-sharing, and profiling-first constraints. +- Default file order: + 1. `developer_llm_wiki/MODULES_AND_APIS.md` + 2. `ai_context/FUNCTION_CLASSIFICATION.md` + 3. `ai_context/memory_management_policy.md` + 4. C++ best-practice instruction file + 5. relevant benchmarks / concurrency tests / target sources +- Must verify: thread-safety class, lock ordering, atomic vs mutex choice, timeout/cancellation semantics, and whether the path is P0/P1/P2. #### Plugin boundary and extensibility C++ work - Prioritize `OOP_AND_SOC_PRINCIPLES.md` and `GOVERNANCE_AND_ROADMAP.md` after `MODULES_AND_APIS.md`. - Verify public/private boundary rules, adapter/plugin interface contracts, and that no private implementation details leak into Community/Minimal surfaces. - Treat plugin-related interface additions as governance-sensitive changes, not just local refactors. +- Default file order: + 1. `developer_llm_wiki/MODULES_AND_APIS.md` + 2. `ai_context/OOP_AND_SOC_PRINCIPLES.md` + 3. `developer_llm_wiki/GOVERNANCE_AND_ROADMAP.md` + 4. plugin interface headers/docs + 5. affected governance/release docs when surface policy changes +- Must verify: adapter boundary, edition/public-private boundary, repository-vs-plugin ownership, and whether the change belongs in public SDK docs or private plugin space. + +## C++ Subtype Routing Heuristics + +- If the task edits `include/**` or changes documented external behavior, treat it as **Public C++ API work**. +- If the task edits `src/**`, `detail::`, or internal helper headers without intended external contract change, treat it as **Internal core C++ work**. +- If the task changes mutexes, atomics, scheduling, batching, benchmarks, latency-sensitive code, or timeout behavior, treat it as **Concurrency and performance C++ work**. +- If the task changes adapters, plugin interfaces, extensibility seams, SDK exposure, or edition boundaries, treat it as **Plugin boundary and extensibility C++ work**. +- If multiple C++ subtypes apply, read all relevant subtype inputs and use the strictest boundary/documentation requirements among them. ### General onboarding or multi-area tasks - Start with `INDEX.md` diff --git a/ai_context/COPILOT_INSTRUCTIONS.md b/ai_context/COPILOT_INSTRUCTIONS.md index 2fdf94712c..3268f6fb98 100644 --- a/ai_context/COPILOT_INSTRUCTIONS.md +++ b/ai_context/COPILOT_INSTRUCTIONS.md @@ -67,6 +67,12 @@ Task-specific minimum expectations: - Internal core work: verify RAII rules, adapter boundaries, and internal-vs-public surface separation before editing `src/**` or internal headers. - Concurrency / performance work: verify locking model, atomic usage, timeout/cancellation behavior, hot-path classification, and benchmark expectations before changing behavior. - Plugin boundary / extensibility work: verify public/private boundary constraints, adapter contracts, and governance-sensitive plugin surface rules before changing interfaces. + - Classification hint: + - `include/**` or external contract change → public API work + - `src/**`, internal headers, or `detail::` changes → internal core work + - locking, atomics, latency, benchmarks, or timeout behavior → concurrency / performance work + - adapters, plugin interfaces, SDK exposure, or edition boundaries → plugin boundary / extensibility work + - If more than one C++ subtype applies, all relevant wiki inputs and the strictest boundary/documentation rules apply together. Reference module: [../.github/copilot/AI_WIKI_CONTEXT.md](../.github/copilot/AI_WIKI_CONTEXT.md) From 33d1463beac89220b1b7fd9cbbfb7cbd978d9d63 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 26 Aug 2026 10:09:47 +0000 Subject: [PATCH 09/10] fix: scan only added PR diff lines for private credentials Co-authored-by: makr-code <150588092+makr-code@users.noreply.github.com> --- .github/workflows/gate-pr-core.yml | 35 +++++++++++++++++------------- 1 file changed, 20 insertions(+), 15 deletions(-) diff --git a/.github/workflows/gate-pr-core.yml b/.github/workflows/gate-pr-core.yml index eb4ee452a0..fcdc7361bd 100644 --- a/.github/workflows/gate-pr-core.yml +++ b/.github/workflows/gate-pr-core.yml @@ -826,12 +826,15 @@ jobs: run: | BASE_REF="${{ github.base_ref }}" git fetch origin "${BASE_REF}" + DIFF_RANGE="origin/${BASE_REF}...HEAD" if git merge-base "origin/${BASE_REF}" HEAD >/dev/null 2>&1; then - git diff --name-only "origin/${BASE_REF}...HEAD" > changed_files.txt + : else echo "::warning::No merge base found for origin/${BASE_REF}...HEAD; falling back to two-dot diff." - git diff --name-only "origin/${BASE_REF}..HEAD" > changed_files.txt + DIFF_RANGE="origin/${BASE_REF}..HEAD" fi + git diff --name-only "${DIFF_RANGE}" > changed_files.txt + git diff --unified=0 --no-color "${DIFF_RANGE}" > pr.diff echo "Files changed: $(wc -l < changed_files.txt)" - name: Scan for private credentials (AWS/Azure/GCP/OAuth/SSH) @@ -859,26 +862,28 @@ jobs: "db_password": (r"db_password\s*[:=]\s*['\"]([^'\"]{8,})['\"]", "HIGH"), } - changed_files = Path("changed_files.txt").read_text().splitlines() critical_found = False matches_summary = [] + current_file = None + target_line = None - for filepath in changed_files: - p = Path(filepath) - if not p.exists() or not p.is_file(): + for raw_line in Path("pr.diff").read_text(errors="replace").splitlines(): + if raw_line.startswith("+++ b/"): + current_file = raw_line[6:] continue - - try: - content = p.read_text(errors="replace") - except Exception: + if raw_line.startswith("@@"): + match = re.match(r"@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@", raw_line) + target_line = int(match.group(1)) if match else None continue - - line_num = 0 - for line in content.splitlines(): - line_num += 1 + if current_file is None or target_line is None: + continue + if raw_line.startswith("+") and not raw_line.startswith("+++"): + line = raw_line[1:] + line_num = target_line + target_line += 1 for pattern_name, (pattern, severity) in CREDENTIAL_PATTERNS.items(): if re.search(pattern, line, re.IGNORECASE): - msg = f"[{severity}] {pattern_name} detected at {filepath}:{line_num}" + msg = f"[{severity}] {pattern_name} detected at {current_file}:{line_num}" print(f"::error::{msg}") matches_summary.append(f"{severity}: {pattern_name}") if severity == "CRITICAL": From 6cfceac58914b3626b64798dd09776ba4a833df5 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 26 Aug 2026 10:09:56 +0000 Subject: [PATCH 10/10] fix: satisfy workflow boundary guard path constraints Co-authored-by: makr-code <150588092+makr-code@users.noreply.github.com> --- .github/workflows/gate-pr-core.yml | 24 ++++++++- .github/workflows/security-codeql.yml | 70 +++++++++++++++++++++++---- 2 files changed, 83 insertions(+), 11 deletions(-) diff --git a/.github/workflows/gate-pr-core.yml b/.github/workflows/gate-pr-core.yml index fcdc7361bd..c339f26e71 100644 --- a/.github/workflows/gate-pr-core.yml +++ b/.github/workflows/gate-pr-core.yml @@ -26,12 +26,34 @@ on: - hyperscaler - military - minimal + paths: + - CMakeLists.txt + - CMakePresets.json + - cmake/**/*.cmake + - cmake/**/*.txt + - cmake/**/*.in + - .github/workflows/** + - .github/no_workflows/** + - .github/actions/** + - .github/scripts/** + - .github/WORKFLOW_GUIDELINES.md + - .github/WORKFLOW_REGISTRY.md + - ROADMAP.md + - FUTURE_ENHANCEMENTS.md + - RELEASE_STRATEGY.md + - BRANCHING_STRATEGY.md + - VERSIONING.md + - CHANGELOG.md + - tools/ci/** + - tools/tests/** push: branches: [develop] paths: - CMakeLists.txt - CMakePresets.json - - cmake/** + - cmake/**/*.cmake + - cmake/**/*.txt + - cmake/**/*.in - .github/workflows/gate-pr-core.yml - .github/WORKFLOW_GUIDELINES.md workflow_dispatch: diff --git a/.github/workflows/security-codeql.yml b/.github/workflows/security-codeql.yml index 02656c4742..5ab3487f17 100644 --- a/.github/workflows/security-codeql.yml +++ b/.github/workflows/security-codeql.yml @@ -29,11 +29,36 @@ on: push: branches: [ "develop", "community" ] paths: - - 'src/**' - - 'include/**' - - 'tests/**' - - 'benchmarks/**' - - 'tools/**' + - 'src/**/*.c' + - 'src/**/*.cc' + - 'src/**/*.cpp' + - 'src/**/*.cxx' + - 'src/**/*.h' + - 'src/**/*.hh' + - 'src/**/*.hpp' + - 'src/**/*.hxx' + - 'include/**/*.h' + - 'include/**/*.hh' + - 'include/**/*.hpp' + - 'include/**/*.hxx' + - 'tests/**/*.c' + - 'tests/**/*.cc' + - 'tests/**/*.cpp' + - 'tests/**/*.cxx' + - 'tests/**/*.h' + - 'tests/**/*.hh' + - 'tests/**/*.hpp' + - 'tests/**/*.hxx' + - 'benchmarks/**/*.c' + - 'benchmarks/**/*.cc' + - 'benchmarks/**/*.cpp' + - 'benchmarks/**/*.cxx' + - 'benchmarks/**/*.h' + - 'benchmarks/**/*.hh' + - 'benchmarks/**/*.hpp' + - 'benchmarks/**/*.hxx' + - 'tools/ci/**' + - 'tools/tests/**' - '*.c' - '*.cc' - '*.cpp' @@ -44,11 +69,36 @@ on: pull_request: branches: [ "develop", "community" ] paths: - - 'src/**' - - 'include/**' - - 'tests/**' - - 'benchmarks/**' - - 'tools/**' + - 'src/**/*.c' + - 'src/**/*.cc' + - 'src/**/*.cpp' + - 'src/**/*.cxx' + - 'src/**/*.h' + - 'src/**/*.hh' + - 'src/**/*.hpp' + - 'src/**/*.hxx' + - 'include/**/*.h' + - 'include/**/*.hh' + - 'include/**/*.hpp' + - 'include/**/*.hxx' + - 'tests/**/*.c' + - 'tests/**/*.cc' + - 'tests/**/*.cpp' + - 'tests/**/*.cxx' + - 'tests/**/*.h' + - 'tests/**/*.hh' + - 'tests/**/*.hpp' + - 'tests/**/*.hxx' + - 'benchmarks/**/*.c' + - 'benchmarks/**/*.cc' + - 'benchmarks/**/*.cpp' + - 'benchmarks/**/*.cxx' + - 'benchmarks/**/*.h' + - 'benchmarks/**/*.hh' + - 'benchmarks/**/*.hpp' + - 'benchmarks/**/*.hxx' + - 'tools/ci/**' + - 'tools/tests/**' - '*.c' - '*.cc' - '*.cpp'