aiblueprint-cli 1.4.74 → 1.4.76

package/agents-config/skills/use-style/styles/vercel-simple.md

@@ -0,0 +1,322 @@
+# Vercel Simple Style
+
+Minimal dark-mode developer UI. High contrast, line-driven structure, no decoration.
+
+**Reference vibe:** Vercel dashboard, blog, and data tools (take-home pay, country index).
+
+---
+
+## Core vibe
+
+- **Developer-first.** Utilitarian, not marketing-soft.
+- **Pure dark canvas.** Black background, white primary text, gray hierarchy.
+- **Line over depth.** 1px borders define structure; no shadows or blur.
+- **Restrained radius.** `0` on data/tool surfaces, `6-8px` on nav buttons and cards in app shells.
+- **Monospace for data.** Labels, nav, tables, inputs, metadata.
+- **Sans for prose.** Blog posts, long descriptions, dashboard titles (Geist / Inter stack).
+- **Generous whitespace.** Wide section gaps, airy row padding.
+
+---
+
+## Color
+
+Portable palette. Map to project tokens when available.
+
+| Role | Hex | CSS var (suggested) | Usage |
+|------|-----|---------------------|-------|
+| Canvas | `#000000` | `--vs-bg` | Page background |
+| Surface | `#111111` | `--vs-surface` | Summary boxes, sidebar panels, inset blocks |
+| Surface raised | `#1a1a1a` | `--vs-surface-raised` | Hover rows, secondary panels |
+| Ink | `#ffffff` | `--vs-fg` | Headlines, primary values, active tab text |
+| Muted ink | `#888888` | `--vs-muted-fg` | Descriptions, metadata, inactive tabs |
+| Subtle ink | `#a1a1aa` | `--vs-subtle-fg` | Breadcrumbs, timestamps, helper text |
+| Border | `#333333` | `--vs-border` | Boxes, dividers, input outlines |
+| Border strong | `#444444` | `--vs-border-strong` | Active/hover borders |
+| Data bar | `#666666` | `--vs-bar` | Progress / comparison bars |
+| Link | `#0070f3` | `--vs-link` | Text links, copy actions |
+| Success | `#50e3c2` | `--vs-success` | Stable / success states |
+| Error | `#ee0000` | `--vs-error` | Failed states |
+
+### Tailwind mapping (when no project tokens)
+
+```css
+:root {
+  --vs-bg: #000;
+  --vs-surface: #111;
+  --vs-fg: #fff;
+  --vs-muted-fg: #888;
+  --vs-border: #333;
+  --vs-link: #0070f3;
+}
+```
+
+| Tailwind | Value |
+|----------|-------|
+| `bg-black` | Canvas |
+| `bg-[#111]` | Surface |
+| `text-white` | Primary |
+| `text-[#888]` | Muted |
+| `border-[#333]` | Structure |
+
+**Rule:** Keep 90% of the UI monochromatic. Color accents only for links, status, and flag/icon glyphs.
+
+---
+
+## Typography
+
+### Font stacks
+
+| Role | Stack |
+|------|-------|
+| Sans (prose / dashboard) | `Geist, Inter, ui-sans-serif, system-ui, sans-serif` |
+| Mono (data / tools) | `Geist Mono, ui-monospace, SFMono-Regular, Menlo, monospace` |
+
+Load Geist via `@fontsource/geist-sans` / `@fontsource/geist-mono`, or `next/font/local` in Next.js.
+
+### Scale
+
+| Level | Font | Pattern |
+|-------|------|---------|
+| Page title | Sans or Mono | `text-2xl md:text-3xl font-medium tracking-tight text-white` |
+| Section label | Mono | `text-[10px] sm:text-xs uppercase tracking-wider text-[#888]` |
+| Body | Sans | `text-sm md:text-base leading-relaxed text-[#888]` |
+| Data / nav / button | Mono | `font-mono text-xs uppercase tracking-wide` |
+| Large input value | Mono | `font-mono text-2xl md:text-3xl tabular-nums text-white` |
+| Metadata | Sans or Mono | `text-xs text-[#888]` |
+
+### Section labels
+
+All-caps, small, muted gray. Examples: `TAX`, `TOOLS`, `SORT BY`, `YOUR GROSS ANNUAL SALARY`.
+
+```tsx
+<p className="font-mono text-xs uppercase tracking-wider text-[#888]">Tools</p>
+```
+
+---
+
+## Layout tokens
+
+| Token | Value |
+|-------|-------|
+| `VS_SHELL` | `mx-auto w-full max-w-5xl px-4 sm:px-6 md:px-8` |
+| `VS_SHELL_WIDE` | `max-w-7xl` (dashboard) |
+| `VS_SECTION` | `py-12 md:py-16 lg:py-20` |
+| `VS_STACK` | `px-4 py-4 sm:px-5 sm:py-5 md:px-6 md:py-6` |
+| `VS_GAP_SECTION` | `mb-12 md:mb-16` |
+
+### Page shell (tool / index)
+
+```
++---------------------------------------- viewport --+
+|  VS_SHELL                                          |
+|  - Section label (mono, uppercase, muted)          |
+|  - Page title                                      |
+|  - Description (muted sans)                         |
+|  - Search / controls                               |
+|  - Bordered grid or list                           |
++----------------------------------------------------+
+```
+
+```tsx
+<div className="min-h-screen bg-black text-white">
+  <main className={VS_SHELL}>
+    <section className={VS_SECTION}>...</section>
+  </main>
+</div>
+```
+
+### App shell (dashboard)
+
+Sidebar + main. Sidebar is narrow, icon + label, muted inactive links.
+
+```tsx
+<div className="flex min-h-screen bg-black">
+  <aside className="w-56 border-r border-[#333]">...</aside>
+  <main className="flex-1 p-6 md:p-8">...</main>
+</div>
+```
+
+---
+
+## Borders & radius
+
+| Context | Radius | Border |
+|---------|--------|--------|
+| Data tools, country lists, tables | `rounded-none` | `border border-[#333]` |
+| Cards, project tiles, blog feature | `rounded-lg` (8px) | `border border-[#333]` |
+| Primary button | `rounded-md` (6px) | filled or outline |
+| Inputs | `rounded-none` or `rounded-md` | `border border-[#333] bg-transparent` |
+
+Dividers: `border-t border-[#333]`, full width inside the container.
+
+---
+
+## Component patterns
+
+### Search input
+
+```tsx
+<input
+  className="w-full border border-[#333] bg-transparent px-4 py-3 font-mono text-sm text-white placeholder:text-[#888] focus:border-[#444] focus:outline-none"
+  placeholder="Search countries..."
+/>
+```
+
+### Link row (index grid)
+
+Bordered box, icon left, title white, arrow right.
+
+```tsx
+<a className="flex items-center justify-between border border-[#333] px-4 py-3 transition-colors hover:border-[#444] hover:bg-[#111]">
+  <span className="flex items-center gap-3 font-mono text-sm text-white">...</span>
+  <span className="font-mono text-[#888]">{"->"}</span>
+</a>
+```
+
+### Tab / sort toggle
+
+Inactive: gray border + gray text. Active: white border + white text.
+
+```tsx
+<button className={cn(
+  "border px-3 py-1.5 font-mono text-xs uppercase tracking-wide",
+  active ? "border-white text-white" : "border-[#333] text-[#888]"
+)}>...</button>
+```
+
+### Data table row
+
+Row inside a bordered container. Primary number is white + mono tabular. Secondary detail is muted and small.
+
+```tsx
+<div className="flex items-center gap-4 border-b border-[#333] px-4 py-4 last:border-b-0">
+  <span className="w-28 font-mono text-sm">Germany</span>
+  <div className="h-2 flex-1 bg-[#333]">
+    <div className="h-full bg-[#666]" style={{ width: `${pct}%` }} />
+  </div>
+  <span className="font-mono tabular-nums text-white">52,340</span>
+</div>
+```
+
+Progress bars: track `#333`, fill `#666`. Flat, no gradient.
+
+### Summary / highlight box
+
+```tsx
+<div className="border border-[#333] bg-[#111] px-5 py-4 font-mono text-sm">
+  <span className="text-[#888]">Best value: </span>
+  <span className="text-white">Bulgaria</span>
+</div>
+```
+
+### Card (dashboard / blog)
+
+```tsx
+<div className="rounded-lg border border-[#333] bg-black p-4 transition-colors hover:border-[#444]">
+  <div className="mb-3 flex items-start justify-between">...</div>
+  <h3 className="text-sm font-medium text-white">Project name</h3>
+  <p className="mt-1 text-xs text-[#888]">project.vercel.app</p>
+</div>
+```
+
+### Buttons
+
+| Variant | Classes |
+|---------|---------|
+| Primary | `rounded-md bg-white px-4 py-2 text-sm font-medium text-black hover:bg-white/90` |
+| Secondary | `rounded-md border border-[#333] bg-black px-4 py-2 text-sm text-white hover:border-[#444]` |
+| Ghost link | `text-[#0070f3] hover:underline` |
+
+### Two-column grid
+
+```tsx
+<div className="grid grid-cols-1 gap-3 sm:grid-cols-2">
+  {items.map(...)}
+</div>
+```
+
+Each cell is its own bordered box, not a `gap-px` mosaic unless every cell sets explicit `bg-black`.
+
+---
+
+## Grid patterns
+
+### Bordered list stack
+
+```tsx
+<div className="border border-[#333] divide-y divide-[#333]">
+  {rows.map(...)}
+</div>
+```
+
+### Full-width tool card
+
+```tsx
+<a className="block border border-[#333] px-5 py-5 transition-colors hover:bg-[#111]">
+  <p className="font-mono text-base text-white">Europe: Take-Home Pay Comparison</p>
+  <p className="mt-1 text-sm text-[#888]">Calculate, visualize, and compare...</p>
+</a>
+```
+
+---
+
+## Charts (data viz)
+
+Match the line-driven, monochrome tool aesthetic:
+
+- Series in grayscale: `#fff`, `#888`, `#666`, `#333`. Add **one** accent only when a series must stand out - `#0070f3` (link blue) or `#50e3c2` (success).
+- **Sharp bars** (`borderRadius: 0`) - same square geometry as the data tools. Flat fills, no gradients.
+- Gridlines `#333`; axis text **mono** (`Geist Mono`), muted `#888`.
+- Tooltip: `#111` background, white text, square or 6px corners.
+- Bars/progress reuse the data-bar token: track `#333`, fill `#666` (or `#fff` for the active series).
+- Doughnut: segments separated by a `#000` stroke; legend in mono uppercase.
+
+```js
+const FG="#fff", S2="#888", S3="#666", S4="#333", ACCENT="#0070f3", GRID="#333";
+Chart.defaults.font.family = "Geist Mono, ui-monospace, monospace";
+Chart.defaults.color = "#888";
+// bars: backgroundColor:[S3, FG], borderRadius:0
+// grid: { color: GRID }, border: { color: GRID }
+// tooltip: { backgroundColor:"#111", cornerRadius:0 }
+```
+
+---
+
+## Motion & effects
+
+- No drop shadows, glass blur, gradient backgrounds, or glow halos.
+- Hover: border lighten (`#333` to `#444`), subtle bg (`#111`), or text color shift.
+- `transition-colors duration-150` on interactive elements.
+- No scale/lift animations on cards.
+
+---
+
+## Mode selection
+
+| Surface type | Font | Radius |
+|--------------|------|--------|
+| Data tools, tax calculators, index pages | Mono primary | Sharp (`0`) |
+| Dashboard, blog, marketing docs | Sans primary, mono for metadata | Soft (`6-8px`) |
+
+When unsure, default to mono + sharp for new tool UIs, and sans + `rounded-lg` for app shells and content pages.
+
+---
+
+## Anti-patterns
+
+| Avoid | Why |
+|-------|-----|
+| `rounded-xl`, `rounded-2xl`, `rounded-full` on data/tool UI | Breaks the utilitarian look |
+| `shadow-lg`, `ring-*`, `backdrop-blur-*` | Depth replaces line hierarchy |
+| Gradient backgrounds | Keep flat black / `#111` surfaces |
+| Bright saturated fills on large areas | Reserve color for links and status |
+| `gap-px` + `bg-border` without per-cell bg | Unintended gray gutters |
+| Pill-shaped tabs on tool pages | Use rectangular bordered toggles |
+| Light mode by default | The style is dark-first |
+| Decorative hero imagery on a tool index | Text + bordered grid only |
+
+---
+
+## Project overrides
+
+If the repo defines `.agents/styles/vercel-simple.md` or `.agents/styles/vercel-simple-theme.md`, prefer those tokens and components over this portable spec.

