from pathlib import Path
from collections import defaultdict
import re, json, html, hashlib, shutil, base64, argparse, zipfile
from parse_substellar_blocks import blocks_from_text
from planning_hub import render_planning
from illustrated_companion import IllustratedCompanion, read_records
from edition05_companion import CurrentDirectionEdition, NEW_SOURCES, NEW_KEYS
ROOT=Path(__file__).resolve().parent
PORTABLE=(ROOT.name=='sources' and (ROOT.parent/'index.html').exists())
OUT=ROOT.parent if PORTABLE else ROOT/'substellar'
DIAGRAM_ROOT=OUT/'images/diagrams' if PORTABLE else ROOT/'diagrams'
DIAGRAM_META=ROOT/'overview-diagrams.json' if PORTABLE else ROOT/'diagrams/overview-diagrams.json'
def copy_file(source,dest):
source,dest=Path(source),Path(dest)
if source.resolve()!=dest.resolve():shutil.copy2(source,dest)
SOURCES=[('approved','complete_text_for_typesetting.txt','Approved text'),('industry','industry_progression_expansion.txt','Industry expansion'),('moon-mars','moon_mars_expansion.txt','Destination expansion'),('tier1','tier1_space_expansion.txt','Tier 1 expansion'),('first-playable','first_playable_expansion.txt','First Playable planning'),('tier1-models','tier1_model_specifications.txt','Tier 1 model specifications'),('illustrated','illustrated_companion.txt','Illustrated reading companion')]+NEW_SOURCES
PLANNING_HTML=''
COMPANION=None
CURRENT=None
ART={
'EAR01_H': {'source':'illustrated_assets/EAR01_H_Overworld.png','name':'Overworld — home and the first descent','caption':'The familiar surface remains the emotional center: blue water, a readable quarry, warm shelter, and a route into the Earth. Existing concept image, reused in this edition.','kind':'Existing concept'},
'EAR03_H': {'source':'illustrated_assets/EAR03_H_Deepwilds.png','name':'Deepwilds — a living underground landscape','caption':'A shared atmosphere reference for vegetation, water, player scale, and warm maintained refuges. The complete written atlas retains quiet, sparse, wet, and dry variations beyond this image.','kind':'Existing concept'},
'EAR05_H': {'source':'illustrated_assets/EAR05_H_Abyss.png','name':'Abyss — a refuge against the deep','caption':'Warm shelter and a maintained crossing establish a route through immense columns, dark water, and exposed ground. The other Abyss experiences remain individually named in the text and artwork backlog.','kind':'Existing concept'},
'OV-EARTH': {'source':'generated_images/exec-df67088b-7ab2-4654-9a6d-675b8a07f4f3.png','name':'Earth — four more realm identities','caption':'Shallows, Underreach, Mantle, and Core receive an overview panel each. These are concept moods and example activities; the seven-realm diagram defines the relationships, and the complete text defines all 35 regional experiences.','kind':'New overview'},
'OV-MOON': {'source':'generated_images/exec-116b91aa-0ecc-4ad8-b0e9-d3e3e2920654.png','name':'Moon — from the surface to Glassfall Vaults','caption':'A first foothold on a crater rim, a tethered shallow descent, a sheltered gallery habitat, and a deep glass survey. Surface and cave profiles are fictional game regions, with no implied breathable lunar caves.','kind':'New overview'},
'OV-MARS': {'source':'generated_images/exec-74e1393b-d7ac-448c-b59f-d74b71dd5eef.png','name':'Mars — a frontier above and below ground','caption':'Windcut terrain and old drainage lead into Ochre Galleries, Brine Scarps, and Rootstone Chambers. Imported equipment supports the first expedition; local materials improve subsequent operations.','kind':'New overview'}
}
if (ROOT/'overview_generated_assets.json').exists():
for k,v in json.loads((ROOT/'overview_generated_assets.json').read_text()).items():
ART.setdefault(k,{}).update(v)
def esc(s):return html.escape(str(s),quote=True)
def slug(s):
return re.sub(r'[^a-z0-9]+','-',s.lower()).strip('-')
def inline(s):
# Preserve words and punctuation while interpreting the draft's exact inline markup.
tokens=re.split(r'(\*\*.*?\*\*|`[^`]+`|https?://[^\s<>]+)',str(s))
parts=[]
for t in tokens:
if t.startswith('**') and t.endswith('**'):parts.append(''+esc(t[2:-2])+'')
elif t.startswith('`') and t.endswith('`'):parts.append(''+esc(t[1:-1])+'')
elif re.match(r'https?://',t):
url=t.rstrip('.,;)');suffix=t[len(url):]
parts.append(''+esc(url)+''+esc(suffix))
else:parts.append(re.sub(r'\bREF(\d{2})\b',lambda m:''+m[0]+'',esc(t)))
return ''.join(parts)
def plain(s):return html.unescape(re.sub(r'<[^>]*>','',inline(s)))
def words(s):return len(re.findall(r"\b[\w]+(?:[’'-][\w]+)*\b",re.sub(r'[#*`|]',' ',s)))
def badge(label,kind=''):return ''+esc(label)+''
CHAPTERS=[];SOURCE_BLOCKS={};TITLE_ANCHORS={};ID_ANCHORS={};SEARCH=[]
for key,filename,label in SOURCES:
path=ROOT/filename
if not path.exists():raise RuntimeError('Missing complete source: '+filename)
blocks=blocks_from_text(path.read_text());SOURCE_BLOCKS[key]=blocks;chapter=None;ci=0
for bi,b in enumerate(blocks):
if b[0]=='heading' and b[1]==1:
ci+=1;cid=('ch' if key=='approved' else key)+'-'+str(ci).zfill(2)+'-'+slug(b[2])
chapter={'id':cid,'title':b[2],'source':key,'label':label,'index':ci,'blocks':[],'subheads':[]}
CHAPTERS.append(chapter);TITLE_ANCHORS[b[2]]=cid
if chapter is None:raise RuntimeError('Source must begin with a chapter: '+filename)
blockid=f'{key}-{bi:04d}';anchor=chapter['id'] if b[0]=='heading' and b[1]==1 else blockid
if b[0]=='heading' and b[1]>1:
anchor=chapter['id']+'--'+slug(b[2]);
if any(x.get('anchor')==anchor for x in chapter['blocks']):anchor+='-'+str(bi)
chapter['subheads'].append({'anchor':anchor,'level':b[1],'title':b[2]})
TITLE_ANCHORS.setdefault(b[2],anchor)
text=' '.join(' '.join(row) for row in b[1]) if b[0]=='table' else b[2] if b[0]=='heading' else b[1]
for ident in re.findall(r'\b(?:T1-[A-Z]+-?\d+|FP-(?:PLAN-\d+|B\d+|ART\d+|C\d+|R\d+)|MO-PLAN-\d+|MA-PLAN-\d+|IND-M\d+|IP\d+|MAT\d+|PM\d+|EQ\d+|TEC\d+|SUPPLY\d+|BIO\d+|FL\d+|HUL\d+|CEC\d+|SPX\d+|UX\d+|EAR\d+|SET\d+|DST\d+|ENC\d+|MO-[SL]\d|MA-[SL]\d)\b',text):
if b[0]=='heading' and key not in ('first-playable','tier1-models') and key not in NEW_KEYS:ID_ANCHORS[ident]=anchor
else:ID_ANCHORS.setdefault(ident,anchor)
if key in NEW_KEYS:
for ident in re.findall(r'\b(?:CD05-(?:T\d+|[AD]\d+)|WP05-(?:PLAN-|B|AC)?\d+|LE05-(?:PLAN-|AC)?\d+|OS05-\d+)\b',text):
if b[0]=='heading':ID_ANCHORS[ident]=anchor
else:ID_ANCHORS.setdefault(ident,anchor)
chapter['blocks'].append({'block':b,'index':bi,'id':blockid,'anchor':anchor})
if b[0]=='heading':chapter['current_heading']=b[2]
SEARCH.append({'id':anchor,'chapter':chapter['title'],'title':chapter.get('current_heading',chapter['title']),'text':plain(text),'source':key})
# Realm and destination IDs open their actual chapter, while order/recipe IDs
# retain the exact source table in which they are defined.
for prefix,titles in [('EAR',['Overworld','Shallows','Deepwilds','Underreach','Abyss','Mantle','Core']),('DST',['Moon','Mars','Ceres','Europa','Io','Titan','Pluto','Cairn','Morrow'])]:
for number,title in enumerate(titles,1):
ID_ANCHORS[prefix+str(number).zfill(2)]=TITLE_ANCHORS[title]
def anchor(title):
if title in TITLE_ANCHORS:return TITLE_ANCHORS[title]
if title in ID_ANCHORS:return ID_ANCHORS[title]
matches=[v for k,v in TITLE_ANCHORS.items() if title.lower() in k.lower()]
return matches[0] if matches else 'complete-text'
def link(title,label=None):return ''+esc(label or title)+''
def idlink(ident):return ''+esc(ident)+''
def artpath(ident):return 'images/'+slug(ident)+'.webp'
def originalpath(ident):return 'images/originals/'+slug(ident)+'.png'
REFS=json.loads((ROOT/'reference_catalogue.json').read_text())
for r in REFS['records']:
ART[r['id']]={'source':r['file_path'],'name':r['title'],'caption':'; '.join(r['appearance_notes'][:2]),'kind':'Confirmed reference','record':r}
for r in read_records(ROOT/'illustrated_03_boards.json'):
path=ROOT/'illustrated_03_assets'/Path(r['file']).name
if PORTABLE or path.is_file():
ART[r['id']]={'source':str(path),'name':r['title'],'caption':r.get('caption',r.get('alt','')),'kind':'Illustrated overview concept','record':r}
if PORTABLE:
for ident in ART:ART[ident]['source']=str(OUT/originalpath(ident))
def plate(ident,caption=None):
x=ART.get(ident)
if not x:raise RuntimeError('Missing required overview art '+ident)
name=x['name'];cap=caption or x['caption']
return f'''
{esc(name)}{esc(ident)} · {esc(x['kind'])}
{esc(cap)}'''
DIAGRAMS=json.loads(DIAGRAM_META.read_text())['diagrams']
def diagram(name):
rec=next(x for x in DIAGRAMS if x['file']==name+'.svg')
svg=(DIAGRAM_ROOT/rec['file']).read_text()
svg=re.sub(r'<\?xml[^>]*>','',svg)
# Namespacing protects markers and accessibility references when all seven SVGs are inline.
svgids=re.findall(r'\bid="([^"]+)"',svg)
for sid in sorted(svgids,key=len,reverse=True):
newid=name+'-'+sid
svg=svg.replace('id="'+sid+'"','id="'+newid+'"').replace('url(#'+sid+')','url(#'+newid+')').replace('href="#'+sid+'"','href="#'+newid+'"')
svg=re.sub(r'(aria-labelledby=")([^"]+)(")',lambda m:m[1]+' '.join(newid if v==sid else v for v in m[2].split())+m[3],svg)
return f'{svg}{esc(rec["alt"])} Open full-size diagram'
def sectionhead(num,title,desc=''):
return '
'+esc(num)+'
'+esc(title)+'
'+('
'+esc(desc)+'
' if desc else '')+'
'
def card(title,desc,href=None,ident=None,status=None,extra='',imageid=None):
im=f'' if imageid else ''
image_anchor=' id="art-'+slug(imageid)+'"' if imageid in ('EAR01_H','EAR03_H','EAR05_H') else ''
return ''+im+(''+esc(ident)+'' if ident else '')+'
'+esc(title)+'
'+(''.join(badge(*s) for s in status) if status else '')+'
' if href else '')+''
def render_overview():
original_words=words((ROOT/SOURCES[0][1]).read_text())
add_words=sum(words((ROOT/f).read_text()) for k,f,l in SOURCES[1:])
h=f'''
Creative & product direction · Illustrated overview 03
Every world goes deeper.
A complete reference for SUBSTELLAR: the Earth beneath home, the worlds beyond it, and the industry, equipment, settlements, and journeys that connect them.
PALE HORIZON / CONFIRMED REFERENCE 03A first room beneath an unfamiliar sky.
The Explorer and its supporting systems establish the first complete Earth–Moon–Earth journey.
{original_words:,}Approved words preserved
{add_words:,}Words of additional direction
15Confirmed reference sheets
7 + 5Original diagrams + world boards
'''
if CURRENT:
h=h.replace('Creative & product direction · Illustrated overview 03','Creative & product direction · Current edition 05').replace('href="#illustrated-overview">Open the illustrated guide','href="#current-edition">Open the current direction').replace('7 + 5Original diagrams + world boards','59Concepts, references and diagrams')
h+=CURRENT.hub()
h+=render_chapters([c for c in CHAPTERS if c['source'] in NEW_KEYS], source_band=False)
h+=CURRENT.review_and_maps()
if COMPANION:
h+='
Retained illustrated overview 03
The complete high-level atlas and reading guides
The ten guides and their original eight-board production record are preserved below. Their edition-specific counts describe that earlier overview. The visual directory includes the three additional concept boards and six diagrams from edition 05.
'
h+=COMPANION.intro()+COMPANION.coverage()+COMPANION.chapter_directory()+COMPANION.visual_directory()
h+='Earlier planning edition 02 — specifications and original image briefs
This retained planning record predates the illustrated overview. Its zero-generation statement and two pending briefs describe that earlier delivery. The current visual catalogue records the completed overview boards and diagrams.
'+PLANNING_HTML+''
h+='
The original five world overview boards and their earlier edition labels are retained. Current illustrated coverage is recorded in the ten reading guides and visual catalogue above.
'
h+=''+sectionhead('Reading this edition','The complete plan, made navigable.','The approved text remains intact. New planning is identifiable, and future artwork has named tasks.')
h+='''
'''+badge('Approved text','confirmed')+'''
All 36 chapters and 28 tables from the approved text edition remain below, in full and in order.
'''+badge('New planning','new')+'''
The industrial progression, machine catalogue, Moon, Mars, and complete Tier 1 systems are expanded for review.
'''+badge('Confirmed reference','confirmed')+'''
Your 15 supplied sheets define the space hardware’s visual direction. Their labels are searchable as ordinary text.
Overview coverage is kept separate from individual regions, machine states, model views, and final asset production.
'''
h+='
Current direction takes precedence where the new references clarify it.
The Tier 1 Explorer Rocket is the first physical spacecraft and supports both orbital and lunar missions. The earlier Keel and Pilgrim hull proposals are retained in the approved text for context. Attainable Earth materials support the first complete round trip; advanced industry and deep Earth discoveries strengthen later exploration. The new expansion explains these changes explicitly.
'
h+='
Use the contents to open any chapter, or press / to search across the full writing, reference labels, and art backlog. Section links identify passages. Optional review notes stay in your browser and can be exported. The illustrations are creative references; exact connections and labels live in the diagrams and text.
'
h+=''+sectionhead('01 / The whole horizon','The Solar System, and Afterlight.','All eight planets are represented. Campaign destinations, optional branches, orbital settings, and planning backlog are distinguished.')+diagram('solar-system')
dest=[
('Moon','Pale Horizon','Learn to leave, descend, establish a refuge, and return. Silence, dust, fractured hollows, basalt passages, and impact glass.', 'Moon — complete destination planning expansion','OV-MOON'),
('Mars','Red Frontier','Read the old drainage, cross a weather-shaped surface, build a Frontier Yard, and investigate the geology beneath it.','Mars — complete destination planning expansion','OV-MARS'),
('Ceres','Optional industrial branch','Anchors, fractured routes, contained ice-pocket extraction, and cargo transfer. Holdfast makes a difficult route workable.','Ceres',None),
('Europa','Outer Worlds','Descend through the ice ceiling into Lantern Ocean and its fictional vent ecology. Pressure, current, sensing, and protected refuge define the expedition.','Europa',None),
('Io','Optional thermal branch','Survey and time an operation among mineral chimneys, cooling passages, and Furnace Wells. Build a bounded pocket of industrial order.','Io',None),
('Titan','Outer Worlds','Amber shorelines, waxlike passages, local underground weather, and slow folded life. Establish a harbor and learn a route through haze.','Titan',None),
('Pluto','Solar System conclusion','Long shadows, frozen folds, Nightglass optics, and the Quiet Lens. Complete the Far Observatory and choose what comes after homecoming.','Pluto',None),
('Cairn','Afterlight / Beyond Sol','Tilted plates, Inverted Terraces, Palimpsest Halls, and the Witness Engine. Read what remains and chart a local route to Morrow.','Cairn',None),
('Morrow','Afterlight / capstone','Sheltering growth, Rooted Vaults, Tide Orchards, and Hearthsea. Observation and a useful conservatory turn discovery into a place to tend.','Morrow',None)]
h+='
'
for title,tag,desc,target,img in dest:
expanded=title in ('Moon','Mars')
status=[('Documented','confirmed'),('Overview included','overview')]
if not expanded:status.append(('Further design expansion — backlog','backlog'))
h+=card(title,desc,anchor(target),tag,status,imageid=img)
h+='
'
planets=[('Mercury','#9b8a7c','Further design expansion — backlog','A named Solar System location in the atlas. Landing, strata, activities, and campaign role await design.'),('Venus','#d6b16b','Further design expansion — backlog','Atmosphere and surface identity need a deliberate gameplay brief before a new destination is promised.'),('Jupiter','#b69b82','Orbital setting','A monumental orbital view and access context for Europa and Io. No conventional solid landing surface is promised.'),('Saturn','#cebe8c','Orbital setting','Ringed orbital scenery and access context for Titan. Station and route details remain future work.'),('Uranus','#88bdc1','Further design expansion — backlog','Represented in the atlas. A future brief must choose orbital activity, supported moons, or another explicit experience.'),('Neptune','#5a7aa7','Further design expansion — backlog','Represented in the atlas. Future destination planning must define its role and scope before content expansion.')]
for name,color,status,desc in planets:
h+=f'
{name}
'+badge(status,'backlog' if 'backlog' in status else 'overview')+'
'+esc(desc)+'
'
h+='
'+plate('OV-OUTER')+plate('OV-FRONTIERS')+''
h+=''+sectionhead('02 / The first world','Seven realms. Thirty-five experiences.','Depth is a tendency, with lateral geography and overlapping transitions. These are not seven equally thick floors.')+diagram('earth-layers')
h+=plate('OV-EARTH')+'
'
for name,ident,desc in [('Overworld','EAR01_H','Ordinary survival, expressive landscapes, a useful home, and the quarry’s invitation underground.'),('Deepwilds','EAR03_H','A living underground landscape of canopies, shores, gardens, cultivation, and established return routes.'),('Abyss','EAR05_H','Exposed crossings, pillars, dark water, careful navigation, and the emotional warmth of a dependable refuge.')]:
h+=card(name,desc,anchor(name),status=[('Documented','confirmed'),('Concept included','overview')],imageid=ident)
h+='
World-generation contract. The documented working envelope is 512 total block levels, Y −192 through 319. The Core is the fictional deep-crust Heart environment. Final realm allocations remain a generation decision. '+link('The vertical world specification','Read the full specification →')+'
'
h+=''+sectionhead('03 / Pale Horizon','The Moon is a full destination.','Two surface experiences and three underground regions, with a first foothold, a growing workshop, a campaign, and reasons to return.')+plate('OV-MOON')+diagram('moon-layers')
h+='
'+card('A Light Across the Basin','Connect observations, reflectors, and relay sites; learn the return route; expand from a small refuge to a useful lunar base.',anchor('MO-PLAN-07'),ident='MOON CAMPAIGN')+card('From regolith to a better expedition','Regolith Ceramic strengthens habitats and thermal panels. Lunar Glass Filament improves instruments and lighting. Earth-built equipment enables the first samples.',anchor('MO-PLAN-05'),ident='MATERIAL → PROCESS → USE')+'
'+link('Moon — complete destination planning expansion','Read the complete Moon planning expansion')+' — generation, all five regions, conditions, local industry, controller stages, mission beats, three expeditions, progression, acceptance criteria, and named future art.
'
h+=''+sectionhead('04 / Red Frontier','Mars asks for field competence.','Weather, rover routes, repairable industry, buried drainage, and a more independent frontier home.')+plate('OV-MARS')+diagram('mars-layers')
h+='
'+card('The River That Isn’t There','Connect the surface delta to buried channels and Rootstone observations. The mission rewards interpreting a connected place.',anchor('MA-PLAN-07'),ident='MARS CAMPAIGN')+card('A Frontier Yard that earns its place','A service pad and shelter grow into a rover bay, repair gantry, weather mast, greenhouse, and supply depot. Ferric Lattice and Brine Catalyst improve later operations.',anchor('MA-PLAN-06'),ident='OUTPOST → REGIONAL CAPABILITY')+'
'+link('Mars — complete destination planning expansion','Read the complete Mars planning expansion')+' — all five regions, weather and recovery, processing chains, outpost stages, mission evidence, three expeditions, revisits, and future artwork.
'
return h
def render_progression():
reg=json.loads((ROOT/'industry_progression_register.json').read_text())
h=''+sectionhead('05 / Capability, work, and travel','Progression lives in what you can do.','A readable industrial world: machinery with physical purpose, broad processing capability, and meaningful operating choices.')+diagram('progression')
h+='
A first launch is an achievable workshop project.
After the first powered workshop, the player can prepare the Explorer and pursue a lunar foothold while regional and deep Earth industry continue. The industrial bands describe capabilities. They are not ten mandatory, sequential crafting gates, and they are separate from rocket Tiers 1–3.
'
h+='
Band
Capability
First useful result
Relationship to the world
'
for r in reg['industrial_bands']:
h+='
'+idlink(r['id'])+' '+esc(r['title'])+'
'+esc(r['capability'])+'
'+esc(r['first_result'])+'
'+esc(r['exploration_relationship'])+'
'
h+='
'
groups=[('Make and shape','Repair benches, timber work, ceramics, seals, textile production, forming, alloys, and recognizable vehicle parts.'),('Separate and refine','Crushing, washing, concentration, electrical refining, controlled chemical processing, gases, fluids, and useful recovery streams.'),('Power and distribute','Mechanical sources, generators, storage, distribution, shutoff, protected service allocations, and later specialist energy systems.'),('Support a journey','Charging, breathing supplies, propellant, habitat service, survey instruments, mobile repairs, and launch and recovery.'),('Move and automate','Cargo, conveyors, ports, bounded excavation, local order handling, established freight routes, and visible stop conditions.'),('Choose advanced capability','Optional specialist processes, larger energy projects, precision systems, powered equipment, and surveyed transit. Each keeps a defined role and cost.')]
h+='
'+''.join(card(n,d,anchor('Machinery and industrial systems'),status=[('Documented in expansion','new'),('Detailed artwork — backlog','backlog')]) for n,d in groups)+'
'
h+='
66 machine and function entries. Each sits beneath the existing TEC installation families. The detailed catalogue covers inputs, outputs, interaction, unlock context, cost, and tradeoffs; the surrounding chapters define service states, ports, networks, balancing, recovery, and regional pause. '+link('Machinery and industrial systems','Open the complete machine catalogue →')+'
'
h+='
The inspiration is Immersive Engineering’s visible industrial construction and Mekanism’s breadth of connected processing and configurable systems. SUBSTELLAR’s implementation and balance proposals are its own. '+link('Industry and progression','Read the progression and reference basis →')+'
'
h+=''+sectionhead('06 / A humble beginning','Tier 1 is the whole expedition.','The Explorer, its machines and items, the launch site, the lunar foothold, and the return are one connected feature.')+plate('REF15','Confirmed reference: the complete Tier 1 system family, from rocket parts and support machines to launch, Moon exploration, and return. The same sheet is preserved at full source resolution in the images folder.')
h+='
'+card('Part Fabrication Table','Craft identified components from accessible Earth stock. Show input, working state, missing material, output, and safe interruption.',anchor('T1-M01'),ident='T1-M01 / REF10',imageid='REF10')+card('Rocket Assembly Station','Turn prepared components into one registered Explorer, commission it, and hand it to the launch site. “Rocket Assembly Table” remains a visible source alias.',anchor('T1-M02'),ident='T1-M02 / REF09 + REF15',imageid='REF09')+'
'
h+='
System
Role in the first complete journey
Full planning
'
rows=[('Fuel Refinery','Produce standard game propellant from defined, Earth-accessible inputs.','T1-M03'),('Fuel Pipe','Move propellant between compatible containers and a parked craft with explicit fill targets.','T1-M04'),('Oxygen Generator','Prepare breathing supplies for suit, cabin, and supported habitat services.','T1-M05'),('Launch Pad','Provide the registered staging, boarding, departure, and recovery location.','T1-M06'),('Control Console','Show route, readiness, cargo, services, reserves, and the next action.','T1-M07'),('Storage Crate','Keep workshop stock, mission cargo, samples, and reserved supplies distinct.','T1-M08'),('Rocket parts, engine, and tank','A small recognizable component family supports assembly, servicing, and refits.','T1-I01'),('Navigation Chip / Guidance Chip','Store and use supported route and mission information.','T1-I04'),('Launch Key','Make vehicle operation and ownership deliberate, with recovery if the key is lost.','T1-I05'),('Suit, helmet, and oxygen tank','Extend safe operation outside the cabin with legible reserves and serviceable equipment.','T1-E01'),('Explorer cabin and cargo','An inhabited first vehicle with compact seating, storage, access, and essential services.','T1-V01'),('Starter shelter and recovery','Earth-supplied survival, a lunar refuge, protected return allocations, and recoverable failure.','T1-S02')]
for n,d,k in rows:h+='
'+esc(n)+'
'+esc(d)+'
'+idlink(k)+'
'
h+='
'+card('The Explorer Rocket','An upright white-and-orange rocket with a stepped nose, dark cockpit window, visible hatch, fins, and dark engine cluster. One physical family covers first orbital and lunar capability.',anchor('T1-V01'),ident='CONFIRMED VEHICLE',imageid='REF11')+card('Player Space Suit','The matching practical suit, dark blue visor, reinforced gloves and boots, chest controls, and backpack establish the Tier 1 worn-equipment family.',anchor('T1-E01'),ident='CONFIRMED EQUIPMENT',imageid='REF12')+'
'
h+='
Model decisions remain visible. The supplied sheets show rocket heights of approximately 6, 9, and 12 blocks. A production pass must reconcile exterior, interior, collision, and clearance together. Example recipe grids, the sample cargo-slot count, and illustrative station dimensions are retained as references without silently becoming final balance values. '+link('T1-OV01','Read the source reconciliation →')+'
'
h+='
'+card('Tier 2 concept','The supplied Concept 2 / Earth Launch Site image establishes a later silhouette and launch-setting reference. Detailed systems and destination mapping remain for a later slice.',None,ident='REF06 / USER-SUPPLIED LATER TIER',status=[('Reference included','confirmed'),('Further design — backlog','backlog')],imageid='REF06')+card('Tier 3 concept','The supplied Concept 3 / Deep-Space Rocket shows a larger modular form. Its label is preserved; interstellar capability is not inferred from size alone.',None,ident='REF07 / USER-SUPPLIED LATER TIER',status=[('Reference included','confirmed'),('Further design — backlog','backlog')],imageid='REF07')+'
'
h+='
'+link('Tier 1 space systems — complete first expedition','Read all 30 Tier 1 planning sections')+' — every named core object, commissioning, first flight, lunar campaign, servicing, return, refits, balance, recovery, data states, and the first implementation slice.
'
h+=''+sectionhead('07 / A useful home','Settlements, materials, tools, and life.','The wider systems retain their complete writing and catalogues. These diagrams make the relationships easier to review.')+diagram('settlement-cycle')+diagram('resources-equipment')
h+='
'+card('World generation','Regional shape, geology, water, light, ecology, fair variation, reachable landmarks, transitions, and return routes.',anchor('World generation and the Earth atlas'))+card('Settlements and authored life','Old Valley’s five chapters, construction controllers, residents, cooperative contribution, regional activity, and free building.',anchor('Settlements and authored adventures'))+card('Resources and products','19 Earth resources, 10 processed product families, 18 planetary materials, ordinary Minecraft resources, and source-to-use relationships.',anchor('Materials and the crafting economy'))+card('Tools and preparation','32 equipment families, loadouts, traversal, light, survey, excavation, protection, samples, repairs, and rescue.',anchor('Tools equipment and preparation'))+card('Living systems','Earth creatures and plants, food, cultivation, fishing, encounters, lore, audio, and fictional offworld ecology.',anchor('Life ecology and encounters'))+card('Stations and support vehicles','Orbit Anchorage, Transfer Yards, shared modules, rover, crawler, submersible, and atmospheric survey skiff.',anchor('Spacecraft and orbital places'))+'
'
return h
def render_references():
h=''+sectionhead('08 / The confirmed visual record','All fifteen supplied references.','Every sheet is included unmodified in the folder. Names, purposes, scale notes, and variants are transcribed below each image.')
h+='
The recurring Tier 1 language is off-white and pale gray block forms, orange bands and service accents, dark machinery, blue glass or displays, clear hatches, and practical assembly. Source-sheet branding is preserved in the images; the project name remains SUBSTELLAR. Select an image to enlarge it.
'
h+='
'
for r in REFS['records']:
ident=r['id'];rid='ref-'+slug(ident)
title=r['title'].replace(' / ',' · ')
desc=' '.join(r['appearance_notes'])
h+=f'
'
SEARCH.append({'id':rid,'chapter':'Confirmed reference gallery','title':ident+' · '+title,'text':desc+' '+' '.join(r['object_labels'])+' '+' '.join(r['visible_text_transcription'])+' '+' '.join(p['source_text'] for p in r['purposes']),'source':'references'})
h+='
Confirmed appearance, explicit open decisions.
The sheets do not agree on final rocket scale; the assembly form and chip name have variants. Their example recipes and sample interface values are retained as evidence. The new Tier 1 chapter gives the working interpretation and the production decisions still to resolve. '+link('T1-OV01','Read the reconciliation')+'
'
return h
def render_backlog():
path=ROOT/'artwork_backlog.json'
if not path.exists():raise RuntimeError('Full artwork backlog must be present')
obj=json.loads(path.read_text());rows=obj['records']
current=json.loads((ROOT/'current_visual_coverage.json').read_text())
coverage={r['original_record_id']:r for r in current['records'] if r['original_register']=='artwork_backlog.json'}
families=sorted(set(r['family'] for r in rows))
h=''+sectionhead('09 / Visual coverage and further detail','Included views and the illustration backlog.','The ten-part overview is complete. The register below retains individual view requests, with current delivery status shown where a specific earlier request has now been supplied.')
h+='
Current status is reconciled with the earlier record. All twelve requested interface layouts are supplied on the four editable interface sheets. The two earlier opening-scene briefs are supplied as the Old Valley and first workshop concept boards. Matching rows show their current status, with the previous status retained as history. Other records keep their existing status; a family board does not complete all of its individual views.
'
delivered=list(dict.fromkeys(r['delivered_figure_id'] for r in current['records']))
h+=' · '.join(''+esc(ident)+'' for ident in delivered)
h+='
This register names the individual future views across realms, regional experiences, planets, materials, equipment, creatures, machines, interfaces, and construction. It records the writing status separately from the art status and links each task back to its planning context. Filter by a family, object, or stable ID.
'
for r in rows:
target=anchor(r.get('target_chapter',''))
art=r['art_status'];st='confirmed' if ('included' in art.lower() and 'backlog' not in art.lower()) else 'backlog'
ctx=r.get('overview_ref','') or ''
if isinstance(ctx,list):ctx=', '.join(ctx)
refs=r.get('source_refs',[]) or []
detail=r.get('detail','')
ctxparts=[]
for code in re.findall(r'REF\d\d|OV-[A-Z]+|EAR\d\d[_-]H',ctx+' '+' '.join(refs)):
if code in ART:
lid='ref-'+slug(code) if code.startswith('REF') else 'art-'+slug(code)
# Existing hero images are cards; link them to their full chapter context.
if code in ('EAR01_H','EAR03_H','EAR05_H'):lid=anchor({'EAR01_H':'Overworld','EAR03_H':'Deepwilds','EAR05_H':'Abyss'}[code])
ctxparts.append(''+esc(code)+'')
ranchor='task-'+slug(r['id'])
now=coverage.get(r['id'])
art_html=badge(art,st)
current_detail=''
if now:
art_html=badge(now['current_status'],'confirmed')+'Earlier status'+badge(art,st)+''
current_detail='
The full register is a production reference, not an instruction to generate everything now. Tier 2 and Tier 3 spacecraft keep their supplied overview art and deferred detail. Additional planetary campaigns are not created merely because a body appears on the atlas.
'
return h,obj
INSERTS={
'The creative foundation': 'Edition status. The 36 chapters below preserve the approved version 0.1 text verbatim, including its original review and image-production language. This overview edition records your subsequent text approval, includes the first illustration slice, and adds clearly identified new planning. The edition guide and new Tier 1 reconciliation express the current status.',
'The complete player journey': 'Progression clarification. The new industrial plan defines a practical early Tier 1 branch after a powered workshop. The long Earth adventure remains central and supports later capabilities; Core completion and Heartglass are not material gates for the first lunar round trip. See the industrial and Tier 1 expansions.',
'Core': 'Current Tier 1 relationship. This approved Core profile is preserved. The new confirmed Explorer direction uses attainable Earth materials. Core discoveries strengthen the wider Earth-to-stars journey and later capabilities, without becoming a mandatory material gate for the first lunar mission.',
'Spacecraft and orbital places': 'Confirmed Tier 1 reconciliation. The Explorer is the first physical spacecraft, combining Orbital and Lunar capability. The Keel and Pilgrim names and silhouettes below remain earlier proposed alternatives. The six capability classes still describe roles; they do not require six disposable vehicles. Detailed later-tier expansion and new art remain deferred.',
'Visual direction and the illustrated edition': 'Current image-production scope. This original comprehensive register is preserved. Only the current overview slice is included now. The separate artwork task register distinguishes existing concepts, your confirmed references, overview context, and dedicated views still in the backlog. It does not authorize generating the entire register at once.'
}
def render_chapters(chapters=None, source_band=True):
chapters=chapters if chapters is not None else [c for c in CHAPTERS if c['source'] not in NEW_KEYS]
h='
Complete writing / preserved in full
The approved creative and product direction
All 36 chapters and 28 tables follow in their original order. The preserved planning expansions follow the approved text. Edition notes link each source to its current topic without removing the earlier wording.
' if source_band else ''
last_source='approved' if source_band else chapters[0]['source'] if chapters else ''
for ci,c in enumerate(chapters):
if c['source']!=last_source:
last_source=c['source']
title={'industry':'Industrial progression and machinery','moon-mars':'Moon and Mars: complete destination planning','tier1':'Tier 1: the complete first space expedition','first-playable':'First Playable — Old Valley, the Quarry, and the First Workshop','tier1-models':'Tier 1 — Model and Implementation Specifications','illustrated':'Illustrated overview — ten reading guides',**{k:label for k,f,label in NEW_SOURCES}}[last_source]
if last_source=='illustrated':
h+='
Illustrated overview 03 / Ten reading guides
'+esc(title)+'
Representative images, precise diagrams, and source-linked comparisons explain the complete direction. All earlier writing and artwork remain available through the chapter links.
'
elif last_source not in NEW_KEYS:
h+='
Preserved planning expansion
'+esc(title)+'
The detailed writing is retained in full. The supplied Tier 1 artwork is confirmed; proposed operational choices and numerical tuning remain identified for review.
'
status=badge('Approved text','confirmed') if c['source']=='approved' else badge('Current synthesis · proposals labelled','overview') if c['source']=='current-direction' else badge('Edition 05 planning · working defaults','new') if c['source'] in NEW_KEYS else badge('Illustrated reading guide','overview') if c['source']=='illustrated' else badge('Expansion for review','new')
number=('Chapter '+str(c['index']).zfill(2)) if c['source']=='approved' else c['label']+' '+str(c['index']).zfill(2)
h+=''
inbody=False;listkind=None;illustrated_slice=None;illustrated_inserted=False;current_heading=c['title'];current_inserted=False
for entry in c['blocks']:
b=entry['block'];kind=b[0];bid=entry['id'];aid=entry['anchor']
attrs=' class="source-block" data-source="'+c['source']+'" data-block="'+bid+'"'
if kind not in ('bullet','number') and listkind:
h+='';listkind=None
if kind=='heading' and b[1]==1:
# Chapter section owns the stable anchor; heading still has the exact source block ID.
h+=''+esc(number)+''+inline(b[2])+'
'+status+'
'
if c['title'] in INSERTS:
h+=''
if c['title'] in ('Moon','Mars'):
h+=''
if COMPANION:h+=COMPANION.chapter_note(c['title'])
if CURRENT and c['source'] not in NEW_KEYS:h+=CURRENT.original_chapter_note(c)
h+='
';inbody=True
elif kind=='heading':
current_heading=b[2];current_inserted=False
lev=min(5,b[1]+1);h+=''+inline(b[2])+'#'
if c['source']=='illustrated' and b[1]==2:
match=re.match(r'ILL-S(\d+)',b[2]);illustrated_slice=int(match[1]) if match else None;illustrated_inserted=False
elif kind=='table':
rows=b[1];cols=max(len(r) for r in rows)
h+='
'
h+=''.join('
'+inline(v)+'
' for v in rows[0])+'
'
for row in rows[1:]:h+='
'+''.join('
'+inline(v)+'
' for v in row)+'
'
h+='
'
elif kind in ('bullet','number'):
needed='ul' if kind=='bullet' else 'ol'
if listkind!=needed:
if listkind:h+=''
h+='<'+needed+'>';listkind=needed
h+=''+inline(b[1])+''
else:
h+=''+inline(b[1])+''
if c['source']=='illustrated' and illustrated_slice and not illustrated_inserted and COMPANION:
h+=COMPANION.slice_insert(illustrated_slice);illustrated_inserted=True
if CURRENT and c['source'] in NEW_KEYS and not current_inserted:
h+=CURRENT.after_paragraph(c['source'],current_heading);current_inserted=True
if listkind:h+=''
if inbody:h+='
'
h+='Your review notes
Notes stay in this browser. Export them to keep a portable copy.
'
prev=chapters[ci-1] if ci else None;nxt=chapters[ci+1] if ci+1← '+esc(prev['title'])+'' if prev else '')+(''+esc(nxt['title'])+' →' if nxt else 'Return to overview ↑')+''
return h
def render_reader_navigation():
return ''''''
def render_sidebar():
prime=[('overview','Edition overview'),('illustrated-overview','Start here: illustrated guide'),('illustrated-coverage','Ten-slice coverage'),('chapter-directory','Chapter reading directory'),('visual-directory','Illustrations & diagrams'),('world-atlas','Solar System & destinations'),('earth-overview','Earth: seven realms'),('moon-overview','Moon: surface & layers'),('mars-overview','Mars: surface & layers'),('progression-overview','Progression & machinery'),('tier1-overview','Tier 1 systems'),('systems-overview','Settlements & living systems'),('reference-gallery','Confirmed reference gallery'),('artwork-backlog','Artwork backlog')]
if CURRENT:prime=prime[:1]+CURRENT.nav()+prime[1:]
h=''
def render_sources():
# Cover and navigation copy are retained as historical source front matter, in addition to every body block.
historical=['SUBSTELLAR','Creative and Product Direction','Text edition for creative review','Version 0.1 6 October 2026','A complete reference for the intended worlds, experiences, settlements, progression, equipment, spacecraft, and illustrated edition.','The journey begins with a familiar home and continues through the Earth below it, the Solar System, and the proposed worlds of Afterlight.','Text confirmation is the next creative checkpoint. The full image register is included for the subsequent illustrated edition.','Contents','Each entry links to its chapter. Word navigation also exposes the detailed headings, named environments, materials, and image references.']
h=''+sectionhead('Edition record','Text, references, and reusable sources.','The folder contains the full reading edition, every supplied image, the new overview boards, editable diagrams, and ordinary source files.')
h+='
Source and decision order. Your latest directions and confirmed artwork govern Tier 1 appearance and the current slice. The complete approved text is retained. The new expansions connect that source to the requested broader machinery and destination planning. Generated boards are concept references; unresolved numerical design remains explicit.
'
h+='
File
Purpose
'
entries=[('complete-direction.txt','The approved text and all planning expansions in one plain-text file.'),('complete_text_for_typesetting.txt','Exact approved body source, preserved without edits.'),('industry_progression_expansion.txt','The complete industrial progression and machine expansion.'),('moon_mars_expansion.txt','The complete Moon and Mars expansion.'),('tier1_space_expansion.txt','All Tier 1 operational planning.'),('first_playable_expansion.txt','The complete opening experience, first workshop, generation, controller, and build plan.'),('tier1_model_specifications.txt','Proposed Tier 1 dimensions, components, ports, assembly, animation, states, and implementation criteria.'),('first_playable_register.json','Structured first-playable tasks, resource accounting, dependencies, and acceptance.'),('tier1_model_register.json','Structured Tier 1 assets, geometry, connections, decisions, and implementation tasks.'),('next_image_slice.json','Historical planning-edition-02 briefs; their completed concept boards appear in the current visual catalogue.'),('project_inspection.json','Available-workspace inspection and explicit unverified implementation baseline.'),('edition_02_change_record.json','Scope, preservation, and approval status for planning slice 02.'),('overview-edition-01-manifest.json','The previous edition record retained for comparison.'),('reference_catalogue.json','Every supplied reference with its labels, purposes, notes, and source checksum.'),('industry_progression_register.json','Machine/function entries and industrial capability bands.'),('artwork_backlog.json','The original commissioning register, preserved with its historical status.'),('current_visual_coverage.json','Current delivery mappings for twelve interface layouts and both opening concept briefs.'),('overview_prompts.json','The overview art prompts and bounded production scope.'),('edition-manifest.json','Content counts, source checksums, included art, and edition metadata.'),('SUBSTELLAR_Creative_and_Product_Direction_v0.1.docx','The original approved document, including its cover, contents, and page references.')]
entries += [('illustrated_companion.txt','The ten illustrated reading guides as complete plain text.'),('illustrated_editorial.json','Chapter summaries, slice relationships, realm and destination comparisons.'),('illustrated_visual_catalogue.json','Every retained and new visual with its caption, kind and context.'),('illustrated_coverage.json','Actual overview coverage of all ten document slices and dedicated views remaining.'),('illustrated_03_scope_data.json','Exact destination regions, material pairs, projects, and eleven planetary ecology families.'),('illustrated_03_boards.json','The eight new concept briefs, outputs, captions and individual coverage notes.'),('illustrated_03_diagrams.json','The eight new editable diagrams and their source mappings.'),('illustrated_03_interfaces.json','All twelve interface references grouped into four precise sheets.'),('planning-edition-02-manifest.json','The complete prior edition record, retained unchanged.')]
if CURRENT:
entries += [(name,desc) for name,desc in CURRENT.data['source_descriptions'].items()]
for name,desc in entries:h+='
The original table of contents and page numbers remain in the included DOCX. HTML navigation links to the same 36 chapters.
'
h+='
Documented does not mean implemented. The complete direction supports future roadmap decisions; feature implementation, numerical balance, final model dimensions, and detailed artwork proceed in explicit slices. The source record chapter retains the original project provenance. The industrial expansion links its external inspiration references directly.
'
return h
def create_assets():
OUT.mkdir(exist_ok=True)
for d in ('images','images/originals','images/diagrams','sources'):(OUT/d).mkdir(exist_ok=True)
asset_jobs=[]
for ident,record in ART.items():
path=Path(record['source']);path=path if path.is_absolute() else ROOT/path
if not path.exists():raise RuntimeError('Missing image '+str(path))
copy_file(path,OUT/originalpath(ident))
asset_jobs.append({'source':str(path),'output':str(OUT/artpath(ident))})
(ROOT/'web_image_jobs.json').write_text(json.dumps(asset_jobs))
for rec in DIAGRAMS:copy_file(DIAGRAM_ROOT/rec['file'],OUT/'images/diagrams'/rec['file'])
copy_file(DIAGRAM_META,OUT/'sources/overview-diagrams.json')
for key,filename,label in SOURCES:copy_file(ROOT/filename,OUT/'sources'/filename)
for filename in ('industry_progression_register.json','artwork_backlog.json','overview_prompts.json','overview_generated_assets.json','tier1_reference_findings.txt','SUBSTELLAR_Creative_and_Product_Direction_v0.1.docx','first_playable_register.json','tier1_model_register.json','next_image_slice.json','project_inspection.json','edition_02_change_record.json','overview-edition-01-manifest.json','current_visual_coverage.json'):
copy_file(ROOT/filename,OUT/'sources'/filename)
refs=json.loads(json.dumps(REFS))
refs['inspection_method']='All 15 supplied PNGs were visually inspected. Original files are preserved; web display copies retain dimensions and transparency.'
for r in refs['records']:r['file_path']='../'+originalpath(r['id'])
(OUT/'sources/reference_catalogue.json').write_text(json.dumps(refs,ensure_ascii=False,indent=2))
reg=json.loads((OUT/'sources/industry_progression_register.json').read_text());reg['source_document']='industry_progression_expansion.txt'
(OUT/'sources/industry_progression_register.json').write_text(json.dumps(reg,ensure_ascii=False,indent=2))
complete='SUBSTELLAR — Creative and Product Direction\nCurrent direction and worked journeys 05\n\nAll 90,735 earlier source words remain preserved in their seven original sources. Four new sources supply the current-direction synthesis, worked progression, occupied-place visual review, and complete first lunar expedition. The source map links the current topics to all 45 baseline chapters. Confirmed supplied Tier 1 artwork governs appearance. Numerical examples, tuning and final model dimensions remain proposals where stated.\n\n'
for key,filename,label in SOURCES:complete+='\n\n'+('='*60)+'\n'+label.upper()+'\n'+('='*60)+'\n\n'+(ROOT/filename).read_text()
(OUT/'sources/complete-direction.txt').write_text(complete)
manifest={'title':'SUBSTELLAR Creative and Product Direction','edition':'Illustrated overview 03','date':'2026-10-06','date_timezone':'America/Edmonton','previous_edition':'Planning edition 02','prior_source_words_preserved':88193,'planning_slice_02':{'new_images_generated':0,'new_generation_calls':0,'new_art_briefs':2,'mod_development_authorized':False,'implementation_status':'Unverified: actual mod project not available in the inspected workspace.'},'original_text_approved':True,'new_planning_status':'Expansion for review','source_content':[],'references':15,'diagrams':7,'new_overview_boards':5,'new_generation_call_cap':6,'new_generation_calls_used':6,'overview_edition_01_generation_record':{'boards':5,'call_cap':6,'calls_used':6,'historical':True},'image_records':[],'site':'index.html','notes':['All original body paragraphs, headings, lists and table cells are retained in order.','Original cover, table of contents and page references remain in the included DOCX; cover wording is also visible in the HTML source record.','Confirmed artwork and original supplied PNG bytes are preserved.','Web display copies retain source dimensions and alpha.','Exact recipes, model dimensions and performance are not inferred from illustrative reference grids.','Legacy new_overview_boards and new_generation_call fields describe Overview edition 01; planning_slice_02 records zero new generation.']}
for key,filename,label in SOURCES:
b=SOURCE_BLOCKS[key];p=ROOT/filename
manifest['source_content'].append({'key':key,'file':filename,'words':words(p.read_text()),'blocks':len(b),'chapters':sum(x[0]=='heading' and x[1]==1 for x in b),'tables':sum(x[0]=='table' for x in b),'sha256':hashlib.sha256(p.read_bytes()).hexdigest()})
for ident,r in ART.items():
p=OUT/originalpath(ident);manifest['image_records'].append({'id':ident,'title':r['name'],'status':r['kind'],'original':originalpath(ident),'web':artpath(ident),'sha256_original':hashlib.sha256(p.read_bytes()).hexdigest()})
manifest['total_source_words']=sum(x['words'] for x in manifest['source_content'])
manifest['total_chapters']=len(CHAPTERS)
(OUT/'sources/edition-manifest.json').write_text(json.dumps(manifest,ensure_ascii=False,indent=2))
(ROOT/'html_build_manifest.json').write_text(json.dumps(manifest,ensure_ascii=False,indent=2))
return manifest
def build():
global PLANNING_HTML,COMPANION,CURRENT
COMPANION=IllustratedCompanion(ROOT,OUT,esc,inline,badge,anchor,SEARCH,ART,DIAGRAMS)
CURRENT=CurrentDirectionEdition(ROOT,OUT,CHAPTERS,esc,inline,badge,anchor,SEARCH)
manifest=create_assets()
COMPANION.copy_extra_assets()
visual_catalogue,illustrated_coverage=COMPANION.write_records()
CURRENT.copy_assets_and_sources()
visual_catalogue=json.loads(json.dumps(visual_catalogue))
visual_catalogue['edition']='Current direction and worked journeys 05'
visual_catalogue['records']+=CURRENT.catalogue_records()
visual_catalogue['unique_raster_concepts_and_references']+=3
visual_catalogue['editable_figures']+=6
COMPANION._catalogue=visual_catalogue['records']
(OUT/'sources/visual_catalogue_05.json').write_text(json.dumps(visual_catalogue,ensure_ascii=False,indent=2))
manifest['illustrated_overview_03']={'document_slices':illustrated_coverage['slices'],'new_concept_board_cap':8,'new_concept_boards':len(COMPANION.boards),'new_editable_figures':len(COMPANION.diagrams)+len(COMPANION.interfaces),'interface_views':12,'prior_source_words_preserved':88193,'scope':'Balanced illustrated document website'}
generation_record=json.loads((ROOT/'illustrated_03_boards.json').read_text())['summary']
manifest['illustrated_overview_03']['generation_calls']=generation_record['generation_calls']
manifest['illustrated_overview_03']['rerolls']=generation_record['revisions']
manifest['new_overview_boards']=len(COMPANION.boards)
manifest['new_generation_call_cap']=8
manifest['new_generation_calls_used']=generation_record['generation_calls']
manifest['notes'][-1]='Current new_overview_boards and new_generation_call fields describe Illustrated overview 03. The original generation counts are preserved in overview_edition_01_generation_record and both earlier edition manifests.'
manifest['diagrams']=len(DIAGRAMS)+len(COMPANION.diagrams)+len(COMPANION.interfaces)
manifest['raster_visuals']=len(ART)
manifest['current_visual_coverage']={'file':'current_visual_coverage.json','interface_layouts_now_included':12,'opening_boards_now_included':2,'original_register_preserved':True}
manifest['reader_navigation_revision']={'revision':'04','date':'2026-10-07','features':['Fixed current-reading bar','Chapter and subsection tracking','Contents follow toggle and current-location reveal','Section selector and previous/next navigation','Copy current section link','Within-chapter progress'],'new_image_generation':0,'source_text_unchanged':True}
CURRENT.add_manifest(manifest)
for target in (OUT/'sources/edition-manifest.json',ROOT/'html_build_manifest.json'):target.write_text(json.dumps(manifest,ensure_ascii=False,indent=2))
PLANNING_HTML,planning_data=render_planning(ROOT,esc,inline,badge,sectionhead,anchor,SEARCH)
overview=render_overview()+render_progression()+render_references()
backlog,backlogdata=render_backlog()
body=overview+backlog+render_chapters()+render_sources()
CURRENT.verify_rendered()
css=(ROOT/'substellar_style.css').read_text();js=(ROOT/'substellar_app.js').read_text()+'\n'+(ROOT/'substellar_reader_navigation.js').read_text()
searchdata=json.dumps(SEARCH,ensure_ascii=False,separators=(',',':')).replace('SUBSTELLAR — Creative & Product DirectionSkip to the complete textSUBSTELLARCreative & product direction
'''
(OUT/'index.html').write_text(doc)
# Rebuild material is ordinary local source; no repository or hosted service is required.
for f in ('build_substellar_html.py','parse_substellar_blocks.py','substellar_style.css','substellar_app.js','substellar_reader_navigation.js','test_reader_navigation.js','planning_hub.py','illustrated_companion.py','edition05_companion.py'):
if (ROOT/f).exists():copy_file(ROOT/f,OUT/'sources'/f)
(OUT/'README.txt').write_text((ROOT/'README_05.txt').read_text())
copy_file(ROOT/'README_05.txt',OUT/'sources/README_05.txt')
print(json.dumps({'html':str(OUT/'index.html'),'characters':len(doc),'search_passages':len(SEARCH),'chapters':len(CHAPTERS),'words':manifest['total_source_words'],'backlog_tasks':len(backlogdata['records']),'assets':manifest['raster_visuals'],'distinct_visuals':manifest['total_distinct_visuals']},indent=2))
if __name__=='__main__':build()