adjust rolltemplate, summary, description, outcome

CHANGELOG.md

@@ -4,7 +4,7 @@
 
 ### Breaking changes
 
-* `Name` key removed (as it was trying to do too many jobs). in its place is `Title`, an object which provides a "canonical", "standard", and "short" version of the item's title. items which can't rightly be said to have a title of their own, like asset inputs receive `Label` (a string) instead.
+* `Name` key removed (as it was trying to do too many jobs). in its place is `Title`, an object which provides a `Canonical`, `Standard`, and `Short` version of the item's title. items which can't rightly be said to have a title of their own, like asset inputs receive `Label` (a string) instead.
 * "Health" on companion assets is now labelled "companion health"
 * "Integrity" on vehicle cards is now labelled "vehicle integrity"
 * internal references to stats are now lowercase rather than title case. all of these are reflected in enums, so if you're already using those, you should be set!
@@ -16,10 +16,17 @@
     * old: `../../img/vector/Oracles/Creature/Environment/Space.svg`
     * new: `img/vector/Oracles/Creature/Environment/Space.svg`
 * complete overhaul of oracle table display data -- see `IOracle.Display.Columns`
+* roll templates (see `IRowTemplate`) now demarcate strings to be replaced with `{{Oracle_Id}}` rather than `${{Oracle_Id}}`. Admittedly, this is a bit arbitrary, and is mainly so that internal JSON template replacement when Dataforged builds from YAML uses a replacement demarcation distinct from roll templates. example:
+  * old: `"${{Starforged/Oracles/Factions/Affiliation}} of the ${{Starforged/Oracles/Factions/Legacy}} ${{Starforged/Oracles/Factions/Identity}}"`
+  * new: `"{{Starforged/Oracles/Factions/Affiliation}} of the {{Starforged/Oracles/Factions/Legacy}} {{Starforged/Oracles/Factions/Identity}}"`
 
-### Other changes
-* `Source` now includes a `License` property, containing a URL pointing to the relevant license.
+### Other API changes
+* `Source` now includes a `License` property, containing a URI pointing to the relevant license.
 * everything that has a localizable string descendent (direct or otherwise) now has an `$id`
+* `IOracleBase` (and its descendants, `IOracle` and `IOracleCategory`) may now have `Summary` in addition to `Description`. `Summary` is for providing a brief summary of the article (a couple sentences tops), while `Description` includes more detailed information (often multiple paragraphs).
+
+### Fixes
+* Fixed incorrect data in many `IMoveOutcomes` (and asset `IAlterMoveOutcomes`) due to a janky build script
 
 ### New content
 #### Starforged

_master-data/Ironsworn/Delve-Site-Themes.yaml

@@ -31,7 +31,7 @@ Themes:
       - Floor: 1
         Ceiling: 5
         Result: Ancient trap
-        Suggestions: &Theme_Trap
+        Suggestions: &SuggestTrap
           Oracle rolls:
             - Ironsworn/Oracles/Trap/Event
             - Ironsworn/Oracles/Trap/Component
@@ -118,7 +118,7 @@ Themes:
       - Floor: 19
         Ceiling: 20
         Result: Mystic trap or trigger
-        Suggestions: *Theme_Trap
+        Suggestions: *SuggestTrap
       - Floor: 21
         Ceiling: 22
         Result: Mystic barrier or ward
@@ -178,7 +178,7 @@ Themes:
       - Floor: 15
         Ceiling: 16
         Result: Denizen lures you into a trap
-        Suggestions: *Theme_Trap
+        Suggestions: *SuggestTrap
       - Floor: 17
         Ceiling: 18
         Result: Denizens converge on this area
@@ -197,7 +197,7 @@ Themes:
       - Floor: 27
         Ceiling: 28
         Result: Trap
-        Suggestions: *Theme_Trap
+        Suggestions: *SuggestTrap
       - Floor: 29
         Ceiling: 30
         Result: Alarm trigger
@@ -392,7 +392,7 @@ Themes:
       - Floor: 27
         Ceiling: 28
         Result: Trap or snare
-        Suggestions: *Theme_Trap
+        Suggestions: *SuggestTrap
       - Floor: 29
         Ceiling: 30
         Result: Victim’s horrible fate is revealed

