mdan-method 2.6.3

package/tools/cli/README.md

@@ -0,0 +1,60 @@
+# MDAN CLI Tool
+
+## Installing external repo MDAN official modules
+
+For external official modules to be discoverable during install, ensure an entry for the external repo is added to external-official-modules.yaml.
+
+For community modules - this will be handled in a different way. This file is only for registration of modules under the mdan-code-org.
+
+## Post-Install Notes
+
+Modules can display setup guidance to users after configuration is collected during `npx mdan install`. Notes are defined in the module's own `module.yaml` — no changes to the installer are needed.
+
+### Simple Format
+
+Always displayed after the module is configured:
+
+```yaml
+post-install-notes: |
+  Thank you for choosing the XYZ Cool Module
+  For Support about this Module call 555-1212
+```
+
+### Conditional Format
+
+Display different messages based on a config question's answer:
+
+```yaml
+post-install-notes:
+  config_key_name:
+    value1: |
+      Instructions for value1...
+    value2: |
+      Instructions for value2...
+```
+
+Values without an entry (e.g., `none`) display nothing. Multiple config keys can each have their own conditional notes.
+
+### Example: TEA Module
+
+The TEA module uses the conditional format keyed on `tea_browser_automation`:
+
+```yaml
+post-install-notes:
+  tea_browser_automation:
+    cli: |
+      Playwright CLI Setup:
+        npm install -g @playwright/cli@latest
+        playwright-cli install --skills
+    mcp: |
+      Playwright MCP Setup (two servers):
+        1. playwright    — npx @playwright/mcp@latest
+        2. playwright-test — npx playwright run-test-mcp-server
+    auto: |
+      Playwright CLI Setup:
+        ...
+      Playwright MCP Setup (two servers):
+        ...
+```
+
+When a user selects `auto`, they see both CLI and MCP instructions. When they select `none`, nothing is shown.

package/tools/cli/commands/install.js

@@ -0,0 +1,87 @@
+const path = require('node:path');
+const prompts = require('../lib/prompts');
+const { Installer } = require('../installers/lib/core/installer');
+const { UI } = require('../lib/ui');
+
+const installer = new Installer();
+const ui = new UI();
+
+module.exports = {
+  command: 'install',
+  description: 'Install MDAN Core agents and tools',
+  options: [
+    ['-d, --debug', 'Enable debug output for manifest generation'],
+    ['--directory <path>', 'Installation directory (default: current directory)'],
+    ['--modules <modules>', 'Comma-separated list of module IDs to install (e.g., "bmm,bmb")'],
+    [
+      '--tools <tools>',
+      'Comma-separated list of tool/IDE IDs to configure (e.g., "claude-code,cursor"). Use "none" to skip tool configuration.',
+    ],
+    ['--custom-content <paths>', 'Comma-separated list of paths to custom modules/agents/workflows'],
+    ['--action <type>', 'Action type for existing installations: install, update, quick-update, or compile-agents'],
+    ['--user-name <name>', 'Name for agents to use (default: system username)'],
+    ['--communication-language <lang>', 'Language for agent communication (default: English)'],
+    ['--document-output-language <lang>', 'Language for document output (default: English)'],
+    ['--output-folder <path>', 'Output folder path relative to project root (default: _mdan-output)'],
+    ['-y, --yes', 'Accept all defaults and skip prompts where possible'],
+  ],
+  action: async (options) => {
+    try {
+      // Set debug flag as environment variable for all components
+      if (options.debug) {
+        process.env.MDAN_DEBUG_MANIFEST = 'true';
+        await prompts.log.info('Debug mode enabled');
+      }
+
+      const config = await ui.promptInstall(options);
+
+      // Handle cancel
+      if (config.actionType === 'cancel') {
+        await prompts.log.warn('Installation cancelled.');
+        process.exit(0);
+      }
+
+      // Handle quick update separately
+      if (config.actionType === 'quick-update') {
+        const result = await installer.quickUpdate(config);
+        await prompts.log.success('Quick update complete!');
+        await prompts.log.info(`Updated ${result.moduleCount} modules with preserved settings (${result.modules.join(', ')})`);
+        process.exit(0);
+      }
+
+      // Handle compile agents separately
+      if (config.actionType === 'compile-agents') {
+        const result = await installer.compileAgents(config);
+        await prompts.log.info(`Recompiled ${result.agentCount} agents with customizations applied`);
+        process.exit(0);
+      }
+
+      // Regular install/update flow
+      const result = await installer.install(config);
+
+      // Check if installation was cancelled
+      if (result && result.cancelled) {
+        process.exit(0);
+      }
+
+      // Check if installation succeeded
+      if (result && result.success) {
+        process.exit(0);
+      }
+    } catch (error) {
+      try {
+        if (error.fullMessage) {
+          await prompts.log.error(error.fullMessage);
+        } else {
+          await prompts.log.error(`Installation failed: ${error.message}`);
+        }
+        if (error.stack) {
+          await prompts.log.message(error.stack);
+        }
+      } catch {
+        console.error(error.fullMessage || error.message || error);
+      }
+      process.exit(1);
+    }
+  },
+};

