ai-project-boilerplate 1.2.0 → 1.3.1

package/bin/cli.js

@@ -36,6 +36,72 @@ function compareVersions(a, b) {
   return 0;
 }
 
+function getPrefsPath() {
+  const os = require("os");
+  return path.join(os.homedir(), ".config", "ai-project", "prefs.json");
+}
+
+function loadPrefs() {
+  try {
+    return JSON.parse(fs.readFileSync(getPrefsPath(), "utf8"));
+  } catch {
+    return {};
+  }
+}
+
+function savePrefs(prefs) {
+  const prefsPath = getPrefsPath();
+  fs.mkdirSync(path.dirname(prefsPath), { recursive: true });
+  fs.writeFileSync(prefsPath, JSON.stringify(prefs, null, 2));
+}
+
+function checkPackageManager() {
+  const isPnpm = __filename.includes("pnpm");
+  if (isPnpm) return;
+
+  const prefs = loadPrefs();
+  if (prefs.suppressPnpmWarning) return;
+
+  const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+  const cyan   = (s) => `\x1b[36m${s}\x1b[0m`;
+  const bold   = (s) => `\x1b[1m${s}\x1b[0m`;
+  const dim    = (s) => `\x1b[2m${s}\x1b[0m`;
+
+  const hasPnpm = (() => {
+    try { require("child_process").execSync("pnpm --version", { stdio: "ignore" }); return true; } catch { return false; }
+  })();
+
+  const strip  = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
+
+  let lines;
+  if (hasPnpm) {
+    const cmd = bold(cyan("pnpm add -g ai-project-boilerplate"));
+    lines = [
+      `   ${bold(yellow("RECOMMENDED:"))} install via pnpm for best compatibility`,
+      `   Run ${cmd}`,
+      `   To suppress this warning: ${bold(cyan("ai-project --no-pnpm-warning"))}`,
+    ];
+  } else {
+    const installCmd = bold(cyan("npm install -g pnpm"));
+    const migrateCmd = bold(cyan("pnpm add -g ai-project-boilerplate"));
+    lines = [
+      `   ${bold(yellow("RECOMMENDED:"))} install via pnpm for best compatibility`,
+      `   1. Install pnpm: ${installCmd}`,
+      `   2. Then migrate: ${migrateCmd}`,
+      `   To suppress this warning: ${bold(cyan("ai-project --no-pnpm-warning"))}`,
+    ];
+  }
+
+  const width  = Math.max(...lines.map(l => strip(l).length)) + 2;
+  const border = yellow("─".repeat(width));
+
+  console.error(`\n${yellow("┌")}${border}${yellow("┐")}`);
+  for (const line of lines) {
+    console.error(`${yellow("│")} ${line.padEnd(line.length + width - strip(line).length - 1)}${yellow("│")}`);
+  }
+  console.error(`${yellow("└")}${border}${yellow("┘")}\n`);
+}
+
 async function checkForUpdate() {
   const latest = await fetchLatestVersion();
   if (latest && compareVersions(latest, CURRENT_VERSION) > 0) {
@@ -85,6 +151,18 @@ function copyTemplate(src, dest) {
 async function main() {
   const args = process.argv.slice(2);
 
+  // Handle --no-pnpm-warning
+  if (args[0] === '--no-pnpm-warning') {
+    const prefs = loadPrefs();
+    prefs.suppressPnpmWarning = true;
+    savePrefs(prefs);
+    console.log("pnpm warning suppressed. To re-enable, delete ~/.config/ai-project/prefs.json");
+    process.exit(0);
+  }
+
+  // Check package manager preference
+  checkPackageManager();
+
   // Always check for updates first
   await checkForUpdate();
 

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "ai-project-boilerplate",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "CLI to scaffold AI-collaborated projects with stage-based AI instruction files",
   "bin": {
     "ai-project": "bin/cli.js"
   },
+  "scripts": {
+    "preuninstall": "node scripts/preuninstall.js"
+  },
   "files": [
     "bin",
-    "template"
+    "template",
+    "scripts/preuninstall.js"
   ],
   "keywords": [
     "ai",

package/scripts/preuninstall.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const prefsPath = path.join(os.homedir(), ".config", "ai-project", "prefs.json");
+try {
+  fs.rmSync(prefsPath, { force: true });
+} catch {
+  // silently ignore
+}

package/template/docs/architecture.md

@@ -14,35 +14,16 @@
   - `feature/<short-description>` — for new functionality
   - `fix/<short-description>` — for bug fixes
 ### PR Flow
-```bash
-# 1. Create and switch to branch
-git checkout -b feature/<short-description>
-
-# 2. Implement, commit changes, then push
-git push -u origin feature/<short-description>
-
-# 3. Create PR
-gh pr create --title "<title>" --body "$(cat <<'EOF'
-## Summary
-- <bullet points>
-
-## Test plan
-- [ ] <manual test steps>
-EOF
-)"
-
-# 4. Check CI status
-gh pr checks
-
-# 5. Merge and delete branch after approval
-gh pr merge --squash --delete-branch
-```
+1. Create a feature or fix branch and push to remote
+2. Open a pull request targeting `main` (e.g. via `gh pr create` or your Git host's UI)
+3. Check CI status (e.g. `gh pr checks`)
+4. Merge and delete the branch after approval (e.g. `gh pr merge --squash --delete-branch`)
 
 ### Release Flow
-```bash
-# Bump version, tag, and create GitHub release
-./scripts/release.sh <patch|minor|major>
-```
+1. Bump the version (follow your project's versioning convention)
+2. Commit the version change and tag the commit (e.g. `vX.Y.Z`)
+3. Push the tag to remote
+4. Publish / deploy (e.g. create a release on your Git host, publish to a registry, deploy to an environment)
 
 ## Key Conventions
 <!-- Naming, file organization, patterns to follow -->