@mytechtoday/augment-extensions 0.4.0 → 0.7.0

package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json

@@ -0,0 +1,247 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://augment.dev/schemas/screenplay/character-profile.json",
+  "title": "Character Profile",
+  "description": "JSON schema for screenplay character profiles with traits, arcs, motivations, relationships, backstory, and physical description",
+  "type": "object",
+  "required": ["name", "role"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Character's full name"
+    },
+    "role": {
+      "type": "string",
+      "enum": ["protagonist", "antagonist", "supporting", "minor"],
+      "description": "Character's role in the story"
+    },
+    "age": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 150,
+      "description": "Character's age in years"
+    },
+    "gender": {
+      "type": "string",
+      "description": "Character's gender identity"
+    },
+    "physicalDescription": {
+      "type": "object",
+      "properties": {
+        "height": {
+          "type": "string",
+          "description": "Character's height (e.g., '5'10\"', '180cm')"
+        },
+        "build": {
+          "type": "string",
+          "description": "Character's body type (e.g., 'athletic', 'slender', 'stocky')"
+        },
+        "hairColor": {
+          "type": "string",
+          "description": "Character's hair color"
+        },
+        "eyeColor": {
+          "type": "string",
+          "description": "Character's eye color"
+        },
+        "distinguishingFeatures": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Notable physical features (scars, tattoos, etc.)"
+        },
+        "appearance": {
+          "type": "string",
+          "description": "Overall appearance description"
+        }
+      }
+    },
+    "personality": {
+      "type": "object",
+      "properties": {
+        "traits": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Core personality traits"
+        },
+        "strengths": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Character strengths"
+        },
+        "weaknesses": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Character flaws and weaknesses"
+        },
+        "fears": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Character's fears"
+        },
+        "desires": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Character's desires and wants"
+        }
+      }
+    },
+    "backstory": {
+      "type": "object",
+      "properties": {
+        "summary": {
+          "type": "string",
+          "description": "Brief backstory summary"
+        },
+        "formativeEvents": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "event": {
+                "type": "string",
+                "description": "Description of the event"
+              },
+              "age": {
+                "type": "integer",
+                "description": "Age when event occurred"
+              },
+              "impact": {
+                "type": "string",
+                "description": "How this event shaped the character"
+              }
+            }
+          },
+          "description": "Key events that shaped the character"
+        },
+        "family": {
+          "type": "string",
+          "description": "Family background"
+        },
+        "education": {
+          "type": "string",
+          "description": "Educational background"
+        },
+        "occupation": {
+          "type": "string",
+          "description": "Current or past occupation"
+        }
+      }
+    },
+    "motivations": {
+      "type": "object",
+      "properties": {
+        "externalGoal": {
+          "type": "string",
+          "description": "What the character wants to achieve (plot-level)"
+        },
+        "internalGoal": {
+          "type": "string",
+          "description": "What the character needs to learn/overcome (theme-level)"
+        },
+        "stakes": {
+          "type": "string",
+          "description": "What the character stands to lose"
+        },
+        "conflictingMotivations": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Competing desires that create internal conflict"
+        }
+      }
+    },
+    "characterArc": {
+      "type": "object",
+      "properties": {
+        "arcType": {
+          "type": "string",
+          "enum": ["positive", "negative", "flat"],
+          "description": "Type of character arc"
+        },
+        "startingState": {
+          "type": "string",
+          "description": "Character's state at story beginning"
+        },
+        "endingState": {
+          "type": "string",
+          "description": "Character's state at story end"
+        },
+        "transformation": {
+          "type": "string",
+          "description": "How the character changes"
+        }
+      }
+    },
+    "relationships": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["character", "relationship"],
+        "properties": {
+          "character": {
+            "type": "string",
+            "description": "Name of related character"
+          },
+          "relationship": {
+            "type": "string",
+            "description": "Type of relationship (e.g., 'mentor', 'rival', 'love interest')"
+          },
+          "description": {
+            "type": "string",
+            "description": "Description of the relationship dynamic"
+          },
+          "conflictPoints": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Sources of conflict in this relationship"
+          }
+        }
+      },
+      "description": "Character's relationships with other characters"
+    },
+    "voice": {
+      "type": "object",
+      "properties": {
+        "speechPattern": {
+          "type": "string",
+          "description": "How the character speaks (formal, casual, etc.)"
+        },
+        "vocabulary": {
+          "type": "string",
+          "description": "Type of vocabulary used (technical, simple, etc.)"
+        },
+        "catchphrases": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Recurring phrases or expressions"
+        },
+        "accent": {
+          "type": "string",
+          "description": "Character's accent or dialect"
+        }
+      }
+    },
+    "notes": {
+      "type": "string",
+      "description": "Additional notes about the character"
+    }
+  }
+}
+

