diff --git a/MANIFEST.sha256 b/MANIFEST.sha256
index 99680b6..d56a682 100644
--- a/MANIFEST.sha256
+++ b/MANIFEST.sha256
@@ -20,7 +20,7 @@ b45d388c901b6a0397d644ddf85c88a71bbdfd8ed91e2c1fbb5e2e26287afa9e  docs/superpowe
 b512e17d600965bac02492f9e0dbbd30b0e68771c1c3ebdda0992a4c498453b4  functions/_lib/http.js
 b04ee5d5fd478ac6b37de485dae8f826fdd854706a5d2d5323114614ef617773  functions/_lib/identity.js
 bf407a093caf22903d96c3eaa4ed7dbe5fcebdb16273527efa552681cf27d4ff  functions/api/auth/[[path]].js
-0a65c39e81d3662dddf3aeee1d98ba77df573664d3d402eef5dcc1d8c164e1d6  functions/api/v2/[[path]].js
+5eafb513d50a902f785940fd601076daf60ca0eee21c1306b21807b90c431f8a  functions/api/v2/[[path]].js
 0f1859c6cc1c232919c4e79372b169d1beef3900181e553c188de63d0d1f1f50  migrations/0001_identity.sql
 7a2e3055d95dfc251ffad07f0f2b9bf9f90ace5092654fb8fa92fa261d56a29c  scripts/build_sovereign_genesis.mjs
 2b2bf8698b2951203307e384e441e43645b345ff5dd84b32d1183d8121473db5  scripts/patch_current_v2.mjs
@@ -33,15 +33,15 @@ efd1af2bcdd0939bda2432e6823f09135f6d8345796e8a6f9690886b0b104b05  site/assets/wo
 27eaa1da60c9ae26c54512c6b986e2d568f5ec9a968d6a46d3d785f9117e5e4e  site/cinematic-world.css
 6c2c82fb1de7d8a0051edaa1e5f5711fc8881865ad8638fa0c41a709dce54696  site/data/sovereign-genesis.json
 0670d7be3b270c8e627c5f0089e25ba065c3326f6bcf0f06ce9ae5cf3c5cf64b  site/icon.svg
-37edda29fd3d7dc28535024733ec4e770cf16b8e2e8dc1ceeda73d1c1bc154b2  site/index.html
+f7f882e7c491d86e5bc54c57033192b52cd28da593a70175564f612a187d3a06  site/index.html
 a31f15ff86c87f9eafb1723fb3fc59186f27fb32a75b00d287fc7efbdeec5b1c  site/medieval-art.js
 49897b8d946b85c84a4e0f177a3c7773a0c6f9acfef0025d308ccec2ac3a7ef1  site/medieval-world.css
 82197a81454575b5c941ec0c52924c0a53f1d92bf70371e9c16df0912a29dcf0  site/observer-connection.js
-f57bf13a527ada7c6c792760f6ab976412df64a4a125f305be7e86dda6a32cbf  site/pixi-observer.js
+3deafe2d73b4c47ac240cc5ab9b335d89b005f98f43f704e27b6b59f218a2e24  site/pixi-observer.js
 5edab258856c44d89ea1df51472037697db95909c2d696607ef7c30a503a4838  site/preview.png
-772ee873b012f6ddf0f36b79c8c95b737c1a45b4362f0b997afcb7a68b77b233  site/sovereign-renderer.js
-59d83fee261298ef4c90a650ab3b350d4533ab61e7ad3f315e45cdd83443de74  site/sovereign-world.css
-d639481c2258cfabfaa97bead83e2009cffa3a5535fca4c8c14729dade54fce4  site/sovereign-world.js
+5dcf19ad709016f22bf7d1f2e099b94c34a41861c14aa1c9fb6a7d6ef27fab11  site/sovereign-renderer.js
+9d1a63c705106bb23e92accd232f509cba550ba47dcab1d1d13681351f457e30  site/sovereign-world.css
+ca3d652f16c7b2ebd4781d0db1640f51089f738a905285a0bc6df229e41a4b9a  site/sovereign-world.js
 aaa5a63cab5926e0355e8257bd562ec2db4c8890904ef1894767063925ceadf1  site/terrain-model.js
 c98fca62534d141f285a6c92bfd6257c26d462a3daff72672a4d76f2399d1f21  site/transient-physics.js
 d179b80fb34aae0db437dfa72c1a6e6704209a8119b8d991ad49321d8584da8f  tests/browser-art.mjs
@@ -84,7 +84,7 @@ f6c7f2623eeeeea2faebe84c30e135c6357403b3c44aee379dc5f8058064ecac  tests/test_sov
 3addb20df209d6f6ad84ff37adaa7dd67bf2c10adfc4c372559bc32543311415  tests/test_sovereign_shelter_environment.mjs
 218e8e718765fa3e19aead2359ab5cec36778c6fda596176d8b016a38843da00  tests/test_sovereign_society.mjs
 5357326e16f8493d08ecc0a56bae1a48773c1f2e979f830f99181054e144ce7a  tests/test_sovereign_transient_physics_upgrade.mjs
-f19d6c322cd8b17bd8f65560e4602d523899f8546d70dd40a783cc8a285ab0a7  worker/src/index.js
+0fb98d54388b831fdf91bf0ac02de518e1c0b65b176e8f305801e816bd858fff  worker/src/index.js
 2eac2b46fb9337eb62b4b716be26eb11f92359c58e6c6685039f3506346a09fb  world/actions.js
 79cdf84d53e19cb1500f2a782aad657d49281005c7809e06bfcf190f7411f294  world/artifacts.js
 251ef01a7616cef68bba68b1bc81ac62d30b0bd1685a8beb9784c4ba55fa469b  world/beliefs.js
@@ -122,3 +122,4 @@ dab555575cd5a79e1e1be63a155033788d40995f6b5c69b3b82fe87132233009  site/spine-cit
 4fd200df9a9fc14a16eb12445665f4dfd58777fdba8426da4f00ca99b21d8fbe  docs/SPINE_OBSERVER_INTEGRATION.md
 164c56738f05469e36d0cb3c913656154381bda6a177505d5d2f06d87d1665ad  tests/test_sovereign_observer_readability_upgrade.mjs
 98d88f126a1bca9443485b2cbc2f4614dbc975f9f96d0dfb72ed37465e2c3e56  tests/test_sovereign_citizen_animation_upgrade.mjs
