mirror of
https://github.com/garrytan/gstack.git
synced 2026-07-12 10:46:35 +02:00
feat: design binary core — generate, check, compare commands
Stateless CLI (design/dist/design) wrapping OpenAI Responses API for UI mockup generation. Three working commands: - generate: brief -> PNG mockup via gpt-4o + image_generation tool - check: vision-based quality gate via GPT-4o (text readability, layout completeness, visual coherence) - compare: generates self-contained HTML comparison board with star ratings, radio Pick, per-variant feedback, regenerate controls, and Submit button that writes structured JSON for agent polling Auth reads from ~/.gstack/openai.json (0600), falls back to OPENAI_API_KEY env var. Compiled separately from browse binary (openai added to devDependencies, not runtime deps). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Garry Tan
@@ -0,0 +1,404 @@
|
||||
/**
|
||||
* Generate HTML comparison board for user review of design variants.
|
||||
* Opens in headed Chrome via $B goto. User picks favorite, rates, comments, submits.
|
||||
* Agent reads feedback from hidden DOM element.
|
||||
*
|
||||
* Design spec: single column, full-width mockups, APP UI aesthetic.
|
||||
*/
|
||||
|
||||
import fs from "fs";
|
||||
import path from "path";
|
||||
|
||||
export interface CompareOptions {
|
||||
images: string[];
|
||||
output: string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Generate the comparison board HTML page.
|
||||
*/
|
||||
export function generateCompareHtml(images: string[]): string {
|
||||
const variantLabels = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
|
||||
|
||||
const variantCards = images.map((imgPath, i) => {
|
||||
const label = variantLabels[i] || `${i + 1}`;
|
||||
// Embed images as base64 data URIs for self-contained HTML
|
||||
const imgData = fs.readFileSync(imgPath).toString("base64");
|
||||
const ext = path.extname(imgPath).slice(1) || "png";
|
||||
|
||||
return `
|
||||
<div class="variant" data-variant="${label}">
|
||||
<img src="data:image/${ext};base64,${imgData}" alt="Variant ${label}" />
|
||||
<div class="variant-controls">
|
||||
<label class="pick-label">
|
||||
<input type="radio" name="preferred" value="${label}" />
|
||||
<span class="pick-text">Pick</span>
|
||||
</label>
|
||||
<div class="stars" data-variant="${label}">
|
||||
${[1,2,3,4,5].map(n => `<span class="star" data-value="${n}">★</span>`).join("")}
|
||||
</div>
|
||||
<input type="text" class="feedback-input" data-variant="${label}"
|
||||
placeholder="What do you like/dislike?" />
|
||||
<button class="more-like-this" data-variant="${label}">More like this</button>
|
||||
</div>
|
||||
</div>`;
|
||||
}).join("\n");
|
||||
|
||||
return `<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
<title>Design Exploration</title>
|
||||
<style>
|
||||
* { margin: 0; padding: 0; box-sizing: border-box; }
|
||||
body {
|
||||
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
|
||||
background: #fff;
|
||||
color: #333;
|
||||
}
|
||||
|
||||
.header {
|
||||
padding: 16px 24px;
|
||||
border-bottom: 1px solid #e5e5e5;
|
||||
display: flex;
|
||||
justify-content: space-between;
|
||||
align-items: center;
|
||||
}
|
||||
.header h1 { font-size: 16px; font-weight: 600; }
|
||||
.header .meta { font-size: 13px; color: #999; }
|
||||
|
||||
.variants { max-width: 1200px; margin: 0 auto; padding: 0 24px; }
|
||||
|
||||
.variant {
|
||||
border-bottom: 1px solid #e5e5e5;
|
||||
padding: 24px 0;
|
||||
}
|
||||
.variant:last-child { border-bottom: none; }
|
||||
|
||||
.variant img {
|
||||
width: 100%;
|
||||
height: auto;
|
||||
display: block;
|
||||
border-radius: 4px;
|
||||
}
|
||||
|
||||
.variant-controls {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 16px;
|
||||
padding: 12px 0 0;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
.pick-label {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 4px;
|
||||
cursor: pointer;
|
||||
font-size: 14px;
|
||||
font-weight: 600;
|
||||
}
|
||||
.pick-label input[type="radio"] { accent-color: #000; }
|
||||
|
||||
.stars { display: flex; gap: 2px; }
|
||||
.star {
|
||||
font-size: 20px;
|
||||
color: #ddd;
|
||||
cursor: pointer;
|
||||
user-select: none;
|
||||
transition: color 0.1s;
|
||||
}
|
||||
.star.filled { color: #000; }
|
||||
.star:hover { color: #666; }
|
||||
|
||||
.feedback-input {
|
||||
flex: 1;
|
||||
min-width: 200px;
|
||||
padding: 6px 10px;
|
||||
border: 1px solid #e5e5e5;
|
||||
border-radius: 4px;
|
||||
font-size: 13px;
|
||||
outline: none;
|
||||
}
|
||||
.feedback-input:focus { border-color: #999; }
|
||||
.feedback-input::placeholder { color: #999; }
|
||||
|
||||
.more-like-this {
|
||||
padding: 6px 12px;
|
||||
background: none;
|
||||
border: 1px solid #e5e5e5;
|
||||
border-radius: 4px;
|
||||
font-size: 13px;
|
||||
cursor: pointer;
|
||||
color: #666;
|
||||
}
|
||||
.more-like-this:hover { border-color: #999; color: #333; }
|
||||
|
||||
.overall-section {
|
||||
max-width: 1200px;
|
||||
margin: 0 auto;
|
||||
padding: 16px 24px;
|
||||
border-top: 1px solid #e5e5e5;
|
||||
}
|
||||
.overall-section summary {
|
||||
font-size: 14px;
|
||||
color: #666;
|
||||
cursor: pointer;
|
||||
padding: 8px 0;
|
||||
}
|
||||
.overall-textarea {
|
||||
width: 100%;
|
||||
padding: 8px 10px;
|
||||
border: 1px solid #e5e5e5;
|
||||
border-radius: 4px;
|
||||
font-size: 13px;
|
||||
resize: vertical;
|
||||
min-height: 60px;
|
||||
margin-top: 8px;
|
||||
outline: none;
|
||||
font-family: inherit;
|
||||
}
|
||||
.overall-textarea:focus { border-color: #999; }
|
||||
|
||||
.regenerate-bar {
|
||||
background: #f7f7f7;
|
||||
padding: 16px 24px;
|
||||
margin-top: 8px;
|
||||
}
|
||||
.regenerate-bar .inner {
|
||||
max-width: 1200px;
|
||||
margin: 0 auto;
|
||||
}
|
||||
.regenerate-bar h3 { font-size: 14px; font-weight: 600; margin-bottom: 10px; }
|
||||
.regen-controls {
|
||||
display: flex;
|
||||
gap: 8px;
|
||||
flex-wrap: wrap;
|
||||
align-items: center;
|
||||
}
|
||||
.regen-chiclet {
|
||||
padding: 6px 14px;
|
||||
background: #fff;
|
||||
border: 1px solid #e5e5e5;
|
||||
border-radius: 16px;
|
||||
font-size: 13px;
|
||||
cursor: pointer;
|
||||
}
|
||||
.regen-chiclet:hover { border-color: #999; }
|
||||
.regen-chiclet.active { border-color: #000; background: #f0f0f0; }
|
||||
.regen-custom {
|
||||
flex: 1;
|
||||
min-width: 150px;
|
||||
padding: 6px 10px;
|
||||
border: 1px solid #e5e5e5;
|
||||
border-radius: 4px;
|
||||
font-size: 13px;
|
||||
outline: none;
|
||||
}
|
||||
.regen-custom:focus { border-color: #999; }
|
||||
.regen-btn {
|
||||
padding: 6px 16px;
|
||||
background: #fff;
|
||||
border: 1px solid #e5e5e5;
|
||||
border-radius: 4px;
|
||||
font-size: 13px;
|
||||
cursor: pointer;
|
||||
font-weight: 600;
|
||||
}
|
||||
.regen-btn:hover { border-color: #000; }
|
||||
|
||||
.submit-bar {
|
||||
max-width: 1200px;
|
||||
margin: 0 auto;
|
||||
padding: 16px 24px;
|
||||
display: flex;
|
||||
justify-content: flex-end;
|
||||
}
|
||||
.submit-btn {
|
||||
padding: 10px 24px;
|
||||
background: #000;
|
||||
color: #fff;
|
||||
border: none;
|
||||
border-radius: 4px;
|
||||
font-size: 14px;
|
||||
font-weight: 600;
|
||||
cursor: pointer;
|
||||
}
|
||||
.submit-btn:hover { background: #333; }
|
||||
.submit-btn:disabled { background: #ccc; cursor: not-allowed; }
|
||||
|
||||
.success-msg {
|
||||
display: none;
|
||||
max-width: 1200px;
|
||||
margin: 24px auto;
|
||||
padding: 16px 24px;
|
||||
background: #f0f9f0;
|
||||
border: 1px solid #c3e6c3;
|
||||
border-radius: 4px;
|
||||
font-size: 14px;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
/* Hidden result elements for agent polling */
|
||||
#status, #feedback-result { display: none; }
|
||||
|
||||
/* Skeleton loading state */
|
||||
.skeleton {
|
||||
background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
|
||||
background-size: 200% 100%;
|
||||
animation: shimmer 1.5s infinite;
|
||||
border-radius: 4px;
|
||||
height: 400px;
|
||||
}
|
||||
@keyframes shimmer {
|
||||
0% { background-position: 200% 0; }
|
||||
100% { background-position: -200% 0; }
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<div class="header">
|
||||
<h1>Design Exploration</h1>
|
||||
<span class="meta">${images.length} variants</span>
|
||||
</div>
|
||||
|
||||
<div class="variants">
|
||||
${variantCards}
|
||||
</div>
|
||||
|
||||
<div class="overall-section">
|
||||
<details>
|
||||
<summary>Overall direction (optional)</summary>
|
||||
<textarea class="overall-textarea" id="overall-feedback"
|
||||
placeholder="Any overall notes about direction?"></textarea>
|
||||
</details>
|
||||
</div>
|
||||
|
||||
<div class="regenerate-bar">
|
||||
<div class="inner">
|
||||
<h3>Want to explore more?</h3>
|
||||
<div class="regen-controls">
|
||||
<button class="regen-chiclet" data-action="different">Totally different</button>
|
||||
<button class="regen-chiclet" data-action="match">Match my design</button>
|
||||
<input type="text" class="regen-custom" id="regen-custom-input"
|
||||
placeholder="Tell us what you want different..." />
|
||||
<button class="regen-btn" id="regen-btn">Regenerate →</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="submit-bar">
|
||||
<button class="submit-btn" id="submit-btn">✓ Submit</button>
|
||||
</div>
|
||||
|
||||
<div class="success-msg" id="success-msg">
|
||||
Feedback submitted! Return to your coding agent.
|
||||
</div>
|
||||
|
||||
<!-- Hidden elements for agent polling -->
|
||||
<div id="status"></div>
|
||||
<div id="feedback-result"></div>
|
||||
|
||||
<script>
|
||||
// Star rating
|
||||
document.querySelectorAll('.stars').forEach(starsEl => {
|
||||
const stars = starsEl.querySelectorAll('.star');
|
||||
let rating = 0;
|
||||
|
||||
stars.forEach(star => {
|
||||
star.addEventListener('click', () => {
|
||||
rating = parseInt(star.dataset.value);
|
||||
stars.forEach(s => {
|
||||
s.classList.toggle('filled', parseInt(s.dataset.value) <= rating);
|
||||
});
|
||||
});
|
||||
});
|
||||
});
|
||||
|
||||
// Regenerate chiclets (toggle active)
|
||||
document.querySelectorAll('.regen-chiclet').forEach(chiclet => {
|
||||
chiclet.addEventListener('click', () => {
|
||||
document.querySelectorAll('.regen-chiclet').forEach(c => c.classList.remove('active'));
|
||||
chiclet.classList.add('active');
|
||||
});
|
||||
});
|
||||
|
||||
// More like this buttons
|
||||
document.querySelectorAll('.more-like-this').forEach(btn => {
|
||||
btn.addEventListener('click', () => {
|
||||
const variant = btn.dataset.variant;
|
||||
// Set regeneration context
|
||||
document.querySelectorAll('.regen-chiclet').forEach(c => c.classList.remove('active'));
|
||||
document.getElementById('regen-custom-input').value = 'More like variant ' + variant;
|
||||
// Trigger regenerate
|
||||
submitRegenerate('more_like_' + variant);
|
||||
});
|
||||
});
|
||||
|
||||
// Regenerate button
|
||||
document.getElementById('regen-btn').addEventListener('click', () => {
|
||||
const activeChiclet = document.querySelector('.regen-chiclet.active');
|
||||
const customInput = document.getElementById('regen-custom-input').value;
|
||||
const action = activeChiclet ? activeChiclet.dataset.action : 'custom';
|
||||
const detail = customInput || action;
|
||||
submitRegenerate(detail);
|
||||
});
|
||||
|
||||
function submitRegenerate(detail) {
|
||||
const feedback = collectFeedback();
|
||||
feedback.regenerated = true;
|
||||
feedback.regenerateAction = detail;
|
||||
document.getElementById('feedback-result').textContent = JSON.stringify(feedback);
|
||||
document.getElementById('status').textContent = 'regenerate';
|
||||
}
|
||||
|
||||
// Submit button
|
||||
document.getElementById('submit-btn').addEventListener('click', () => {
|
||||
const feedback = collectFeedback();
|
||||
feedback.regenerated = false;
|
||||
document.getElementById('feedback-result').textContent = JSON.stringify(feedback);
|
||||
document.getElementById('status').textContent = 'submitted';
|
||||
document.getElementById('submit-btn').disabled = true;
|
||||
document.getElementById('success-msg').style.display = 'block';
|
||||
});
|
||||
|
||||
function collectFeedback() {
|
||||
const preferred = document.querySelector('input[name="preferred"]:checked');
|
||||
const ratings = {};
|
||||
const comments = {};
|
||||
|
||||
document.querySelectorAll('.variant').forEach(v => {
|
||||
const variant = v.dataset.variant;
|
||||
const stars = v.querySelectorAll('.star.filled');
|
||||
ratings[variant] = stars.length;
|
||||
const input = v.querySelector('.feedback-input');
|
||||
if (input && input.value) {
|
||||
comments[variant] = input.value;
|
||||
}
|
||||
});
|
||||
|
||||
return {
|
||||
preferred: preferred ? preferred.value : null,
|
||||
ratings,
|
||||
comments,
|
||||
overall: document.getElementById('overall-feedback').value || null,
|
||||
};
|
||||
}
|
||||
</script>
|
||||
|
||||
</body>
|
||||
</html>`;
|
||||
}
|
||||
|
||||
/**
|
||||
* Compare command: generate comparison board HTML from image files.
|
||||
*/
|
||||
export function compare(options: CompareOptions): void {
|
||||
const html = generateCompareHtml(options.images);
|
||||
const outputDir = path.dirname(options.output);
|
||||
fs.mkdirSync(outputDir, { recursive: true });
|
||||
fs.writeFileSync(options.output, html);
|
||||
console.log(JSON.stringify({ outputPath: options.output, variants: options.images.length }));
|
||||
}
|
||||
Reference in New Issue
Block a user