package/tools/cli/commands/status.js

@@ -0,0 +1,65 @@
+const path = require('node:path');
+const prompts = require('../lib/prompts');
+const { Installer } = require('../installers/lib/core/installer');
+const { Manifest } = require('../installers/lib/core/manifest');
+const { UI } = require('../lib/ui');
+
+const installer = new Installer();
+const manifest = new Manifest();
+const ui = new UI();
+
+module.exports = {
+  command: 'status',
+  description: 'Display MDAN installation status and module versions',
+  options: [],
+  action: async (options) => {
+    try {
+      // Find the mdan directory
+      const projectDir = process.cwd();
+      const { mdanDir } = await installer.findMdanDir(projectDir);
+
+      // Check if mdan directory exists
+      const fs = require('fs-extra');
+      if (!(await fs.pathExists(mdanDir))) {
+        await prompts.log.warn('No MDAN installation found in the current directory.');
+        await prompts.log.message(`Expected location: ${mdanDir}`);
+        await prompts.log.message('Run "mdan install" to set up a new installation.');
+        process.exit(0);
+        return;
+      }
+
+      // Read manifest
+      const manifestData = await manifest._readRaw(mdanDir);
+
+      if (!manifestData) {
+        await prompts.log.warn('No MDAN installation manifest found.');
+        await prompts.log.message('Run "mdan install" to set up a new installation.');
+        process.exit(0);
+        return;
+      }
+
+      // Get installation info
+      const installation = manifestData.installation || {};
+      const modules = manifestData.modules || [];
+
+      // Check for available updates (only for external modules)
+      const availableUpdates = await manifest.checkForUpdates(mdanDir);
+
+      // Display status
+      await ui.displayStatus({
+        installation,
+        modules,
+        availableUpdates,
+        mdanDir,
+      });
+
+      process.exit(0);
+    } catch (error) {
+      await prompts.log.error(`Status check failed: ${error.message}`);
+      if (process.env.MDAN_DEBUG) {
+        await prompts.log.message(error.stack);
+      }
+      process.exit(1);
+    }
+  },
+};

package/tools/cli/commands/uninstall.js

