@polishd/next 0.2.1 → 0.2.2-dev.1

package/CHANGELOG.md

@@ -1,7 +1,64 @@
 # Changelog
 
+## Unreleased
+
+### Cross-install telemetry ingest
+
+A new `@polishd/next/telemetry` entry point exports a CORS-enabled ingest
+route for collecting telemetry *from other polishd installations* — the
+foundation for polishd dogfooding its own dashboards. Unlike the first-party
+route, it answers preflights, accepts POSTs cross-origin, and takes identity
+from the body (a client-minted anonymous session id plus a stable, anonymous
+`installId`) since the httpOnly session cookie never crosses origins. Events
+land tagged with an `install_id` — a new nullable column on `events`, migrated
+automatically on both backends — so one shared database can tell installations
+apart. Nothing sends to this endpoint yet; the dashboard-side emitter and its
+opt-in consent flow ship separately.
+
+### The dashboard dogfoods itself — with consent
+
+The dashboard now asks, once, whether it may share anonymous usage of
+*itself* with the polishd project. Opt-in and off by default: say no and it
+never asks again; say yes and a small emitter records clicks (with the same
+rage/dead classification the host capture layer uses, via newly shared DOM
+helpers), tab views, and one viewport sample — namespaced under `/~polishd/…`
+paths, tied to a random install id, and suspended the instant the URL leaves
+the dashboard. Nothing from the host site is ever sent: not its analytics,
+not its visitors, not its URLs. `POLISHD_TELEMETRY=off` kills the feature
+(prompt included), `POLISHD_TELEMETRY_ENDPOINT` redirects it for testing, and
+`navigator.doNotTrack` is honored regardless of stored consent. Batches
+travel as `text/plain` so the cross-origin POST stays preflight-free and
+beacon-compatible.
+
 ## 0.2.1
 
+### Losses can be ignored, and the model remembers why
+
+A loss had one answer next to it — **File bug** — and no way to say the other
+thing: that it isn't a problem. Nothing recorded that judgement, so the next
+regenerate found the deliberate two-step checkout again, and again.
+
+**Ignore** now sits beside File bug on every loss. One click, no explanation
+required: the loss leaves the card, leaves the cached summary immediately, and
+is dropped from every later summary *before* the four-loss cap applies — so
+dismissing one promotes the next real problem into its place rather than
+leaving a gap.
+
+A **reason** is optional and offered after the dismissal, so the fast path
+stays one click. Give one and it's replayed to the model verbatim on every
+later call, alongside the problem it dismissed — context the analytics digest
+can't carry ("the second CTA is deliberate", "that page is staff-only"). The
+model is told not to re-report a dismissed problem under any wording, and to
+read the rest of the data taking the stated reason as true. Reasons can be
+edited afterwards, and **Undo** puts a loss back where the model can find it
+again.
+
+Dismissals key off the same evidence citation the GitHub issue log uses, so a
+problem refound under different wording is still recognised as the one you
+already reviewed. They fold into the summary fingerprint too: ignoring
+something marks the summary stale exactly like new analytics does, so the next
+refresh really does re-ask the model.
+
 ### Setup moved out of the way, into a Settings tab
 
 The first screen of the dashboard was also its setup form. Provider, key, site

package/DATABASE.md

@@ -88,13 +88,20 @@ CREATE TABLE IF NOT EXISTS events (
   text        TEXT,
   value       DOUBLE PRECISION,
   meta        JSONB,
-  received_at BIGINT      NOT NULL
+  received_at BIGINT      NOT NULL,
+  install_id  TEXT
 );
 CREATE INDEX IF NOT EXISTS idx_events_path    ON events(path);
 CREATE INDEX IF NOT EXISTS idx_events_type    ON events(type);
 CREATE INDEX IF NOT EXISTS idx_events_session ON events(session_id);
