blue/.blue/docs/rfcs/0044-rfc-matching-and-auto-status.draft.md

RFC 0044: RFC Matching and Auto Status

Status	Draft
Date	2026-02-01
Source Spike	rfc-sdlc-workflow-gaps

---

Summary

Two gaps in the SDLC workflow:

1. RFC matching fails for NNNN-slug patterns - find_document() in store.rs:1789 uses trim_start_matches('0') which only works on pure numeric strings. Pattern 0107-worker-job-id fails because 107-worker-job-id isn't a valid integer.

2. RFC status not auto-updated on PR merge - handle_merge() in pr.rs:416 doesn't update RFC status to "implemented". The link exists (worktrees table has document_id + branch_name) but missing get_worktree_by_branch() function and no status update code.

Both fixes are mechanical.

---

Design

Fix 1: Extract Leading Digits from NNNN-slug Patterns

File: crates/blue-core/src/store.rs:1788-1798

Before:

// Try number match
let trimmed = query.trim_start_matches('0');
if let Ok(num) = if trimmed.is_empty() {
    "0".parse()
} else {
    trimmed.parse::<i32>()
} {
    if let Ok(doc) = self.get_document_by_number(doc_type, num) {
        return Ok(doc);
    }
}

After:

// Try number match - extract leading digits from NNNN-slug format
let num_str: String = query.chars()
    .take_while(|c| c.is_ascii_digit())
    .collect();
if !num_str.is_empty() {
    let trimmed = num_str.trim_start_matches('0');
    if let Ok(num) = if trimmed.is_empty() {
        "0".parse()
    } else {
        trimmed.parse::<i32>()
    } {
        if let Ok(doc) = self.get_document_by_number(doc_type, num) {
            return Ok(doc);
        }
    }
}

This handles:

• 0107 → extracts 0107 → parses as 107
• 0107-worker-job-id → extracts 0107 → parses as 107
• worker-job-id → extracts `` → skips number match, falls to substring

---

Fix 2: Auto-Update RFC Status on Merge

Step 2a: Add get_worktree_by_branch() to store.rs

pub fn get_worktree_by_branch(&self, branch_name: &str) -> Result<Option<Worktree>, StoreError> {
    match self.conn.query_row(
        "SELECT id, document_id, branch_name, worktree_path, created_at
         FROM worktrees WHERE branch_name = ?1",
        params![branch_name],
        |row| {
            Ok(Worktree {
                id: Some(row.get(0)?),
                document_id: row.get(1)?,
                branch_name: row.get(2)?,
                worktree_path: row.get(3)?,
                created_at: row.get(4)?,
            })
        },
    ) {
        Ok(wt) => Ok(Some(wt)),
        Err(rusqlite::Error::QueryReturnedNoRows) => Ok(None),
        Err(e) => Err(StoreError::Database(e.to_string())),
    }
}

Step 2b: Update handle_merge() in pr.rs

After successful merge (line 416), add:

Ok(()) => {
    // Auto-update RFC status to implemented
    let branch = get_current_branch(&state.home.root).ok();
    if let Some(ref b) = branch {
        if let Ok(Some(wt)) = state.store.get_worktree_by_branch(b) {
            if let Ok(doc) = state.store.get_document_by_id(wt.document_id) {
                if doc.status == "in-progress" {
                    let _ = state.store.update_document_status(
                        DocType::Rfc,
                        &doc.title,
                        "implemented"
                    );
                }
            }
        }
    }

    Ok(json!({ ... }))
}

---

Test Plan

• find_document("0044") returns RFC 0044
• find_document("0044-rfc-matching") returns RFC 0044
• find_document("rfc-matching") returns RFC 0044
• Merge PR on RFC-linked branch → RFC status changes to "implemented"
• Merge PR on non-RFC branch → no error, no status change

---

"Right then. Let's get to it."

— Blue