@atmem/architect 0.2.0-alpha.4.1 → 0.2.1

package/src/final-package.mjs

@@ -0,0 +1,34 @@
+import{unzipSync,zipSync,strToU8,strFromU8}from'fflate';
+const safe=name=>name&&!name.startsWith('/')&&!name.includes('\\')&&!name.split('/').some(p=>p==='..'||p==='.')&&!name.includes('\0');
+function attributes(bytes){
+ const view=new DataView(bytes.buffer,bytes.byteOffset,bytes.byteLength);let end=bytes.length-22;
+ while(end>=Math.max(0,bytes.length-65557)&&view.getUint32(end,true)!==0x06054b50)end--;
+ if(end<0||end+22+view.getUint16(end+20,true)!==bytes.length||view.getUint16(end+4,true)||view.getUint16(end+6,true))throw Error('Unsupported package directory.');
+ const result=new Map(),count=view.getUint16(end+10,true);let offset=view.getUint32(end+16,true);
+ for(let i=0;i<count;i++){
+  if(offset+46>end||view.getUint32(offset,true)!==0x02014b50)throw Error('Invalid package directory.');
+  const length=view.getUint16(offset+28,true),extra=view.getUint16(offset+30,true),comment=view.getUint16(offset+32,true);
+  if(offset+46+length+extra+comment>end)throw Error('Invalid package entry.');
+  const name=strFromU8(bytes.subarray(offset+46,offset+46+length));if(!safe(name)||result.has(name))throw Error('Unsafe or duplicate package entry.');
+  result.set(name,{os:view.getUint16(offset+4,true)>>>8,attrs:view.getUint32(offset+38,true)});offset+=46+length+extra+comment;
+ }
+ if(offset!==end)throw Error('Package directory does not match its receipt.');return result;
+}
+export async function completeProjectZip(verified,design){
+ if(!design?.files)throw Error('Wait for the design documents to finish preparing.');
+ const bytes=new Uint8Array(await verified.arrayBuffer()),attrs=attributes(bytes);let expanded=0;
+ const original=unzipSync(bytes,{filter:entry=>{expanded+=entry.originalSize;if(expanded>150000000)throw Error('Package exceeds its receiving limit.');return true;}});
+ const output=Object.fromEntries(Object.entries(original).map(([name,data])=>[name,[data,attrs.get(name)]]));
+ const documents={};for(const[name,value]of Object.entries(design.files)){
+  if(!safe(name))throw Error('Invalid design document path.');
+  const target='design-documents/'+name;if(output[target])throw Error('Design documents conflict with captured files.');
+  const content=typeof value==='string'?strToU8(value):value;expanded+=content.byteLength;if(expanded>150000000)throw Error('Combined package exceeds its receiving limit.');
+  output[target]=[content,{os:3,attrs:0o100644<<16}];documents[target]=content;
+ }
+ const hash=async data=>[...new Uint8Array(await crypto.subtle.digest('SHA-256',data))].map(b=>b.toString(16).padStart(2,'0')).join('');
+ const manifest={version:1,designRevision:design.manifest.designRevision,sourceArtifactPreserved:'evidence/original-implementation.zip',documents:await Promise.all(Object.entries(documents).map(async([path,data])=>({path,bytes:data.byteLength,sha256:await hash(data)})))};
+ output['package-contents.json']=strToU8(JSON.stringify(manifest,null,2));
+ const readme=strFromU8(original['START_HERE.md']||new Uint8Array());
+ output['START_HERE.md']=strToU8('# Open this project\n\nUnzip this package, then open this folder as a project in Orca or your editor. Read this file and the implementation README before running commands.\n\n- implementation/: captured application, infrastructure and tests.\n- design-documents/: requirements, Spec Kit, diagram, cost assumptions and generated design references.\n- evidence/: captured source ZIP and recorded checks.\n\nDesign references are not proof that changed requirements were implemented.\n\n'+readme);
+ return new Blob([zipSync(output)],{type:'application/zip'});
+}

package/src/journey-workspace.css

