@fugood/bricks-ctor 2.24.0-beta.40

package/tools/mcp-tools/icons.ts

@@ -0,0 +1,70 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { z } from 'zod'
+import * as TOON from '@toon-format/toon'
+import Fuse from 'fuse.js'
+import glyphmap from '../icons/fa6pro-glyphmap.json'
+import glyphmapMeta from '../icons/fa6pro-meta.json'
+
+type IconStyle = 'brands' | 'duotone' | 'light' | 'regular' | 'solid' | 'thin'
+
+// Bitmask bits for icon family membership (compact metadata format)
+const STYLE_BITS: Record<IconStyle, number> = {
+  brands: 1,
+  thin: 2,
+  light: 4,
+  regular: 8,
+  solid: 16,
+  duotone: 256,
+}
+const ALL_STYLES = Object.keys(STYLE_BITS) as IconStyle[]
+const iconMeta = glyphmapMeta as Record<string, number>
+
+const iconList = Object.entries(glyphmap as Record<string, number>).map(([name, code]) => {
+  const bits = iconMeta[name] || 0
+  const styles = ALL_STYLES.filter((s) => bits & STYLE_BITS[s])
+  return { name, code, styles }
+})
+
+const iconFuse = new Fuse(iconList, {
+  keys: ['name'],
+  threshold: 0.3,
+  includeScore: true,
+})
+
+export function register(server: McpServer) {
+  server.tool(
+    'icon_search',
+    {
+      query: z.string().describe('Search keywords for FontAwesome 6 Pro icons'),
+      limit: z.number().min(1).max(100).optional().default(10),
+      style: z
+        .enum(['brands', 'duotone', 'light', 'regular', 'solid', 'thin'])
+        .optional()
+        .describe('Filter by icon style'),
+    },
+    async ({ query, limit, style }) => {
+      let results = iconFuse.search(query, { limit: style ? limit * 3 : limit })
+
+      if (style) {
+        results = results.filter((r) => r.item.styles.includes(style)).slice(0, limit)
+      }
+
+      const icons = results.map((r) => ({
+        name: r.item.name,
+        code: r.item.code,
+        unicode: `U+${r.item.code.toString(16).toUpperCase()}`,
+        styles: r.item.styles,
+        score: r.score,
+      }))
+
+      return {
+        content: [
+          {
+            type: 'text',
+            text: TOON.encode({ count: icons.length, icons }),
+          },
+        ],
+      }
+    },
+  )
+}

package/tools/mcp-tools/lottie.ts

@@ -0,0 +1,102 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { z } from 'zod'
+import * as TOON from '@toon-format/toon'
+
+const LOTTIEFILES_API_URL = 'https://lottiefiles.com/api'
+
+export function register(server: McpServer) {
+  server.tool(
+    'lottie_search',
+    {
+      query: z.string().describe('Search keywords for animations'),
+      page: z.number().min(1).optional().default(1),
+      limit: z.number().min(1).max(100).optional().default(10),
+    },
+    async ({ query, page, limit }) => {
+      try {
+        const url = new URL(`${LOTTIEFILES_API_URL}/search/get-animations`)
+        url.searchParams.set('query', query)
+        url.searchParams.set('page', String(page))
+        url.searchParams.set('limit', String(limit))
+        url.searchParams.set('format', 'json')
+
+        const response = await fetch(url.toString())
+        const data = await response.json()
+        const animations = data?.data?.data ?? []
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: TOON.encode({ count: animations.length, animations }),
+            },
+          ],
+        }
+      } catch (err: any) {
+        return {
+          content: [{ type: 'text', text: `Failed to search animations: ${err.message}` }],
+        }
+      }
+    },
+  )
+
+  server.tool(
+    'lottie_get_details',
+    {
+      id: z.string().describe('Animation file ID'),
+    },
+    async ({ id }) => {
+      try {
+        const url = new URL(`${LOTTIEFILES_API_URL}/animations/get-animation-data`)
+        url.searchParams.set('fileId', id)
+        url.searchParams.set('format', 'json')
+
+        const response = await fetch(url.toString())
+        const data = await response.json()
+
+        return {
+          content: [{ type: 'text', text: TOON.encode(data) }],
+        }
+      } catch (err: any) {
+        return {
+          content: [{ type: 'text', text: `Failed to get animation: ${err.message}` }],
+        }
+      }
+    },
+  )
+
+  server.tool(
+    'lottie_popular',
+    {
+      page: z.number().min(1).optional().default(1),
+      limit: z.number().min(1).max(100).optional().default(10),
+    },
+    async ({ page, limit }) => {
+      try {
+        const url = new URL(
+          `${LOTTIEFILES_API_URL}/iconscout/popular-animations-weekly?api=%26sort%3Dpopular`,
+        )
+        url.searchParams.set('page', String(page))
+        url.searchParams.set('limit', String(limit))
+        url.searchParams.set('format', 'json')
+
+        const response = await fetch(url.toString())
+        const data = await response.json()
+        const animations = data?.popularWeeklyData?.data ?? []
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: TOON.encode({ count: animations.length, animations }),
+            },
+          ],
+        }
+      } catch (err: any) {
+        return {
+          content: [{ type: 'text', text: `Failed to get popular animations: ${err.message}` }],
+        }
+      }
+    },
+  )
+}