package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json

@@ -0,0 +1,200 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://augment-extensions.dev/schemas/screenplay/feature-selection.json",
+  "title": "Screenplay Feature Selection Schema",
+  "description": "Configuration schema for selecting screenplay genres, themes, and styles",
+  "type": "object",
+  "properties": {
+    "screenplay_enhancements": {
+      "type": "object",
+      "description": "Screenplay enhancement features configuration",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Enable/disable all screenplay enhancements",
+          "default": true
+        },
+        "features": {
+          "type": "object",
+          "description": "Individual feature configurations",
+          "properties": {
+            "genres": {
+              "type": "object",
+              "description": "Genre-specific rules and guidelines",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "description": "Enable/disable genre features",
+                  "default": true
+                },
+                "selected": {
+                  "type": "array",
+                  "description": "List of selected genres to apply",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "action",
+                      "adventure",
+                      "comedy",
+                      "drama",
+                      "horror",
+                      "sci-fi",
+                      "fantasy",
+                      "romance",
+                      "thriller",
+                      "mystery",
+                      "western",
+                      "historical",
+                      "biographical",
+                      "animation",
+                      "documentary",
+                      "musical",
+                      "noir",
+                      "superhero"
+                    ]
+                  },
+                  "uniqueItems": true,
+                  "default": []
+                },
+                "hybridMode": {
+                  "type": "boolean",
+                  "description": "Enable hybrid genre mode (allows multiple genres)",
+                  "default": false
+                },
+                "conflictResolution": {
+                  "type": "string",
+                  "description": "How to resolve conflicts between genre rules",
+                  "enum": ["merge", "priority", "manual"],
+                  "default": "merge"
+                }
+              },
+              "required": ["enabled", "selected"]
+            },
+            "themes": {
+              "type": "object",
+              "description": "Thematic integration rules",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "description": "Enable/disable theme features",
+                  "default": true
+                },
+                "selected": {
+                  "type": "array",
+                  "description": "List of selected themes to integrate",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "redemption",
+                      "love",
+                      "revenge",
+                      "identity",
+                      "power",
+                      "survival",
+                      "friendship",
+                      "betrayal",
+                      "growth",
+                      "isolation",
+                      "justice",
+                      "ambition",
+                      "fate",
+                      "technology",
+                      "environment"
+                    ]
+                  },
+                  "uniqueItems": true,
+                  "default": []
+                },
+                "primaryTheme": {
+                  "type": "string",
+                  "description": "Primary theme (takes precedence in conflicts)",
+                  "enum": [
+                    "redemption",
+                    "love",
+                    "revenge",
+                    "identity",
+                    "power",
+                    "survival",
+                    "friendship",
+                    "betrayal",
+                    "growth",
+                    "isolation",
+                    "justice",
+                    "ambition",
+                    "fate",
+                    "technology",
+                    "environment"
+                  ]
+                },
+                "integrationLevel": {
+                  "type": "string",
+                  "description": "How deeply to integrate themes",
+                  "enum": ["subtle", "moderate", "prominent"],
+                  "default": "moderate"
+                }
+              },
+              "required": ["enabled", "selected"]
+            },
+            "styles": {
+              "type": "object",
+              "description": "Narrative style rules and techniques",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "description": "Enable/disable style features",
+                  "default": true
+                },
+                "selected": {
+                  "type": "array",
+                  "description": "List of selected narrative styles (typically one)",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "linear",
+                      "non-linear",
+                      "ensemble",
+                      "minimalist",
+                      "epic",
+                      "satirical",
+                      "poetic",
+                      "realistic",
+                      "surreal",
+                      "experimental",
+                      "voice-over",
+                      "flashback",
+                      "dialogue-centric"
+                    ]
+                  },
+                  "uniqueItems": true,
+                  "maxItems": 1,
+                  "default": []
+                }
+              },
+              "required": ["enabled", "selected"]
+            }
+          },
+          "required": ["genres", "themes", "styles"]
+        },
+        "validation": {
+          "type": "object",
+          "description": "Validation settings",
+          "properties": {
+            "strictMode": {
+              "type": "boolean",
+              "description": "Enforce strict adherence to selected features",
+              "default": false
+            },
+            "warningsAsErrors": {
+              "type": "boolean",
+              "description": "Treat validation warnings as errors",
+              "default": false
+            }
+          }
+        }
+      },
+      "required": ["enabled", "features"]
+    }
+  },
+  "required": ["screenplay_enhancements"]
+}
+

package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json

