seo-intel 1.5.38 → 1.5.40

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 1.5.40 (2026-05-28)
+
+### Setup wizard — daily notifications now self-install
+The notify loop is now opt-in via a single click. Setup-wizard's Done step gains a small "Daily problem notifications" card that toggles a managed `crontab` line via `lib/cron.js`. No more manual `crontab -e`.
+
+- **New CLI:** `seo-intel install-cron [--schedule "0 9 * * *"] [--open] [--remove]` — install / replace / remove a managed cron line. Idempotent. macOS + Linux. Windows returns a clear "use Task Scheduler" message.
+- **New library:** `lib/cron.js` exports `installNotifyCron`, `removeNotifyCron`, `getNotifyCronStatus`. Uses a `# managed-by-seo-intel` marker comment so we only touch our own entries — the user's other cron jobs are never modified.
+- **Setup wizard card** (Step 6, Done): live status pill, one-click Enable/Disable button, default schedule 9am daily, intel-blue accent matching the visual brief tokens. Polls `/api/setup/cron` on step entry; toggle hits `/api/setup/cron POST { action: 'install'|'remove' }`.
+- Cron line writes the absolute `process.execPath` so the scheduled job works regardless of the user's PATH inside cron's minimal environment (a classic foot-gun avoided).
+
+Full lifecycle verified: status read → install (`0 9 * * *` line written, crontab confirms) → status reports installed → remove → crontab clean → status reports clean. Smoke 10/10.
+
+## 1.5.39 (2026-05-27)
+
+### Dashboard — Problems card as the landing surface (Ahrefs-style "what's broken")
+The biggest UX shift since MCP shipped. Opening the dashboard now greets the user with a unified Problems card at the very top of every project panel — same data backing the `list_problems` MCP tool, finally surfaced for humans too.
+
+- **New `buildProblemsCard()`** renders Ahrefs-style: big counters (Critical / Warn / Info) using the v1.5.33 visual-brief `.vb-score-big` numerals, top 12 issues table with severity dots, category, fix-difficulty stars (1–5), and an expandable "Fix" disclosure per row showing the agent-friendly `fix_template`.
+- Single source of truth: same `getProblems()` library function that powers `list_problems` MCP tool. Dashboard and AI agents see identical data; closing one closes both.
+- "Showing top 12 of 190 — query the rest via MCP: `list_problems("carbium", limit=190)`" — makes the agent escape hatch visible from the dashboard itself.
+- Empty state: "all clear" message when no problems pending.
+
+### Dashboard — AI Citability card polished to brief spec
+- Inline colors (`#4ade80`, `#facc15`, `#ff8c00`, `#ef4444`) swapped to brief signal tokens (`var(--signal-good)`, `var(--signal-warn)`, `var(--signal-bad)`). One color system, no drift.
+- Score gradient aligned with `lib/problems.js` severity buckets: ≥60 good, 35–59 warn, <35 bad.
+- New `.vb-pill` header chip with the "weakest signal" caption ("weakest: answer density") so the user sees the headline takeaway at a glance.
+- Existing signal bars + page-score table preserved — minimal disruption, maximum polish.
+
+**Verified live against carbium / risunouto / ukkometa:** 36 severity dots rendered across three Problems cards, 3 MCP-hint references, citability cards on each pro panel, no existing functionality broken. Smoke 10/10. HTML size unchanged (2.4MB).
+
+Next: setup-wizard cron-entry installer (v1.5.40), then per-page polish for Site Watch timeline / Competitive Radar / Action Export modal.
+
 ## 1.5.38 (2026-05-23)
 
 ### Fix — LM Studio model count was always 0 (wrong endpoint + wrong parser)

package/cli.js

@@ -1511,6 +1511,41 @@ program
     if (fired === 0) console.log(chalk.dim('  ✓ No projects need attention.'));
   });
 
