@synergenius/flow-weaver 0.13.2 → 0.14.0

package/dist/generated-version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.13.2";
+export declare const VERSION = "0.14.0";
 //# sourceMappingURL=generated-version.d.ts.map

package/dist/generated-version.js

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/generate-version.ts — do not edit manually
-export const VERSION = '0.13.2';
+export const VERSION = '0.14.0';
 //# sourceMappingURL=generated-version.js.map

package/dist/jsdoc-parser.d.ts

@@ -33,6 +33,7 @@ export interface JSDocNodeTypeConfig {
         expression?: string;
         scope?: string;
         mergeStrategy?: TMergeStrategy;
+        hidden?: boolean;
         metadata?: {
             order?: number;
         };
@@ -42,11 +43,14 @@ export interface JSDocNodeTypeConfig {
         type: TDataType;
         label?: string;
         scope?: string;
+        hidden?: boolean;
         metadata?: {
             order?: number;
         };
         tsType?: string;
     }>;
+    /** Per-target deploy config from @deploy annotations on nodeType */
+    deploy?: Record<string, Record<string, unknown>>;
 }
 export interface JSDocWorkflowConfig {
     name?: string;
@@ -79,6 +83,10 @@ export interface JSDocWorkflowConfig {
             line: number;
             column: number;
         };
+        /** CI/CD job group */
+        job?: string;
+        /** CI/CD deployment environment */
+        environment?: string;
     }>;
     connections?: Array<{
         from: {
@@ -192,6 +200,69 @@ export interface JSDocWorkflowConfig {
         limit: number;
         period?: string;
     };
+    /** @secret declarations */
+    secrets?: Array<{
+        name: string;
+        description?: string;
+        platform?: 'github' | 'gitlab' | 'all';
+        scope?: string;
+    }>;
+    /** @runner default execution environment */
+    runner?: string;
+    /** @cache configurations */
+    caches?: Array<{
+        strategy: string;
+        path?: string;
+        key?: string;
+    }>;
+    /** @artifact declarations */
+    artifacts?: Array<{
+        name: string;
+        path: string;
+        retention?: number;
+    }>;
+    /** @environment declarations */
+    environments?: Array<{
+        name: string;
+        url?: string;
+        reviewers?: number;
+    }>;
+    /** @matrix strategy */
+    matrix?: {
+        dimensions: Record<string, string[]>;
+        include?: Record<string, string>[];
+        exclude?: Record<string, string>[];
+    };
+    /** @service containers */
+    services?: Array<{
+        name: string;
+        image: string;
+        env?: Record<string, string>;
+        ports?: string[];
+    }>;
+    /** @concurrency control */
+    concurrency?: {
+        group: string;
+        cancelInProgress?: boolean;
+    };
+    /** Extended CI/CD triggers from @trigger push/pull_request/dispatch/tag */
+    cicdTriggers?: Array<{
+        type: 'push' | 'pull_request' | 'schedule' | 'dispatch' | 'tag';
+        branches?: string[];
+        paths?: string[];
+        pathsIgnore?: string[];
+        pattern?: string;
+        types?: string[];
+        cron?: string;
+        inputs?: Record<string, {
+            description?: string;
+            required?: boolean;
+            default?: string;
+            type?: string;
+        }>;
+    }>;
+    /** @deploy target key=value pairs */
+    deploy?: Record<string, Record<string, unknown>>;
 }
 export interface JSDocPatternConfig {
     name?: string;
@@ -331,6 +402,10 @@ export declare class JSDocParser {
      * Parse @trigger tag using Chevrotain parser.
      */
     private parseTriggerTag;
+    /**
+     * Parse a CI/CD-specific trigger type (push, pull_request, dispatch, tag, schedule).
+     */
+    private parseCICDTrigger;
     /**
      * Parse @cancelOn tag using Chevrotain parser.
      */
@@ -339,6 +414,61 @@ export declare class JSDocParser {
      * Parse @throttle tag using Chevrotain parser.
      */
     private parseThrottleTag;
+    /**
+     * Dispatch a CI/CD or @deploy tag to the appropriate parser.
+     * Consolidates all deployment-related cases from the main switch.
+     */
+    private handleDeploymentTag;
+    /**
+     * Parse @deploy tag.
+     * Format: @deploy <target> key=value key2="value with spaces" key3=123 key4=true
+     *
+     * Examples:
+     *   @deploy github-actions action="actions/checkout@v4"
+     *   @deploy inngest durableSteps=true framework="next" retries=3
+     *   @deploy lambda memory=256 timeout=30
+     *
+     * Values are auto-coerced: "true"/"false" → boolean, numeric strings → number.
+     */
+    private parseDeployTag;
+    /**
+     * Parse @secret tag.
+     * Format: @secret NAME - description
+     * Optional: @secret NAME scope="deploy" platform="github" - description
+     */
+    private parseSecretTag;
+    /**
+     * Parse @cache tag.
+     * Format: @cache strategy [key="file"] [path="dir"]
+     */
+    private parseCacheTag;
+    /**
+     * Parse @artifact tag.
+     * Format: @artifact name path="dist/" [retention=5]
+     */
+    private parseArtifactTag;
+    /**
+     * Parse @environment tag.
+     * Format: @environment name [url="..."] [reviewers=N]
+     */
+    private parseEnvironmentTag;
+    /**
+     * Parse @matrix tag.
+     * Format: @matrix dim1="val1,val2" dim2="val3,val4"
+     * Or: @matrix include dim1="val1" dim2="val2"
+     * Or: @matrix exclude dim1="val1" dim2="val2"
+     */
+    private parseMatrixTag;
+    /**
+     * Parse @service tag.
+     * Format: @service name image="..." [env="K=V,K2=V2"] [ports="5432:5432"]
+     */
+    private parseServiceTag;
+    /**
+     * Parse @concurrency tag.
+     * Format: @concurrency group="name" [cancel-in-progress=true]
+     */
+    private parseConcurrencyTag;
     /**
      * Parse default value from string
      */

package/dist/jsdoc-parser.js

@@ -195,6 +195,10 @@ export class JSDocParser {
                 case 'step':
                     this.parseStepTag(tag, config, func, warnings);
                     break;
+                case 'deploy':
+                    config.deploy = config.deploy || {};
+                    this.parseDeployTag(tag, config.deploy);
+                    break;
                 default:
                     // D: Context validation - tags that belong to other block types
                     if (tagName === 'param' || tagName === 'returns' || tagName === 'return') {
@@ -316,6 +320,18 @@ export class JSDocParser {
                 case 'throttle':
                     this.parseThrottleTag(tag, config, warnings);
                     break;
+                // ── CI/CD + deployment annotations (delegated to helper) ──
+                case 'deploy':
+                case 'secret':
+                case 'runner':
+                case 'cache':
+                case 'artifact':
+                case 'environment':
+                case 'matrix':
+                case 'service':
+                case 'concurrency':
+                    this.handleDeploymentTag(tagName, tag, config, warnings);
+                    break;
                 case 'param':
                     this.parseParamTag(tag, config, func, warnings);
                     break;
@@ -493,7 +509,7 @@ export class JSDocParser {
         if (!result) {
             return;
         }
-        const { name, defaultValue, isOptional, scope, order, mergeStrategy, description } = result;
+        const { name, defaultValue, isOptional, scope, order, mergeStrategy, hidden, description } = result;
         // Infer type from signature or scope callback return type
         let type;
         let tsType;
@@ -569,6 +585,7 @@ export class JSDocParser {
             ...(expression && { expression }),
             ...(scope && { scope }),
             ...(mergeStrategy && { mergeStrategy: mergeStrategy }),
+            ...(hidden && { hidden }),
             ...(order !== undefined && { metadata: { order } }),
             ...(tsType && { tsType }),
         };
@@ -583,7 +600,7 @@ export class JSDocParser {
         if (!result) {
             return;
         }
-        const { name, scope, order, description } = result;
+        const { name, scope, order, hidden, description } = result;
         // Infer type from return type or scope callback parameter
         let type;
         let tsType;
@@ -652,6 +669,7 @@ export class JSDocParser {
             type,
             label: description?.trim(),
             ...(scope && { scope }),
+            ...(hidden && { hidden }),
             ...(order !== undefined && { metadata: { order } }),
             ...(tsType && { tsType }),
         };
@@ -813,7 +831,7 @@ export class JSDocParser {
         if (!result) {
             return;
         }
-        const { instanceId, nodeType, parentScope, label, expressions, portOrder, portLabel, minimized, pullExecution, size, position, color, icon, tags, } = result;
+        const { instanceId, nodeType, parentScope, label, expressions, portOrder, portLabel, minimized, pullExecution, size, position, color, icon, tags, job, environment, } = result;
         // Capture source location from tag
         const line = tag.getStartLineNumber();
         // Build portConfigs from portOrder, portLabel, and expressions
@@ -861,6 +879,8 @@ export class JSDocParser {
             ...(tags && tags.length > 0 && { tags }),
             ...(size && { width: size.width, height: size.height }),
             ...(position && { x: position.x, y: position.y }),
+            ...(job && { job }),
+            ...(environment && { environment }),
             sourceLocation: { line, column: 0 },
         });
     }
@@ -1017,9 +1037,26 @@ export class JSDocParser {
      * Parse @trigger tag using Chevrotain parser.
      */
     parseTriggerTag(tag, config, warnings) {
-        const comment = tag.getCommentText() || '';
+        const comment = (tag.getCommentText() || '').trim();
+        // Check for CI/CD trigger types first (push, pull_request, dispatch, tag, schedule)
+        const cicdTriggerMatch = comment.match(/^(push|pull_request|dispatch|tag|schedule)\b(.*)?$/);
+        if (cicdTriggerMatch) {
+            this.parseCICDTrigger(cicdTriggerMatch[1], cicdTriggerMatch[2]?.trim() || '', config, warnings);
+            return;
+        }
+        // Also detect cron="..." as a schedule trigger for CI/CD
+        const cronOnlyMatch = comment.match(/^cron\s*=\s*"([^"]+)"/);
+        if (cronOnlyMatch && !comment.includes('event=')) {
+            // Could be CI/CD schedule or existing FW cron — store both
+            config.cicdTriggers = config.cicdTriggers || [];
+            config.cicdTriggers.push({ type: 'schedule', cron: cronOnlyMatch[1] });
+        }
+        // Existing FW trigger parsing (event= and/or cron=)
         const result = parseTriggerLine(`@trigger ${comment}`, warnings);
         if (!result) {
+            // If it was a CI/CD trigger we already handled, don't warn
+            if (cicdTriggerMatch)
+                return;
             warnings.push(`Invalid @trigger format: @trigger ${comment}`);
             return;
         }
@@ -1030,6 +1067,43 @@ export class JSDocParser {
         if (result.cron)
             config.trigger.cron = result.cron;
     }
+    /**
+     * Parse a CI/CD-specific trigger type (push, pull_request, dispatch, tag, schedule).
+     */
+    parseCICDTrigger(type, rest, config, _warnings) {
+        config.cicdTriggers = config.cicdTriggers || [];
+        const triggerType = type;
+        const trigger = { type: triggerType };
+        // Parse key="value" pairs from rest
+        const branchesMatch = rest.match(/branches\s*=\s*"([^"]+)"/);
+        if (branchesMatch)
+            trigger.branches = branchesMatch[1].split(',').map(b => b.trim());
+        const pathsMatch = rest.match(/(?<![a-z])paths\s*=\s*"([^"]+)"/);
+        if (pathsMatch)
+            trigger.paths = pathsMatch[1].split(',').map(p => p.trim());
+        const pathsIgnoreMatch = rest.match(/paths-ignore\s*=\s*"([^"]+)"/);
+        if (pathsIgnoreMatch)
+            trigger.pathsIgnore = pathsIgnoreMatch[1].split(',').map(p => p.trim());
+        const typesMatch = rest.match(/types\s*=\s*"([^"]+)"/);
+        if (typesMatch)
+            trigger.types = typesMatch[1].split(',').map(t => t.trim());
+        const patternMatch = rest.match(/pattern\s*=\s*"([^"]+)"/);
+        if (patternMatch)
+            trigger.pattern = patternMatch[1];
+        const cronMatch = rest.match(/cron\s*=\s*"([^"]+)"/);
+        if (cronMatch)
+            trigger.cron = cronMatch[1];
+        const inputsMatch = rest.match(/inputs\s*=\s*"([^"]+)"/);
+        if (inputsMatch) {
+            trigger.inputs = {};
+            for (const input of inputsMatch[1].split(',')) {
+                const name = input.trim();
+                if (name)
+                    trigger.inputs[name] = {};
+            }
+        }
+        config.cicdTriggers.push(trigger);
+    }
     /**
      * Parse @cancelOn tag using Chevrotain parser.
      */
@@ -1054,6 +1128,336 @@ export class JSDocParser {
         }
         config.throttle = result;
     }
+    // ── Deployment dispatch + @deploy parser ───────────────────────────
+    /**
+     * Dispatch a CI/CD or @deploy tag to the appropriate parser.
+     * Consolidates all deployment-related cases from the main switch.
+     */
+    handleDeploymentTag(tagName, tag, config, warnings) {
+        switch (tagName) {
+            case 'deploy':
+                config.deploy = config.deploy || {};
+                this.parseDeployTag(tag, config.deploy);
+                break;
+            case 'secret':
+                this.parseSecretTag(tag, config, warnings);
+                break;
+            case 'runner': {
+                const comment = (tag.getCommentText() || '').trim().replace(/^["']|["']$/g, '');
+                if (comment)
+                    config.runner = comment;
+                break;
+            }
+            case 'cache':
+                this.parseCacheTag(tag, config, warnings);
+                break;
+            case 'artifact':
+                this.parseArtifactTag(tag, config, warnings);
+                break;
+            case 'environment':
+                this.parseEnvironmentTag(tag, config, warnings);
+                break;
+            case 'matrix':
+                this.parseMatrixTag(tag, config, warnings);
+                break;
+            case 'service':
+                this.parseServiceTag(tag, config, warnings);
+                break;
+            case 'concurrency':
+                this.parseConcurrencyTag(tag, config, warnings);
+                break;
+        }
+    }
+    /**
+     * Parse @deploy tag.
+     * Format: @deploy <target> key=value key2="value with spaces" key3=123 key4=true
+     *
+     * Examples:
+     *   @deploy github-actions action="actions/checkout@v4"
+     *   @deploy inngest durableSteps=true framework="next" retries=3
+     *   @deploy lambda memory=256 timeout=30
+     *
+     * Values are auto-coerced: "true"/"false" → boolean, numeric strings → number.
+     */
+    parseDeployTag(tag, deployMap) {
+        const text = (tag.getCommentText() || '').trim();
+        if (!text)
+            return;
+        // Split target name from remaining key=value pairs
+        const spaceIdx = text.indexOf(' ');
+        const targetName = spaceIdx === -1 ? text : text.substring(0, spaceIdx);
+        const rest = spaceIdx === -1 ? '' : text.substring(spaceIdx + 1);
+        if (!targetName)
+            return;
+        if (!deployMap[targetName])
+            deployMap[targetName] = {};
+        if (!rest)
+            return;
+        // Parse key=value and key="value with spaces" pairs
+        const kvRegex = /(\w[\w-]*)\s*=\s*(?:"([^"]*)"|([\S]+))/g;
+        let match;
+        while ((match = kvRegex.exec(rest)) !== null) {
+            const key = match[1];
+            const quotedVal = match[2]; // captured from "..."
+            const bareVal = match[3]; // captured from unquoted
+            if (quotedVal !== undefined) {
+                // Quoted values: check if comma-separated list → string[]
+                if (quotedVal.includes(',')) {
+                    deployMap[targetName][key] = quotedVal.split(',').map(v => v.trim());
+                }
+                else {
+                    deployMap[targetName][key] = quotedVal;
+                }
+            }
+            else if (bareVal !== undefined) {
+                // Bare values: auto-coerce boolean and number
+                if (bareVal === 'true') {
+                    deployMap[targetName][key] = true;
+                }
+                else if (bareVal === 'false') {
+                    deployMap[targetName][key] = false;
+                }
+                else {
+                    const num = Number(bareVal);
+                    deployMap[targetName][key] = isNaN(num) ? bareVal : num;
+                }
+            }
+        }
+    }
+    // ── CI/CD annotation parsers ───────────────────────────────────────
+    /**
+     * Parse @secret tag.
+     * Format: @secret NAME - description
+     * Optional: @secret NAME scope="deploy" platform="github" - description
+     */
+    parseSecretTag(_tag, config, warnings) {
+        const comment = (_tag.getCommentText() || '').trim();
+        if (!comment) {
+            warnings.push('Empty @secret tag. Expected: @secret SECRET_NAME - description');
+            return;
+        }
+        // Parse: NAME [key=value ...] [- description]
+        const match = comment.match(/^(\S+)(.*?)(?:\s+-\s+(.*))?$/);
+        if (!match) {
+            warnings.push(`Invalid @secret format: @secret ${comment}`);
+            return;
+        }
+        const name = match[1];
+        const attrs = match[2] || '';
+        const description = match[3]?.trim();
+        const secret = { name };
+        if (description)
+            secret.description = description;
+        // Parse optional key=value attributes
+        const scopeMatch = attrs.match(/scope\s*=\s*"([^"]+)"/);
+        if (scopeMatch)
+            secret.scope = scopeMatch[1];
+        const platformMatch = attrs.match(/platform\s*=\s*"([^"]+)"/);
+        if (platformMatch) {
+            const validPlatforms = ['github', 'gitlab', 'all'];
+            const p = platformMatch[1];
+            if (validPlatforms.includes(p)) {
+                secret.platform = p;
+            }
+            else {
+                warnings.push(`Invalid @secret platform "${platformMatch[1]}". Must be: github, gitlab, or all`);
+            }
+        }
+        config.secrets = config.secrets || [];
+        config.secrets.push(secret);
+    }
+    /**
+     * Parse @cache tag.
+     * Format: @cache strategy [key="file"] [path="dir"]
+     */
+    parseCacheTag(_tag, config, warnings) {
+        const comment = (_tag.getCommentText() || '').trim();
+        if (!comment) {
+            warnings.push('Empty @cache tag. Expected: @cache npm key="package-lock.json"');
+            return;
+        }
+        const parts = comment.match(/^(\S+)(.*)?$/);
+        if (!parts) {
+            warnings.push(`Invalid @cache format: @cache ${comment}`);
+            return;
+        }
+        const cache = { strategy: parts[1] };
+        const rest = parts[2] || '';
+        const keyMatch = rest.match(/key\s*=\s*"([^"]+)"/);
+        if (keyMatch)
+            cache.key = keyMatch[1];
+        const pathMatch = rest.match(/path\s*=\s*"([^"]+)"/);
+        if (pathMatch)
+            cache.path = pathMatch[1];
+        config.caches = config.caches || [];
+        config.caches.push(cache);
+    }
+    /**
+     * Parse @artifact tag.
+     * Format: @artifact name path="dist/" [retention=5]
+     */
+    parseArtifactTag(_tag, config, warnings) {
+        const comment = (_tag.getCommentText() || '').trim();
+        if (!comment) {
+            warnings.push('Empty @artifact tag. Expected: @artifact name path="dist/"');
+            return;
+        }
+        const nameMatch = comment.match(/^(\S+)/);
+        if (!nameMatch) {
+            warnings.push(`Invalid @artifact format: @artifact ${comment}`);
+            return;
+        }
+        const pathMatch = comment.match(/path\s*=\s*"([^"]+)"/);
+        if (!pathMatch) {
+            warnings.push(`@artifact requires path="...": @artifact ${comment}`);
+            return;
+        }
+        const artifact = {
+            name: nameMatch[1],
+            path: pathMatch[1],
+        };
+        const retentionMatch = comment.match(/retention\s*=\s*(\d+)/);
+        if (retentionMatch)
+            artifact.retention = parseInt(retentionMatch[1], 10);
+        config.artifacts = config.artifacts || [];
+        config.artifacts.push(artifact);
+    }
+    /**
+     * Parse @environment tag.
+     * Format: @environment name [url="..."] [reviewers=N]
+     */
+    parseEnvironmentTag(_tag, config, warnings) {
+        const comment = (_tag.getCommentText() || '').trim();
+        if (!comment) {
+            warnings.push('Empty @environment tag. Expected: @environment production url="https://app.com"');
+            return;
+        }
+        const nameMatch = comment.match(/^(\S+)/);
+        if (!nameMatch) {
+            warnings.push(`Invalid @environment format: @environment ${comment}`);
+            return;
+        }
+        const env = { name: nameMatch[1] };
+        const urlMatch = comment.match(/url\s*=\s*"([^"]+)"/);
+        if (urlMatch)
+            env.url = urlMatch[1];
+        const reviewersMatch = comment.match(/reviewers\s*=\s*(\d+)/);
+        if (reviewersMatch)
+            env.reviewers = parseInt(reviewersMatch[1], 10);
+        config.environments = config.environments || [];
+        config.environments.push(env);
+    }
+    /**
+     * Parse @matrix tag.
+     * Format: @matrix dim1="val1,val2" dim2="val3,val4"
+     * Or: @matrix include dim1="val1" dim2="val2"
+     * Or: @matrix exclude dim1="val1" dim2="val2"
+     */
+    parseMatrixTag(_tag, config, warnings) {
+        const comment = (_tag.getCommentText() || '').trim();
+        if (!comment) {
+            warnings.push('Empty @matrix tag. Expected: @matrix node="18,20,22" os="ubuntu-latest"');
+            return;
+        }
+        config.matrix = config.matrix || { dimensions: {} };
+        // Check for include/exclude prefix
+        const isInclude = comment.startsWith('include ');
+        const isExclude = comment.startsWith('exclude ');
+        if (isInclude || isExclude) {
+            const rest = comment.slice(isInclude ? 8 : 8);
+            const entry = {};
+            const kvRegex = /(\w[\w-]*)\s*=\s*"([^"]+)"/g;
+            let m;
+            while ((m = kvRegex.exec(rest)) !== null) {
+                entry[m[1]] = m[2];
+            }
+            if (Object.keys(entry).length > 0) {
+                if (isInclude) {
+                    config.matrix.include = config.matrix.include || [];
+                    config.matrix.include.push(entry);
+                }
+                else {
+                    config.matrix.exclude = config.matrix.exclude || [];
+                    config.matrix.exclude.push(entry);
+                }
+            }
+            return;
+        }
+        // Regular dimensions: key="val1,val2"
+        const kvRegex = /(\w[\w-]*)\s*=\s*"([^"]+)"/g;
+        let m;
+        while ((m = kvRegex.exec(comment)) !== null) {
+            config.matrix.dimensions[m[1]] = m[2].split(',').map(v => v.trim());
+        }
+    }
+    /**
+     * Parse @service tag.
+     * Format: @service name image="..." [env="K=V,K2=V2"] [ports="5432:5432"]
+     */
+    parseServiceTag(_tag, config, warnings) {
+        const comment = (_tag.getCommentText() || '').trim();
+        if (!comment) {
+            warnings.push('Empty @service tag. Expected: @service postgres image="postgres:16"');
+            return;
+        }
+        const nameMatch = comment.match(/^(\S+)/);
+        if (!nameMatch) {
+            warnings.push(`Invalid @service format: @service ${comment}`);
+            return;
+        }
+        const imageMatch = comment.match(/image\s*=\s*"([^"]+)"/);
+        if (!imageMatch) {
+            warnings.push(`@service requires image="...": @service ${comment}`);
+            return;
+        }
+        const svc = {
+            name: nameMatch[1],
+            image: imageMatch[1],
+        };
+        const envMatch = comment.match(/env\s*=\s*"([^"]+)"/);
+        if (envMatch) {
+            svc.env = {};
+            for (const pair of envMatch[1].split(',')) {
+                const [k, ...vParts] = pair.split('=');
+                if (k && vParts.length > 0)
+                    svc.env[k.trim()] = vParts.join('=').trim();
+            }
+        }
+        const portsMatch = comment.match(/ports\s*=\s*"([^"]+)"/);
+        if (portsMatch) {
+            svc.ports = portsMatch[1].split(',').map(p => p.trim());
+        }
+        config.services = config.services || [];
+        config.services.push(svc);
+    }
+    /**
+     * Parse @concurrency tag.
+     * Format: @concurrency group="name" [cancel-in-progress=true]
+     */
+    parseConcurrencyTag(_tag, config, warnings) {
+        const comment = (_tag.getCommentText() || '').trim();
+        if (!comment) {
+            warnings.push('Empty @concurrency tag. Expected: @concurrency group="deploy"');
+            return;
+        }
+        const groupMatch = comment.match(/group\s*=\s*"([^"]+)"/);
+        if (!groupMatch) {
+            // Try bare word: @concurrency deploy
+            const bareMatch = comment.match(/^(\S+)/);
+            if (bareMatch) {
+                config.concurrency = { group: bareMatch[1], cancelInProgress: false };
+            }
+            else {
+                warnings.push(`Invalid @concurrency format: @concurrency ${comment}`);
+            }
+            return;
+        }
+        const cancelMatch = comment.match(/cancel-in-progress\s*=\s*(true|false)/);
+        config.concurrency = {
+            group: groupMatch[1],
+            cancelInProgress: cancelMatch ? cancelMatch[1] === 'true' : false,
+        };
+    }
     /**
      * Parse default value from string
      */

package/dist/marketplace/index.d.ts

@@ -4,7 +4,7 @@
  * Flow Weaver Marketplace — discover, install, and publish reusable
  * node types, workflows, and patterns via npm.
  */
-export type { TMarketplaceManifest, TManifestNodeType, TManifestWorkflow, TManifestPattern, TManifestPort, TValidationIssue, TValidationSeverity, TPackageValidationResult, TMarketplacePackageInfo, TInstalledPackage, TMarketInitConfig, } from './types.js';
+export type { TMarketplaceManifest, TManifestNodeType, TManifestWorkflow, TManifestPattern, TManifestExportTarget, TManifestPort, TValidationIssue, TValidationSeverity, TPackageValidationResult, TMarketplacePackageInfo, TInstalledPackage, TMarketInitConfig, } from './types.js';
 export { generateManifest, writeManifest, readManifest, type GenerateManifestOptions, type GenerateManifestResult, } from './manifest.js';
 export { validatePackage } from './validator.js';
 export { searchPackages, listInstalledPackages, getInstalledPackageManifest, type SearchOptions, } from './registry.js';