@@ -0,0 +1,233 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://augment.dev/schemas/screenplay/plot-outline.json",
+  "title": "Plot Outline",
+  "description": "JSON schema for screenplay plot outlines with acts, beats, turning points, sequences, and scenes",
+  "type": "object",
+  "required": ["title", "acts"],
+  "properties": {
+    "title": {
+      "type": "string",
+      "description": "Title of the screenplay"
+    },
+    "logline": {
+      "type": "string",
+      "description": "One-sentence story summary"
+    },
+    "genre": {
+      "type": "string",
+      "description": "Story genre"
+    },
+    "targetLength": {
+      "type": "integer",
+      "description": "Target screenplay length in pages"
+    },
+    "acts": {
+      "type": "array",
+      "minItems": 3,
+      "items": {
+        "type": "object",
+        "required": ["actNumber", "title", "pageRange", "sequences"],
+        "properties": {
+          "actNumber": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Act number (1, 2, or 3)"
+          },
+          "title": {
+            "type": "string",
+            "description": "Act title or description"
+          },
+          "pageRange": {
+            "type": "object",
+            "required": ["start", "end"],
+            "properties": {
+              "start": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Starting page number"
+              },
+              "end": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "Ending page number"
+              }
+            }
+          },
+          "summary": {
+            "type": "string",
+            "description": "Summary of what happens in this act"
+          },
+          "turningPoints": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["page", "description"],
+              "properties": {
+                "page": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "description": "Page number of turning point"
+                },
+                "description": {
+                  "type": "string",
+                  "description": "Description of the turning point"
+                },
+                "type": {
+                  "type": "string",
+                  "enum": ["inciting-incident", "plot-point-1", "midpoint", "plot-point-2", "climax"],
+                  "description": "Type of turning point"
+                }
+              }
+            },
+            "description": "Major turning points in this act"
+          },
+          "sequences": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["sequenceNumber", "title", "scenes"],
+              "properties": {
+                "sequenceNumber": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "description": "Sequence number within the act"
+                },
+                "title": {
+                  "type": "string",
+                  "description": "Sequence title or description"
+                },
+                "pageRange": {
+                  "type": "object",
+                  "properties": {
+                    "start": {
+                      "type": "integer",
+                      "minimum": 1
+                    },
+                    "end": {
+                      "type": "integer",
+                      "minimum": 1
+                    }
+                  }
+                },
+                "summary": {
+                  "type": "string",
+                  "description": "Summary of the sequence"
+                },
+                "purpose": {
+                  "type": "string",
+                  "description": "Narrative purpose of this sequence"
+                },
+                "scenes": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "required": ["sceneNumber", "heading", "summary"],
+                    "properties": {
+                      "sceneNumber": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "description": "Scene number"
+                      },
+                      "heading": {
+                        "type": "string",
+                        "description": "Scene heading (e.g., 'INT. COFFEE SHOP - DAY')"
+                      },
+                      "location": {
+                        "type": "string",
+                        "description": "Scene location"
+                      },
+                      "timeOfDay": {
+                        "type": "string",
+                        "enum": ["DAY", "NIGHT", "MORNING", "AFTERNOON", "EVENING", "DUSK", "DAWN", "CONTINUOUS", "LATER", "MOMENTS LATER"],
+                        "description": "Time of day"
+                      },
+                      "intExt": {
+                        "type": "string",
+                        "enum": ["INT", "EXT", "INT/EXT"],
+                        "description": "Interior or exterior"
+                      },
+                      "pageNumber": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "description": "Approximate page number"
+                      },
+                      "summary": {
+                        "type": "string",
+                        "description": "What happens in this scene"
+                      },
+                      "characters": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "Characters present in the scene"
+                      },
+                      "purpose": {
+                        "type": "string",
+                        "description": "Narrative purpose of the scene"
+                      },
+                      "conflict": {
+                        "type": "string",
+                        "description": "Central conflict in the scene"
+                      },
+                      "outcome": {
+                        "type": "string",
+                        "description": "How the scene ends/what changes"
+                      },
+                      "emotionalBeat": {
+                        "type": "string",
+                        "description": "Emotional tone or beat of the scene"
+                      },
+                      "notes": {
+                        "type": "string",
+                        "description": "Additional notes about the scene"
+                      }
+                    }
+                  },
+                  "description": "Scenes in this sequence"
+                }
+              }
+            },
+            "description": "Sequences in this act"
+          }
+        }
+      },
+      "description": "Acts in the screenplay (typically 3)"
+    },
+    "subplots": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["title", "description"],
+        "properties": {
+          "title": {
+            "type": "string",
+            "description": "Subplot title"
+          },
+          "description": {
+            "type": "string",
+            "description": "Subplot description"
+          },
+          "characters": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Characters involved in subplot"
+          },
+          "resolution": {
+            "type": "string",
+            "description": "How the subplot resolves"
+          }
+        }
+      },
+      "description": "Subplots in the story"
+    },
+    "notes": {
+      "type": "string",
+      "description": "Additional notes about the plot outline"
+    }
+  }
+}
+