@pressgang-wp/shakedown 0.1.1 → 0.1.3

package/README.md

@@ -45,7 +45,7 @@ Optional `shakedown.config.json` in the theme, for overrides only:
 
 Authored journeys (form submissions, checkout flows) live in your theme's `tests/e2e/` — when present they run alongside the derived passes as the `journeys` project.
 
-**Seeding is convention-first.** If your theme ships [Muster](https://github.com/pressgang-wp/pressgang-muster) seeders (`src/Muster/*`), the sandbox runs them via `wp capstan seed` as the baseline — your real menus, terms and pages — then layers the derived populated/minimal ACF state fixtures on top. A theme that ships no seeders is unaffected: the derived layer covers it on its own, so it does a good job out of the box.
+**Seeding is convention-first.** If your theme ships [Muster](https://github.com/pressgang-wp/pressgang-muster) seeders (a top-level `muster/` directory), the sandbox runs them via `wp capstan seed` as the baseline — your real menus, terms and pages — then layers the derived populated/minimal ACF state fixtures on top. A theme that ships no seeders is unaffected: the derived layer covers it on its own, so it does a good job out of the box.
 
 Sandbox fixture randomness and time are separate deterministic inputs. `seed`
 controls generated values; `epoch` fixes relative dates used by Muster,

package/bin/seed-states.php

@@ -4,11 +4,16 @@
  * the sandbox isolation witness has already proven this WordPress runs on
  * throwaway SQLite before this script is invoked).
  *
- * For every ACF field group with a seedable location target, creates two
- * published fixtures via Muster:
- *   - populated: every generatable field filled (deterministic, seeded)
- *   - minimal:   required fields only — the sparsest state an editor can
- *                legally publish, where empty-link/missing-image bugs live
+ * Each ACF field group is seeded according to where it is located:
+ *   - post types, page and post templates → a dedicated PAIR of fixtures,
+ *     `populated` (every generatable field filled) and `minimal` (required
+ *     fields only — the sparsest publishable state, where empty-link and
+ *     missing-image bugs live), each with a placeholder featured image;
+ *   - options pages → the populated values written once (global chrome);
+ *   - the front page (`page_type=front_page`) → the populated values onto the
+ *     home page, reusing a theme-assigned front page or creating one;
+ *   - nav-menu-item groups → left to the theme's own seeder, whose menus carry
+ *     the real structure the fields attach to.
  *
  * Run via: wp eval-file bin/seed-states.php <muster-autoload> <acf-json-dir> <seed> <epoch>
  * Emits JSON: {"routes": [{url, kind, expect}...]} for the matrix.
@@ -51,13 +56,23 @@ $generator = new AcfValueGenerator($context->victuals(), [
 		->id(),
 	'post' => function (array $types) use ($context): int {
 		$type = $types[0] ?? 'post';
+		$slug = 'state-related-' . sanitize_title($type);
 
-		return (new PostBuilder($context, $type))
+		$ref = (new PostBuilder($context, $type))
 			->title('State related ' . $type)
-			->slug('state-related-' . sanitize_title($type))
+			->slug($slug)
 			->status('publish')
-			->save()
-			->id();
+			// Pin before the fixture epoch so relationship stubs sink below the
+			// real fixtures in date-ordered feeds rather than heading them.
+			->date($context->clock()->epoch()->modify('-1 year')->format('Y-m-d H:i:s'))
+			->save();
+
+		(new AttachmentBuilder($context, "{$slug}-thumb"))
+			->placeholder(1200, 800)
+			->featuredOn($ref)
+			->save();
+
+		return $ref->id();
 	},
 	'term' => fn (string $taxonomy): int => (new TermBuilder($context, $taxonomy))
 		->name('State term')
@@ -68,43 +83,90 @@ $generator = new AcfValueGenerator($context->victuals(), [
 ]);
 
 $routes = [];
+$liveAcf = new LiveAcfAdapter();
 
 foreach (AcfJson::groups($acfJsonDir) as $group) {
 	$targets = AcfJson::targets($group);
 
 	if ($targets === []) {
-		continue; // menu items, page_type rules — not seedable (v1)
+		continue; // no seedable location (taxonomy terms, user roles, …)
 	}
 
 	$target = $targets[0];
+	$fields = (array) $group['fields'];
+	$slugBase = sanitize_title($group['title'] ?? $group['key']);
 
 	// Options-page groups are global state, not a URL: seed the populated
-	// values once so chrome (header/footer) renders fully. The unseeded
-	// fresh install already exercises the empty-options state.
+	// values once so chrome (header/footer) renders fully. The unseeded fresh
+	// install already exercises the empty-options state.
 	if ($target['param'] === 'options_page') {
-		(new LiveAcfAdapter())->updateFields($generator->populated((array) $group['fields']), 'option', 0);
+		$liveAcf->updateFields($generator->populated($fields), 'option', 0);
 		continue;
 	}
-	$slugBase = sanitize_title($group['title'] ?? $group['key']);
 
+	// The front page is a singular surface — seed the populated state onto the
+	// one home page. Reuse the front page a theme seeder may already have set;
+	// assign one only when none exists, so we never fight a theme-authored home.
+	// The matrix's own `/` route covers it, so no dedicated route is emitted.
+	// Other page_type values (top_level, …) have no generic surface to seed.
+	if ($target['param'] === 'page_type') {
+		if ($target['value'] !== 'front_page') {
+			continue;
+		}
+
+		$frontId = (int) get_option('page_on_front');
+		if ($frontId === 0) {
+			$frontId = (new PostBuilder($context, 'page'))
+				->title('Home')
+				->slug('state-front-page')
+				->status('publish')
+				->date($fixtureDate)
+				->save()
+				->id();
+			update_option('show_on_front', 'page');
+			update_option('page_on_front', $frontId);
+		}
+
+		$liveAcf->updateFields($generator->populated($fields), 'post', $frontId);
+		continue;
+	}
+
+	// nav_menu_item groups attach to a menu's items, which exist only once a
+	// menu is built with the theme's real structure — that is the theme
+	// seeder's job. The derived path leaves them to the baseline rather than
+	// inventing a menu here.
+	if ($target['param'] === 'nav_menu_item') {
+		continue;
+	}
+
+	// Per-instance surfaces (post types, page and post templates): a dedicated
+	// populated AND minimal fixture, so the sparsest publishable state is
+	// exercised alongside the full one.
 	foreach (['populated', 'minimal'] as $variant) {
-		$fields = (array) $group['fields'];
 		$values = $variant === 'populated' ? $generator->populated($fields) : $generator->minimal($fields);
 
-		$builder = $target['param'] === 'page_template'
-			? (new PostBuilder($context, 'page'))->template($target['value'])
-			: new PostBuilder($context, $target['value']);
+		$builder = match ($target['param']) {
+			'page_template' => (new PostBuilder($context, 'page'))->template($target['value']),
+			'post_template' => (new PostBuilder($context, 'post'))->template($target['value']),
+			default         => new PostBuilder($context, $target['value']),
+		};
 
 		$ref = $builder
 			->title(($group['title'] ?? $group['key']) . ' — ' . $variant)
 			->slug("state-{$slugBase}-{$variant}")
 			->status('publish')
 			->date($fixtureDate)
-
 			->content('State fixture: ' . $slugBase . ' (' . $variant . ')')
 			->acf($values)
 			->save();
 
+		// A placeholder featured image so archive and card thumbnails render
+		// instead of the theme's empty-thumbnail fallback.
+		(new AttachmentBuilder($context, "state-thumb-{$slugBase}-{$variant}"))
+			->placeholder(1200, 800)
+			->featuredOn($ref)
+			->save();
+
 		$url = get_permalink($ref->id());
 
 		if ($url) {

package/lib/sandbox.mjs

@@ -285,6 +285,12 @@ export async function bootSandbox(target, options = {}) {
     }
   }
 
+  // Clear WordPress's install defaults (Hello world!, Sample Page, the seeded
+  // comment) so the sandbox starts from a deterministic empty state — only
+  // seeded fixtures exist, and no version-dependent defaults leak into feeds,
+  // archives, or menus.
+  wp(root, ['site', 'empty', '--yes']);
+
   wp(root, ['rewrite', 'structure', '/%postname%/', '--hard']);
 
   const server = spawn('wp', ['server', `--host=127.0.0.1`, `--port=${port}`, `--docroot=${docroot}`, `--path=${root}`], {
@@ -308,7 +314,7 @@ export async function bootSandbox(target, options = {}) {
 
 /**
  * Convention-first baseline seeding: run the theme's OWN Muster seeders
- * (anything under its `src/Muster/`) via `wp capstan seed`, so a theme that
+ * (anything under its `muster/` directory) via `wp capstan seed`, so a theme that
  * ships fixtures gets its real content — menus assigned to locations, terms,
  * pages, relationships — exactly as `wp capstan seed` produces on a dev site.
  * The ACF state fixtures (see {@link seedAcfStates}) then layer on top.
@@ -323,7 +329,8 @@ export async function bootSandbox(target, options = {}) {
  * @returns {boolean} True when theme seeders ran; false when none were applied.
  */
 export function seedThemeMuster(sandbox, { seed = 42 } = {}) {
-  const musterDir = join(sandbox.root, 'wp-content', 'themes', sandbox.theme ?? '', 'src', 'Muster');
+  // Seeders live in a top-level `muster/` directory (mapped under autoload-dev).
+  const musterDir = join(sandbox.root, 'wp-content', 'themes', sandbox.theme ?? '', 'muster');
 
   if (!sandbox.theme || !existsSync(musterDir)) {
     return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pressgang-wp/shakedown",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Sea trials for PressGang themes — config-derived e2e smoke testing",
   "type": "module",
   "license": "MIT",