super-ux 0.59.1 → 0.59.3

package/CHANGELOG.md

@@ -1,3 +1,37 @@
+## 0.59.3 — accountable journeys and explicit copy inputs
+
+- Journeys record an Owner, with `unknown` supported. `U086` advises migration
+  for missing/blank/duplicate owners without assigning anyone automatically.
+- Marketing writing uses a current `copy-brief.md` with success metric,
+  constraints and a reference to the voice pair alongside the original inputs.
+  `B074` advises existing packs; `B075` checks present records. Unresolved values
+  remain `unknown`; unrelated tasks do not load a brief.
+- Seeds and every per-skill contract copy are synchronized. Discovery descriptions
+  are unchanged. No installation or provider operation was performed.
+- CI uses nightly runs and deliberate ready-for-review promotion, preserving jobs.
+  [FW05 source receipt](docs/evidence/runs/2026-10-13-fw05-journey-copy.md).
+
+## 0.59.2 — brand-lint names the line, and a release refuses a lightweight tag
+
+- **`B022` reports the line.** An unregistered literal was reported at line 0 —
+  `B022 bin/super-ux.js:0` for a string on line 303 — so the finding named a file
+  and left the search to the reader. Code literals now carry the line their first
+  character is on (template-literal paragraphs included), HTML controls the line
+  they open on. The comment scanner keeps a block comment's newlines so a stripped
+  comment cannot shift the count. Fixture `b022_line_cases` in
+  `test/brand_lint_test.py`; three plants (line 0 back, comment newlines dropped,
+  HTML line pinned) each turned it red.
+- **The probe string that fired it is retired, not registered.** `claude --version`
+  in `bin/super-ux.js` was the `command` field of the typed result returned when the
+  claude CLI is absent; nothing prints it. B022's doctrine is "agree it or retire
+  it", and a row in `strings.md` would register as interface copy a string no
+  reader sees, so the field is now derived from the probe's own argv, the way
+  `run()` derives every other `command`. `python3 docs/brand/lint.py` is clean.
+- **The release refuses a lightweight tag.** A step right after checkout in
+  `release.yml` fails unless `git cat-file -t <tag>` is `tag`. `git describe` and
+  `git submodule status` see annotated tags only; v0.59.1 was cut lightweight and
+  the hub read super-ux as its previous release.
+
 ## 0.59.1 — inventories and audits work without delegation
 
 Brand inventory, scenario inventory and UX audit now use the same areas, batches

package/README.md