+f0d644436e621ebd5b6e28cb8af3673b6884fbb487725e5816ef1dc08291d7b8  tests/test_sovereign_avatar_observer_upgrade.mjs
diff --git a/functions/api/v2/[[path]].js b/functions/api/v2/[[path]].js
index 08761ef..b04aabc 100644
--- a/functions/api/v2/[[path]].js
+++ b/functions/api/v2/[[path]].js
@@ -18,7 +18,26 @@ export async function onRequest({request,env}){
     if(request.method==='GET'&&p.startsWith('/why/'))return proxy(request,env);
     if(request.method==='GET'&&p==='/stream')return proxy(request,env);
     if(request.method==='POST'&&p==='/avatar'){
-      await readJson(request).catch(()=>({}));const actor=await requireActor(request,env);return proxy(request,env,{body:{actor},path:'/avatar'});
+      await readJson(request).catch(()=>({}));
+      const actor=await requireActor(request,env);
+      const ensured=await proxy(request,env,{body:{actor},path:'/avatar'});
+      const avatar=await ensured.json();
+
+      if(!avatar.ok)return json(avatar,ensured.status);
+
+      return json({
+        ok:true,
+        authenticated:true,
+        actor:{
+          displayName:actor.display_name||actor.github_login||null,
+          githubLogin:actor.github_login||null,
+          avatarUrl:actor.avatar_url||null
+        },
+        avatar:{
+          citizenId:avatar.citizenId,
+          created:Boolean(avatar.created)
+        }
+      });
     }
     if(request.method==='POST'&&p==='/intent'){
       const actor=await requireActor(request,env);const body=await readJson(request);const avatar=await proxy(new Request(request.url,{method:'POST'}),env,{body:{actor},path:'/avatar'});const av=await avatar.json();if(!av.ok)return json(av,avatar.status);return proxy(request,env,{body:{citizenId:av.citizenId,intent:body.intent},path:'/intent'});
diff --git a/site/index.html b/site/index.html
index 4a98e26..3d6ee65 100644
--- a/site/index.html
+++ b/site/index.html
@@ -50,7 +50,7 @@
       <button id="overlayKnowledge"><span><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M3 5q5-3 9 0 4-3 9 0v15q-5-3-9 0-4-3-9 0zM12 5v15"/></svg></span><b>Knowledge</b></button>
       <button id="overlayRelations"><span><svg viewBox="0 0 24 24" aria-hidden="true"><circle cx="5" cy="12" r="3"/><circle cx="19" cy="5" r="3"/><circle cx="19" cy="19" r="3"/><path d="m8 11 8-5M8 13l8 5"/></svg></span><b>Relations</b></button>
       <button id="fullscreenWorld"><span><svg viewBox="0 0 24 24" aria-hidden="true"><path d="M8 3H3v5M16 3h5v5M3 16v5h5M21 16v5h-5"/></svg></span><b>Fullscreen</b></button>
-      <button id="agentOpen"><span><svg viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="7" r="4"/><path d="M4 22v-3a8 8 0 0 1 16 0v3"/></svg></span><b>My Avatar</b></button>
+      <button id="agentOpen"><span><svg viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="7" r="4"/><path d="M4 22v-3a8 8 0 0 1 16 0v3"/></svg></span><b>My Avatar</b><small id="myAvatarStatus">SIGN IN</small></button>
     </nav>
 
     <section id="societyHistory" class="game-window parchment-panel history-window" hidden aria-label="Society History">
@@ -61,7 +61,34 @@
 
     <section id="agentWindow" class="game-window parchment-panel agent-window" hidden aria-label="Personal Agent">
       <header><div><span>HUMAN-LINKED CITIZEN</span><h2>Your direction, their world.</h2><p>Your intent may influence your avatar. It grants no knowledge or privilege.</p></div><button class="panel-close" id="agentClose" aria-label="Close agent">×</button></header>
-      <div class="agent-copy"><p>Your avatar is subject to the same biology, scarcity, physical terrain, social consequences and mortality as every other Citizen.</p><textarea id="humanIntent" rows="5" placeholder="Example: avoid violence, learn their language, build trust, and seek a sustainable way to improve transport."></textarea><button id="sendIntent" class="primary">Send direction to my avatar</button><a id="loginLink" href="/api/auth/github?return_to=%2F">Enter the world with GitHub</a><p id="agentFeedback" role="status"></p></div>
+      <div class="agent-copy">
+        <div id="avatarGuest">
+          <p>Sign in to embody one persistent Citizen inside CYMONIA. Your Citizen receives no Earth knowledge or privilege.</p>
+          <a id="loginLink" class="avatar-login" href="/api/auth/github?return_to=%2F">Enter the world with GitHub</a>
+        </div>
+        <div id="avatarDashboard" hidden>
+          <div class="avatar-identity">
+            <img id="avatarIdentityImage" alt="" hidden>
+            <div><span class="eyebrow">YOUR CITIZEN</span><h3 id="avatarIdentityName">—</h3><small id="avatarIdentityStatus">—</small></div>
+          </div>
+          <div class="avatar-actions">
+            <button id="avatarLocate">Locate</button>
+            <button id="avatarFollow">Follow</button>
+            <button id="avatarInspect">Inspect</button>
+          </div>
+          <div id="avatarStats" class="avatar-stats"></div>
+          <div class="avatar-section"><h3>Current life</h3><div id="avatarNow"></div></div>
+          <div class="avatar-section"><h3>Evolution</h3><div id="avatarEvolution"></div></div>
+          <div class="avatar-section"><h3>Recent life</h3><div id="avatarTimeline" class="avatar-timeline"></div></div>
+          <div class="avatar-section avatar-direction">
+            <h3>Direction</h3>
+            <p>Your intent is a preference. Your Citizen can interpret it, fail, refuse through circumstances, or die.</p>
+            <textarea id="humanIntent" rows="4" placeholder="Example: avoid violence, learn their language, build trust, and seek a sustainable way to improve transport."></textarea>
+            <button id="sendIntent" class="primary">Send direction to my avatar</button>
+            <p id="agentFeedback" role="status"></p>
+          </div>
+        </div>
+      </div>
     </section>
 
     <div id="toastLayer" class="toast-layer" aria-live="polite"></div>
diff --git a/site/pixi-observer.js b/site/pixi-observer.js
index e7d4e27..8bf5ac5 100644
--- a/site/pixi-observer.js
+++ b/site/pixi-observer.js
@@ -16,7 +16,7 @@ export class PixiObserverLayer{
   constructor(canvasFallback,art){
     this.canvasFallback=canvasFallback;this.art=art;this.app=null;this.ready=false;this.failed=false;this.state=null;this.staticKey='';this.hits=[];this.citizenSprites=new Map();this.frames=[];this.groundSource=null;this.staticEntries=[];
     // Logical object layers share a depth-sorted container, so trees can occlude people correctly.
-    this.vegetationLayer=[];this.resourceLayer=[];this.structureLayer=[];this.citizenLayer=null;this.spineAdapter=null;
+    this.vegetationLayer=[];this.resourceLayer=[];this.structureLayer=[];this.citizenLayer=null;this.spineAdapter=null;this.ownedCitizenId=null;
     this.init();
   }
   async init(){
@@ -40,6 +40,7 @@ export class PixiObserverLayer{
     }catch(error){console.warn('Pixi observer unavailable; Canvas fallback remains active.',error);this.app?.destroy(true,{children:true});this.app=null;this.failed=true;}
   }
   setState(state){this.state=state;}
+  setOwnedCitizen(id){this.ownedCitizenId=id||null;}
   staticSignature(state){return `${staticSceneKey(state)}|${this.art.revision}`;}
   clearLayer(layer){for(const child of layer.removeChildren())child.destroy({children:true});}
   sprite(frame,size){const s=new globalThis.PIXI.Sprite(this.frames[frame]);s.anchor.set(.5,.94);s.scale.set(size/s.texture.width);return s;}
@@ -74,6 +75,9 @@ export class PixiObserverLayer{
         task.anchor.set(.5);task.position.set(0,-41);container.addChild(shadow,body,task);
         entry={container,body,task,shadow,baseScale:Math.abs(body.scale.x),spine:false};
       }
+      const ownedRing=new PIXI.Graphics();ownedRing.ellipse(0,1,11,5).stroke({width:1.5,color:0x8fd7ff,alpha:.95});ownedRing.visible=false;
+      const ownerMark=new PIXI.Text({text:'YOU',style:{fontFamily:'system-ui',fontSize:8,fontWeight:'700',fill:0xbfe8ff,stroke:{color:0x17251f,width:2}}});ownerMark.anchor.set(.5);ownerMark.position.set(0,-49);ownerMark.visible=false;
+      entry.container.addChildAt(ownedRing,0);entry.container.addChild(ownerMark);entry.ownedRing=ownedRing;entry.ownerMark=ownerMark;
       this.citizenLayer.addChild(entry.container);this.citizenSprites.set(c.id,entry);
     }
     for(const [id,e] of this.citizenSprites)if(!alive.has(id)){e.container.destroy({children:true});this.citizenSprites.delete(id);}
@@ -97,6 +101,7 @@ export class PixiObserverLayer{
         e.body.scale.set((flip?-1:1)*e.baseScale*pose.scaleX,e.baseScale*pose.scaleY);
         if(e.shadow)e.shadow.scale.x=pose.shadowScale;
       }
+      const owned=c.id===this.ownedCitizenId;if(e.ownedRing)e.ownedRing.visible=owned;if(e.ownerMark)e.ownerMark.visible=owned;
       e.task.text=a&&(active||camera.zoom>2)?ACTION_ICON[a.type]||'·':'';
       const sp=this.screenPoint(pos.x,pos.y,t.elevation,camera);hits.push({...this.art.hitRecord({id:c.id,kind:'citizen',frame:citizenFrame(c),size:19},{x:sp.x,y:sp.y+e.body.y*camera.zoom},camera.zoom,e.body.scale.x<0),depth:p.y});
     }
diff --git a/site/sovereign-renderer.js b/site/sovereign-renderer.js
index 9e56c7b..0dd2bf3 100644
--- a/site/sovereign-renderer.js
+++ b/site/sovereign-renderer.js
@@ -26,13 +26,23 @@ function dayLight(minute){const phase=((minute%1440)+1440)%1440/1440,sun=Math.si
 
 export class SovereignRenderer{
   constructor(canvas,mini){
-    this.canvas=canvas;this.canvasFallback=canvas;this.gpuCanvas=null;this.art=new MedievalArt();this.gpu=new PixiObserverLayer(this.canvasFallback,this.art);this.artEntries=[];this.artKey='';this.mini=mini;this.state=null;this.selected=null;this.follow=null;this.overlay=null;this.hits=[];this.drag=null;this.lastFrame=performance.now?.()||0;
+    this.canvas=canvas;this.canvasFallback=canvas;this.gpuCanvas=null;this.art=new MedievalArt();this.gpu=new PixiObserverLayer(this.canvasFallback,this.art);this.artEntries=[];this.artKey='';this.mini=mini;this.state=null;this.selected=null;this.follow=null;this.ownedCitizen=null;this.overlay=null;this.hits=[];this.drag=null;this.lastFrame=performance.now?.()||0;
     this.camera={x:50,y:50,zoom:1.55,targetX:50,targetY:50,targetZoom:1.55,width:1000,height:700};
     this.terrainCache=null;this.terrainCacheKey='';this.wire();
   }
   setState(state){const oldId=this.state?.worldId;this.state=state;this.gpu?.setState(state);this.gpuCanvas=this.gpu?.app?.canvas||null;if(state?.worldId!==oldId){this.terrainCache=null;this.terrainCacheKey='';}}
   setSelected(id){this.selected=id;}
   setFollow(id){this.follow=id||null;}
+  setOwnedCitizen(id){this.ownedCitizen=id||null;this.gpu?.setOwnedCitizen?.(this.ownedCitizen);}
+  locateCitizen(id,{follow=false}={}){
+    const c=this.state?.citizens?.find(x=>x.id===id);
+    if(!c||!c.alive)return false;
+    const pos=citizenPosition(c,this.state,Date.now());
+    this.camera.targetX=clamp(pos.x,2,98);this.camera.targetY=clamp(pos.y,2,98);
+    this.camera.targetZoom=Math.max(this.camera.targetZoom,1.8);
+    this.follow=follow?id:null;
+    return true;
+  }
   center(){this.camera.targetX=50;this.camera.targetY=50;this.camera.targetZoom=1.55;this.follow=null;}
   fitPopulation(){
     const alive=(this.state?.citizens||[]).filter(c=>c.alive);
@@ -115,9 +125,9 @@ export class SovereignRenderer{
   drawShelter(ctx,e,p,light){const s=clamp(this.camera.zoom,.7,2.1);this.drawShadow(ctx,p,12*s,5*s,.3);ctx.save();ctx.translate(p.x,p.y);ctx.fillStyle=light.night>.55?'#7a6848':'#b09562';ctx.strokeStyle='#d2bd82';ctx.lineWidth=Math.max(1,s);ctx.beginPath();ctx.moveTo(-11*s,2*s);ctx.lineTo(0,-12*s);ctx.lineTo(11*s,2*s);ctx.closePath();ctx.fill();ctx.stroke();ctx.fillStyle='#4b3525';ctx.beginPath();ctx.moveTo(-2*s,2*s);ctx.lineTo(0,-5*s);ctx.lineTo(3*s,2*s);ctx.closePath();ctx.fill();ctx.restore();this.hits.push({id:e.id,kind:'shelter',x:p.x,y:p.y-4*s,r:15*s});}
   drawProject(ctx,e,p,light){const pr=e.data,s=clamp(this.camera.zoom,.7,2.2),progress=pr.workRequiredMinutes?clamp(pr.workDoneMinutes/pr.workRequiredMinutes,0,1):.2;this.drawShadow(ctx,p,15*s,6*s,.28);ctx.save();ctx.translate(p.x,p.y);ctx.strokeStyle='#c7a768';ctx.lineWidth=2*s;for(let i=-1;i<=1;i++){ctx.beginPath();ctx.moveTo(i*9*s,4*s);ctx.lineTo(i*9*s,-(6+14*progress)*s);ctx.stroke();}ctx.beginPath();ctx.moveTo(-12*s,-8*s);ctx.lineTo(12*s,-8*s);ctx.stroke();ctx.fillStyle='#9c8257';ctx.fillRect(-10*s,0,20*s,4*s);ctx.restore();this.hits.push({id:e.id,kind:'project',x:p.x,y:p.y-8*s,r:18*s});}
   drawBuilding(ctx,e,p,light){const b=e.data,s=clamp(this.camera.zoom,.72,2.2),active=this.selected===b.id;this.drawShadow(ctx,p,20*s,8*s,.34);ctx.save();ctx.translate(p.x,p.y);ctx.fillStyle=light.night>.55?'#706c5b':'#9a9578';ctx.strokeStyle=active?'#ffe4a2':'#d3c59e';ctx.lineWidth=active?2.4:1.2;ctx.fillRect(-15*s,-20*s,30*s,21*s);ctx.strokeRect(-15*s,-20*s,30*s,21*s);ctx.fillStyle='#6d5136';ctx.beginPath();ctx.moveTo(-19*s,-20*s);ctx.lineTo(0,-34*s);ctx.lineTo(19*s,-20*s);ctx.closePath();ctx.fill();ctx.stroke();ctx.fillStyle='#3b2b20';ctx.fillRect(-3*s,-8*s,6*s,9*s);ctx.restore();this.hits.push({id:e.id,kind:'building',x:p.x,y:p.y-12*s,r:22*s});}
-  drawCitizen(ctx,e,p,light,minute){const c=e.data,a=c.currentAction,s=clamp(this.camera.zoom,.68,2.3),active=this.selected===c.id||this.follow===c.id,moving=a?.type==='MOVE'&&worldMinute(this.state)<Number(a.endsWorldMinute),phase=(performance.now?.()||Date.now())/125+hashUnit(c.id)*TAU,step=moving?Math.sin(phase):0;let facing=0;if(moving&&a?.targetPosition&&a?.fromPosition)facing=Math.atan2(a.targetPosition.y-a.fromPosition.y,a.targetPosition.x-a.fromPosition.x);this.drawShadow(ctx,{x:p.x,y:p.y+2*s},6*s,2.8*s,.32);ctx.save();ctx.translate(p.x,p.y+step*1.2*s);if(active){ctx.strokeStyle='#ffe39b';ctx.lineWidth=1.5*s;ctx.beginPath();ctx.ellipse(0,3*s,10*s,5*s,0,0,TAU);ctx.stroke();}ctx.rotate(facing*.08);const human=c.kind==='HUMAN_LINKED';ctx.strokeStyle=human?'#9fd4ff':'#d2c9a5';ctx.lineWidth=1*s;ctx.fillStyle=human?'#315b76':'#4f7258';ctx.beginPath();ctx.roundRect?.(-4*s,-11*s,8*s,10*s,2*s);if(ctx.roundRect)ctx.fill();else ctx.fillRect(-4*s,-11*s,8*s,10*s);ctx.fillStyle='#d7bd95';ctx.beginPath();ctx.arc(0,-14*s,3.4*s,0,TAU);ctx.fill();if(moving){ctx.strokeStyle='#342b22';ctx.lineWidth=1.3*s;ctx.beginPath();ctx.moveTo(-1*s,-1*s);ctx.lineTo((-2-step*2)*s,4*s);ctx.moveTo(1*s,-1*s);ctx.lineTo((2+step*2)*s,4*s);ctx.stroke();}this.drawCitizenAction(ctx,a,phase,s);if(a&&this.camera.zoom>.82){ctx.font=`bold ${Math.round(8*s)}px system-ui`;ctx.textAlign='center';ctx.fillStyle='#f4e1a2';ctx.strokeStyle='#203024';ctx.lineWidth=2;const icon=ACTION_ICON[a.type]||'·';ctx.strokeText(icon,0,-23*s);ctx.fillText(icon,0,-23*s);}ctx.restore();this.hits.push({id:c.id,kind:'citizen',x:p.x,y:p.y-8*s,r:12*s});if(this.overlay==='knowledge'){const count=Array.isArray(c.knowledge)?c.knowledge.length:Number(c.knowledge?.count||0);ctx.fillStyle='rgba(14,25,18,.88)';ctx.fillRect(p.x-15*s,p.y-33*s,30*s,10*s);ctx.fillStyle='#b7dcc3';ctx.font=`${Math.max(7,Math.round(7*s))}px system-ui`;ctx.textAlign='center';ctx.fillText(`K ${count}`,p.x,p.y-25*s);}}
+  drawCitizen(ctx,e,p,light,minute){const c=e.data,a=c.currentAction,s=clamp(this.camera.zoom,.68,2.3),owned=c.id===this.ownedCitizen,active=this.selected===c.id||this.follow===c.id,moving=a?.type==='MOVE'&&worldMinute(this.state)<Number(a.endsWorldMinute),phase=(performance.now?.()||Date.now())/125+hashUnit(c.id)*TAU,step=moving?Math.sin(phase):0;let facing=0;if(moving&&a?.targetPosition&&a?.fromPosition)facing=Math.atan2(a.targetPosition.y-a.fromPosition.y,a.targetPosition.x-a.fromPosition.x);this.drawShadow(ctx,{x:p.x,y:p.y+2*s},6*s,2.8*s,.32);ctx.save();ctx.translate(p.x,p.y+step*1.2*s);if(active){ctx.strokeStyle='#ffe39b';ctx.lineWidth=1.5*s;ctx.beginPath();ctx.ellipse(0,3*s,10*s,5*s,0,0,TAU);ctx.stroke();}if(owned){ctx.strokeStyle='#8fd7ff';ctx.lineWidth=1.8*s;ctx.beginPath();ctx.ellipse(0,3*s,13*s,6.5*s,0,0,TAU);ctx.stroke();ctx.font=`bold ${Math.max(8,Math.round(8*s))}px system-ui`;ctx.textAlign='center';ctx.fillStyle='#bfe8ff';ctx.strokeStyle='#17251f';ctx.lineWidth=2;ctx.strokeText('YOU',0,-27*s);ctx.fillText('YOU',0,-27*s);}ctx.rotate(facing*.08);const human=c.kind==='HUMAN_LINKED';ctx.strokeStyle=human?'#9fd4ff':'#d2c9a5';ctx.lineWidth=1*s;ctx.fillStyle=human?'#315b76':'#4f7258';ctx.beginPath();ctx.roundRect?.(-4*s,-11*s,8*s,10*s,2*s);if(ctx.roundRect)ctx.fill();else ctx.fillRect(-4*s,-11*s,8*s,10*s);ctx.fillStyle='#d7bd95';ctx.beginPath();ctx.arc(0,-14*s,3.4*s,0,TAU);ctx.fill();if(moving){ctx.strokeStyle='#342b22';ctx.lineWidth=1.3*s;ctx.beginPath();ctx.moveTo(-1*s,-1*s);ctx.lineTo((-2-step*2)*s,4*s);ctx.moveTo(1*s,-1*s);ctx.lineTo((2+step*2)*s,4*s);ctx.stroke();}this.drawCitizenAction(ctx,a,phase,s);if(a&&this.camera.zoom>.82){ctx.font=`bold ${Math.round(8*s)}px system-ui`;ctx.textAlign='center';ctx.fillStyle='#f4e1a2';ctx.strokeStyle='#203024';ctx.lineWidth=2;const icon=ACTION_ICON[a.type]||'·';ctx.strokeText(icon,0,-23*s);ctx.fillText(icon,0,-23*s);}ctx.restore();this.hits.push({id:c.id,kind:'citizen',x:p.x,y:p.y-8*s,r:12*s});if(this.overlay==='knowledge'){const count=Array.isArray(c.knowledge)?c.knowledge.length:Number(c.knowledge?.count||0);ctx.fillStyle='rgba(14,25,18,.88)';ctx.fillRect(p.x-15*s,p.y-33*s,30*s,10*s);ctx.fillStyle='#b7dcc3';ctx.font=`${Math.max(7,Math.round(7*s))}px system-ui`;ctx.textAlign='center';ctx.fillText(`K ${count}`,p.x,p.y-25*s);}}
   drawCitizenAction(ctx,a,phase,s){if(!a)return;const w=Math.sin(phase);if(['CUT','DIG','BUILD','GATHER'].includes(a.type)){ctx.strokeStyle='#dec27c';ctx.lineWidth=1.4*s;ctx.beginPath();ctx.moveTo(3*s,-7*s);ctx.lineTo((8+w*3)*s,(-12-w*3)*s);ctx.stroke();}else if(a.type==='CARRY'){ctx.fillStyle='#9a754a';ctx.fillRect(-8*s,-10*s,4*s,6*s);}else if(a.type==='COMMUNICATE'||a.type==='TEACH'){ctx.strokeStyle='#b8e0c4';ctx.beginPath();ctx.arc(7*s,-17*s,(3+Math.abs(w)*2)*s,Math.PI*.7,Math.PI*1.7);ctx.stroke();}else if(a.type==='SLEEP'){ctx.fillStyle='#b9d3df';ctx.font=`${Math.round(9*s)}px Georgia`;ctx.fillText('z',6*s,-17*s);}else if(a.type==='EXPERIMENT'){ctx.fillStyle='#eadb82';ctx.globalAlpha=.5+.4*Math.abs(w);ctx.beginPath();ctx.arc(8*s,-15*s,2.4*s,0,TAU);ctx.fill();ctx.globalAlpha=1;}else if(['ATTACK','DEFEND'].includes(a.type)){ctx.strokeStyle='#e99578';ctx.lineWidth=1.5*s;ctx.beginPath();ctx.moveTo(4*s,-7*s);ctx.lineTo(10*s,(-10-w*3)*s);ctx.stroke();}}
   drawRelations(ctx,minute){const by=new Map((this.state.citizens||[]).filter(c=>c.alive).map(c=>[c.id,c])),seen=new Set();ctx.save();for(const a of by.values())for(const [id,rel] of Object.entries(a.relationships||{})){const b=by.get(id);if(!b)continue;const key=[a.id,b.id].sort().join('|');if(seen.has(key))continue;seen.add(key);const strength=Math.max(relationStrength(rel),relationStrength(b.relationships?.[a.id]));if(strength<.12)continue;const ap=citizenPosition(a,this.state),bp=citizenPosition(b,this.state),ta=terrainAtPublic(this.state,ap.x,ap.y),tb=terrainAtPublic(this.state,bp.x,bp.y),pa=this.project(ap.x,ap.y,ta.elevation),pb=this.project(bp.x,bp.y,tb.elevation);ctx.strokeStyle=this.selected===a.id||this.selected===b.id?'rgba(255,225,153,.78)':`rgba(146,211,172,${.12+strength*.34})`;ctx.lineWidth=.5+strength*1.4;ctx.beginPath();ctx.moveTo(pa.x,pa.y-8);ctx.lineTo(pb.x,pb.y-8);ctx.stroke();}ctx.restore();}
   drawAtmosphere(ctx,r,light,minute){const rain=Number(this.state.environment?.precipitation||0);if(rain>.06){ctx.save();ctx.strokeStyle=`rgba(202,222,218,${.12+rain*.34})`;ctx.lineWidth=1;const count=Math.min(150,Math.floor(35+rain*180));for(let i=0;i<count;i++){const x=(hashUnit(i,Math.floor(minute/2),1)*r.width+minute*7)%r.width,y=(hashUnit(i,11,2)*r.height+minute*15+i*13)%r.height;ctx.beginPath();ctx.moveTo(x,y);ctx.lineTo(x-4,y+10);ctx.stroke();}ctx.restore();}if(light.night>.05){ctx.fillStyle=`rgba(4,11,18,${light.night*.16})`;ctx.fillRect(0,0,r.width,r.height);}if(light.dawn>.08){ctx.fillStyle=`rgba(225,145,84,${light.dawn*.08})`;ctx.fillRect(0,0,r.width,r.height);}const vignette=ctx.createRadialGradient(r.width/2,r.height/2,Math.min(r.width,r.height)*.28,r.width/2,r.height/2,Math.max(r.width,r.height)*.68);vignette.addColorStop(0,'rgba(0,0,0,0)');vignette.addColorStop(1,'rgba(3,8,6,.16)');ctx.fillStyle=vignette;ctx.fillRect(0,0,r.width,r.height);}
-  drawMini(minute){if(!this.mini||!this.state)return;const ctx=this.mini.getContext('2d'),w=this.mini.width,h=this.mini.height;ctx.clearRect(0,0,w,h);for(let y=0;y<100;y+=4)for(let x=0;x<100;x+=4){const t=terrainAtPublic(this.state,x+2,y+2);ctx.fillStyle=terrainPalette(t.kind,.12);ctx.fillRect(x/100*w,y/100*h,4/100*w+1,4/100*h+1);}for(const b of this.state.buildings||[])if(b.massKg>0&&b.condition>0){ctx.fillStyle='#e3ca8b';ctx.fillRect(b.position.x/100*w-1,b.position.y/100*h-1,3,3);}for(const p of this.state.projects||[])if(p.status==='construction'){ctx.fillStyle='#c78c56';ctx.fillRect(p.site.x/100*w-1,p.site.y/100*h-1,3,3);}for(const c of this.state.citizens||[])if(c.alive){const p=citizenPosition(c,this.state);ctx.fillStyle=c.id===this.selected?'#ffe09a':c.kind==='HUMAN_LINKED'?'#8fcfff':'#d7e5bd';ctx.fillRect(p.x/100*w,p.y/100*h,2,2);}ctx.strokeStyle='#f3dda0';ctx.lineWidth=1;ctx.beginPath();for(const [i,xy] of [[0,[0,0]],[1,[this.camera.width,0]],[2,[this.camera.width,this.camera.height]],[3,[0,this.camera.height]]]){const p=this.unproject(...xy);if(i===0)ctx.moveTo(p.x/100*w,p.y/100*h);else ctx.lineTo(p.x/100*w,p.y/100*h);}ctx.closePath();ctx.stroke();}
+  drawMini(minute){if(!this.mini||!this.state)return;const ctx=this.mini.getContext('2d'),w=this.mini.width,h=this.mini.height;ctx.clearRect(0,0,w,h);for(let y=0;y<100;y+=4)for(let x=0;x<100;x+=4){const t=terrainAtPublic(this.state,x+2,y+2);ctx.fillStyle=terrainPalette(t.kind,.12);ctx.fillRect(x/100*w,y/100*h,4/100*w+1,4/100*h+1);}for(const b of this.state.buildings||[])if(b.massKg>0&&b.condition>0){ctx.fillStyle='#e3ca8b';ctx.fillRect(b.position.x/100*w-1,b.position.y/100*h-1,3,3);}for(const p of this.state.projects||[])if(p.status==='construction'){ctx.fillStyle='#c78c56';ctx.fillRect(p.site.x/100*w-1,p.site.y/100*h-1,3,3);}for(const c of this.state.citizens||[])if(c.alive){const p=citizenPosition(c,this.state);ctx.fillStyle=c.id===this.ownedCitizen?'#ffffff':c.id===this.selected?'#ffe09a':c.kind==='HUMAN_LINKED'?'#8fcfff':'#d7e5bd';const size=c.id===this.ownedCitizen?3:2;ctx.fillRect(p.x/100*w-size/2,p.y/100*h-size/2,size,size);}ctx.strokeStyle='#f3dda0';ctx.lineWidth=1;ctx.beginPath();for(const [i,xy] of [[0,[0,0]],[1,[this.camera.width,0]],[2,[this.camera.width,this.camera.height]],[3,[0,this.camera.height]]]){const p=this.unproject(...xy);if(i===0)ctx.moveTo(p.x/100*w,p.y/100*h);else ctx.lineTo(p.x/100*w,p.y/100*h);}ctx.closePath();ctx.stroke();}
 }
diff --git a/site/sovereign-world.css b/site/sovereign-world.css
index e141b2c..6b8016d 100644
--- a/site/sovereign-world.css
+++ b/site/sovereign-world.css
@@ -6,7 +6,7 @@
 .inspector{position:absolute;z-index:16;right:12px;top:91px;width:min(360px,calc(100vw - 24px));max-height:calc(100vh - 190px);overflow:auto;padding:18px;border-radius:3px}.inspector>.panel-close{position:sticky;float:right;top:0;margin:-8px -8px 4px 8px}.eyebrow{display:block;font-size:8px;letter-spacing:.18em;color:#765b32;margin:6px 0}.inspector h2,.game-window h2{font:700 25px/1.05 var(--ui-font);margin:4px 0 8px;color:#2c2517}.inspector h3{font:700 13px var(--ui-font);margin:9px 0 4px}.inspector p{font-size:11px;line-height:1.45}.inspector-grid{display:grid;grid-template-columns:repeat(4,1fr);gap:4px;margin:12px 0}.inspector-grid div{background:#8e764233;border:1px solid #7d653633;padding:7px;text-align:center}.inspector-grid b{display:block;font:700 13px var(--ui-font)}.inspector-grid small{display:block;font-size:7px;text-transform:uppercase}.inspector-section{border-top:1px solid #876b3a55;margin-top:10px;padding-top:7px}.tag{display:inline-block;border:1px solid #836b3e;background:#fff8d943;border-radius:2px;padding:3px 5px;margin:2px;font-size:8px;color:#362d1c}
 .mini-map-shell{position:absolute;z-index:13;left:12px;bottom:18px;width:260px;padding:7px;border-radius:3px}.mini-title{height:24px;display:flex;justify-content:space-between;align-items:center;padding:0 4px;font:700 9px var(--ui-font);letter-spacing:.12em;color:#dfc787}.mini-title small{font-size:7px;color:#a8956a}#miniMap{display:block;width:100%;height:148px;border:2px inset #6e5936;background:#0d160f;image-rendering:auto}
 .game-dock{position:absolute;z-index:14;left:50%;bottom:15px;transform:translateX(-50%);height:67px;display:flex;align-items:stretch;padding:5px;border-radius:4px}.game-dock button{width:78px;border:0;border-right:1px solid #6e5938;background:linear-gradient(#4c3b25,#302719);color:#e8d49c;text-shadow:0 1px #000}.game-dock button:last-child{border-right:0}.game-dock button:hover{background:linear-gradient(#6b5330,#44351f);color:#fff0bd}.game-dock button span{display:block;font:700 20px var(--ui-font);line-height:28px}.game-dock button b{font:700 8px var(--ui-font);text-transform:uppercase;letter-spacing:.05em}
-.game-window{position:absolute;z-index:30;left:50%;top:50%;transform:translate(-50%,-50%);width:min(920px,calc(100vw - 40px));height:min(680px,calc(100vh - 80px));border-radius:4px;padding:20px;overflow:hidden}.game-window[hidden]{display:none}.game-window>header{display:flex;justify-content:space-between;border-bottom:1px solid #7d6338;padding-bottom:12px}.game-window>header span{font-size:8px;letter-spacing:.2em;color:#775d32}.game-window>header p{font-size:10px;margin:4px 0}.history-toolbar{display:flex;gap:8px;padding:10px 0}.history-toolbar input,.history-toolbar select,.agent-copy textarea{background:#f4e8c5;border:1px solid #7c6135;color:#2b2417;padding:8px}.history-toolbar input{flex:1}.history-timeline{height:calc(100% - 130px);overflow:auto;padding-right:8px}.history-entry{display:grid;grid-template-columns:105px 16px 1fr;gap:8px;padding:9px 0;border-bottom:1px solid #80694142;cursor:pointer}.history-entry:hover{background:#fff5d632}.history-date{font:700 8px var(--ui-font);color:#765d34}.history-node{width:7px;height:7px;border-radius:50%;background:#71562f;margin-top:4px;box-shadow:0 0 0 3px #8b704033}.history-entry b{font:700 11px var(--ui-font)}.history-entry small{display:block;font-size:8px;margin-top:3px;opacity:.75}.why-panel{position:absolute;right:18px;bottom:18px;width:min(390px,45%);max-height:45%;overflow:auto;background:#241d13;color:#ead9ab;border:1px solid #9d7d45;padding:13px;box-shadow:0 10px 30px #0008}.why-panel pre{white-space:pre-wrap;font-size:8px}.agent-window{width:min(640px,calc(100vw - 40px));height:auto;max-height:80vh}.agent-copy{padding-top:14px}.agent-copy textarea{width:100%;resize:vertical}.agent-copy .primary{display:block;margin-top:8px;padding:10px 16px;border:1px solid #604923;background:#72562d;color:#fff0bd}.agent-copy a{display:inline-block;margin-top:10px;color:#644a24}
+.game-window{position:absolute;z-index:30;left:50%;top:50%;transform:translate(-50%,-50%);width:min(920px,calc(100vw - 40px));height:min(680px,calc(100vh - 80px));border-radius:4px;padding:20px;overflow:hidden}.game-window[hidden]{display:none}.game-window>header{display:flex;justify-content:space-between;border-bottom:1px solid #7d6338;padding-bottom:12px}.game-window>header span{font-size:8px;letter-spacing:.2em;color:#775d32}.game-window>header p{font-size:10px;margin:4px 0}.history-toolbar{display:flex;gap:8px;padding:10px 0}.history-toolbar input,.history-toolbar select,.agent-copy textarea{background:#f4e8c5;border:1px solid #7c6135;color:#2b2417;padding:8px}.history-toolbar input{flex:1}.history-timeline{height:calc(100% - 130px);overflow:auto;padding-right:8px}.history-entry{display:grid;grid-template-columns:105px 16px 1fr;gap:8px;padding:9px 0;border-bottom:1px solid #80694142;cursor:pointer}.history-entry:hover{background:#fff5d632}.history-date{font:700 8px var(--ui-font);color:#765d34}.history-node{width:7px;height:7px;border-radius:50%;background:#71562f;margin-top:4px;box-shadow:0 0 0 3px #8b704033}.history-entry b{font:700 11px var(--ui-font)}.history-entry small{display:block;font-size:8px;margin-top:3px;opacity:.75}.why-panel{position:absolute;right:18px;bottom:18px;width:min(390px,45%);max-height:45%;overflow:auto;background:#241d13;color:#ead9ab;border:1px solid #9d7d45;padding:13px;box-shadow:0 10px 30px #0008}.why-panel pre{white-space:pre-wrap;font-size:8px}.agent-window{width:min(640px,calc(100vw - 40px));height:auto;max-height:80vh}.agent-copy{padding-top:14px}.agent-copy textarea{width:100%;resize:vertical}.agent-copy .primary{display:block;margin-top:8px;padding:10px 16px;border:1px solid #604923;background:#72562d;color:#fff0bd}.agent-copy a{display:inline-block;margin-top:10px;color:#644a24}.game-dock button small{display:block;font-size:6px;line-height:8px;letter-spacing:.08em;color:#9da98a}.game-dock button small[data-state="alive"]{color:#9be095}.game-dock button small[data-state="dead"]{color:#d88976}.avatar-login{padding:9px 12px;border:1px solid #765a31;background:#e7d7aa}.avatar-identity{display:flex;align-items:center;gap:12px;padding:8px 0 12px;border-bottom:1px solid #876b3a55}.avatar-identity img{width:44px;height:44px;border-radius:50%;border:2px solid #765a31}.avatar-identity h3{margin:2px 0;font:700 18px var(--ui-font)}.avatar-identity small{font-size:8px;letter-spacing:.06em}.avatar-actions{display:flex;gap:6px;padding:10px 0}.avatar-actions button{flex:1;padding:8px;border:1px solid #765a31;background:#5f492d;color:#f4e4b4}.avatar-stats,.avatar-evolution-grid{display:grid;grid-template-columns:repeat(4,1fr);gap:5px}.avatar-stats div,.avatar-evolution-grid span{background:#8e764233;border:1px solid #7d653633;padding:8px;text-align:center}.avatar-stats b,.avatar-evolution-grid b{display:block;font:700 14px var(--ui-font)}.avatar-stats small,.avatar-evolution-grid small{display:block;font-size:7px;text-transform:uppercase}.avatar-section{border-top:1px solid #876b3a55;margin-top:10px;padding-top:8px}.avatar-section h3{font:700 13px var(--ui-font);margin:0 0 5px}.avatar-life-row{display:grid;grid-template-columns:125px 1fr;gap:8px;padding:5px 0;border-bottom:1px solid #80694133;font-size:8px}.avatar-life-row span{color:#765d34}.avatar-direction textarea{margin-top:5px}
 .truth-badge{position:absolute;z-index:12;right:13px;bottom:18px;display:flex;align-items:center;gap:7px;padding:6px 9px;background:#1a2117dd;border:1px solid #675a3b;color:#cdbf92;font-size:7px;letter-spacing:.12em}.truth-badge i{width:7px;height:7px;border-radius:50%;background:#d1a84d}.truth-badge[data-mode="LIVE"] i{background:#73b56d;box-shadow:0 0 7px #73b56d}.truth-badge[data-mode="DEGRADED"] i,.truth-badge[data-mode="RECONNECTING"] i{background:#d38b45}.truth-badge[data-mode="REPLAY"] i{background:#aa6254}.control-hints{position:absolute;z-index:9;left:50%;top:84px;transform:translateX(-50%);font-size:7px;color:#d8c996aa;letter-spacing:.08em;text-shadow:0 1px #000}.control-hints span{color:#f1dfaa}.control-hints i:after{content:'·';margin:0 8px}.toast-layer{position:absolute;right:15px;top:88px;z-index:50;display:grid;gap:6px}.toast{background:#2f2719;color:#ecdca9;border:1px solid #8b7041;padding:8px 12px;box-shadow:0 6px 20px #0007;font-size:9px}
 .world-loader{position:absolute;inset:0;z-index:100;background:#0c120d;display:grid;place-content:center;text-align:center;transition:opacity .45s,visibility .45s}.world-loader.ready{opacity:0;visibility:hidden}.world-loader strong{font:700 25px var(--ui-font);letter-spacing:.13em;color:#e0c77f}.world-loader span{font-size:9px;letter-spacing:.15em;color:#968662;margin-top:8px}.world-loader-mark{display:flex;gap:5px;justify-content:center;margin-bottom:12px}.world-loader-mark i{width:8px;height:18px;background:#947541;animation:loader 1s infinite alternate}.world-loader-mark i:nth-child(2){animation-delay:.2s}.world-loader-mark i:nth-child(3){animation-delay:.4s}@keyframes loader{to{transform:translateY(-7px);background:#d8bd73}}
 @media(max-width:900px){.game-topbar{height:58px;gap:5px}.brand{min-width:110px}.brand b{font-size:17px}.brand span{display:none}.world-clock{min-width:150px;padding:4px 8px}.top-metrics span{min-width:55px;padding:4px}.environment-metric{display:none}.activity-rail{top:78px;max-height:45vh;width:225px}.mini-map-shell{width:190px;bottom:83px}.mini-map-shell canvas{height:110px}.game-dock{bottom:8px;width:calc(100vw - 14px);height:60px}.game-dock button{flex:1;width:auto}.game-dock button b{font-size:6px}.truth-badge{bottom:75px}.control-hints{display:none}.inspector{top:72px;max-height:calc(100vh - 150px)}}
diff --git a/site/sovereign-world.js b/site/sovereign-world.js
index d34ec27..32e7a51 100644
--- a/site/sovereign-world.js
+++ b/site/sovereign-world.js
@@ -4,7 +4,7 @@ import {observerConceptView} from './observer-concepts.js';
 const $=id=>document.getElementById(id);
 const esc=v=>String(v??'').replace(/[&<>"']/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
 const ICON={MOVE:'→',OBSERVE:'◉',REST:'·',SLEEP:'z',EAT:'•',DRINK:'≈',GATHER:'⌁',CARRY:'▣',CUT:'╱',DIG:'⌄',BUILD:'⌂',CARE:'+',TEACH:'◇',COMMUNICATE:'◇',EXPERIMENT:'✦',ATTACK:'⚠',DEFEND:'◈',TRANSFER:'↔',PROMISE:'∞',CLAIM:'⌁',REPRODUCE:'◌'};
-const state={world:null,selected:null,renderer:null,keys:new Set(),lastFrame:performance.now(),lastHud:0,connection:null,mode:CONNECTION.CONNECTING};
+const state={world:null,selected:null,renderer:null,myAvatar:null,keys:new Set(),lastFrame:performance.now(),lastHud:0,connection:null,mode:CONNECTION.CONNECTING};
 async function getJSON(url,opts={}){const r=await fetch(url,{cache:'no-store',credentials:'same-origin',...opts});if(!r.ok)throw new Error(`${r.status}`);return r.json();}
 function dateLabel(min){const m=Math.max(0,Math.floor(min)),year=Math.floor(m/525600)+1,rem=m%525600,day=Math.floor(rem/1440)+1,hour=Math.floor((rem%1440)/60),minute=rem%60;return `YEAR ${year} · DAY ${day} · ${String(hour).padStart(2,'0')}:${String(minute).padStart(2,'0')}`;}
 function climateState(w){const minute=worldMinute(w),dayPhase=Number(w.environment?.dayPhase??((minute%1440)/1440)),seasonPhase=Number(w.environment?.seasonPhase??((minute%525600)/525600)),temperature=Number(w.environment?.temperatureC??18),rain=Number(w.environment?.precipitation??0),seasons=['DEEPWINTER','THAW','HIGHSUN','HARVEST'],season=seasons[Math.floor((((seasonPhase+.125)%1)+1)%1*4)%4];return{dayPhase,season,temperature,rain,night:dayPhase<.21||dayPhase>.79};}
@@ -12,18 +12,19 @@ function citizenName(c){return c.selfName||c.observerDisplayName||c.id.replace('
 function goalLabel(g){if(!g)return 'No long-term goal exposed';if(typeof g==='string')return g;const actions=Array.isArray(g.actionTypes)?g.actionTypes:[],concepts=Array.isArray(g.concepts)?g.concepts:[];return [actions.length?actions.join(' → '):'',concepts.length?`concepts ${concepts.join(', ')}`:''].filter(Boolean).join(' · ')||'Self-directed';}
 function modeLabel(mode){return({[CONNECTION.LIVE]:'LIVE · CANONICAL WORLD',[CONNECTION.DEGRADED]:'DEGRADED · LAST CANONICAL STATE',[CONNECTION.REPLAY]:'OFFLINE · GENESIS REPLAY',[CONNECTION.RECONNECTING]:'RECONNECTING TO CANONICAL WORLD',[CONNECTION.CONNECTING]:'CONNECTING TO CANONICAL WORLD'})[mode]||mode;}
 function setConnectionMode(mode,detail){state.mode=mode;const badge=document.querySelector('.truth-badge');if(badge)badge.dataset.mode=mode;$('truthText').textContent=modeLabel(mode);$('worldStatus').textContent=mode===CONNECTION.LIVE?'CANONICAL WORLD':mode;if(mode===CONNECTION.DEGRADED&&detail?.retryInMs)$('worldStatus').textContent=`RETRY ${Math.ceil(detail.retryInMs/1000)}s`;}
-function acceptWorld(world,meta={}){state.world=world;state.renderer?.setState(world);$('worldLoader')?.classList.add('ready');renderAll();}
+function acceptWorld(world,meta={}){state.world=world;state.renderer?.setState(world);state.renderer?.setOwnedCitizen?.(state.myAvatar?.citizenId||null);$('worldLoader')?.classList.add('ready');renderAll();}
 function renderTop(){
   const w=state.world;if(!w)return;
-  const living=w.citizens.filter(c=>c.alive).length,climate=climateState(w),visibility=state.renderer?.populationVisibility?.()||{visible:living,total:living};
+  const living=w.citizens.filter(c=>c.alive).length,embodied=w.citizens.length,human=w.citizens.filter(c=>c.kind==='HUMAN_LINKED').length,climate=climateState(w),visibility=state.renderer?.populationVisibility?.()||{visible:living,total:living};
   $('populationValue').textContent=living;
-  if($('populationLabel'))$('populationLabel').textContent=`PEOPLE · ${visibility.visible} VISIBLE`;
+  if($('populationLabel'))$('populationLabel').textContent=`LIVING · ${embodied} TOTAL · ${human} HUMAN · ${visibility.visible} VISIBLE`;
   $('structureValue').textContent=(w.buildings||[]).length;
   $('organizationValue').textContent=(w.organizations||[]).length;
   $('environmentValue').textContent=`${Math.round(climate.temperature)}° ${climate.season}`;
   $('weatherValue').textContent=climate.rain>.08?`RAIN ${Math.round(climate.rain*100)}%`:climate.night?'NIGHT':'CLEAR';
   $('worldDate').textContent=dateLabel(worldMinute(w));
   $('miniMode').textContent=state.mode===CONNECTION.LIVE?'LIVE':'OBSERVER';
+  renderMyAvatarStatus();
 }
 function significantHistory(w){const rows=[...(w.history||[])];const rank={conflict:9,life:8,construction:8,society:8,culture:8,language:7,knowledge:7,genesis:6};return rows.sort((a,b)=>(b.worldMinute-a.worldMinute)||(rank[b.category]||0)-(rank[a.category]||0)).slice(0,14);}
 function renderActivity(){const w=state.world;if(!w)return;const history=significantHistory(w);if(history.length){$('activityList').innerHTML=history.map(e=>`<button class="activity-row" data-event="${esc(e.eventId)}"><span>${e.category==='life'?'✦':e.category==='construction'?'⌂':e.category==='conflict'?'⚠':e.category==='language'?'◇':'•'}</span><div><b>${esc(e.label)}</b><small>${esc(e.date?.label||dateLabel(e.worldMinute))} · ${esc(e.category)}</small></div></button>`).join('');return;}const now=worldMinute(w),rows=w.citizens.filter(c=>c.alive&&c.currentAction).sort((a,b)=>{const am=a.currentAction.type==='MOVE'?1:0,bm=b.currentAction.type==='MOVE'?1:0;return am-bm||a.currentAction.endsWorldMinute-b.currentAction.endsWorldMinute;}).slice(0,14);$('activityList').innerHTML=rows.map(c=>{const a=c.currentAction,span=Math.max(1,a.endsWorldMinute-a.startedWorldMinute),progress=clamp((now-a.startedWorldMinute)/span*100,0,100);return `<button class="activity-row" data-citizen="${esc(c.id)}"><span>${ICON[a.type]||'·'}</span><div><b>${esc(citizenName(c))}</b><small>${esc(a.type.toLowerCase())} · ${esc(a.purpose||'self-directed')}</small><i class="action-progress"><i class="action-progress-fill" style="width:${progress.toFixed(1)}%"></i></i></div></button>`;}).join('')||'<div class="activity-row"><span>…</span><div><b>Quiet interval</b><small>No significant canonical event right now.</small></div></div>';}
@@ -35,14 +36,98 @@ function renderInspector(){const w=state.world;if(!w)return;const c=w.citizens.f
   $('inspectorBody').innerHTML=`<span class="eyebrow">${esc(c.kind)} · ${c.alive?'ALIVE':'DEAD'}</span><h2>${esc(citizenName(c))}</h2><div class="inspector-grid"><div><b>${age}</b><small>years</small></div><div><b>${Math.round(c.body.health)}%</b><small>health</small></div><div><b>${Math.round(c.body.hydration)}%</b><small>water</small></div><div><b>${Math.round(c.body.calories)}%</b><small>energy</small></div></div><div class="inspector-section"><span class="eyebrow">CURRENT ACTION</span><h3>${esc(a?.type||'IDLE / THINKING')}</h3><p>${esc(a?.purpose||'No public physical action recorded.')}</p>${a?`<button class="tag" data-why-action="${esc(a.id)}">WHY?</button>`:''}</div><div class="inspector-section"><h3>Current goal</h3><p>${esc(goalLabel(c.activeGoal))}</p></div><div class="inspector-section"><h3>Body / exposure</h3><span class="tag">sleep ${Math.round(c.body.sleepPressure||0)}%</span><span class="tag">temperature ${Number(c.body.temperatureC||36.6).toFixed(1)}°C</span><span class="tag">terrain ${esc(c.body.exposure?.terrain||'unknown')}</span><span class="tag">rain exposure ${Math.round((c.body.exposure?.rainExposure||0)*100)}%</span><span class="tag">injuries ${Number(c.body.injuries||0)}</span><span class="tag">diseases ${Number(c.body.diseases||0)}</span></div><div class="inspector-section"><h3>Mind / traits</h3>${psych.map(([name,v])=>`<span class="tag">${esc(name)} ${Math.round(v*100)}%</span>`).join('')||'<p>No public trait state.</p>'}</div><div class="inspector-section"><h3>Known concepts</h3>${conceptViews.length?conceptViews.slice(0,28).map(v=>`<span class="tag concept-tag" title="${esc(v.tooltip)}">${esc(v.label)}</span>`).join(''):`<p>${c.knowledge?.count!=null?`${c.knowledge.count} private concepts`:'No exposed concepts yet.'}</p>`}</div><div class="inspector-section"><h3>Language</h3>${Object.entries(c.language?.lexicon||{}).slice(0,18).map(([concept,token])=>{const v=conceptById.get(concept)||observerConceptView(w,c,{concept,confidence:null,provenance:[]});return `<span class="tag concept-word" title="${esc(v.tooltip)}">${esc(token)} ↔ ${esc(v.label)}</span>`;}).join('')||'<p>No stable coined lexicon yet.</p>'}</div><div class="inspector-section"><h3>Relationships</h3>${rels.map(([id,r])=>`<span class="tag">${esc(id.replace('genesis:','C'))} · trust ${Math.round((r.trust||0)*100)} · affection ${Math.round((r.affection||0)*100)} · fear ${Math.round((r.fear||0)*100)}</span>`).join('')||'<p>No significant public relationship data yet.</p>'}</div><div class="inspector-section"><h3>Possessions</h3>${poss.map(id=>`<span class="tag">${esc(objectLabel(id))}</span>`).join('')||'<p>No individually held objects.</p>'}</div>`;}
 function renderHistory(){const history=state.world?.history||[],q=$('historySearch').value.trim().toLowerCase(),cat=$('historyCategory').value,rows=history.filter(e=>(cat==='all'||e.category===cat)&&(!q||JSON.stringify(e).toLowerCase().includes(q))).sort((a,b)=>b.worldMinute-a.worldMinute);$('historyTimeline').innerHTML=rows.length?rows.map(e=>`<article class="history-entry" data-event="${esc(e.eventId)}"><span class="history-date">${esc(e.date?.label||dateLabel(e.worldMinute))}</span><i class="history-node"></i><div><b>${esc(e.label)}</b><small>${esc(e.era||'Emergent history')} · ${esc(e.category)} · ${esc(e.actorId||'world')}</small></div></article>`).join(''):'<p>No canonical history matches this filter.</p>';}
 async function showWhy(id){const p=$('whyPanel');p.hidden=false;p.innerHTML='<span class="eyebrow">WHY?</span><p>Tracing canonical causes…</p>';try{if(String(id).startsWith('observer:')){const e=(state.world.history||[]).find(x=>x.eventId===id);p.innerHTML=`<span class="eyebrow">OBSERVER CLASSIFICATION</span><h3>${esc(e?.label||'Derived historical label')}</h3><p>${esc(e?.era||'')} ${e?.confidence!=null?`· confidence ${Math.round(e.confidence*100)}%`:''}</p><p>This label is descriptive. It never mutates world state.</p>${e?.payload?`<pre>${esc(JSON.stringify(e.payload,null,2))}</pre>`:''}<small>${(e?.causes||[]).length} canonical cause(s)</small>`;return}const d=await getJSON(`/api/v2/why/${encodeURIComponent(id)}`);p.innerHTML=`<span class="eyebrow">CANONICAL CAUSAL TRACE</span><h3>${esc(d.why.event.type)}</h3><p>World minute ${d.why.event.worldMinute} · actor ${esc(d.why.event.actorId)}</p><pre>${esc(JSON.stringify(d.why.event.payload,null,2))}</pre><small>${d.why.causes?.length||0} direct causal parent(s)</small>`;}catch(e){p.innerHTML=`<span class="eyebrow">WHY?</span><p>Trace unavailable: ${esc(e.message)}</p>`;}}
-function renderAll(){renderTop();renderActivity();renderInspector();if(!$('societyHistory').hidden)renderHistory();}
+function worldDuration(minutes){
+  const m=Math.max(0,Math.floor(Number(minutes)||0)),days=Math.floor(m/1440),hours=Math.floor((m%1440)/60);
+  return `${days}d ${hours}h`;
+}
+function currentOwnedCitizen(){
+  const id=state.myAvatar?.citizenId;
+  return id?state.world?.citizens?.find(c=>c.id===id)||null:null;
+}
+function renderMyAvatarStatus(){
+  const el=$('myAvatarStatus');if(!el)return;
+  if(!state.myAvatar?.authenticated){el.textContent='SIGN IN';el.dataset.state='guest';return;}
+  const c=currentOwnedCitizen();
+  if(!c){el.textContent='LINKED';el.dataset.state='linked';return;}
+  el.textContent=c.alive?'● ALIVE':'† DEAD';el.dataset.state=c.alive?'alive':'dead';
+}
+function avatarRecentEvents(c){
+  const rows=[...(state.world?.recentLedger||[]),...(state.world?.history||[])].filter(e=>e?.actorId===c.id);
+  const seen=new Set();
+  return rows.sort((a,b)=>Number(b.worldMinute||0)-Number(a.worldMinute||0)).filter(e=>{
+    const key=e.eventId||`${e.type}|${e.worldMinute}`;if(seen.has(key))return false;seen.add(key);return true;
+  }).slice(0,8);
+}
+function renderMyAvatar(){
+  const guest=$('avatarGuest'),dash=$('avatarDashboard');
+  if(!guest||!dash)return;
+  const linked=Boolean(state.myAvatar?.authenticated&&state.myAvatar?.citizenId);
+  guest.hidden=linked;dash.hidden=!linked;renderMyAvatarStatus();
+  if(!linked)return;
+  const c=currentOwnedCitizen(),actor=state.myAvatar.actor||{};
+  if(!c){$('avatarIdentityName').textContent=actor.displayName||actor.githubLogin||'Linked Citizen';$('avatarIdentityStatus').textContent='Synchronizing canonical Citizen…';return;}
+  const img=$('avatarIdentityImage');
+  if(actor.avatarUrl){img.src=actor.avatarUrl;img.hidden=false;}else img.hidden=true;
+  $('avatarIdentityName').textContent=citizenName(c)||actor.displayName||actor.githubLogin||'My Citizen';
+  $('avatarIdentityStatus').textContent=`${c.kind} · ${c.alive?'ALIVE':'DEAD'} · embodied ${worldDuration(worldMinute(state.world)-Number(c.birthWorldMinute||0))} ago`;
+  const knowledgeCount=Array.isArray(c.knowledge)?c.knowledge.length:Number(c.knowledge?.count||0);
+  const vocabularyCount=Object.keys(c.language?.lexicon||{}).length;
+  const relationshipsCount=Object.keys(c.relationships||{}).length;
+  const possessionsCount=(c.possessions||[]).length;
+  $('avatarStats').innerHTML=`<div><b>${Math.round(c.body.health||0)}%</b><small>health</small></div><div><b>${knowledgeCount}</b><small>knowledge</small></div><div><b>${vocabularyCount}</b><small>words</small></div><div><b>${relationshipsCount}</b><small>relations</small></div>`;
+  const a=c.currentAction;
+  $('avatarNow').innerHTML=`<p><b>${esc(a?.type||'IDLE / THINKING')}</b> — ${esc(a?.purpose||'No public physical action recorded.')}</p><span class="tag">water ${Math.round(c.body.hydration||0)}%</span><span class="tag">energy ${Math.round(c.body.calories||0)}%</span><span class="tag">sleep ${Math.round(c.body.sleepPressure||0)}%</span><span class="tag">possessions ${possessionsCount}</span><p><small>Goal: ${esc(goalLabel(c.activeGoal))}</small></p>`;
+  $('avatarEvolution').innerHTML=`<div class="avatar-evolution-grid"><span><b>${knowledgeCount}</b><small>concepts learned</small></span><span><b>${vocabularyCount}</b><small>coined/shared words</small></span><span><b>${relationshipsCount}</b><small>known relationships</small></span><span><b>${possessionsCount}</b><small>possessions</small></span></div>`;
+  const events=avatarRecentEvents(c);
+  $('avatarTimeline').innerHTML=events.length?events.map(e=>`<div class="avatar-life-row"><span>${esc(dateLabel(e.worldMinute||0))}</span><b>${esc(e.label||e.type||'Canonical event')}</b></div>`).join(''):'<p>No recent public canonical events for this Citizen yet.</p>';
+}
+async function refreshMyAvatar({quiet=false}={}){
+  try{
+    const d=await getJSON('/api/v2/avatar',{
+      method:'POST',
+      headers:{'content-type':'application/json'},
+      body:'{}'
+    });
+
+    state.myAvatar={
+      authenticated:true,
+      citizenId:d.avatar?.citizenId||null,
+      actor:d.actor||{}
+    };
+
+    state.renderer?.setOwnedCitizen?.(state.myAvatar.citizenId);
+    renderMyAvatar();
+    renderTop();
+
+    return state.myAvatar;
+  }catch(error){
+    if(error.message==='401'){
+      state.myAvatar=null;
+      state.renderer?.setOwnedCitizen?.(null);
+      renderMyAvatar();
+      renderMyAvatarStatus();
+      return null;
+    }
+
+    if(!quiet)toast('Avatar link unavailable');
+    return null;
+  }
+}
+function locateMyAvatar({follow=false,inspect=false}={}){
+  const id=state.myAvatar?.citizenId;if(!id){toast('Sign in with GitHub first');return false;}
+  const ok=state.renderer?.locateCitizen?.(id,{follow});
+  if(!ok){toast(currentOwnedCitizen()?.alive===false?'Your Citizen is dead':'Avatar position unavailable');return false;}
+  if(inspect){state.selected=id;state.renderer.setSelected(id);renderInspector();}
+  toast(follow?'Following your Citizen':'Located your Citizen');return true;
+}
+function renderAll(){renderTop();renderActivity();renderInspector();renderMyAvatar();if(!$('societyHistory').hidden)renderHistory();}
 function createSocket({onWorld,onOpen,onClose,onError}){const url=new URL('/api/v2/stream',location.href);url.protocol=location.protocol==='https:'?'wss:':'ws:';const ws=new WebSocket(url);ws.onopen=onOpen;ws.onmessage=e=>{try{const m=JSON.parse(e.data);if(m.state)onWorld(m.state);}catch(error){onError(error);}};ws.onclose=onClose;ws.onerror=e=>onError(e);return ws;}
 function toast(text){const d=document.createElement('div');d.className='toast';d.textContent=text;$('toastLayer').append(d);setTimeout(()=>d.remove(),3200);}
 async function sendIntent(){const intent=$('humanIntent').value.trim();if(!intent)return;const feedback=$('agentFeedback');feedback.textContent='Sending direction through the epistemic boundary…';try{const d=await getJSON('/api/v2/intent',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify({intent})});feedback.textContent=d.ok?'Direction queued. Your avatar still decides and can fail.':'Direction rejected.';toast('Avatar direction queued');}catch(e){feedback.textContent=e.message==='401'?'Sign in with GitHub first.':`Unavailable: ${e.message}`;}}
 function toggleFullscreen(){document.fullscreenElement?document.exitFullscreen?.():$('game').requestFullscreen?.();}
 function closeWindows(){let closed=false;for(const id of ['societyHistory','agentWindow']){const el=$(id);if(el&&!el.hidden){el.hidden=true;closed=true;}}$('whyPanel').hidden=true;if(!closed&&state.selected){state.selected=null;state.renderer.setSelected(null);renderInspector();}else if(!closed&&state.renderer.follow)state.renderer.setFollow(null);}
 function isTyping(el){return ['INPUT','TEXTAREA','SELECT'].includes(el?.tagName)||el?.isContentEditable;}
-function wire(){const canvas=$('worldCanvas');canvas.addEventListener('worldselect',e=>{state.selected=e.detail.id;state.renderer.setSelected(state.selected);renderInspector();});canvas.addEventListener('dblclick',()=>state.renderer.center());document.addEventListener('click',e=>{const c=e.target.closest('[data-citizen]');if(c){state.selected=c.dataset.citizen;state.renderer.setSelected(state.selected);renderInspector();}const h=e.target.closest('[data-event]');if(h)showWhy(h.dataset.event);const why=e.target.closest('[data-why-action]');if(why)showWhy(why.dataset.whyAction);});$('closeInspector').onclick=()=>{state.selected=null;state.renderer.setSelected(null);renderInspector();};$('toggleRail').onclick=()=>$('activityRail').classList.toggle('collapsed');$('historyOpen').onclick=()=>{$('societyHistory').hidden=false;renderHistory();};$('historyClose').onclick=()=>{$('societyHistory').hidden=true;$('whyPanel').hidden=true;};$('historySearch').oninput=renderHistory;$('historyCategory').onchange=renderHistory;$('agentOpen').onclick=()=>$('agentWindow').hidden=false;$('agentClose').onclick=()=>$('agentWindow').hidden=true;$('sendIntent').onclick=sendIntent;$('centerWorld').onclick=()=>state.renderer.center();$('fitPopulation').onclick=()=>{const ok=state.renderer.fitPopulation();toast(ok?'Framing all living Citizens':'No living Citizens to frame');};$('followSelected').onclick=()=>{state.renderer.setFollow(state.selected);toast(state.selected?'Following selected Citizen':'Select a Citizen first');};$('overlayKnowledge').onclick=()=>state.renderer.toggleOverlay('knowledge');$('overlayRelations').onclick=()=>state.renderer.toggleOverlay('relations');$('fullscreenWorld').onclick=toggleFullscreen;document.addEventListener('keydown',e=>{if(isTyping(e.target)){if(e.key==='Escape')e.target.blur();return}const k=e.key.toLowerCase();if(['arrowup','arrowdown','arrowleft','arrowright','w','a','s','d'].includes(k)){state.keys.add(k);e.preventDefault();}if(k==='f'){toggleFullscreen();e.preventDefault();}else if(k==='escape')closeWindows();else if(k==='h'){$('societyHistory').hidden=!$('societyHistory').hidden;if(!$('societyHistory').hidden)renderHistory();}else if(k==='c')state.renderer.center();else if(k==='v'){state.renderer.fitPopulation();e.preventDefault();}else if(k==='+'||k==='=')state.renderer.zoomBy(1.12);else if(k==='-')state.renderer.zoomBy(.89);});document.addEventListener('keyup',e=>state.keys.delete(e.key.toLowerCase()));window.addEventListener('blur',()=>state.keys.clear());}
+function wire(){const canvas=$('worldCanvas');canvas.addEventListener('worldselect',e=>{state.selected=e.detail.id;state.renderer.setSelected(state.selected);renderInspector();});canvas.addEventListener('dblclick',()=>state.renderer.center());document.addEventListener('click',e=>{const c=e.target.closest('[data-citizen]');if(c){state.selected=c.dataset.citizen;state.renderer.setSelected(state.selected);renderInspector();}const h=e.target.closest('[data-event]');if(h)showWhy(h.dataset.event);const why=e.target.closest('[data-why-action]');if(why)showWhy(why.dataset.whyAction);});$('closeInspector').onclick=()=>{state.selected=null;state.renderer.setSelected(null);renderInspector();};$('toggleRail').onclick=()=>$('activityRail').classList.toggle('collapsed');$('historyOpen').onclick=()=>{$('societyHistory').hidden=false;renderHistory();};$('historyClose').onclick=()=>{$('societyHistory').hidden=true;$('whyPanel').hidden=true;};$('historySearch').oninput=renderHistory;$('historyCategory').onchange=renderHistory;$('agentOpen').onclick=async()=>{$('agentWindow').hidden=false;await refreshMyAvatar({quiet:true});renderMyAvatar();};$('agentClose').onclick=()=>$('agentWindow').hidden=true;$('avatarLocate').onclick=()=>locateMyAvatar();$('avatarFollow').onclick=()=>locateMyAvatar({follow:true});$('avatarInspect').onclick=()=>locateMyAvatar({inspect:true});$('sendIntent').onclick=sendIntent;$('centerWorld').onclick=()=>state.renderer.center();$('fitPopulation').onclick=()=>{const ok=state.renderer.fitPopulation();toast(ok?'Framing all living Citizens':'No living Citizens to frame');};$('followSelected').onclick=()=>{state.renderer.setFollow(state.selected);toast(state.selected?'Following selected Citizen':'Select a Citizen first');};$('overlayKnowledge').onclick=()=>state.renderer.toggleOverlay('knowledge');$('overlayRelations').onclick=()=>state.renderer.toggleOverlay('relations');$('fullscreenWorld').onclick=toggleFullscreen;document.addEventListener('keydown',e=>{if(isTyping(e.target)){if(e.key==='Escape')e.target.blur();return}const k=e.key.toLowerCase();if(['arrowup','arrowdown','arrowleft','arrowright','w','a','s','d'].includes(k)){state.keys.add(k);e.preventDefault();}if(k==='f'){toggleFullscreen();e.preventDefault();}else if(k==='escape')closeWindows();else if(k==='h'){$('societyHistory').hidden=!$('societyHistory').hidden;if(!$('societyHistory').hidden)renderHistory();}else if(k==='c')state.renderer.center();else if(k==='v'){state.renderer.fitPopulation();e.preventDefault();}else if(k==='+'||k==='=')state.renderer.zoomBy(1.12);else if(k==='-')state.renderer.zoomBy(.89);});document.addEventListener('keyup',e=>state.keys.delete(e.key.toLowerCase()));window.addEventListener('blur',()=>state.keys.clear());}
 function frame(now){const dt=Math.min(.05,(now-state.lastFrame)/1000||.016);state.lastFrame=now;const speed=260*dt;if(state.keys.has('w')||state.keys.has('arrowup'))state.renderer.panBy(0,speed);if(state.keys.has('s')||state.keys.has('arrowdown'))state.renderer.panBy(0,-speed);if(state.keys.has('a')||state.keys.has('arrowleft'))state.renderer.panBy(speed,0);if(state.keys.has('d')||state.keys.has('arrowright'))state.renderer.panBy(-speed,0);state.renderer.draw();if(now-state.lastHud>300){state.lastHud=now;renderTop();if(!$('inspector').hidden)renderInspector();}requestAnimationFrame(frame);}
 function installTestHooks(){window.render_game_to_text=()=>{if(!state.world)return JSON.stringify({status:'loading'});const w=state.world;return JSON.stringify({mode:state.mode,worldMinute:worldMinute(w),selectedId:state.selected,citizens:w.citizens.filter(c=>c.alive).map(c=>{const p=citizenPosition(c,w);return{id:c.id,x:Number(p.x.toFixed(3)),y:Number(p.y.toFixed(3)),action:c.currentAction?.type||null};}),structures:(w.buildings||[]).length,projects:(w.projects||[]).filter(p=>p.status==='construction').length});};}
 async function boot(){
@@ -53,6 +138,10 @@ async function boot(){
   // Rendering must never depend on network availability.
   requestAnimationFrame(frame);
 
+  // Session ownership is resolved before the first canonical state fetch so
+  // an authenticated user's idempotent HUMAN_LINKED embodiment is visible immediately.
+  await refreshMyAvatar({quiet:true});
+
   state.connection=new ObserverConnection({
     fetchState:async()=>{
       const d=await getJSON('/api/v2/state');
diff --git a/tests/test_sovereign_avatar_observer_upgrade.mjs b/tests/test_sovereign_avatar_observer_upgrade.mjs
new file mode 100644
index 0000000..36c13fa
--- /dev/null
+++ b/tests/test_sovereign_avatar_observer_upgrade.mjs
@@ -0,0 +1,134 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import {createSovereignGenesis} from '../world/genesis.js';
+import {createHumanAvatar} from '../world/engine.js';
+
+const read=p=>fs.readFileSync(new URL(`../${p}`,import.meta.url),'utf8');
+
+test('human avatar embodiment is idempotent and population distinguishes embodiment from living count',()=>{
+  const world=createSovereignGenesis({seed:31,realEpochMs:0});
+
+  const reserve=world.reserves.observerEmbodimentKg;
+
+  const a=createHumanAvatar(
+    world,
+    {externalId:'github:owner-1',displayName:'Owner'},
+    0
+  );
+
+  const afterFirst=world.reserves.observerEmbodimentKg;
+
+  const b=createHumanAvatar(
+    world,
+    {externalId:'github:owner-1',displayName:'Owner'},
+    10
+  );
+
+  assert.equal(a.id,b.id);
+  assert.equal(world.citizens.length,101);
+  assert.equal(afterFirst,world.reserves.observerEmbodimentKg);
+  assert.ok(afterFirst<reserve);
+});
+
+test('session-backed POST avatar endpoint automatically ensures ownership without requiring an intent',()=>{
+  const api=read('functions/api/v2/[[path]].js');
+  const worker=read('worker/src/index.js');
+
+  assert.ok(
+    api.includes("request.method==='POST'&&p==='/avatar'")
+  );
+
+  assert.equal(
+    api.includes("request.method==='GET'&&p==='/avatar'"),
+    false
+  );
+
+  assert.match(api,/requireActor\(request,env\)/);
+  assert.ok(api.includes("path:'/avatar'"));
+  assert.ok(api.includes('authenticated:true'));
+
+  assert.match(
+    worker,
+    /const existing=this\.world\.citizens\.find\(c=>c\.externalId===externalId\)/
+  );
+
+  assert.match(worker,/created:!existing/);
+  assert.match(worker,/if\(!existing\)\{/);
+});
+
+test('Observer exposes owned-avatar marker, locate/follow controls and personal evolution panel',()=>{
+  const html=read('site/index.html');
+  const js=read('site/sovereign-world.js');
+  const renderer=read('site/sovereign-renderer.js');
+  const pixi=read('site/pixi-observer.js');
+
+  assert.match(html,/id="myAvatarStatus"/);
+  assert.match(html,/id="avatarDashboard"/);
+
+  for(const id of [
+    'avatarLocate',
+    'avatarFollow',
+    'avatarInspect',
+    'avatarEvolution',
+    'avatarTimeline'
+  ]){
+    assert.match(html,new RegExp(`id="${id}"`));
+  }
+
+  assert.match(js,/refreshMyAvatar/);
+  assert.match(js,/renderMyAvatar/);
+
+  assert.ok(
+    js.includes(
+      "LIVING · ${embodied} TOTAL · ${human} HUMAN · ${visibility.visible} VISIBLE"
+    )
+  );
+
+  assert.match(
+    js,
+    /getJSON\('\/api\/v2\/avatar',\{/
+  );
+
+  assert.match(renderer,/setOwnedCitizen/);
+  assert.match(renderer,/locateCitizen/);
+  assert.match(pixi,/ownedCitizenId/);
+  assert.match(pixi,/'YOU'/);
+});
+
+test('public HUMAN_LINKED state remains privacy-minimal',()=>{
+  const engine=read('world/engine.js');
+  const js=read('site/sovereign-world.js');
+
+  assert.match(
+    engine,
+    /c\.kind==='HUMAN_LINKED'\?\{count:c\.knowledge\.filter/
+  );
+
+  const start=engine.indexOf('export function publicWorld');
+
+  assert.ok(
+    start>=0,
+    'publicWorld must exist'
+  );
+
+  const next=engine.indexOf(
+    '\nexport function ',
+    start+'export function publicWorld'.length
+  );
+
+  const publicBlock=engine.slice(
+    start,
+    next>=0?next:engine.length
+  );
+
+  assert.doesNotMatch(
+    publicBlock,
+    /privateHumanIntents/
+  );
+
+  assert.match(js,/knowledgeCount/);
+  assert.match(js,/vocabularyCount/);
+  assert.match(js,/relationshipsCount/);
+  assert.match(js,/possessionsCount/);
+});
diff --git a/worker/src/index.js b/worker/src/index.js
index a84524a..326fe56 100644
--- a/worker/src/index.js
+++ b/worker/src/index.js
@@ -426,9 +426,14 @@ export class SovereignWorld {
     if(request.method==='POST'&&path==='/avatar'){
       const body=await request.json();
       if(!body?.actor?.id)return json({ok:false,error:'actor_required'},400);
-      const c=createHumanAvatar(this.world,{externalId:`github:${body.actor.github_id||body.actor.id}`,displayName:body.actor.display_name||body.actor.github_login||null},this.world.clock.worldMinute);
-      await this.persist({forceSeal:true});
-      return json({ok:true,citizenId:c.id});
+      const externalId=`github:${body.actor.github_id||body.actor.id}`;
+      const existing=this.world.citizens.find(c=>c.externalId===externalId);
+      const c=existing||createHumanAvatar(this.world,{externalId,displayName:body.actor.display_name||body.actor.github_login||null},this.world.clock.worldMinute);
+      if(!existing){
+        await this.persist({forceSeal:true});
+        this.broadcast({type:'world_delta',state:publicWorld(this.world,Date.now())});
+      }
+      return json({ok:true,citizenId:c.id,created:!existing});
     }
     if(request.method==='POST'&&path==='/intent'){
       const body=await request.json();