This page mirrors avvy-worker/docs/projection-model-signoff-sop.md. The repo is canonical — update there first, then resync here.
This checklist exists to prevent false "issue resolved" claims for projection-model pipeline changes (model.projection.step.v1 and model.projection.model.v1 — see signed callbacks).
- Do not mark a projection-model issue as resolved based only on synthetic comparator or validation tests.
- A fix is not signed off unless at least one regression test enters through the same production-shaped path that failed in the issue.
- The final report must state exactly which code path was exercised and which test command proved it.
- If the fix changes input handling, conversion, or callback validation, each touched stage needs its own proof.
For any bug involving provider model artifacts, ZIP bundles, sidecars, or canonical selection, the regression set must cover:
- ZIP extraction keeps canonical bundle-relative paths intact.
- ZIP extraction rejects unsafe paths such as absolute paths and
../ escapes.
- ZIP candidate inspection for OBJ bundles with parent-relative sidecars.
- ZIP candidate inspection for glTF bundles with external sidecars.
- ZIP candidate inspection for glTF bundles with embedded data URIs.
- Malformed ZIP candidate input fails loudly and deterministically.
- Canonical selection prefers textured candidates over textureless candidates.
- Canonical selection tie-breakers remain deterministic.
- Runtime importer / converter path succeeds for in-memory sidecar bundles without local temp files.
- Canonical GLB inspection and preview generation still run on the produced output.
¶ Required Sign-Off Commands
At minimum, sign-off must include the exact commands used for the touched path, for example:
go test ./cmd/avvy-worker
go test ./blenderproc
If a narrower command is used during iteration, the final sign-off still requires the broader package-level run for every touched package.
The close-out must explicitly answer:
- What exact failing path from the issue is now covered by regression tests?
- Which new tests prove the fix?
- Which commands were run successfully?
- What is still not covered?
If item 4 is non-empty, the issue must not be described as fully resolved.
avvy-worker architecture.
Signed callbacks.
JS SDK: Model Processing.
gitlab.avvyland.com/avvy/avvy-worker — docs/projection-model-signoff-sop.md.