Method initRequirements

src/session/tdd_state.js:129–158

* Arm the loop with a list of requirements. * Each entry is a plain-English description of behaviour to implement. * Does not start a cycle — call beginCycle() or let the governor auto-start. * * @param {string[]} requirements * @returns {{ ok: boolean, message: string, requirements:

(requirements)

   * @returns {{ ok: boolean, message: string, requirements: object[] }}
   */
  initRequirements(requirements) {
    if (this.disabled) return { ok: true, message: 'TDD gating disabled.', requirements: [] };
    if (!Array.isArray(requirements) || requirements.length === 0) {
      return { ok: false, message: 'initRequirements: pass a non-empty array of requirement strings.' };
    }

    this._requirements = requirements
      .map((text, i) => String(text || '').trim())
      .filter(Boolean)
      .map((text, i) => ({ id: `r${String(i + 1).padStart(2, '0')}`, text, status: REQ_STATUS.PENDING }));

    if (this._requirements.length === 0) {
      return { ok: false, message: 'initRequirements: all requirement strings were empty.' };
    }

    this._loopActive = true;
    this._regressionClean = false;
    // Reset any in-flight cycle
    this._phase = PHASES.IDLE;
    this._targetTest = null;
    this._redConfirmed = false;
    this._save();

    const lines = this._requirements.map(r => `  ○ ${r.id}: ${r.text}`).join('\n');
    return {
      ok: true,
      message: `TDD loop initialised with ${this._requirements.length} requirement(s):\n${lines}\n\nNext: write a failing test for "${this._requirements[0].text}", then call tdd_begin_cycle.`,
      requirements: this._requirements,
    };
  }

  /**
   * Mark a requirement as complete (used internally after a cycle reaches green).