@etus/seven-skill 0.1.0-beta.3 → 0.1.0-beta.5

package/docs/upstream-parity.json

@@ -0,0 +1,242 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "schemaVersion": 1,
+  "updatedAt": "2026-07-22",
+  "upstream": {
+    "repository": "https://github.com/pbakaus/impeccable",
+    "commit": "698a743958a401b17ca443db706eb5477c6afc59",
+    "cliVersion": "3.3.1",
+    "skillVersion": "4.0.1",
+    "extensionVersion": "1.2.1"
+  },
+  "statusDefinitions": {
+    "ported": "Equivalent behavior ships in Seven.",
+    "adapted": "The useful behavior ships with Seven as the visual and component authority.",
+    "rejected": "The upstream behavior conflicts with Seven or the explicit consumer-only boundary.",
+    "pending": "Applicable behavior is not implemented yet."
+  },
+  "constraints": {
+    "consumerGithubArtifacts": false,
+    "consumerDesignOverride": false,
+    "designAuthority": "The exact installed Seven release, registry, components, variants, and tokens.",
+    "framework": "React 19 and Tailwind CSS 4"
+  },
+  "commands": {
+    "ported": [
+      "audit",
+      "clarify",
+      "polish",
+      "shape"
+    ],
+    "adapted": [
+      "adapt",
+      "animate",
+      "bolder",
+      "colorize",
+      "critique",
+      "delight",
+      "distill",
+      "document",
+      "extract",
+      "harden",
+      "init",
+      "layout",
+      "live",
+      "onboard",
+      "optimize",
+      "overdrive",
+      "quieter",
+      "typeset"
+    ],
+    "rejected": [
+      "craft"
+    ],
+    "pending": [],
+    "notes": {
+      "craft": "Deprecated upstream alias; Seven has no reason to preserve an obsolete public name.",
+      "init": "Adapted to Seven product/app/surface context; it never creates a consumer DESIGN.md.",
+      "live": "Adapted to an authenticated loopback bridge and inert browser previews; accepted DOM is translated into validated React/Seven source instead of pasted.",
+      "onboard": "Owns first-run product experiences; context capture is handled by init."
+    }
+  },
+  "operations": {
+    "ported": [
+      "doctor",
+      "hooks"
+    ],
+    "adapted": [
+      "context-aware-routing",
+      "daily-update-check",
+      "local-pre-commit",
+      "pin-unpin",
+      "project-context",
+      "release-update",
+      "surface-briefs"
+    ],
+    "rejected": [
+      "consumer-github-hooks"
+    ],
+    "pending": []
+  },
+  "providers": {
+    "ported": [
+      "claude-code",
+      "codex"
+    ],
+    "adapted": [
+      "agents",
+      "cursor",
+      "gemini",
+      "grok",
+      "kiro",
+      "opencode",
+      "pi",
+      "qoder",
+      "rovo-dev",
+      "trae",
+      "trae-cn",
+      "vibe"
+    ],
+    "rejected": [
+      "github"
+    ],
+    "pending": [],
+    "notes": {
+      "agents": "The upstream Codex Repo Skills build is the same installed .agents skill tree used by Seven's codex provider alias.",
+      "github": "Explicitly excluded: Seven consumer governance never creates or edits .github artifacts."
+    }
+  },
+  "detectorRules": {
+    "ported": [
+      "all-caps-body",
+      "aphoristic-cadence",
+      "blinking-cursor",
+      "body-text-viewport-edge",
+      "bounce-easing",
+      "broken-image",
+      "clipped-overflow-container",
+      "codex-grid-background",
+      "content-hidden-at-rest",
+      "cramped-padding",
+      "design-system-color",
+      "design-system-font",
+      "design-system-font-size",
+      "design-system-radius",
+      "edge-flush-cards",
+      "extreme-negative-tracking",
+      "first-viewport-column-overflow",
+      "flat-type-hierarchy",
+      "gpt-thin-border-wide-shadow",
+      "gray-on-color",
+      "heading-rhythm",
+      "icon-tile-stack",
+      "image-hover-transform",
+      "justified-text",
+      "layout-transition",
+      "line-length",
+      "low-contrast",
+      "marketing-buzzword",
+      "marquee",
+      "monotonous-spacing",
+      "nested-cards",
+      "numbered-section-labels",
+      "oversized-h1",
+      "pulsing-dot",
+      "radial-halo",
+      "repeated-container-text",
+      "repeating-stripes-gradient",
+      "script-error",
+      "shape-assembled-illustration",
+      "skipped-heading",
+      "text-occlusion",
+      "text-overflow",
+      "theater-slop-phrase",
+      "tight-leading",
+      "tiny-text",
+      "undersized-ui-text",
+      "wide-tracking"
+    ],
+    "adapted": [
+      "ai-color-palette",
+      "border-accent-on-rounded",
+      "cream-palette",
+      "dark-glow",
+      "em-dash-overuse",
+      "gradient-text",
+      "overused-font",
+      "side-tab"
+    ],
+    "rejected": [
+      "hero-eyebrow-chip",
+      "italic-serif-display",
+      "repeated-section-kickers",
+      "single-font"
+    ],
+    "pending": [],
+    "sevenOnly": [
+      "non-inter-font",
+      "hardcoded-color-not-token",
+      "raw-tailwind-palette-color",
+      "missing-color-type-hint",
+      "missing-length-type-hint",
+      "leading-none-with-length-var",
+      "fuchsia-in-ui-chrome",
+      "pt-pt-vocab",
+      "pure-black-or-white",
+      "side-stripe-border",
+      "gradient-text-decorative",
+      "shadows-not-borders",
+      "everything-centered",
+      "missing-tactile-press",
+      "pill-on-button",
+      "radius-mixed-scales",
+      "non-lucide-icon",
+      "emoji-in-chrome",
+      "forbidden-em-dash",
+      "sidebar-topbar-shell",
+      "sidebar-rail-behavior"
+    ],
+    "consumerBoundary": [
+      "unknown-seven-token",
+      "raw-interactive-element",
+      "foreign-ui-library",
+      "invalid-seven-variant"
+    ]
+  },
+  "systems": {
+    "ported": [
+      "browser-extension",
+      "doctor",
+      "provider-hooks",
+      "provider-transformer",
+      "safe-update-uninstall",
+      "three-engine-detector"
+    ],
+    "adapted": [
+      "asset-producer",
+      "critique-persistence",
+      "design-extraction",
+      "design-system-validation",
+      "finish-reviewer",
+      "image-generation",
+      "interactive-direction-picker",
+      "live-mode",
+      "manual-edit-applier",
+      "pattern-extraction",
+      "product-context",
+      "surface-briefs",
+      "visual-direction-probes"
+    ],
+    "rejected": [
+      "consumer-github-integration",
+      "design-md-as-consumer-authority",
+      "native-ios-android",
+      "svelte-live-adapter"
+    ],
+    "pending": [],
+    "notes": {
+      "provider-hooks": "Includes the CLI 3.3.1 stop_hook_active re-entry guard; other hosts retain Seven's bounded fallback.",
+      "three-engine-detector": "Includes CLI 3.3.1 browser parity for undersized UI text and Seven's stricter rendered long-dash adaptation."
+    }
+  }
+}