+// ── INSTALL-CRON (one-shot cron entry for daily notify) ────────────────────
+program
+  .command('install-cron')
+  .description('Install / remove the daily seo-intel notify cron entry (macOS + Linux)')
+  .option('--remove', 'Remove the managed cron entry instead of installing')
+  .option('--schedule <cron>', 'Cron schedule, 5 fields (default: 9am daily)', '0 9 * * *')
+  .option('--open', 'Pass --open to the scheduled notify command (dashboard opens when fired)')
+  .action(async (opts) => {
+    const { installNotifyCron, removeNotifyCron, getNotifyCronStatus, DEFAULT_SCHEDULE } = await import('./lib/cron.js');
+    if (opts.remove) {
+      const r = removeNotifyCron();
+      if (!r.ok) { console.error(chalk.red(`Failed: ${r.error}`)); process.exit(1); }
+      console.log(chalk.green(r.removed ? '  ✓ Removed managed cron entry.' : '  (Nothing to remove.)'));
+      return;
+    }
+    const status = getNotifyCronStatus();
+    if (status.platform === 'win32') {
+      console.log(chalk.yellow('  ⚠ Windows: use Task Scheduler manually.'));
+      console.log(chalk.dim('  Daily task command:'));
+      console.log(chalk.dim(`    ${process.execPath} ${join(__dirname, 'cli.js')} notify`));
+      return;
+    }
+    if (status.installed) {
+      console.log(chalk.dim(`  Existing entry detected (schedule: ${status.schedule}). Replacing…`));
+    }
+    const result = installNotifyCron({ schedule: opts.schedule, openOnFire: !!opts.open });
+    if (!result.ok) { console.error(chalk.red(`Failed: ${result.error}`)); process.exit(1); }
+    console.log(chalk.green(`  ✓ Daily notification scheduled (cron: ${result.schedule})`));
+    console.log(chalk.dim(`  Cron line: ${result.line}`));
+    console.log(chalk.dim(`  Remove with: seo-intel install-cron --remove`));
+    if (process.platform === 'darwin') {
+      console.log(chalk.dim(`  Note: macOS may prompt to authorise cron access on first fire — approve in System Settings if so.`));
+    }
+  });
+
 // ── STATUS ─────────────────────────────────────────────────────────────────
 program
   .command('status')

package/lib/cron.js