package/dist/cli.js

@@ -35971,8 +35971,10 @@ function getContainerCandidates(options, includeCodex = true) {
     }
   ]);
 }
-function getInstructionFileCandidates(options, includeCodex = true) {
+function getInstructionFileCandidates(options, scope) {
   const folders = resolveFolders(options);
+  const cursorDir = path17.join(folders.rootDir, ".cursor");
+  const linkToolInstructionsWhenMissing = scope === "global";
   return uniqueByPath([
     {
       label: "agents-instructions",
@@ -35984,11 +35986,17 @@ function getInstructionFileCandidates(options, includeCodex = true) {
       path: path17.join(folders.claudeDir, "CLAUDE.md"),
       linkWhenMissing: true
     },
-    ...includeCodex ? [{
+    {
       label: "codex-instructions",
       path: path17.join(folders.codexDir, "AGENTS.md"),
-      linkWhenMissing: true
-    }] : []
+      linkWhenMissing: linkToolInstructionsWhenMissing,
+      linkWhenParentExists: true
+    },
+    {
+      label: "cursor-instructions",
+      path: path17.join(cursorDir, "AGENTS.md"),
+      linkWhenParentExists: true
+    }
   ]);
 }
 function getRepositoryContainerCandidates(options) {
@@ -36656,6 +36664,8 @@ async function importInstructionFiles(candidates, destinationPath, result, dryRu
 async function shouldLinkMissingInstruction(candidate) {
   if (candidate.linkWhenMissing)
     return true;
+  if (candidate.linkWhenParentExists)
+    return import_fs_extra13.default.pathExists(path17.dirname(candidate.path));
   return false;
 }
 async function linkInstructionFile(candidate, destinationPath, result, dryRun = false) {
@@ -36849,12 +36859,12 @@ async function ensureClaudeInstructionSymlink(result, agentsPath, claudePath, dr
     to: agentsPath
   });
 }
-async function writeRepositoryInstructionIndex(result, folders, dryRun = false) {
+async function writeRepositoryInstructionIndex(result, folders, dryRun = false, includeRules = true) {
   const rulesDir = path17.join(folders.agentsDir, "rules");
   const agentsPath = path17.join(folders.rootDir, "AGENTS.md");
   const claudePath = path17.join(folders.rootDir, "CLAUDE.md");
   const rulesDirExists = await pathExistsOrSymlink(rulesDir);
-  const rules = dryRun || rulesDirExists ? dryRun ? await collectPlannedRuleIndexEntries(result, folders.rootDir) : await collectRuleIndexEntries(rulesDir, folders.rootDir) : [];
+  const rules = includeRules && (dryRun || rulesDirExists) ? dryRun ? await collectPlannedRuleIndexEntries(result, folders.rootDir) : await collectRuleIndexEntries(rulesDir, folders.rootDir) : [];
   const agentsExists = await pathExistsOrSymlink(agentsPath);
   const claudeExists = await pathExistsOrSymlink(claudePath);
   if (rules.length === 0 && !agentsExists && !claudeExists) {
@@ -36967,7 +36977,9 @@ async function unifyAgentsConfiguration(options = {}) {
   const dryRun = Boolean(options.dryRun);
   const folders = resolveFolders(options);
   const includeCodex = scope !== "repository";
-  const instructionCandidates = getInstructionFileCandidates(options, includeCodex);
+  const defaultCategories = scope === "repository" ? ["instructions", "skills", "agents", "rules"] : ["instructions", "skills", "agents"];
+  const selectedCategories = new Set((options.categories ?? defaultCategories).filter((category) => defaultCategories.includes(category)));
+  const instructionCandidates = getInstructionFileCandidates(options, scope);
   const candidates = scope === "repository" ? getRepositoryContainerCandidates(options) : getContainerCandidates(options);
   const result = {
     rootDir: folders.rootDir,
@@ -36988,13 +37000,17 @@ async function unifyAgentsConfiguration(options = {}) {
     instructions: path17.join(folders.agentsDir, "AGENTS.md"),
     rules: path17.join(folders.agentsDir, "rules")
   };
-  await importInstructionFiles(instructionCandidates, destinationByCategory.instructions, result, dryRun);
+  if (selectedCategories.has("instructions")) {
+    await importInstructionFiles(instructionCandidates, destinationByCategory.instructions, result, dryRun);
+  }
   const categories = scope === "repository" ? ["skills", "agents", "rules"] : ["skills", "agents"];
-  if (scope === "repository" && await pathExistsOrSymlink(destinationByCategory.rules)) {
+  if (scope === "repository" && selectedCategories.has("rules") && await pathExistsOrSymlink(destinationByCategory.rules)) {
     await migrateExistingRuleExtensions(destinationByCategory.rules, result, dryRun);
   }
   const activeCategories = new Set;
   for (const category of categories) {
+    if (!selectedCategories.has(category))
+      continue;
     const isActive = await importCategoryEntries(category, candidates, destinationByCategory[category], result, dryRun);
     if (isActive) {
       activeCategories.add(category);
@@ -37005,14 +37021,16 @@ async function unifyAgentsConfiguration(options = {}) {
       continue;
     await linkContainer(candidate, destinationByCategory[candidate.category], result, dryRun);
   }
-  for (const candidate of instructionCandidates) {
-    await linkInstructionFile(candidate, destinationByCategory.instructions, result, dryRun);
+  if (selectedCategories.has("instructions")) {
+    for (const candidate of instructionCandidates) {
+      await linkInstructionFile(candidate, destinationByCategory.instructions, result, dryRun);
+    }
   }
-  if (scope === "repository") {
-    if (!dryRun && await pathExistsOrSymlink(destinationByCategory.rules)) {
+  if (scope === "repository" && (selectedCategories.has("instructions") || selectedCategories.has("rules"))) {
+    if (!dryRun && selectedCategories.has("rules") && await pathExistsOrSymlink(destinationByCategory.rules)) {
       await migrateExistingRuleExtensions(destinationByCategory.rules, result, dryRun);
     }
-    await writeRepositoryInstructionIndex(result, folders, dryRun);
+    await writeRepositoryInstructionIndex(result, folders, dryRun, selectedCategories.has("rules"));
   }
   return result;
 }
@@ -37021,6 +37039,46 @@ async function previewAgentsConfiguration(options = {}) {
 }
 
 // src/commands/agents-unify.ts
+var CATEGORY_LABELS = {
+  instructions: "AGENTS.md",
+  skills: "Skills",
+  agents: "Agents",
+  rules: "Rules and memories"
+};
+function defaultCategoriesForScope(scope) {
+  return scope === "repository" ? ["instructions", "skills", "agents", "rules"] : ["instructions", "skills", "agents"];
+}
+function selectableCategoriesForScope(scope) {
+  return defaultCategoriesForScope(scope);
+}
+async function resolveSelectedCategories(params) {
+  const scope = params.scope ?? "global";
+  const selectableCategories = selectableCategoriesForScope(scope);
+  const requestedCategories = params.categories?.filter((category) => selectableCategories.includes(category));
+  const initialValues = requestedCategories ?? selectableCategories;
+  if (!params.interactive) {
+    if (params.categories && initialValues.length === 0) {
+      throw new Error(`Selected categories do not apply to ${scope} scope`);
+    }
+    return requestedCategories;
+  }
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new Error("Interactive category selection requires a TTY");
+  }
+  const selected = await fe({
+    message: "What do you want to unify?",
+    options: selectableCategories.map((category) => ({
+      value: category,
+      label: CATEGORY_LABELS[category]
+    })),
+    initialValues,
+    required: true
+  });
+  if (pD(selected)) {
+    return null;
+  }
+  return selected;
+}
 function countByCategory(result, key, category) {
   return result[key].filter((entry) => entry.category === category).length;
 }
@@ -37086,15 +37144,24 @@ AIBlueprint agents unify ${source_default.gray(`v${getVersion()}`)}
 `));
     console.log(source_default.gray(`Scope: ${params.scope ?? "global"}`));
     console.log(source_default.gray(params.scope === "repository" ? "Centralizing project agent configuration into .agents" : "Centralizing reusable agent configuration into .agents, then rendering Codex agents"));
-    const preview = await previewAgentsConfiguration(params);
+    const selectedCategories = await resolveSelectedCategories(params);
+    if (selectedCategories === null) {
+      console.log(source_default.gray(`
+Unify cancelled`));
+      return;
+    }
+    const commandParams = { ...params, categories: selectedCategories };
+    const effectiveCategories = selectedCategories ?? defaultCategoriesForScope(params.scope ?? "global");
+    console.log(source_default.gray(`Categories: ${effectiveCategories.map((category) => CATEGORY_LABELS[category]).join(", ")}`));
+    const preview = await previewAgentsConfiguration(commandParams);
     printAgentsUnifyPreview(preview);
     if (!await confirmUnify()) {
       console.log(source_default.gray(`
 Unify cancelled`));
       return;
     }
-    const result = await unifyAgentsConfiguration(params);
-    const codexResult = params.scope === "repository" ? null : await renderCodexAgentsFromMarkdown(params);
+    const result = await unifyAgentsConfiguration(commandParams);
+    const codexResult = params.scope === "repository" || !effectiveCategories.includes("agents") ? null : await renderCodexAgentsFromMarkdown(commandParams);
     console.log(source_default.green(`
 Unify complete`));
     console.log(source_default.gray(`  Shared folder: ${result.agentsDir}`));
@@ -39315,6 +39382,18 @@ var __dirname3 = dirname3(fileURLToPath3(import.meta.url));
 var packageJson = JSON.parse(readFileSync3(join2(__dirname3, "../package.json"), "utf8"));
 var program2 = new Command;
 program2.name("aiblueprint").description("AIBlueprint CLI for setting up AI coding configurations").version(packageJson.version);
+function readUnifyCategories(options) {
+  const categories = [];
+  if (options.agentsMd)
+    categories.push("instructions");
+  if (options.skills)
+    categories.push("skills");
+  if (options.agents)
+    categories.push("agents");
+  if (options.rules)
+    categories.push("rules");
+  return categories.length > 0 ? categories : undefined;
+}
 function registerAgentsCommands(cmd) {
   cmd.option("-f, --folder <path>", "Root folder that contains .claude/, .codex/, .agents/ (default: $HOME)").option("--claudeCodeFolder <path>", "Override Claude Code folder (default: {folder}/.claude)").option("--codexFolder <path>", "Override Codex folder (default: {folder}/.codex)").option("--agentsFolder <path>", "Override shared agents folder (default: {folder}/.agents)").option("-s, --skip", "Skip interactive prompts and install all features");
   cmd.command("setup").description("Setup AI coding configuration with AIBlueprint defaults").action((options, command) => {
@@ -39342,7 +39421,7 @@ function registerAgentsCommands(cmd) {
       codexFolder: parentOptions.codexFolder
     });
   });
-  cmd.command("unify [scope]").description("Unify agent configuration into .agents (scope: global or projects/repository; default: global)").action((scope, options, command) => {
+  cmd.command("unify [scope]").description("Unify agent configuration into .agents (scope: global or projects/repository; default: global)").option("-i, --interactive", "Choose which categories to unify").option("--agents-md", "Unify instruction files into .agents/AGENTS.md").option("--skills", "Unify skills").option("--agents", "Unify Markdown agents").option("--rules", "Unify repository rules and memories").action((scope, options, command) => {
     const parentOptions = command.parent.opts();
     const requestedScope = scope ?? "global";
     const selectedScope = requestedScope === "projects" || requestedScope === "project" ? "repository" : requestedScope;
@@ -39357,7 +39436,9 @@ function registerAgentsCommands(cmd) {
       claudeCodeFolder: parentOptions.claudeCodeFolder,
       codexFolder: parentOptions.codexFolder,
       agentsFolder: parentOptions.agentsFolder,
-      scope: selectedScope
+      scope: selectedScope,
+      categories: readUnifyCategories(options),
+      interactive: options.interactive
     });
   });
   cmd.command("codex-agents").description("Render shared Markdown agents from .agents/agents into Codex TOML custom agents").option("--overwrite", "Overwrite existing non-generated Codex agent files").action((options, command) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiblueprint-cli",
-  "version": "1.4.74",
+  "version": "1.4.76",
   "description": "AIBlueprint CLI for setting up AI coding configurations",
   "author": "AIBlueprint",
   "license": "MIT",