PlotDirector/PlotLine/Docs/StoryIntelligence_Phase20AP_AssetImport.md

2.3 KiB

Phase 20AP - Asset Intelligence Review and Import

Phase 20AP adds the first implemented Asset Intelligence import stage to the Story Intelligence pipeline.

The stage uses only stored Scene Intelligence JSON from completed chapter runs. It does not make additional OpenAI calls and does not change the Scene Intelligence prompts.

Implemented Asset Stage

After Character Review/Import and Location Review/Import, the pipeline now continues to:

  • Review Assets
  • Create Assets
  • Complete

Resume support routes books with completed characters and locations, but incomplete assets, directly to Asset Review.

Source Data

Asset candidates are built from:

  • assets[] in stored Scene Intelligence results
  • entity-mappable observations whose subject or object is an Asset/Object

The import does not reread the manuscript and does not send raw text back to AI.

Candidate Filtering

The asset resolver keeps story-significant objects such as:

  • TR6
  • rucksack
  • note
  • letter
  • necklace
  • driving licence
  • car keys
  • passport
  • envelope
  • photograph
  • map
  • diary
  • notebook

It suppresses generic scenery, furniture, broad locations and incidental items unless there is repeated story significance or clear asset signal.

Duplicate and Alias Handling

Asset variants are folded into one review candidate where safe.

Examples:

  • red notebook, the notebook, old notebook -> Notebook
  • photo -> Photograph
  • driving license -> Driving licence

The review screen supports:

  • create new asset
  • link to existing asset
  • create separate asset
  • alias/variant of another reviewed asset
  • ignore

Imported Fields

Approved assets create or link:

  • StoryAssets
  • AssetAliases
  • AssetEvents
  • AssetCustodyEvents only when owner/holder text resolves to an existing character

Asset kind is mapped to existing lookup values such as Document, Evidence, Vehicle or Physical Object. New lookup values are not created.

Scene appearances are imported as Asset Events so they appear in the Scene Inspector World panel and on Asset pages/timelines.

Not Yet Implemented

The following remain future Story Intelligence stages:

  • relationships
  • knowledge
  • continuity
  • real timeline events
  • full asset dependency modelling
  • unresolved owner creation

No placeholder characters or owners are created by this phase.