_master-data/Ironsworn/Oracles/Combat_Event-Delve.yaml

@@ -1,6 +1,16 @@
 Title:
   Canonical: Combat Event
-Description: Determine the actions of a character, creature, or force during a fight.
+Summary: Determine the actions of a character, creature, or force during a fight.
+Description: |-
+  Use the Combat Event oracles to answer questions about the actions of a foe or enemy force. You can use these oracles instead of—or in addition to—the [Combat Action](Ironsworn/Oracles/Turning_Point/Combat_Action) oracle.
+
+  Roll once each on the [Method](Ironsworn/Oracles/Combat_Event/Method) oracle and the [Target](Ironsworn/Oracles/Combat_Event/Target) oracle. Then, interpret the response as appropriate to the current situation and the nature of your foe.
+
+  For example, you are fighting a rhaskar, a bear-like beast. It has initiative, and you want to know what it does next. You [Ask the Oracle](Ask the Oracle), rolling [Method](Ironsworn/Oracles/Combat_Event/Method) and [Target](Ironsworn/Oracles/Combat_Event/Target). The oracle responds, “Await Weakness.” You envision the rhaskar circling you, its keen eyes narrowing as it looks for an opening in your defenses. You must [Face Danger](Face Danger) to avoid being outmaneuvered.
+Usage:
+  Suggestions:
+    Oracle rolls:
+      - Ironsworn/Oracles/Turning_Point/Combat_Action
 Source:
   Authors:
     - Shawn Tomkin

_master-data/Ironsworn/Oracles/Feature-Delve.yaml

@@ -6,7 +6,11 @@ Source:
   Title: "Ironsworn: Delve"
   Page: 204
   License: https://creativecommons.org/licenses/by-nc-sa/4.0/
-Description: Use the Aspect and Focus oracles to answer questions or provide inspiration for a location or event within a site.
+Summary: Use the [Aspect](Ironsworn/Oracles/Feature/Aspect) and [Focus](Ironsworn/Oracles/Feature/Focus) oracles to answer questions or provide inspiration for a location or event within a site.
+Description: |-
+  Use the [Aspect](Ironsworn/Oracles/Feature/Aspect) and [Focus](Ironsworn/Oracles/Feature/Focus) oracles to generate the details of a location or event within a site, or to answer questions about the site’s nature or history.
+
+  The basic function of these oracles is similar to the Action(Ironsworn/Oracles/Action) and Theme(Ironsworn/Oracles/Theme) oracles in Ironsworn Core. They are abstract word prompts you can interpret as appropriate to the current situation and setting. For example, you are traveling through a [Wild](Ironsworn/Themes/Wild) [Tanglewood](Ironsworn/Domains/Tanglewood) and roll “Something unusual or unexpected” on the domain feature table. You then [Ask the Oracle](Ironsworn/Move/Fate/Ask_the_Oracle) what you discover using the [Aspect](Ironsworn/Oracles/Feature/Aspect) and [Focus](Ironsworn/Oracles/Feature/Focus) tables. The oracle responds, “Depleted Environment.” Interpreting this answer, you envision coming upon an expanse of cleared forest. All that remains of this once thick woodland is rotted stumps. What happened here? Perhaps the answer lies ahead...
 Oracles:
   - Title:
       Canonical: "Feature: Aspect"

_master-data/Ironsworn/Oracles/Monstrosity-Delve.yaml

@@ -1,6 +1,27 @@
 Title:
   Canonical: Monstrosity
