pipecraft 0.0.0-releaseit

package/dist/utils/ast-path-operations.js

@@ -0,0 +1,419 @@
+import { parseDocument, stringify, YAMLMap, YAMLSeq, Scalar } from 'yaml';
+/**
+ * Set a value at a specific path in the YAML AST
+ *
+ * Creates intermediate nodes as needed and sets the final value at the specified path.
+ * This is the core function for setting values in the YAML structure.
+ *
+ * @param {YAMLMap} doc - The YAML document to modify
+ * @param {string} path - Dot-notation path (e.g., 'jobs.changes.steps')
+ * @param {PathValue} value - Value to set at the path
+ *
+ * @throws {Error} When path navigation fails or parent is not a map
+ *
+ * @example
+ * ```typescript
+ * const doc = parseDocument('name: Pipeline')
+ * setPathValue(doc.contents, 'jobs.changes.runs-on', 'ubuntu-latest')
+ * // Results in: jobs: { changes: { 'runs-on': 'ubuntu-latest' } }
+ * ```
+ */
+export function setPathValue(doc, path, value, document, commentBefore, spaceBeforeComment) {
+    const pathParts = path.split('.');
+    let current = doc;
+    // Navigate to the parent of the target
+    for (let i = 0; i < pathParts.length - 1; i++) {
+        const part = pathParts[i];
+        if (current instanceof YAMLMap) {
+            let next = current.get(part);
+            if (!next) {
+                // Create missing intermediate nodes
+                next = new YAMLMap();
+                current.set(part, next);
+            }
+            current = next;
+        }
+        else {
+            throw new Error(`Cannot navigate to ${part} - parent is not a map`);
+        }
+    }
+    // Set the final value
+    const finalKey = pathParts[pathParts.length - 1];
+    if (current instanceof YAMLMap) {
+        let node;
+        // Check if value is already a node (from createValueFromString, etc.)
+        if (value && typeof value === 'object' && ('items' in value || 'type' in value)) {
+            // Value is already a node, use it directly
+            node = value;
+        }
+        else {
+            // Value is not a node, create one
+            node = document && document.createNode ? document.createNode(value) : createNode(value);
+        }
+        // When commentBefore is provided, or when setting a job key (which may need comments added later),
+        // we need to create a Scalar key instead of a string key.
+        // This is because YAML's set() method creates a plain string key by default,
+        // but comments can only be attached to Scalar objects.
+        const isJobKey = pathParts.length === 2 && pathParts[0] === 'jobs';
+        if (commentBefore || isJobKey) {
+            // Create a Scalar key (with or without comment)
+            const scalarKey = new Scalar(finalKey);
+            if (commentBefore) {
+                ;
+                scalarKey.commentBefore = commentBefore;
+            }
+            // Add blank line before the comment if requested
+            if (spaceBeforeComment) {
+                ;
+                scalarKey.spaceBefore = true;
+            }
+            // Add the pair to the map with a Scalar key
+            current.add({ key: scalarKey, value: node });
+        }
+        else {
+            // Normal case: use the simple set() method which creates a string key
+            current.set(finalKey, node);
+        }
+    }
+    else {
+        throw new Error(`Cannot set ${finalKey} - parent is not a map`);
+    }
+}
+/**
+ * Get a value at a specific path in the YAML AST
+ *
+ * Navigates to the specified path and returns the node if found, null otherwise.
+ * This is useful for checking if a path exists before applying operations.
+ *
+ * @param {YAMLMap} doc - The YAML document to read from
+ * @param {string} path - Dot-notation path (e.g., 'jobs.changes.steps')
+ * @returns {Node | null} The node at the path, or null if not found
+ *
+ * @example
+ * ```typescript
+ * const doc = parseDocument('jobs: { changes: { runs-on: ubuntu-latest } }')
+ * const value = getPathValue(doc.contents, 'jobs.changes.runs-on')
+ * console.log(value) // Scalar('ubuntu-latest')
+ * ```
+ */
+export function getPathValue(doc, path) {
+    const pathParts = path.split('.');
+    let current = doc;
+    for (const part of pathParts) {
+        if (current instanceof YAMLMap) {
+            current = current.get(part);
+            if (!current)
+                return null;
+        }
+        else {
+            return null;
+        }
+    }
+    return current;
+}
+/**
+ * Ensure a path exists and apply the specified operation
+ *
+ * This is the main orchestration function that handles all path operations.
+ * It checks if the path exists, applies the appropriate operation based on
+ * the configuration, and handles required vs optional paths.
+ *
+ * @param {YAMLMap} doc - The YAML document to modify
+ * @param {PathOperationConfig} config - Operation configuration
+ *
+ * @example
+ * ```typescript
+ * const config: PathOperationConfig = {
+ *   path: 'jobs.changes.runs-on',
+ *   operation: 'set',
+ *   value: 'ubuntu-latest',
+ *   required: true
+ * }
+ *
+ * ensurePathAndApply(doc, config)
+ * ```
+ */
+export function ensurePathAndApply(doc, config, document) {
+    const { path, operation, value, required = true, commentBefore, spaceBeforeComment } = config;
+    // Check if path exists
+    const existingValue = getPathValue(doc, path);
+    if (!existingValue && !required) {
+        // Path doesn't exist and not required - skip
+        return;
+    }
+    // Apply operation based on whether path exists or not
+    // For required paths that don't exist, we still respect the operation type
+    switch (operation) {
+        case 'set':
+            setPathValue(doc, path, value, document, commentBefore, spaceBeforeComment);
+            break;
+        case 'merge':
+            // Merge will handle non-existent paths by creating them
+            mergePathValue(doc, path, value, document);
+            break;
+        case 'overwrite':
+            setPathValue(doc, path, value, document, commentBefore, spaceBeforeComment);
+            break;
+        case 'preserve':
+            // Only preserve if path exists, otherwise create it
+            if (!existingValue) {
+                setPathValue(doc, path, value, document, commentBefore, spaceBeforeComment);
+            }
+            // If exists, do nothing - keep existing value
+            break;
+    }
+}
+/**
+ * Merge a value at a specific path (for objects/arrays)
+ *
+ * Intelligently merges values based on their type:
+ * - Objects: Merges key-value pairs, preserving existing keys
+ * - Arrays: Adds new items that don't already exist
+ * - Other types: Falls back to overwrite behavior
+ *
+ * @param {YAMLMap} doc - The YAML document to modify
+ * @param {string} path - Dot-notation path to merge at
+ * @param {PathValue} value - Value to merge
+ *
+ * @example
+ * ```typescript
+ * // Merge object properties
+ * mergePathValue(doc, 'on.workflow_call.inputs', {
+ *   version: { description: 'Version to deploy' },
+ *   environment: { description: 'Environment to deploy to' }
+ * })
+ *
+ * // Merge array items
+ * mergePathValue(doc, 'on.pull_request.branches', ['feature-branch'])
+ * ```
+ */
+function mergePathValue(doc, path, value, document) {
+    const existingValue = getPathValue(doc, path);
+    if (!existingValue) {
+        setPathValue(doc, path, value, document);
+        return;
+    }
+    // Merge logic based on type
+    if (existingValue instanceof YAMLMap && typeof value === 'object') {
+        // Merge objects
+        const newMap = (document && document.createNode ? document.createNode(value) : createNode(value));
+        for (const pair of newMap.items) {
+            const key = pair.key;
+            const val = pair.value;
+            existingValue.set(key, val);
+        }
+    }
+    else if (existingValue instanceof YAMLSeq && Array.isArray(value)) {
+        // Merge arrays - add new items that don't exist
+        const newSeq = (document && document.createNode ? document.createNode(value) : createNode(value));
+        for (const item of newSeq.items) {
+            if (!existingValue.items.some(existing => stringify(existing) === stringify(item))) {
+                existingValue.items.push(item);
+            }
+        }
+    }
+    else {
+        // Fallback to overwrite
+        setPathValue(doc, path, value, document);
+    }
+}
+/**
+ * Create a YAML node from a JavaScript value, YAML node, or parsed document
+ *
+ * This is the core value conversion function that handles all supported value types.
+ * It intelligently converts JavaScript values to appropriate YAML nodes.
+ *
+ * @param {PathValue} value - Value to convert to YAML node
+ * @returns {Node} The converted YAML node
+ *
+ * @example
+ * ```typescript
+ * // Convert object
+ * const node = createNode({ key: 'value' })
+ *
+ * // Convert array
+ * const node = createNode(['item1', 'item2'])
+ *
+ * // Convert string
+ * const node = createNode('simple string')
+ *
+ * // Convert YAML string
+ * const node = createNode(createValueFromString(`
+ *   runs-on: ubuntu-latest
+ *   steps:
+ *     - name: Example step
+ *       run: echo "Hello"
+ * `))
+ * ```
+ */
+function createNode(value) {
+    // If it's already a YAML node, return it
+    if (value && typeof value === 'object' && 'type' in value) {
+        return value;
+    }
+    // If it's a parsed document, extract the contents
+    if (value && typeof value === 'object' && 'contents' in value) {
+        const contents = value.contents;
+        // If contents is a single item, return it directly
+        if (contents && typeof contents === 'object' && 'type' in contents) {
+            return contents;
+        }
+        return contents;
+    }
+    // Handle primitive types
+    if (typeof value === 'string') {
+        return new Scalar(value);
+    }
+    else if (typeof value === 'number') {
+        return new Scalar(value);
+    }
+    else if (typeof value === 'boolean') {
+        return new Scalar(value);
+    }
+    else if (Array.isArray(value)) {
+        const seq = new YAMLSeq();
+        for (const item of value) {
+            seq.items.push(createNode(item));
+        }
+        return seq;
+    }
+    else if (typeof value === 'object' && value !== null) {
+        const map = new YAMLMap();
+        for (const [key, val] of Object.entries(value)) {
+            map.set(key, createNode(val));
+        }
+        return map;
+    }
+    else {
+        return new Scalar(value);
+    }
+}
+/**
+ * Apply multiple path operations to a document
+ *
+ * This is the main entry point for applying multiple operations to a YAML document.
+ * It processes all operations in order and applies them to the document.
+ *
+ * @param {YAMLMap} doc - The YAML document to modify
+ * @param {PathOperationConfig[]} operations - Array of operations to apply
+ *
+ * @example
+ * ```typescript
+ * const operations: PathOperationConfig[] = [
+ *   {
+ *     path: 'on.workflow_call.inputs.version',
+ *     operation: 'set',
+ *     value: { description: 'Version to deploy', required: false, type: 'string' }
+ *   },
+ *   {
+ *     path: 'jobs.changes',
+ *     operation: 'overwrite',
+ *     value: createValueFromString(`
+ *       runs-on: ubuntu-latest
+ *       steps:
+ *         - uses: ./.github/actions/detect-changes
+ *     `)
+ *   }
+ * ]
+ *
+ * applyPathOperations(doc, operations)
+ * ```
+ */
+export function applyPathOperations(doc, operations, document) {
+    for (const operation of operations) {
+        ensurePathAndApply(doc, operation, document);
+    }
+}
+/**
+ * Helper functions for creating values
+ *
+ * These convenience functions make it easier to create YAML nodes from different
+ * value types. They handle the parsing and conversion automatically.
+ */
+/**
+ * Create a YAML node from a YAML string
+ *
+ * Parses a YAML string and returns the root node. This is useful for complex
+ * multi-line YAML structures like job definitions.
+ *
+ * @param {string} yamlString - YAML string to parse
+ * @returns {Node} The parsed YAML node
+ *
+ * @example
+ * ```typescript
+ * const node = createValueFromString(`
+ *   runs-on: ubuntu-latest
+ *   steps:
+ *     - name: Checkout code
+ *       uses: actions/checkout@v3
+ *     - name: Run tests
+ *       run: npm test
+ * `)
+ * ```
+ */
+export function createValueFromString(yamlString, context, document) {
+    // Evaluate JavaScript template literals in the string using the provided context
+    // Use a more sophisticated approach that handles nested braces
+    let processedString = yamlString;
+    let match;
+    const regex = /\$\{([^{}]+)\}/g;
+    while ((match = regex.exec(processedString)) !== null) {
+        const [fullMatch, expression] = match;
+        try {
+            // Create a function that evaluates the expression with the context
+            const func = new Function('ctx', `return ${expression}`);
+            const result = func(context || {});
+            processedString = processedString.replace(fullMatch, JSON.stringify(result));
+            // Reset regex lastIndex to avoid issues with string replacement
+            regex.lastIndex = 0;
+        }
+        catch (error) {
+            // If evaluation fails, return the original expression as a string
+            processedString = processedString.replace(fullMatch, `"${expression}"`);
+            regex.lastIndex = 0;
+        }
+    }
+    // Parse the YAML string and return the root content as a proper Node
+    const doc = parseDocument(processedString);
+    return doc.contents;
+}
+/**
+ * Create a YAML node from a JavaScript object
+ *
+ * Converts a plain JavaScript object to a YAML map node.
+ *
+ * @param {object} obj - JavaScript object to convert
+ * @returns {Node} The converted YAML map node
+ *
+ * @example
+ * ```typescript
+ * const node = createValueFromObject({
+ *   description: 'The version to deploy',
+ *   required: false,
+ *   type: 'string'
+ * })
+ * ```
+ */
+export function createValueFromObject(obj, doc) {
+    if (doc && doc.createNode) {
+        return doc.createNode(obj);
+    }
+    return createNode(obj);
+}
+/**
+ * Create a YAML node from a JavaScript array
+ *
+ * Converts a JavaScript array to a YAML sequence node.
+ *
+ * @param {any[]} arr - JavaScript array to convert
+ * @returns {Node} The converted YAML sequence node
+ *
+ * @example
+ * ```typescript
+ * const node = createValueFromArray(['develop', 'staging', 'main'])
+ * ```
+ */
+export function createValueFromArray(arr) {
+    return createNode(arr);
+}
+//# sourceMappingURL=ast-path-operations.js.map

