@mytechtoday/augment-extensions 0.2.0 → 0.5.0

package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain

@@ -0,0 +1,204 @@
+Title: DARK HARBOR
+Episode: 1x05 - "The Lighthouse Keeper"
+Credit: Written by
+Author: Example Screenplay
+Draft date: 01/31/2026
+
+===
+
+TEASER
+
+FADE IN:
+
+EXT. ROCKY COASTLINE - NIGHT
+
+Waves crash against jagged rocks. A lighthouse beam cuts through thick fog, rotating slowly.
+
+SUPER: "DARK HARBOR, MAINE - 11:47 PM"
+
+INT. LIGHTHOUSE - KEEPER'S QUARTERS - NIGHT
+
+THOMAS BRENNAN (58), weathered face, flannel shirt, sits at a small desk writing in a logbook. The lighthouse beam sweeps past the window every few seconds, illuminating the room in rhythmic flashes.
+
+A RADIO CRACKLES on the desk.
+
+DISPATCHER (V.O.)
+(through radio)
+Lighthouse Station Seven, this is Harbor Patrol. Do you copy?
+
+Thomas picks up the radio.
+
+THOMAS
+This is Station Seven. Go ahead, Harbor Patrol.
+
+DISPATCHER (V.O.)
+We're getting reports of a vessel in distress approximately two miles northeast of your position. Can you confirm visual?
+
+Thomas stands, walks to the window, peers out into the fog.
+
+THOMAS
+Negative, Harbor Patrol. Visibility is near zero. I can barely see past the rocks.
+
+DISPATCHER (V.O.)
+Copy that. Keep your eyes open. Coast Guard is en route but they're twenty minutes out.
+
+THOMAS
+Will do.
+
+He sets down the radio, returns to the window. The beam sweeps across the fog.
+
+Then - a FLASH OF LIGHT in the distance. Not the lighthouse beam. Something else.
+
+Thomas grabs binoculars, scans the water.
+
+THOMAS (CONT'D)
+(into radio)
+Harbor Patrol, I've got something. Looks like... wait.
+
+Through the binoculars: A SMALL BOAT, adrift. No lights. No movement.
+
+THOMAS (CONT'D)
+I've got visual on a vessel. Appears to be a fishing boat, maybe twenty-footer. Dead in the water.
+
+DISPATCHER (V.O.)
+Any signs of crew?
+
+Thomas adjusts the binoculars. Squints.
+
+THOMAS
+Can't tell from here. I'm going to take the launch out for a closer look.
+
+DISPATCHER (V.O.)
+Negative, Station Seven. Wait for Coast Guard.
+
+THOMAS
+They're twenty minutes out. If someone's in the water, they don't have twenty minutes.
+
+He's already moving, grabbing a jacket and flashlight.
+
+EXT. LIGHTHOUSE DOCK - NIGHT
+
+Thomas climbs into a small motorboat, starts the engine. It ROARS to life.
+
+He steers into the fog, the lighthouse beam fading behind him.
+
+EXT. OPEN WATER - NIGHT
+
+The motorboat cuts through choppy waves. Thomas keeps his flashlight trained ahead.
+
+The abandoned fishing boat comes into view, rocking with the waves.
+
+THOMAS
+(into handheld radio)
+Harbor Patrol, I'm approaching the vessel now.
+
+He pulls alongside. The boat is eerily quiet. No name visible on the hull.
+
+THOMAS (CONT'D)
+Boat appears abandoned. No visible damage. I'm going aboard.
+
+He ties off and climbs onto the fishing boat.
+
+INT. FISHING BOAT - NIGHT
+
+Thomas sweeps his flashlight across the deck. Fishing nets are neatly coiled. Equipment is stowed properly. Everything is in order.
+
+Too much in order.
+
+He moves to the cabin door, opens it slowly.
+
+INT. FISHING BOAT - CABIN - NIGHT
+
+The flashlight beam reveals a small cabin. Navigation equipment. A half-eaten sandwich on the console. A coffee cup, still steaming.
+
+Thomas touches the cup. Warm.
+
+THOMAS
+(into radio)
+Harbor Patrol, this is strange. The boat looks like it was just abandoned. There's fresh coffee, food...
+
+He notices something on the navigation screen. Leans closer.
+
+The GPS shows a route - but it's not heading to shore. It's heading out to sea. To a specific coordinate.
+
+Thomas pulls out his phone, takes a photo of the screen.
+
+Then he sees it: A LOGBOOK on the seat, open to today's date.
+
+He picks it up, reads the last entry. His face goes pale.
+
+THOMAS (CONT'D)
+(whispered)
+Oh my God.
+
+DISPATCHER (V.O.)
+Station Seven, say again?
+
+Thomas doesn't respond. He's staring at the logbook entry.
+
+We see it over his shoulder:
+
+"THEY FOUND ME. IF YOU'RE READING THIS, DON'T GO TO THE COORDINATES. WHATEVER YOU DO, DON'T—"
+
+The entry ends mid-sentence.
+
+Suddenly - the boat's radio CRACKLES to life.
+
+VOICE (V.O.)
+(distorted, barely audible)
+...Thomas... can you hear me...
+
+Thomas spins around, staring at the radio.
+
+THOMAS
+Who is this?
+
+VOICE (V.O.)
+...you shouldn't have come... turn back... while you still can...
+
+THOMAS
+Identify yourself!
+
+The radio goes dead. Silence.
+
+Then - a SPLASH outside. Something hitting the water.
+
+Thomas rushes to the deck.
+
+EXT. FISHING BOAT - DECK - NIGHT
+
+He sweeps his flashlight across the water. Nothing but fog and waves.
+
+Then he sees it: His motorboat. The rope is cut. It's drifting away.
+
+THOMAS
+No, no, no!
+
+He runs to the edge, but the boat is already too far.
+
+Behind him - FOOTSTEPS on the deck.
+
+Thomas spins around, flashlight raised.
+
+Nothing there.
+
+But the cabin door is now closed. He left it open.
+
+THOMAS (CONT'D)
+(into radio, urgent)
+Harbor Patrol, I need immediate assistance. My boat is gone and there's someone—
+
+The radio DIES. Screen goes black.
+
+Thomas is alone in the fog. On a dead boat. With something - or someone - in the cabin.
+
+He backs toward the railing, flashlight shaking in his hand.
+
+The cabin door slowly creaks open.
+
+SMASH TO BLACK.
+
+TITLE CARD: "DARK HARBOR"
+
+END OF TEASER
+

package/augment-extensions/writing-standards/screenplay/genres/README.md

@@ -0,0 +1,181 @@
+# Screenplay Genres Module
+
+**Version**: 1.0.0  
+**Type**: Writing Standards  
+**Category**: Screenplay
+
+## Overview
+
+This module provides comprehensive genre-specific rules and guidelines for screenplay writing across 18+ film genres. Each genre includes core conventions, structural requirements, character archetypes, pacing guidelines, and real-world film examples.
+
+## Key Features
+
+- **18+ Primary Genres**: Action, Adventure, Comedy, Drama, Horror, Sci-Fi, Fantasy, Romance, Thriller, Mystery, Western, Historical, Biographical, Animation, Documentary, Musical, Noir, Superhero
+- **Hybrid Genre Support**: Guidelines for combining multiple genres (Rom-Com, Sci-Fi Horror, etc.)
+- **85% Depth Coverage**: Each genre documented with 5-10 core rules and 10-15 guidelines
+- **Film Examples**: 3-5 real film examples per genre with specific scene references
+- **Modular Activation**: Select only the genres you need
+
+## Installation
+
+### With CLI (Recommended)
+```bash
+augx link writing-standards/screenplay/genres
+```
+
+### Manual Setup
+1. Copy `augment-extensions/writing-standards/screenplay/genres/` to your project
+2. Reference genre files in your `.augment/` configuration
+3. Configure active genres in `.augment/screenplay-config.json`
+
+## Configuration
+
+Create or update `.augment/screenplay-config.json`:
+
+```json
+{
+  "screenplay_enhancements": {
+    "enabled": true,
+    "features": {
+      "genres": {
+        "enabled": true,
+        "selected": ["action", "sci-fi", "thriller"]
+      }
+    }
+  }
+}
+```
+
+## Directory Structure
+
+```
+genres/
+├── module.json           # Module metadata
+├── README.md             # This file
+├── rules/                # Genre-specific rules
+│   ├── action.md         ✅ Complete
+│   ├── adventure.md      ✅ Complete
+│   ├── animation.md      ✅ Complete
+│   ├── biographical.md   ✅ Complete
+│   ├── comedy.md         ✅ Complete
+│   ├── documentary.md    ✅ Complete
+│   ├── drama.md          ✅ Complete
+│   ├── fantasy.md        ✅ Complete
+│   ├── historical.md     ✅ Complete
+│   ├── horror.md         ✅ Complete
+│   ├── musical.md        ✅ Complete
+│   ├── mystery.md        ✅ Complete
+│   ├── noir.md           ✅ Complete
+│   ├── romance.md        ✅ Complete
+│   ├── sci-fi.md         ✅ Complete
+│   ├── superhero.md      ✅ Complete
+│   ├── thriller.md       ✅ Complete
+│   ├── western.md        ✅ Complete
+│   └── hybrids.md        🔲 Planned
+└── examples/
+    └── genre-applications.md
+```
+
+## Usage
+
+### Selecting a Genre
+
+When starting a screenplay, select the primary genre(s) that apply:
+
+```json
+{
+  "genres": {
+    "selected": ["thriller", "mystery"]
+  }
+}
+```
+
+### Applying Genre Rules
+
+AI agents will automatically apply the selected genre rules when:
+- Creating new screenplay files
+- Reviewing existing scenes
+- Providing feedback on structure and pacing
+- Suggesting character archetypes
+
+### Hybrid Genres
+
+For hybrid genres (e.g., Rom-Com), select multiple genres:
+
+```json
+{
+  "genres": {
+    "selected": ["romance", "comedy"]
+  }
+}
+```
+
+Refer to `rules/hybrids.md` for conflict resolution and integration strategies.
+
+## Genre Coverage
+
+### Primary Genres (18)
+- Action
+- Adventure
+- Comedy
+- Drama
+- Horror
+- Sci-Fi
+- Fantasy
+- Romance
+- Thriller
+- Mystery
+- Western
+- Historical
+- Biographical
+- Animation
+- Documentary
+- Musical
+- Noir
+- Superhero
+
+### Hybrid Genres
+- Rom-Com (Romance + Comedy)
+- Sci-Fi Horror (Sci-Fi + Horror)
+- Action-Comedy (Action + Comedy)
+- Historical Drama (Historical + Drama)
+- Psychological Thriller (Thriller + Drama)
+
+## Character Count
+
+**Total**: ~TBD characters (will be calculated after content creation)
+
+## Contents
+
+### Completed Genres (18/18) ✅
+
+- `rules/action.md` - Action genre conventions and examples ✅
+- `rules/adventure.md` - Adventure genre conventions and examples ✅
+- `rules/animation.md` - Animation genre conventions and examples ✅
+- `rules/biographical.md` - Biographical genre conventions and examples ✅
+- `rules/comedy.md` - Comedy genre conventions and examples ✅
+- `rules/documentary.md` - Documentary genre conventions and examples ✅
+- `rules/drama.md` - Drama genre conventions and examples ✅
+- `rules/fantasy.md` - Fantasy genre conventions and examples ✅
+- `rules/historical.md` - Historical genre conventions and examples ✅
+- `rules/horror.md` - Horror genre conventions and examples ✅
+- `rules/musical.md` - Musical genre conventions and examples ✅
+- `rules/mystery.md` - Mystery genre conventions and examples ✅
+- `rules/noir.md` - Film Noir genre conventions and examples ✅
+- `rules/romance.md` - Romance genre conventions and examples ✅
+- `rules/sci-fi.md` - Science Fiction genre conventions and examples ✅
+- `rules/superhero.md` - Superhero genre conventions and examples ✅
+- `rules/thriller.md` - Thriller genre conventions and examples ✅
+- `rules/western.md` - Western genre conventions and examples ✅
+
+### Additional Content (Planned)
+
+- `rules/hybrids.md` - Hybrid genre combination strategies 🔲
+- `examples/genre-applications.md` - Complete genre application examples 🔲
+
+## Related Modules
+
+- `writing-standards/screenplay/themes` - Thematic integration
+- `writing-standards/screenplay/styles` - Narrative style guidelines
+- `writing-standards/screenplay` - Core screenplay standards
+

package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep

@@ -0,0 +1,2 @@
+# Placeholder for genres/examples directory
+

package/augment-extensions/writing-standards/screenplay/genres/module.json

@@ -0,0 +1,70 @@
+{
+  "name": "screenplay-genres",
+  "version": "1.0.0",
+  "displayName": "Screenplay Genres",
+  "description": "Genre-specific rules and guidelines for screenplay writing across 18+ film genres",
+  "type": "writing-standards",
+  "category": "screenplay",
+  "tags": [
+    "screenplay",
+    "genres",
+    "film",
+    "writing",
+    "storytelling"
+  ],
+  "dependencies": {
+    "required": [],
+    "optional": []
+  },
+  "augment": {
+    "characterCount": 243000,
+    "priority": "high",
+    "category": "screenplay-genres",
+    "appliesTo": {
+      "filePatterns": [
+        "**/*.fountain",
+        "**/*.screenplay",
+        "**/screenplay/**/*.md"
+      ],
+      "languages": ["fountain", "markdown"]
+    }
+  },
+  "installation": {
+    "required": false,
+    "steps": [
+      "Link module: augx link writing-standards/screenplay/genres",
+      "Configure genres in .augment/screenplay-config.json",
+      "Select specific genres to activate"
+    ]
+  },
+  "configuration": {
+    "schema": "../schemas/feature-selection.json",
+    "defaultConfig": {
+      "enabled": true,
+      "selected": []
+    }
+  },
+  "contents": [
+    "rules/action.md - Action genre conventions",
+    "rules/adventure.md - Adventure genre conventions",
+    "rules/comedy.md - Comedy genre conventions",
+    "rules/drama.md - Drama genre conventions",
+    "rules/horror.md - Horror genre conventions",
+    "rules/sci-fi.md - Science Fiction genre conventions",
+    "rules/fantasy.md - Fantasy genre conventions",
+    "rules/romance.md - Romance genre conventions",
+    "rules/thriller.md - Thriller genre conventions",
+    "rules/mystery.md - Mystery genre conventions",
+    "rules/western.md - Western genre conventions",
+    "rules/historical.md - Historical genre conventions",
+    "rules/biographical.md - Biographical genre conventions",
+    "rules/animation.md - Animation genre conventions",
+    "rules/documentary.md - Documentary genre conventions",
+    "rules/musical.md - Musical genre conventions",
+    "rules/noir.md - Film Noir genre conventions",
+    "rules/superhero.md - Superhero genre conventions",
+    "rules/hybrids.md - Hybrid genre combinations",
+    "examples/genre-applications.md - Genre application examples"
+  ]
+}
+

package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep

@@ -0,0 +1,2 @@
+# Placeholder for genres/rules directory
+