orchestrix 15.14.0

package/bin/o8x.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+'use strict';
+
+const args = process.argv.slice(2);
+const command = args[0];
+const flags = parseFlags(args.slice(1));
+
+function parseFlags(argv) {
+  const result = { _: [] };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === '--key' && i + 1 < argv.length) {
+      result.key = argv[++i];
+    } else if (arg === '--offline') {
+      result.offline = true;
+    } else if (arg === '--force') {
+      result.force = true;
+    } else if (arg === '--no-hooks') {
+      result.noHooks = true;
+    } else if (arg === '--no-scripts') {
+      result.noScripts = true;
+    } else if (arg === '--no-mcp') {
+      result.noMcp = true;
+    } else if (arg === '--yes' || arg === '-y') {
+      result.yes = true;
+    } else {
+      result._.push(arg);
+    }
+  }
+  return result;
+}
+
+async function main() {
+  if (command === 'install' || command === 'i') {
+    const { install } = require('../lib/install');
+    await install(flags);
+  } else if (command === 'doctor' || command === 'dr') {
+    const { doctor } = require('../lib/doctor');
+    await doctor(flags);
+  } else if (command === 'upgrade' || command === 'up') {
+    const { upgrade } = require('../lib/upgrade');
+    await upgrade(flags);
+  } else if (command === 'uninstall' || command === 'rm') {
+    const { uninstall } = require('../lib/uninstall');
+    await uninstall(flags);
+  } else if (command === '--version' || command === '-v' || command === '-V') {
+    const { version } = require('../package.json');
+    console.log(version);
+  } else if (command === '--help' || command === '-h' || !command) {
+    printHelp();
+  } else {
+    console.error(`Unknown command: ${command}`);
+    console.error('Run "o8x --help" for usage information.');
+    process.exit(1);
+  }
+}
+
+function printHelp() {
+  const { version } = require('../package.json');
+  console.log(`
+  o8x v${version} — Install Orchestrix multi-agent infrastructure
+
+  Usage:
+    npx o8x install [options]       Install into current project
+    npx o8x doctor                  Check installation health
+    npx o8x upgrade                 Upgrade to latest from MCP server
+    npx o8x uninstall               Remove Orchestrix files from project
+    npx o8x --version               Show version
+    npx o8x --help                  Show this help message
+
+  Install options:
+    --key <KEY>          License key (skips interactive prompt)
+    --offline            Use embedded files only (no MCP fetch)
+    --force              Overwrite all files without confirmation
+    --no-hooks           Skip Stop hook installation
+    --no-scripts         Skip tmux scripts installation
+    --no-mcp             Skip .mcp.json modification
+    -y, --yes            Skip confirmations
+
+  Examples:
+    npx o8x install                           Interactive install
+    npx o8x install --key orch_live_xxx       Install with key
+    npx o8x install --offline                 Offline install (embedded files)
+    npx o8x doctor                            Health check
+  `);
+}
+
+main().catch((err) => {
+  console.error(`\n  Error: ${err.message}`);
+  process.exit(1);
+});

package/lib/doctor.js