-Description: Discover the nature of a [nightspawn](Ironsworn/Encounters/Horrors/Nightspawn) or other frightful creature within your world.
+Summary: Discover the nature of a [nightspawn](Ironsworn/Encounters/Horrors/Nightspawn) or other frightful creature within your world.
+Description: |-
+  Use the Monstrosity oracle to define the nature of a [Nightspawn](Ironsworn/Encounters/Horrors/Nightspawn), or to introduce a new type of [animal](Ironsworn/Encounters/Animal), [beast](Ironsworn/Encounters/Beast), or [horror](Ironsworn/Encounters/Horror) in your world.
+
+  To create a monstrosity, start by rolling for its [Size](Ironsworn/Oracles/Monstrosity/Size) and [Primary Form](Ironsworn/Oracles/Monstrosity/Primary_Form). Then, roll up to four times for [Characteristics](Ironsworn/Oracles/Monstrosity/Characteristics) and keep up to three of those results. Do the same for [Abilities](Ironsworn/Oracles/Monstrosity/Abilities).
+
+  Give the monstrosity a rank. Choose one appropriate to its features, or use the [Challenge Rank](Ironsworn/Oracles/Turning_Point/Challenge_Rank) oracle.
+
+  Finally, envision your creation and give it a name. It’s part of your world now.
+
+  Some results on these tables include two related options separated by a slash (/). Pick the one which best fits the nature of the creature or is the most interesting. You can also make one of the options likely, and [Ask the Oracle](Ironsworn/Moves/Fate/Ask_the_Oracle) (using the pick two procedure) to confirm your choice. Or just take both!
+
+  You should weave these abilities into the fiction of your encounter with a monstrosity. Combined with its physical characteristics, they help define the creature’s approach and tactics. Make moves as appropriate to overcome, avoid, or face the consequences of these abilities.
+
+  To learn more about your creation’s nature, you can roll on additional tables. Use the [Character Goal](Ironsworn/Oracles/Character/Goal) oracle to give the monstrosity a purpose. Roll on the [Character Disposition](Ironsworn/Oracles/Character/Disposition) and [Activity](Ironsworn/Oracles/Character/Activity) oracles to frame your initial encounter. Another roll or two can give your monstrosity nuance and complexity, making it a deeper part of your story.
+Usage:
+  Suggestions:
+    Oracle rolls:
+      - Ironsworn/Oracles/Turning_Point/Challenge_Rank
+      - Ironsworn/Oracles/Character/Goal
+      - Ironsworn/Oracles/Character/Disposition
+      - Ironsworn/Oracles/Character/Activity
 Source:
   Authors:
     - Shawn Tomkin
@@ -12,6 +33,8 @@ Oracles:
       Short: Size
       Canonical: "Monstrosity: Size"
     _idFragment: Size
+    Usage:
+      Initial: true
     Source:
       Page: 214
     Table:
@@ -25,6 +48,10 @@ Oracles:
       Short: Primary Form
       Canonical: "Monstrosity: Primary Form"
     _idFragment: Primary Form
+    Description: |-
+      Some results on these tables include two related options separated by a slash (/). Pick the one which best fits the nature of the creature or is the most interesting. You can also make one of the options likely, and [Ask the Oracle](Ironsworn/Moves/Fate/Ask_the_Oracle) (using the pick two procedure) to confirm your choice. Or just take both!
+    Usage:
+      Initial: true
     Source:
       Page: 214
     Table:
@@ -51,6 +78,12 @@ Oracles:
       Short: Characteristics
       Canonical: "Monstrosity: Characteristics"
     _idFragment: Characteristics
+    Usage:
+      Max rolls: 4
+      Initial: true
+    Summary: Roll up to four times for Characteristics and keep up to three of those results.
+    Description: |-
+      Some results on these tables include two related options separated by a slash (/). Pick the one which best fits the nature of the creature or is the most interesting. You can also make one of the options likely, and [Ask the Oracle](Ironsworn/Moves/Fate/Ask_the_Oracle) (using the pick two procedure) to confirm your choice. Or just take both!
     Source:
       Page: 215
     Table:
@@ -87,6 +120,14 @@ Oracles:
       Short: Abilities
       Canonical: "Monstrosity: Abilities"
     _idFragment: Abilities
+    Usage:
+      Max rolls: 4
+      Initial: true
+    Summary: Roll up to four times for Abilities and keep up to three of those results.
+    Description: |-
+      Some results on these tables include two related options separated by a slash (/). Pick the one which best fits the nature of the creature or is the most interesting. You can also make one of the options likely, and [Ask the Oracle](Ironsworn/Moves/Fate/Ask_the_Oracle) (using the pick two procedure) to confirm your choice. Or just take both!
+
+      You should weave these abilities into the fiction of your encounter with a monstrosity. Combined with its physical characteristics, they help define the creature’s approach and tactics. Make moves as appropriate to overcome, avoid, or face the consequences of these abilities.
     Source:
       Page: 216
     Table:

_master-data/Ironsworn/Oracles/Place.yaml

