feat!: require ordered axis in custom categoryNames

[antonstefer]

Summary

Replace the silent House auto-prepend at generator.ts:177-179 with an explicit error when a user-supplied categoryNames list contains no category with ordered: true.

Before: generate({ categoryNames: [4 unordered] }) → silently mutates input to 5 categories (House + your 4) and proceeds.
After: same call → throws with a message that explains the requirement and points to defaultHouseCategory(size) as the escape hatch.

The default path (no categoryNames supplied) is unchanged — it still prepends House to DEFAULT_CATEGORIES because that contract is internal.

Why

• Violates the project's Throw on errors — never silently swallow or use fallback values rule.
• Silently changes puzzle shape (4 categories → 5) which surprises users who expected their custom list to be respected.
• Reviewer flagged this on docs: surface logic-grid-ai across the root README #20 as "weird behavior".

Migration

// Before — relied on silent prepend
generate({ size: 4, categoryNames: [name, color, drink, pet] });

// After — pick one of:
generate({ size: 4, categoryNames: [defaultHouseCategory(4), name, color, drink, pet] });
// or mark a domain-relevant category as ordered with orderingPhrases

The error message itself includes this hint.

Implementation notes

• The throw fires after validateCategories(categories) so existing structural errors (duplicate values, duplicate names, missing verbs) still surface first when present.
• logic-grid-ai is unaffected: validateThemeResult already requires an ordered axis on AI output, so generateTheme results always satisfy the new contract.
• Demo presets (hedge-fund, morning-schedule) both already mark a category ordered, so no demo changes needed.
• README updated with the new requirement and an example using defaultHouseCategory(size).

Release impact

feat!: triggers a major bump → release-please will propose logic-grid 3.0.0. After it lands, logic-grid-ai's peerDep should bump to ^3.0.0 in a follow-up commit so a corresponding logic-grid-ai major is cut.

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	logic-grid	e55319c	Commit Preview URL Branch Preview URL	Apr 28 2026, 11:59 AM