@programinglive/commiter 1.0.6 → 1.0.10

package/.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: Publish to NPM
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test
+
+      - name: Publish to NPM
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.COMMITER_TOKEN }}

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [1.0.10](https://github.com/programinglive/commiter/compare/v1.0.9...v1.0.10) (2025-10-29)
+
+### [1.0.9](https://github.com/programinglive/commiter/compare/v1.0.8...v1.0.9) (2025-10-29)
+
+
+### ✨ Features
+
+* add new feature ([e1603c1](https://github.com/programinglive/commiter/commit/e1603c144823dd54f077de3f16c5c764d2066fe7))
+
+### [1.0.8](https://github.com/programinglive/commiter/compare/v1.0.7...v1.0.8) (2025-10-29)
+
+
+### ✨ Features
+
+* add release helper script and tests ([085af63](https://github.com/programinglive/commiter/commit/085af631d2c53725f125d0f48b1221bc81830288))
+
+### [1.0.7](https://github.com/programinglive/commiter/compare/v1.0.6...v1.0.7) (2025-10-29)
+
+
+### ✨ Features
+
+* add release helper script and tests ([93f4235](https://github.com/programinglive/commiter/commit/93f4235c3cf2e34b77b78ba51c0337cf89e564df))
+
 ### [1.0.6](https://github.com/programinglive/commiter/compare/v1.0.5...v1.0.6) (2025-10-19)
 
 ### [1.0.5](https://github.com/programinglive/commiter/compare/v1.0.4...v1.0.5) (2025-10-19)

package/PUBLISH.md

@@ -72,6 +72,7 @@ npm publish
 
 ## Automated Release Workflow
 
+### Option 1: Manual Publishing (Traditional)
 1. Make changes and commit using conventional commits
 2. Run the appropriate release command
 3. Push to GitHub with tags
@@ -93,6 +94,31 @@ git push --follow-tags origin main
 npm publish
 ```
 
+### Option 2: Automated Publishing (Recommended)
+1. Make changes and commit using conventional commits
+2. Run the appropriate release command
+3. Push to GitHub with tags - **npm publishing happens automatically**
+
+Example:
+```bash
+# Make changes
+git add .
+git commit -m "feat(cli): add interactive setup wizard"
+
+# Create release
+npm run release:minor
+
+# Push to GitHub (triggers automatic npm publish)
+git push --follow-tags origin main
+```
+
+**Setup Required for Automated Publishing:**
+1. Add `NPM_TOKEN` secret to your GitHub repository
+2. The GitHub Actions workflow (`.github/workflows/publish.yml`) will automatically:
+   - Run tests
+   - Publish to npm when a tag starting with `v` is pushed
+   - Use the `--access public` flag for scoped packages
+
 ## Unpublishing (Emergency Only)
 
 If you need to unpublish a version within 72 hours:

package/index.js

@@ -42,10 +42,10 @@ function setupCommiter() {
     packageJson.scripts = ensureSafeTestScript(packageJson.scripts || {});
     // Add scripts
     packageJson.scripts.prepare = 'husky';
-    packageJson.scripts.release = 'standard-version';
-    packageJson.scripts['release:major'] = 'npm run release -- --release-as major';
-    packageJson.scripts['release:minor'] = 'npm run release -- --release-as minor';
-    packageJson.scripts['release:patch'] = 'npm run release -- --release-as patch';
+    packageJson.scripts.release = 'node scripts/release.js';
+    packageJson.scripts['release:major'] = 'node scripts/release.js major';
+    packageJson.scripts['release:minor'] = 'node scripts/release.js minor';
+    packageJson.scripts['release:patch'] = 'node scripts/release.js patch';
 
     // Add standard-version config
     packageJson['standard-version'] = {
@@ -68,6 +68,24 @@ function setupCommiter() {
     // Write updated package.json
     fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
 
+    // Create release helper script
+    console.log('🛠️  Creating release helper script...');
+    const releaseScriptDir = path.join(process.cwd(), 'scripts');
+    if (!fs.existsSync(releaseScriptDir)) {
+      fs.mkdirSync(releaseScriptDir, { recursive: true });
+    }
+
+    const releaseScriptPath = path.join(releaseScriptDir, 'release.js');
+    const releaseScriptSource = path.join(__dirname, 'scripts', 'release.js');
+    const releaseScriptContent = fs.readFileSync(releaseScriptSource, 'utf8');
+
+    fs.writeFileSync(releaseScriptPath, releaseScriptContent + '\n');
+    try {
+      fs.chmodSync(releaseScriptPath, 0o755);
+    } catch (error) {
+      // Ignore chmod errors on non-POSIX systems
+    }
+
     // Determine commitlint config format based on project module type
     const isEsmProject = packageJson.type === 'module';
     const commitlintConfigFile = isEsmProject ? 'commitlint.config.js' : 'commitlint.config.cjs';
@@ -108,10 +126,11 @@ npx --no -- commitlint --edit "$1"
 
     console.log('\n✅ Commiter setup complete!\n');
     console.log('📚 Available commands:');
-    console.log('  npm run release:major  - Create a major release (1.0.0 → 2.0.0)');
-    console.log('  npm run release:minor  - Create a minor release (1.0.0 → 1.1.0)');
-    console.log('  npm run release:patch  - Create a patch release (1.0.0 → 1.0.1)');
-    console.log('  npm run release        - Auto-detect version bump\n');
+    console.log('  npm run release major  - Create a major release (1.0.0 → 2.0.0)');
+    console.log('  npm run release minor  - Create a minor release (1.0.0 → 1.1.0)');
+    console.log('  npm run release patch  - Create a patch release (1.0.0 → 1.0.1)');
+    console.log('  npm run release        - Auto-detect version bump');
+    console.log('  npm run release -- --prerelease beta  - Create a beta prerelease\n');
     console.log('🎯 Commit format: type(scope): subject');
     console.log('   Example: feat(auth): add user login\n');
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@programinglive/commiter",
-  "version": "1.0.6",
+  "version": "1.0.10",
   "description": "Commit convention tooling for standard-version releases with beautiful changelogs",
   "main": "index.js",
   "bin": {
@@ -9,10 +9,10 @@
   "scripts": {
     "test": "node test/ensureSafeTestScript.test.js",
     "prepare": "husky",
-    "release": "standard-version",
-    "release:major": "npm run release -- --release-as major",
-    "release:minor": "npm run release -- --release-as minor",
-    "release:patch": "npm run release -- --release-as patch"
+    "release": "node scripts/release.js",
+    "release:major": "node scripts/release.js major",
+    "release:minor": "node scripts/release.js minor",
+    "release:patch": "node scripts/release.js patch"
   },
   "keywords": [
     "commit",

package/scripts/release.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require('child_process');
+
+const VALID_RELEASE_TYPES = new Set([
+  'major',
+  'minor',
+  'patch',
+  'premajor',
+  'preminor',
+  'prepatch',
+  'prerelease'
+]);
+
+const SEMVER_REGEX = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
+
+function getCliArguments(argv = process.argv) {
+  const rawArgs = argv.slice(2);
+  if (rawArgs.length === 0) {
+    return { releaseType: undefined, extraArgs: [] };
+  }
+
+  if (rawArgs[0].startsWith('-')) {
+    return { releaseType: undefined, extraArgs: rawArgs };
+  }
+
+  const [firstArg, ...rest] = rawArgs;
+  return { releaseType: firstArg, extraArgs: rest };
+}
+
+function getNpmRunArgument(env = process.env) {
+  try {
+    const npmArgs = JSON.parse(env.npm_config_argv || '{}');
+    const original = npmArgs.original || [];
+    const releaseIndex = original.lastIndexOf('release');
+    if (releaseIndex !== -1) {
+      return original[releaseIndex + 1];
+    }
+  } catch (error) {
+    // Ignore JSON parsing issues and fall back to defaults
+  }
+  return undefined;
+}
+
+function buildStandardVersionArgs({ releaseType, extraArgs }) {
+  const args = [];
+  if (releaseType) {
+    const normalized = releaseType.trim();
+    const isValid = VALID_RELEASE_TYPES.has(normalized) || SEMVER_REGEX.test(normalized);
+    if (!isValid) {
+      const allowed = Array.from(VALID_RELEASE_TYPES).join(', ');
+      throw new Error(`Unknown release type "${normalized}". Use one of ${allowed} or a valid semver version.`);
+    }
+    args.push('--release-as', normalized);
+  }
+
+  if (Array.isArray(extraArgs) && extraArgs.length > 0) {
+    args.push(...extraArgs);
+  }
+
+  return args;
+}
+
+function runRelease({ argv = process.argv, env = process.env, spawn = spawnSync } = {}) {
+  const { releaseType: cliReleaseType, extraArgs } = getCliArguments(argv);
+  const inferredReleaseType = cliReleaseType || getNpmRunArgument(env);
+  const standardVersionArgs = buildStandardVersionArgs({
+    releaseType: inferredReleaseType,
+    extraArgs
+  });
+
+  const standardVersionBin = require.resolve('standard-version/bin/cli.js');
+  return spawn(process.execPath, [standardVersionBin, ...standardVersionArgs], {
+    stdio: 'inherit'
+  });
+}
+
+if (require.main === module) {
+  try {
+    const result = runRelease();
+    if (result.status !== 0) {
+      process.exit(result.status ?? 1);
+    }
+  } catch (error) {
+    console.error(`❌ ${error.message}`);
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  VALID_RELEASE_TYPES,
+  SEMVER_REGEX,
+  getCliArguments,
+  getNpmRunArgument,
+  buildStandardVersionArgs,
+  runRelease
+};