Ensure that we display an appropriate error message for when there is .maintenance file

[katinthehatsite]

Related issues

Fixes STU-1847

How AI was used in this PR

It was used to implement the solution.

Proposed Changes

This PR ensures that when there is a .maintenance file and a fresh lock, the appropriate message is displayed to the user if they try to stop and start the site. It detects the lock that is fresher than 10 minutes and after 10 minutes, WordPress will ignore the stale lock file.

Testing Instructions

• Pull the changes from this branch and start Studio with npm start
• Create a site (or use an existing one) and start it
• Test fresh lock — create a .maintenance file with a recent timestamp by running in your Terminal the following (make sure to replace with the name of your site):

  echo '<?php $upgrading = '$(date +%s)'; ?>' > ~/Studio/<your-site-name>/.maintenance

• Stop the site in Studio, then try to start it. You should see a message saying WordPress is in maintenance
  mode and the lock will expire within 10 minutes:

• Test no lock — delete the file:
  rm ~/Studio/<your-site-name>/.maintenance
• Start should work normally.

Pre-merge Checklist

• Have you checked for TypeScript, React or other console errors?

[wpmobilebot]

📊 Performance Test Results

Comparing 9e71055 vs trunk

app-size

Metric	trunk	9e71055	Diff	Change
App Size (Mac)	1411.96 MB	1411.97 MB	+0.01 MB	⚪ 0.0%

site-editor

Metric	trunk	9e71055	Diff	Change
load	1088 ms	1072 ms	16 ms	⚪ 0.0%

site-startup

Metric	trunk	9e71055	Diff	Change
siteCreation	6532 ms	6514 ms	18 ms	⚪ 0.0%
siteStartup	2393 ms	2385 ms	8 ms	⚪ 0.0%

---

Results are median values from multiple test runs.

Legend: 🟢 Improvement (faster) | 🔴 Regression (slower) | ⚪ No change (<50ms diff)

[katinthehatsite]

This is the behaviour compared to trunk:

[bcotrim]

I suggest moving the checkMaintenanceFile to the CLI so it covers the app, cli and agent workflows.
The app can still catch the error to display the correct Maintenance file error message.
What do you think?

[katinthehatsite]

Thanks for the review @bcotrim - I applied your suggestion!

[gavande1]

Thanks for addressing the concerns. I tested this, and it looks good to me. ✅

[katinthehatsite]

Thanks for the review @gavande1 🙇