@qlucent/fishi-core 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -643,10 +643,72 @@ declare function startDevServer(projectDir: string, config: DevServerConfig): Ch
  */
 declare function getVibeModeConfig(enabled: boolean): string;
 
+interface DesignTokens {
+    colors: Record<string, string>;
+    typography: {
+        fontFamilies: string[];
+        scale: Record<string, string>;
+    };
+    spacing: Record<string, string>;
+    borderRadius: Record<string, string>;
+    shadows: Record<string, string>;
+    darkMode: boolean;
+}
+interface ComponentEntry {
+    name: string;
+    path: string;
+    type: 'ui' | 'layout' | 'form' | 'data' | 'navigation' | 'other';
+}
+interface ComponentRegistry {
+    components: ComponentEntry[];
+    library: string | null;
+    framework: string | null;
+}
+interface BrandGuardianIssue {
+    file: string;
+    line: number;
+    severity: 'error' | 'warning' | 'info';
+    rule: string;
+    message: string;
+    fix?: string;
+}
+interface BrandGuardianReport {
+    issues: BrandGuardianIssue[];
+    passed: boolean;
+    stats: {
+        errors: number;
+        warnings: number;
+        infos: number;
+        filesScanned: number;
+    };
+}
+/**
+ * Detect design tokens from a project's config files.
+ * Checks: tailwind.config, CSS custom properties, theme files.
+ */
+declare function detectDesignTokens(projectDir: string): DesignTokens;
+/**
+ * Generate default design tokens for a new project.
+ */
+declare function generateDefaultTokens(): DesignTokens;
+/**
+ * Detect component library and registry from a project.
+ */
+declare function detectComponentRegistry(projectDir: string): ComponentRegistry;
+/**
+ * Run Brand Guardian validation on project files.
+ * Checks for hardcoded colors, inconsistent spacing, missing a11y, etc.
+ */
+declare function runBrandGuardian(projectDir: string, tokens: DesignTokens): BrandGuardianReport;
+/**
+ * Generate a design system config file for the project.
+ */
+declare function generateDesignSystemConfig(tokens: DesignTokens, registry: ComponentRegistry): string;
+
 declare function getSandboxPolicyTemplate(): string;
 
 declare function getDockerfileTemplate(): string;
 
 declare function getDashboardHtml(): string;
 
