analyzthis_design 2.4.1 → 2.5.0

package/dist/lib/feedback-submit.js

@@ -18,7 +18,9 @@ const CONFIG_DIR = path.join(os.homedir(), '.analyzthis_design');
 const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
 const CONSENT_FILE = path.join(CONFIG_DIR, 'feedback', 'submit-consent.json');
 
+const DEFAULT_ENDPOINT = 'https://analyzthis-lab.vercel.app/api/feedback';
 const MAX_SUBMIT_TEXT = 2000;
+const MAX_ROWS_PER_REQUEST = 50;
 const PATH_PATTERN = /(?:\/Users\/|\/home\/|[A-Za-z]:\\)[^\s"'`,;)]+/g;
 const EMAIL_PATTERN = /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g;
 const SECRET_PATTERN = /\b(sk-[a-zA-Z0-9_-]{10,}|api[_-]?key\s*[:=]\s*['"]?[a-zA-Z0-9_-]{8,})/gi;
@@ -43,8 +45,11 @@ function resolveSubmitConfig() {
   const pkgVersion = safePackageVersion();
 
   return {
-    url: process.env.ANALYZTHIS_FEEDBACK_URL || fb.submit_url || '',
-    anonKey: process.env.ANALYZTHIS_FEEDBACK_ANON_KEY || fb.anon_key || '',
+    // A single HTTPS endpoint — the Vercel function in website/api/feedback.js,
+    // which holds the Neon connection string in its own env. The package never
+    // carries a database credential, and moving off Neon later means editing
+    // that function rather than republishing this package.
+    url: process.env.ANALYZTHIS_FEEDBACK_URL || fb.submit_url || DEFAULT_ENDPOINT,
     enabled: fb.submit_enabled !== false,
     packageVersion: pkgVersion,
     installId: getInstallId(config),
@@ -105,6 +110,23 @@ function anonymizeText(text, maxLen = MAX_SUBMIT_TEXT) {
   return out.trim();
 }
 
+/**
+ * Look up what actually happened to this persona's advice. The reaction
+ * (satisfied/rating) says the designer was unhappy; the outcome says the
+ * persona was wrong. Only the second justifies changing the shipped package.
+ */
+function outcomeForEntry(entry) {
+  try {
+    const state = session.show({ project: entry.project_id });
+    if (!state || !state.outcome) return null;
+    const rec = (state.outcome.confirmed && state.outcome.confirmed[entry.persona])
+      || (state.outcome.inferred && state.outcome.inferred[entry.persona]);
+    return (rec && rec.value) || null;
+  } catch {
+    return null;
+  }
+}
+
 function entryToSubmitPayload(entry, cfg) {
   return {
     install_id: cfg.installId,
@@ -113,6 +135,8 @@ function entryToSubmitPayload(entry, cfg) {
     persona: entry.persona,
     satisfied: !!entry.satisfied,
     rating: entry.rating,
+    outcome: outcomeForEntry(entry),
+    task_type: entry.context?.problem_type || '',
     tags: entry.tags || [],
     user_comment: anonymizeText(entry.comment, 800),
     assistant_rejected: anonymizeText(entry.original_output),
@@ -193,22 +217,21 @@ async function submitRows(rows, cfg) {
   if (!cfg.url) {
     throw new Error(
       'No feedback submit URL configured.\n'
-      + '  Maintainer: set feedback.submit_url + feedback.anon_key in ~/.analyzthis_design/config.json\n'
-      + '  Or env: ANALYZTHIS_FEEDBACK_URL and ANALYZTHIS_FEEDBACK_ANON_KEY\n'
-      + '  See README → "Community feedback collection"',
+      + '  Set feedback.submit_url in ~/.analyzthis_design/config.json\n'
+      + '  Or env: ANALYZTHIS_FEEDBACK_URL\n'
+      + '  See docs/package-feedback.md',
     );
   }
-  if (!cfg.anonKey) {
-    throw new Error('Missing anon key. Set feedback.anon_key in config or ANALYZTHIS_FEEDBACK_ANON_KEY.');
-  }
 
-  await postJson(cfg.url, {
-    apikey: cfg.anonKey,
-    Authorization: `Bearer ${cfg.anonKey}`,
-    Prefer: 'return=minimal',
-  }, rows);
-
-  return rows.length;
+  // No credential travels with the package. The endpoint is a Vercel function
+  // that holds the database connection string in its own environment.
+  let sent = 0;
+  for (let i = 0; i < rows.length; i += MAX_ROWS_PER_REQUEST) {
+    const batch = rows.slice(i, i + MAX_ROWS_PER_REQUEST);
+    await postJson(cfg.url, {}, { kind: 'corrections', rows: batch });
+    sent += batch.length;
+  }
+  return sent;
 }
 
 function askConsentQuestion() {
@@ -216,7 +239,8 @@ function askConsentQuestion() {
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     rl.question(
       '\nShare anonymized persona feedback with analyzthis_design maintainers?\n'
-      + '  Sends: persona, rating, tags, comment/correction, redacted output snippets\n'
+      + '  Sends: persona, rating, outcome (shipped/revised/missed), task type,\n'
+      + '         tags, comment/correction, redacted output snippets\n'
       + '  Does NOT send: project paths, repo names, emails, or API keys\n'
       + 'Continue? [y/N] ',
       (answer) => {
@@ -303,18 +327,74 @@ function submitStatus() {
   return {
     consent: consent?.opted_in ? `opted in (${consent.at})` : 'not opted in',
     endpoint: cfg.url || '(not configured — set feedback.submit_url)',
-    anonKey: cfg.anonKey ? 'configured' : '(missing — set feedback.anon_key)',
+    endpoint: cfg.url || '(unset)',
     installId: cfg.installId,
     unsentCount: unsent,
     packageVersion: cfg.packageVersion,
   };
 }
 
+
+/**
+ * Aggregate persona scores — counts only, never note text.
+ * This is the signal that tells the maintainer which persona rule is failing
+ * ACROSS installs, which is the only justification for changing the shipped
+ * package. Cheap to send and hard to de-anonymise.
+ */
+function buildScorePayloads(cfg) {
+  const em = require('./evolution-metrics');
+  const metrics = em.computeEvolutionMetrics();
+  const rows = [];
+  for (const [persona, m] of Object.entries(metrics.personas)) {
+    // Nothing learned yet — do not ship noise upstream.
+    if (!m.evidence_count) continue;
+    rows.push({
+      install_id: cfg.installId,
+      package_version: cfg.packageVersion,
+      persona,
+      score: m.score,
+      level: m.level,
+      evidence_count: m.evidence_count,
+      shipped: m.outcome_breakdown.shipped || 0,
+      revised: m.outcome_breakdown.revised || 0,
+      blocked_correctly: m.outcome_breakdown.blocked_correctly || 0,
+      missed: m.outcome_breakdown.missed || 0,
+      avg_rating: m.avg_rating,
+    });
+  }
+  return rows;
+}
+
+/**
+ * Send the aggregate scoreboard. Requires the same consent as corrections.
+ */
+async function submitScores({ dryRun = false } = {}) {
+  const cfg = resolveSubmitConfig();
+  if (!cfg.enabled) return { sent: 0, skipped: 'submission disabled' };
+
+  const rows = buildScorePayloads(cfg);
+  if (!rows.length) return { sent: 0, skipped: 'no scored personas yet' };
+  if (dryRun) return { sent: 0, dryRun: true, rows };
+
+  if (!loadConsent()) return { sent: 0, skipped: 'no consent on file' };
+  if (!cfg.url) return { sent: 0, skipped: 'no endpoint configured' };
+
+  let sent = 0;
+  for (let i = 0; i < rows.length; i += MAX_ROWS_PER_REQUEST) {
+    const batch = rows.slice(i, i + MAX_ROWS_PER_REQUEST);
+    await postJson(cfg.url, {}, { kind: 'scores', rows: batch });
+    sent += batch.length;
+  }
+  return { sent, rows };
+}
+
 module.exports = {
   anonymizeText,
   entryToSubmitPayload,
   resolveSubmitConfig,
   submitFeedback,
+  submitScores,
+  buildScorePayloads,
   submitStatus,
   collectUnsentEntries,
   markEntriesSubmitted,

package/dist/lib/host-llm.js

@@ -76,9 +76,25 @@ function responsePath(runDir, stepId) {
   return path.join(runDir, 'responses', `${stepId}.md`);
 }
 
+/**
+ * Devi voices every persona, so it is the one place a team-wide trust signal
+ * can land. Advisory only — Devi weights its synthesis, never drops a persona.
+ * Best-effort: a scoreboard must never block a run.
+ */
+function scoreboardPreamble() {
+  try {
+    const em = require('./evolution-metrics');
+    const board = em.formatScoreboardForDevi(em.computeEvolutionMetrics());
+    return board ? board + '\n\n' : '';
+  } catch (e) {
+    return '';
+  }
+}
+
 function writePending(runDir, manifest, { personaId, system, user, meta = {} }) {
   manifest.pending_persona = personaId;
   const stepId = `${String(manifest.step_counter + 1).padStart(3, '0')}-${personaId}`;
+  system = scoreboardPreamble() + (system || '');
   const payload = {
     step_id: stepId,
     persona_id: personaId,

package/dist/lib/lessons.js

@@ -32,10 +32,26 @@ function loadLessons(personaId) {
   return lessons;
 }
 
+function lessonKey(lesson) {
+  return [lesson.persona, lesson.session_id, lesson.polarity || '', lesson.pattern].join('|');
+}
+
+/**
+ * Append unless an identical lesson already exists. Lessons now feed scoring
+ * (+10 each), and extractLessons runs on every keep/skip, so re-marking the
+ * same note must not inflate a persona's score.
+ * @returns {boolean} true if written
+ */
 function appendLesson(personaId, lesson) {
   ensureLessonsDir();
   var file = personaLessonFile(personaId);
+  var key = lessonKey(lesson);
+  var existing = loadLessons(personaId);
+  for (var i = 0; i < existing.length; i++) {
+    if (lessonKey(existing[i]) === key) return false;
+  }
   fs.appendFileSync(file, JSON.stringify(lesson) + '\n');
+  return true;
 }
 
 function keywordOverlap(a, b) {
@@ -52,7 +68,10 @@ function keywordOverlap(a, b) {
 
 function extractLessonsFromSession(state, personaId) {
   var entry = state.persona_outputs && state.persona_outputs[personaId];
-  if (!entry || entry.accepted !== true) return [];
+  // Learn from rejections too — a correction is the most informative signal
+  // we get. accepted === null means the designer never reacted; skip those.
+  if (!entry || entry.accepted === null || entry.accepted === undefined) return [];
+  var polarity = entry.accepted === true ? 'positive' : 'negative';
 
   var outcomeVal = 'unknown';
   if (state.outcome && state.outcome.confirmed && state.outcome.confirmed[personaId]) {
@@ -80,6 +99,7 @@ function extractLessonsFromSession(state, personaId) {
           pattern: pattern,
           fix: fix,
           outcome: outcomeVal,
+          polarity: polarity,
           session_id: state.project_id,
           extracted_at: new Date().toISOString(),
           citation: entry.citations ? entry.citations[0] : ''
@@ -88,6 +108,30 @@ function extractLessonsFromSession(state, personaId) {
     }
   }
 
+  // A rejection carries the designer's own correction — the highest-value
+  // lesson available. Pull it from the most recent negative feedback entry.
+  if (polarity === 'negative') {
+    var log = state.feedback_log || [];
+    for (var f = log.length - 1; f >= 0; f--) {
+      if (log[f].persona !== personaId || log[f].satisfied !== false) continue;
+      var corrective = String(log[f].correction || log[f].comment || '').trim();
+      if (!corrective) break;
+      lessons.push({
+        id: require('crypto').randomBytes(6).toString('hex'),
+        persona: personaId,
+        task_type: state.task_type || '',
+        pattern: 'Designer rejected this note: ' + corrective,
+        fix: corrective,
+        outcome: outcomeVal,
+        polarity: 'negative',
+        session_id: state.project_id,
+        extracted_at: new Date().toISOString(),
+        citation: ''
+      });
+      break;
+    }
+  }
+
   var hierarchyMatch = text.match(/Hierarchy\[([A-F])\]/gi);
   if (hierarchyMatch) {
     for (var j = 0; j < hierarchyMatch.length; j++) {
@@ -99,6 +143,7 @@ function extractLessonsFromSession(state, personaId) {
         pattern: pattern2,
         fix: 'Review visual hierarchy per DS tokens',
         outcome: outcomeVal,
+        polarity: polarity,
         session_id: state.project_id,
         extracted_at: new Date().toISOString(),
         citation: ''
@@ -123,8 +168,7 @@ function extractLessons(opts) {
 
     var lessons = extractLessonsFromSession(state, persona);
     for (var j = 0; j < lessons.length; j++) {
-      appendLesson(persona, lessons[j]);
-      total++;
+      if (appendLesson(persona, lessons[j])) total++;
     }
   }
 
@@ -148,8 +192,7 @@ function extractAllLessons(opts) {
       var pers = personas[p];
       var lessons = extractLessonsFromSession(state, pers);
       for (var j = 0; j < lessons.length; j++) {
-        appendLesson(pers, lessons[j]);
-        total++;
+        if (appendLesson(pers, lessons[j])) total++;
       }
     }
   }

package/dist/lib/mcp-server.js

@@ -290,6 +290,29 @@ var TOOLS = [
   },
 ];
 
+// The one line every persona closes with. Deliberately host-neutral: the
+// designer answers in plain language and the agent picks the transport
+// (Bash on Claude Code/Cursor, analyzthis_accept on Desktop).
+var ASK_LINE = '\u2014\nWas this right? Say yes, or no plus one sentence. I\'ll record it.';
+
+var ACCEPT_TOOL = {
+  name: 'analyzthis_accept',
+  description: 'Record the designer\'s reaction to a persona note. Call this whenever they approve, '
+    + 'push back on, or correct a persona (\"that\'s right\", \"no, the hierarchy is backwards\"). '
+    + 'This is how personas earn or lose trust — without it they never improve. '
+    + 'persona is optional: the last one that spoke is inferred.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      keep: { type: 'boolean', description: 'true = the note was right; false = it was wrong or needed rework' },
+      persona: { type: 'string', description: 'Optional. zara, arjun, meera, priya, noor, anuj, raj, kavi. Inferred if omitted.' },
+      because: { type: 'string', description: 'Required when keep is false: one sentence on what was wrong or what they did instead' },
+      comment: { type: 'string', description: 'Optional note when keep is true' },
+    },
+    required: ['keep'],
+  },
+};
+
 var ROUTER_TOOL = {
   name: 'analyzthis_design',
   description: 'Design team router. Set who to zara, arjun, noor, anuj, meera, priya, raj, kavi, orchestrator, ux-ideator, design-critic, ux-story-gate, design-director, or mood-board. Returns a short skill front — call analyzthis_retrieve for the rest.',
@@ -306,7 +329,14 @@ var ROUTER_TOOL = {
 
 var RECEIPT_TOOL = {
   name: 'analyzthis_receipt',
-  description: 'Show inferred token receipt for this project. Not a bill. Do not invent a dollar figure.',
+  description: 'Show inferred token receipt for this project, and optionally how much each persona is worth listening to. Not a bill. Do not invent a dollar figure.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      project: { type: 'string', description: 'Optional project id' },
+      scores: { type: 'boolean', description: 'Include the persona trust scoreboard' },
+    },
+  },
   inputSchema: {
     type: 'object',
     properties: {
@@ -322,9 +352,9 @@ function resolveCatalog(explicit) {
 
 function listedTools(catalog) {
   if (resolveCatalog(catalog) === 'full') {
-    return TOOLS.concat([ROUTER_TOOL, RECEIPT_TOOL]);
+    return TOOLS.concat([ROUTER_TOOL, ACCEPT_TOOL, RECEIPT_TOOL]);
   }
-  return [ROUTER_TOOL, TOOLS.find(function (t) { return t.name === 'analyzthis_retrieve'; }), TOOLS.find(function (t) { return t.name === 'analyzthis_session'; }), RECEIPT_TOOL].filter(Boolean);
+  return [ROUTER_TOOL, ACCEPT_TOOL, TOOLS.find(function (t) { return t.name === 'analyzthis_retrieve'; }), TOOLS.find(function (t) { return t.name === 'analyzthis_session'; }), RECEIPT_TOOL].filter(Boolean);
 }
 
 // ── Tool handlers ────────────────────────────────────────────────────────
@@ -372,6 +402,8 @@ function handleToolCall(name, args) {
       return handleRouter(args);
     case 'analyzthis_receipt':
       return handleReceipt(args);
+    case 'analyzthis_accept':
+      return handleAccept(args);
 
     default:
       return { error: 'Unknown tool: ' + name };
@@ -398,7 +430,8 @@ function handleSinglePersona(personaId, args) {
     (context ? '\n## Context\n' + context : '') +
     extra + '\n\n' +
     'Use the lite output contract. Call analyzthis_retrieve (kind=skill, file=' + personaId + ') only if you need the full lens. ' +
-    'Be specific — cite components, zones, and fixes. Do not give generic advice.';
+    'Be specific — cite components, zones, and fixes. Do not give generic advice.\n\n' +
+    'End your reply with this line, exactly:\n' + ASK_LINE;
 
   return { prompt: prompt, persona: personaId, task: task, verdicts: 1 };
 }
@@ -571,9 +604,43 @@ function handleRouter(args) {
   return handleCombinationPass(mapped, args);
 }
 
+function handleAccept(args) {
+  try {
+    var accept = require('./accept');
+    if (args.keep === false) {
+      return { result: JSON.stringify(accept.fix({
+        project: args.project,
+        persona: args.persona,
+        because: args.because || args.comment || '',
+      })) };
+    }
+    return { result: JSON.stringify(accept.keep({
+      project: args.project,
+      persona: args.persona,
+      comment: args.comment || '',
+      shipped: args.shipped !== false,
+    })) };
+  } catch (e) {
+    if (e.code === 'NEED_PERSONA') {
+      return { result: 'Which persona was that — Zara, Arjun, Meera, Priya, Noor, Anuj, or Raj? Ask the designer, then call again.' };
+    }
+    if (e.code === 'NEED_BECAUSE') {
+      return { result: 'Ask the designer one sentence on what was wrong, then call again with because.' };
+    }
+    return { error: e.message };
+  }
+}
+
 function handleReceipt(args) {
   var receipt = require('./receipt');
-  return { result: receipt.report({ project: args.project }) };
+  var out = receipt.report({ project: args.project });
+  if (args.scores) {
+    try {
+      var em = require('./evolution-metrics');
+      out += '\n\n' + em.formatEvolutionSummary(em.computeEvolutionMetrics());
+    } catch (e) { /* receipt must never fail for a scoreboard */ }
+  }
+  return { result: out };
 }
 
 function handleSession(args) {

package/dist/skills/accept/SKILL.md

@@ -23,28 +23,40 @@ You help a designer mark the last persona note (Zara, Arjun, …) so the team ca
    > Was this Zara, Arjun, Meera, Priya, Noor, Anuj, or Raj?
 
 5. On **skip**, you need one sentence (what was wrong, or what they did instead). If missing, ask **once**. Then stop asking.
-6. Run the CLI yourself. Do not ask them to copy commands.
+6. Record it using **whichever path this host gives you** — never ask the designer
+   to run anything:
 
-**Keep:**
+   - **Have Bash** (Claude Code, Cursor, a terminal)?
 
-```bash
-npx analyzthis_design accept --keep --persona zara
-```
+     ```bash
+     npx analyzthis_design accept --keep --persona zara
+     npx analyzthis_design accept --fix --persona zara --because "one sentence from the designer"
+     ```
 
-**Skip:**
+   - **MCP only** (Claude Desktop — there is no terminal, so the commands above
+     cannot run)? Call the **`analyzthis_accept`** tool:
 
-```bash
-npx analyzthis_design accept --fix --persona zara --because "one sentence from the designer"
-```
+     ```
+     analyzthis_accept  { keep: true,  persona: "zara" }
+     analyzthis_accept  { keep: false, persona: "zara", because: "one sentence" }
+     ```
 
-Change `zara` to the persona they used. If they already named it in `/accept yes zara`, pass that.
+     `persona` is optional — the last persona that spoke is inferred.
 
-7. Reply in **one or two short sentences**. Example: “Saved. Zara’s note is marked keep.” or “Saved. We logged your fix so the team can learn.” After a skip, you may mention they can type `/share` to send it to the package. No JSON. No dollar figures. No flag tutorial unless the command failed.
+   Both paths write identical state. Change `zara` to the persona they used.
 
-## If the command failed
+7. Reply in **one or two short sentences**. Example: "Saved. Zara's note is marked keep."
+   or "Saved. We logged your fix so the team can learn." After a skip, you may mention
+   they can type `/share` to send it to the package. No JSON. No dollar figures. No flag
+   tutorial unless the command failed.
+
+## If it failed
 
 Say what happened in plain language. If it asks which persona or for one sentence, ask the designer that — still no flags.
 
+If Bash is unavailable and `analyzthis_accept` is not in your tool list, say the note
+could not be recorded on this host — do not pretend it was saved.
+
 ## Do not
 
 - Invent a monthly cost or a verified token bill

package/dist/skills/devi/SKILL.md

@@ -112,3 +112,25 @@ If the prompt says **Rebuttal round N**, do not copy prior text. Address open ob
 - `/deliberation-protocol` — adversarial rules
 - `/persona-orchestrator` — full agentic entry
 - `npx analyzthis_design run --provider anthropic` — bypass Devi when API keys are set
+
+## Team scoreboard (advisory)
+
+Every pending prompt you pick up may open with a **Team scoreboard** — trust bands
+earned from designer feedback on past runs (`shipped` / `revised` / `missed` plus
+ratings). It is advisory input for synthesis, not an instruction.
+
+**Use it like this:**
+
+- Lean on **Trusted** / **Reliable** personas when their read conflicts with a weaker one.
+- Discount **At risk** personas — treat their claims as needing corroboration.
+- Say the lean in **one line**, e.g. "Weighted toward Meera (Trusted, 6 shipped) over Priya (At risk) on the effort call."
+
+**Never:**
+
+- Drop a persona from the run, or skip writing their output. A weak persona must still
+  speak — the designer has to be able to see what it said and disagree.
+- Treat a band as a verdict. It reflects past runs, not this screen.
+- Show the scoreboard to the designer unless they ask. It is context, not output.
+
+Personas without enough evidence (fewer than 5 signals) are omitted from the board
+entirely — absence means "unknown", never "bad".

package/dist/skills/evolve-check/SKILL.md

@@ -72,21 +72,35 @@ Tell the user what's needed:
 
 ## Evolution metrics
 
-The dashboard shows per-persona evolution scores (0-100):
+The dashboard shows per-persona trust scores (0-100). A persona **starts at 50**
+and moves in both directions, so a rejection genuinely costs it.
 
 | Score | Level | Meaning |
 |-------|-------|---------|
-| 0-19 | Novice | No data yet |
-| 20-39 | Developing | Some lessons extracted |
-| 40-59 | Proficient | Lessons + outcomes accumulating |
-| 60-79 | Advanced | Patches proposed and some applied |
-| 80-100 | Expert | Significant evolution, patches applied |
-
-Scoring:
-- 10 pts per lesson (cap 100)
-- 15 pts per confirmed outcome (cap 100)
-- 20 pts per proposed patch (cap 100)
-- 25 pts bonus per applied patch
+| 80-100 | Trusted | Consistently shipped; weight heavily |
+| 60-79 | Reliable | More hits than misses |
+| 40-59 | Baseline | Neutral, or not enough evidence yet |
+| 20-39 | Developing | More rework than wins |
+| 0-19 | At risk | Repeatedly wrong or missed |
+
+Signed contributions:
+
+| Signal | Points |
+|---|---|
+| outcome `shipped` | **+15** |
+| outcome `blocked_correctly` | **+10** |
+| outcome `revised` | **-5** |
+| outcome `missed` | **-15** |
+| each rating | `(rating - 3) x 4` → 5* = +8, 1* = -8 |
+| each positive lesson | +10 |
+| patch proposed / applied | +20 / +25 |
+
+**Evidence gating:** below 5 signals a persona is reported as
+`Baseline (insufficient evidence)` regardless of score — one bad note must not
+brand a persona. Scores are derived on read, so changing weights re-scores history
+with no migration.
+
+Scope is **global per persona** by default. Pass `--project` to scope down.
 
 ## CLI reference
 
@@ -94,8 +108,10 @@ Scoring:
 # Check readiness + dashboard
 npx analyzthis_design evolve --ready
 
-# Just the dashboard
+# Just the dashboard (or the shorter alias)
 npx analyzthis_design evolve --metrics
+npx analyzthis_design scores
+npx analyzthis_design scores --persona arjun
 
 # Extract patches (dry-run by default)
 npx analyzthis_design evolve --extract --dry-run

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "analyzthis_design",
-  "version": "2.4.1",
-  "description": "8 AI design personas — v2.2 project-scoped knowledge bank (no cross-project vault entanglement), v2.0 chunked execution with frontier planner + free/cheap chunk models, adversarial deliberation loops, opt-in community feedback, Kavi knowledge collection, DesignSpec producer path, wireframe skills, UX critique, Agent Skills for Cursor, Claude, Codex, Grok, Windsurf. Plain source — no obfuscation, no auto-install.",
+  "version": "2.5.0",
+  "description": "8 AI design personas \u2014 v2.2 project-scoped knowledge bank (no cross-project vault entanglement), v2.0 chunked execution with frontier planner + free/cheap chunk models, adversarial deliberation loops, opt-in community feedback, Kavi knowledge collection, DesignSpec producer path, wireframe skills, UX critique, Agent Skills for Cursor, Claude, Codex, Grok, Windsurf. Plain source \u2014 no obfuscation, no auto-install.",
   "keywords": [
     "cursor",
     "cursor-skill",
@@ -46,5 +46,9 @@
   },
   "engines": {
     "node": ">=16"
+  },
+  "devDependencies": {
+    "@neon/config": "^1.2.0",
+    "@neon/env": "^1.2.0"
   }
 }

package/scripts/validate-csvs.js

@@ -180,6 +180,26 @@ for (var fileKey in schema.files) {
   }
 }
 
+// ── website/system-prompt.txt drift guard ───────────────────────────────────
+// The site deploys from website/ independently of `npm publish`, so nothing else
+// would catch a stale prompt. Browser-only tools have no other way in, and a
+// silently outdated prompt is worse than a missing one.
+(function checkSystemPrompt() {
+  var promptPath = path.join(__dirname, '..', 'website', 'system-prompt.txt');
+  if (!fs.existsSync(promptPath)) {
+    errors.push('website/system-prompt.txt is missing — run: npm run build');
+    return;
+  }
+  try {
+    var expected = require(path.join(__dirname, '..', 'lib', 'system-prompt.js')).buildPrompt({ mode: 'both' });
+    if (fs.readFileSync(promptPath, 'utf8') !== expected) {
+      errors.push('website/system-prompt.txt is out of date — run: npm run build');
+    }
+  } catch (e) {
+    errors.push('could not verify website/system-prompt.txt: ' + e.message);
+  }
+})();
+
 // Report
 if (warnings.length) {
   console.log('\n── Warnings ──');