@argus-design/protocol 2026.4.12

package/dist/index.js

@@ -0,0 +1,309 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ARGUS_DIR: () => ARGUS_DIR,
+  ARGUS_VERSION: () => ARGUS_VERSION,
+  CONTRAST_THRESHOLDS: () => CONTRAST_THRESHOLDS,
+  DEFAULT_CONFIG: () => DEFAULT_CONFIG,
+  DEFAULT_GATEWAY_PORT: () => DEFAULT_GATEWAY_PORT,
+  DEFAULT_MCP_PORT: () => DEFAULT_MCP_PORT,
+  DEFAULT_THRESHOLD: () => DEFAULT_THRESHOLD,
+  GRADE_BOUNDARIES: () => GRADE_BOUNDARIES,
+  MAX_ELEMENTS: () => MAX_ELEMENTS,
+  MAX_TEXT_LENGTH: () => MAX_TEXT_LENGTH,
+  MCP_TOOLS: () => MCP_TOOLS,
+  RULE_CATEGORIES: () => RULE_CATEGORIES,
+  SPACING_SCALE: () => SPACING_SCALE,
+  TOUCH_TARGETS: () => TOUCH_TARGETS,
+  TYPE_SCALE_RATIOS: () => TYPE_SCALE_RATIOS,
+  err: () => err,
+  ok: () => ok,
+  scoreToGrade: () => scoreToGrade
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types.ts
+function ok(value) {
+  return { ok: true, value };
+}
+function err(error) {
+  return { ok: false, error };
+}
+var RULE_CATEGORIES = [
+  "spacing",
+  "typography",
+  "color",
+  "hierarchy",
+  "accessibility",
+  "consistency"
+];
+var MCP_TOOLS = [
+  {
+    name: "design.inspect",
+    description: "Analyze a page or component's visual structure. Returns element positions, computed styles, accessibility data, and structural relationships.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: {
+          type: "string",
+          description: "URL to inspect"
+        },
+        selector: {
+          type: "string",
+          description: "CSS selector to scope inspection"
+        },
+        html: {
+          type: "string",
+          description: "Raw HTML string to inspect"
+        },
+        maxElements: {
+          type: "number",
+          description: "Maximum elements to inspect (default: 500)"
+        }
+      }
+    }
+  },
+  {
+    name: "design.score",
+    description: "Score design quality against established principles. Returns per-rule findings, category scores, and aggregate score (0-100).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        snapshot: {
+          type: "object",
+          description: "PageSnapshot from design.inspect"
+        },
+        categories: {
+          type: "array",
+          items: { type: "string" },
+          description: "Categories to score (default: all). Options: spacing, typography, color, hierarchy, accessibility, consistency"
+        },
+        threshold: {
+          type: "number",
+          description: "Minimum acceptable score (default: 70)"
+        }
+      },
+      required: ["snapshot"]
+    }
+  },
+  {
+    name: "design.suggest",
+    description: "Get specific, actionable improvement suggestions for design issues.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        snapshot: {
+          type: "object",
+          description: "PageSnapshot from design.inspect"
+        },
+        maxSuggestions: {
+          type: "number",
+          description: "Maximum suggestions to return (default: 10)"
+        },
+        focus: {
+          type: "string",
+          description: "Category to focus suggestions on"
+        }
+      },
+      required: ["snapshot"]
+    }
+  },
+  {
+    name: "design.apply",
+    description: "Apply a design fix and verify the improvement with before/after scoring.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        selector: { type: "string", description: "Element to modify" },
+        changes: {
+          type: "array",
+          description: "CSS property changes",
+          items: {
+            type: "object",
+            properties: {
+              property: { type: "string" },
+              value: { type: "string" }
+            }
+          }
+        },
+        verify: {
+          type: "boolean",
+          description: "Re-score after applying (default: true)"
+        }
+      },
+      required: ["selector", "changes"]
+    }
+  },
+  {
+    name: "design.compare",
+    description: "Compare two page states. Shows score deltas, structural changes, regressions, and fixes.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        before: { type: "object", description: "PageSnapshot of before state" },
+        after: { type: "object", description: "PageSnapshot of after state" }
+      },
+      required: ["before", "after"]
+    }
+  },
+  {
+    name: "design.preferences",
+    description: "Read or export the user's design taste profile for system prompt injection.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        action: {
+          type: "string",
+          enum: ["read", "export"],
+          description: "Read profile or export as structured format"
+        },
+        format: {
+          type: "string",
+          enum: ["xml", "json"],
+          description: "Export format (default: xml)"
+        }
+      },
+      required: ["action"]
+    }
+  },
+  {
+    name: "design.audit",
+    description: "Run comprehensive design quality + accessibility audit with prioritized fix list.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "URL to audit" },
+        selector: { type: "string", description: "Scope to specific section" },
+        wcag: {
+          type: "string",
+          enum: ["AA", "AAA"],
+          description: "WCAG conformance level (default: AA)"
+        }
+      }
+    }
+  },
+  {
+    name: "design.doctor",
+    description: "Check Argus installation health, configuration, and version info.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  }
+];
+var ARGUS_VERSION = "2026.4.12";
+var ARGUS_DIR = ".argus";
+var DEFAULT_MCP_PORT = 18790;
+var DEFAULT_GATEWAY_PORT = 18791;
+var MAX_ELEMENTS = 1e3;
+var MAX_TEXT_LENGTH = 200;
+var DEFAULT_THRESHOLD = 70;
+var SPACING_SCALE = [0, 2, 4, 8, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128];
+var TYPE_SCALE_RATIOS = {
+  minorSecond: 1.067,
+  majorSecond: 1.125,
+  minorThird: 1.2,
+  majorThird: 1.25,
+  perfectFourth: 1.333,
+  augmentedFourth: 1.414,
+  perfectFifth: 1.5,
+  goldenRatio: 1.618
+};
+var CONTRAST_THRESHOLDS = {
+  AALargeText: 3,
+  AANormalText: 4.5,
+  AAALargeText: 4.5,
+  AAANormalText: 7
+};
+var TOUCH_TARGETS = {
+  minimum: 24,
+  recommended: 44,
+  comfortable: 48
+};
+var GRADE_BOUNDARIES = {
+  "A+": 95,
+  A: 90,
+  "B+": 85,
+  B: 75,
+  "C+": 65,
+  C: 55,
+  D: 40,
+  F: 0
+};
+function scoreToGrade(score) {
+  if (score >= GRADE_BOUNDARIES["A+"]) return "A+";
+  if (score >= GRADE_BOUNDARIES.A) return "A";
+  if (score >= GRADE_BOUNDARIES["B+"]) return "B+";
+  if (score >= GRADE_BOUNDARIES.B) return "B";
+  if (score >= GRADE_BOUNDARIES["C+"]) return "C+";
+  if (score >= GRADE_BOUNDARIES.C) return "C";
+  if (score >= GRADE_BOUNDARIES.D) return "D";
+  return "F";
+}
+var DEFAULT_CONFIG = {
+  version: 1,
+  mcp: {
+    port: DEFAULT_MCP_PORT,
+    bind: "loopback",
+    auth: { mode: "none" }
+  },
+  gateway: {
+    port: DEFAULT_GATEWAY_PORT,
+    bind: "loopback"
+  },
+  scoring: {
+    threshold: DEFAULT_THRESHOLD,
+    enabledCategories: [...RULE_CATEGORIES],
+    customRulePaths: []
+  },
+  memory: {
+    profileName: "default",
+    historyEnabled: false,
+    maxHistoryDays: 90
+  },
+  inspector: {
+    maxElements: MAX_ELEMENTS,
+    includeHidden: false,
+    includeCustomProperties: true
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ARGUS_DIR,
+  ARGUS_VERSION,
+  CONTRAST_THRESHOLDS,
+  DEFAULT_CONFIG,
+  DEFAULT_GATEWAY_PORT,
+  DEFAULT_MCP_PORT,
+  DEFAULT_THRESHOLD,
+  GRADE_BOUNDARIES,
+  MAX_ELEMENTS,
+  MAX_TEXT_LENGTH,
+  MCP_TOOLS,
+  RULE_CATEGORIES,
+  SPACING_SCALE,
+  TOUCH_TARGETS,
+  TYPE_SCALE_RATIOS,
+  err,
+  ok,
+  scoreToGrade
+});

