@devo-bmad-custom/agent-orchestration 1.0.0

package/bin/bmad.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * bmad-package/bin/bmad.js
+ * NPX entry point — handles npx temp-directory path issues, then delegates to CLI.
+ */
+'use strict';
+
+const path = require('path');
+const { execSync } = require('child_process');
+
+const cliPath = path.join(__dirname, '..', 'lib', 'cli.js');
+const isNpx = __dirname.includes('_npx') || __dirname.includes('.npm') || __dirname.includes('npx');
+
+// Inject 'install' as default subcommand when none is provided
+const SUBCOMMANDS = ['install', 'update', 'status', 'platforms', 'tmux'];
+const userArgs = process.argv.slice(2);
+const hasSubcommand = userArgs.length > 0 && SUBCOMMANDS.includes(userArgs[0]);
+const effectiveArgs = hasSubcommand ? userArgs : ['install', ...userArgs];
+
+if (isNpx) {
+  // When running via npx, CWD is the user's project — spawn with correct CWD
+  const args = effectiveArgs.map(a => JSON.stringify(a)).join(' ');
+  try {
+    execSync(`node ${JSON.stringify(cliPath)} ${args}`, {
+      cwd: process.cwd(),
+      stdio: 'inherit',
+      env: process.env,
+    });
+  } catch (e) {
+    process.exit(e.status || 1);
+  }
+} else {
+  // Rewrite argv so Commander sees the effective args
+  process.argv = [process.argv[0], process.argv[1], ...effectiveArgs];
+  require(cliPath);
+}

package/lib/cli.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+/**
+ * bmad-package/lib/cli.js
+ * Main CLI — parses commands and delegates to installer.
+ */
+'use strict';
+
+const { Command } = require('commander');
+const path = require('path');
+const pkg = require('../package.json');
+
+const SUPPORTED_TOOLS = [
+  'claude-code',
+  'cursor',
+  'windsurf',
+  'cline',
+  'github-copilot',
+  'gemini',
+].join(', ');
+
+const program = new Command();
+
+program
+  .name('bmad')
+  .description('BMAD Method — install AI-native agile workflows into your project')
+  .version(pkg.version);
+
+// ─── install (default) ────────────────────────────────────────────────────────
+
+program
+  .command('install', { isDefault: true })
+  .description('Install BMAD into the current project (default command — runs on `npx @devo-bmad-custom/agent-orchestration`)')
+  .option('-d, --directory <path>', 'Target project root', process.cwd())
+  .option('-m, --modules <ids>', 'Modules to install (comma-separated: bmm,bmb,core,_memory)', 'bmm,bmb,core,_memory')
+  .option('--tools <ids>', `IDE integrations to configure (comma-separated). Supported: ${SUPPORTED_TOOLS}`, 'claude-code')
+  .option('--user-name <name>', 'Your name (written into config.yaml)', '')
+  .option('--output-folder <path>', 'Output folder for BMAD artifacts', '_bmad-output')
+  .option('-y, --yes', 'Skip interactive prompts and accept all defaults', false)
+  .addHelpText('after', `
+Examples:
+  # Interactive install — prompts for your name, detects existing installation
+  npx @devo-bmad-custom/agent-orchestration
+
+  # Non-interactive, install everything
+  npx @devo-bmad-custom/agent-orchestration --yes
+
+  # Install with specific IDEs
+  npx @devo-bmad-custom/agent-orchestration --tools claude-code,cursor,windsurf --yes
+
+  # Install into a specific directory
+  npx @devo-bmad-custom/agent-orchestration --directory /path/to/project --yes
+`)
+  .action(async (opts) => {
+    const { install } = require('./installer');
+    await install(opts);
+  });
+
+// ─── update ───────────────────────────────────────────────────────────────────
+
+program
+  .command('update')
+  .description('Update an existing BMAD installation — adds/removes files to match new version, preserves config.yaml')
+  .option('-d, --directory <path>', 'Target project root', process.cwd())
+  .option('-m, --modules <ids>', 'Modules to update (defaults to all installed modules)', 'bmm,bmb,core,_memory')
+  .option('--tools <ids>', `IDE integrations to re-configure (comma-separated). Supported: ${SUPPORTED_TOOLS}`, 'claude-code')
+  .option('-y, --yes', 'Skip interactive prompts', false)
+  .addHelpText('after', `
+Examples:
+  # Interactive update — shows installed version, preserves your name
+  npx @devo-bmad-custom/agent-orchestration update
+
+  # Non-interactive update
+  npx @devo-bmad-custom/agent-orchestration update --yes
+
+  # Update and add Cursor support
+  npx @devo-bmad-custom/agent-orchestration update --tools claude-code,cursor --yes
+`)
+  .action(async (opts) => {
+    const { install } = require('./installer');
+    await install({ ...opts, action: 'update' });
+  });
+
+// ─── status ───────────────────────────────────────────────────────────────────
+
+program
+  .command('status')
+  .description('Show current BMAD installation status, version, and tracked file count')
+  .option('-d, --directory <path>', 'Target project root', process.cwd())
+  .action(async (opts) => {
+    const { status } = require('./installer');
+    await status(opts);
+  });
+
+// ─── platforms ────────────────────────────────────────────────────────────────
+
+program
+  .command('platforms')
+  .description('List all supported IDE platforms and the files they configure')
+  .action(() => {
+    console.log('\nSupported IDE platforms:\n');
+    const rows = [
+      ['Platform ID',      'Label',            'Rules file',                        'Agent stubs'],
+      ['claude-code',      'Claude Code',       '.claude/CLAUDE.md',                 '.claude/agents/'],
+      ['cursor',           'Cursor',            '.cursor/rules/bmad.mdc',            '—'],
+      ['windsurf',         'Windsurf',          '.windsurfrules',                    '—'],
+      ['cline',            'Cline',             '.clinerules',                       '—'],
+      ['github-copilot',   'GitHub Copilot',    '.github/copilot-instructions.md',   '—'],
+      ['gemini',           'Gemini CLI',        'GEMINI.md',                         '—'],
+    ];
+    const widths = rows[0].map((_, i) => Math.max(...rows.map(r => r[i].length)));
+    for (const row of rows) {
+      console.log('  ' + row.map((cell, i) => cell.padEnd(widths[i])).join('   '));
+    }
+    console.log('\nPass multiple platforms with --tools:\n  npx @devo-bmad-custom/agent-orchestration --tools claude-code,cursor,windsurf\n');
+  });
+
+// ─── tmux ─────────────────────────────────────────────────────────────────────
+
+program
+  .command('tmux')
+  .description('Set up tmux for AI agent workflows — writes config, scripts, and walks through WSL prerequisites')
+  .option('-d, --directory <path>', 'Project root (used for squid/squid-claude aliases)', process.cwd())
+  .addHelpText('after', `
+Examples:
+  # Interactive tmux setup
+  npx @devo-bmad-custom/agent-orchestration tmux
+
+  # tmux setup for a specific project directory
+  npx @devo-bmad-custom/agent-orchestration tmux --directory /path/to/project
+`)
+  .action(async (opts) => {
+    const { setupTmux } = require('./installer');
+    const chalk = (await import('chalk')).default;
+    await setupTmux(path.resolve(opts.directory), chalk);
+  });
+
+program.parse();

