@mytechtoday/augment-extensions 0.7.0 → 1.2.0

package/augment-extensions/writing-standards/screenplay/examples/aaa-hollywood-scene.fountain

@@ -1,164 +1,164 @@
-Title: THE LAST PROTOCOL
-Credit: Written by
-Author: AI Agent (Example)
-Draft date: 2026-01-30
-
-===
-
-FADE IN:
-
-EXT. TOKYO SKYLINE - NIGHT
-
-Neon lights pierce through rain. A city that never sleeps.
-
-INT. PENTHOUSE APARTMENT - CONTINUOUS
-
-Floor-to-ceiling windows overlook the city. Minimalist. Cold.
-
-ALEX CHEN, 35, ex-military, scars tell stories, stands at the window. Phone to ear.
-
-ALEX
-(into phone)
-I'm out. Find someone else.
-
-VOICE (V.O.)
-(filtered, distorted)
-You don't get to be out, Alex. Not after what you know.
-
-Alex hangs up. Tosses the phone on a glass table.
-
-A RED DOT appears on the window. Laser sight.
-
-Alex DIVES as the window EXPLODES. Glass rains down.
-
-EXT. ROOFTOP ACROSS THE STREET - CONTINUOUS
-
-SNIPER, masked, adjusts scope. Fires again.
-
-INT. PENTHOUSE APARTMENT - CONTINUOUS
-
-Alex rolls behind a concrete pillar. Pulls a GLOCK from an ankle holster.
-
-ALEX
-(to herself)
-So much for retirement.
-
-She low-crawls to a side door. Bullets PUNCH through the walls above her.
-
-INT. PENTHOUSE HALLWAY - CONTINUOUS
-
-Alex bursts through. Sprints toward the elevator.
-
-The elevator doors are CLOSING. She slides through just in time.
-
-INT. ELEVATOR - CONTINUOUS
-
-Alex catches her breath. Checks the gun. Full magazine.
-
-The elevator LURCHES. Stops between floors.
-
-VOICE (V.O.)
-(over speaker)
-Going somewhere?
-
-The lights CUT OUT. Emergency lighting kicks in. Red glow.
-
-ALEX
-(calm, deadly)
-You made a mistake.
-
-She PUNCHES through the ceiling panel. Pulls herself up.
-
-INT. ELEVATOR SHAFT - CONTINUOUS
-
-Alex climbs the cable. Hand over hand. Thirty floors up.
-
-Below, the elevator PLUMMETS. CRASHES at the bottom.
-
-Alex doesn't look down. Keeps climbing.
-
-She reaches a maintenance door. Kicks it open.
-
-INT. MAINTENANCE CORRIDOR - CONTINUOUS
-
-Narrow. Pipes and wiring. Alex moves fast.
-
-A FIGURE steps out ahead. Gun raised.
-
-OPERATIVE
-End of the line.
-
-Alex doesn't slow down. Runs STRAIGHT at him.
-
-The Operative FIRES. Alex slides under the shot. Sweeps his legs.
-
-He goes down. Alex disarms him in one fluid motion.
-
-ALEX
-Who sent you?
-
-OPERATIVE
-(laughing)
-You really don't know, do you?
-
-Alex pistol-whips him. He's out cold.
-
-She takes his radio. Listens.
-
-RADIO VOICE (V.O.)
-Target is in the maintenance level. All units converge.
-
-ALEX
-(into radio, mimicking)
-Copy that. Moving to intercept.
-
-She drops the radio. Crushes it under her boot.
-
-INT. PARKING GARAGE - MOMENTS LATER
-
-Alex emerges from a service door. Scans the area.
-
-Rows of luxury cars. Empty. Too quiet.
-
-She moves between vehicles. Reaches a BLACK MOTORCYCLE.
-
-Hotwires it in seconds. Engine ROARS to life.
-
-HEADLIGHTS flood the garage. Three BLACK SUVS screech in.
-
-ALEX
-(smirking)
-Showtime.
-
-She GUNS the throttle. The motorcycle LAUNCHES forward.
-
-The SUVs give chase. Bullets RICOCHET off concrete pillars.
-
-Alex weaves through the garage. Hits a ramp. Goes AIRBORNE.
-
-EXT. CITY STREET - CONTINUOUS
-
-The motorcycle lands hard. Alex doesn't flinch.
-
-She races through traffic. The SUVs follow, smashing through cars.
-
-PEDESTRIANS scatter. Horns BLARE.
-
-Alex spots an alley. Cuts hard right.
-
-EXT. NARROW ALLEY - CONTINUOUS
-
-Barely wide enough for the bike. The SUVs can't follow.
-
-Alex emerges on the other side. Slows down. Blends into traffic.
-
-She pulls out a burner phone. Dials.
-
-ALEX
-(into phone)
-It's me. I need a favor.
-
-FADE OUT.
-
-THE END
-
+Title: THE LAST PROTOCOL
+Credit: Written by
+Author: AI Agent (Example)
+Draft date: 2026-01-30
+
+===
+
+FADE IN:
+
+EXT. TOKYO SKYLINE - NIGHT
+
+Neon lights pierce through rain. A city that never sleeps.
+
+INT. PENTHOUSE APARTMENT - CONTINUOUS
+
+Floor-to-ceiling windows overlook the city. Minimalist. Cold.
+
+ALEX CHEN, 35, ex-military, scars tell stories, stands at the window. Phone to ear.
+
+ALEX
+(into phone)
+I'm out. Find someone else.
+
+VOICE (V.O.)
+(filtered, distorted)
+You don't get to be out, Alex. Not after what you know.
+
+Alex hangs up. Tosses the phone on a glass table.
+
+A RED DOT appears on the window. Laser sight.
+
+Alex DIVES as the window EXPLODES. Glass rains down.
+
+EXT. ROOFTOP ACROSS THE STREET - CONTINUOUS
+
+SNIPER, masked, adjusts scope. Fires again.
+
+INT. PENTHOUSE APARTMENT - CONTINUOUS
+
+Alex rolls behind a concrete pillar. Pulls a GLOCK from an ankle holster.
+
+ALEX
+(to herself)
+So much for retirement.
+
+She low-crawls to a side door. Bullets PUNCH through the walls above her.
+
+INT. PENTHOUSE HALLWAY - CONTINUOUS
+
+Alex bursts through. Sprints toward the elevator.
+
+The elevator doors are CLOSING. She slides through just in time.
+
+INT. ELEVATOR - CONTINUOUS
+
+Alex catches her breath. Checks the gun. Full magazine.
+
+The elevator LURCHES. Stops between floors.
+
+VOICE (V.O.)
+(over speaker)
+Going somewhere?
+
+The lights CUT OUT. Emergency lighting kicks in. Red glow.
+
+ALEX
+(calm, deadly)
+You made a mistake.
+
+She PUNCHES through the ceiling panel. Pulls herself up.
+
+INT. ELEVATOR SHAFT - CONTINUOUS
+
+Alex climbs the cable. Hand over hand. Thirty floors up.
+
+Below, the elevator PLUMMETS. CRASHES at the bottom.
+
+Alex doesn't look down. Keeps climbing.
+
+She reaches a maintenance door. Kicks it open.
+
+INT. MAINTENANCE CORRIDOR - CONTINUOUS
+
+Narrow. Pipes and wiring. Alex moves fast.
+
+A FIGURE steps out ahead. Gun raised.
+
+OPERATIVE
+End of the line.
+
+Alex doesn't slow down. Runs STRAIGHT at him.
+
+The Operative FIRES. Alex slides under the shot. Sweeps his legs.
+
+He goes down. Alex disarms him in one fluid motion.
+
+ALEX
+Who sent you?
+
+OPERATIVE
+(laughing)
+You really don't know, do you?
+
+Alex pistol-whips him. He's out cold.
+
+She takes his radio. Listens.
+
+RADIO VOICE (V.O.)
+Target is in the maintenance level. All units converge.
+
+ALEX
+(into radio, mimicking)
+Copy that. Moving to intercept.
+
+She drops the radio. Crushes it under her boot.
+
+INT. PARKING GARAGE - MOMENTS LATER
+
+Alex emerges from a service door. Scans the area.
+
+Rows of luxury cars. Empty. Too quiet.
+
+She moves between vehicles. Reaches a BLACK MOTORCYCLE.
+
+Hotwires it in seconds. Engine ROARS to life.
+
+HEADLIGHTS flood the garage. Three BLACK SUVS screech in.
+
+ALEX
+(smirking)
+Showtime.
+
+She GUNS the throttle. The motorcycle LAUNCHES forward.
+
+The SUVs give chase. Bullets RICOCHET off concrete pillars.
+
+Alex weaves through the garage. Hits a ramp. Goes AIRBORNE.
+
+EXT. CITY STREET - CONTINUOUS
+
+The motorcycle lands hard. Alex doesn't flinch.
+
+She races through traffic. The SUVs follow, smashing through cars.
+
+PEDESTRIANS scatter. Horns BLARE.
+
+Alex spots an alley. Cuts hard right.
+
+EXT. NARROW ALLEY - CONTINUOUS
+
+Barely wide enough for the bike. The SUVs can't follow.
+
+Alex emerges on the other side. Slows down. Blends into traffic.
+
+She pulls out a burner phone. Dials.
+
+ALEX
+(into phone)
+It's me. I need a favor.
+
+FADE OUT.
+
+THE END
+

