@mytechtoday/augment-extensions 2.3.7 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/cli/dist/cli.js +2 -0
  2. package/cli/dist/cli.js.map +1 -1
  3. package/cli/dist/commands/generate-shot-list/generator/ai-blocking-extractor.d.ts +58 -0
  4. package/cli/dist/commands/generate-shot-list/generator/ai-blocking-extractor.d.ts.map +1 -0
  5. package/cli/dist/commands/generate-shot-list/generator/ai-blocking-extractor.js +275 -0
  6. package/cli/dist/commands/generate-shot-list/generator/ai-blocking-extractor.js.map +1 -0
  7. package/cli/dist/commands/generate-shot-list/generator/ai-entity-extractor.d.ts +41 -0
  8. package/cli/dist/commands/generate-shot-list/generator/ai-entity-extractor.d.ts.map +1 -0
  9. package/cli/dist/commands/generate-shot-list/generator/ai-entity-extractor.js +155 -0
  10. package/cli/dist/commands/generate-shot-list/generator/ai-entity-extractor.js.map +1 -0
  11. package/cli/dist/commands/generate-shot-list/generator/context-builder.d.ts +65 -2
  12. package/cli/dist/commands/generate-shot-list/generator/context-builder.d.ts.map +1 -1
  13. package/cli/dist/commands/generate-shot-list/generator/context-builder.js +394 -98
  14. package/cli/dist/commands/generate-shot-list/generator/context-builder.js.map +1 -1
  15. package/cli/dist/commands/generate-shot-list/generator/index.d.ts +59 -1
  16. package/cli/dist/commands/generate-shot-list/generator/index.d.ts.map +1 -1
  17. package/cli/dist/commands/generate-shot-list/generator/index.js +364 -34
  18. package/cli/dist/commands/generate-shot-list/generator/index.js.map +1 -1
  19. package/cli/dist/commands/generate-shot-list/generator/types.d.ts +3 -2
  20. package/cli/dist/commands/generate-shot-list/generator/types.d.ts.map +1 -1
  21. package/cli/dist/commands/generate-shot-list/generator/validator.d.ts +33 -0
  22. package/cli/dist/commands/generate-shot-list/generator/validator.d.ts.map +1 -1
  23. package/cli/dist/commands/generate-shot-list/generator/validator.js +167 -0
  24. package/cli/dist/commands/generate-shot-list/generator/validator.js.map +1 -1
  25. package/cli/dist/commands/generate-shot-list/help-text.d.ts +1 -1
  26. package/cli/dist/commands/generate-shot-list/help-text.d.ts.map +1 -1
  27. package/cli/dist/commands/generate-shot-list/help-text.js +11 -0
  28. package/cli/dist/commands/generate-shot-list/help-text.js.map +1 -1
  29. package/cli/dist/commands/generate-shot-list.d.ts +1 -0
  30. package/cli/dist/commands/generate-shot-list.d.ts.map +1 -1
  31. package/cli/dist/commands/generate-shot-list.js +7 -4
  32. package/cli/dist/commands/generate-shot-list.js.map +1 -1
  33. package/package.json +2 -1
@@ -11,6 +11,7 @@
11
11
  */
12
12
  import { Scene, SceneElement } from '../parser/types';
13
13
  import { SceneContext, CharacterState } from './types';
14
+ import { MergedStyleGuidelines } from '../style/types';
14
15
  /**
15
16
  * Context builder configuration
16
17
  */
@@ -18,6 +19,7 @@ export interface ContextBuilderConfig {
18
19
  includeAtmosphere: boolean;
19
20
  includeWeather: boolean;
20
21
  trackCharacterEmotions: boolean;
22
+ styleGuidelines?: MergedStyleGuidelines | null;
21
23
  }
22
24
  /**
23
25
  * Context Builder class
@@ -30,7 +32,46 @@ export declare class ContextBuilder {
30
32
  private characterBlockingHistory;
31
33
  private characterBible;
32
34
  private setBible;
35
+ private styleGuidelines;
36
+ private aiExtractor;
33
37
  constructor(config: ContextBuilderConfig);
38
+ /**
39
+ * Normalize character name for fuzzy matching
40
+ * Handles variations like "THE CAPTAIN" vs "CAPTAIN", "A WIZARD" vs "WIZARD"
41
+ *
42
+ * Rules:
43
+ * - Remove leading articles: THE, A, AN
44
+ * - Trim whitespace
45
+ * - Convert to uppercase for consistent comparison
46
+ *
47
+ * Examples:
48
+ * - "THE CAPTAIN" -> "CAPTAIN"
49
+ * - "A WIZARD" -> "WIZARD"
50
+ * - "AN OFFICER" -> "OFFICER"
51
+ * - "CAPTAIN" -> "CAPTAIN"
52
+ */
53
+ private normalizeCharacterName;
54
+ /**
55
+ * Find character in Bible using fuzzy matching
56
+ * Tries exact match first, then normalized match, then partial match
57
+ *
58
+ * @param characterName - The character name to search for
59
+ * @returns The Bible entry if found, null otherwise
60
+ */
61
+ private findCharacterInBible;
62
+ /**
63
+ * Get or create character in Bible using fuzzy matching
64
+ * Returns the canonical name (the one stored in the Bible)
65
+ *
66
+ * @param characterName - The character name to search for
67
+ * @returns Object with bibleEntry and canonicalName
68
+ */
69
+ private getOrCreateCharacterInBible;
70
+ /**
71
+ * Reset all state (Character Bible, Set Bible, blocking history)
72
+ * Call this at the start of each new screenplay generation to prevent contamination
73
+ */
74
+ reset(): void;
34
75
  /**
35
76
  * Build scene-level context from scene heading and elements
36
77
  * Requirement 11: Use Set Bible to maintain rich, consistent set descriptions
@@ -41,9 +82,9 @@ export declare class ContextBuilder {
41
82
  * Build character states from scene elements
42
83
  * Requirement 9: Maintain character blocking continuity across shots
43
84
  * Requirement 10: Use Character Bible to maintain rich, consistent character descriptions
44
- * PRIORITY: Extract character introductions from action lines using known character names
85
+ * PRIORITY: Use AI-powered fuzzy logic to extract characters following MPAA/AMPAS standards
45
86
  */
