# Phase 20AH - Chapter Intelligence and Character Import

Phase 20AH completes the first chapter-level import path and begins author-reviewed character import from existing stored Story Intelligence JSON.

## Chapter Intelligence Import

When a Story Intelligence scene commit runs, PlotDirector now also updates the target chapter inside the same import transaction.

Imported chapter fields:

- Chapter summary: populated from the Chapter Structure `chapterSummary` response.
- Chapter purpose: mapped to an existing Chapter Purpose lookup value where the stored Chapter Intelligence response supports a clear match.

The import does not concatenate scene summaries to create a chapter summary.

Chapter Purpose is a chapter-level lookup, separate from Scene Purpose. The default lookup values are:

- Opening
- Character Development
- Relationship Development
- World Building
- Investigation
- Revelation
- Escalation
- Turning Point
- Climax
- Resolution
- Transition

Chapter Purpose is editable on the standard chapter edit screen and visible on the chapter detail page.

## Character Import

After scenes have been created, the onboarding review page can show a character review section.

The review is built from stored Scene Intelligence results only. It does not call OpenAI again.

For each candidate, PlotDirector shows:

- Character name
- Number of scenes where the character appears or is mentioned
- Confidence band
- Possible aliases
- First appearance example
- Existing matched character where available

The author can approve, ignore, or rename new characters before import.

When approved:

- Existing characters are linked where names or aliases match.
- New characters are created only for approved candidates.
- Aliases from Scene Intelligence are saved where they do not duplicate the primary name or an existing alias.
- Scene People panels are populated for characters physically present in imported scenes.
- Mentioned-only characters can be created if approved, but they are not added as physically present scene appearances.
- Previously unresolved scene POV links are retried after character creation.

The import does not infer gender or create placeholder characters.

## Still Future Phases

- Locations
- Assets
- Relationships
- Knowledge changes
- Continuity warnings
- Real timeline events
