aiwg 2026.1.5 → 2026.1.6

package/CLAUDE.md

@@ -190,7 +190,9 @@ Before pushing a version tag:
 
 ### Version Format
 
-- **CalVer**: `YYYY.MM.PATCH` (e.g., `2026.01.3`)
+- **CalVer**: `YYYY.M.PATCH` (e.g., `2026.1.5`, `2026.12.0`)
+- **CRITICAL**: No leading zeros! npm semver rejects `01`, `02`, etc.
 - PATCH resets each month
-- Tag format: `vYYYY.MM.PATCH` (e.g., `v2026.01.3`)
+- Tag format: `vYYYY.M.PATCH` (e.g., `v2026.1.5`)
+- See `@docs/contributing/versioning.md` for full details
 

package/docs/contributing/versioning.md

@@ -0,0 +1,196 @@
+# Versioning Guide
+
+**Version:** 1.0
+**Last Updated:** 2026-01-14
+**Target Audience:** All contributors and AI agents
+
+## Overview
+
+AIWG uses **Calendar Versioning (CalVer)** with npm-compatible format. This document explains the versioning scheme and critical rules to avoid npm publishing failures.
+
+## Version Format
+
+```
+YYYY.M.PATCH
+```
+
+| Component | Description | Example |
+|-----------|-------------|---------|
+| `YYYY` | Four-digit year | `2026` |
+| `M` | Month (1-12, **NO leading zeros**) | `1`, `12` |
+| `PATCH` | Patch number within month (resets each month) | `0`, `1`, `5` |
+
+### Examples
+
+| Correct | Incorrect | Why |
+|---------|-----------|-----|
+| `2026.1.0` | `2026.01.0` | Leading zero in month |
+| `2026.1.5` | `2026.01.05` | Leading zeros in month and patch |
+| `2026.12.0` | `2026.12.00` | Leading zero in patch |
+
+## Critical Rule: No Leading Zeros
+
+**npm's semver parser rejects leading zeros.** This is per the [Semantic Versioning spec](https://semver.org/):
+
+> A normal version number MUST take the form X.Y.Z where X, Y, and Z are non-negative integers, and **MUST NOT contain leading zeroes**.
+
+### What Happens With Leading Zeros
+
+```bash
+# This FAILS
+$ npm -g update aiwg
+npm error Invalid Version: 2026.01.4
+
+# This WORKS (same package, different command)
+$ npm -g install aiwg
+# Installs successfully but update is broken
+```
+
+The `npm install` command is more lenient than `npm update`. Users will be able to install but not update, causing confusion and support issues.
+
+## Tag Format
+
+Git tags should match the version with a `v` prefix:
+
+```bash
+# Correct
+git tag -a v2026.1.5 -m "v2026.1.5 - Feature Name"
+
+# Incorrect
+git tag -a v2026.01.5 -m "v2026.01.5 - Feature Name"
+```
+
+## Release Workflow
+
+### 1. Update package.json
+
+```json
+{
+  "version": "2026.1.5"
+}
+```
+
+**Validation**: Run this to check for leading zeros:
+
+```bash
+grep '"version"' package.json | grep -E '\.[0-9]{2}\.' && echo "ERROR: Leading zero detected!" || echo "OK: No leading zeros"
+```
+
+### 2. Update CHANGELOG.md
+
+```markdown
+## [2026.1.5] - 2026-01-14 – "Release Name"
+```
+
+### 3. Create and Push Tag
+
+```bash
+# Create annotated tag
+git tag -a v2026.1.5 -m "v2026.1.5 - Release Name"
+
+# Push to both remotes
+git push origin main --tags
+git push github main --tags
+```
+
+### 4. Verify Published Version
+
+After CI/CD completes:
+
+```bash
+npm view aiwg version
+# Should show: 2026.1.5
+```
+
+## Version Progression Examples
+
+### Within a Month
+
+```
+2026.1.0  → First release in January 2026
+2026.1.1  → Bug fix
+2026.1.2  → Another fix
+2026.1.3  → Feature addition
+```
+
+### Month Transitions
+
+```
+2026.1.5  → Last release in January
+2026.2.0  → First release in February (PATCH resets)
+2026.2.1  → Next release in February
+```
+
+### Year Transitions
+
+```
+2026.12.3 → December release
+2027.1.0  → January of next year
+```
+
+## Automated Validation
+
+### Pre-commit Hook (Optional)
+
+Add to `.git/hooks/pre-commit`:
+
+```bash
+#!/bin/bash
+VERSION=$(grep '"version"' package.json | head -1)
+if echo "$VERSION" | grep -qE '\.[0-9]{2}\.'; then
+  echo "ERROR: package.json version has leading zeros!"
+  echo "Found: $VERSION"
+  echo "Fix: Remove leading zeros (e.g., 2026.01.5 → 2026.1.5)"
+  exit 1
+fi
+```
+
+### CI Validation
+
+The npm publish workflow will fail if the version has leading zeros, but it's better to catch this before pushing.
+
+## Common Mistakes
+
+### Mistake 1: Copy-Paste from Dates
+
+```bash
+# Today is January 5, 2026
+# WRONG: Using date format
+2026.01.05
+
+# RIGHT: Using CalVer format
+2026.1.5
+```
+
+### Mistake 2: Assuming Two-Digit Month
+
+```bash
+# WRONG: Padding single-digit months
+2026.01.0, 2026.02.0, ..., 2026.09.0
+
+# RIGHT: No padding
+2026.1.0, 2026.2.0, ..., 2026.9.0
+```
+
+### Mistake 3: Incrementing Without Checking Format
+
+When bumping versions, always verify the format:
+
+```bash
+# Before: 2026.1.4
+# Bumping patch...
+
+# WRONG (if you typed it manually)
+"version": "2026.01.5"
+
+# RIGHT
+"version": "2026.1.5"
+```
+
+## References
+
+- [Semantic Versioning 2.0.0](https://semver.org/)
+- [Calendar Versioning](https://calver.org/)
+- [npm semver](https://docs.npmjs.com/cli/v6/using-npm/semver)
+- @CLAUDE.md - Release Documentation Requirements
+- @docs/contributing/ci-cd-secrets.md - CI/CD configuration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiwg",
-  "version": "2026.01.5",
+  "version": "2026.1.6",
   "description": "Modular agentic framework for AI-powered SDLC, marketing automation, and workflow orchestration",
   "type": "module",
   "bin": {

package/tools/agents/deploy-windsurf.mjs

@@ -606,17 +606,24 @@ async function main() {
   // Collect agent files based on mode
   const agentFiles = [];
 
-  // Writing/General agents
-  if (mode === 'general' || mode === 'writing' || mode === 'both' || mode === 'all') {
-    const writingAddonAgentsRoot = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'agents');
-    const legacyAgentsRoot = path.join(srcRoot, 'agents');
-    const agentsRoot = fs.existsSync(writingAddonAgentsRoot) ? writingAddonAgentsRoot : legacyAgentsRoot;
-
-    if (fs.existsSync(agentsRoot)) {
-      const files = listMdFiles(agentsRoot);
-      if (files.length > 0) {
-        console.log(`Found ${files.length} writing/general agents`);
-        agentFiles.push(...files);
+  // All addons (dynamically discovered)
+  if (mode === 'general' || mode === 'writing' || mode === 'sdlc' || mode === 'both' || mode === 'all') {
+    const addonsRoot = path.join(srcRoot, 'agentic', 'code', 'addons');
+    if (fs.existsSync(addonsRoot)) {
+      let addonAgentCount = 0;
+      const addonDirs = fs.readdirSync(addonsRoot, { withFileTypes: true })
+        .filter(e => e.isDirectory())
+        .map(e => path.join(addonsRoot, e.name, 'agents'));
+
+      for (const addonAgentsDir of addonDirs) {
+        if (fs.existsSync(addonAgentsDir)) {
+          const files = listMdFiles(addonAgentsDir);
+          agentFiles.push(...files);
+          addonAgentCount += files.length;
+        }
+      }
+      if (addonAgentCount > 0) {
+        console.log(`Found ${addonAgentCount} addon agents`);
       }
     }
   }
@@ -693,6 +700,20 @@ async function main() {
   // Collect skills count for .windsurfrules
   let skillCount = 0;
   if (deploySkills) {
+    // Addon skills (dynamically discovered)
+    const addonsRoot = path.join(srcRoot, 'agentic', 'code', 'addons');
+    if (fs.existsSync(addonsRoot)) {
+      const addonDirs = fs.readdirSync(addonsRoot, { withFileTypes: true })
+        .filter(e => e.isDirectory())
+        .map(e => path.join(addonsRoot, e.name, 'skills'));
+
+      for (const addonSkillsDir of addonDirs) {
+        if (fs.existsSync(addonSkillsDir)) {
+          skillCount += listSkillDirs(addonSkillsDir).length;
+        }
+      }
+    }
+
     // SDLC skills
     if (mode === 'sdlc' || mode === 'both' || mode === 'all') {
       const sdlcSkillsRoot = path.join(srcRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'skills');
@@ -701,16 +722,9 @@ async function main() {
       }
     }
 
-    // Utils addon skills
-    const utilsSkillsRoot = path.join(srcRoot, 'agentic', 'code', 'addons', 'aiwg-utils', 'skills');
-    if (fs.existsSync(utilsSkillsRoot)) {
-      skillCount += listSkillDirs(utilsSkillsRoot).length;
-    }
-
     if (skillCount > 0) {
       console.log(`\n[NOTE] Skills (${skillCount} found) are not directly deployed to Windsurf.`);
-      console.log('Reference skill files in prompts using @-mentions:');
-      console.log('  @~/.local/share/ai-writing-guide/agentic/code/addons/aiwg-utils/skills/<skill>/SKILL.md');
+      console.log('Reference skill files in prompts using @-mentions.');
     }
   }
 

package/tools/commands/deploy-prompts-codex.mjs

@@ -201,6 +201,22 @@ function getCommandDirectories(srcRoot, mode) {
     }
   }
 
+  // Addon commands (dynamically discovered)
+  if (mode === 'general' || mode === 'sdlc' || mode === 'both' || mode === 'all') {
+    const addonsRoot = path.join(srcRoot, 'agentic', 'code', 'addons');
+    if (fs.existsSync(addonsRoot)) {
+      const addonDirs = fs.readdirSync(addonsRoot, { withFileTypes: true })
+        .filter(e => e.isDirectory())
+        .map(e => path.join(addonsRoot, e.name, 'commands'));
+
+      for (const addonCommandsDir of addonDirs) {
+        if (fs.existsSync(addonCommandsDir)) {
+          dirs.push({ dir: addonCommandsDir, label: path.basename(path.dirname(addonCommandsDir)) });
+        }
+      }
+    }
+  }
+
   // SDLC framework commands
   if (mode === 'sdlc' || mode === 'both' || mode === 'all') {
     const sdlcCommandsDir = path.join(srcRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'commands');

package/tools/rules/deploy-rules-cursor.mjs

@@ -241,6 +241,22 @@ function getCommandDirectories(srcRoot, mode) {
     }
   }
 
+  // Addon commands (dynamically discovered)
+  if (mode === 'general' || mode === 'sdlc' || mode === 'both' || mode === 'all') {
+    const addonsRoot = path.join(srcRoot, 'agentic', 'code', 'addons');
+    if (fs.existsSync(addonsRoot)) {
+      const addonDirs = fs.readdirSync(addonsRoot, { withFileTypes: true })
+        .filter(e => e.isDirectory())
+        .map(e => path.join(addonsRoot, e.name, 'commands'));
+
+      for (const addonCommandsDir of addonDirs) {
+        if (fs.existsSync(addonCommandsDir)) {
+          dirs.push({ dir: addonCommandsDir, label: path.basename(path.dirname(addonCommandsDir)) });
+        }
+      }
+    }
+  }
+
   // SDLC framework commands
   if (mode === 'sdlc' || mode === 'both' || mode === 'all') {
     const sdlcCommandsDir = path.join(srcRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'commands');

package/tools/warp/setup-warp.mjs

@@ -279,6 +279,21 @@ function generateAIWGContent(aiwgRoot, mode) {
       agentPaths.push(...listMdFiles(generalAgents));
     }
   }
+
+  // Addon agents (dynamically discovered)
+  const addonsRoot = path.join(aiwgRoot, 'agentic', 'code', 'addons');
+  if (fs.existsSync(addonsRoot)) {
+    const addonDirs = fs.readdirSync(addonsRoot, { withFileTypes: true })
+      .filter(e => e.isDirectory())
+      .map(e => path.join(addonsRoot, e.name, 'agents'));
+
+    for (const addonAgentsDir of addonDirs) {
+      if (fs.existsSync(addonAgentsDir)) {
+        agentPaths.push(...listMdFiles(addonAgentsDir));
+      }
+    }
+  }
+
   if (mode === 'sdlc' || mode === 'both') {
     const sdlcAgents = path.join(aiwgRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'agents');
     if (fs.existsSync(sdlcAgents)) {
@@ -304,6 +319,20 @@ function generateAIWGContent(aiwgRoot, mode) {
       commandPaths.push(...listMdFiles(generalCommands));
     }
   }
+
+  // Addon commands (dynamically discovered)
+  if (fs.existsSync(addonsRoot)) {
+    const addonCommandDirs = fs.readdirSync(addonsRoot, { withFileTypes: true })
+      .filter(e => e.isDirectory())
+      .map(e => path.join(addonsRoot, e.name, 'commands'));
+
+    for (const addonCommandsDir of addonCommandDirs) {
+      if (fs.existsSync(addonCommandsDir)) {
+        commandPaths.push(...listMdFiles(addonCommandsDir));
+      }
+    }
+  }
+
   if (mode === 'sdlc' || mode === 'both') {
     const sdlcCommands = path.join(aiwgRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'commands');
     if (fs.existsSync(sdlcCommands)) {