@12ui/design 0.2.13 → 0.2.15

package/skills/design/references/selection-contract.md

@@ -1,112 +0,0 @@
-# Selection evidence contract
-
-Write `selection.json` before conversion. Use absolute image paths and exact
-prompt text so a resumed run cannot silently select different evidence.
-
-```json
-{
-  "version": 6,
-  "createdAt": "<ISO-8601>",
-  "requestSummary": "<concise implementation contract>",
-  "viewportMode": "<first-viewport|primary-state|single-screen|complete-simple-surface>",
-  "designMode": "<new-interface|exploratory-redesign|structure-preserving-reskin>",
-  "redesignSource": {
-    "originalPath": "<absolute source path, or null when absent>",
-    "originalSha256": "<source sha256, or null when absent>",
-    "preparedPath": "<absolute crop or original path, or null when absent>",
-    "preparedSha256": "<prepared sha256, or null when absent>",
-    "preparation": "<none|first-viewport-crop>"
-  },
-  "contract": {
-    "preserve": ["<specific constraint>"],
-    "change": ["<specific intended change>"]
-  },
-  "referencePolicy": {
-    "retrieval": "<text-only|text-and-redesign-source>",
-    "generation": "<one-corpus-image-per-candidate|redesign-source-only>",
-    "imagesPerGeneration": 1
-  },
-  "corpus": {
-    "query": "<exact query>",
-    "mode": "<direct|balanced|adventurer>",
-    "fallback": null,
-    "idempotencyKey": "<manifest value>",
-    "setId": "<manifest value>",
-    "references": [
-      {
-        "id": "<id-1>",
-        "path": "<absolute path>",
-        "sha256": "<sha256>",
-        "aspect": "<portrait|landscape|square>"
-      }
-    ]
-  },
-  "generation": {
-    "referenceMode": "<inspiration|preserve-structure>",
-    "manifestPath": "<absolute generation manifest path>",
-    "manifestSha256": "<sha256>",
-    "batchAttemptPath": "<absolute batch attempt path>"
-  },
-  "candidates": [
-    {
-      "id": "A",
-      "path": "<absolute PNG path>",
-      "sha256": "<sha256>",
-      "prompt": "<exact prompt>",
-      "promptSha256": "<sha256>",
-      "directionReferenceId": "<paired corpus id-1>",
-      "direction": "<short visibly grounded text direction>",
-      "generationReferencePath": "<paired corpus path or redesign-source path>",
-      "generationReferenceSha256": "<sha256>",
-      "referenceMode": "<inspiration|preserve-structure>",
-      "provider": "<codex|openai>",
-      "idempotencyKey": "<stable key>",
-      "providerIdempotencyEnforced": false,
-      "attemptEvidencePath": "<absolute attempt path>",
-      "rejectionReasons": []
-    }
-  ],
-  "recommendation": {
-    "candidateId": "<recommended candidate id, or null when the run indicated none>",
-    "source": "<where the recommendation came from, or null>"
-  },
-  "winner": "A",
-  "selectionSource": "<recommended|override|no-recommendation>",
-  "selectionOverrideReason": "<why the recommendation was not followed, or null>",
-  "rationale": "<visible, brief-specific rationale>"
-}
-```
-
-Include exactly four corpus references and candidates in endpoint order: A/1,
-B/2, C/3, D/4. Copy the corpus mode and reference evidence from
-`manifest.json`, and generation fields from the batch and candidate attempt
-files. Never store credentials or invent IDs or provider guarantees. The winner
-has no rejection reasons; every other candidate has at least one specific
-visible reason. Set `providerIdempotencyEnforced` only to the recorded CLI
-value.
-
-Set `selectionSource` to `recommended` when the winner is the recommended
-candidate, `override` when it is not, and `no-recommendation` when the run
-indicated none. Use null `recommendation` fields in that last case. An
-`override` requires a specific `selectionOverrideReason` — an explicit user
-preference, a brief or steering directive the recommendation could not see, or a
-named visible defect in the recommended candidate — and keeps
-`selectionOverrideReason` null in every other case. A flow that also writes
-`design-run.json` records the same pair there, the reason under
-`selection_override_reason`.
-
-Keep `corpus.fallback` null for the recommended Balanced result. If Direct or
-Adventurer was used after a complete Balanced set failed the brief, replace it
-with `{ "fromMode": "balanced", "reason": "<visible failure>",
-"manifestPath": "<prior absolute manifest path>", "manifestSha256":
-"<sha256>" }`. Do not record a transport or download failure as a mode fallback.
-
-For `new-interface`, use null redesign-source paths/hashes, `text-only` retrieval, and one
-paired corpus image per generation. For `exploratory-redesign`, record the
-original and prepared source for retrieval but still use one paired corpus
-image per generation. For `structure-preserving-reskin`, use the prepared
-redesign source as the sole generation
-image for all four candidates; each paired corpus image is represented only by
-its short textual `direction`. Never attach the redesign source and a corpus
-image to the same generation. Use `inspiration` reference mode for the first two
-cases and `preserve-structure` for the last.