@mytechtoday/augment-extensions 1.5.2 → 1.6.1

package/cli/dist/commands/generate-shot-list/generator/validator.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Shot List Validator
+ *
+ * Validates shot lists against character and duration limits
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShotListValidator = void 0;
+exports.createValidator = createValidator;
+/**
+ * Validator class for shot list validation
+ */
+class ShotListValidator {
+    /**
+     * Validate entire shot list
+     */
+    validate(shotList, config) {
+        const warnings = [];
+        // Validate each shot
+        for (const shot of shotList.shots) {
+            warnings.push(...this.validateShot(shot, config));
+        }
+        return warnings;
+    }
+    /**
+     * Validate individual shot
+     */
+    validateShot(shot, config) {
+        const warnings = [];
+        // Validate character count
+        warnings.push(...this.validateCharacterCount(shot, config));
+        // Validate duration
+        warnings.push(...this.validateDuration(shot, config));
+        return warnings;
+    }
+    /**
+     * Validate character count against limits
+     */
+    validateCharacterCount(shot, config) {
+        const warnings = [];
+        const warningThreshold = config.maxCharacters * (config.warningThreshold / 100);
+        // Error: Exceeds limit
+        if (shot.characterCount > config.maxCharacters) {
+            warnings.push({
+                type: 'character-limit-error',
+                message: `Shot ${shot.number} exceeds character limit (${shot.characterCount.toLocaleString()}/${config.maxCharacters.toLocaleString()})`,
+                shotNumber: shot.number,
+                severity: 'error',
+                suggestion: 'Reduce description length or split into multiple shots'
+            });
+        }
+        // Warning: Approaching limit (90% threshold)
+        else if (shot.characterCount >= warningThreshold) {
+            const percentage = Math.round((shot.characterCount / config.maxCharacters) * 100);
+            warnings.push({
+                type: 'character-limit-warning',
+                message: `Shot ${shot.number} approaching character limit (${shot.characterCount.toLocaleString()}/${config.maxCharacters.toLocaleString()}, ${percentage}%)`,
+                shotNumber: shot.number,
+                severity: 'warning',
+                suggestion: 'Consider reducing description length'
+            });
+        }
+        return warnings;
+    }
+    /**
+     * Validate duration against limits
+     */
+    validateDuration(shot, config) {
+        const warnings = [];
+        const warningThreshold = config.maxShotLength * (config.warningThreshold / 100);
+        // Error: Exceeds limit
+        if (shot.duration > config.maxShotLength) {
+            warnings.push({
+                type: 'duration-limit-error',
+                message: `Shot ${shot.number} exceeds duration limit (${shot.duration}s/${config.maxShotLength}s)`,
+                shotNumber: shot.number,
+                severity: 'error',
+                suggestion: 'Split this shot into multiple shorter shots'
+            });
+        }
+        // Warning: Approaching limit (90% threshold)
+        else if (shot.duration >= warningThreshold) {
+            const percentage = Math.round((shot.duration / config.maxShotLength) * 100);
+            warnings.push({
+                type: 'duration-limit-warning',
+                message: `Shot ${shot.number} approaching duration limit (${shot.duration}s/${config.maxShotLength}s, ${percentage}%)`,
+                shotNumber: shot.number,
+                severity: 'warning',
+                suggestion: 'Consider splitting into multiple shots'
+            });
+        }
+        return warnings;
+    }
+    /**
+     * Get validation summary
+     */
+    getValidationSummary(warnings) {
+        const summary = {
+            totalWarnings: warnings.filter(w => w.severity === 'warning').length,
+            totalErrors: warnings.filter(w => w.severity === 'error').length,
+            byType: {}
+        };
+        // Count by type
+        for (const warning of warnings) {
+            summary.byType[warning.type] = (summary.byType[warning.type] || 0) + 1;
+        }
+        return summary;
+    }
+}
+exports.ShotListValidator = ShotListValidator;
+/**
+ * Create validator instance
+ */
+function createValidator() {
+    return new ShotListValidator();
+}
+//# sourceMappingURL=validator.js.map

package/cli/dist/commands/generate-shot-list/generator/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/generator/validator.ts"],"names":[],"mappings":"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"}

