@programinglive/commiter 1.2.16 → 1.2.17

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 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.2.17](https://github.com/programinglive/commiter/compare/v1.2.16...v1.2.17) (2025-12-26)
+
+
+### 📝 Documentation
+
+* **web:** update homepage for v1.2.16 release ([c4ba36e](https://github.com/programinglive/commiter/commit/c4ba36ed3b9ec50f16df92b4cc37094f3173fc3a))
+
+
+### ✨ Features
+
+* **release:** enforce PRD presence warning ([227e237](https://github.com/programinglive/commiter/commit/227e237012cb56f9b570e69f96dc4bd2e836b319))
+
 ### [1.2.16](https://github.com/programinglive/commiter/compare/v1.2.15...v1.2.16) (2025-12-13)
 
 

package/README.md

@@ -128,10 +128,11 @@ npm run release
 
 1. 🧪 **Runs tests** - Detects your package manager and runs the `test` script automatically (tests only run during release, not on commit)
 2. 📊 **Analyzes commits** - Examines commits since last release
-3. 🔢 **Bumps version** - Updates version in `package.json`
-4. 📝 **Updates changelog** - Generates `CHANGELOG.md` with icons
-5. 🏷️ **Creates tag** - Creates a git tag for the release
-6. 💾 **Commits release** - Commits changes with format: `chore(release): v1.2.3 🚀`
+3. 📘 **Verifies documentation** – Warns if `docs/PRD.md` is missing so every project keeps an up-to-date PRD
+4. 🔢 **Bumps version** - Updates version in `package.json`
+5. 📝 **Updates changelog** - Generates `CHANGELOG.md` with icons
+6. 🏷️ **Creates tag** - Creates a git tag for the release
+7. 💾 **Commits release** - Commits changes with format: `chore(release): v1.2.3 🚀`
 
 ## Push Your Release
 

package/{PRD.md → docs/PRD.md}

@@ -47,7 +47,7 @@ Growing teams often struggle to keep release processes consistent: commit messag
    - Exit with non-zero status if tests or standard-version commands fail.
 3. CLI should provide friendly console output (status icons, instructions).
 4. The preload script must eliminate `[DEP0176] fs.F_OK` warnings on supported Node versions.
-5. Documentation (README, PRD, release notes) remains shipped with the package.
+5. Documentation (README, PRD, release notes) remains shipped with the package. Each project integrating Commiter must keep a `docs/PRD.md` file present in the repository. The release helper enforces this by warning when the PRD is missing so maintainers remember to author or update the document before tagging releases.
 
 ## 7. Non-Functional Requirements
 - **Compatibility**: Supports Node.js 18+ (aligning with dependencies); tested on Windows/macOS/Linux.

package/docs/release-notes/RELEASE_NOTES.md

@@ -4,6 +4,7 @@ This document summarizes every published version of `@programinglive/commiter`.
 
 | Version | Date | Highlights |
 |---------|------|------------|
+| 1.2.17 | 2025-12-26 | **web:** update homepage for v1.2.16 release (c4ba36e) |
 | 1.2.16 | 2025-12-13 | upgrade to node 20 and update npm for OIDC (5f7d9a0) |
 | 1.2.15 | 2025-12-13 | remove registry-url to fix OIDC auth conflict (c49b6e8) |
 | 1.2.14 | 2025-12-13 | remove legacy auth token env (8508deb) |
@@ -73,6 +74,14 @@ This document summarizes every published version of `@programinglive/commiter`.
 
 
 
+
+
+## 1.2.17 – 📝 Documentation
+
+Released on **2025-12-26**.
+
+- **web:** update homepage for v1.2.16 release (c4ba36e)
+- **release:** enforce PRD presence warning (227e237)
 
 ## 1.2.16 – 👷 Continuous Integration
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@programinglive/commiter",
-  "version": "1.2.16",
+  "version": "1.2.17",
   "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": {

package/scripts/release.cjs

@@ -11,6 +11,9 @@ const FS_FOK_PRELOAD_FLAG = buildPreloadFlag(fsFokPreloadPath);
 
 require('./preload/fs-f-ok.cjs');
 
+const DEFAULT_PRD_RELATIVE_PATH = path.join('docs', 'PRD.md');
+const DEFAULT_PRD_DISPLAY_PATH = 'docs/PRD.md';
+
 const VALID_RELEASE_TYPES = new Set([
   'major',
   'minor',
@@ -161,6 +164,8 @@ function runRelease({
     throw new Error('Working tree has uncommitted changes. Commit or stash before running release.');
   }
 
+  ensurePrdPresence({ cwd, dependencies });
+
   const testResult = runProjectTests({ spawn, env });
   if (testResult && typeof testResult.status === 'number' && testResult.status !== 0) {
     return testResult;
@@ -219,9 +224,31 @@ module.exports = {
   detectPackageManager,
   runProjectTests,
   runRelease,
-  isWorkingTreeClean
+  isWorkingTreeClean,
+  ensurePrdPresence
 };
 
+function ensurePrdPresence({ cwd = process.cwd(), dependencies = {} } = {}) {
+  const {
+    fsExistsSync = fs.existsSync,
+    logger = console,
+    prdRelativePath = DEFAULT_PRD_RELATIVE_PATH,
+    prdDisplayPath = DEFAULT_PRD_DISPLAY_PATH
+  } = dependencies;
+
+  const resolvedPath = path.isAbsolute(prdRelativePath)
+    ? prdRelativePath
+    : path.join(cwd, prdRelativePath);
+
+  if (fsExistsSync(resolvedPath)) {
+    return true;
+  }
+
+  const warn = typeof logger?.warn === 'function' ? logger.warn.bind(logger) : console.warn.bind(console);
+  warn(`⚠️  Product Requirements Document missing (${prdDisplayPath}). Add ${DEFAULT_PRD_DISPLAY_PATH} so teams understand release expectations.`);
+  return false;
+}
+
 function buildPreloadFlag(filePath) {
   const resolved = path.resolve(filePath);
   const escaped = resolved.includes(' ')

package/web/index.html

@@ -66,7 +66,7 @@
             <div class="hero-content">
                 <div class="hero-badge">
                     <span class="badge-dot"></span>
-                    <span>v1.2.5 - Latest Release</span>
+                    <span>v1.2.16 - Latest Release</span>
                 </div>
                 <h1 class="hero-title">
                     Ship Releases with <span class="gradient-text">Confidence</span>
@@ -90,7 +90,7 @@
                 </div>
                 <div class="hero-stats">
                     <div class="stat-item">
-                        <div class="stat-value">1.2.5</div>
+                        <div class="stat-value">1.2.16</div>
                         <div class="stat-label">Latest Version</div>
                     </div>
                     <div class="stat-item">
@@ -121,9 +121,9 @@
                         <div class="code-line output success">🎉 Setup complete! Ready to release.</div>
                         <div class="code-line"><span class="prompt">$</span> npm run release:patch</div>
                         <div class="code-line output">✓ Running tests...</div>
-                        <div class="code-line output">✓ Bumping version to 1.0.1...</div>
+                        <div class="code-line output">✓ Bumping version to 1.2.17...</div>
                         <div class="code-line output">✓ Updating CHANGELOG.md...</div>
-                        <div class="code-line output success">🚀 Release v1.0.1 ready!</div>
+                        <div class="code-line output success">🚀 Release v1.2.17 ready!</div>
                         <div class="code-line cursor">_</div>
                     </div>
                 </div>
@@ -388,34 +388,34 @@
                 <!-- RELEASES_TIMELINE:START -->
                 <div class="release-item">
                     <div class="release-badge">Latest</div>
-                    <div class="release-version">v1.2.5</div>
-                    <div class="release-date">November 29, 2025</div>
-                    <div class="release-type">🧹 Chores</div>
-                    <p class="release-description">release: v1.2.4 🚀 (23e546a)</p>
+                    <div class="release-version">v1.2.16</div>
+                    <div class="release-date">December 13, 2025</div>
+                    <div class="release-type">👷 Continuous Integration</div>
+                    <p class="release-description">upgrade to node 20 and update npm for OIDC via GitHub Actions</p>
                 </div>
                 <div class="release-item">
-                    <div class="release-version">v1.2.4</div>
-                    <div class="release-date">November 27, 2025</div>
-                    <div class="release-type">🧹 Chores</div>
-                    <p class="release-description">release: 1.2.3 (9d12f7e)</p>
+                    <div class="release-version">v1.2.15</div>
+                    <div class="release-date">December 13, 2025</div>
+                    <div class="release-type">👷 Continuous Integration</div>
+                    <p class="release-description">remove registry-url to fix OIDC auth conflict</p>
                 </div>
                 <div class="release-item">
-                    <div class="release-version">v1.2.3</div>
-                    <div class="release-date">November 27, 2025</div>
-                    <div class="release-type">✨ Features</div>
-                    <p class="release-description">automate website releases timeline updates from release notes (5abf788)</p>
+                    <div class="release-version">v1.2.14</div>
+                    <div class="release-date">December 13, 2025</div>
+                    <div class="release-type">👷 Continuous Integration</div>
+                    <p class="release-description">remove legacy auth token env</p>
                 </div>
                 <div class="release-item">
-                    <div class="release-version">v1.2.2</div>
-                    <div class="release-date">November 27, 2025</div>
-                    <div class="release-type">🧹 Chores</div>
-                    <p class="release-description">update homepage url (556b173)</p>
+                    <div class="release-version">v1.2.13</div>
+                    <div class="release-date">December 13, 2025</div>
+                    <div class="release-type">👷 Continuous Integration</div>
+                    <p class="release-description">enable npm trusted publishing (OIDC) with provenance</p>
                 </div>
                 <div class="release-item">
-                    <div class="release-version">v1.2.1</div>
-                    <div class="release-date">November 26, 2025</div>
-                    <div class="release-type">🐛 Bug Fixes</div>
-                    <p class="release-description">release: improve website version update reliability (18f5ace)</p>
+                    <div class="release-version">v1.2.12</div>
+                    <div class="release-date">December 13, 2025</div>
+                    <div class="release-type">🧹 Chores</div>
+                    <p class="release-description">cleanup and add deployment scripts</p>
                 </div>
                 <!-- RELEASES_TIMELINE:END -->
             </div>