vision.threshold.sweep.v1
Overview
Verify that the Forge runtime executes the canonical Threshold Sweep Primitive Profile using the production Media execution kernel.
After completing this example you should be able to:
- execute the canonical Media profile
- inspect threshold exploration results
- verify generated artifacts
- validate deterministic replay
- understand the execution contract
This document verifies Media execution.
It does not evaluate computer vision models or image classification accuracy.
Primitive Profile
| Property | Value |
|---|---|
| Primitive | media@1 |
| Profile | vision.threshold.sweep.v1 |
| Runtime | Compute |
| Replay | Supported |
| Artifacts | Supported |
| Deterministic | Supported |
| CPU | Supported |
| GPU | Optional |
Capability
vision.threshold.sweep.v1 performs deterministic threshold exploration over a supplied media asset.
Instead of producing a single transformed image, the Media kernel evaluates a defined threshold space and generates reproducible outputs for each valid processing point.
The objective is to expose processing behaviour across a controlled parameter range rather than optimize or interpret image content.
The transformation pipeline remains fully deterministic under the canonical execution contract.
Canonical Contract
Execution uses the canonical Forge Media execution contract.
Primitive
media
Version
1
Profile
vision.threshold.sweep.v1Requests are validated before entering the execution runtime.
The canonical payload contains:
op.name
op.version
op.profile
argsOptional execution metadata may include:
ctx
seed
policyRequired Inputs
The canonical execution contract requires:
- source asset
- threshold configuration
- execution parameters
Execution begins only after successful canonical validation.
Optional Inputs
Depending on execution policy, optional inputs may include:
- threshold range
- threshold step
- output format
- preprocessing configuration
- execution evidence
- replay configuration
Only profile-supported fields should be supplied.
Unsupported fields are rejected during validation.
Canonical Smoke
The maintained Media smoke verifies:
- successful profile resolution
- canonical validation
- deterministic threshold execution
- runtime evidence generation
- replay metadata generation
- artifact availability
The maintained Smoke Suite remains the canonical executable source.
Verification Expectations
A successful execution should demonstrate:
- canonical validation succeeds
- threshold exploration completes
- derived artifacts are generated
- execution metadata is produced
- replay metadata is available
- runtime evidence is inspectable
Verification includes inspection of both the generated artifacts and the execution process that produced them.
Runtime Evidence
Successful execution exposes runtime evidence including:
- execution identifier
- primitive profile
- execution metadata
- threshold summary
- generated artifact count
- processing summary
- replay metadata
- artifact references
The exact evidence surface depends on execution policy.
Replay
Replay should reproduce identical threshold exploration when executed using the same execution contract, source asset, threshold configuration, runtime version, and deterministic seed where applicable.
Replay validates the determinism of the Media kernel rather than infrastructure identity.
Replay verification is described in:
→ /verification/replay-determinism
Artifacts
Typical execution artifacts include:
- threshold outputs
- processing summary
- execution report
- replay metadata
Artifacts provide observable evidence explaining how the Media kernel generated each derived output.
Applied Intelligence Modules
This Primitive Profile is reused across multiple Forge Intelligence Modules requiring deterministic media preprocessing, parameter exploration, and reproducible asset transformation.
The execution primitive remains identical while the Primitive Profile defines media-specific processing semantics.
Related Documentation
Verification Checklist
| Verification Surface | Status |
|---|---|
| Primitive resolved | ✓ |
| Contract validated | ✓ |
| Threshold sweep completed | ✓ |
| Runtime inspected | ✓ |
| Artifacts inspected | ✓ |
| Replay verified | ✓ |
| Negative validation tested | ✓ |
Final Principle
vision.threshold.sweep.v1 verifies a versioned Media Primitive Profile rather than a thresholding algorithm.
Its correctness is demonstrated through deterministic media transformation, observable runtime evidence, replay, and artifact inspection, allowing independent evaluators to reproduce the same parameter exploration workflow using the canonical execution contract.
Continue in Forge Studio
This document describes the canonical execution contract for this capability.
The Forge documentation explains how this capability works.
Forge Studio allows you to inspect, execute, and verify the live implementation.
Capability Explorer
Browse the live capability catalog, supported execution surfaces, available Primitive Profiles, and execution metadata.
→ https://studio.forgepool.io/capability-explorer
Block Registry
Inspect the registered Primitive Profile, execution contract, block metadata, adapters, versions, and runtime characteristics.
→ https://studio.forgepool.io/studio/blocks-registry
Execute
Execute this capability using Forge Studio, the Execution API, or an MCP-compatible client.
Verify
Before interpreting the result, inspect:
- runtime evidence
- generated artifacts
- deterministic replay
- execution metadata
Trust should be established through independent verification rather than documentation alone.