How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

quality-sweep - Prompt - OpenSmartRoute

Name: quality-sweep
Author: freshwaterbruce2

Prompt file imported from freshwaterbruce2/vibe-tech-monorepo (.claude/commands/loop/quality-sweep.md). Copyright stays with the author.

Loop Quality Sweep - Auto-Fix Lint and Type Errors

Processes ONE Nx project per turn. Fixes lint errors with --fix, then manually fixes remaining lint and typecheck errors. Auto-commits per project.

Absolute Prohibitions

NEVER modify apps/crypto-enhanced/ or any file in it
NEVER modify .env, *.key, *.pem, *.secret files
NEVER modify database files on D:\
NEVER modify .git/hooks/, .github/workflows/, or CI config
NEVER delete files or remove/install dependencies
NEVER use git push --force or git reset --hard
NEVER modify security-critical code (auth, encryption, API key handling)
STOP if 3 consecutive pre-commit hook failures occur

Per-Turn Workflow

1. Read State

SESSION_DIR="D:/logs/loop-sessions/$(date +%Y%m%d)"
cat "$SESSION_DIR/quality-sweep-state.json"

Parse the state. If commitCount >= commitBudget (20), STOP:

[quality-sweep] Commit budget exhausted (20/20). Stopping.

If consecutivePrecommitFailures >= 3, STOP:

[quality-sweep] 3 consecutive pre-commit failures. Stopping for safety.

2. Select Next Project

npx nx show projects 2>/dev/null | sort

Pick the project at projectIndex from the sorted list. Skip projects in processedProjects or failedProjects. If all processed, STOP.

Skip these projects entirely:

crypto-enhanced
Any project name containing e2e or storybook

3. Run Lint with Auto-Fix

pnpm nx lint PROJECT_NAME --fix 2>&1 | tail -40

Record the output. If lint passes cleanly, move to step 4.

If lint errors remain after --fix, read ONLY the files with errors. Apply fixes using the Edit tool:

Fix unused imports: remove them
Fix missing return types: add explicit types
Fix any types: replace with proper types where obvious
Fix formatting: follow existing patterns

Max 3 fix iterations per project. If errors persist after 3 rounds, log as failed and move on.

4. Run Typecheck

pnpm nx typecheck PROJECT_NAME 2>&1 | tail -40

If typecheck passes, move to step 5.

If typecheck errors exist:

Read the erroring files
Fix obvious type errors (missing properties, wrong types, import issues)
Do NOT attempt complex refactors
Max 3 fix iterations

If errors persist after 3 rounds, log as partially fixed and move on.

5. Stage and Commit

Stage ONLY files belonging to this project:

# Determine project root
PROJECT_ROOT=$(npx nx show project PROJECT_NAME --json 2>/dev/null | grep -o '"root":"[^"]*"' | cut -d'"' -f4)
git add "$PROJECT_ROOT/" 2>/dev/null

Check if there are staged changes:

git diff --cached --stat

If no staged changes, skip commit and move to next project.

If there are changes, commit:

git commit -m "$(cat <<'EOF'
fix(PROJECT_NAME): auto-fix lint and type errors

Automated fixes applied by overnight quality sweep loop.
EOF
)"

6. Handle Pre-Commit Result

If commit succeeds:

Reset consecutivePrecommitFailures to 0
Increment commitCount
Add project to processedProjects
Log success

If pre-commit hook fails:

Increment consecutivePrecommitFailures
Unstage all changes: git restore --staged .
Add project to failedProjects
Log failure with reason

7. Auto-Merge Check

If commitCount is a multiple of 10 and > 0:

CURRENT_BRANCH=$(git branch --show-current)
git checkout main && git pull origin main 2>/dev/null
git merge "$CURRENT_BRANCH" --no-ff -m "chore: auto-merge loop commits (batch)" 2>&1
MERGE_RESULT=$?
git checkout "$CURRENT_BRANCH"

If merge fails, log the error but continue on the loop branch. Do NOT force anything.

8. Update State

Write updated state back to D:/logs/loop-sessions/YYYYMMDD/quality-sweep-state.json:

Increment projectIndex
Update commitCount
Update processedProjects or failedProjects
Update consecutivePrecommitFailures

9. Log

Append to D:/logs/loop-sessions/YYYYMMDD/loop.log:

echo "[$(date -Iseconds)] [quality-sweep] [PROJECT_NAME] lint: N errors fixed, typecheck: PASS/FAIL, commit: YES/NO/SKIPPED" >> "$SESSION_DIR/loop.log"

