@synergenius/flow-weaver 0.13.3 → 0.14.0

package/dist/api/validate.js

@@ -6,6 +6,8 @@
  */
 import { validator } from "../validator.js";
 import { getAgentValidationRules } from "../validation/agent-rules.js";
+import { getCICDValidationRules } from "../validation/cicd-rules.js";
+import { isCICDWorkflow } from "../validation/cicd-detection.js";
 /**
  * Validates a workflow AST
  *
@@ -19,8 +21,12 @@ import { getAgentValidationRules } from "../validation/agent-rules.js";
 export function validateWorkflow(ast, options) {
     // Use the consolidated validator
     const result = validator.validate(ast, { mode: options?.mode });
-    // Apply agent-specific rules + any custom rules
-    const allRules = [...getAgentValidationRules(), ...(options?.customRules || [])];
+    // Apply agent-specific rules, CI/CD rules (only if workflow is CI/CD), and custom rules
+    const allRules = [
+        ...getAgentValidationRules(),
+        ...(isCICDWorkflow(ast) ? getCICDValidationRules() : []),
+        ...(options?.customRules || []),
+    ];
     for (const rule of allRules) {
         const ruleResults = rule.validate(ast);
         for (const err of ruleResults) {

package/dist/ast/types.d.ts

@@ -277,6 +277,8 @@ export type TNodeTypeAST = {
     declarationKind?: 'const' | 'let' | 'var';
     /** npm package specifier this node type was resolved from (e.g., 'date-fns') */
     importSource?: string;
+    /** Per-target deploy config from @deploy annotations (e.g., deploy['github-actions'].action) */
+    deploy?: Record<string, Record<string, unknown>>;
 };
 /**
  * Port configuration for instance-level overrides
@@ -395,6 +397,10 @@ export type TNodeInstanceAST = {
     sourceLocation?: TSourceLocation;
     /** Reserved for plugin extensibility */
     metadata?: TNodeMetadata;
