six-degrees 0.2.1 → 0.3.0

package/.next/standalone/app/launch/page.js

@@ -2,6 +2,7 @@
 
 import { useEffect, useState, useRef, useCallback } from 'react';
 import Link from 'next/link';
+import { SAMPLE_STATS } from '../../lib/sample-stats';
 
 // ── Intersection Observer hook for scroll-triggered animations ──
 function useInView(options = {}) {
@@ -177,13 +178,15 @@ function HeroSection() {
 // ═══════════════════════════════════════════════════════════════
 // STATS BAR — Animated counters
 // ═══════════════════════════════════════════════════════════════
+// The numbers on this page are the invented sample network's
+// (lib/sample-stats.js), never one person's real network.
 function StatsBar() {
   const [ref, inView] = useInView();
   const stats = [
-    { label: 'Connections Mapped', value: 2438, color: '#3498DB' },
-    { label: 'Bridges Discovered', value: 25, color: '#FFD700' },
-    { label: 'Power Scored', value: 575, color: '#9B59B6' },
-    { label: 'Degrees Deep', value: 6, color: '#00ff88' },
+    { label: 'Connections Mapped', value: SAMPLE_STATS.connections, color: '#3498DB' },
+    { label: 'Bridges Discovered', value: SAMPLE_STATS.bridges, color: '#FFD700' },
+    { label: 'People Scored', value: SAMPLE_STATS.people, color: '#9B59B6' },
+    { label: 'Companies', value: SAMPLE_STATS.companies, color: '#00ff88' },
   ];
   return (
     <section ref={ref} style={{ padding: '80px 24px', borderTop: '1px solid rgba(255,255,255,0.05)', borderBottom: '1px solid rgba(255,255,255,0.05)' }}>
@@ -196,12 +199,14 @@ function StatsBar() {
           }}>
             <div style={{ fontSize: 48, fontWeight: 800, color: s.color, lineHeight: 1 }}>
               <Counter end={s.value} active={inView} />
-              {s.value > 100 ? '+' : ''}
             </div>
             <div style={{ fontSize: 13, color: '#666', marginTop: 8, fontWeight: 500, letterSpacing: 0.5 }}>{s.label}</div>
           </div>
         ))}
       </div>
+      <p style={{ textAlign: 'center', fontSize: 12, color: '#555', margin: '32px auto 0', maxWidth: 520 }}>
+        Counted from the sample network that comes with the app. Every person in it is invented.
+      </p>
     </section>
   );
 }
@@ -315,9 +320,10 @@ function GalaxySection() {
 function ChainSection() {
   const [ref, inView] = useInView();
   const degrees = [
-    { d: 1, label: 'Your Connections', desc: 'Direct network — scored & tiered', color: '#3498DB', count: 575 },
-    { d: 2, label: 'Bridge Connections', desc: 'Friends of your bridges', color: '#9B59B6', count: 1519 },
-    { d: 3, label: 'Extended Reach', desc: 'Bridged from promoted D2s', color: '#FFD700', count: 344 },
+    // The sample's counts; it maps two degrees.
+    { d: 1, label: 'Your Connections', desc: 'Direct network — scored & tiered', color: '#3498DB', count: SAMPLE_STATS.degree1 },
+    { d: 2, label: 'Bridge Connections', desc: 'Friends of your bridges', color: '#9B59B6', count: SAMPLE_STATS.degree2 },
+    { d: 3, label: 'Extended Reach', desc: 'Bridged from promoted D2s', color: '#FFD700', count: null },
     { d: 4, label: 'Industry Layer', desc: 'Company & sector intelligence', color: '#FF6B35', count: null },
     { d: 5, label: 'Market Layer', desc: 'Cross-industry connections', color: '#00ff88', count: null },
     { d: 6, label: 'Global Reach', desc: 'Anyone in the world', color: '#ff5050', count: null },
@@ -396,6 +402,9 @@ function ChainSection() {
             </div>
           ))}
         </div>
+        <p style={{ textAlign: 'center', fontSize: 12, color: '#555', marginTop: 40 }}>
+          The counts are the sample network&rsquo;s, whose people are all invented.
+        </p>
       </div>
     </section>
   );
