gemini-designer 0.1.31 → 0.1.32

package/dist/cli.js

@@ -9,6 +9,7 @@ import { loginCommand } from './commands/login.js';
 import { doctorCommand } from './commands/doctor.js';
 import { linksCommand } from './commands/links.js';
 import { uninstallCommand } from './commands/uninstall.js';
+import { agentsMdCommand } from './commands/agents-md.js';
 import { VERSION } from './version.js';
 const program = new Command();
 program
@@ -20,5 +21,6 @@ program.addCommand(loginCommand);
 program.addCommand(doctorCommand);
 program.addCommand(linksCommand);
 program.addCommand(uninstallCommand);
+program.addCommand(agentsMdCommand);
 program.parse();
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,iBAAiB,CAAC;KACvB,WAAW,CAAC,8CAA8C,CAAC;KAC3D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AAErC,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,iBAAiB,CAAC;KACvB,WAAW,CAAC,8CAA8C,CAAC;KAC3D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AAEpC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/agents-md.d.ts

@@ -0,0 +1,7 @@
+/**
+ * agents-md command
+ * Print (or install) a drop-in AGENTS.md section that teaches agents how to use Gemini Designer MCP tools effectively.
+ */
+import { Command } from 'commander';
+export declare const agentsMdCommand: Command;
+//# sourceMappingURL=agents-md.d.ts.map

package/dist/commands/agents-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../src/commands/agents-md.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2EpC,eAAO,MAAM,eAAe,SA0BxB,CAAC"}

package/dist/commands/agents-md.js

@@ -0,0 +1,97 @@
+/**
+ * agents-md command
+ * Print (or install) a drop-in AGENTS.md section that teaches agents how to use Gemini Designer MCP tools effectively.
+ */
+import { Command } from 'commander';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import chalk from 'chalk';
+const BEGIN = '<!-- gemini-designer:agents-md:begin -->';
+const END = '<!-- gemini-designer:agents-md:end -->';
+function getAgentsMdSection() {
+    return [
+        BEGIN,
+        '# Gemini Designer MCP — Agent Workflow Rules',
+        '',
+        '## Golden rules',
+        '- Prefer Gemini Designer MCP tools for UI work; avoid hand-writing large UI blobs unless explicitly requested.',
+        '- Default to: 1 generation pass + (optional) 1 targeted modify pass. Do not loop endlessly.',
+        '- Always maintain WCAG AA, keyboard navigation, and strong :focus-visible states.',
+        '- Avoid generic layouts (cookie-cutter SaaS grids) and generic gradients.',
+        '',
+        '## Recommended workflows',
+        '',
+        '### A) New page / new component (highest quality, lowest back-and-forth)',
+        '1) (Optional) detect_ui_stack(projectRoot) to learn framework/styling conventions.',
+        '2) generate_vibes(vibeCount=3..5) and pick ONE vibe.',
+        '3) create_ui(...) or snippet_ui(...), pass the vibe JSON as vibe=... and keep requirements explicit.',
+        '4) If polish is needed: ONE modify_ui pass (surgical edits).',
+        '',
+        '### B) Tight iteration on existing UI (no re-generation)',
+        '1) modify_ui(targetFile, instruction, preserveLogic=true, returnDiff=true).',
+        '2) If diff looks good: modify_ui(..., applyChanges=true).',
+        '',
+        '### C) Screenshot → design breakdown → implementation',
+        '1) analyze_screenshot_ui(imagePath, outputFormat=json).',
+        '2) create_ui/snippet_ui to implement the extracted structure.',
+        '3) modify_ui to refine alignment/spacing/accessibility.',
+        '',
+        '### D) Repo refactor / consistency',
+        '- catalog_components to discover existing exports to reuse.',
+        '- analyze_tokens to extract tokens from CSS/SCSS.',
+        '- sync_design_tokens to normalize/convert tokens (css-vars/scss-vars/tailwind/tokens-studio/style-dictionary).',
+        '',
+        '### E) Architecture planning (before implementation)',
+        '1) scaffold_project(name, pages, features) to get a structured plan.',
+        '2) Implement pages/components via create_ui/snippet_ui.',
+        '',
+        '## High-signal request template (copy/paste)',
+        'Purpose: <what this UI is for>',
+        'Audience: <who uses it>',
+        'Required content: <bullets of exact elements that must exist>',
+        'Constraints:',
+        '- WCAG AA',
+        '- Mobile-first responsive',
+        '- Strong :focus-visible states',
+        '- Avoid generic “SaaS card grids” + generic gradients',
+        'Design direction: <ONE clear aesthetic (editorial | brutalist | art-deco | luxury | playful)>',
+        '',
+        'Tip: For marketing pages, explicitly list required sections (hero, how-it-works, examples, testimonials, pricing, CTA).',
+        END,
+        '',
+    ].join('\n');
+}
+function upsertSection(existing, section) {
+    if (existing.includes(BEGIN) && existing.includes(END)) {
+        const start = existing.indexOf(BEGIN);
+        const end = existing.indexOf(END);
+        if (start !== -1 && end !== -1 && end >= start) {
+            const after = existing.slice(end + END.length);
+            return `${existing.slice(0, start)}${section}${after.replace(/^\n+/, '\n')}`;
+        }
+    }
+    const trimmed = existing.replace(/\s+$/, '');
+    return `${trimmed}\n\n${section}`;
+}
+export const agentsMdCommand = new Command('agents-md')
+    .description('Print or install a drop-in AGENTS.md section for best Gemini Designer MCP results')
+    .option('-f, --file <path>', 'Target file to write to', 'AGENTS.md')
+    .option('--install', 'Install/update the section in the target file (append if missing)')
+    .action(async (options) => {
+    const section = getAgentsMdSection();
+    if (!options.install) {
+        process.stdout.write(`${section}\n`);
+        return;
+    }
+    const target = path.resolve(process.cwd(), String(options.file || 'AGENTS.md'));
+    let existing = '';
+    if (fs.existsSync(target)) {
+        existing = fs.readFileSync(target, 'utf8');
+    }
+    const next = upsertSection(existing, section);
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, next, 'utf8');
+    console.log(chalk.green(`✓ Updated ${path.relative(process.cwd(), target)}`));
+    console.log(chalk.gray('Tip: If you already have repo instructions, keep them — this section is additive.'));
+});
+//# sourceMappingURL=agents-md.js.map