46
- buildCharacterStates(elements: SceneElement[], sceneContext: SceneContext): CharacterState[];
87
+ buildCharacterStates(elements: SceneElement[], sceneContext: SceneContext): Promise<CharacterState[]>;
47
88
  /**
48
89
  * Extract environment description from scene
49
90
  * Requirement 11: Rich Set Descriptions
@@ -72,12 +113,19 @@ export declare class ContextBuilder {
72
113
  * Extract atmosphere from scene elements
73
114
  */
74
115
  private extractAtmosphere;
116
+ /**
117
+ * Check if the scene is set in space (spaceship, space station, etc.)
118
+ * where weather doesn't make sense
119
+ */
120
+ private isSpaceSetting;
75
121
  /**
76
122
  * Extract weather from scene elements
123
+ * Style-aware: respects franchise settings (no weather on spaceships!)
77
124
  */
78
125
  private extractWeather;
79
126
  /**
80
127
  * Extract emotion from dialogue element
128
+ * Handles both parenthetical and character extension (V.O., O.S., etc.)
81
129
  */
82
130
  private extractEmotion;
83
131
  /**
@@ -99,5 +147,20 @@ export declare class ContextBuilder {
99
147
  * PRIORITY: Extract actual character descriptions from screenplay
100
148
  */
101
149
  private updateCharacterStatesFromAction;
150
+ /**
151
+ * Enrich wardrobe descriptions with specific colors based on cinematic style
152
+ * Maintains visual continuity by adding particular details
153
+ *
154
+ * Star Trek uniform colors:
155
+ * - Command: Gold/Yellow
156
+ * - Science/Medical: Blue
157
+ * - Engineering/Security: Red
158
+ */
159
+ private enrichWardrobeWithColors;
160
+ /**
161
+ * Extract characters using AI-powered fuzzy logic
162
+ * Follows MPAA and AMPAS Nicholl Fellowship screenplay standards
163
+ */
164
+ private extractCharactersWithAI;
102
165
  }
103
166
  //# sourceMappingURL=context-builder.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/generator/context-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAkC,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,sBAAsB,EAAE,OAAO,CAAC;CACjC;AA6BD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,wBAAwB,CAA0C;IAC1E,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,QAAQ,CAAyC;gBAE7C,MAAM,EAAE,oBAAoB;IAIxC;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY;IA+D7C;;;;;OAKG;IACH,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,YAAY,EAAE,YAAY,GAAG,cAAc,EAAE;IAmI5F;;;OAGG;IACH;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAyBnC,OAAO,CAAC,kBAAkB;IA8B1B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAyD3B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;;;;OAKG;IACH,OAAO,CAAC,uCAAuC;IAyE/C;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAqCpC;;;;;OAKG;IACH,OAAO,CAAC,+BAA+B;CAwJxC"}
1
+ {"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/generator/context-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAkC,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,sBAAsB,EAAE,OAAO,CAAC;IAChC,eAAe,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAChD;AAkCD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,wBAAwB,CAA0C;IAC1E,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,eAAe,CAAsC;IAC7D,OAAO,CAAC,WAAW,CAAoB;gBAE3B,MAAM,EAAE,oBAAoB;IAMxC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;;;;;OAMG;IACH,OAAO,CAAC,2BAA2B;IAuBnC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAOb;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY;IA+D7C;;;;;OAKG;IACG,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAqK3G;;;OAGG;IACH;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAyBnC,OAAO,CAAC,kBAAkB;IA8B1B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAyD3B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;;OAGG;IACH,OAAO,CAAC,cAAc;IA2BtB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAqBtB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAyCtB;;;;;OAKG;IACH,OAAO,CAAC,uCAAuC;IAkF/C;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAqCpC;;;;;OAKG;IACH,OAAO,CAAC,+BAA+B;IA2KvC;;;;;;;;OAQG;IACH,OAAO,CAAC,wBAAwB;IAkEhC;;;OAGG;YACW,uBAAuB;CAuCtC"}