hacklab 0.3.0 → 0.4.0

package/README.md

@@ -1,107 +1,76 @@
-# @hacklab/cli
+# hacklab
 
-hacklab cli package.
+The terminal-native way to join [Hacklab](https://hacklab.so) — a social network
+for AI-native hackers. Scan your local AI token usage, see where you rank, claim
+your profile with GitHub.
 
-## commands
+## Install & join
 
-- `hacklab login` - authenticate via browser oauth or non-interactive token (`--token`), with identity selection (`--as human|agent`).
-- `hacklab whoami` - show current logged in user.
-- `hacklab init` - create or initialize the current repo as your lab repository.
-- `hacklab brag` - read `.hacklab/project.yaml`, upload local screenshots, and sync the project to Hacklab.
-- `hacklab new` - interactive content creation (`essay`, `guide`, `course`, `research paper`, `project`).
-- `hacklab publish` - push the current lab repo to github.
-- `hacklab explore` - open hacklab discovery in browser.
-- `hacklab admin waitlist` - admin-only waitlist inspection (visible only for DEV/GOD accounts).
-
-## repository layout
-
-`hacklab init` creates:
-
-- `.hacklab/config.json`
-- `.hacklab/README.mdx`
-- `assets/`
-- `home.mdx`
-- `readme.mdx`
-- `profile/`
-- `profile/bio.mdx`
-- `profile/cv.mdx`
-- `projects/`
-- `guides/`
-- `courses/`
-- `essays/`
-- `research/`
-- `docs/profile.mdx`
-- `docs/content-model.mdx`
-- `docs/frontmatter.mdx`
-
-it also creates sample `.mdx` content in each content directory.
-
-identity fields in `.hacklab/config.json`:
-
-- `labId` (optional)
-- `labSlug`
-- `labName`
-- `owner`
-- `workspaceType`
-
-## local usage
-
-from repo root:
+One command:
 
 ```bash
-pnpm --filter @hacklab/cli build
-node packages/cli/dist/index.js login --token <cli-access-token>
-node packages/cli/dist/index.js login --as human
-node packages/cli/dist/index.js login --as agent
-node packages/cli/dist/index.js brag
-node packages/cli/dist/index.js brag path/to/project.yaml
-node packages/cli/dist/index.js init --name matts-lab
-node packages/cli/dist/index.js new
-node packages/cli/dist/index.js new guide api-design-primer
-node packages/cli/dist/index.js new research-paper llm-evals-2026
-node packages/cli/dist/index.js publish
-node packages/cli/dist/index.js explore
+curl hacklab.so/install.sh | sh
 ```
 
-environment variables:
+It checks for Node 20+ and runs `npx hacklab@latest join`. If you have Node
+already (incl. via a version manager), you can skip the script:
 
-- `HACKLAB_APP_URL` - app base url (default: `http://localhost:3000`)
-- `HACKLAB_SESSION_PATH` - custom path for cli session file
-
-credentials are stored at `~/.hacklab/session.json`.
+```bash
+npx hacklab@latest join
+```
 
-## brag manifest
+## The join ritual
 
-`hacklab brag` looks for `.hacklab/project.yaml` in the current directory by default.
+```
+scan local AI usage → see your rank → pick a username → sign in with GitHub → claim
+```
 
-Supported fields:
+1. **Scan** — reads your local AI token usage from Claude Code, Codex, Cursor,
+   OpenClaw, Hermes, and OpenCode. Nothing leaves your machine yet.
+2. **Rank** — shows the rank that usage would hold (`you'd be #15 of N`), with no
+   account required.
+3. **Username** — pick your Hacklab handle (checked for availability live).
+4. **GitHub** — sign in to authenticate and link your profile + repos.
+5. **Claim** — your profile goes live at `hacklab.so/<username>`. Your usage
+   uploads in the background while you get a shareable stats card.
+6. **Share** — a stats thumbnail (belt, level, rank, token breakdown) is rendered
+   locally, copied to your clipboard, and you can post it to X in one keystroke.
+
+## Commands
+
+- `hacklab join` — the join ritual above. Running bare `hacklab` does this for
+  new users (and `sync` for returning ones).
+- `hacklab sync` — re-scan local AI usage and sync it to your profile.
+- `hacklab whoami` — show who you're logged in as.
+- `hacklab drop "message"` — post a drop to your feed (`-u <url>` to attach a link).
+- `hacklab login` — re-authenticate with GitHub.
+- `hacklab exam [--pyro|--hacker]` — run your belt exam (token usage + GitHub code).
+- `hacklab scan` — build your full profile (skills, repos, blog).
+- `hacklab config <key> <value>` — set config (`cursor-api-key`, `cursor-email`).
+- `hacklab brag [path]` — sync a `.hacklab/project.yaml` to your profile.
+- `hacklab --version` / `hacklab --help`.
+
+## Environment
+
+- `HACKLAB_APP_URL` — app base URL (default `http://localhost:3000`).
+- `HACKLAB_SESSION_PATH` — custom path for the session file
+  (default `~/.hacklab/session.json`).
+
+## Local development
+
+From the repo root, run the CLI from source against a local app:
 
-- `title` - required
-- `slug` - optional; defaults to the current directory name, slugified
-- `description`
-- `tags` - yaml list or comma-separated string
-- `repoUrl` or `repo`
-- `liveUrl` or `url`
-- `publishedAt`, `published_at`, or `date`
-- `content` - inline markdown
-- `contentFile` - relative path to markdown content
-- `screenshots` - up to 5 entries, each either a URL, a relative file path, or `{ path, caption }` / `{ url, caption }`
+```bash
+HACKLAB_APP_URL=http://localhost:3000 \
+HACKLAB_SESSION_PATH=/tmp/hl-test.json \
+pnpm --filter hacklab dev join
+```
 
-If neither `content` nor `contentFile` is provided, the CLI falls back to `README.md` or `README.mdx` in the repo root.
+`pnpm --filter hacklab dev <command>` runs `src/index.ts` via tsx (no build).
+`pnpm --filter hacklab build` compiles to `dist/`.
 
-Example:
+To reset a test account so its GitHub identity can join fresh:
 
-```yaml
-title: Shipyard
-description: Fast deployment previews for side projects.
-tags:
-  - next.js
-  - postgres
-repo: https://github.com/acme/shipyard
-url: https://shipyard.dev
-contentFile: README.md
-screenshots:
-  - screenshots/home.png
-  - path: screenshots/dashboard.jpg
-    caption: Dashboard
+```bash
+pnpm --filter @hacklab/db delete-account <handle-or-github-username>
 ```

package/dist/belt.d.ts

@@ -0,0 +1,25 @@
+export type BeltColor = 'white' | 'orange' | 'red' | 'blue' | 'cyan' | 'yellow' | 'lime' | 'green' | 'pink' | 'purple' | 'black';
+export type Title = 'gaijin' | 'deshi' | 'ronin' | 'shinobi' | 'samurai' | 'senpai' | 'tatsujin' | 'kensei' | 'oni' | 'ryujin';
+export type DanTitle = 'shodan' | 'nidan' | 'sandan' | 'yondan' | 'godan' | 'rokudan' | 'nanadan' | 'hachidan' | 'kudan' | 'judan';
+export type GrandMasterTitle = 'shihan' | 'hanshi' | 'meijin' | 'oyama';
+/** Convert raw token count to Pyro XP. 1,000 tokens = 1 XP. */
+export declare function tokensToXp(tokens: number): number;
+/** Convert total XP to level (fractional). */
+export declare function xpToLevel(xp: number): number;
+/** Convert level to minimum XP required. */
+export declare function levelToMinXp(level: number): number;
+/** Get the integer level (floor of fractional level). */
+export declare function getLevel(xp: number): number;
+/** Get belt color for a given level. */
+export declare function getBeltColor(level: number): BeltColor;
+/** Get title for a given level. */
+export declare function getTitle(level: number): Title | DanTitle | GrandMasterTitle;
+export type BeltProgress = {
+    level: number;
+    title: Title | DanTitle | GrandMasterTitle;
+    beltColor: BeltColor;
+    progressPercent: number;
+};
+/** Belt info for a raw token total (pyro-only — correct for a fresh join). */
+export declare function beltForTokens(tokensTotal: number): BeltProgress;
+//# sourceMappingURL=belt.d.ts.map

package/dist/belt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"belt.d.ts","sourceRoot":"","sources":["../src/belt.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,QAAQ,GACR,KAAK,GACL,MAAM,GACN,MAAM,GACN,QAAQ,GACR,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,GACR,OAAO,CAAA;AAEX,MAAM,MAAM,KAAK,GACb,QAAQ,GACR,OAAO,GACP,OAAO,GACP,SAAS,GACT,SAAS,GACT,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,KAAK,GACL,QAAQ,CAAA;AAEZ,MAAM,MAAM,QAAQ,GAChB,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,SAAS,GACT,SAAS,GACT,UAAU,GACV,OAAO,GACP,OAAO,CAAA;AAEX,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;AAqCvE,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,8CAA8C;AAC9C,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAMrD;AAED,mCAAmC;AACnC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,gBAAgB,CAkB3E;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,gBAAgB,CAAA;IAC1C,SAAS,EAAE,SAAS,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAgB/D"}

package/dist/belt.js

@@ -0,0 +1,113 @@
+// Belt / level math — ported verbatim from @hacklab/db `levels.ts` so the CLI
+// can render the share card instantly (locally) without waiting on the server.
+// The CLI is a standalone published package and must not pull in @hacklab/db
+// (drizzle/pg/etc.), so we copy the small, stable curve here.
+//
+// One curve: xp(level) = 23 × level^3.32 up to level 100, exponential above.
+// Pyro XP = tokens / 1000. For a brand-new join, hacker + mason XP are 0, so
+// belt XP == pyro XP — which is exactly what the server computes right after
+// the first sync. Kept in sync via belt.test.ts (anchored to the known points).
+const K = 3.32;
+const A = 23;
+const LEVEL_100_XP = 100_000_000; // 100M XP
+const BELT_TIERS = [
+    { minLevel: 0, color: 'white', title: 'gaijin' },
+    { minLevel: 10, color: 'orange', title: 'deshi' },
+    { minLevel: 20, color: 'red', title: 'ronin' },
+    { minLevel: 30, color: 'blue', title: 'shinobi' },
+    { minLevel: 40, color: 'cyan', title: 'samurai' },
+    { minLevel: 50, color: 'yellow', title: 'senpai' },
+    { minLevel: 60, color: 'lime', title: 'tatsujin' },
+    { minLevel: 70, color: 'green', title: 'kensei' },
+    { minLevel: 80, color: 'pink', title: 'oni' },
+    { minLevel: 90, color: 'purple', title: 'ryujin' },
+];
+const DAN_TITLES = [
+    'shodan',
+    'nidan',
+    'sandan',
+    'yondan',
+    'godan',
+    'rokudan',
+    'nanadan',
+    'hachidan',
+    'kudan',
+    'judan',
+];
+const GRAND_MASTER_TIERS = [
+    { minLevel: 200, title: 'shihan' },
+    { minLevel: 300, title: 'hanshi' },
+    { minLevel: 400, title: 'meijin' },
+    { minLevel: 500, title: 'oyama' },
+];
+/** Convert raw token count to Pyro XP. 1,000 tokens = 1 XP. */
+export function tokensToXp(tokens) {
+    return Math.floor(tokens / 1_000);
+}
+/** Convert total XP to level (fractional). */
+export function xpToLevel(xp) {
+    if (xp <= 0)
+        return 0;
+    if (xp >= LEVEL_100_XP) {
+        return 100 + 100 * Math.log10(xp / LEVEL_100_XP);
+    }
+    return (xp / A) ** (1 / K);
+}
+/** Convert level to minimum XP required. */
+export function levelToMinXp(level) {
+    if (level <= 0)
+        return 0;
+    if (level >= 100) {
+        return Math.round(LEVEL_100_XP * 10 ** ((level - 100) / 100));
+    }
+    return Math.round(A * level ** K);
+}
+/** Get the integer level (floor of fractional level). */
+export function getLevel(xp) {
+    return Math.floor(xpToLevel(xp));
+}
+/** Get belt color for a given level. */
+export function getBeltColor(level) {
+    if (level >= 100)
+        return 'black';
+    for (let i = BELT_TIERS.length - 1; i >= 0; i--) {
+        if (level >= BELT_TIERS[i].minLevel)
+            return BELT_TIERS[i].color;
+    }
+    return 'white';
+}
+/** Get title for a given level. */
+export function getTitle(level) {
+    if (level >= 200) {
+        for (let i = GRAND_MASTER_TIERS.length - 1; i >= 0; i--) {
+            if (level >= GRAND_MASTER_TIERS[i].minLevel)
+                return GRAND_MASTER_TIERS[i].title;
+        }
+    }
+    if (level >= 100) {
+        const danIndex = Math.min(Math.floor((level - 100) / 10), DAN_TITLES.length - 1);
+        return DAN_TITLES[danIndex];
+    }
+    for (let i = BELT_TIERS.length - 1; i >= 0; i--) {
+        if (level >= BELT_TIERS[i].minLevel)
+            return BELT_TIERS[i].title;
+    }
+    return 'gaijin';
+}
+/** Belt info for a raw token total (pyro-only — correct for a fresh join). */
+export function beltForTokens(tokensTotal) {
+    const xp = tokensToXp(tokensTotal);
+    const level = getLevel(xp);
+    const currentLevelXp = levelToMinXp(level);
+    const nextLevelXp = levelToMinXp(level + 1);
+    const xpIntoLevel = xp - currentLevelXp;
+    const xpNeeded = nextLevelXp - currentLevelXp;
+    const progressPercent = xpNeeded > 0 ? Math.min(Math.round((xpIntoLevel / xpNeeded) * 100), 100) : 0;
+    return {
+        level,
+        title: getTitle(level),
+        beltColor: getBeltColor(level),
+        progressPercent,
+    };
+}
+//# sourceMappingURL=belt.js.map

package/dist/belt.js.map

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

package/dist/commands/{signup.d.ts → join.d.ts}

@@ -1,11 +1,11 @@
 /**
- * The hero command: the guided signup ritual.
+ * The hero command: the guided join ritual.
  *
  *   scan → anonymous rank → pick username + fields → GitHub OAuth → claim
  *
  * Value (rank) is shown before any account exists; GitHub auth comes last.
  * Each stage degrades on its own terms (see the per-stage handling below) so a
- * network blip on the vanity rank never blocks the actual signup.
+ * network blip on the vanity rank never blocks the actual join.
  */
-export declare function signup(): Promise<void>;
-//# sourceMappingURL=signup.d.ts.map
+export declare function join(): Promise<void>;
+//# sourceMappingURL=join.d.ts.map

package/dist/commands/join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../src/commands/join.ts"],"names":[],"mappings":"AAiCA;;;;;;;;GAQG;AACH,wBAAsB,IAAI,kBA0NzB"}

package/dist/commands/{signup.js → join.js}

@@ -1,6 +1,8 @@
 import * as clack from '@clack/prompts';
+import { beltForTokens } from '../belt.js';
 import { formatTokens, scanAllTools, } from '../scanners/index.js';
 import { getAppUrl, loadSession } from '../session.js';
+import { promptShareOnX, renderShareCard, } from '../share.js';
 import { bold, dim, info } from '../ui.js';
 import { login } from './login.js';
 const TOOL_LABELS = {
@@ -12,15 +14,15 @@ const TOOL_LABELS = {
     opencode: 'OpenCode',
 };
 /**
- * The hero command: the guided signup ritual.
+ * The hero command: the guided join ritual.
  *
  *   scan → anonymous rank → pick username + fields → GitHub OAuth → claim
  *
  * Value (rank) is shown before any account exists; GitHub auth comes last.
  * Each stage degrades on its own terms (see the per-stage handling below) so a
- * network blip on the vanity rank never blocks the actual signup.
+ * network blip on the vanity rank never blocks the actual join.
  */
-export async function signup() {
+export async function join() {
     clack.intro(bold('hacklab'));
     const appUrl = getAppUrl();
     // ── Stage 1: scan ────────────────────────────────────────────────────────
@@ -54,7 +56,11 @@ export async function signup() {
             process.exit(0);
         }
     }
-    // ── Stage 2: anonymous rank (best-effort; never blocks signup) ────────────
+    // ── Stage 2: anonymous rank (best-effort; never blocks the join) ──────────
+    // Captured for the share card later — the preview rank equals the post-sync
+    // rank (rank counts users with MORE tokens, so the user joining the set
+    // doesn't change it), so the card can show it without waiting on the upload.
+    let previewRank = null;
     try {
         const res = await fetch(`${appUrl}/api/rank/preview`, {
             method: 'POST',
@@ -63,16 +69,17 @@ export async function signup() {
         });
         if (res.ok) {
             const { rank, ofTotal } = (await res.json());
+            previewRank = rank;
             clack.note(`${bold(`you'd be #${rank}`)} of ${ofTotal} hackers`, 'your rank');
         }
     }
     catch {
-        // Rank is a hook, not a gate. Skip silently and continue to signup.
+        // Rank is a hook, not a gate. Skip silently and continue the join.
     }
     // ── Stage 3: pick username + fields ───────────────────────────────────────
     const username = await promptAvailableUsername(appUrl);
     if (username === null) {
-        clack.outro(dim('signup cancelled.'));
+        clack.outro(dim('cancelled.'));
         process.exit(0);
     }
     const bio = await optionalText('one line — what are you building?');
@@ -83,12 +90,12 @@ export async function signup() {
         await login();
     }
     catch (err) {
-        clack.cancel(`GitHub sign-in failed: ${err instanceof Error ? err.message : String(err)}. run \`hacklab signup\` again.`);
+        clack.cancel(`GitHub sign-in failed: ${err instanceof Error ? err.message : String(err)}. run \`hacklab join\` again.`);
         process.exit(1);
     }
     const session = await loadSession();
     if (!session) {
-        clack.cancel('GitHub sign-in did not complete. run `hacklab signup` again.');
+        clack.cancel('GitHub sign-in did not complete. run `hacklab join` again.');
         process.exit(1);
     }
     // ── Stage 5: claim (re-prompt username on a TOCTOU collision) ─────────────