@@ -0,0 +1,150 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const ui = require('./ui');
+const { validateKey } = require('./mcp-client');
+const { resolveKey } = require('./license');
+
+async function doctor(flags) {
+  ui.banner();
+  ui.header('Health Check');
+
+  const projectDir = process.cwd();
+  let allGood = true;
+
+  // 1. Node.js version
+  const nodeVersion = process.versions.node;
+  const nodeMajor = parseInt(nodeVersion.split('.')[0], 10);
+  if (nodeMajor >= 18) {
+    ui.success(`Node.js ${nodeVersion}`);
+  } else {
+    ui.error(`Node.js ${nodeVersion} (need >= 18)`);
+    allGood = false;
+  }
+
+  // 2. tmux
+  try {
+    const tmuxVersion = execSync('tmux -V', { stdio: 'pipe' }).toString().trim();
+    ui.success(`tmux: ${tmuxVersion}`);
+  } catch {
+    ui.warn('tmux not installed (needed for multi-agent automation)');
+    ui.log(`  Install: brew install tmux (macOS) or sudo apt install tmux (Linux)`);
+  }
+
+  // 3. .mcp.json
+  const mcpPath = path.join(projectDir, '.mcp.json');
+  if (fs.existsSync(mcpPath)) {
+    try {
+      const mcp = JSON.parse(fs.readFileSync(mcpPath, 'utf-8'));
+      if (mcp.mcpServers && mcp.mcpServers.orchestrix) {
+        ui.success(`.mcp.json: orchestrix entry found (${mcp.mcpServers.orchestrix.url})`);
+      } else {
+        ui.error('.mcp.json: missing orchestrix entry');
+        allGood = false;
+      }
+    } catch {
+      ui.error('.mcp.json: invalid JSON');
+      allGood = false;
+    }
+  } else {
+    ui.error('.mcp.json: not found');
+    allGood = false;
+  }
+
+  // 4. License key + MCP server
+  try {
+    const key = await resolveKey({ ...flags, key: flags.key || process.env.ORCHESTRIX_LICENSE_KEY });
+    const result = await validateKey(key);
+    if (result.valid) {
+      ui.success(`MCP server: reachable (tier: ${result.tier})`);
+    } else {
+      ui.warn(`MCP server: ${result.error}`);
+    }
+  } catch {
+    ui.warn('License key not found — MCP server check skipped');
+  }
+
+  // 5. Slash commands
+  const commandsDir = path.join(projectDir, '.claude', 'commands');
+  const expectedCommands = ['o.md', 'o-help.md', 'o-status.md'];
+  const foundCommands = expectedCommands.filter((f) => fs.existsSync(path.join(commandsDir, f)));
+  if (foundCommands.length === expectedCommands.length) {
+    ui.success(`Slash commands: ${foundCommands.length}/${expectedCommands.length} installed`);
+  } else {
+    ui.error(`Slash commands: ${foundCommands.length}/${expectedCommands.length} installed`);
+    allGood = false;
+  }
+
+  // 6. Core config
+  const configPath = path.join(projectDir, '.orchestrix-core', 'core-config.yaml');
+  if (fs.existsSync(configPath)) {
+    ui.success('core-config.yaml: found');
+  } else {
+    ui.error('core-config.yaml: not found');
+    allGood = false;
+  }
+
+  // 7. Scripts
+  const scriptsDir = path.join(projectDir, '.orchestrix-core', 'scripts');
+  const expectedScripts = ['start-orchestrix.sh', 'handoff-detector.sh'];
+  const foundScripts = expectedScripts.filter((f) => {
+    const p = path.join(scriptsDir, f);
+    if (!fs.existsSync(p)) return false;
+    try {
+      fs.accessSync(p, fs.constants.X_OK);
+      return true;
+    } catch {
+      ui.warn(`${f}: exists but not executable (chmod +x)`);
+      return false;
+    }
+  });
+  if (foundScripts.length === expectedScripts.length) {
+    ui.success(`Scripts: ${foundScripts.length}/${expectedScripts.length} installed + executable`);
+  } else {
+    ui.warn(`Scripts: ${foundScripts.length}/${expectedScripts.length} ready`);
+  }
+
+  // 8. Hooks
+  const settingsPath = path.join(projectDir, '.claude', 'settings.local.json');
+  if (fs.existsSync(settingsPath)) {
+    try {
+      const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+      const hasHook = settings.hooks?.Stop?.some((entry) =>
+        entry.hooks?.some((h) => h.command?.includes('handoff-detector'))
+      );
+      if (hasHook) {
+        ui.success('Hooks: handoff-detector configured');
+      } else {
+        ui.warn('Hooks: settings.local.json exists but no handoff-detector hook');
+      }
+    } catch {
+      ui.warn('Hooks: settings.local.json invalid JSON');
+    }
+  } else {
+    ui.warn('Hooks: settings.local.json not found');
+  }
+
+  // 9. .gitignore
+  const gitignorePath = path.join(projectDir, '.gitignore');
+  if (fs.existsSync(gitignorePath)) {
+    const content = fs.readFileSync(gitignorePath, 'utf-8');
+    if (content.includes('.env.local')) {
+      ui.success('.gitignore: .env.local covered');
+    } else {
+      ui.warn('.gitignore: .env.local not listed');
+    }
+  }
+
+  // Result
+  console.log();
+  if (allGood) {
+    ui.success('All checks passed');
+  } else {
+    ui.info('Some checks failed — run "npx o8x install" to fix');
+  }
+  console.log();
+}
+
+module.exports = { doctor };

