ui-ux-master 1.1.0 → 1.2.1

package/system-prompts/ui-ux-master-system-add-on.md

@@ -0,0 +1,47 @@
+# UI/UX Master System Prompt Add-on
+
+Use this add-on in any AI coding agent that supports custom instructions, system prompts, project rules, or model context.
+
+## Activation Rule
+
+Activate UI/UX Master only when the user includes `/ui-ux-master` in the request. If the user does not include `/ui-ux-master`, do not apply this workflow automatically.
+
+## Source of Truth
+
+When active, read `.ui-ux-master/SKILL.md` first. If `.ui-ux-master/` is not available, read the installed `ui-ux-master` package files. Use these references when relevant:
+
+- `.ui-ux-master/references/ui-ux-memory-workflow.md`
+- `.ui-ux-master/references/ui-ux-frontend-implementation-rules.md`
+- `.ui-ux-master/references/ui-ux-complete-checklist.md`
+- `.ui-ux-master/references/wcag-aa-quick-reference.md`
+- `.ui-ux-master/references/accessibility-advanced-patterns.md`
+- `.ui-ux-master/references/design-system-playbook.md`
+- `.ui-ux-master/templates/ui-ux-memory.md`
+
+## Required Behavior
+
+1. Treat the rest of the prompt after `/ui-ux-master` as the user task.
+2. Check for existing UI/UX memory before designing: `.ui-ux-memory.md`, `docs/ui-ux-memory.md`, `docs/design/ui-ux-memory.md`, or `design/ui-ux-memory.md`.
+3. Inspect existing brand, tokens, components, CSS, routes, screenshots, dependencies, and similar screens before proposing UI changes.
+4. Preserve existing design conventions unless the user asks for redesign or rebrand.
+5. Include accessibility, responsive behavior, screen states, error/empty/loading/success states, content design, localization risks, platform conventions, analytics, QA, and developer handoff.
+6. If implementing frontend code, follow existing stack conventions and avoid arbitrary new dependencies.
+7. State whether UI/UX memory was read, created, updated, or unavailable.
+
+## Default Output Shape
+
+When the user does not request a specific format, return:
+
+- Product/user goal
+- Assumptions and evidence confidence
+- UX/IA/flow recommendations
+- Visual and interaction direction
+- Component/state specifications
+- Accessibility and responsive requirements
+- Content/copy recommendations
+- Implementation handoff and acceptance criteria
+- QA checklist and next steps
+
+## Quality Bar
+
+Do not stop at pretty screens. Produce senior-level UI/UX work that is usable, accessible, coherent, implementable, brand-consistent, and measurable.

package/tests/install-smoke.test.mjs

@@ -2,11 +2,12 @@ import assert from 'node:assert/strict';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
-import { execFileSync } from 'node:child_process';
+import { execFileSync, spawnSync } from 'node:child_process';
 import test from 'node:test';
 
 const root = path.resolve(import.meta.dirname, '..');
 const bin = path.join(root, 'bin', 'ui-ux-master.mjs');
+const mcpBin = path.join(root, 'bin', 'ui-ux-master-mcp.mjs');
 const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
 const templates = [
   'agent-templates/claude/commands/ui-ux-master.md',
@@ -22,10 +23,21 @@ function run(args, cwd = root) {
   return execFileSync(process.execPath, [bin, ...args], { cwd, encoding: 'utf8' });
 }
 
-test('package exposes ui-ux-master bin', () => {
+function runMcp(messages) {
+  const input = messages.map(m => JSON.stringify(m)).join('\n') + '\n';
+  const res = spawnSync(process.execPath, [mcpBin], { input, encoding: 'utf8', cwd: root, timeout: 5000 });
+  assert.equal(res.status, 0, res.stderr);
+  return res.stdout.trim().split(/\n+/).map(line => JSON.parse(line));
+}
+
+test('package exposes cli and mcp bins with Rupak Biswas author', () => {
+  assert.equal(pkg.author, 'Rupak Biswas');
   assert.equal(pkg.bin['ui-ux-master'], './bin/ui-ux-master.mjs');
+  assert.equal(pkg.bin['ui-ux-master-mcp'], './bin/ui-ux-master-mcp.mjs');
   assert.ok(fs.existsSync(bin));
+  assert.ok(fs.existsSync(mcpBin));
   assert.ok(fs.readFileSync(bin, 'utf8').startsWith('#!/usr/bin/env node'));
+  assert.ok(fs.readFileSync(mcpBin, 'utf8').startsWith('#!/usr/bin/env node'));
 });
 
 test('agent templates include trigger and avoid local absolute paths', () => {
@@ -38,10 +50,29 @@ test('agent templates include trigger and avoid local absolute paths', () => {
   }
 });
 
+test('discovery assets and system prompts exist', () => {
+  const required = [
+    'llms.txt',
+    'ai-discovery/ui-ux-master.manifest.json',
+    'system-prompts/ui-ux-master-system-add-on.md',
+    'system-prompts/ui-ux-master-compact.md',
+    'system-prompts/ui-ux-master-mcp-add-on.md',
+    'docs/mcp-server.md',
+  ];
+  for (const rel of required) {
+    const text = fs.readFileSync(path.join(root, rel), 'utf8');
+    assert.match(text, /\/ui-ux-master/);
+  }
+  const manifest = JSON.parse(fs.readFileSync(path.join(root, 'ai-discovery/ui-ux-master.manifest.json'), 'utf8'));
+  assert.equal(manifest.author, 'Rupak Biswas');
+  assert.equal(manifest.activation.trigger, '/ui-ux-master');
+  assert.equal(manifest.entrypoints.mcp_server_bin, 'ui-ux-master-mcp');
+});
+
 test('cli help doctor and where work', () => {
-  assert.match(run(['--help']), /ui-ux-master install/);
+  assert.match(run(['--help']), /ui-ux-master-mcp/);
   assert.match(run(['where']).trim(), /UI-UX Skills|ui-ux-master/i);
-  assert.match(run(['doctor', '--dry-run']), /trigger: \/ui-ux-master/);
+  assert.match(run(['doctor', '--dry-run']), /bin\/ui-ux-master-mcp\.mjs|bin\\ui-ux-master-mcp\.mjs/);
 });
 
 test('project install dry-run does not write', () => {
@@ -58,6 +89,9 @@ test('project install writes expected files and is idempotent', () => {
   run(['install', '--project', '--dir', dir]);
   run(['install', '--project', '--dir', dir]);
   assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'SKILL.md')));
+  assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'llms.txt')));
+  assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'ai-discovery', 'ui-ux-master.manifest.json')));
+  assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'system-prompts', 'ui-ux-master-system-add-on.md')));
   assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'references', 'ui-ux-memory-workflow.md')));
   assert.ok(fs.existsSync(path.join(dir, '.ui-ux-master', 'templates', 'ui-ux-memory.md')));
   assert.ok(fs.existsSync(path.join(dir, '.claude', 'commands', 'ui-ux-master.md')));
@@ -69,3 +103,29 @@ test('project install writes expected files and is idempotent', () => {
   assert.match(agents, /\.ui-ux-master\/SKILL\.md/);
   assert.match(agents, /\/ui-ux-master/);
 });
+
+test('mcp server lists tools resources prompts and can return the skill', () => {
+  const responses = runMcp([
+    { jsonrpc: '2.0', id: 1, method: 'initialize', params: {} },
+    { jsonrpc: '2.0', id: 2, method: 'tools/list', params: {} },
+    { jsonrpc: '2.0', id: 3, method: 'resources/list', params: {} },
+    { jsonrpc: '2.0', id: 4, method: 'prompts/list', params: {} },
+    { jsonrpc: '2.0', id: 5, method: 'tools/call', params: { name: 'get_asset', arguments: { name: 'system_prompt' } } },
+  ]);
+  assert.equal(responses[0].result.serverInfo.name, 'ui-ux-master');
+  assert.ok(responses[1].result.tools.some(t => t.name === 'generate_system_prompt'));
+  assert.ok(responses[2].result.resources.some(r => r.uri === 'ui-ux-master://skill'));
+  assert.ok(responses[2].result.resources.some(r => r.uri === 'ui-ux-master://memory-template'));
+  assert.ok(responses[3].result.prompts.some(p => p.name === 'ui-ux-audit'));
+  assert.match(responses[4].result.content[0].text, /Activation Rule/);
+});
+
+test('mcp server handles prompt retrieval and unknown methods correctly', () => {
+  const responses = runMcp([
+    { jsonrpc: '2.0', id: 1, method: 'prompts/get', params: { name: 'ui-ux-design-system', arguments: { scope: 'admin dashboard' } } },
+    { jsonrpc: '2.0', id: 2, method: 'not/a-method', params: {} },
+  ]);
+  assert.match(responses[0].result.messages[0].content.text, /\/ui-ux-master/);
+  assert.match(responses[0].result.messages[0].content.text, /admin dashboard/);
+  assert.equal(responses[1].error.code, -32601);
+});