package/dist/utils/ast-path-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-path-operations.js","sourceRoot":"","sources":["../../src/utils/ast-path-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAQ,MAAM,MAAM,CAAA;AA0I/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY,EAAE,IAAY,EAAE,KAAgB,EAAE,QAAc,EAAE,aAAsB,EAAE,kBAA4B;IAC7I,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,OAAO,GAAS,GAAG,CAAA;IAEvB,uCAAuC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;QAEzB,IAAI,OAAO,YAAY,OAAO,EAAE,CAAC;YAC/B,IAAI,IAAI,GAAQ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACjC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,oCAAoC;gBACpC,IAAI,GAAG,IAAI,OAAO,EAAE,CAAA;gBACpB,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YACzB,CAAC;YACD,OAAO,GAAG,IAAI,CAAA;QAChB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,wBAAwB,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAChD,IAAI,OAAO,YAAY,OAAO,EAAE,CAAC;QAC/B,IAAI,IAAS,CAAA;QAEb,sEAAsE;QACtE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,OAAO,IAAI,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC;YAChF,2CAA2C;YAC3C,IAAI,GAAG,KAAK,CAAA;QACd,CAAC;aAAM,CAAC;YACN,kCAAkC;YAClC,IAAI,GAAG,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;QACzF,CAAC;QAED,mGAAmG;QACnG,0DAA0D;QAC1D,6EAA6E;QAC7E,uDAAuD;QACvD,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,MAAM,CAAA;QAElE,IAAI,aAAa,IAAI,QAAQ,EAAE,CAAC;YAC9B,gDAAgD;YAChD,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAA;YAEtC,IAAI,aAAa,EAAE,CAAC;gBAClB,CAAC;gBAAC,SAAiB,CAAC,aAAa,GAAG,aAAa,CAAA;YACnD,CAAC;YAED,iDAAiD;YACjD,IAAI,kBAAkB,EAAE,CAAC;gBACvB,CAAC;gBAAC,SAAiB,CAAC,WAAW,GAAG,IAAI,CAAA;YACxC,CAAC;YAED,4CAA4C;YAC5C,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAC9C,CAAC;aAAM,CAAC;YACN,sEAAsE;YACtE,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,wBAAwB,CAAC,CAAA;IACjE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY,EAAE,IAAY;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,OAAO,GAAS,GAAG,CAAA;IAEvB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,OAAO,YAAY,OAAO,EAAE,CAAC;YAC/B,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAS,CAAA;YACnC,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAA;QAC3B,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAY,EACZ,MAA2B,EAC3B,QAAc;IAEd,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,aAAa,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAAA;IAE7F,uBAAuB;IACvB,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAE7C,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChC,6CAA6C;QAC7C,OAAM;IACR,CAAC;IAED,sDAAsD;IACtD,2EAA2E;IAC3E,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,KAAK;YACR,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,kBAAkB,CAAC,CAAA;YAC3E,MAAK;QAEP,KAAK,OAAO;YACV,wDAAwD;YACxD,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;YAC1C,MAAK;QAEP,KAAK,WAAW;YACd,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,kBAAkB,CAAC,CAAA;YAC3E,MAAK;QAEP,KAAK,UAAU;YACb,oDAAoD;YACpD,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,kBAAkB,CAAC,CAAA;YAC7E,CAAC;YACD,8CAA8C;YAC9C,MAAK;IACT,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAS,cAAc,CAAC,GAAY,EAAE,IAAY,EAAE,KAAgB,EAAE,QAAc;IAClF,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAE7C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;QACxC,OAAM;IACR,CAAC;IAED,4BAA4B;IAC5B,IAAI,aAAa,YAAY,OAAO,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAClE,gBAAgB;QAChB,MAAM,MAAM,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAY,CAAA;QAC5G,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;YACpB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAA;YACtB,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;SAAM,IAAI,aAAa,YAAY,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpE,gDAAgD;QAChD,MAAM,MAAM,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAY,CAAA;QAC5G,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CACvC,SAAS,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,CACxC,EAAE,CAAC;gBACF,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAChC,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,wBAAwB;QACxB,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;IAC1C,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,SAAS,UAAU,CAAC,KAAgB;IAClC,yCAAyC;IACzC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QAC1D,OAAO,KAAa,CAAA;IACtB,CAAC;IAED,kDAAkD;IAClD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,IAAI,KAAK,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAI,KAAa,CAAC,QAAQ,CAAA;QACxC,mDAAmD;QACnD,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,IAAI,QAAQ,EAAE,CAAC;YACnE,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,yBAAyB;IACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,OAAO,EAAE,CAAA;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;QAClC,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,OAAO,EAAE,CAAA;QACzB,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;QAC/B,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAY,EACZ,UAAiC,EACjC,QAAc;IAEd,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB,EAAE,OAAa,EAAE,QAAc;IACrF,iFAAiF;IACjF,+DAA+D;IAC/D,IAAI,eAAe,GAAG,UAAU,CAAA;IAChC,IAAI,KAAK,CAAA;IACT,MAAM,KAAK,GAAG,iBAAiB,CAAA;IAE/B,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,KAAK,CAAA;QACrC,IAAI,CAAC;YACH,mEAAmE;YACnE,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,UAAU,UAAU,EAAE,CAAC,CAAA;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;YAClC,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;YAC5E,gEAAgE;YAChE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAA;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kEAAkE;YAClE,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,UAAU,GAAG,CAAC,CAAA;YACvE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAA;QACrB,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,MAAM,GAAG,GAAG,aAAa,CAAC,eAAe,CAAC,CAAA;IAC1C,OAAO,GAAG,CAAC,QAAgB,CAAA;AAC7B,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW,EAAE,GAAS;IAC1D,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QAC1B,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;IACD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAU;IAC7C,OAAO,UAAU,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,3 @@
+export declare const loadConfig: (configPath?: string) => any;
+export declare const validateConfig: (config: any) => boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,GAAI,aAAa,MAAM,QAS7C,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,QAAQ,GAAG,YAiDzC,CAAA"}

