Skip to content

docs(8): report job-definition schema coverage holes#9

Merged
alanbchristie merged 1 commit into
mainfrom
squonk2-jobs_abc-8-schema-holes
Jul 16, 2026
Merged

docs(8): report job-definition schema coverage holes#9
alanbchristie merged 1 commit into
mainfrom
squonk2-jobs_abc-8-schema-holes

Conversation

@claude-im

Copy link
Copy Markdown
Collaborator

Fixes #8

Inspects all 18 deployed Job Definition files against the decoder's
job-definition-schema.yaml and reports where the schema does not explicitly
cover their content. Deliverable is a report only — no schema or job-file
changes (schema changes belong in the squonk2-data-manager-job-decoder
submodule).

Findings

17 of 18 files fully conform. Every hole comes from
virtual-screening/data-manager/moldb.yaml, but each exposes a real gap:

  1. Top-level object lacks additionalProperties: falserepository-url /
    repository-tag pass silently (modelled nowhere).
  2. job object lacks additionalProperties: falseoptions: placed
    directly on moldb-count-rows (should be under variables:) is silently
    ignored.
  3. Option properties use minValue / maxValue, which the schema does not
    model (it has minimum / maximum) — the only case that actually fails
    validation (9 errors).
  4. Latent: checks, test-checks-output and the value-from inner objects
    share the same silent-hole pattern.

Changes

  • docs/schema-coverage.md — the report (method, holes table, details,
    recommended schema extensions, reproducible validation script + output).
  • docs/README.md — links the new document from the Contents table.

🤖 Generated with Claude Code

Inspect all 18 Job Definition files against the decoder schema and
document where the schema does not explicitly cover their content:
- top-level and `job` objects lack `additionalProperties: false`, so
  unknown keys (repository-url/tag, misplaced options) pass silently
- option properties use unmodelled `minValue`/`maxValue` (hard fail)
- several other objects share the same silent-hole pattern

Report only; schema changes belong in the decoder submodule.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@claude-im claude-im mentioned this pull request Jul 16, 2026
@alanbchristie
alanbchristie merged commit 241f229 into main Jul 16, 2026
5 of 6 checks passed
@alanbchristie
alanbchristie deleted the squonk2-jobs_abc-8-schema-holes branch July 16, 2026 16:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Find holes in the schema

2 participants