package/dist/index.mjs

@@ -0,0 +1,265 @@
+// src/types.ts
+function ok(value) {
+  return { ok: true, value };
+}
+function err(error) {
+  return { ok: false, error };
+}
+var RULE_CATEGORIES = [
+  "spacing",
+  "typography",
+  "color",
+  "hierarchy",
+  "accessibility",
+  "consistency"
+];
+var MCP_TOOLS = [
+  {
+    name: "design.inspect",
+    description: "Analyze a page or component's visual structure. Returns element positions, computed styles, accessibility data, and structural relationships.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: {
+          type: "string",
+          description: "URL to inspect"
+        },
+        selector: {
+          type: "string",
+          description: "CSS selector to scope inspection"
+        },
+        html: {
+          type: "string",
+          description: "Raw HTML string to inspect"
+        },
+        maxElements: {
+          type: "number",
+          description: "Maximum elements to inspect (default: 500)"
+        }
+      }
+    }
+  },
+  {
+    name: "design.score",
+    description: "Score design quality against established principles. Returns per-rule findings, category scores, and aggregate score (0-100).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        snapshot: {
+          type: "object",
+          description: "PageSnapshot from design.inspect"
+        },
+        categories: {
+          type: "array",
+          items: { type: "string" },
+          description: "Categories to score (default: all). Options: spacing, typography, color, hierarchy, accessibility, consistency"
+        },
+        threshold: {
+          type: "number",
+          description: "Minimum acceptable score (default: 70)"
+        }
+      },
+      required: ["snapshot"]
+    }
+  },
+  {
+    name: "design.suggest",
+    description: "Get specific, actionable improvement suggestions for design issues.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        snapshot: {
+          type: "object",
+          description: "PageSnapshot from design.inspect"
+        },
+        maxSuggestions: {
+          type: "number",
+          description: "Maximum suggestions to return (default: 10)"
+        },
+        focus: {
+          type: "string",
+          description: "Category to focus suggestions on"
+        }
+      },
+      required: ["snapshot"]
+    }
+  },
+  {
+    name: "design.apply",
+    description: "Apply a design fix and verify the improvement with before/after scoring.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        selector: { type: "string", description: "Element to modify" },
+        changes: {
+          type: "array",
+          description: "CSS property changes",
+          items: {
+            type: "object",
+            properties: {
+              property: { type: "string" },
+              value: { type: "string" }
+            }
+          }
+        },
+        verify: {
+          type: "boolean",
+          description: "Re-score after applying (default: true)"
+        }
+      },
+      required: ["selector", "changes"]
+    }
+  },
+  {
+    name: "design.compare",
+    description: "Compare two page states. Shows score deltas, structural changes, regressions, and fixes.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        before: { type: "object", description: "PageSnapshot of before state" },
+        after: { type: "object", description: "PageSnapshot of after state" }
+      },
+      required: ["before", "after"]
+    }
+  },
+  {
+    name: "design.preferences",
+    description: "Read or export the user's design taste profile for system prompt injection.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        action: {
+          type: "string",
+          enum: ["read", "export"],
+          description: "Read profile or export as structured format"
+        },
+        format: {
+          type: "string",
+          enum: ["xml", "json"],
+          description: "Export format (default: xml)"
+        }
+      },
+      required: ["action"]
+    }
+  },
+  {
+    name: "design.audit",
+    description: "Run comprehensive design quality + accessibility audit with prioritized fix list.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "URL to audit" },
+        selector: { type: "string", description: "Scope to specific section" },
+        wcag: {
+          type: "string",
+          enum: ["AA", "AAA"],
+          description: "WCAG conformance level (default: AA)"
+        }
+      }
+    }
+  },
+  {
+    name: "design.doctor",
+    description: "Check Argus installation health, configuration, and version info.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  }
+];
+var ARGUS_VERSION = "2026.4.12";
+var ARGUS_DIR = ".argus";
+var DEFAULT_MCP_PORT = 18790;
+var DEFAULT_GATEWAY_PORT = 18791;
+var MAX_ELEMENTS = 1e3;
+var MAX_TEXT_LENGTH = 200;
+var DEFAULT_THRESHOLD = 70;
+var SPACING_SCALE = [0, 2, 4, 8, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128];
+var TYPE_SCALE_RATIOS = {
+  minorSecond: 1.067,
+  majorSecond: 1.125,
+  minorThird: 1.2,
+  majorThird: 1.25,
+  perfectFourth: 1.333,
+  augmentedFourth: 1.414,
+  perfectFifth: 1.5,
+  goldenRatio: 1.618
+};
+var CONTRAST_THRESHOLDS = {
+  AALargeText: 3,
+  AANormalText: 4.5,
+  AAALargeText: 4.5,
+  AAANormalText: 7
+};
+var TOUCH_TARGETS = {
+  minimum: 24,
+  recommended: 44,
+  comfortable: 48
+};
+var GRADE_BOUNDARIES = {
+  "A+": 95,
+  A: 90,
+  "B+": 85,
+  B: 75,
+  "C+": 65,
+  C: 55,
+  D: 40,
+  F: 0
+};
+function scoreToGrade(score) {
+  if (score >= GRADE_BOUNDARIES["A+"]) return "A+";
+  if (score >= GRADE_BOUNDARIES.A) return "A";
+  if (score >= GRADE_BOUNDARIES["B+"]) return "B+";
+  if (score >= GRADE_BOUNDARIES.B) return "B";
+  if (score >= GRADE_BOUNDARIES["C+"]) return "C+";
+  if (score >= GRADE_BOUNDARIES.C) return "C";
+  if (score >= GRADE_BOUNDARIES.D) return "D";
+  return "F";
+}
+var DEFAULT_CONFIG = {
+  version: 1,
+  mcp: {
+    port: DEFAULT_MCP_PORT,
+    bind: "loopback",
+    auth: { mode: "none" }
+  },
+  gateway: {
+    port: DEFAULT_GATEWAY_PORT,
+    bind: "loopback"
+  },
+  scoring: {
+    threshold: DEFAULT_THRESHOLD,
+    enabledCategories: [...RULE_CATEGORIES],
+    customRulePaths: []
+  },
+  memory: {
+    profileName: "default",
+    historyEnabled: false,
+    maxHistoryDays: 90
+  },
+  inspector: {
+    maxElements: MAX_ELEMENTS,
+    includeHidden: false,
+    includeCustomProperties: true
+  }
+};
+export {
+  ARGUS_DIR,
+  ARGUS_VERSION,
+  CONTRAST_THRESHOLDS,
+  DEFAULT_CONFIG,
+  DEFAULT_GATEWAY_PORT,
+  DEFAULT_MCP_PORT,
+  DEFAULT_THRESHOLD,
+  GRADE_BOUNDARIES,
+  MAX_ELEMENTS,
+  MAX_TEXT_LENGTH,
+  MCP_TOOLS,
+  RULE_CATEGORIES,
+  SPACING_SCALE,
+  TOUCH_TARGETS,
+  TYPE_SCALE_RATIOS,
+  err,
+  ok,
+  scoreToGrade
+};

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@argus-design/protocol",
+  "version": "2026.4.12",
+  "description": "Shared types, interfaces, and constants for the Argus design intelligence runtime",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "license": "MIT",
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0"
+  }
+}