@logickernel/agileflow 0.4.2 → 0.13.0

package/README.md

@@ -80,9 +80,9 @@ jobs:
 **GitLab CI** (`.gitlab-ci.yml`):
 ```yaml
 agileflow:
-  stage: version
-  image: node:20-alpine
+  image: node:20
   script:
+    - npm install -g @logickernel/agileflow
     - npx @logickernel/agileflow gitlab
   rules:
     - if: '$CI_COMMIT_BRANCH == "main"'
@@ -161,11 +161,7 @@ AgileFlow analyzes commits since the last version tag to determine the appropria
 | Breaking change | `feat!: redesign API` | **Minor** (0.1.0 → 0.2.0) | **Major** (1.0.0 → 2.0.0) |
 | Feature | `feat: add login` | **Minor** | **Minor** |
 | Fix | `fix: resolve crash` | **Patch** | **Patch** |
-| Performance | `perf: optimize query` | **Patch** | **Patch** |
-| Refactor | `refactor: simplify logic` | **Patch** | **Patch** |
-| Build/CI | `build: update deps` | **Patch** | **Patch** |
-| Docs only | `docs: update README` | No bump | No bump |
-| Style changes | `style: update variable name` | No bump | No bump |
+| Everything else | `docs: update README` | No bump | No bump |
 
 ---
 

package/docs/branching-strategy.md

@@ -189,8 +189,6 @@ AgileFlow determines version bumps from commits:
 ```bash
 # Patch bump (v1.0.0 → v1.0.1)
 fix: resolve login bug
-perf: optimize queries
-refactor: simplify logic
 
 # Minor bump (v1.0.0 → v1.1.0)
 feat: add user dashboard
@@ -199,6 +197,8 @@ feat: add user dashboard
 feat!: remove deprecated API
 
 # No bump
+perf: optimize queries
+refactor: simplify logic
 docs: update README
 chore: update dependencies
 ```

package/docs/conventional-commits.md

@@ -29,14 +29,14 @@ type(scope): description
 
 | Type | Description | 1.0.0+ | 0.x.x |
 |------|-------------|--------|-------|
-| `feat` | New features | Minor | Patch |
+| `feat` | New features | Minor | Minor |
 | `fix` | Bug fixes | Patch | Patch |
-| `perf` | Performance improvements | Patch | Patch |
-| `refactor` | Code refactoring | Patch | Patch |
-| `build` | Build system changes | Patch | Patch |
-| `ci` | CI/CD changes | Patch | Patch |
-| `test` | Test changes | Patch | Patch |
-| `revert` | Revert commits | Patch | Patch |
+| `perf` | Performance improvements | None | None |
+| `refactor` | Code refactoring | None | None |
+| `build` | Build system changes | None | None |
+| `ci` | CI/CD changes | None | None |
+| `test` | Test changes | None | None |
+| `revert` | Revert commits | None | None |
 | `docs` | Documentation | None | None |
 | `style` | Code style | None | None |
 | `chore` | Maintenance | None | None |
@@ -123,9 +123,9 @@ chore: update development dependencies
 When multiple commits exist, the highest priority wins:
 
 1. **Breaking changes** → Major (or Minor for 0.x.x)
-2. **Features** → Minor (or Patch for 0.x.x)
-3. **Fixes, Performance, etc.** → Patch
-4. **Docs, Style, Chore** → No bump
+2. **Features** → Minor
+3. **Fixes** → Patch
+4. **Everything else** → No bump
 
 ### Example
 
@@ -190,7 +190,7 @@ docs: internal notes [skip release]
 ## Non-Conventional Commits
 
 Commits not following the format:
-- Trigger **patch bump** by default
+- Trigger **no bump** by default
 - Appear under "Other changes" in release notes
 - Use `[skip release]` to prevent bump
 

package/docs/getting-started.md

@@ -121,9 +121,9 @@ jobs:
 ```yaml
 # Runs on merge to main - creates the tag
 agileflow:
-  stage: version
-  image: node:20-alpine
+  image: node:20
   script:
+    - npm install -g @logickernel/agileflow
     - npx @logickernel/agileflow gitlab
   rules:
     - if: '$CI_COMMIT_BRANCH == "main"'
@@ -154,19 +154,12 @@ This creates an annotated tag and pushes it. Configure your CI to trigger on tag
 
 AgileFlow analyzes commit messages to determine the bump:
 
