{"record":{"id":"5a3069ed23b411a0","repo":"pbakaus/impeccable","slug":"concept-seed-mode-must-be-persuade-operate-re-5a3069","errorCode":null,"errorMessage":"concept-seed: --mode must be persuade, operate, read, or experience","messagePattern":"concept-seed: --mode must be persuade, operate, read, or experience","errorType":"validation","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"skill/scripts/concept-seed.mjs","lineNumber":322,"sourceCode":"  _resolvedData = undefined,\n} = {}) {\n  if (scope !== 'surface' && scope !== 'direction') {\n    throw new Error('concept-seed: --scope must be direction or surface');\n  }\n  if (!Number.isInteger(reroll) || reroll < 0) {\n    throw new Error('concept-seed: --reroll must be a non-negative integer');\n  }\n  if (register !== null && register !== 'safer' && register !== 'bolder') {\n    throw new Error('concept-seed: --register must be safer or bolder');\n  }\n  if (register !== null && reroll < 1) {\n    throw new Error('concept-seed: --register steers a re-roll round; pass --reroll <n> with it');\n  }\n  if (register !== null && scope !== 'direction') {\n    throw new Error('concept-seed: --register applies to direction rounds only');\n  }\n  if (mode !== null && !SEED_MODES.has(mode)) {\n    throw new Error('concept-seed: --mode must be persuade, operate, read, or experience');\n  }\n  // Grain needs no mode: how much of the product is in play is independent of\n  // which register of work it is.\n  if (grain !== null && !COMPOSITION_GRAINS.includes(grain)) {\n    throw new Error(`concept-seed: --grain must be one of ${COMPOSITION_GRAINS.join(', ')}`);\n  }\n  if (platform !== null && !COMPOSITION_PLATFORMS.includes(platform)) {\n    throw new Error(`concept-seed: --platform must be one of ${COMPOSITION_PLATFORMS.join(', ')}`);\n  }\n  if (!Number.isInteger(candidateCount) || candidateCount < 5 || candidateCount > 7) {\n    throw new Error('concept-seed: --candidate-count must be an integer from 5 to 7');\n  }\n  const unit = (salt) => {\n    const h = crypto.createHash('sha256').update(`${scope}:${salt}:${key}`).digest();\n    return h.readUInt32BE(0) / 0xffffffff;\n  };\n  const indexSalt = reroll === 0 ? 'index' : `index:reroll-${reroll}`;\n  const buildIndex = 3 + Math.floor(unit(indexSalt) * (candidateCount - 2)); // 3..candidateCount","sourceCodeStart":304,"sourceCodeEnd":340,"githubUrl":"https://github.com/pbakaus/impeccable/blob/d14711ae3d1a1dd62dee61a358d27f107c51ccd0/skill/scripts/concept-seed.mjs#L304-L340","documentation":"Thrown when `mode` is set to a value not in SEED_MODES = {persuade, operate, read, experience}. Mode is optional (default null) and describes which register of work the seed targets. The allowed set is fixed and mirrored in the catalog validator.","triggerScenarios":"Passing 'reading' instead of 'read'; passing 'transactional' or 'browsing'; passing an empty string instead of null; case mismatch.","commonSituations":"Using a gerund or synonym; copying a mode label from a different part of the skill; config drift between the caller's enum and SEED_MODES.","solutions":["Use exactly one of persuade, operate, read, experience, or omit mode / pass null.","If exposing mode via CLI, validate against SEED_MODES before calling."],"exampleFix":"// before\nawait seedConcepts({ scope: 'surface', mode: 'reading' });\n\n// after\nawait seedConcepts({ scope: 'surface', mode: 'read' }); // or persuade|operate|experience","handlingStrategy":"type-guard","validationCode":null,"typeGuard":"import { SEED_MODES } from './lib/concept-catalog.mjs';\nfunction isValidMode(v) {\n  return v == null || SEED_MODES.has(v);\n}","tryCatchPattern":null,"preventionTips":["Use persuade, operate, read, or experience exactly (lowercase), or omit / pass null.","Reuse the exported SEED_MODES set for CLI autocompletion and validation.","Avoid gerunds ('reading') and synonyms."],"tags":["validation","concept-seed","cli","enum"],"backgroundTag":null,"analyzedSha":"d14711ae3d1a1dd62dee61a358d27f107c51ccd0","analyzedAt":"2026-08-13T00:52:25.771Z","schemaVersion":2},"datasetVersion":"2026-08-13T04:17:16.726Z"}