@@ -117,7 +124,7 @@ export async function signup() {
         if (res.status === 409) {
             const reprompt = await promptAvailableUsername(appUrl, 'that name was just taken — pick another');
             if (reprompt === null) {
-                clack.cancel('signup cancelled before claiming a handle.');
+                clack.cancel('cancelled before claiming a handle.');
                 process.exit(1);
             }
             claimedHandle = reprompt;
@@ -127,43 +134,103 @@ export async function signup() {
         clack.cancel(data?.error ?? `claim failed (${res.status})`);
         process.exit(1);
     }
-    // ── Stage 6: sync token totals to the claimed profile ─────────────────────
-    spin.start('syncing your usage');
-    try {
-        const res = await fetch(`${appUrl}/api/claim/sync`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                Authorization: `Bearer ${session.token}`,
+    // ── Stage 6: kick the heavy token upload off in the BACKGROUND ────────────
+    // It uploads while the user looks at their card and shares on X, so the
+    // upload never feels blocking. `.catch` keeps a transient failure from
+    // becoming an unhandled rejection; we reconcile the result in Stage 8.
+    const syncPromise = fetch(`${appUrl}/api/claim/sync`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${session.token}`,
+        },
+        body: JSON.stringify({
+            dailyTotals: scan.dailyTotals,
+            toolTotals: scan.toolTotals,
+            modelTotals: scan.modelTotals,
+            hourlyTotals: scan.hourlyTotals,
+        }),
+        // Hard cap so a slow/stuck upload can never freeze the CLI indefinitely.
+        // On timeout the fetch rejects → .catch → null → "syncing" message.
+        signal: AbortSignal.timeout(120_000),
+    })
+        .then((res) => (res.ok ? res.json() : null))
+        .catch(() => null);
+    // ── Stage 7: stats thumbnail + share (runs while the upload is in flight) ─
+    // Card is rendered from local data: scan totals, the captured preview rank,
+    // and the locally-computed belt (pyro-only, which matches the server for a
+    // fresh join). No dependency on the in-flight sync.
+    if (scan.grandTotal > 0) {
+        const belt = beltForTokens(scan.grandTotal);
+        const card = {
+            handle: claimedHandle,
+            level: belt.level,
+            title: belt.title,
+            beltColor: belt.beltColor,
+            tokensTotal: scan.grandTotal,
+            rank: previewRank ?? 0,
+            streak: 1,
+            longestStreak: 1,
+            progressPercent: belt.progressPercent,
+            estimatedCost: estimateCost(scan.toolTotals),
+            toolBreakdown: {
+                claudeCode: scan.toolTotals.claude_code ?? 0,
+                codex: scan.toolTotals.codex ?? 0,
+                cursor: scan.toolTotals.cursor ?? 0,
             },
-            body: JSON.stringify({
-                dailyTotals: scan.dailyTotals,
-                toolTotals: scan.toolTotals,
-                modelTotals: scan.modelTotals,
-                hourlyTotals: scan.hourlyTotals,
-            }),
-        });
-        if (res.ok) {
-            const r = (await res.json());
-            spin.stop('usage synced');
-            if (r.title && r.level != null) {
-                info(`${bold(r.title)} lv.${r.level}${r.beltColor ? ` (${r.beltColor} belt)` : ''}`);
-            }
-            if (r.rankAfter)
-                info(`rank: #${r.rankAfter}`);
-        }
-        else {
-            spin.stop('usage sync deferred');
-            info(dim('your profile is live; usage will sync next run.'));
-        }
+            models: Object.entries(scan.modelTotals)
+                .map(([name, tokens]) => ({ name, tokens }))
+                .sort((a, b) => b.tokens - a.tokens),
+            dailyActivity: aggregateDailyActivity(scan.dailyTotals),
+        };
+        await renderShareCard(card);
+        await promptShareOnX(card);
     }
-    catch {
+    // ── Stage 8: reconcile the background upload ──────────────────────────────
+    // It was uploading during the card + share, so it's usually done by now. Show
+    // a spinner for the remainder so a heavy upload reads as "working", never a
+    // silent freeze; the AbortSignal above guarantees this resolves.
+    spin.start('saving your usage');
+    const syncResult = await syncPromise;
+    const base = appUrl.replace(/\/$/, '');
+    if (syncResult?.title && syncResult.level != null) {
+        spin.stop('usage saved');
+        info(`${bold(syncResult.title)} lv.${syncResult.level}${syncResult.beltColor ? ` (${syncResult.beltColor} belt)` : ''}`);
+        if (syncResult.rankAfter)
+            info(`rank: #${syncResult.rankAfter}`);
+    }
+    else {
         spin.stop('usage sync deferred');
-        info(dim('your profile is live; usage will sync next run.'));
+        info(dim('your profile is live — run `hacklab sync` if your stats look off.'));
     }
-    const base = appUrl.replace(/\/$/, '');
     clack.outro(`${bold('claimed.')} ${base}/${claimedHandle}`);
 }
+/** Blended cost estimate ($/M tokens) across the scanned tools, for the card. */
+function estimateCost(toolTotals) {
+    const rate = {
+        claude_code: 0.6,
+        codex: 0.25,
+        cursor: 0.4,
+        openclaw: 0.5,
+        hermes: 0.5,
+        opencode: 0.5,
+    };
+    let cost = 0;
+    for (const [tool, tokens] of Object.entries(toolTotals)) {
+        cost += (tokens / 1_000_000) * (rate[tool] ?? 0.4);
+    }
+    return cost;
+}
+/** Collapse per-tool daily entries into one {date, tokens}[] for the card graph. */
+function aggregateDailyActivity(dailyTotals) {
+    const byDate = new Map();
+    for (const entry of dailyTotals) {
+        byDate.set(entry.date, (byDate.get(entry.date) ?? 0) + entry.tokens);
+    }
+    return Array.from(byDate.entries())
+        .map(([date, tokens]) => ({ date, tokens }))
+        .sort((a, b) => a.date.localeCompare(b.date));
+}
 /**
  * Prompt for a username and loop until it passes the availability check or the
  * user cancels. Returns the chosen username, or null if cancelled.
@@ -209,7 +276,7 @@ async function optionalText(message) {
     return trimmed.length > 0 ? trimmed : undefined;
 }
 /** Discard a value that isn't a parseable URL, so an optional vanity field can
- * never 400 the claim and abort signup at the final step. */
+ * never 400 the claim and abort the join at the final step. */
 function asValidUrl(value) {
     try {
         return new URL(value).href;
@@ -239,4 +306,4 @@ function normalizeWebsite(raw) {
         return undefined;
     return asValidUrl(/^https?:\/\//i.test(v) ? v : `https://${v}`);
 }
-//# sourceMappingURL=signup.js.map
+//# sourceMappingURL=join.js.map

package/dist/commands/join.js.map

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

package/dist/index.js

@@ -3,9 +3,9 @@ import { brag, parseBragArgs } from './commands/brag.js';
 import { configCommand } from './commands/config.js';
 import { drop } from './commands/drop.js';
 import { exam } from './commands/exam.js';
+import { join } from './commands/join.js';
 import { login } from './commands/login.js';
 import { scanProfile } from './commands/scan-profile.js';
-import { signup } from './commands/signup.js';
 import { sync } from './commands/sync.js';
 import { whoami } from './commands/whoami.js';
 import { loadSession } from './session.js';
@@ -15,7 +15,7 @@ function printHelp() {
     banner();
     console.log('');
     console.log(bold('usage:'));
-    console.log(`  hacklab ${dim('signup')}             join hacklab from your terminal`);
+    console.log(`  hacklab ${dim('join')}               join hacklab from your terminal`);
     console.log(`  hacklab ${dim('sync')}               sync AI token usage to your profile`);
     console.log(`  hacklab ${dim('whoami')}             check who you're logged in as`);
     console.log(`  hacklab ${dim('drop')} ${dim('"message"')}     post a drop to your feed`);
@@ -46,10 +46,10 @@ async function main() {
         process.exit(0);
     }
     if (cmd === '--version' || cmd === '-v') {
-        console.log('0.3.0');
+        console.log('0.4.0');
         process.exit(0);
     }
-    // Bare invocation (e.g. `npx hacklab@latest`): signup for newcomers, sync for
+    // Bare invocation (e.g. `npx hacklab@latest`): join for newcomers, sync for
     // a returning, already-authenticated user.
     if (!cmd) {
         const session = await loadSession();
@@ -57,12 +57,12 @@ async function main() {
             await sync();
         }
         else {
-            await signup();
+            await join();
         }
         return;
     }
-    if (cmd === 'signup') {
-        await signup();
+    if (cmd === 'join') {
+        await join();
     }
     else if (cmd === 'login') {
         await login();