@atmem/architect 0.2.0 → 0.2.2

package/server/memory-requirements.lock

@@ -1,14 +1,14 @@
 # This file was autogenerated by uv via the following command:
 #    uv pip compile --universal --python-version 3.13 server/memory-requirements.txt --generate-hashes --output-file server/memory-requirements.lock
-atflows==0.1.4 \
-    --hash=sha256:2ada812488a9f22368975936fbafdcbe066a147bc88ae949213fef3724ce5261 \
-    --hash=sha256:d277f0aba85cbc82229cefd2aeb87b81548e4cd1f0276f2c8b4c758ecec4b36b
+atflows==0.1.8 \
+    --hash=sha256:9819783a615d8eb21ac70adc826627f707c4072d2a67f0efe2b173b06405477f \
+    --hash=sha256:fe07f07f2710e4603bd29e10b2a29cb3192f9b8e7426418da7604b88fe0e4cbc
     # via
     #   -r server/memory-requirements.txt
     #   atmem
-atmem==2.3.10 \
-    --hash=sha256:e89f27ed6d9624cc4cb4e6d59286b48e53e430d2f2019737973488c3d43956cc \
-    --hash=sha256:f2e152ea2e710759fcb145cef34a33af5e173e0ef883aa2d75a5c01692a57c36
+atmem==2.3.14 \
+    --hash=sha256:37597be588817aa2dad921a683b39b6e6417eb5bdf3ec23256655acf13b19a03 \
+    --hash=sha256:e70c4baab2e41375aee6cc7d31066d2e5b9fca324d2e086649d2cabbee34708d
     # via -r server/memory-requirements.txt
 atmem-atbot==0.1.1 \
     --hash=sha256:0b47efeda0ca46c4f3bcaa6ce4adabf7b5094841d788f3cfee783d668a6a03d1 \

package/server/memory-requirements.txt

@@ -1,6 +1,6 @@
-atmem==2.3.10
+atmem==2.3.14
 atmem-atbot==0.1.1
-atflows==0.1.4
+atflows==0.1.8
 cryptography==48.0.1
 cffi==2.1.1
 pycparser==3.12

package/server/memory_service.py

@@ -46,6 +46,7 @@ class MemoryService:
         self.worker = str(worker or setting('MEMORY_PYTHON') or ROOT / '.memory-venv' / ('Scripts/python.exe' if os.name == 'nt' else 'bin/python'))
         self.lock = threading.RLock()
         self.error = None