+CREATE INDEX IF NOT EXISTS idx_events_install ON events(install_id);
 ```
 
+(`install_id` is null on every first-party event; it is only set on rows that
+arrived through a `@polishd/next/telemetry` endpoint, which tags each event
+with the anonymous id of the remote installation that sent it. Databases
+created before the column existed are migrated automatically at open.)
+
 ---
 
 ## Production — Option B: Turso (edge SQLite) — not yet wired up

package/README.md

@@ -363,6 +363,33 @@ authoritative context, so:
 > provide. Your source is read only during an explicit scan (or a targeted
 > gap-fill), and always under strict size budgets.
 
+### Two verdicts on a loss: file it, or ignore it
+
+Every loss carries both answers, side by side.
+
+**File bug** (with GitHub connected) verifies the report against your repo's
+source before anything is filed: confirmed reports become an issue with the
+technical analysis and suggested fixes, and a report the code disproves comes
+back as *"checked the source — not an actual bug"* with the reasoning, filing
+nothing.
+
+**Ignore** is the other answer: this isn't a problem, stop showing it to me. It
+takes one click and no explanation. The loss drops out of the card and out of
+every later summary — including the cached one, immediately — and the model is
+told about the dismissal on every subsequent call, so it doesn't spend a loss
+slot rediscovering it. Dismissing one loss doesn't shrink the list; the next
+real problem takes its place.
+
+A **reason** is optional and offered after the fact — *"the second CTA is
+deliberate"*, *"that page is staff-only"*. It's worth adding: reasons are
+replayed to the model verbatim as context it can't get from the numbers, which
+is what stops the same finding coming back in different words. You can edit a
+reason later, and **Undo** puts the loss back where the model can report it
+again.
+
+Ignoring a loss marks the summary stale, exactly like new analytics does, so
+the next refresh actually re-asks the model with the dismissal in hand.
+
 ## Design review
 
 The dashboard's **Design** tab (in the sidebar) is your site's brand guideline
@@ -415,6 +442,28 @@ import { PolishdMonitor } from "@polishd/next/client";
 </PolishdMonitor>
 ```
 
+## Dashboard telemetry
+
+Polishd can report anonymous usage of its own dashboard back to the polishd
+project — the same rage-click/dead-click/page-view signals it captures for
+you, applied to itself, so the dashboard is improved by what it preaches.
+
+**Opt-in, and off by default.** The first time you open the dashboard it asks
+once; nothing is sent unless you say yes. What's shared when you do:
+
+- Clicks and tab views **inside the dashboard only** (paths are namespaced
+  `/~polishd/…` and capture suspends the moment you navigate back to your
+  site), plus one viewport-size sample per session.
+- A random install id (`crypto.randomUUID()`, minted on consent) and an
+  anonymous per-browser-session id. No cookies, no fingerprinting, no URLs,
+  page content, or user data from your site — your analytics never leave your
+  database.
+
+Say no and it never asks again. Change your mind, or disable it fleet-wide,
+with `POLISHD_TELEMETRY=off`; `navigator.doNotTrack` is honored regardless of
+consent. The receiving end is an ordinary `@polishd/next/telemetry` route on
+the polishd site's own installation — the same package, dogfooding itself.
+
 ## Configuration
 
 Defaults suit a low-traffic site. Override via `polishd.config.ts`:
@@ -487,6 +536,8 @@ POLISHD_SESSION_COOKIE=my_session
 | `POLISHD_GITHUB_REPO` | GitHub (optional) | Repository as `owner/repo` — enables filing bugs from AI-found losses |
 | `POLISHD_GITHUB_TOKEN` | GitHub (optional) | Fine-grained PAT: Contents (read), Issues & Pull requests (write) |
 | `POLISHD_GITHUB_AUTO_ISSUES` | GitHub (optional) | `true` — file a GitHub issue automatically for each new problem a summary finds |
