Repository Layout

Repository Layout

PyCVE розділений на два незалежні code-репозиторії з різними життєвими циклами: builder живе на одній машині й може вільно вимагати свіжий Python та залежності, тоді як агент розкатується на весь парк і тому тримається максимально консервативним (Python 3.8+, лише стандартна бібліотека). Спільне вікі описує те, що стосується обох.

pycve-server

Builder статичних рулсетів. Python-пакет pycve-server, CLI entrypoint — rule-builder.

pycve-server/
├── src/rule_service/      # код builder-а: CLI, fetcher-и джерел, нормалізатори
├── tests/                 # unit/integration-тести + fixtures фідів
├── run-rule-builder.sh    # portable-обгортка (працює без встановлення пакета)
├── pyproject.toml
└── README.md              # повний CLI reference builder-а

pycve-agent

Локальний агент. Python-пакет pycve-agent, CLI entrypoint — local-agent.

pycve-agent/
├── src/local_agent/            # код агента: detection, fetch/cache, matching, вивід
├── tests/                      # unit/integration-тести
├── run-local-agent.sh          # portable-обгортка
├── checks.pycve.yaml.example   # приклад інтеграції з check-runner
├── pyproject.toml
└── README.md                   # повний CLI reference агента

Тести в обох репозиторіях запускаються однаково:

python3 -m unittest discover -s tests -p 'test_*.py'

Спільне вікі

Це вікі — один набір Markdown-сторінок, який публікується в wiki-remote обох репозиторіїв, тому читач pycve-agent і читач pycve-server бачать ту саму документацію:

pycve/
├── server -> pycve-server.git
├── agent  -> pycve-agent.git
└── wiki   -> pycve-server.wiki.git і pycve-agent.wiki.git

Поділ відповідальності між документацією:

• README репозиторію — довідник по конкретному CLI: встановлення, всі ключі, формати виводу, обмеження.
• Вікі — спільна картина: архітектура, операційні сценарії, формати артефактів, джерела даних, пріоритезація.

Вікі не містить deployable-коду і не є runtime-компонентом системи.