@yojahny/wp-design-library 0.6.0 → 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yojahny/wp-design-library",
-  "version": "0.6.0",
+  "version": "1.0.0",
   "description": "Design reference corpus and MCP server for claude-wp-builder",
   "repository": {
     "type": "git",

package/src/cli/serve.mjs

@@ -11,8 +11,20 @@ async function syncSeed(p) {
   if (p.seed !== p.entries && fs.existsSync(p.seed)) {
     const path = await import('node:path');
     fs.mkdirSync(p.entries, { recursive: true });
+    // Healing missing files is not enough when the file that changed is one the volume already
+    // has. 0.6.0 rewrote every entry.md — artifacts became {key, bytes, sha256} records — and
+    // because the volume's copies existed, none were replaced: all 31 entries failed validation
+    // and the gallery served nothing but drafts. Copy-if-absent can only ever fix an entry that
+    // is incomplete, never one that is stale, so a schema change breaks the corpus permanently.
+    // The stamp closes that: when the image's version differs from the one this volume was last
+    // seeded at, entry.md is re-copied for the slugs the seed ships.
+    const stamp = path.join(p.data, '.seed-version');
+    let seeded;
+    try { seeded = fs.readFileSync(stamp, 'utf8').trim(); } catch { seeded = null; }
+    const upgraded = seeded !== p.version;
     let copied = 0;
     let healed = 0;
+    let refreshed = 0;
     for (const d of fs.readdirSync(p.seed, { withFileTypes: true })) {
       if (!d.isDirectory() || !fs.existsSync(path.join(p.seed, d.name, 'entry.md'))) continue;
       const src = path.join(p.seed, d.name);
@@ -31,9 +43,22 @@ async function syncSeed(p) {
           return true;
         },
       });
+      // Only entry.md, and only on an upgrade. Everything else the seed ships is inert next to
+      // an artifact record, and a hosted ingest never lands on a slug the image also ships — so
+      // what this can overwrite is an operator's hand-edit of a seeded entry, which an image
+      // upgrade was always going to supersede. Serving a corpus that validates beats preserving
+      // an edit that only exists until the next deploy.
+      if (!upgraded) continue;
+      const from = path.join(src, 'entry.md');
+      const to = path.join(dest, 'entry.md');
+      if (fs.readFileSync(from, 'utf8') === fs.readFileSync(to, 'utf8')) continue;
+      fs.copyFileSync(from, to);
+      refreshed++;
     }
+    fs.writeFileSync(stamp, p.version);
     process.stderr.write(`seed: copied ${copied} new entries into ${p.entries}\n`);
     process.stderr.write(`seed: healed ${healed} missing files into existing entries\n`);
+    process.stderr.write(`seed: refreshed ${refreshed} stale entry.md (volume seeded at ${seeded ?? 'unknown'}, image is ${p.version})\n`);
   }
 }