tabwright 1.0.0

package/src/a11y-client.ts

@@ -0,0 +1,241 @@
+/**
+ * Browser-side accessibility label renderer.
+ * Bundled and injected into page context via CDP.
+ */
+
+export interface LabelBox {
+  x: number
+  y: number
+  width: number
+  height: number
+}
+
+export interface A11yLabel {
+  ref: string
+  role: string
+  box: LabelBox
+}
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+const LABELS_CONTAINER_ID = '__tabwright_labels__'
+const LABELS_TIMER_KEY = '__tabwright_labels_timer__'
+
+// Color scheme for labels by role
+const ROLE_COLORS: Record<string, [string, string, string]> = {
+  link: ['#FFF785', '#FFC542', '#E3BE23'],
+  button: ['#FFE0B2', '#FFCC80', '#FFB74D'],
+  textbox: ['#FFCDD2', '#EF9A9A', '#E57373'],
+  combobox: ['#F8BBD0', '#F48FB1', '#F06292'],
+  searchbox: ['#F8BBD0', '#F48FB1', '#F06292'],
+  checkbox: ['#C8E6C9', '#A5D6A7', '#81C784'],
+  radio: ['#C8E6C9', '#A5D6A7', '#81C784'],
+  slider: ['#BBDEFB', '#90CAF9', '#64B5F6'],
+  spinbutton: ['#BBDEFB', '#90CAF9', '#64B5F6'],
+  switch: ['#D1C4E9', '#B39DDB', '#9575CD'],
+  menuitem: ['#FFE0B2', '#FFCC80', '#FFB74D'],
+  menuitemcheckbox: ['#FFE0B2', '#FFCC80', '#FFB74D'],
+  menuitemradio: ['#FFE0B2', '#FFCC80', '#FFB74D'],
+  option: ['#FFE0B2', '#FFCC80', '#FFB74D'],
+  tab: ['#FFE0B2', '#FFCC80', '#FFB74D'],
+  treeitem: ['#FFE0B2', '#FFCC80', '#FFB74D'],
+  img: ['#B3E5FC', '#81D4FA', '#4FC3F7'],
+  video: ['#B3E5FC', '#81D4FA', '#4FC3F7'],
+  audio: ['#B3E5FC', '#81D4FA', '#4FC3F7'],
+}
+
+const DEFAULT_COLORS: [string, string, string] = ['#FFF9C4', '#FFF59D', '#FFEB3B']
+
+// ============================================================================
+// Label Rendering
+// ============================================================================
+
+function renderA11yLabels(labels: A11yLabel[]): number {
+  const doc = document
+  const win = window as typeof window & { [LABELS_TIMER_KEY]?: number | null }
+
+  // Cancel any pending auto-hide timer
+  if (win[LABELS_TIMER_KEY]) {
+    win.clearTimeout(win[LABELS_TIMER_KEY])
+    win[LABELS_TIMER_KEY] = null
+  }
+
+  // Remove existing labels
+  doc.getElementById(LABELS_CONTAINER_ID)?.remove()
+
+  // Create container
+  const container = doc.createElement('div')
+  container.id = LABELS_CONTAINER_ID
+  container.style.cssText = 'position:absolute;left:0;top:0;z-index:2147483647;pointer-events:none;'
+
+  // Inject styles
+  const style = doc.createElement('style')
+  style.textContent = `
+    .__pw_label__ {
+      position: absolute;
+      font: bold 12px Helvetica, Arial, sans-serif;
+      padding: 1px 4px;
+      border-radius: 3px;
+      color: black;
+      text-shadow: 0 1px 0 rgba(255, 255, 255, 0.6);
+      white-space: nowrap;
+    }
+  `
+  container.appendChild(style)
+
+  // Create SVG for connector lines
+  const svg = doc.createElementNS('http://www.w3.org/2000/svg', 'svg')
+  svg.style.cssText = 'position:absolute;left:0;top:0;pointer-events:none;overflow:visible;'
+  svg.setAttribute('width', `${doc.documentElement.scrollWidth}`)
+  svg.setAttribute('height', `${doc.documentElement.scrollHeight}`)
+
+  // Arrow markers
+  const defs = doc.createElementNS('http://www.w3.org/2000/svg', 'defs')
+  svg.appendChild(defs)
+  const markerCache: Record<string, string> = {}
+
+  function getArrowMarkerId(color: string): string {
+    if (markerCache[color]) {
+      return markerCache[color]
+    }
+    const markerId = `arrow-${color.replace('#', '')}`
+    const marker = doc.createElementNS('http://www.w3.org/2000/svg', 'marker')
+    marker.setAttribute('id', markerId)
+    marker.setAttribute('viewBox', '0 0 10 10')
+    marker.setAttribute('refX', '9')
+    marker.setAttribute('refY', '5')
+    marker.setAttribute('markerWidth', '6')
+    marker.setAttribute('markerHeight', '6')
+    marker.setAttribute('orient', 'auto-start-reverse')
+    const path = doc.createElementNS('http://www.w3.org/2000/svg', 'path')
+    path.setAttribute('d', 'M 0 0 L 10 5 L 0 10 z')
+    path.setAttribute('fill', color)
+    marker.appendChild(path)
+    defs.appendChild(marker)
+    markerCache[color] = markerId
+    return markerId
+  }
+
+  container.appendChild(svg)
+
+  // Track placed labels for overlap detection
+  const placedLabels: Array<{ left: number; top: number; right: number; bottom: number }> = []
+  const LABEL_HEIGHT = 17
+  const LABEL_CHAR_WIDTH = 7
+
+  const viewportLeft = win.scrollX
+  const viewportTop = win.scrollY
+  const viewportRight = viewportLeft + win.innerWidth
+  const viewportBottom = viewportTop + win.innerHeight
+
+  let count = 0
+  for (const { ref, role, box } of labels) {
+    const rectLeft = box.x
+    const rectTop = box.y
+    const rectRight = rectLeft + box.width
+    const rectBottom = rectTop + box.height
+
+    if (box.width <= 0 || box.height <= 0) {
+      continue
+    }
+
+    // Skip if outside viewport
+    if (rectRight < viewportLeft || rectLeft > viewportRight || rectBottom < viewportTop || rectTop > viewportBottom) {
+      continue
+    }
+
+    // Calculate label position
+    const labelWidth = ref.length * LABEL_CHAR_WIDTH + 8
+    const labelLeft = rectLeft
+    const labelTop = Math.max(0, rectTop - LABEL_HEIGHT)
+    const labelRect = {
+      left: labelLeft,
+      top: labelTop,
+      right: labelLeft + labelWidth,
+      bottom: labelTop + LABEL_HEIGHT,
+    }
+
+    // Check overlap
+    let overlaps = false
+    for (const placed of placedLabels) {
+      if (
+        labelRect.left < placed.right &&
+        labelRect.right > placed.left &&
+        labelRect.top < placed.bottom &&
+        labelRect.bottom > placed.top
+      ) {
+        overlaps = true
+        break
+      }
+    }
+    if (overlaps) {
+      continue
+    }
+
+    // Get colors
+    const [gradTop, gradBottom, border] = ROLE_COLORS[role] || DEFAULT_COLORS
+
+    // Create label
+    const label = doc.createElement('div')
+    label.className = '__pw_label__'
+    label.textContent = ref
+    label.style.background = `linear-gradient(to bottom, ${gradTop} 0%, ${gradBottom} 100%)`
+    label.style.border = `1px solid ${border}`
+    label.style.left = `${labelLeft}px`
+    label.style.top = `${labelTop}px`
+    container.appendChild(label)
+
+    // Draw connector line
+    const line = doc.createElementNS('http://www.w3.org/2000/svg', 'line')
+    const labelCenterX = labelLeft + labelWidth / 2
+    const labelBottomY = labelTop + LABEL_HEIGHT
+    const elementCenterX = rectLeft + box.width / 2
+    const elementCenterY = rectTop + box.height / 2
+    line.setAttribute('x1', `${labelCenterX}`)
+    line.setAttribute('y1', `${labelBottomY}`)
+    line.setAttribute('x2', `${elementCenterX}`)
+    line.setAttribute('y2', `${elementCenterY}`)
+    line.setAttribute('stroke', border)
+    line.setAttribute('stroke-width', '1.5')
+    line.setAttribute('marker-end', `url(#${getArrowMarkerId(border)})`)
+    svg.appendChild(line)
+
+    placedLabels.push(labelRect)
+    count++
+  }
+
+  doc.documentElement.appendChild(container)
+
+  // Auto-hide after 30 seconds
+  win[LABELS_TIMER_KEY] = win.setTimeout(() => {
+    doc.getElementById(LABELS_CONTAINER_ID)?.remove()
+    win[LABELS_TIMER_KEY] = null
+  }, 30000)
+
+  return count
+}
+
+// ============================================================================
+// Hide Labels
+// ============================================================================
+
+export function hideA11yLabels(): void {
+  const win = window as typeof window & { [LABELS_TIMER_KEY]?: number | null }
+  if (win[LABELS_TIMER_KEY]) {
+    win.clearTimeout(win[LABELS_TIMER_KEY])
+    win[LABELS_TIMER_KEY] = null
+  }
+  document.getElementById(LABELS_CONTAINER_ID)?.remove()
+}
+
+// ============================================================================
+// Expose on globalThis for injection
+// ============================================================================
+
+;(globalThis as { __a11y?: { renderA11yLabels: (labels: A11yLabel[]) => number; hideA11yLabels: () => void } }).__a11y =
+  {
+    renderA11yLabels,
+    hideA11yLabels,
+  }

