18 · Issue logs & diagnostics

What you'll do

Look behind the scenes — the errors TofuFactory caught and healed, the running log of what it's been doing — and package a report when you need to hand the problem to someone.

You won't need this day to day. It's here for the times something feels off and you want to see what actually happened, or troubleshooting sent you to get a closer look.

The error log

TofuFactory watches itself. When something low-level goes wrong — a failed request, a lost AI process, a locked file — it logs it and, most of the time, recovers on its own.

Go to System → Error Log. On it you can:

• Filter by severity — errors, warnings, or just-so-you-know notices.
• Open a row to see the details of what went wrong underneath.
• Ignore one that healed itself or doesn't matter, to clear it off the active warnings.
• See its status — whether the app already recovered, or it still needs a look.

The activity log (Flight Recorder)

The Flight Recorder is the read-only running record of what the factory did and why — a step beyond a single job's detail view. Go to System → Flight Recorder to trace things like:

• Which job the factory chose to run next, and why.
• The moment a job was handed to a particular AI.
• When working copies of your code were created and cleaned up.
• When finished work was merged back into your project.

Package a diagnostic report

If the app won't start, can't reach its database, or keeps crashing, you can bundle up the details for whoever helps you run it:

1. Go to Settings → Diagnostics.
2. Click Generate report.
3. The app gathers system info, your setup, and what's running — and leaves out passwords and keys.
4. Click Download ZIP and send them the file.

You should now see

• The error log, with caught issues and whether they healed.
• The Flight Recorder streaming the factory's actions.
• A diagnostic ZIP saved to your computer when you need one.

If something's not right

Problem	What to do
The error log is a long list	Don't panic — it records every self-heal attempt. Anything marked resolved sorted itself out; only the active ones need you.
The Flight Recorder stopped updating	Reload the page — it streams live, and a network blip can drop the connection.
The report wouldn't generate	Check you have free disk space and that the app can write to its own folders.

Next

→ 19 · Tofu Runner & Easter eggs — you've earned a break.