Method beginCycle

src/session/tdd_state.js:213–241

* Start a TDD cycle for testName. In loop mode, also links the cycle to * the currently-active requirement (or the first pending one if none active).

(testName)

   * the currently-active requirement (or the first pending one if none active).
   */
  beginCycle(testName) {
    if (this.disabled) return { ok: true, phase: 'idle', message: 'TDD gating disabled.' };
    if (!testName || typeof testName !== 'string' || !testName.trim()) {
      return { ok: false, phase: this._phase, message: 'beginCycle requires a non-empty testName.' };
    }

    // In loop mode, mark the associated requirement as active
    if (this._loopActive) {
      const activeReq = this.activeRequirement();
      if (!activeReq) {
        // Try to activate the first pending requirement
        const first = this._requirements.find(r => r.status === REQ_STATUS.PENDING);
        if (first) first.status = REQ_STATUS.ACTIVE;
      }
    }

    this._phase = PHASES.RED;
    this._targetTest = testName.trim();
    this._redConfirmed = false;
    this._cycleId = (this._cycleId || 0) + 1;
    this._startedAt = new Date().toISOString();
    this._save();

    return {
      ok: true,
      phase: PHASES.RED,
      message: `TDD cycle started for "${this._targetTest}". Call run_tests (with test_filter "${this._targetTest}") to confirm it fails (RED phase).`,
    };
  }

  confirmRed(testResult) {
    if (this.disabled) return { ok: true, phase: 'idle', message: 'TDD gating disabled.' };