@synergenius/flowweaver-pack-gitlab-ci 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +63 -0
  2. package/package.json +2 -2
package/README.md ADDED
@@ -0,0 +1,63 @@
1
+ # @synergenius/flowweaver-pack-gitlab-ci
2
+
3
+ GitLab CI/CD export target for [Flow Weaver](https://github.com/synergenius-fw/flow-weaver).
4
+
5
+ Generates native `.gitlab-ci.yml` files from Flow Weaver CI/CD workflows. No runtime dependency — outputs pure GitLab CI YAML.
6
+
7
+ ## Installation
8
+
9
+ ```bash
10
+ npm install @synergenius/flowweaver-pack-gitlab-ci
11
+ ```
12
+
13
+ This package is a **marketplace pack** — once installed, Flow Weaver automatically discovers it via `createTargetRegistry()`.
14
+
15
+ ## Usage
16
+
17
+ ### CLI
18
+
19
+ ```bash
20
+ # Export a CI/CD workflow as GitLab CI YAML
21
+ npx flow-weaver export my-pipeline.ts --target gitlab-ci
22
+ ```
23
+
24
+ ### Programmatic
25
+
26
+ ```typescript
27
+ import { createTargetRegistry } from '@synergenius/flow-weaver/deployment';
28
+
29
+ const registry = await createTargetRegistry(process.cwd());
30
+ const gitlab = registry.get('gitlab-ci');
31
+
32
+ const artifacts = await gitlab.generate({
33
+ sourceFile: 'my-pipeline.ts',
34
+ workflowName: 'myPipeline',
35
+ displayName: 'my-pipeline',
36
+ outputDir: './dist/gitlab-ci',
37
+ });
38
+ ```
39
+
40
+ ## What it generates
41
+
42
+ - `.gitlab-ci.yml` — Native GitLab CI configuration
43
+ - `SECRETS_SETUP.md` — Documentation for required CI/CD variables
44
+
45
+ ### Mapping
46
+
47
+ | Flow Weaver | GitLab CI |
48
+ |-------------|-----------|
49
+ | `[job: "name"]` annotation | Job with `stage:` |
50
+ | `@path` dependencies | Stage ordering |
51
+ | `@secret NAME` | `$NAME` variable |
52
+ | `@cache` | Native `cache:` keyword |
53
+ | `@artifact` | Native `artifacts:` keyword |
54
+ | `@trigger push` | `rules:` conditions |
55
+ | `@environment` | `environment:` with optional `when: manual` |
56
+
57
+ ## Requirements
58
+
59
+ - `@synergenius/flow-weaver` >= 0.14.0
60
+
61
+ ## License
62
+
63
+ See [LICENSE](./LICENSE).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@synergenius/flowweaver-pack-gitlab-ci",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "description": "GitLab CI/CD export target for Flow Weaver",
5
5
  "keywords": [
6
6
  "flowweaver-marketplace-pack",
@@ -36,7 +36,7 @@
36
36
  },
37
37
  "devDependencies": {
38
38
  "typescript": "^5.0.0",
39
- "@synergenius/flow-weaver": "^0.14.2",
39
+ "@synergenius/flow-weaver": "^0.17.1",
40
40
  "@types/node": "^20.0.0"
41
41
  },
42
42
  "license": "SEE LICENSE IN LICENSE",