madappgang/claude-code/state-machine

Todo ──→ In Progress ──→ In Review ──→ Done
                 ↑           │
                 └───────────┘
                 (iteration)
 
In Progress ──→ Blocked (escalation)

async function canStartWork(issue: Issue): Promise<boolean> {
  const checks = [
    // Has acceptance criteria
    extractAcceptanceCriteria(issue.description).length > 0,
    // No blocking dependencies
    (await getBlockingIssues(issue)).length === 0,
    // Assigned to autopilot
    issue.assignee?.id === AUTOPILOT_BOT_USER_ID,
  ];
  return checks.every(c => c);
}

async function canSubmitForReview(proof: Proof): Promise<boolean> {
  const checks = [
    // All tests pass
    proof.testResults.passed === proof.testResults.total,
    // Build successful
    proof.buildSuccessful,
    // No lint errors
    proof.lintErrors === 0,
    // Has proof artifacts
    proof.screenshots.length > 0 || proof.deploymentUrl,
  ];
  return checks.every(c => c);
}

async function canComplete(proof: Proof): Promise<{
  canProceed: boolean;
  autoApproved: boolean;
}> {
  if (proof.confidence >= 95) {
    return { canProceed: true, autoApproved: true };
  }
  if (proof.confidence >= 80) {
    return { canProceed: false, autoApproved: false };
    // Wait for user approval
  }
  return { canProceed: false, autoApproved: false };
  // Validation failed, should iterate
}

class StateMachine {
  async transition(
    issueId: string,
    targetState: string,
    proof?: Proof
  ): Promise<void> {
    const issue = await linear.issue(issueId);
    const currentState = issue.state.name;
    // Validate transition
    const isValid = this.validateTransition(currentState, targetState, proof);
    if (!isValid) {
      throw new Error(`Invalid transition: ${currentState} -> ${targetState}`);
    }
    // Execute transition
    await linear.issueUpdate(issueId, {
      stateId: await this.getStateId(issue.team.id, targetState),
    });
    // Log transition
    await this.logTransition(issueId, currentState, targetState, proof);
  }
  private validateTransition(
    from: string,
    to: string,
    proof?: Proof
  ): boolean {
    const validTransitions: Record<string, string[]> = {
      'Todo': ['In Progress', 'Blocked'],
      'In Progress': ['In Review', 'Blocked'],
      'In Review': ['Done', 'In Progress'],
      'Blocked': ['Todo', 'In Progress'],
    };
    return validTransitions[from]?.includes(to) ?? false;
  }
}

                    ┌─────────────────────────────┐
                    │                             │
                    ▼                             │
┌──────┐       ┌─────────────┐       ┌───────────┴───┐       ┌──────┐
│ Todo │ ────► │ In Progress │ ────► │   In Review   │ ────► │ Done │
└──────┘       └─────────────┘       └───────────────┘       └──────┘
    │               │                        │
    │               │                        │
    │               ▼                        │
    │          ┌─────────┐                   │
    └────────► │ Blocked │ ◄─────────────────┘
               └─────────┘

// Task created
await transitionState(issueId, 'In Progress');  // Gate: Has acceptance criteria
// Work complete, proof generated
await transitionState(issueId, 'In Review');    // Gate: Proof >= 80%
// High confidence auto-approval
await transitionState(issueId, 'Done');         // Gate: Confidence >= 95%

// First attempt
await transitionState(issueId, 'In Progress');
await transitionState(issueId, 'In Review');    // Confidence: 85%
// User requests changes
await transitionState(issueId, 'In Progress');  // Feedback: REQUESTED_CHANGES
// Second attempt
await transitionState(issueId, 'In Review');    // Confidence: 97%
await transitionState(issueId, 'Done');         // Auto-approved

// After 5 feedback rounds
if (iterationCount >= MAX_FEEDBACK_ROUNDS) {
  await transitionState(issueId, 'Blocked');
  await addComment(issueId, "Escalated: Max iterations reached");
}