antisketch 1.2.0 → 1.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Harsh Joshi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,6 +4,8 @@ Turn websites you like into design skills for your coding agent.
 
 Paste a link. Antisketch studies the site's typography, colors, spacing, and interactions, then builds two demos that use those ideas for different tasks. Review the results, ask for changes, and save the version you like as a skill.
 
+![Antisketch demo: paste a reference URL, review the captured design, try two generated demos, and approve one as a skill](https://josharsh.github.io/Josharsh/assets/antisketch/demo.gif)
+
 The aim is to give your agent a useful understanding of a design: what gives it character, how the pieces work together, and how to apply it somewhere else.
 
 ## Install
@@ -27,7 +29,7 @@ Choose **Connect Codex** and sign in through the browser. If you're already sign
 4. Ask for another revision if something feels off.
 5. Pick a demo and approve the design when you're happy with it.
 
-Preparation has several passes: capture desktop and mobile sections, write two distinct concept briefs, create original SVG artwork, build each demo, then render and test it. The two experiments build concurrently, with artwork, HTML/CSS, and JavaScript generated in separate passes to keep each response manageable. Codex compares the screenshots with the reference and gets one refinement pass when the review finds issues. This takes longer and uses more of your Codex allowance than a single generation. The visual review is visible beside the experiments; it helps you judge the result, but it isn't a quality guarantee.
+Preparation has several passes: capture desktop and mobile sections, write two distinct concept briefs, create original SVG artwork, build each demo, then render and test it. The two experiments build concurrently, with artwork, HTML/CSS, and JavaScript generated in separate passes to keep each response manageable. Codex compares the screenshots with the reference and gets one refinement pass when the review finds issues; experiments that need it are refined concurrently too, and a step that stalls is retried once automatically. This takes longer and uses more of your Codex allowance than a single generation. The visual review is visible beside the experiments; it helps you judge the result, but it isn't a quality guarantee.
 
 You decide what gets approved. An approved skill includes the design spec, tokens, supporting evidence, and your chosen demo. Earlier approvals stay available when you make a new revision.
 

package/app/public/app.js

@@ -2,7 +2,7 @@
 const $=s=>document.querySelector(s),$$=s=>[...document.querySelectorAll(s)];
 const esc=v=>String(v??'').replace(/[&<>"']/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
 const active=['queued','capturing','interpreting','validating'];
-let session=null,designs=[],releases=[],detail=null,tab='reference',selectedDemo=1,device='desktop',screenshot=0,revision=null,search='',routeGeneration=0,polling=false;
+let session=null,designs=[],releases=[],detail=null,tab='reference',selectedDemo=1,device='desktop',screenshot=0,revision=null,search='',routeGeneration=0,polling=false,elapsedTimer=null;
 let pollFingerprint='',listFingerprint='',resizeObserver,approvalTarget=null;
 const main=$('#main');
 async function api(url,options={}){const response=await fetch(url,{...options,headers:{'Content-Type':'application/json',...(session?{'X-Antisketch-Token':session.token}:{}),...options.headers}});const result=await response.json();if(!response.ok){const error=new Error(result.error||'Unable to complete this action');error.id=result.id;throw error;}return result;}
@@ -30,6 +30,7 @@ function renderList(mode){main.className='collection-page';listFingerprint=JSON.
 }
 function renderDetail(){main.className='detail-page';const d=detail,r=d.selectedRevision;renderNav(r.status==='approved'?'library':d.archived?'archive':'inbox');$('#breadcrumb').textContent='Your workspace / '+d.name;const editable=r.number===d.current_revision;const busy=active.includes(r.status);const release=d.releases.find(x=>x.revision===r.number);
  main.innerHTML=`<div class="meta-row"><a href="#inbox">← Your desk</a>${badge(r.status)}<label>Revision <select id="revision-select" aria-label="View revision">${d.revisions.map(v=>`<option value="${v.number}" ${v.number===r.number?'selected':''}>${v.number} · ${esc(v.status)}</option>`).join('')}</select></label><a href="${esc(d.url)}" target="_blank" rel="noopener noreferrer">${esc(new URL(d.url).hostname)} ↗</a></div><div class="detail-head"><div><h1>${esc(d.summary?.name||d.name)}</h1><p>${esc(d.summary?.summary||'We’re gathering the details that give this reference its character. You can leave this screen; preparation continues while the app is running.')}</p></div><div class="detail-actions">${release?`<button class="button small" data-use-release="${release.id}">Use in… ↗</button><a class="button secondary small" href="/api/releases/${release.id}/download">Download skill ↓</a>`:''}${!busy&&editable?`<button class="button secondary small" id="archive-button">${d.archived?'Restore to inbox':'Archive'}</button>`:''}</div></div>${!editable?'<div class="notice">You’re looking at a previous revision. Its record is preserved; changes and approval happen on the latest revision.</div>':''}${r.status==='approved'?`<div class="notice">Version ${release?.version||''} is approved and frozen. Start a new revision below whenever your taste evolves.</div>`:''}${busy?progressHTML(r):r.status==='failed'||r.status==='cancelled'?`<div class="progress-card"><span class="eyebrow">${r.status==='failed'?'NEEDS A LITTLE ATTENTION':'STOPPED FOR NOW'}</span><h2>${r.status==='failed'?'Let’s give this another look.':'Your work is still here.'}</h2><p class="muted">${esc(r.error||r.stage)}</p><button class="button" id="retry-button">Retry extraction ↗</button>${d.capture?'<p class="fine">Captured evidence is retained below, even though this revision is incomplete.</p>':''}</div>`:''}${d.summary||d.capture?`<div class="tabs" role="tablist" aria-label="Review sections">${[['reference','01','Reference'],['language','02','Design language'],['experiments','03','Experiments'],['review','04','Review & keep']].map(([id,n,label])=>`<button role="tab" id="tab-${id}" aria-controls="tab-content" aria-selected="${tab===id}" tabindex="${tab===id?'0':'-1'}" data-tab="${id}" class="${tab===id?'active':''}"><span>${n}</span>${label}</button>`).join('')}</div><section id="tab-content" role="tabpanel" aria-labelledby="tab-${tab}"></section>`:''}`;
+ clearInterval(elapsedTimer);if(busy){const since=Date.parse(r.updated_at);const tick=()=>{const el=$('#elapsed');if(!el)return;const s=Math.max(0,Math.round((Date.now()-since)/1000));el.textContent=`${Math.floor(s/60)}:${String(s%60).padStart(2,'0')}`;};tick();elapsedTimer=setInterval(tick,1000);}
  $('#revision-select').addEventListener('change',e=>{location.hash=`design/${d.id}/${e.target.value}`;});
  $('#archive-button')?.addEventListener('click',()=>mutate(async()=>{await api(`/api/designs/${d.id}/archive`,{method:'POST',body:JSON.stringify({archived:!d.archived})});toast(d.archived?'Back on your desk':'Reference archived');await refreshLists();await loadDetail(d.id,r.number); }));
  $('#cancel-button')?.addEventListener('click',()=>mutate(async()=>{await api(`/api/designs/${d.id}/cancel`,{method:'POST',body:'{}'});await loadDetail(d.id,r.number);}));
@@ -38,7 +39,7 @@ function renderDetail(){main.className='detail-page';const d=detail,r=d.selected
  $('.tabs')?.addEventListener('keydown',e=>{if(!['ArrowLeft','ArrowRight','Home','End'].includes(e.key))return;e.preventDefault();const tabs=$$('[data-tab]');let i=tabs.indexOf(document.activeElement);i=e.key==='Home'?0:e.key==='End'?tabs.length-1:(i+(e.key==='ArrowRight'?1:-1)+tabs.length)%tabs.length;tabs[i].click();});
  renderTab();
 }
-function progressHTML(r){const stages=['queued','capturing','interpreting','validating'],current=stages.indexOf(r.status);return `<div class="progress-card"><div class="spinner" aria-hidden="true"></div><h2>${esc(r.stage)}</h2><p class="muted">We’re preparing an evidence-backed design study and two working applications. This usually takes several minutes. You can keep browsing your collection.</p><div class="steps">${['Queued','Capture','Interpret & create','Check'].map((x,i)=>`<span class="step ${i<current?'done':i===current?'current':''}">${i<current?'✓':String(i+1).padStart(2,'0')} ${x}</span>`).join('')}</div><button class="button secondary small" id="cancel-button">Cancel preparation</button></div>`;}
+function progressHTML(r){const stages=['queued','capturing','interpreting','validating'],current=stages.indexOf(r.status);return `<div class="progress-card"><div class="spinner" aria-hidden="true"></div><h2>${esc(r.stage)} <span class="elapsed" id="elapsed"></span></h2><p class="muted">We’re preparing an evidence-backed design study and two working applications. This usually takes about ten minutes; each step takes a minute or two. You can keep browsing your collection.</p><div class="steps">${['Queued','Capture','Interpret & create','Check'].map((x,i)=>`<span class="step ${i<current?'done':i===current?'current':''}">${i<current?'✓':String(i+1).padStart(2,'0')} ${x}</span>`).join('')}</div><button class="button secondary small" id="cancel-button">Cancel preparation</button></div>`;}
 function renderTab(){resizeObserver?.disconnect();const root=$('#tab-content');if(!root)return;const d=detail,r=d.selectedRevision;
  if(tab==='reference'){const c=d.capture;if(!c){root.innerHTML='<p class="muted">Reference captures will appear here when inspection finishes.</p>';return;}screenshot=Math.min(screenshot,c.screenshots.length-1);const s=c.screenshots[screenshot];root.innerHTML=`<div class="split"><div class="panel"><div class="panel-top"><select id="capture-select" aria-label="Reference capture">${c.screenshots.map((s,i)=>`<option value="${i}" ${i===screenshot?'selected':''}>${esc(s.label)}</option>`).join('')}</select><span>${s?.viewport?esc(s.viewport.width+' × '+s.viewport.height):'CAPTURED REFERENCE'}</span></div>${s?`<a href="${file(s.file)}" target="_blank" rel="noopener"><img class="reference-image" src="${file(s.file)}" alt="${esc(s.label)}"></a>`:'<p>No screenshot available.</p>'}</div><aside><div class="side-note"><span class="eyebrow">WHAT WE LOOKED AT</span><h3 style="margin-top:15px">Captured ${date(c.capturedAt)}</h3><span class="metric">${c.coverage.routes.length} <small style="font:12px var(--sans)">pages sampled</small></span><p>${c.coverage.viewports.map(esc).join('<br>')}</p></div><div class="side-note"><h3>States inspected</h3>${c.coverage.states.map(x=>`<span class="scope-pill">${esc(x)}</span>`).join('')}</div><div class="side-note"><h3>Know the edges</h3><ul>${[...c.warnings,...c.coverage.limits].map(x=>`<li>${esc(x)}</li>`).join('')}</ul></div><p class="fine">Source imagery is reference material. Approval does not grant permission to reuse its photos, logos, or fonts.</p></aside></div>`;$('#capture-select').addEventListener('change',e=>{screenshot=Number(e.target.value);renderTab();});return;}
  if(!d.summary){root.innerHTML='<div class="notice">The design interpretation is not ready yet. Check the reference captures or retry preparation.</div>';return;}

package/app/public/style.css

@@ -314,3 +314,5 @@ button.connection{border:0;background:none;padding:6px 0;font:9px var(--mono);co
 #settings-dialog{max-width:620px}#settings-dialog h2{font-size:42px;line-height:1.05;letter-spacing:-1.7px}
 .setup-intro{color:var(--muted);line-height:1.7;margin:18px 0 28px}.setup-connection{border-top:1px solid var(--ink);padding-top:20px}.setup-step{display:flex;justify-content:space-between;gap:20px;font:9px var(--mono);letter-spacing:.04em;color:var(--muted)}.setup-state{text-transform:uppercase}.setup-state.ready{color:var(--ink)}.setup-connection h3{font:500 25px var(--display);letter-spacing:-.7px;margin:22px 0 12px}.setup-account{font-size:13px;margin-bottom:12px;overflow-wrap:anywhere}.setup-account span{color:var(--muted)}.setup-connection>.muted{font-size:12px;line-height:1.7}.setup-actions{display:flex;flex-wrap:wrap;align-items:center;gap:18px;margin:24px 0}.setup-actions .fine{flex-basis:100%;margin:0}.setup-browser{border-top:1px solid var(--line);border-bottom:1px solid var(--line);padding:20px 0}.setup-browser p{font-size:12px;line-height:1.7;margin:13px 0 0}.setup-browser .text-button,.setup-browser .link-button{margin:15px 20px 0 0}.setup-data-note{margin:20px 0}.setup-storage{margin-top:24px;border-top:1px solid var(--line);padding-top:20px;font-size:12px}.setup-storage summary{cursor:pointer;font:10px var(--mono)}.setup-storage p{margin:18px 0 8px}.setup-storage code{display:block;overflow-wrap:anywhere;font-size:10px}.setup-storage a{display:inline-block;margin-top:15px}#setup-error:empty{display:none}#setup-error{margin:15px 0}
 @media(max-width:600px){#settings-dialog h2{font-size:34px}.setup-connection h3{font-size:23px}.setup-actions .button{width:100%}.setup-step{font-size:8px;gap:10px}}
+
+.elapsed{font:13px var(--mono,ui-monospace,monospace);color:var(--muted,#6b7280);font-variant-numeric:tabular-nums;font-weight:400;vertical-align:middle}

package/app/server/generate.js

@@ -6,7 +6,11 @@ import os from 'node:os';
 import {z} from 'zod';
 import {atomic,readJSON} from './files.js';
 function providerError(message){return String(message||'Provider reported an error').replace(/https?:\/\/\S+/g,'[URL]').replace(/(?:Bearer\s+\S+|sk-[\w-]+|eyJ[\w.-]+)/gi,'[redacted]').slice(0,400);}
-export async function runPhase({schema,prompt,images=[],dir,phase,effort=phase==='design-direction'?'high':'medium',model=process.env.ANTISKETCH_MODEL||null,signal,onProgress=()=>{},label=phase}){
+// A phase asks for a few thousand output tokens and normally finishes within two minutes. One that runs
+// several times longer is a stalled stream rather than slow work, so it is killed and tried once more.
+// Errors marked retry:false are deterministic (output limit, auth, quota, cancel) and fail immediately.
+const failure=(message,retry)=>Object.assign(new Error(message),{retry});
+export async function runPhase({schema,prompt,images=[],dir,phase,effort=phase==='design-direction'?'high':'medium',model=process.env.ANTISKETCH_MODEL||null,signal,onProgress=()=>{},label=phase,deadlineMs=(phase==='design-direction'?8:5)*60*1000}){
  signal?.throwIfAborted();
  const temp=fs.mkdtempSync(path.join(os.tmpdir(),'antisketch-agent-'));
  try{
@@ -15,20 +19,26 @@ export async function runPhase({schema,prompt,images=[],dir,phase,effort=phase==
   const args=['exec','--ignore-user-config','--ephemeral','--skip-git-repo-check','--sandbox','read-only','-c',`model_reasoning_effort="${effort}"`,'-c','features.shell_tool=false','-c','web_search="disabled"','-c','project_doc_max_bytes=0','--output-schema',schemaPath,'--output-last-message',output,'--color','never','--json','-C',temp];
   for(const file of images)if(fs.existsSync(file))args.push('--image',file);
   if(model)args.push('--model',model);
-  args.push('-');onProgress(label);
-  const started=Date.now();const diagnostics={phase,model:model||'Codex default (unresolved)',reasoningEffort:effort,startedAt:new Date().toISOString(),events:0,lastEvent:null,lastItem:null,usage:null};await new Promise((resolve,reject)=>{
-   const env=codexEnvironment();const executable=codexCommand();
-   const child=spawn(executable.command,[...executable.prefix,...args],{env,stdio:['pipe','pipe','pipe'],detached:process.platform!=='win32'});let stderr='',bytes=0,finished=false,pending='';
-   const heartbeat=setInterval(()=>{atomic(path.join(dir,`phase-${phase}.json`),{...diagnostics,durationMs:Date.now()-started,running:true});onProgress(`${label} · ${Math.max(1,Math.floor((Date.now()-started)/60000))} min`);},60000);heartbeat.unref();
-   const stop=()=>{try{if(process.platform!=='win32')process.kill(-child.pid,'SIGTERM');else child.kill('SIGTERM');}catch{}setTimeout(()=>{try{if(process.platform!=='win32')process.kill(-child.pid,'SIGKILL');else child.kill('SIGKILL');}catch{}},1500).unref();};
-   const abort=()=>{stop();done(new Error('Preparation cancelled'));};const timer=setTimeout(()=>{stop();done(new Error(`${label} timed out after 12 minutes.${diagnostics.lastProviderError?' Last provider error: '+diagnostics.lastProviderError:' Retry this revision.'}`));},12*60*1000);
-   function done(error){if(finished)return;finished=true;atomic(path.join(dir,`phase-${phase}.json`),{...diagnostics,durationMs:Date.now()-started,error:error?.message||null});clearTimeout(timer);clearInterval(heartbeat);signal?.removeEventListener('abort',abort);error?reject(error):resolve();}
-   signal?.addEventListener('abort',abort,{once:true});if(signal?.aborted){abort();return;}
-   child.stdout.on('data',chunk=>{pending+=chunk.toString();const lines=pending.split('\n');pending=lines.pop();for(const line of lines){try{const event=JSON.parse(line);diagnostics.events++;diagnostics.lastEvent=event.type;if(event.item?.type)diagnostics.lastItem=event.item.type;if(event.usage)diagnostics.usage=event.usage;if(event.type==='error'||event.type==='turn.failed'){diagnostics.lastProviderError=providerError(event.message||event.error?.message);onProgress(`${label} · Codex reported an error${event.type==='error'?'; waiting for retry':''}`);atomic(path.join(dir,`phase-${phase}.json`),{...diagnostics,durationMs:Date.now()-started,running:true});if(event.type==='turn.failed'||/max_output_tokens/.test(diagnostics.lastProviderError)){stop();done(new Error('Codex could not complete '+label+': '+diagnostics.lastProviderError));}}}catch{}}bytes+=chunk.length;if(bytes>5_000_000){stop();done(new Error('Interpretation output exceeded its size limit'));}});
-   child.stderr.on('data',chunk=>{stderr=(stderr+chunk.toString()).slice(-6000);});child.on('error',e=>done(new Error(e.code==='ENOENT'?'Codex CLI is not installed. Open Studio settings to reconnect.':e.message)));child.on('close',code=>done(code===0?null:new Error(/rate.limit|usage.limit|quota/i.test(stderr)?'Codex usage limit reached. Retry after your allowance resets.':/auth|login|unauthorized|401/i.test(stderr)?'Codex needs authentication. Open Studio settings to reconnect, then retry.':`Codex could not complete this revision (exit ${code}). Check codex login status and retry.`)));
-   child.stdin.on('error',()=>{});child.stdin.end(prompt);
-  });
-  if(!fs.existsSync(output))throw new Error('Codex returned no result for '+phase+'. Retry the revision.');
+  args.push('-');
+  const attempt=async number=>{
+   const started=Date.now();const diagnostics={phase,attempt:number,model:model||'Codex default (unresolved)',reasoningEffort:effort,startedAt:new Date().toISOString(),events:0,lastEvent:null,lastItem:null,usage:null};
+   await new Promise((resolve,reject)=>{
+    const env=codexEnvironment();const executable=codexCommand();
+    const child=spawn(executable.command,[...executable.prefix,...args],{env,stdio:['pipe','pipe','pipe'],detached:process.platform!=='win32'});let stderr='',bytes=0,finished=false,pending='';
+    const heartbeat=setInterval(()=>atomic(path.join(dir,`phase-${phase}.json`),{...diagnostics,durationMs:Date.now()-started,running:true}),60000);heartbeat.unref();
+    const stop=()=>{try{if(process.platform!=='win32')process.kill(-child.pid,'SIGTERM');else child.kill('SIGTERM');}catch{}setTimeout(()=>{try{if(process.platform!=='win32')process.kill(-child.pid,'SIGKILL');else child.kill('SIGKILL');}catch{}},1500).unref();};
+    const abort=()=>{stop();done(failure('Preparation cancelled',false));};const timer=setTimeout(()=>{stop();done(failure(`${label} took longer than ${Math.round(deadlineMs/60000)} minutes.${diagnostics.lastProviderError?' Last provider error: '+diagnostics.lastProviderError:''}`,true));},deadlineMs);
+    function done(error){if(finished)return;finished=true;atomic(path.join(dir,`phase-${phase}.json`),{...diagnostics,durationMs:Date.now()-started,error:error?.message||null});clearTimeout(timer);clearInterval(heartbeat);signal?.removeEventListener('abort',abort);error?reject(error):resolve();}
+    signal?.addEventListener('abort',abort,{once:true});if(signal?.aborted){abort();return;}
+    child.stdout.on('data',chunk=>{pending+=chunk.toString();const lines=pending.split('\n');pending=lines.pop();for(const line of lines){try{const event=JSON.parse(line);diagnostics.events++;diagnostics.lastEvent=event.type;if(event.item?.type)diagnostics.lastItem=event.item.type;if(event.usage)diagnostics.usage=event.usage;if(event.type==='error'||event.type==='turn.failed'){diagnostics.lastProviderError=providerError(event.message||event.error?.message);onProgress(`${label} · Codex reported an error${event.type==='error'?'; waiting for retry':''}`);atomic(path.join(dir,`phase-${phase}.json`),{...diagnostics,durationMs:Date.now()-started,running:true});const limit=/max_output_tokens/.test(diagnostics.lastProviderError);if(event.type==='turn.failed'||limit){stop();done(failure('Codex could not complete '+label+': '+diagnostics.lastProviderError,!limit));}}}catch{}}bytes+=chunk.length;if(bytes>5_000_000){stop();done(failure('Interpretation output exceeded its size limit',false));}});
+    child.stderr.on('data',chunk=>{stderr=(stderr+chunk.toString()).slice(-6000);});child.on('error',e=>done(failure(e.code==='ENOENT'?'Codex CLI is not installed. Open Studio settings to reconnect.':e.message,false)));child.on('close',code=>done(code===0?null:/rate.limit|usage.limit|quota/i.test(stderr)?failure('Codex usage limit reached. Retry after your allowance resets.',false):/auth|login|unauthorized|401/i.test(stderr)?failure('Codex needs authentication. Open Studio settings to reconnect, then retry.',false):failure(`Codex could not complete this revision (exit ${code}). Check codex login status and retry.`,true)));
+    child.stdin.on('error',()=>{});child.stdin.end(prompt);
+   });
+   if(!fs.existsSync(output))throw failure('Codex returned no result for '+phase+'. Retry the revision.',true);
+  };
+  onProgress(label);
+  try{await attempt(1);}
+  catch(error){if(!error.retry||signal?.aborted)throw error;onProgress(`${label} · trying again`);await attempt(2);}
   return schema.parse(readJSON(output));
  }finally{fs.rmSync(temp,{recursive:true,force:true});}
 }

package/app/server/interpret.js

@@ -89,17 +89,19 @@ EVIDENCE:\n${JSON.stringify(evidence)}`);
   const critique=await call(`visual-review-${round}`,schema,`Act as a demanding design reviewer. First ${images.length} attached images are SOURCE captures in this order: ${JSON.stringify(capture.screenshots.filter(s=>images.includes(path.join(dir,s.file))).map(s=>s.id))}. Last four are GENERATED experiment 1 desktop/mobile, experiment 2 desktop/mobile. Compare rendered visual evidence, not the promise of the brief. Score identity transfer, task-specific composition, visual craft, interaction each 1–5. 3 means credible, 5 exceptional. Flag flattened artwork, diminished visual scale, wrong typography/hierarchy, generic repeated layouts, decorative assets disconnected from the task, clipping and failed interactions. Do not reward copying the source subject. Check if the two concepts actually differ. Ask for specific implementable fixes if any dimension is below 3 or functional checks fail. Aesthetic scores are advisory, not user approval. Direction: ${brief}\nBrowser checks: ${JSON.stringify(validation)}`, [...images,...previews]);
   atomic(path.join(dir,`visual-review-${round}.json`),critique);return critique;
  };
- onProgress('Comparing the rendered experiments with the reference');let critique=await review('initial');let repaired=false;
- for(let i=0;i<2;i++){
-  const c=critique.experiments[i];const failures=validation.checks.filter(check=>check.demo===i+1&&!check.passed);
-  if(!critique.distinct||c.needsRevision||Math.min(c.identity,c.composition,c.craft,c.interaction)<3||failures.length){
+ onProgress('Comparing the rendered experiments with the reference');let critique=await review('initial');
+ const needsWork=i=>{const c=critique.experiments[i];return !critique.distinct||c.needsRevision||Math.min(c.identity,c.composition,c.craft,c.interaction)<3||validation.checks.some(check=>check.demo===i+1&&!check.passed);};
+ const repairs=[0,1].filter(needsWork);const repaired=repairs.length>0;
+ if(repaired){
+  await runTogether(repairs.map(i=>async refineSignal=>{
+   const c=critique.experiments[i];const failures=validation.checks.filter(check=>check.demo===i+1&&!check.passed);
    onProgress(`Refining experiment ${i+1} after visual and interaction review`);
-   const artwork=c.craft<3?await illustrate(i,`refine-artwork-${i+1}`,signal,c.issues.join(' ')):result.demos[i].artwork;
-   const build=await buildInterface(i,artwork,signal,{review:c,comparison:critique.comparison,failures,html:result.demos[i].html,tests:result.demos[i].tests});
-   atomic(path.join(dir,`refine-experiment-${i+1}.json`),build);result.demos[i]={...plan.concepts[i],...build,artwork};repaired=true;
-  }
+   const artwork=c.craft<3?await illustrate(i,`refine-artwork-${i+1}`,refineSignal,c.issues.join(' ')):result.demos[i].artwork;
+   const build=await buildInterface(i,artwork,refineSignal,{review:c,comparison:critique.comparison,failures,html:result.demos[i].html,tests:result.demos[i].tests});
+   atomic(path.join(dir,`refine-experiment-${i+1}.json`),build);result.demos[i]={...plan.concepts[i],...build,artwork};
+  }),signal);
+  write();onProgress('Checking the refined experiments');validation=await render(dir,{signal});critique=await review('final');
  }
- if(repaired){write();onProgress('Checking the refined experiments');validation=await render(dir,{signal});critique=await review('final');}
  result.visualReview={...critique,repaired,scope:'Automated visual critique, advisory only. Your approval is still required.'};
  result.limitations=[...new Set([...plan.limitations,...result.demos.flatMap(d=>[...d.limitations,...d.artwork.limitations]),...critique.experiments.flatMap((c,i)=>c.issues.map(x=>`Experiment ${i+1} review: ${x}`))])];
  atomic(path.join(dir,'interpretation.json'),result);atomic(path.join(dir,'generation.json'),{provider:'Codex CLI',durationMs:Date.now()-started,createdAt:new Date().toISOString(),schemaVersion:2,model:model||'Codex default (unresolved)',reasoningEffort:{direction:'high',build:'medium',review:'medium'},repaired});return result;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antisketch",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "type": "module",
   "engines": {
     "node": ">=20.17"
@@ -33,6 +33,22 @@
     "design-vault": "bin/design-vault"
   },
   "description": "A local workshop for turning design references into reusable agent skills.",
+  "license": "MIT",
+  "author": "Harsh Joshi <harsh.joshi.pth@gmail.com>",
+  "homepage": "https://github.com/josharsh/antisketch#readme",
+  "bugs": {
+    "url": "https://github.com/josharsh/antisketch/issues"
+  },
+  "keywords": [
+    "design",
+    "design-system",
+    "design-tokens",
+    "agent-skills",
+    "codex",
+    "claude-code",
+    "playwright",
+    "mcp"
+  ],
   "os": [
     "darwin"
   ],
@@ -56,7 +72,8 @@
     "app/public/brand/mark.svg",
     "app/public/brand/favicon.svg",
     "app/public/brand/identity.json",
-    "app/public/brand/identity.css"
+    "app/public/brand/identity.css",
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public",