agileflow 2.96.1 → 2.96.2

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.96.2] - 2026-02-06
+
+### Fixed
+- Smart docs folder detection for existing AgileFlow installations
+
 ## [2.96.1] - 2026-02-06
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agileflow",
-  "version": "2.96.1",
+  "version": "2.96.2",
   "description": "AI-driven agile development system for Claude Code, Cursor, Windsurf, and more",
   "keywords": [
     "agile",

package/tools/cli/lib/docs-setup.js

@@ -416,25 +416,45 @@ Document your CI/CD workflows and configuration here.
   return result;
 }
 
+/**
+ * Check if a folder is an AgileFlow docs folder
+ * @param {string} folderPath - Path to check
+ * @returns {boolean} True if it's an AgileFlow docs folder
+ */
+function isAgileFlowDocsFolder(folderPath) {
+  const metadataPath = path.join(folderPath, '00-meta', 'agileflow-metadata.json');
+  return fs.existsSync(metadataPath);
+}
+
 /**
  * Get the docs folder name from metadata or default
+ * Checks both 'docs' and 'agileflow-docs' folders
  * @param {string} targetDir - Target directory
  * @returns {Promise<string>} Docs folder name
  */
 async function getDocsFolderName(targetDir) {
-  try {
-    const metadataPath = path.join(targetDir, 'docs', '00-meta', 'agileflow-metadata.json');
-    if (fs.existsSync(metadataPath)) {
-      const metadata = JSON.parse(await fs.readFile(metadataPath, 'utf8'));
-      return metadata.docsFolder || 'docs';
+  // Check in order of preference: existing metadata, then probe folders
+  const candidateFolders = ['docs', 'agileflow-docs'];
+
+  for (const folder of candidateFolders) {
+    try {
+      const folderPath = path.join(targetDir, folder);
+      const metadataPath = path.join(folderPath, '00-meta', 'agileflow-metadata.json');
+      if (fs.existsSync(metadataPath)) {
+        const metadata = JSON.parse(await fs.readFile(metadataPath, 'utf8'));
+        return metadata.docsFolder || folder;
+      }
+    } catch (_err) {
+      // Continue to next candidate
     }
-  } catch (err) {
-    // Ignore errors, return default
   }
+
+  // No existing AgileFlow docs found, default to 'docs'
   return 'docs';
 }
 
 module.exports = {
   createDocsStructure,
   getDocsFolderName,
+  isAgileFlowDocsFolder,
 };

package/tools/cli/lib/ui.js

@@ -112,9 +112,15 @@ async function promptInstall() {
   // Always install to current directory
   const directory = path.resolve('.');
 
-  // Check if docs/ folder already exists (conflict detection)
+  // Check if docs/ folder already exists and if it's an AgileFlow docs folder
   const defaultDocsFolder = 'docs';
-  const docsExists = fs.existsSync(path.join(directory, defaultDocsFolder));
+  const docsPath = path.join(directory, defaultDocsFolder);
+  const docsExists = fs.existsSync(docsPath);
+
+  // Check if existing docs/ is an AgileFlow docs folder
+  // AgileFlow docs have 00-meta/agileflow-metadata.json
+  const isAgileFlowDocs =
+    docsExists && fs.existsSync(path.join(docsPath, '00-meta', 'agileflow-metadata.json'));
 
   // Build questions dynamically - only ask what's necessary
   const questions = [
@@ -132,12 +138,13 @@ async function promptInstall() {
     },
   ];
 
-  // Only ask about docs folder if it already exists (potential conflict)
-  if (docsExists) {
+  // Only ask about docs folder if it exists AND is not an AgileFlow folder
+  // If it's already an AgileFlow folder, reuse it silently
+  if (docsExists && !isAgileFlowDocs) {
     questions.push({
       type: 'input',
       name: 'docsFolder',
-      message: `A 'docs/' folder already exists. Use a different name for AgileFlow docs?`,
+      message: `A 'docs/' folder already exists (not AgileFlow). Use a different name?`,
       default: 'agileflow-docs',
       validate: input => {
         if (!/^[a-zA-Z0-9._-]+$/.test(input)) {