@logickernel/agileflow 0.14.0 → 0.14.1

package/README.md

@@ -165,12 +165,13 @@ After 1.0.0, AgileFlow continues automatic versioning with standard semantic ver
 
 AgileFlow analyzes commits since the last version tag to determine the appropriate version 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 |
+| Commit Type | Example | Changelog | 0.x.x | 1.0.0+ |
+|-------------|---------|-----------|-------|--------|
+| Breaking change | `feat!: redesign API` | Add entry | **Minor** (0.1.0 → 0.2.0) | **Major** (1.0.0 → 2.0.0) |
+| Feature | `feat: add login` | Add entry | **Minor** | **Minor** |
+| Fix | `fix: resolve crash` | Add entry | **Patch** | **Patch** |
+| Chore | `chore: update dependencies` | **No** entry | No bump | No bump |
+| Everything else | `docs: update README` | Add entry | No bump | No bump |
 
 ---
 

package/docs/configuration.md

@@ -74,23 +74,21 @@ jobs:
       - name: Create version tag
         env:
           AGILEFLOW_TOKEN: ${{ secrets.AGILEFLOW_TOKEN }}
-        run: npx @logickernel/agileflow github
+        run: agileflow github
 ```
 
 ### GitLab CI
 
 ```yaml
 agileflow:
-  stage: version
-  image: node:20-alpine
+  image: node:20
   script:
-    - VERSION=$(npx @logickernel/agileflow gitlab --quiet)
-    - echo "VERSION=$VERSION" >> version.env
-  artifacts:
-    reports:
-      dotenv: version.env
-  only:
-    - main
+    - npm install -g @logickernel/agileflow
+    - agileflow gitlab
+  rules:
+    - if: '$CI_COMMIT_BRANCH == "main"'
+  tags:
+    - agileflow
 ```
 
 ---

package/docs/conventional-commits.md

@@ -39,10 +39,10 @@ flowchart TD
   A -- "no" --> B{Does it fix functionality?}
 
   B -- "yes" --> X[fix:]
-  B -- "no" --> C{Is it work in progress?}
+  B -- "no" --> C{Is it worth an entry in the changelog?}
 
-  C -- "yes" --> W[wip:]
-  C -- "no" --> D[Choose best: docs, ci, style, chore, etc.]
+  C -- "yes" --> W[Choose best: docs, ci, style, etc.]
+  C -- "no" --> D[chore:]
 
   W --> E{Is it a breaking change?}
   F --> E
@@ -221,7 +221,17 @@ feat: add user authentication
 feat: added user authentication
 ```
 
-5. Add Meaningful Scopes when applicable
+5. Use Chore for *work in progress*
+
+```bash
+# ✅ Use chore so an entry is not added to the changelog
+chore: add framework for form validation
+
+# ❌ Used something else that will add a meaningless entry to the changelog
+refactor: add framework for form validation
+```
+
+6. Add Meaningful Scopes when applicable
 
 ```bash
 # ✅ Helpful scope

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logickernel/agileflow",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "Automatic semantic versioning and changelog generation based on conventional commits",
   "main": "src/index.js",
   "bin": {
@@ -24,6 +24,7 @@
     "versioning",
     "git",
     "ci-cd",
+    "github",
     "gitlab",
     "automation",
     "release-management"

package/src/git-push.js

@@ -10,9 +10,10 @@ const os = require('os');
  * Uses native git commands - requires git credentials to be configured.
  * @param {string} tagName - The tag name (e.g., "v1.2.3")
  * @param {string} message - The tag message (changelog)
+ * @param {boolean} quiet - If true, suppress success message
  * @returns {Promise<void>}
  */
-async function pushTag(tagName, message) {
+async function pushTag(tagName, message, quiet = false) {
   const safeTag = String(tagName).replace(/"/g, '\\"');
   
   // Write message to a temp file to avoid shell escaping issues with special characters
@@ -25,6 +26,10 @@ async function pushTag(tagName, message) {
     
     // Push to origin
     execSync(`git push origin "${safeTag}"`, { stdio: 'pipe' });
+    
+    if (!quiet) {
+      console.log(`Tag ${tagName} created and pushed successfully.`);
+    }
   } finally {
     // Clean up temp file
     try {

package/src/github-push.js

@@ -122,9 +122,10 @@ function makeRequest({ method, path, accessToken, body }) {
  * Uses GITHUB_REPOSITORY and GITHUB_SHA from GitHub Actions environment.
  * @param {string} tagName - The tag name
  * @param {string} message - The tag message
+ * @param {boolean} quiet - If true, suppress success message
  * @returns {Promise<void>}
  */
-async function pushTag(tagName, message) {
+async function pushTag(tagName, message, quiet = false) {
   const accessToken = process.env.AGILEFLOW_TOKEN;
   const repository = process.env.GITHUB_REPOSITORY;
   const commitSha = process.env.GITHUB_SHA;
@@ -148,6 +149,10 @@ async function pushTag(tagName, message) {
   }
   
   await createTagViaAPI(tagName, message || tagName, repository, accessToken, commitSha);
+  
+  if (!quiet) {
+    console.log(`Tag ${tagName} created and pushed successfully.`);
+  }
 }
 
 module.exports = {

package/src/index.js

@@ -125,11 +125,7 @@ async function handlePushCommand(pushType, options) {
     console.log(`\nCreating tag ${info.newVersion}...`);
   }
   
-  await pushModule.pushTag(info.newVersion, tagMessage);
-  
-  if (!options.quiet) {
-    console.log(`Tag ${info.newVersion} created and pushed successfully.`);
-  }
+  await pushModule.pushTag(info.newVersion, tagMessage, options.quiet);
 }
 
 async function main() {