@@ -11,26 +11,26 @@ Oracles:
       Canonical: "Oracle 3: Region"
       Standard: Region
     _idFragment: Region
-    Description: Use this oracle when you want to randomly select a region with the Ironlands.
+    Summary: Use this oracle when you want to randomly select a region with the Ironlands.
     Source:
       Title: Ironsworn Rulebook
       Page: 176
     Table:
-      - [1, 12, Barrier Islands]
-      - [13, 24, Ragged Coast]
-      - [25, 34, Deep Wilds]
-      - [35, 46, Flooded Lands]
-      - [47, 60, Havens]
-      - [61, 72, Hinterlands]
-      - [73, 84, Tempest Hills]
-      - [85, 94, Veiled Mountains]
-      - [95, 99, Shattered Wastes]
+      - [1, 12, "[Barrier Islands](Ironsworn/Regions/Barrier_Islands)", Suggestions: {Regions: [Ironsworn/Regions/Barrier_Islands]}]
+      - [13, 24, "[Ragged Coast](Ironsworn/Regions/Ragged_Coast)", Suggestions: {Regions: [Ironsworn/Regions/Ragged_Coast]}]
+      - [25, 34, "[Deep Wilds](Ironsworn/Regions/Deep_Wilds)", Suggestions: {Regions: [Ironsworn/Regions/Deep_Wilds]}]
+      - [35, 46, "[Flooded Lands](Ironsworn/Regions/Flooded_Lands)", Suggestions: {Regions: [Ironsworn/Regions/Flooded_Lands]}]
+      - [47, 60, "[Havens](Ironsworn/Regions/Havens)", Suggestions: {Regions: [Ironsworn/Regions/Havens]}]
+      - [61, 72, "[Hinterlands](Ironsworn/Regions/Hinterlands)", Suggestions: {Regions: [Ironsworn/Regions/Hinterlands]}]
+      - [73, 84, "[Tempest Hills](Ironsworn/Regions/Tempest_Hills)", Suggestions: {Regions: [Ironsworn/Regions/Tempest_Hills]}]
+      - [85, 94, "[Veiled Mountains](Ironsworn/Regions/Veiled_Mountains)", Suggestions: {Regions: [Ironsworn/Regions/Veiled_Mountains]}]
+      - [95, 99, "[Shattered Wastes](Ironsworn/Regions/Shattered_Wastes)", Suggestions: {Regions: [Ironsworn/Regions/Shattered_Wastes]}]
       - [100, 100, Elsewhere]
   - Title:
       Canonical: "Oracle 4: Location"
       Standard: Location
     _idFragment: Location
-    Description: Use this oracle when traveling to generate a point-of-interest or to answer a question about a place where someone or something can be found.
+    Summary: Use this oracle when traveling to generate a point-of-interest or to answer a question about a place where someone or something can be found.
     Source:
       Title: Ironsworn Rulebook
       Page: 176
@@ -90,7 +90,7 @@ Oracles:
       Canonical: "Oracle 5: Coastal Waters Location"
       Standard: Coastal Waters Location
     _idFragment: Coastal Waters Location
-    Description: Use this oracle to identify a point-of-interest or destination when you are traveling by ship or boat.
+    Summary: Use this oracle to identify a point-of-interest or destination when you are traveling by ship or boat.
     Source:
       Title: Ironsworn Rulebook
       Page: 176
@@ -117,7 +117,7 @@ Oracles:
       Standard: Location Descriptor
       Short: Descriptor
     _idFragment: Descriptor
-    Description: Use this oracle to add detail to the Location or Coastal Waters Location oracles, or by itself to generate a description of a location. Roll more than once for extra detail.
+    Summary: Use this oracle to add detail to the Location or Coastal Waters Location oracles, or by itself to generate a description of a location. Roll more than once for extra detail.
     Source:
       Title: Ironsworn Rulebook
       Page: 177

_master-data/Ironsworn/Oracles/Settlement.yaml

@@ -19,7 +19,7 @@ Oracles:
           Canonical: A feature of the landscape
           Standard: Landscape Feature
         _idFragment: Landscape Feature
-        Description: &Landscape_Feature |-
+        Summary: &Landscape_Feature |-
           "**A feature of the landscape.** Envision what it is. What makes it unusual or distinctive?",
         Table:
           - [1, 10, Highmount]