@@ -0,0 +1,108 @@
+/**
+ * lib/cron.js — Install / remove the daily `seo-intel notify` cron entry.
+ *
+ * The "user forgets to check SEO" defense from v1.5.34's delivery brainstorm.
+ * Adds a single managed crontab line tagged with a marker comment so we can
+ * find and replace/remove our own entry without touching the user's other
+ * cron jobs.
+ *
+ * macOS + Linux: uses crontab(1). On macOS the first install will prompt the
+ * user to approve calendar/automation access via the system permission dialog
+ * — that's normal, nothing we can do about it.
+ *
+ * Windows: returns ok:false with a hint pointing at Task Scheduler. Out of
+ * scope for v1.5.40.
+ */
+
+import { spawnSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, '..');
+const NODE_BIN = process.execPath;
+const MARKER = '# managed-by-seo-intel';
+
+export const DEFAULT_SCHEDULE = '0 9 * * *'; // 9am every day
+
+function readCrontab() {
+  const r = spawnSync('crontab', ['-l'], { encoding: 'utf8' });
+  if (r.status === 0) return r.stdout || '';
+  // status !== 0 typically means "no crontab for user yet" — return empty
+  return '';
+}
+
+function writeCrontab(content) {
+  const text = (content || '').replace(/\n*$/, '\n'); // ensure single trailing newline
+  const r = spawnSync('crontab', ['-'], { input: text, encoding: 'utf8' });
+  if (r.status !== 0) {
+    throw new Error(`crontab write failed: ${r.stderr || 'unknown error'}`);
+  }
+}
+
+function isWindows() { return process.platform === 'win32'; }
+
+/**
+ * @returns {{ installed: boolean, line: string|null, schedule: string|null, platform: string }}
+ */
+export function getNotifyCronStatus() {
+  if (isWindows()) return { installed: false, line: null, schedule: null, platform: 'win32' };
+  const lines = readCrontab().split('\n').filter(l => l.includes(MARKER));
+  if (!lines.length) return { installed: false, line: null, schedule: null, platform: process.platform };
+  const line = lines[0];
+  // Schedule is the first 5 space-separated fields
+  const parts = line.trim().split(/\s+/);
+  const schedule = parts.slice(0, 5).join(' ');
+  return { installed: true, line, schedule, platform: process.platform };
+}
+
+/**
+ * Install (or replace) the managed cron line.
+ *
+ * @param {object} [opts]
+ * @param {string} [opts.schedule]  Cron schedule, default DEFAULT_SCHEDULE (9am daily)
+ * @param {boolean} [opts.openOnFire]  Append `--open` flag so the dashboard opens when fired
+ * @returns {{ ok: boolean, line?: string, schedule?: string, error?: string, hint?: string }}
+ */
+export function installNotifyCron({ schedule = DEFAULT_SCHEDULE, openOnFire = false } = {}) {
+  if (isWindows()) {
+    return {
+      ok: false,
+      error: 'Windows not supported — use Task Scheduler manually',
+      hint: `Create a daily task running:  ${NODE_BIN} "${join(ROOT, 'cli.js')}" notify`,
+    };
+  }
+  // Sanity-check schedule (5 fields, no shell metachars)
+  if (!/^[-*\/0-9, ]+$/.test(schedule) || schedule.trim().split(/\s+/).length !== 5) {
+    return { ok: false, error: `Invalid cron schedule "${schedule}". Expected 5 fields, e.g. "0 9 * * *".` };
+  }
+  const cmd = `cd ${ROOT} && ${NODE_BIN} cli.js notify${openOnFire ? ' --open' : ''}`;
+  const newLine = `${schedule} ${cmd}  ${MARKER}`;
+  const current = readCrontab();
+  const kept = current.split('\n').filter(l => l && !l.includes(MARKER));
+  kept.push(newLine);
+  try {
+    writeCrontab(kept.join('\n'));
+    return { ok: true, line: newLine, schedule };
+  } catch (e) {
+    return { ok: false, error: e.message };
+  }
+}
+
+/**
+ * Remove the managed cron line (if any). Idempotent.
+ * @returns {{ ok: boolean, removed: boolean, error?: string }}
+ */
+export function removeNotifyCron() {
+  if (isWindows()) return { ok: true, removed: false }; // nothing to remove
+  const current = readCrontab();
+  const before = current.split('\n').filter(Boolean).length;
+  const kept = current.split('\n').filter(l => l && !l.includes(MARKER));
+  if (kept.length === before) return { ok: true, removed: false };
+  try {
+    writeCrontab(kept.join('\n'));
+    return { ok: true, removed: true };
+  } catch (e) {
+    return { ok: false, removed: false, error: e.message };
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seo-intel",
-  "version": "1.5.38",
+  "version": "1.5.40",
   "description": "Local Ahrefs-style SEO competitor intelligence. Crawl → SQLite → cloud analysis.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",

package/reports/generate-html.js

@@ -21,6 +21,7 @@ import { isPro } from '../lib/license.js';
 import { getActiveInsights } from '../db/db.js';
 import { getCitabilityScores } from '../analyses/aeo/index.js';
 import { getWatchData } from '../analyses/watch/index.js';
+import { getProblems, getProblemCounts } from '../lib/problems.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
@@ -127,6 +128,14 @@ export function gatherProjectData(db, project, config) {
   let citabilityData = null;
   try { citabilityData = getCitabilityScores(db, project); } catch { /* table may not exist yet */ }
 
+  // Problems (v1.5.39) — unified Ahrefs-style "what's broken" feed
+  let problems = [];
+  let problemCounts = null;
+  try {
+    problems = getProblems(db, project, { includePaid: isPro(), limit: 200 });
+    problemCounts = getProblemCounts(db, project, { includePaid: isPro() });
+  } catch { /* fresh DB / migration not run yet — silent */ }
+
   // Site Watch data
   let watchData = null;
   try { watchData = getWatchData(db, project); } catch { /* tables may not exist yet */ }
@@ -155,6 +164,7 @@ export function gatherProjectData(db, project, config) {
     gravityMap, contentTerrain, keywordVenn, performanceBubbles,
     headingFlow, territoryTreemap, topicClusters, linkDna, linkRadarPulse,
     keywordsReport, extractionStatus, gscData, domainArch, gscInsights, citabilityData, watchData,
+    problems, problemCounts,
   };
 
   // Rollback the owned→target merge so the actual DB is unchanged
@@ -227,6 +237,7 @@ function buildHtmlTemplate(data, opts = {}) {
     gravityMap, contentTerrain, keywordVenn, performanceBubbles,
     headingFlow, territoryTreemap, topicClusters, linkDna, linkRadarPulse,
     keywordsReport, extractionStatus, gscData, domainArch, gscInsights, citabilityData, watchData,
+    problems = [], problemCounts = null,
   } = data;
 
   const totalPages = domains.reduce((sum, d) => sum + d.page_count, 0);
@@ -2979,6 +2990,9 @@ function buildHtmlTemplate(data, opts = {}) {
 
   <div class="dashboard">
 
+    <!-- ═══ PROBLEMS (v1.5.39 — Ahrefs-style landing card) ═══ -->
+    ${buildProblemsCard(problems, problemCounts, escapeHtml, project)}
+
     <!-- ═══ GSC PERFORMANCE TREND ═══ -->
     ${gscData ? (() => {
       const s = gscData.summary;
@@ -5849,6 +5863,115 @@ function buildMultiHtmlTemplate(allProjectData) {
 
 // ─── AEO Card Builder ────────────────────────────────────────────────────────
 
+// ─── Problems card (v1.5.39) — Ahrefs-style unified "what's broken" feed ──
+// Uses lib/problems.js getProblems() — single source of truth shared with MCP.
+function buildProblemsCard(problems, counts, escapeHtml, project) {
+  if (!counts || counts.total === 0) {
+    return `
+      <div class="card full-width vb-card" id="problems-card" style="margin-bottom: 24px;">
+        <div style="display:flex; align-items:center; gap:14px; margin-bottom:14px;">
+          <span class="vb-pill">Problems</span>
+          <span class="vb-label-caps">all clear</span>
+        </div>
+        <div style="color: var(--text-muted); font-size: 0.85rem;">
+          <i class="fa-solid fa-check" style="color: var(--signal-good); margin-right: 6px;"></i>
+          No pending issues detected for this project. Run a fresh crawl to refresh detection.
+        </div>
+      </div>`;
+  }
+
+  const sev = (s) => s === 'critical' ? 'crit' : s === 'warn' ? 'warn' : 'info';
+  const sevColor = (s) => s === 'critical' ? 'var(--signal-bad)' : s === 'warn' ? 'var(--signal-warn)' : 'var(--signal-good)';
+  const sevLabel = (s) => s.toUpperCase();
+  const diffStars = (n) => '●'.repeat(Math.max(1, Math.min(5, n))) + '○'.repeat(5 - Math.max(1, Math.min(5, n)));
+
+  const top = problems.slice(0, 12);
+  const remaining = problems.length - top.length;
+
+  const rows = top.map(p => {
+    const sevClass = sev(p.severity);
+    const sevCol = sevColor(p.severity);
+    const fix = (p.fix_template || '').slice(0, 200);
+    const urls = (p.affected_urls || []).slice(0, 3).map(u => {
+      try { return new URL(u).pathname || u; } catch { return u.slice(0, 50); }
+    });
+    return `
+      <tr data-problem-id="${escapeHtml(p.id)}">
+        <td style="vertical-align:top; padding-top: 14px;">
+          <span class="vb-severity-dot ${sevClass}"></span>
+        </td>
+        <td style="vertical-align:top;">
+          <div style="font-family: var(--font-display); font-weight: 700; font-size: 0.92rem; color: var(--text-primary); line-height: 1.3;">${escapeHtml(p.title)}</div>
+          <div style="font-size: 0.72rem; color: var(--text-muted); margin-top: 4px; line-height: 1.5;">${escapeHtml(p.description)}</div>
+          ${urls.length ? `<div class="vb-num-tabular" style="font-size: 0.68rem; color: var(--text-subtle); margin-top: 4px;">${urls.map(u => `<code style="background:transparent;">${escapeHtml(u)}</code>`).join(' · ')}</div>` : ''}
+        </td>
+        <td style="vertical-align:top; padding-top: 14px;">
+          <span class="vb-label-caps" style="color: ${sevCol};">${sevLabel(p.severity)}</span>
+          <div style="font-size: 0.65rem; color: var(--text-muted); margin-top: 2px;">${escapeHtml(p.category)}</div>
+        </td>
+        <td style="vertical-align:top; padding-top: 14px;" title="Fix difficulty: ${p.fix_difficulty}/5">
+          <span style="color: var(--intel-blue); font-size: 0.7rem; letter-spacing: 1px;">${diffStars(p.fix_difficulty)}</span>
+        </td>
+        <td style="vertical-align:top; padding-top: 12px;">
+          <details style="font-size: 0.7rem;">
+            <summary style="cursor:pointer; color: var(--intel-blue); font-weight: 600; user-select: none;">Fix</summary>
+            <div style="margin-top: 8px; padding: 10px; background: var(--surface-off); border-left: 2px solid var(--intel-blue); color: var(--text-secondary); line-height: 1.5; font-size: 0.72rem;">${escapeHtml(fix)}${(p.fix_template || '').length > 200 ? '…' : ''}</div>
+          </details>
+        </td>
+      </tr>`;
+  }).join('');
+
+  return `
+    <div class="card full-width vb-card" id="problems-card" style="margin-bottom: 24px;">
+      <div style="display:flex; align-items:center; gap:14px; margin-bottom: 18px; flex-wrap: wrap;">
+        <span class="vb-pill">Problems</span>
+        <span style="font-family: var(--font-display); font-weight: 700; font-size: 1.4rem; color: var(--text-primary); letter-spacing: -0.02em;">${counts.total} issue${counts.total === 1 ? '' : 's'} pending</span>
+        <span class="vb-label-caps" style="margin-left:auto; color: var(--text-subtle);">ahrefs-style site health</span>
+      </div>
+
+      <div style="display:flex; gap: 32px; margin-bottom: 24px; padding-bottom: 20px; border-bottom: 1px solid var(--surface-border); flex-wrap: wrap;">
+        <div>
+          <div class="vb-score-big ${counts.critical > 0 ? 'bad' : 'good'}">${counts.critical}</div>
+          <div class="vb-label-caps" style="margin-top: 6px;">critical</div>
+        </div>
+        <div>
+          <div class="vb-score-big ${counts.warn > 9 ? 'warn' : 'good'}">${counts.warn}</div>
+          <div class="vb-label-caps" style="margin-top: 6px;">warn</div>
+        </div>
+        <div>
+          <div class="vb-score-big good">${counts.info}</div>
+          <div class="vb-label-caps" style="margin-top: 6px;">info</div>
+        </div>
+        <div style="margin-left:auto; max-width: 420px; align-self: center;">
+          <div style="font-size: 0.78rem; color: var(--text-secondary); line-height: 1.6;">
+            Each problem ships with a <strong style="color: var(--intel-blue);">fix template</strong> and <strong style="color: var(--intel-blue);">verification</strong> step — copy the Fix into an AI agent (via MCP <code style="color: var(--text-primary); background: var(--surface-off); padding: 1px 5px; border-radius: 3px; font-size: 0.7rem;">list_problems</code>) or apply manually.
+          </div>
+        </div>
+      </div>
+
+      <table class="analysis-table" style="margin: 0;">
+        <thead>
+          <tr>
+            <th style="width: 28px;"></th>
+            <th>Issue</th>
+            <th style="width: 90px;">Severity</th>
+            <th style="width: 90px;">Difficulty</th>
+            <th style="width: 100px;">Action</th>
+          </tr>
+        </thead>
+        <tbody>${rows}</tbody>
+      </table>
+
+      ${remaining > 0 ? `
+        <div style="margin-top: 16px; padding-top: 14px; border-top: 1px solid var(--surface-border); text-align: center;">
+          <span style="color: var(--text-muted); font-size: 0.78rem;">
+            Showing top ${top.length} of ${counts.total} — query the rest via MCP:
+            <code style="color: var(--intel-blue); background: var(--surface-off); padding: 2px 6px; border-radius: 3px; margin-left: 4px;">list_problems("${escapeHtml(project)}", limit=${counts.total})</code>
+          </span>
+        </div>` : ''}
+    </div>`;
+}
+
 function buildAeoCard(citabilityData, escapeHtml, project) {
   const targetScores = citabilityData.filter(s => s.role === 'target' || s.role === 'owned');
   const compScores = citabilityData.filter(s => s.role === 'competitor');
@@ -5867,7 +5990,8 @@ function buildAeoCard(citabilityData, escapeHtml, project) {
     avg: Math.round(targetScores.reduce((a, s) => a + (s[sig] || 0), 0) / targetScores.length),
   }));
 
-  const scoreColor = (s) => s >= 75 ? '#4ade80' : s >= 55 ? '#facc15' : s >= 35 ? '#ff8c00' : '#ef4444';
+  // Brief gradient: 0–34 bad, 35–59 warn, 60+ good (matches lib/problems.js severity)
+  const scoreColor = (s) => s >= 60 ? 'var(--signal-good)' : s >= 35 ? 'var(--signal-warn)' : 'var(--signal-bad)';
 
   // Page rows (worst first, limit 25)
   const pageRows = targetScores
@@ -5908,20 +6032,28 @@ function buildAeoCard(citabilityData, escapeHtml, project) {
     compStatHtml += `<div class="ki-stat"><span class="ki-stat-number" style="color:${scoreColor(avgComp)}">${avgComp}</span><span class="ki-stat-label">Competitor Avg</span></div>`;
   }
   if (delta !== null) {
-    compStatHtml += `<div class="ki-stat"><span class="ki-stat-number" style="color:${delta >= 0 ? '#4ade80' : '#ef4444'}">${delta > 0 ? '+' : ''}${delta}</span><span class="ki-stat-label">Delta</span></div>`;
+    compStatHtml += `<div class="ki-stat"><span class="ki-stat-number" style="color:${delta >= 0 ? 'var(--signal-good)' : 'var(--signal-bad)'}">${delta > 0 ? '+' : ''}${delta}</span><span class="ki-stat-label">Delta</span></div>`;
   }
 
+  // Visual-brief pill header: pick the worst signal for the "weakest area" caption
+  const weakestSignal = [...signalAvgs].sort((a, b) => a.avg - b.avg)[0];
+
   return `
     <div class="card full-width" id="aeo-citability">
       ${cardExportHtml('aeo', project)}
-      <h2><span class="icon"><i class="fa-solid fa-robot"></i></span> AI Citability Audit</h2>
+      <div style="display:flex; align-items:center; gap: 14px; margin-bottom: 18px; flex-wrap: wrap;">
+        <span class="vb-pill">AI Citability</span>
+        <span style="font-family: var(--font-display); font-weight: 700; font-size: 1.4rem; color: var(--text-primary); letter-spacing: -0.02em;">${targetScores.length} pages scored</span>
+        ${weakestSignal ? `<span class="vb-label-caps" style="margin-left:auto; color: var(--text-subtle);">weakest: ${weakestSignal.label}</span>` : ''}
+      </div>
+      <h2 style="display:none;"><span class="icon"><i class="fa-solid fa-robot"></i></span> AI Citability Audit</h2>
       <div class="ki-stat-bar">
         <div class="ki-stat"><span class="ki-stat-number" style="color:${scoreColor(avgTarget)}">${avgTarget}</span><span class="ki-stat-label">Target Avg</span></div>
         ${compStatHtml}
-        <div class="ki-stat"><span class="ki-stat-number" style="color:#4ade80">${tierCounts.excellent}</span><span class="ki-stat-label">Excellent</span></div>
-        <div class="ki-stat"><span class="ki-stat-number" style="color:#facc15">${tierCounts.good}</span><span class="ki-stat-label">Good</span></div>
-        <div class="ki-stat"><span class="ki-stat-number" style="color:#ff8c00">${tierCounts.needs_work}</span><span class="ki-stat-label">Needs Work</span></div>
-        <div class="ki-stat"><span class="ki-stat-number" style="color:#ef4444">${tierCounts.poor}</span><span class="ki-stat-label">Poor</span></div>
+        <div class="ki-stat"><span class="ki-stat-number" style="color:var(--signal-good)">${tierCounts.excellent}</span><span class="ki-stat-label">Excellent</span></div>
+        <div class="ki-stat"><span class="ki-stat-number" style="color:var(--signal-warn)">${tierCounts.good}</span><span class="ki-stat-label">Good</span></div>
+        <div class="ki-stat"><span class="ki-stat-number" style="color:var(--signal-bad);opacity:0.85">${tierCounts.needs_work}</span><span class="ki-stat-label">Needs Work</span></div>
+        <div class="ki-stat"><span class="ki-stat-number" style="color:var(--signal-bad)">${tierCounts.poor}</span><span class="ki-stat-label">Poor</span></div>
       </div>
 
       <div style="display:flex;gap:2rem;margin:1.5rem 0;flex-wrap:wrap;">

package/setup/web-routes.js

@@ -128,6 +128,17 @@ export function handleSetupRequest(req, res, url) {
     return true;
   }
 
+  // GET /api/setup/cron — read notify-cron install state
+  if (path === '/api/setup/cron' && method === 'GET') {
+    handleCronStatus(req, res);
+    return true;
+  }
+  // POST /api/setup/cron — install / remove
+  if (path === '/api/setup/cron' && method === 'POST') {
+    handleCronAction(req, res);
+    return true;
+  }
+
   // POST /api/setup/save-env — save a key to .env
   if (path === '/api/setup/save-env' && method === 'POST') {
     handleSaveEnv(req, res);
@@ -341,6 +352,34 @@ async function handlePingOllama(req, res) {
   }
 }
 
+async function handleCronStatus(req, res) {
+  try {
+    const { getNotifyCronStatus } = await import('../lib/cron.js');
+    jsonResponse(res, getNotifyCronStatus());
+  } catch (err) {
+    jsonResponse(res, { error: err.message }, 500);
+  }
+}
+
+async function handleCronAction(req, res) {
+  try {
+    const body = await readBody(req);
+    const { action, schedule, openOnFire } = body || {};
+    const { installNotifyCron, removeNotifyCron, getNotifyCronStatus } = await import('../lib/cron.js');
+    if (action === 'install') {
+      const result = installNotifyCron({ schedule, openOnFire: !!openOnFire });
+      jsonResponse(res, { ...result, status: getNotifyCronStatus() });
+    } else if (action === 'remove') {
+      const result = removeNotifyCron();
+      jsonResponse(res, { ...result, status: getNotifyCronStatus() });
+    } else {
+      jsonResponse(res, { error: 'action must be "install" or "remove"' }, 400);
+    }
+  } catch (err) {
+    jsonResponse(res, { error: err.message }, 500);
+  }
+}
+
 async function handleSaveEnv(req, res) {
   try {
     const body = await readBody(req);

package/setup/wizard.html

@@ -1862,6 +1862,21 @@ input::placeholder {
       <!-- Populated by JS -->
     </table>
 
+    <!-- ── Daily notification scheduler (v1.5.40) ────────────────────────── -->
+    <div id="notifyCronCard" style="margin-top:20px; padding:14px 16px; background:var(--bg-elevated); border:1px solid rgba(59,130,246,0.18); border-radius:var(--radius); display:flex; gap:14px; align-items:center; flex-wrap:wrap;">
+      <i class="fa-solid fa-bell" style="font-size:1rem; color:#3b82f6;"></i>
+      <div style="flex:1; min-width:200px;">
+        <div style="font-size:0.8rem; font-weight:600; color:var(--text-primary); margin-bottom:2px;">Daily problem notifications</div>
+        <div id="notifyCronHint" style="font-size:0.66rem; color:var(--text-muted); line-height:1.4;">
+          Fires a native macOS / Linux notification each morning for projects with pending criticals or warns.
+        </div>
+      </div>
+      <div id="notifyCronStatus" style="font-size:0.66rem; color:var(--text-muted);">…</div>
+      <button id="notifyCronToggleBtn" class="btn btn-sm" onclick="toggleNotifyCron()" style="padding:5px 12px; font-size:0.7rem; min-width:90px;">
+        <i class="fa-solid fa-spinner fa-spin"></i>
+      </button>
+    </div>
+
     <h3 style="font-family:var(--font-display); font-size:0.85rem; color:var(--text-primary); margin: 20px 0 12px; font-weight:600;">
       <i class="fa-solid fa-rocket" style="color:var(--accent-gold); margin-right:6px;"></i> What's Next
     </h3>
@@ -3409,6 +3424,64 @@ input::placeholder {
     }
 
     goToStep(6);
+    loadNotifyCronStatus();
+  };
+
+  // ── Daily notification cron (v1.5.40) ──────────────────────────────────
+  let _cronState = null;
+  async function loadNotifyCronStatus() {
+    const statusEl = document.getElementById('notifyCronStatus');
+    const btn = document.getElementById('notifyCronToggleBtn');
+    const hint = document.getElementById('notifyCronHint');
+    if (!statusEl || !btn) return;
+    try {
+      const s = await API.get('/api/setup/cron');
+      _cronState = s;
+      if (s.platform === 'win32') {
+        statusEl.textContent = 'Windows: use Task Scheduler';
+        btn.disabled = true;
+        btn.innerHTML = 'N/A';
+        hint.textContent = 'Cron auto-install is macOS / Linux only — set up a daily Task Scheduler entry manually.';
+        return;
+      }
+      if (s.installed) {
+        statusEl.innerHTML = `<span style="color:var(--color-success);"><i class="fa-solid fa-check"></i> Active · ${s.schedule}</span>`;
+        btn.innerHTML = '<i class="fa-solid fa-bell-slash"></i> Disable';
+        btn.style.borderColor = 'rgba(244,123,93,0.4)';
+        btn.style.color = '#f47b5d';
+      } else {
+        statusEl.innerHTML = `<span style="color:var(--text-muted);">Not scheduled</span>`;
+        btn.innerHTML = '<i class="fa-solid fa-bell"></i> Enable';
+        btn.style.borderColor = 'rgba(59,130,246,0.4)';
+        btn.style.color = '#3b82f6';
+      }
+      btn.disabled = false;
+    } catch (err) {
+      statusEl.textContent = 'Status check failed';
+      btn.disabled = true;
+    }
+  }
+
+  window.toggleNotifyCron = async function() {
+    const btn = document.getElementById('notifyCronToggleBtn');
+    if (!btn || btn.disabled) return;
+    btn.disabled = true;
+    btn.innerHTML = '<i class="fa-solid fa-spinner fa-spin"></i>';
+    const action = _cronState?.installed ? 'remove' : 'install';
+    try {
+      const r = await API.post('/api/setup/cron', { action, schedule: '0 9 * * *' });
+      if (r.ok === false && r.error) {
+        document.getElementById('notifyCronStatus').textContent = 'Error: ' + r.error;
+        btn.disabled = false;
+        btn.innerHTML = '<i class="fa-solid fa-triangle-exclamation"></i> Retry';
+        return;
+      }
+      await loadNotifyCronStatus();
+    } catch (err) {
+      document.getElementById('notifyCronStatus').textContent = 'Error: ' + err.message;
+      btn.disabled = false;
+      btn.innerHTML = '<i class="fa-solid fa-triangle-exclamation"></i> Retry';
+    }
   };
 
   window.copyCli = function() {