super-ux 0.61.0 → 0.63.0

package/CHANGELOG.md

@@ -1,3 +1,66 @@
+## 0.63.0 (2026-10-20): short descriptions, triggers in the body
+
+- **Every skill description is a router of 279 to 393 characters** (was 332 to
+  948). The operator's Claude Code skill listing measured 29,995 of about
+  30,000 characters for 134 skills, and 81 skills showed no description at
+  all; a plugin skill cannot be hidden, so length is the only lever. Each
+  description is one "Use when" sentence, four to six English and Russian
+  triggers, one "Not for" boundary naming the sibling, and the refusal
+  phrase where the route has one. Total for the seven skills: 4,426 to 2,436.
+- **Every removed trigger phrase moved verbatim into a `## Triggers` section**
+  of its SKILL.md body, so the family routing hook's words still appear in the
+  skill's own text.
+- **`ux-flows` Improve procedure moved to `references/flow-improve.md`**, text
+  unchanged apart from link paths, so the body stays inside the house audit's
+  4,750-token working limit with the new `## Triggers` section (4,712 tokens
+  before, 4,564 after).
+- **Commands carry one short sentence each** (60 to 89 characters, was 99 to
+  224; total 2,424 to 1,116).
+- **`validate.py` holds the budget:** a skill description over 500 characters
+  or without a "Not for" boundary fails, a command description over 120 fails,
+  and the trigger-position check reads `Triggers:` as well as `Triggers - `.
+
+## 0.62.0 (2026-10-19): retrieval crawlers, the audit's brief, landing promises, Copylot sweep
+
+- **`B050` judges retrieval agents only.** The AI-search contradiction is a block
+  of `OAI-SearchBot`, `ChatGPT-User`, `Claude-SearchBot`, `Claude-User`,
+  `PerplexityBot` or `Perplexity-User` while `channels.md` declares AI search a
+  target. Training and dataset tokens (`GPTBot`, `ClaudeBot`, `CCBot`,
+  `Google-Extended`) are a separate decision and are never reported; before
+  this release a `GPTBot` block was an error and an `OAI-SearchBot` block was
+  invisible. robots.txt is read in RFC 9309 groups: shared `User-agent` lines,
+  the `*` fallback for an agent with no group of its own, case-insensitive
+  tokens, and an equal-length `Allow: /` beating `Disallow: /`. Each purpose is
+  cited from the vendor's own crawler page in the code and the contract.
+  Fifteen new fixtures, each defect planted in the linter and watched red.
+- **`seo-aeo-safety.md`:** a "Crawler policy: two decisions" section with the
+  vendor table; the technical floor replaced by a pointer to seo-aeo-audit's
+  brief mode (`references/build-time.md`, ships with seo-aeo-audit 0.28); no
+  `FAQPage`/`HowTo` markup for rich results (Google's changelog: HowTo removed
+  in 2023, FAQ rich results gone from 7 May 2026); the keyword-stuffing text now
+  states what `B051` enforces (pages of 40 or more words, a word repeated 5 or
+  more times above a 4% share, registered terms exempt, advisory) instead of
+  the retired 1% rule; Claude's row in the engine table reflects web search.
+- **`landing-pages.md` LP-21..LP-24:** an offer condition next to its claim and
+  the same in the ad; lead with the problem and name AI only where it changes
+  the outcome; a "works with X" claim waits for a measured acceptance test in
+  `facts.md`; one job per page and creatives judged by the qualified-step rate,
+  not CTR. Readiness-check commands for LP-21, LP-23 and LP-24; LP-22 stays a
+  reading. Each rule cites the regulator or platform policy it rests on.
+- **`copywriting`:** runs `copylot.check` beside the brand linter when the tool
+  is in the session (target `register: web`, `format: web-page`; until
+  Copylot's schema lists them, `marketing` and no format, said out loud) and
+  prints a fallback line when it is absent.
+- **Synthetic respondents are hypotheses:** `research-evidence.md`,
+  `ux-foundation` and `ux-scenarios` say a synthetic persona or LLM "digital
+  twin" is never evidence for a persona or scenario decision (cited: Nielsen
+  Norman Group, 2024). `audit-depth.md` adds the quarterly fresh-user walk:
+  clean install or new account, from the ad or landing page to paid use with a
+  real payment method, on the smallest supported screen, findings recorded
+  against scenarios.
+- Contract copies synchronized with `python3 test/sync_references.py`; seeded
+  `docs/brand/lint.py` re-copied. Discovery descriptions unchanged.
+
 ## 0.61.0 (2026-10-18): no em dash in new text
 
 Owner decision, 2026-10-18: text an agent writes carries no em dash (U+2014), in

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "super-ux",
-  "version": "0.61.0",
+  "version": "0.63.0",
   "scripts": {
     "test": "python3 test/validate.py && python3 test/brand_lint_test.py && python3 test/display_copy_test.py && python3 test/ux_lint_test.py && python3 docs/ux/lint.py && python3 docs/brand/lint.py && node test/installer_test.js && npm run test:audit",
     "test:audit": "for t in test/audit_regressions/*.py; do python3 \"$t\" || exit 1; done"

package/plugins/super-ux/scripts/brand_lint.py

@@ -1794,7 +1794,79 @@ def _ios_keywords(path: str, fields: dict, raw: str) -> list[Finding]:
     return findings
 
 
-AI_AGENTS = ("GPTBot", "ClaudeBot", "PerplexityBot", "Google-Extended")
+# B050 judges RETRIEVAL agents only: the ones that fetch a page to show, cite
+# or answer from it. Blocking one while AI search is a declared target is the
+# contradiction. Each purpose is the vendor's own wording, read 2026-10-19:
+#   OAI-SearchBot  "surface websites in search results in ChatGPT's search
+#                  features"; ChatGPT-User  user-initiated fetches
+#                  (https://developers.openai.com/api/docs/bots)
+#   Claude-SearchBot  indexes content for search; Claude-User  retrieves a
+#                  page in response to a user query
+#                  (https://support.claude.com/en/articles/8896518)
+#   PerplexityBot  "surface and link websites in search results on
+#                  Perplexity"; Perplexity-User  fetches for a user's question
+#                  (https://docs.perplexity.ai/guides/bots)
+RETRIEVAL_AGENTS = (
+    "OAI-SearchBot", "ChatGPT-User", "Claude-SearchBot", "Claude-User",
+    "PerplexityBot", "Perplexity-User",
+)
+# TRAINING and dataset tokens: blocking them is a separate decision with no
+# effect on AI search, so B050 never reports them. GPTBot and ClaudeBot are
+# the vendors' training crawlers (same pages); Google-Extended controls Gemini
+# training and grounding and "does not impact a site's inclusion in Google
+# Search" (https://developers.google.com/crawling/docs/crawlers-fetchers/google-common-crawlers);
+# CCBot builds Common Crawl's open archive (https://commoncrawl.org/ccbot).
+TRAINING_AGENTS = ("GPTBot", "ClaudeBot", "CCBot", "Google-Extended")
+# Whole-site paths and their rule length. Google's matcher ignores a trailing
+# `*` (so `/*` and a bare `*` weigh what `/` weighs) and reads `$` as the end
+# of the path; the longer rule wins and Allow wins a tie (RFC 9309 2.2.2).
+# So `Disallow: /*` against `Allow: /` is a tie Allow wins, while
+# `Disallow: /*$` (3 octets) outranks `Allow: /`.
+FULL_PATHS = {"/": 1, "/*": 1, "*": 1, "/*$": 3}
+
+
+def robots_groups(text: str) -> list[tuple[list[str], list[tuple[str, str]]]]:
+    """RFC 9309 groups: consecutive `User-agent` lines share the rules after
+    them, and a `User-agent` line after a rule opens a new group. Tokens are
+    lower-cased, because product tokens match case-insensitively, and cut to
+    their leading [a-z_-] run, as Google's matcher does, so `OAI-SearchBot/1.0`
+    still names OAI-SearchBot. A UTF-8 BOM before the first line is dropped."""
+    text = text.lstrip("\ufeff")
+    groups: list[tuple[list[str], list[tuple[str, str]]]] = []
+    agents: list[str] = []
+    rules: list[tuple[str, str]] = []
+    for raw in text.splitlines():
+        line = raw.split("#", 1)[0].strip()
+        m = re.match(r"^(user-agent|allow|disallow)\s*:\s*(.*?)\s*$", line, re.I)
+        if not m:
+            continue
+        key, value = m.group(1).lower(), m.group(2)
+        if key == "user-agent":
+            if rules:
+                groups.append((agents, rules))
+                agents, rules = [], []
+            token = re.match(r"\*(?=\s|$)|[a-z_-]*", value.lower()).group(0)
+            agents.append(token or value.lower())
+        elif agents:
+            rules.append((key, value))
+    if agents:
+        groups.append((agents, rules))
+    return groups
+
+
+def robots_blocks(text: str, token: str) -> bool:
+    """True when robots.txt shuts `token` out of the whole site. The agent
+    obeys the groups naming it, or the `*` groups when none does; an
+    equal-length `Allow` beats `Disallow` (RFC 9309 section 2.2.2)."""
+    groups = robots_groups(text)
+    own = [r for a, r in groups if token.lower() in a]
+    rules = [rule for rs in (own or [r for a, r in groups if "*" in a])
+             for rule in rs]
+    def longest(kind: str) -> int:
+        return max((FULL_PATHS[v] for k, v in rules
+                    if k == kind and v in FULL_PATHS), default=0)
+    disallow, allow = longest("disallow"), longest("allow")
+    return disallow > 0 and disallow > allow
 
 FILLER_OPENERS = (
     "in today's digital landscape", "in the ever-evolving world",
@@ -2159,21 +2231,15 @@ def check_bot_safety(brand_dir: Path, sources: dict) -> list[Finding]:
             (p, {}, "") for p in sources["robots"]
         ]:
             robots = read(brand_dir.parent.parent / path) or ""
-            blocks = []
-            agent = None
-            for line in robots.splitlines():
-                head = re.match(r"^User-agent:\s*(.+?)\s*$", line, re.I)
-                if head:
-                    agent = head.group(1).strip()
-                elif re.match(r"^Disallow:\s*/\s*$", line, re.I) and agent:
-                    if agent in AI_AGENTS:
-                        blocks.append(agent)
+            blocks = [t for t in RETRIEVAL_AGENTS if robots_blocks(robots, t)]
             if blocks:
                 findings.append(Finding(
                     "B050", SEVERITY_ERROR, path, 0,
-                    f"channels.md declares AI search a target while "
-                    f"{', '.join(blocks)} is blocked here -- content quality "
-                    f"is irrelevant to a crawler that never arrives",
+                    f"channels.md declares AI search a target while the "
+                    f"retrieval agent(s) {', '.join(blocks)} are blocked here. "
+                    f"An answer engine cannot cite a page it may not fetch. "
+                    f"Training crawlers ({', '.join(TRAINING_AGENTS)}) are a "
+                    f"separate decision and are not judged here",
                 ))
 
     records = surfaces(brand_dir)