+| `POLISHD_TELEMETRY` | optional | `off` (or `0`/`false`/`no`) — disable [dashboard telemetry](#dashboard-telemetry) entirely, consent prompt included |
+| `POLISHD_TELEMETRY_ENDPOINT` | optional | Where dashboard telemetry is sent, if not the polishd project's own endpoint |
 
 AI settings are optional — the dashboard's **Settings** tab configures the same
 fields, and what you save there overrides these env defaults.
@@ -519,6 +570,7 @@ Run `npx @polishd/next doctor` first — it catches most of these by name, and
 | `@polishd/next/client` | `initPolishd`, `PolishdMonitor` |
 | `@polishd/next/server` | store, ingest, queries, `withPolishdSession` (Node only) |
 | `@polishd/next/route` | `POST`, `createPolishdRoute` |
+| `@polishd/next/telemetry` | `POST`, `OPTIONS`, `createPolishdTelemetryRoute` — CORS-enabled ingest for telemetry from *other* polishd installs |
 | `@polishd/next/proxy` | `proxy`, `config`, `withPolishdSession`, `polishdMatcher`, `composePolishd` |
 | `@polishd/next/dashboard` | `createPolishdPage`, `polishdTokenAuth`, `PolishdDashboard`, `loadPolishdDashboardData` |
 

package/dist/ai/actions.d.ts

@@ -1,5 +1,5 @@
 import { type ListModelsInput, type SaveAISettingsInput } from "./settings";
-import type { PolishdAISettingsPublic, PolishdLossItem, CreateIssueResult, GenerateDesignReviewResult, GenerateProfileResult, GenerateSummaryResult, ListModelsResult, VerifyGithubResult } from "./types";
+import type { PolishdAISettingsPublic, PolishdLossItem, CreateIssueResult, GenerateDesignReviewResult, GenerateProfileResult, GenerateSummaryResult, IgnoreLossResult, ListModelsResult, UnignoreLossResult, VerifyGithubResult } from "./types";
 /** Generate or refresh the narrative. `force` re-asks the model even if data is unchanged. */
 export declare function generateSummaryAction(force?: boolean): Promise<GenerateSummaryResult>;
 /**
@@ -31,4 +31,13 @@ export declare function verifyGithubAction(): Promise<VerifyGithubResult>;
  * disproved report returns `not-a-bug` with the reasoning instead of filing.
  */
 export declare function createIssueFromLossAction(loss: Pick<PolishdLossItem, "issue" | "evidence" | "location">): Promise<CreateIssueResult>;
+/**
+ * The other verdict on a loss: dismiss it, with an optional reason. The loss
+ * leaves every summary from here on, and the dismissal — reason included — is
+ * replayed into later model calls so the problem isn't reported again. Calling
+ * it on an already-dismissed loss just updates the reason.
+ */
+export declare function ignoreLossAction(loss: Pick<PolishdLossItem, "issue" | "evidence">, reason?: string): Promise<IgnoreLossResult>;
+/** Undo a dismissal: the loss can be found and reported again. */
+export declare function unignoreLossAction(evidence: string): Promise<UnignoreLossResult>;
 //# sourceMappingURL=actions.d.ts.map

package/dist/ai/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/ai/actions.ts"],"names":[],"mappings":"AAqBA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,8FAA8F;AAC9F,wBAAsB,qBAAqB,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAGzF;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,UAAQ,GACZ,OAAO,CAAC,0BAA0B,CAAC,CAGrC;AAED,mFAAmF;AACnF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAGlC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAI5E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGxF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAGtE;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC,GAC7D,OAAO,CAAC,iBAAiB,CAAC,CAG5B"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/ai/actions.ts"],"names":[],"mappings":"AAsBA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB,8FAA8F;AAC9F,wBAAsB,qBAAqB,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAGzF;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,UAAQ,GACZ,OAAO,CAAC,0BAA0B,CAAC,CAGrC;AAED,mFAAmF;AACnF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAGlC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAI5E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGxF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAGtE;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC,GAC7D,OAAO,CAAC,iBAAiB,CAAC,CAG5B;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,UAAU,CAAC,EACjD,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,CAM3B;AAED,kEAAkE;AAClE,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAKtF"}

package/dist/ai/actions.js

@@ -15,6 +15,7 @@
 import { requirePolishdAuth } from "./guard";
 import { generateDesignReview } from "./design";
 import { verifyGithubConnection } from "./github";
+import { ignoreLoss, unignoreLoss } from "./ignored";
 import { createIssueFromLoss } from "./issues";
 import { generateProjectProfile } from "./profile";
 import { loadPolishdDashboardData } from "../server/queries";
@@ -73,4 +74,24 @@ export async function createIssueFromLossAction(loss) {
     await requirePolishdAuth();
     return createIssueFromLoss(loss);
 }