package/cli/dist/commands/generate-shot-list/help-text.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Help Text for generate-shot-list command
+ *
+ * Comprehensive help documentation for the AI Shot List Generator
+ */
+export declare const HELP_TEXT = "\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557\n\u2551                        AI SHOT LIST GENERATOR                                \u2551\n\u2551                                                                              \u2551\n\u2551  Convert traditional screenplays into AI-optimized shot lists for video     \u2551\n\u2551  generation platforms (Runway, Pika, Stable Video Diffusion, etc.)          \u2551\n\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\n\nSYNOPSIS\n  augx generate-shot-list --path <screenplay-file> [options]\n\nDESCRIPTION\n  Converts traditional screenplays into AI-optimized shot lists with automatic\n  enforcement of shot duration and character limits. Each shot includes:\n  \n  \u2022 Complete scene context (set, lighting, time of day)\n  \u2022 Character descriptions and positions\n  \u2022 Camera framing and movement suggestions\n  \u2022 Shot duration and character count validation\n  \u2022 Technical notes and metadata\n\nREQUIRED ARGUMENTS\n  --path <file>\n      Path to screenplay file\n      Supported formats: Fountain (.fountain), Markdown (.md), Plain Text (.txt)\n      \n      Examples:\n        --path screenplay.fountain\n        --path /path/to/screenplay.md\n        --path \"C:\\Users\\Name\\screenplay.txt\"\n\nOPTIONAL ARGUMENTS\n  --format <format>\n      Output format for shot list\n      Valid values: md, json, jsonl, csv, txt, html\n      Default: md\n      \n      Examples:\n        --format json\n        --format html\n\n  --output <filename>\n      Custom output filename\n      Default: <screenplay-name>-ai-shot-list.<format>\n      \n      Examples:\n        --output my-shots.json\n        --output /path/to/output.md\n\n  --max-characters <number>\n      Maximum characters per shot description\n      Range: 100 - 10000\n      Default: 4000\n      \n      Examples:\n        --max-characters 3000\n        --max-characters 5000\n\n  --max-shot-length <seconds>\n      Maximum shot duration in seconds\n      Range: 1 - 60\n      Default: 12\n      \n      Examples:\n        --max-shot-length 10\n        --max-shot-length 15\n\n  --verbose\n      Enable verbose output with detailed progress information\n      \n  --quiet\n      Suppress all output except errors\n      \n  --help, -h\n      Display this help message\n\nUSAGE EXAMPLES\n  Basic usage (Markdown output):\n    augx generate-shot-list --path screenplay.fountain\n\n  Generate JSON output:\n    augx generate-shot-list --path screenplay.md --format json\n\n  Custom character limit:\n    augx generate-shot-list --path screenplay.txt --max-characters 3000\n\n  Custom output file:\n    augx generate-shot-list --path screenplay.fountain --output my-shots.html --format html\n\n  Verbose mode:\n    augx generate-shot-list --path screenplay.md --verbose\n\nSUPPORTED FORMATS\n  Input Formats:\n    \u2022 Fountain (.fountain) - Industry-standard screenplay format\n    \u2022 Markdown (.md) - Headings as scenes, paragraphs as action/dialogue\n    \u2022 Plain Text (.txt) - Simple text with INT/EXT scene headings\n\n  Output Formats:\n    \u2022 Markdown (md) - Structured shot list with tables\n    \u2022 JSON (json) - Machine-readable format with all metadata\n    \u2022 JSONL (jsonl) - One shot per line (streaming-friendly)\n    \u2022 CSV (csv) - Spreadsheet-compatible format\n    \u2022 TXT (txt) - Simple plain text format\n    \u2022 HTML (html) - Interactive format with character counting\n\nERROR HANDLING\n  The command logs all errors to .augment/logs/shot-list-errors.jsonl\n  \n  Common errors:\n    \u2022 PE001: Invalid scene heading format\n    \u2022 VE001: Shot exceeds character limit\n    \u2022 VE002: Shot exceeds duration limit\n    \u2022 IO001: Input file not found\n    \u2022 IO002: Output file cannot be written\n\nEXIT CODES\n  0 - Success\n  1 - General error\n  2 - Invalid arguments\n  3 - Input file error\n  4 - Output file error\n  5 - Parsing error\n  6 - Validation error\n\nBEST PRACTICES\n  1. Use Fountain format for best results (most structured)\n  2. Keep shot descriptions under 4000 characters for optimal AI generation\n  3. Limit shots to 12 seconds for better video quality\n  4. Use HTML output for interactive editing and character counting\n  5. Review warnings in the output for potential issues\n\nTIPS\n  \u2022 The generator automatically splits long scenes into multiple shots\n  \u2022 Context is repeated for each shot (set, characters, lighting)\n  \u2022 Metadata extraction identifies shot types and camera movements\n  \u2022 Character limits include full context, not just action description\n\nFor more information, visit:\n  https://github.com/mytech-today-now/augment-extensions\n\nReport issues at:\n  https://github.com/mytech-today-now/augment-extensions/issues\n";
+/**
+ * Display help text
+ */
+export declare function displayHelp(): void;
+//# sourceMappingURL=help-text.d.ts.map

