sonance-brand-mcp 1.1.7 → 1.2.3

package/dist/assets/BRAND_GUIDELINES.md

@@ -160,14 +160,6 @@ The clear space ensures the logo remains legible and impactful in all applicatio
 - Never place our logo over busy backgrounds
 - Never modify proportions or recreate the logo
 
-### Tagline Lockups
-
-When utilizing the Sonance tagline "BEYOND SOUND", use the appropriate lockup based on available space:
-
-**Horizontal Lockup**: Use when the space allowed is horizontal. The cap height of the logo serves as a guide to ensure a consistent relationship between the Sonance logo and tagline.
-
-**Vertical Lockup**: Use wherever vertical space allows for it. Use the height of the beam plus the cut as a guide to ensure a consistent relationship.
-
 ### Sonance Foundation
 
 The Sonance Foundation logo is clean, lean and all caps. The 2 color version, with the arrow (the green accent) should be used for any and all Foundation brand communications.

package/dist/assets/logo-manifest.json

@@ -2,24 +2,6 @@
   "/logos/40th-anniversary/Sonance_40_Logo_CMYK_BEAM_BLUE_40_AND_BEAM_DARK.png",
   "/logos/Sonance logo dark mode.png",
   "/logos/Sonance logo light mode.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Horizontal_2C_Dark_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Horizontal_2C_Light_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Horizontal_2C_Reverse_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Horizontal_Black_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Horizontal_Grayscale_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Horizontal_Reverse_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Large_2C_Dark_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Large_2C_Light_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Large_2C_Reverse_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Large_Black_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Large_Grayscale_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Large_Reverse_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Small_2C_Dark_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Small_2C_Light_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Small_2C_Reverse_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Small_Black_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Small_Grayscale_RGB.png",
-  "/logos/beyond-sound/Sonance_Logo_Tagline_Small_Reverse_RGB.png",
   "/logos/blaze/BlazeBySonance_Logo_Lockup_2C_Light_RGB_05162025.png",
   "/logos/blaze/BlazeBySonance_Logo_Lockup_3C_Dark_RGB_05162025.png",
   "/logos/blaze/BlazeBySonance_Logo_Lockup_White_RGB_05162025.png",

package/dist/index.js

@@ -641,7 +641,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             {
                 name: "get_full_library",
-                description: "Returns the complete component library including brand guidelines, CSS theme, utilities, and all component source code. Use this when you need to build a full application with Sonance styling.",
+                description: "RECOMMENDED FOR APP REDESIGNS & FULL APPLICATIONS: Returns the complete component library including brand guidelines, CSS theme, utilities, and all component source code. USE THIS TOOL when the user asks to: redesign an application, rebrand an app, build a full application, update an entire codebase to use Sonance/IPORT/Blaze brand, or any multi-file/multi-component project. This is the go-to tool for comprehensive brand implementation across an entire project.",
                 inputSchema: {
                     type: "object",
                     properties: {},
@@ -2604,6 +2604,91 @@ server.setRequestHandler(ListPromptsRequestSchema, async () => ({
                 },
             ],
         },
+        // ========== EXCELLENCE WORKFLOW PROMPTS ==========
+        {
+            name: "design-with-excellence",
+            description: "FULL WORKFLOW: Design any branded output (UI, document, email, etc.) with MANDATORY quality gates. Automatically iterates until Tier 4+ (score ≥85) is achieved.",
+            arguments: [
+                {
+                    name: "request",
+                    description: "What to create (e.g., 'hero section', 'proposal PDF', 'email template', 'Excel report')",
+                    required: true,
+                },
+                {
+                    name: "brand",
+                    description: "Which brand: sonance, iport, or blaze (defaults to sonance)",
+                    required: false,
+                },
+                {
+                    name: "theme",
+                    description: "Color scheme: light or dark (defaults based on brand)",
+                    required: false,
+                },
+            ],
+        },
+        {
+            name: "rebrand-with-excellence",
+            description: "FULL WORKFLOW: Rebrand an existing document/asset to a target brand with MANDATORY quality verification. Iterates until Tier 4+ is achieved.",
+            arguments: [
+                {
+                    name: "source_format",
+                    description: "Format of document to rebrand: word, pdf, excel, powerpoint, html, or generic",
+                    required: true,
+                },
+                {
+                    name: "target_brand",
+                    description: "Target brand: sonance, iport, or blaze",
+                    required: true,
+                },
+                {
+                    name: "description",
+                    description: "Brief description of the document being rebranded",
+                    required: false,
+                },
+            ],
+        },
+        {
+            name: "document-with-excellence",
+            description: "FULL WORKFLOW: Generate a branded document (Word/PDF/Excel) with code templates and MANDATORY quality verification.",
+            arguments: [
+                {
+                    name: "format",
+                    description: "Document format: word-python, pdf-python, or excel-python",
+                    required: true,
+                },
+                {
+                    name: "template_type",
+                    description: "Type of document: proposal, spec-sheet, report, invoice, or presentation",
+                    required: true,
+                },
+                {
+                    name: "brand",
+                    description: "Which brand: sonance, iport, or blaze (defaults to sonance)",
+                    required: false,
+                },
+            ],
+        },
+        {
+            name: "app-redesign-with-excellence",
+            description: "FULL WORKFLOW: Redesign an entire application (Next.js, React, etc.) to use Sonance/IPORT/Blaze brand with MANDATORY quality gates on each major section. Use this for full app rebrands.",
+            arguments: [
+                {
+                    name: "app_description",
+                    description: "Describe the app to redesign (e.g., 'dashboard app', 'e-commerce site', 'admin panel')",
+                    required: true,
+                },
+                {
+                    name: "brand",
+                    description: "Which brand to apply: sonance, iport, or blaze (defaults to sonance)",
+                    required: false,
+                },
+                {
+                    name: "theme",
+                    description: "Color scheme: light or dark (defaults based on brand)",
+                    required: false,
+                },
+            ],
+        },
     ],
 }));
 server.setRequestHandler(GetPromptRequestSchema, async (request) => {
@@ -2707,6 +2792,390 @@ Provide the score, tier, and a clear improvement plan to reach Tier 4+ if needed
             ],
         };
     }