package/dist/commands/agents-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../../src/commands/agents-md.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gemini-designer",
-  "version": "0.1.31",
+  "version": "0.1.32",
   "description": "CLI installer for Gemini Designer MCP server",
   "type": "module",
   "main": "dist/cli.js",

package/src/cli.ts

@@ -10,6 +10,7 @@ import { loginCommand } from './commands/login.js';
 import { doctorCommand } from './commands/doctor.js';
 import { linksCommand } from './commands/links.js';
 import { uninstallCommand } from './commands/uninstall.js';
+import { agentsMdCommand } from './commands/agents-md.js';
 import { VERSION } from './version.js';
 
 const program = new Command();
@@ -24,5 +25,6 @@ program.addCommand(loginCommand);
 program.addCommand(doctorCommand);
 program.addCommand(linksCommand);
 program.addCommand(uninstallCommand);
+program.addCommand(agentsMdCommand);
 
 program.parse();

package/src/commands/agents-md.ts

@@ -0,0 +1,108 @@
+/**
+ * agents-md command
+ * Print (or install) a drop-in AGENTS.md section that teaches agents how to use Gemini Designer MCP tools effectively.
+ */
+
+import { Command } from 'commander';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import chalk from 'chalk';
+
+const BEGIN = '<!-- gemini-designer:agents-md:begin -->';
+const END = '<!-- gemini-designer:agents-md:end -->';
+
+function getAgentsMdSection(): string {
+  return [
+    BEGIN,
+    '# Gemini Designer MCP — Agent Workflow Rules',
+    '',
+    '## Golden rules',
+    '- Prefer Gemini Designer MCP tools for UI work; avoid hand-writing large UI blobs unless explicitly requested.',
+    '- Default to: 1 generation pass + (optional) 1 targeted modify pass. Do not loop endlessly.',
+    '- Always maintain WCAG AA, keyboard navigation, and strong :focus-visible states.',
+    '- Avoid generic layouts (cookie-cutter SaaS grids) and generic gradients.',
+    '',
+    '## Recommended workflows',
+    '',
+    '### A) New page / new component (highest quality, lowest back-and-forth)',
+    '1) (Optional) detect_ui_stack(projectRoot) to learn framework/styling conventions.',
+    '2) generate_vibes(vibeCount=3..5) and pick ONE vibe.',
+    '3) create_ui(...) or snippet_ui(...), pass the vibe JSON as vibe=... and keep requirements explicit.',
+    '4) If polish is needed: ONE modify_ui pass (surgical edits).',
+    '',
+    '### B) Tight iteration on existing UI (no re-generation)',
+    '1) modify_ui(targetFile, instruction, preserveLogic=true, returnDiff=true).',
+    '2) If diff looks good: modify_ui(..., applyChanges=true).',
+    '',
+    '### C) Screenshot → design breakdown → implementation',
+    '1) analyze_screenshot_ui(imagePath, outputFormat=json).',
+    '2) create_ui/snippet_ui to implement the extracted structure.',
+    '3) modify_ui to refine alignment/spacing/accessibility.',
+    '',
+    '### D) Repo refactor / consistency',
+    '- catalog_components to discover existing exports to reuse.',
+    '- analyze_tokens to extract tokens from CSS/SCSS.',
+    '- sync_design_tokens to normalize/convert tokens (css-vars/scss-vars/tailwind/tokens-studio/style-dictionary).',
+    '',
+    '### E) Architecture planning (before implementation)',
+    '1) scaffold_project(name, pages, features) to get a structured plan.',
+    '2) Implement pages/components via create_ui/snippet_ui.',
+    '',
+    '## High-signal request template (copy/paste)',
+    'Purpose: <what this UI is for>',
+    'Audience: <who uses it>',
+    'Required content: <bullets of exact elements that must exist>',
+    'Constraints:',
+    '- WCAG AA',
+    '- Mobile-first responsive',
+    '- Strong :focus-visible states',
+    '- Avoid generic “SaaS card grids” + generic gradients',
+    'Design direction: <ONE clear aesthetic (editorial | brutalist | art-deco | luxury | playful)>',
+    '',
+    'Tip: For marketing pages, explicitly list required sections (hero, how-it-works, examples, testimonials, pricing, CTA).',
+    END,
+    '',
+  ].join('\n');
+}
+
+function upsertSection(existing: string, section: string): string {
+  if (existing.includes(BEGIN) && existing.includes(END)) {
+    const start = existing.indexOf(BEGIN);
+    const end = existing.indexOf(END);
+    if (start !== -1 && end !== -1 && end >= start) {
+      const after = existing.slice(end + END.length);
+      return `${existing.slice(0, start)}${section}${after.replace(/^\n+/, '\n')}`;
+    }
+  }
+  const trimmed = existing.replace(/\s+$/, '');
+  return `${trimmed}\n\n${section}`;
+}
+
+export const agentsMdCommand = new Command('agents-md')
+  .description('Print or install a drop-in AGENTS.md section for best Gemini Designer MCP results')
+  .option('-f, --file <path>', 'Target file to write to', 'AGENTS.md')
+  .option('--install', 'Install/update the section in the target file (append if missing)')
+  .action(async (options) => {
+    const section = getAgentsMdSection();
+
+    if (!options.install) {
+      process.stdout.write(`${section}\n`);
+      return;
+    }
+
+    const target = path.resolve(process.cwd(), String(options.file || 'AGENTS.md'));
+    let existing = '';
+    if (fs.existsSync(target)) {
+      existing = fs.readFileSync(target, 'utf8');
+    }
+
+    const next = upsertSection(existing, section);
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, next, 'utf8');
+
+    console.log(chalk.green(`✓ Updated ${path.relative(process.cwd(), target)}`));
+    console.log(
+      chalk.gray('Tip: If you already have repo instructions, keep them — this section is additive.')
+    );
+  });
+