Add automatic authoring and distinct nine-shot reference themes

[henyjone]

What changed

• add an upfront automatic / guided authoring choice to the APSAL Codex plugin
• let automatic mode select valid DNA, confirm all five semantic layers, and finalize the Prompt/Skill package in one project revision
• preserve guided mode as the compatibility default and keep Studio/headless selection independent
• make the default nine-Job Chaptered Variation use nine distinct scenes, poses, actions, hand plans, gazes, face and body orientations, expressions, compositions, makeup designs, hairstyles, wardrobes, focal lengths, perspective purposes, and lighting designs
• lock only the same adult facial identity, age, body proportions, and live-action medium across those variations
• package the sanitized real reference image under assets/references/, record purpose and rights, and map it to every applicable Job
• compile identity-only reference boundaries and the complete per-Job design into all nine different full Prompts
• document the flow and add engine, package, MCP schema, and frontend coverage

Why

Creators asked for a simpler path that does not require manual confirmation at every authoring stage, while reference-based nine-image sets still need real visual variety. The previous Chaptered Variation repeated three scenes and three looks, and its Prompts did not carry every shot-specific face, styling, composition, optics, and lighting decision. Automatic mode now turns the initial choice into explicit consent for complete defaults, while reference images preserve the same face only and do not leak their original pose or styling into all nine images. Rights, reference purpose, validation, and visual QA gates remain intact.

User impact

Starting a default reference-based theme now produces nine independently executable Prompt Jobs instead of nine near-duplicates. The installable Skill contains the actual permitted reference file and an explicit reference mapping for each Job. Continuous Narrative remains available when one scene and one look are intentionally required.

Validation

• python3 -m pytest -q — 83 passed
• python3 scripts/validate_plugin_bundle.py — passed, 29 tools
• npm test -- --run — 5 passed
• npm run test:electron — 3 passed
• npx tsc --noEmit — passed
• npm run build — passed
• installed app engine, repository engine, and Codex plugin cache hashes match
• installed app signature passes deep strict verification
• real automatic identity-reference session produced 9/9 unique requested fields, 9 unique full Prompts, an embedded sanitized reference, and per-Job reference mappings