-| Commit Type | Example | Version Bump |
-|-------------|---------|--------------|
-| Breaking change | `feat!: redesign API` | **Major** (1.0.0 → 2.0.0) |
-| Feature | `feat: add login` | **Minor** (1.0.0 → 1.1.0) |
-| Fix | `fix: resolve crash` | **Patch** (1.0.0 → 1.0.1) |
-| Performance | `perf: optimize query` | **Patch** |
-| Docs only | `docs: update README` | No bump |
-
-### Pre-1.0.0 Behavior
-
-During initial development (0.x.x):
-- Features and fixes → **patch** bump
-- Breaking changes → **minor** bump
+| Commit Type | Example | 0.x.x | 1.0.0+ |
+|-------------|---------|-------|--------|
+| Breaking change | `feat!: redesign API` | **Minor** (0.1.0 → 0.2.0) | **Major** (1.0.0 → 2.0.0) |
+| Feature | `feat: add login` | **Minor** | **Minor** |
+| Fix | `fix: resolve crash` | **Patch** | **Patch** |
+| Everything else | `docs: update README` | No bump | No bump |
 
 ### No Bump Needed
 
@@ -226,7 +219,7 @@ Yes! Running `npx @logickernel/agileflow` without a command shows the next versi
 
 ### No Version Bump Detected
 - Use conventional commit format (`type: description`)
-- Include bump-triggering types: `feat`, `fix`, `perf`, etc.
+- Include bump-triggering types: `feat` (minor) or `fix` (patch)
 
 ---
 

package/docs/installation.md

@@ -189,8 +189,9 @@ stages:
 # Versioning job - runs on merge to main
 agileflow:
   stage: version
-  image: node:20-alpine
+  image: node:20
   script:
+    - npm install @logickernel/agileflow
     - npx @logickernel/agileflow gitlab
   rules:
     - if: '$CI_COMMIT_BRANCH == "main"'
@@ -199,9 +200,7 @@ agileflow:
 build:
   stage: build
   script:
-    - echo "Building version $CI_COMMIT_TAG"
-    - docker build -t myapp:$CI_COMMIT_TAG .
-    - docker push myapp:$CI_COMMIT_TAG
+    # Script to build your software, usually a docker image that is pulled to a registry
   rules:
     - if: '$CI_COMMIT_TAG =~ /^v/'
 
@@ -209,7 +208,7 @@ build:
 deploy-staging:
   stage: deploy
   script:
-    - kubectl set image deployment/myapp myapp=myapp:$CI_COMMIT_TAG
+    # Script to deploy your software in staging
   environment:
     name: staging
   rules:
@@ -218,7 +217,7 @@ deploy-staging:
 deploy-production:
   stage: deploy
   script:
-    - kubectl set image deployment/myapp myapp=myapp:$CI_COMMIT_TAG
+    # Script to deploy your software in production
   environment:
     name: production
   rules:

package/docs/release-management.md

@@ -30,13 +30,12 @@ MAJOR.MINOR.PATCH
 
 ### Automatic Version Calculation
 
-| Commit Type | Example | Version Bump |
-|-------------|---------|--------------|
-| Breaking | `feat!: remove API` | Major |
-| Feature | `feat: add login` | Minor |
-| Fix | `fix: resolve crash` | Patch |
-| Performance | `perf: optimize` | Patch |
-| No bump | `docs: update README` | None |
+| Commit Type | Example | 0.x.x | 1.0.0+ |
+|-------------|---------|-------|--------|
+| Breaking change | `feat!: redesign API` | **Minor** (0.1.0 → 0.2.0) | **Major** (1.0.0 → 2.0.0) |
+| Feature | `feat: add login` | **Minor** | **Minor** |
+| Fix | `fix: resolve crash` | **Patch** | **Patch** |
+| Everything else | `docs: update README` | No bump | No bump |
 
 ---
 
@@ -170,7 +169,8 @@ git tag -l -n99 v1.2.4
 
 New projects start at v0.0.0:
 
-- Features/fixes → Patch bump (0.0.0 → 0.0.1)
+- Features → Minor bump (0.0.0 → 0.1.0)
+- Fixes → Patch bump (0.0.0 → 0.0.1)
 - Breaking changes → Minor bump (0.0.0 → 0.1.0)
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logickernel/agileflow",
-  "version": "0.4.2",
+  "version": "0.13.0",
   "description": "Automatic semantic versioning and changelog generation based on conventional commits",
   "main": "src/index.js",
   "bin": {
@@ -35,6 +35,6 @@
     "type": "git",
     "url": "git@code.logickernel.com:kernel/agileflow.git"
   },
-  "author": "Víctor H. Valle <victor.valle@logickernel.com>",
+  "author": "Víctor Valle <victor.valle@logickernel.com>",
   "license": "ISC"
 }

package/src/gitlab-push.js

