@mytechtoday/augment-extensions 0.5.0 → 1.2.0

package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml

@@ -1,116 +1,116 @@
-# Character Profile Example
-# Demonstrates the character-profile.json schema usage
-
-name: "Sarah Mitchell"
-role: "protagonist"
-age: 32
-gender: "Female"
-
-physicalDescription:
-  height: "5'6\""
-  build: "Athletic, runner's physique"
-  hairColor: "Dark brown, shoulder-length"
-  eyeColor: "Green"
-  distinguishingFeatures:
-    - "Small scar above left eyebrow from childhood accident"
-    - "Wears her grandmother's silver locket"
-  appearance: "Professional but approachable. Often wears practical clothing - jeans, comfortable shoes. Minimal makeup. Carries herself with quiet confidence that masks deep insecurity."
-
-personality:
-  traits:
-    - "Intelligent and analytical"
-    - "Compassionate but guarded"
-    - "Perfectionist"
-    - "Self-sacrificing"
-    - "Struggles with vulnerability"
-  strengths:
-    - "Problem-solving ability"
-    - "Empathy for others"
-    - "Determination and resilience"
-    - "Loyalty to those she cares about"
-  weaknesses:
-    - "Difficulty trusting others"
-    - "Tendency to isolate when stressed"
-    - "Fear of failure"
-    - "Puts others' needs before her own to a fault"
-  fears:
-    - "Abandonment"
-    - "Being a burden to others"
-    - "Losing control"
-    - "Repeating her mother's mistakes"
-  desires:
-    - "To build meaningful connections"
-    - "To prove her worth"
-    - "To break free from her past"
-    - "To find a place where she belongs"
-
-backstory:
-  summary: "Raised by a single mother who struggled with addiction, Sarah learned early to be self-reliant. She put herself through college, became a social worker, and dedicated her life to helping others - perhaps as a way to save the mother she couldn't save as a child."
-  formativeEvents:
-    - event: "Mother's first overdose"
-      age: 8
-      impact: "Learned she couldn't rely on adults to take care of her. Became hyper-responsible and self-sufficient."
-    - event: "Placed in foster care temporarily"
-      age: 12
-      impact: "Developed deep fear of abandonment and loss of control. Vowed never to be helpless again."
-    - event: "Mother's death from overdose"
-      age: 19
-      impact: "Reinforced belief that she failed to save someone she loved. Drives her work as a social worker but also her inability to accept help."
-    - event: "Failed engagement at 28"
-      age: 28
-      impact: "Confirmed her fear that she's incapable of maintaining close relationships. Withdrew further emotionally."
-  family: "Only child. Mother deceased. Father unknown. No extended family connections."
-  education: "Bachelor's in Social Work from state university. Graduated with honors while working two jobs."
-  occupation: "Social worker specializing in addiction and family services"
-
-motivations:
-  externalGoal: "To save a troubled family from the same fate as her own"
-  internalGoal: "To learn that she's worthy of love and doesn't have to earn her place in the world"
-  stakes: "If she fails, she'll confirm her deepest fear - that she's fundamentally broken and incapable of saving anyone, including herself"
-  conflictingMotivations:
-    - "Wants to help others but fears getting too close"
-    - "Desires connection but pushes people away"
-    - "Needs to be in control but must learn to trust"
-
-characterArc:
-  arcType: "positive"
-  startingState: "Emotionally isolated, believes she must handle everything alone, defines her worth by her ability to save others"
-  endingState: "Learns to accept help, builds genuine connections, understands that her worth isn't dependent on being perfect or saving everyone"
-  transformation: "From self-reliant isolation to vulnerable connection. Learns that asking for help isn't weakness and that she deserves love not because of what she does, but because of who she is."
-
-relationships:
-  - character: "Marcus Thompson"
-    relationship: "Colleague and potential love interest"
-    description: "Fellow social worker who sees through Sarah's walls. Patient, kind, but won't let her push him away completely."
-    conflictPoints:
-      - "Sarah's inability to accept his help or support"
-      - "Her tendency to prioritize work over personal connection"
-      - "His frustration with her self-destructive patterns"
-  
-  - character: "Elena Rodriguez"
-    relationship: "Client/Mirror character"
-    description: "Young mother struggling with addiction. Reminds Sarah of her own mother. Their relationship becomes the catalyst for Sarah's transformation."
-    conflictPoints:
-      - "Sarah's over-identification with Elena's situation"
-      - "Professional boundaries vs. personal investment"
-      - "Elena's resistance to help mirrors Sarah's own patterns"
-  
-  - character: "Dr. Patricia Hayes"
-    relationship: "Mentor/Supervisor"
-    description: "Sarah's supervisor who recognizes Sarah's talent but worries about her burnout and emotional isolation."
-    conflictPoints:
-      - "Patricia pushes Sarah to take care of herself"
-      - "Challenges Sarah's belief that she must save everyone"
-      - "Forces Sarah to confront her own trauma"
-
-voice:
-  speechPattern: "Measured and professional in work settings. More hesitant and uncertain in personal conversations. Uses humor as deflection."
-  vocabulary: "Professional social work terminology when discussing cases. Simpler, more vulnerable language when discussing personal matters (though she rarely does)."
-  catchphrases:
-    - "I'm fine" (when she's clearly not)
-    - "I've got it handled" (when she's overwhelmed)
-    - "It's not about me" (deflecting from her own needs)
-  accent: "Neutral American, slight working-class inflections that emerge when stressed"
-
-notes: "Sarah's journey is about learning that vulnerability is strength, not weakness. Her arc parallels Elena's - as Sarah helps Elena, she must confront her own need for help. The key is that Sarah can't save Elena (or anyone) until she learns to save herself by accepting that she doesn't have to do it alone."
-
+# Character Profile Example
+# Demonstrates the character-profile.json schema usage
+
+name: "Sarah Mitchell"
+role: "protagonist"
+age: 32
+gender: "Female"
+
+physicalDescription:
+  height: "5'6\""
+  build: "Athletic, runner's physique"
+  hairColor: "Dark brown, shoulder-length"
+  eyeColor: "Green"
+  distinguishingFeatures:
+    - "Small scar above left eyebrow from childhood accident"
+    - "Wears her grandmother's silver locket"
+  appearance: "Professional but approachable. Often wears practical clothing - jeans, comfortable shoes. Minimal makeup. Carries herself with quiet confidence that masks deep insecurity."
+
+personality:
+  traits:
+    - "Intelligent and analytical"
+    - "Compassionate but guarded"
+    - "Perfectionist"
+    - "Self-sacrificing"
+    - "Struggles with vulnerability"
+  strengths:
+    - "Problem-solving ability"
+    - "Empathy for others"
+    - "Determination and resilience"
+    - "Loyalty to those she cares about"
+  weaknesses:
+    - "Difficulty trusting others"
+    - "Tendency to isolate when stressed"
+    - "Fear of failure"
+    - "Puts others' needs before her own to a fault"
+  fears:
+    - "Abandonment"
+    - "Being a burden to others"
+    - "Losing control"
+    - "Repeating her mother's mistakes"
+  desires:
+    - "To build meaningful connections"
+    - "To prove her worth"
+    - "To break free from her past"
+    - "To find a place where she belongs"
+
+backstory:
+  summary: "Raised by a single mother who struggled with addiction, Sarah learned early to be self-reliant. She put herself through college, became a social worker, and dedicated her life to helping others - perhaps as a way to save the mother she couldn't save as a child."
+  formativeEvents:
+    - event: "Mother's first overdose"
+      age: 8
+      impact: "Learned she couldn't rely on adults to take care of her. Became hyper-responsible and self-sufficient."
+    - event: "Placed in foster care temporarily"
+      age: 12
+      impact: "Developed deep fear of abandonment and loss of control. Vowed never to be helpless again."
+    - event: "Mother's death from overdose"
+      age: 19
+      impact: "Reinforced belief that she failed to save someone she loved. Drives her work as a social worker but also her inability to accept help."
+    - event: "Failed engagement at 28"
+      age: 28
+      impact: "Confirmed her fear that she's incapable of maintaining close relationships. Withdrew further emotionally."
+  family: "Only child. Mother deceased. Father unknown. No extended family connections."
+  education: "Bachelor's in Social Work from state university. Graduated with honors while working two jobs."
+  occupation: "Social worker specializing in addiction and family services"
+
+motivations:
+  externalGoal: "To save a troubled family from the same fate as her own"
+  internalGoal: "To learn that she's worthy of love and doesn't have to earn her place in the world"
+  stakes: "If she fails, she'll confirm her deepest fear - that she's fundamentally broken and incapable of saving anyone, including herself"
+  conflictingMotivations:
+    - "Wants to help others but fears getting too close"
+    - "Desires connection but pushes people away"
+    - "Needs to be in control but must learn to trust"
+
+characterArc:
+  arcType: "positive"
+  startingState: "Emotionally isolated, believes she must handle everything alone, defines her worth by her ability to save others"
+  endingState: "Learns to accept help, builds genuine connections, understands that her worth isn't dependent on being perfect or saving everyone"
+  transformation: "From self-reliant isolation to vulnerable connection. Learns that asking for help isn't weakness and that she deserves love not because of what she does, but because of who she is."
+
+relationships:
+  - character: "Marcus Thompson"
+    relationship: "Colleague and potential love interest"
+    description: "Fellow social worker who sees through Sarah's walls. Patient, kind, but won't let her push him away completely."
+    conflictPoints:
+      - "Sarah's inability to accept his help or support"
+      - "Her tendency to prioritize work over personal connection"
+      - "His frustration with her self-destructive patterns"
+  
+  - character: "Elena Rodriguez"
+    relationship: "Client/Mirror character"
+    description: "Young mother struggling with addiction. Reminds Sarah of her own mother. Their relationship becomes the catalyst for Sarah's transformation."
+    conflictPoints:
+      - "Sarah's over-identification with Elena's situation"
+      - "Professional boundaries vs. personal investment"
+      - "Elena's resistance to help mirrors Sarah's own patterns"
+  
+  - character: "Dr. Patricia Hayes"
+    relationship: "Mentor/Supervisor"
+    description: "Sarah's supervisor who recognizes Sarah's talent but worries about her burnout and emotional isolation."
+    conflictPoints:
+      - "Patricia pushes Sarah to take care of herself"
+      - "Challenges Sarah's belief that she must save everyone"
+      - "Forces Sarah to confront her own trauma"
+
+voice:
+  speechPattern: "Measured and professional in work settings. More hesitant and uncertain in personal conversations. Uses humor as deflection."
+  vocabulary: "Professional social work terminology when discussing cases. Simpler, more vulnerable language when discussing personal matters (though she rarely does)."
+  catchphrases:
+    - "I'm fine" (when she's clearly not)
+    - "I've got it handled" (when she's overwhelmed)
+    - "It's not about me" (deflecting from her own needs)
+  accent: "Neutral American, slight working-class inflections that emerge when stressed"
+
+notes: "Sarah's journey is about learning that vulnerability is strength, not weakness. Her arc parallels Elena's - as Sarah helps Elena, she must confront her own need for help. The key is that Sarah can't save Elena (or anyone) until she learns to save herself by accepting that she doesn't have to do it alone."
+

package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain

@@ -1,151 +1,151 @@
-Title: MOUNTAIN PEAK COFFEE - 30 SECOND SPOT
-Credit: Written by
-Author: Example Commercial Script
-Draft date: 01/31/2026
-Format: Commercial
-
-===
-
-COMMERCIAL: MOUNTAIN PEAK COFFEE
-LENGTH: :30
-CLIENT: Mountain Peak Coffee Co.
-PRODUCT: Premium Organic Coffee
-TARGET: Adults 25-45, coffee enthusiasts
-
----
-
-FADE IN:
-
-EXT. MOUNTAIN SUMMIT - DAWN
-
-Golden sunlight breaks over a snow-capped mountain peak. Breathtaking vista.
-
-SUPER: "5:47 AM"
-
-:00-:03
-
-A HIKER (30s) reaches the summit, removes backpack, pulls out a thermos.
-
-:03-:06
-
-CLOSE ON: Steam rising from the thermos as she pours coffee into a cup.
-
-:06-:08
-
-She takes a sip. Eyes close. Moment of pure satisfaction.
-
-:08-:10
-
-WIDE SHOT: Hiker silhouetted against the sunrise, coffee in hand.
-
-:10-:12
-
-VOICEOVER (V.O.)
-(warm, authentic)
-Some moments deserve exceptional coffee.
-
-:12-:15
-
-QUICK CUTS:
-- Coffee beans being roasted
-- Hands carefully packaging coffee
-- Mountain Peak Coffee logo on bag
-
-:15-:18
-
-VOICEOVER (V.O.)
-Mountain Peak Coffee. Organically grown at high altitude. Roasted in small batches. Crafted for moments that matter.
-
-:18-:24
-
-BACK TO: Hiker on summit, taking another sip, smiling at the view.
-
-:24-:26
-
-PRODUCT SHOT: Mountain Peak Coffee bag against mountain backdrop.
-
-SUPER: "MOUNTAIN PEAK COFFEE"
-SUPER: "Elevate Your Morning"
-
-:26-:28
-
-VOICEOVER (V.O.)
-Mountain Peak Coffee. Elevate your morning.
-
-:28-:30
-
-FADE OUT.
-
----
-
-PRODUCTION NOTES:
-
-VISUAL STYLE:
-- Natural lighting, golden hour cinematography
-- Authentic, documentary feel
-- Emphasis on natural beauty and craftsmanship
-
-MUSIC:
-- Gentle acoustic guitar
-- Builds subtly with sunrise
-- Warm, inviting tone
-
-SOUND DESIGN:
-- Mountain wind (subtle)
-- Coffee pouring
-- Thermos opening
-- Natural ambiance
-
-TALENT:
-- 1 principal (hiker)
-- Authentic, relatable, diverse casting
-
-LOCATIONS:
-- Mountain summit (sunrise shoot)
-- Coffee roasting facility (B-roll)
-
-PROPS:
-- Hiking gear (backpack, thermos)
-- Mountain Peak Coffee products
-- Coffee brewing equipment
-
-CALL TO ACTION:
-- Brand name and tagline
-- Emphasis on quality and experience
-- Emotional connection to product
-
-BRAND MESSAGING:
-- Premium quality
-- Organic/sustainable
-- Craftsmanship
-- Moments that matter
-- Authentic experience
-
-TARGET EMOTION:
-- Aspiration
-- Satisfaction
-- Connection to nature
-- Quality of life
-
----
-
-SHOT LIST:
-
-1. Wide: Mountain peak at dawn (:00-:03)
-2. Medium: Hiker reaching summit (:03-:06)
-3. Close: Coffee pouring from thermos (:06-:08)
-4. Close: Hiker's face, eyes closed, sipping (:08-:10)
-5. Wide: Silhouette against sunrise (:10-:12)
-6. Close: Coffee beans roasting (:15-:16)
-7. Close: Hands packaging coffee (:16-:17)
-8. Close: Mountain Peak logo (:17-:18)
-9. Medium: Hiker enjoying view (:24-:26)
-10. Product shot: Coffee bag (:26-:28)
-
-TIMING BREAKDOWN:
-- Opening visual: 12 seconds
-- VO + product shots: 12 seconds
-- Closing visual + CTA: 6 seconds
-
-END COMMERCIAL
-
+Title: MOUNTAIN PEAK COFFEE - 30 SECOND SPOT
+Credit: Written by
+Author: Example Commercial Script
+Draft date: 01/31/2026
+Format: Commercial
+
+===
+
+COMMERCIAL: MOUNTAIN PEAK COFFEE
+LENGTH: :30
+CLIENT: Mountain Peak Coffee Co.
+PRODUCT: Premium Organic Coffee
+TARGET: Adults 25-45, coffee enthusiasts
+
+---
+
+FADE IN:
+
+EXT. MOUNTAIN SUMMIT - DAWN
+
+Golden sunlight breaks over a snow-capped mountain peak. Breathtaking vista.
+
+SUPER: "5:47 AM"
+
+:00-:03
+
+A HIKER (30s) reaches the summit, removes backpack, pulls out a thermos.
+
+:03-:06
+
+CLOSE ON: Steam rising from the thermos as she pours coffee into a cup.
+
+:06-:08
+
+She takes a sip. Eyes close. Moment of pure satisfaction.
+
+:08-:10
+
+WIDE SHOT: Hiker silhouetted against the sunrise, coffee in hand.
+
+:10-:12
+
+VOICEOVER (V.O.)
+(warm, authentic)
+Some moments deserve exceptional coffee.
+
+:12-:15
+
+QUICK CUTS:
+- Coffee beans being roasted
+- Hands carefully packaging coffee
+- Mountain Peak Coffee logo on bag
+
+:15-:18
+
+VOICEOVER (V.O.)
+Mountain Peak Coffee. Organically grown at high altitude. Roasted in small batches. Crafted for moments that matter.
+
+:18-:24
+
+BACK TO: Hiker on summit, taking another sip, smiling at the view.
+
+:24-:26
+
+PRODUCT SHOT: Mountain Peak Coffee bag against mountain backdrop.
+
+SUPER: "MOUNTAIN PEAK COFFEE"
+SUPER: "Elevate Your Morning"
+
+:26-:28
+
+VOICEOVER (V.O.)
+Mountain Peak Coffee. Elevate your morning.
+
+:28-:30
+
+FADE OUT.
+
+---
+
+PRODUCTION NOTES:
+
+VISUAL STYLE:
+- Natural lighting, golden hour cinematography
+- Authentic, documentary feel
+- Emphasis on natural beauty and craftsmanship
+
+MUSIC:
+- Gentle acoustic guitar
+- Builds subtly with sunrise
+- Warm, inviting tone
+
+SOUND DESIGN:
+- Mountain wind (subtle)
+- Coffee pouring
+- Thermos opening
+- Natural ambiance
+
+TALENT:
+- 1 principal (hiker)
+- Authentic, relatable, diverse casting
+
+LOCATIONS:
+- Mountain summit (sunrise shoot)
+- Coffee roasting facility (B-roll)
+
+PROPS:
+- Hiking gear (backpack, thermos)
+- Mountain Peak Coffee products
+- Coffee brewing equipment
+
+CALL TO ACTION:
+- Brand name and tagline
+- Emphasis on quality and experience
+- Emotional connection to product
+
+BRAND MESSAGING:
+- Premium quality
+- Organic/sustainable
+- Craftsmanship
+- Moments that matter
+- Authentic experience
+
+TARGET EMOTION:
+- Aspiration
+- Satisfaction
+- Connection to nature
+- Quality of life
+
+---
+
+SHOT LIST:
+
+1. Wide: Mountain peak at dawn (:00-:03)
+2. Medium: Hiker reaching summit (:03-:06)
+3. Close: Coffee pouring from thermos (:06-:08)
+4. Close: Hiker's face, eyes closed, sipping (:08-:10)
+5. Wide: Silhouette against sunrise (:10-:12)
+6. Close: Coffee beans roasting (:15-:16)
+7. Close: Hands packaging coffee (:16-:17)
+8. Close: Mountain Peak logo (:17-:18)
+9. Medium: Hiker enjoying view (:24-:26)
+10. Product shot: Coffee bag (:26-:28)
+
+TIMING BREAKDOWN:
+- Opening visual: 12 seconds
+- VO + product shots: 12 seconds
+- Closing visual + CTA: 6 seconds
+
+END COMMERCIAL
+

package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain

@@ -1,67 +1,67 @@
-Title: The Weight of Silence
-Credit: Written by
-Author: Example Screenplay
-Draft date: 01/31/2026
-Contact:
-    Example Productions
-    example@screenplay.com
-
-===
-
-INT. SMALL APARTMENT - NIGHT
-
-A cramped studio apartment. Peeling wallpaper. A single window overlooks a fire escape. SARAH (32), disheveled, sits on the edge of a worn couch, staring at a photograph in her hands.
-
-The room is silent except for the distant hum of traffic.
-
-She sets the photo down gently on the coffee table - it shows a younger version of herself with a man, both smiling.
-
-SARAH
-(quietly, to herself)
-You know what the hardest part is?
-
-She stands, walks to the window. Her reflection stares back at her.
-
-SARAH (CONT'D)
-It's not the big moments. Not the funeral, not the condolences, not even the empty side of the bed.
-
-She touches the glass, her fingers leaving prints.
-
-SARAH (CONT'D)
-It's the small things. The way you'd leave your coffee cup on the counter, half-finished. How you'd hum that stupid song in the shower - what was it? Something from the eighties.
-
-A bitter laugh escapes her.
-
-SARAH (CONT'D)
-I used to hate that. The humming. The half-finished coffee. The way you'd leave your shoes right in the middle of the hallway where I'd trip over them every single morning.
-
-She turns away from the window, her voice breaking.
-
-SARAH (CONT'D)
-And now... now I'd give anything to trip over those shoes one more time. To hear that off-key humming. To pour out that cold coffee and complain about the waste.
-
-She sinks back onto the couch, picking up the photograph again.
-
-SARAH (CONT'D)
-Everyone keeps telling me it gets easier. That time heals. But they don't understand - I don't want it to get easier. Because easier means forgetting. And forgetting means losing you all over again.
-
-Tears stream down her face now.
-
-SARAH (CONT'D)
-So I keep your coffee cup on the counter. I play that eighties song every morning. I leave your shoes in the hallway.
-
-She clutches the photograph to her chest.
-
-SARAH (CONT'D)
-Because if I can't have you here... at least I can keep you close. Even if it hurts. Especially because it hurts.
-
-She closes her eyes, rocking slightly.
-
-SARAH (CONT'D)
-(whispered)
-I'm not ready to let go. I don't know if I ever will be.
-
-The room falls silent again. Sarah sits motionless, the photograph pressed against her heart.
-
-FADE OUT.
-
+Title: The Weight of Silence
+Credit: Written by
+Author: Example Screenplay
+Draft date: 01/31/2026
+Contact:
+    Example Productions
+    example@screenplay.com
+
+===
+
+INT. SMALL APARTMENT - NIGHT
+
+A cramped studio apartment. Peeling wallpaper. A single window overlooks a fire escape. SARAH (32), disheveled, sits on the edge of a worn couch, staring at a photograph in her hands.
+
+The room is silent except for the distant hum of traffic.
+
+She sets the photo down gently on the coffee table - it shows a younger version of herself with a man, both smiling.
+
+SARAH
+(quietly, to herself)
+You know what the hardest part is?
+
+She stands, walks to the window. Her reflection stares back at her.
+
+SARAH (CONT'D)
+It's not the big moments. Not the funeral, not the condolences, not even the empty side of the bed.
+
+She touches the glass, her fingers leaving prints.
+
+SARAH (CONT'D)
+It's the small things. The way you'd leave your coffee cup on the counter, half-finished. How you'd hum that stupid song in the shower - what was it? Something from the eighties.
+
+A bitter laugh escapes her.
+
+SARAH (CONT'D)
+I used to hate that. The humming. The half-finished coffee. The way you'd leave your shoes right in the middle of the hallway where I'd trip over them every single morning.
+
+She turns away from the window, her voice breaking.
+
+SARAH (CONT'D)
+And now... now I'd give anything to trip over those shoes one more time. To hear that off-key humming. To pour out that cold coffee and complain about the waste.
+
+She sinks back onto the couch, picking up the photograph again.
+
+SARAH (CONT'D)
+Everyone keeps telling me it gets easier. That time heals. But they don't understand - I don't want it to get easier. Because easier means forgetting. And forgetting means losing you all over again.
+
+Tears stream down her face now.
+
+SARAH (CONT'D)
+So I keep your coffee cup on the counter. I play that eighties song every morning. I leave your shoes in the hallway.
+
+She clutches the photograph to her chest.
+
+SARAH (CONT'D)
+Because if I can't have you here... at least I can keep you close. Even if it hurts. Especially because it hurts.
+
+She closes her eyes, rocking slightly.
+
+SARAH (CONT'D)
+(whispered)
+I'm not ready to let go. I don't know if I ever will be.
+
+The room falls silent again. Sarah sits motionless, the photograph pressed against her heart.
+
+FADE OUT.
+