@programinglive/commiter 1.1.8 → 1.1.10

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 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.1.10](https://github.com/programinglive/commiter/compare/v1.1.9...v1.1.10) (2025-11-26)
+
+
+### ✨ Features
+
+* **website:** add professional landing page and release tools ([ec53e2d](https://github.com/programinglive/commiter/commit/ec53e2d5d2d1d61d899ba0349cb6771bb9e57385))
+
+### [1.1.9](https://github.com/programinglive/commiter/compare/v1.1.8...v1.1.9) (2025-11-24)
+
+
+### 🐛 Bug Fixes
+
+* convert release scripts to CJS to support ESM projects ([842da02](https://github.com/programinglive/commiter/commit/842da0298f1c4df7aa93b43ca8698e3669ef6450))
+
 ### [1.1.8](https://github.com/programinglive/commiter/compare/v1.1.7...v1.1.8) (2025-11-22)
 
 

package/docs/CREATE_RELEASES.md

@@ -0,0 +1,103 @@
+# Creating GitHub Releases
+
+This guide explains how to populate your GitHub releases page with releases from your tags.
+
+## Problem
+
+You have tags in your repository (v1.0.0, v1.1.9, etc.) but the GitHub releases page is empty. GitHub doesn't automatically create releases from tags - you need to create them manually.
+
+## Solution Options
+
+### Option 1: Use the Automated Script (Recommended)
+
+We've created a script that will automatically create releases for all your tags using the content from CHANGELOG.md.
+
+#### Prerequisites
+1. Create a GitHub Personal Access Token:
+   - Go to https://github.com/settings/tokens
+   - Click "Generate new token" → "Generate new token (classic)"
+   - Give it a name like "Commiter Releases"
+   - Select scope: `repo` (Full control of private repositories)
+   - Click "Generate token"
+   - **Copy the token immediately** (you won't see it again!)
+
+#### Steps
+1. Set your GitHub token as an environment variable:
+   ```powershell
+   # Windows PowerShell
+   $env:GITHUB_TOKEN="your_token_here"
+   ```
+
+2. Run the script:
+   ```bash
+   node scripts/create-releases.js
+   ```
+
+3. The script will:
+   - Read all your local tags
+   - Parse CHANGELOG.md for release notes
+   - Create GitHub releases for each tag
+   - Skip tags that already have releases
+
+### Option 2: Create Releases Manually
+
+If you prefer to create releases manually or just want to create the latest release:
+
+1. Go to https://github.com/programinglive/commiter/releases
+2. Click "Draft a new release"
+3. Click "Choose a tag" and select `v1.1.9`
+4. Set the release title to `v1.1.9`
+5. Copy the release notes from CHANGELOG.md (lines 5-10):
+   ```markdown
+   ### 🐛 Bug Fixes
+
+   * convert release scripts to CJS to support ESM projects ([842da02](https://github.com/programinglive/commiter/commit/842da0298f1c4df7aa93b43ca8698e3669ef6450))
+   ```
+6. Click "Publish release"
+7. Repeat for other versions if needed
+
+### Option 3: Use GitHub CLI (if installed)
+
+If you have GitHub CLI installed (`gh`):
+
+```bash
+# Create release for v1.1.9
+gh release create v1.1.9 \
+  --title "v1.1.9" \
+  --notes "### 🐛 Bug Fixes
+
+* convert release scripts to CJS to support ESM projects"
+
+# Or create from CHANGELOG
+gh release create v1.1.9 --notes-file CHANGELOG.md
+```
+
+## After Creating Releases
+
+Once releases are created, they will appear on:
+- https://github.com/programinglive/commiter/releases
+- The right sidebar of your repository
+- In the repository's release feed
+
+## Automating Future Releases
+
+To automatically create GitHub releases during your release process, you can:
+
+1. **Add to your release script** - Modify `scripts/release.cjs` to create GitHub releases
+2. **Use GitHub Actions** - Set up a workflow that creates releases when tags are pushed
+3. **Use the script** - Run `scripts/create-releases.js` after each release
+
+## Troubleshooting
+
+### "GITHUB_TOKEN not set"
+Make sure you've set the environment variable in your current terminal session.
+
+### "API rate limit exceeded"
+GitHub API has rate limits. The script waits 1 second between requests to avoid this. If you hit the limit, wait an hour and try again.
+
+### "Resource not accessible by integration"
+Your token doesn't have the right permissions. Make sure you selected the `repo` scope when creating the token.
+
+## Security Note
+
+**Never commit your GitHub token to the repository!** Always use environment variables or secure secret management.

package/docs/QUICK_RELEASE_GUIDE.md

@@ -0,0 +1,101 @@
+# Quick Guide: Create GitHub Release for v1.1.9
+
+Follow these simple steps to create your first GitHub release:
+
+## Step 1: Navigate to New Release Page
+1. Make sure you're logged into GitHub
+2. Go to: https://github.com/programinglive/commiter/releases/new
+
+## Step 2: Fill in the Form
+
+### Choose a tag
+- Click "Choose a tag"
+- Type: `v1.1.9`
+- Click "Create new tag: v1.1.9 on publish"
+
+### Release title
+- Type: `v1.1.9`
+
+### Describe this release
+Copy and paste this content:
+
+```markdown
+### 🐛 Bug Fixes
+
+* convert release scripts to CJS to support ESM projects ([842da02](https://github.com/programinglive/commiter/commit/842da0298f1c4df7aa93b43ca8698e3669ef6450))
+```
+
+## Step 3: Publish
+- Click the green "Publish release" button
+
+## Done! ✅
+
+Your release will now appear at: https://github.com/programinglive/commiter/releases
+
+---
+
+## Create More Releases (Optional)
+
+If you want to create releases for older versions, here's the content for each:
+
+### v1.1.8
+**Title:** `v1.1.8`  
+**Description:**
+```markdown
+### 🐛 Bug Fixes
+
+* update installation script to copy missing files and update gitignore ([5d56259](https://github.com/programinglive/commiter/commit/5d562592fe35b684fa12bd89748b24551ae28a66))
+```
+
+### v1.1.7
+**Title:** `v1.1.7`  
+**Description:**
+```markdown
+### 📝 Documentation
+
+* recommend dev workflow mcp server ([58a5054](https://github.com/programinglive/commiter/commit/58a5054fafd627ef23c448fd93b1383518590ad2))
+```
+
+### v1.1.6
+**Title:** `v1.1.6`  
+**Description:**
+```markdown
+### 🐛 Bug Fixes
+
+* revert to simple release notes staging to avoid git ref conflicts ([2f6a40e](https://github.com/programinglive/commiter/commit/2f6a40ed7259cffdb0b1de1633af3e43df475044))
+```
+
+### v1.1.5
+**Title:** `v1.1.5`  
+**Description:**
+```markdown
+### ✨ Features
+
+* include release notes in release commit via amendment ([3f2afa8](https://github.com/programinglive/commiter/commit/3f2afa8bd0bd264d047df06ae791384e74dc827e))
+
+### 📝 Documentation
+
+* update release notes for v1.1.5 ([cb3dbe6](https://github.com/programinglive/commiter/commit/cb3dbe62a85a174bfb074e3d2526a005fc83d0d7))
+```
+
+### v1.1.1
+**Title:** `v1.1.1`  
+**Description:**
+```markdown
+### 🐛 Bug Fixes
+
+* remove fs.F_OK deprecation warning ([1b0652b](https://github.com/programinglive/commiter/commit/1b0652b88d1b095e1045994948f75ce8194f9d3a))
+```
+
+### v1.0.12
+**Title:** `v1.0.12`  
+**Description:**
+```markdown
+### ✨ Features
+
+* auto-detect test command during release ([602e30e](https://github.com/programinglive/commiter/commit/602e30e94ff7c58b35f8c54bd495c0334352c72c))
+```
+
+---
+
+**Tip:** You only need to create releases for the major versions (1.1.9, 1.1.8, 1.1.7, etc.). You can skip the older patch versions if you want to save time.

package/docs/release-notes/RELEASE_NOTES.md

@@ -4,6 +4,8 @@ This document summarizes every published version of `@programinglive/commiter`.
 
 | Version | Date | Highlights |
 |---------|------|------------|
+| 1.1.10 | 2025-11-26 | **website:** add professional landing page and release tools (ec53e2d) |
+| 1.1.9 | 2025-11-24 | convert release scripts to CJS to support ESM projects (842da02) |
 | 1.1.8 | 2025-11-22 | update installation script to copy missing files and update gitignore (5d56259) |
 | 1.1.7 | 2025-11-11 | recommend dev workflow mcp server (58a5054) |
 | 1.1.6 | 2025-11-05 | revert to simple release notes staging to avoid git ref conflicts (2f6a40e) |
@@ -34,6 +36,20 @@ This document summarizes every published version of `@programinglive/commiter`.
 
 
 
+
+
+## 1.1.10 – ✨ Features
+
+Released on **2025-11-26**.
+
+- **website:** add professional landing page and release tools (ec53e2d)
+
+## 1.1.9 – 🐛 Bug Fixes
+
+Released on **2025-11-24**.
+
+- convert release scripts to CJS to support ESM projects (842da02)
+
 ## 1.1.8 – 🐛 Bug Fixes
 
 Released on **2025-11-22**.

package/index.js

@@ -59,10 +59,10 @@ function setupCommiter() {
     packageJson.scripts = ensureSafeTestScript(packageJson.scripts || {});
     // Add scripts
     packageJson.scripts.prepare = 'husky';
-    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';
+    packageJson.scripts.release = 'node scripts/release.cjs';
+    packageJson.scripts['release:major'] = 'node scripts/release.cjs major';
+    packageJson.scripts['release:minor'] = 'node scripts/release.cjs minor';
+    packageJson.scripts['release:patch'] = 'node scripts/release.cjs patch';
 
     // Add standard-version config
     packageJson['standard-version'] = {
@@ -92,22 +92,22 @@ function setupCommiter() {
       fs.mkdirSync(releaseScriptDir, { recursive: true });
     }
 
-    const releaseScriptPath = path.join(releaseScriptDir, 'release.js');
-    const releaseScriptSource = path.join(__dirname, 'scripts', 'release.js');
+    const releaseScriptPath = path.join(releaseScriptDir, 'release.cjs');
+    const releaseScriptSource = path.join(__dirname, 'scripts', 'release.cjs');
     fs.copyFileSync(releaseScriptSource, releaseScriptPath);
 
     // Copy update-release-notes.js
-    const updateNotesSource = path.join(__dirname, 'scripts', 'update-release-notes.js');
-    const updateNotesDest = path.join(releaseScriptDir, 'update-release-notes.js');
+    const updateNotesSource = path.join(__dirname, 'scripts', 'update-release-notes.cjs');
+    const updateNotesDest = path.join(releaseScriptDir, 'update-release-notes.cjs');
     if (fs.existsSync(updateNotesSource)) {
-        fs.copyFileSync(updateNotesSource, updateNotesDest);
+      fs.copyFileSync(updateNotesSource, updateNotesDest);
     }
 
     // Copy preload directory
     const preloadSource = path.join(__dirname, 'scripts', 'preload');
     const preloadDest = path.join(releaseScriptDir, 'preload');
     if (fs.existsSync(preloadSource)) {
-        copyRecursiveSync(preloadSource, preloadDest);
+      copyRecursiveSync(preloadSource, preloadDest);
     }
     try {
       fs.chmodSync(releaseScriptPath, 0o755);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@programinglive/commiter",
-  "version": "1.1.8",
+  "version": "1.1.10",
   "description": "Commiter keeps repositories release-ready by enforcing conventional commits, generating icon-rich changelog entries, and orchestrating semantic version bumps without manual toil. It bootstraps Husky hooks, commitlint rules, and release scripts that inspect history, detect framework-specific test commands, run them automatically, tag git releases, coordinate npm publishing, surface release metrics, enforce project-specific checks, and give maintainers observability across distributed teams. Plus!",
   "main": "index.js",
   "bin": {
@@ -9,10 +9,10 @@
   "scripts": {
     "test": "node --test",
     "prepare": "husky",
-    "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"
+    "release": "node scripts/release.cjs",
+    "release:major": "node scripts/release.cjs major",
+    "release:minor": "node scripts/release.cjs minor",
+    "release:patch": "node scripts/release.cjs patch"
   },
   "keywords": [
     "commit",

package/scripts/create-releases.js

@@ -0,0 +1,219 @@
+#!/usr/bin/env node
+
+/**
+ * Create GitHub Releases from Tags and CHANGELOG
+ * 
+ * This script reads the CHANGELOG.md file and creates GitHub releases
+ * for all tags that don't have releases yet.
+ * 
+ * Prerequisites:
+ * - GitHub Personal Access Token with 'repo' scope
+ * - Set as environment variable: GITHUB_TOKEN
+ * 
+ * Usage:
+ * GITHUB_TOKEN=your_token node scripts/create-releases.js
+ */
+
+const fs = require('fs');
+const https = require('https');
+const { execSync } = require('child_process');
+
+// Configuration
+const REPO_OWNER = 'programinglive';
+const REPO_NAME = 'commiter';
+const CHANGELOG_PATH = './CHANGELOG.md';
+
+// GitHub API helper
+function githubRequest(method, path, data = null) {
+    const token = process.env.GITHUB_TOKEN;
+
+    if (!token) {
+        console.error('❌ Error: GITHUB_TOKEN environment variable not set');
+        console.error('Please set it with: set GITHUB_TOKEN=your_token_here');
+        process.exit(1);
+    }
+
+    return new Promise((resolve, reject) => {
+        const options = {
+            hostname: 'api.github.com',
+            port: 443,
+            path: path,
+            method: method,
+            headers: {
+                'User-Agent': 'Commiter-Release-Script',
+                'Authorization': `token ${token}`,
+                'Accept': 'application/vnd.github.v3+json',
+                'Content-Type': 'application/json'
+            }
+        };
+
+        const req = https.request(options, (res) => {
+            let body = '';
+            res.on('data', (chunk) => body += chunk);
+            res.on('end', () => {
+                if (res.statusCode >= 200 && res.statusCode < 300) {
+                    resolve(JSON.parse(body || '{}'));
+                } else {
+                    reject(new Error(`GitHub API error: ${res.statusCode} - ${body}`));
+                }
+            });
+        });
+
+        req.on('error', reject);
+
+        if (data) {
+            req.write(JSON.stringify(data));
+        }
+
+        req.end();
+    });
+}
+
+// Parse CHANGELOG.md to extract release notes
+function parseChangelog() {
+    const content = fs.readFileSync(CHANGELOG_PATH, 'utf-8');
+    const releases = {};
+
+    // Match version headers like: ### [1.1.9](link) (2025-11-24)
+    const versionRegex = /### \[(\d+\.\d+\.\d+)\]\([^)]+\) \(([^)]+)\)/g;
+    const sections = content.split(versionRegex);
+
+    // Process matches
+    let match;
+    const matches = [];
+    while ((match = versionRegex.exec(content)) !== null) {
+        matches.push({
+            version: match[1],
+            date: match[2],
+            index: match.index
+        });
+    }
+
+    // Extract content for each version
+    for (let i = 0; i < matches.length; i++) {
+        const current = matches[i];
+        const next = matches[i + 1];
+
+        const startIndex = current.index;
+        const endIndex = next ? next.index : content.length;
+
+        let releaseContent = content.substring(startIndex, endIndex).trim();
+
+        // Remove the version header line
+        releaseContent = releaseContent.split('\n').slice(1).join('\n').trim();
+
+        // Clean up the content
+        releaseContent = releaseContent
+            .replace(/###\s+\[(\d+\.\d+\.\d+)\].*$/m, '') // Remove next version header if present
+            .trim();
+
+        releases[current.version] = {
+            version: current.version,
+            date: current.date,
+            body: releaseContent || 'See CHANGELOG.md for details.'
+        };
+    }
+
+    return releases;
+}
+
+// Get all local tags
+function getLocalTags() {
+    try {
+        const output = execSync('git tag -l', { encoding: 'utf-8' });
+        return output.trim().split('\n').filter(Boolean);
+    } catch (error) {
+        console.error('❌ Error getting local tags:', error.message);
+        return [];
+    }
+}
+
+// Get existing GitHub releases
+async function getExistingReleases() {
+    try {
+        const releases = await githubRequest('GET', `/repos/${REPO_OWNER}/${REPO_NAME}/releases`);
+        return new Set(releases.map(r => r.tag_name));
+    } catch (error) {
+        console.error('❌ Error fetching existing releases:', error.message);
+        return new Set();
+    }
+}
+
+// Create a GitHub release
+async function createRelease(tag, releaseData) {
+    const data = {
+        tag_name: tag,
+        name: `${tag}`,
+        body: releaseData.body,
+        draft: false,
+        prerelease: false
+    };
+
+    try {
+        await githubRequest('POST', `/repos/${REPO_OWNER}/${REPO_NAME}/releases`, data);
+        console.log(`✅ Created release for ${tag}`);
+        return true;
+    } catch (error) {
+        console.error(`❌ Failed to create release for ${tag}:`, error.message);
+        return false;
+    }
+}
+
+// Main function
+async function main() {
+    console.log('🚀 Creating GitHub Releases from CHANGELOG...\n');
+
+    // Parse changelog
+    console.log('📝 Parsing CHANGELOG.md...');
+    const releases = parseChangelog();
+    console.log(`Found ${Object.keys(releases).length} releases in CHANGELOG\n`);
+
+    // Get local tags
+    console.log('🏷️  Getting local tags...');
+    const localTags = getLocalTags();
+    console.log(`Found ${localTags.length} local tags\n`);
+
+    // Get existing GitHub releases
+    console.log('🔍 Checking existing GitHub releases...');
+    const existingReleases = await getExistingReleases();
+    console.log(`Found ${existingReleases.size} existing releases on GitHub\n`);
+
+    // Create releases for tags that don't have them
+    console.log('📦 Creating missing releases...\n');
+    let created = 0;
+    let skipped = 0;
+
+    for (const tag of localTags) {
+        const version = tag.replace(/^v/, '');
+
+        if (existingReleases.has(tag)) {
+            console.log(`⏭️  Skipping ${tag} (already exists)`);
+            skipped++;
+            continue;
+        }
+
+        const releaseData = releases[version];
+        if (!releaseData) {
+            console.log(`⚠️  No changelog entry found for ${tag}, using default message`);
+            await createRelease(tag, { body: 'See [CHANGELOG.md](CHANGELOG.md) for details.' });
+            created++;
+        } else {
+            await createRelease(tag, releaseData);
+            created++;
+        }
+
+        // Rate limiting: wait 1 second between requests
+        await new Promise(resolve => setTimeout(resolve, 1000));
+    }
+
+    console.log(`\n✨ Done!`);
+    console.log(`   Created: ${created}`);
+    console.log(`   Skipped: ${skipped}`);
+    console.log(`\n🔗 View releases at: https://github.com/${REPO_OWNER}/${REPO_NAME}/releases`);
+}
+
+// Run the script
+main().catch(error => {
+    console.error('\n❌ Script failed:', error.message);
+    process.exit(1);
+});

package/scripts/{release.js → release.cjs}

@@ -4,7 +4,7 @@ const { spawnSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
 
-const { updateReleaseNotes } = require('./update-release-notes');
+const { updateReleaseNotes } = require('./update-release-notes.cjs');
 
 const fsFokPreloadPath = path.join(__dirname, 'preload', 'fs-f-ok.cjs');
 const FS_FOK_PRELOAD_FLAG = buildPreloadFlag(fsFokPreloadPath);

package/web/README.md

@@ -0,0 +1,79 @@
+# Commiter Website
+
+This is the static website for the Commiter project. It can be deployed to any web server or hosting platform.
+
+## 📁 Structure
+
+```
+web/
+├── index.html          # Main landing page
+├── css/
+│   └── style.css      # Styles with modern dark theme
+├── js/
+│   └── script.js      # Interactive features
+└── README.md          # This file
+```
+
+## 🚀 Deployment Options
+
+### Option 1: Plesk / cPanel
+1. Compress the `web` folder contents into a ZIP file
+2. Upload to your Plesk/cPanel file manager
+3. Extract in your public_html or desired directory
+4. Access via your domain
+
+### Option 2: Static Hosting (Netlify, Vercel, GitHub Pages)
+1. Push the `web` folder to a Git repository
+2. Connect to your hosting platform
+3. Set the build directory to `web`
+4. Deploy
+
+### Option 3: Simple HTTP Server (Testing)
+```bash
+# Navigate to the web directory
+cd web
+
+# Python 3
+python -m http.server 8000
+
+# Node.js (if you have http-server installed)
+npx http-server -p 8000
+
+# PHP
+php -S localhost:8000
+```
+
+Then open http://localhost:8000 in your browser.
+
+## 🎨 Features
+
+- **Modern Design**: Dark theme with glassmorphism effects
+- **Fully Responsive**: Works on desktop, tablet, and mobile
+- **Smooth Animations**: Scroll animations and transitions
+- **Interactive Elements**: Copy-to-clipboard, smooth scrolling
+- **SEO Optimized**: Meta tags and semantic HTML
+- **Fast Loading**: Optimized CSS and JavaScript
+
+## 🛠️ Customization
+
+### Colors
+Edit CSS variables in `css/style.css`:
+```css
+:root {
+    --primary: #6366f1;
+    --secondary: #8b5cf6;
+    --accent: #ec4899;
+    /* ... more variables */
+}
+```
+
+### Content
+Edit `index.html` to update:
+- Version numbers
+- Release information
+- Links and URLs
+- Text content
+
+## 📝 License
+
+This website is part of the Commiter project and is released under the MIT License.