package/lib/embedded/commands.js

@@ -0,0 +1,163 @@
+'use strict';
+
+// Embedded slash command files — canonical content from Orchestrix MCP Server
+// These serve as offline fallback when MCP server is unreachable
+
+const O_MD = `---
+description: Activate Orchestrix Agent (e.g., /o dev, /o sm --lang=zh)
+---
+
+# Orchestrix Agent Activation
+
+## Available Agents
+
+| ID | Agent | Description |
+|----|-------|-------------|
+| \`dev\` | Full Stack Developer | implementation, debugging, refactoring |
+| \`sm\` | Scrum Master | story creation, epic management, agile guidance |
+| \`qa\` | QA Engineer | E2E testing, quality verification |
+| \`architect\` | Solution Architect | system design, tech selection, API design |
+| \`pm\` | Product Manager | PRDs, product strategy, roadmap planning |
+| \`po\` | Product Owner | backlog management, story refinement |
+| \`analyst\` | Business Analyst | market research, competitive analysis |
+| \`ux-expert\` | UX Expert | UI/UX design, wireframes, prototypes |
+| \`orchestrix-orchestrator\` | Workflow Coordinator | multi-agent tasks |
+| \`orchestrix-master\` | Master Agent | one-off tasks across domains |
+| \`decision-evaluator\` | Decision Evaluator | execute decision rules |
+
+## Language Support
+
+Use \`--lang=xx\` to load agent content in a specific language:
+- \`--lang=en\` - English (default)
+- \`--lang=zh\` - Chinese / 中文
+
+Examples:
+- \`/o dev\` - Load Developer agent in English (default)
+- \`/o dev --lang=zh\` - Load Developer agent in Chinese
+- \`/o sm --lang=zh\` - Load Scrum Master agent in Chinese
+
+## Action Required
+
+**FIRST**: Parse \`$ARGUMENTS\` to extract agent ID and language option.
+
+Arguments format: \`[agent_id] [--lang=xx]\`
+
+Parsing rules:
+1. If \`$ARGUMENTS\` is empty or blank → Show agent table, ask user to select
+2. If \`$ARGUMENTS\` contains \`--lang=xx\` → Extract language code (en or zh)
+3. Extract agent ID (everything before \`--lang\` or the entire argument if no \`--lang\`)
+
+If \`$ARGUMENTS\` is empty or blank:
+- Show the table above directly
+- Ask user to select an agent
+- **DO NOT** call ReadMcpResourceTool with empty arguments
+
+If agent ID is provided, proceed to load the agent:
+
+## Step 1: Read Agent Configuration
+
+**CRITICAL**: You MUST use \`ReadMcpResourceTool\` (NOT prompts!) with the EXACT parameters below.
+
+\`ReadMcpResourceTool\` only accepts \`server\` and \`uri\` parameters. Language MUST be encoded in the URI as a query parameter.
+
+**Without language** (default English):
+- server: \`orchestrix\`
+- uri: \`orchestrix://agents/{agent_id}.yaml\`
+
+**With language** (e.g., \`--lang=zh\`):
+- server: \`orchestrix\`
+- uri: \`orchestrix://agents/{agent_id}.yaml?lang=zh\`
+
+### Examples
+
+For \`/o pm\`:
+\`\`\`
+ReadMcpResourceTool(server="orchestrix", uri="orchestrix://agents/pm.yaml")
+\`\`\`
+
+For \`/o pm --lang=zh\`:
+\`\`\`
+ReadMcpResourceTool(server="orchestrix", uri="orchestrix://agents/pm.yaml?lang=zh")
+\`\`\`
+
+**DO NOT** use \`orchestrix://prompts/\` - agents are exposed as **resources**, not prompts!
+**DO NOT** pass \`lang\` as a separate parameter - it MUST be in the URI query string.
+
+## Step 2: After Loading Agent
+
+1. Adopt the persona defined in the \`agent\` section completely
+2. Follow \`activation_instructions\` exactly
+3. Display greeting with agent name/role
+4. Show the numbered command list from \`commands.help.output_format\`
+5. Wait for user selection
+`;
+
+const O_HELP_MD = `---
+description: Show Orchestrix help and available agents
+---
+
+# Orchestrix Help
+
+Please call the Orchestrix MCP Server's \`list-agents\` tool to display all available agents.
+
+Then display the following usage guide:
+
+## Usage
+
+\`\`\`
+/o [agent_id]     Activate an agent (e.g., /o dev, /o sm)
+/o-help           Show this help message
+/o-status         Show current Orchestrix status
+\`\`\`
+
+## Quick Start
+
+1. Use \`/o dev\` to activate the Developer agent for coding tasks
+2. Use \`/o sm\` to activate the Scrum Master for story management
+3. Use \`/o qa\` to activate QA Engineer for testing
+`;
+
+const O_STATUS_MD = `---
+description: Show Orchestrix server status
+---
+
+# Orchestrix Status
+
+Please check and display the current Orchestrix status:
+
+## Status Check Items
+
+1. **MCP Server Connection**: Check if Orchestrix MCP Server is connected
+2. **Available Agents**: Call \`list-agents\` tool to verify agents are loaded
+3. **License Status**: Display current license tier (if applicable)
+
+## Expected Output
+
+Display the status in this format:
+
+\`\`\`
+Orchestrix Status
+=================
+Server: Connected / Disconnected
+Agents: [count] agents available
+License: [tier] mode
+
+Available Commands:
+  /o [agent]  - Activate agent
+  /o-help     - Show help
+  /o-status   - This status
+\`\`\`
+
+## Troubleshooting
+
+If the server is not connected:
+1. Check \`.mcp.json\` configuration
+2. Verify the MCP server process is running
+3. Check server logs for errors
+`;
+
+module.exports = {
+  'o.md': O_MD,
+  'o-help.md': O_HELP_MD,
+  'o-status.md': O_STATUS_MD,
+};

