aub-workspace 0.3.0

package/vendor/aub/schema/ui-project.schema.json

@@ -0,0 +1,139 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/HenryLau1103/AUB/schema/0.1.0/ui-project.schema.json",
+  "title": "UI Blueprint Project",
+  "description": "A reference-based multi-screen project. Lists member single-screen Blueprint files by relative path, declares a navigation graph between them, names an entry screen, and optionally carries a project-level shared design system. Member .ui.json files remain fully valid standalone Blueprints.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "id",
+    "name",
+    "screens",
+    "entry_screen"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Optional path or URL to this JSON Schema. Lets editors provide validation and autocomplete for standalone .aub.project.json files. Ignored by AUB tooling."
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version of the project schema this document conforms to.",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "enum": ["0.1.0"],
+      "examples": ["0.1.0"]
+    },
+    "id": {
+      "type": "string",
+      "description": "Unique project identifier (kebab or dot notation, e.g. 'acme-app').",
+      "pattern": "^[a-z0-9][a-z0-9._-]*$",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable project name shown in editors and exports.",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "description": {
+      "type": "string",
+      "description": "Optional one-paragraph summary of the product or flow this project describes.",
+      "maxLength": 1024
+    },
+    "screens": {
+      "type": "array",
+      "description": "Member screens. Each references a single-screen Blueprint file by relative path. At least one required.",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/screenRef" }
+    },
+    "entry_screen": {
+      "type": "string",
+      "description": "Screen id (from screens[].id) where the flow starts. MUST match one of the declared screens.",
+      "pattern": "^[a-z0-9][a-z0-9._-]*$",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "navigation": {
+      "type": "array",
+      "description": "Directed navigation edges between screens. from/to MUST reference declared screen ids.",
+      "items": { "$ref": "#/$defs/navigationEdge" }
+    },
+    "design_system": {
+      "type": "object",
+      "description": "Optional project-level shared design tokens. Member screens may override these in their own design_system. Free-form object mirroring a Blueprint design_system; not validated field-for-field here.",
+      "additionalProperties": true
+    },
+    "provenance": {
+      "type": "object",
+      "description": "Optional metadata about how this project document was produced.",
+      "additionalProperties": true
+    }
+  },
+  "$defs": {
+    "screenRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Screen identifier. MUST match the referenced Blueprint's screen.id.",
+          "pattern": "^[a-z0-9][a-z0-9._-]*$",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "name": {
+          "type": "string",
+          "description": "Optional display name. Defaults to the referenced Blueprint's screen.name.",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "path": {
+          "type": "string",
+          "description": "Relative path (from the project file) to a single-screen .ui.json or .ui.yaml Blueprint.",
+          "minLength": 1,
+          "maxLength": 1024
+        }
+      }
+    },
+    "navigationEdge": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["from", "to"],
+      "properties": {
+        "from": {
+          "type": "string",
+          "description": "Source screen id (must be a declared screen).",
+          "pattern": "^[a-z0-9][a-z0-9._-]*$",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "to": {
+          "type": "string",
+          "description": "Destination screen id (must be a declared screen).",
+          "pattern": "^[a-z0-9][a-z0-9._-]*$",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "trigger": {
+          "type": "string",
+          "description": "What causes the navigation.",
+          "enum": ["click", "submit", "change", "load", "system", "gesture"]
+        },
+        "interaction_id": {
+          "type": "string",
+          "description": "Optional id of the interaction on the source screen that triggers this navigation.",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "label": {
+          "type": "string",
+          "description": "Optional human-readable label for the edge (e.g. 'Open settings').",
+          "maxLength": 280
+        }
+      }
+    }
+  }
+}

package/vendor/aub/scripts/agent-implementation-benchmark.lib.mjs

