@atmem/architect 0.0.0-stage → 0.2.0

package/src/CodePreview.jsx

@@ -0,0 +1,8 @@
+import React from 'react';
+// React escapes every token; previews never inject HTML or execute source.
+export function CodePreview({content,name='',className=''}){
+ const source=typeof content==='string'?content:String(content);
+ const pattern=/("(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|\/\/[^\n]*|#[^\n]*|\b(?:true|false|null|resource|variable|output|provider|terraform|module|locals|data)\b|\b\d+(?:\.\d+)?\b)/g;
+ const parts=source.split(pattern);
+ return <pre className={`code-preview ${className}`} aria-label={name||'Code preview'}><code>{parts.map((text,i)=>i%2?<span key={i} className={/^['"]/.test(text)?(/^\s*:/.test(parts[i+1]||'')?'code-key':'code-string'):/^(\/\/|#)/.test(text)?'code-comment':/^\d/.test(text)?'code-number':'code-keyword'}>{text}</span>:text)}</code></pre>;
+}

package/src/ComponentReview.jsx

@@ -0,0 +1,31 @@
+import React,{useState} from 'react';
+import {CheckCircle2, CircleHelp, Circle, RefreshCw, ChevronLeft, ChevronRight, MessageCircle, Plus, AlertCircle} from 'lucide-react';
+import {reviewIssueLabel} from './component-review.mjs';
+function QuestionAnswer({question,busy,onResolve}){
+ const [answer,setAnswer]=useState('');
+ return <details><summary>Record answer</summary><form onSubmit={e=>{e.preventDefault();if(answer.trim())onResolve(question.id,answer.trim());}}><label>Answer<textarea aria-label={`Answer: ${question.text}`} maxLength={2000} value={answer} onChange={e=>setAnswer(e.target.value)}/></label><button className="btn ghost" disabled={busy||!answer.trim()}>Save answer</button></form></details>;
+}
+function DetailAnswer({question,busy,onSave}){
+ const [answer,setAnswer]=useState('');const ownership=question.id==='detail-Ownership recorded',region=question.id==='detail-Cloud region selected';
+ return <form className="block-question-form" onSubmit={e=>{e.preventDefault();if(answer.trim())onSave(ownership?{origin:answer}:region?{config:{region:answer.trim()}}:{description:answer.trim()});}}><label>{ownership?'System ownership':region?'Cloud region':'Block responsibility'}{ownership?<select aria-label="System ownership" value={answer} onChange={e=>setAnswer(e.target.value)}><option value="">Choose…</option><option value="existing">Existing system</option><option value="proposed">Proposed component</option></select>:<textarea aria-label={region?'Cloud region answer':'Block responsibility answer'} maxLength={region?100:16000} value={answer} onChange={e=>setAnswer(e.target.value)}/>}</label><button className="btn ghost" disabled={busy||!answer.trim()}>Save detail</button></form>;
+}
+export function ReviewBadge({item,onClick}){
+ const Icon={reviewed:CheckCircle2,questions:CircleHelp,issues:AlertCircle,ready:Circle,changed:RefreshCw}[item.status];
+ const label=item.issues.length?reviewIssueLabel(item.issues):item.statusLabel,tone=item.status==='issues'?'questions':item.status;
+ return onClick?<button className={`block-review-badge ${tone} nodrag`} aria-label={`Review ${item.label}: ${label}`} title={`${label} · design review, not runtime validation`} onClick={e=>{e.stopPropagation();onClick();}}><Icon size={13}/>{label}</button>:<span className={`block-review-badge ${tone}`}><Icon size={14}/>{label}</span>;
+}
+export function ComponentReview({item,items,busy,onOpen,onConfirm,onDiscuss,onQuestion,onResolve,onDetailAnswer}){
+ const [adding,setAdding]=useState(false),[question,setQuestion]=useState('');const index=items.findIndex(r=>r.id===item.id);
+ return <section className="component-review" aria-label="Block design review">
+  <div className="block-review-heading"><strong>Block {index+1} of {items.length}</strong><ReviewBadge item={item}/></div>
+  <div className="block-review-progress"><progress aria-label="Blocks reviewed" max={items.length} value={items.filter(r=>r.status==='reviewed').length}/><small>{items.filter(r=>r.status==='reviewed').length} reviewed</small></div>
+  {item.status==='changed'&&<p>The block or its context changed. Check it again.</p>}
+  {item.architectNote&&<div className="block-architect-note"><strong>{item.architectNoteCurrent?'Architect’s review':'Previous review · context changed'}</strong><p>{item.architectNote}</p></div>}
+  <ul className="block-review-checks">{item.checks.map(c=><li key={c.label} className={c.passed?'complete':'incomplete'}>{c.passed?<CheckCircle2 size={14}/>:<CircleHelp size={14}/>} {c.label}</li>)}</ul>
+  {!!item.issues.length&&<ul className="block-review-questions">{item.issues.map(q=><li key={q.id}><strong>{q.kind==='finding'?'Design issue':'Question'}</strong><span>{q.text}</span>{q.action&&<small>Suggested next step: {q.action}</small>}{q.kind==='question'&&<QuestionAnswer question={q} busy={busy} onResolve={onResolve}/>} {q.kind==='detail'&&<DetailAnswer question={q} busy={busy} onSave={onDetailAnswer}/>} {q.kind==='finding'&&<button className="link" disabled={busy} onClick={()=>onDiscuss(q)}>Ask Architect to plan this fix</button>}</li>)}</ul>}
+  <div className="block-review-actions"><button className="btn primary" disabled={busy||item.issues.length>0||item.status==='reviewed'} onClick={onConfirm}><CheckCircle2 size={14}/>{item.status==='reviewed'?'Design reviewed':'Looks good'}</button><button className="btn ghost" disabled={busy} onClick={onDiscuss}><MessageCircle size={14}/>Ask Architect</button><button className="btn ghost" disabled={busy} onClick={()=>setAdding(!adding)}><Plus size={14}/>Question</button></div>
+  {adding&&<form className="block-question-form" onSubmit={e=>{e.preventDefault();if(question.trim()){onQuestion(question.trim());setQuestion('');setAdding(false);}}}><label>Question about this block<textarea aria-label="Question about this block" maxLength={1000} value={question} onChange={e=>setQuestion(e.target.value)} autoFocus/></label><button className="btn" disabled={busy||!question.trim()}>Save question</button></form>}
+  <small className="block-review-boundary">Design review only. Implementation and runtime checks are separate.</small>
+  <nav className="block-review-navigation" aria-label="Review blocks one by one"><button className="btn ghost" disabled={index===0} onClick={()=>onOpen(items[index-1].id)}><ChevronLeft size={14}/>Previous</button><button className="btn ghost" disabled={index===items.length-1} onClick={()=>onOpen(items[index+1].id)}>Next block<ChevronRight size={14}/></button></nav>
+ </section>;
+}

package/src/DeliveryViews.jsx

@@ -0,0 +1,59 @@
+import React from "react";
+import { consultingEstimate, WORK_PHASES, setDetail } from "./estimate.mjs";
+import { resourcePlan } from "./resources.mjs";
+const amount = (n, c) => n == null ? "Not estimated" : `${c} ${n.toLocaleString("en", { maximumFractionDigits: 2 })}`;
+const number = (s) => s === "" || !Number.isFinite(Number(s)) || Number(s) < 0 ? undefined : Number(s);
+
+export function DetailedCharges({ project, onChange }) {
+  const lines = project.estimate?.details || [];
+  const components = project.nodes.filter((n) => n.data.kind !== "note");
+  const change = (details) => onChange({ ...project, estimate: { ...(project.estimate || {}), details } });
+  return <details className="extra" aria-label="Detailed cloud charges">
+    <summary>Model detailed cloud costs</summary>
+    <p className="muted small">Add each billable dimension: for example input tokens, output tokens, requests, compute, storage and transfer. Detailed lines replace the coarse ROM line for that component. Enter a zero-cost line and explain why for an existing or free component.</p>
+    {lines.map((l, index) => {
+      const set = (patch) => onChange(setDetail(project, l.id, patch));
+      return <fieldset className="charge-editor" key={l.id}>
+        <legend>Charge {index + 1}</legend>
+        <div className="delivery-fields">
+          <label className="field">Component<select aria-label={`Charge ${index + 1} component`} value={l.componentId} onChange={(e) => set({ componentId: e.target.value })}>
+            {!components.some((n) => n.id === l.componentId) && <option value={l.componentId}>Removed component — reassign</option>}
+            {components.map((n) => <option key={n.id} value={n.id}>{n.data.label}</option>)}
+          </select></label>
+          {[['description','Charge description'],['quantity','Monthly quantity'],['unit','Unit'],['price','Unit price'],['currency','Currency'],['service','Service or SKU'],['region','Price region'],['source','Price source or quote'],['date','Price date']].map(([key,label]) => <label className="field" key={key}>{label}<input aria-label={`Charge ${index + 1} ${label.toLowerCase()}`} type={key === 'date' ? 'date' : 'text'} inputMode={['quantity','price'].includes(key) ? 'decimal' : undefined} value={l[key] ?? ''} onChange={(e) => set({ [key]: ['quantity','price'].includes(key) ? number(e.target.value) : key === 'currency' ? e.target.value.toUpperCase().slice(0,3) : e.target.value })} /></label>)}
+        </div>
+        <button className="btn ghost danger" onClick={() => change(lines.filter((x) => x.id !== l.id))}>Remove charge {index + 1}</button>
+      </fieldset>;
+    })}
+    <button className="btn" disabled={!components.length} onClick={() => change([...lines, { id: `charge-${crypto.randomUUID()}`, componentId: components[0].id, description: "", unit: "", currency: "USD", source: "", date: new Date().toISOString().slice(0,10), region: "", service: "" }])}>Add cloud charge</button>
+  </details>;
+}
+
+export function ConsultingView({ project, onChange }) {
+  const c = project.estimate?.consulting || {}, result = consultingEstimate(project);
+  const set = (patch) => onChange({ ...project, estimate: { ...(project.estimate || {}), consulting: { ...c, ...patch } } });
+  return <details className="extra" aria-label="Consulting and build estimate">
+    <summary>Consulting and build estimate · one-off</summary>
+    <p className="muted small">Enter person-days and your day rate; no rates or effort are assumed. Give the basis, scope and exclusions. Use zero days with a reason if a phase is out of scope. Person-days are effort, not calendar duration.</p>
+    <label className="field">Consulting currency<input aria-label="Consulting currency" value={c.currency || "USD"} onChange={(e) => set({ currency: e.target.value.toUpperCase().slice(0,3) })} /></label>
+    <div className="totals"><div><small>Expected one-off subtotal</small><strong>{amount(result.expected, result.currency)}</strong></div><div><small>Range</small><span>{result.low == null ? '—' : `${amount(result.low, result.currency)} – ${amount(result.high, result.currency)}`}</span></div><div><small>Status</small><span>{result.complete ? "All work packages estimated" : "Incomplete — work packages need estimates"}</span></div></div>
+    {WORK_PHASES.map(([id,label]) => {
+      const phase = c.phases?.[id] || {};
+      const edit = (patch) => set({ phases: { ...(c.phases || {}), [id]: { ...phase, ...patch } } });
+      return <fieldset className="charge-editor" key={id}><legend>{label}</legend><div className="delivery-fields">
+        {[['lowDays','Low days'],['days','Expected days'],['highDays','High days'],['rate','Day rate']].map(([key,name]) => <label className="field" key={key}>{name}<input aria-label={`${label} ${name.toLowerCase()}`} inputMode="decimal" value={phase[key] ?? ''} onChange={(e) => edit({ [key]: number(e.target.value) })} /></label>)}
+        <label className="field delivery-basis">Basis, scope and exclusions<textarea rows={2} aria-label={`${label} basis`} value={phase.basis || ''} onChange={(e) => edit({ basis: e.target.value })} /></label>
+      </div></fieldset>;
+    })}
+    <p className="muted small">Separate from cloud running costs. Taxes, licences, ongoing support and migration are excluded unless explicitly included.</p>
+  </details>;
+}
+
+export function ResourcesView({ project }) {
+  const plan = resourcePlan(project);
+  return <details className="extra" aria-label="Cloud resource schedule"><summary>Resources and infrastructure coverage · {plan.rows.length} components</summary>
+    <p className="muted small">Derived from the current diagram. Generic services need confirmation. S3 foundation code covers buckets and their controls; drawn wires still need application integration and IAM.</p>
+    <div className="resource-schedule">{plan.rows.map((r) => <article key={r.id}><strong>{r.label}</strong><span>{r.provider.toUpperCase()} · {r.service} · {r.region}</span><small>{r.existing ? "Existing system" : r.selection} · {r.terraform}</small><small>{r.resources.join(', ') || 'Resource types to confirm'}</small><small>Cost dimensions: {r.costDrivers}</small></article>)}</div>
+    {plan.gaps.length > 0 && <p className="warn-text small">{plan.gaps.length} resource or integration tasks remain. The full list is included in the delivery pack.</p>}
+  </details>;
+}

package/src/EmulationPanel.jsx

@@ -0,0 +1,44 @@
+import {emulationGuidance,emulationRepairTask} from './emulation-guidance.mjs';
+import {toProjectFile} from './project-file.mjs';
+import {BrainActivity} from "./BrainActivity.jsx";
+import React,{useState} from 'react';
+import {Play,X,CheckCircle2,AlertCircle} from 'lucide-react';
+import {emulationFeedback,emulationEvidenceSummary} from './emulation-feedback.mjs';
+export function EmulationPanel({project,session,emulation,onDiscuss,discussionBusy=false,onOpenComponent,onClose,onBuild}){
+ const {result,previous,running}=emulation;
+ const [expanded,setExpanded]=useState(false),[taskError,setTaskError]=useState('');
+ const readiness=emulationGuidance(project,result)||emulation.preflight;
+ const guidance=readiness?.action==='build-and-test'&&!onBuild?{...readiness,next:'Application implementation is unavailable in this session. Download the repair task for the missing code and tests; testing can resume once that implementation is available.'}:readiness;
+ const feedback=emulationFeedback(project,result),thinking=discussionBusy&&!!result;
+ const title=running?'Testing this design…':thinking?'Architect is reviewing…':guidance?guidance.title:result?.status==='passed'?'Local checks passed':result?'Let’s resolve the next step':previous?'Design changed — rerun needed.':'Local implementation checks';
+ function saveReport(){const url=URL.createObjectURL(new Blob([JSON.stringify(result,null,2)],{type:'application/json'}));const a=document.createElement('a');a.href=url;a.download=`atmem-local-checks-r${project.revision}.json`;a.click();setTimeout(()=>URL.revokeObjectURL(url),1000);}
+ function saveTask(){try{toProjectFile(project);const url=URL.createObjectURL(new Blob([emulationRepairTask(project,result)],{type:'text/markdown'}));const a=document.createElement('a');a.href=url;a.download='architect-repair-task.md';a.click();setTimeout(()=>URL.revokeObjectURL(url),1000);setTaskError('');}catch(error){setTaskError(error.message);}}
+ const icon=(label,Icon,action,options={})=><button type="button" className={`emulation-icon ${options.active?'active':''}`} aria-label={label} title={label} onClick={action} disabled={options.disabled} aria-pressed={options.toggle?options.active:undefined}><Icon size={19}/></button>;
+ return <aside className={`emulation-panel ${running||thinking?'is-working':''}`} aria-label="Local checks">
+  <div className="emulation-heading"><span className={`emulation-orb ${running||thinking?'working':''}`}><BrainActivity size={34} active={running||thinking}/></span><div><span className="emulation-eyebrow">LOCAL CHECKS</span><h3 aria-live="polite">{title}</h3></div>{onClose&&icon('Close local checks',X,onClose)}</div>
+  <div className="emulation-controls row">
+   <button type="button" className="btn primary" aria-label="Run local checks" aria-busy={running||thinking} title={running?'Local checks running':thinking?'Architect is reviewing':emulation.preflight?'Complete the next step below before testing':'Run local checks'} disabled={running||thinking||!session?.token||!!emulation.preflight} onClick={()=>emulation.run()}>{running||thinking?<BrainActivity size={24}/>:<Play size={19}/>} Run local checks</button>
+   {running&&<button type="button" className="btn" onClick={emulation.stop}>Stop waiting</button>}
+   {result&&onDiscuss&&<button type="button" className="btn" disabled={discussionBusy||running} onClick={()=>onDiscuss(result,'question')}>Ask Architect about these results</button>}
+   <button type="button" className="btn" aria-expanded={expanded} onClick={()=>setExpanded(!expanded)}>{expanded?'Hide details':'Check details and settings'}</button>
+  </div>
+  <div className="emulation-track" aria-label="Local check progress"><span className={running?'current':result?'complete':''}>Test</span><i/><span className={thinking?'current':''}>Review</span><i/><span>Improve</span><i/><span>Retest</span></div>
+  {running&&<div className="emulation-progress" role="progressbar" aria-label="Running local checks"><span/></div>}
+  <p className="emulation-caption">{running?'Checking the generated code. Keep exploring the diagram.':thinking?'Your architect is working through the evidence in chat.':guidance?guidance.reason:result?emulationEvidenceSummary(result):'Runs local checks on the generated implementation and shows the results here. Monitoring needs its own implementation and configuration.'}</p>
+  {guidance&&!running&&!thinking&&<div className="emulation-next-step"><p><strong>Next:</strong> {guidance.next}</p>{guidance.action==='build-and-test'&&onBuild?<button className="btn primary" disabled={discussionBusy} onClick={onBuild}>Implement and check</button>:guidance.owner==='engineering'?<button className="btn primary" onClick={saveTask}>Download repair task</button>:guidance.needsModel?<button className="btn primary" disabled={discussionBusy} onClick={()=>onDiscuss?.(result,'correction')}>Work through this with Architect</button>:<button className="btn ghost" onClick={()=>setExpanded(true)}>See test details</button>}{guidance.componentId&&onOpenComponent&&<button className="link" onClick={()=>onOpenComponent(guidance.componentId)}>Review affected block</button>}{taskError&&<p role="alert">{taskError}</p>}</div>}
+  {emulation.retestLimitReached&&<p role="status">Two automatic retests are complete. Review the latest correction, then choose Run local checks to continue.</p>}
+  {expanded&&<div className="emulation-evidence">
+   <label><input type="checkbox" checked={emulation.coach} onChange={event=>emulation.setCoach(event.target.checked)}/> Ask Architect to explain new check results automatically</label>
+   <label><input type="checkbox" checked={emulation.autoRetest} onChange={event=>emulation.setAutoRetest(event.target.checked)}/> Rerun checks after an accepted correction (up to two attempts)</label>
+   <p>Corrections follow Draw as we talk and remain undoable. Stop waiting ends your wait; server work can continue until its time limit.</p>
+   {result?.artifactDigest&&<button type="button" className="btn" onClick={saveReport}>Download check report (JSON)</button>}
+   {feedback&&<p>{feedback.question}</p>}{result?.message&&<p>{result.message}</p>}
+   {result?.backend&&<p>{result.backend} {result.backendVersion} · r{result.designRevision} · {result.environment}</p>}
+   {result?.checks?.map((c,i)=><div className="emulation-check" key={i}>{c.passed?<CheckCircle2 size={16}/>:<AlertCircle size={16}/>}<span>{c.name}{c.message&&<small>{c.message}</small>}</span></div>)}
+   {result?.blockers?.map((b,i)=><p key={i}>{b}</p>)}
+   {!!result?.capabilities?.length&&<details><summary>What was checked</summary><ul>{result.capabilities.map((item,i)=><li key={i}>{item.service}: {item.mode}</li>)}</ul></details>}
+   {!!result?.emulatorPatches?.length&&<details><summary>Emulator compatibility fixes</summary><ul>{result.emulatorPatches.map(item=><li key={item.id}>{item.id}: {item.reason}</li>)}</ul></details>}
+   {!!result?.limitations?.length&&<details open><summary>Still requires cloud verification</summary><ul>{result.limitations.map((v,i)=><li key={i}>{v}</li>)}</ul></details>}
+  </div>}
+ </aside>;
+}

package/src/EngagementViews.jsx

@@ -0,0 +1,387 @@
+import {InlineNote} from './HelpNote.jsx';
+import {BrainActivity} from "./BrainActivity.jsx";
+import {systemDescription,requirementExplanation} from './system-description.mjs';
+import { resolveCommentRevision } from "./consultation.mjs";
+// Consultant views: Discover (qualify), Options and Decisions (design), Build card.
+import React from "react";
+import { requirementNumber } from "./derive.mjs";
+import { Plus, Trash2 } from "lucide-react";
+import {
+  BRIEF_FIELDS,
+  CRITERIA,
+  GATE,
+  LEVELS,
+  OPTIONS,
+  STATUSES,
+  VERDICTS,
+  defaultAssessment,
+  newDecision,
+  optionScore,
+} from "./engagement.mjs";
+import { OPTION_NAMES } from "./pack.mjs";
+import {
+  decisionHistory,
+  measureProblem,
+  reviseDecision,
+} from "./records.mjs";
+
+const area = (props) => <textarea rows={2} {...props} />;
+
+// One understood topic: read as text; edit only when asked.
+function Known({ topic, value, onSave }) {
+  const [editing, setEditing] = React.useState(false);
+  return (
+    <div className={`known-item ${topic.state}`}>
+      <dt>
+        {topic.label}
+        {topic.state === "assumed" && <em> · assumed</em>}
+        {!editing && (
+          <button className="link small" aria-label={`Edit ${topic.label}`} onClick={() => setEditing(true)}>
+            Edit
+          </button>
+        )}
+      </dt>
+      {editing ? (
+        <dd>
+          <textarea autoFocus rows={2} aria-label={topic.label} defaultValue={value} onBlur={(e) => (onSave(e.target.value), setEditing(false))} />
+        </dd>
+      ) : (
+        <dd>{value}</dd>
+      )}
+    </div>
+  );
+}
+
+// What we've understood from the chat, as a small card on the board.
+export function DiscoverView({ project, onChange, topics, open = true, onToggle }) {
+  const brief = project.brief || {};
+  const useCases = project.useCases || [];
+  const setCase = (i, patch) =>
+    onChange({ ...project, useCases: useCases.map((u, j) => (j === i ? { ...u, ...patch } : u)) });
+  const facts = (project.facts || []).filter((f) => f.name !== "cloud.preference" && f.name !== "data.sensitive");
+  const heard = topics.filter((t) => t.state !== "open");
+  if (!open) return null;
+  return (
+    <section className="notes-card" aria-label="Discover">
+      <div className="doc-sub">
+        <h3>What we know so far</h3>
+      </div>
+      {heard.length > 0 && (
+        <>
+          <p className="muted small">Your words — edit anything.</p>
+          {facts.length > 0 && (
+            <div className="facts">
+              {facts.map((f) => (
+                <span key={f.id} className={`chip ${f.conflictsWith ? "missing" : ""}`} title={`${f.text} (${f.madeAt})`}>
+                  {typeof f.value === "number" ? f.value.toLocaleString("en") : String(f.value)} {f.unit}
+                  <button aria-label={`Forget ${f.unit}`} onClick={() => onChange({ ...project, facts: project.facts.filter((x) => x.id !== f.id) })}>
+                    ×
+                  </button>
+                </span>
+              ))}
+            </div>
+          )}
+          <dl className="known">
+            {heard.map((t) => (
+              <Known
+                key={t.id}
+                topic={t}
+                value={brief[t.id] || ""}
+                onSave={(value) => onChange({ ...project, brief: { ...brief, [t.id]: value } })}
+              />
+            ))}
+          </dl>
+          <p className="muted small">
+            Still to cover, whenever you're ready:{" "}
+            {topics.filter((t) => t.state === "open").map((t) => t.label.toLowerCase()).join(", ") || "nothing — that's everything for now."}
+          </p>
+        </>
+      )}
+      <details className="extra">
+        <summary>Comparing ideas? Qualify use cases</summary>
+        <div className="cases compact">
+          {useCases.map((u, i) => (
+            <div key={u.id} className={`case verdict-${u.verdict.replace(" ", "-").toLowerCase()}`}>
+              <input aria-label="Use case" placeholder="Idea" value={u.title} onChange={(e) => setCase(i, { title: e.target.value })} />
+              <div className="seg verdicts">
+                {VERDICTS.map((v) => (
+                  <button key={v} className={u.verdict === v ? "on" : ""} onClick={() => setCase(i, { verdict: v })}>
+                    {v}
+                  </button>
+                ))}
+              </div>
+              <button className="icon" aria-label="Remove use case" onClick={() => onChange({ ...project, useCases: useCases.filter((_, j) => j !== i) })}>
+                <Trash2 size={13} />
+              </button>
+            </div>
+          ))}
+          <button
+            className="link small"
+            onClick={() =>
+              onChange({
+                ...project,
+                useCases: [...useCases, { id: `uc-${Date.now()}`, title: "", value: "Medium", risk: "Medium", fit: "Medium", verdict: "Park", reason: "" }],
+              })
+            }
+          >
+            + Add use case
+          </button>
+        </div>
+      </details>
+    </section>
+  );
+}
+
+export function OptionsView({ project, onDiscuss, onPreview, onChoose, onContinue, busy }) {
+  const notes = project.assessment?.notes || {};
+  const ready = Object.values(notes).some(Boolean);
+  const selected = [...(project.decisions||[])].reverse().find(d=>d.subject==='platform.cloud'&&d.status==='Accepted')?.decision;
+  return <section className="doc" aria-label="Choices">
+    <header className="doc-head"><h2>Choices</h2></header>
+    <button className="btn" onClick={() => onDiscuss('Help me compare AWS, Azure, Google Cloud and IBM for this design. Ask one useful question about my priorities, then refine the comparison from my answer. Populate optionAssessment when enough is known. Keep the diagram unchanged.')}>Discuss cloud options</button>
+    {selected && <p className="cloud-selection" role="status"><strong>Selected: {OPTION_NAMES[selected]}</strong> <button className="btn primary" disabled={busy} onClick={onContinue}>Review →</button></p>}
+    <DecisionsView project={project} onDiscuss={onDiscuss} embedded/>
+    <h3>Cloud alternatives</h3>
+
+    {['current','aws','azure','gcp','ibm'].filter(id => notes[id]).map(id => <article className="consultation-summary" key={id}>
+      <h3>{OPTION_NAMES[id]}{selected===id ? " · Selected" : ""}</h3><InlineNote label={`About ${OPTION_NAMES[id]}`}>{notes[id].replace(/^(?:AtMem AI Architect|At[Ff]orma) proposal — confirm: /,'')}</InlineNote>
+      <button className="link" onClick={() => onDiscuss(`Explain how ${OPTION_NAMES[id]} fits our design and the main tradeoff. Ask one question to help me decide; keep this as a discussion until I explicitly choose.`)}>Discuss this option</button>
+      {id!=="current" && <><button className="link" onClick={()=>onPreview(id)}>Preview service architecture</button><button className="btn primary" disabled={busy||selected===id} onClick={()=>onChoose(id)}>{selected===id ? `${OPTION_NAMES[id]} selected` : `${OPTION_NAMES[id]} →`}</button></>}
+    </article>)}
+  </section>;
+}
+
+export function DecisionsView({ project, onDiscuss, embedded=false }) {
+  const all = project.decisions || [];
+  const choices = all.filter(d => !d.subject?.startsWith('design.'));
+  const current = choices.filter(d => d.status !== 'Superseded');
+  const sketches = all.filter(d => d.subject?.startsWith('design.'));
+  const labels = {'platform.cloud':'Cloud provider','cloud.region':'Region','data.country':'Country / data residency','infrastructure.tool':'Infrastructure tool'};
+  return <section className={embedded?undefined:"doc"} aria-label="Decisions">
+    <header className="doc-head"><h2>Selected choices</h2></header>
+    <button className="btn" onClick={() => onDiscuss('Review our current design and explicit choices. Explain the next choice we need to make and ask me one useful question. Do not treat a sketch or a suggestion as an accepted decision.')}>Discuss the next choice</button>
+    {!current.length && <p className="muted">No choices selected.</p>}
+    {current.map(d => <article className="consultation-summary" key={d.id}>
+      <h3>{labels[d.subject] || d.title}</h3><p>{OPTION_NAMES[d.decision] || d.decision || 'Still being discussed'}</p>
+      <small className="muted">{d.status === 'Accepted' ? 'Confirmed in our conversation' : 'Proposed — still to discuss'}</small>
+      {(d.context||d.consequences)&&<InlineNote label="Decision details"><p>{d.context}</p><p>{d.consequences}</p></InlineNote>}
+      <button className="link" onClick={() => onDiscuss(`Let’s revisit our choice about ${labels[d.subject] || d.title}: ${d.decision}. Explain the tradeoff and ask what I would like to change before updating it.`)}>Revisit in chat</button>
+      {choices.some(h => h.subject===d.subject && h.status==='Superseded') && <details className="extra"><summary>Earlier choices</summary>{choices.filter(h => h.subject===d.subject && h.status==='Superseded').map(h=><p key={h.id}>{h.decision} {h.reason && `— ${h.reason}`}</p>)}</details>}
+    </article>)}
+    {!!sketches.length && <details className="extra"><summary>Diagram change history</summary>{sketches.map(d=><p key={d.id}>{d.title} · {d.decision}</p>)}</details>}
+  </section>;
+}
+
+export function BuildCard({ project, run, onChange, onOpen, environment, onEnvironment, onPlan, onPulumi, onPack }) {
+  const scope = project.nodes.filter((n) => n.data.poc);
+  const tested = run && run.revision === project.revision && run.status !== "running";
+  const results = Object.fromEntries(
+    (tested ? run.steps : []).flatMap((s) => (s.output?.measures || []).map((m) => [m.label, m])),
+  );
+  const outputs = project.nodes.filter((n) => n.data.measures?.length);
+  const gate = project.gate || {};
+  const unowned = (project.decisions || []).filter((d) => !d.owner?.trim()).length;
+  return (
+    <aside className="deploy build" aria-label="Build">
+      <h3>Prototype</h3>
+      <p className="muted small">
+        {scope.length}/{project.nodes.length} blocks in scope · faded blocks are out
+      </p>
+      <h4>Success criteria</h4>
+      {outputs.length ? (
+        <ul className="checks">
+          {outputs.flatMap((n) =>
+            n.data.measures.map((m) => {
+              const r = results[m.label];
+              return (
+                <li key={n.id + m.label} className={r ? (r.pass ? "ok" : "bad") : ""}>
+                  <button className="link-plain" onClick={() => onOpen(n.id)}>
+                    {m.label} {m.op} {String(m.target)}
+                    {r && <span className="muted"> · {String(r.value)}</span>}
+                  </button>
+                </li>
+              );
+            }),
+          )}
+        </ul>
+      ) : (
+        <p className="muted small">Add measures to the final check block.</p>
+      )}
+      <h4>Scale gate</h4>
+      {GATE.map((g) => (
+        <label key={g.id} className="field">
+          {g.label}
+          {area({
+            "aria-label": g.label,
+            placeholder: g.hint,
+            value: gate[g.id] || "",
+            onChange: (e) => onChange({ ...project, gate: { ...gate, [g.id]: e.target.value } }),
+          })}
+        </label>
+      ))}
+      {unowned > 0 && <p className="warn-text small">{unowned} decision{unowned > 1 ? "s" : ""} without an owner</p>}
+      <div className="seg">
+        {["staging", "production"].map((env) => (
+          <button key={env} className={environment === env ? "on" : ""} onClick={() => onEnvironment(env)}>
+            {env[0].toUpperCase() + env.slice(1)}
+          </button>
+        ))}
+      </div>
+      <div className="row">
+        <button className="btn" onClick={onPlan}>
+          Export {environment} plan
+        </button>
+        <button className="btn ghost" onClick={onPulumi}>
+          Pulumi
+        </button>
+      </div>
+      <button className="btn primary" onClick={onPack}>
+        Client pack
+      </button>
+    </aside>
+  );
+}
+
+export function MeasuresEditor({ measures = [], disabled, onChange }) {
+  const set = (i, patch) => onChange(measures.map((m, j) => (j === i ? { ...m, ...patch } : m)));
+  return (
+    <div className="measures">
+      <h4>Success measures</h4>
+      {measures.map((m, i) => (
+        <div key={i} className="measure">
+          <input aria-label="Measure label" disabled={disabled} value={m.label} onChange={(e) => set(i, { label: e.target.value })} />
+          <input aria-label="Measure field" disabled={disabled} className="mono" value={m.path} onChange={(e) => set(i, { path: e.target.value })} />
+          <select aria-label="Measure operator" disabled={disabled} value={m.op} onChange={(e) => set(i, { op: e.target.value })}>
+            <option>{">="}</option>
+            <option>{"<="}</option>
+            <option>{"=="}</option>
+          </select>
+          <input
+            aria-label="Measure target"
+            disabled={disabled}
+            value={String(m.target)}
+            onChange={(e) => {
+              const v = e.target.value;
+              set(i, { target: v === "true" ? true : v === "false" ? false : v !== "" && !isNaN(Number(v)) ? Number(v) : v });
+            }}
+          />
+          <button className="icon" aria-label="Remove measure" disabled={disabled} onClick={() => onChange(measures.filter((_, j) => j !== i))}>
+            <Trash2 size={13} />
+          </button>
+        </div>
+      ))}
+      <button
+        className="btn ghost"
+        disabled={disabled}
+        onClick={() => onChange([...measures, { label: "New measure", path: "status", op: "==", target: "passed" }])}
+      >
+        <Plus size={13} /> Add measure
+      </button>
+    </div>
+  );
+}
+
+function RequirementComments({ requirement, comments, onSave, onRemove, target, number, onReview, onResolve, reviewing, onDiscuss }) {
+  const [open,setOpen]=React.useState(false), [text,setText]=React.useState(''), [quote,setQuote]=React.useState('');
+  const editor=React.useRef(null);
+  React.useEffect(()=>{if(target?.id===requirement.id){setQuote(target.quote);setOpen(true);}},[target,requirement.id]);
+  React.useEffect(()=>{if(open){editor.current?.focus();editor.current?.scrollIntoView({block:'nearest'});}},[open,target]);
+  const save=review=>{onSave(text.trim(),quote,review);setText('');setOpen(false);};
+  return <aside className="requirement-comments" aria-label={`Comments on ${requirement.id}`}>
+    {comments.filter(c=>!['reviewed','dismissed'].includes(c.status)).map(c=><div className="requirement-comment" key={c.id}>
+      <strong>Your feedback on {number}</strong>{c.selectedText && <blockquote>{c.selectedText}</blockquote>}<p>{c.text}</p>
+      {c.status==='proposed' ? <div className="requirement-revision">
+        <h5>Suggested revision — not applied yet</h5><p className="revision-label">Current wording</p><p>{c.before}</p>
+        <p className="revision-label">Proposed wording</p><p className="revision-after">{c.after}</p><p>{c.explanation}</p>
+        <button className="requirement-add-comment" onClick={()=>onResolve(c.id,true)}>Apply this revision</button>
+        <button className="link" onClick={()=>onResolve(c.id,false)}>Keep current wording</button>
+      </div> : <><p className="comment-status">{c.reviewMessage || 'Saved feedback. Ask AtMem AI Architect to suggest wording, then review the change here.'}</p><button className="requirement-add-comment" disabled={reviewing} onClick={()=>onReview([c])}>{reviewing?<><BrainActivity/> Preparing suggestions…</>:'Suggest a revision'}</button><button className="link" onClick={()=>onDiscuss(`Help me clarify my feedback on ${number} (${requirement.id}): ${c.text}. Ask one question before proposing a change.`)}>Discuss feedback</button></>}
+      <button className="link" onClick={()=>onRemove(c.id)} aria-label={`Remove comment ${c.id}`}>Remove</button>
+    </div>)}
+    {comments.some(c=>['reviewed','dismissed'].includes(c.status)) && <section className="comment-history"><h4>Feedback history</h4>{comments.filter(c=>['reviewed','dismissed'].includes(c.status)).map(c=><div key={c.id}><p>{c.text}</p><small>{c.status==='reviewed'?'Revision applied':'Original wording kept'}</small>{c.after&&<p>{c.after}</p>}</div>)}</section>}
+    {!open ? <button className="requirement-add-comment" onClick={()=>{setQuote('');setOpen(true);}}>Comment or request a change</button> : <div className="comment-composer">
+      <strong>Feedback on {number}</strong>{quote && <blockquote>{quote}</blockquote>}
+      <textarea ref={editor} aria-label={`Comment on ${requirement.id}`} value={text} maxLength={500} onChange={e=>setText(e.target.value)} placeholder="What doesn’t fit, what’s missing, or what would you like explained?" />
+      <p className="comment-status">AtMem AI Architect will suggest new wording below. You decide whether to apply it.</p>
+      <button className="btn" disabled={!text.trim()||reviewing} onClick={()=>save(true)}>Suggest a revision</button>
+      <button className="link" disabled={!text.trim()} onClick={()=>save(false)}>Save for later</button>
+      <button className="link" onClick={()=>{setOpen(false);setText('');}}>Cancel</button>
+    </div>}
+  </aside>;
+}
+
+export function RequirementsView({checks,onContinue, project, onDiscuss, onChange, onReview, reviewing, onUpload, onOpenProject }) {
+  const [commentMenu,setCommentMenu]=React.useState(null), [commentTarget,setCommentTarget]=React.useState(null);
+  React.useEffect(()=>{
+    if(!commentMenu)return;
+    const dismiss=()=>setCommentMenu(null);
+    const key=e=>{if(e.key==='Escape')dismiss();};
+    document.addEventListener('pointerdown',dismiss);document.addEventListener('keydown',key);window.addEventListener('resize',dismiss);
+    return ()=>{document.removeEventListener('pointerdown',dismiss);document.removeEventListener('keydown',key);window.removeEventListener('resize',dismiss);};
+  },[commentMenu]);
+  function textMenu(event,r) {
+    const selection=window.getSelection();
+    if(!selection?.rangeCount || selection.isCollapsed)return;
+    const range=selection.getRangeAt(0), element=event.currentTarget;
+    if(!element.contains(range.startContainer) || !element.contains(range.endContainer))return;
+    const quote=selection.toString().trim();if(!quote)return;
+    event.preventDefault();event.stopPropagation();
+    setCommentMenu({id:r.id,quote:quote.slice(0,1500),x:Math.max(8,Math.min(event.clientX,window.innerWidth-250)),y:Math.max(8,Math.min(event.clientY,window.innerHeight-70))});
+  }
+  const needs = project.needs || [];
+  const comments = project.extensions?.requirementComments || [];
+  const pending = comments.filter(c=>c.status==='open' && needs.some(r=>r.id===c.requirementId));
+  const saveComments = value => onChange({...project,extensions:{...project.extensions,requirementComments:value}});
+
+  const names = Object.fromEntries(project.nodes.map(n => [n.id, n.data.label]));
+  const titles = {suggested:'Suggestions still to discuss',functional:'Functional requirements',security:'Security and access',compliance:'Data governance and compliance',availability:'Availability and recovery',reliability:'Reliability',performance:'Performance',scalability:'Capacity and growth',maintainability:'Operations and maintainability',cost:'Cost constraints',other:'Quality requirements'};
+  const groups = new Map();
+  for (const r of needs) {
+    const key = r.source==='agent' ? 'suggested' : r.kind === 'functional' ? 'functional' : r.category || 'other';
+    if (!groups.has(key)) groups.set(key, []);
+    groups.get(key).push(r);
+  }
+  const questions = (project.openQuestions || []).filter(q=>q.status==='open');
+  const purpose = project.brief?.application || project.requirements;
+  const system=systemDescription(project);
+  return <section className="doc requirements-document" aria-label="Requirements">
+    <div className="requirements-actions">
+      {!!pending.length && <button className="btn" disabled={reviewing} onClick={()=>onReview(pending.slice(0,6))}>{reviewing?'Reviewing comments…':'Suggest revisions for saved feedback'} ({Math.min(6,pending.length)})</button>}
+    </div>
+    {commentMenu && <div className="ctx-menu requirement-text-menu" role="menu" aria-label="Selected text actions" style={{left:commentMenu.x,top:commentMenu.y}} onPointerDown={e=>e.stopPropagation()}>
+      <button role="menuitem" ref={node=>node?.focus({preventScroll:true})} onClick={()=>{setCommentTarget({...commentMenu,nonce:Date.now()});setCommentMenu(null);}}>Comment on selected text</button>
+    </div>}
+    <article className="requirements-paper" aria-label="Requirements document">
+      <header className="requirements-cover">
+        <p className="document-kicker">AtMem AI Architect · Working requirements</p>
+        <h2>{project.name || 'Solution requirements'}</h2>
+        <p className="document-subtitle">Where we’ve reached</p>
+        <p>This document brings together the requirements developed from our board and discussion. Proposed requirements remain open for review as the design evolves.</p>
+        <p className="document-meta">Design revision {project.revision || 1} · Working draft</p>
+      </header>
+      <section className="requirements-chapter"><h3>Purpose and scope</h3>
+        <p>{purpose || 'We are developing the scope together. Describe the outcome you want in chat, and this document will grow with the design.'}</p>
+      </section>
+      <section className="requirements-chapter"><h3>How the system works</h3><p>{system.overview}</p>{system.flows.map((f,i)=><div className="system-interaction" key={f.id}><h4>{i+1}. {f.title}</h4><p>{f.description}</p><p>{f.contract}</p><p className="document-meta">Proposed verification: {f.validation}</p></div>)}</section>
+      <section className="requirements-chapter"><h3>Component responsibilities and design rationale</h3>{system.components.map(c=><section key={c.id} id={`component-spec-${c.id}`} className="system-component"><h4>{c.name}</h4><p className="document-meta">{c.service} · {c.placement}</p><p>{c.purpose}</p><p>{c.boundary}</p><h5>Inputs and outputs</h5><ul>{[...c.inputs,...c.outputs].map((v,i)=><li key={i}>{v}</li>)}</ul>{!c.inputs.length&&!c.outputs.length&&<p>No connections are drawn for this component.</p>}<h5>Contribution to requirements</h5>{c.requirements.length?<ul>{c.requirements.map(r=><li key={r}>{r}</li>)}</ul>:<p>No requirement is explicitly linked to this component yet.</p>}<h5>Implementation and verification</h5><p>{c.implementation}</p><p className="document-meta">Engineering considerations, to be confirmed during implementation:</p><ul>{c.engineering.map(v=><li key={v}>{v}</li>)}</ul></section>)}</section>
+      {[...groups].sort(([a],[b])=>(a==='suggested')-(b==='suggested')).map(([key,rows])=>{const Tag='section';return <Tag className="requirements-chapter" key={key}>
+        {key==='suggested'?<h4>Suggestions still to discuss ({rows.length})</h4>:<h3>{titles[key] || 'Additional requirements'}</h3>}
+        {key==='suggested'&&<p className="document-meta">These are early considerations, not agreed requirements. We’ll discuss the most relevant ones as the design develops.</p>}
+        {rows.map(r=><div className="requirement-paragraph" key={r.id}>
+          <h4 className="requirement-number">{requirementNumber(project,r.id)}</h4>
+          <p className="requirement-text" onContextMenu={event=>textMenu(event,r)}>{r.statement}</p>
+          {r.measure && <p className="acceptance-target">Acceptance target: {r.measure.metric} {r.measure.op} {r.measure.target} {r.measure.unit || ''}.</p>}
+          <p className="document-meta">{r.source === 'agent' ? 'Proposed for discussion' : 'Recorded from our discussion'}{r.links?.length ? ` · Related design: ${r.links.map(id=>names[id] || 'earlier component').join(', ')}` : ''}</p>
+          <div className="requirement-reason"><p><strong>{r.rationale?"Why this matters.":"Design explanation (guidance)."}</strong> {requirementExplanation(r)}</p>{r.basis&&<p className="document-meta">Basis: {r.basis}</p>}<button className="link document-discuss" onClick={()=>onDiscuss(`Explain why ${requirementNumber(project,r.id)} (${r.id}) is needed: ${r.statement}. Use the actual board and discussion as evidence, distinguish assumptions, explain the consequence of leaving it out, and ask whether it fits my needs.`)}>Explain why we need this</button></div>
+          <RequirementComments onReview={onReview} reviewing={reviewing} onDiscuss={onDiscuss} onResolve={(id,accept)=>onChange(resolveCommentRevision(project,id,accept))} target={commentTarget} number={requirementNumber(project,r.id)} requirement={r} comments={comments.filter(c=>c.requirementId===r.id)} onSave={(text,selectedText,review)=>{const comment={id:crypto.randomUUID(),requirementId:r.id,text,selectedText,statement:r.statement,status:'open',createdAt:new Date().toISOString()};saveComments([...comments,comment]);if(review)onReview([comment]);}} onRemove={id=>saveComments(comments.filter(c=>c.id!==id))} />
+        </div>)}
+        <button className="link document-discuss" onClick={()=>onDiscuss(`Let's discuss the ${titles[key] || key} section of our requirements document further. Current requirements: ${rows.map(r=>`${r.id}: ${r.statement}`).join('; ')}. Ask one useful question and refine the document from my answer.`)}>Discuss this section further in chat</button>
+      </Tag>;})}
+      {!needs.length && <section className="requirements-chapter"><h3>Requirements to develop</h3><p>As we discuss the idea and shape the board, AtMem AI Architect will summarise the functional requirements, constraints and acceptance targets here.</p></section>}
+      {!!project.assumptions?.length && <section className="requirements-chapter"><h3>Assumptions to validate</h3>{project.assumptions.map(a=><p key={a.id}>{a.statement}</p>)}</section>}
+      {!!questions.length && <section className="requirements-chapter"><h3>Open questions</h3>{questions.map(q=><p key={q.id}>{q.question}</p>)}<button className="link document-discuss" onClick={()=>onDiscuss(`Help resolve the open questions in our requirements document, one at a time. Start with the question that most affects the design.`)}>Let’s work through these in chat</button></section>}
+      {checks&&<section className="requirements-chapter"><h3>Design checks and decisions</h3>{checks}</section>}
+      <footer className="document-footer">{onContinue&&<button className="btn primary" disabled={reviewing} onClick={onContinue}>Continue to Choices →</button>}</footer>
+    </article>
+  </section>;
+}