Ship PerpScope v1.7 trader context

Author: Clay

README.md

@@ -46,6 +46,7 @@ PerpScope rejects wallet paths, private keys, mnemonics, seeds, signers, signatu
 - a read-only decoder worker that emits `/perpscope.json` from Percolator SDK decoded market accounts
 - a Trader Radar board that ranks live markets by heat, stress, skew, funding pressure, freshness, and unit-confidence checks
 - live-by-default public site behavior with a compact Data Confidence strip and Trader Radar filters
+- Why Hot explanations, Feed Health, shareable market/filter links, and terminal Adapter Targets
 - issue templates for sanitized decoded shapes, adapter mapping requests, and CLI doctor output
 
 ## Submit A Shape
@@ -393,6 +394,7 @@ The normalized market DTO includes:
 - `docs/release-v1.4.0.md` mirrors the public release notes for the decoder worker.
 - `docs/release-v1.5.0.md` mirrors the public release notes for default live Percolator loading and Trader Radar.
 - `docs/release-v1.6.0.md` mirrors the public release notes for automatic live loading, confidence, and radar filters.
+- `docs/release-v1.7.0.md` mirrors the public release notes for why-hot explanations, feed health, share links, and adapter targets.
 - `docs/decoded-live-source.md` documents the CORS endpoint contract for decoded Percolator live feeds.
 - `docs/v0.5-plan.md` documents the shipped compatibility report export.
 - `.github/ISSUE_TEMPLATE/decoded-percolator-shape.yml` is the structured intake form for sanitized builder samples.
@@ -447,4 +449,5 @@ Current public site: [williamclay8.github.io/perpscope](https://williamclay8.git
 - v1.4 shipped: `perpscope-decoder-worker`, Render Blueprint deployment, and SDK-backed decoded market account output.
 - v1.5 shipped: default hosted Percolator loading, decoded value sanity checks, and Trader Radar market ranking.
 - v1.6 shipped: automatic public-site live loading, Data Confidence summary, Trader Radar filters, and live loading/fallback states.
+- v1.7 shipped: Why Hot explanations, Feed Health, shareable cockpit links, and terminal Adapter Targets.
 - More deployment fixtures as Percolator terminal teams share read-only shapes.

docs/release-v1.7.0.md

@@ -0,0 +1,22 @@
+# PerpScope v1.7.0
+
+PerpScope v1.7 turns the live cockpit into a more useful trader and builder surface.
+
+## Shipped
+
+- Adds a Why Hot panel that explains the selected market's heat with stress, skew, carry, freshness, spread, and decode confidence.
+- Adds a Feed Health panel for market count, slot, age, unit checks, gaps, and decoder source.
+- Adds shareable cockpit links with `?market=` and `?filter=` state.
+- Adds Adapter Targets for terminal rails, risk overlays, execution lanes, and feed monitors.
+- Keeps the public site auto-loading the hosted read-only Percolator decoder worker.
+
+## Safety
+
+PerpScope remains read-only. The new explanations are data-quality and risk-context summaries only; they do not connect wallets, sign transactions, submit orders, route trades, or provide trade recommendations.
+
+## Live
+
+```text
+https://williamclay8.github.io/perpscope/
+https://perpscope-decoder-worker.onrender.com/perpscope.json
+```

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "perpscope",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "private": true,
   "type": "module",
   "description": "Read-only Percolator risk cockpit and terminal adapter kit.",

package.json

@@ -34,6 +34,7 @@ const releaseV13Doc = readFileSync(new URL("../docs/release-v1.3.0.md", import.m
 const releaseV14Doc = readFileSync(new URL("../docs/release-v1.4.0.md", import.meta.url), "utf8");
 const releaseV15Doc = readFileSync(new URL("../docs/release-v1.5.0.md", import.meta.url), "utf8");
 const releaseV16Doc = readFileSync(new URL("../docs/release-v1.6.0.md", import.meta.url), "utf8");
+const releaseV17Doc = readFileSync(new URL("../docs/release-v1.7.0.md", import.meta.url), "utf8");
 const decodedLiveSourceDoc = readFileSync(new URL("../docs/decoded-live-source.md", import.meta.url), "utf8");
 const decoderWorker = readFileSync(new URL("../scripts/percolator-decoder-worker.mjs", import.meta.url), "utf8");
 const decoderWorkerLib = readFileSync(new URL("../src/lib/percolator-decoder-worker.js", import.meta.url), "utf8");
@@ -149,6 +150,10 @@ if (!/shouldAutoLoadLivePercolator/.test(js) || !/dataConfidenceStrip/.test(js)
   failures.push("Cockpit should auto-load live Percolator on the public site and expose confidence plus radar filters.");
 }
 
+if (!/hot-reasons-panel/.test(js) || !/buildMarketHotReasons/.test(js) || !/feed-health-panel/.test(js) || !/buildFeedHealth/.test(js) || !/buildShareUrl/.test(js) || !/copy-market-link/.test(js) || !/TERMINAL_ADAPTER_TARGETS/.test(js) || !/adapter-targets-panel/.test(js)) {
+  failures.push("Cockpit should expose v1.7 why-hot explanations, feed health, share links, and adapter targets.");
+}
+
 if (!/createDecoderHttpHandler/.test(decoderWorker) || !/perpscope\.json/.test(decoderWorkerLib) || !/getMarketsByAddress/.test(decoderWorkerLib) || !/new Worker/.test(decoderWorkerLib) || !/buildPerpScopeDecodedSnapshot/.test(decoderWorkerThread) || !/PERPSCOPE_ALLOWED_ORIGIN/.test(decoderWorker) || !/PERPSCOPE_DECODER_TIMEOUT_MS/.test(decoderWorker) || !/localhost\|127/.test(decoderWorkerLib) || !/healthz/.test(decoderWorkerLib)) {
   failures.push("Decoder worker should expose health and PerpScope JSON endpoints backed by read-only SDK account reads.");
 }
@@ -275,6 +280,7 @@ for (const doc of [
   "docs/release-v1.4.0.md",
   "docs/release-v1.5.0.md",
   "docs/release-v1.6.0.md",
+  "docs/release-v1.7.0.md",
   "docs/decoded-live-source.md",
   "docs/v0.5-plan.md"
 ]) {
@@ -422,6 +428,12 @@ for (const required of ["Auto-loads", "Data Confidence", "Trader Radar filters",
   }
 }
 
+for (const required of ["Why Hot", "Feed Health", "?market=", "Adapter Targets", "Safety"]) {
+  if (!releaseV17Doc.includes(required)) {
+    failures.push(`v1.7 release notes should include ${required}.`);
+  }
+}
+
 for (const required of ["compatibility report", "Export", "wallet", "transaction", "npm run check", "0.5.0"]) {
   if (!v05PlanDoc.toLowerCase().includes(required.toLowerCase())) {
     failures.push(`v0.5 plan should mention ${required}.`);