@prompd/cli 0.3.3

package/dist/lib/compiler/section-override.js

@@ -0,0 +1,296 @@
+"use strict";
+/**
+ * Section Override Processing
+ *
+ * Provides complete functionality for parsing, validating, and applying
+ * section-based content overrides in prompd template inheritance.
+ *
+ * This is a direct port of the Python CLI's SectionOverrideProcessor.
+ */
+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.SectionOverrideProcessor = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+const errors_1 = require("../errors");
+class SectionOverrideProcessor {
+    constructor() {
+        // Pattern to match markdown headings (# through ######)
+        this.headingPattern = /^(#{1,6})\s+(.+)$/gm;
+        // Pattern to match section ID comments
+        this.sectionIdPattern = /<!--\s*section-id:\s*([a-z0-9-]+)\s*-->/i;
+    }
+    /**
+     * Extract all sections from markdown content.
+     */
+    extractSections(content) {
+        if (!content || !content.trim()) {
+            return new Map();
+        }
+        const sections = new Map();
+        const lines = content.split('\n');
+        const encounteredSectionIds = new Set();
+        // Track explicit section ID comments
+        const explicitSectionIds = new Map();
+        for (let i = 0; i < lines.length; i++) {
+            const match = this.sectionIdPattern.exec(lines[i]);
+            if (match) {
+                const sectionId = match[1];
+                this.validateSectionId(sectionId, i + 1);
+                explicitSectionIds.set(i, sectionId);
+            }
+        }
+        // Find all headings and create sections
+        const headingMatches = [];
+        let match;
+        // Reset regex state
+        this.headingPattern.lastIndex = 0;
+        while ((match = this.headingPattern.exec(content)) !== null) {
+            const headingLevel = match[1].length; // Number of # characters
+            const headingText = match[2].trim();
+            const headingLine = content.substring(0, match.index).split('\n').length - 1;
+            headingMatches.push({
+                level: headingLevel,
+                text: headingText,
+                line: headingLine,
+                index: match.index
+            });
+        }
+        // Process each heading to create sections
+        for (let i = 0; i < headingMatches.length; i++) {
+            const heading = headingMatches[i];
+            // Determine section ID
+            let sectionId = null;
+            // Check for explicit section ID comment before this heading (within 5 lines)
+            for (let lineNum = heading.line; lineNum >= Math.max(0, heading.line - 5); lineNum--) {
+                if (explicitSectionIds.has(lineNum)) {
+                    sectionId = explicitSectionIds.get(lineNum);
+                    break;
+                }
+            }
+            // If no explicit ID, generate from heading text
+            if (!sectionId) {
+                sectionId = this.generateSectionId(heading.text);
+            }
+            // Validate section ID
+            this.validateSectionId(sectionId, heading.line + 1);
+            // Check for duplicate section IDs
+            if (encounteredSectionIds.has(sectionId)) {
+                throw new errors_1.ParseError(`Duplicate section ID '${sectionId}' at line ${heading.line + 1}. ` +
+                    `Section IDs must be unique.`);
+            }
+            encounteredSectionIds.add(sectionId);
+            // Determine section content boundaries
+            const sectionStart = heading.index;
+            const nextHeading = headingMatches[i + 1];
+            const sectionEnd = nextHeading ? nextHeading.index : content.length;
+            // Extract section content
+            const sectionContent = content.substring(sectionStart, sectionEnd).trim();
+            sections.set(sectionId, {
+                id: sectionId,
+                headingText: heading.text,
+                content: sectionContent,
+                startLine: heading.line,
+                endLine: content.substring(0, sectionEnd).split('\n').length - 1,
+                headingLevel: heading.level
+            });
+        }
+        return sections;
+    }
+    /**
+     * Apply overrides and merge parent/child sections.
+     */
+    async applyOverrides(parentSections, childSections, overrides, baseDir, verbose = false, fileSystem) {
+        // Start with parent sections as base
+        const mergedSections = new Map(parentSections);
+        // Apply overrides
+        for (const [sectionId, overridePath] of Object.entries(overrides)) {
+            if (!mergedSections.has(sectionId)) {
+                // Override references a section that doesn't exist in parent
+                if (verbose) {
+                    const available = Array.from(mergedSections.keys()).sort().join(', ');
+                    console.log(`Warning: Override section '${sectionId}' not found in parent. Available: ${available}`);
+                }
+                continue;
+            }
+            if (overridePath === null) {
+                // Remove section
+                mergedSections.delete(sectionId);
+                if (verbose) {
+                    console.log(`  - Removing section '${sectionId}'`);
+                }
+            }
+            else {
+                // Replace section with content from file
+                try {
+                    const overrideContent = await this.loadOverrideContent(overridePath, baseDir, fileSystem);
+                    const originalSection = mergedSections.get(sectionId);
+                    mergedSections.set(sectionId, {
+                        ...originalSection,
+                        content: overrideContent
+                    });
+                    if (verbose) {
+                        console.log(`  - Replacing section '${sectionId}' with content from ${overridePath}`);
+                    }
+                }
+                catch (error) {
+                    throw new Error(`Failed to apply override for section '${sectionId}': ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+        }
+        // Merge child sections (child overrides parent for matching IDs)
+        for (const [sectionId, childSection] of childSections.entries()) {
+            mergedSections.set(sectionId, childSection);
+            if (verbose && parentSections.has(sectionId)) {
+                console.log(`  - Child overrides parent section '${sectionId}'`);
+            }
+            else if (verbose) {
+                console.log(`  - Adding child section '${sectionId}'`);
+            }
+        }
+        // Reconstruct content from merged sections
+        const contentParts = [];
+        for (const section of mergedSections.values()) {
+            contentParts.push(section.content);
+        }
+        return contentParts.join('\n\n');
+    }
+    /**
+     * Load override content from a file.
+     */
+    async loadOverrideContent(overridePath, baseDir, fileSystem) {
+        // Security: Validate and resolve path
+        const resolvedPath = this.resolveOverridePath(overridePath, baseDir);
+        // If using custom file system, use it directly
+        if (fileSystem) {
+            if (!await fileSystem.exists(resolvedPath)) {
+                throw new Error(`Override file not found: ${resolvedPath}`);
+            }
+            try {
+                const content = await fileSystem.readFile(resolvedPath);
+                return content.trim();
+            }
+            catch (error) {
+                throw new Error(`Failed to read override file: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        // Otherwise use Node.js fs (default behavior)
+        // Security: Check file exists
+        if (!await fs.pathExists(resolvedPath)) {
+            throw new Error(`Override file not found: ${resolvedPath}`);
+        }
+        // Security: Check it's a regular file
+        const stats = await fs.stat(resolvedPath);
+        if (!stats.isFile()) {
+            throw new errors_1.SecurityError(`Override path must be a regular file: ${resolvedPath}`);
+        }
+        // Security: Check file size (max 10MB)
+        const maxFileSize = 10 * 1024 * 1024;
+        if (stats.size > maxFileSize) {
+            throw new errors_1.SecurityError(`Override file too large: ${stats.size} bytes (max: ${maxFileSize})`);
+        }
+        // Load content
+        try {
+            const content = await fs.readFile(resolvedPath, 'utf-8');
+            return content.trim();
+        }
+        catch (error) {
+            throw new Error(`Failed to read override file: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Resolve override path with security checks.
+     */
+    resolveOverridePath(overridePath, baseDir) {
+        // Security: Path traversal protection
+        const normalized = path.normalize(overridePath);
+        // Security: Detect path traversal attempts
+        if (normalized.includes('..') && !overridePath.startsWith('./') && !overridePath.startsWith('../')) {
+            throw new errors_1.SecurityError(`Path traversal detected in override path: ${overridePath}`);
+        }
+        // Security: Reject absolute paths unless they're in safe locations
+        if (path.isAbsolute(normalized)) {
+            // Allow absolute paths only within the project or home directory
+            const projectRoot = process.cwd();
+            const homeDir = require('os').homedir();
+            if (!normalized.startsWith(projectRoot) && !normalized.startsWith(homeDir)) {
+                throw new errors_1.SecurityError(`Absolute paths outside project not allowed: ${overridePath}`);
+            }
+            return normalized;
+        }
+        // Resolve relative path from base directory
+        const resolved = path.resolve(baseDir, normalized);
+        // Security: Ensure resolved path doesn't escape base directory
+        if (!resolved.startsWith(baseDir) && !resolved.startsWith(process.cwd())) {
+            throw new errors_1.SecurityError(`Override path escapes base directory: ${overridePath}`);
+        }
+        return resolved;
+    }
+    /**
+     * Generate a section ID from heading text (kebab-case).
+     */
+    generateSectionId(headingText) {
+        return headingText
+            .toLowerCase()
+            .trim()
+            .replace(/[^a-z0-9\s-]/g, '') // Remove non-alphanumeric except spaces and hyphens
+            .replace(/\s+/g, '-') // Replace spaces with hyphens
+            .replace(/-+/g, '-') // Collapse multiple hyphens
+            .replace(/^-|-$/g, ''); // Remove leading/trailing hyphens
+    }
+    /**
+     * Validate section ID format.
+     */
+    validateSectionId(sectionId, lineNumber) {
+        // Section IDs must be kebab-case (lowercase letters, numbers, hyphens)
+        const validPattern = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+        if (!validPattern.test(sectionId)) {
+            const location = lineNumber ? ` at line ${lineNumber}` : '';
+            throw new errors_1.ValidationError(`Invalid section ID '${sectionId}'${location}. ` +
+                `Section IDs must be kebab-case (lowercase letters, numbers, hyphens only).`);
+        }
+        // Security: Check for excessively long IDs (potential DoS)
+        if (sectionId.length > 100) {
+            throw new errors_1.ValidationError(`Section ID too long: ${sectionId.length} characters (max: 100)`);
+        }
+        // Security: Reject IDs that might be used for code injection
+        const dangerousPatterns = ['__proto__', 'constructor', 'prototype'];
+        if (dangerousPatterns.some(pattern => sectionId.includes(pattern))) {
+            throw new errors_1.SecurityError(`Section ID contains forbidden pattern: ${sectionId}`);
+        }
+    }
+}
+exports.SectionOverrideProcessor = SectionOverrideProcessor;
+//# sourceMappingURL=section-override.js.map

package/dist/lib/compiler/section-override.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-override.js","sourceRoot":"","sources":["../../../src/lib/compiler/section-override.ts"],"names":[],"mappings":"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"}

package/dist/lib/compiler/stages/assets.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Asset Extraction Stage
+ *
+ * Extracts content from binary files (Excel, Word, PDF, Images) with
+ * comprehensive security validation.
+ *
+ * Supported formats:
+ * - Excel: .xlsx, .xls
+ * - Word: .docx
+ * - PDF: .pdf
+ * - Images: .png, .jpg, .jpeg, .gif (metadata only)
+ * - Text: .txt, .md, .json, .yaml, .yml
+ */
+import { CompilerStage, CompilationContext } from '../types';
+export declare class AssetExtractionStage implements CompilerStage {
+    private maxFileSize;
+    private allowedExtensions;
+    constructor();
+    process(context: CompilationContext): Promise<void>;
+    /**
+     * Process context files from metadata.
+     * Extracts file content and adds to context.contexts array.
+     * This matches the Python CLI behavior where context is output at the top.
+     */
+    private processContextFiles;
+    /**
+     * Process YAML-defined section file references.
+     * Replaces placeholder content with extracted file content.
+     */
+    private processYamlSectionFiles;
+    /**
+     * Process inline file references in content.
+     * Replaces [file:./path] placeholders with extracted content.
+     */
+    private processInlineFileReferences;
+    /**
+     * Extract content from a file with security validation.
+     */
+    private extractFile;
+    /**
+     * Security: Validate file path for path traversal and other attacks.
+     */
+    private validateFilePath;
+    /**
+     * Security: Validate file properties.
+     */
+    private validateFile;
+    /**
+     * Extract content from Excel files.
+     */
+    private extractExcel;
+    /**
+     * Extract content from Word documents.
+     */
+    private extractWord;
+    /**
+     * Extract content from PDF files.
+     */
+    private extractPdf;
+    /**
+     * Extract metadata from images (OCR not implemented).
+     */
+    private extractImageMetadata;
+    /**
+     * Extract plain text content.
+     * For code files, wraps content in markdown code blocks with appropriate language identifier.
+     */
+    private extractText;
+    getName(): string;
+}
+//# sourceMappingURL=assets.d.ts.map

package/dist/lib/compiler/stages/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../../src/lib/compiler/stages/assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AA2B7D,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,iBAAiB,CAAc;;IAgBjC,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBzD;;;;OAIG;YACW,mBAAmB;IA2CjC;;;OAGG;YACW,uBAAuB;IA0DrC;;;OAGG;YACW,2BAA2B;IAwCzC;;OAEG;YACW,WAAW;IAmDzB;;OAEG;YACW,gBAAgB;IAgB9B;;OAEG;YACW,YAAY;IAsB1B;;OAEG;YACW,YAAY;IAsB1B;;OAEG;YACW,WAAW;IAiBzB;;OAEG;YACW,UAAU;IAwBxB;;OAEG;YACW,oBAAoB;IAyBlC;;;OAGG;YACW,WAAW;IA+BzB,OAAO,IAAI,MAAM;CAGlB"}