@@ -91,7 +91,7 @@ function createTagViaAPI(tagName, message, projectPath, serverHost, accessToken,
  * @param {string} message - The tag message
  * @returns {Promise<void>}
  */
-async function pushTag(tagName, message) {
+async function pushTag(tagName, message, quiet = false) {
   const accessToken = process.env.AGILEFLOW_TOKEN;
   const serverHost = process.env.CI_SERVER_HOST;
   const projectPath = process.env.CI_PROJECT_PATH;
@@ -128,6 +128,11 @@ async function pushTag(tagName, message) {
   }
   
   await createTagViaAPI(tagName, message || tagName, projectPath, serverHost, accessToken, commitSha);
+
+  if (!quiet) {
+    const commitUrl = `https://${process.env.CI_SERVER_HOST}/${process.env.CI_PROJECT_PATH}/-/commit/${process.env.CI_COMMIT_SHA}/pipelines`;
+    console.log(`Tag ${tagName} created and pushed successfully.\nView the build pipelines at: ${commitUrl}`);
+  }
 }
 
 module.exports = {

package/src/utils.js

@@ -72,8 +72,7 @@ function getCurrentBranch() {
 }
 
 // Conventional commit type configuration
-const TYPE_ORDER = ['feat', 'fix', 'perf', 'refactor', 'style', 'test', 'docs', 'build', 'ci', 'chore', 'revert'];
-const PATCH_TYPES = ['fix', 'perf', 'refactor', 'test', 'build', 'ci', 'revert'];
+const TYPE_ORDER = ['feat', 'fix', 'perf', 'refactor', 'style', 'test', 'build', 'ci', 'docs', 'chore', 'revert'];
 const SEMVER_PATTERN = /^v(\d+)\.(\d+)\.(\d+)(-[a-zA-Z0-9.-]+)?$/;
 
 // Friendly header names for changelog
@@ -208,19 +207,19 @@ function parseVersion(version) {
 
 /**
  * Determines version bump type based on commit analysis.
- * @param {{hasBreaking: boolean, hasFeat: boolean, hasPatchTypes: boolean}} analysis
+ * @param {{hasBreaking: boolean, hasFeat: boolean, hasFix: boolean}} analysis
  * @param {boolean} isPreOneZero - Whether current version is 0.x.x
  * @returns {'major'|'minor'|'patch'|'none'}
  */
 function determineVersionBumpType(analysis, isPreOneZero) {
-  const { hasBreaking, hasFeat, hasPatchTypes } = analysis;
+  const { hasBreaking, hasFeat, hasFix } = analysis;
   if (isPreOneZero) {
     if (hasBreaking || hasFeat) return 'minor';
-    if (hasPatchTypes) return 'patch';
+    if (hasFix) return 'patch';
   } else {
     if (hasBreaking) return 'major';
     if (hasFeat) return 'minor';
-    if (hasPatchTypes) return 'patch';
+    if (hasFix) return 'patch';
   }
   return 'none';
 }
@@ -255,12 +254,12 @@ function isBreakingChange(commit, parsed) {
 /**
  * Analyzes commits to determine version bump requirements.
  * @param {Array} commits - Array of commit objects
- * @returns {{hasBreaking: boolean, hasFeat: boolean, hasPatchTypes: boolean, commitsByType: Object, breakingCommits: Array}}
+ * @returns {{hasBreaking: boolean, hasFeat: boolean, hasFix: boolean, commitsByType: Object, breakingCommits: Array}}
  */
 function analyzeCommitsForVersioning(commits) {
   const commitsByType = Object.fromEntries(TYPE_ORDER.map(t => [t, []]));
   const breakingCommits = [];
-  let hasBreaking = false, hasFeat = false, hasPatchTypes = false;
+  let hasBreaking = false, hasFeat = false, hasFix = false;
   
   for (const commit of commits) {
     const parsed = parseConventionalCommit(commit.message);
@@ -275,7 +274,7 @@ function analyzeCommitsForVersioning(commits) {
     } else {
       // Only add to type sections if not breaking
       if (type === 'feat') hasFeat = true;
-      else if (PATCH_TYPES.includes(type)) hasPatchTypes = true;
+      else if (type === 'fix') hasFix = true;
       
       if (commitsByType[type]) {
         commitsByType[type].push(commit);
@@ -283,7 +282,7 @@ function analyzeCommitsForVersioning(commits) {
     }
   }
   
-  return { hasBreaking, hasFeat, hasPatchTypes, commitsByType, breakingCommits };
+  return { hasBreaking, hasFeat, hasFix, commitsByType, breakingCommits };
 }
 
 /**