polyci 0.1.0 → 0.1.2

package/dist/main.js

@@ -341,7 +341,6 @@ function appendModulePublishJob(lines, module) {
     lines.push(`    - changes:`);
     lines.push(`      - ${module.modulePath}/**/*`);
     lines.push(`  needs:`);
-    lines.push(`    - job: ${module.moduleName}-test`);
     lines.push(`    - job: release`);
     lines.push(`  image: $IMAGE_NODE`);
     lines.push(`  script:`);
@@ -350,7 +349,11 @@ function appendModulePublishJob(lines, module) {
     lines.push(`    - cd ${module.modulePath}`);
     lines.push(`    - cat polyci.env`);
     lines.push(`    - source polyci.env`);
-    lines.push(`    - source "ci/${module.moduleType}/publish.sh"`);
+    lines.push(`    - if [ -n "\${PLI_MODULE_VERSION:-}" ]; then`);
+    lines.push(`        source "ci/${module.moduleType}/publish.sh"`);
+    lines.push(`      else`);
+    lines.push(`        echo "No new version. Skipping publish."`);
+    lines.push(`      fi`);
     lines.push(`  artifacts:`);
     lines.push(`    paths:`);
     lines.push(`      - ${module.modulePath}/polyci.env`);
@@ -372,7 +375,11 @@ function appendModuleDeployJob(lines, module) {
     lines.push(`    - cd ${module.modulePath}`);
     lines.push(`    - cat polyci.env`);
     lines.push(`    - source polyci.env`);
-    lines.push(`    - source "ci/${module.moduleType}/deploy.sh"`);
+    lines.push(`    - if [ -n "\${PLI_MODULE_VERSION:-}" ]; then`);
+    lines.push(`        source "ci/${module.moduleType}/deploy.sh"`);
+    lines.push(`      else`);
+    lines.push(`        echo "No new version. Skipping deploy."`);
+    lines.push(`      fi`);
     lines.push(``);
 }
 function buildPipeline(modules, mainBranch, versionTemplate, branchVersionTemplate, tagTemplate, tagPattern, branchTagPattern) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "polyci",
   "description": "Monorepo CI/CD utilities.",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "private": false,
   "author": "Alexander Tsarev",

package/readme.md

@@ -1,13 +1,54 @@
-installation
+# polyci
 
-usage
+Generates GitLab CI pipelines for monorepos. Discovers modules under a root directory, creates per-module build, test, release, publish, and deploy jobs, and wires them with conventional-commit-based versioning via semalease.
 
-recommedations
-do not change the provided module types and scripts. instead, copy and customise your own type.
-be careful changin environment in release.sh (eg install packages) as the module releases run in one job in one container.
+## Installation
 
-requirements
-POLYCI_TOKEN variable must be defined in GitLab and accessible in the jobs that match the rule in the root .gitlab-ci.yml.
-each module must have build script to be called via "npm run build".
-each module must put the build result into ./dist folder.
-docker service deploy needs docker host server with traefik 3.
+```bash
+npm install
+npm run build
+```
+
+Or use via `npx polyci` when the package is published.
+
+## Usage
+
+```bash
+npx polyci [output] [options]
+```
+
+**Example** (typical GitLab CI setup):
+
+```bash
+npx polyci --modules-root modules polyci-pipeline.yml
+```
+
+**Options:**
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-o, --output <path>` | Output pipeline file path | — |
+| `--modules-root <path>` | Root directory to scan for modules | `./modules` |
+| `--main-branch <name>` | Primary branch for release tagging | `main` |
+| `--version-template <template>` | Version template for main branch; placeholders: `{version}`, `{branch}`, `{increment}` | `{version}` |
+| `--branch-version-template <template>` | Version template for non-main branches | `{version}-{branch}-{increment}` |
+| `--tag-template <template>` | Tag template; placeholders: `{module}`, `{version}` | `{module}-v{version}` |
+| `--tag-pattern <pattern>` | Tag regex for main branch (passed to semalease) | `^$PLI_MODULE_NAME-v(?<version>...)` |
+| `--branch-tag-pattern <pattern>` | Tag regex for non-main branches (with `?<increment>`) | — |
+| `--cwd <path>` | Working directory | current directory |
+
+## Description
+
+If there is no new version, publish and deploy finish successfuly doing nothing.
+
+## Requirements
+
+- **POLYCI_TOKEN** — GitLab OAuth token for pushing tags; must be defined in GitLab CI/CD variables and available to jobs that run the release stage.
+- **Module build** — Each module must support `npm run build` and produce output in `./dist`.
+
+For **docker-service** deploy type: a Docker host with Traefik 3.
+
+## Recommendations
+
+- **Do not modify the built-in module types** (`node-vite`, `node-express`, `npm-package`). Copy and customize a new type under `ci/` instead.
+- **Avoid heavy setup in `release.sh`** — Module releases run sequentially in a single container; installing extra packages or changing the environment can slow or break the job.