@@ -0,0 +1,125 @@
+import { verifyImplementationReport } from './implementation-report.lib.mjs';
+
+const STYLE_KEYS = [
+  'position',
+  'marginTop',
+  'marginRight',
+  'marginBottom',
+  'marginLeft',
+  'backgroundColor',
+  'color',
+  'borderRadius',
+  'boxShadow',
+  'fontFamily',
+  'fontSize',
+  'fontWeight',
+  'lineHeight',
+];
+
+const AUTO_LAYOUT_STYLE_KEYS = [
+  'display',
+  'flexDirection',
+  'rowGap',
+  'columnGap',
+  'paddingTop',
+  'paddingRight',
+  'paddingBottom',
+  'paddingLeft',
+];
+
+export function scoreImplementationBenchmark(blueprint, candidate, reference, implementationReport) {
+  const checks = [];
+  const nodeIds = blueprint.nodes.map((node) => node.id);
+  const root = blueprint.nodes.find((node) => node.parent_id === null);
+
+  for (const viewport of blueprint.viewports) {
+    const candidateView = candidate.viewports[viewport.id];
+    const referenceView = reference.viewports[viewport.id];
+    add(checks, `${viewport.id}.screenshot`, Boolean(candidateView?.screenshot_bytes > 5000), '> 5000 bytes', candidateView?.screenshot_bytes ?? 0);
+    add(checks, `${viewport.id}.horizontal_overflow`, candidateView?.horizontal_overflow === false, false, candidateView?.horizontal_overflow);
+    add(checks, `${viewport.id}.root_children`, equal(candidateView?.root_children, root?.children ?? []), root?.children ?? [], candidateView?.root_children);
+
+    for (const nodeId of nodeIds) {
+      add(checks, `${viewport.id}.node.${nodeId}`, Boolean(candidateView?.nodes?.[nodeId]), true, Boolean(candidateView?.nodes?.[nodeId]));
+    }
+
+    for (const node of blueprint.nodes) {
+      const actualNode = candidateView?.nodes?.[node.id];
+      const referenceNode = referenceView?.nodes?.[node.id];
+      add(
+        checks,
+        `${viewport.id}.parent.${node.id}`,
+        actualNode?.parent_node_id === node.parent_id,
+        node.parent_id,
+        actualNode?.parent_node_id
+      );
+      const styleKeys = node.layout?.mode === 'auto'
+        ? [...STYLE_KEYS, ...AUTO_LAYOUT_STYLE_KEYS]
+        : STYLE_KEYS;
+      for (const key of styleKeys) {
+        if (referenceNode?.styles?.[key] === undefined) continue;
+        add(
+          checks,
+          `${viewport.id}.style.${node.id}.${key}`,
+          actualNode?.styles?.[key] === referenceNode.styles[key],
+          referenceNode.styles[key],
+          actualNode?.styles?.[key]
+        );
+      }
+
+      const placement = node.placements?.[viewport.id];
+      if (!placement) continue;
+      const actual = actualNode?.rect;
+      for (const key of ['x', 'y', 'width', 'height']) {
+        const pass = Number.isFinite(actual?.[key]) && Math.abs(actual[key] - placement[key]) <= 2;
+        add(checks, `${viewport.id}.geometry.${node.id}.${key}`, pass, placement[key], actual?.[key]);
+      }
+      add(checks, `${viewport.id}.geometry.${node.id}.z_index`, Number(actual?.z_index) === placement.z_index, placement.z_index, actual?.z_index);
+    }
+
+    const primary = candidateView?.nodes?.primary_cta?.rect;
+    const secondary = candidateView?.nodes?.secondary_cta?.rect;
+    add(checks, `${viewport.id}.cta_side_by_side`, Boolean(
+      primary && secondary && Math.abs(primary.y - secondary.y) <= 2 && primary.x + primary.width <= secondary.x
+    ), true, { primary, secondary });
+  }
+
+  for (const node of blueprint.nodes) {
+    const expectedText = node.content?.text ?? node.content?.label;
+    if (!expectedText) continue;
+    const actualText = candidate.viewports.desktop?.nodes?.[node.id]?.text?.trim();
+    add(checks, `content.${node.id}`, actualText === expectedText, expectedText, actualText);
+  }
+
+  for (const interaction of blueprint.interactions) {
+    add(
+      checks,
+      `interaction.${interaction.id}`,
+      candidate.interactions?.[interaction.source_node_id] === interaction.action,
+      interaction.action,
+      candidate.interactions?.[interaction.source_node_id]
+    );
+  }
+
+  add(checks, 'accessibility.focus_visible', candidate.has_focus_visible === true, true, candidate.has_focus_visible);
+  const reportVerification = verifyImplementationReport(blueprint, implementationReport);
+  add(checks, 'implementation_report.ready', reportVerification.ready, true, reportVerification);
+
+  const passed = checks.filter((check) => check.pass).length;
+  return {
+    score: Math.round((passed / checks.length) * 100),
+    passed,
+    total: checks.length,
+    ready: passed === checks.length,
+    checks,
+    report_verification: reportVerification,
+  };
+}
+
+function add(checks, path, pass, expected, actual) {
+  checks.push({ path, pass, expected, actual });
+}
+
+function equal(left, right) {
+  return JSON.stringify(left) === JSON.stringify(right);
+}