@@ -161,7 +161,7 @@ Commands: `/brand` (status → one recommended action), `/brand-init`,
 python3 docs/brand/lint.py
 ```
 
-46 deterministic checks (`B001`..`B073`): banned words, one action under two names, a figure
+48 deterministic checks (`B001`..`B073`): banned words, one action under two names, a figure
 with no sourced fact, a field over its limit with the locale coefficient
 applied, blocked AI crawlers, keyword stuffing, humor on a billing screen,
 a rhetorical dash, a title that ends in a full stop, a locale that lags

package/bin/super-ux.js

@@ -294,13 +294,17 @@ function printUpdateLine() {
 
 function installClaudePlugin() {
   console.log(`\n--- Claude Code plugin ---`);
-  const probe = spawnSync('claude', ['--version'], { stdio: 'ignore' });
+  // The probe's argv is the one source of its `command`, exactly as run()
+  // derives it: the typed result carries it, nothing prints it, so it is not
+  // interface copy and gets no strings.md row (brand-lint B022, retired).
+  const probeArgv = ['claude', '--version'];
+  const probe = spawnSync(probeArgv[0], probeArgv.slice(1), { stdio: 'ignore' });
   if (probe.error && probe.error.code === 'ENOENT') {
     console.log(`claude CLI not found. Run inside Claude Code instead:
   /plugin marketplace add ${REPO}
   /plugin install super-ux@super-ux`);
     return { status: 'unsupported', code: null, signal: null,
-             command: 'claude --version' };
+             command: probeArgv.join(' ') };
   }
   if (run('claude', ['plugin', 'marketplace', 'add', REPO]).status !== 'ok') {
     console.log('(marketplace may already be added, continuing)');

package/cursor/rules/copywriting.mdc

@@ -21,6 +21,10 @@ locale policy. Missing terms or facts are reported, never invented. This pass
 owns product text and `strings.md` rows (`Status: proposed`); claim coordinated
 files before editing. A file living in `docs/brand/` does not forbid the edit.
 
+For marketing writing only, use the copywriting skill’s `marketing-copy.md`
+→ Before writing contract for the current brief; keep unknown inputs explicit.
+Other tasks do not load this brief.
+
 ## Rules that hold in every voice
 
 - **No decorative full stop in headings or labels**, even when inline markup

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "super-ux",
-  "version": "0.59.1",
+  "version": "0.59.3",
   "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

@@ -81,7 +81,7 @@ STRING_KINDS = ("copy", "layout")
 
 SEVERITY_ERROR = "error"
 SEVERITY_WARN = "warn"
-WARNING_CODES = set("B003 B005 B007 B022 B025 B026 B031 B043 B044 B045 B046 B051 B053 B054 B060 B063 B064 B066 B071 B072".split())
+WARNING_CODES = set("B003 B005 B007 B022 B025 B026 B031 B043 B044 B045 B046 B051 B053 B054 B060 B063 B064 B066 B071 B072 B074".split())
 
 Finding = namedtuple("Finding", "code severity path line message")
 
@@ -560,16 +560,38 @@ def code_literals(text: str) -> list[str]:
     Comments must already be stripped by the caller -- `_strip_comments` leaves
     literals untouched, which is what makes both patterns below safe to run.
     """
-    out: list[str] = [lit for _quote, lit in LITERAL_RE.findall(text)]
-    for block in TEMPLATE_RE.findall(text):
+    return [lit for lit, _line in code_literals_at(text)]
+
+
+def code_literals_at(text: str) -> list[tuple[str, int]]:
+    """`code_literals`, each with the 1-based line its first character is on.
+
+    B022 reported every unregistered literal at line 0 -- `bin/super-ux.js:0`
+    for a string on line 303 -- so the finding named a file and left the reader
+    to search it. The line is counted in the comment-stripped text, which
+    `_strip_comments` keeps line-for-line with the source (a block comment
+    leaves its newlines behind), so the number is the source's own.
+    """
+    def line_at(offset: int) -> int:
+        return text.count("\n", 0, offset) + 1
+
+    out: list[tuple[str, int]] = [
+        (m.group(2), line_at(m.start(2))) for m in LITERAL_RE.finditer(text)
+    ]
+    for m in TEMPLATE_RE.finditer(text):
+        block = m.group(1)
         if "\n" not in block:
             continue          # single-line backticks are already in `out`
+        cursor = 0
         for para in re.split(r"\n\s*\n", block):
+            at = block.find(para, cursor)
+            cursor = at + len(para)
             joined = " ".join(
                 line.strip() for line in para.splitlines() if line.strip()
             )
             if len(joined) >= 3:
-                out.append(joined)
+                lead = len(para) - len(para.lstrip())
+                out.append((joined, line_at(m.start(1) + at + lead)))
     return out
 
 # A template literal's interpolations split it into pieces, and the pieces are
@@ -742,10 +764,13 @@ def check_consistency(brand_dir: Path, sources: dict) -> list[Finding]:
         body = read(target) or ""
         html = html_copy(body) if target.suffix.lower() in HTML_SUFFIXES else None
         source_copy = " ".join(html.blocks) if html is not None else body
-        literals = html.interface_texts if html is not None else [
-            lit for lit in code_literals(_strip_comments(body, target.suffix))
-            if _looks_like_copy(lit)
-        ]
+        located = list(zip(html.interface_texts, html.interface_lines)) \
+            if html is not None else [
+                (lit, line) for lit, line
+                in code_literals_at(_strip_comments(body, target.suffix))
+                if _looks_like_copy(lit)
+            ]
+        literals = [lit for lit, _line in located]
         if literals or html is not None:
             # The registry records what a reader sees, so the built page is the
             # authority whenever there is one. Source is the fallback and stays
@@ -781,10 +806,13 @@ def check_consistency(brand_dir: Path, sources: dict) -> list[Finding]:
                 swept.add(file_part)
                 known = {r["text"] for r in rows}
                 trimmed = {t.strip() for t in known}
-                for lit in dict.fromkeys(literals):   # one report per literal
+                first_line: dict[str, int] = {}
+                for lit, line in located:     # one report per literal, at its first line
+                    first_line.setdefault(lit, line)
+                for lit, line in first_line.items():
                     if lit not in known and lit.strip() not in trimmed:
                         findings.append(Finding(
-                            "B022", SEVERITY_WARN, f"{file_part}", 0,
+                            "B022", SEVERITY_WARN, f"{file_part}", line,
                             f"\"{lit}\" is in the code with no registry row -- "
                             f"agree it or retire it",
                         ))
@@ -927,6 +955,7 @@ class HTMLCopy(HTMLParser):
         self.last_anchor_end = None
         self.controls = []
         self.interface_texts = []
+        self.interface_lines = []   # parallel to interface_texts: the control's opening line
 
     @property
     def blocked(self):
@@ -939,7 +968,7 @@ class HTMLCopy(HTMLParser):
                       attrs.get("style", ""), re.I))
         if not hidden:
             if tag in self.CONTROLS or attrs.get("role", "").lower() in self.INTERFACE_ROLES:
-                self.controls.append((tag, len(self.stack), []))
+                self.controls.append((tag, len(self.stack), [], self.getpos()[0]))
             if tag == "br" or tag in self.BLOCK or re.fullmatch(r"h[1-6]", tag):
                 for control in self.controls:
                     control[2].append(" ")
@@ -978,6 +1007,7 @@ class HTMLCopy(HTMLParser):
                 text = " ".join("".join(control[2]).split())
                 if text:
                     self.interface_texts.append(text)
+                    self.interface_lines.append(control[3])
                 self.controls.remove(control)
         if tag == "a" and not self.blocked:
             self.last_anchor_end = len(self.parts)
@@ -1106,7 +1136,12 @@ def _strip_comments(text: str, suffix: str) -> str:
             continue
         if not hashed and text.startswith("/*", i):
             end = text.find("*/", i + 2)
-            i = n if end == -1 else end + 2
+            stop = n if end == -1 else end + 2
+            # Keep the comment's newlines: B022 reports a literal by its line
+            # in THIS text, so a stripped multi-line comment must not shift
+            # every line after it.
+            out.append("\n" * text.count("\n", i, stop))
+            i = stop
             continue
         out.append(ch)
         i += 1
@@ -2539,6 +2574,45 @@ def apply_fixes(brand_dir: Path, findings: list[Finding]) -> int:
     return rewritten
 
 
+COPY_BRIEF_FIELDS = ("Surface", "Action", "Reader", "Customer words", "Proof",
+                     "Success metric", "Constraints", "Voice reference")
+
+
+def check_copy_brief(brand_dir: Path, sources: dict) -> list[Finding]:
+    """B074/B075: one current marketing brief, with explicit unknowns permitted."""
+    path = brand_dir / "copy-brief.md"
+    if not path.exists():
+        return [Finding("B074", SEVERITY_WARN, "copy-brief.md", 0,
+                        "marketing sources have no current copy brief; seed one "
+                        "before the next writing task, retaining unknown inputs")] if sources.get("marketing") else []
+    text = read(path)
+    if text is None:
+        return [Finding("B075", SEVERITY_ERROR, "copy-brief.md", 0,
+                        "current copy brief cannot be read")]
+    text = re.sub(r"<!--.*?-->", "", text, flags=re.S)
+    fields = {}
+    findings = []
+    for field in COPY_BRIEF_FIELDS:
+        values = re.findall(rf"(?m)^{re.escape(field)}:[ \t]*(.*)$", text)
+        if len(values) != 1 or unfilled(values[0]):
+            findings.append(Finding("B075", SEVERITY_ERROR, "copy-brief.md", 0,
+                                    f"needs one nonempty {field}: value; use unknown for an unresolved input"))
+        else:
+            fields[field] = values[0].strip()
+    ref = fields.get("Voice reference", "unknown")
+    if ref.lower() != "unknown":
+        voice = re.sub(r"<!--.*?-->", "", read(brand_dir / "voice.md") or "", flags=re.S)
+        section = re.search(r"(?ms)^## Voice references[ \t]*\n(.*?)(?=^## |\Z)", voice)
+        pair = [re.search(rf"(?m)^[ \t]*(?:-[ \t]*)?\*\*{field}:\*\*[ \t]*(.*)$", section[1] if section else "")
+                for field in ("Admired", "Refused")]
+        if (ref != "voice.md#voice-references" or not section
+                or any(not m or unfilled(m[1]) or m[1].strip().lower() == "unknown" for m in pair)):
+            findings.append(Finding("B075", SEVERITY_ERROR, "copy-brief.md", 0,
+                                    "Voice reference must be unknown or voice.md#voice-references "
+                                    "with a filled Admired/Refused pair in voice.md"))
+    return findings
+
+
 def run(brand_dir: Path, fix: bool = False) -> list[Finding]:
     """Every check, in order. `fix` is applied by the caller via apply_fixes."""
     sources = load_sources(brand_dir)
@@ -2549,6 +2623,7 @@ def run(brand_dir: Path, fix: bool = False) -> list[Finding]:
     findings.extend(check_consistency(brand_dir, sources))
     findings.extend(check_facts(brand_dir, sources))
     findings.extend(check_channels(brand_dir, sources))
+    findings.extend(check_copy_brief(brand_dir, sources))
     findings.extend(check_short_video(brand_dir, sources))
     findings.extend(check_bot_safety(brand_dir, sources))
     findings.extend(check_ai_tells(brand_dir, sources))

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

@@ -735,6 +735,16 @@ def check_jobs(foundation: str, scenarios: str = "", flows: str = "",
                     f"{', '.join(JOB_FIELDS)}")
 
 
+def check_journey_owners(foundation: str) -> None:
+    """U086: absence is migration advice; unknown is an explicit unassigned owner."""
+    for sid, body in sorted(entry_blocks(foundation, "JRN").items()):
+        owners = re.findall(r"(?m)^[ \t]*(?:-[ \t]*)?\*\*Owner:\*\*[ \t]*(.*)$", body)
+        if len(owners) != 1 or _unfilled(owners[0]):
+            warn(f"[U086] foundation.md: {sid} needs one **Owner:** value — "
+                 "name the accountable role/person or write unknown; "
+                 "do not invent an assignment")
+
+
 WEB_SURFACE_FIELDS = ("Route", "Answers", "Indexable", "Without JS", "Entity")
 
 
@@ -1251,6 +1261,7 @@ def main() -> int:
     check_field_vocabulary(scenarios, foundation)
     check_status_enums(scenarios, foundation, screens, flows, vision)
     check_jobs(foundation, scenarios, flows, screens)
+    check_journey_owners(foundation)
     check_vision(ux, vision)
     check_web_surface(screens, flows)
     check_onboarding(flows, ux, project_root)

package/templates/brand/README.md

@@ -15,6 +15,7 @@ Owned by the `brand-voice` skill. Written by `copywriting`. Checked by
 | `terminology.md` | our words, banned words, entity and tier names |
 | `facts.md` | canonical numbers and proof — the only source of a figure |
 | `channels.md` | one record per surface: register, limits, bans |
+| `copy-brief.md` | current marketing task inputs; unknowns stay explicit |
 | `strings.md` | interface string registry → `file:line` → scenario |
 | `locales/<code>.md` | per-locale delta |
 

package/templates/brand/copy-brief.md

@@ -0,0 +1,10 @@
+Contract: brand-contract v1
+
+Surface: unknown
+Action: unknown
+Reader: unknown
+Customer words: unknown
+Proof: unknown
+Success metric: unknown
+Constraints: unknown
+Voice reference: unknown

package/templates/foundation.md

@@ -23,6 +23,7 @@ data/observation, recognizable by a real user. -->
 ## Customer journeys
 
 <!-- ### JRN-01: <persona> — <job> (JTBD-01)
+- **Owner:** unknown
 | # | Stage | User action | Touchpoint | Emotion (1-5) | Pain | Opportunity |
 |---|-------|------------|------------|---------------|------|-------------|
 -->