S06.3 — Deliver the strict real-artifact demonstration

Planning / historicaltaskdelivery

Historical

Planning material. It summarizes and links to the authoritative specification and the current measured state — it does not replace either, and it is not current engineering truth.

Migration identity#

Canonical identifier: S06.3 (GitHub issue type: subtask).
Legacy identifier: C06.3 (retained as old_identifier).
Parent epic: E06.
Milestone: M1 — IntentGuard Weekend MVP.

Objective#

Provide make demo and concise instructions that exercise health, accepted, abstained, and malformed cases through the running real-artifact API.

Rationale#

The demo is the observable end-to-end proof for a reviewer and must not conceal a mock.

Parent identifier#

E06.

Source task#

T-006.

Traceability#

Primary: AC-013. Secondary: FR-006, FR-007, NFR-010.

Prerequisites#

C06.2 real service passes; a valid U04 artifact path is configured; demo cases are reviewed.

Likely files#

Makefile, scripts/demo.py, docs/OPERATIONS.md, tests/integration/test_api.py.

Implementation boundary#

Local repeatable demonstration against a running FastAPI service and real loaded artifact.

MUST scope#

Preflight health/artifact check, deterministic cases, clear output, non-zero failures, five-minute documented flow.

Explicit non-goals#

Mock predictor, recorded fake response, frontend, deployment, benchmark load, or optional chart.

Acceptance criteria#

Demo refuses mock/degraded/unready service, identifies the artifact, shows all required cases, and completes from documented commands in five minutes excluding first-time downloads/training.

Validation commands#

make serve in one terminal, then make demo; API integration tests run separately.

Expected evidence#

Artifact-tagged demo transcript/output and documented reproducible steps.

Fallback and status consequence#

Mocked demo is Mocked and cannot satisfy AC-013 or strict MVP.

Stop condition#

Stop for missing/unready artifact, response-contract mismatch, hidden manual step, or output sourced from a deterministic predictor.

Definition of ready#

Real-artifact API is Implemented and demo inputs/expected status categories are stable.

Definition of done#

AC-013 passes with captured evidence from the real loaded transformer artifact.

Labels#

type:subtask, priority:MUST, area:api

Estimate#

0.5 hour.