+    /** CI/CD job group this node belongs to (from [job: "name"] attribute) */
+    job?: string;
+    /** CI/CD environment for this node's job (from [environment: "name"] attribute) */
+    environment?: string;
 };
 /**
  * Type compatibility result for a connection.
@@ -440,6 +446,120 @@ export type TWorkflowOptions = {
         limit: number;
         period?: string;
     };
+    /** CI/CD pipeline configuration from @secret, @cache, @artifact, etc. */
+    cicd?: TCICDOptions;
+    /** Target-specific config (e.g., deploy['github-actions'].runner) */
+    deploy?: Record<string, Record<string, unknown>>;
+};
+/**
+ * CI/CD domain options — shared across all CI/CD export targets.
+ * Populated from @secret, @runner, @cache, @artifact, @environment,
+ * @matrix, @service, @concurrency annotations.
+ */
+export type TCICDOptions = {
+    /** Secret declarations for CI/CD pipelines */
+    secrets?: TCICDSecret[];
+    /** Default runner environment for CI/CD jobs */
+    runner?: string;
+    /** Cache configurations for CI/CD */
+    caches?: TCICDCache[];
+    /** Artifact declarations for CI/CD */
+    artifacts?: TCICDArtifact[];
+    /** Deployment environment configurations */
+    environments?: TCICDEnvironment[];
+    /** Matrix strategy for multi-version/OS testing */
+    matrix?: TCICDMatrix;
+    /** Sidecar service containers */
+    services?: TCICDService[];
+    /** Concurrency control */
+    concurrency?: {
+        group: string;
+        cancelInProgress?: boolean;
+    };
+    /** Extended CI/CD triggers (push, PR, dispatch, tag) */
+    triggers?: TCICDTrigger[];
+};
+/** Secret declaration from @secret annotation */
+export type TCICDSecret = {
+    /** Secret name (e.g., NPM_TOKEN) */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Platform restriction (default: all) */
+    platform?: 'github' | 'gitlab' | 'all';
+    /** Which job scope uses this secret */
+    scope?: string;
+};
+/** Cache configuration from @cache annotation */
+export type TCICDCache = {
+    /** Cache strategy name (e.g., npm, pip, custom) */
+    strategy: string;
+    /** Cache path override */
+    path?: string;
+    /** Cache key file (e.g., package-lock.json) */
+    key?: string;
+};
+/** Artifact declaration from @artifact annotation */
+export type TCICDArtifact = {
+    /** Artifact name */
+    name: string;
+    /** Path(s) to include */
+    path: string;
+    /** Retention in days */
+    retention?: number;
+};
+/** Deployment environment from @environment annotation */
+export type TCICDEnvironment = {
+    /** Environment name (e.g., production, staging) */
+    name: string;
+    /** Environment URL */
+    url?: string;
+    /** Number of required reviewers */
+    reviewers?: number;
+};
+/** Matrix strategy from @matrix annotation */
+export type TCICDMatrix = {
+    /** Dimension name → values (e.g., { "node": ["18","20","22"] }) */
+    dimensions: Record<string, string[]>;
+    /** Explicit include entries */
+    include?: Record<string, string>[];
+    /** Explicit exclude entries */
+    exclude?: Record<string, string>[];
+};
+/** Service container from @service annotation */
+export type TCICDService = {
+    /** Service name */
+    name: string;
+    /** Docker image */
+    image: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Port mappings (host:container) */
+    ports?: string[];
+};
+/** CI/CD trigger from extended @trigger annotation */
+export type TCICDTrigger = {
+    /** Trigger type */
+    type: 'push' | 'pull_request' | 'schedule' | 'dispatch' | 'tag';
+    /** Branch filters */
+    branches?: string[];
+    /** Path filters */
+    paths?: string[];
+    /** Path ignore filters */
+    pathsIgnore?: string[];
+    /** Tag pattern (for tag triggers) */
+    pattern?: string;
+    /** PR event types (e.g., opened, synchronize) */
+    types?: string[];
+    /** Cron expression (for schedule triggers) */
+    cron?: string;
+    /** Dispatch inputs */
+    inputs?: Record<string, {
+        description?: string;
+        required?: boolean;
+        default?: string;
+        type?: string;
+    }>;
 };
 /**
  * Connection AST - A link between two ports.

package/dist/chevrotain-parser/node-parser.d.ts

@@ -27,6 +27,10 @@ export interface NodeParseResult {
         label: string;
         tooltip?: string;
     }>;
+    /** CI/CD job group */
+    job?: string;
+    /** CI/CD deployment environment */
+    environment?: string;
 }
 /**
  * Parse a @node line and return structured result.

package/dist/chevrotain-parser/node-parser.js

@@ -4,7 +4,7 @@
  * Parser for @node declarations using Chevrotain.
  */
 import { CstParser } from 'chevrotain';
-import { JSDocLexer, NodeTag, Identifier, Dot, Integer, LabelPrefix, ExprPrefix, PortOrderPrefix, PortLabelPrefix, MinimizedKeyword, PullExecutionPrefix, SizePrefix, PositionPrefix, ColorPrefix, IconPrefix, TagsPrefix, StringLiteral, LBracket, RBracket, Comma, Equals, EventEq, CronEq, MatchEq, TimeoutEq, LimitEq, PeriodEq, allTokens, } from './tokens.js';
+import { JSDocLexer, NodeTag, Identifier, Dot, Integer, LabelPrefix, ExprPrefix, PortOrderPrefix, PortLabelPrefix, MinimizedKeyword, PullExecutionPrefix, SizePrefix, PositionPrefix, ColorPrefix, IconPrefix, JobPrefix, EnvironmentAttrPrefix, TagsPrefix, StringLiteral, LBracket, RBracket, Comma, Equals, EventEq, CronEq, MatchEq, TimeoutEq, LimitEq, PeriodEq, allTokens, } from './tokens.js';
 // =============================================================================
 // Parser Definition
 // =============================================================================
