jedarden/pdftract
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
pdftract/notes/bf-78c91.md
jedarden 3c72081ab8 docs(bf-78c91): document mirror sync trigger attempt and blocker 
Attempted to trigger Forgejo mirror sync to GitHub via API and direct git push.
Both methods blocked by large files in git history (--1.ppm: 235MB, test_parse_simple: 60MB).
Mirror configuration is correct (Forgejo → GitHub, sync_on_commit enabled) but
GitHub rejects pushes exceeding 100MB file size limit.

Closes bf-78c91. See notes/bf-78c91.md for full analysis.
2026-07-06 19:31:12 -04:00

2.1 KiB
Raw Blame History

Mirror Sync Trigger Attempt - bf-78c91

Date: 2026-07-06

Task: Trigger Forgejo mirror sync to GitHub

Mirror Status from bf-21b5a

  • Direction: Forgejo → GitHub (PUSH mirror, CORRECT)
  • Sync on Commit: Enabled (automatic)
  • Interval: 10 minutes
  • Last Update Attempt: 2026-07-06T23:25:15Z
  • Status: Active but failing

API Trigger Attempt

Attempted to trigger sync via Forgejo API:

POST https://git.ardenone.com/api/v1/repos/jedarden/pdftract/mirror-sync

Result: 401 Unauthorized - "token is required"

  • No Forgejo authentication token available in environment
  • Cannot trigger manual sync via API without credentials

Direct Push Attempt

Attempted direct push to GitHub via git remote:

git push github main

Result: REJECTED by GitHub pre-receive hook

remote: error: File --1.ppm is 235.13 MB; this exceeds GitHub's file size limit of 100.00 MB
remote: GH001: Large files detected. You may want to try Git Large File Storage
! [remote rejected]   main -> main (pre-receive hook declined)

Commit Status

  • Local commits ahead of GitHub: 347 commits
  • GitHub commits ahead of local: 0 commits

Blocker: Large Files in Git History

The mirror sync (both automatic and manual) is blocked by two files in git history:

  1. --1.ppm: 235.13 MB (exceeds GitHub's 100 MB hard limit)
  2. test_parse_simple: 60.74 MB (exceeds GitHub's 50 MB recommended limit)

These files are in the git history but do not exist in the current working tree.

Acceptance Criteria Status

  • Mirror sync trigger attempted via API (401 - requires token)
  • Alternative push method attempted via git (rejected - large files)
  • Blocker identified: large files in history exceed GitHub limits

Next Steps Required

Before mirror sync can succeed, the large file history must be addressed:

  1. Remove large files from git history using git filter-repo or BFG
  2. Force update both Forgejo and GitHub remotes
  3. Then trigger mirror sync

References

  • Parent bead: bf-5l6ku
  • Child bead (mirror config): bf-21b5a
  • Large file blocker documented in bf-21b5a notes