package/cli/dist/commands/generate-shot-list/help-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-text.d.ts","sourceRoot":"","sources":["../../../src/commands/generate-shot-list/help-text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,SAAS,qhLA+IrB,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/cli/dist/commands/generate-shot-list/help-text.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * Help Text for generate-shot-list command
+ *
+ * Comprehensive help documentation for the AI Shot List Generator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP_TEXT = void 0;
+exports.displayHelp = displayHelp;
+exports.HELP_TEXT = `
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                        AI SHOT LIST GENERATOR                                ║
+║                                                                              ║
+║  Convert traditional screenplays into AI-optimized shot lists for video     ║
+║  generation platforms (Runway, Pika, Stable Video Diffusion, etc.)          ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+SYNOPSIS
+  augx generate-shot-list --path <screenplay-file> [options]
+
+DESCRIPTION
+  Converts traditional screenplays into AI-optimized shot lists with automatic
+  enforcement of shot duration and character limits. Each shot includes:
+  
+  • Complete scene context (set, lighting, time of day)
+  • Character descriptions and positions
+  • Camera framing and movement suggestions
+  • Shot duration and character count validation
+  • Technical notes and metadata
+
+REQUIRED ARGUMENTS
+  --path <file>
+      Path to screenplay file
+      Supported formats: Fountain (.fountain), Markdown (.md), Plain Text (.txt)
+      
+      Examples:
+        --path screenplay.fountain
+        --path /path/to/screenplay.md
+        --path "C:\\Users\\Name\\screenplay.txt"
+
+OPTIONAL ARGUMENTS
+  --format <format>
+      Output format for shot list
+      Valid values: md, json, jsonl, csv, txt, html
+      Default: md
+      
+      Examples:
+        --format json
+        --format html
+
+  --output <filename>
+      Custom output filename
+      Default: <screenplay-name>-ai-shot-list.<format>
+      
+      Examples:
+        --output my-shots.json
+        --output /path/to/output.md
+
+  --max-characters <number>
+      Maximum characters per shot description
+      Range: 100 - 10000
+      Default: 4000
+      
+      Examples:
+        --max-characters 3000
+        --max-characters 5000
+
+  --max-shot-length <seconds>
+      Maximum shot duration in seconds
+      Range: 1 - 60
+      Default: 12
+      
+      Examples:
+        --max-shot-length 10
+        --max-shot-length 15
+
+  --verbose
+      Enable verbose output with detailed progress information
+      
+  --quiet
+      Suppress all output except errors
+      
+  --help, -h
+      Display this help message
+
+USAGE EXAMPLES
+  Basic usage (Markdown output):
+    augx generate-shot-list --path screenplay.fountain
+
+  Generate JSON output:
+    augx generate-shot-list --path screenplay.md --format json
+
+  Custom character limit:
+    augx generate-shot-list --path screenplay.txt --max-characters 3000
+
+  Custom output file:
+    augx generate-shot-list --path screenplay.fountain --output my-shots.html --format html
+
+  Verbose mode:
+    augx generate-shot-list --path screenplay.md --verbose
+
+SUPPORTED FORMATS
+  Input Formats:
+    • Fountain (.fountain) - Industry-standard screenplay format
+    • Markdown (.md) - Headings as scenes, paragraphs as action/dialogue
+    • Plain Text (.txt) - Simple text with INT/EXT scene headings
+
+  Output Formats:
+    • Markdown (md) - Structured shot list with tables
+    • JSON (json) - Machine-readable format with all metadata
+    • JSONL (jsonl) - One shot per line (streaming-friendly)
+    • CSV (csv) - Spreadsheet-compatible format
+    • TXT (txt) - Simple plain text format
+    • HTML (html) - Interactive format with character counting
+
+ERROR HANDLING
+  The command logs all errors to .augment/logs/shot-list-errors.jsonl
+  
+  Common errors:
+    • PE001: Invalid scene heading format
+    • VE001: Shot exceeds character limit
+    • VE002: Shot exceeds duration limit
+    • IO001: Input file not found
+    • IO002: Output file cannot be written
+
+EXIT CODES
+  0 - Success
+  1 - General error
+  2 - Invalid arguments
+  3 - Input file error
+  4 - Output file error
+  5 - Parsing error
+  6 - Validation error
+
+BEST PRACTICES
+  1. Use Fountain format for best results (most structured)
+  2. Keep shot descriptions under 4000 characters for optimal AI generation
+  3. Limit shots to 12 seconds for better video quality
+  4. Use HTML output for interactive editing and character counting
+  5. Review warnings in the output for potential issues
+
+TIPS
+  • The generator automatically splits long scenes into multiple shots
+  • Context is repeated for each shot (set, characters, lighting)
+  • Metadata extraction identifies shot types and camera movements
+  • Character limits include full context, not just action description
+
+For more information, visit:
+  https://github.com/mytech-today-now/augment-extensions
+
+Report issues at:
+  https://github.com/mytech-today-now/augment-extensions/issues
+`;
+/**
+ * Display help text
+ */
+function displayHelp() {
+    console.log(exports.HELP_TEXT);
+}
+//# sourceMappingURL=help-text.js.map

package/cli/dist/commands/generate-shot-list/help-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-text.js","sourceRoot":"","sources":["../../../src/commands/generate-shot-list/help-text.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAsJH,kCAEC;AAtJY,QAAA,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+IxB,CAAC;AAEF;;GAEG;AACH,SAAgB,WAAW;IACzB,OAAO,CAAC,GAAG,CAAC,iBAAS,CAAC,CAAC;AACzB,CAAC"}

package/cli/dist/commands/generate-shot-list/logger/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Logger Module for AI Shot List Generator
+ *
+ * Orchestrates logging functionality with JSONL error logging
+ */
+import { Logger } from './types';
+export * from './types';
+export { JSONLWriter } from './jsonl-writer';
+export { ShotListLogger } from './shot-list-logger';
+/**
+ * Create a logger instance
+ *
+ * @param logFilePath - Optional custom log file path
+ * @returns Logger instance
+ */
+export declare function createLogger(logFilePath?: string): Promise<Logger>;
+/**
+ * Get or create the global logger instance
+ */
+export declare function getLogger(logFilePath?: string): Promise<Logger>;
+/**
+ * Reset the global logger (useful for testing)
+ */
+export declare function resetLogger(): void;
+//# sourceMappingURL=index.d.ts.map

package/cli/dist/commands/generate-shot-list/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/logger/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAapD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKxE;AAOD;;GAEG;AACH,wBAAsB,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKrE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/cli/dist/commands/generate-shot-list/logger/index.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Logger Module for AI Shot List Generator
+ *
+ * Orchestrates logging functionality with JSONL error logging
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShotListLogger = exports.JSONLWriter = void 0;
+exports.createLogger = createLogger;
+exports.getLogger = getLogger;
+exports.resetLogger = resetLogger;
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const shot_list_logger_1 = require("./shot-list-logger");
+// Re-export types
+__exportStar(require("./types"), exports);
+var jsonl_writer_1 = require("./jsonl-writer");
+Object.defineProperty(exports, "JSONLWriter", { enumerable: true, get: function () { return jsonl_writer_1.JSONLWriter; } });
+var shot_list_logger_2 = require("./shot-list-logger");
+Object.defineProperty(exports, "ShotListLogger", { enumerable: true, get: function () { return shot_list_logger_2.ShotListLogger; } });
+/**
+ * Default log file path
+ */
+function getDefaultLogPath() {
+    // Use .augment-extensions/logs directory in user's home
+    const homeDir = os.homedir();
+    const logDir = path.join(homeDir, '.augment-extensions', 'logs');
+    const logFile = path.join(logDir, 'shot-list-generator.jsonl');
+    return logFile;
+}
+/**
+ * Create a logger instance
+ *
+ * @param logFilePath - Optional custom log file path
+ * @returns Logger instance
+ */
+async function createLogger(logFilePath) {
+    const filePath = logFilePath || getDefaultLogPath();
+    const logger = new shot_list_logger_1.ShotListLogger(filePath);
+    await logger.initialize();
+    return logger;
+}
+/**
+ * Singleton logger instance
+ */
+let globalLogger = null;
+/**
+ * Get or create the global logger instance
+ */
+async function getLogger(logFilePath) {
+    if (!globalLogger) {
+        globalLogger = await createLogger(logFilePath);
+    }
+    return globalLogger;
+}
+/**
+ * Reset the global logger (useful for testing)
+ */
+function resetLogger() {
+    globalLogger = null;
+}
+//# sourceMappingURL=index.js.map