@@ -36,7 +36,7 @@ Oracles:
           Canonical: A manmade edifice
           Standard: Manmade Edifice
         _idFragment: Manmade Edifice
-        Description: &Manmade_Edifice |-
+        Summary: &Manmade_Edifice |-
           **A manmade edifice.** What is it? Why is it important to this settlement’s history?,
         Table:
           - [1, 10, Whitebridge]
@@ -53,7 +53,7 @@ Oracles:
           Canonical: A creature
           Standard: Creature
         _idFragment: Creature
-        Description: &Creature |-
+        Summary: &Creature |-
           **A creature.** Why have the people of this settlement chosen this creature as their totem? How is it represented in art or rituals?
         Table:
           - [1, 10, Ravencliff]
@@ -70,7 +70,7 @@ Oracles:
           Canonical: A historical event
           Standard: Historical Event
         _idFragment: Historical Event
-        Description: &Historical_Event |-
+        Summary: &Historical_Event |-
           **A historical event.** What happened here? What place or practice commemorates this event?
         Table:
           - [1, 10, Swordbreak]
@@ -87,7 +87,7 @@ Oracles:
           Canonical: A word in an Old World language
           Standard: Old World Language
         _idFragment: Old World Language
-        Description: &Old_World_Language |-
+        Summary: &Old_World_Language |-
           **A word in an Old World language.** What culture is represented by this word? What does it translate to?
         Table:
           - [1, 10, Abon]
@@ -104,7 +104,7 @@ Oracles:
           Canonical: A season or environmental aspect
           Standard: Environmental Aspect
         _idFragment: Environmental Aspect
-        Description: &Environmental_Aspect |-
+        Summary: &Environmental_Aspect |-
           **A season or environmental aspect.** What influence does the weather have on this settlement?
         Table:
           - [1, 10, Winterhome]
@@ -137,13 +137,13 @@ Oracles:
       - [ 46, 60, *Historical_Event, Oracle rolls: [Ironsworn/Oracles/Settlement/Name/Historical_Event] ]
       - [ 61, 75, *Old_World_Language, Oracle rolls: [Ironsworn/Oracles/Settlement/Name/Old_World_Language] ]
       - [ 76, 90, *Environmental_Aspect, Oracle rolls: [Ironsworn/Oracles/Settlement/Name/Environmental_Aspect] ]
-      - [ 91, 100, "Something Else...", Oracle rolls: [Ironsworn/Oracles/Settlement/Name/Something_Else]]
+      - [ 91, 100, "Something Else..."]
   - Title:
       Canonical: "Oracle 8: Quick Settlement Name Generator"
       Standard: Quick Settlement Name Generator
       Short: Quick Name
     _idFragment: Quick Name
-    Description: Use this oracle as a simpler alternative for settlement names. Roll once for the prefix, and once for the suffix. If the combination doesn’t quite work, look at adjacent rows or reverse the digits.
+    Summary: Use this oracle as a simpler alternative for settlement names. Roll once for the prefix, and once for the suffix. If the combination doesn’t quite work, look at adjacent rows or reverse the digits.
     Display:
       Columns:
         - Type: dice range
@@ -156,7 +156,7 @@ Oracles:
           Label: Suffix
     Usage:
       Roll template:
-        Result: "${{Ironsworn/Oracles/Settlement/Quick_Name/Prefix}}${{Ironsworn/Oracles/Settlement/Quick_Name/Suffix}}"
+        Result: "{{Ironsworn/Oracles/Settlement/Quick_Name/Prefix}}{{Ironsworn/Oracles/Settlement/Quick_Name/Suffix}}"
     Source:
       Page: 180
     Oracles:
@@ -275,7 +275,7 @@ Oracles:
       Standard: Settlement Trouble
       Short: Trouble
     _idFragment: Trouble
-    Description: Use this table to generate a narrative hook for a problem faced by a community. This oracle can help inspire a vow for your character or serve as a prompt for a trouble you encounter when you interact with a settlement.
+    Summary: Use this table to generate a narrative hook for a problem faced by a community. This oracle can help inspire a vow for your character or serve as a prompt for a trouble you encounter when you interact with a settlement.
     Source:
       Page: 181
     Table: