qapture2 0.7.6 → 0.7.7

package/dist/{chunk-NM3IDVEL.js → chunk-FVQKCQC3.js}

@@ -1755,10 +1755,10 @@ var STR = {
     copied: "Copied",
     copy_failed: "Copy failed",
     copy_prompt: "Copy as agent prompt",
-    severity_label: "Severity",
+    severity_label: "What is this?",
     sev_bug: "Bug",
-    sev_question: "Question",
-    sev_polish: "Polish",
+    sev_design: "Design",
+    sev_enhance: "Enhance",
     status_open: "Open",
     status_verified: "Verified",
     context_attached: "{n} runtime events attached",
@@ -1953,10 +1953,10 @@ var STR = {
     copied: "\u062A\u0645 \u0627\u0644\u0646\u0633\u062E",
     copy_failed: "\u0641\u0634\u0644 \u0627\u0644\u0646\u0633\u062E",
     copy_prompt: "\u0646\u0633\u062E \u0643\u0645\u0648\u062C\u0651\u0647 \u0644\u0644\u0648\u0643\u064A\u0644",
-    severity_label: "\u0627\u0644\u0623\u0647\u0645\u064A\u0629",
-    sev_bug: "\u062E\u0644\u0644",
-    sev_question: "\u0633\u0624\u0627\u0644",
-    sev_polish: "\u062A\u062D\u0633\u064A\u0646",
+    severity_label: "\u0645\u0627 \u0647\u0630\u0627\u061F",
+    sev_bug: "Bug",
+    sev_design: "Design",
+    sev_enhance: "Enhance",
     status_open: "\u0645\u0641\u062A\u0648\u062D",
     status_verified: "\u062A\u0645 \u0627\u0644\u062A\u062D\u0642\u0642",
     context_attached: "{n} \u0645\u0646 \u0623\u062D\u062F\u0627\u062B \u0627\u0644\u062A\u0634\u063A\u064A\u0644 \u0645\u0631\u0641\u0642\u0629",
@@ -3277,15 +3277,15 @@ function fmtPct(n, d) {
 }
 function summariseSession(notes, stamp) {
   if (!notes.length) return "No points captured.";
-  let bugs = 0, questions = 0, polish = 0, verified = 0, awaiting = 0;
+  let bugs = 0, enhancements = 0, designs = 0, verified = 0, awaiting = 0;
   const pages = /* @__PURE__ */ new Set();
   let earliest = Number.POSITIVE_INFINITY;
   let latest = 0;
   for (const n of notes) {
     const sev = n.severity ?? "bug";
     if (sev === "bug") bugs++;
-    else if (sev === "question") questions++;
-    else polish++;
+    else if (sev === "enhance") enhancements++;
+    else designs++;
     const status = n.status ?? "open";
     if (status === "verified") verified++;
     else if (status === "fixed") awaiting++;
@@ -3300,8 +3300,8 @@ function summariseSession(notes, stamp) {
     `${notes.length} point${notes.length === 1 ? "" : "s"}`,
     `${bugs} bug${bugs === 1 ? "" : "s"}`
   ];
-  if (questions) parts.push(`${questions} question${questions === 1 ? "" : "s"}`);
-  if (polish) parts.push(`${polish} polish`);
+  if (enhancements) parts.push(`${enhancements} enhancement${enhancements === 1 ? "" : "s"}`);
+  if (designs) parts.push(`${designs} design`);
   if (verified) parts.push(`${verified} verified`);
   if (awaiting) parts.push(`${awaiting} awaiting re-test`);
   parts.push(`${pages.size} page${pages.size === 1 ? "" : "s"}`);
@@ -3332,6 +3332,37 @@ Exported: ${stamp}
 Points: ${noteCount}
 
 **Session:** ${summariseSession(notes, stamp)}`
+  );
+  sections.push(
+    `## What the tags mean
+
+Every point below is tagged **Bug**, **Design** or **Enhance**. These are not priorities \u2014 they are three different kinds of work. Read the tag before you decide what to do.
+
+### Bug \u2014 something is broken
+
+Find the **root cause**, not the symptom. Do not patch over it.
+
+State the cause in one plain sentence before you change anything \u2014 e.g. "the date was wrong because the server sends UTC and the list formats in local time". **If you cannot write that sentence, you have not found the cause yet.** Keep looking. The real cause is often something small and silly; that is normal, and it is still the cause.
+
+**The cause is not always in the code.** If the code does exactly what it was asked to do and the result is still wrong, then nothing is broken \u2014 what was *asked for* and what was *meant* did not match. That mismatch is the bug. Realign to what the owner meant and fix it there. If the note already says what they meant ("this isn't what I wanted, I wanted X"), they have told you \u2014 just do X. Do not stop to ask a question they have already answered.
+
+### Design \u2014 it works, but it looks or feels wrong
+
+The functionality is fine and is not in question. Do not go hunting for a fault; there isn't one. Think properly about the interface and the experience \u2014 layout, spacing, hierarchy, wording, states, what the person is actually trying to do \u2014 and change how it looks and feels.
+
+### Enhance \u2014 a new idea, thought of while using the app
+
+The tester wants something added or changed: a new section, a new feature, a different way of doing it.
+
+**Plan it before you build it.** Read the surrounding code, work out what it touches and what it might break, and choose an approach that fits how the app is already built. Then build it. You do not need to stop and ask for approval \u2014 plan well, then go.
+
+Push back only when you have a real reason: it would break something, or it conflicts with an invariant below. Then say so plainly and propose the alternative you would build instead.
+
+### When the tag and the words disagree
+
+The tag sets your starting posture; **the words win.** A point tagged Design that says "this crashes" is a bug \u2014 treat it as one, and mention that you changed lane. People pick the wrong chip all the time; that is not a reason to do the wrong work.
+
+And if a point is phrased as a question rather than a report, **answer it \u2014 do not change code on a maybe.**`
   );
   const stack = typeof p.stack === "string" && p.stack.trim() ? p.stack.trim() : "(not provided)";
   const runArr = toStrings(p.runCommands);
@@ -3927,12 +3958,12 @@ function campaignJsonText(allNotes) {
 function reportMarkdownText(allNotes) {
   if (!campaign) return "";
   const ordered = orderedKnownNotes(allNotes);
-  const counts = { bug: 0, question: 0, polish: 0, verified: 0 };
+  const counts = { bug: 0, design: 0, enhance: 0, verified: 0 };
   for (const n of ordered) {
     const sev = n.severity ?? "bug";
     if (sev === "bug") counts.bug++;
-    else if (sev === "question") counts.question++;
-    else counts.polish++;
+    else if (sev === "enhance") counts.enhance++;
+    else counts.design++;
     if (n.status === "verified") counts.verified++;
   }
   const header = [
@@ -3941,7 +3972,7 @@ function reportMarkdownText(allNotes) {
     campaign.tester ? `Tester: ${campaign.tester}  ` : "",
     `Started: ${campaign.startedAt}  `,
     `Updated: ${(/* @__PURE__ */ new Date()).toISOString()}  `,
-    `Points: ${ordered.length} (${counts.bug} bug, ${counts.question} question, ${counts.polish} polish \xB7 ${counts.verified} verified)`,
+    `Points: ${ordered.length} (${counts.bug} bug, ${counts.design} design, ${counts.enhance} enhance \xB7 ${counts.verified} verified)`,
     "",
     getFsSyncEngine() === "download" ? "Saved by Qapture as the campaign was tested. Screenshots are in" : "Written live by Qapture as each point was saved. Screenshots are in",
     "`screenshots/`, one Markdown file per point in `notes/`.",
@@ -4293,6 +4324,12 @@ function QaProvider({
         for (const id of pendingIds) void idb.delete(id);
         storage.setJSON(PENDING_DELETE_KEY, []);
       }
+      live = live.map((n) => {
+        const legacy = n.severity;
+        if (legacy === "question") return { ...n, severity: "enhance" };
+        if (legacy === "polish") return { ...n, severity: "design" };
+        return n;
+      });
       const sorted = live.slice().sort(
         (a, b) => a.timestamp < b.timestamp ? 1 : -1
       );
@@ -4891,8 +4928,8 @@ function QaProvider({
     const counts = {
       all: notes.length,
       bug: 0,
-      question: 0,
-      polish: 0,
+      design: 0,
+      enhance: 0,
       open: 0,
       fixed: 0,
       verified: 0,
@@ -4901,8 +4938,8 @@ function QaProvider({
     for (const n of notes) {
       const sev = n.severity ?? "bug";
       if (sev === "bug") counts.bug++;
-      else if (sev === "question") counts.question++;
-      else counts.polish++;
+      else if (sev === "enhance") counts.enhance++;
+      else counts.design++;
       const status = n.status ?? "open";
       if (status === "verified") counts.verified++;
       else if (status === "fixed") counts.fixed++;
@@ -5291,7 +5328,11 @@ function QaProvider({
     pendingShare,
     sharePending,
     retestNote,
-    showWelcome,
+    // The greeting explains how to capture. Once a note exists, the tester has
+    // either done it or found their own way, so the line has nothing left to
+    // say — take it away rather than making them dismiss it. (The stored flag
+    // still governs a first visit; this only hides it early.)
+    showWelcome: showWelcome && notes.length === 0,
     dismissWelcome,
     // v0.6
     panelSide,
@@ -5744,8 +5785,8 @@ function QaFab() {
 }
 var SEVERITIES = [
   { value: "bug", labelKey: "sev_bug", icon: "Bug" },
-  { value: "question", labelKey: "sev_question" },
-  { value: "polish", labelKey: "sev_polish" }
+  { value: "enhance", labelKey: "sev_enhance" },
+  { value: "design", labelKey: "sev_design" }
 ];
 function SeverityChipRow({
   value,
@@ -6490,13 +6531,13 @@ function KindBadge({
 }
 var SEVERITY_CLASS = {
   bug: "qa-bg-danger-tint qa-text-danger",
-  question: "qa-bg-warn-tint qa-text-warn",
-  polish: "qa-bg-accent-tint qa-text-accent"
+  enhance: "qa-bg-warn-tint qa-text-warn",
+  design: "qa-bg-accent-tint qa-text-accent"
 };
 var SEVERITY_LABEL_KEY = {
   bug: "sev_bug",
-  question: "sev_question",
-  polish: "sev_polish"
+  enhance: "sev_enhance",
+  design: "sev_design"
 };
 function SeverityChip({ severity, t }) {
   return /* @__PURE__ */ jsxs(
@@ -6601,7 +6642,7 @@ function NoteItem({
       notify(t("copy_failed"), { tone: "error" });
     }
   };
-  const severityDot = severity === "bug" ? "var(--qa-danger)" : severity === "question" ? "var(--qa-warn)" : "var(--qa-accent)";
+  const severityDot = severity === "bug" ? "var(--qa-danger)" : severity === "enhance" ? "var(--qa-warn)" : "var(--qa-accent)";
   if (dense && !open && !editing) {
     return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs(
       "button",
@@ -7144,22 +7185,22 @@ function NoteFilterBar() {
       onClick: sev("bug")
     },
     {
-      key: "question",
-      label: t("sev_question"),
-      count: noteCounts.question,
-      active: filter.severity === "question",
-      icon: "AlertTriangle",
+      key: "enhance",
+      label: t("sev_enhance"),
+      count: noteCounts.enhance,
+      active: filter.severity === "enhance",
+      icon: "Plus",
       tone: "warn",
-      onClick: sev("question")
+      onClick: sev("enhance")
     },
     {
-      key: "polish",
-      label: t("sev_polish"),
-      count: noteCounts.polish,
-      active: filter.severity === "polish",
+      key: "design",
+      label: t("sev_design"),
+      count: noteCounts.design,
+      active: filter.severity === "design",
       icon: "Pencil",
       tone: "accent",
-      onClick: sev("polish")
+      onClick: sev("design")
     },
     {
       key: "open",
@@ -7598,46 +7639,25 @@ function SettingsSheet({ onClose }) {
   );
 }
 function WelcomeCard() {
-  const { t, brand, dismissWelcome } = useQa();
+  const { t, dismissWelcome } = useQa();
   return /* @__PURE__ */ jsxs(
     "div",
     {
-      className: "qa-rounded-xl qa-border qa-border-subtle qa-bg-1 qa-p-3 qa-space-y-2",
+      className: "qa-flex qa-items-center qa-gap-2 qa-rounded-xl qa-border qa-border-subtle qa-bg-1 qa-px-3 qa-py-2",
       role: "note",
       children: [
-        /* @__PURE__ */ jsxs("p", { className: "qa-m-0 qa-flex qa-items-center qa-gap-1.5 qa-text-sm qa-font-semibold qa-text-hi", children: [
-          /* @__PURE__ */ jsx(
-            "span",
-            {
-              "aria-hidden": "true",
-              className: "qa-shrink-0",
-              style: { width: 6, height: 6, background: "var(--qa-accent)" }
-            }
-          ),
-          t("welcome_title", { brand: brand.label })
-        ] }),
-        /* @__PURE__ */ jsxs("ul", { className: "qa-m-0 qa-space-y-1 qa-text-xs qa-text-mid", children: [
-          /* @__PURE__ */ jsxs("li", { className: "qa-flex qa-items-start qa-gap-1.5", children: [
-            /* @__PURE__ */ jsx(Icon, { name: "Crosshair", size: 12, className: "qa-shrink-0 qa-mt-1" }),
-            /* @__PURE__ */ jsx("span", { children: t("welcome_capture") })
-          ] }),
-          /* @__PURE__ */ jsxs("li", { className: "qa-flex qa-items-start qa-gap-1.5", children: [
-            /* @__PURE__ */ jsx(Icon, { name: "Pencil", size: 12, className: "qa-shrink-0 qa-mt-1" }),
-            /* @__PURE__ */ jsx("span", { children: t("welcome_say") })
-          ] }),
-          /* @__PURE__ */ jsxs("li", { className: "qa-flex qa-items-start qa-gap-1.5", children: [
-            /* @__PURE__ */ jsx(Icon, { name: "CheckCircle2", size: 12, className: "qa-shrink-0 qa-mt-1" }),
-            /* @__PURE__ */ jsx("span", { children: t("welcome_safe") })
-          ] })
-        ] }),
+        /* @__PURE__ */ jsx(Icon, { name: "Crosshair", size: 13, className: "qa-shrink-0 qa-text-accent" }),
+        /* @__PURE__ */ jsx("span", { className: "qa-flex-1 qa-text-xs qa-text-mid", children: t("welcome_capture") }),
         /* @__PURE__ */ jsx(
           "button",
           {
             type: "button",
             onClick: dismissWelcome,
-            className: "qa-tap qa-w-full qa-rounded-lg qa-bg-accent qa-px-3 qa-py-1.5 qa-text-xs qa-font-semibold",
-            style: { border: "none", cursor: "pointer" },
-            children: t("welcome_got_it")
+            "aria-label": t("welcome_got_it"),
+            title: t("welcome_got_it"),
+            className: "qa-tap-icon qa-shrink-0 qa-rounded-full qa-text-mid qa-focus-ring",
+            style: { background: "transparent", border: "none", cursor: "pointer", padding: 2 },
+            children: /* @__PURE__ */ jsx(Icon, { name: "X", size: 13 })
           }
         )
       ]
@@ -9104,16 +9124,16 @@ function unlockPageScroll() {
 var DRAG_THRESHOLD2 = 6;
 var TOUCH_DRAG_THRESHOLD = 12;
 var MIN_REGION_SIZE = 8;
-var SEVERITIES2 = ["bug", "question", "polish"];
+var SEVERITIES2 = ["bug", "design", "enhance"];
 var SEVERITY_ICON = {
   bug: "Bug",
-  question: "AlertTriangle",
-  polish: "Pencil"
+  design: "Pencil",
+  enhance: "Plus"
 };
 var SEVERITY_LABEL_KEY2 = {
   bug: "sev_bug",
-  question: "sev_question",
-  polish: "sev_polish"
+  design: "sev_design",
+  enhance: "sev_enhance"
 };
 function clampRegionRect(rect) {
   const vw = typeof window !== "undefined" ? window.innerWidth : rect.left + rect.width;
@@ -10067,7 +10087,7 @@ function CaptureMode() {
                   /* @__PURE__ */ jsx("span", { className: "qa-text-11 qa-text-mid qa-me-1", children: t("severity_label") }),
                   SEVERITIES2.map((sev) => {
                     const active = severity === sev;
-                    const toneClass = sev === "bug" ? "qa-bg-danger-tint qa-text-danger" : sev === "question" ? "qa-bg-warn-tint qa-text-warn" : "qa-bg-accent-tint qa-text-accent";
+                    const toneClass = sev === "bug" ? "qa-bg-danger-tint qa-text-danger" : sev === "enhance" ? "qa-bg-warn-tint qa-text-warn" : "qa-bg-accent-tint qa-text-accent";
                     return /* @__PURE__ */ jsxs(
                       "button",
                       {
@@ -10345,5 +10365,5 @@ function Qapture({ config }) {
 }
 
 export { Qapture, deleteQaDatabase, initQaStudio };
-//# sourceMappingURL=chunk-NM3IDVEL.js.map
-//# sourceMappingURL=chunk-NM3IDVEL.js.map
+//# sourceMappingURL=chunk-FVQKCQC3.js.map
+//# sourceMappingURL=chunk-FVQKCQC3.js.map

package/dist/{chunk-CNNNWLTX.cjs → chunk-WU7QMHPK.cjs}

@@ -1762,10 +1762,10 @@ var STR = {
     copied: "Copied",
     copy_failed: "Copy failed",
     copy_prompt: "Copy as agent prompt",
-    severity_label: "Severity",
+    severity_label: "What is this?",
     sev_bug: "Bug",
-    sev_question: "Question",
-    sev_polish: "Polish",
+    sev_design: "Design",
+    sev_enhance: "Enhance",
     status_open: "Open",
     status_verified: "Verified",
     context_attached: "{n} runtime events attached",
@@ -1960,10 +1960,10 @@ var STR = {
     copied: "\u062A\u0645 \u0627\u0644\u0646\u0633\u062E",
     copy_failed: "\u0641\u0634\u0644 \u0627\u0644\u0646\u0633\u062E",
     copy_prompt: "\u0646\u0633\u062E \u0643\u0645\u0648\u062C\u0651\u0647 \u0644\u0644\u0648\u0643\u064A\u0644",
-    severity_label: "\u0627\u0644\u0623\u0647\u0645\u064A\u0629",
-    sev_bug: "\u062E\u0644\u0644",
-    sev_question: "\u0633\u0624\u0627\u0644",
-    sev_polish: "\u062A\u062D\u0633\u064A\u0646",
+    severity_label: "\u0645\u0627 \u0647\u0630\u0627\u061F",
+    sev_bug: "Bug",
+    sev_design: "Design",
+    sev_enhance: "Enhance",
     status_open: "\u0645\u0641\u062A\u0648\u062D",
     status_verified: "\u062A\u0645 \u0627\u0644\u062A\u062D\u0642\u0642",
     context_attached: "{n} \u0645\u0646 \u0623\u062D\u062F\u0627\u062B \u0627\u0644\u062A\u0634\u063A\u064A\u0644 \u0645\u0631\u0641\u0642\u0629",
@@ -3284,15 +3284,15 @@ function fmtPct(n, d) {
 }
 function summariseSession(notes, stamp) {
   if (!notes.length) return "No points captured.";
-  let bugs = 0, questions = 0, polish = 0, verified = 0, awaiting = 0;
+  let bugs = 0, enhancements = 0, designs = 0, verified = 0, awaiting = 0;
   const pages = /* @__PURE__ */ new Set();
   let earliest = Number.POSITIVE_INFINITY;
   let latest = 0;
   for (const n of notes) {
     const sev = n.severity ?? "bug";
     if (sev === "bug") bugs++;
-    else if (sev === "question") questions++;
-    else polish++;
+    else if (sev === "enhance") enhancements++;
+    else designs++;
     const status = n.status ?? "open";
     if (status === "verified") verified++;
     else if (status === "fixed") awaiting++;
@@ -3307,8 +3307,8 @@ function summariseSession(notes, stamp) {
     `${notes.length} point${notes.length === 1 ? "" : "s"}`,
     `${bugs} bug${bugs === 1 ? "" : "s"}`
   ];
-  if (questions) parts.push(`${questions} question${questions === 1 ? "" : "s"}`);
-  if (polish) parts.push(`${polish} polish`);
+  if (enhancements) parts.push(`${enhancements} enhancement${enhancements === 1 ? "" : "s"}`);
+  if (designs) parts.push(`${designs} design`);
   if (verified) parts.push(`${verified} verified`);
   if (awaiting) parts.push(`${awaiting} awaiting re-test`);
   parts.push(`${pages.size} page${pages.size === 1 ? "" : "s"}`);
@@ -3339,6 +3339,37 @@ Exported: ${stamp}
 Points: ${noteCount}
 
 **Session:** ${summariseSession(notes, stamp)}`
+  );
+  sections.push(
+    `## What the tags mean
+
+Every point below is tagged **Bug**, **Design** or **Enhance**. These are not priorities \u2014 they are three different kinds of work. Read the tag before you decide what to do.
+
+### Bug \u2014 something is broken
+
+Find the **root cause**, not the symptom. Do not patch over it.
+
+State the cause in one plain sentence before you change anything \u2014 e.g. "the date was wrong because the server sends UTC and the list formats in local time". **If you cannot write that sentence, you have not found the cause yet.** Keep looking. The real cause is often something small and silly; that is normal, and it is still the cause.
+
+**The cause is not always in the code.** If the code does exactly what it was asked to do and the result is still wrong, then nothing is broken \u2014 what was *asked for* and what was *meant* did not match. That mismatch is the bug. Realign to what the owner meant and fix it there. If the note already says what they meant ("this isn't what I wanted, I wanted X"), they have told you \u2014 just do X. Do not stop to ask a question they have already answered.
+
+### Design \u2014 it works, but it looks or feels wrong
+
+The functionality is fine and is not in question. Do not go hunting for a fault; there isn't one. Think properly about the interface and the experience \u2014 layout, spacing, hierarchy, wording, states, what the person is actually trying to do \u2014 and change how it looks and feels.
+
+### Enhance \u2014 a new idea, thought of while using the app
+
+The tester wants something added or changed: a new section, a new feature, a different way of doing it.
+
+**Plan it before you build it.** Read the surrounding code, work out what it touches and what it might break, and choose an approach that fits how the app is already built. Then build it. You do not need to stop and ask for approval \u2014 plan well, then go.
+
+Push back only when you have a real reason: it would break something, or it conflicts with an invariant below. Then say so plainly and propose the alternative you would build instead.
+
+### When the tag and the words disagree
+
+The tag sets your starting posture; **the words win.** A point tagged Design that says "this crashes" is a bug \u2014 treat it as one, and mention that you changed lane. People pick the wrong chip all the time; that is not a reason to do the wrong work.
+
+And if a point is phrased as a question rather than a report, **answer it \u2014 do not change code on a maybe.**`
   );
   const stack = typeof p.stack === "string" && p.stack.trim() ? p.stack.trim() : "(not provided)";
   const runArr = toStrings(p.runCommands);
@@ -3934,12 +3965,12 @@ function campaignJsonText(allNotes) {
 function reportMarkdownText(allNotes) {
   if (!campaign) return "";
   const ordered = orderedKnownNotes(allNotes);
-  const counts = { bug: 0, question: 0, polish: 0, verified: 0 };
+  const counts = { bug: 0, design: 0, enhance: 0, verified: 0 };
   for (const n of ordered) {
     const sev = n.severity ?? "bug";
     if (sev === "bug") counts.bug++;
-    else if (sev === "question") counts.question++;
-    else counts.polish++;
+    else if (sev === "enhance") counts.enhance++;
+    else counts.design++;
     if (n.status === "verified") counts.verified++;
   }
   const header = [
@@ -3948,7 +3979,7 @@ function reportMarkdownText(allNotes) {
     campaign.tester ? `Tester: ${campaign.tester}  ` : "",
     `Started: ${campaign.startedAt}  `,
     `Updated: ${(/* @__PURE__ */ new Date()).toISOString()}  `,
-    `Points: ${ordered.length} (${counts.bug} bug, ${counts.question} question, ${counts.polish} polish \xB7 ${counts.verified} verified)`,
+    `Points: ${ordered.length} (${counts.bug} bug, ${counts.design} design, ${counts.enhance} enhance \xB7 ${counts.verified} verified)`,
     "",
     getFsSyncEngine() === "download" ? "Saved by Qapture as the campaign was tested. Screenshots are in" : "Written live by Qapture as each point was saved. Screenshots are in",
     "`screenshots/`, one Markdown file per point in `notes/`.",
@@ -4300,6 +4331,12 @@ function QaProvider({
         for (const id of pendingIds) void idb.delete(id);
         storage.setJSON(PENDING_DELETE_KEY, []);
       }
+      live = live.map((n) => {
+        const legacy = n.severity;
+        if (legacy === "question") return { ...n, severity: "enhance" };
+        if (legacy === "polish") return { ...n, severity: "design" };
+        return n;
+      });
       const sorted = live.slice().sort(
         (a, b) => a.timestamp < b.timestamp ? 1 : -1
       );
@@ -4898,8 +4935,8 @@ function QaProvider({
     const counts = {
       all: notes.length,
       bug: 0,
-      question: 0,
-      polish: 0,
+      design: 0,
+      enhance: 0,
       open: 0,
       fixed: 0,
       verified: 0,
@@ -4908,8 +4945,8 @@ function QaProvider({
     for (const n of notes) {
       const sev = n.severity ?? "bug";
       if (sev === "bug") counts.bug++;
-      else if (sev === "question") counts.question++;
-      else counts.polish++;
+      else if (sev === "enhance") counts.enhance++;
+      else counts.design++;
       const status = n.status ?? "open";
       if (status === "verified") counts.verified++;
       else if (status === "fixed") counts.fixed++;
@@ -5298,7 +5335,11 @@ function QaProvider({
     pendingShare,
     sharePending,
     retestNote,
-    showWelcome,
+    // The greeting explains how to capture. Once a note exists, the tester has
+    // either done it or found their own way, so the line has nothing left to
+    // say — take it away rather than making them dismiss it. (The stored flag
+    // still governs a first visit; this only hides it early.)
+    showWelcome: showWelcome && notes.length === 0,
     dismissWelcome,
     // v0.6
     panelSide,
@@ -5751,8 +5792,8 @@ function QaFab() {
 }
 var SEVERITIES = [
   { value: "bug", labelKey: "sev_bug", icon: "Bug" },
-  { value: "question", labelKey: "sev_question" },
-  { value: "polish", labelKey: "sev_polish" }
+  { value: "enhance", labelKey: "sev_enhance" },
+  { value: "design", labelKey: "sev_design" }
 ];
 function SeverityChipRow({
   value,
@@ -6497,13 +6538,13 @@ function KindBadge({
 }
 var SEVERITY_CLASS = {
   bug: "qa-bg-danger-tint qa-text-danger",
-  question: "qa-bg-warn-tint qa-text-warn",
-  polish: "qa-bg-accent-tint qa-text-accent"
+  enhance: "qa-bg-warn-tint qa-text-warn",
+  design: "qa-bg-accent-tint qa-text-accent"
 };
 var SEVERITY_LABEL_KEY = {
   bug: "sev_bug",
-  question: "sev_question",
-  polish: "sev_polish"
+  enhance: "sev_enhance",
+  design: "sev_design"
 };
 function SeverityChip({ severity, t }) {
   return /* @__PURE__ */ jsxRuntime.jsxs(
@@ -6608,7 +6649,7 @@ function NoteItem({
       notify(t("copy_failed"), { tone: "error" });
     }
   };
-  const severityDot = severity === "bug" ? "var(--qa-danger)" : severity === "question" ? "var(--qa-warn)" : "var(--qa-accent)";
+  const severityDot = severity === "bug" ? "var(--qa-danger)" : severity === "enhance" ? "var(--qa-warn)" : "var(--qa-accent)";
   if (dense && !open && !editing) {
     return /* @__PURE__ */ jsxRuntime.jsx("li", { children: /* @__PURE__ */ jsxRuntime.jsxs(
       "button",
@@ -7151,22 +7192,22 @@ function NoteFilterBar() {
       onClick: sev("bug")
     },
     {
-      key: "question",
-      label: t("sev_question"),
-      count: noteCounts.question,
-      active: filter.severity === "question",
-      icon: "AlertTriangle",
+      key: "enhance",
+      label: t("sev_enhance"),
+      count: noteCounts.enhance,
+      active: filter.severity === "enhance",
+      icon: "Plus",
       tone: "warn",
-      onClick: sev("question")
+      onClick: sev("enhance")
     },
     {
-      key: "polish",
-      label: t("sev_polish"),
-      count: noteCounts.polish,
-      active: filter.severity === "polish",
+      key: "design",
+      label: t("sev_design"),
+      count: noteCounts.design,
+      active: filter.severity === "design",
       icon: "Pencil",
       tone: "accent",
-      onClick: sev("polish")
+      onClick: sev("design")
     },
     {
       key: "open",
@@ -7605,46 +7646,25 @@ function SettingsSheet({ onClose }) {
   );
 }
 function WelcomeCard() {
-  const { t, brand, dismissWelcome } = useQa();
+  const { t, dismissWelcome } = useQa();
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
-      className: "qa-rounded-xl qa-border qa-border-subtle qa-bg-1 qa-p-3 qa-space-y-2",
+      className: "qa-flex qa-items-center qa-gap-2 qa-rounded-xl qa-border qa-border-subtle qa-bg-1 qa-px-3 qa-py-2",
       role: "note",
       children: [
-        /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "qa-m-0 qa-flex qa-items-center qa-gap-1.5 qa-text-sm qa-font-semibold qa-text-hi", children: [
-          /* @__PURE__ */ jsxRuntime.jsx(
-            "span",
-            {
-              "aria-hidden": "true",
-              className: "qa-shrink-0",
-              style: { width: 6, height: 6, background: "var(--qa-accent)" }
-            }
-          ),
-          t("welcome_title", { brand: brand.label })
-        ] }),
-        /* @__PURE__ */ jsxRuntime.jsxs("ul", { className: "qa-m-0 qa-space-y-1 qa-text-xs qa-text-mid", children: [
-          /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "qa-flex qa-items-start qa-gap-1.5", children: [
-            /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "Crosshair", size: 12, className: "qa-shrink-0 qa-mt-1" }),
-            /* @__PURE__ */ jsxRuntime.jsx("span", { children: t("welcome_capture") })
-          ] }),
-          /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "qa-flex qa-items-start qa-gap-1.5", children: [
-            /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "Pencil", size: 12, className: "qa-shrink-0 qa-mt-1" }),
-            /* @__PURE__ */ jsxRuntime.jsx("span", { children: t("welcome_say") })
-          ] }),
-          /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "qa-flex qa-items-start qa-gap-1.5", children: [
-            /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "CheckCircle2", size: 12, className: "qa-shrink-0 qa-mt-1" }),
-            /* @__PURE__ */ jsxRuntime.jsx("span", { children: t("welcome_safe") })
-          ] })
-        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "Crosshair", size: 13, className: "qa-shrink-0 qa-text-accent" }),
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "qa-flex-1 qa-text-xs qa-text-mid", children: t("welcome_capture") }),
         /* @__PURE__ */ jsxRuntime.jsx(
           "button",
           {
             type: "button",
             onClick: dismissWelcome,
-            className: "qa-tap qa-w-full qa-rounded-lg qa-bg-accent qa-px-3 qa-py-1.5 qa-text-xs qa-font-semibold",
-            style: { border: "none", cursor: "pointer" },
-            children: t("welcome_got_it")
+            "aria-label": t("welcome_got_it"),
+            title: t("welcome_got_it"),
+            className: "qa-tap-icon qa-shrink-0 qa-rounded-full qa-text-mid qa-focus-ring",
+            style: { background: "transparent", border: "none", cursor: "pointer", padding: 2 },
+            children: /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "X", size: 13 })
           }
         )
       ]
@@ -9111,16 +9131,16 @@ function unlockPageScroll() {
 var DRAG_THRESHOLD2 = 6;
 var TOUCH_DRAG_THRESHOLD = 12;
 var MIN_REGION_SIZE = 8;
-var SEVERITIES2 = ["bug", "question", "polish"];
+var SEVERITIES2 = ["bug", "design", "enhance"];
 var SEVERITY_ICON = {
   bug: "Bug",
-  question: "AlertTriangle",
-  polish: "Pencil"
+  design: "Pencil",
+  enhance: "Plus"
 };
 var SEVERITY_LABEL_KEY2 = {
   bug: "sev_bug",
-  question: "sev_question",
-  polish: "sev_polish"
+  design: "sev_design",
+  enhance: "sev_enhance"
 };
 function clampRegionRect(rect) {
   const vw = typeof window !== "undefined" ? window.innerWidth : rect.left + rect.width;
@@ -10074,7 +10094,7 @@ function CaptureMode() {
                   /* @__PURE__ */ jsxRuntime.jsx("span", { className: "qa-text-11 qa-text-mid qa-me-1", children: t("severity_label") }),
                   SEVERITIES2.map((sev) => {
                     const active = severity === sev;
-                    const toneClass = sev === "bug" ? "qa-bg-danger-tint qa-text-danger" : sev === "question" ? "qa-bg-warn-tint qa-text-warn" : "qa-bg-accent-tint qa-text-accent";
+                    const toneClass = sev === "bug" ? "qa-bg-danger-tint qa-text-danger" : sev === "enhance" ? "qa-bg-warn-tint qa-text-warn" : "qa-bg-accent-tint qa-text-accent";
                     return /* @__PURE__ */ jsxRuntime.jsxs(
                       "button",
                       {
@@ -10354,5 +10374,5 @@ function Qapture({ config }) {
 exports.Qapture = Qapture;
 exports.deleteQaDatabase = deleteQaDatabase;
 exports.initQaStudio = initQaStudio;
-//# sourceMappingURL=chunk-CNNNWLTX.cjs.map
-//# sourceMappingURL=chunk-CNNNWLTX.cjs.map
+//# sourceMappingURL=chunk-WU7QMHPK.cjs.map
+//# sourceMappingURL=chunk-WU7QMHPK.cjs.map

package/dist/index.cjs

@@ -1,24 +1,24 @@
 'use strict';
 
-var chunkCNNNWLTX_cjs = require('./chunk-CNNNWLTX.cjs');
+var chunkWU7QMHPK_cjs = require('./chunk-WU7QMHPK.cjs');
 
 
 
 Object.defineProperty(exports, "QaStudio", {
   enumerable: true,
-  get: function () { return chunkCNNNWLTX_cjs.Qapture; }
+  get: function () { return chunkWU7QMHPK_cjs.Qapture; }
 });
 Object.defineProperty(exports, "Qapture", {
   enumerable: true,
-  get: function () { return chunkCNNNWLTX_cjs.Qapture; }
+  get: function () { return chunkWU7QMHPK_cjs.Qapture; }
 });
 Object.defineProperty(exports, "deleteQaDatabase", {
   enumerable: true,
-  get: function () { return chunkCNNNWLTX_cjs.deleteQaDatabase; }
+  get: function () { return chunkWU7QMHPK_cjs.deleteQaDatabase; }
 });
 Object.defineProperty(exports, "initQaStudio", {
   enumerable: true,
-  get: function () { return chunkCNNNWLTX_cjs.initQaStudio; }
+  get: function () { return chunkWU7QMHPK_cjs.initQaStudio; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.js

@@ -1,3 +1,3 @@
-export { Qapture as QaStudio, Qapture, deleteQaDatabase, initQaStudio } from './chunk-NM3IDVEL.js';
+export { Qapture as QaStudio, Qapture, deleteQaDatabase, initQaStudio } from './chunk-FVQKCQC3.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/next.cjs

@@ -1,21 +1,21 @@
 "use client";
 'use strict';
 
-var chunkCNNNWLTX_cjs = require('./chunk-CNNNWLTX.cjs');
+var chunkWU7QMHPK_cjs = require('./chunk-WU7QMHPK.cjs');
 
 
 
 Object.defineProperty(exports, "QaStudio", {
   enumerable: true,
-  get: function () { return chunkCNNNWLTX_cjs.Qapture; }
+  get: function () { return chunkWU7QMHPK_cjs.Qapture; }
 });
 Object.defineProperty(exports, "Qapture", {
   enumerable: true,
-  get: function () { return chunkCNNNWLTX_cjs.Qapture; }
+  get: function () { return chunkWU7QMHPK_cjs.Qapture; }
 });
 Object.defineProperty(exports, "initQaStudio", {
   enumerable: true,
-  get: function () { return chunkCNNNWLTX_cjs.initQaStudio; }
+  get: function () { return chunkWU7QMHPK_cjs.initQaStudio; }
 });
 //# sourceMappingURL=next.cjs.map
 //# sourceMappingURL=next.cjs.map

package/dist/next.js

@@ -1,4 +1,4 @@
 "use client";
-export { Qapture as QaStudio, Qapture, initQaStudio } from './chunk-NM3IDVEL.js';
+export { Qapture as QaStudio, Qapture, initQaStudio } from './chunk-FVQKCQC3.js';
 //# sourceMappingURL=next.js.map
 //# sourceMappingURL=next.js.map

package/dist/standalone.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkCNNNWLTX_cjs = require('./chunk-CNNNWLTX.cjs');
+var chunkWU7QMHPK_cjs = require('./chunk-WU7QMHPK.cjs');
 
 // src/standalone.ts
 if (typeof window !== "undefined" && typeof customElements !== "undefined" && !customElements.get("qapture-widget")) {
@@ -38,7 +38,7 @@ if (typeof window !== "undefined" && typeof customElements !== "undefined" && !c
 
 Object.defineProperty(exports, "initQaStudio", {
   enumerable: true,
-  get: function () { return chunkCNNNWLTX_cjs.initQaStudio; }
+  get: function () { return chunkWU7QMHPK_cjs.initQaStudio; }
 });
 //# sourceMappingURL=standalone.cjs.map
 //# sourceMappingURL=standalone.cjs.map

package/dist/standalone.js

@@ -1,4 +1,4 @@
-export { initQaStudio } from './chunk-NM3IDVEL.js';
+export { initQaStudio } from './chunk-FVQKCQC3.js';
 
 // src/standalone.ts
 if (typeof window !== "undefined" && typeof customElements !== "undefined" && !customElements.get("qapture-widget")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qapture2",
-  "version": "0.7.6",
+  "version": "0.7.7",
   "description": "Drop-in, AI-aware in-browser QA capture widget. A tester annotates the live app (element/region + auto-screenshot + note), tracks a graded testing journey, and exports a ZIP your own coding agent reads. Ships zero AI.",
   "type": "module",
   "license": "MIT",