@@ -51,6 +51,8 @@ class NodeParser extends CstParser {
                     { ALT: () => this.SUBRULE(this.positionAttr) },
                     { ALT: () => this.SUBRULE(this.colorAttr) },
                     { ALT: () => this.SUBRULE(this.iconAttr) },
+                    { ALT: () => this.SUBRULE(this.jobAttr) },
+                    { ALT: () => this.SUBRULE(this.environmentAttr) },
                     { ALT: () => this.SUBRULE(this.tagsAttr) },
                 ]);
             },
@@ -157,6 +159,16 @@ class NodeParser extends CstParser {
         this.CONSUME(IconPrefix);
         this.CONSUME(StringLiteral, { LABEL: 'iconValue' });
     });
+    // job: "value" — CI/CD job group
+    jobAttr = this.RULE('jobAttr', () => {
+        this.CONSUME(JobPrefix);
+        this.CONSUME(StringLiteral, { LABEL: 'jobValue' });
+    });
+    // environment: "value" — CI/CD deployment environment
+    environmentAttr = this.RULE('environmentAttr', () => {
+        this.CONSUME(EnvironmentAttrPrefix);
+        this.CONSUME(StringLiteral, { LABEL: 'environmentValue' });
+    });
     // tags: "label" "tooltip", "label2"
     tagsAttr = this.RULE('tagsAttr', () => {
         this.CONSUME(TagsPrefix);
@@ -203,6 +215,8 @@ class NodeVisitor extends BaseVisitor {
         let color;
         let icon;
         let tags;
+        let job;
+        let environment;
         if (ctx.parentScopeRef) {
             parentScope = this.visit(ctx.parentScopeRef);
         }
@@ -231,6 +245,10 @@ class NodeVisitor extends BaseVisitor {
                     icon = attrs.icon;
                 if (attrs.tags)
                     tags = [...(tags || []), ...attrs.tags];
+                if (attrs.job)
+                    job = attrs.job;
+                if (attrs.environment)
+                    environment = attrs.environment;
             }
         }
         return {
@@ -248,6 +266,8 @@ class NodeVisitor extends BaseVisitor {
             ...(color && { color }),
             ...(icon && { icon }),
             ...(tags && { tags }),
+            ...(job && { job }),
+            ...(environment && { environment }),
         };
     }
     parentScopeRef(ctx) {
@@ -267,6 +287,8 @@ class NodeVisitor extends BaseVisitor {
         let color;
         let icon;
         let tags;
+        let job;
+        let environment;
         if (ctx.labelAttr) {
             for (const attr of ctx.labelAttr) {
                 label = this.visit(attr);
@@ -324,6 +346,16 @@ class NodeVisitor extends BaseVisitor {
                 tags = [...(tags || []), ...parsed];
             }
         }
+        if (ctx.jobAttr) {
+            for (const attr of ctx.jobAttr) {
+                job = this.visit(attr);
+            }
+        }
+        if (ctx.environmentAttr) {
+            for (const attr of ctx.environmentAttr) {
+                environment = this.visit(attr);
+            }
+        }
         return {
             label,
             expressions,
@@ -336,6 +368,8 @@ class NodeVisitor extends BaseVisitor {
             color,
             icon,
             tags,
+            job,
+            environment,
         };
     }
     labelAttr(ctx) {
@@ -426,6 +460,12 @@ class NodeVisitor extends BaseVisitor {
     iconAttr(ctx) {
         return this.unescapeString(ctx.iconValue[0].image);
     }
+    jobAttr(ctx) {
+        return this.unescapeString(ctx.jobValue[0].image);
+    }
+    environmentAttr(ctx) {
+        return this.unescapeString(ctx.environmentValue[0].image);
+    }
     tagsAttr(ctx) {
         const result = [];
         if (ctx.tagEntry) {

package/dist/chevrotain-parser/port-parser.d.ts

@@ -13,6 +13,7 @@ export interface PortParseResult {
     placement?: 'TOP' | 'BOTTOM';
     dataType?: string;
     mergeStrategy?: string;
+    hidden?: boolean;
     description?: string;
 }
 /**

package/dist/chevrotain-parser/port-parser.js

@@ -4,7 +4,7 @@
  * Parser for @input/@output/@step port declarations using Chevrotain.
  */
 import { CstParser } from 'chevrotain';
-import { JSDocLexer, InputTag, OutputTag, StepTag, Identifier, ScopePrefix, OrderPrefix, PlacementPrefix, TypePrefix, MergeStrategyPrefix, TopKeyword, BottomKeyword, TrueKeyword, FalseKeyword, OverKeyword, AsKeyword, MinimizedKeyword, Integer, StringLiteral, DescriptionText, LBracket, RBracket, LParen, RParen, Comma, Colon, Dot, Dash, Equals, GreaterThan, LessThan, Pipe, Ampersand, LBrace, RBrace, Asterisk, allTokens, } from './tokens.js';
+import { JSDocLexer, InputTag, OutputTag, StepTag, Identifier, ScopePrefix, OrderPrefix, PlacementPrefix, TypePrefix, MergeStrategyPrefix, TopKeyword, BottomKeyword, TrueKeyword, FalseKeyword, OverKeyword, AsKeyword, MinimizedKeyword, HiddenKeyword, Integer, StringLiteral, DescriptionText, LBracket, RBracket, LParen, RParen, Comma, Colon, Dot, Dash, Equals, GreaterThan, LessThan, Pipe, Ampersand, LBrace, RBrace, Asterisk, allTokens, } from './tokens.js';
 // =============================================================================
 // Parser Definition
 // =============================================================================
@@ -97,6 +97,7 @@ class PortParser extends CstParser {
                     { ALT: () => this.SUBRULE(this.placementAttr) },
                     { ALT: () => this.SUBRULE(this.typeAttr) },
                     { ALT: () => this.SUBRULE(this.mergeStrategyAttr) },
+                    { ALT: () => this.SUBRULE(this.hiddenAttr) },
                 ]);
             },
         });
@@ -126,6 +127,10 @@ class PortParser extends CstParser {
         this.CONSUME(MergeStrategyPrefix);
         this.CONSUME(Identifier, { LABEL: 'mergeStrategyValue' });
     });
+    // hidden (standalone keyword, no value needed)
+    hiddenAttr = this.RULE('hiddenAttr', () => {
+        this.CONSUME(HiddenKeyword);
+    });
     // - description text
     // Note: We just consume the dash here. The actual description text is extracted
     // from the raw input in parsePortLine() to handle special characters like &, :, etc.
@@ -226,6 +231,7 @@ class PortVisitor extends BaseVisitor {
         if (ctx.scopeClause) {
             scope = this.visit(ctx.scopeClause);
         }
+        let hidden;
         if (ctx.metadataBracket) {
             // Handle multiple metadata brackets (e.g., [order:1] [placement:TOP])
             for (const bracket of ctx.metadataBracket) {
@@ -238,6 +244,8 @@ class PortVisitor extends BaseVisitor {
                     dataType = metadata.dataType;
                 if (metadata.mergeStrategy !== undefined)
                     mergeStrategy = metadata.mergeStrategy;
+                if (metadata.hidden)
+                    hidden = true;
             }
         }
         if (ctx.descriptionClause) {
@@ -253,6 +261,7 @@ class PortVisitor extends BaseVisitor {
             ...(placement && { placement }),
             ...(dataType && { dataType }),
             ...(mergeStrategy && { mergeStrategy }),
+            ...(hidden && { hidden }),
             ...(description && { description }),
         };
     }
@@ -266,6 +275,7 @@ class PortVisitor extends BaseVisitor {
         if (ctx.scopeClause) {
             scope = this.visit(ctx.scopeClause);
         }
+        let hidden;
         if (ctx.metadataBracket) {
             // Handle multiple metadata brackets (e.g., [order:1] [placement:TOP])
             for (const bracket of ctx.metadataBracket) {
@@ -276,6 +286,8 @@ class PortVisitor extends BaseVisitor {
                     placement = metadata.placement;
                 if (metadata.dataType !== undefined)
                     dataType = metadata.dataType;
+                if (metadata.hidden)
+                    hidden = true;
             }
         }
         if (ctx.descriptionClause) {
@@ -288,6 +300,7 @@ class PortVisitor extends BaseVisitor {
             ...(order !== undefined && { order }),
             ...(placement && { placement }),
             ...(dataType && { dataType }),
+            ...(hidden && { hidden }),
             ...(description && { description }),
         };
     }
@@ -311,6 +324,7 @@ class PortVisitor extends BaseVisitor {
         let placement;
         let dataType;
         let mergeStrategy;
+        let hidden;
         if (ctx.orderAttr) {
             for (const attr of ctx.orderAttr) {
                 order = this.visit(attr);
@@ -331,7 +345,10 @@ class PortVisitor extends BaseVisitor {
                 mergeStrategy = this.visit(attr);
             }
         }
-        return { order, placement, dataType, mergeStrategy };
+        if (ctx.hiddenAttr) {
+            hidden = true;
+        }
+        return { order, placement, dataType, mergeStrategy, hidden };
     }
     orderAttr(ctx) {
         return parseInt(ctx.orderValue[0].image, 10);
@@ -342,6 +359,9 @@ class PortVisitor extends BaseVisitor {
     typeAttr(ctx) {
         return ctx.typeValue[0].image;
     }
+    hiddenAttr(_ctx) {
+        return true;
+    }
     mergeStrategyAttr(ctx) {
         return ctx.mergeStrategyValue[0].image;
     }

package/dist/chevrotain-parser/tokens.d.ts

@@ -43,10 +43,13 @@ export declare const ExprPrefix: import("chevrotain").TokenType;
 export declare const MergeStrategyPrefix: import("chevrotain").TokenType;
 export declare const PullExecutionPrefix: import("chevrotain").TokenType;
 export declare const MinimizedKeyword: import("chevrotain").TokenType;
+export declare const HiddenKeyword: import("chevrotain").TokenType;
 export declare const SizePrefix: import("chevrotain").TokenType;
 export declare const PositionPrefix: import("chevrotain").TokenType;
 export declare const ColorPrefix: import("chevrotain").TokenType;
 export declare const IconPrefix: import("chevrotain").TokenType;
+export declare const JobPrefix: import("chevrotain").TokenType;
+export declare const EnvironmentAttrPrefix: import("chevrotain").TokenType;
 export declare const TagsPrefix: import("chevrotain").TokenType;
 export declare const EventEq: import("chevrotain").TokenType;
 export declare const CronEq: import("chevrotain").TokenType;

package/dist/chevrotain-parser/tokens.js

@@ -168,6 +168,10 @@ export const MinimizedKeyword = createToken({
     name: 'MinimizedKeyword',
     pattern: /minimized\b/,
 });
+export const HiddenKeyword = createToken({
+    name: 'HiddenKeyword',
+    pattern: /hidden\b/,
+});
 export const SizePrefix = createToken({
     name: 'SizePrefix',
     pattern: /size:/,
@@ -184,6 +188,14 @@ export const IconPrefix = createToken({
     name: 'IconPrefix',
     pattern: /icon:/,
 });
+export const JobPrefix = createToken({
+    name: 'JobPrefix',
+    pattern: /job:/,
+});
+export const EnvironmentAttrPrefix = createToken({
+    name: 'EnvironmentAttrPrefix',
+    pattern: /environment:/,
+});
 export const TagsPrefix = createToken({
     name: 'TagsPrefix',
     pattern: /tags:/,
@@ -363,6 +375,8 @@ export const allTokens = [
     PositionPrefix,
     ColorPrefix,
     IconPrefix,
+    JobPrefix,
+    EnvironmentAttrPrefix,
     TagsPrefix,
     EventEq,
     CronEq,
@@ -374,6 +388,7 @@ export const allTokens = [
     OverKeyword,
     AsKeyword,
     MinimizedKeyword,
+    HiddenKeyword,
     TopKeyword,
     BottomKeyword,
     TrueKeyword,

package/dist/cli/commands/export.js

@@ -1,7 +1,7 @@
 /**
  * Export command - generate serverless function handlers for deployment
  */
-import { exportWorkflow, getSupportedTargets } from '../../export/index.js';
+import { exportWorkflow } from '../../export/index.js';
 import { logger } from '../utils/logger.js';
 /**
  * Export a workflow as a serverless function.
@@ -34,10 +34,9 @@ import { logger } from '../utils/logger.js';
  * ```
  */
 export async function exportCommand(input, options) {
-    const validTargets = getSupportedTargets();
-    // Validate target
-    if (!validTargets.includes(options.target)) {
-        throw new Error(`Invalid target "${options.target}". Valid targets: ${validTargets.join(', ')}`);
+    // Validate target is provided
+    if (!options.target) {
+        throw new Error('--target is required. Install a target pack (e.g. npm install flowweaver-pack-lambda)');
     }
     const isDryRun = options.dryRun ?? false;
     const isMulti = options.multi ?? false;
@@ -122,42 +121,30 @@ export async function exportCommand(input, options) {
             }
         }
     }
+    // Get deploy instructions from the target
     logger.newline();
     logger.section('Next Steps');
-    switch (result.target) {
-        case 'lambda':
-            logger.log('  1. cd ' + options.output);
-            logger.log('  2. npm install');
-            logger.log('  3. npm run build');
-            logger.log('  4. sam build && sam deploy --guided');
-            logger.newline();
-            logger.info('Requires: AWS SAM CLI (https://aws.amazon.com/serverless/sam/)');
-            break;
-        case 'vercel':
-            logger.log("  1. Move files to your Vercel project's api/ directory:");
-            logger.log(`     mv ${options.output}/*.ts your-project/api/`);
-            logger.log('  2. vercel deploy');
-            logger.newline();
-            logger.info('Requires: Vercel CLI (npm install -g vercel)');
-            logger.info(`Endpoint will be: https://your-project.vercel.app/api/${result.workflow}`);
-            break;
-        case 'cloudflare':
-            logger.log('  1. cd ' + options.output);
-            logger.log('  2. npm install');
-            logger.log('  3. npm run deploy');
-            logger.newline();
-            logger.info('Requires: Wrangler CLI (npm install -g wrangler)');
-            logger.info('First run: wrangler login');
-            break;
-        case 'inngest':
-            logger.log('  1. cd ' + options.output);
-            logger.log('  2. npm install');
-            logger.log('  3. npm run dev');
+    const { createTargetRegistry } = await import('../../deployment/index.js');
+    const registry = await createTargetRegistry(process.cwd());
+    const target = registry.get(result.target);
+    if (target) {
+        // Use the target's own deploy instructions
+        const instructions = target.getDeployInstructions({
+            files: [],
+            target: result.target,
+            workflowName: result.workflow,
+            entryPoint: '',
+        });
+        for (let i = 0; i < instructions.steps.length; i++) {
+            logger.log(`  ${i + 1}. ${instructions.steps[i]}`);
+        }
+        if (instructions.prerequisites.length > 0) {
             logger.newline();
-            logger.info('Inngest Dev Server will start at http://localhost:8288');
-            logger.info('Send test events from the Inngest Dev Server UI');
-            logger.info('Docs: https://www.inngest.com/docs');
-            break;
+            logger.info(`Requires: ${instructions.prerequisites.join(', ')}`);
+        }
+    }
+    else {
+        logger.log('  See target documentation for deployment instructions.');
     }
 }
 //# sourceMappingURL=export.js.map