package/dist/utils/config.js

@@ -0,0 +1,49 @@
+import { cosmiconfigSync } from 'cosmiconfig';
+export const loadConfig = (configPath) => {
+    const explorer = cosmiconfigSync('pipecraft');
+    const result = configPath ? explorer.load(configPath) : explorer.search();
+    if (!result) {
+        throw new Error(`No configuration file found. Expected: ${configPath || '.pipecraftrc.json'}`);
+    }
+    return result.config;
+};
+export const validateConfig = (config) => {
+    const requiredFields = ['ciProvider', 'mergeStrategy', 'requireConventionalCommits', 'initialBranch', 'finalBranch', 'branchFlow', 'domains'];
+    for (const field of requiredFields) {
+        if (!(field in config)) {
+            throw new Error(`Missing required field: ${field}`);
+        }
+    }
+    if (!['github', 'gitlab'].includes(config.ciProvider)) {
+        throw new Error('ciProvider must be either "github" or "gitlab"');
+    }
+    if (!['fast-forward', 'merge'].includes(config.mergeStrategy)) {
+        throw new Error('mergeStrategy must be either "fast-forward" or "merge"');
+    }
+    if (!Array.isArray(config.branchFlow) || config.branchFlow.length < 2) {
+        throw new Error('branchFlow must be an array with at least 2 branches');
+    }
+    if (typeof config.domains !== 'object') {
+        throw new Error('domains must be an object');
+    }
+    for (const [domainName, domainConfig] of Object.entries(config.domains)) {
+        if (!domainConfig || typeof domainConfig !== 'object') {
+            throw new Error(`Domain "${domainName}" must be an object`);
+        }
+        if (!domainConfig.paths || !Array.isArray(domainConfig.paths)) {
+            throw new Error(`Domain "${domainName}" must have a "paths" array`);
+        }
+        if (domainConfig.paths.length === 0) {
+            throw new Error(`Domain "${domainName}" must have at least one path pattern`);
+        }
+        // Set defaults for optional properties
+        if (domainConfig.testable === undefined) {
+            domainConfig.testable = true;
+        }
+        if (domainConfig.deployable === undefined) {
+            domainConfig.deployable = true;
+        }
+    }
+    return true;
+};
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAG7C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAmB,EAAE,EAAE;IAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAA;IAEzE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,0CAA0C,UAAU,IAAI,mBAAmB,EAAE,CAAC,CAAA;IAChG,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAA;AACtB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAW,EAAE,EAAE;IAC5C,MAAM,cAAc,GAAG,CAAC,YAAY,EAAE,eAAe,EAAE,4BAA4B,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,CAAC,CAAA;IAE7I,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAA;QACrD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IACnE,CAAC;IAED,IAAI,CAAC,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;IAC3E,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;IACzE,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAC9C,CAAC;IAED,KAAK,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAA6B,EAAE,CAAC;QACpG,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,WAAW,UAAU,qBAAqB,CAAC,CAAA;QAC7D,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,WAAW,UAAU,6BAA6B,CAAC,CAAA;QACrE,CAAC;QAED,IAAI,YAAY,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,WAAW,UAAU,uCAAuC,CAAC,CAAA;QAC/E,CAAC;QAED,uCAAuC;QACvC,IAAI,YAAY,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACxC,YAAY,CAAC,QAAQ,GAAG,IAAI,CAAA;QAC9B,CAAC;QACD,IAAI,YAAY,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAC1C,YAAY,CAAC,UAAU,GAAG,IAAI,CAAA;QAChC,CAAC;IACH,CAAC;IAGD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