package/lib/filter.js

@@ -0,0 +1,73 @@
+'use strict';
+/**
+ * bmad-package/lib/filter.js
+ * Determines which files and directories to exclude from the generic BMAD package.
+ * Filters out Squidhub-specific content (unnportal, nautilus, squid-master, etc.)
+ */
+
+/**
+ * Path segments that indicate a file/dir is Squidhub-specific.
+ * Any file whose relative path contains one of these strings is excluded.
+ */
+const EXCLUDED_PATH_PATTERNS = [
+  'squidhub',            // _bmad/squidhub/ module
+  'squid-master',        // squid-master agent and sidecar
+  'tech-writer-sidecar', // project-specific sidecar
+  'mcp-standards',       // _bmad/bmm/data/mcp-standards.md  (squidhub MCP docs)
+  '.backup',             // stale backup files
+  '.bak',                // stale backup files
+];
+
+/**
+ * Content patterns that mark a file as Squidhub-specific.
+ * If a text file's content matches any of these, it is excluded.
+ */
+const EXCLUDED_CONTENT_PATTERNS = [
+  /squidhub 2\.1/i,
+  /unnportal\.io/i,
+  /nautilus/i,
+  /squid-master/i,
+  /UNN-\d+/,             // Linear issue references
+  /mcp__squidhub__/i,    // Squidhub MCP tool calls
+];
+
+/**
+ * Returns true if the given relative file path should be excluded.
+ * @param {string} relPath - Path relative to the _bmad/ root
+ */
+function isExcludedPath(relPath) {
+  const normalized = relPath.replace(/\\/g, '/').toLowerCase();
+  return EXCLUDED_PATH_PATTERNS.some(p => normalized.includes(p));
+}
+
+/**
+ * Returns true if the file content contains Squidhub-specific markers.
+ * Only called for text files.
+ * @param {string} content - File content as string
+ */
+function isExcludedContent(content) {
+  return EXCLUDED_CONTENT_PATTERNS.some(re => re.test(content));
+}
+
+/**
+ * Text file extensions that should be scanned for content patterns.
+ */
+const TEXT_EXTENSIONS = new Set([
+  '.md', '.yaml', '.yml', '.json', '.xml', '.csv', '.txt', '.js', '.sh',
+]);
+
+/**
+ * Returns true if a file should be excluded from the generic package.
+ * @param {string} relPath - Relative path from _bmad/ root
+ * @param {string|null} content - File content (null for binaries/unread)
+ */
+function shouldExclude(relPath, content = null) {
+  if (isExcludedPath(relPath)) return true;
+  if (content !== null) {
+    const ext = relPath.substring(relPath.lastIndexOf('.')).toLowerCase();
+    if (TEXT_EXTENSIONS.has(ext) && isExcludedContent(content)) return true;
+  }
+  return false;
+}
+
+module.exports = { shouldExclude, isExcludedPath, isExcludedContent, TEXT_EXTENSIONS };