openclaw - 💡(How to fix) Fix refactor: consolidate mega-merge files under mega/ directory [1 comments, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#57951Fetched 2026-04-08 01:55:47
View on GitHub
Comments
1
Participants
1
Timeline
3
Reactions
0
Author
Participants
Timeline (top)
closed ×1commented ×1locked ×1

Move all mega-merge tooling into a dedicated mega/ top-level directory to fully isolate integration-build noise from upstream source history.

Root Cause

Move all mega-merge tooling into a dedicated mega/ top-level directory to fully isolate integration-build noise from upstream source history.

Code Example

mega/
├── scripts/
│   └── mega-merge.ts          (moved from scripts/)
├── docs/
│   ├── history.json           (was docs/mega-merge-history.json)
│   ├── autoskip.json          (was docs/mega-merge-autoskip.json)
│   ├── report.json            (was docs/mega-merge-report.json)
│   ├── changelog.md           (was docs/mega-merge-changelog.md)
│   └── pr-cache.json          (was docs/mega-merge-pr-cache.json)
└── runbook.md                 (operational notes)
RAW_BUFFERClick to expand / collapse

Summary

Move all mega-merge tooling into a dedicated mega/ top-level directory to fully isolate integration-build noise from upstream source history.

Proposed layout

mega/
├── scripts/
│   └── mega-merge.ts          (moved from scripts/)
├── docs/
│   ├── history.json           (was docs/mega-merge-history.json)
│   ├── autoskip.json          (was docs/mega-merge-autoskip.json)
│   ├── report.json            (was docs/mega-merge-report.json)
│   ├── changelog.md           (was docs/mega-merge-changelog.md)
│   └── pr-cache.json          (was docs/mega-merge-pr-cache.json)
└── runbook.md                 (operational notes)

What stays at root: CLAUDE.md, README.md, .github/workflows/mega-merge.yml

Benefits

  • git diff mega/ vs git diff src/ — mega-merge noise is fully isolated
  • git log -- src/ shows only upstream PR changes, no chore commits
  • .gitignore entry is one line: mega/docs/pr-cache.json
  • Any future mega-merge tooling (dashboard, scripts) has a natural home
  • Upstream openclaw's docs/ and scripts/ folders stay uncontaminated — easier to diff against upstream later

Work required

  1. git mv scripts/mega-merge.ts mega/scripts/mega-merge.ts
  2. git mv docs/mega-merge-history.json mega/docs/history.json
  3. git mv docs/mega-merge-autoskip.json mega/docs/autoskip.json
  4. git mv docs/mega-merge-report.json mega/docs/report.json
  5. git mv docs/mega-merge-changelog.md mega/docs/changelog.md
  6. Update all hardcoded paths inside mega-merge.ts (e.g. docs/mega-merge-history.jsonmega/docs/history.json)
  7. Update .github/workflows/mega-merge.yml: bun scripts/mega-merge.tsbun mega/scripts/mega-merge.ts
  8. Update .gitignore: replace docs/mega-merge-pr-cache.jsonmega/docs/pr-cache.json
  9. Update README.md key files table with new paths

Tradeoff

scripts/mega-merge.tsmega/scripts/mega-merge.ts requires updating the workflow run: command. Trivial one-line change.

extent analysis

Fix Plan

To move the mega-merge tooling into a dedicated mega/ top-level directory, follow these steps:

  1. Move files:

    • git mv scripts/mega-merge.ts mega/scripts/mega-merge.ts
    • git mv docs/mega-merge-history.json mega/docs/history.json
    • git mv docs/mega-merge-autoskip.json mega/docs/autoskip.json
    • git mv docs/mega-merge-report.json mega/docs/report.json
    • git mv docs/mega-merge-changelog.md mega/docs/changelog.md
  2. Update hardcoded paths in mega-merge.ts: Replace occurrences of:

    • docs/mega-merge-history.json with mega/docs/history.json
    • docs/mega-merge-autoskip.json with mega/docs/autoskip.json
    • docs/mega-merge-report.json with mega/docs/report.json
    • docs/mega-merge-changelog.md with mega/docs/changelog.md

    Example:

    // Before
    const historyPath = 'docs/mega-merge-history.json';
    // After
    const historyPath = 'mega/docs/history.json';
  3. Update .github/workflows/mega-merge.yml: Replace bun scripts/mega-merge.ts with bun mega/scripts/mega-merge.ts.

  4. Update .gitignore: Replace docs/mega-merge-pr-cache.json with mega/docs/pr-cache.json.

  5. Update README.md: Modify the key files table to reflect the new paths.

Verification

After completing these steps, verify that:

  • The files have been moved correctly using git ls-tree -r --name-only HEAD
  • The workflow runs successfully with the updated mega-merge.ts path
  • The .gitignore entry is correctly ignoring the pr-cache.json file
  • The README.md reflects the updated file paths

Extra Tips

  • Make sure to commit each step separately for easier tracking and rollback if needed.
  • Consider adding a test to ensure the mega-merge tooling works as expected after the move.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING