@synergenius/flow-weaver 0.17.7 → 0.17.8

package/dist/extensions/cicd/base-target.js

@@ -1,397 +0,0 @@
-/**
- * Base CI/CD Export Target
- *
- * Shared logic for generating CI/CD pipeline files (GitHub Actions, GitLab CI).
- * Unlike serverless targets, CI/CD targets produce native YAML that runs without
- * any FW runtime dependency.
- *
- * Key responsibilities:
- * - Build job graph from AST (group nodes by @job, compute dependencies)
- * - Resolve secret wiring (secret: pseudo-node connections -> job env vars)
- * - Inject artifact upload/download steps between jobs
- * - Generate SECRETS_SETUP.md documentation
- */
-import { BaseExportTarget, } from '../../deployment/targets/base.js';
-export const NODE_ACTION_MAP = {
-    checkout: {
-        githubAction: 'actions/checkout@v4',
-        gitlabScript: ['echo "Checkout handled by GitLab CI runner"'],
-        label: 'Checkout code',
-    },
-    'setup-node': {
-        githubAction: 'actions/setup-node@v4',
-        githubWith: { 'node-version': '20' },
-        gitlabImage: 'node:20',
-        label: 'Setup Node.js',
-    },
-    'setup-python': {
-        githubAction: 'actions/setup-python@v5',
-        githubWith: { 'python-version': '3.12' },
-        gitlabImage: 'python:3.12',
-        label: 'Setup Python',
-    },
-    'npm-install': {
-        githubAction: undefined,
-        gitlabScript: ['npm ci'],
-        label: 'Install dependencies',
-    },
-    'npm-test': {
-        githubAction: undefined,
-        gitlabScript: ['npm test'],
-        label: 'Run tests',
-    },
-    'npm-build': {
-        githubAction: undefined,
-        gitlabScript: ['npm run build'],
-        label: 'Build',
-    },
-    'docker-build': {
-        githubAction: 'docker/build-push-action@v6',
-        githubWith: { push: 'false' },
-        gitlabScript: ['docker build -t $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA .'],
-        label: 'Build Docker image',
-    },
-    'docker-push': {
-        githubAction: 'docker/build-push-action@v6',
-        githubWith: { push: 'true' },
-        gitlabScript: ['docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA'],
-        label: 'Push Docker image',
-    },
-    'docker-login': {
-        githubAction: 'docker/login-action@v3',
-        gitlabScript: ['echo "$CI_REGISTRY_PASSWORD" | docker login -u "$CI_REGISTRY_USER" --password-stdin $CI_REGISTRY'],
-        label: 'Docker login',
-    },
-    'shell-command': {
-        githubAction: undefined,
-        gitlabScript: ['echo "TODO: Add shell command"'],
-        label: 'Run command',
-    },
-    'deploy-ssh': {
-        githubAction: undefined,
-        gitlabScript: ['echo "TODO: Configure SSH deployment"'],
-        label: 'Deploy via SSH',
-    },
-    'deploy-s3': {
-        githubAction: 'aws-actions/configure-aws-credentials@v4',
-        gitlabScript: ['aws s3 sync dist/ s3://$S3_BUCKET/'],
-        label: 'Deploy to S3',
-    },
-    'slack-notify': {
-        githubAction: 'slackapi/slack-github-action@v1',
-        gitlabScript: ["curl -X POST -H 'Content-type: application/json' --data '{\"text\":\"Pipeline complete\"}' $SLACK_WEBHOOK_URL"],
-        label: 'Send Slack notification',
-    },
-    'health-check': {
-        githubAction: undefined,
-        gitlabScript: ['curl --retry 10 --retry-delay 5 --retry-all-errors $HEALTH_CHECK_URL'],
-        label: 'Health check',
-    },
-    'wait-for-url': {
-        githubAction: undefined,
-        gitlabScript: ['for i in $(seq 1 30); do curl -sf $WAIT_URL && exit 0; sleep 10; done; exit 1'],
-        label: 'Wait for URL',
-    },
-};
-// ---------------------------------------------------------------------------
-// Base CI/CD Target
-// ---------------------------------------------------------------------------
-export class BaseCICDTarget extends BaseExportTarget {
-    async generateMultiWorkflow(_workflows, _options) {
-        throw new Error('CI/CD targets use generate() with AST, not generateMultiWorkflow()');
-    }
-    async generateNodeTypeService(_nodeTypes, _options) {
-        throw new Error('CI/CD targets do not export node types as services');
-    }
-    async generateBundle(_workflows, _nodeTypes, _options) {
-        throw new Error('CI/CD targets use generate() with AST, not generateBundle()');
-    }
-    // ---------------------------------------------------------------------------
-    // Shared CI/CD Logic
-    // ---------------------------------------------------------------------------
-    resolveActionMapping(step, targetName) {
-        const deployConfig = step.nodeTypeDeploy?.[targetName];
-        if (deployConfig) {
-            return {
-                githubAction: deployConfig.action,
-                githubWith: deployConfig.with
-                    ? (typeof deployConfig.with === 'string'
-                        ? JSON.parse(deployConfig.with)
-                        : deployConfig.with)
-                    : undefined,
-                gitlabScript: deployConfig.script
-                    ? (Array.isArray(deployConfig.script)
-                        ? deployConfig.script
-                        : deployConfig.script.split('\n'))
-                    : undefined,
-                gitlabImage: deployConfig.image,
-                label: deployConfig.label || step.name,
-            };
-        }
-        return NODE_ACTION_MAP[step.nodeType]
-            || NODE_ACTION_MAP[step.nodeType.replace(/([A-Z])/g, '-$1').toLowerCase()];
-    }
-    buildJobGraph(ast) {
-        const nodeTypeLookup = new Map();
-        for (const nt of ast.nodeTypes) {
-            nodeTypeLookup.set(nt.name, nt);
-            if (nt.functionName !== nt.name)
-                nodeTypeLookup.set(nt.functionName, nt);
-        }
-        const jobMap = new Map();
-        const defaultRunner = ast.options?.cicd?.runner;
-        for (const inst of ast.instances) {
-            const jobName = inst.job || 'default';
-            if (!jobMap.has(jobName))
-                jobMap.set(jobName, []);
-            jobMap.get(jobName).push(inst);
-        }
-        const nodeJob = new Map();
-        for (const inst of ast.instances) {
-            nodeJob.set(inst.id, inst.job || 'default');
-        }
-        const jobDeps = new Map();
-        for (const conn of ast.connections) {
-            if (conn.from.node.startsWith('secret:'))
-                continue;
-            if (conn.from.node === 'Start' || conn.to.node === 'Exit')
-                continue;
-            const fromJob = nodeJob.get(conn.from.node);
-            const toJob = nodeJob.get(conn.to.node);
-            if (fromJob && toJob && fromJob !== toJob) {
-                if (!jobDeps.has(toJob))
-                    jobDeps.set(toJob, new Set());
-                jobDeps.get(toJob).add(fromJob);
-            }
-        }
-        const jobs = [];
-        for (const [jobId, instances] of jobMap) {
-            const environment = instances.find((i) => i.environment)?.environment;
-            const steps = instances.map((inst) => {
-                const nt = nodeTypeLookup.get(inst.nodeType);
-                return {
-                    id: inst.id,
-                    name: inst.config?.label || inst.id,
-                    nodeType: inst.nodeType,
-                    ...(nt?.deploy && { nodeTypeDeploy: nt.deploy }),
-                };
-            });
-            const needs = jobDeps.get(jobId)
-                ? Array.from(jobDeps.get(jobId))
-                : [];
-            jobs.push({
-                id: jobId,
-                name: jobId,
-                runner: defaultRunner,
-                needs,
-                steps,
-                environment,
-                secrets: [],
-            });
-        }
-        // Apply @job configs
-        const jobConfigs = ast.options?.cicd?.jobs;
-        if (jobConfigs) {
-            for (const jc of jobConfigs) {
-                const job = jobs.find(j => j.id === jc.id);
-                if (!job)
-                    continue;
-                if (jc.retry !== undefined)
-                    job.retry = jc.retry;
-                if (jc.allowFailure !== undefined)
-                    job.allowFailure = jc.allowFailure;
-                if (jc.timeout)
-                    job.timeout = jc.timeout;
-                if (jc.variables)
-                    job.variables = { ...job.variables, ...jc.variables };
-                if (jc.tags)
-                    job.tags = jc.tags;
-                if (jc.beforeScript)
-                    job.beforeScript = jc.beforeScript;
-                if (jc.rules)
-                    job.rules = jc.rules;
-                if (jc.coverage)
-                    job.coverage = jc.coverage;
-                if (jc.reports)
-                    job.reports = jc.reports;
-                if (jc.runner)
-                    job.runner = jc.runner;
-                if (jc.extends)
-                    job.extends = jc.extends;
-            }
-        }
-        // Apply @stage assignments
-        const stages = ast.options?.cicd?.stages;
-        if (stages && stages.length > 0) {
-            const depthMap = this.computeJobDepths(jobs);
-            // Match ALL jobs by name prefix to stages, not just configured ones
-            for (const job of jobs) {
-                if (!job.stage) {
-                    for (const s of stages) {
-                        if (job.id === s.name || job.id.startsWith(s.name + '-') || job.id.startsWith(s.name + '_')) {
-                            job.stage = s.name;
-                            break;
-                        }
-                    }
-                }
-            }
-            for (const job of jobs) {
-                if (!job.stage) {
-                    const depth = depthMap.get(job.id) || 0;
-                    job.stage = stages[Math.min(depth, stages.length - 1)].name;
-                }
-            }
-        }
-        // Apply workflow-level defaults
-        const cicd = ast.options?.cicd;
-        if (cicd) {
-            for (const job of jobs) {
-                if (cicd.variables && !job.variables) {
-                    job.variables = { ...cicd.variables };
-                }
-                if (cicd.beforeScript && !job.beforeScript) {
-                    job.beforeScript = [...cicd.beforeScript];
-                }
-                if (cicd.tags && !job.tags) {
-                    job.tags = [...cicd.tags];
-                }
-            }
-        }
-        return this.topoSortJobs(jobs);
-    }
-    topoSortJobs(jobs) {
-        const jobMap = new Map(jobs.map((j) => [j.id, j]));
-        const visited = new Set();
-        const sorted = [];
-        function visit(id) {
-            if (visited.has(id))
-                return;
-            visited.add(id);
-            const job = jobMap.get(id);
-            if (!job)
-                return;
-            for (const dep of job.needs) {
-                visit(dep);
-            }
-            sorted.push(job);
-        }
-        for (const job of jobs) {
-            visit(job.id);
-        }
-        return sorted;
-    }
-    computeJobDepths(jobs) {
-        const depths = new Map();
-        function depth(jobId, visited) {
-            if (depths.has(jobId))
-                return depths.get(jobId);
-            if (visited.has(jobId))
-                return 0;
-            visited.add(jobId);
-            const job = jobs.find(j => j.id === jobId);
-            if (!job || job.needs.length === 0) {
-                depths.set(jobId, 0);
-                return 0;
-            }
-            const maxDep = Math.max(...job.needs.map(n => depth(n, visited)));
-            const d = maxDep + 1;
-            depths.set(jobId, d);
-            return d;
-        }
-        for (const job of jobs) {
-            depth(job.id, new Set());
-        }
-        return depths;
-    }
-    resolveJobSecrets(jobs, ast, renderSecretRef) {
-        const nodeJob = new Map();
-        for (const inst of ast.instances) {
-            nodeJob.set(inst.id, inst.job || 'default');
-        }
-        const stepMap = new Map();
-        for (const job of jobs) {
-            for (const step of job.steps) {
-                stepMap.set(step.id, step);
-            }
-        }
-        for (const conn of ast.connections) {
-            if (!conn.from.node.startsWith('secret:'))
-                continue;
-            const secretName = conn.from.node.substring(7);
-            const targetNode = conn.to.node;
-            const targetPort = conn.to.port;
-            const jobId = nodeJob.get(targetNode);
-            if (!jobId)
-                continue;
-            const job = jobs.find((j) => j.id === jobId);
-            if (!job)
-                continue;
-            if (!job.secrets.includes(secretName)) {
-                job.secrets.push(secretName);
-            }
-            const step = stepMap.get(targetNode);
-            if (step) {
-                step.env = step.env || {};
-                step.env[targetPort.replace(/([A-Z])/g, '_$1').toUpperCase().replace(/^_/, '')] =
-                    renderSecretRef(secretName);
-            }
-        }
-    }
-    injectArtifactSteps(jobs, artifacts) {
-        if (artifacts.length === 0)
-            return;
-        for (const job of jobs) {
-            if (job.needs.length === 0)
-                continue;
-            const neededJobs = jobs.filter((j) => job.needs.includes(j.id));
-            for (const needed of neededJobs) {
-                const jobArtifacts = artifacts.filter((a) => !a.name || needed.steps.some((s) => s.nodeType === a.name));
-                if (jobArtifacts.length > 0) {
-                    needed.uploadArtifacts = (needed.uploadArtifacts || []).concat(jobArtifacts);
-                    job.downloadArtifacts = (job.downloadArtifacts || []).concat(jobArtifacts.map((a) => a.name));
-                }
-            }
-        }
-    }
-    generateSecretsDoc(secrets, platform) {
-        if (secrets.length === 0)
-            return '';
-        const lines = [
-            '# Secrets Setup Guide',
-            '',
-            `This workflow requires ${secrets.length} secret(s) to be configured.`,
-            '',
-        ];
-        for (const secret of secrets) {
-            lines.push(`## ${secret.name}`);
-            if (secret.description) {
-                lines.push(`> ${secret.description}`);
-            }
-            lines.push('');
-            if (platform === 'github-actions' || secret.platform === 'all' || secret.platform === 'github' || !secret.platform) {
-                lines.push('**GitHub Actions:**');
-                lines.push('1. Go to your repository on GitHub');
-                lines.push('2. Navigate to Settings > Secrets and variables > Actions');
-                lines.push('3. Click "New repository secret"');
-                lines.push(`4. Name: \`${secret.name}\``);
-                lines.push('5. Paste your secret value and click "Add secret"');
-                lines.push('');
-            }
-            if (platform === 'gitlab-ci' || secret.platform === 'all' || secret.platform === 'gitlab' || !secret.platform) {
-                lines.push('**GitLab CI:**');
-                lines.push('1. Go to your project on GitLab');
-                lines.push('2. Navigate to Settings > CI/CD > Variables');
-                lines.push('3. Click "Add variable"');
-                lines.push(`4. Key: \`${secret.name}\``);
-                lines.push('5. Paste your secret value');
-                lines.push('6. Check "Mask variable" and optionally "Protect variable"');
-                lines.push('7. Click "Add variable"');
-                lines.push('');
-            }
-            lines.push('---');
-            lines.push('');
-        }
-        return lines.join('\n');
-    }
-}
-//# sourceMappingURL=base-target.js.map

