- git mv of all existing files into version-python/ (history preserved) - version-rust/: minimal cargo scaffold (edition 2024), no deps yet - root AGENTS.md documents the transition rules and artifact/schema contract - main is untouched; the python layout there stays as-is
27 lines
1.2 KiB
Markdown
27 lines
1.2 KiB
Markdown
# AGENTS.md — Warhammer_DLP_Helper (transition layout)
|
|
|
|
This repo is mid-transition. **The `main` branch still carries the original
|
|
flat python layout** — read `version-python/AGENTS.md` there (and on this
|
|
branch at `version-python/AGENTS.md`) for the full project rules: secrets,
|
|
failure policy, idempotency, rate limiting, testing. Those rules still apply.
|
|
|
|
## Layout on this branch (`version-rust`)
|
|
|
|
- `version-python/` — the existing, working python tooling, moved here with
|
|
`git mv` (history preserved). All rules and path references in its
|
|
`AGENTS.md` resolve relative to `version-python/`.
|
|
- `version-rust/` — the Rust rewrite (cargo project) that will eventually
|
|
replace the python version. See `version-rust/README.md` for the port plan
|
|
and crate choices.
|
|
|
|
## Transition rules
|
|
|
|
1. Python fixes go into `version-python/` on `main` (flat layout there) and
|
|
are merged into `version-python/` here; never fork the logic in two
|
|
places.
|
|
2. The Rust version must stay compatible with the run artifacts
|
|
(`state.json`, `manifest.jsonl`, `~/.local/share/dlphelper/urls.json`) —
|
|
schemas are the contract.
|
|
3. `data/gwshop_catalog.json` (committed snapshot) is shared; the sorter in
|
|
both versions must be able to read the same catalog schema.
|