capy-mcp 1.0.8 → 1.0.10

package/dist/brief.js

@@ -13,6 +13,7 @@ const SECTION_ORDER = [
     "Data Display",
     "Feedback",
     "Overlays",
+    "Components",
     "Feature or Page Sections",
 ];
 export async function buildPreviewBrief(projectRoot, input) {
@@ -143,6 +144,7 @@ function buildWarnings(framework, changedFiles, discoveryGaps = []) {
         warnings.push("No changedFiles were provided. The agent should inspect git diff or recent edits when performing update_preview.");
     }
     warnings.push(...discoveryGaps);
+    warnings.push("IMPORTANT: Add .capy/ and the created preview route/page files (e.g. app/preview/, pages/preview.tsx) to .gitignore so they are not committed to the repository.");
     return warnings;
 }
 function buildInstructions(projectFacts, input, discoveryInstruction) {
@@ -150,5 +152,5 @@ function buildInstructions(projectFacts, input, discoveryInstruction) {
         ? "Update the existing /preview route incrementally."
         : "Create the /preview route from scratch.";
     const userGoal = input.userGoal ? ` User goal: ${input.userGoal}.` : "";
-    return `${lead}${userGoal} Read the app shell first, then global styles, then traverse all discovered component directories. After that, implement ${projectFacts.previewEntryFile} as a clean preview surface that supports both vertical and horizontal scanning when useful, includes a dedicated icon section when icons can be discovered, and renders colors as consistent swatches with 6-character hex labels plus click-to-copy behavior using a pointer cursor. ${discoveryInstruction}`;
+    return `${lead}${userGoal} Read the app shell first, then global styles, then traverse all discovered component directories. After that, implement ${projectFacts.previewEntryFile} as a clean preview surface that supports both vertical and horizontal scanning when useful, includes a dedicated icon section when icons can be discovered, and renders colors as consistent swatches with 6-character hex labels plus click-to-copy behavior using a pointer cursor. ${discoveryInstruction} IMPORTANT: After creating files, add the .capy/ folder and the created preview page files (e.g. ${projectFacts.previewEntryFile}) to .gitignore so they are not committed to the repository.`;
 }

package/dist/component-discovery.js

@@ -87,9 +87,13 @@ function buildDiscoveryFacts(components) {
     for (const comp of components) {
         const slashIndex = comp.path.lastIndexOf("/");
         const dir = slashIndex === -1 ? "." : comp.path.slice(0, slashIndex);
-        if (!byDir.has(dir))
-            byDir.set(dir, []);
-        byDir.get(dir).push(comp.exports[0] ?? comp.basename);
+        const existing = byDir.get(dir);
+        if (existing) {
+            existing.push(comp.exports[0] ?? comp.basename);
+        }
+        else {
+            byDir.set(dir, [comp.exports[0] ?? comp.basename]);
+        }
     }
     const facts = [];
     for (const [dir, names] of byDir) {

package/dist/design-system.js

@@ -1,6 +1,5 @@
 import { glob } from "glob";
 import { basename, join } from "path";
-import { buildPreviewBrief } from "./brief.js";
 import { buildComponentDiscoveryPlan } from "./component-discovery.js";
 import { readText, toPosixPath, writeText } from "./files.js";
 import { detectFramework } from "./framework.js";
@@ -10,28 +9,10 @@ export async function buildDesignSystemArtifact(projectRoot, input = {}) {
     const framework = await detectFramework(projectRoot);
     const projectFacts = await buildProjectFacts(projectRoot, framework);
     const discoveryPlan = await buildComponentDiscoveryPlan(projectRoot, projectFacts);
-    const previewBrief = await buildPreviewBrief(projectRoot, {
-        task: input.mode === "update" ? "update_preview" : "build_preview",
-        changedFiles: input.changedFiles,
-        userGoal: input.userGoal,
-    });
     const cssVariables = await collectCssVariables(projectRoot, projectFacts.likelyStyleFiles);
     const components = await collectComponents(projectRoot, projectFacts);
-    const readFirst = buildReadFirst(previewBrief, components, discoveryPlan.prioritizedFiles);
-    const bridges = await buildUsageBridges(projectRoot, projectFacts.likelyStyleFiles, components);
-    const gaps = buildGapNotes(projectFacts, components, cssVariables, discoveryPlan.missingFamilyGaps);
     const artifactPath = input.artifactPath ?? DEFAULT_ARTIFACT_PATH;
     return {
-        forAgent: {
-            intent: input.mode === "update"
-                ? "Update /preview incrementally. Read the files below first, then touch only the sections affected by the changed files unless shared foundations changed."
-                : "Build or refine /preview. Read the files below first, then mirror the repo's existing UI language instead of inventing a new one.",
-            readFirst,
-            facts: buildAgentFacts(projectFacts, components, cssVariables, discoveryPlan.discoveredFamilyFacts),
-            bridges,
-            gaps,
-            updateHints: previewBrief.updateStrategy,
-        },
         artifact: {
             generatedAt: new Date().toISOString(),
             mode: input.mode ?? "build",
@@ -50,6 +31,7 @@ export async function buildDesignSystemArtifact(projectRoot, input = {}) {
             pageDirs: projectFacts.likelyPageDirs,
             styleFiles: projectFacts.likelyStyleFiles,
             uiDirs: projectFacts.likelyUiDirs,
+            discoveredFamilies: discoveryPlan.discoveredFamilyFacts,
         },
         tokens: {
             cssVariables,
@@ -59,12 +41,6 @@ export async function buildDesignSystemArtifact(projectRoot, input = {}) {
             count: components.length,
             items: components,
         },
-        preview: {
-            route: projectFacts.previewRoute,
-            entryFile: projectFacts.previewEntryFile,
-            sections: previewBrief.deliverableSpec.sections,
-            updateStrategy: previewBrief.updateStrategy,
-        },
     };
 }
 export async function writeDesignSystemArtifact(projectRoot, input = {}) {
@@ -170,131 +146,3 @@ function classifyCssVariable(name) {
 function lineNumberAt(contents, index) {
     return contents.slice(0, index).split("\n").length;
 }
-function buildReadFirst(previewBrief, components, prioritizedFiles) {
-    const seen = new Set();
-    const readFirst = [];
-    const firstComponentByDir = new Map();
-    for (const component of components) {
-        const slashIndex = component.path.lastIndexOf("/");
-        if (slashIndex === -1)
-            continue;
-        const directory = component.path.slice(0, slashIndex);
-        if (!firstComponentByDir.has(directory)) {
-            firstComponentByDir.set(directory, component.path);
-        }
-    }
-    for (const step of previewBrief.inspectionPlan.slice(0, 2)) {
-        for (const target of step.targets) {
-            if (!looksLikeProjectPath(target))
-                continue;
-            const normalizedTarget = firstComponentByDir.get(target) ?? target;
-            if (seen.has(normalizedTarget))
-                continue;
-            seen.add(normalizedTarget);
-            readFirst.push({
-                path: normalizedTarget,
-                reason: step.reason,
-            });
-            if (readFirst.length >= 8) {
-                return readFirst;
-            }
-        }
-    }
-    for (const prioritizedFile of prioritizedFiles) {
-        if (seen.has(prioritizedFile))
-            continue;
-        seen.add(prioritizedFile);
-        readFirst.push({
-            path: prioritizedFile,
-            reason: "Likely reusable primitive or usage example. Read this before inventing preview-only specimens.",
-        });
-        if (readFirst.length >= 8) {
-            return readFirst;
-        }
-    }
-    for (const step of previewBrief.inspectionPlan.slice(2)) {
-        for (const target of step.targets) {
-            if (!looksLikeProjectPath(target))
-                continue;
-            const normalizedTarget = firstComponentByDir.get(target) ?? target;
-            if (seen.has(normalizedTarget))
-                continue;
-            seen.add(normalizedTarget);
-            readFirst.push({
-                path: normalizedTarget,
-                reason: step.reason,
-            });
-            if (readFirst.length >= 8) {
-                return readFirst;
-            }
-        }
-    }
-    return readFirst;
-}
-function buildAgentFacts(projectFacts, components, cssVariables, discoveredFamilyFacts) {
-    return [
-        `Use ${projectFacts.framework} conventions.`,
-        `Implement /preview at ${projectFacts.previewEntryFile}.`,
-        "Use repo-relative paths only.",
-        `Found ${components.length} component candidates and ${cssVariables.length} CSS variables.`,
-        ...discoveredFamilyFacts,
-    ];
-}
-function buildGapNotes(projectFacts, components, cssVariables, discoveryGaps) {
-    const gaps = [...discoveryGaps];
-    if (components.length === 0) {
-        gaps.push("No components were detected. Grep src/components, src/ui, src/features, components, ui, or features before assuming the app has no reusable UI.");
-    }
-    if (cssVariables.length === 0 && projectFacts.likelyStyleFiles.length > 0) {
-        gaps.push(`No CSS variables were detected. Read ${projectFacts.likelyStyleFiles[0]} directly and look for literal classes, theme config, or inline color tokens.`);
-    }
-    if (projectFacts.likelyStyleFiles.length === 0) {
-        gaps.push("No global style files were detected. Inspect app shell files and component code directly for layout and color usage.");
-    }
-    return gaps;
-}
-async function buildUsageBridges(projectRoot, styleFiles, components) {
-    const bridges = [];
-    for (const relativePath of styleFiles) {
-        const fileContents = await readText(join(projectRoot, relativePath));
-        if (!fileContents)
-            continue;
-        if (fileContents.includes("hsl(var(--")) {
-            bridges.push(`Theme tokens are bridged through hsl(var(--...)) in ${relativePath}.`);
-            break;
-        }
-    }
-    const hexByFile = await collectHexLiterals(projectRoot, components);
-    for (const [path, hexValues] of hexByFile.slice(0, 3)) {
-        bridges.push(`Literal accents also appear in ${path}: ${hexValues.join(", ")}.`);
-    }
-    return bridges;
-}
-async function collectHexLiterals(projectRoot, components) {
-    const matches = [];
-    for (const component of components) {
-        const contents = await readText(join(projectRoot, component.path));
-        if (!contents)
-            continue;
-        const hexMatches = Array.from(contents.matchAll(/#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})\b/g))
-            .map((match) => normalizeHex(match[0]))
-            .filter((value, index, values) => values.indexOf(value) === index);
-        if (hexMatches.length > 0) {
-            matches.push([component.path, hexMatches.slice(0, 4)]);
-        }
-    }
-    return matches;
-}
-function normalizeHex(hex) {
-    const normalized = hex.replace("#", "").toUpperCase();
-    if (normalized.length === 3) {
-        return `#${normalized
-            .split("")
-            .map((char) => `${char}${char}`)
-            .join("")}`;
-    }
-    return `#${normalized}`;
-}
-function looksLikeProjectPath(target) {
-    return target.includes("/") || /^[A-Za-z0-9._-]+\.(?:tsx|ts|jsx|js|css|scss|sass|less)$/.test(target);
-}

package/dist/server.js

@@ -224,9 +224,9 @@ export function createServer(projectRoot = process.cwd()) {
             preview_entry_file: z.string(),
             component_count: z.number(),
             css_variable_count: z.number(),
-            read_first: z.array(z.string()),
-            warnings: z.array(z.string()),
-            summary: z.string(),
+            component_dirs: z.array(z.string()),
+            style_files: z.array(z.string()),
+            discovered_families: z.array(z.string()),
         },
     }, async ({ artifactPath = ".capy/design-system.json", mode = "build", changedFiles, userGoal }) => {
         const artifact = await writeDesignSystemArtifact(projectRoot, {
@@ -243,9 +243,9 @@ export function createServer(projectRoot = process.cwd()) {
             preview_entry_file: artifact.repo.previewEntryFile,
             component_count: artifact.components.count,
             css_variable_count: artifact.tokens.cssVariables.length,
-            read_first: artifact.forAgent.readFirst.map((item) => item.path),
-            warnings: artifact.forAgent.gaps,
-            summary: artifact.forAgent.intent,
+            component_dirs: artifact.scan.componentDirs,
+            style_files: artifact.scan.styleFiles,
+            discovered_families: artifact.scan.discoveredFamilies,
         };
         return {
             content: [
@@ -263,7 +263,8 @@ export function createServer(projectRoot = process.cwd()) {
     return server;
 }
 export async function main() {
-    const server = createServer();
+    const projectRoot = process.argv[2] || process.cwd();
+    const server = createServer(projectRoot);
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/dist/types.d.ts

@@ -66,17 +66,6 @@ export interface ComponentRecord {
     kind: "primitive" | "component" | "feature" | "unknown";
 }
 export interface DesignSystemArtifact {
-    forAgent: {
-        intent: string;
-        readFirst: Array<{
-            path: string;
-            reason: string;
-        }>;
-        facts: string[];
-        bridges: string[];
-        gaps: string[];
-        updateHints: string[];
-    };
     artifact: {
         generatedAt: string;
         mode: "build" | "update";
@@ -95,6 +84,7 @@ export interface DesignSystemArtifact {
         pageDirs: string[];
         styleFiles: string[];
         uiDirs: string[];
+        discoveredFamilies: string[];
     };
     tokens: {
         cssVariables: CssVariableRecord[];
@@ -104,12 +94,6 @@ export interface DesignSystemArtifact {
         count: number;
         items: ComponentRecord[];
     };
-    preview: {
-        route: string;
-        entryFile: string;
-        sections: string[];
-        updateStrategy: string[];
-    };
 }
 export interface PreviewStateSnapshot {
     generatedAt: string;

package/dist/update.js

@@ -29,7 +29,7 @@ export async function runPreviewUpdate(projectRoot, input = {}) {
         userGoal: input.userGoal,
     });
     await writePreviewStateSnapshot(projectRoot, snapshotPath, diffResult.snapshot);
-    const warnings = [...previewBrief.warnings];
+    const warnings = [];
     if (diffResult.baselineCreated) {
         warnings.unshift("No prior preview-state snapshot was found. Capy created a baseline snapshot, so this run cannot infer incremental changes automatically.");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capy-mcp",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "MCP server that inspects a repo, returns a structured /preview brief, and writes a design-system JSON artifact for AI coding agents",
   "type": "module",
   "main": "dist/index.js",