@synergenius/flow-weaver 0.17.6 → 0.17.8

package/dist/extensions/cicd/tag-handler.js

@@ -1,504 +0,0 @@
-/**
- * CI/CD tag handler for the TagHandlerRegistry.
- *
- * Handles all CI/CD annotation tags: @secret, @runner, @cache, @artifact,
- * @environment, @matrix, @service, @concurrency, @job, @stage, @variables,
- * @before_script, @tags, @includes, plus the synthetic _cicdTrigger tag
- * for CI/CD trigger variants of @trigger.
- *
- * Each parser writes to ctx.deploy (the 'cicd' namespace slot) using the
- * same structures as the former jsdoc-parser.ts private methods.
- */
-export const cicdTagHandler = (tagName, comment, ctx) => {
-    const d = ctx.deploy;
-    const warnings = ctx.warnings;
-    const text = comment.trim();
-    switch (tagName) {
-        case 'secret':
-            parseSecret(text, d, warnings);
-            break;
-        case 'runner': {
-            const val = text.replace(/^["']|["']$/g, '');
-            if (val)
-                d['runner'] = val;
-            break;
-        }
-        case 'cache':
-            parseCache(text, d, warnings);
-            break;
-        case 'artifact':
-            parseArtifact(text, d, warnings);
-            break;
-        case 'environment':
-            parseEnvironment(text, d, warnings);
-            break;
-        case 'matrix':
-            parseMatrix(text, d, warnings);
-            break;
-        case 'service':
-            parseService(text, d, warnings);
-            break;
-        case 'concurrency':
-            parseConcurrency(text, d, warnings);
-            break;
-        case 'job':
-            parseJob(text, d, warnings);
-            break;
-        case 'stage':
-            parseStage(text, d, warnings);
-            break;
-        case 'variables':
-            parseVariables(text, d, warnings);
-            break;
-        case 'before_script':
-            parseBeforeScript(text, d, warnings);
-            break;
-        case 'tags':
-            parseTags(text, d, warnings);
-            break;
-        case 'includes':
-            parseIncludes(text, d, warnings);
-            break;
-        case '_cicdTrigger':
-            parseCicdTrigger(text, d, warnings);
-            break;
-    }
-};
-function parseSecret(text, d, warnings) {
-    if (!text) {
-        warnings.push('Empty @secret tag. Expected: @secret SECRET_NAME - description');
-        return;
-    }
-    const match = text.match(/^(\S+)(.*?)(?:\s+-\s+(.*))?$/);
-    if (!match) {
-        warnings.push(`Invalid @secret format: @secret ${text}`);
-        return;
-    }
-    const name = match[1];
-    const attrs = match[2] || '';
-    const description = match[3]?.trim();
-    const secret = { name };
-    if (description)
-        secret.description = description;
-    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`);
-        }
-    }
-    const secrets = d['secrets'] ?? [];
-    secrets.push(secret);
-    d['secrets'] = secrets;
-}
-function parseCache(text, d, warnings) {
-    if (!text) {
-        warnings.push('Empty @cache tag. Expected: @cache npm key="package-lock.json"');
-        return;
-    }
-    const parts = text.match(/^(\S+)(.*)?$/);
-    if (!parts) {
-        warnings.push(`Invalid @cache format: @cache ${text}`);
-        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];
-    const caches = d['caches'] ?? [];
-    caches.push(cache);
-    d['caches'] = caches;
-}
-function parseArtifact(text, d, warnings) {
-    if (!text) {
-        warnings.push('Empty @artifact tag. Expected: @artifact name path="dist/"');
-        return;
-    }
-    const nameMatch = text.match(/^(\S+)/);
-    if (!nameMatch) {
-        warnings.push(`Invalid @artifact format: @artifact ${text}`);
-        return;
-    }
-    const pathMatch = text.match(/path\s*=\s*"([^"]+)"/);
-    if (!pathMatch) {
-        warnings.push(`@artifact requires path="...": @artifact ${text}`);
-        return;
-    }
-    const artifact = {
-        name: nameMatch[1],
-        path: pathMatch[1],
-    };
-    const retentionMatch = text.match(/retention\s*=\s*(\d+)/);
-    if (retentionMatch)
-        artifact.retention = parseInt(retentionMatch[1], 10);
-    const artifacts = d['artifacts'] ?? [];
-    artifacts.push(artifact);
-    d['artifacts'] = artifacts;
-}
-function parseEnvironment(text, d, warnings) {
-    if (!text) {
-        warnings.push('Empty @environment tag. Expected: @environment production url="https://app.com"');
-        return;
-    }
-    const nameMatch = text.match(/^(\S+)/);
-    if (!nameMatch) {
-        warnings.push(`Invalid @environment format: @environment ${text}`);
-        return;
-    }
-    const env = { name: nameMatch[1] };
-    const urlMatch = text.match(/url\s*=\s*"([^"]+)"/);
-    if (urlMatch)
-        env.url = urlMatch[1];
-    const reviewersMatch = text.match(/reviewers\s*=\s*(\d+)/);
-    if (reviewersMatch)
-        env.reviewers = parseInt(reviewersMatch[1], 10);
-    const environments = d['environments'] ?? [];
-    environments.push(env);
-    d['environments'] = environments;
-}
-function parseMatrix(text, d, warnings) {
-    if (!text) {
-        warnings.push('Empty @matrix tag. Expected: @matrix node="18,20,22" os="ubuntu-latest"');
-        return;
-    }
-    const matrix = d['matrix'] ?? { dimensions: {} };
-    d['matrix'] = matrix;
-    const isInclude = text.startsWith('include ');
-    const isExclude = text.startsWith('exclude ');
-    if (isInclude || isExclude) {
-        const rest = text.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) {
-                matrix.include = matrix.include || [];
-                matrix.include.push(entry);
-            }
-            else {
-                matrix.exclude = matrix.exclude || [];
-                matrix.exclude.push(entry);
-            }
-        }
-        return;
-    }
-    const kvRegex = /(\w[\w-]*)\s*=\s*"([^"]+)"/g;
-    let m;
-    while ((m = kvRegex.exec(text)) !== null) {
-        matrix.dimensions[m[1]] = m[2].split(',').map(v => v.trim());
-    }
-}
-function parseService(text, d, warnings) {
-    if (!text) {
-        warnings.push('Empty @service tag. Expected: @service postgres image="postgres:16"');
-        return;
-    }
-    const nameMatch = text.match(/^(\S+)/);
-    if (!nameMatch) {
-        warnings.push(`Invalid @service format: @service ${text}`);
-        return;
-    }
-    const imageMatch = text.match(/image\s*=\s*"([^"]+)"/);
-    if (!imageMatch) {
-        warnings.push(`@service requires image="...": @service ${text}`);
-        return;
-    }
-    const svc = {
-        name: nameMatch[1],
-        image: imageMatch[1],
-    };
-    const envMatch = text.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 = text.match(/ports\s*=\s*"([^"]+)"/);
-    if (portsMatch) {
-        svc.ports = portsMatch[1].split(',').map(p => p.trim());
-    }
-    const services = d['services'] ?? [];
-    services.push(svc);
-    d['services'] = services;
-}
-function parseConcurrency(text, d, warnings) {
-    if (!text) {
-        warnings.push('Empty @concurrency tag. Expected: @concurrency group="deploy"');
-        return;
-    }
-    const groupMatch = text.match(/group\s*=\s*"([^"]+)"/);
-    if (!groupMatch) {
-        const bareMatch = text.match(/^(\S+)/);
-        if (bareMatch) {
-            d['concurrency'] = { group: bareMatch[1], cancelInProgress: false };
-        }
-        else {
-            warnings.push(`Invalid @concurrency format: @concurrency ${text}`);
-        }
-        return;
-    }
-    const cancelMatch = text.match(/cancel-in-progress\s*=\s*(true|false)/);
-    d['concurrency'] = {
-        group: groupMatch[1],
-        cancelInProgress: cancelMatch ? cancelMatch[1] === 'true' : false,
-    };
-}
-function parseJob(text, d, warnings) {
-    if (!text) {
-        warnings.push('Empty @job tag. Expected: @job <name> key=value ...');
-        return;
-    }
-    const spaceIdx = text.indexOf(' ');
-    const jobId = spaceIdx === -1 ? text : text.substring(0, spaceIdx);
-    const rest = spaceIdx === -1 ? '' : text.substring(spaceIdx + 1);
-    const jobs = d['jobs'] ?? [];
-    d['jobs'] = jobs;
-    let jc = jobs.find(j => j.id === jobId);
-    if (!jc) {
-        jc = { id: jobId };
-        jobs.push(jc);
-    }
-    if (!rest)
-        return;
-    const kvRegex = /(\w[\w-]*)\s*=\s*(?:"((?:[^"\\]|\\.)*)"|'((?:[^'\\]|\\.)*)'|([\S]+))/g;
-    let match;
-    while ((match = kvRegex.exec(rest)) !== null) {
-        const key = match[1];
-        const value = match[2] !== undefined ? match[2] : match[3] !== undefined ? match[3] : match[4];
-        switch (key) {
-            case 'retry': {
-                const n = parseInt(value, 10);
-                if (!isNaN(n) && n >= 0)
-                    jc.retry = n;
-                else
-                    warnings.push(`Invalid retry value "${value}" in @job ${jobId}`);
-                break;
-            }
-            case 'allow_failure':
-                jc.allowFailure = value === 'true';
-                break;
-            case 'timeout':
-                jc.timeout = value;
-                break;
-            case 'runner':
-                jc.runner = value;
-                break;
-            case 'tags':
-                jc.tags = value.split(',').map(t => t.trim()).filter(Boolean);
-                break;
-            case 'coverage':
-                jc.coverage = value;
-                break;
-            case 'extends':
-                jc.extends = value;
-                break;
-            case 'variables': {
-                jc.variables = jc.variables || {};
-                for (const pair of value.split(',')) {
-                    const eqIdx = pair.indexOf('=');
-                    if (eqIdx > 0) {
-                        jc.variables[pair.substring(0, eqIdx).trim()] = pair.substring(eqIdx + 1).trim();
-                    }
-                }
-                break;
-            }
-            case 'before_script':
-                jc.beforeScript = value.split(',').map(s => s.trim()).filter(Boolean);
-                break;
-            case 'rules':
-                jc.rules = jc.rules || [];
-                jc.rules.push({ if: value });
-                break;
-            case 'when': {
-                // Modifier: sets `when` on the last rule, or creates a standalone rule
-                jc.rules = jc.rules || [];
-                if (jc.rules.length === 0)
-                    jc.rules.push({});
-                jc.rules[jc.rules.length - 1].when = value;
-                break;
-            }
-            case 'changes': {
-                // Modifier: sets `changes` on the last rule
-                jc.rules = jc.rules || [];
-                if (jc.rules.length === 0)
-                    jc.rules.push({});
-                jc.rules[jc.rules.length - 1].changes = value.split(',').map(s => s.trim()).filter(Boolean);
-                break;
-            }
-            case 'reports': {
-                jc.reports = jc.reports || [];
-                for (const pair of value.split(',')) {
-                    const eqIdx = pair.indexOf('=');
-                    if (eqIdx > 0) {
-                        jc.reports.push({
-                            type: pair.substring(0, eqIdx).trim(),
-                            path: pair.substring(eqIdx + 1).trim(),
-                        });
-                    }
-                }
-                break;
-            }
-            default:
-                warnings.push(`Unknown @job attribute "${key}" in @job ${jobId}`);
-        }
-    }
-}
-function parseStage(text, d, warnings) {
-    if (!text) {
-        warnings.push('Empty @stage tag. Expected: @stage <name>');
-        return;
-    }
-    const stages = d['stages'] ?? [];
-    d['stages'] = stages;
-    const name = text.split(/\s+/)[0];
-    if (!stages.some(s => s.name === name)) {
-        stages.push({ name });
-    }
-}
-function parseVariables(text, d, warnings) {
-    if (!text) {
-        warnings.push('Empty @variables tag. Expected: @variables KEY=VALUE');
-        return;
-    }
-    const variables = d['variables'] ?? {};
-    d['variables'] = variables;
-    const kvRegex = /(\w[\w-]*)\s*=\s*(?:"((?:[^"\\]|\\.)*)"|(\S+))/g;
-    let match;
-    while ((match = kvRegex.exec(text)) !== null) {
-        variables[match[1]] = match[2] !== undefined ? match[2] : match[3];
-    }
-}
-function parseBeforeScript(text, d, warnings) {
-    if (!text) {
-        warnings.push('Empty @before_script tag. Expected: @before_script "cmd1" "cmd2"');
-        return;
-    }
-    const beforeScript = d['beforeScript'] ?? [];
-    d['beforeScript'] = beforeScript;
-    const strRegex = /"((?:[^"\\]|\\.)*)"/g;
-    let match;
-    const commands = [];
-    while ((match = strRegex.exec(text)) !== null) {
-        commands.push(match[1]);
-    }
-    if (commands.length > 0) {
-        beforeScript.push(...commands);
-    }
-    else {
-        beforeScript.push(text);
-    }
-}
-function parseTags(text, d, warnings) {
-    if (!text) {
-        warnings.push('Empty @tags tag. Expected: @tags tag1 tag2');
-        return;
-    }
-    d['tags'] = text.split(/[\s,]+/).filter(Boolean);
-}
-function parseIncludes(text, d, warnings) {
-    if (!text) {
-        warnings.push('Empty @includes tag. Expected: @includes local="path"');
-        return;
-    }
-    const includes = d['includes'] ?? [];
-    d['includes'] = includes;
-    const localMatch = text.match(/local\s*=\s*"([^"]+)"/);
-    const templateMatch = text.match(/template\s*=\s*"([^"]+)"/);
-    const remoteMatch = text.match(/remote\s*=\s*"([^"]+)"/);
-    const projectMatch = text.match(/project\s*=\s*"([^"]+)"/);
-    if (localMatch) {
-        includes.push({ type: 'local', file: localMatch[1] });
-    }
-    else if (templateMatch) {
-        includes.push({ type: 'template', file: templateMatch[1] });
-    }
-    else if (remoteMatch) {
-        includes.push({ type: 'remote', file: remoteMatch[1] });
-    }
-    else if (projectMatch) {
-        const fileMatch = text.match(/file\s*=\s*"([^"]+)"/);
-        const refMatch = text.match(/ref\s*=\s*"([^"]+)"/);
-        if (fileMatch) {
-            includes.push({
-                type: 'project',
-                file: fileMatch[1],
-                project: projectMatch[1],
-                ...(refMatch && { ref: refMatch[1] }),
-            });
-        }
-        else {
-            warnings.push(`@includes project requires file="...": @includes ${text}`);
-        }
-    }
-    else {
-        warnings.push(`Invalid @includes format: @includes ${text}. Expected: @includes local="path" or @includes template="name"`);
-    }
-}
-function parseCicdTrigger(text, d, warnings) {
-    // Check for CI/CD trigger types: push, pull_request, dispatch, tag, schedule
-    const cicdMatch = text.match(/^(push|pull_request|dispatch|tag|schedule)\b(.*)?$/);
-    if (!cicdMatch) {
-        // Also detect standalone cron="..." as schedule trigger
-        const cronOnlyMatch = text.match(/^cron\s*=\s*"([^"]+)"/);
-        if (cronOnlyMatch) {
-            const triggers = d['triggers'] ?? [];
-            d['triggers'] = triggers;
-            triggers.push({ type: 'schedule', cron: cronOnlyMatch[1] });
-            return;
-        }
-        warnings.push(`Invalid CI/CD trigger format: @trigger ${text}`);
-        return;
-    }
-    const type = cicdMatch[1];
-    const rest = (cicdMatch[2] || '').trim();
-    const triggerType = type;
-    const trigger = { type: triggerType };
-    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] = {};
-        }
-    }
-    const triggers = d['triggers'] ?? [];
-    d['triggers'] = triggers;
-    triggers.push(trigger);
-}
-//# sourceMappingURL=tag-handler.js.map

package/dist/extensions/cicd/templates/cicd-docker.d.ts

@@ -1,9 +0,0 @@
-/**
- * CI/CD: Docker Pipeline template
- *
- * Generates a Flow Weaver workflow for building and pushing Docker images:
- * checkout → docker-login → docker-build → docker-push
- */
-import type { WorkflowTemplate } from '../../../cli/templates/index.js';
-export declare const cicdDockerTemplate: WorkflowTemplate;
-//# sourceMappingURL=cicd-docker.d.ts.map

package/dist/extensions/cicd/templates/cicd-docker.js

@@ -1,110 +0,0 @@
-/**
- * CI/CD: Docker Pipeline template
- *
- * Generates a Flow Weaver workflow for building and pushing Docker images:
- * checkout → docker-login → docker-build → docker-push
- */
-const configSchema = {
-    platform: {
-        type: 'select',
-        label: 'CI/CD Platform',
-        default: 'github-actions',
-        options: [
-            { value: 'github-actions', label: 'GitHub Actions' },
-            { value: 'gitlab-ci', label: 'GitLab CI' },
-        ],
-    },
-    registry: {
-        type: 'select',
-        label: 'Container Registry',
-        default: 'ghcr',
-        options: [
-            { value: 'ghcr', label: 'GitHub Container Registry (ghcr.io)' },
-            { value: 'dockerhub', label: 'Docker Hub' },
-            { value: 'ecr', label: 'AWS ECR' },
-            { value: 'gcr', label: 'Google Container Registry' },
-        ],
-    },
-};
-export const cicdDockerTemplate = {
-    id: 'cicd-docker',
-    name: 'CI/CD: Docker Pipeline',
-    description: 'Build and push Docker images to a container registry',
-    category: 'automation',
-    configSchema,
-    generate: (opts) => {
-        const name = opts.workflowName || 'dockerPipeline';
-        const registry = opts.config?.registry || 'ghcr';
-        const registrySecrets = {
-            ghcr: ' * @secret GITHUB_TOKEN - GitHub token for ghcr.io',
-            dockerhub: ' * @secret DOCKER_USERNAME - Docker Hub username\n * @secret DOCKER_PASSWORD - Docker Hub password',
-            ecr: ' * @secret AWS_ACCESS_KEY_ID - AWS access key\n * @secret AWS_SECRET_ACCESS_KEY - AWS secret key',
-            gcr: ' * @secret GCR_KEY - Google Cloud service account key',
-        };
-        const registryConnect = {
-            ghcr: ' * @connect secret:GITHUB_TOKEN -> login.token',
-            dockerhub: ' * @connect secret:DOCKER_USERNAME -> login.username\n * @connect secret:DOCKER_PASSWORD -> login.password',
-            ecr: ' * @connect secret:AWS_ACCESS_KEY_ID -> login.accessKey\n * @connect secret:AWS_SECRET_ACCESS_KEY -> login.secretKey',
-            gcr: ' * @connect secret:GCR_KEY -> login.serviceAccountKey',
-        };
-        return `/** @flowWeaver nodeType
- * @expression
- * @label Checkout code
- */
-function checkout(): { repo: string } { return { repo: '.' }; }
-
-/** @flowWeaver nodeType
- * @expression
- * @label Docker login
- */
-function dockerLogin(${registry === 'dockerhub' ? 'username: string = \'\', password: string = \'\'' : registry === 'ecr' ? 'accessKey: string = \'\', secretKey: string = \'\'' : registry === 'gcr' ? 'serviceAccountKey: string = \'\'' : 'token: string = \'\''}): { loggedIn: boolean } { return { loggedIn: true }; }
-
-/** @flowWeaver nodeType
- * @expression
- * @label Docker build
- */
-function dockerBuild(): { imageTag: string } { return { imageTag: 'latest' }; }
-
-/** @flowWeaver nodeType
- * @expression
- * @label Docker push
- */
-function dockerPush(): { digest: string } { return { digest: 'sha256:abc123' }; }
-
-/**
- * @flowWeaver workflow
- * @trigger push branches="main" paths="Dockerfile,src/**"
- * @trigger tag pattern="v*"
- * @runner ubuntu-latest
-${registrySecrets[registry]}
- *
- * @node co checkout [job: "build"] [position: 270 0]
- * @node login dockerLogin [job: "build"] [position: 540 0]
- * @node build dockerBuild [job: "build"] [position: 810 0]
- * @node push dockerPush [job: "build"] [position: 1080 0]
- *
- * @path Start -> co -> login -> build -> push -> Exit
- * @position Start 0 0
- * @position Exit 1350 0
-${registryConnect[registry]}
- * @connect push.digest -> Exit.imageDigest
- *
- * @param execute [order:-1] - Execute
- * @param params [order:0] - Params
- * @returns onSuccess [order:-2] - On Success
- * @returns onFailure [order:-1] - On Failure
- * @returns imageDigest [order:0] - Docker image digest
- */
-export async function ${name}(
-  execute: boolean,
-  params: Record<string, never> = {},
-): Promise<{ onSuccess: boolean; onFailure: boolean; imageDigest: string | null }> {
-  // @flow-weaver-body-start
-  throw new Error('Compile with: npx flow-weaver compile <this-file>');
-  // @flow-weaver-body-end
-  return { onSuccess: false, onFailure: true, imageDigest: null };
-}
-`;
-    },
-};
-//# sourceMappingURL=cicd-docker.js.map

package/dist/extensions/cicd/templates/cicd-matrix.d.ts

@@ -1,9 +0,0 @@
-/**
- * CI/CD: Matrix Testing template
- *
- * Generates a pipeline with matrix strategy for testing across
- * multiple Node.js versions and/or operating systems.
- */
-import type { WorkflowTemplate } from '../../../cli/templates/index.js';
-export declare const cicdMatrixTemplate: WorkflowTemplate;
-//# sourceMappingURL=cicd-matrix.d.ts.map