package/tools/mcp-tools/media.ts

@@ -0,0 +1,110 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { z } from 'zod'
+import { $ } from 'bun'
+
+const runBricks = async (projectDir: string, ...args: string[]) => {
+  try {
+    return await $`bunx bricks ${args}`.cwd(projectDir).text()
+  } catch (err: any) {
+    throw new Error(err.stderr?.toString() || err.message)
+  }
+}
+
+export function register(server: McpServer, projectDir: string) {
+  server.tool('media_boxes', {}, async () => {
+    try {
+      const output = await runBricks(projectDir, 'media', 'boxes')
+      return { content: [{ type: 'text', text: output }] }
+    } catch (err: any) {
+      return { content: [{ type: 'text', text: `Failed to list media boxes: ${err.message}` }] }
+    }
+  })
+
+  server.tool('media_get_box', { id: z.string().describe('Media box ID') }, async ({ id }) => {
+    try {
+      const output = await runBricks(projectDir, 'media', 'box', id)
+      return { content: [{ type: 'text', text: output }] }
+    } catch (err: any) {
+      return { content: [{ type: 'text', text: `Failed to get media box: ${err.message}` }] }
+    }
+  })
+
+  server.tool(
+    'media_files',
+    {
+      boxId: z.string().describe('Media box ID'),
+      types: z.string().describe('Comma-separated file types to include').optional(),
+      userTag: z.array(z.string()).describe('Filter by user tags').optional(),
+      limit: z.number().describe('Limit results').optional(),
+      offset: z.number().describe('Offset results').optional(),
+    },
+    async ({ boxId, types, userTag, limit, offset }) => {
+      try {
+        const args = ['media', 'files', boxId]
+        if (types) args.push('-t', types)
+        if (userTag) userTag.forEach((tag) => args.push('-u', tag))
+        if (limit != null) args.push('-l', String(limit))
+        if (offset != null) args.push('-o', String(offset))
+        const output = await runBricks(projectDir, ...args)
+        return { content: [{ type: 'text', text: output }] }
+      } catch (err: any) {
+        return { content: [{ type: 'text', text: `Failed to list media files: ${err.message}` }] }
+      }
+    },
+  )
+
+  server.tool('media_file', { id: z.string().describe('Media file ID') }, async ({ id }) => {
+    try {
+      const output = await runBricks(projectDir, 'media', 'file', id)
+      return { content: [{ type: 'text', text: output }] }
+    } catch (err: any) {
+      return { content: [{ type: 'text', text: `Failed to get media file: ${err.message}` }] }
+    }
+  })
+
+  server.tool(
+    'media_upload_files',
+    {
+      boxId: z.string().describe('Target media box ID'),
+      files: z.array(z.string()).min(1).describe('File paths to upload'),
+      description: z.string().describe('File description').optional(),
+      userTags: z.array(z.string()).max(15).describe('User tags (max 15)').optional(),
+      imageVersion: z
+        .array(z.string())
+        .describe('Image resize specs as WxH or WxH:STRATEGY')
+        .optional(),
+      imageVersionType: z.enum(['jpg', 'png']).describe('Image output format').optional(),
+      enableAiAnalysis: z.boolean().describe('Enable AI analysis').optional(),
+      aiInstruction: z.string().describe('Custom AI analysis instruction').optional(),
+      concurrency: z.number().min(1).describe('Max concurrent uploads').optional(),
+    },
+    async ({
+      boxId,
+      files,
+      description,
+      userTags,
+      imageVersion,
+      imageVersionType,
+      enableAiAnalysis,
+      aiInstruction,
+      concurrency,
+    }) => {
+      try {
+        const args = ['media', 'upload', boxId, ...files]
+        if (description) args.push('-d', description)
+        if (userTags) userTags.forEach((tag) => args.push('-t', tag))
+        if (imageVersion) imageVersion.forEach((spec) => args.push('--image-version', spec))
+        if (imageVersionType) args.push('--image-version-type', imageVersionType)
+        if (enableAiAnalysis) args.push('--enable-ai-analysis')
+        if (aiInstruction) args.push('--ai-instruction', aiInstruction)
+        if (concurrency != null) args.push('--concurrency', String(concurrency))
+        const output = await runBricks(projectDir, ...args)
+        return { content: [{ type: 'text', text: output }] }
+      } catch (err: any) {
+        return {
+          content: [{ type: 'text', text: `Failed to upload media files: ${err.message}` }],
+        }
+      }
+    },
+  )
+}

