OmniRoute/scripts/scratch/refine_viable.py

import os

viable_data = {
    1718: {
        "title": "expose upstream error details in client-facing error responses",
        "solves": "Debugging upstream errors is difficult because they are hidden behind generic '[400] Error from provider' wrappers.",
        "how": "1. Modify `buildErrorBody` to accept `upstream_details`.\n2. In `BaseExecutor` or specific handlers, parse the raw upstream response on failure.\n3. Propagate the parsed body to the client response inside `upstream_details`.",
        "areas": "open-sse/executors/base.ts, open-sse/utils/errors.ts, src/app/api/v1/chat/completions/route.ts",
        "req_summary": "Expose the upstream error body (e.g. context_length_exceeded) directly in the error response under an `upstream_details` key, without breaking OpenAI compatibility.",
        "req_approach": "Modify the central error generation functions (like `buildErrorBody`) to optionally accept an `upstreamDetails` object. Update the request executors to pass the JSON parsed error from the upstream response into this new parameter when a request fails.",
        "req_files": "| File | Changes |\n|---|---|\n| `open-sse/utils/errors.ts` | Update `buildErrorBody` to include `upstream_details`. |\n| `open-sse/executors/base.ts` | Extract response body on failure and pass to error builder. |",
        "req_effort": "Low. A few files changed. No breaking changes."
    },
    1731: {
        "title": "(combo): provider-level exhaustion tracking to skip same-provider targets",
        "solves": "Combo routing wastes significant time retrying multiple targets from the same provider when the entire provider is rate-limited or quota-exhausted.",
        "how": "1. Track 429 quota exhaustion errors at the provider level.\n2. In `combo.ts`, before attempting a target, check if its provider is currently marked as exhausted.\n3. If exhausted, skip the target and move to the next provider.",
        "areas": "open-sse/services/combo.ts, open-sse/services/accountFallback.ts",
        "req_summary": "Implement provider-level 429 exhaustion tracking in the combo router so it skips remaining targets of a provider if a 429 quota exhaustion occurs.",
        "req_approach": "Add a temporary exclusion set in `handleComboChat` that tracks providers that have returned a hard 429. Before evaluating the next target in the combo, check if its provider is in the exclusion set and skip it if true.",
        "req_files": "| File | Changes |\n|---|---|\n| `open-sse/services/combo.ts` | Add logic to track provider failures and skip matching targets. |\n| `open-sse/services/accountFallback.ts` | Properly bubble up the 429 status. |",
        "req_effort": "Medium. Needs careful state tracking across the combo loop. No breaking changes."
    },
    1764: {
        "title": "Make installation script detect termux",
        "solves": "OmniRoute fails to start or install properly on Termux because `wreq-js` attempts to load a native `libgcc` arm64 module which is incompatible.",
        "how": "1. Update the `postinstall` script to check `process.env.PREFIX` for termux.\n2. If termux is detected, gracefully skip or patch the wreq-js installation/loading.",
        "areas": "scripts/postinstall.mjs, open-sse/executors/wreq.ts",
        "req_summary": "Detect termux environments during installation or runtime and gracefully handle the `wreq-js` native module failure, allowing the rest of OmniRoute to function.",
        "req_approach": "Modify `scripts/postinstall.mjs` or the wreq-js loader logic. If `process.env.PREFIX && process.env.PREFIX.includes('termux')` is true, avoid hard crashing on wreq-js load failures.",
        "req_files": "| File | Changes |\n|---|---|\n| `scripts/postinstall.mjs` | Add termux detection and warning. |\n| `open-sse/utils/env.ts` (or similar) | Graceful downgrade. |",
        "req_effort": "Low. Very localized fix."
    }
}

for root, _, files in os.walk("_ideia/viable"):
    for f in files:
        if not f.endswith(".md") or "requirements" in f: continue
        num = int(f.split('-')[0])
        if num in viable_data:
            path = os.path.join(root, f)
            with open(path, 'r') as file:
                content = file.read()
            
            d = viable_data[num]
            
            # replace TBDs
            content = content.replace("### What it solves\n\n- TBD", f"### What it solves\n\n- {d['solves']}")
            content = content.replace("### How it should work (high level)\n\n1. TBD\n2. TBD", f"### How it should work (high level)\n\n{d['how']}")
            content = content.replace("### Affected areas\n\n- TBD", f"### Affected areas\n\n- {d['areas']}")
            content = content.replace("Feature needs manual refinement and interpretation to fill logical gaps and outline high-level technical scope.", "Refined and scoped for implementation.")
            
            with open(path, 'w') as file:
                file.write(content)
            
            req_content = f"""# Requirements: {d['title']}

> Feature Idea: [#{num}](./{f})
> Research Date: 2026-05-01
> Verdict: ✅ VIABLE

## 🔍 Research Summary

{d['req_summary']}

## 📚 Reference Implementations

| #   | Repository       | Stars | Last Updated | Approach | Relevance    |
| --- | ---------------- | ----- | ------------ | -------- | ------------ |
| 1   | OmniRoute Source | -     | 2026-05-01   | Internal | High         |

## 📐 Proposed Solution Architecture

### Approach

{d['req_approach']}

### Modified Files

{d['req_files']}

## ⚙️ Implementation Effort

- **Estimated complexity**: {d['req_effort']}
- **Breaking changes**: No
"""
            req_path = os.path.join(root, f.replace(".md", ".requirements.md"))
            with open(req_path, 'w') as req_file:
                req_file.write(req_content)
                
            print(f"Refined {num} and created requirements.")