maiass 5.10.4 → 5.10.6

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,27 @@
+# Code of Conduct
+
+## Our Pledge
+
+We are committed to making participation in this project a respectful and harassment-free experience for everyone.
+
+## Our Standards
+
+Expected behaviour:
+- Be respectful and constructive in all interactions
+- Accept feedback gracefully
+- Focus on what is best for the project and its users
+
+Unacceptable behaviour:
+- Harassment, insults, or personal attacks of any kind
+- Trolling or deliberately disruptive behaviour
+- Publishing others' private information without consent
+
+## Enforcement
+
+Instances of unacceptable behaviour may be reported by contacting the maintainer at [mark@pottie.com](mailto:mark@pottie.com). All reports will be reviewed and responded to.
+
+Maintainers reserve the right to remove, edit, or reject comments, commits, and other contributions that violate this code of conduct.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.

package/CONTRIBUTING.md

@@ -0,0 +1,38 @@
+# Contributing to MAIASS
+
+Thanks for your interest in contributing!
+
+## Reporting Issues
+
+- Search [existing issues](https://github.com/vsmash/nodemaiass/issues) before opening a new one
+- Include your OS, Node.js version, and `maiass --version` output
+- For bugs, include the full error output and the command you ran
+
+## Pull Requests
+
+1. Fork the repo and create a branch from `develop`
+2. Make your changes following the code style below
+3. Add or update tests if relevant (`npm run test:unit`)
+4. Ensure all tests pass (`npm run test:unit && npm test`)
+5. Submit a PR against `develop` — not `main`
+
+## Code Style
+
+- ES modules (`import`/`export`, `.js` extensions)
+- No comments unless the *why* is non-obvious
+- No new dependencies without discussion
+
+## Development Setup
+
+```bash
+git clone https://github.com/vsmash/nodemaiass.git
+cd nodemaiass
+npm install
+node maiass.mjs --help
+```
+
+See [docs/development.md](docs/development.md) for full details.
+
+## Questions
+
+Open a [GitHub Discussion](https://github.com/vsmash/nodemaiass/discussions) or file an issue.

package/lib/maiass-pipeline.js

@@ -15,6 +15,7 @@ import { handleVersionCommand } from './version-command.js';
 import { getSingleCharInput, getLineInput } from './input-utils.js';
 import { updateChangelog as updateChangelogNew } from './changelog.js';
 import { displayHeader } from './header.js';
+import { checkForUpdates } from './update-check.js';
 import { execSync } from 'child_process';
 import path from 'path';
 import fs from 'fs';
@@ -723,81 +724,6 @@ async function handleReleaseBranchWorkflow(newVersion, versionInfo, developBranc
   }
 }
 
-/**
- * Check for MAIASS version updates from npm registry
- * @param {string} currentVersion - Current version to compare against
- * @returns {Promise<Object>} Update check result
- */
-async function checkForUpdates(currentVersion) {
-  try {
-    // Set a timeout to prevent hanging
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), 3000); // 3 second timeout
-
-    const response = await fetch('https://registry.npmjs.org/maiass-dev', {
-      headers: {
-        'Accept': 'application/vnd.npm.install-v1+json',
-        'User-Agent': 'MAIASS-Version-Checker'
-      },
-      signal: controller.signal
-    });
-
-    clearTimeout(timeoutId);
-
-    if (!response.ok) {
-      return { updateAvailable: false, error: `HTTP ${response.status}` };
-    }
-
-    const registryData = await response.json();
-    const latestVersion = registryData['dist-tags']?.latest;
-    const releaseUrl = 'https://www.npmjs.com/package/maiass-dev';
-
-    if (!latestVersion) {
-      return { updateAvailable: false, error: 'No latest version found in npm registry' };
-    }
-
-    // Simple version comparison (assumes semantic versioning)
-    const current = currentVersion.split('.').map(num => parseInt(num, 10));
-    const latest = latestVersion.split('.').map(num => parseInt(num, 10));
-
-    let updateAvailable = false;
-    for (let i = 0; i < Math.max(current.length, latest.length); i++) {
-      const currentPart = current[i] || 0;
-      const latestPart = latest[i] || 0;
-      if (latestPart > currentPart) {
-        updateAvailable = true;
-        break;
-      } else if (latestPart < currentPart) {
-        break;
-      }
-    }
-
-    return {
-      updateAvailable,
-      currentVersion,
-      latestVersion,
-      releaseUrl,
-      error: null
-    };
-  } catch (error) {
-    // Handle timeout and other errors gracefully
-    const errorMsg = error.name === 'AbortError' ? 'Request timeout' : error.message;
-    return { updateAvailable: false, error: errorMsg };
-  }
-}
-
-/**
- * Display version information and update status
- * @param {string} currentVersion - Current MAIASS version
- */
-async function displayVersionInfo(currentVersion) {
-  // Display current version
-  logger.info(SYMBOLS.INFO, `MAIASS ${colors.Cyan(currentVersion)}`);
-  
-  // Note: Update checking is disabled for nodemaiass as it's in active development
-  // and not following npm registry releases. Bashmaiass uses Homebrew for updates.
-  // TODO: Re-enable when nodemaiass is published to npm with stable releases
-}
 
 /**
  * Main MAIASS pipeline orchestrator
@@ -818,6 +744,10 @@ export async function runMaiassPipeline(options = {}) {
   
   // Display branded header with MAIASS's own version (not project version)
   displayHeader(MAIASS_VERSION);
+
+  // Kick off update check in the background immediately so the network request
+  // runs concurrently with the rest of the pipeline — result shown at the end
+  const updateCheckPromise = checkForUpdates(MAIASS_VERSION);
   
   // Get git info early to show current branch
   const originalGitInfo = getGitInfo();
@@ -944,7 +874,15 @@ export async function runMaiassPipeline(options = {}) {
       const topupEndpoint = process.env.MAIASS_TOPUP_ENDPOINT || 'https://maiass.net/top-up';
       console.log(`${colors.BMagenta('Credit top-up link:')} ${colors.Blue(`${topupEndpoint}/${subscriptionId}`)}`);
     }
-    
+
+    // Show update notice if a newer version was found (check started at pipeline top)
+    const updateInfo = await updateCheckPromise;
+    if (updateInfo.updateAvailable) {
+      console.log('');
+      console.log(colors.Yellow(`  ⬆  Update available: ${updateInfo.currentVersion} → ${updateInfo.latestVersion}`));
+      console.log(colors.Gray(`     Run: npm install -g maiass`));
+    }
+
     return {
       success: true,
       branchInfo,

package/lib/update-check.js

@@ -0,0 +1,53 @@
+/**
+ * Check npm registry for a newer version of maiass.
+ * Resolves quickly (3s timeout) and never throws — callers can fire-and-forget.
+ *
+ * @param {string} currentVersion - The currently running version (e.g. "5.10.3")
+ * @param {Function} [fetchFn] - Optional fetch override for testing
+ * @returns {Promise<{updateAvailable: boolean, currentVersion: string, latestVersion?: string, error?: string}>}
+ */
+export async function checkForUpdates(currentVersion, fetchFn = fetch) {
+  try {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 3000); // 3s timeout
+
+    const response = await fetchFn('https://registry.npmjs.org/maiass', {
+      headers: {
+        'Accept': 'application/vnd.npm.install-v1+json',
+        'User-Agent': 'MAIASS-Version-Checker'
+      },
+      signal: controller.signal
+    });
+
+    clearTimeout(timeoutId);
+
+    if (!response.ok) {
+      return { updateAvailable: false, currentVersion, error: `HTTP ${response.status}` };
+    }
+
+    const data = await response.json();
+    const latestVersion = data['dist-tags']?.latest;
+
+    if (!latestVersion) {
+      return { updateAvailable: false, currentVersion, error: 'No latest version in registry' };
+    }
+
+    // Semantic version comparison — compares each part left to right
+    const current = currentVersion.split('.').map(n => parseInt(n, 10));
+    const latest  = latestVersion.split('.').map(n => parseInt(n, 10));
+
+    let updateAvailable = false;
+    for (let i = 0; i < Math.max(current.length, latest.length); i++) {
+      const c = current[i] || 0;
+      const l = latest[i]  || 0;
+      if (l > c) { updateAvailable = true; break; }
+      if (l < c) { break; }
+    }
+
+    return { updateAvailable, currentVersion, latestVersion };
+
+  } catch (error) {
+    const msg = error.name === 'AbortError' ? 'Request timeout' : error.message;
+    return { updateAvailable: false, currentVersion, error: msg };
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "maiass",
   "type": "module",
-  "version": "5.10.4",
+  "version": "5.10.6",
   "description": "AI commit message generator, semantic versioning, and changelog automation for Git. One command stages, commits with AI, bumps version, and merges branches. Free credits on install — no sign-up needed.",
   "main": "maiass.mjs",
   "bin": {
@@ -24,6 +24,8 @@
     "maiass.mjs",
     "setup-env.js",
     "README.md",
+    "CONTRIBUTING.md",
+    "CODE_OF_CONDUCT.md",
     "LICENSE"
   ],
   "engines": {