sdg-agents 1.2.3 → 1.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdg-agents",
-  "version": "1.2.3",
+  "version": "1.4.0",
   "description": "Structured working protocol and engineering rules for AI agents. Works with Claude Code, Antigravity, Codex, and others.",
   "type": "module",
   "main": "./src/engine/bin/index.mjs",
@@ -14,7 +14,7 @@
     "dev": "node src/engine/bin/index.mjs",
     "build": "node src/engine/bin/build-bundle.mjs",
     "review": "node src/engine/bin/review-bundle.mjs",
-    "bump": "node src/engine/bin/auto-bump.mjs",
+    "bump": "node scripts/bump.mjs",
     "add-idiom": "node src/engine/bin/add-idiom.mjs",
     "clear": "node src/engine/bin/clear-bundle.mjs",
     "test": "node --test src/engine/lib/*.test.mjs",

package/src/assets/instructions/templates/bump.mjs

@@ -0,0 +1,90 @@
+/**
+ * SDG-Agents: Bump & Changelog Automation
+ * Automates semantic versioning and promotes Unreleased changes in CHANGELOG.md.
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+
+const ROOT_DIR = process.cwd();
+const PACKAGE_JSON_PATH = path.join(ROOT_DIR, 'package.json');
+const CHANGELOG_PATH = path.join(ROOT_DIR, 'CHANGELOG.md');
+
+function run() {
+  const args = process.argv.slice(2);
+  const bumpType = args[0]; // feat, fix, major
+
+  if (!['feat', 'fix', 'major'].includes(bumpType)) {
+    console.error('❌ Error: Please specify bump type (feat, fix, or major).');
+    console.log('Usage: npm run bump <feat|fix|major>');
+    process.exit(1);
+  }
+
+  const typeMap = {
+    feat: 'minor',
+    fix: 'patch',
+    major: 'major',
+  };
+
+  const npmType = typeMap[bumpType];
+
+  try {
+    // 1. Get current version
+    const pkg = JSON.parse(fs.readFileSync(PACKAGE_JSON_PATH, 'utf8'));
+    const oldVersion = pkg.version;
+
+    // 2. Bump version in package.json (no git tag/commit yet)
+    console.log(`🚀 Bumping version (${npmType})...`);
+    execSync(`npm version ${npmType} --no-git-tag-version`, { stdio: 'inherit' });
+
+    // 3. Get new version
+    const newPkg = JSON.parse(fs.readFileSync(PACKAGE_JSON_PATH, 'utf8'));
+    const newVersion = newPkg.version;
+
+    // 4. Update CHANGELOG.md
+    updateChangelog(newVersion);
+
+    console.log(`✅ Success: ${oldVersion} → ${newVersion}`);
+    console.log('🔗 CHANGELOG.md updated and promoted to current date.');
+  } catch (error) {
+    console.error('❌ Error during bump strategy:', error.message);
+    process.exit(1);
+  }
+}
+
+function updateChangelog(newVersion) {
+  if (!fs.existsSync(CHANGELOG_PATH)) {
+    console.warn('⚠️  CHANGELOG.md not found. Skipping changelog update.');
+    return;
+  }
+
+  const content = fs.readFileSync(CHANGELOG_PATH, 'utf8');
+  const today = new Date().toISOString().split('T')[0];
+
+  // Pattern to find the [Unreleased] section
+  // It handles both formats: ## [Unreleased] and ## [Unreleased] - YYYY-MM-DD
+  const unreleasedRegex = /##\s*\[Unreleased\](\s*-\s*\d{4}-\d{2}-\d{2})?/i;
+
+  if (!unreleasedRegex.test(content)) {
+    console.warn('⚠️  Could not find "## [Unreleased]" header in CHANGELOG.md.');
+    console.log('Skipping content promotion.');
+    return;
+  }
+
+  const newHeader = `## [${newVersion}] - ${today}`;
+
+  // 1. Promote Unreleased to New Version
+  let updatedContent = content.replace(unreleasedRegex, newHeader);
+
+  // 2. Inject new [Unreleased] block at the top
+  const insertIndex = updatedContent.indexOf(newHeader);
+  const nextBlock = `## [Unreleased]\n\n### Added\n\n### Fixed\n\n`;
+
+  updatedContent =
+    updatedContent.slice(0, insertIndex) + nextBlock + updatedContent.slice(insertIndex);
+
+  fs.writeFileSync(CHANGELOG_PATH, updatedContent);
+}
+
+run();

package/src/assets/instructions/templates/workflow.md

@@ -140,7 +140,8 @@ On every request, classify intent before acting:
 ### END Checklist (mandatory — execute in order, mark each before proceeding)
 
 - [ ] **SUMMARIZE** — one sentence per completed PLAN task written in response
-- [ ] **CHANGELOG** — Append entry. **Identify next version** (check \`package.json\`) to determine the header (\`## [NEXT_VERSION] - YYYY-MM-DD\` for releases/auto-bump, or \`## [Unreleased]\`). Categories: \`### Added\` (feat), \`### Fixed\` (fix).
+- [ ] **BUMP** — run \`npm run bump <feat|fix>\` to promote CHANGELOG and package.json version. Skip if not applicable.
+- [ ] **CHANGELOG** — Verify [Unreleased] content was promoted. Append any manual notes if needed.
 - [ ] **BACKLOG: tasks.md** — all completed tasks moved to `## Done` with `[DONE]` status
 - [ ] **BACKLOG: context.md** — \`## Now\` updated with next objective or cleared
 - [ ] **KNOWLEDGE** — Log any patterns, findings, or rework discovered during this cycle. Update \`.ai-backlog/learned.md\` (for successful feats) or \`.ai-backlog/troubleshoot.md\` (for fixed incidents). Curate stale or irrelevant items.

package/src/engine/bin/build-bundle.mjs

@@ -21,6 +21,7 @@ const {
   writeBacklogFiles,
   writeGitignore,
   writeManifest,
+  writeAutomationScripts,
 } = InstructionAssembler;
 const { success } = ResultUtils;
 const { runIfDirect } = FsUtils;
@@ -207,6 +208,7 @@ function executeQuickPipeline(targetDir, selections, { noDevGuides = false } = {
 
   printStep(5, 5, 'Injecting spec templates...');
   injectPrompts(targetDir, selections.track);
+  writeAutomationScripts(targetDir, selections);
   writeManifest(targetDir, selections, packageJson.version);
 }
 
@@ -239,6 +241,7 @@ function executeAgentsPipeline(targetDir, selections, { noDevGuides = false } =
   writeGitignore(targetDir);
 
   printStep(5, 5, 'Finalizing manifest...');
+  writeAutomationScripts(targetDir, selections);
   writeManifest(targetDir, selections, packageJson.version);
 }
 

package/src/engine/lib/cli-parser.mjs

@@ -17,6 +17,7 @@ function parseCliArgs(argv) {
     mode: getArgValue(argv, '--mode'),
     track: getArgValue(argv, '--track'),
     scope: getArgValue(argv, '--scope'),
+    bump: !argv.includes('--no-bump'),
   };
 }
 

package/src/engine/lib/instruction-assembler.mjs

@@ -528,6 +528,76 @@ function writeManifest(targetDir, selections, pkgVersion) {
   fs.writeFileSync(path.join(aiDir, '.sdg-manifest.json'), JSON.stringify(manifest, null, 2));
 }
 
+/**
+ * Injects automation scripts and configurations (Bump, Husky) if enabled.
+ * Idempotent: skips if scripts/bump.mjs exists or if selections.bump is false.
+ */
+function writeAutomationScripts(targetDir, selections) {
+  if (selections.bump === false) return;
+
+  const scriptsDir = path.join(targetDir, 'scripts');
+  const bumpScriptPath = path.join(scriptsDir, 'bump.mjs');
+
+  // 1. Check for existing bump script in package.json to avoid collision
+  const pkgPath = path.join(targetDir, 'package.json');
+  if (!fs.existsSync(pkgPath)) return;
+
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+  const hasExistingBump =
+    pkg.scripts && (pkg.scripts.bump || pkg.scripts.release || pkg.scripts.version);
+
+  if (hasExistingBump && !fs.existsSync(bumpScriptPath)) {
+    // If they have a script but not our file, we respect their script
+    return;
+  }
+
+  // 2. Write bump.mjs template
+  if (!fs.existsSync(bumpScriptPath)) {
+    if (!fs.existsSync(scriptsDir)) fs.mkdirSync(scriptsDir, { recursive: true });
+    const templatePath = path.join(SOURCE_INSTRUCTIONS, 'templates', 'bump.mjs');
+    const templateContent = fs.readFileSync(templatePath, 'utf8');
+    fs.writeFileSync(bumpScriptPath, templateContent);
+  }
+
+  // 3. Update package.json scripts
+  if (!pkg.scripts) pkg.scripts = {};
+  if (!pkg.scripts.bump) {
+    pkg.scripts.bump = 'node scripts/bump.mjs';
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+  }
+
+  // 4. Configure Husky if .husky exists
+  const huskyDir = path.join(targetDir, '.husky');
+  if (fs.existsSync(huskyDir)) {
+    const prePushPath = path.join(huskyDir, 'pre-push');
+    const nvmShim = dedent`
+      # NVM Shim (Essential for projects Staff in Linux/NVM)
+      export NVM_DIR="$HOME/.nvm"
+      [ -s "$NVM_DIR/nvm.sh" ] && \\. "$NVM_DIR/nvm.sh"
+    `;
+
+    const bumpCmd = 'npm run bump fix';
+
+    if (fs.existsSync(prePushPath)) {
+      const content = fs.readFileSync(prePushPath, 'utf8');
+      if (!content.includes('npm run bump')) {
+        const separator = content.endsWith('\n') ? '' : '\n';
+        fs.appendFileSync(prePushPath, `${separator}\n${nvmShim}\n${bumpCmd}\n`);
+      }
+    } else {
+      const prePushContent = dedent`
+        #!/usr/bin/env sh
+        . "$(dirname -- "$0")/_/husky.sh"
+
+        ${nvmShim}
+
+        ${bumpCmd}
+      `;
+      fs.writeFileSync(prePushPath, prePushContent, { mode: 0o755 });
+    }
+  }
+}
+
 const InstructionAssembler = {
   buildMasterInstructions,
   buildClaudeContent,
@@ -536,6 +606,7 @@ const InstructionAssembler = {
   writeBacklogFiles,
   writeGitignore,
   writeManifest,
+  writeAutomationScripts,
 };
 
 export { InstructionAssembler };

package/src/engine/lib/wizard.mjs

@@ -33,7 +33,7 @@ async function gatherUserSelections(targetDir = process.cwd()) {
   let scope = 'fullstack';
   let step = 0;
 
-  const finalStep = () => (selections.mode === 'prompts' ? 2 : 8);
+  const finalStep = () => (selections.mode === 'prompts' ? 2 : 9);
 
   while (step < finalStep()) {
     const context = {
@@ -74,6 +74,7 @@ async function gatherUserSelections(targetDir = process.cwd()) {
     if (stepValue.ide) currentSelections.ide = stepValue.ide;
     if (stepValue.undoLastIdiom) currentSelections.idioms.pop();
     if (stepValue.resetIdioms) currentSelections.idioms = [];
+    if (stepValue.bump !== undefined) currentSelections.bump = stepValue.bump;
     return nextScope;
   }
 }
@@ -98,8 +99,10 @@ async function executeWizardStep(step, context) {
       return promptDesignPreset(context);
     case 7:
       return promptIdeSelection();
+    case 8:
+      return promptBumpAutomation(context);
     default: {
-      const defaultResult = success({ nextStep: 8 });
+      const defaultResult = success({ nextStep: 9 });
       return defaultResult;
     }
   }
@@ -393,6 +396,24 @@ async function promptIdeSelection() {
   return ideResult;
 }
 
+async function promptBumpAutomation(context) {
+  const { selections } = context;
+
+  const hasJsTs = selections.idioms.some((id) => id === 'javascript' || id === 'typescript');
+
+  if (!hasJsTs) {
+    return success({ nextStep: 9, bump: false });
+  }
+
+  const result = await safeConfirm({
+    message: 'Enable automated versioning (Bump & Changelog)?',
+    default: true,
+  });
+
+  const bumpResult = success({ nextStep: 9, bump: result });
+  return bumpResult;
+}
+
 function validateSelections(selections) {
   if (selections.mode === 'quick') {
     selections.flavor = selections.flavor || 'lite';