forked from ccf-ai-infra/TileOPs-Metax
c986df5407
## Summary
- Remove over-engineered pool hooks and private snapshot tests; make
indexed max-pool forwards explicit.
- Deduplicate GLA, Mamba, and formula tests; remove dead helpers,
commented benchmark rows, and process metadata.
- Consolidate benchmarks onto manifest workloads and
`ManifestBenchmark`; delete obsolete benchmark modules and factor
redundant sweep axes.
- Require implemented ops to declare `kernel_map` and manifest-driven
benchmark coverage, filling the corresponding manifest gaps.
- Reduce the repository by 2,415 net lines without changing runtime
operator behavior.
## Test plan
- [x] pre-commit passed
- [x] Pool tests passed: 246
- [x] Perf/formula and validator tests passed: 128
- [x] Changed benchmark modules collected: 538 nodes
- [x] Test node delta: 476 → 391 (-85)
- [x] `python scripts/validate_manifest.py --strict` passed
---------
Co-authored-by: Ibuki 🍃 — a wind born from GPTs <Ibuki-wind@users.noreply.github.com>
|
||
|---|---|---|
| .. | ||
| design | ||
| perf | ||
| README.md | ||
| known-issues.md | ||
| tileops-skills.md | ||
README.md
TileOPs Documentation
Design-first, spec-driven documentation for TileOPs. tileops/manifest/ and the documents below are the authoritative spec; code conforms to the spec, not the other way around.
Design
| Document | Scope |
|---|---|
| architecture.md | System modules (M1–M8), data flow, agent production loop, directory structure. |
| manifest.md | tileops/manifest/ spec: signature, workloads, roofline fields, source. |
| ops-design.md | Op interface execution guide — how to add a new op. |
| ops-design-reference.md | Op interface detail reference: interface tables, codegen, naming, protocol. |
| roofline.md | tileops/manifest/ roofline field spec: performance model, authoring, and per-consumer contracts (validator, benchmark, M5, op codegen). |
Process
| Document | Scope |
|---|---|
| trust-model.md | Trust boundaries between manifest → test → implementation → benchmark; workloads layer contract. |
| testing.md | Test and benchmark framework: core abstractions, tolerances, reporting rules. |
| tileops-skills.md | Developer decision guide: which repo-provided skill to use for which task, with composition diagram. |
Performance Guides
Empirical performance guidance lives under perf/. Each op category has a checklist plus the evidence backing it.
- perf/elementwise.md — elementwise kernel performance checklist
- perf/elementwise-evidence.md — reasoning and measurements
External
- TileOPs.github.io — auto-generated documentation site (API reference, perf tables, support matrix).