package/tools/postinstall.ts

@@ -0,0 +1,229 @@
+import { $ } from 'bun'
+import {
+  cp,
+  lstat,
+  mkdir,
+  readFile,
+  readdir,
+  readlink,
+  rm,
+  stat,
+  symlink,
+  writeFile,
+} from 'fs/promises'
+import * as path from 'path'
+import TOML from '@iarna/toml'
+
+const cwd = process.cwd()
+const projectSkillsDir = path.join(cwd, '.bricks', 'skills')
+const compatibilitySkillLinks = [
+  path.join(cwd, '.claude', 'skills'),
+  path.join(cwd, '.codex', 'skills'),
+]
+
+async function exists(f: string) {
+  try {
+    await stat(f)
+    return true
+  } catch {
+    return false
+  }
+}
+
+async function pathExists(f: string) {
+  try {
+    await lstat(f)
+    return true
+  } catch {
+    return false
+  }
+}
+
+// Migrate old projects: remove legacy project/ directory
+const oldProjectDir = path.join(cwd, 'project')
+if (await exists(oldProjectDir)) {
+  await rm(oldProjectDir, { recursive: true, force: true })
+  console.log('Removed legacy project/ directory')
+}
+
+// handle flag --skip-copy
+const skipCopyProject = process.argv.includes('--skip-copy-project')
+if (skipCopyProject) {
+  console.log('Skipping copy of files to ctor/')
+} else {
+  const libFiles = ['types', 'utils', 'index.ts']
+
+  await $`mkdir -p ${cwd}/ctor`
+  await Promise.all(libFiles.map((file) => $`cp -r ${__dirname}/../${file} ${cwd}/ctor`))
+  console.log('Copied files to ctor/')
+}
+
+const projectMcpServer = {
+  command: 'bun',
+  args: [`${cwd}/node_modules/@fugood/bricks-ctor/tools/mcp-server.ts`],
+}
+
+type CodexMcpConfig = {
+  mcp_servers: Record<string, typeof projectMcpServer>
+}
+
+// Claude Code and AGENTS.md projects both use the shared project .mcp.json file.
+const defaultMcpConfig = {
+  mcpServers: {
+    'bricks-ctor': projectMcpServer,
+  },
+}
+
+const handleMcpConfigOverride = async (mcpConfigPath: string) => {
+  let mcpConfig: { mcpServers: Record<string, typeof projectMcpServer> } | null = null
+  if (await exists(mcpConfigPath)) {
+    const configStr = await readFile(mcpConfigPath, 'utf-8')
+    try {
+      mcpConfig = JSON.parse(configStr)
+      if (!mcpConfig?.mcpServers) throw new Error('mcpServers is not defined')
+      mcpConfig.mcpServers['bricks-ctor'] = projectMcpServer
+      delete mcpConfig.mcpServers['bricks-project']
+    } catch {
+      mcpConfig = defaultMcpConfig
+    }
+  } else {
+    mcpConfig = defaultMcpConfig
+  }
+
+  await writeFile(mcpConfigPath, `${JSON.stringify(mcpConfig, null, 2)}\n`)
+
+  console.log(`Updated ${mcpConfigPath}`)
+}
+
+const hasClaudeCode = await exists(`${cwd}/CLAUDE.md`)
+const hasAgentsMd = await exists(`${cwd}/AGENTS.md`)
+
+if (hasClaudeCode || hasAgentsMd) {
+  // Keep the workspace-level JSON MCP config aligned for tools that read .mcp.json.
+  const mcpConfigPath = `${cwd}/.mcp.json`
+  await handleMcpConfigOverride(mcpConfigPath)
+}
+
+const copyMissingSkills = async (sourceDir: string, targetDir: string) => {
+  if (!(await exists(sourceDir))) return
+
+  const packageSkills = await readdir(sourceDir, { withFileTypes: true })
+  const skillsToInstall = packageSkills.filter(
+    (entry) => entry.isDirectory() && !entry.name.startsWith('.'),
+  )
+
+  await mkdir(targetDir, { recursive: true })
+
+  await Promise.all(
+    skillsToInstall.map(async (entry) => {
+      const targetSkillDir = path.join(targetDir, entry.name)
+      if (await exists(targetSkillDir)) {
+        console.log(`Skill '${entry.name}' already exists, skipping`)
+      } else {
+        await cp(path.join(sourceDir, entry.name), targetSkillDir, { recursive: true })
+        console.log(`Installed skill '${entry.name}' to ${targetDir}/`)
+      }
+    }),
+  )
+}
+
+const migrateSkillsDir = async (legacySkillsDir: string, canonicalSkillsDir: string) => {
+  if (!(await pathExists(legacySkillsDir))) return
+
+  const legacyStats = await lstat(legacySkillsDir)
+
+  if (legacyStats.isSymbolicLink()) {
+    const linkTarget = await readlink(legacySkillsDir)
+    const resolvedTarget = path.resolve(path.dirname(legacySkillsDir), linkTarget)
+    if (resolvedTarget === canonicalSkillsDir) return
+
+    await copyMissingSkills(resolvedTarget, canonicalSkillsDir)
+    await rm(legacySkillsDir, { force: true, recursive: true })
+    return
+  }
+
+  if (legacyStats.isDirectory()) {
+    await copyMissingSkills(legacySkillsDir, canonicalSkillsDir)
+    await rm(legacySkillsDir, { force: true, recursive: true })
+    return
+  }
+
+  console.warn(`Skipping skills migration for ${legacySkillsDir}; expected a directory or symlink`)
+}
+
+const ensureCompatibilitySkillLink = async (linkPath: string, targetDir: string) => {
+  await mkdir(path.dirname(linkPath), { recursive: true })
+
+  if (await pathExists(linkPath)) {
+    const linkStats = await lstat(linkPath)
+    if (linkStats.isSymbolicLink()) {
+      const linkTarget = await readlink(linkPath)
+      const resolvedTarget = path.resolve(path.dirname(linkPath), linkTarget)
+      if (resolvedTarget === targetDir) return
+    } else {
+      console.warn(
+        `Skipping skills symlink at ${linkPath}; path already exists and is not a symlink`,
+      )
+      return
+    }
+  }
+
+  const relativeTarget = path.relative(path.dirname(linkPath), targetDir)
+  const symlinkType = process.platform === 'win32' ? 'junction' : 'dir'
+  await symlink(relativeTarget, linkPath, symlinkType)
+  console.log(`Linked ${linkPath} -> ${relativeTarget}`)
+}
+
+const setupSkills = async () => {
+  const packageSkillsDir = `${__dirname}/../skills`
+  await mkdir(projectSkillsDir, { recursive: true })
+  await copyMissingSkills(packageSkillsDir, projectSkillsDir)
+
+  for (const linkPath of compatibilitySkillLinks) {
+    await migrateSkillsDir(linkPath, projectSkillsDir)
+    await ensureCompatibilitySkillLink(linkPath, projectSkillsDir)
+  }
+}
+
+if (hasClaudeCode || hasAgentsMd) {
+  // Install project skills once and expose them through compatibility symlinks.
+  await setupSkills()
+}
+
+if (hasAgentsMd) {
+  // Codex stores its project-local MCP config in .codex/config.toml.
+  const defaultCodexMcpConfig = {
+    mcp_servers: {
+      'bricks-ctor': projectMcpServer,
+    },
+  }
+
+  const handleCodexMcpConfigOverride = async (mcpConfigPath: string) => {
+    let mcpConfig: CodexMcpConfig | null = null
+    if (await exists(mcpConfigPath)) {
+      const configStr = await readFile(mcpConfigPath, 'utf-8')
+      try {
+        const parsed = TOML.parse(configStr) as Partial<CodexMcpConfig>
+        if (!parsed?.mcp_servers) throw new Error('mcp_servers is not defined')
+        mcpConfig = { mcp_servers: parsed.mcp_servers }
+        mcpConfig.mcp_servers['bricks-ctor'] = projectMcpServer
+        delete mcpConfig.mcp_servers['bricks-project']
+      } catch {
+        mcpConfig = defaultCodexMcpConfig
+      }
+    } else {
+      mcpConfig = defaultCodexMcpConfig
+    }
+
+    await writeFile(mcpConfigPath, `${TOML.stringify(mcpConfig)}\n`)
+
+    console.log(`Updated ${mcpConfigPath}`)
+  }
+
+  // Keep the Codex TOML MCP config aligned with the same bricks-ctor server entry.
+  const codexConfigPath = `${cwd}/.codex/config.toml`
+  await handleCodexMcpConfigOverride(codexConfigPath)
+}
+
+// TODO: .cursor/skills if needed
+// TODO: User setting in application.json to avoid unnecessary skills/config setup