Studio: Improve context for errors that bubble up from wordpress-server-child

[katinthehatsite]

Related issues

Fixes STU-1496

How AI was used in this PR

It was used to help identify the issue.

Proposed Changes

This PR ensures that we display more detailed error message to the user from wordpress-server-child

Testing Instructions

• Pull the changes from this branch
• Start Studio with npm start
• Use the broken blueprint e.g.
  broken-blueprint.json
• Click on Add site -> Build a new site -> Upload blueprint
• Observe that you can see more details about why the upload failed:

• Confirm that when you open Studio logs, you can also find more details there:

Pre-merge Checklist

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

[wpmobilebot]

📊 Performance Test Results

Comparing bfc9ba3 vs trunk

app-size

Metric	trunk	bfc9ba3	Diff	Change
App Size (Mac)	1384.37 MB	1384.37 MB	+0.00 MB	⚪ 0.0%

site-editor

Metric	trunk	bfc9ba3	Diff	Change
load	1642 ms	1668 ms	+26 ms	⚪ 0.0%

site-startup

Metric	trunk	bfc9ba3	Diff	Change
siteCreation	9007 ms	9033 ms	+26 ms	⚪ 0.0%
siteStartup	4402 ms	4407 ms	+5 ms	⚪ 0.0%

---

Results are median values from multiple test runs.

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

[bcotrim]

This can hit timezone issues, the tag here is UTC but the daemon writes the filename in local time, so the file won’t be found. I’d suggest looking up the most recent studio-site-${ siteId } log files instead.

[katinthehatsite]

I implemented this suggestion in 8b04b28

[bcotrim]

While testing with another Blueprint, I noticed the new error parsing can show misleading errors to users.

The dialog trims the message at the first ., so URLs/domains get cut off. In this case the real URL is:

https://example.com/missing-plugin.zip

But the dialog only shows it up to https://example.:

This seems to come from simplifyErrorToFirstSentence() treating any . as a sentence boundary.

Test Blueprint:

{
	"meta": {
		"title": "Broken URL Test Blueprint",
		"author": "Studio test",
		"description": "Intentionally fails while fetching a plugin ZIP from a broken URL."
	},
	"preferredVersions": {
		"php": "8.3",
		"wp": "latest"
	},
	"steps": [
		{
			"step": "installPlugin",
			"pluginData": {
				"resource": "url",
				"url": "https://example.com/missing-plugin.zip"
			}
		}
	]
}

[katinthehatsite]

Thanks for the review @bcotrim ! I will take a look: I initially went with shortening because in some cases the errors were too long and too confusing to read 🙈

[katinthehatsite]

I made adjustments and it should now look like this:

Let me know what you think!

[bcotrim]

LGTM 👍
Nice solution @katinthehatsite, thanks for making the changes