package/dist/extensions/cicd/detection.d.ts

@@ -1,33 +0,0 @@
-/**
- * CI/CD Workflow Detection
- *
- * Determines whether a workflow is a CI/CD pipeline based on annotations.
- * A workflow is CI/CD if it has any CI/CD-specific annotations:
- * @secret, @runner, @cache, @artifact, @environment, @matrix, @service,
- * @concurrency, [job: "..."], or CI/CD trigger types (push, pull_request, etc.)
- */
-import type { TWorkflowAST } from '../../ast/types.js';
-/**
- * Check if a workflow is a CI/CD pipeline.
- *
- * Detection signals (any one is sufficient):
- * 1. Workflow options contain CI/CD fields (secrets, runner, caches, etc.)
- * 2. Any node instance has a `job` attribute
- * 3. Workflow has cicdTriggers
- */
-export declare function isCICDWorkflow(ast: TWorkflowAST): boolean;
-/**
- * Get all unique job names from a CI/CD workflow.
- * Returns empty array if no jobs are defined.
- */
-export declare function getJobNames(ast: TWorkflowAST): string[];
-/**
- * Get all declared secret names from a CI/CD workflow.
- */
-export declare function getDeclaredSecrets(ast: TWorkflowAST): string[];
-/**
- * Get all secret:NAME references from connections.
- * Returns array of secret names that are wired via @connect.
- */
-export declare function getReferencedSecrets(ast: TWorkflowAST): string[];
-//# sourceMappingURL=detection.d.ts.map