+    // ========== EXCELLENCE WORKFLOW PROMPT HANDLERS ==========
+    if (name === "design-with-excellence") {
+        const request = promptArgs?.request || "component";
+        const brand = promptArgs?.brand || "sonance";
+        const theme = promptArgs?.theme || (brand === "sonance" ? "light" : "dark");
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `# Design with Excellence Workflow
+
+## Request
+Create: **${request}**
+Brand: **${brand.toUpperCase()}**
+Theme: **${theme}**
+
+---
+
+## MANDATORY WORKFLOW - You MUST follow these steps:
+
+### Step 1: Get Design Tokens
+Call \`design_component\` with:
+- component_description: "${request}"
+- brand: "${brand}"
+- theme: "${theme}"
+
+### Step 2: Generate the Design
+Using the design tokens from Step 1, create the ${request}.
+- Follow all brand guidelines exactly
+- Use semantic color variables (not hardcoded hex)
+- Apply correct typography (Montserrat, light/medium weights)
+- Include dark mode support if UI component
+
+### Step 3: Evaluate (MANDATORY)
+You **MUST** call \`evaluate_design\` with your generated code.
+- Pass the complete code
+- Include a brief description
+
+### Step 4: Check Score
+- If score **≥ 85** (Tier 4+): Proceed to Step 5
+- If score **< 85**: You **MUST** iterate:
+  1. Review the gaps identified in the evaluation
+  2. Fix each issue listed
+  3. Re-run \`evaluate_design\`
+  4. Repeat until score ≥ 85
+
+### Step 5: Final Verification
+Call \`get_excellence_checklist\` and verify all items pass.
+
+### Step 6: Deliver
+Only after achieving Tier 4+ (score ≥ 85), present the final output to the user.
+
+---
+
+## CRITICAL RULES
+- You **MUST NOT** skip the evaluate_design step
+- You **MUST NOT** deliver with score < 85
+- You **MUST** iterate if score < 85
+- The evaluate → iterate loop continues until Tier 4+ is achieved
+
+## Tier Reference
+- Tier 5 (95-100): Portfolio-worthy - exceed expectations
+- Tier 4 (85-94): Professional - **MINIMUM for delivery**
+- Tier 3 (70-84): Needs iteration - do not deliver
+- Tier 2 (50-69): Major issues - do not deliver
+- Tier 1 (0-49): Rebuild required - do not deliver
+
+Begin the workflow now.`,
+                    },
+                },
+            ],
+        };
+    }
+    if (name === "rebrand-with-excellence") {
+        const sourceFormat = promptArgs?.source_format || "generic";
+        const targetBrand = promptArgs?.target_brand || "sonance";
+        const description = promptArgs?.description || "document";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `# Rebrand with Excellence Workflow
+
+## Request
+Rebrand: **${description}**
+Source Format: **${sourceFormat}**
+Target Brand: **${targetBrand.toUpperCase()}**
+
+---
+
+## MANDATORY WORKFLOW - You MUST follow these steps:
+
+### Step 1: Get Rebranding Guide
+Call \`rebrand_document\` with:
+- source_format: "${sourceFormat}"
+- target_brand: "${targetBrand}"
+
+This will provide:
+- Color replacement mappings
+- Font substitutions
+- Logo placement rules
+- Spacing guidelines
+
+### Step 2: Apply the Rebrand
+Using the guide from Step 1:
+- Replace all colors with brand colors
+- Update fonts to Montserrat (or Arial for Excel)
+- Apply correct logo placement
+- Adjust spacing per guidelines
+
+### Step 3: Evaluate (MANDATORY)
+You **MUST** call \`evaluate_design\` with:
+- code: The rebranded output/code
+- description: "${description}"
+- brand: "${targetBrand}"
+- output_type: "doc" (for documents) or appropriate type
+
+### Step 4: Check Score
+- If score **≥ 85** (Tier 4+): Proceed to Step 5
+- If score **< 85**: You **MUST** iterate:
+  1. Review gaps from evaluation
+  2. Fix each issue
+  3. Re-run \`evaluate_design\`
+  4. Repeat until score ≥ 85
+
+### Step 5: Deliver
+Only after achieving Tier 4+ (score ≥ 85), present the rebranded output.
+
+---
+
+## CRITICAL RULES
+- You **MUST NOT** skip the evaluate_design step
+- You **MUST NOT** deliver with score < 85
+- You **MUST** iterate if score < 85
+- Every color must match the brand palette exactly
+- The document must be unmistakably ${targetBrand.toUpperCase()}
+
+Begin the workflow now.`,
+                    },
+                },
+            ],
+        };
+    }
+    if (name === "document-with-excellence") {
+        const format = promptArgs?.format || "word-python";
+        const templateType = promptArgs?.template_type || "report";
+        const brand = promptArgs?.brand || "sonance";
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `# Document Generation with Excellence Workflow
+
+## Request
+Generate: **${templateType}** document
+Format: **${format}**
+Brand: **${brand.toUpperCase()}**
+
+---
+
+## MANDATORY WORKFLOW - You MUST follow these steps:
+
+### Step 1: Get Document Template
+Call \`get_document_template\` with:
+- format: "${format}"
+- brand: "${brand}"
+- template_type: "${templateType}"
+
+This provides the base code template with correct brand constants.
+
+### Step 2: Get Design Tokens
+Call \`design_component\` with:
+- component_description: "${templateType} document"
+- brand: "${brand}"
+- output_type: "doc"
+
+This provides additional styling guidance.
+
+### Step 3: Generate the Document Code
+Using templates from Steps 1 & 2:
+- Customize for the specific ${templateType}
+- Ensure all brand colors are correct
+- Apply proper fonts and sizing
+- Include headers, footers, and logo placement
+
+### Step 4: Evaluate (MANDATORY)
+You **MUST** call \`evaluate_design\` with:
+- code: Your generated document code
+- description: "${templateType} document for ${brand}"
+- brand: "${brand}"
+- output_type: "doc"
+
+### Step 5: Check Score
+- If score **≥ 85** (Tier 4+): Proceed to Step 6
+- If score **< 85**: You **MUST** iterate:
+  1. Review gaps from evaluation
+  2. Fix each issue
+  3. Re-run \`evaluate_design\`
+  4. Repeat until score ≥ 85
+
+### Step 6: Deliver
+Only after achieving Tier 4+ (score ≥ 85), present the final document code.
+
+---
+
+## CRITICAL RULES
+- You **MUST NOT** skip the evaluate_design step
+- You **MUST NOT** deliver with score < 85
+- You **MUST** iterate if score < 85
+- Document must be production-ready
+- All brand constants must be exact
+
+## Format Reference
+- word-python: Uses python-docx library
+- pdf-python: Uses ReportLab library
+- excel-python: Uses openpyxl library
+
+Begin the workflow now.`,
+                    },
+                },
+            ],
+        };
+    }
+    if (name === "app-redesign-with-excellence") {
+        const appDescription = promptArgs?.app_description || "application";
+        const brand = promptArgs?.brand || "sonance";
+        const theme = promptArgs?.theme || (brand === "sonance" ? "light" : "dark");
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `# App Redesign with Excellence Workflow
+
+## Request
+Redesign: **${appDescription}**
+Target brand: **${brand.toUpperCase()}**
+Theme: **${theme}**
+
+---
+
+## MANDATORY WORKFLOW - You MUST follow these steps exactly:
+
+### Step 1: Get Complete Component Library (REQUIRED FIRST STEP)
+You **MUST** call \`get_full_library\` as your FIRST action.
+
+This gives you the complete ${brand.toUpperCase()} component library including:
+- Brand guidelines and color system
+- Complete CSS theme with all variables
+- Utility functions (cn for className merging)
+- All component source code (Button, Card, Input, etc.)
+
+**DO NOT proceed without calling get_full_library first.**
+
+### Step 2: Audit the Existing Application (MANDATORY)
+You **MUST** thoroughly scan the existing codebase to understand what needs changing.
+
+**2a. Scan for Components**
+Search for and list all UI components:
+- Buttons, Cards, Inputs, Forms, Modals, Tables
+- Navigation components (headers, sidebars, menus)
+- Custom components in /components directory
+- Note: Which can be replaced with ${brand.toUpperCase()} library equivalents?
+
+**2b. Find Hardcoded Colors**
+Search for and list all color values:
+- Hex codes (#fff, #000, #3b82f6, etc.)
+- RGB/RGBA values (rgb(59, 130, 246))
+- HSL values
+- Tailwind color classes (bg-blue-500, text-gray-900)
+- Note: These ALL need to be replaced with semantic variables
+
+**2c. Locate Logo Files**
+Find all logo/brand assets:
+- Search /public, /assets, /images directories
+- Check for SVG, PNG, JPG logo files
+- Find where logos are imported/used in code
+- Note: These need to be replaced with ${brand.toUpperCase()} logos
+
+**2d. Check Theme/CSS Setup**
+Examine existing styling infrastructure:
+- globals.css or global styles
+- tailwind.config.js/ts (custom colors, fonts)
+- Theme providers or context
+- CSS variables already in use
+- Note: This is where ${brand.toUpperCase()} theme will be integrated
+
+**2e. Font Configuration**
+Check current font setup:
+- Font imports (Google Fonts, local fonts)
+- Font family declarations
+- Note: Replace with Montserrat
+
+**2f. Additional Findings**
+Note any other brand-related items discovered:
+- Third-party UI libraries (shadcn, MUI, Chakra, etc.)
+- Animation libraries with hardcoded color values
+- Icon sets that may need updating
+- Environment-specific styles or themes
+- Any other brand-inconsistent patterns
+
+**After auditing, create a change manifest:**
+| Category | Files Found | Changes Needed |
+|----------|-------------|----------------|
+| Components | list files... | Replace with ${brand.toUpperCase()} equivalents |
+| Colors | list files... | Convert to CSS variables |
+| Logos | list files... | Replace with ${brand.toUpperCase()} logos |
+| Theme | list files... | Integrate ${brand.toUpperCase()} theme |
+| Fonts | list files... | Switch to Montserrat |
+| Other | list files... | Address findings |
+
+### Step 3: Redesign Systematically
+Work through the app in this order:
+
+**3a. Root Layout / Theme Provider**
+- Set up CSS variables from the library
+- Configure Montserrat font
+- Set up theme provider for light/dark mode
+
+**3b. Navigation / Header**
+- Apply ${brand.toUpperCase()} navigation patterns
+- Use correct logo variant for theme
+- Apply brand colors and spacing
+
+**3c. Main Pages**
+- Update each page to use brand components
+- Apply semantic color variables
+- Ensure proper typography hierarchy
+
+**3d. Shared Components**
+- Replace existing components with ${brand.toUpperCase()} library equivalents
+- Ensure consistent styling
+
+### Step 4: Evaluate Each Section (MANDATORY)
+After updating each major file/section, you **MUST**:
+
+1. Call \`evaluate_design\` with:
+   - code: The updated code for that section
+   - description: Brief description of what was updated
+   - brand: "${brand}"
+   - output_type: "ui"
+
+2. Check the score:
+   - Score **≥ 85** (Tier 4+): Move to next section
+   - Score **< 85**: You **MUST** fix the identified gaps and re-evaluate
+
+**DO NOT move to the next section until the current one scores ≥ 85.**
+
+### Step 5: Final Delivery
+Only after ALL sections have achieved Tier 4+ (score ≥ 85):
+- Provide summary of all changes made
+- List files modified
+- Confirm all evaluations passed
+
+---
+
+## CRITICAL RULES
+- You **MUST** call \`get_full_library\` as your FIRST action
+- You **MUST** evaluate each major section before moving on
+- You **MUST NOT** skip evaluation steps
+- You **MUST NOT** deliver until all sections score ≥ 85
+- If any section scores < 85, iterate until it passes
+- Use semantic CSS variables (--background, --foreground, etc.)
+- Keep corners sharp (0-4px border radius)
+- Apply generous whitespace ("Designed to Disappear" philosophy)
+
+## Brand Quick Reference
+- Primary color: ${brand === "sonance" ? "Charcoal (#343d46)" : brand === "iport" ? "Black (#000000)" : "Orange (#f26522)"}
+- Font: Montserrat (weights 300-700)
+- Style: Minimalist, sophisticated, corporate-modern
+
+Begin the workflow now by calling \`get_full_library\`.`,
+                    },
+                },
+            ],
+        };
+    }
     throw new Error(`Unknown prompt: ${name}`);
 });
 // ============================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sonance-brand-mcp",
-  "version": "1.1.7",
+  "version": "1.2.3",
   "description": "MCP Server for Sonance Brand Guidelines and Component Library - gives Claude instant access to brand colors, typography, and UI components.",
   "main": "dist/index.js",
   "type": "module",