"""Spaceship spike: /tmp/space-spike/pub = showroom (browse/spaceships.html + the modules it imports, vendor, spaceships.json, blobs incl. painted copies) + a renders page with one card per craft, grouped by family. usage: python3 tools/space/build_spike_space.py "" then tools/space/publish_spike_space.sh Reads browse/spaceships.json (tools/space/manifest_space.py). No cards = it says so and changes nothing. A linked render or blob that cannot be found = no index.html, so publish_spike_space.sh refuses and the last good copy stays online. Tests can point it elsewhere with SPACE_SPIKE_ROOT (a repo-shaped tree) and SPACE_SPIKE_OUT.""" import html, io, json, os, re, shutil, subprocess, sys from datetime import datetime from PIL import Image ROOT = os.environ.get('SPACE_SPIKE_ROOT') or os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) OUT = os.environ.get('SPACE_SPIKE_OUT', '/tmp/space-spike/pub') E = html.escape stamp = sys.argv[1] if len(sys.argv) > 1 else '' FAM = {'fighters': 'Fighters (several genres)', 'alien': 'Alien vessels', 'ships': 'Spaceships: shuttles, freighters, gunships', 'pods': 'Escape pods', 'cruisers': 'Cruisers', 'battleships': 'Battleships', 'motherships': 'Motherships', 'speeders': 'Speeders'} def job_bytes(job, name): """a file of a space job: the job dir, else git (None if nowhere)""" p = f'{ROOT}/jobs/{job}/{name}' if os.path.exists(p): return open(p, 'rb').read() r = subprocess.run(['git', '-C', ROOT, 'show', f'HEAD:jobs/{job}/{name}'], capture_output=True) return r.stdout if r.returncode == 0 and r.stdout else None def job_minutes(job): """minutes between started.txt and finished.txt of the job (None when either is missing)""" a, b = job_bytes(job, 'started.txt'), job_bytes(job, 'finished.txt') if not (a and b): return None try: t = lambda x: datetime.fromisoformat(x.decode().strip().replace('Z', '+00:00')) return max(1, round((t(b) - t(a)).total_seconds() / 60)) except ValueError: return None def is_gemini(a): return 'gemini-4' in (a or '').lower() def drawn_by(a): """the model that drew it in Blender (card provenance.author), in plain words""" a = a or 'GPT-6 Astra' return 'GPT-6 Astra' if 'astra' in a.lower() else 'Gemini 4 Argon (Antigravity CLI)' if is_gemini(a) else a def list_cost(job): """list price of a Gemini job from its relay log (agy4_cost.py), '' when there is no log""" relay = job_bytes(job, 'agy-relay.log') if not relay: return '' r = subprocess.run(['python3', os.path.expanduser('~/forge-hub/agent/agy4_cost.py'), '/dev/stdin'], input=relay, capture_output=True) return f" · ${json.loads(r.stdout)['usd_list']:.2f} list" if r.returncode == 0 and r.stdout else '' def local_modules(rel): """the local ES modules a page or module imports, recursively; relative paths kept (stage.mjs pulls garage/paint.mjs)""" seen, todo = set(), [rel] while todo: f = todo.pop() text = open(f'{ROOT}/browse/{f}').read() for m in re.findall(r"""(?:from|import)\s*\(?\s*['"]\./([\w./-]+\.m?js)['"]""", text): g = os.path.normpath(os.path.join(os.path.dirname(f), m)) if g not in seen: seen.add(g); todo.append(g) return sorted(seen) manifest = f'{ROOT}/browse/spaceships.json' cards = json.load(open(manifest)) if os.path.exists(manifest) else [] if not cards: print('0 spacecraft cards in browse/spaceships.json (run tools/space/manifest_space.py): nothing built, nothing changed') sys.exit(0) if os.path.exists(OUT): shutil.rmtree(OUT) os.makedirs(f'{OUT}/blobs'); os.makedirs(f'{OUT}/renders') for f in ['spaceships.html', 'spaceships.json', *local_modules('spaceships.html')]: os.makedirs(os.path.dirname(f'{OUT}/{f}') or OUT, exist_ok=True) shutil.copy(f'{ROOT}/browse/{f}', f'{OUT}/{f}') shutil.copytree(f'{ROOT}/browse/garage', f'{OUT}/garage', dirs_exist_ok=True) # stage.mjs also reads garage/colormap.png when a kit asks for it shutil.copytree(f'{ROOT}/browse/vendor', f'{OUT}/vendor', symlinks=False, ignore=shutil.ignore_patterns('fge-look', 'rapier')) lost_blobs = [] for v in cards: for sha in filter(None, [v['glb'], v.get('painted_glb')]): src = f'{ROOT}/store/blobs/{sha}.glb' if os.path.exists(src): shutil.copy(src, f'{OUT}/blobs/') else: lost_blobs.append(f"{v['slug']}:{sha[:10]}") for src, dst, w in (('final.png', 'final', 1280), ('paints.png', 'paints', 1280), ('sheet.jpg', 'sheet', 1280), ('painted-before.jpg', 'painted-before', 1600), ('painted-after.jpg', 'painted-after', 1600)): b = job_bytes(v['job'], src) if b: im = Image.open(io.BytesIO(b)).convert('RGB') if im.width > w: im = im.resize((w, int(w * im.height / im.width))) im.save(f"{OUT}/renders/{v['slug']}-{dst}.jpg", quality=86) def fmt_len(m): return f'{m:,.0f}' if m >= 100 else f'{m:.1f}' def card_html(v): s = v['slug'] mins = job_minutes(v['job']) took = f' · took {mins} min' if mins else '' cost = list_cost(v['job']) if is_gemini(v.get('author')) else '' pair = '' if os.path.exists(f'{OUT}/renders/{s}-painted-before.jpg') and os.path.exists(f'{OUT}/renders/{s}-painted-after.jpg'): pair = (f'
Before: Blender textures
After: repainted copy
' f'{E(v[
') return f"""
{E(v['title'])}, Blender render

{E(v['title'])}

{fmt_len(v['size'][2])} m long · {v['tris'] / 1000:.0f}k triangles · {v['bytes'] / 1e6:.1f} MB · {len(v['paints'])} paints{' · v' + str(v['version']) if v['version'] > 1 else ''}

Drawn by {E(drawn_by(v.get('author')))}{took}{cost}

{pair}
Paints and reference sheetpaintsreference sheet
""" rows = [] for fam in [*FAM, *sorted({v['family'] for v in cards} - set(FAM))]: fvs = [v for v in cards if v['family'] == fam] if not fvs: continue rows.append(f'

{E(FAM.get(fam, fam))} {len(fvs)} {"model" if len(fvs) == 1 else "models"}

') rows.extend(card_html(v) for v in fvs) rows.append('
') npaint = sum(1 for v in cards if v.get('painted_glb')) page = f""" Forge spaceships
Forge spaceships

Forge spaceships

{len(cards)} models built in Blender from a concept sheet by GPT-6 Astra or Gemini 4 Argon (each card says which), packed for phones (KTX2 + Draco). Every one recolours, the moving parts move, and there is no insignia or text, so games add their own factions.{f' {npaint} of them also {"has" if npaint == 1 else "have"} a painted copy, repainted by an image model.' if npaint else ''} Updated {E(stamp)}.

Open the 3D showroom {''.join(rows)}
""" # publish_spike_space.sh mirrors with --delete: a page pointing at a render we could not find would wipe the last good copy. # No index.html = publish_spike_space.sh refuses. lost = sorted({m for m in re.findall(r'src="(renders/[^"]+)"', page) if not os.path.exists(f'{OUT}/{m}')}) if lost or lost_blobs: sys.exit(f'NOT publishable: {len(lost)} renders missing ({" ".join(lost[:8])}), {len(lost_blobs)} blobs missing ({" ".join(lost_blobs[:6])}); no index.html written') open(f'{OUT}/index.html', 'w').write(page) print(OUT, len(cards), 'spacecraft,', npaint, 'with a painted copy')