package/src/agent-skills/conan-config/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: conan-config
+description: Search, read, inspect history and schemas, validate edits, manage drafts, publish, create, copy, and roll back domestic Conan/Buff Space_Enhanced_Config configs through the unified Tabwright conan-config capability. Use immediately for exact config URLs, config keywords, draft or history questions, and explicit config changes in cn-prod or cn-test. Run read operations autonomously; require a prepared immutable report, a structured semantic diff or definition preview, and explicit user confirmation for every write operation.
+---
+
+# Conan Config
+
+Use `tabwright capability run conan-config`; never execute `conan-config` as a shell command.
+
+## Select the environment
+
+Infer the environment from an exact URL:
+
+- `cn-prod`: `conan.zhenguanyu.com`, `buff.zhenguanyu.com`
+- `cn-test`: `ytkconan.zhenguanyu.com`, `buff-test.zhenguanyu.com`
+
+Pass `environment` explicitly when no URL is available. For a write, stop and resolve an ambiguous environment before preparing the change. Do not use this capability for overseas hosts.
+
+Capability runs write local run logs and artifacts under `~/.tabwright/capabilities/conan-config/`; use escalated execution in a Codex sandbox. If cookie auth is missing or expired, report the blocker and obtain approval before running:
+
+```bash
+tabwright capability refresh-auth conan-config --browser user --json
+```
+
+## Run read operations directly
+
+Run these operations without confirmation:
+
+```bash
+tabwright capability run conan-config --input-json '{"action":"list-spaces","environment":"cn-prod"}' --json
+tabwright capability run conan-config --input-json '{"action":"search","environment":"cn-test","query":"会员订单"}' --json
+tabwright capability run conan-config --input-json '{"action":"history","url":"<config-url>"}' --json
+tabwright capability run conan-config --input-json '{"action":"get-schema","url":"<config-url>"}' --json
+```
+
+For an exact `Space_Enhanced_Config` URL, route or get it immediately:
+
+```bash
+tabwright capability route "<config-url>" --json
+tabwright capability run conan-config --input-json '{"action":"get","url":"<config-url>"}' --json
+```
+
+Use `historyIds` with `history` only when full historical values are needed. Keep large values out of chat and point to saved artifacts. Production artifacts retain the legacy path `artifacts/conan-config/<namespace>/<key>/`; test artifacts use `artifacts/conan-config/cn-test/<namespace>/<key>/`.
+
+## Validate values
+
+Validate the complete target value, not only changed fields. Check:
+
+- Formily field types, required fields, enums, defaults, `x-validator`, and `x-reactions`
+- component semantics and nested array/object shapes
+- unchanged legacy fields that the schema may not expose
+- every path in the structured semantic Diff
+- suspicious test markers such as `ytk`, `.biz`, or `test` when targeting `cn-prod`
+
+Return a report with `passed`, `errors`, `warnings`, `warningsAccepted`, `environment`, the hashes and version fields returned by the prepare operation, and `summary`. Never mark warnings accepted unless the user explicitly accepts them.
+
+## Change content
+
+Prepare the complete target value:
+
+```bash
+tabwright capability run conan-config --input-json '{"action":"prepare-change","url":"<config-url>","value":<complete-target-json>,"changeSummary":"<summary>"}' --json
+```
+
+Show `environment`, field paths, before/after values, warnings, and whether a draft exists. Then choose exactly one confirmed write:
+
+- Save without publishing: `save-draft` with `--confirm conan-config:save-draft`
+- Update and publish atomically: `apply-change` with `--confirm conan-config:apply-change`
+
+Pass the unchanged complete target value, summary, and validation report. Both operations recheck `environment`, `schemaId`, `updatedTime`, `sourceSha256`, and `targetSha256`. Do not overwrite an existing draft.
+
+## Publish or discard a draft
+
+Prepare an existing draft:
+
+```bash
+tabwright capability run conan-config --input-json '{"action":"prepare-publish-draft","url":"<config-url>"}' --json
+```
+
+Validate `draftValue`, show the Diff against `currentValue`, the draft operator, environment, and warnings, then:
+
+- Publish with the unchanged validation report and `--confirm conan-config:publish-draft`.
+- Discard only after showing `configDraftId`, operator, environment, and Diff; pass the prepared `configDraftId` and `draftSha256` with `--confirm conan-config:discard-draft`.
+
+Treat discarding as destructive. Never retry a failed or partially completed draft write automatically.
+
+## Create a config
+
+Resolve the target `groupingId` with `list-spaces` or `search`, then prepare:
+
+```bash
+tabwright capability run conan-config --input-json '{"action":"prepare-create","environment":"cn-test","groupingId":123,"key":"CONFIG_KEY","name":"配置名称","desc":"配置描述","schemaId":456}' --json
+```
+
+Show the complete definition, target root grouping, environment, Schema summary, and warnings. After confirmation, pass `environment`, `targetSha256`, and `groupingUpdatedTime` unchanged in `preparationReport`, then run `create` with `--confirm conan-config:create`.
+
+Creating a config does not create or edit a Schema. A `schemaId` of `0` means no Formily Schema and must be shown as a warning.
+
+## Copy a config definition
+
+Prepare the source and target:
+
+```bash
+tabwright capability run conan-config --input-json '{"action":"prepare-copy","sourceUrl":"<source-config-url>","groupingId":123,"targetKey":"CONFIG_KEY_COPY"}' --json
+```
+
+Show the source, target, environment, target grouping, and `contentCopied: false`. The B-side copy flow copies metadata and reuses the source `schemaId`; it does not copy the source value. After confirmation, pass the unchanged preparation fields and run `copy` with `--confirm conan-config:copy`.
+
+If the user also wants content copied, create the target definition first, then run the normal `prepare-change` and `save-draft` or `apply-change` workflow on the new target.
+
+## Roll back
+
+List history, choose one `historyId`, then prepare:
+
+```bash
+tabwright capability run conan-config --input-json '{"action":"prepare-rollback","url":"<config-url>","historyId":123}' --json
+```
+
+Validate the full historical value against its historical Schema. Show the environment, history record, Schema change, and semantic Diff. Stop if a draft exists. After confirmation, pass the unchanged report fields and run `rollback` with `--confirm conan-config:rollback`.
+
+Rollback creates and publishes a draft with operation type `backtrace`, then reads the live config back. Never retry it automatically.
+
+## Confirmation discipline
+
+Never call a write operation directly from a raw user request. Always run its read-only prepare operation first, display the concrete target and side effect, and obtain confirmation for that exact prepared state.
+
+Use only these write confirmations:
+
+- `conan-config:save-draft`
+- `conan-config:apply-change`
+- `conan-config:publish-draft`
+- `conan-config:discard-draft`
+- `conan-config:create`
+- `conan-config:copy`
+- `conan-config:rollback`
+
+Do not use this capability to delete configs, manage groupings, create or edit Schemas, change favourites, or operate overseas environments.
+
+## Report results
+
+Keep answers compact. Always report `environment`, `namespace`, `key`, `configId`, operation status, and verification result. For writes, also report `configDraftId` when present and state whether the change was published. Do not create extra export files unless requested.

package/src/agent-skills/conan-config/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: 'Conan 文案配置'
+  short_description: '查询并安全管理国内正式与测试环境的 Conan 文案配置'
+  default_prompt: 'Use $conan-config to inspect or safely change this domestic Conan copywriting config.'