orchestrix-yuri 4.3.0 → 4.4.1

package/lib/gateway/engine/phase-orchestrator.js

@@ -181,6 +181,20 @@ class PhaseOrchestrator {
       };
     }
 
+    if (this._phase === 'test') {
+      return { phase: 'test', message: '🧪 Testing in progress. QA running smoke tests.' };
+    }
+
+    if (this._phase === 'iterate') {
+      const ctx = this._changeContext || {};
+      return { phase: 'iterate', message: `🔄 Iteration in progress. Current: ${ctx.iteratePhase || 'starting'}` };
+    }
+
+    if (this._phase === 'change') {
+      const ctx = this._changeContext || {};
+      return { phase: 'change', message: `🔧 Change in progress (${ctx.scope || '?'}). Step ${this._step + 1}` };
+    }
+
     return { phase: this._phase, message: `Phase ${this._phase} is running.` };
   }
 
@@ -753,6 +767,187 @@ class PhaseOrchestrator {
     this.onComplete('develop', '🎉 Development complete! All stories finished.\n\nRun *test to start smoke testing.');
   }
 
+  // ── Test Phase ──────────────────────────────────────────────────────────────
+
+  /**
+   * Start test phase: QA smoke test per epic, auto fix-retest loop.
+   * Uses existing dev session's QA window (3) and Dev window (2).
+   */
+  startTest(projectRoot) {
+    if (this._phase) {
+      return `⚠️ Phase "${this._phase}" is already running. Use *status to check.`;
+    }
+
+    this._projectRoot = projectRoot;
+    this._phase = 'test';
+    this._step = 0;
+    this._lastHash = '';
+    this._stableCount = 0;
+
+    // Ensure dev session exists (QA is window 3)
+    try {
+      const scriptPath = path.join(SKILL_DIR, 'scripts', 'ensure-session.sh');
+      const result = execSync(`bash "${scriptPath}" dev "${projectRoot}"`, {
+        encoding: 'utf8', timeout: 60000,
+      }).trim();
+      const lines = result.split('\n');
+      this._session = lines[lines.length - 1].trim();
+    } catch (err) {
+      this._phase = null;
+      return `❌ Failed to ensure dev session: ${err.message}`;
+    }
+
+    // Start QA smoke test on first epic
+    tmx.sendKeysWithEnter(this._session, 3, '/clear');
+    execSync('sleep 2');
+    tmx.sendKeysWithEnter(this._session, 3, '/o qa');
+    execSync('sleep 12');
+    tmx.sendKeysWithEnter(this._session, 3, '*smoke-test');
+
+    const pollInterval = this.config.phase_poll_interval || 30000;
+    this._timer = setInterval(() => this._pollTest(), pollInterval);
+
+    log.engine(`Test phase started: session=${this._session}`);
+    return '🧪 Testing started! QA is running smoke tests.\n\nI\'ll notify you of results. Failed tests will auto-trigger Dev fixes.';
+  }
+
+  _pollTest() {
+    if (this._phase !== 'test') return;
+
+    if (!tmx.hasSession(this._session)) {
+      this._handleError('test', 'tmux session died');
+      return;
+    }
+
+    const result = tmx.checkCompletion(this._session, 3, this._lastHash);
+    if (result.status === 'complete' || (result.status === 'stable' && ++this._stableCount >= 3)) {
+      this._stableCount = 0;
+      this._lastHash = '';
+      this._completeTest();
+      return;
+    }
+    if (result.status !== 'stable') { this._stableCount = 0; this._lastHash = result.hash || ''; }
+    else { this._lastHash = result.hash; }
+  }
+
+  _completeTest() {
+    if (this._timer) { clearInterval(this._timer); this._timer = null; }
+    this._phase = null;
+    log.engine('Test phase complete');
+    this.onComplete('test', '🧪 Testing complete! Check QA results.\n\nRun *deploy when ready.');
+  }
+
+  // ── Iterate (New Iteration) ────────────────────────────────────────────────
+
+  /**
+   * Start a new iteration: PM generates next-steps, agents execute, SM starts dev.
+   * Flow: PM *start-iteration → parse HANDOFF → execute agents → SM *draft → dev auto
+   */
+  startIterate(projectRoot) {
+    if (this._phase) {
+      return `⚠️ Phase "${this._phase}" is already running. Use *status to check.`;
+    }
+
+    this._projectRoot = projectRoot;
+    this._phase = 'iterate';
+    this._step = 0;
+    this._lastHash = '';
+    this._stableCount = 0;
+
+    // Step 1: Ensure planning session
+    try {
+      const scriptPath = path.join(SKILL_DIR, 'scripts', 'ensure-session.sh');
+      const result = execSync(`bash "${scriptPath}" planning "${projectRoot}"`, {
+        encoding: 'utf8', timeout: 60000,
+      }).trim();
+      const lines = result.split('\n');
+      this._session = lines[lines.length - 1].trim();
+    } catch (err) {
+      this._phase = null;
+      return `❌ Failed to create planning session: ${err.message}`;
+    }
+
+    // Start PM *start-iteration
+    tmx.sendKeysWithEnter(this._session, 0, '/o pm');
+    execSync('sleep 15');
+    tmx.sendKeysWithEnter(this._session, 0, '*start-iteration');
+
+    this._changeContext = { iteratePhase: 'pm' };
+    const pollInterval = this.config.phase_poll_interval || 30000;
+    this._timer = setInterval(() => this._pollIterate(), pollInterval);
+
+    log.engine(`Iterate started: session=${this._session}`);
+    return '🔄 New iteration started! PM is generating next-steps.\n\nAfter PM finishes, agents will execute in sequence, then dev automation resumes.';
+  }
+
+  _pollIterate() {
+    if (this._phase !== 'iterate') return;
+    if (this._waitingForInput) return;
+
+    const ctx = this._changeContext;
+    if (!ctx) return;
+
+    if (!tmx.hasSession(this._session)) {
+      this._handleError('iterate', 'tmux session died');
+      return;
+    }
+
+    const result = tmx.checkCompletion(this._session, 0, this._lastHash);
+    if (result.status === 'complete' || (result.status === 'stable' && ++this._stableCount >= 3)) {
+      this._stableCount = 0;
+      this._lastHash = '';
+      this._step++;
+
+      if (ctx.iteratePhase === 'pm') {
+        // PM done → send to Architect for review
+        this.onProgress('✅ PM generated next-steps. Sending to Architect...');
+        ctx.iteratePhase = 'architect';
+        tmx.sendKeysWithEnter(this._session, 0, '/clear');
+        execSync('sleep 2');
+        tmx.sendKeysWithEnter(this._session, 0, '/o architect');
+        execSync('sleep 15');
+        tmx.sendKeysWithEnter(this._session, 0, '*resolve-change');
+      } else if (ctx.iteratePhase === 'architect') {
+        // Architect done → transition to dev: SM *draft
+        this.onProgress('✅ Architect resolved. Starting dev automation via SM...');
+        try {
+          const scriptPath = path.join(SKILL_DIR, 'scripts', 'ensure-session.sh');
+          const devResult = execSync(`bash "${scriptPath}" dev "${this._projectRoot}"`, {
+            encoding: 'utf8', timeout: 120000,
+          }).trim();
+          const devLines = devResult.split('\n');
+          const devSession = devLines[devLines.length - 1].trim();
+
+          tmx.sendKeysWithEnter(devSession, 1, '/clear');
+          execSync('sleep 2');
+          tmx.sendKeysWithEnter(devSession, 1, '/o sm');
+          execSync('sleep 12');
+          tmx.sendKeysWithEnter(devSession, 1, '*draft');
+
+          this._completeIterate(devSession);
+        } catch (err) {
+          this._handleError('iterate', `Failed to start dev: ${err.message}`);
+        }
+      }
+      return;
+    }
+
+    if (result.status !== 'stable') { this._stableCount = 0; this._lastHash = result.hash || ''; }
+    else { this._lastHash = result.hash; }
+  }
+
+  _completeIterate(devSession) {
+    if (this._timer) { clearInterval(this._timer); this._timer = null; }
+    // Kill planning session
+    if (this._session && tmx.hasSession(this._session)) {
+      tmx.killSession(this._session);
+    }
+    this._phase = null;
+    this._changeContext = null;
+    log.engine('Iterate complete — dev automation started');
+    this.onComplete('iterate', `🔄 New iteration launched!\n\nSM is drafting stories in dev session: ${devSession}\nAgents will chain automatically via handoff-detector.`);
+  }
+
   // ── Change Management ───────────────────────────────────────────────────────
 
   /**

package/lib/gateway/router.js

@@ -17,15 +17,17 @@ const YURI_GLOBAL = path.join(os.homedir(), '.yuri');
 // ── Phase command patterns ─────────────────────────────────────────────────────
 
 const PHASE_COMMANDS = {
-  plan:    /^\*plan\b/i,
-  develop: /^\*develop\b/i,
-  change:  /^\*change\s+(.+)/i,
-  test:    /^\*test\b/i,
-  deploy:  /^\*deploy\b/i,
-  cancel:  /^\*cancel\b/i,
+  plan:     /^\*plan\b/i,
+  develop:  /^\*develop\b/i,
+  test:     /^\*test\b/i,
+  change:   /^\*change\s+(.+)/i,
+  iterate:  /^\*iterate\b/i,
+  deploy:   /^\*deploy\b/i,
+  cancel:   /^\*cancel\b/i,
 };
 
 const META_COMMANDS = {
+  help:     /^\*help\b/i,
   projects: /^\*projects\b/i,
   switch:   /^\*switch\s+(.+)/i,
 };
@@ -208,7 +210,10 @@ class Router {
       return this._handleStatusQuery(msg);
     }
 
-    // ═══ META COMMANDS — *projects, *switch (always allowed) ═══
+    // ═══ META COMMANDS — *help, *projects, *switch (always allowed) ═══
+    if (META_COMMANDS.help.test(msg.text.trim())) {
+      return { text: this._buildHelpText() };
+    }
     if (META_COMMANDS.projects.test(msg.text.trim())) {
       return this._handleProjects(msg);
     }
@@ -281,9 +286,14 @@ class Router {
       case 'develop':
         response = this.orchestrator.startDevelop(projectRoot);
         break;
+      case 'test':
+        response = this.orchestrator.startTest(projectRoot);
+        break;
       case 'change':
         return this._handleChangeCommand(msg, projectRoot);
-      case 'test':
+      case 'iterate':
+        response = this.orchestrator.startIterate(projectRoot);
+        break;
       case 'deploy':
         return this._processMessageDirect(msg);
       default:
@@ -799,6 +809,46 @@ Reply with ONLY one word: small, medium, or large. Nothing else.`;
     return lines.join('\n');
   }
 
+  // ── Help ──────────────────────────────────────────────────────────────────────
+
+  _buildHelpText() {
+    return `🚀 **Yuri — Meta-Orchestrator**
+
+**Project Lifecycle**
+| Command | Description |
+|---------|-------------|
+| \`*create\` | Create a new project (interactive Q&A) |
+| \`*plan\` | Start planning phase (6 agents sequentially, background) |
+| \`*develop\` | Start development phase (4 agents with HANDOFF, background) |
+| \`*test\` | Start smoke testing (QA per epic, auto fix-retest) |
+| \`*deploy\` | Deploy the project |
+
+**Change & Iteration**
+| Command | Description |
+|---------|-------------|
+| \`*change "desc"\` | Handle a requirement change (auto scope assessment) |
+| \`*iterate\` | Start new iteration (PM → agents → dev automation) |
+
+**Monitoring**
+| Command | Description |
+|---------|-------------|
+| \`*status\` | Show progress card (epic/story/agent/cost) |
+| \`*cancel\` | Stop the running phase |
+| \`*resume\` | Resume from last checkpoint |
+
+**Portfolio**
+| Command | Description |
+|---------|-------------|
+| \`*projects\` | List all registered projects |
+| \`*switch <name>\` | Switch active project |
+| \`*help\` | Show this help |
+
+**Notes**
+- \`*plan\`, \`*develop\`, \`*test\`, \`*change\`, \`*iterate\` run in background — you can chat normally while they execute
+- Progress is reported every 30 minutes automatically
+- Reply to agent question messages to answer them directly`;
+  }
+
   _updateGlobalFocus(msg, projectRoot) {
     const focusPath = path.join(YURI_GLOBAL, 'focus.yaml');
     if (!fs.existsSync(focusPath)) return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orchestrix-yuri",
-  "version": "4.3.0",
+  "version": "4.4.1",
   "description": "Yuri — Meta-Orchestrator for Orchestrix. Drive your entire project lifecycle with natural language.",
   "main": "lib/installer.js",
   "bin": {