40 lines
2.3 KiB
Markdown
40 lines
2.3 KiB
Markdown
# Neutron GamePort
|
|
|
|
Follow `../AGENTS.md` and `../prompt.MD`. This is the local Git repository.
|
|
Do not configure a remote, push, upload originals or use cloud CI.
|
|
Originals are in `../Original/` and must remain byte-identical; verify using
|
|
`python3 tools/recon/inventory.py ../Original --verify docs/original-manifest.json`.
|
|
|
|
Use .NET 10, Silk.NET.Vulkan Vulkan 1.3+, SDL3 and shared Linux/Windows x64 code.
|
|
Keep recovered data/algorithms distinct from unverified approximations. Require
|
|
runtime evidence before claiming working gameplay or platform compatibility.
|
|
|
|
## Working map
|
|
- `src/GamePort/`: runtime, platform, rendering, assets and game systems.
|
|
- `tools/`: Python analysis/extraction tools (stdlib where practical).
|
|
- `tests/`: original-data regressions and bounded parser tests.
|
|
- `scripts/`: local dependency, build, test and packaging entry points.
|
|
- `docs/`: durable evidence and continuation notes.
|
|
- `.tools/`, `.nuget/`, `artifacts/`, `dist/`: ignored local generated data.
|
|
|
|
Build from this directory with `dotnet build`, `dotnet run`; project-local SDK
|
|
may require `scripts/dotnet.sh` (consult README for verified invocation).
|
|
Python tests: `python3 -m unittest discover -s tests -v`.
|
|
Local builds: `scripts/build-linux.sh`, `scripts/build-windows.sh`;
|
|
tests: `scripts/test.sh`; packages: `scripts/package.sh`.
|
|
|
|
## Coordination
|
|
Native subagents supported, max three investigators alongside primary. Explicit
|
|
exclusive file ownership; primary reviews, integrates, tests and commits milestones.
|
|
Binary agent: `tools/binary/`, binary/graphics analysis. Asset agent: extractors,
|
|
asset/format docs, extractor tests. Infrastructure agent: runtime/build scripts and
|
|
infrastructure report. Primary: GAM loader, gameplay/recon/docs and integration.
|
|
Coordinate any ownership transfer before editing shared files. No agent commits
|
|
other agents' active changes. Keep updates concise, save detailed evidence to disk.
|
|
|
|
Use bounded endian-aware parsers, portable paths, clear C#, deterministic tests,
|
|
and explicit unmanaged ownership. Build frequently. Update `docs/progress.md`,
|
|
`docs/tasks.md`, `docs/decisions.md`, and compatibility evidence before transitions.
|
|
Current priority is exact asset recovery and one reconstructed original scene;
|
|
read those documents for actual completion status and next actions.
|