@@ -70,3 +70,42 @@
 }
 
 .chat-width-toggle{display:none}@media(min-width:901px){.chat-width-toggle{display:inline-flex;margin-left:auto;padding:5px 8px}}
+
+.review-costs,.review-generation{padding:20px;border:1px solid var(--line);border-radius:16px;background:var(--paper);margin:16px 0}
+.review-costs>.doc{padding:0}.review-costs h2,.review-generation h2{font-size:1.25rem;margin-top:0}
+.review-finish{display:flex;align-items:center;justify-content:space-between;gap:20px;padding:20px 0;border-top:1px solid var(--line)}
+.review-finish p{margin:5px 0;color:var(--muted);font-size:.9rem}.review-finish>.btn{flex-shrink:0}
+.chat-working-status{display:flex;align-items:center;gap:10px;padding:12px 16px;border-top:1px solid var(--line);background:var(--paper);font-size:.9rem}
+.chat-working-status .brain-activity{flex-shrink:0}.generation-status{display:flex;gap:8px;align-items:center}
+.engineering-panel .generation-conversation{max-height:none;overflow:visible}.engineering-panel .generation-conversation[open]>.engineering-conversation{max-height:300px;overflow:auto}
+.review-generation .engineering-panel textarea{min-height:72px}.review-generation .engineering-actions{display:block}
+@media(max-width:650px){.review-finish{align-items:stretch;flex-direction:column}.review-finish>.btn{width:100%}}
+.chat-jump-latest{position:absolute;right:24px;bottom:230px;z-index:40;border:1px solid var(--line);border-radius:50%;background:var(--paper);color:var(--ink);box-shadow:0 3px 12px #0002;width:40px;height:40px;font-size:24px;cursor:pointer}
+.project-checks{padding:20px;border:1px solid var(--line);border-radius:16px;background:var(--paper);margin:16px 0}.section-action{display:flex;align-items:center;gap:8px}.section-action h3{margin:0}.section-action>.btn{margin-left:auto}
+.check-rows,.final-checklist ul{padding:0;list-style:none}.check-rows li,.final-checklist li{display:flex;align-items:center;gap:12px;padding:10px 0;border-bottom:1px solid var(--line);font-size:.9rem}.check-rows strong,.final-checklist strong{margin-left:auto;font-size:.85rem}.check-complete{color:#217143}.check-pending{color:#946000}.final-checklist{margin:20px 0}.final-checklist li>span:first-child{width:24px;height:24px;display:grid;place-items:center;border:1px solid currentColor;border-radius:50%;flex-shrink:0}
+[data-theme=dark] .check-complete{color:#80d6a2}[data-theme=dark] .check-pending{color:#f0c575}
+.project-checks pre{max-height:300px;overflow:auto;white-space:pre-wrap}.delivery-state{font-weight:600}
+.message-list>.msg{border-top:1px solid var(--line);padding-top:14px;margin-top:14px}.message-meta{display:flex;align-items:center;justify-content:space-between;gap:12px;font-size:.75rem;color:var(--muted);margin-bottom:6px}.message-meta time{font-variant-numeric:tabular-nums}
+.memory-modal{width:min(1280px,96vw)!important;max-width:1280px!important;height:min(88vh,1000px);overflow:auto}.memory-panel{width:100%}
+.file-tree{min-width:0;overflow:auto;border-right:1px solid var(--line);padding:8px 0;max-height:650px;background:var(--paper)}.file-tree ul{list-style:none;padding:0;margin:0}.file-tree button{display:flex;align-items:center;gap:5px;width:100%;min-height:30px;text-align:left;background:transparent;color:var(--ink);border:0;border-radius:0;font:inherit;font-size:.8rem;cursor:pointer;white-space:nowrap}.file-tree button:hover{background:var(--accent-soft)}.file-tree button.selected{background:var(--accent-soft);box-shadow:inset 2px 0 var(--accent)}.file-tree button>svg{flex-shrink:0}.tree-indent{width:13px;flex-shrink:0}.file-tree button>span:last-child{overflow:hidden;text-overflow:ellipsis}
+.concise-answer{min-width:0}.message-details{display:inline-flex;align-items:center;min-height:32px;padding:2px 0;text-decoration:underline;text-underline-offset:3px;cursor:pointer;font-size:.85rem}
+
+
+.final-checklist li{padding:0}.final-checklist li>button{display:flex;align-items:center;gap:12px;width:100%;padding:12px 4px;border:0;border-radius:6px;background:transparent;color:var(--ink);font:inherit;text-align:left;cursor:pointer}.final-checklist li>button:hover,.final-checklist li>button:focus-visible{background:var(--accent-soft);outline:2px solid var(--ink);outline-offset:-2px}.final-checklist button>span:first-child{width:24px;height:24px;display:grid;place-items:center;border:1px solid currentColor;border-radius:50%;flex-shrink:0}.checklist-arrow{font-size:1.15em}
+
+.inline-note{display:block;max-width:100%;margin:6px 0 10px;line-height:1.5;color:var(--muted);overflow-wrap:anywhere}
+
+.cost-size-selector .btn{display:inline-flex;align-items:center;gap:6px}.cost-size-selector .btn[aria-pressed="true"]{font-weight:600}.cost-selection-status{font-size:.9rem;color:var(--muted)}
+
+.cost-heading{display:flex;align-items:center;justify-content:space-between;gap:12px}.cost-heading h2{margin:0}.cost-heading>.btn{flex-shrink:0}
+
+.memory-heading{display:flex;align-items:center;justify-content:space-between;gap:12px}.memory-heading h2,.memory-heading h3{margin:0}.memory-profile-bar{display:flex;align-items:center;gap:12px;flex-wrap:wrap;padding:12px 0;border-bottom:1px solid var(--line);margin-bottom:12px}.memory-profile-bar label{display:flex;align-items:center;gap:8px}.memory-profile-bar input{max-width:190px}.memory-profile-bar code{font-size:.72rem;overflow-wrap:anywhere}.memory-state{margin-left:auto}.memory-toolbar{display:flex;gap:10px;align-items:center;margin:16px 0 10px}.memory-toolbar input{flex:1;min-width:100px}.memory-toolbar strong{white-space:nowrap;font-size:.85rem}.memory-table-wrap{max-height:50vh;overflow:auto;border:1px solid var(--line);border-radius:10px}.memory-table{width:100%;border-collapse:collapse;font-size:.8rem;table-layout:fixed}.memory-table th{position:sticky;top:0;background:var(--paper);z-index:1;font-weight:600;text-align:left}.memory-table td,.memory-table th{padding:10px 12px;border-bottom:1px solid var(--line);vertical-align:top;overflow-wrap:anywhere}.memory-table th:first-child{width:20%}.memory-table th:nth-child(2){width:35%}.memory-table th:last-child{width:60px}.memory-table td:nth-child(5){font-variant-numeric:tabular-nums;font-size:.73rem}.memory-content{display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden;border:0;padding:0;background:none;color:var(--ink);font:inherit;text-align:left;cursor:pointer}.memory-table .link{padding:0;font:inherit;text-align:left;overflow-wrap:anywhere}.memory-badge{font-size:.72rem;border-radius:20px;padding:3px 6px;background:var(--board)}.memory-badge.active{color:#21633a;background:#e8f4eb}.memory-pagination{display:flex;align-items:center;justify-content:flex-end;gap:10px;padding:12px 0}.memory-pagination>span{margin-right:auto;font-size:.8rem}.memory-preference-form{display:flex;gap:10px;flex-wrap:wrap;padding:12px 0}.memory-preference-form input{flex:1;min-width:140px}.memory-record-detail{padding:16px;border:1px solid var(--line);border-radius:10px;margin:12px 0}.memory-record-detail dl{display:grid;grid-template-columns:140px 1fr;gap:8px;font-size:.8rem}.memory-record-detail dd{margin:0;overflow-wrap:anywhere}.memory-record-detail p{white-space:pre-wrap}.memory-feedback{display:flex;align-items:center;gap:6px;font-size:.8rem;margin:8px 0}.memory-empty{padding:32px;text-align:center;color:var(--muted)}.memory-table-wrap[aria-busy=true]{opacity:.65}.memory-preview{padding:16px;border:1px solid var(--line);border-radius:10px}.memory-preview .btn{margin-right:8px}@media(max-width:700px){.memory-table{min-width:800px}.memory-profile-bar code{font-size:.65rem}.memory-record-detail dl{grid-template-columns:1fr}.memory-toolbar{flex-wrap:wrap}}
+
+.memory-modal{height:auto!important;max-height:88vh!important}.memory-profile-bar input,.memory-toolbar input,.memory-toolbar select,.memory-preference-form input,.memory-preference-form select{font:inherit;font-size:.85rem;min-height:36px;box-sizing:border-box;padding:7px 10px;border:1px solid var(--line);border-radius:8px;background:var(--paper);color:var(--ink)}.memory-table th:last-child{width:84px;white-space:nowrap}.memory-table td:last-child{white-space:nowrap}.memory-table th:nth-child(4){width:90px}.memory-table th:nth-child(5){width:130px}.memory-table th:nth-child(3){width:84px}.memory-toolbar>strong{color:var(--muted);font-weight:500}.memory-pagination .btn{min-height:32px}.memory-record-detail .memory-table{table-layout:auto}.memory-table .memory-content:hover{text-decoration:underline;text-underline-offset:3px}
+
+.location-region-form{display:flex;align-items:flex-end;gap:12px}.location-region-form label{display:flex;flex-direction:column;gap:6px}.location-region-form input{font:inherit;padding:9px 12px;border:1px solid var(--line);border-radius:8px;background:var(--paper);color:var(--ink)}
+
+.final-checklist li>button:not(:disabled),.final-checklist li>button:not(:disabled) *{cursor:pointer}.final-checklist[aria-busy="true"] li>button,.final-checklist[aria-busy="true"] li>button *{cursor:wait}.final-checklist li>button:disabled{opacity:1}.checklist-label{display:flex;flex-direction:column;gap:4px;min-width:0}.checklist-label small{font-size:.75rem;color:var(--muted);font-weight:400;overflow-wrap:anywhere}.checklist-loading{font-size:.85rem;color:var(--muted)}
+.star-prompt{width:min(460px,calc(100vw - 32px));max-width:460px;border:1px solid var(--line);border-radius:16px;padding:22px;background:var(--paper);color:var(--ink);box-shadow:0 18px 60px #0003}.star-prompt::backdrop{background:#0005}.star-prompt header,.star-prompt h2,.star-prompt-actions{display:flex;align-items:center;gap:10px}.star-prompt header{justify-content:space-between}.star-prompt h2{font-size:1.2rem}.star-prompt h2>svg{color:var(--accent);fill:var(--accent-soft)}.star-prompt p{margin:18px 0;line-height:1.5}.star-prompt-actions>a{flex:1;text-decoration:none}.star-prompt-actions>button{min-width:90px}
+
+.check-run-action{display:inline-flex;margin-left:12px;flex-shrink:0}.check-run-action>button:disabled{pointer-events:none}.check-run-action:focus-visible{outline:2px solid var(--accent);outline-offset:3px}

package/src/journey.mjs

@@ -20,7 +20,7 @@ export function completedStages(p){
  return {board:p.nodes.some(n=>n.data.kind!=='note'),scope:saved.scope===keys.scope,
  cloud:cloudMapping(p).ready&&saved.architecture===keys.architecture,
  review:saved.review===keys.architecture&&saved.estimate===keys.estimate,
- delivery:false}; // A visit/download alone never proves successful delivery.
+ delivery:saved.delivery===keys.delivery}; // Delivery means the exact package was downloaded, not deployed.
 }
 export function journeyAction(guidance,section='board'){
  if(section===journeySectionId(guidance.id)&&guidance.checkpoint&&section!=='board')return {kind:'continue',label:guidance.continueLabel};
@@ -42,7 +42,7 @@ const snapshot=value=>{const text=JSON.stringify(value);let a=2166136261,b=5381;
 export function journeyKeys(p){
  const scope=snapshot([p.brief?.application||p.requirements||'',(p.needs||[]).filter(r=>r.source==='user').map(r=>[r.id,r.statement,r.measure]).sort()]);
  const architecture=snapshot([scope,p.nodes.filter(n=>n.data.kind!=='note').map(n=>[n.id,n.data.label,n.data.service,n.data.provider,n.data.config,n.data.description]).sort(),p.edges.map(e=>[e.source,e.target,e.label]).sort(),choice(p,'platform.cloud'),choice(p,'cloud.region'),choice(p,'data.country')]);
- return {scope,architecture,estimate:snapshot([architecture,p.estimate||{}])};
+ const estimate=snapshot([architecture,p.estimate||{}]);return {scope,architecture,estimate,delivery:snapshot([architecture,estimate,p.revision])};
 }
 export function cloudMapping(p){
  const provider=choice(p,'platform.cloud');
@@ -85,3 +85,13 @@ export function advanceJourney(p,checkpoint){
  const key=checkpoint==='review'?'architecture':checkpoint;
  return {...p,extensions:{...p.extensions,journey:{...p.extensions?.journey,[checkpoint]:state.keys[key]}}};
 }
+
+// Explicit completion actions acknowledge a working draft; navigation never does.
+export function acknowledgeStage(p,stage){
+ const keys=journeyKeys(p),previous=p.extensions?.journey||{},saved={...previous};
+ if(stage==='scope'&&(p.needs?.length||p.brief?.application?.trim()))saved.scope=keys.scope;
+ if(stage==='cloud'&&cloudMapping(p).ready)saved.architecture=keys.architecture;
+ if(stage==='review')saved.review=keys.architecture;
+ if(stage==='delivery')saved.delivery=keys.delivery;
+ return {...p,extensions:{...p.extensions,journey:saved}};
+}

package/src/large-request.mjs

@@ -0,0 +1,25 @@
+// Preserve the entire JSON payload; chunk transport changes no project content.
+export async function postLargeJson(url,payload,{token,signal,onProgress,fetcher=fetch}={}){
+ const data=new TextEncoder().encode(JSON.stringify(payload));
+ if(data.length>64*1024*1024)throw Error('Project exceeds the 64 MiB validation upload limit.');
+ const post=async(path,value,requestSignal=signal)=>{
+  const response=await fetcher(path,{method:'POST',headers:{'Content-Type':'application/json',Authorization:`Bearer ${token}`},body:JSON.stringify(value),signal:requestSignal});
+  const result=await response.json();if(!response.ok)throw Error(result.detail||'Validation request could not start.');return result;
+ };
+ if(data.length<=192000)return post(url,payload);
+ const sha256=[...new Uint8Array(await crypto.subtle.digest('SHA-256',data))].map(x=>x.toString(16).padStart(2,'0')).join('');
+ const {uploadId,chunkBytes}=await post('/api/terraform/uploads/start',{bytes:data.length,sha256});
+ try{
+  if(chunkBytes!==131072)throw Error('The upload service returned an unsupported chunk size.');
+  for(let offset=0,index=0;offset<data.length;offset+=chunkBytes,index++){
+   const chunk=data.subarray(offset,offset+chunkBytes);let text='';
+   for(let i=0;i<chunk.length;i+=8192)text+=String.fromCharCode(...chunk.subarray(i,i+8192));
+   await post('/api/terraform/uploads/chunk',{uploadId,index,data:btoa(text)});
+   onProgress?.(Math.round(Math.min(offset+chunkBytes,data.length)/data.length*100));
+  }
+  onProgress?.(null);
+  return await post(url+'-upload',{uploadId});
+ }finally{
+  await post('/api/terraform/uploads/cancel',{uploadId},AbortSignal.timeout(5000)).catch(()=>{});
+ }
+}