Hero Studio

@@ -25,7 +25,7 @@ const flags = {}; const pos = []; // Valueless flags MUST be declared: the old parser consumed the next token as // a value, so `--steal --headline "X"` silently dropped the headline (#42).-const BOOL_FLAGS = new Set(['steal', 'fresh-showcase', 'no-fallback', 'keep-alive']);+const BOOL_FLAGS = new Set(['steal', 'fresh-showcase', 'no-fallback', 'keep-alive', 'seed-only', 'no-local']); for (let i = 0; i < args.length; i++) {   if (!args[i].startsWith('--')) { pos.push(args[i]); continue; }   const name = args[i].slice(2);@@ -167,16 +167,56 @@ if (!state) {   if (!state) { console.error('hero-studio server did not come up on :' + port); process.exit(1); } } +// 2-local. The LOCAL PACKAGE subject source (hero-studio#52): a first hero is+// a PUBLISH PREREQUISITE, so at hero time the page often does not exist on the+// wiki yet -- but everything the studio needs is sitting in the invoking+// directory. When ./package.json (or page.json) matches the posed slug, its+// fields seed the subject and its images become showcase candidates.+// Precedence: local package -> wiki page -> generic mock ("prefer what is+// about to be published over what is already published"); explicit --title/+// --brief flags outrank everything. --no-local opts out.+let localPkg = null;+let localImages = [];+if (!('no-local' in flags)) {+  for (const mf of ['package.json', 'page.json']) {+    try {+      const m = JSON.parse(fs.readFileSync(path.join(process.cwd(), mf), 'utf8'));+      if ((m.slug || m.name || '').replace(/^.*\//, '') === slug) { localPkg = m; break; }+    } catch {}+  }+  if (localPkg) {+    const seen = new Set();+    const addImgs = (dir, excl) => {+      try {+        for (const f of fs.readdirSync(path.join(process.cwd(), dir))) {+          if (!/\.(png|jpe?g|webp)$/i.test(f)) continue;+          if (excl && excl.test(f)) continue;+          const rel = path.join(dir, f);+          if (!seen.has(rel)) { seen.add(rel); localImages.push(path.join(process.cwd(), rel)); }+        }+      } catch {}+    };+    // UI/part screenshots first (the old hero.png is the thing being REPLACED,+    // so it goes last, never first)+    addImgs('screenshots', /^hero\./i);+    addImgs('docs');+    try { if (fs.existsSync(path.join(process.cwd(), slug + '.png'))) localImages.push(path.join(process.cwd(), slug + '.png')); } catch {}+    console.error('local package subject: ' + (localPkg.title || slug) + ' (' + (localImages.length || 'no') + ' local image candidate(s))');+  }+}+ // 2. make sure the studio knows this package, then pose it. // --type accepts a comma list for multi-type pages (hero-studio#19, // e.g. --type app,service): the first entry drives the mode, the full set // renders as a pill group.-const title = flags.title || slug.split('-').map((w) => w[0].toUpperCase() + w.slice(1)).join(' ');-const typeList = String(flags.type || 'app').split(',').map((t) => t.trim()).filter(Boolean);+const localType = localPkg && (localPkg.type === 'hardware' ? 'component' : localPkg.type);+const title = flags.title || (localPkg && localPkg.title) || slug.split('-').map((w) => w[0].toUpperCase() + w.slice(1)).join(' ');+const localBrief = localPkg && (localPkg.brief || localPkg.description);+const typeList = String(flags.type || localType || 'app').split(',').map((t) => t.trim()).filter(Boolean); await jf('api/pages', {   method: 'POST', headers: { 'Content-Type': 'application/json' },   body: JSON.stringify(Object.fromEntries(Object.entries(-    { owner, slug, title, type: typeList[0], types: typeList.length > 1 ? typeList : null, brief: flags.brief },+    { owner, slug, title, type: typeList[0], types: typeList.length > 1 ? typeList : null, brief: flags.brief || localBrief },   ).filter(([, v]) => v))), }); // Every type poses into the app composition (title + subtitle + showcase@@ -196,6 +236,9 @@ await jf('state', {   method: 'POST', headers: { 'Content-Type': 'application/json' },   body: JSON.stringify({     mode: poseMode, page: ref,+    // #53: the legacy component lab's built-in sample part (a real JST MPN)+    // must never ride into a posed session; a posed page's comp slot is inert+    comp: { id: null },     // the gate presentation: verification chrome + a fresh checklist     verify: true, tour: true, marqueePreview: true, guides: false,     confirm: { title: false, subtitle: false, showcase: false, type: false },@@ -215,12 +258,41 @@ await jf('state', {   }), }); -// 2a-live. re-pull title/brief/type from the wiki (#30/#33): the seeded row-// above is only a fallback; the LIVE page wins when it exists.+// 2a-live. re-pull title/brief/type from the wiki (#30/#33). For a page with+// NO local package, the live page wins as before. With a local package the+// PRECEDENCE INVERTS (#52): local fields are what is about to be published,+// so they are re-asserted over the live row after the pull (which still runs+// for the metadata the local manifest lacks: score, stars, author). try {   const lv = await jf('refresh-page?page=' + ref, { method: 'POST' });-  if (lv && lv.ok) console.error('live page: "' + lv.title + '"');+  if (lv && lv.ok) console.error('live page: "' + lv.title + '"' + (localPkg ? ' (local package fields win for this pose)' : '')); } catch {}+if (localPkg) {+  await jf('api/pages', {+    method: 'POST', headers: { 'Content-Type': 'application/json' },+    body: JSON.stringify(Object.fromEntries(Object.entries(+      { owner, slug, title, type: typeList[0], brief: flags.brief || localBrief },+    ).filter(([, v]) => v))),+  });+}+// 2a-showcase. Stage the best local image as the showcase (unless staged work+// is being preserved on a same-page re-pose, or the caller staged their own).+if (localImages.length && !(samePageRepose && !('fresh-showcase' in flags))) {+  const pick = localImages[0];+  const sc = await jf('showcase-file', {+    method: 'POST', headers: { 'Content-Type': 'application/json' },+    body: JSON.stringify({ path: pick }),+  });+  if (sc && sc.ok) {+    console.error('local showcase staged: ' + path.relative(process.cwd(), pick) + (localImages.length > 1 ? ' (alternatives: ' + localImages.slice(1, 4).map((f) => path.relative(process.cwd(), f)).join(', ') + '; swap with `hero-studio showcase --file <path>`)' : ''));+  }+}+// Test hook (#52 verification): everything above ran; skip the human gate.+if ('seed-only' in flags) {+  const st = await jf('state');+  console.log(JSON.stringify({ ok: true, seedOnly: true, page: st.page, resolved: st.resolved, showcaseBytes: (st.showcase && st.showcase.src || '').length, localImages: localImages.map((f) => path.relative(process.cwd(), f)) }));+  process.exit(0);+}  // 2b. fresh change ledger for THIS review session (#20): everything the human // edits at the gate (page fields + pose deltas) accumulates from here and