+/**
+ * The other verdict on a loss: dismiss it, with an optional reason. The loss
+ * leaves every summary from here on, and the dismissal — reason included — is
+ * replayed into later model calls so the problem isn't reported again. Calling
+ * it on an already-dismissed loss just updates the reason.
+ */
+export async function ignoreLossAction(loss, reason) {
+    await requirePolishdAuth();
+    const ignored = await ignoreLoss(loss, reason);
+    return ignored
+        ? { ok: true, ignored }
+        : { ok: false, message: "Couldn't save that — the analytics store didn't accept the write." };
+}
+/** Undo a dismissal: the loss can be found and reported again. */
+export async function unignoreLossAction(evidence) {
+    await requirePolishdAuth();
+    return (await unignoreLoss(evidence))
+        ? { ok: true }
+        : { ok: false, message: "Couldn't undo that — the analytics store didn't accept the write." };
+}
 //# sourceMappingURL=actions.js.map

package/dist/ai/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/ai/actions.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,cAAc,GAGf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAY5C,8FAA8F;AAC9F,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAK,GAAG,KAAK;IACvD,MAAM,kBAAkB,EAAE,CAAC;IAC3B,OAAO,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAAK,GAAG,KAAK;IAEb,MAAM,kBAAkB,EAAE,CAAC;IAC3B,OAAO,oBAAoB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAA0B;IAE1B,MAAM,kBAAkB,EAAE,CAAC;IAC3B,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,kBAAkB,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,wBAAwB,EAAE,CAAC;IAC9C,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAsB;IAC3D,MAAM,kBAAkB,EAAE,CAAC;IAC3B,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,kBAAkB,EAAE,CAAC;IAC3B,OAAO,sBAAsB,EAAE,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAA8D;IAE9D,MAAM,kBAAkB,EAAE,CAAC;IAC3B,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/ai/actions.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,cAAc,GAGf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAc5C,8FAA8F;AAC9F,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAK,GAAG,KAAK;IACvD,MAAM,kBAAkB,EAAE,CAAC;IAC3B,OAAO,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAAK,GAAG,KAAK;IAEb,MAAM,kBAAkB,EAAE,CAAC;IAC3B,OAAO,oBAAoB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAA0B;IAE1B,MAAM,kBAAkB,EAAE,CAAC;IAC3B,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,kBAAkB,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,wBAAwB,EAAE,CAAC;IAC9C,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAsB;IAC3D,MAAM,kBAAkB,EAAE,CAAC;IAC3B,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,kBAAkB,EAAE,CAAC;IAC3B,OAAO,sBAAsB,EAAE,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAA8D;IAE9D,MAAM,kBAAkB,EAAE,CAAC;IAC3B,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAiD,EACjD,MAAe;IAEf,MAAM,kBAAkB,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,OAAO;QACZ,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;QACvB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mEAAmE,EAAE,CAAC;AAClG,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,MAAM,kBAAkB,EAAE,CAAC;IAC3B,OAAO,CAAC,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE;QACd,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,mEAAmE,EAAE,CAAC;AAClG,CAAC"}

package/dist/ai/ignored.d.ts

@@ -0,0 +1,26 @@
+import type { PolishdIgnoredLoss, PolishdLossItem, PolishdSummary } from "./types";
+/** Same normalization as the issue log: one citation, one verdict. */
+export declare function ignoreKey(evidence: string): string;
+/** Every dismissal, newest first. */
+export declare function loadIgnoredLosses(): Promise<PolishdIgnoredLoss[]>;
+/** The evidence keys to filter losses by. */
+export declare function ignoredKeys(list: PolishdIgnoredLoss[]): Set<string>;
+/**
+ * Dismiss one loss, with an optional reason. Re-ignoring an already-ignored
+ * loss updates its reason (that's the "add a reason afterwards" path), keeping
+ * the original timestamp so the log stays in the order things were reviewed.
+ */
+export declare function ignoreLoss(loss: Pick<PolishdLossItem, "issue" | "evidence">, reason?: string): Promise<PolishdIgnoredLoss | null>;
+/** Undo a dismissal. Returns false only when the store refused the write. */
+export declare function unignoreLoss(evidence: string): Promise<boolean>;
+/**
+ * The dismissals as prompt context: what the owner already reviewed and
+ * rejected, so the model doesn't spend a loss slot re-reporting it. Reasons are
+ * included verbatim — they're the part the analytics can't tell the model.
+ */
+export declare function ignoredSection(list: PolishdIgnoredLoss[]): string | null;
+/** Hash of the dismissals, so a new one invalidates the cached summary. */
+export declare function ignoredFingerprint(list: PolishdIgnoredLoss[]): string;
+/** Drop dismissed losses from a summary about to be rendered. */
+export declare function withoutIgnored(summary: PolishdSummary, keys: Set<string>): PolishdSummary;
+//# sourceMappingURL=ignored.d.ts.map

