Guth
NewsDocs
Page actions
View as Markdown ↗
Explore MCP tools ↗

instrument implementation / implementation-contract

Color Code Converter implementation

A source-bound implementation contract for Color Code Converter; deployment and executable qualification remain separate.

Status: VERIFIED_WITH_ERRATALifecycle: implementation-contract

Binding contract

This record describes what an executable surface must bind and validate. It does not claim that a public calculator, package, or production route is deployed.

Record owner
Guth Instruments
Lifecycle
verified-with-binding-errata
Evidence ID
t4-196
Effect
Computation or source lookup only

Input and validation requirements

Achromatic colors such as black produce zero denominators in the general HSL/HSV hue and saturation formulas and, for black, in the usual CMYK secondary-channel formulas. The converter must use special cases and expose hue as undefined; a numeric hue or an unhandled division would be a break.

Required corrections

[
  {
    "vector": 1,
    "field": "hsl.s",
    "wrong": 66.6667,
    "correct": 50,
    "cause": "copied HSV saturation into HSL field; her v4 HSL saturation is correct"
  }
]

Inspectable interface fixture

The sample below is evidence for interface and validation tests, not a production implementation.

{
  "inputs": {
    "hex": "#336699"
  },
  "expected_outputs": {
    "hex": "#336699",
    "rgb": {
      "r": 51,
      "g": 102,
      "b": 153
    },
    "rgba": {
      "r": 51,
      "g": 102,
      "b": 153,
      "a": 1
    },
    "hsl": {
      "h": 210,
      "s": 66.6667,
      "l": 40
    },
    "hsv": {
      "h": 210,
      "s": 66.6667,
      "v": 60
    },
    "cmyk": {
      "c": 66.6667,
      "m": 33.3333,
      "y": 0,
      "k": 40
    }
  },
  "working": "Normalize RGB: r=51/255=0.2, g=102/255=0.4, b=153/255=0.6. max=0.6, min=0.2, d=0.4. HSL: l=(0.6+0.2)/2=0.4; s=0.4/(1-|2(0.4)-1|)=0.4/0.6=0.666667=66.6667%; b is maximum, so h=60[((r-g)/d)+4]=60[((0.2-0.4)/0.4)+4]=60(3.5)=210°. HSV: v=0.6=60%; s=d/v=0.4/0.6=0.666667=66.6667%; h=210°. CMYK: k=1-max=1-0.6=0.4=40%; c=(1-0.2-0.4)/(1-0.4)=0.4/0.6=0.666667=66.6667%; m=(1-0.4-0.4)/0.6=0.2/0.6=0.333333=33.3333%; y=(1-0.6-0.4)/0.6=0."
}

Other records

Sources and evidence

These pointers bind the page to evidence. They do not grant authority or collapse verification into deployment.

  • VERIFIED_LEDGER.json
  • evidence-tranche4/tranche4-results.json
  • tranche errata record