BSKY-1042: site-spec integration for AI site builder #105543

ariskataoka · 2025-09-03T17:12:40Z

Description

Part of # https://linear.app/a8c/issue/BSKY-1041/integrate-site-spec-in-wordpresscom-environments

This pull request introduces a new system for integrating the SiteSpec lib into Calypso, including configuration, script/CSS loading utils, and a "Site Step" in the AI Site Builder flow that leverages SiteSpec as a test. The changes are grouped into three main areas: feature integration, configuration and env support, and utility/testing infrastructure.

This PR depends on wordpress.com PR 191598.

Why are these changes being made?

We need to replace the current AI site builder with site-spec, also bringing over the ability to build the site specification within Calypso.
Note: This PR does not remove the existing site builder, it just adds a new way to do that. Let's remove the existing one in a separate PR.

Testing Instructions

Point your sandbox to the PR 191598 branch, Proxy your public-api and widgets.wp.com hosts
In development, the feature is already enabled in config/development.json
Navigate to the new AI site builder page: http://calypso.localhost:3000/setup/ai-site-builder/site-spec and

Verify Site-Spec loads correctly
Verify CSS styles are applied
Confirm the Site-Spec interface renders properly
Verify that you're site is built correctly after adding the prompt

calypso.mp4

Pre-merge Checklist

Has the general commit checklist been followed? (PCYsg-hS-p2)
Have you written new tests for your changes?
Have you tested the feature in Simple (P9HQHe-k8-p2), Atomic (P9HQHe-jW-p2), and self-hosted Jetpack sites (PCYsg-g6b-p2)?
Have you checked for TypeScript, React or other console errors?
Have you tested accessibility for your changes? Ensure the feature remains usable with various user agents (e.g., browsers), interfaces (e.g., keyboard navigation), and assistive technologies (e.g., screen readers) (PCYsg-S3g-p2).
Have you used memoizing on expensive computations? More info in Memoizing with create-selector and Using memoizing selectors and Our Approach to Data
Have we added the "[Status] String Freeze" label as soon as any new strings were ready for translation (p4TIVU-5Jq-p2)?
- For UI changes, have we tested the change in various languages (for example, ES, PT, FR, or DE)? The length of text and words vary significantly between languages.
For changes affecting Jetpack: Have we added the "[Status] Needs Privacy Updates" label if this pull request changes what data or activity we track or use (p4TIVU-aUh-p2)?

github-actions · 2025-09-03T17:12:51Z

Calypso Live (direct link)

	https://calypso.live?image=registry.a8c.com/calypso/app:build-155378

Jetpack Cloud live (direct link)

	https://calypso.live?image=registry.a8c.com/calypso/app:build-155378&env=jetpack

Automattic for Agencies live (direct link)

	https://calypso.live?image=registry.a8c.com/calypso/app:build-155378&env=a8c-for-agencies

matticbot · 2025-09-03T17:19:15Z

This PR modifies the release build for the following Calypso Apps:

For info about this notification, see here: PCYsg-OT6-p2

blaze-dashboard
happy-blocks
help-center
notifications
odyssey-stats
wpcom-block-editor

To test WordPress.com changes, run install-plugin.sh $pluginSlug try/site-spec-integration-cdn on your sandbox.

ariskataoka · 2025-09-03T17:46:52Z

@aagam-shah @dereksmart just to clarify this piece is the site spec lib only, so auth is still not addressed. But I believe it can be a base to turn into an app where we can add the auth layer.

config/_shared.json

client/lib/site-spec/script-loader.ts

client/lib/site-spec/use-site-spec.ts

client/lib/site-spec/utils.ts

aswasif007

Code reviewed and tested. I have left some minor comments, plus we want to use the latest version of the site-spec bundle.

Approving as I don't see any major change required.

…ation-cdn

dereksmart

this is causing the default root http://calypso.localhost:3000/setup/ai-site-builder/ start at /site-spec, whether it's enabled in config or not. When it's not, it just lands on a white page.

The entrypoints in prod go to http://calypso.localhost:3000/setup/ai-site-builder/ and would be broken.