@@ -0,0 +1,167 @@
+const path = require('node:path');
+const fs = require('fs-extra');
+const prompts = require('../lib/prompts');
+const { Installer } = require('../installers/lib/core/installer');
+
+const installer = new Installer();
+
+module.exports = {
+  command: 'uninstall',
+  description: 'Remove MDAN installation from the current project',
+  options: [
+    ['-y, --yes', 'Remove all MDAN components without prompting (preserves user artifacts)'],
+    ['--directory <path>', 'Project directory (default: current directory)'],
+  ],
+  action: async (options) => {
+    try {
+      let projectDir;
+
+      if (options.directory) {
+        // Explicit --directory flag takes precedence
+        projectDir = path.resolve(options.directory);
+      } else if (options.yes) {
+        // Non-interactive mode: use current directory
+        projectDir = process.cwd();
+      } else {
+        // Interactive: ask user which directory to uninstall from
+        // select() handles cancellation internally (exits process)
+        const dirChoice = await prompts.select({
+          message: 'Where do you want to uninstall MDAN from?',
+          choices: [
+            { value: 'cwd', name: `Current directory (${process.cwd()})` },
+            { value: 'other', name: 'Another directory...' },
+          ],
+        });
+
+        if (dirChoice === 'other') {
+          // text() handles cancellation internally (exits process)
+          const customDir = await prompts.text({
+            message: 'Enter the project directory path:',
+            placeholder: process.cwd(),
+            validate: (value) => {
+              if (!value || value.trim().length === 0) return 'Directory path is required';
+            },
+          });
+
+          projectDir = path.resolve(customDir.trim());
+        } else {
+          projectDir = process.cwd();
+        }
+      }
+
+      if (!(await fs.pathExists(projectDir))) {
+        await prompts.log.error(`Directory does not exist: ${projectDir}`);
+        process.exit(1);
+      }
+
+      const { mdanDir } = await installer.findMdanDir(projectDir);
+
+      if (!(await fs.pathExists(mdanDir))) {
+        await prompts.log.warn('No MDAN installation found.');
+        process.exit(0);
+      }
+
+      const existingInstall = await installer.getStatus(projectDir);
+      const version = existingInstall.version || 'unknown';
+      const modules = (existingInstall.modules || []).map((m) => m.id || m.name).join(', ');
+      const ides = (existingInstall.ides || []).join(', ');
+
+      const outputFolder = await installer.getOutputFolder(projectDir);
+
+      await prompts.intro('MDAN Uninstall');
+      await prompts.note(`Version: ${version}\nModules: ${modules}\nIDE integrations: ${ides}`, 'Current Installation');
+
+      let removeModules = true;
+      let removeIdeConfigs = true;
+      let removeOutputFolder = false;
+
+      if (!options.yes) {
+        // multiselect() handles cancellation internally (exits process)
+        const selected = await prompts.multiselect({
+          message: 'Select components to remove:',
+          options: [
+            {
+              value: 'modules',
+              label: `MDAN Modules & data (${installer.mdanFolderName}/)`,
+              hint: 'Core installation, agents, workflows, config',
+            },
+            { value: 'ide', label: 'IDE integrations', hint: ides || 'No IDEs configured' },
+            { value: 'output', label: `User artifacts (${outputFolder}/)`, hint: 'WARNING: Contains your work products' },
+          ],
+          initialValues: ['modules', 'ide'],
+          required: true,
+        });
+
+        removeModules = selected.includes('modules');
+        removeIdeConfigs = selected.includes('ide');
+        removeOutputFolder = selected.includes('output');
+
+        const red = (s) => `\u001B[31m${s}\u001B[0m`;
+        await prompts.note(
+          red('💀 This action is IRREVERSIBLE! Removed files cannot be recovered!') +
+            '\n' +
+            red('💀 IDE configurations and modules will need to be reinstalled.') +
+            '\n' +
+            red('💀 User artifacts are preserved unless explicitly selected.'),
+          '!! DESTRUCTIVE ACTION !!',
+        );
+
+        const confirmed = await prompts.confirm({
+          message: 'Proceed with uninstall?',
+          default: false,
+        });
+
+        if (!confirmed) {
+          await prompts.outro('Uninstall cancelled.');
+          process.exit(0);
+        }
+      }
+
+      // Phase 1: IDE integrations
+      if (removeIdeConfigs) {
+        const s = await prompts.spinner();
+        s.start('Removing IDE integrations...');
+        await installer.uninstallIdeConfigs(projectDir, existingInstall, { silent: true });
+        s.stop(`Removed IDE integrations (${ides || 'none'})`);
+      }
+
+      // Phase 2: User artifacts
+      if (removeOutputFolder) {
+        const s = await prompts.spinner();
+        s.start(`Removing user artifacts (${outputFolder}/)...`);
+        await installer.uninstallOutputFolder(projectDir, outputFolder);
+        s.stop('User artifacts removed');
+      }
+
+      // Phase 3: MDAN modules & data (last — other phases may need _.mdan/)
+      if (removeModules) {
+        const s = await prompts.spinner();
+        s.start(`Removing MDAN modules & data (${installer.mdanFolderName}/)...`);
+        await installer.uninstallModules(projectDir);
+        s.stop('Modules & data removed');
+      }
+
+      const summary = [];
+      if (removeIdeConfigs) summary.push('IDE integrations cleaned');
+      if (removeModules) summary.push('Modules & data removed');
+      if (removeOutputFolder) summary.push('User artifacts removed');
+      if (!removeOutputFolder) summary.push(`User artifacts preserved in ${outputFolder}/`);
+
+      await prompts.note(summary.join('\n'), 'Summary');
+      await prompts.outro('To reinstall, run: npx mdan install');
+
+      process.exit(0);
+    } catch (error) {
+      try {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        await prompts.log.error(`Uninstall failed: ${errorMessage}`);
+        if (error instanceof Error && error.stack) {
+          await prompts.log.message(error.stack);
+        }
+      } catch {
+        console.error(error instanceof Error ? error.message : error);
+      }
+      process.exit(1);
+    }
+  },
+};

