@12ui/design 0.2.12 → 0.2.14

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

@@ -1,96 +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": []
-    }
-  ],
-  "winner": "A",
-  "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.
-
-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.