# LEN-0200 — Interface Contract Lens

## Ontology Metadata

Code: LEN-0200
Version: LEN-0200@0.1.0
Ontology release: 0.1.0
Updated: 2026-05-10T00:00:00Z
Canonical URL: /workbench/lenses/interface-contract-lens/

## Summary

Compares declared interface structure to observed runtime structure to detect contract deviations.

## Primary Pattern Matches

- PAT-0150 — Interface Mismatch
  - URL: /workbench/patterns/interface-mismatch/
  - Summary: A structural condition where observed interface behavior, shape, or exchange differs from the declared interface contract.
- PAT-0160 — Schema Breakage
  - URL: /workbench/patterns/schema-breakage/
  - Summary: A structural condition where an instance, graph, payload, or object violates the type, shape, or rule requirements of a declared schema.

## Secondary Pattern Matches

- PAT-0130 — Incomplete Declaration
  - URL: /workbench/patterns/incomplete-declaration/
  - Summary: A structural condition where an element is declared but required attributes, dependencies, or linked definitions are missing.
- PAT-0330 — Invariant Breakage
  - URL: /workbench/patterns/invariant-breakage/
  - Summary: A structural condition where an observed state violates a declared invariant that is supposed to remain true.

## Related Issues

- ISS-0087 — Agent Cannot Choose Tool Without Tool Result
  - URL: /workbench/issues/agent-cannot-choose-tool-without-tool-result/
  - Summary: The agent needs a tool result to choose the right tool, but cannot obtain that result without choosing a tool first.
- ISS-0115 — Agent Gets Conflicting Tool Authority
  - URL: /workbench/issues/agent-gets-conflicting-tool-authority/
  - Summary: An agent receives conflicting authority signals about whether, when, or how it may use a tool, connector, function, or integration.
- ISS-0026 — AI Output Breaks Parser
  - URL: /workbench/issues/ai-output-breaks-parser/
  - Summary: The AI output causes a parser, validator, importer, or structured-output consumer to fail.
- ISS-0002 — Answer Has No Traceable Source Link
  - URL: /workbench/issues/answer-has-no-traceable-source-link/
  - Summary: The answer makes a claim, recommendation, citation, or factual statement without a source link or trace path that allows the user to verify where it came from.
- ISS-0003 — Citation Points to Wrong Source
  - URL: /workbench/issues/citation-points-to-wrong-source/
  - Summary: A citation, reference, link, or source pointer is present, but it points to the wrong source, wrong passage, wrong document, or unsupported evidence.
- ISS-0077 — Diagnostic Area Has No Coverage
  - URL: /workbench/issues/diagnostic-area-has-no-coverage/
  - Summary: A known diagnostic area, failure mode, requirement, or review dimension has no Issue, check, rubric item, or workflow coverage.
- ISS-0097 — Downstream Steps Magnify Hallucinated Claim
  - URL: /workbench/issues/downstream-steps-magnify-hallucinated-claim/
  - Summary: A hallucinated or unsupported claim from an AI output is reused by later workflow steps until it becomes more influential than the evidence supports.
- ISS-0027 — Duplicate Fields With Same Meaning
  - URL: /workbench/issues/duplicate-fields-with-same-meaning/
  - Summary: The AI returns multiple fields, labels, sections, or structured elements that carry the same meaning and create ambiguity about which one should be used.
- ISS-0066 — Duplicate Output Sections
  - URL: /workbench/issues/duplicate-output-sections/
  - Summary: The AI repeats sections, headings, blocks, or output areas in a way that creates redundancy, confusion, or downstream handling problems.
- ISS-0081 — Evaluation Rubric Has Coverage Gap
  - URL: /workbench/issues/evaluation-rubric-has-coverage-gap/
  - Summary: An evaluation rubric, grading standard, or review checklist leaves part of the required evaluation space uncovered.
- ISS-0014 — Fallback Authority Is Missing
  - URL: /workbench/issues/fallback-authority-is-missing/
  - Summary: The system does not declare who or what has authority when the primary owner, rule, tool, source, or decision path is unavailable or inconclusive.
- ISS-0028 — Format Rule Too Weak
  - URL: /workbench/issues/format-rule-too-weak/
  - Summary: The format instruction is too vague, incomplete, or optional to reliably produce output that satisfies the expected structure.
- ISS-0023 — Hallucinated Fields
  - URL: /workbench/issues/hallucinated-fields/
  - Summary: The AI adds fields, keys, attributes, columns, or structured elements that were not declared, requested, or allowed by the expected schema.
- ISS-0021 — Invalid JSON Output
  - URL: /workbench/issues/invalid-json-output/
  - Summary: The AI returns malformed JSON or structured output that cannot be parsed.
- ISS-0074 — Missing Fallback for Unavailable Information
  - URL: /workbench/issues/missing-fallback-for-unavailable-information/
  - Summary: The task does not declare what the AI should do when required information, sources, tools, fields, or evidence are unavailable.
- ISS-0022 — Missing Required Fields
  - URL: /workbench/issues/missing-required-fields/
  - Summary: The AI returns structured output that omits fields required by the schema, workflow, parser, form, or downstream consumer.
- ISS-0038 — Model and Workflow Disagree on Next Step
  - URL: /workbench/issues/model-and-workflow-disagree-on-next-step/
  - Summary: The AI model recommends or selects a next step that conflicts with the workflow state, required handoff, routing rule, or process sequence.