-export { type AgentDefinition, type AgentRole, type AgentTemplate, type BackupManifest, type BrownfieldAnalysisData, type ClaudeMdOptions, type CommandTemplate, type ConflictCategory, type ConflictMap, type ConflictResolution, type CostMode, type DetectionCheck, type DetectionResult, type DevServerConfig, type DynamicAgent, type DynamicAgentConfig, type ExecutionConfig, type FileConflict, type FileResolutionMap, type FishiConfig, type FishiYamlOptions, type GateConfig, type GateStatus, type GitConfig, type HookTemplate, type InitOptions, type McpConfig, type McpServerConfig, type ModelRoutingConfig, type ModelTier, type MonitorEvent, type MonitorState, type MonitorSummary, type ProjectConfig, type ProjectType, type ProjectYamlOptions, type SandboxConfig, type SandboxMode, type SandboxPolicy, type SandboxRunResult, type ScaffoldOptions, type ScaffoldResult, type SkillTemplate, type StateConfig, type TaskStatus, type TaskboardConfig, type TemplateContext, architectAgentTemplate, backendAgentTemplate, buildSandboxEnv, createBackup, detectConflicts, detectDevServer, detectDocker, devLeadTemplate, devopsAgentTemplate, docsAgentTemplate, emitEvent, frontendAgentTemplate, fullstackAgentTemplate, generateScaffold, getAdaptiveTaskGraphSkill, getAgentCompleteHook, getAgentFactoryTemplate, getAgentRegistryTemplate, getAgentSummary, getApiDesignSkill, getAutoCheckpointHook, getBoardCommand, getBrainstormingSkill, getBrownfieldAnalysisSkill, getBrownfieldDiscoverySkill, getClaudeMdTemplate, getCodeGenSkill, getCoordinatorFactoryTemplate, getDashboardHtml, getDebuggingSkill, getDeploymentSkill, getDocCheckerScript, getDockerfileTemplate, getDocumentationSkill, getFishiYamlTemplate, getGateCommand, getGateManagerScript, getGitignoreAdditions, getInitCommand, getLearningsManagerScript, getMasterOrchestratorTemplate, getMcpJsonTemplate, getMemoryManagerScript, getModelRoutingReference, getMonitorEmitterScript, getPhaseRunnerScript, getPostEditHook, getPrdCommand, getPrdSkill, getProjectYamlTemplate, getResetCommand, getResumeCommand, getSafetyCheckHook, getSandboxPolicyTemplate, getSessionStartHook, getSettingsJsonTemplate, getSprintCommand, getStatusCommand, getTaskboardOpsSkill, getTaskboardUpdateHook, getTestingSkill, getTodoManagerScript, getValidateScaffoldScript, getVibeModeConfig, getWorktreeManagerScript, getWorktreeSetupHook, marketingAgentTemplate, mergeClaudeMd, mergeClaudeMdTop, mergeGitignore, mergeMcpJson, mergeSettingsJson, opsLeadTemplate, planningAgentTemplate, planningLeadTemplate, qualityLeadTemplate, readMonitorState, readSandboxConfig, readSandboxPolicy, researchAgentTemplate, runInDockerSandbox, runInProcessSandbox, runInSandbox, securityAgentTemplate, startDevServer, testingAgentTemplate, uiuxAgentTemplate, writingAgentTemplate };
+export { type AgentDefinition, type AgentRole, type AgentTemplate, type BackupManifest, type BrandGuardianIssue, type BrandGuardianReport, type BrownfieldAnalysisData, type ClaudeMdOptions, type CommandTemplate, type ComponentEntry, type ComponentRegistry, type ConflictCategory, type ConflictMap, type ConflictResolution, type CostMode, type DesignTokens, type DetectionCheck, type DetectionResult, type DevServerConfig, type DynamicAgent, type DynamicAgentConfig, type ExecutionConfig, type FileConflict, type FileResolutionMap, type FishiConfig, type FishiYamlOptions, type GateConfig, type GateStatus, type GitConfig, type HookTemplate, type InitOptions, type McpConfig, type McpServerConfig, type ModelRoutingConfig, type ModelTier, type MonitorEvent, type MonitorState, type MonitorSummary, type ProjectConfig, type ProjectType, type ProjectYamlOptions, type SandboxConfig, type SandboxMode, type SandboxPolicy, type SandboxRunResult, type ScaffoldOptions, type ScaffoldResult, type SkillTemplate, type StateConfig, type TaskStatus, type TaskboardConfig, type TemplateContext, architectAgentTemplate, backendAgentTemplate, buildSandboxEnv, createBackup, detectComponentRegistry, detectConflicts, detectDesignTokens, detectDevServer, detectDocker, devLeadTemplate, devopsAgentTemplate, docsAgentTemplate, emitEvent, frontendAgentTemplate, fullstackAgentTemplate, generateDefaultTokens, generateDesignSystemConfig, generateScaffold, getAdaptiveTaskGraphSkill, getAgentCompleteHook, getAgentFactoryTemplate, getAgentRegistryTemplate, getAgentSummary, getApiDesignSkill, getAutoCheckpointHook, getBoardCommand, getBrainstormingSkill, getBrownfieldAnalysisSkill, getBrownfieldDiscoverySkill, getClaudeMdTemplate, getCodeGenSkill, getCoordinatorFactoryTemplate, getDashboardHtml, getDebuggingSkill, getDeploymentSkill, getDocCheckerScript, getDockerfileTemplate, getDocumentationSkill, getFishiYamlTemplate, getGateCommand, getGateManagerScript, getGitignoreAdditions, getInitCommand, getLearningsManagerScript, getMasterOrchestratorTemplate, getMcpJsonTemplate, getMemoryManagerScript, getModelRoutingReference, getMonitorEmitterScript, getPhaseRunnerScript, getPostEditHook, getPrdCommand, getPrdSkill, getProjectYamlTemplate, getResetCommand, getResumeCommand, getSafetyCheckHook, getSandboxPolicyTemplate, getSessionStartHook, getSettingsJsonTemplate, getSprintCommand, getStatusCommand, getTaskboardOpsSkill, getTaskboardUpdateHook, getTestingSkill, getTodoManagerScript, getValidateScaffoldScript, getVibeModeConfig, getWorktreeManagerScript, getWorktreeSetupHook, marketingAgentTemplate, mergeClaudeMd, mergeClaudeMdTop, mergeGitignore, mergeMcpJson, mergeSettingsJson, opsLeadTemplate, planningAgentTemplate, planningLeadTemplate, qualityLeadTemplate, readMonitorState, readSandboxConfig, readSandboxPolicy, researchAgentTemplate, runBrandGuardian, runInDockerSandbox, runInProcessSandbox, runInSandbox, securityAgentTemplate, startDevServer, testingAgentTemplate, uiuxAgentTemplate, writingAgentTemplate };

package/dist/index.js

@@ -11111,7 +11111,7 @@ async function createBackup(targetDir, conflictingFiles) {
       manifestFiles.push({ path: relPath, size: stat.size });
     }
   }
-  const fishiVersion = "0.8.0";
+  const fishiVersion = "0.9.0";
   const manifest = {
     timestamp: now.toISOString(),
     fishi_version: fishiVersion,
@@ -11466,6 +11466,320 @@ vibe_mode:
 `;
 }
 
+// src/generators/design-system.ts
+import { existsSync as existsSync7, readFileSync as readFileSync4, readdirSync } from "fs";
+import { join as join7 } from "path";
+function detectDesignTokens(projectDir) {
+  const tokens = {
+    colors: {},
+    typography: { fontFamilies: [], scale: {} },
+    spacing: {},
+    borderRadius: {},
+    shadows: {},
+    darkMode: false
+  };
+  const tailwindFiles = ["tailwind.config.js", "tailwind.config.ts", "tailwind.config.mjs", "tailwind.config.cjs"];
+  for (const file of tailwindFiles) {
+    const p = join7(projectDir, file);
+    if (existsSync7(p)) {
+      const content = readFileSync4(p, "utf-8");
+      const colorMatches = content.matchAll(/['"]?([\w-]+)['"]?\s*:\s*['"]?(#[0-9a-fA-F]{3,8})['"]?/g);
+      for (const m of colorMatches) {
+        tokens.colors[m[1]] = m[2];
+      }
+      if (content.includes("darkMode")) tokens.darkMode = true;
+      break;
+    }
+  }
+  const cssFiles = findFiles(projectDir, ["src", "styles", "app"], [".css"]);
+  for (const file of cssFiles.slice(0, 10)) {
+    try {
+      const content = readFileSync4(file, "utf-8");
+      const varMatches = content.matchAll(/--(\w[\w-]*)\s*:\s*([^;]+)/g);
+      for (const m of varMatches) {
+        const name = m[1];
+        const value = m[2].trim();
+        if (name.includes("color") || name.includes("bg") || value.startsWith("#") || value.startsWith("rgb") || value.startsWith("hsl")) {
+          tokens.colors[name] = value;
+        } else if (name.includes("font")) {
+          if (name.includes("size")) tokens.typography.scale[name] = value;
+          else if (name.includes("family")) tokens.typography.fontFamilies.push(value);
+        } else if (name.includes("spacing") || name.includes("gap") || name.includes("padding") || name.includes("margin")) {
+          tokens.spacing[name] = value;
+        } else if (name.includes("radius")) {
+          tokens.borderRadius[name] = value;
+        } else if (name.includes("shadow")) {
+          tokens.shadows[name] = value;
+        }
+      }
+      if (content.includes("prefers-color-scheme: dark") || content.includes(".dark")) {
+        tokens.darkMode = true;
+      }
+    } catch {
+    }
+  }
+  const themeFiles = ["theme.ts", "theme.js", "theme.json", "src/theme.ts", "src/theme.js", "src/styles/theme.ts"];
+  for (const file of themeFiles) {
+    if (existsSync7(join7(projectDir, file))) {
+      try {
+        const content = readFileSync4(join7(projectDir, file), "utf-8");
+        const colorMatches = content.matchAll(/['"]?([\w-]+)['"]?\s*:\s*['"]?(#[0-9a-fA-F]{3,8})['"]?/g);
+        for (const m of colorMatches) {
+          tokens.colors[m[1]] = m[2];
+        }
+      } catch {
+      }
+      break;
+    }
+  }
+  return tokens;
+}
+function generateDefaultTokens() {
+  return {
+    colors: {
+      "brand-50": "#f0f7ff",
+      "brand-100": "#e0efff",
+      "brand-200": "#b8d9ff",
+      "brand-500": "#0066cc",
+      "brand-600": "#0052a3",
+      "brand-700": "#003d7a",
+      "brand-900": "#001f3f",
+      "gray-50": "#f9fafb",
+      "gray-100": "#f3f4f6",
+      "gray-200": "#e5e7eb",
+      "gray-500": "#6b7280",
+      "gray-700": "#374151",
+      "gray-900": "#111827",
+      "success": "#22c55e",
+      "warning": "#f59e0b",
+      "error": "#ef4444"
+    },
+    typography: {
+      fontFamilies: ['-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif'],
+      scale: {
+        "xs": "0.75rem",
+        "sm": "0.875rem",
+        "base": "1rem",
+        "lg": "1.125rem",
+        "xl": "1.25rem",
+        "2xl": "1.5rem",
+        "3xl": "1.875rem",
+        "4xl": "2.25rem"
+      }
+    },
+    spacing: {
+      "xs": "0.25rem",
+      "sm": "0.5rem",
+      "md": "1rem",
+      "lg": "1.5rem",
+      "xl": "2rem",
+      "2xl": "3rem",
+      "3xl": "4rem"
+    },
+    borderRadius: {
+      "sm": "0.25rem",
+      "md": "0.375rem",
+      "lg": "0.5rem",
+      "xl": "0.75rem",
+      "full": "9999px"
+    },
+    shadows: {
+      "sm": "0 1px 2px rgba(0,0,0,0.05)",
+      "md": "0 4px 6px rgba(0,0,0,0.1)",
+      "lg": "0 10px 15px rgba(0,0,0,0.1)"
+    },
+    darkMode: true
+  };
+}
+function detectComponentRegistry(projectDir) {
+  const registry = {
+    components: [],
+    library: null,
+    framework: null
+  };
+  const pkgPath = join7(projectDir, "package.json");
+  if (existsSync7(pkgPath)) {
+    const pkg = JSON.parse(readFileSync4(pkgPath, "utf-8"));
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    if (deps["@shadcn/ui"] || existsSync7(join7(projectDir, "components.json"))) registry.library = "shadcn";
+    else if (deps["@radix-ui/react-dialog"] || deps["@radix-ui/themes"]) registry.library = "radix";
+    else if (deps["@mui/material"]) registry.library = "mui";
+    else if (deps["antd"]) registry.library = "antd";
+    else if (deps["@chakra-ui/react"]) registry.library = "chakra";
+    else if (deps["@headlessui/react"]) registry.library = "headlessui";
+    if (deps["react"] || deps["react-dom"]) registry.framework = "react";
+    else if (deps["vue"]) registry.framework = "vue";
+    else if (deps["svelte"]) registry.framework = "svelte";
+    else if (deps["@angular/core"]) registry.framework = "angular";
+  }
+  const componentDirs = ["src/components", "components", "src/ui", "app/components", "src/components/ui"];
+  for (const dir of componentDirs) {
+    const fullDir = join7(projectDir, dir);
+    if (existsSync7(fullDir)) {
+      try {
+        scanComponents(fullDir, dir, registry.components);
+      } catch {
+      }
+    }
+  }
+  return registry;
+}
+function scanComponents(dir, relBase, components) {
+  try {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        scanComponents(join7(dir, entry.name), `${relBase}/${entry.name}`, components);
+      } else if (entry.name.match(/\.(tsx|jsx|vue|svelte)$/)) {
+        const name = entry.name.replace(/\.(tsx|jsx|vue|svelte)$/, "");
+        if (name === "index") continue;
+        const type = classifyComponent(name);
+        components.push({ name, path: `${relBase}/${entry.name}`, type });
+      }
+    }
+  } catch {
+  }
+}
+function classifyComponent(name) {
+  const lower = name.toLowerCase();
+  if (/button|badge|avatar|icon|tag|chip|tooltip/i.test(lower)) return "ui";
+  if (/layout|header|footer|sidebar|menu/i.test(lower)) return "layout";
+  if (/input|form|select|checkbox|radio|textarea|switch|slider/i.test(lower)) return "form";
+  if (/table|list|card|grid|chart|graph|stat/i.test(lower)) return "data";
+  if (/link|breadcrumb|tab|pagination|stepper|nav|navbar/i.test(lower)) return "navigation";
+  return "other";
+}
+function runBrandGuardian(projectDir, tokens) {
+  const issues = [];
+  let filesScanned = 0;
+  const files = findFiles(projectDir, ["src", "app", "pages", "components"], [".tsx", ".jsx", ".vue", ".svelte", ".css"]);
+  for (const file of files.slice(0, 100)) {
+    try {
+      const content = readFileSync4(file, "utf-8");
+      const lines = content.split("\n");
+      const relPath = file.replace(projectDir, "").replace(/\\/g, "/").replace(/^\//, "");
+      filesScanned++;
+      for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNum = i + 1;
+        if (file.match(/\.(tsx|jsx|vue|svelte)$/)) {
+          const hexMatches = line.matchAll(/#[0-9a-fA-F]{3,8}\b/g);
+          for (const m of hexMatches) {
+            if (line.trimStart().startsWith("//") || line.trimStart().startsWith("*")) continue;
+            if (line.includes("--")) continue;
+            issues.push({
+              file: relPath,
+              line: lineNum,
+              severity: "warning",
+              rule: "no-hardcoded-colors",
+              message: `Hardcoded color ${m[0]} \u2014 use design tokens instead`,
+              fix: "Replace with a CSS variable or Tailwind class from your design system"
+            });
+          }
+        }
+        if (line.includes("style=") && line.match(/\d+px/)) {
+          issues.push({
+            file: relPath,
+            line: lineNum,
+            severity: "warning",
+            rule: "no-inline-px",
+            message: "Inline px values \u2014 use spacing tokens or Tailwind classes",
+            fix: "Replace px values with spacing scale (xs, sm, md, lg, xl)"
+          });
+        }
+        if (line.match(/<img\b/) && !line.includes("alt=") && !line.includes("alt =")) {
+          issues.push({
+            file: relPath,
+            line: lineNum,
+            severity: "error",
+            rule: "img-alt-text",
+            message: "Image missing alt attribute \u2014 accessibility violation",
+            fix: 'Add alt="descriptive text" or alt="" for decorative images'
+          });
+        }
+        if (line.includes("onClick") && !line.includes("onKeyDown") && !line.includes("onKeyUp") && !line.includes("onKeyPress")) {
+          if (line.includes("<div") || line.includes("<span")) {
+            issues.push({
+              file: relPath,
+              line: lineNum,
+              severity: "warning",
+              rule: "keyboard-accessible",
+              message: "Click handler on non-interactive element without keyboard support",
+              fix: 'Add onKeyDown handler and role="button" tabIndex={0}, or use <button>'
+            });
+          }
+        }
+        if (line.match(/font-size:\s*\d+px/) && !line.includes("--")) {
+          issues.push({
+            file: relPath,
+            line: lineNum,
+            severity: "info",
+            rule: "use-typography-scale",
+            message: "Hardcoded font-size \u2014 use typography scale tokens",
+            fix: "Replace with typography scale class (text-xs, text-sm, text-base, etc.)"
+          });
+        }
+        if (line.match(/<html\b/) && !line.includes("lang=")) {
+          issues.push({
+            file: relPath,
+            line: lineNum,
+            severity: "error",
+            rule: "html-lang",
+            message: "HTML element missing lang attribute \u2014 accessibility violation",
+            fix: 'Add lang="en" (or appropriate language code) to <html>'
+          });
+        }
+      }
+    } catch {
+    }
+  }
+  const errors = issues.filter((i) => i.severity === "error").length;
+  const warnings = issues.filter((i) => i.severity === "warning").length;
+  const infos = issues.filter((i) => i.severity === "info").length;
+  return {
+    issues,
+    passed: errors === 0,
+    stats: { errors, warnings, infos, filesScanned }
+  };
+}
+function generateDesignSystemConfig(tokens, registry) {
+  return JSON.stringify({
+    version: "1.0",
+    tokens,
+    components: {
+      library: registry.library,
+      framework: registry.framework,
+      count: registry.components.length,
+      entries: registry.components
+    }
+  }, null, 2) + "\n";
+}
+function findFiles(base, dirs, extensions) {
+  const files = [];
+  for (const dir of dirs) {
+    const fullDir = join7(base, dir);
+    if (existsSync7(fullDir)) {
+      walkDir(fullDir, extensions, files);
+    }
+  }
+  return files;
+}
+function walkDir(dir, extensions, result) {
+  try {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const full = join7(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (entry.name === "node_modules" || entry.name === ".next" || entry.name === "dist" || entry.name === ".git") continue;
+        walkDir(full, extensions, result);
+      } else if (extensions.some((ext) => entry.name.endsWith(ext))) {
+        result.push(full);
+      }
+    }
+  } catch {
+  }
+}
+
 // src/templates/configs/sandbox-policy.ts
 function getSandboxPolicyTemplate() {
   return `# FISHI Sandbox Policy
@@ -11862,7 +12176,9 @@ export {
   backendAgentTemplate,
   buildSandboxEnv,
   createBackup,
+  detectComponentRegistry,
   detectConflicts,
+  detectDesignTokens,
   detectDevServer,
   detectDocker,
   devLeadTemplate,
@@ -11871,6 +12187,8 @@ export {
   emitEvent,
   frontendAgentTemplate,
   fullstackAgentTemplate,
+  generateDefaultTokens,
+  generateDesignSystemConfig,
   generateScaffold,
   getAdaptiveTaskGraphSkill,
   getAgentCompleteHook,
@@ -11938,6 +12256,7 @@ export {
   readSandboxConfig,
   readSandboxPolicy,
   researchAgentTemplate,
+  runBrandGuardian,
   runInDockerSandbox,
   runInProcessSandbox,
   runInSandbox,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qlucent/fishi-core",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Shared templates, types, and generators for the FISHI framework",
   "license": "MIT",
   "type": "module",