+        self.engine_version = None
         with self.db() as db:
             db.executescript('''
               CREATE TABLE IF NOT EXISTS identity (id TEXT PRIMARY KEY);
@@ -107,6 +108,7 @@ class MemoryService:
         if result.returncode or 'error' in payload:
             raise RuntimeError('AtMem rejected the operation (' + payload.get('error', 'worker failed') + ')')
         self.error = None
+        self.engine_version = payload.get('version')
         return payload['results']
 
     def enqueue(self, project, scope, key, text, event_id=None, source=''):
@@ -192,7 +194,7 @@ class MemoryService:
     def status(self, project):
         with self.db() as db:
             counts = dict(db.execute('SELECT state,count(*) FROM queue WHERE project=? GROUP BY state', (project,)).fetchall())
-        return {'enabled': self.enabled(project), 'status': 'disabled' if not self.enabled(project) else 'unavailable' if self.error else 'ready', 'pending': counts.get('pending', 0), 'rejected': counts.get('rejected', 0), 'engine': 'AtMem 2.3.10 core SDK', 'policy': 'AtMem AI Architect single-user scope and opt-out policy', 'detail': self.error}
+        return {'enabled': self.enabled(project), 'status': 'disabled' if not self.enabled(project) else 'unavailable' if self.error else 'ready', 'pending': counts.get('pending', 0), 'rejected': counts.get('rejected', 0), 'engine': f'AtMem {self.engine_version} core SDK' if self.engine_version else 'AtMem core SDK (not checked)', 'policy': 'AtMem AI Architect single-user scope and opt-out policy', 'detail': self.error}
 
     def profile(self, project, field, value):
         if field not in {'explanation', 'experience', 'iac', 'preferences'} or not value.strip() or len(value) > 1000:

package/server/memory_worker.py

@@ -5,6 +5,8 @@ import sqlite3
 import base64
 import re
 from importlib.metadata import version
+from pathlib import Path
+EXPECTED_ATMEM_VERSION = re.search(r"^atmem==(\d+\.\d+\.\d+)$", (Path(__file__).parent / "memory-requirements.txt").read_text(), re.M).group(1)
 from atmem import Memory
 
 
@@ -62,8 +64,8 @@ def keyed_records(memory,subject,record_id,limit=10001):
 
 
 def run(payload):
-    if version('atmem') != '2.3.10':
-        raise RuntimeError('AtMem AI Architect requires the tested AtMem 2.3.10 runtime')
+    if version('atmem') != EXPECTED_ATMEM_VERSION:
+        raise RuntimeError(f'AtMem AI Architect requires the tested AtMem {EXPECTED_ATMEM_VERSION} runtime')
     memory = Memory(payload['database'], auto_vectors=False)
     receipts = sqlite3.connect(payload['database'] + '.receipts.sqlite')
     receipts.execute('CREATE TABLE IF NOT EXISTS receipts (id TEXT PRIMARY KEY, result TEXT)')

package/server/pricing.py

@@ -61,6 +61,9 @@ def storage_quote(provider,region):
     if provider=='aws':return {**aws_s3(region),'provider':'aws','available':True}
     if provider=='azure':return dict(_azure_storage(region,int(time.time()//3600)))
     if provider=='gcp':
+        if region=='us-central1':
+            try:return dict(_google_storage_public(region,int(time.time()//3600)))
+            except (ValueError,OSError):pass
         import os
         key=os.getenv('GOOGLE_CLOUD_BILLING_API_KEY')
         if key and re.fullmatch(r'[a-z]+-[a-z]+\d',region):
@@ -80,7 +83,7 @@ def storage_quote(provider,region):
                     price=rates[0]['unitPrice'];value=float(price.get('units',0))+float(price.get('nanos',0))/1e9
                     candidates.append({'available':True,'provider':'gcp','price':value,'currency':'USD','unit':'GiB-month','region':region,'service':'Google Cloud Storage Standard / '+sku['skuId'],'source':'Google Cloud Billing Catalog','url':'https://cloud.google.com/skus/?currency=USD','date':datetime.now(timezone.utc).date().isoformat(),'coverage':'Standard storage only; operations, replication and transfer excluded'})
             if len(candidates)==1:return candidates[0]
-        return {'available':False,'provider':'gcp','region':region,'sourceUrl':PROVIDER_PAGES[provider],'reason':'An exact regional storage SKU needs a configured Google Cloud Billing Catalog API key or a sourced quote. A generic/default-region web price will not be substituted.','nextQuestion':'Which Google Cloud region and storage class should we price?'}
+        return {'available':False,'provider':'gcp','region':region,'sourceUrl':PROVIDER_PAGES[provider],'reason':f'Storage pricing for {region or "the selected region"} could not be verified. Recalculate or enter a sourced rate.','nextQuestion':'Which Google Cloud region and storage class should we price?'}
     return {'available':False,'provider':'ibm','region':region,'sourceUrl':PROVIDER_PAGES[provider],'reason':'IBM pricing depends on region, storage class and plan. No verified regional quote is configured; no AWS or invented rate is substituted.','nextQuestion':'Which IBM region and storage class or existing IBM quote should we use?'}
 
 
@@ -188,3 +191,54 @@ def google_public_quote(service,region,planning_reference=False):
     if region!='us-central1' and not (planning_reference and (not region or re.search('select|unknown|tbd',region,re.I))):
         raise ValueError('This public quote supports Iowa only; the selected region is preserved.')
     return {**_google_public(service,int(time.time()//3600)),'planningReference':region!='us-central1'}
+
+
+def parse_google_storage_public(html, region, url):
+    """Read an explicitly selected single-region public table, never a region list match."""
+    import hashlib
+    from html.parser import HTMLParser
+    if region != 'us-central1':
+        raise ValueError('The public default storage table verifies Iowa only.')
+    marker = 'id="data-storage"'
+    if marker not in html:
+        raise ValueError('Google data storage section is missing.')
+    section = html[html.index(marker):]
+    # Stop before dual-region rates. Region options alone do not verify selected pricing.
+    boundary = re.search(r'<(?:p|h[1-6])[^>]*>\s*(?:<b>)?Dual-region(?:</b>)?\s*</', section)
+    if not boundary:
+        raise ValueError('The single-region storage boundary is missing.')
+    section = section[:boundary.start()]
+    class Selected(HTMLParser):
+        def __init__(self):super().__init__();self.regions=[]
+        def handle_starttag(self,tag,attrs):
+            a=dict(attrs)
+            if a.get('role')=='option' and a.get('aria-selected')=='true':self.regions.append(a.get('data-value'))
+    selected=Selected();selected.feed(section)
+    if selected.regions != ['Iowa (us-central1)']:
+        raise ValueError('The selected public storage region is not Iowa.')
+    table = re.search(r'<table\b[^>]*>.*?</table>', section, re.S)
+    rows = _public_rows(table.group(0)) if table else []
+    if len(rows)!=2 or rows[0].count('Standard storage')!=1:
+        raise ValueError('The Standard storage table could not be verified.')
+    index=rows[0].index('Standard storage')
+    if index>=len(rows[1]):raise ValueError('The storage price is missing.')
+    cell=rows[1][index]
+    rate=re.fullmatch(r'\$([0-9]+(?:\.[0-9]+)?) / 1 gibibyte hour(?:, per 1 month / account)?',cell)
+    if not rate or not 0<float(rate.group(1))<1:raise ValueError('Unexpected Google storage rate or unit.')
+    hourly=float(rate.group(1))
+    return {'available':True,'provider':'gcp','price':hourly*730,'currency':'USD',
+            'unit':'GiB-month','region':region,'service':'Cloud Storage Standard / single-region',
+            'source':'Google Cloud public pricing','url':url,
+            'date':datetime.now(timezone.utc).date().isoformat(),
+            'sourceSha256':hashlib.sha256(section.encode()).hexdigest(),
+            'hourlyPrice':hourly,'hoursPerMonth':730,
+            'coverage':'Single-region Standard storage; 730-hour planning month. Operations, replication, transfer, taxes and discounts excluded.'}
+
+
+@lru_cache(maxsize=32)
+def _google_storage_public(region,hour):
+    url='https://cloud.google.com/storage/pricing'
+    with urllib.request.urlopen(urllib.request.Request(url,headers={'User-Agent':'AtMem Architect pricing'}),timeout=12) as response:
+        raw=response.read(8_000_001)
+    if len(raw)>8_000_000:raise ValueError('Google storage page exceeds its size bound.')
+    return parse_google_storage_public(raw.decode('utf-8'),region,url)

package/server/request_uploads.py

@@ -0,0 +1,65 @@
+"""Bounded, temporary, ordered request assembly. Uploaded content is never executed."""
+import hashlib
+import secrets
+import tempfile
+import threading
+import time
+
+MAX_BYTES = 64 * 1024 * 1024
+CHUNK_BYTES = 128 * 1024
+
+
+class RequestUploads:
+    def __init__(self):
+        self.rows = {}
+        self.lock = threading.Lock()
+
+    def _expire(self):
+        for key, row in list(self.rows.items()):
+            if time.monotonic() - row['updated'] > 1800:
+                self.rows.pop(key)['file'].close()
+
+    def start(self, size, digest):
+        with self.lock:
+            self._expire()
+            if not 0 < size <= MAX_BYTES:
+                raise ValueError('Request exceeds the 64 MiB upload limit.')
+            if len(self.rows) >= 8 or sum(r['size'] for r in self.rows.values()) + size > 2 * MAX_BYTES:
+                raise ValueError('Upload capacity is busy. Retry after current uploads finish.')
+            key = secrets.token_hex(24)
+            self.rows[key] = dict(file=tempfile.TemporaryFile(), size=size, digest=digest,
+                                  received=0, index=0, updated=time.monotonic())
+            return {'uploadId': key, 'chunkBytes': CHUNK_BYTES}
+
+    def append(self, key, index, content):
+        with self.lock:
+            self._expire()
+            row = self.rows.get(key)
+            if row is None:
+                raise ValueError('Upload expired. Start validation again.')
+            if index != row['index'] or not 0 < len(content) <= CHUNK_BYTES or row['received'] + len(content) > row['size']:
+                raise ValueError('Upload chunk is out of order or exceeds its declared size.')
+            row['file'].write(content)
+            row.update(received=row['received'] + len(content), index=index + 1, updated=time.monotonic())
+            return {'receivedBytes': row['received']}
+
+    def take(self, key):
+        with self.lock:
+            self._expire()
+            row = self.rows.pop(key, None)
+            if row is None:
+                raise ValueError('Upload expired. Start validation again.')
+            try:
+                row['file'].seek(0)
+                data = row['file'].read()
+                if len(data) != row['size'] or hashlib.sha256(data).hexdigest() != row['digest']:
+                    raise ValueError('Upload is incomplete or its checksum changed. Retry validation.')
+                return data
+            finally:
+                row['file'].close()
+
+    def cancel(self, key):
+        with self.lock:
+            row = self.rows.pop(key, None)
+            if row:
+                row['file'].close()

package/server/terraform_routes.py

@@ -11,13 +11,49 @@ from pathlib import Path
 import shutil
 import subprocess
 import tempfile
+import base64
+import binascii
 from fastapi import APIRouter, HTTPException
-from pydantic import BaseModel, ConfigDict
+from pydantic import BaseModel, ConfigDict, Field, ValidationError
+from .request_uploads import RequestUploads, MAX_BYTES
 from typing import Literal
 
 router = APIRouter()
 LOCK = asyncio.Lock()
 ROOT = Path(__file__).resolve().parent.parent
+UPLOADS = RequestUploads()
+
+class UploadStart(BaseModel):
+    model_config = ConfigDict(extra='forbid')
+    bytes: int = Field(gt=0, le=MAX_BYTES, strict=True)
+    sha256: str = Field(pattern=r'^[a-f0-9]{64}$')
+
+class UploadId(BaseModel):
+    model_config = ConfigDict(extra='forbid')
+    uploadId: str = Field(pattern=r'^[a-f0-9]{48}$')
+
+class UploadChunk(UploadId):
+    index: int = Field(ge=0, strict=True)
+    data: str = Field(min_length=1, max_length=174764)
+
+@router.post('/api/terraform/uploads/start')
+async def upload_start(payload: UploadStart):
+    try:
+        return UPLOADS.start(payload.bytes, payload.sha256)
+    except ValueError as error:
+        raise HTTPException(409, str(error))
+
+@router.post('/api/terraform/uploads/chunk')
+async def upload_chunk(payload: UploadChunk):
+    try:
+        return UPLOADS.append(payload.uploadId, payload.index, base64.b64decode(payload.data, validate=True))
+    except (ValueError, binascii.Error) as error:
+        raise HTTPException(422, str(error))
+
+@router.post('/api/terraform/uploads/cancel')
+async def upload_cancel(payload: UploadId):
+    UPLOADS.cancel(payload.uploadId)
+    return {'cancelled': True}
 
 class ValidationRequest(BaseModel):
     model_config = ConfigDict(extra='forbid')
@@ -116,3 +152,13 @@ async def validate_route(payload: ValidationRequest):
             raise HTTPException(504, 'Terraform validation timed out. No deployment was attempted.')
         except (ValueError, OSError):
             raise HTTPException(422, 'Could not validate the generated Terraform draft. Check the project and local Terraform installation.')
+
+@router.post('/api/terraform/validate-upload')
+async def validate_upload(payload: UploadId):
+    if LOCK.locked():
+        raise HTTPException(409, 'A Terraform validation is already running.')
+    try:
+        request = ValidationRequest.model_validate_json(UPLOADS.take(payload.uploadId))
+    except (ValueError, ValidationError):
+        raise HTTPException(422, 'The upload is incomplete, changed, or is not a valid project validation request.')
+    return await validate_route(request)

package/src/EngineeringPanel.jsx

@@ -59,9 +59,14 @@ export function EngineeringPanel({projectId,session,connection,saveProject,onCon
     actionLock.current=true;setBusy(true);setError('');
     try{await operation();}catch(e){if(live.current)setError(e.message);}finally{actionLock.current=false;if(live.current)setBusy(false);}
   }
-  useEffect(()=>{onBusyChange?.(busy);return()=>onBusyChange?.(false);},[busy,onBusyChange]);
+  useEffect(()=>{onBusyChange?.(busy||loading||['running','starting'].includes(job?.state));return()=>onBusyChange?.(false);},[busy,loading,job?.state,onBusyChange]);
   const exactSelection=connection?.provider==='codex'&&connection.model&&connection.model!=='default'&&connection.effort;
   const running=job?.state==='running',uncertain=job?.state==='starting';
+  const lastProgress=events.filter(event=>event.runId===job?.run&&['progress','message'].includes(event.kind)).at(-1);
+  const [lastReceived,setLastReceived]=useState(null),[now,setNow]=useState(Date.now());
+  useEffect(()=>{if(lastProgress){const time=Date.now();setLastReceived(time);setNow(time);}},[lastProgress?.sequence]);
+  useEffect(()=>{if(!running&&!uncertain)return;const timer=setInterval(()=>setNow(Date.now()),1000);return()=>clearInterval(timer);},[running,uncertain]);
+  const activity=lastProgress?.kind==='message'?'Preparing an update':({reasoning:'Thinking through the implementation',fileChange:'Updating project files',commandExecution:'Running a development command',mcpToolCall:'Using a development tool',webSearch:'Checking documentation'}[lastProgress?.text]||'Generating project files');
   const conversation=engineeringConversation(events);
   const hasDesign=hasArchitectureDesign(project),canSubmit=running?!!draft.trim():!!buildIntent(project,draft);
   const consumedBuild=useRef(null);
@@ -112,7 +117,9 @@ export function EngineeringPanel({projectId,session,connection,saveProject,onCon
     {restoreBlocked&&<button disabled={loading||busy} onClick={()=>{setError('');setRestoreAttempt(value=>value+1);}}>Retry loading earlier work</button>}
     {loading?<p role="status">Finding your project’s work…</p>:<>
       {job?<>
-        <p className="generation-status" role="status">{(running||uncertain||busy)&&<BrainActivity size={24}/>} {running?'Working':uncertain?'Recovering acceptance of your last request':job.last_status?({completed:'Work completed',interrupted:'Work stopped',failed:'Work needs attention'}[job.last_status]||job.last_status):'Ready'} · {job.model} · {job.effort}</p>
+        {(running||uncertain)&&<div className="generation-progress" role="progressbar" aria-label="Project generation" aria-valuetext={activity}><span/></div>}
+        {(running||uncertain)&&<p className="generation-activity" role="status">{activity}{lastReceived&&<> · Last update received {Math.max(0,Math.floor((now-lastReceived)/1000))}s ago</>}</p>}
+        <p className="generation-status" role="status">{(running||uncertain||busy)&&<BrainActivity size={24}/>} {running?'Working':uncertain?'Recovering acceptance of your last request':finalization?.kind==='finalization_needs_attention'?'Files generated · Checks need attention':job.last_status?({completed:'Work completed',interrupted:'Work stopped',failed:'Work needs attention'}[job.last_status]||job.last_status):'Ready'} · {job.model} · {job.effort}</p>
 
       </>:<>
         <p>{exactSelection?`${connection.model} · ${connection.effort}`:'Choose a Codex model and reasoning level to start.'}</p>
@@ -133,14 +140,14 @@ export function EngineeringPanel({projectId,session,connection,saveProject,onCon
           {running&&<button disabled={busy} onClick={()=>act(async()=>{const next=await call('interrupt');if(live.current)setJob(next);})}>Stop work</button>}
           {!running&&!uncertain&&job.last_status&&<button disabled={busy} onClick={()=>act(async()=>{const captured=await call('capture');if(live.current)setArtifact(captured);})}>Refresh package snapshot</button>}
         </details>
-        <details><summary>Engineering progress ({events.length})</summary><ol>{events.filter(event=>!['message','accepted','steering_submitted'].includes(event.kind)).map(event=><li key={event.sequence}>{event.kind}{event.text?` · ${event.text}`:''}</li>)}</ol></details>
+        <details><summary>Engineering progress (<span key={events.length} className={`engineering-progress-count${running||uncertain?' updated':''}`}>{events.length}</span>)</summary><ol>{events.filter(event=>!['message','accepted','steering_submitted'].includes(event.kind)).map(event=><li key={event.sequence}>{event.kind}{event.text?` · ${event.text}`:''}</li>)}</ol></details>
       </>}
-      {artifact&&<div className="engineering-artifact"><p>Project files · {artifact.files.filter(file=>file.kind==='file').length} {artifact.files.filter(file=>file.kind==='file').length===1?'file':'files'} · {artifact.turnStatus}.</p>
-        {artifact.runId!==job?.run&&<p>Earlier package · regenerate for current changes.</p>}
+      {artifact&&<div className="engineering-artifact"><p>{artifact.runId!==job?.run||running||uncertain?'Previous files':'Project files'} · {artifact.files.filter(file=>file.kind==='file').length} {artifact.files.filter(file=>file.kind==='file').length===1?'file':'files'}</p>
+        {artifact.runId!==job?.run&&<p>{running||uncertain?'Generating updated files…':'Generate updated files to include your changes.'}</p>}
         {onDelivery&&<button disabled={busy} onClick={onDelivery}>Review and download handoff</button>}
 
-        <p className="muted small" role="status">{mappingStatus||'File links pending.'}</p>
-        {mappingStatus==='File links missing from package.'&&<button disabled={busy||contextBusy} onClick={()=>submitIntent(null,'Add architecture-work-proposal.json binding the existing implementation files to the saved design blocks and requirements. Preserve the application and requirements. Run applicable local checks; retain failed or unexecuted checks explicitly.')}>Repair file links</button>}
+        {onWorkModelChange&&<p className="muted small" role="status">{running||uncertain?'File links update when generation finishes.':artifact.runId!==job?.run?'File links belong to the previous snapshot.':mappingStatus||'Connecting files to design blocks…'}</p>}
+        {!running&&!uncertain&&artifact.runId===job?.run&&mappingStatus==='File links missing from package.'&&<button disabled={busy||contextBusy} onClick={()=>submitIntent(null,'Add architecture-work-proposal.json binding the existing implementation files to the saved design blocks and requirements. Preserve the application and requirements. Run applicable local checks; retain failed or unexecuted checks explicitly.')}>Repair file links</button>}
 
 
       </div>}

package/src/FinalChecklist.jsx

@@ -1,15 +1,23 @@
-import React from'react';
+import React,{useState,useRef} from'react';
+import{BrainActivity}from'./BrainActivity.jsx';
 import{estimate}from'./estimate.mjs';
 import{cloudMapping}from'./journey.mjs';
 import{OPTION_NAMES}from'./pack.mjs';
 export function FinalChecklist({project,implementation,terraform,checks=[],onNavigate}){
+ const [opening,setOpening]=useState(null),[error,setError]=useState('');const navigating=useRef(false);
+ async function open(name,target){if(navigating.current||!onNavigate)return;navigating.current=true;setError('');setOpening(name);
+  try{await onNavigate(target);}catch(e){setError(e.message||'Could not open that section. Try again.');}finally{navigating.current=false;setOpening(null);}
+ }
  const cost=estimate(project),mapping=cloudMapping(project),requirements=!!(project.needs?.length||project.brief?.application);
  const selectedRegion=[...(project.decisions||[])].reverse().find(d=>d.subject==='cloud.region'&&d.status==='Accepted')?.decision;
  const country=[...(project.decisions||[])].reverse().find(d=>d.subject==='data.country'&&d.status==='Accepted')?.decision;
  const proposed=project.nodes.filter(n=>n.data.kind!=='note'&&n.data.origin!=='existing');
  const placements=proposed.map(n=>n.data.config?.region).filter(r=>typeof r==='string'&&r.trim()&&!/select|unknown|tbd/i.test(r));
  const region=selectedRegion||(proposed.length&&placements.length===proposed.length?[...new Set(placements)].join(', '):null);
- const rows=[['Requirements',requirements?'Recorded':'Not recorded',requirements],['Cloud',mapping.provider?(OPTION_NAMES[mapping.provider]||mapping.provider):'Not selected',!!mapping.provider],['Data country',country||'Not selected',!!country],['Cloud region',region||'Choose region',!!region],['Cost estimate',cost.complete?'Calculated':cost.lines.some(l=>l.cost!=null)?'Partial · charges missing':'Not calculated',cost.complete],['Implementation',implementation?'Included':'Not generated',!!implementation],['Application checks',checks.length?checks.every(c=>c.state==='finished'&&c.result?.status==='passed')?'Passed':'Needs attention':'Not run',checks.length>0&&checks.every(c=>c.state==='finished'&&c.result?.status==='passed')],['Terraform checks',terraform?.status==='passed'?'Passed':terraform?.status==='failed'?'Failed':terraform?.status==='incomplete'?'Incomplete':'Not run',terraform?.status==='passed']];
+ const hasEstimate=cost.expected!==null&&!cost.mixedCurrencies;
+ const excluded=new Set([...cost.lines.filter(line=>line.cost==null).map(line=>line.component),...cost.notCosted]).size;
+ const costReason=hasEstimate&&excluded?`${excluded} items excluded · View breakdown`:'';
+ const rows=[['Requirements',requirements?'Recorded':'Not recorded',requirements],['Cloud',mapping.provider?(OPTION_NAMES[mapping.provider]||mapping.provider):'Not selected',!!mapping.provider],['Data country',country||'Not selected',!!country],['Cloud region',region||'Choose region',!!region],['Cost estimate',hasEstimate?'Estimated':cost.mixedCurrencies?'Choose one currency':'Not estimated',hasEstimate],['Implementation',implementation?'Included':'Not generated',!!implementation],['Application checks',checks.length?checks.every(c=>c.state==='finished'&&c.result?.status==='passed')?'Passed':'Needs attention':'Not run',checks.length>0&&checks.every(c=>c.state==='finished'&&c.result?.status==='passed')],['Terraform checks',terraform?.status==='passed'?'Passed':terraform?.status==='failed'?'Failed':terraform?.status==='incomplete'?'Incomplete':'Not run',terraform?.status==='passed']];
  const targets=['requirements','location','location','location','cost','implementation','checks','checks'];
- return <section className="final-checklist" aria-label="Final checklist"><h3>Final checklist</h3><ul>{rows.map(([name,status,complete],index)=><li key={name}><button type="button" onClick={()=>onNavigate?.(targets[index])} aria-label={`${name}: ${status}. Open ${name}`}><span className={complete?'check-complete':'check-pending'} aria-label={complete?'Complete':'Needs attention'}>{complete?'✓':'!'}</span><span>{name}</span><strong>{status}</strong><span className="checklist-arrow" aria-hidden="true">→</span></button></li>)}</ul></section>;
+ return <section className="final-checklist" aria-label="Final checklist" aria-busy={!!opening}><h3>Final checklist</h3><ul>{rows.map(([name,status,complete],index)=><li key={name}><button type="button" onClick={()=>open(name,targets[index])} disabled={!!opening||!onNavigate} aria-label={`${name}: ${status}. Open ${name}`}><span className={complete?'check-complete':'check-pending'} aria-label={name==='Cost estimate'&&hasEstimate?'Estimate available':complete?'Complete':'Needs attention'}>{complete?'✓':'!'}</span><span className="checklist-label">{name}{name==='Cost estimate'&&costReason&&<small>{costReason}</small>}</span><strong>{opening===name?<>Opening… <BrainActivity/></>:status}</strong><span className="checklist-arrow" aria-hidden="true">→</span></button></li>)}</ul>{opening&&<p role="status" className="checklist-loading">Opening {opening}…</p>}{error&&<p role="alert">{error}</p>}</section>;
 }

package/src/ImplementationDelivery.jsx

@@ -2,12 +2,13 @@ import {unzipSync,zipSync,strToU8} from 'fflate';
 import {FinalChecklist} from './FinalChecklist.jsx';
 import {BrainActivity} from './BrainActivity.jsx';
 import {completeProjectZip} from './final-package.mjs';
-import React,{useEffect,useState} from 'react';
+import React,{useEffect,useState,useRef} from 'react';
 import {engineeringCall,verifiedHandoffDownload} from './engineering-client.mjs';
 import {ArtifactChecks} from './ArtifactChecks.jsx';
 
 export function ImplementationDelivery({project,session,onBuild,onSave,contextBusy=false,designBundle,onDesignDownload,onDownloaded,checkReceipt,onExplore,onNavigate}){
  const [orcaResult,setOrcaResult]=useState(null);
+ const projectRef=useRef(project);projectRef.current=project;
  const [prepared,setPrepared]=useState(null),[preparing,setPreparing]=useState(false);
  const [loaded,setLoaded]=useState(null),[error,setError]=useState(''),[retry,setRetry]=useState(0),[busy,setBusy]=useState(false);
  const report=loaded?.project===project?loaded.report:null;
@@ -23,9 +24,8 @@ export function ImplementationDelivery({project,session,onBuild,onSave,contextBu
   let stopped=false;const controller=new AbortController();setPreparing(true);setError('');
   (async()=>{try{
     const captured=await verifiedHandoffDownload(session,{projectId:project.id,sessionId:report.session.id,artifactId:report.artifact.id,savedDesignSha256:report.savedDesignSha256},report.artifact,{signal:controller.signal});
-    const blob=await completeProjectZip(captured,designBundle);
-    const files=unzipSync(new Uint8Array(await blob.arrayBuffer()));
-    if(!stopped){setPrepared({artifactId:report.artifact.id,designSha256:report.savedDesignSha256,blob});onExplore?.({project,files});}
+    const files={...unzipSync(new Uint8Array(await captured.arrayBuffer())),...Object.fromEntries(Object.entries(designBundle.files).map(([name,value])=>['design-documents/'+name,typeof value==='string'?strToU8(value):value]))};
+    if(!stopped){setPrepared({artifactId:report.artifact.id,designSha256:report.savedDesignSha256});onExplore?.({project,files});}
   }catch(e){if(!stopped&&e.name!=='AbortError')setError(e.message);}finally{if(!stopped)setPreparing(false);}})();
   return()=>{stopped=true;controller.abort();};
  },[report?.artifact?.id,report?.savedDesignSha256,designBundle,project,session.token,retry]);
@@ -34,11 +34,12 @@ export function ImplementationDelivery({project,session,onBuild,onSave,contextBu
   const zipBase64=await new Promise((resolve,reject)=>{const reader=new FileReader();reader.onload=()=>resolve(reader.result.split(',')[1]);reader.onerror=()=>reject(Error('Could not prepare the project ZIP.'));reader.readAsDataURL(blob);});
   const result=await engineeringCall(session,'orca/open',{projectId:project.id,zipBase64});setOrcaResult(result);if(!result.opened)throw Error(result.message);
  }
+ async function downloadDesign(){if(busy||contextBusy)return;setBusy(true);setError('');try{await onDesignDownload?.(designBundle);}catch(error){setError(error.message);}finally{setBusy(false);}}
  async function openOrca(){
   if(busy||contextBusy)return;
   setOrcaResult(null);
   if(report?.artifact)return download(true);
-  setBusy(true);setError('');try{if(!designBundle||designBundle.project!==project)throw Error('Project files are still preparing.');if(onSave)await onSave(project);await launchOrca(new Blob([zipSync(Object.fromEntries(Object.entries(designBundle.files).map(([name,value])=>[name,typeof value==='string'?strToU8(value):value])))]));}catch(error){setError(error.message);}finally{setBusy(false);}
+  setBusy(true);setError('');try{if(!designBundle||designBundle.project!==project)throw Error('Project files are still preparing.');if(onSave)await onSave(project);const full=await(designBundle.prepare?.()||designBundle);if(projectRef.current!==project)throw Error('Design changed while preparing files. Try again.');await launchOrca(new Blob([zipSync(Object.fromEntries(Object.entries(full.files).map(([name,value])=>[name,typeof value==='string'?strToU8(value):value])))]));}catch(error){setError(error.message);}finally{setBusy(false);}
  }
  async function download(openInOrca=false){
   if(!report?.artifact||busy||contextBusy)return;
@@ -59,7 +60,9 @@ export function ImplementationDelivery({project,session,onBuild,onSave,contextBu
    const payload={projectId:project.id,sessionId:current.session.id,artifactId:current.artifact.id};
    const captured=await verifiedHandoffDownload(session,{...payload,savedDesignSha256:current.savedDesignSha256},current.artifact);
    if(designBundle?.project!==project)throw Error('The design documents are refreshing. Try downloading again when preparation finishes.');
-   const blob=await completeProjectZip(captured,designBundle);
+   const full=await(designBundle.prepare?.()||designBundle);
+   if(projectRef.current!==project)throw Error('Design changed while preparing files. Try again.');
+   const blob=await completeProjectZip(captured,full);
    if(openInOrca){await launchOrca(blob);return;}
    const url=URL.createObjectURL(blob),link=document.createElement('a');link.href=url;
    link.download=`architect-handoff-${report.artifact.id}.zip`;link.click();onDownloaded?.();setTimeout(()=>URL.revokeObjectURL(url),1000);
@@ -69,7 +72,7 @@ export function ImplementationDelivery({project,session,onBuild,onSave,contextBu
   <h3>Your project ZIP</h3>
   {!report&&!error&&<p role="status">Preparing package…</p>}
   {report&&!report.artifact&&<p>Design package · implementation not generated.</p>}
-  {report&&!report.canPackage&&<button className="btn primary" disabled={!designBundle||designBundle.project!==project||contextBusy} onClick={()=>onDesignDownload?.(designBundle)}>Download project ZIP</button>}
+  {report&&!report.canPackage&&<button className="btn primary" disabled={busy||!designBundle||designBundle.project!==project||contextBusy} onClick={downloadDesign}>{busy?'Preparing ZIP…':'Download project ZIP'}</button>}
   {report?.artifact&&<>
    <p className="delivery-state">{report.relation==='matches_saved_design'?'✓ Current design':report.relation==='design_changed'?'! Design changed since generation':'! Earlier or unverified implementation'}</p>
 

package/src/JourneyViews.jsx

@@ -92,7 +92,7 @@ export function ReviewView({ project, findings, onChange, onOpen, onAddRequireme
   );
 }
 
-export function EstimateView({ project, result, onChange, onEstimate, busy=false, pricing, onNext }) {
+export function EstimateView({ project, result, onChange, onEstimate, busy=false, pricing, onNext, onChooseRegion }) {
   const e = result;
   return (
     <section className="doc" aria-label="Estimate">
@@ -104,7 +104,7 @@ export function EstimateView({ project, result, onChange, onEstimate, busy=false
         <div className="row">{PROJECT_SIZES.map(size=><button type="button" className={project.estimate?.projectSize===size.id?"btn primary":"btn"} key={size.id} aria-pressed={project.estimate?.projectSize===size.id} onClick={()=>{if(project.estimate?.projectSize===size.id)return;const next=setProjectSize(project,size.id);onChange(next);onEstimate?.(next);}}>{project.estimate?.projectSize===size.id&&<Check size={16} aria-hidden="true"/>}{size.label}</button>)}</div>
         <details className="cost-assumptions"><summary>Planning assumptions</summary><p className="muted small">Small: 10,000 requests / 10 GB; Medium: 100,000 / 100 GB; Large: 1 million / 1 TB; Extra Large: 10 million / 10 TB per month. Existing usage figures take priority. Model assumptions: 3,000 tokens per request and 730 endpoint hours; training usage needs separate agreement.</p></details>
       </fieldset>
-      {project.estimate?.projectSize&&<p className="cost-selection-status" role="status">{PROJECT_SIZES.find(size=>size.id===project.estimate.projectSize)?.label} · {pricing?.busy?'Updating prices…':e.complete?'Estimate ready':e.lines.some(line=>line.cost!=null)?'Partial estimate':'Prices unavailable'}</p>}{pricing?.errors?.map((error,i)=><p className="warn-text" key={i}>{error.component&&`${error.component}: `}{error.reason} <button className="link" disabled={busy||pricing?.busy} onClick={()=>onEstimate?.(project)}>Retry pricing</button></p>)}
+      {project.estimate?.projectSize&&<p className="cost-selection-status" role="status">{PROJECT_SIZES.find(size=>size.id===project.estimate.projectSize)?.label} · {pricing?.busy?'Updating prices…':e.expected!==null?'Estimate ready':'Prices unavailable'}</p>}{pricing?.errors?.map((error,i)=><p className={e.expected!==null?"muted small":"warn-text"} key={i}>{error.component&&`${error.component}: `}{error.reason} <button className="link" disabled={busy||pricing?.busy} onClick={()=>error.action==='choose-region'?onChooseRegion?.():onEstimate?.(project)}>{error.action==='choose-region'?'Choose region':'Retry pricing'}</button></p>)}
 
       <div className="totals">
         <div>
@@ -119,8 +119,8 @@ export function EstimateView({ project, result, onChange, onEstimate, busy=false
         </div>
         <div>
           <small className="muted">Status</small>
-          <span className={e.complete ? "ok-text" : "warn-text"}>
-            {e.complete ? "All entered charges estimated" : e.mixedCurrencies ? "Currency needs review" : "Partial estimate · see exclusions"}
+          <span className={e.mixedCurrencies ? "warn-text" : e.expected!==null ? "" : "muted"}>
+            {e.mixedCurrencies ? "Choose one currency" : e.expected!==null ? "Planning estimate" : "Not estimated"}
           </span>
         </div>
         {e.budget && (

package/src/OpenAIVoicePanel.jsx

@@ -4,10 +4,11 @@ import {BrainActivity} from './BrainActivity.jsx';
 import React,{useEffect,useRef,useState} from 'react';
 import {OpenAIVoice} from './openai-voice.mjs';
 
-export function OpenAIVoicePanel({session,connection,transportRef,onTranscript,onStart,onConnections}){
+export function OpenAIVoicePanel({hideTrigger=false,openRequest=0,session,connection,transportRef,onTranscript,onStart,onConnections}){
  const [status,setStatus]=useState(null),[phase,setPhase]=useState('off'),[error,setError]=useState(''),[key,setKey]=useState(''),[saving,setSaving]=useState(false),[automatic,setAutomatic]=useState(false),[readReplies,setReadReplies]=useState(true),[open,setOpen]=useState(false);
  const props=useRef({onTranscript,onStart,automatic});props.current={onTranscript,onStart,automatic};
  const engine=useRef(null),live=useRef(true);
+ useEffect(()=>{if(openRequest>0)setOpen(true);},[openRequest]);
  const active=!['off','error'].includes(phase);
  async function refresh(){
   const response=await fetch('/api/voice/openai/status');
@@ -39,7 +40,7 @@ export function OpenAIVoicePanel({session,connection,transportRef,onTranscript,o
  }
  const caption={off:'Off',connecting:'Connecting OpenAI audio…',listening:automatic?'Listening · auto-send':'Listening',speaking:'Speaking',error:'Stopped · retry'}[phase];
  return <>
-  <div className="voice-status"><button type="button" className="icon" aria-label="Voice settings" title="Voice settings" onClick={()=>setOpen(true)}><Volume2 size={18}/></button>{active&&<button type="button" onClick={()=>engine.current?.stop({preservePending:true})}>Stop voice</button>}{active&&error.includes('playback')&&<button type="button" onClick={()=>void engine.current?.resumeAudio()}>Enable voice playback</button>}{(active||error)&&<span role="status">{error||caption}</span>}</div>
+  <div className="voice-status">{!hideTrigger&&<button type="button" className="icon" aria-label="Voice settings" title="Voice settings" onClick={()=>setOpen(true)}><Volume2 size={18}/></button>}{active&&<button type="button" onClick={()=>engine.current?.stop({preservePending:true})}>Stop voice</button>}{active&&error.includes('playback')&&<button type="button" onClick={()=>void engine.current?.resumeAudio()}>Enable voice playback</button>}{(active||error)&&<span role="status">{error||caption}</span>}</div>
   {open&&<div className="backdrop" onMouseDown={event=>{if(event.target===event.currentTarget)setOpen(false)}}><section className="modal" role="dialog" aria-modal="true" aria-label="OpenAI voice" onKeyDown={event=>{if(event.key==='Escape'){event.stopPropagation();setOpen(false)}}}>
   <h2>Voice</h2><button type="button" className="icon modal-close" aria-label="Close voice settings" onClick={()=>setOpen(false)}><X size={18}/></button>
   <section aria-label="OpenAI voice settings">

package/src/OutputsView.jsx

@@ -1,8 +1,10 @@
+import {ReadyExampleChecklist} from './ReadyExample.jsx';
+import {isReadyExample} from './ready-example.mjs';
 import {FileTree} from './FileTree.jsx';
 import {strFromU8} from 'fflate';
 import {CodePreview} from './CodePreview.jsx';
 import {BrainActivity} from "./BrainActivity.jsx";
-import React,{useEffect,useState} from 'react';
+import React,{useEffect,useState,useRef,useMemo} from 'react';
 import {EmulationPanel} from './EmulationPanel.jsx';
 import {outputBundle} from './output-bundle.mjs';
 import {ImplementationDelivery} from './ImplementationDelivery.jsx';
@@ -37,24 +39,31 @@ function Preview({name,content}){
 }
 export function OutputsView({project,run,environment,session,onDownload,onBack,emulation,onDiscuss,discussionBusy,onBuild,onSave,onDownloaded,onReview,checkReceipt,onNavigate}){
  const [exploration,setExploration]=useState(null);
+ const projectRef=useRef(project);projectRef.current=project;
+ const [packing,setPacking]=useState(false);
  const [bundle,setBundle]=useState(null),[error,setError]=useState(''),[loading,setLoading]=useState(true),[retry,setRetry]=useState(0),[selected,setSelected]=useState('spec-kit/implementation-spec.md');
  useEffect(()=>{
    let active=true;setLoading(true);setError('');
-   outputBundle(project,run,environment,checkReceipt).then(value=>{if(active){setBundle(value);setLoading(false);}}).catch(e=>{if(active){setError(e.message);setLoading(false);}});
+   outputBundle(project,run,environment,checkReceipt,{deferVisuals:true}).then(value=>{if(active){setBundle(value);setLoading(false);}}).catch(e=>{if(active){setError(e.message);setLoading(false);}});
    return ()=>{active=false;};
  },[project,run,environment,retry,checkReceipt]);
  const readiness=bundle?.files['spec-kit/readiness.json']?JSON.parse(bundle.files['spec-kit/readiness.json']):null;
- const fileValues=exploration?.project===project?exploration.files:bundle?.files||{};
- const selectedPath=fileValues[selected]!==undefined?selected:fileValues['START_HERE.md']?'START_HERE.md':Object.keys(fileValues).find(name=>name.endsWith('implementation-spec.md'))||Object.keys(fileValues)[0];
- const raw=fileValues[selectedPath],content=typeof raw==='string'?raw:raw&&/\.(?:md|txt|json|py|js|mjs|tf|sh|yaml|yml|toml|html|css)$/.test(selectedPath)?strFromU8(raw):raw;
+ const artifactMode=exploration?.project===project,prefix=artifactMode?'design-documents/':'';
+ const fileValues=useMemo(()=>artifactMode?{...exploration.files,...Object.fromEntries(Object.entries(bundle?.files||{}).map(([name,value])=>[prefix+name,value]))}:bundle?.files||{},[artifactMode,exploration,bundle,prefix]);
+ const treeFiles=useMemo(()=>({...Object.fromEntries((bundle?.visualPaths||[]).map(path=>[prefix+path,null])),...fileValues}),[bundle,fileValues,prefix]);
+ async function selectFile(name){setSelected(name);if(treeFiles[name]===null){try{const full=await bundle.prepare();if(projectRef.current===project)setBundle(full);}catch(error){if(projectRef.current===project)setError(error.message);}}}
+ async function downloadDesign(){if(packing)return;setPacking(true);setError('');try{const full=await bundle.prepare();if(projectRef.current!==project)return;setBundle(full);await onDownload(full);}catch(error){if(projectRef.current===project)setError(error.message);}finally{setPacking(false);}}
+ const selectedPath=Object.hasOwn(treeFiles,selected)?selected:fileValues['START_HERE.md']?'START_HERE.md':Object.keys(fileValues).find(name=>name.endsWith('implementation-spec.md'))||Object.keys(fileValues)[0];
+ const raw=treeFiles[selectedPath],content=typeof raw==='string'?raw:raw&&/\.(?:md|txt|json|py|js|mjs|tf|sh|yaml|yml|toml|html|css)$/.test(selectedPath)?strFromU8(raw):raw;
 
  return <section className="doc outputs-view" aria-label="Outputs">
   <header className="doc-head"><h2>Delivery</h2></header>
   <button className="link" onClick={onReview||onBack}>Back to Review</button>
-  {session?.engineeringEnabled&&<ImplementationDelivery key={project.id} project={project} session={session} onBuild={onBuild} onSave={onSave} contextBusy={discussionBusy} designBundle={loading?null:bundle} onDesignDownload={onDownload} onDownloaded={onDownloaded} checkReceipt={checkReceipt} onExplore={setExploration} onNavigate={onNavigate}/>}
+  {isReadyExample(project)&&<ReadyExampleChecklist/>}
+  {session?.engineeringEnabled&&(isReadyExample(project)?<details><summary>Checks for your edited project</summary><ImplementationDelivery key={project.id} project={project} session={session} onBuild={onBuild} onSave={onSave} contextBusy={discussionBusy} designBundle={loading?null:bundle} onDesignDownload={onDownload} onDownloaded={onDownloaded} checkReceipt={checkReceipt} onExplore={setExploration} onNavigate={onNavigate}/></details>:<ImplementationDelivery key={project.id} project={project} session={session} onBuild={onBuild} onSave={onSave} contextBusy={discussionBusy} designBundle={loading?null:bundle} onDesignDownload={onDownload} onDownloaded={onDownloaded} checkReceipt={checkReceipt} onExplore={setExploration} onNavigate={onNavigate}/>)}
   <section aria-label="Project file explorer"><h3>Explore files</h3>
 
-  {!session?.engineeringEnabled&&<><p>Design package · no implementation generated.</p><button className="btn" disabled={!bundle||loading||!!error} onClick={()=>onDownload(bundle)}>Download project ZIP</button></>}
+  {!session?.engineeringEnabled&&<><p>Design package · no implementation generated.</p><button className="btn" disabled={!bundle||loading||!!error||packing} onClick={downloadDesign}>{packing?'Preparing ZIP…':'Download project ZIP'}</button></>}
 
   {loading&&<p role="status"><BrainActivity/> Preparing the current outputs…</p>}
   {error&&<div role="alert"><p>{error}</p><button className="btn" onClick={()=>setRetry(n=>n+1)}>Retry preparing outputs</button></div>}
@@ -62,8 +71,8 @@ export function OutputsView({project,run,environment,session,onDownload,onBack,e
    <p className="muted small">r{bundle.manifest.designRevision} · {Object.keys(bundle.files).length} design files</p>
    {readiness&&<details><summary>Remaining work</summary><aside aria-label="Handoff readiness"><strong>Engineering handoff — decisions and implementation remain</strong><p>{readiness.counts.priorityDecisions} priority decisions · {readiness.counts.generatedFoundations} generated foundations / {readiness.counts.components} logical components</p><p>Next: {readiness.nextAction}</p><button className="link" onClick={()=>setSelected('spec-kit/readiness.md')}>Review handoff gaps</button></aside></details>}
    <div className="outputs-browser" data-snapshot-id={bundle.manifest.snapshotId}>
-    <FileTree files={fileValues} selected={selectedPath} onSelect={setSelected}/>
-    <div className="output-preview" aria-label="Output preview"><h3>{selectedPath}</h3>{content!==undefined&&(typeof content==='string'||/\.(?:pdf|png|svg)$/.test(selectedPath)?<Preview key={selectedPath} name={selectedPath} content={content}/>:<p>{content.byteLength} bytes</p>)}</div>
+    <FileTree files={treeFiles} selected={selectedPath} onSelect={selectFile}/>
+    <div className="output-preview" aria-label="Output preview"><h3>{selectedPath}</h3>{raw===null?<p role="status"><BrainActivity/> Preparing preview…</p>:content!==undefined&&(typeof content==='string'||/\.(?:pdf|png|svg)$/.test(selectedPath)?<Preview key={selectedPath} name={selectedPath} content={content}/>:<p>{content.byteLength} bytes</p>)}</div>
    </div>
   </>}
   </section>