Known issues & roadmap
Bugs, fixes, and what's coming.
Found a bug or have feedback? Please email [email protected].
v0.4.3 is the current candidate, pending manual release review. See its candidate notes before choosing a download.
Open issues and validation for the 0.4.3 candidate
| Issue | Status | What to expect |
|---|---|---|
| macOS release validation | pending | Search and health-check recovery is integrated in source, with recorded macOS development tests. The repaired 0.4.3 installer and release build still need native installer, launcher, browser, scheduling, and diagnostic checks. This is not yet a verified macOS release. |
| Some sources require forced cleanup | open | Windows tester runs recorded repeated AMS and StepStone cleanup failures. Recovered listings can still be included, but the digest is marked degraded. |
| Completion and local-report access need clearer wording | open | A partial digest can be a completed run. A later run may contain only newly found jobs; open the earlier HTML report to revisit its results. |
Fixes included in 0.4.3
These changes have automated regression coverage. Field validation is still pending, and older fallback builds do not include them.
| Issue | Candidate change |
|---|---|
| Employer research stalled during browser cleanup | Supervised cleanup now extends to employer research, addressing the teardown stall that delayed report delivery. Real browser and native Mac validation remain part of the release checks. |
| Large Discord digests exceeded message limits | Digests are split by total text and embed count. Oversized cards continue in order, and repeated job links are sent in separate messages. A failed batch still records delivery as unsuccessful. |
| macOS installer selected an unsupported Python | The installer selects and reuses a supported Python, checks macOS 14+, and ships executable script permissions in the ZIP. Native installation validation remains pending. |
| Scheduler status could match another LaunchAgent | The status check now matches FOX3's exact agent label. A plist present on disk still does not establish that the agent is loaded or that scheduled runs will execute. |
Earlier fixes and continuing limitations
| Issue | Status | Workaround |
|---|---|---|
| Settings changes didn't take effect until you restarted the app | fixed | Fixed in v0.3.4. Changes you save in the control panel now apply immediately, and a run started right after a change uses the new values — no restart needed. |
| CVs from LaTeX / tight-typography PDFs dropped most dates; some Word CVs stopped reading partway | fixed | Fixed in v0.3.4. FOX3 now recovers the word-spacing that some PDFs (often exported from LaTeX) drop, so your dates come through, and it reads Word CVs with merged table cells all the way to the end. Update to the latest build — what's new. |
| The "update available" notice in the control panel was easy to miss | fixed | Fixed in v0.3.4. A new version now shows as a prominent banner at the top of the control panel, and the update check no longer briefly freezes the panel when it opens. |
| Where's the desktop shortcut? | known | The installer reports whether the launcher was created, skipped, or failed. If it is missing, use the printed fallback command. A created launcher may still have a blank icon. |
| PDF CVs with a side-column layout can still list dates out of order | known | v0.3.4 recovers dates that some PDFs were dropping, but a true two-column layout can still place a
side-column date next to the wrong role. Prefer a .docx, .txt, or
.md CV for the cleanest profile; FOX3 always shows you what it parsed, so you can
correct it. Layout-aware PDF parsing is on the list. |
| Unsigned build → Windows SmartScreen / macOS "unidentified developer" warning | fix planned | Windows: More info → Run anyway. macOS: System Settings → Privacy & Security → Open Anyway
(or run xattr -d com.apple.quarantine <file> in Terminal). Signing and notarization are V1 release work; no delivery date is set. |
| Tuning your digest (good/bad feedback) still needs a command-line step | fix planned | Run fox3 feedback to rate listings — now a proper branded command. An in-app feedback surface, to rate right from the dashboard, is on the way. |
| The control panel can briefly hang if force-closed during a live run | investigating | Shutdown and cancellation still need final release checks. Previously saved scores can be reused, but review the run status and local report before starting again. |
| Company-pages / priority-employer field shows but is "in development" | investigating | Naming a priority employer still boosts its listings in scoring; dedicated company-page scraping is not built yet. |
| Multi-line CV/answer paste in the console interview can mis-split lines (Windows) | mitigated | Use /paste mode (end with a single .); completed turns are checkpointed. |
| Very relaxed search constraints can hit the run budget cap before deep research | by design | Expected: scoring can stop at the budget cap, and deep research can be skipped to protect cost. Tighten the region/keywords to go deeper. I'm exploring better and more efficient algorithms. |
When an issue is fixed it's tagged fixed here for one release, then retired to the version history once the next build ships.
V1 development
Thank you to everyone who helped test the beta. The V1 direction includes a desktop interface, an in-app job database, a guided interview with multiple supporting documents, and broader job discovery. CV tailoring and improvements to installation, updates, and localization are also on the roadmap.
These are development plans, not released features or a delivery schedule. Stay tuned for updates as V1 takes shape.