super-ux 0.59.2 → 0.59.3

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## 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 —

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/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.2",
+  "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")
 
@@ -2574,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)
@@ -2584,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 |
 |---|-------|------------|------------|---------------|------|-------------|
 -->