package/dist/utils/github-setup.d.ts

@@ -0,0 +1,74 @@
+interface WorkflowPermissions {
+    default_workflow_permissions: 'read' | 'write';
+    can_approve_pull_request_reviews: boolean;
+}
+interface RepositoryInfo {
+    owner: string;
+    repo: string;
+    remote: string;
+}
+interface BranchProtectionRules {
+    required_status_checks: null | {
+        strict: boolean;
+        contexts: string[];
+    };
+    enforce_admins: boolean;
+    required_pull_request_reviews: null | {
+        dismiss_stale_reviews: boolean;
+        require_code_owner_reviews: boolean;
+        required_approving_review_count: number;
+    };
+    restrictions: null;
+    allow_force_pushes: boolean;
+    allow_deletions: boolean;
+    required_linear_history: boolean;
+    required_conversation_resolution: boolean;
+}
+/**
+ * Get repository information from git remote
+ */
+export declare function getRepositoryInfo(): RepositoryInfo;
+/**
+ * Get GitHub token from environment or gh CLI
+ */
+export declare function getGitHubToken(): string;
+/**
+ * Get current workflow permissions
+ */
+export declare function getWorkflowPermissions(owner: string, repo: string, token: string): Promise<WorkflowPermissions>;
+/**
+ * Update workflow permissions
+ */
+export declare function updateWorkflowPermissions(owner: string, repo: string, token: string, permissions: Partial<WorkflowPermissions>): Promise<void>;
+/**
+ * Determine required permission changes without prompting
+ * Returns: changes object if changes needed, null if already correct
+ */
+export declare function getRequiredPermissionChanges(currentPermissions: WorkflowPermissions): Partial<WorkflowPermissions> | null;
+/**
+ * Display current permissions and prompt for changes
+ * Returns: changes object if user accepted changes, 'declined' if user declined, null if already correct
+ */
+export declare function promptPermissionChanges(currentPermissions: WorkflowPermissions): Promise<Partial<WorkflowPermissions> | null | 'declined'>;
+/**
+ * Get branch protection rules
+ */
+export declare function getBranchProtection(owner: string, repo: string, branch: string, token: string): Promise<BranchProtectionRules | null>;
+/**
+ * Update branch protection rules to enable auto-merge
+ */
+export declare function updateBranchProtection(owner: string, repo: string, branch: string, token: string): Promise<void>;
+/**
+ * Enable auto-merge feature for the repository
+ */
+export declare function enableAutoMerge(owner: string, repo: string, token: string): Promise<boolean>;
+/**
+ * Configure branch protection for branches that need auto-merge
+ */
+export declare function configureBranchProtection(repoInfo: RepositoryInfo, token: string, autoApply: boolean): Promise<void>;
+/**
+ * Main setup function
+ */
+export declare function setupGitHubPermissions(autoApply?: boolean): Promise<void>;
+export {};
+//# sourceMappingURL=github-setup.d.ts.map