package/cli/dist/commands/generate-shot-list/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/logger/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BH,oCAKC;AAUD,8BAKC;AAKD,kCAEC;AAtDD,2CAA6B;AAC7B,uCAAyB;AACzB,yDAAoD;AAGpD,kBAAkB;AAClB,0CAAwB;AACxB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,uDAAoD;AAA3C,kHAAA,cAAc,OAAA;AAEvB;;GAEG;AACH,SAAS,iBAAiB;IACxB,wDAAwD;IACxD,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,YAAY,CAAC,WAAoB;IACrD,MAAM,QAAQ,GAAG,WAAW,IAAI,iBAAiB,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,iCAAc,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;IAC1B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC;;GAEG;AACI,KAAK,UAAU,SAAS,CAAC,WAAoB;IAClD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW;IACzB,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC"}

package/cli/dist/commands/generate-shot-list/logger/jsonl-writer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * JSONL Writer for AI Shot List Generator
+ *
+ * Handles writing log entries to JSONL files with:
+ * - Append-only writing
+ * - Atomic writes (prevent corruption)
+ * - Concurrent write safety
+ */
+/**
+ * JSONL Writer class
+ */
+export declare class JSONLWriter {
+    private filePath;
+    private writeQueue;
+    constructor(filePath: string);
+    /**
+     * Initialize the writer (create directory if needed)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Write a log entry to the JSONL file
+     *
+     * This method is thread-safe and ensures atomic writes
+     */
+    write(entry: any): Promise<void>;
+    /**
+     * Write multiple entries at once
+     */
+    writeMany(entries: any[]): Promise<void>;
+    /**
+     * Flush any pending writes
+     */
+    flush(): Promise<void>;
+    /**
+     * Get the file path
+     */
+    getFilePath(): string;
+}
+/**
+ * Create a JSONL writer for a specific log file
+ */
+export declare function createJSONLWriter(filePath: string): JSONLWriter;
+//# sourceMappingURL=jsonl-writer.d.ts.map

package/cli/dist/commands/generate-shot-list/logger/jsonl-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-writer.d.ts","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/logger/jsonl-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAoC;gBAE1C,QAAQ,EAAE,MAAM;IAI5B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC;;;;OAIG;IACG,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtC;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACH,WAAW,IAAI,MAAM;CAGtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAE/D"}

package/cli/dist/commands/generate-shot-list/logger/jsonl-writer.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * JSONL Writer for AI Shot List Generator
+ *
+ * Handles writing log entries to JSONL files with:
+ * - Append-only writing
+ * - Atomic writes (prevent corruption)
+ * - Concurrent write safety
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JSONLWriter = void 0;
+exports.createJSONLWriter = createJSONLWriter;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const util_1 = require("util");
+const appendFile = (0, util_1.promisify)(fs.appendFile);
+const mkdir = (0, util_1.promisify)(fs.mkdir);
+const access = (0, util_1.promisify)(fs.access);
+/**
+ * JSONL Writer class
+ */
+class JSONLWriter {
+    constructor(filePath) {
+        this.writeQueue = Promise.resolve();
+        this.filePath = filePath;
+    }
+    /**
+     * Initialize the writer (create directory if needed)
+     */
+    async initialize() {
+        const dir = path.dirname(this.filePath);
+        try {
+            await access(dir);
+        }
+        catch {
+            // Directory doesn't exist, create it
+            await mkdir(dir, { recursive: true });
+        }
+    }
+    /**
+     * Write a log entry to the JSONL file
+     *
+     * This method is thread-safe and ensures atomic writes
+     */
+    async write(entry) {
+        // Queue the write to ensure sequential writes
+        this.writeQueue = this.writeQueue.then(async () => {
+            try {
+                // Convert entry to JSON and add newline
+                const line = JSON.stringify(entry) + '\n';
+                // Append to file atomically
+                await appendFile(this.filePath, line, { encoding: 'utf-8' });
+            }
+            catch (error) {
+                // Log to stderr but don't throw - we don't want logging failures to crash the app
+                console.error('Failed to write log entry:', error);
+            }
+        });
+        // Wait for this write to complete
+        await this.writeQueue;
+    }
+    /**
+     * Write multiple entries at once
+     */
+    async writeMany(entries) {
+        for (const entry of entries) {
+            await this.write(entry);
+        }
+    }
+    /**
+     * Flush any pending writes
+     */
+    async flush() {
+        await this.writeQueue;
+    }
+    /**
+     * Get the file path
+     */
+    getFilePath() {
+        return this.filePath;
+    }
+}
+exports.JSONLWriter = JSONLWriter;
+/**
+ * Create a JSONL writer for a specific log file
+ */
+function createJSONLWriter(filePath) {
+    return new JSONLWriter(filePath);
+}
+//# sourceMappingURL=jsonl-writer.js.map