package/lib/embedded/config.js

@@ -0,0 +1,74 @@
+'use strict';
+
+// Embedded core-config.template.yaml — project configuration template
+
+const CORE_CONFIG_TEMPLATE = `title: Orchestrix Core System
+description: >
+  The core agent framework for Orchestrix, providing the essential agents,
+  workflows, and data for building and managing AI-driven development teams.
+markdownExploder: true
+project:
+  name: '{{PROJECT_NAME}}'
+  mode: monolith
+  testCommand: '{{TEST_COMMAND}}'
+  multi_repo:
+    role: implementation
+    repository_id: '{{REPO_ID}}'
+    product_repo_path: ''
+    auto_filter_stories: false
+    assigned_stories: []
+prd:
+  prdFile: docs/prd.md
+  prdSharded: false
+  prdShardedLocation: docs/prd
+architecture:
+  architectureFile: docs/architecture.md
+  architectureSharded: false
+  architectureShardedLocation: docs/architecture
+  storyReviewsLocation: docs/architecture/story-reviews
+customTechnicalDocuments: null
+devLoadAlwaysFiles:
+  - docs/architecture/*coding-standards.md
+  - docs/architecture/*tech-stack.md
+  - docs/architecture/*source-tree.md
+devDebugLog: .ai/debug-log.md
+devStoryLocation: docs/stories
+verticalSliceStrategy: true
+dev:
+  devLogLocation: docs/dev/logs
+  devLogEnabled: true
+architect:
+  storyReviewsLocation: docs/architecture/story-reviews
+qa:
+  qaLocation: docs/qa
+  qaReviewsLocation: docs/qa/reviews
+  evidenceLocation: docs/qa/evidence
+  testDesignThresholds:
+    simple:
+      maxComplexity: 0
+      minQualityScore: 8.5
+      securitySensitive: false
+      tasks: []
+    standard:
+      maxComplexity: 2
+      minQualityScore: 7
+      tasks:
+        - test-design
+    comprehensive:
+      minComplexity: 3
+      securitySensitive: true
+      tasks:
+        - test-design
+        - risk-profile
+slashPrefix: Orchestrix
+version: 15.14.0
+i18n:
+  default_language: en
+  supported_languages:
+    - en
+    - zh
+  fallback_to_default: true
+  file_pattern: '{name}.{lang}.{ext}'
+`;
+
+module.exports = { CORE_CONFIG_TEMPLATE };