package/tools/cli/external-official-modules.yaml

@@ -0,0 +1,53 @@
+# This file allows these modules under mdan-code-org to also be installed with the mdan method installer, while
+# allowing us to keep the source of these projects in separate repos.
+
+modules:
+  mdan-builder:
+    url: https://github.com/mdan-code-org/mdan-builder
+    module-definition: src/module.yaml
+    code: bmb
+    name: "MDAN Builder"
+    description: "Agent, Workflow and Module Builder"
+    defaultSelected: false
+    type: mdan-org
+    npmPackage: mdan-builder
+
+  mdan-creative-intelligence-suite:
+    url: https://github.com/mdan-code-org/mdan-module-creative-intelligence-suite
+    module-definition: src/module.yaml
+    code: cis
+    name: "MDAN Creative Intelligence Suite"
+    description: "Creative tools for writing, brainstorming, and more"
+    defaultSelected: false
+    type: mdan-org
+    npmPackage: mdan-creative-intelligence-suite
+
+  mdan-game-dev-studio:
+    url: https://github.com/mdan-code-org/mdan-module-game-dev-studio.git
+    module-definition: src/module.yaml
+    code: gds
+    name: "MDAN Game Dev Studio"
+    description: "Game development agents and workflows"
+    defaultSelected: false
+    type: mdan-org
+    npmPackage: mdan-game-dev-studio
+
+  mdan-test-architecture-enterprise:
+    url: https://github.com/mdan-code-org/mdan-test-architecture-enterprise
+    module-definition: src/module.yaml
+    code: tea
+    name: "Test Architect"
+    description: "Master Test Architect for quality strategy, test automation, and release gates"
+    defaultSelected: false
+    type: mdan-org
+    npmPackage: mdan-test-architecture-enterprise
+
+  # whiteport-design-system:
+  #   url: https://github.com/mdan-code-org/mdan-wds-expansion
+  #   module-definition: src/module.yaml
+  #   code: wds
+  #   name: "Whiteport UX Design System"
+  #   description: "UX design framework with Figma integration"
+  #   defaultSelected: false
+  #   type: community
+  #   npmPackage: mdan-wds-expansion

package/tools/cli/installers/install-messages.yaml

@@ -0,0 +1,39 @@
+# MDAN Installer Messages
+# These messages are displayed during installation
+# Edit this file to change what users see during the install process
+
+# Display at the START of installation (after logo, before prompts)
+startMessage: |
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  🎉 V6 IS HERE! Welcome to MDAN Method V6 - Official Stable Release!
+
+  The MDAN Method is now a Platform powered by the MDAN Method Core and Module Ecosystem!
+    - Select and install modules during setup - customize your experience
+    - New MDAN Method for Agile AI-Driven Development (the evolution of V4)
+    - Exciting new modules available during installation, with community modules coming soon
+    - Documentation: https://docs.mdan.org
+
+  🌟 MDAN is 100% free and open source.
+    - No gated Discord. No paywalls. No gated content.
+    - We believe in empowering everyone, not just those who can pay.
+    - Knowledge should be shared, not sold.
+
+  🎤 SPEAKING & MEDIA:
+    - Available for conferences, podcasts, and media appearances
+    - Topics: AI-Native Transformation, Spec and Context Engineering, MDAN Method
+    - For speaking inquiries or interviews, reach out to MDAN on Discord!
+
+  ⭐ HELP US GROW:
+    - Star us on GitHub: https://github.com/mdan-code-org/MDAN/
+    - Subscribe on YouTube: https://www.youtube.com/@MDANCode
+    - Free Community and Support: https://discord.gg/gk8jAdXWmj
+    - Donate: https://buymeacoffee.com/mdan
+    - Corporate Sponsorship available
+
+  Latest updates: https://github.com/mdan-code-org/MDAN/blob/main/CHANGELOG.md
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+# No end message - install summary and next steps are rendered by the installer
+endMessage: ""