dereksmart · 2025-09-11T16:51:24Z

package.json

@@ -108,10 +108,10 @@
 		"reformat-files": "./node_modules/.bin/prettier --ignore-path .eslintignore --write \"**/*.{js,jsx,json,ts,tsx}\"",
 		"search:storybook:start": "echo 'Deprecated, run `yarn workspace @automattic/search run storybook:start` instead'",
 		"site-admin:storybook:start": "yarn workspace @automattic/site-admin run storybook:start",
-		"start": "npx check-node-version --package && node bin/welcome.js && yarn run build && yarn run start-build",
+		"start": "npx check-node-version --package && node --max-old-space-size=8192 bin/welcome.js && yarn run build && yarn run start-build",


I am very not sure about updating the whole project's start script. Why is this needed?

You're very right to be unsure about this being for the whole project. Thanks for calling this out.
And no, we shouldn’t force this in the project-wide start - prod/CI already run with higher limits (e.g. TC is set to 16 GB), and hard-coding in the project could unintended cap those. The flag was only to unblock a local js heap out of memory for the welcome.js.
I'm reverting this change in this PR and we can raise a follow-up PR adding a start with higher memory/or per environment memory set.

dereksmart · 2025-09-11T16:51:59Z

config/development.json

@@ -174,6 +174,7 @@
 		"signup/social-first": true,
 		"site-indicator": true,
 		"site-profiler/metrics": true,
+		"site-spec": true,


we can enable this in stage.json too (easier to test internally)

…ation-cdn

ariskataoka · 2025-09-12T06:23:18Z

this is causing the default root http://calypso.localhost:3000/setup/ai-site-builder/ start at /site-spec, whether it's enabled in config or not. When it's not, it just lands on a white page.

The entrypoints in prod go to http://calypso.localhost:3000/setup/ai-site-builder/ and would be broken.

Thanks for taking the time to review this, @dereksmart !
I've addressed the above in e9126d2

dereksmart · 2025-09-12T14:40:56Z

@ariskataoka can we please not make it the default starting point for http://calypso.localhost:3000/setup/ai-site-builder/ in general?

It would be great to have this in staging for internal folks to test it easily without also breaking the current site creation flows.

Until we are ready to get this in a production setting, I think the standalone spec should only be accessible with a direct link to it.

aagam-shah and others added 22 commits September 1, 2025 11:56

Initial commit to test site-spec app integration

85b5f9a

Save state

f6c42b1

Import site-spec as we do for other wpcom scripts

54697b3

Cleanup

a119705

More cleanup

01bc241

Try move loading css

bc126ec

Move css load to a more appropriate area

e9a9f24

Move css to its own function

8d0f4a6

Cleanup

879e62a

We dont need react imports as it is now part of the SiteSpec bundle

ce1a4cf

Cleanup

8bad13c

Linter

60cf575

Rename site-spec-script with site-spec

7cd03a5

Add css url config

0cede20

Group site-spec config into its own section

af6a7d4

Add note to readme

d71f7a0

Remove complexity

8547d78

Linter

47bc6d9

Update readme with load css details

889c6a1

FIx test

0f39f97

Add correct URLs for site-spec script and css

67d92e5

Remove debug logs

4e1f882

ariskataoka requested a review from a team as a code owner September 3, 2025 17:12

matticbot added the [Status] Needs Review The PR is ready for review. This also triggers e2e canary tests and wp-desktop tests automatically. label Sep 3, 2025

ariskataoka requested a review from aagam-shah September 3, 2025 17:13

ariskataoka requested a review from dereksmart September 3, 2025 17:47

ariskataoka changed the title ~~BSKY-1041: Try add site-spec integration~~ BSKY-1042: Try add site-spec integration Sep 4, 2025

Fix array branch error

5061404

aswasif007 reviewed Sep 8, 2025

View reviewed changes

config/_shared.json Outdated Show resolved Hide resolved

aswasif007 reviewed Sep 8, 2025

View reviewed changes

client/lib/site-spec/script-loader.ts Outdated Show resolved Hide resolved

aswasif007 reviewed Sep 8, 2025