package/cli/dist/commands/generate-shot-list/logger/jsonl-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-writer.js","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/logger/jsonl-writer.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsFH,8CAEC;AAtFD,uCAAyB;AACzB,2CAA6B;AAC7B,+BAAiC;AAEjC,MAAM,UAAU,GAAG,IAAA,gBAAS,EAAC,EAAE,CAAC,UAAU,CAAC,CAAC;AAC5C,MAAM,KAAK,GAAG,IAAA,gBAAS,EAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AAClC,MAAM,MAAM,GAAG,IAAA,gBAAS,EAAC,EAAE,CAAC,MAAM,CAAC,CAAC;AAEpC;;GAEG;AACH,MAAa,WAAW;IAItB,YAAY,QAAgB;QAFpB,eAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;QAGpD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAExC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;YACrC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,KAAU;QACpB,8CAA8C;QAC9C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAChD,IAAI,CAAC;gBACH,wCAAwC;gBACxC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;gBAE1C,4BAA4B;gBAC5B,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,kFAAkF;gBAClF,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YACrD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,kCAAkC;QAClC,MAAM,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,OAAc;QAC5B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AApED,kCAoEC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,OAAO,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC"}

package/cli/dist/commands/generate-shot-list/logger/shot-list-logger.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Shot List Logger Implementation
+ *
+ * Main logger implementation for AI Shot List Generator
+ */
+import { ErrorDefinition } from '../errors';
+import { Logger, SuccessLogEntry } from './types';
+/**
+ * Shot List Logger class
+ */
+export declare class ShotListLogger implements Logger {
+    private writer;
+    constructor(logFilePath: string);
+    /**
+     * Initialize the logger
+     */
+    initialize(): Promise<void>;
+    /**
+     * Log an error
+     */
+    logError(error: ErrorDefinition, context?: any, stackTrace?: string): Promise<void>;
+    /**
+     * Log a success
+     */
+    logSuccess(message: string, statistics: SuccessLogEntry['statistics'], inputFile: string, outputFile: string, format: string): Promise<void>;
+    /**
+     * Log a warning
+     */
+    logWarning(code: string, message: string, context?: any): Promise<void>;
+    /**
+     * Log info
+     */
+    logInfo(message: string, data?: any): Promise<void>;
+    /**
+     * Flush any pending log entries
+     */
+    flush(): Promise<void>;
+    /**
+     * Generate reproduction steps from context
+     */
+    private generateReproductionSteps;
+}
+//# sourceMappingURL=shot-list-logger.d.ts.map

package/cli/dist/commands/generate-shot-list/logger/shot-list-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shot-list-logger.d.ts","sourceRoot":"","sources":["../../../../src/commands/generate-shot-list/logger/shot-list-logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EACL,MAAM,EAEN,eAAe,EAGhB,MAAM,SAAS,CAAC;AAqBjB;;GAEG;AACH,qBAAa,cAAe,YAAW,MAAM;IAC3C,OAAO,CAAC,MAAM,CAAc;gBAEhB,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,QAAQ,CACZ,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,GAAG,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IA4BhB;;OAEG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,EACzC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7E;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAazD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACH,OAAO,CAAC,yBAAyB;CAkBlC"}