- ISS-0025 — Nested Fields Do Not Match
  - URL: /workbench/issues/nested-fields-do-not-match/
  - Summary: The AI returns nested structured fields whose internal shape, hierarchy, parent-child relationship, or contained values do not match the expected structure.
- ISS-0018 — Output Breaks the Next Step
  - URL: /workbench/issues/output-breaks-the-next-step/
  - Summary: The AI output looks acceptable by itself but cannot be used by the next tool, workflow step, parser, reviewer, or downstream consumer.
- ISS-0079 — Policy Area Has No Examples
  - URL: /workbench/issues/policy-area-has-no-examples/
  - Summary: A policy, rule, standard, or guidance area has no examples showing how it should apply to real cases.
- ISS-0090 — Policy Decision Depends on Itself
  - URL: /workbench/issues/policy-decision-depends-on-itself/
  - Summary: A policy decision requires the outcome of the same policy decision before it can be made.
- ISS-0054 — Prompt Changed but Workflow Did Not
  - URL: /workbench/issues/prompt-changed-but-workflow-did-not/
  - Summary: A prompt changes but the workflow, parser, review step, routing rule, or downstream expectation still assumes the old prompt behavior.
- ISS-0080 — Relationship Map Has Missing Links
  - URL: /workbench/issues/relationship-map-has-missing-links/
  - Summary: A map of related Issues, rules, patterns, cases, fields, tools, or workflow steps is missing links needed to navigate or reason over the structure.
- ISS-0075 — Review Rubric Missing Required Criteria
  - URL: /workbench/issues/review-rubric-missing-required-criteria/
  - Summary: A review rubric, grading rule, evaluation checklist, or classification standard lacks criteria required to make the review reliable.
- ISS-0057 — Same Contract Name Has Different Meanings
  - URL: /workbench/issues/same-contract-name-has-different-meanings/
  - Summary: The same prompt, schema, field, policy, tool, or workflow contract name is used in different places with different meanings.
- ISS-0033 — Saved Memory Not Used
  - URL: /workbench/issues/saved-memory-not-used/
  - Summary: A saved memory, preference, instruction, or durable context item exists but does not affect the AI output when it should.
- ISS-0091 — Schema Reference Loops Without Base Case
  - URL: /workbench/issues/schema-reference-loops-without-base-case/
  - Summary: A schema, field, type, object, or structured reference points through a loop without a base case that allows validation or interpretation to resolve.
- ISS-0107 — Single Field Carries Too Many Obligations
  - URL: /workbench/issues/single-field-carries-too-many-obligations/
  - Summary: One field, label, score, status, or structured value is expected to carry too many meanings, decisions, or workflow obligations.
- ISS-0011 — Task Has No Clear Limit
  - URL: /workbench/issues/task-has-no-clear-limit/
  - Summary: The task does not declare where the AI should stop, what is out of scope, or what counts as enough work.
- ISS-0017 — Tool Call Contract Mismatch
  - URL: /workbench/issues/tool-call-contract-mismatch/
  - Summary: The AI or agent calls a tool with names, arguments, types, modes, or shapes that do not match the declared tool interface.
- ISS-0108 — Tool Can Act Without Responsible Authority
  - URL: /workbench/issues/tool-can-act-without-responsible-authority/
  - Summary: A tool, connector, function, or integration can perform an action without a declared responsible authority for that action.
- ISS-0020 — Tool Exists but Required Inputs Are Missing
  - URL: /workbench/issues/tool-exists-but-required-inputs-are-missing/
  - Summary: A usable tool or integration exists, but the AI or agent does not have the required inputs, permissions, fields, identifiers, or context needed to call it correctly.
- ISS-0019 — Tool Result Not Integrated Correctly
  - URL: /workbench/issues/tool-result-not-integrated-correctly/
  - Summary: The AI receives a tool result but misreads, ignores, overwrites, misplaces, or fails to incorporate it correctly into the final output or workflow state.
- ISS-0110 — Tool Rules and Prompt Rules Conflict
  - URL: /workbench/issues/tool-rules-and-prompt-rules-conflict/
  - Summary: Tool, connector, function, or MCP rules conflict with prompt instructions, causing the AI or agent to face incompatible requirements.
- ISS-0006 — Validation Result Changes on Retry
  - URL: /workbench/issues/validation-result-changes-on-retry/
  - Summary: A validation, grading, review, classification, or pass/fail result changes after retry even though the input and declared validation rules did not change.
- ISS-0078 — Workflow Stage Has Too Few Checks
  - URL: /workbench/issues/workflow-stage-has-too-few-checks/
  - Summary: A workflow stage lacks enough checks, gates, criteria, or review conditions to safely support the work it controls.
- ISS-0013 — Workflow Step Has No Decision Owner
  - URL: /workbench/issues/workflow-step-has-no-decision-owner/
  - Summary: A workflow step requires a decision, approval, judgment, or routing choice, but no owner is declared for making it.
- ISS-0073 — Workflow Step Lacks Required Conditions
  - URL: /workbench/issues/workflow-step-lacks-required-conditions/
  - Summary: A workflow step can run, route, approve, reject, or continue without the required conditions being declared or checked.
- ISS-0024 — Wrong Field Types
  - URL: /workbench/issues/wrong-field-types/
  - Summary: The AI returns fields with values whose types do not match the expected schema, such as strings where numbers, booleans, arrays, objects, or enums are required.
