specweave 0.13.6 → 0.15.0

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

@@ -1,183 +1,211 @@
-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;
-  }
+/**
+ * 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;
+    }
 }
-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: [
+// ============================================================================
+// 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([
         {
-          name: `\u{1F4CB} Interactive (browse and select from ${allProjects.length} projects)`,
-          value: "interactive"
+            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',
+                        },
+                    ]
+                    : []),
+            ],
         },
+    ]);
+    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([
         {
-          name: "\u270F\uFE0F  Manual entry (type project names)",
-          value: "manual"
+            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;
+            },
         },
-        ...allowSelectAll ? [
-          {
-            name: `\u2728 Select all (${allProjects.length} projects)`,
-            value: "all"
-          }
-        ] : []
-      ]
+    ]);
+    // Check if user chose manual entry
+    if (selectedNames.includes('__MANUAL__')) {
+        return await manualProjectEntry(allProjects, minSelection, maxSelection);
     }
-  ]);
-  if (selectionMethod === "all") {
+    console.log(`\n✅ Selected ${selectedNames.length} projects: ${selectedNames.join(', ')}\n`);
     return {
-      selectedNames: allProjects.map((p) => p.name),
-      method: "all"
+        selectedNames,
+        method: 'interactive',
     };
-  }
-  if (selectionMethod === "manual") {
-    return await manualProjectEntry(allProjects, minSelection, maxSelection);
-  }
-  return await interactiveProjectSelection(
-    allProjects,
-    preSelected,
-    minSelection,
-    maxSelection,
-    pageSize
-  );
-}
-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 { 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;
-      }
-    }
-  ]);
-  if (selectedNames.includes("__MANUAL__")) {
-    return await manualProjectEntry(allProjects, minSelection, maxSelection);
-  }
-  console.log(`
-\u2705 Selected ${selectedNames.length} projects: ${selectedNames.join(", ")}
-`);
-  return {
-    selectedNames,
-    method: "interactive"
-  };
 }
+/**
+ * Manual project name entry (comma-separated)
+ */
 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;
-      }
+    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('');
     }
-  ]);
-  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"
-  };
+    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');
+    }
+    console.log(`✅ Selected ${selectedNames.length} projects: ${selectedNames.join(', ')}\n`);
+    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})`;
 }
-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];
+/**
+ * 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];
 }
-export {
-  fetchAllAdoProjects,
-  selectAdoProjects,
-  selectSingleAdoProject
-};
+//# sourceMappingURL=project-selector.js.map

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/lib/cli-sync-increment-changes.js

@@ -1,17 +1,28 @@
 #!/usr/bin/env node
-import { syncIncrementChanges } from "./github-sync-increment-changes.js";
+/**
+ * CLI wrapper for syncing increment changes to GitHub
+ *
+ * Usage:
+ *   node dist/plugins/specweave-github/lib/cli-sync-increment-changes.js <incrementId> <changedFile>
+ *
+ * Example:
+ *   node dist/plugins/specweave-github/lib/cli-sync-increment-changes.js 0015-hierarchical-sync spec.md
+ */
+import { syncIncrementChanges } from './github-sync-increment-changes.js';
 const incrementId = process.argv[2];
 const changedFile = process.argv[3];
 if (!incrementId || !changedFile) {
-  console.error("\u274C Usage: cli-sync-increment-changes <incrementId> <changedFile>");
-  console.error("   Example: cli-sync-increment-changes 0015-hierarchical-sync spec.md");
-  process.exit(1);
+    console.error('❌ Usage: cli-sync-increment-changes <incrementId> <changedFile>');
+    console.error('   Example: cli-sync-increment-changes 0015-hierarchical-sync spec.md');
+    process.exit(1);
 }
-if (!["spec.md", "plan.md", "tasks.md"].includes(changedFile)) {
-  console.error(`\u274C Invalid file: ${changedFile}`);
-  console.error("   Must be one of: spec.md, plan.md, tasks.md");
-  process.exit(1);
+if (!['spec.md', 'plan.md', 'tasks.md'].includes(changedFile)) {
+    console.error(`❌ Invalid file: ${changedFile}`);
+    console.error('   Must be one of: spec.md, plan.md, tasks.md');
+    process.exit(1);
 }
 syncIncrementChanges(incrementId, changedFile).catch((error) => {
-  console.error("\u274C Fatal error:", error);
+    console.error('❌ Fatal error:', error);
+    // Don't exit with error code - best-effort sync
 });
+//# sourceMappingURL=cli-sync-increment-changes.js.map