specweave 0.13.5 → 0.14.0

package/plugins/specweave-ado/lib/project-selector.js

@@ -1,211 +1,183 @@
-/**
- * ADO Project Selector with Pagination
- *
- * Features:
- * - Fetches all ADO projects via API
- * - Interactive multi-select with search
- * - Manual project name entry (comma-separated)
- * - Handles large project lists (50+ projects)
- * - Validates project names
- */
-import inquirer from 'inquirer';
-// ============================================================================
-// ADO Project Fetching
-// ============================================================================
-/**
- * Fetch all ADO projects from API
- */
-export async function fetchAllAdoProjects(client) {
-    console.log('🔍 Fetching Azure DevOps projects...');
-    try {
-        const projects = await client.getProjects();
-        console.log(`✅ Found ${projects.length} Azure DevOps projects\n`);
-        return projects;
-    }
-    catch (error) {
-        console.error('❌ Failed to fetch ADO projects:', error.message);
-        throw error;
-    }
+import inquirer from "inquirer";
+async function fetchAllAdoProjects(client) {
+  console.log("\u{1F50D} Fetching Azure DevOps projects...");
+  try {
+    const projects = await client.getProjects();
+    console.log(`\u2705 Found ${projects.length} Azure DevOps projects
+`);
+    return projects;
+  } catch (error) {
+    console.error("\u274C Failed to fetch ADO projects:", error.message);
+    throw error;
+  }
 }
-// ============================================================================
-// Interactive Project Selection
-// ============================================================================
-/**
- * Interactive project selector with search and pagination
- */
-export async function selectAdoProjects(client, options = {}) {
-    const { allowManualEntry = true, allowSelectAll = true, preSelected = [], minSelection = 1, maxSelection, pageSize = 15, } = options;
-    // Fetch all projects
-    const allProjects = await fetchAllAdoProjects(client);
-    if (allProjects.length === 0) {
-        console.log('⚠️  No Azure DevOps projects found');
-        return {
-            selectedNames: [],
-            method: 'interactive',
-        };
-    }
-    // Show project overview
-    console.log('📋 Available Azure DevOps Projects:\n');
-    console.log(`   Total: ${allProjects.length} projects\n`);
-    // Decide selection method
-    const { selectionMethod } = await inquirer.prompt([
+async function selectAdoProjects(client, options = {}) {
+  const {
+    allowManualEntry = true,
+    allowSelectAll = true,
+    preSelected = [],
+    minSelection = 1,
+    maxSelection,
+    pageSize = 15
+  } = options;
+  const allProjects = await fetchAllAdoProjects(client);
+  if (allProjects.length === 0) {
+    console.log("\u26A0\uFE0F  No Azure DevOps projects found");
+    return {
+      selectedNames: [],
+      method: "interactive"
+    };
+  }
+  console.log("\u{1F4CB} Available Azure DevOps Projects:\n");
+  console.log(`   Total: ${allProjects.length} projects
+`);
+  const { selectionMethod } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "selectionMethod",
+      message: "How would you like to select projects?",
+      choices: [
         {
-            type: 'list',
-            name: 'selectionMethod',
-            message: 'How would you like to select projects?',
-            choices: [
-                {
-                    name: `📋 Interactive (browse and select from ${allProjects.length} projects)`,
-                    value: 'interactive',
-                },
-                {
-                    name: '✏️  Manual entry (type project names)',
-                    value: 'manual',
-                },
-                ...(allowSelectAll
-                    ? [
-                        {
-                            name: `✨ Select all (${allProjects.length} projects)`,
-                            value: 'all',
-                        },
-                    ]
-                    : []),
-            ],
+          name: `\u{1F4CB} Interactive (browse and select from ${allProjects.length} projects)`,
+          value: "interactive"
         },
-    ]);
-    if (selectionMethod === 'all') {
-        return {
-            selectedNames: allProjects.map((p) => p.name),
-            method: 'all',
-        };
-    }
-    if (selectionMethod === 'manual') {
-        return await manualProjectEntry(allProjects, minSelection, maxSelection);
-    }
-    // Interactive selection
-    return await interactiveProjectSelection(allProjects, preSelected, minSelection, maxSelection, pageSize);
-}
-/**
- * Interactive project selection with checkbox
- */
-async function interactiveProjectSelection(allProjects, preSelected, minSelection, maxSelection, pageSize) {
-    console.log('💡 Use <space> to select, <a> to toggle all, <i> to invert\n');
-    const choices = allProjects.map((p) => ({
-        name: formatProjectChoice(p),
-        value: p.name,
-        checked: preSelected.includes(p.name),
-    }));
-    // Add manual entry option at the end
-    choices.push(new inquirer.Separator(), {
-        name: '✏️  Enter project names manually instead',
-        value: '__MANUAL__',
-        checked: false,
-    });
-    const { selectedNames } = await inquirer.prompt([
         {
-            type: 'checkbox',
-            name: 'selectedNames',
-            message: `Select Azure DevOps projects (${minSelection}${maxSelection ? `-${maxSelection}` : '+'} required):`,
-            choices,
-            pageSize,
-            loop: false,
-            validate: (selected) => {
-                const actualSelected = selected.filter((k) => k !== '__MANUAL__');
-                if (actualSelected.length < minSelection) {
-                    return `Please select at least ${minSelection} project(s)`;
-                }
-                if (maxSelection && actualSelected.length > maxSelection) {
-                    return `Please select at most ${maxSelection} project(s)`;
-                }
-                return true;
-            },
+          name: "\u270F\uFE0F  Manual entry (type project names)",
+          value: "manual"
         },
-    ]);
-    // Check if user chose manual entry
-    if (selectedNames.includes('__MANUAL__')) {
-        return await manualProjectEntry(allProjects, minSelection, maxSelection);
+        ...allowSelectAll ? [
+          {
+            name: `\u2728 Select all (${allProjects.length} projects)`,
+            value: "all"
+          }
+        ] : []
+      ]
     }
-    console.log(`\n✅ Selected ${selectedNames.length} projects: ${selectedNames.join(', ')}\n`);
+  ]);
+  if (selectionMethod === "all") {
     return {
-        selectedNames,
-        method: 'interactive',
+      selectedNames: allProjects.map((p) => p.name),
+      method: "all"
     };
+  }
+  if (selectionMethod === "manual") {
+    return await manualProjectEntry(allProjects, minSelection, maxSelection);
+  }
+  return await interactiveProjectSelection(
+    allProjects,
+    preSelected,
+    minSelection,
+    maxSelection,
+    pageSize
+  );
 }