package/dist/extensions/cicd/detection.js

@@ -1,88 +0,0 @@
-/**
- * CI/CD Workflow Detection
- *
- * Determines whether a workflow is a CI/CD pipeline based on annotations.
- * A workflow is CI/CD if it has any CI/CD-specific annotations:
- * @secret, @runner, @cache, @artifact, @environment, @matrix, @service,
- * @concurrency, [job: "..."], or CI/CD trigger types (push, pull_request, etc.)
- */
-/**
- * Check if a workflow is a CI/CD pipeline.
- *
- * Detection signals (any one is sufficient):
- * 1. Workflow options contain CI/CD fields (secrets, runner, caches, etc.)
- * 2. Any node instance has a `job` attribute
- * 3. Workflow has cicdTriggers
- */
-export function isCICDWorkflow(ast) {
-    // Check CI/CD domain annotations
-    const cicd = ast.options?.cicd;
-    if (cicd) {
-        if (cicd.secrets && cicd.secrets.length > 0)
-            return true;
-        if (cicd.runner)
-            return true;
-        if (cicd.caches && cicd.caches.length > 0)
-            return true;
-        if (cicd.artifacts && cicd.artifacts.length > 0)
-            return true;
-        if (cicd.environments && cicd.environments.length > 0)
-            return true;
-        if (cicd.matrix)
-            return true;
-        if (cicd.services && cicd.services.length > 0)
-            return true;
-        if (cicd.concurrency)
-            return true;
-        if (cicd.triggers && cicd.triggers.length > 0)
-            return true;
-        if (cicd.jobs && cicd.jobs.length > 0)
-            return true;
-        if (cicd.variables && Object.keys(cicd.variables).length > 0)
-            return true;
-        if (cicd.beforeScript && cicd.beforeScript.length > 0)
-            return true;
-        if (cicd.tags && cicd.tags.length > 0)
-            return true;
-        if (cicd.includes && cicd.includes.length > 0)
-            return true;
-        if (cicd.stages && cicd.stages.length > 0)
-            return true;
-    }
-    // Check node-level CI/CD annotations
-    if (ast.instances.some((inst) => inst.job))
-        return true;
-    return false;
-}
-/**
- * Get all unique job names from a CI/CD workflow.
- * Returns empty array if no jobs are defined.
- */
-export function getJobNames(ast) {
-    const jobs = new Set();
-    for (const inst of ast.instances) {
-        if (inst.job)
-            jobs.add(inst.job);
-    }
-    return Array.from(jobs);
-}
-/**
- * Get all declared secret names from a CI/CD workflow.
- */
-export function getDeclaredSecrets(ast) {
-    return (ast.options?.cicd?.secrets || []).map((s) => s.name);
-}
-/**
- * Get all secret:NAME references from connections.
- * Returns array of secret names that are wired via @connect.
- */
-export function getReferencedSecrets(ast) {
-    const secrets = new Set();
-    for (const conn of ast.connections) {
-        if (conn.from.node.startsWith('secret:')) {
-            secrets.add(conn.from.node.substring(7)); // strip "secret:" prefix
-        }
-    }
-    return Array.from(secrets);
-}
-//# sourceMappingURL=detection.js.map