File Scope Rules

Loop 1 (this loop) ONLY touches source code:

apps/*/src/**
packages/*/src/**
packages/*/index.ts
apps/*/tsconfig*.json (only to fix lint scope issues)

NEVER touch:

Root config files (nx.json, package.json, .gitignore)
docs/, tmp/, scripts/
Build artifacts, test fixtures
Any file outside the current project's root

Recovery

If something goes wrong:

Check D:\logs\loop-sessions\YYYYMMDD\loop.log
git log --oneline -20 to see what was committed
git revert HEAD~N..HEAD to undo N commits
Or restore D:\ snapshot: Restore-Snapshot.ps1 -Tag "pre-loop-YYYYMMDD"

Install quality-sweep and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

# Loop Quality Sweep - Auto-Fix Lint and Type Errors Processes ONE Nx project per turn. Fixes lint errors with --fix, then manually fixes remaining lint and typecheck errors. Auto-commits per project. ## Absolute Prohibitions - NEVER modify `apps/crypto-enhanced/` or any file in it - NEVER modify `.env`, `*.key`, `*.pem`, `*.secret` files - NEVER modify database files on D:\ - NEVER modify `.git/hooks/`, `.github/workflows/`, or CI config - NEVER delete files or remove/install dependencies - NEVER use `git push --force` or `git reset --hard` - NEVER modify security-critical code (auth, encryption, API key handling) - STOP if 3 consecutive pre-commit hook failures occur ## Per-Turn Workflow ### 1. Read State ```bash SESSION_DIR="D:/logs/loop-sessions/$(date +%Y%m%d)" cat "$SESSION_DIR/quality-sweep-state.json" ``` Parse the state. If `commitCount >= commitBudget` (20), STOP: ``` [quality-sweep] Commit budget exhausted (20/20). Stopping. ``` If `consecutivePrecommitFailures >= 3`, STOP: ``` [quality-sweep] 3 consecutive pre-commit failures. Stopping for safety. ``` ### 2. Select Next Project ```bash npx nx show projects 2>/dev/null | sort ``` Pick the project at `projectIndex` from the sorted list. Skip projects in `processedProjects` or `failedProjects`. If all processed, STOP. Skip these projects entirely: - `crypto-enhanced` - Any project name containing `e2e` or `storybook` ### 3. Run Lint with Auto-Fix ```bash pnpm nx lint PROJECT_NAME --fix 2>&1 | tail -40 ``` Record the output. If lint passes cleanly, move to step 4. If lint errors remain after `--fix`, read ONLY the files with errors. Apply fixes using the Edit tool: - Fix unused imports: remove them - Fix missing return types: add explicit types - Fix `any` types: replace with proper types where obvious - Fix formatting: follow existing patterns **Max 3 fix iterations per project.** If errors persist after 3 rounds, log as failed and move on. ### 4. Run Typecheck ```bash pnpm nx typecheck PROJECT_NAME 2>&1 | tail -40 ``` If typecheck passes, move to step 5. If typecheck errors exist: - Read the erroring files - Fix obvious type errors (missing properties, wrong types, import issues) - Do NOT attempt complex refactors - Max 3 fix iterations If errors persist after 3 rounds, log as partially fixed and move on. ### 5. Stage and Commit Stage ONLY files belonging to this project: ```bash # Determine project root PROJECT_ROOT=$(npx nx show project PROJECT_NAME --json 2>/dev/null | grep -o '"root":"[^"]*"' | cut -d'"' -f4) git add "$PROJECT_ROOT/" 2>/dev/null ``` Check if there are staged changes: ```bash git diff --cached --stat ``` If no staged changes, skip commit and move to next project. If there are changes, commit: ```bash git commit -m "$(cat <<'EOF' fix(PROJECT_NAME): auto-fix lint and type errors Automated fixes applied by overnight quality sweep loop. EOF )" ``` ### 6. Handle Pre-Commit Result If commit succeeds: - Reset `consecutivePrecommitFailures` to 0 - Increment `commitCount` - Add project to `processedProjects` - Log success If pre-commit hook fails: - Increment `consecutivePrecommitFailures` - Unstage all changes: `git restore --staged .` - Add project to `failedProjects` - Log failure with reason ### 7. Auto-Merge Check If `commitCount` is a multiple of 10 and > 0: ```bash CURRENT_BRANCH=$(git branch --show-current) git checkout main && git pull origin main 2>/dev/null git merge "$CURRENT_BRANCH" --no-ff -m "chore: auto-merge loop commits (batch)" 2>&1 MERGE_RESULT=$? git checkout "$CURRENT_BRANCH" ``` If merge fails, log the error but continue on the loop branch. Do NOT force anything. ### 8. Update State Write updated state back to `D:/logs/loop-sessions/YYYYMMDD/quality-sweep-state.json`: - Increment `projectIndex` - Update `commitCount` - Update `processedProjects` or `failedProjects` - Update `consecutivePrecommitFailures` ### 9. Log Append to `D:/logs/loop-sessions/YYYYMMDD/loop.log`: ```bash echo "[$(date -Iseconds)] [quality-sweep] [PROJECT_NAME] lint: N errors fixed, typecheck: PASS/FAIL, commit: YES/NO/SKIPPED" >> "$SESSION_DIR/loop.log" ``` ## File Scope Rules Loop 1 (this loop) ONLY touches source code: - `apps/*/src/**` - `packages/*/src/**` - `packages/*/index.ts` - `apps/*/tsconfig*.json` (only to fix lint scope issues) NEVER touch: - Root config files (nx.json, package.json, .gitignore) - `docs/`, `tmp/`, `scripts/` - Build artifacts, test fixtures - Any file outside the current project's root ## Recovery If something goes wrong: 1. Check D:\logs\loop-sessions\YYYYMMDD\loop.log 2. `git log --oneline -20` to see what was committed 3. `git revert HEAD~N..HEAD` to undo N commits 4. Or restore D:\ snapshot: `Restore-Snapshot.ps1 -Tag "pre-loop-YYYYMMDD"`

{ "prompt": "# Loop Quality Sweep - Auto-Fix Lint and Type Errors\n\nProcesses ONE Nx project per turn. Fixes lint errors with --fix, then manually fixes remaining lint and typecheck errors. Auto-commits per project.\n\n## Absolute Prohibitions\n\n- NEVER modify `apps/crypto-enhanced/` or any file in it\n- NEVER modify `.env`, `*.key`, `*.pem`, `*.secret` files\n- NEVER modify database files on D:\\\n- NEVER modify `.git/hooks/`, `.github/workflows/`, or CI config\n- NEVER delete files or remove/install dependencies\n- NEVER use `git push --force` or `git reset --hard`\n- NEVER modify security-critical code (auth, encryption, API key handling)\n- STOP if 3 consecutive pre-commit hook failures occur\n\n## Per-Turn Workflow\n\n### 1. Read State\n\n```bash\nSESSION_DIR=\"D:/logs/loop-sessions/$(date +%Y%m%d)\"\ncat \"$SESSION_DIR/quality-sweep-state.json\"\n```\n\nParse the state. If `commitCount >= commitBudget` (20), STOP:\n\n```\n[quality-sweep] Commit budget exhausted (20/20). Stopping.\n```\n\nIf `consecutivePrecommitFailures >= 3`, STOP:\n\n```\n[quality-sweep] 3 consecutive pre-commit failures. Stopping for safety.\n```\n\n### 2. Select Next Project\n\n```bash\nnpx nx show projects 2>/dev/null | sort\n```\n\nPick the project at `projectIndex` from the sorted list. Skip projects in `processedProjects` or `failedProjects`. If all processed, STOP.\n\nSkip these projects entirely:\n\n- `crypto-enhanced`\n- Any project name containing `e2e` or `storybook`\n\n### 3. Run Lint with Auto-Fix\n\n```bash\npnpm nx lint PROJECT_NAME --fix 2>&1 | tail -40\n```\n\nRecord the output. If lint passes cleanly, move to step 4.\n\nIf lint errors remain after `--fix`, read ONLY the files with errors. Apply fixes using the Edit tool:\n\n- Fix unused imports: remove them\n- Fix missing return types: add explicit types\n- Fix `any` types: replace with proper types where obvious\n- Fix formatting: follow existing patterns\n\n**Max 3 fix iterations per project.** If errors persist after 3 rounds, log as failed and move on.\n\n### 4. Run Typecheck\n\n```bash\npnpm nx typecheck PROJECT_NAME 2>&1 | tail -40\n```\n\nIf typecheck passes, move to step 5.\n\nIf typecheck errors exist:\n\n- Read the erroring files\n- Fix obvious type errors (missing properties, wrong types, import issues)\n- Do NOT attempt complex refactors\n- Max 3 fix iterations\n\nIf errors persist after 3 rounds, log as partially fixed and move on.\n\n### 5. Stage and Commit\n\nStage ONLY files belonging to this project:\n\n```bash\n# Determine project root\nPROJECT_ROOT=$(npx nx show project PROJECT_NAME --json 2>/dev/null | grep -o '\"root\":\"[^\"]*\"' | cut -d'\"' -f4)\ngit add \"$PROJECT_ROOT/\" 2>/dev/null\n```\n\nCheck if there are staged changes:\n\n```bash\ngit diff --cached --stat\n```\n\nIf no staged changes, skip commit and move to next project.\n\nIf there are changes, commit:\n\n```bash\ngit commit -m \"$(cat <<'EOF'\nfix(PROJECT_NAME): auto-fix lint and type errors\n\nAutomated fixes applied by overnight quality sweep loop.\nEOF\n)\"\n```\n\n### 6. Handle Pre-Commit Result\n\nIf commit succeeds:\n\n- Reset `consecutivePrecommitFailures` to 0\n- Increment `commitCount`\n- Add project to `processedProjects`\n- Log success\n\nIf pre-commit hook fails:\n\n- Increment `consecutivePrecommitFailures`\n- Unstage all changes: `git restore --staged .`\n- Add project to `failedProjects`\n- Log failure with reason\n\n### 7. Auto-Merge Check\n\nIf `commitCount` is a multiple of 10 and > 0:\n\n```bash\nCURRENT_BRANCH=$(git branch --show-current)\ngit checkout main && git pull origin main 2>/dev/null\ngit merge \"$CURRENT_BRANCH\" --no-ff -m \"chore: auto-merge loop commits (batch)\" 2>&1\nMERGE_RESULT=$?\ngit checkout \"$CURRENT_BRANCH\"\n```\n\nIf merge fails, log the error but continue on the loop branch. Do NOT force anything.\n\n### 8. Update State\n\nWrite updated state back to `D:/logs/loop-sessions/YYYYMMDD/quality-sweep-state.json`:\n\n- Increment `projectIndex`\n- Update `commitCount`\n- Update `processedProjects` or `failedProjects`\n- Update `consecutivePrecommitFailures`\n\n### 9. Log\n\nAppend to `D:/logs/loop-sessions/YYYYMMDD/loop.log`:\n\n```bash\necho \"[$(date -Iseconds)] [quality-sweep] [PROJECT_NAME] lint: N errors fixed, typecheck: PASS/FAIL, commit: YES/NO/SKIPPED\" >> \"$SESSION_DIR/loop.log\"\n```\n\n## File Scope Rules\n\nLoop 1 (this loop) ONLY touches source code:\n\n- `apps/*/src/**`\n- `packages/*/src/**`\n- `packages/*/index.ts`\n- `apps/*/tsconfig*.json` (only to fix lint scope issues)\n\nNEVER touch:\n\n- Root config files (nx.json, package.json, .gitignore)\n- `docs/`, `tmp/`, `scripts/`\n- Build artifacts, test fixtures\n- Any file outside the current project's root\n\n## Recovery\n\nIf something goes wrong:\n\n1. Check D:\\logs\\loop-sessions\\YYYYMMDD\\loop.log\n2. `git log --oneline -20` to see what was committed\n3. `git revert HEAD~N..HEAD` to undo N commits\n4. Or restore D:\\ snapshot: `Restore-Snapshot.ps1 -Tag \"pre-loop-YYYYMMDD\"`", "variables": [], "notes": "Autonomous lint/typecheck fix loop - processes one project per turn Tools: Bash, Read, Edit, Glob, Grep.", "metadata": { "source": { "provider": "github-claude-commands", "repository": "https://github.com/freshwaterbruce2/vibe-tech-monorepo", "path": ".claude/commands/loop/quality-sweep.md", "ref": "a44693438a130be0daafa1651a91a9b8638b5bc1", "url": "https://github.com/freshwaterbruce2/vibe-tech-monorepo/blob/a44693438a130be0daafa1651a91a9b8638b5bc1/.claude/commands/loop/quality-sweep.md", "key": "freshwaterbruce2/vibe-tech-monorepo/.claude/commands/loop/quality-sweep.md" } } }

quality-sweep

About

Loop Quality Sweep - Auto-Fix Lint and Type Errors

Absolute Prohibitions

Per-Turn Workflow

1. Read State

2. Select Next Project

3. Run Lint with Auto-Fix

4. Run Typecheck

5. Stage and Commit

6. Handle Pre-Commit Result

7. Auto-Merge Check

8. Update State

9. Log

File Scope Rules

Recovery

Install quality-sweep and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews