mirror of
https://github.com/garrytan/gstack.git
synced 2026-05-06 13:45:35 +02:00
Garry Tan
a4dd5b0c2e
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>
405 lines
11 KiB
TypeScript
405 lines
11 KiB
TypeScript
/**
|
|
* 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 }));
|
|
}
|