-/**
- * Manual project name entry (comma-separated)
- */
-async function manualProjectEntry(allProjects, minSelection, maxSelection) {
-    console.log('\n📝 Enter project names manually\n');
-    console.log('💡 Format: Comma-separated project names (e.g., AI Meme Generator,Project 2,Project 3)\n');
-    if (allProjects.length > 0) {
-        console.log('Available project names:');
-        console.log(allProjects
-            .map((p) => p.name)
-            .join(', ')
-            .substring(0, 100) + (allProjects.length > 20 ? '...' : ''));
-        console.log('');
+async function interactiveProjectSelection(allProjects, preSelected, minSelection, maxSelection, pageSize) {
+  console.log("\u{1F4A1} Use <space> to select, <a> to toggle all, <i> to invert\n");
+  const choices = allProjects.map((p) => ({
+    name: formatProjectChoice(p),
+    value: p.name,
+    checked: preSelected.includes(p.name)
+  }));
+  choices.push(
+    new inquirer.Separator(),
+    {
+      name: "\u270F\uFE0F  Enter project names manually instead",
+      value: "__MANUAL__",
+      checked: false
     }
-    const { manualNames } = await inquirer.prompt([
-        {
-            type: 'input',
-            name: 'manualNames',
-            message: 'Project names:',
-            validate: (input) => {
-                if (!input.trim()) {
-                    return 'Please enter at least one project name';
-                }
-                const names = input
-                    .split(',')
-                    .map((n) => n.trim())
-                    .filter((n) => n.length > 0);
-                if (names.length < minSelection) {
-                    return `Please enter at least ${minSelection} project name(s)`;
-                }
-                if (maxSelection && names.length > maxSelection) {
-                    return `Please enter at most ${maxSelection} project name(s)`;
-                }
-                return true;
-            },
-        },
-    ]);
-    const selectedNames = manualNames
-        .split(',')
-        .map((n) => n.trim())
-        .filter((n) => n.length > 0);
-    // Warn about unknown projects
-    const knownNames = allProjects.map((p) => p.name);
-    const unknownNames = selectedNames.filter((n) => !knownNames.includes(n));
-    if (unknownNames.length > 0) {
-        console.log(`\n⚠️  Unknown project names (will be used anyway): ${unknownNames.join(', ')}`);
-        console.log('   Make sure these projects exist in your Azure DevOps organization.\n');
+  );
+  const { selectedNames } = await inquirer.prompt([
+    {
+      type: "checkbox",
+      name: "selectedNames",
+      message: `Select Azure DevOps projects (${minSelection}${maxSelection ? `-${maxSelection}` : "+"} required):`,
+      choices,
+      pageSize,
+      loop: false,
+      validate: (selected) => {
+        const actualSelected = selected.filter((k) => k !== "__MANUAL__");
+        if (actualSelected.length < minSelection) {
+          return `Please select at least ${minSelection} project(s)`;
+        }
+        if (maxSelection && actualSelected.length > maxSelection) {
+          return `Please select at most ${maxSelection} project(s)`;
+        }
+        return true;
+      }
     }
-    console.log(`✅ Selected ${selectedNames.length} projects: ${selectedNames.join(', ')}\n`);
-    return {
-        selectedNames,
-        method: 'manual',
-    };
+  ]);
+  if (selectedNames.includes("__MANUAL__")) {
+    return await manualProjectEntry(allProjects, minSelection, maxSelection);
+  }
+  console.log(`
+\u2705 Selected ${selectedNames.length} projects: ${selectedNames.join(", ")}
+`);
+  return {
+    selectedNames,
+    method: "interactive"
+  };
+}
+async function manualProjectEntry(allProjects, minSelection, maxSelection) {
+  console.log("\n\u{1F4DD} Enter project names manually\n");
+  console.log("\u{1F4A1} Format: Comma-separated project names (e.g., AI Meme Generator,Project 2,Project 3)\n");
+  if (allProjects.length > 0) {
+    console.log("Available project names:");
+    console.log(
+      allProjects.map((p) => p.name).join(", ").substring(0, 100) + (allProjects.length > 20 ? "..." : "")
+    );
+    console.log("");
+  }
+  const { manualNames } = await inquirer.prompt([
+    {
+      type: "input",
+      name: "manualNames",
+      message: "Project names:",
+      validate: (input) => {
+        if (!input.trim()) {
+          return "Please enter at least one project name";
+        }
+        const names = input.split(",").map((n) => n.trim()).filter((n) => n.length > 0);
+        if (names.length < minSelection) {
+          return `Please enter at least ${minSelection} project name(s)`;
+        }
+        if (maxSelection && names.length > maxSelection) {
+          return `Please enter at most ${maxSelection} project name(s)`;
+        }
+        return true;
+      }
+    }
+  ]);
+  const selectedNames = manualNames.split(",").map((n) => n.trim()).filter((n) => n.length > 0);
+  const knownNames = allProjects.map((p) => p.name);
+  const unknownNames = selectedNames.filter((n) => !knownNames.includes(n));
+  if (unknownNames.length > 0) {
+    console.log(`
+\u26A0\uFE0F  Unknown project names (will be used anyway): ${unknownNames.join(", ")}`);
+    console.log("   Make sure these projects exist in your Azure DevOps organization.\n");
+  }
+  console.log(`\u2705 Selected ${selectedNames.length} projects: ${selectedNames.join(", ")}
+`);
+  return {
+    selectedNames,
+    method: "manual"
+  };
 }
-// ============================================================================
-// Helpers
-// ============================================================================
-/**
- * Format project choice for display
- */
 function formatProjectChoice(project) {
-    const visibility = project.visibility || 'private';
-    const state = project.state || 'wellFormed';
-    return `${project.name.padEnd(30)} - ${project.description || 'No description'} (${visibility}, ${state})`;
+  const visibility = project.visibility || "private";
+  const state = project.state || "wellFormed";
+  return `${project.name.padEnd(30)} - ${project.description || "No description"} (${visibility}, ${state})`;
 }
-/**
- * Quick project selector - select single project
- */
-export async function selectSingleAdoProject(client, message = 'Select Azure DevOps project:') {
-    const result = await selectAdoProjects(client, {
-        allowManualEntry: true,
-        allowSelectAll: false,
-        minSelection: 1,
-        maxSelection: 1,
-    });
-    return result.selectedNames[0];
+async function selectSingleAdoProject(client, message = "Select Azure DevOps project:") {
+  const result = await selectAdoProjects(client, {
+    allowManualEntry: true,
+    allowSelectAll: false,
+    minSelection: 1,
+    maxSelection: 1
+  });
+  return result.selectedNames[0];
 }
-//# sourceMappingURL=project-selector.js.map
+export {
+  fetchAllAdoProjects,
+  selectAdoProjects,
+  selectSingleAdoProject
+};

package/plugins/specweave-docs/skills/docusaurus/SKILL.md

@@ -1,15 +1,29 @@
 ---
 name: docusaurus
-description: Expert in generating Docusaurus documentation sites from SpecWeave structure. Converts .specweave/docs/public/ into a beautiful, deployable static site with search, versioning, and hosting options. Activates for docusaurus, create docs site, generate documentation, public docs, documentation site, host docs, deploy documentation, static site generator, client documentation.
+description: Expert in generating beautiful Docusaurus documentation sites from SpecWeave structure. ALWAYS use this for internal docs preview, browsing docs locally, viewing documentation in browser. Converts .specweave/docs/internal/ and .specweave/docs/public/ into beautiful, searchable sites with navigation, search, and Mermaid diagrams. Activates for preview internal docs, view docs locally, see docs in browser, browse documentation, internal docs preview, docusaurus, create docs site, generate documentation, public docs, documentation site, host docs, deploy documentation, static site generator, client documentation, engineering playbook, dual docs sites.
 ---
 
 # Docusaurus Documentation Generator
 
-Expert skill for creating production-ready Docusaurus documentation sites from SpecWeave public documentation.
+Expert skill for creating production-ready Docusaurus documentation sites from SpecWeave documentation.
+
+## 🚨 CRITICAL: Default Behavior for Internal Docs Preview
+
+**When users ask to preview/view/browse internal docs locally:**
+
+1. **IMMEDIATELY** invoke `/specweave-docs-preview:preview` command
+2. This launches a beautiful Docusaurus site with:
+   - Auto-generated navigation from folder structure
+   - Search functionality
+   - Mermaid diagram rendering
+   - Hot reload for live editing
+   - Professional theming
+3. **DO NOT** use basic file serving or simple markdown rendering
+4. **ALWAYS** prefer Docusaurus for the best user experience
 
 ## What This Skill Does
 
-Converts your SpecWeave public documentation (`.specweave/docs/public/`) into a beautiful, searchable, deployable documentation website using Docusaurus v3.
+Converts your SpecWeave documentation (`.specweave/docs/internal/` or `.specweave/docs/public/`) into a beautiful, searchable, deployable documentation website using Docusaurus v3.
 
 ## Key Capabilities
 

package/plugins/specweave-docs-preview/commands/preview.md

@@ -7,6 +7,19 @@ description: Launch interactive documentation preview server with Docusaurus. Au
 
 Launch an interactive Docusaurus development server to preview your SpecWeave living documentation.
 
+## 🎨 Beautiful Docusaurus Experience
+
+**This command ALWAYS uses Docusaurus** - not basic file serving! You get:
+- ✅ Auto-generated navigation from folder structure
+- ✅ Search functionality (instant local search)
+- ✅ Beautiful theming (light/dark mode)
+- ✅ Mermaid diagram rendering
+- ✅ Hot reload (edit markdown, see changes instantly)
+- ✅ Professional typography and layout
+- ✅ Mobile responsive design
+
+**Never settle for basic markdown rendering when you can have this!**
+
 ## Your Task
 
 Execute the following workflow to launch the documentation preview server:
@@ -45,13 +58,25 @@ const docsConfig = config.documentation?.preview || {
 };
 ```
 
-### Step 3: Check if Documentation Preview is Enabled
+### Step 3: Check if Documentation Preview is Enabled (Auto-Enable if Needed)
 
 ```typescript
 if (!docsConfig.enabled) {
-  console.log('📚 Documentation preview is disabled in config.');
-  console.log('   To enable, set documentation.preview.enabled = true in .specweave/config.json');
-  process.exit(0);
+  console.log('📚 Documentation preview is currently disabled.');
+  console.log('   Enabling it now for beautiful Docusaurus experience...\n');
+
+  // Auto-enable the feature
+  config.documentation = config.documentation || {};
+  config.documentation.preview = {
+    ...docsConfig,
+    enabled: true,
+    autoInstall: true
+  };
+
+  // Save updated config
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+
+  console.log('✅ Documentation preview enabled!\n');
 }
 ```
 

package/plugins/specweave-github/hooks/hooks.json

@@ -10,6 +10,17 @@
           }
         ]
       }
+    ],
+    "PostSlashCommand": [
+      {
+        "matcher": "specweave:specweave-done",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-increment-done.sh"
+          }
+        ]
+      }
     ]
   }
 }