commitshow 0.1.0 → 0.1.1

package/README.md

@@ -1,12 +1,15 @@
-# commitshow
+# commit.show CLI
 
 > Audit any vibe-coded project from your terminal.
 
-`commitshow` pulls the latest [commit.show](https://commit.show) audit report for
-a project and renders it inline — Audit / Scout / Community scores, 3 strengths
-+ 2 concerns, current season rank, delta since the last snapshot. Local runs
-also save a `.commitshow/audit.md` file so your AI coding agent can read the
-report in the next turn and iterate.
+The official CLI for **[commit.show](https://commit.show)** — pulls the latest
+audit report for a project and renders it inline. Score breakdown
+(Audit / Scout / Community), 3 strengths + 2 concerns, current season rank,
+delta since the last snapshot. Local runs also save a `.commitshow/audit.md`
+file so your AI coding agent can read the report in the next turn and iterate.
+
+The npm package + command is `commitshow` (no dot — npm doesn't allow it in
+package names). Everything else uses the brand `commit.show`.
 
 ```bash
 npx commitshow audit

package/dist/commands/audit.js

@@ -1,6 +1,6 @@
 import { resolveTarget, TargetError } from '../lib/target.js';
 import { findProjectByGithubUrl, fetchLatestSnapshot, fetchStanding, runPreviewAudit, waitForPreviewSnapshot, } from '../lib/api.js';
-import { renderAudit, renderMarkdown, renderJson, renderUpsell, writeAuditMarkdown, writeAuditJson, } from '../lib/render.js';
+import { renderAudit, renderMarkdown, renderJson, renderUpsell, renderQuotaFooter, renderRateLimitDeny, writeAuditMarkdown, writeAuditJson, } from '../lib/render.js';
 import { c } from '../lib/colors.js';
 export async function audit(args) {
     const asJson = args.includes('--json');
@@ -60,7 +60,28 @@ export async function audit(args) {
     if ('error' in result) {
         const err = result;
         if (err.error === 'rate_limited') {
-            emitError(asJson, 'rate_limited', err.message ?? 'Rate limit hit. Try again tomorrow or sign in.', target.github_url);
+            if (asJson) {
+                process.stdout.write(JSON.stringify({
+                    error: 'rate_limited',
+                    reason: err.reason,
+                    message: err.message,
+                    limit: err.limit,
+                    count: err.count,
+                    quota: err.quota,
+                    target: target.github_url,
+                }) + '\n');
+            }
+            else {
+                console.error('');
+                console.error(renderRateLimitDeny({
+                    reason: err.reason ?? 'ip_cap',
+                    message: err.message ?? 'Rate limit hit. Try again later.',
+                    limit: err.limit ?? 0,
+                    count: err.count ?? 0,
+                    quota: err.quota,
+                }));
+                console.error('');
+            }
             return 1;
         }
         emitError(asJson, err.error, err.message ?? 'Preview audit failed.', target.github_url);
@@ -77,19 +98,30 @@ export async function audit(args) {
             emitError(asJson, 'timeout', 'Preview audit is taking longer than expected. Try `commitshow status <repo>` in a minute.', target.github_url);
             return 1;
         }
-        envelope = waited;
+        // Carry the original quota from the first response — server doesn't re-issue
+        // one when we poll for the snapshot.
+        envelope = { ...waited, quota: pending.quota };
     }
     else {
         envelope = result;
     }
     const view = { project: envelope.project, snapshot: envelope.snapshot, standing: null };
     if (asJson) {
-        process.stdout.write(renderJson(view) + '\n');
+        // Inject quota into the v1 schema as an additive field — schema_version
+        // unchanged because additive-only fields don't bump it.
+        const shape = JSON.parse(renderJson(view));
+        if (envelope.quota)
+            shape.quota = envelope.quota;
+        process.stdout.write(JSON.stringify(shape, null, 2) + '\n');
     }
     else {
         console.log('');
         console.log(renderAudit(view));
         console.log('');
+        if (envelope.quota) {
+            console.log(renderQuotaFooter(envelope.quota));
+            console.log('');
+        }
         console.log(renderUpsell());
         console.log('');
     }

package/dist/index.js

@@ -7,10 +7,10 @@ import { whoami } from './commands/whoami.js';
 import { c } from './lib/colors.js';
 const VERSION = '0.1.0';
 const USAGE = `
-${c.bold(c.gold('commitshow'))} ${c.dim(`v${VERSION}`)}  ${c.muted('—')} ${c.cream('audit any vibe-coded project from your terminal.')}
+${c.bold(c.gold('commit.show'))} ${c.dim(`v${VERSION}`)}  ${c.muted('—')} ${c.cream('audit any vibe-coded project from your terminal.')}
 
 ${c.muted('USAGE')}
-  ${c.cream('commitshow')} ${c.gold('<command>')} [target] [flags]
+  ${c.cream('commitshow')} ${c.gold('<command>')} [target] [flags]   ${c.dim('# CLI is `commitshow` (no dot — npm constraint)')}
 
 ${c.muted('COMMANDS')}
   ${c.gold('audit')}    [target]    run audit and render the report

package/dist/lib/render.js

@@ -23,6 +23,33 @@ function scoreBar(value, max) {
     const tone = scoreTone(Math.round((value / max) * 100));
     return tone('▰'.repeat(filled)) + c.muted('▱'.repeat(empty));
 }
+// 5-row × 5-col ASCII digit set · used for the hero score.
+// Hand-rolled (no external font dep) so the bundle stays tiny.
+const BIG_DIGITS = {
+    '0': ['█▀▀▀█', '█   █', '█   █', '█   █', '█▄▄▄█'],
+    '1': ['  ▄█ ', '   █ ', '   █ ', '   █ ', '  ▄█▄'],
+    '2': ['█▀▀▀█', '    █', '█▀▀▀▀', '█    ', '█▄▄▄▄'],
+    '3': ['█▀▀▀█', '    █', ' ▀▀▀█', '    █', '█▄▄▄█'],
+    '4': ['█   █', '█   █', '█▄▄▄█', '    █', '    █'],
+    '5': ['█▀▀▀▀', '█    ', '▀▀▀▀█', '    █', '█▄▄▄█'],
+    '6': ['█▀▀▀▀', '█    ', '█▀▀▀█', '█   █', '█▄▄▄█'],
+    '7': ['█▀▀▀█', '    █', '   ▄▀', '  ▄▀ ', ' ▄▀  '],
+    '8': ['█▀▀▀█', '█   █', '█▀▀▀█', '█   █', '█▄▄▄█'],
+    '9': ['█▀▀▀█', '█   █', '█▄▄▄█', '    █', '█▄▄▄█'],
+    '/': ['    █', '   ▄▀', '  ▄▀ ', ' ▄▀  ', '█    '],
+    ' ': ['     ', '     ', '     ', '     ', '     '],
+};
+/** Render a string ("68", "100", "82/100") as 5 rows of big ASCII. */
+function bigText(text) {
+    const rows = ['', '', '', '', ''];
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        const glyph = BIG_DIGITS[ch] ?? BIG_DIGITS[' '];
+        for (let r = 0; r < 5; r++)
+            rows[r] += glyph[r] + (i < text.length - 1 ? ' ' : '');
+    }
+    return rows;
+}
 function pad(s, w) {
     return s.length >= w ? s.slice(0, w) : s + ' '.repeat(w - s.length);
 }
@@ -66,13 +93,20 @@ export function renderAudit(view) {
     const slug = p.github_url?.replace(/^https?:\/\//, '') ?? '';
     lines.push('  ' + c.bold(c.cream(name)) + '   ' + c.muted(slug));
     lines.push('');
-    // Hero score card
-    const scoreText = `${total} / 100`;
-    const scoreTinted = scoreTone(total)(scoreText);
-    const cardW = 14;
-    lines.push('  ' + ' '.repeat(20) + c.muted('╔' + '═'.repeat(cardW) + '╗'));
-    lines.push('  ' + ' '.repeat(20) + c.muted('║') + centerPadAnsi(scoreTinted, cardW) + c.muted('║'));
-    lines.push('  ' + ' '.repeat(20) + c.muted('╚' + '═'.repeat(cardW) + '╝'));
+    // Hero score · big-digit ASCII for X-share screenshots.
+    // Renders the score number 5 rows tall, color-coded by tier band.
+    // Width budget: 3-digit (e.g. "100") = 17 cols → centered in 58.
+    const tone = scoreTone(total);
+    const bigRows = bigText(String(total));
+    const bigWidth = bigRows[0].length;
+    const leftPad = Math.floor((58 - bigWidth) / 2);
+    for (const row of bigRows) {
+        lines.push('  ' + ' '.repeat(leftPad) + tone(row));
+    }
+    // Caption beneath the big number — small "/ 100 · band"
+    const band = total >= 75 ? 'strong' : total >= 50 ? 'mid' : 'weak';
+    const caption = `/ 100 · ${band}`;
+    lines.push('  ' + ' '.repeat(Math.floor((58 - caption.length) / 2)) + c.muted(caption));
     lines.push('');
     // 3-axis bars
     const auditLine = `  Audit  ${pad(`${p.score_auto}/50`, 7)}  ${scoreBar(p.score_auto, 50)}`;
@@ -264,10 +298,89 @@ export function toAgentShape(view) {
 export function renderJson(view) {
     return JSON.stringify(toAgentShape(view), null, 2);
 }
-// ── Upsell panel (CLI-only · appended to preview audits) ─────────────
-// Shown after a preview audit render so Creator sees what a real audition
-// unlocks. Intentionally NOT shown for registered projects — they already
-// have access to everything listed here.
+function timeUntil(isoTarget) {
+    const ms = Math.max(0, new Date(isoTarget).getTime() - Date.now());
+    const h = Math.floor(ms / 3_600_000);
+    const m = Math.floor((ms % 3_600_000) / 60_000);
+    if (h >= 24)
+        return `${Math.floor(h / 24)}d ${h % 24}h`;
+    if (h > 0)
+        return `${h}h ${m}m`;
+    return `${m}m`;
+}
+export function renderQuotaFooter(q) {
+    // Pick the tier closest to its cap so the user sees the most relevant pressure.
+    const tiers = [
+        { name: 'IP', count: q.ip.count, limit: q.ip.limit, remaining: q.ip.remaining },
+        { name: 'repo', count: q.url.count, limit: q.url.limit, remaining: q.url.remaining },
+        { name: 'global', count: q.global.count, limit: q.global.limit, remaining: q.global.remaining },
+    ];
+    const tightest = tiers.slice().sort((a, b) => a.remaining - b.remaining)[0];
+    const tone = tightest.remaining === 0 ? c.scarlet :
+        tightest.remaining <= 1 ? c.gold :
+            c.muted;
+    const reset = timeUntil(q.reset_at);
+    const ipPart = `IP ${q.ip.remaining}/${q.ip.limit}`;
+    const urlPart = `repo ${q.url.remaining}/${q.url.limit}`;
+    return '  ' + c.muted('quota: ') +
+        tone(ipPart) + c.muted(' · ') +
+        tone(urlPart) + c.muted(' · ') +
+        c.dim(`resets in ${reset}`);
+}
+// ── Rate-limit panel (deny path) ────────────────────────────────
+// Replaces the bare error line. Shows which tier was hit, count vs cap,
+// time until reset, and what to do next.
+const REASON_LABEL = {
+    ip_cap: 'Daily limit hit · per IP',
+    url_cap: 'This repo audited too many times today',
+    global_cap: 'commit.show daily audit cap reached',
+};
+function bar(filled, total, width = 20) {
+    const f = Math.max(0, Math.min(width, Math.round((filled / Math.max(1, total)) * width)));
+    return c.scarlet('▰'.repeat(f)) + c.muted('▱'.repeat(width - f));
+}
+export function renderRateLimitDeny(opts) {
+    const lines = [];
+    const horiz = '─'.repeat(58);
+    lines.push('  ' + c.muted('┌' + horiz + '┐'));
+    lines.push('  ' + c.muted('│ ') + c.bold(c.scarlet('Rate limit')) + c.muted(' · ') + c.cream(REASON_LABEL[opts.reason] ?? opts.reason) + ' '.repeat(Math.max(0, 58 - 14 - (REASON_LABEL[opts.reason]?.length ?? opts.reason.length))) + c.muted('│'));
+    lines.push('  ' + c.muted('│' + ' '.repeat(58) + '│'));
+    lines.push('  ' + c.muted('│ ') + c.cream(`${opts.count}/${opts.limit}  `) + bar(opts.count, opts.limit) + ' '.repeat(58 - 28) + c.muted('│'));
+    if (opts.quota) {
+        const reset = timeUntil(opts.quota.reset_at);
+        lines.push('  ' + c.muted('│ ') + c.dim(`resets in ${reset}`) + ' '.repeat(58 - 12 - reset.length - 9 - 2) + c.muted('│'));
+    }
+    // Wrap the message into ~54-char lines.
+    for (const w of wrapText(opts.message, 54)) {
+        lines.push('  ' + c.muted('│ ') + c.cream(w) + ' '.repeat(56 - w.length) + c.muted('│'));
+    }
+    if (opts.reason === 'url_cap') {
+        lines.push('  ' + c.muted('│ ') + c.dim('Tip: cached audit (< 7d) is free — `commitshow status <repo>`.') + c.muted(' │'));
+    }
+    if (opts.reason === 'ip_cap' && opts.quota?.ip.tier === 'anon') {
+        lines.push('  ' + c.muted('│ ') + c.dim('Sign in (commit.show) for a higher daily cap.') + ' '.repeat(58 - 49) + c.muted('│'));
+    }
+    lines.push('  ' + c.muted('└' + horiz + '┘'));
+    return lines.join('\n');
+}
+function wrapText(s, width) {
+    const words = s.split(/\s+/);
+    const out = [];
+    let line = '';
+    for (const w of words) {
+        if ((line + ' ' + w).trim().length > width) {
+            if (line)
+                out.push(line.trim());
+            line = w;
+        }
+        else {
+            line += ' ' + w;
+        }
+    }
+    if (line.trim())
+        out.push(line.trim());
+    return out;
+}
 export function renderUpsell() {
     const lines = [];
     const bar = '─'.repeat(58);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commitshow",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "commit.show CLI — audit any vibe-coded project from your terminal.",
   "type": "module",
   "bin": {