package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml

@@ -1,95 +1,95 @@
-# Beat Sheet Example - Save the Cat Structure
-# Demonstrates the beat-sheet.json schema usage
-# Based on a psychological thriller about a social worker
-
-title: "The Weight We Carry"
-logline: "A dedicated social worker must confront her own traumatic past when a case mirrors the addiction that destroyed her family."
-genre: "Psychological Drama/Thriller"
-targetLength: 110
-
-beats:
-  openingImage:
-    page: 1
-    description: "Sarah sits alone in her car outside a rundown apartment building at 3 AM, watching a window. She's been here before - many times. This is her life: watching, waiting, trying to save people who don't want to be saved."
-    visualMetaphor: "Sarah isolated in her car, separated from the world by glass - representing her emotional isolation and her role as observer rather than participant in life."
-
-  themeStated:
-    page: 5
-    description: "Sarah's supervisor, Dr. Hayes, tells her during a review meeting."
-    dialogue: "You can't save everyone, Sarah. And you can't save anyone if you don't save yourself first."
-
-  catalyst:
-    page: 12
-    description: "Sarah is assigned a new case: Elena Rodriguez, a young mother with a 6-year-old daughter, struggling with opioid addiction. When Sarah meets Elena, she's shocked - Elena could be her mother 25 years ago. Same age, same situation, same desperate eyes."
-    impact: "Sarah sees a chance to save the mother she couldn't save as a child. She becomes obsessed with Elena's case."
-
-  debate:
-    page: 15
-    description: "Sarah debates whether to take the case. Dr. Hayes warns her she's too personally invested. Marcus, her colleague, offers to take it instead. But Sarah can't let go - this is her chance to rewrite history."
-    internalConflict: "Should she recuse herself from a case that's clearly triggering her own trauma, or is this her opportunity to finally make things right?"
-
-  breakIntoTwo:
-    page: 25
-    description: "Sarah commits to Elena's case despite warnings. She promises Elena's daughter, Sofia, that she'll keep her family together. It's a promise she couldn't keep for her own family."
-    decision: "Sarah officially takes on Elena's case and begins intensive intervention, crossing professional boundaries in her determination to succeed."
-
-  bStory:
-    page: 30
-    description: "Marcus becomes more present in Sarah's life. He's been interested in her for months, but she's always kept him at arm's length. Now, as the case intensifies, he refuses to let her isolate herself completely."
-    characters:
-      - "Sarah Mitchell"
-      - "Marcus Thompson"
-
-  funAndGames:
-    page: 35
-    description: "Sarah throws herself into helping Elena. We see her success: Elena enters rehab, starts attending meetings, reconnects with her daughter. Sarah feels like she's finally winning. She also begins to open up to Marcus, allowing small moments of connection."
-    setpieces:
-      - "Emotional breakthrough session with Elena"
-      - "Sarah and Marcus's first real conversation over late-night coffee"
-      - "Sofia's joy when Elena completes 30 days sober"
-      - "Sarah letting Marcus see her apartment (her private space) for the first time"
-
-  midpoint:
-    page: 55
-    description: "False victory: Elena celebrates 60 days sober. Sarah is praised at work. She and Marcus share their first kiss. For the first time in years, Sarah feels like she might deserve happiness. Stakes are raised when Elena's abusive ex-boyfriend is released from prison."
-    type: "false-victory"
-    stakeRaise: "Elena's ex, the source of her trauma and addiction, returns. Sarah's personal investment deepens as she sees parallels to her own mother's destructive relationships."
-
-  badGuysCloseIn:
-    page: 60
-    description: "Elena's ex manipulates his way back into her life. Elena starts missing meetings. Sarah becomes increasingly desperate, working longer hours, neglecting her own wellbeing. Marcus tries to help but Sarah pushes him away. Dr. Hayes threatens to remove Sarah from the case."
-    escalation:
-      - "Elena misses a supervised visit with Sofia"
-      - "Sarah finds evidence Elena is using again"
-      - "Marcus confronts Sarah about her obsessive behavior"
-      - "Dr. Hayes officially warns Sarah about boundary violations"
-      - "Sarah's own trauma symptoms intensify - insomnia, anxiety, flashbacks"
-
-  allIsLost:
-    page: 75
-    description: "Elena overdoses. She survives, but Sofia is removed from her care and placed in foster care. Sarah has failed - just like she failed her mother. Dr. Hayes removes her from the case. Marcus tells her he can't watch her destroy herself anymore."
-    whiffOfDeath: "Elena's overdose mirrors Sarah's mother's death. Sarah has a panic attack, reliving finding her mother's body."
-
-  darkNightOfTheSoul:
-    page: 85
-    description: "Sarah sits alone in her apartment, surrounded by Elena's case files. She's lost everything - the case, Marcus, her sense of purpose. She looks at an old photo of her mother and realizes: she's been trying to save her mother through Elena, but her mother is gone. She can't change the past."
-    realization: "Sarah realizes she's been running from her own pain by trying to fix everyone else. She can't save Elena or anyone else until she confronts her own trauma and accepts that her mother's death wasn't her fault."
-
-  breakIntoThree:
-    page: 90
-    description: "Sarah does something she's never done: she asks for help. She calls Marcus and admits she needs support. She starts seeing a therapist. She visits Elena in the hospital - not as a savior, but as someone who understands."
-    solution: "Instead of trying to save Elena, Sarah offers her something more valuable: the truth that recovery is possible, but it has to be Elena's choice, not Sarah's mission."
-
-  finale:
-    page: 95
-    description: "Sarah testifies at Elena's custody hearing. Instead of making promises she can't keep, she tells the truth: recovery is hard, relapse is part of the process, but Elena deserves the chance to fight for her daughter. Elena chooses rehab - for herself, not for Sarah. Sarah reconnects with Marcus, this time with honesty and vulnerability. She begins her own healing journey."
-    climax: "Elena must choose between her ex and her daughter. Sarah must choose between her savior complex and genuine connection."
-    resolution: "Elena chooses recovery (though the outcome is uncertain). Sarah chooses vulnerability and begins building real relationships. Sofia gets a chance at stability, whether with Elena or in a loving foster home."
-
-  finalImage:
-    page: 110
-    description: "Sarah sits in her car outside an apartment building - but this time, Marcus is with her. She's not alone anymore. She's not watching from outside; she's part of the world. She gets out of the car and walks toward her own apartment, toward her own life."
-    transformation: "The opening image showed Sarah isolated, watching life from behind glass. The final image shows her connected, participating, moving forward. She's learned that she can't save everyone, but she can save herself - and that's enough."
-
-notes: "This beat sheet follows the Save the Cat structure while telling a character-driven story about trauma, codependency, and healing. The external plot (saving Elena) drives the internal plot (Sarah saving herself). Each beat serves both the plot and character arc."
-
+# Beat Sheet Example - Save the Cat Structure
+# Demonstrates the beat-sheet.json schema usage
+# Based on a psychological thriller about a social worker
+
+title: "The Weight We Carry"
+logline: "A dedicated social worker must confront her own traumatic past when a case mirrors the addiction that destroyed her family."
+genre: "Psychological Drama/Thriller"
+targetLength: 110
+
+beats:
+  openingImage:
+    page: 1
+    description: "Sarah sits alone in her car outside a rundown apartment building at 3 AM, watching a window. She's been here before - many times. This is her life: watching, waiting, trying to save people who don't want to be saved."
+    visualMetaphor: "Sarah isolated in her car, separated from the world by glass - representing her emotional isolation and her role as observer rather than participant in life."
+
+  themeStated:
+    page: 5
+    description: "Sarah's supervisor, Dr. Hayes, tells her during a review meeting."
+    dialogue: "You can't save everyone, Sarah. And you can't save anyone if you don't save yourself first."
+
+  catalyst:
+    page: 12
+    description: "Sarah is assigned a new case: Elena Rodriguez, a young mother with a 6-year-old daughter, struggling with opioid addiction. When Sarah meets Elena, she's shocked - Elena could be her mother 25 years ago. Same age, same situation, same desperate eyes."
+    impact: "Sarah sees a chance to save the mother she couldn't save as a child. She becomes obsessed with Elena's case."
+
+  debate:
+    page: 15
+    description: "Sarah debates whether to take the case. Dr. Hayes warns her she's too personally invested. Marcus, her colleague, offers to take it instead. But Sarah can't let go - this is her chance to rewrite history."
+    internalConflict: "Should she recuse herself from a case that's clearly triggering her own trauma, or is this her opportunity to finally make things right?"
+
+  breakIntoTwo:
+    page: 25
+    description: "Sarah commits to Elena's case despite warnings. She promises Elena's daughter, Sofia, that she'll keep her family together. It's a promise she couldn't keep for her own family."
+    decision: "Sarah officially takes on Elena's case and begins intensive intervention, crossing professional boundaries in her determination to succeed."
+
+  bStory:
+    page: 30
+    description: "Marcus becomes more present in Sarah's life. He's been interested in her for months, but she's always kept him at arm's length. Now, as the case intensifies, he refuses to let her isolate herself completely."
+    characters:
+      - "Sarah Mitchell"
+      - "Marcus Thompson"
+
+  funAndGames:
+    page: 35
+    description: "Sarah throws herself into helping Elena. We see her success: Elena enters rehab, starts attending meetings, reconnects with her daughter. Sarah feels like she's finally winning. She also begins to open up to Marcus, allowing small moments of connection."
+    setpieces:
+      - "Emotional breakthrough session with Elena"
+      - "Sarah and Marcus's first real conversation over late-night coffee"
+      - "Sofia's joy when Elena completes 30 days sober"
+      - "Sarah letting Marcus see her apartment (her private space) for the first time"
+
+  midpoint:
+    page: 55
+    description: "False victory: Elena celebrates 60 days sober. Sarah is praised at work. She and Marcus share their first kiss. For the first time in years, Sarah feels like she might deserve happiness. Stakes are raised when Elena's abusive ex-boyfriend is released from prison."
+    type: "false-victory"
+    stakeRaise: "Elena's ex, the source of her trauma and addiction, returns. Sarah's personal investment deepens as she sees parallels to her own mother's destructive relationships."
+
+  badGuysCloseIn:
+    page: 60
+    description: "Elena's ex manipulates his way back into her life. Elena starts missing meetings. Sarah becomes increasingly desperate, working longer hours, neglecting her own wellbeing. Marcus tries to help but Sarah pushes him away. Dr. Hayes threatens to remove Sarah from the case."
+    escalation:
+      - "Elena misses a supervised visit with Sofia"
+      - "Sarah finds evidence Elena is using again"
+      - "Marcus confronts Sarah about her obsessive behavior"
+      - "Dr. Hayes officially warns Sarah about boundary violations"
+      - "Sarah's own trauma symptoms intensify - insomnia, anxiety, flashbacks"
+
+  allIsLost:
+    page: 75
+    description: "Elena overdoses. She survives, but Sofia is removed from her care and placed in foster care. Sarah has failed - just like she failed her mother. Dr. Hayes removes her from the case. Marcus tells her he can't watch her destroy herself anymore."
+    whiffOfDeath: "Elena's overdose mirrors Sarah's mother's death. Sarah has a panic attack, reliving finding her mother's body."
+
+  darkNightOfTheSoul:
+    page: 85
+    description: "Sarah sits alone in her apartment, surrounded by Elena's case files. She's lost everything - the case, Marcus, her sense of purpose. She looks at an old photo of her mother and realizes: she's been trying to save her mother through Elena, but her mother is gone. She can't change the past."
+    realization: "Sarah realizes she's been running from her own pain by trying to fix everyone else. She can't save Elena or anyone else until she confronts her own trauma and accepts that her mother's death wasn't her fault."
+
+  breakIntoThree:
+    page: 90
+    description: "Sarah does something she's never done: she asks for help. She calls Marcus and admits she needs support. She starts seeing a therapist. She visits Elena in the hospital - not as a savior, but as someone who understands."
+    solution: "Instead of trying to save Elena, Sarah offers her something more valuable: the truth that recovery is possible, but it has to be Elena's choice, not Sarah's mission."
+
+  finale:
+    page: 95
+    description: "Sarah testifies at Elena's custody hearing. Instead of making promises she can't keep, she tells the truth: recovery is hard, relapse is part of the process, but Elena deserves the chance to fight for her daughter. Elena chooses rehab - for herself, not for Sarah. Sarah reconnects with Marcus, this time with honesty and vulnerability. She begins her own healing journey."
+    climax: "Elena must choose between her ex and her daughter. Sarah must choose between her savior complex and genuine connection."
+    resolution: "Elena chooses recovery (though the outcome is uncertain). Sarah chooses vulnerability and begins building real relationships. Sofia gets a chance at stability, whether with Elena or in a loving foster home."
+
+  finalImage:
+    page: 110
+    description: "Sarah sits in her car outside an apartment building - but this time, Marcus is with her. She's not alone anymore. She's not watching from outside; she's part of the world. She gets out of the car and walks toward her own apartment, toward her own life."
+    transformation: "The opening image showed Sarah isolated, watching life from behind glass. The final image shows her connected, participating, moving forward. She's learned that she can't save everyone, but she can save herself - and that's enough."
+
+notes: "This beat sheet follows the Save the Cat structure while telling a character-driven story about trauma, codependency, and healing. The external plot (saving Elena) drives the internal plot (Sarah saving herself). Each beat serves both the plot and character arc."
+