package/extension/README.md

@@ -0,0 +1,5 @@
+# Seven UI Guardian
+
+Extensão Chromium Manifest V3 empacotada com `@etus/seven-skill`. Ela executa o mesmo detector determinístico distribuído pelo release instalado, mostra findings no popup e no painel DevTools e conecta o overlay Seven Live a um bridge local autenticado.
+
+O npm não pode instalar extensões no navegador sem consentimento. Rode `seven extension path`, abra `chrome://extensions`, ative o modo do desenvolvedor e use **Carregar sem compactação** no caminho informado. O token do Live existe apenas em memória e nunca é persistido pela extensão.

package/extension/background/service-worker.js

@@ -0,0 +1,134 @@
+/* global chrome */
+
+const states = new Map()
+const panelPorts = new Map()
+
+function stateFor(tabId) {
+  if (!states.has(tabId)) states.set(tabId, { findings: [], overlaysVisible: true, contentReady: false })
+  return states.get(tabId)
+}
+
+function notify(tabId, message) {
+  for (const port of panelPorts.get(tabId) || []) {
+    try { port.postMessage(message) } catch { /* disconnected */ }
+  }
+  chrome.runtime.sendMessage({ ...message, tabId }).catch(() => undefined)
+}
+
+function updateBadge(tabId, findings) {
+  const count = findings.length
+  chrome.action.setBadgeText({ tabId, text: count ? String(count) : "" }).catch(() => undefined)
+  chrome.action.setBadgeBackgroundColor({ tabId, color: "#146C5A" }).catch(() => undefined)
+}
+
+async function ensureContent(tabId) {
+  const state = stateFor(tabId)
+  // A full-page navigation destroys the isolated world without necessarily
+  // clearing this service worker's tab state. Reinjection is safe because the
+  // content script has its own idempotency guard.
+  await chrome.scripting.executeScript({ target: { tabId }, files: ["content/content-script.js"] })
+  state.contentReady = true
+}
+
+async function scan(tabId) {
+  await ensureContent(tabId)
+  await chrome.scripting.executeScript({
+    target: { tabId },
+    world: "MAIN",
+    files: ["detector/detect.js"],
+  })
+  const result = await chrome.scripting.executeScript({
+    target: { tabId },
+    world: "MAIN",
+    func: () => (typeof window.sevenDetect === "function" ? window.sevenDetect() : []),
+  })
+  const findings = Array.isArray(result?.[0]?.result) ? result[0].result : []
+  const state = stateFor(tabId)
+  state.findings = findings
+  updateBadge(tabId, findings)
+  await chrome.tabs.sendMessage(tabId, { action: "seven-findings", findings, visible: state.overlaysVisible }).catch(() => undefined)
+  notify(tabId, { action: "seven-state", state })
+  return state
+}
+
+function loopbackServer(value) {
+  try {
+    const url = new URL(value)
+    return url.protocol === "http:" && url.hostname === "127.0.0.1" ? url.origin : null
+  } catch {
+    return null
+  }
+}
+
+async function liveRequest(message) {
+  const server = loopbackServer(message.serverUrl)
+  if (!server) throw new Error("O bridge Live precisa usar http://127.0.0.1:<porta>.")
+  const allowed = new Set(["/health", "/events", "/reply", "/status"])
+  const url = new URL(message.path, server)
+  if (!allowed.has(url.pathname)) throw new Error("Rota Live não permitida pela extensão.")
+  const response = await fetch(url, {
+    method: message.method || "GET",
+    headers: {
+      Authorization: `Bearer ${String(message.token || "")}`,
+      ...(message.body == null ? {} : { "Content-Type": "application/json" }),
+    },
+    body: message.body == null ? undefined : JSON.stringify(message.body),
+  })
+  const text = await response.text()
+  let data = null
+  if (text) {
+    try { data = JSON.parse(text) } catch { data = { error: text } }
+  }
+  return { ok: response.ok, status: response.status, data }
+}
+
+chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
+  const tabId = message.tabId || sender.tab?.id
+  if (message.action === "seven-scan" && tabId) {
+    scan(tabId).then((state) => sendResponse({ ok: true, state })).catch((error) => sendResponse({ ok: false, error: error.message }))
+    return true
+  }
+  if (message.action === "seven-get-state" && tabId) {
+    sendResponse({ ok: true, state: stateFor(tabId) })
+    return false
+  }
+  if (message.action === "seven-toggle" && tabId) {
+    const state = stateFor(tabId)
+    state.overlaysVisible = !state.overlaysVisible
+    ensureContent(tabId)
+      .then(() => chrome.tabs.sendMessage(tabId, { action: "seven-toggle", visible: state.overlaysVisible }))
+      .then(() => sendResponse({ ok: true, state }))
+      .catch((error) => sendResponse({ ok: false, error: error.message }))
+    return true
+  }
+  if (["seven-highlight", "seven-live-connect", "seven-live-disconnect"].includes(message.action) && tabId) {
+    ensureContent(tabId)
+      .then(() => chrome.tabs.sendMessage(tabId, message))
+      .then((result) => sendResponse(result || { ok: true }))
+      .catch((error) => sendResponse({ ok: false, error: error.message }))
+    return true
+  }
+  if (message.action === "seven-live-request") {
+    liveRequest(message).then(sendResponse).catch((error) => sendResponse({ ok: false, status: 0, data: { error: error.message } }))
+    return true
+  }
+  return false
+})
+
+chrome.runtime.onConnect.addListener((port) => {
+  if (!port.name.startsWith("seven-panel-")) return
+  const tabId = Number(port.name.slice("seven-panel-".length))
+  if (!panelPorts.has(tabId)) panelPorts.set(tabId, new Set())
+  panelPorts.get(tabId).add(port)
+  port.postMessage({ action: "seven-state", state: stateFor(tabId) })
+  port.onMessage.addListener((message) => {
+    if (message.action === "seven-scan") scan(tabId).catch(() => undefined)
+    if (message.action === "seven-highlight") chrome.tabs.sendMessage(tabId, message).catch(() => undefined)
+  })
+  port.onDisconnect.addListener(() => panelPorts.get(tabId)?.delete(port))
+})
+
+chrome.tabs.onRemoved.addListener((tabId) => {
+  states.delete(tabId)
+  panelPorts.delete(tabId)
+})