@synergenius/flow-weaver 0.17.0 → 0.17.2

package/dist/api/index.d.ts

@@ -36,6 +36,7 @@ export { type InPlaceGenerateOptions, type InPlaceGenerateResult, generateInPlac
 export { type ParseResult, parseWorkflow } from './parse.js';
 export { transformWorkflow } from './transform.js';
 export { type ValidationResult, validateWorkflow } from './validate.js';
+export { validationRuleRegistry } from './validation-registry.js';
 export * from './manipulation.js';
 export { withValidation, withMinimalValidation, withoutValidation, type RemoveOptions, type NodeFilter, type OperationResult, validatePortReference, portReferencesEqual, formatPortReference, generateUniqueNodeId, assertNodeTypeExists, assertNodeExists, assertNodeNotExists, } from './helpers.js';
 export * from './query.js';
@@ -43,6 +44,8 @@ export * from './builder.js';
 export * from './workflow-file-operations.js';
 export * from './templates.js';
 export * from './patterns.js';
-export { generateInngestFunction } from '../generator/inngest.js';
 export { AnnotationParser } from '../parser.js';
+export { compileTargetRegistry, type CompileTarget } from '../generator/compile-target-registry.js';
+export { devModeRegistry, type DevModeProvider, type DevModeOptions } from '../generator/dev-mode-registry.js';
+export { tagHandlerRegistry, type TagHandlerRegistry, type TTagHandlerFn, type TTagHandlerContext } from '../parser/tag-registry.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/api/index.js

@@ -35,6 +35,7 @@ export { generateInPlace, hasInPlaceMarkers, stripGeneratedSections, MARKERS, }
 export { parseWorkflow } from './parse.js';
 export { transformWorkflow } from './transform.js';
 export { validateWorkflow } from './validate.js';
+export { validationRuleRegistry } from './validation-registry.js';
 export * from './manipulation.js';
 export { withValidation, withMinimalValidation, withoutValidation, validatePortReference, portReferencesEqual, formatPortReference, generateUniqueNodeId, assertNodeTypeExists, assertNodeExists, assertNodeNotExists, } from './helpers.js';
 export * from './query.js';
@@ -43,6 +44,8 @@ export * from './workflow-file-operations.js';
 export * from './templates.js';
 export * from './patterns.js';
 // Re-exports needed by export target packs
-export { generateInngestFunction } from '../generator/inngest.js';
 export { AnnotationParser } from '../parser.js';
+export { compileTargetRegistry } from '../generator/compile-target-registry.js';
+export { devModeRegistry } from '../generator/dev-mode-registry.js';
+export { tagHandlerRegistry } from '../parser/tag-registry.js';
 //# sourceMappingURL=index.js.map

package/dist/api/templates.js

@@ -6,7 +6,7 @@
  *
  * @module
  */
-import { workflowTemplates, nodeTemplates, getWorkflowTemplate as getWorkflowTemplateById, getNodeTemplate as getNodeTemplateById, } from "../cli/templates/index.js";
+import { nodeTemplates, getAllWorkflowTemplates, getWorkflowTemplate as getWorkflowTemplateById, getNodeTemplate as getNodeTemplateById, } from "../cli/templates/index.js";
 /**
  * List all available workflow templates
  *
@@ -19,7 +19,7 @@ import { workflowTemplates, nodeTemplates, getWorkflowTemplate as getWorkflowTem
  * ```
  */
 export function listWorkflowTemplates() {
-    return workflowTemplates;
+    return getAllWorkflowTemplates();
 }
 /**
  * List all available node templates

package/dist/api/validate.d.ts

@@ -14,8 +14,8 @@ export interface ValidationResult {
 /**
  * Validates a workflow AST
  *
- * Runs the built-in validator, then agent-specific rules, then any custom rules.
- * Agent rules are always applied automatically.
+ * Runs the built-in validator, then agent-specific rules, then registry rules
+ * (pack-contributed), then any custom rules.
  *
  * @param ast - The workflow AST to validate
  * @param options - Validation options: custom rules and/or draft mode

package/dist/api/validate.js

@@ -6,13 +6,12 @@
  */
 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";
+import { validationRuleRegistry } from "./validation-registry.js";
 /**
  * Validates a workflow AST
  *
- * Runs the built-in validator, then agent-specific rules, then any custom rules.
- * Agent rules are always applied automatically.
+ * Runs the built-in validator, then agent-specific rules, then registry rules
+ * (pack-contributed), then any custom rules.
  *
  * @param ast - The workflow AST to validate
  * @param options - Validation options: custom rules and/or draft mode
@@ -21,10 +20,11 @@ import { isCICDWorkflow } from "../validation/cicd-detection.js";
 export function validateWorkflow(ast, options) {
     // Use the consolidated validator
     const result = validator.validate(ast, { mode: options?.mode });
-    // Apply agent-specific rules, CI/CD rules (only if workflow is CI/CD), and custom rules
+    // Apply agent-specific rules, registry rules (pack-contributed,
+    // including CI/CD when applicable), and custom rules
     const allRules = [
         ...getAgentValidationRules(),
-        ...(isCICDWorkflow(ast) ? getCICDValidationRules() : []),
+        ...validationRuleRegistry.getApplicableRules(ast),
         ...(options?.customRules || []),
     ];
     for (const rule of allRules) {

package/dist/api/validation-registry.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Singleton validation rule registry for the public API.
+ *
+ * Core rule sets (agent, CI/CD) are registered statically.
+ * Pack-contributed rule sets are registered via marketplace discovery.
+ */
+import { ValidationRuleRegistry } from '../validation/rule-registry.js';
+/** Global validation rule registry. Packs register rule sets here at startup. */
+export declare const validationRuleRegistry: ValidationRuleRegistry;
+//# sourceMappingURL=validation-registry.d.ts.map

package/dist/api/validation-registry.js

@@ -0,0 +1,10 @@
+/**
+ * Singleton validation rule registry for the public API.
+ *
+ * Core rule sets (agent, CI/CD) are registered statically.
+ * Pack-contributed rule sets are registered via marketplace discovery.
+ */
+import { ValidationRuleRegistry } from '../validation/rule-registry.js';
+/** Global validation rule registry. Packs register rule sets here at startup. */
+export const validationRuleRegistry = new ValidationRuleRegistry();
+//# sourceMappingURL=validation-registry.js.map

package/dist/ast/types.d.ts

@@ -397,10 +397,18 @@ export type TNodeInstanceAST = {
     sourceLocation?: TSourceLocation;
     /** Reserved for plugin extensibility */
     metadata?: TNodeMetadata;
-    /** CI/CD job group this node belongs to (from [job: "name"] attribute) */
+    /**
+     * CI/CD job group this node belongs to (from [job: "name"] attribute).
+     * @deprecated Use `deploy?.['cicd']?.job` instead. Kept for backwards compatibility.
+     */
     job?: string;
-    /** CI/CD environment for this node's job (from [environment: "name"] attribute) */
+    /**
+     * CI/CD environment for this node's job (from [environment: "name"] attribute).
+     * @deprecated Use `deploy?.['cicd']?.environment` instead. Kept for backwards compatibility.
+     */
     environment?: string;
+    /** Per-target deploy config contributed by packs (e.g., deploy['cicd'].job) */
+    deploy?: Record<string, Record<string, unknown>>;
 };
 /**
  * Type compatibility result for a connection.
@@ -446,7 +454,10 @@ export type TWorkflowOptions = {
         limit: number;
         period?: string;
     };
-    /** CI/CD pipeline configuration from @secret, @cache, @artifact, etc. */
+    /**
+     * CI/CD pipeline configuration from @secret, @cache, @artifact, etc.
+     * @deprecated Use `deploy?.['cicd']` instead. Kept for backwards compatibility.
+     */
     cicd?: TCICDOptions;
     /** Target-specific config (e.g., deploy['github-actions'].runner) */
     deploy?: Record<string, Record<string, unknown>>;
@@ -454,7 +465,8 @@ export type TWorkflowOptions = {
 /**
  * CI/CD domain options — shared across all CI/CD export targets.
  * Populated from @secret, @runner, @cache, @artifact, @environment,
- * @matrix, @service, @concurrency annotations.
+ * @matrix, @service, @concurrency, @job, @stage, @variables,
+ * @before_script, @tags, @includes annotations.
  */
 export type TCICDOptions = {
     /** Secret declarations for CI/CD pipelines */
@@ -478,6 +490,18 @@ export type TCICDOptions = {
     };
     /** Extended CI/CD triggers (push, PR, dispatch, tag) */
     triggers?: TCICDTrigger[];
+    /** Per-job configuration from @job annotations */
+    jobs?: TCICDJobConfig[];
+    /** Workflow-level default variables from @variables */
+    variables?: Record<string, string>;
+    /** Workflow-level before_script commands from @before_script */
+    beforeScript?: string[];
+    /** Workflow-level runner tags from @tags */
+    tags?: string[];
+    /** GitLab template includes from @includes */
+    includes?: TCICDInclude[];
+    /** Pipeline stage declarations from @stage */
+    stages?: TCICDStage[];
 };
 /** Secret declaration from @secret annotation */
 export type TCICDSecret = {
@@ -561,6 +585,69 @@ export type TCICDTrigger = {
         type?: string;
     }>;
 };
+/** Per-job configuration from @job annotation */
+export type TCICDJobConfig = {
+    /** Job identifier (must match a [job: "name"] on @node declarations) */
+    id: string;
+    /** Maximum retry count on failure */
+    retry?: number;
+    /** Whether this job can fail without failing the pipeline */
+    allowFailure?: boolean;
+    /** Job-level timeout duration (e.g., "30m", "1h") */
+    timeout?: string;
+    /** Key-value environment variables */
+    variables?: Record<string, string>;
+    /** Runner selection tags */
+    tags?: string[];
+    /** Setup commands run before the main script */
+    beforeScript?: string[];
+    /** Conditional execution rules */
+    rules?: TCICDJobRule[];
+    /** Coverage regex pattern */
+    coverage?: string;
+    /** Test/coverage report declarations */
+    reports?: TCICDReport[];
+    /** Per-job runner override */
+    runner?: string;
+    /** GitLab template to extend */
+    extends?: string;
+};
+/** Conditional execution rule for a CI/CD job */
+export type TCICDJobRule = {
+    /** Condition expression (e.g., '$CI_COMMIT_BRANCH == "main"') */
+    if?: string;
+    /** When to run: always, never, manual, delayed */
+    when?: 'always' | 'never' | 'manual' | 'delayed';
+    /** Whether failure is allowed when this rule matches */
+    allowFailure?: boolean;
+    /** Variables to set when this rule matches */
+    variables?: Record<string, string>;
+    /** Changed file patterns that trigger this rule */
+    changes?: string[];
+};
+/** Report declaration for a CI/CD job */
+export type TCICDReport = {
+    /** Report type (junit, cobertura, codequality, sast, etc.) */
+    type: string;
+    /** Report file path */
+    path: string;
+};
+/** GitLab include directive from @includes annotation */
+export type TCICDInclude = {
+    /** Include type */
+    type: 'local' | 'project' | 'remote' | 'template';
+    /** File path or URL */
+    file: string;
+    /** Project path (for type=project) */
+    project?: string;
+    /** Git ref (for type=project) */
+    ref?: string;
+};
+/** Pipeline stage declaration from @stage annotation */
+export type TCICDStage = {
+    /** Stage name */
+    name: string;
+};
 /**
  * Connection AST - A link between two ports.
  *

package/dist/built-in-nodes/invoke-workflow.d.ts

@@ -1,6 +1,6 @@
 /**
  * @flowWeaver nodeType
- * @input functionId - Inngest function ID (e.g. "my-service/sub-workflow")
+ * @input functionId - Function ID of the workflow to invoke (e.g. "my-service/sub-workflow")
  * @input payload - Data to pass as event.data to the invoked function
  * @input [timeout] - Max wait time (e.g. "1h")
  * @output result - Return value from the invoked function

package/dist/built-in-nodes/invoke-workflow.js

@@ -1,7 +1,7 @@
 import { getMockConfig, lookupMock } from './mock-types.js';
 /**
  * @flowWeaver nodeType
- * @input functionId - Inngest function ID (e.g. "my-service/sub-workflow")
+ * @input functionId - Function ID of the workflow to invoke (e.g. "my-service/sub-workflow")
  * @input payload - Data to pass as event.data to the invoked function
  * @input [timeout] - Max wait time (e.g. "1h")
  * @output result - Return value from the invoked function

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

@@ -24,15 +24,28 @@ class ConnectParser extends CstParser {
             this.CONSUME(Identifier, { LABEL: 'coerceType' });
         });
     });
-    // node.port or node.port:scope
+    // node.port, node.port:scope, or pseudo-node (secret:NAME)
     portRef = this.RULE('portRef', () => {
         this.CONSUME(Identifier, { LABEL: 'nodeId' });
-        this.CONSUME(Dot);
-        this.CONSUME2(Identifier, { LABEL: 'portName' });
-        this.OPTION(() => {
-            this.CONSUME(Colon);
-            this.CONSUME3(Identifier, { LABEL: 'scopeName' });
-        });
+        this.OR([
+            {
+                ALT: () => {
+                    this.CONSUME(Dot);
+                    this.CONSUME2(Identifier, { LABEL: 'portName' });
+                    this.OPTION(() => {
+                        this.CONSUME(Colon);
+                        this.CONSUME3(Identifier, { LABEL: 'scopeName' });
+                    });
+                },
+            },
+            {
+                // pseudo-node: secret:NAME (nodeId="secret", colon, pseudoName="NAME")
+                ALT: () => {
+                    this.CONSUME2(Colon, { LABEL: 'pseudoColon' });
+                    this.CONSUME4(Identifier, { LABEL: 'pseudoName' });
+                },
+            },
+        ]);
     });
 }
 // =============================================================================
@@ -66,6 +79,11 @@ class ConnectVisitor extends BaseVisitor {
     }
     portRef(ctx) {
         const nodeId = ctx.nodeId[0].image;
+        // Pseudo-node branch: secret:NAME -> { nodeId: "secret:NAME", portName: "value" }
+        if (ctx.pseudoColon) {
+            const pseudoName = ctx.pseudoName[0].image;
+            return { nodeId: `${nodeId}:${pseudoName}`, portName: 'value' };
+        }
         const portName = ctx.portName[0].image;
         const scope = ctx.scopeName?.[0]?.image;
         return { nodeId, portName, scope };

package/dist/cli/commands/compile.d.ts

@@ -26,13 +26,9 @@ export interface CompileOptions {
      * Useful for vibe coders who don't use the visual editor.
      */
     clean?: boolean;
-    /**
-     * Compilation target.
-     * - 'typescript' (default): Standard in-place compilation
-     * - 'inngest': Generate Inngest function with per-node step.run() for durability
-     */
-    target?: 'typescript' | 'inngest';
-    /** Override @trigger cron from CLI (Inngest target only) */
+    /** Compilation target. 'typescript' (default) or a registered extension target. */
+    target?: string;
+    /** Override @trigger cron from CLI */
     cron?: string;
     /** Generate serve() handler */
     serve?: boolean;
@@ -47,9 +43,9 @@ export interface CompileOptions {
 }
 export declare function compileCommand(input: string, options?: CompileOptions): Promise<void>;
 /**
- * Compile a workflow file to Inngest function code with per-node step.run().
+ * Compile a workflow file using a registered custom compile target.
  */
-export declare function compileInngestTarget(input: string, options: {
+export declare function compileCustomTarget(target: string, input: string, options: {
     production: boolean;
     verbose?: boolean;
     workflowName?: string;

package/dist/cli/commands/compile.js

@@ -12,7 +12,7 @@ import { logger } from '../utils/logger.js';
 import { getErrorMessage } from '../../utils/error-utils.js';
 import { getFriendlyError } from '../../friendly-errors.js';
 import { detectProjectModuleFormat } from './doctor.js';
-import { generateInngestFunction } from '../../generator/inngest.js';
+import { compileTargetRegistry } from '../../generator/compile-target-registry.js';
 import { AnnotationParser } from '../../parser.js';
 /** Show path relative to cwd for cleaner output */
 function displayPath(filePath) {
@@ -37,9 +37,9 @@ function resolveModuleFormat(format, cwd) {
 }
 export async function compileCommand(input, options = {}) {
     const { production = false, sourceMap = false, strict = false, verbose = false, workflowName, dryRun = false, format, inlineRuntime = false, clean = false, target } = options;
-    // Handle Inngest target compilation
-    if (target === 'inngest') {
-        return compileInngestTarget(input, { production, verbose, workflowName, dryRun });
+    // Handle custom compile target
+    if (target && target !== 'typescript') {
+        return compileCustomTarget(target, input, { production, verbose, workflowName, dryRun, cron: options.cron, serve: options.serve, framework: options.framework, typedEvents: options.typedEvents, retries: options.retries, timeout: options.timeout });
     }
     // Resolve module format (auto-detect if not specified)
     const cwd = process.cwd();
@@ -222,19 +222,27 @@ export async function compileCommand(input, options = {}) {
     }
 }
 /**
- * Compile a workflow file to Inngest function code with per-node step.run().
+ * Compile a workflow file using a registered custom compile target.
  */
-export async function compileInngestTarget(input, options) {
+export async function compileCustomTarget(target, input, options) {
+    const customTarget = compileTargetRegistry.get(target);
+    if (!customTarget) {
+        const available = compileTargetRegistry.getNames();
+        const hint = available.length > 0
+            ? ` Available targets: typescript, ${available.join(', ')}`
+            : ' No custom targets registered.';
+        throw new Error(`Unknown compile target: ${target}.${hint}`);
+    }
     const filePath = path.resolve(input);
     if (!fs.existsSync(filePath)) {
         throw new Error(`File not found: ${displayPath(filePath)}`);
     }
-    logger.section('Compiling to Inngest');
+    logger.section(`Compiling to ${target}`);
     logger.info(`Input: ${displayPath(filePath)}`);
-    logger.info(`Target: Inngest (per-node step.run)`);
+    logger.info(`Target: ${target}`);
     logger.newline();
-    const parser = new AnnotationParser();
-    const parseResult = parser.parse(filePath);
+    const annotationParser = new AnnotationParser();
+    const parseResult = annotationParser.parse(filePath);
     if (parseResult.errors.length > 0) {
         const msgs = parseResult.errors.map((e) => `  ${e}`).join('\n');
         throw new Error(`Parse errors:\n${msgs}`);
@@ -263,13 +271,13 @@ export async function compileInngestTarget(input, options) {
         workflow.options = workflow.options || {};
         workflow.options.timeout = options.timeout;
     }
-    const code = generateInngestFunction(workflow, allNodeTypes, {
+    const code = customTarget.compile(workflow, allNodeTypes, {
         production: options.production,
         typedEvents: options.typedEvents,
         serveHandler: options.serve,
         framework: options.framework,
     });
-    const outputPath = filePath.replace(/\.ts$/, '.inngest.ts');
+    const outputPath = filePath.replace(/\.ts$/, `.${target}.ts`);
     if (options.dryRun) {
         logger.success(`Would generate: ${displayPath(outputPath)}`);
         logger.newline();
@@ -287,7 +295,6 @@ export async function compileInngestTarget(input, options) {
     }
     logger.newline();
     logger.section('Summary');
-    logger.success(`Workflow "${workflow.name}" compiled to Inngest function`);
-    logger.info('Each node is wrapped in step.run() for per-node durability');
+    logger.success(`Workflow "${workflow.name}" compiled to ${target} target`);
 }
 //# sourceMappingURL=compile.js.map

package/dist/cli/commands/dev.d.ts

@@ -1,29 +1,18 @@
 /**
  * Dev command - watch, compile, and run workflow on changes
  */
-export interface DevOptions {
+import { type DevModeOptions } from '../../generator/dev-mode-registry.js';
+export interface DevOptions extends DevModeOptions {
     /** Input parameters as JSON string */
     params?: string;
     /** Path to JSON file containing input parameters */
     paramsFile?: string;
-    /** Specific workflow name to run (if file contains multiple workflows) */
-    workflow?: string;
-    /** Run in production mode (no trace events) */
-    production?: boolean;
     /** Module format for generated code */
     format?: 'esm' | 'cjs' | 'auto';
     /** Omit redundant @param/@returns annotations */
     clean?: boolean;
-    /** Run once then exit (for testing) */
-    once?: boolean;
-    /** Output result as JSON (for scripting) */
-    json?: boolean;
     /** Compilation target (default: typescript in-place) */
     target?: string;
-    /** Framework for serve handler (inngest target only) */
-    framework?: 'next' | 'express' | 'hono' | 'fastify' | 'remix';
-    /** Port for the dev server (inngest target only) */
-    port?: number;
 }
 /**
  * Dev command: watch + compile + run in a single loop.