@@ -407,7 +416,7 @@ function ChainSection() {
 function ScoringSection() {
   const [ref, inView] = useInView();
   const tiers = [
-    { tier: 'S', label: 'Supreme', score: '7.0+', color: TIER.S, glow: 'rgba(255,215,0,0.3)', people: 'C-Suite, VPs, Founders', icon: '👑' },
+    { tier: 'S', label: 'Supreme', score: '7.5+', color: TIER.S, glow: 'rgba(255,215,0,0.3)', people: 'C-Suite, VPs, Founders', icon: '👑' },
     { tier: 'A', label: 'Ace', score: '5.5+', color: TIER.A, glow: 'rgba(155,89,182,0.3)', people: 'Directors, Senior Leaders', icon: '💎' },
     { tier: 'B', label: 'Builder', score: '4.0+', color: TIER.B, glow: 'rgba(52,152,219,0.3)', people: 'Managers, Senior ICs', icon: '🔷' },
     { tier: 'C', label: 'Connector', score: '2.5+', color: TIER.C, glow: 'rgba(149,165,166,0.2)', people: 'Associates, Specialists', icon: '🔸' },
@@ -479,10 +488,10 @@ function FeaturesGrid() {
     {
       title: 'Paths',
       subtitle: 'Company Intelligence',
-      desc: 'Scan any company on LinkedIn and see every person mapped, scored, and organized by seniority. 80+ company normalizations built in.',
+      desc: 'Scan any company on LinkedIn and see every person mapped, scored, and organized by seniority.',
       color: '#00ff88',
       icon: '🏢',
-      stat: '344 people scanned',
+      stat: `${SAMPLE_STATS.companies} companies in the sample`,
     },
     {
       title: 'Outlink',
@@ -490,7 +499,7 @@ function FeaturesGrid() {
       desc: 'Your curated list of high-value D2 connections to request. Grouped by bridge, filtered by tier, with batch-open for efficient networking.',
       color: '#FF6B35',
       icon: '🚀',
-      stat: '798 recommendations',
+      stat: `${SAMPLE_STATS.recommendations} recommendations in the sample`,
     },
     {
       title: 'XP System',
@@ -506,7 +515,7 @@ function FeaturesGrid() {
       desc: 'Select any D1 connection as a bridge. Automatically discover and score all their connections — your D2 layer.',
       color: '#9B59B6',
       icon: '🔗',
-      stat: '25 bridges mapped',
+      stat: `${SAMPLE_STATS.bridges} bridges in the sample`,
     },
   ];
 
@@ -599,13 +608,14 @@ function TechSection() {
             background: GRADIENT, WebkitBackgroundClip: 'text', WebkitTextFillColor: 'transparent',
             marginBottom: 32,
           }}>
-            P = (S &times; 0.5) + (C &times; 0.3) + B
+            P = T &times; (0.45 + 0.055 &times; C) + R + B
           </div>
           <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr 1fr', gap: 24 }}>
             {[
-              { sym: 'S', label: 'Seniority', desc: 'VP = 8, Director = 6, Manager = 4', weight: '50%', color: TIER.S },
-              { sym: 'C', label: 'Company Prestige', desc: 'FAANG = 9, Fortune 500 = 7', weight: '30%', color: TIER.A },
-              { sym: 'B', label: 'Circle Bonus', desc: 'Inner circle proximity boost', weight: '20%', color: TIER.B },
+              // The model in lib/scoring.js: a product, so a title counts for more at a bigger company.
+              { sym: 'T', label: 'Title', desc: 'C-suite 10, VP 9, Director 7.5, Manager 6.5', note: 'Multiplied by the company', color: TIER.S },
+              { sym: 'C', label: 'Company', desc: 'Well-known 7–10, else estimated from your network', note: 'Weight 0.5 to 1.0', color: TIER.A },
+              { sym: 'R + B', label: 'Reach & bridge', desc: 'Investor, YC, an audience in the millions; a strong circle', note: 'Up to +1.5 and +1', color: TIER.B },
             ].map((item, i) => (
               <div key={i} style={{
                 padding: 16, borderRadius: 12, background: `${item.color}08`,
@@ -615,7 +625,7 @@ function TechSection() {
                 <div style={{ fontSize: 28, fontWeight: 900, color: item.color }}>{item.sym}</div>
                 <div style={{ fontSize: 13, fontWeight: 700, color: '#fff', marginTop: 4 }}>{item.label}</div>
                 <div style={{ fontSize: 10, color: '#555', marginTop: 4 }}>{item.desc}</div>
-                <div style={{ fontSize: 10, color: item.color, fontWeight: 700, marginTop: 8 }}>Weight: {item.weight}</div>
+                <div style={{ fontSize: 10, color: item.color, fontWeight: 700, marginTop: 8 }}>{item.note}</div>
               </div>
             ))}
           </div>
@@ -627,7 +637,7 @@ function TechSection() {
           opacity: inView ? 1 : 0, transition: 'opacity 1s ease 0.6s',
         }}>
           {[
-            { t: 'S', min: 7, color: TIER.S },
+            { t: 'S', min: 7.5, color: TIER.S },
             { t: 'A', min: 5.5, color: TIER.A },
             { t: 'B', min: 4, color: TIER.B },
             { t: 'C', min: 2.5, color: TIER.C },
@@ -751,7 +761,7 @@ function CTASection() {
           opacity: inView ? 0.4 : 0, transition: 'opacity 1.5s ease 0.5s',
         }}>
           <span style={{ fontSize: 12, color: '#444' }}>Built by Blake Burford</span>
-          <span style={{ fontSize: 12, color: '#444' }}>Stead Labs</span>
+          <span style={{ fontSize: 12, color: '#444' }}>Open source · MIT</span>
           <span style={{ fontSize: 12, color: '#444' }}>2026</span>
         </div>
       </div>

package/.next/standalone/app/page.js

@@ -240,6 +240,19 @@ function HomeInner() {
               Scan
             </Link>}
           </div>
+          {/* Settings — also in CSV/sample mode and on phones, so updates stay reachable */}
+          {!IS_DEMO && <Link
+            href="/settings"
+            title="Settings"
+            aria-label="Settings"
+            style={{
+              width: isMobile ? 28 : 32, height: isMobile ? 28 : 32, borderRadius: '50%', flexShrink: 0,
+              background: 'rgba(255,255,255,0.06)', color: '#888', fontSize: isMobile ? 14 : 16, textDecoration: 'none',
+              display: 'flex', alignItems: 'center', justifyContent: 'center', marginLeft: isMobile ? 4 : 8,
+            }}
+          >
+            {'\u2699\uFE0E'}
+          </Link>}
           {/* Notification bell */}
           {!IS_DEMO && !csvMode && <div style={{ position: 'relative', marginLeft: isMobile ? 4 : 8 }}>
             <button

package/.next/standalone/app/paths/page.js

@@ -1,6 +1,7 @@
 'use client';
 
-import { useEffect, useState } from 'react';
+import { Suspense, useEffect, useState } from 'react';
+import { useSearchParams } from 'next/navigation';
 import { runScrape, scraperStatus, notReadyMessage } from '../../lib/scraper-client';
 import { loadNetwork } from '../../lib/network';
 import { IS_DEMO } from '../../lib/demo';
@@ -13,9 +14,12 @@ import Link from 'next/link';
 import { companyOf, getSeniority } from '../../lib/companies';
 
 const TIER_COLORS = { S: '#FFD700', A: '#9B59B6', B: '#3498DB', C: '#95A5A6', D: '#BDC3C7' };
+const TABS = [['map', 'Map'], ['industries', 'Industries'], ['companies', 'Companies'], ['scores', 'Scores']];
 
 export default function PathsPage() {
-  return <OnboardingGate><PathsInner /></OnboardingGate>;
+  // Suspense because PathsInner reads the address's ?tab= (useSearchParams),
+  // which Next requires to sit inside one for the page to build.
+  return <OnboardingGate><Suspense><PathsInner /></Suspense></OnboardingGate>;
 }
 
 function PathsInner() {
@@ -28,7 +32,11 @@ function PathsInner() {
   const [d2Data, setD2Data] = useState([]);
   const [d3Data, setD3Data] = useState([]);
   // Map and Industries are the analyzer; Companies is the list it grew from.
-  const [tab, setTab] = useState('map');
+  // A link can open a tab (/paths?tab=scores, from Settings → Your sector).
+  // The router's search params rather than window.location: on a click from
+  // another page the address bar only changes after this page has rendered.
+  const asked = useSearchParams().get('tab');
+  const [tab, setTab] = useState(() => (TABS.some(([k]) => k === asked) ? asked : 'map'));
   // Bumped when company scores change, so the network reloads with new tiers.
   const [reloadKey, setReloadKey] = useState(0);
 
@@ -229,7 +237,7 @@ function PathsInner() {
           }}>Paths</h1>
           {!selectedCompany && (
             <div style={{ display: 'flex', gap: 4, marginLeft: 8, padding: 3, borderRadius: 8, background: 'rgba(255,255,255,0.05)' }}>
-              {[['map', 'Map'], ['industries', 'Industries'], ['companies', 'Companies'], ['scores', 'Scores']].map(([k, label]) => (
+              {TABS.map(([k, label]) => (
                 <button key={k} onClick={() => setTab(k)} style={{
                   padding: '5px 12px', borderRadius: 6, border: 'none', cursor: 'pointer', fontSize: 12.5, fontWeight: 700,
                   background: tab === k ? 'linear-gradient(135deg, #00ff88, #3498DB)' : 'transparent', color: tab === k ? '#000' : '#aab',

package/.next/standalone/app/profile/page.js

@@ -6,6 +6,7 @@ import MappingProgress from '../components/MappingProgress';
 import { IS_DEMO } from '../../lib/demo';
 import OnboardingGate from '../components/OnboardingGate';
 import { useUser } from '../components/UserProvider';
+import { sectorByKey } from '../../lib/sector-labels';
 import Link from 'next/link';
 
 const LEVEL_NAMES = {
@@ -32,11 +33,20 @@ function ProfileInner() {
   const [notifications, setNotifications] = useState([]);
   const [queueStats, setQueueStats] = useState({ total: 0, sent: 0, accepted: 0 });
   const [mapping, setMapping] = useState({ degree1: [], degree2: [], skips: [] });
+  // "Your Sectors" is what you picked in Settings → Your sector. (users.sectors,
+  // which this card used to show, is never written by anything; the Sidebar
+  // and Outlink still read it as free text.) null while it loads; a load that
+  // fails says so rather than showing "none picked" (TRAPS §7).
+  const [sectorFocus, setSectorFocus] = useState(null);
 
   useEffect(() => {
     if (IS_DEMO) return;
     if (!userId) return;
     async function load() {
+      fetch('/api/settings')
+        .then((r) => r.json().then((d) => (r.ok && d.settings ? d : Promise.reject(new Error(d.error)))))
+        .then((d) => setSectorFocus(d.settings.sectorFocus || { sectors: [], strength: 'lean' }))
+        .catch(() => setSectorFocus({ failed: true }));
       const net = await loadNetwork(userId);
       const d1 = net.degree1;
       const d2 = net.degree2;
@@ -364,15 +374,38 @@ function ProfileInner() {
           background: 'rgba(255,255,255,0.04)', borderRadius: 12, padding: 20,
           border: '1px solid rgba(255,255,255,0.08)',
         }}>
-          <h3 style={{ fontSize: 14, fontWeight: 700, marginTop: 0, marginBottom: 12 }}>Your Sectors</h3>
-          <div style={{ display: 'flex', flexWrap: 'wrap', gap: 6 }}>
-            {profile.sectors.map((s, i) => (
-              <span key={i} style={{
-                padding: '4px 12px', borderRadius: 20, fontSize: 11, fontWeight: 600,
-                background: 'rgba(52,152,219,0.15)', border: '1px solid rgba(52,152,219,0.3)', color: '#3498DB',
-              }}>{s}</span>
-            ))}
+          <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 12 }}>
+            <h3 style={{ fontSize: 14, fontWeight: 700, margin: 0 }}>Your Sectors</h3>
+            <Link href="/settings#sector" style={{ fontSize: 11, color: '#3498DB', textDecoration: 'none', fontWeight: 600 }}>
+              {sectorFocus?.sectors?.length ? 'Change' : sectorFocus && !sectorFocus.failed ? 'Pick in Settings' : 'Settings'} &rarr;
+            </Link>
           </div>
+          {!sectorFocus ? (
+            <div style={{ fontSize: 12, color: '#888' }}>Loading…</div>
+          ) : sectorFocus.failed ? (
+            <div style={{ fontSize: 12, color: '#ff7676' }}>
+              Couldn&rsquo;t load your sectors. Reload this page, or open Settings to see them.
+            </div>
+          ) : sectorFocus.sectors?.length ? (
+            <div style={{ display: 'flex', flexWrap: 'wrap', gap: 6, alignItems: 'center' }}>
+              {sectorFocus.sectors.map((key) => {
+                const ind = sectorByKey(key);
+                return (
+                  <span key={key} style={{
+                    padding: '4px 12px', borderRadius: 20, fontSize: 11, fontWeight: 600,
+                    background: `${ind.color}26`, border: `1px solid ${ind.color}66`, color: ind.color,
+                  }}>{ind.label}</span>
+                );
+              })}
+              <span style={{ fontSize: 11, color: '#888' }}>
+                {sectorFocus.strength === 'strong' ? 'Strong' : 'Lean'}: companies here count for more in your scores.
+              </span>
+            </div>
+          ) : (
+            <div style={{ fontSize: 12, color: '#888' }}>
+              None picked. Pick up to three in Settings and companies in them count for more in your scores.
+            </div>
+          )}
         </div>
 
       </div>

package/.next/standalone/app/queue/page.js

@@ -6,15 +6,21 @@ import { IS_DEMO } from '../../lib/demo';
 import OutlinkQuest from '../components/OutlinkQuest';
 import OnboardingGate from '../components/OnboardingGate';
 import { useUser } from '../components/UserProvider';
+import { rowCompanyScore, TOP_COMPANY } from '../../lib/scoring';
 import Link from 'next/link';
 
 const TIER_COLORS = { S: '#FFD700', A: '#9B59B6', B: '#3498DB', C: '#95A5A6', D: '#BDC3C7' };
-const PRESTIGE = ['snap', 'google', 'meta', 'apple', 'amazon', 'microsoft', 'netflix', 'tesla', 'spotify', 'tiktok', 'coca-cola', 'nike', 'disney', 'palantir', 'stripe', 'coinbase', 'polymarket', 'pinterest', 'whatnot', 'blackrock', 'anduril'];
 
+// Who to reach first: power, +1 when the company their score is built on is a
+// top one by the model's own scores (TOP_COMPANY: the curated list's major
+// companies and up, or one you or your sector score that high), a nudge for
+// the free-text sectors on your profile, then a lift for S and A. The +1 used
+// to come from a list of one person's favourite names, matched anywhere in the
+// headline, once per name: "Metadata" counted as Meta, "Ex-Google" as Google.
 function calculatePriority(person, sectors) {
   let score = parseFloat(person.power_score) || 0;
   const hl = (person.headline || '').toLowerCase();
-  PRESTIGE.forEach(c => { if (hl.includes(c)) score += 1; });
+  if (rowCompanyScore(person) >= TOP_COMPANY) score += 1;
   (sectors || []).forEach(s => { if (hl.includes(s.toLowerCase())) score += 0.5; });
   if (person.tier === 'S') score *= 1.5;
   else if (person.tier === 'A') score *= 1.2;

package/.next/standalone/app/settings/page.js

@@ -0,0 +1,96 @@
+'use client';
+
+import { useEffect, useState } from 'react';
+import Link from 'next/link';
+import OnboardingGate from '../components/OnboardingGate';
+import UpdatePanel from '../components/UpdatePanel';
+import SectorSection from '../components/settings/SectorSection';
+import DataSection from '../components/settings/DataSection';
+import { Section, Body, Mono, LINE, FONT } from '../components/ui';
+import { IS_DEMO } from '../../lib/demo';
+
+// Settings: one page for the choices that shape how the app treats your data,
+// and the facts about this copy. Each feature adds its own <Section>; what the
+// user chooses is saved in the database (lib/settings.js), so it travels with
+// their data.
+
+export default function SettingsPage() {
+  return <OnboardingGate><SettingsInner /></OnboardingGate>;
+}
+
+const KIND_LABEL = {
+  'mac-app': 'the Mac app',
+  npm: 'the npm package (npx six-degrees)',
+  source: 'a copy built from the source code',
+  git: 'a git checkout of the source code',
+};
+
+function SettingsInner() {
+  const [info, setInfo] = useState(null);
+  const [error, setError] = useState(null);
+
+  useEffect(() => {
+    fetch('/api/settings')
+      .then((r) => r.json().then((d) => (r.ok ? d : Promise.reject(new Error(d.error || 'Could not load settings.')))))
+      .then(setInfo)
+      .catch((e) => setError(e.message));
+  }, []);
+
+  if (IS_DEMO) {
+    return (
+      <div style={{
+        minHeight: '100vh', background: '#0a0a1a', color: 'rgba(255,255,255,0.7)',
+        display: 'flex', flexDirection: 'column', alignItems: 'center', justifyContent: 'center',
+        gap: 12, textAlign: 'center', padding: 24, fontFamily: FONT,
+      }}>
+        <h2 style={{ margin: 0, fontSize: 20, fontWeight: 700, color: '#fff' }}>Not part of the demo</h2>
+        <p style={{ margin: 0, fontSize: 13 }}>The public demo includes the Network Circle and Degrees views only.</p>
+        <Link href="/" style={{ fontSize: 12, color: 'rgba(255,255,255,0.5)', textDecoration: 'none' }}>&larr; Back to the network</Link>
+      </div>
+    );
+  }
+
+  const about = info?.about;
+
+  return (
+    <div style={{ minHeight: '100vh', background: '#0a0a1a', color: '#fff', fontFamily: FONT }}>
+      <header style={{ padding: '16px 24px', borderBottom: LINE, display: 'flex', alignItems: 'center', gap: 16 }}>
+        <Link href="/" style={{
+          display: 'flex', alignItems: 'center', gap: 6, color: '#888', textDecoration: 'none',
+          fontSize: 13, fontWeight: 600, padding: '6px 14px', borderRadius: 6,
+          background: 'rgba(255,255,255,0.06)', border: LINE,
+        }}>← Back to Map</Link>
+        <h1 style={{
+          fontSize: 22, fontWeight: 700, margin: 0,
+          background: 'linear-gradient(135deg, #FFD700, #9B59B6, #3498DB)',
+          WebkitBackgroundClip: 'text', WebkitTextFillColor: 'transparent',
+        }}>Settings</h1>
+      </header>
+
+      <main style={{ maxWidth: 720, margin: '0 auto', padding: '8px 24px 64px' }}>
+        {error && <Body style={{ color: '#ff7676', marginTop: 16 }}>{error}</Body>}
+
+        <UpdatePanel />
+        <SectorSection />
+
+        <DataSection />
+
+        <Section id="about" title="About this copy">
+          {about ? (
+            <>
+              <Body>Version <Mono>{about.version}</Mono>, running as {KIND_LABEL[about.kind] || about.kind}.</Body>
+              <Body>
+                Your network is kept in <Mono>{about.dataDir}</Mono>
+                {about.customDataDir ? ' (a folder you chose).' : '.'}
+                {about.kind === 'mac-app' && ' Help → Show the Data Folder opens it.'}
+              </Body>
+              <Body style={{ fontSize: 12, color: '#667', marginTop: 10 }}>
+                Settings are saved with your network, on this computer. Nothing here is sent anywhere.
+              </Body>
+            </>
+          ) : !error && <Body>Loading…</Body>}
+        </Section>
+      </main>
+    </div>
+  );
+}

package/.next/standalone/app/setup/page.js

@@ -4,8 +4,8 @@ import { useState, useEffect, useCallback, useRef } from 'react';
 import OnboardingGate from '../components/OnboardingGate';
 import Link from 'next/link';
 import { stopScrape } from '../../lib/scraper-client';
+import { setupStep } from '../../lib/scanner-setup';
 import { BudgetBox, CooldownBanner, PausedList } from '../components/LinkedInLimits';
-import UpdatePanel from '../components/UpdatePanel';
 
 // Everything here runs through /api/scraper. There is deliberately no second
 // server and no command to copy: the step where people gave up was starting a
@@ -16,6 +16,7 @@ const LINE = '1px solid rgba(255,255,255,0.1)';
 
 const ACTION_LABELS = {
   install: 'Installing the scanner',
+  setup: 'Setting up the scanner',
   login: 'Waiting for you to sign in',
   full: 'Scanning your whole network',
   refresh: 'Checking for new connections',
@@ -30,6 +31,12 @@ export default function SetupPage() {
 }
 
 function SetupInner() {
+  // Updates moved to Settings; an old menu item or bookmark still lands there.
+  useEffect(() => {
+    if (new URLSearchParams(window.location.search).get('check') === 'updates') {
+      window.location.replace('/settings?check=updates');
+    }
+  }, []);
   const [s, setS] = useState(null);
   const [busy, setBusy] = useState(false);
   // Ten, not twenty-five. The only measured number this project has is that
@@ -100,6 +107,10 @@ function SetupInner() {
 
   const c = s?.checks || {};
   const running = s?.running;
+  // Step 1 (lib/scanner-setup.js): ready (the Mac app's own Python, or one
+  // installed), Install, Set up the scanner (download a Python first), or neither;
+  // and a line of its own when the Python inside the app didn't work.
+  const step1 = setupStep(s);
   const needsDeps = s && !c.dependencies;
   const needsChrome = s && !c.chrome;
   const notFound = s && !c.scriptsFound;
@@ -202,22 +213,23 @@ function SetupInner() {
           </Box>
         )}
 
-        {/* ---- step 1 : dependencies ---- */}
+        {/* The Python inside the app didn't work: what happened, and what to do instead.
+            Red only while there is something to do; once another Python runs the
+            scanner it is just news. */}
+        {s && step1.note && (
+          <Box tone={step1.done ? undefined : 'bad'}>{step1.note}</Box>
+        )}
+
+        {/* ---- step 1 : the scanner itself ---- */}
         <Step
           n={1}
-          done={!!c.dependencies}
-          title="Install what the scanner needs"
-          body={
-            c.dependencies
-              ? 'Installed.'
-              : c.python
-                ? 'One-time, about a minute. Downloads the browser-automation packages.'
-                : 'Python 3 was not found on this machine. Install it from python.org, then reload.'
-          }
+          done={step1.done}
+          title="Set up the scanner"
+          body={s ? step1.text : ''}
           action={
-            !c.dependencies && c.python && (
-              <Btn onClick={() => run('install')} disabled={busy || running}>
-                {running && s.action === 'install' ? 'Installing…' : 'Install'}
+            s && step1.button && (
+              <Btn onClick={() => run(step1.button.action)} disabled={busy || running}>
+                {step1.button.label}
               </Btn>
             )
           }
@@ -416,7 +428,10 @@ function SetupInner() {
           </>
         )}
 
-        <UpdatePanel />
+        <div style={{ marginTop: 32, paddingTop: 20, borderTop: LINE, fontSize: 13.5, color: '#8b9a9a' }}>
+          Checking for updates has moved to{' '}
+          <Link href="/settings#updates" style={{ color: '#3498DB' }}>Settings →</Link>
+        </div>
 
         <p style={{ color: '#667', fontSize: 12.5, lineHeight: 1.7, marginTop: 32 }}>
           Automating LinkedIn may go against its User Agreement, and accounts have been
@@ -523,7 +538,8 @@ function Progress({ p, action }) {
   }
   const pct = Math.max(0, Math.min(100, Math.round((p.done / p.total) * 100)));
   let text;
-  if (p.kind === 'batch') text = `Person ${p.current} of ${p.total}`;
+  if (p.kind === 'download') text = `Downloading Python: ${p.done.toFixed(1)} of ${p.total.toFixed(1)} MB · ${pct}%`;
+  else if (p.kind === 'batch') text = `Person ${p.current} of ${p.total}`;
   else if (action === 'refresh') text = `Looked at ${p.done.toLocaleString()} so far — stops once it reaches people already saved`;
   else text = `${p.done.toLocaleString()} of ${p.total.toLocaleString()} connections · ${pct}%`;
 

package/.next/standalone/bin/args.mjs

@@ -0,0 +1,44 @@
+// The npx launcher's command line, kept apart from bin/six-degrees.mjs (which
+// starts a server the moment it runs) so the tests can read it directly.
+
+import { homedir } from 'node:os';
+import path from 'node:path';
+
+/**
+ * A folder named on the command line, made absolute. The launcher changes into
+ * the package's own folder before the server starts, so a relative folder
+ * passed on as it is would land inside the npx cache, and be lost when that is
+ * cleared. A leading ~ is the home folder: the shell expands `--data-dir ~/x`
+ * but not `--data-dir=~/x`, which would otherwise make a folder named "~".
+ */
+export function absoluteFolder(value, { cwd = process.cwd(), home = homedir() } = {}) {
+  const s = String(value);
+  const expanded = s === '~' ? home : s.startsWith('~/') ? path.join(home, s.slice(2)) : s;
+  return path.resolve(cwd, expanded);
+}
+
+/**
+ * @returns {{ port, open, dataDir, help, version, error }}
+ * dataDir is absolute (absoluteFolder), or null when not given.
+ */
+export function parseArgs(argv, { env = process.env, cwd = process.cwd(), home = homedir() } = {}) {
+  const out = { port: Number(env.PORT) || 6363, open: true, dataDir: null };
+  for (let i = 0; i < argv.length; i++) {
+    const a = String(argv[i]);
+    if (a === '--port' || a === '-p') out.port = Number(argv[++i]);
+    else if (a === '--no-open') out.open = false;
+    else if (a === '--data-dir' || a.startsWith('--data-dir=')) {
+      const value = a === '--data-dir' ? argv[++i] : a.slice('--data-dir='.length);
+      if (value) out.dataDir = absoluteFolder(value, { cwd, home });
+      else out.error = '--data-dir needs a folder, for example: --data-dir ~/six-degrees-copy';
+    }
+    else if (a === '--help' || a === '-h') out.help = true;
+    else if (a === '--version' || a === '-v') out.version = true;
+  }
+  return out;
+}
+
+/** The data folder: --data-dir, else SIX_DEGREES_HOME, else ~/.six-degrees. Always absolute, for the same reason. */
+export function resolveDataDir(args, { env = process.env, cwd = process.cwd(), home = homedir() } = {}) {
+  return absoluteFolder(args.dataDir || env.SIX_DEGREES_HOME || path.join(home, '.six-degrees'), { cwd, home });
+}

package/.next/standalone/bin/six-degrees.mjs

@@ -10,8 +10,9 @@ import { createServer } from 'node:net';
 import { spawn } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { existsSync, mkdirSync } from 'node:fs';
-import { homedir, platform } from 'node:os';
+import { platform } from 'node:os';
 import path from 'node:path';
+import { parseArgs, resolveDataDir } from './args.mjs';
 
 const HERE = path.dirname(fileURLToPath(import.meta.url));
 const ROOT = path.join(HERE, '..');
@@ -33,19 +34,6 @@ function checkNode() {
   }
 }
 
-function parseArgs(argv) {
-  const out = { port: Number(process.env.PORT) || 6363, open: true };
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === '--port' || a === '-p') out.port = Number(argv[++i]);
-    else if (a === '--no-open') out.open = false;
-    else if (a === '--data-dir') process.env.SIX_DEGREES_HOME = argv[++i];
-    else if (a === '--help' || a === '-h') out.help = true;
-    else if (a === '--version' || a === '-v') out.version = true;
-  }
-  return out;
-}
-
 const HELP = `
   six-degrees — map your professional network as a galaxy, on your own machine
 
@@ -106,9 +94,15 @@ async function main() {
     return;
   }
 
+  if (args.error) {
+    console.error(`\n  ${args.error}\n`);
+    process.exit(1);
+  }
+
   checkNode();
 
-  const dataDir = process.env.SIX_DEGREES_HOME || path.join(homedir(), '.six-degrees');
+  // Absolute (bin/args.mjs): the server runs from inside the package, not here.
+  const dataDir = resolveDataDir(args);
   if (!existsSync(dataDir)) mkdirSync(dataDir, { recursive: true });
 
   const server = path.join(ROOT, '.next', 'standalone', 'server.js');