Functional specification

Personas

PersonaNeedFeature
Embedded / IoT engineerKnow early if a model can possibly fit a targetcheck, plan, audit
Mobile ML developerCompare FP32 vs INT8 honestlybenchmark, compare
Tech lead / reviewerA one-page decision recordaudit HTML/MD
CI maintainerFail the build on incompatibilityexit code 1
AI-IDE userReusable review rolesinstall --ide …

Functional requirements

IDRequirementStatus
F-01Read ONNX protobuf metadata (operators, opsets, node count, SHA-256) without execution; reject >32 MiB, malformed, truncated, symlinkedImplemented, tested
F-02Validate model/device/runtime manifests and report per-check pass/fail/unknownImplemented, tested
F-03Produce a non-executing conversion plan with manifest fingerprintsImplemented, tested
F-04Run a deterministic toy FP32 vs simulated INT8 benchmark on the host with p50/p95, CPU time and post-run RSSImplemented, tested
F-05Refuse to compare benchmarks with different workloads/hosts (NOT_COMPARABLE)Implemented, tested
F-06Seal every artifact with SHA-256 integrity; verify recomputes itImplemented, tested
F-07Render reports as Markdown and HTML with identical content; HTML must escape all external textImplemented, tested
F-08audit writes JSON+MD+HTML, artifacts and SHA256SUMS.txt; verdict BLOCKED or REVIEW_REQUIRED onlyImplemented, tested
F-09Install 20 skills into 7 IDE conventions without overwrite or symlink traversalImplemented, tested
F-10Serve reports read-only on 127.0.0.1 with bearer authImplemented, tested
F-11Run real ONNX Runtime inferenceNot implemented
F-12Run on a physical device / measure energyNot implemented

Verdict logic

  1. Any failed static check → BLOCKED (exit 1).
  2. Otherwise → REVIEW_REQUIRED (exit 0): device execution is always NOT_RUN today.
  3. GO_CANDIDATE requires verified on-device evidence and human sign-off. Unreachable in this release by design.

Non-functional requirements

Node ≥ 22; no dependencies; deterministic outputs for identical inputs (except timestamps and timings); reports < 1 MB; all file inputs size-capped.