package/dist/ai/ignored.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignored.d.ts","sourceRoot":"","sources":["../../src/ai/ignored.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAUnF,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElD;AAeD,qCAAqC;AACrC,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAEvE;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAEnE;AAOD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,UAAU,CAAC,EACjD,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA0BpC;AAED,6EAA6E;AAC7E,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMrE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,MAAM,GAAG,IAAI,CAcxE;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,MAAM,CASrE;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAChB,cAAc,CAIhB"}

package/dist/ai/ignored.js

@@ -0,0 +1,134 @@
+/**
+ * Polishd — ignored losses (server only).
+ *
+ * The counterpart to filing a bug. A loss is a claim the model made from the
+ * analytics; "File bug" says *yes, and here's the tracker issue*, and this says
+ * *no — stop telling me about it*, with or without a reason.
+ *
+ * A dismissal is not just a UI toggle, or the next regenerate would hand the
+ * same problem straight back:
+ *
+ *   1. Ignored losses are dropped from every summary that renders — the fresh
+ *      one and the cached one alike — before the four-loss cap applies, so
+ *      dismissing one promotes a real problem into its place rather than
+ *      leaving a gap.
+ *   2. The dismissals (and their reasons) are replayed into the prompt of every
+ *      later model call, so the model knows what has already been reviewed and
+ *      rejected, and why. "Checkout CTA is fine, it's a two-step flow on
+ *      purpose" is context no digest can carry.
+ *   3. They fold into the summary fingerprint, so ignoring something marks the
+ *      cached summary stale and a regenerate actually re-asks the model.
+ *
+ * Keyed by the evidence citation — the same key the GitHub issue log uses (see
+ * issues.ts) — so a problem refound under slightly different wording is still
+ * recognised as the one that was dismissed.
+ */
+import { getMeta, setMeta } from "../server/store";
+import { fingerprintDigest } from "./digest";
+const IGNORED_KEY = "ignored_losses";
+/** Keep the log (and the prompt section built from it) bounded. */
+const MAX_STORED = 50;
+const MAX_IN_PROMPT = 20;
+const MAX_ISSUE_CHARS = 160;
+const MAX_REASON_CHARS = 240;
+/** Same normalization as the issue log: one citation, one verdict. */
+export function ignoreKey(evidence) {
+    return evidence.trim().toLowerCase();
+}
+async function loadLog() {
+    const raw = await getMeta(IGNORED_KEY);
+    if (!raw)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+/** Every dismissal, newest first. */
+export async function loadIgnoredLosses() {
+    return Object.values(await loadLog()).sort((a, b) => b.ignoredAt - a.ignoredAt);
+}
+/** The evidence keys to filter losses by. */
+export function ignoredKeys(list) {
+    return new Set(list.map((i) => ignoreKey(i.evidence)));
+}
+const clip = (s, max) => {
+    const t = s.replace(/\s+/g, " ").trim();
+    return t.length > max ? `${t.slice(0, max - 1)}…` : t;
+};
+/**
+ * Dismiss one loss, with an optional reason. Re-ignoring an already-ignored
+ * loss updates its reason (that's the "add a reason afterwards" path), keeping
+ * the original timestamp so the log stays in the order things were reviewed.
+ */
+export async function ignoreLoss(loss, reason) {
+    const evidence = loss.evidence.trim();
+    if (!evidence)
+        return null;
+    const key = ignoreKey(evidence);
+    const log = await loadLog();
+    const trimmed = reason?.trim();
+    const entry = {
+        issue: clip(loss.issue, MAX_ISSUE_CHARS),
+        evidence,
+        reason: trimmed ? clip(trimmed, MAX_REASON_CHARS) : undefined,
+        ignoredAt: log[key]?.ignoredAt ?? Date.now(),
+    };
+    log[key] = entry;
+    // Bound the log: oldest dismissals fall off first.
+    const keys = Object.keys(log);
+    if (keys.length > MAX_STORED) {
+        for (const k of keys
+            .sort((a, b) => log[a].ignoredAt - log[b].ignoredAt)
+            .slice(0, keys.length - MAX_STORED)) {
+            delete log[k];
+        }
+    }
+    return (await setMeta(IGNORED_KEY, JSON.stringify(log))) ? entry : null;
+}
+/** Undo a dismissal. Returns false only when the store refused the write. */
+export async function unignoreLoss(evidence) {
+    const log = await loadLog();
+    const key = ignoreKey(evidence);
+    if (!(key in log))
+        return true; // already gone — nothing to undo
+    delete log[key];
+    return setMeta(IGNORED_KEY, JSON.stringify(log));
+}
+/**
+ * The dismissals as prompt context: what the owner already reviewed and
+ * rejected, so the model doesn't spend a loss slot re-reporting it. Reasons are
+ * included verbatim — they're the part the analytics can't tell the model.
+ */
+export function ignoredSection(list) {
+    if (list.length === 0)
+        return null;
+    const lines = list
+        .slice(0, MAX_IN_PROMPT)
+        .map((i) => `- "${i.issue}" (cited: ${i.evidence}) — ` +
+        (i.reason ? `dismissed because: ${i.reason}` : "dismissed without a reason"));
+    return ("ALREADY REVIEWED AND DISMISSED BY THE SITE OWNER (do not report these " +
+        "again, in these or any other words — treat a stated reason as true):\n" +
+        lines.join("\n"));
+}
+/** Hash of the dismissals, so a new one invalidates the cached summary. */
+export function ignoredFingerprint(list) {
+    if (list.length === 0)
+        return "";
+    return fingerprintDigest(list
+        .slice(0, MAX_IN_PROMPT)
+        .map((i) => `${ignoreKey(i.evidence)}:${i.reason ?? ""}`)
+        .sort()
+        .join("|"));
+}
+/** Drop dismissed losses from a summary about to be rendered. */
+export function withoutIgnored(summary, keys) {
+    if (!summary.losses?.length || keys.size === 0)
+        return summary;
+    const losses = summary.losses.filter((l) => !keys.has(ignoreKey(l.evidence)));
+    return losses.length === summary.losses.length ? summary : { ...summary, losses };
+}
+//# sourceMappingURL=ignored.js.map

package/dist/ai/ignored.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignored.js","sourceRoot":"","sources":["../../src/ai/ignored.ts"],"names":[],"mappings":"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"}

package/dist/ai/summary.d.ts

@@ -1,7 +1,14 @@
 import { type PolishdDashboardData } from "../server/queries";
 import type { PolishdSummary, GenerateSummaryResult } from "./types";
 export { getAISettingsPublic, saveAISettings, type SaveAISettingsInput, } from "./settings";
-/** The last generated summary, or null. Read-only — never calls a model. */
+/**
+ * The last generated summary, or null. Read-only — never calls a model.
+ *
+ * Losses the owner has dismissed since it was generated are filtered out here,
+ * so an ignore takes effect on the cached summary immediately rather than at
+ * the next regenerate. The stored copy keeps them, which is what makes an undo
+ * bring the loss back.
+ */
 export declare function loadSummary(): Promise<PolishdSummary | null>;
 /**
  * Generate (or reuse) the narrative summary.

package/dist/ai/summary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/ai/summary.ts"],"names":[],"mappings":"AAmBA,OAAO,EAA4B,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAOxF,OAAO,KAAK,EAGV,cAAc,EACd,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAIpB,4EAA4E;AAC5E,wBAAsB,WAAW,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAQlE;AA2ID;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAgFhC;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,CAAC,EAAE,oBAAoB,GAC/B,OAAO,CAAC;IACT,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC,CAuBD"}
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/ai/summary.ts"],"names":[],"mappings":"AAmBA,OAAO,EAA4B,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAexF,OAAO,KAAK,EAIV,cAAc,EACd,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAIpB;;;;;;;GAOG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAUlE;AA2KD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAiFhC;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,CAAC,EAAE,oBAAoB,GAC/B,OAAO,CAAC;IACT,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC,CA0BD"}

package/dist/ai/summary.js

@@ -11,14 +11,15 @@
  *      profile.ts), generated once — the summary call never re-reads source.
  *      Only when analytics mention a component the profile doesn't cover do we
  *      do a tiny targeted read of the files naming it.
- *   3. We fingerprint the inputs (digest + profile) and cache the summary. A
- *      regenerate with no new data returns the cached text for free
+ *   3. We fingerprint the inputs (digest + profile + dismissals) and cache the
+ *      summary. A regenerate with no new data returns the cached text for free
  *      (`regenerated: false`).
  *   4. The system prompt is tight and the output is capped to a paragraph.
  */
 import { getMeta, setMeta } from "../server/store";
 import { loadPolishdDashboardData } from "../server/queries";
 import { buildDigest, fingerprintDigest } from "./digest";
+import { ignoreKey, ignoredFingerprint, ignoredKeys, ignoredSection, loadIgnoredLosses, withoutIgnored, } from "./ignored";
 import { attachGithubIssues } from "./issues";
 import { callModel } from "./providers";
 import { coverageGaps, loadProjectProfile } from "./profile";
@@ -27,17 +28,26 @@ import { resolveSettings } from "./settings";
 // Settings live in ./settings; re-exported here so existing imports keep working.
 export { getAISettingsPublic, saveAISettings, } from "./settings";
 const SUMMARY_KEY = "ai_summary";
-/** The last generated summary, or null. Read-only — never calls a model. */
+/**
+ * The last generated summary, or null. Read-only — never calls a model.
+ *
+ * Losses the owner has dismissed since it was generated are filtered out here,
+ * so an ignore takes effect on the cached summary immediately rather than at
+ * the next regenerate. The stored copy keeps them, which is what makes an undo
+ * bring the loss back.
+ */
 export async function loadSummary() {
     const raw = await getMeta(SUMMARY_KEY);
     if (!raw)
         return null;
+    let summary;
     try {
-        return JSON.parse(raw);
+        summary = JSON.parse(raw);
     }
     catch {
         return null;
     }
+    return withoutIgnored(summary, ignoredKeys(await loadIgnoredLosses()));
 }
 const SYSTEM_PROMPT = "You are a product analyst embedded in a website's analytics dashboard. " +
     "You receive a compact digest of real user-behavior signals (clicks, rage " +
@@ -58,7 +68,10 @@ const SYSTEM_PROMPT = "You are a product analyst embedded in a website's analyti
     "must be concrete (what is wrong, where, and what the numbers show), and " +
     "evidence must be the exact page path, CSS selector, or component name " +
     "copied verbatim from the digest that demonstrates it. Never invent a loss: " +
-    "if the data shows no real problems, return an empty array.";
+    "if the data shows no real problems, return an empty array. If the prompt " +
+    "lists problems the site owner has already reviewed and dismissed, do not " +
+    "report them again — not under a different citation or a different wording — " +
+    "and take any reason they gave as true when reading the rest of the data.";
 /**
  * Parse the model's JSON reply, tolerating stray fences or prose around it.
  * Falls back to treating the whole text as the story so a model that ignores
@@ -99,9 +112,11 @@ function citationTokens(s) {
 /**
  * Hold losses to their evidence bar. A loss survives only if its citation
  * actually appears in the prompt we sent (so it can't be invented), and is
- * then matched to a source file when the codebase is on disk.
+ * then matched to a source file when the codebase is on disk. Anything the
+ * owner has dismissed is dropped here, before the cap — so a dismissal frees
+ * its slot for the next real problem instead of leaving a gap.
  */
-function verifyLosses(raw, promptText, sourceDirs) {
+function verifyLosses(raw, promptText, sourceDirs, ignored) {
     const hay = promptText.toLowerCase();
     const out = [];
     for (const l of raw) {
@@ -110,6 +125,8 @@ function verifyLosses(raw, promptText, sourceDirs) {
         const evidence = typeof l.evidence === "string" ? l.evidence.trim() : "";
         if (!evidence)
             continue; // no citation, no loss
+        if (ignored.has(ignoreKey(evidence)))
+            continue; // reviewed and dismissed
         const tokens = citationTokens(evidence);
         if (!tokens.length || !tokens.some((t) => hay.includes(t)))
             continue; // not in the data we sent
@@ -126,11 +143,29 @@ function verifyLosses(raw, promptText, sourceDirs) {
     return out;
 }
 /**
- * The exact user message for a summary call, plus its cache fingerprint.
- * Fingerprint covers the digest AND the profile, so a re-scan (new profile)
- * marks the cached summary stale too.
+ * The one place the cache fingerprint is defined. It covers the digest, the
+ * profile AND the dismissals, so a re-scan or a newly ignored loss marks the
+ * cached summary stale exactly like new analytics does.
+ */
+function fingerprintInputs(digest, profile, ignored) {
+    const ignoredHash = ignoredFingerprint(ignored);
+    return fingerprintDigest([
+        digest,
+        profile ? `PROFILE:${profile.fingerprint}` : "",
+        ignoredHash ? `IGNORED:${ignoredHash}` : "",
+    ]
+        .filter(Boolean)
+        .join("\n"));
+}
+/**
+ * The exact user message for a summary call, plus its cache fingerprint and
+ * the slice of it a citation is allowed to be grounded in.
+ *
+ * `grounding` is the message minus the dismissals: past problems are quoted
+ * back to the model as context, and quoting them must not turn their citations
+ * into fresh evidence a new loss can lean on (see verifyLosses).
  */
-function composePrompt(data, profile, context, sourceDirs) {
+function composePrompt(data, profile, context, sourceDirs, ignored) {
     const digest = buildDigest(data, context);
     const sections = [];
     if (profile) {
@@ -149,11 +184,12 @@ function composePrompt(data, profile, context, sourceDirs) {
             }
         }
     }
-    sections.push(digest);
-    const user = sections.join("\n\n");
+    const dismissed = ignoredSection(ignored);
+    const grounding = [...sections, digest].join("\n\n");
     return {
-        user,
-        fingerprint: fingerprintDigest(profile ? `${digest}\nPROFILE:${profile.fingerprint}` : digest),
+        user: dismissed ? [...sections, dismissed, digest].join("\n\n") : grounding,
+        grounding,
+        fingerprint: fingerprintInputs(digest, profile, ignored),
     };
 }
 /**
@@ -176,8 +212,8 @@ export async function generateSummary(opts = {}) {
             message: "No analytics captured yet — browse the site, then generate.",
         };
     }
-    const profile = await loadProjectProfile();
-    const { user, fingerprint } = composePrompt(data, profile, settings.context, settings.sourceDirs);
+    const [profile, ignored] = await Promise.all([loadProjectProfile(), loadIgnoredLosses()]);
+    const { user, grounding, fingerprint } = composePrompt(data, profile, settings.context, settings.sourceDirs, ignored);
     if (!opts.force) {
         const cached = await loadSummary();
         if (cached && cached.fingerprint === fingerprint) {
@@ -216,7 +252,7 @@ export async function generateSummary(opts = {}) {
     const parsed = parseStructured(reply.text);
     // Link losses to their GitHub issues — filing new ones when the owner
     // enabled auto-filing, attaching already-filed ones either way.
-    const losses = await attachGithubIssues(verifyLosses(parsed.losses, user, settings.sourceDirs));
+    const losses = await attachGithubIssues(verifyLosses(parsed.losses, grounding, settings.sourceDirs, ignoredKeys(ignored)));
     const summary = {
         text: parsed.story,
         wins: parsed.wins,
@@ -243,14 +279,15 @@ export async function loadSummaryState(preloaded) {
     if (!data.overview.ready || data.overview.totalEvents === 0) {
         return { summary, stale: false, currentFingerprint: null };
     }
-    const [{ settings }, profile] = await Promise.all([
+    const [{ settings }, profile, ignored] = await Promise.all([
         resolveSettings(),
         loadProjectProfile(),
+        loadIgnoredLosses(),
     ]);
     // Staleness only needs the fingerprint — skip the targeted source read by
-    // computing it the same way composePrompt does, without collecting excerpts.
-    const digest = buildDigest(data, settings.context);
-    const currentFingerprint = fingerprintDigest(profile ? `${digest}\nPROFILE:${profile.fingerprint}` : digest);
+    // computing it from the same inputs composePrompt does, without collecting
+    // excerpts.
+    const currentFingerprint = fingerprintInputs(buildDigest(data, settings.context), profile, ignored);
     return {
         summary,
         stale: summary !== null && summary.fingerprint !== currentFingerprint,