[derio-net/frank] 2026-05-27--orch--ruflo-upload-fix · Phase 4/4 · Docs + upstream PR + close#470
Merged
Merged
Conversation
Phase 4/4 of 2026-05-27--orch--ruflo-upload-fix. - frank-gotchas hot file + paperclip-ruflo.md: document the incomplete RvfGridFSBucket GridFS shim (upload/download/copy-on-fork parity fix), RVF-is-the-only-backend (DATABASE_URL ignored), and the per-model supportsTools/forceTools toggle MCP-load requirement. - File upstream PR ruvnet/ruflo#2293 (GridFS parity fix + the still-pending wasm:// urlSafety allow-line); link it from the gotchas. - Retroactively extend the ruflo building post (RVF Surprise, Part Two) and operating post (upload-500 troubleshooting + gotcha). - Set spec + plan Status to Deployed; tick all Phase 4 steps, complete phase. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
📦 Repo: derio-net/frank
📋 Plan: docs/superpowers/plans/2026-05-27--orch--ruflo-upload-fix
📐 Spec: docs/superpowers/specs/2026-05-27--orch--ruflo-image-upload-fix-design.md
🎯 Phase: 4/4 — Docs + upstream PR + close [agentic]
🔗 Issue: #454
Goal (from plan): Land the documentation, upstream PR, and close-out for the ruflo file-upload fix — the final phase of the
orch-layer fix that repairs the incompleteRvfGridFSBucketGridFS shim (image/file upload, download, and copy-on-fork all 500'd) and carries it forward on an upstream bump.Summary
Phase 4/4 — docs, upstream PR, and status close-out. The code fix landed in Phase 2 (#464) and was verified live in Phase 3 (#466); this phase is documentation + upstreaming only (no cluster changes).
Task 1 — Gotchas
docs/runbooks/frank-gotchas/paperclip-ruflo.md— new section documenting (a)RvfGridFSBucketis an incomplete GridFS shim (the three parity gaps: non-Writableupload, ArrayBuffer corruption, non-Readable/mis-shaped-cursor download & copy-on-fork — with incident date and fix), (b) ruvocal is RVF-only at this revision (no Mongo backend;DATABASE_URLsilently ignored), and (c) MCP tools only load for a model declaring per-modelsupportsTools/forceTools(elserunMcpFlowshort-circuits before thewasm://url-safety guard, making a liverejected.*wasmgrep vacuous). Linked the upstream PR.agents/rules/frank-gotchas.md(hot file) — two matching one-liners (shim-parity fix + supportsTools toggle).Task 2 — Upstream PR + close-out
RvfGridFSBucketGridFS-shim parity fix (verbatim of our build-timervf-gridfs-parity.patch, applies cleanly on current upstreammain— the file was unchanged for 150+ commits) and the still-pendingwasm://isValidUrlallow-line. Linked from the gotchas.**Status:**to Deployed. No# manual-operationblocks were added, so/sync-runbookis correctly skipped.Verification
scripts/validate-plans.sh→ exit 0.04.yaml.ruvnet/ruflo@main(git apply --checkOK) before pushing the PR branch.Closes #454