package/dist/utils/github-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-setup.d.ts","sourceRoot":"","sources":["../../src/utils/github-setup.ts"],"names":[],"mappings":"AAKA,UAAU,mBAAmB;IAC3B,4BAA4B,EAAE,MAAM,GAAG,OAAO,CAAA;IAC9C,gCAAgC,EAAE,OAAO,CAAA;CAC1C;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,UAAU,qBAAqB;IAC7B,sBAAsB,EAAE,IAAI,GAAG;QAC7B,MAAM,EAAE,OAAO,CAAA;QACf,QAAQ,EAAE,MAAM,EAAE,CAAA;KACnB,CAAA;IACD,cAAc,EAAE,OAAO,CAAA;IACvB,6BAA6B,EAAE,IAAI,GAAG;QACpC,qBAAqB,EAAE,OAAO,CAAA;QAC9B,0BAA0B,EAAE,OAAO,CAAA;QACnC,+BAA+B,EAAE,MAAM,CAAA;KACxC,CAAA;IACD,YAAY,EAAE,IAAI,CAAA;IAClB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,eAAe,EAAE,OAAO,CAAA;IACxB,uBAAuB,EAAE,OAAO,CAAA;IAChC,gCAAgC,EAAE,OAAO,CAAA;CAC1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAqBlD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAuBvC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,CAAC,CAkB9B;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,kBAAkB,EAAE,mBAAmB,GACtC,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAoBrC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,kBAAkB,EAAE,mBAAmB,GACtC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,GAAG,UAAU,CAAC,CA6D3D;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAuBvC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CA2ClB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,IAAI,CAAC,CA2Ff;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,SAAS,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAmFtF"}