ai-project-boilerplate 1.3.1 → 1.3.3

package/.ai-project-refining-template

@@ -0,0 +1,26 @@
+# Migration Guidance for Existing AI Project
+
+Your existing project has been detected.
+
+To integrate with the AI Project Boilerplate and refine your project for AI collaboration:
+
+1. **Review AI_INSTRUCTIONS.md**: Copy or adapt the AI_INSTRUCTIONS.md from the boilerplate to your project root. This file serves as the AI router and source of truth for project guidelines, ensuring consistent AI interactions.
+
+2. **Add CLAUDE.md**: Include CLAUDE.md for Claude Code entry points, defining how AI tools interact with your codebase.
+
+3. **Set Up docs/ Folder**: Ensure a `docs/` folder exists with at least:
+   - planning.md (project goals and roadmap)
+   - architecture.md (system design)
+   - testing.md (testing strategies)
+   - deployment.md (deployment processes)
+   Copy or adapt these from the boilerplate if needed.
+
+4. **Update CHANGELOG.md**: Maintain a changelog for version history and AI-driven changes.
+
+5. **Enhance README.md**: Update your README.md to reference AI_INSTRUCTIONS.md and include project setup for AI collaboration.
+
+6. **Add .ai-stage File (Optional)**: Create a `.ai-stage` file in the project root with initial content `PLANNING` to track the current development stage (e.g., PLANNING, DEVELOPMENT, TESTING, DEPLOYMENT).
+
+7. **Next Steps**: Fill in or update docs/planning.md. Consider integrating AI tools for code reviews and refinements.
+
+For more details, refer to the AI Project Boilerplate documentation.

package/bin/cli.js

@@ -110,24 +110,37 @@ async function checkForUpdate() {
     const bold   = (s) => `\x1b[1m${s}\x1b[0m`;
     const dim    = (s) => `\x1b[2m${s}\x1b[0m`;
 
-    const tag     = bold(yellow("UPDATE AVAILABLE"));
-    const from    = dim(CURRENT_VERSION);
-    const arrow   = "→";
-    const to      = bold(cyan(latest));
-    const cmd     = bold(cyan("npm install -g ai-project-boilerplate"));
-    const url     = cyan(`https://github.com/${REPO}/releases/tag/v${latest}`);
-    const line1   = `   ${tag}   ${from} ${arrow} ${to}`;
-    const line2   = `   Run ${cmd} to update`;
-    const line3   = `   See what's changed: ${url}`;
-
-    const strip   = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
-    const width   = Math.max(strip(line1).length, strip(line2).length, strip(line3).length) + 2;
-    const border  = yellow("─".repeat(width));
+    const strip  = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
+
+    const isPnpm = __filename.includes("pnpm");
+    const prefs  = loadPrefs();
+
+    const updateCmd = (isPnpm || !prefs.suppressPnpmWarning)
+      ? bold(cyan("pnpm add -g ai-project-boilerplate"))
+      : bold(cyan("npm install -g ai-project-boilerplate"));
+
+    const tag  = bold(yellow("UPDATE AVAILABLE"));
+    const from = dim(CURRENT_VERSION);
+    const to   = bold(cyan(latest));
+    const url  = cyan(`https://github.com/${REPO}/releases/tag/v${latest}`);
+
+    const lines = [
+      `   ${tag}   ${from} → ${to}`,
+      `   Run ${updateCmd} to update`,
+      `   See what's changed: ${url}`,
+    ];
+
+    if (!isPnpm && !prefs.suppressPnpmWarning) {
+      lines.push(`   To suppress pnpm suggestion: ${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("┐")}`);
-    console.error(`${yellow("│")} ${line1.padEnd(line1.length + width - strip(line1).length - 1)}${yellow("│")}`);
-    console.error(`${yellow("│")} ${line2.padEnd(line2.length + width - strip(line2).length - 1)}${yellow("│")}`);
-    console.error(`${yellow("│")} ${line3.padEnd(line3.length + width - strip(line3).length - 1)}${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`);
     return true;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-project-boilerplate",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "CLI to scaffold AI-collaborated projects with stage-based AI instruction files",
   "bin": {
     "ai-project": "bin/cli.js"
@@ -11,7 +11,8 @@
   "files": [
     "bin",
     "template",
-    "scripts/preuninstall.js"
+    "scripts/preuninstall.js",
+    ".ai-project-refining-template"
   ],
   "keywords": [
     "ai",