View reviewed changes

client/lib/site-spec/use-site-spec.ts Outdated Show resolved Hide resolved

aswasif007 reviewed Sep 8, 2025

View reviewed changes

client/lib/site-spec/utils.ts Outdated Show resolved Hide resolved

aswasif007 approved these changes Sep 8, 2025

View reviewed changes

ariskataoka added 7 commits September 9, 2025 09:58

Update site-spec bundle version

d6f7b36

Throw err instead of reject

213ebd9

Warn when site-spec fails to load

d10e817

Verify blank space in config url as well

bd05489

Fix test mock complexity

3187eb9

Merge remote-tracking branch 'origin/trunk' into try/site-spec-integr…

f2cb5ad

…ation-cdn

Merge remote-tracking branch 'origin/trunk' into try/site-spec-integr…

424006d

…ation-cdn

ariskataoka requested review from aagam-shah, aswasif007 and saroshaga September 10, 2025 01:13

saroshaga changed the title ~~BSKY-1042: Try add site-spec integration~~ BSKY-1042: site-spec integration for AI site builder Sep 10, 2025

ariskataoka marked this pull request as draft September 11, 2025 07:00

ariskataoka marked this pull request as ready for review September 11, 2025 07:14

dereksmart requested changes Sep 11, 2025

View reviewed changes

dereksmart reviewed Sep 11, 2025

View reviewed changes

ariskataoka added 5 commits September 12, 2025 14:24

Merge remote-tracking branch 'origin/trunk' into try/site-spec-integr…

d51a605

…ation-cdn

Keep default behaviour when site-spec is set to false

e9126d2

Enable site-spec in stage config

9e9bfcc

Remove mem limit from start project

3c216b4

Merge remote-tracking branch 'origin/trunk' into try/site-spec-integr…

8afd948

…ation-cdn

ariskataoka requested a review from dereksmart September 12, 2025 09:34

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

BSKY-1042: site-spec integration for AI site builder #105543

BSKY-1042: site-spec integration for AI site builder #105543

ariskataoka commented Sep 3, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Sep 3, 2025 •

edited by matticbot

Loading

Uh oh!

matticbot commented Sep 3, 2025 •

edited

Loading

Uh oh!

ariskataoka commented Sep 3, 2025 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

aswasif007 left a comment

Uh oh!

dereksmart left a comment •

edited

Loading

Uh oh!

dereksmart Sep 11, 2025

Uh oh!

ariskataoka Sep 12, 2025

Uh oh!

dereksmart Sep 11, 2025

Uh oh!

ariskataoka Sep 12, 2025

Uh oh!

ariskataoka commented Sep 12, 2025

Uh oh!

dereksmart commented Sep 12, 2025

Uh oh!

Uh oh!

BSKY-1042: site-spec integration for AI site builder #105543

Are you sure you want to change the base?

BSKY-1042: site-spec integration for AI site builder #105543

Conversation

ariskataoka commented Sep 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Why are these changes being made?

Testing Instructions

Pre-merge Checklist

Uh oh!

github-actions bot commented Sep 3, 2025 • edited by matticbot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

matticbot commented Sep 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ariskataoka commented Sep 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

aswasif007 left a comment

Choose a reason for hiding this comment

Uh oh!

dereksmart left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dereksmart Sep 11, 2025

Choose a reason for hiding this comment

Uh oh!

ariskataoka Sep 12, 2025

Choose a reason for hiding this comment

Uh oh!

dereksmart Sep 11, 2025

Choose a reason for hiding this comment

Uh oh!

ariskataoka Sep 12, 2025

Choose a reason for hiding this comment

Uh oh!

ariskataoka commented Sep 12, 2025

Uh oh!

dereksmart commented Sep 12, 2025

Uh oh!

Uh oh!

ariskataoka commented Sep 3, 2025 •

edited

Loading

github-actions bot commented Sep 3, 2025 •

edited by matticbot

Loading

matticbot commented Sep 3, 2025 •

edited

Loading

ariskataoka commented Sep 3, 2025 •

edited

Loading

dereksmart left a comment •

edited

Loading