@logickernel/agileflow 0.4.1 → 0.12.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"'

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"'

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logickernel/agileflow",
-  "version": "0.4.1",
+  "version": "0.12.0",
   "description": "Automatic semantic versioning and changelog generation based on conventional commits",
   "main": "src/index.js",
   "bin": {

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

@@ -52,18 +52,27 @@ function ensureGitRepo() {
 /**
  * Gets the current branch name.
  * @returns {string} Current branch name
- * @throws {Error} If in detached HEAD state
+ * @throws {Error} If in detached HEAD state and no CI environment variable is available
  */
 function getCurrentBranch() {
   const branch = runWithOutput('git branch --show-current').trim();
-  if (!branch) {
-    throw new Error('Repository is in a detached HEAD state. Please check out a branch and try again.');
+  if (branch) {
+    return branch;
   }
-  return branch;
+  
+  // Handle detached HEAD state (common in CI environments)
+  // GitLab CI provides CI_COMMIT_BRANCH (for branches) or CI_COMMIT_REF_NAME (for branches/tags)
+  // GitHub Actions provides GITHUB_REF_NAME (for branches/tags)
+  const ciBranch = process.env.CI_COMMIT_BRANCH || process.env.CI_COMMIT_REF_NAME || process.env.GITHUB_REF_NAME;
+  if (ciBranch) {
+    return ciBranch;
+  }
+  
+  throw new Error('Repository is in a detached HEAD state. Please check out a branch and try again.');
 }
 
 // Conventional commit type configuration
-const TYPE_ORDER = ['feat', 'fix', 'perf', 'refactor', 'style', 'test', 'docs', 'build', 'ci', 'chore', 'revert'];
+const TYPE_ORDER = ['feat', 'fix', 'perf', 'refactor', 'style', 'test', 'build', 'ci', 'docs', 'chore', 'revert'];
 const PATCH_TYPES = ['fix', 'perf', 'refactor', 'test', 'build', 'ci', 'revert'];
 const SEMVER_PATTERN = /^v(\d+)\.(\d+)\.(\d+)(-[a-zA-Z0-9.-]+)?$/;
 
@@ -375,17 +384,25 @@ function calculateNextVersionAndChangelog(expandedInfo) {
  * @returns {Array<{hash: string, datetime: string, author: string, message: string, tags: Array<string>}>}
  */
 function getAllBranchCommits(branch) {
+  // Try to resolve the branch (may be a local branch or remote branch like origin/main)
+  let branchRef = branch;
   try {
     runWithOutput(`git rev-parse --verify ${branch}`);
   } catch {
-    return [];
+    // Try with origin/ prefix (common in CI environments where local branch doesn't exist)
+    try {
+      runWithOutput(`git rev-parse --verify origin/${branch}`);
+      branchRef = `origin/${branch}`;
+    } catch {
+      return [];
+    }
   }
   
   const RS = '\x1E';
   const COMMIT_SEP = `${RS}${RS}`;
   
   try {
-    const logCmd = `git log --format=%H${RS}%ai${RS}%an${RS}%B${COMMIT_SEP} ${branch}`;
+    const logCmd = `git log --format=%H${RS}%ai${RS}%an${RS}%B${COMMIT_SEP} ${branchRef}`;
     const output = runWithOutput(logCmd).trim();
     if (!output) return [];