commitshow 0.1.2 → 0.1.4

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, renderQuotaFooter, renderRateLimitDeny, writeAuditMarkdown, writeAuditJson, } from '../lib/render.js';
+import { renderAudit, renderMarkdown, renderJson, renderUpsell, renderQuotaFooter, renderRateLimitDeny, renderAuditError, writeAuditMarkdown, writeAuditJson, } from '../lib/render.js';
 import { c } from '../lib/colors.js';
 export async function audit(args) {
     const asJson = args.includes('--json');
@@ -27,6 +27,30 @@ export async function audit(args) {
             fetchStanding(project.id),
         ]);
         const view = { project, snapshot, standing };
+        // The snapshot may carry an audit-engine error (Claude quota exceeded,
+        // rate limit, etc.). Render the friendly explanation panel and exit
+        // 2 so CI scripts can detect "engine unavailable" without conflating
+        // it with a genuine low score.
+        const auditErr = snapshot?.rich_analysis?.error;
+        if (auditErr) {
+            if (asJson) {
+                process.stdout.write(JSON.stringify({
+                    error: 'audit_engine_error',
+                    reason: auditErr.type,
+                    message: auditErr.message ?? null,
+                    retry_after: auditErr.retry_after_seconds ?? null,
+                    project: { id: project.id, name: project.project_name, github_url: project.github_url },
+                }) + '\n');
+            }
+            else {
+                console.error('');
+                console.error(renderAuditError({ type: auditErr.type, message: auditErr.message ?? undefined,
+                    retry_after_seconds: auditErr.retry_after_seconds ?? null,
+                    http_status: auditErr.http_status }, project.project_name, `https://commit.show/projects/${project.id}`));
+                console.error('');
+            }
+            return 2;
+        }
         if (asJson) {
             process.stdout.write(renderJson(view) + '\n');
         }
@@ -106,6 +130,30 @@ export async function audit(args) {
         envelope = result;
     }
     const view = { project: envelope.project, snapshot: envelope.snapshot, standing: null };
+    // Same audit-engine error check as the cached path. The polled snapshot
+    // can carry a Claude failure even though the audit-preview Edge Function
+    // returned 202 (the failure happened in the background analyze-project).
+    const polledErr = envelope.snapshot?.rich_analysis?.error;
+    if (polledErr) {
+        if (asJson) {
+            process.stdout.write(JSON.stringify({
+                error: 'audit_engine_error',
+                reason: polledErr.type,
+                message: polledErr.message ?? null,
+                retry_after: polledErr.retry_after_seconds ?? null,
+                project: { id: envelope.project.id, name: envelope.project.project_name, github_url: envelope.project.github_url },
+                quota: envelope.quota,
+            }) + '\n');
+        }
+        else {
+            console.error('');
+            console.error(renderAuditError({ type: polledErr.type, message: polledErr.message ?? undefined,
+                retry_after_seconds: polledErr.retry_after_seconds ?? null,
+                http_status: polledErr.http_status }, envelope.project.project_name, `https://commit.show/projects/${envelope.project.id}`));
+            console.error('');
+        }
+        return 2;
+    }
     if (asJson) {
         // Inject quota into the v1 schema as an additive field — schema_version
         // unchanged because additive-only fields don't bump it.

package/dist/lib/render.js

@@ -60,6 +60,27 @@ function centerPad(s, w) {
     const left = Math.floor(total / 2);
     return ' '.repeat(left) + s + ' '.repeat(total - left);
 }
+// ── Single source of truth for box drawing ─────────────────────
+// Every panel uses 58-char outer width (1 corner + 56 interior + 1 corner)
+// so screenshots line up. Helper takes the *visible* length so colored
+// content (multiple ANSI spans) renders at the right padding without
+// having to strip escape codes at runtime.
+const BOX_W = 58; // outer width including both corners
+const INSIDE_W = BOX_W - 2; // chars between │ and │
+const CONTENT_W = INSIDE_W - 2; // chars between '│ ' and ' │'
+const boxTop = () => c.muted('┌' + '─'.repeat(INSIDE_W) + '┐');
+const boxBottom = () => c.muted('└' + '─'.repeat(INSIDE_W) + '┘');
+const boxBlank = () => c.muted('│' + ' '.repeat(INSIDE_W) + '│');
+/**
+ * Render a content row inside the box with proper padding.
+ * @param visibleLen  number of visible chars in `colored` (for padding math)
+ * @param colored     the rendered string (may contain ANSI escapes)
+ * @param leftMargin  extra spaces inside the box, after the leading `│ `
+ */
+function boxRow(visibleLen, colored, leftMargin = 0) {
+    const padding = Math.max(0, CONTENT_W - leftMargin - visibleLen);
+    return c.muted('│ ') + ' '.repeat(leftMargin) + colored + ' '.repeat(padding) + c.muted(' │');
+}
 /** Strip ANSI for width math on colored strings. */
 function visibleLength(s) {
     // eslint-disable-next-line no-control-regex
@@ -82,11 +103,11 @@ export function renderAudit(view) {
     const { project: p, snapshot, standing } = view;
     const total = p.score_total ?? 0;
     // Header
-    const bar = '─'.repeat(58);
     const lines = [];
-    lines.push(c.muted('┌' + bar + '┐'));
-    lines.push(c.muted('│ ') + c.bold(c.gold('commit.show')) + c.muted(' · ') + c.cream('Audit report') + ' '.repeat(58 - 29) + c.muted('│'));
-    lines.push(c.muted('└' + bar + '┘'));
+    lines.push(boxTop());
+    lines.push(boxRow(
+    /* visibleLen */ 'commit.show · Audit report'.length, c.bold(c.gold('commit.show')) + c.muted(' · ') + c.cream('Audit report')));
+    lines.push(boxBottom());
     lines.push('');
     // Project title line
     const name = p.project_name ?? 'untitled';
@@ -124,14 +145,20 @@ export function renderAudit(view) {
     const strengths = asStringArray(snapshot?.rich_analysis?.scout_brief?.strengths, 3);
     const concerns = asStringArray(snapshot?.rich_analysis?.scout_brief?.weaknesses, 2);
     if (strengths.length > 0 || concerns.length > 0) {
-        lines.push('  ' + c.muted('┌' + '─'.repeat(56) + '┐'));
+        // strengths/concerns each render as `↑ ` (2 visible) + truncated line.
+        // Total visible-line budget inside the box is CONTENT_W chars; reserve
+        // 2 for the arrow + space, leaving CONTENT_W - 2 for the bullet text.
+        const bulletWidth = CONTENT_W - 2;
+        lines.push('  ' + boxTop());
         for (const s of strengths) {
-            lines.push('  ' + c.muted('│ ') + c.teal('↑ ') + truncate(s, 52) + fill(s, 52) + c.muted(' │'));
+            const txt = truncate(s, bulletWidth);
+            lines.push('  ' + boxRow(2 + txt.length, c.teal('↑ ') + c.cream(txt)));
         }
         for (const s of concerns) {
-            lines.push('  ' + c.muted('│ ') + c.scarlet('↓ ') + truncate(s, 52) + fill(s, 52) + c.muted(' │'));
+            const txt = truncate(s, bulletWidth);
+            lines.push('  ' + boxRow(2 + txt.length, c.scarlet('↓ ') + c.cream(txt)));
         }
-        lines.push('  ' + c.muted('└' + '─'.repeat(56) + '┘'));
+        lines.push('  ' + boxBottom());
         lines.push('');
     }
     // Standings + delta
@@ -301,6 +328,72 @@ export function toAgentShape(view) {
 export function renderJson(view) {
     return JSON.stringify(toAgentShape(view), null, 2);
 }
+// ── Audit-engine error panel ────────────────────────────────────────
+// Rendered when the snapshot exists but rich_analysis.error is set —
+// i.e., the Claude call itself failed (quota, rate limit, network). The
+// project's auto-50 signals may still be valid; we explain that and tell
+// the user when fresh audits will resume.
+const AUDIT_ERROR_LABEL = {
+    anthropic_quota_exceeded: 'Daily audit budget reached',
+    anthropic_rate_limited: 'Audit engine rate-limited',
+    anthropic_overloaded: 'Audit engine overloaded',
+    anthropic_auth_error: 'Audit engine auth issue',
+    anthropic_other: 'Audit engine error',
+    claude_returned_no_data: 'Audit engine returned no data',
+    network_error: 'Audit engine network error',
+};
+const AUDIT_ERROR_DETAIL = {
+    anthropic_quota_exceeded: "commit.show paused fresh audits until the daily budget refills. " +
+        "Cached audits (any repo audited in the last 7 days) still work normally.",
+    anthropic_rate_limited: "Too many fresh audits in a short window. Wait a minute and retry. " +
+        "Cached results stay available.",
+    anthropic_overloaded: "The audit engine is briefly overloaded. Retry in a minute or two.",
+    anthropic_auth_error: "commit.show's API key needs attention. Cached results still work.",
+    anthropic_other: "Something on the audit engine side blocked this run. Try again later.",
+    claude_returned_no_data: "The audit engine ran but returned an empty response. Try again.",
+    network_error: "The audit engine couldn't be reached. Check your connection or retry.",
+};
+function untilHuman(seconds) {
+    if (seconds < 60)
+        return `${seconds}s`;
+    if (seconds < 3600)
+        return `${Math.round(seconds / 60)}m`;
+    if (seconds < 86400)
+        return `${Math.round(seconds / 3600)}h`;
+    return `${Math.round(seconds / 86400)}d`;
+}
+export function renderAuditError(err, projectName, projectUrl) {
+    const label = AUDIT_ERROR_LABEL[err.type] ?? AUDIT_ERROR_LABEL.anthropic_other;
+    const detail = AUDIT_ERROR_DETAIL[err.type] ?? AUDIT_ERROR_DETAIL.anthropic_other;
+    const lines = [];
+    const titleVisible = `commit.show · ${label}`;
+    lines.push('  ' + boxTop());
+    lines.push('  ' + boxRow(titleVisible.length, c.bold(c.gold('commit.show')) + c.muted(' · ') + c.scarlet(label)));
+    lines.push('  ' + boxBlank());
+    if (projectName) {
+        const repoLine = `Repo: ${projectName}`;
+        lines.push('  ' + boxRow(repoLine.length, c.cream(repoLine)));
+        lines.push('  ' + boxBlank());
+    }
+    for (const w of wrapText(detail, CONTENT_W)) {
+        lines.push('  ' + boxRow(w.length, c.cream(w)));
+    }
+    if (err.retry_after_seconds && err.retry_after_seconds > 0) {
+        lines.push('  ' + boxBlank());
+        const t = `Retry after ~${untilHuman(err.retry_after_seconds)}`;
+        lines.push('  ' + boxRow(t.length, c.dim(t)));
+    }
+    lines.push('  ' + boxBlank());
+    const statusLine = `Status check: commitshow status ${projectName ?? '<repo>'}`;
+    lines.push('  ' + boxRow(Math.min(statusLine.length, CONTENT_W), c.dim(statusLine.slice(0, CONTENT_W))));
+    if (projectUrl) {
+        const urlMax = CONTENT_W - 'Web view: '.length;
+        const urlText = projectUrl.length > urlMax ? projectUrl.slice(0, urlMax - 1) + '…' : projectUrl;
+        lines.push('  ' + boxRow('Web view: '.length + urlText.length, c.dim('Web view: ') + c.cream(urlText)));
+    }
+    lines.push('  ' + boxBottom());
+    return lines.join('\n');
+}
 function timeUntil(isoTarget) {
     const ms = Math.max(0, new Date(isoTarget).getTime() - Date.now());
     const h = Math.floor(ms / 3_600_000);
@@ -344,26 +437,30 @@ function bar(filled, total, width = 20) {
 }
 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('│'));
+    const reasonLabel = REASON_LABEL[opts.reason] ?? opts.reason;
+    const titleVisible = `Rate limit · ${reasonLabel}`;
+    lines.push('  ' + boxTop());
+    lines.push('  ' + boxRow(titleVisible.length, c.bold(c.scarlet('Rate limit')) + c.muted(' · ') + c.cream(reasonLabel)));
+    lines.push('  ' + boxBlank());
+    // Count + bar row · "5/5  " (5 chars) + 20-char bar = 25 visible
+    const counter = `${opts.count}/${opts.limit}  `;
+    lines.push('  ' + boxRow(counter.length + 20, c.cream(counter) + bar(opts.count, opts.limit)));
     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('│'));
+        const reset = `resets in ${timeUntil(opts.quota.reset_at)}`;
+        lines.push('  ' + boxRow(reset.length, c.dim(reset)));
     }
-    // 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('│'));
+    for (const w of wrapText(opts.message, CONTENT_W)) {
+        lines.push('  ' + boxRow(w.length, c.cream(w)));
     }
     if (opts.reason === 'url_cap') {
-        lines.push('  ' + c.muted('│ ') + c.dim('Tip: cached audit (< 7d) is free — `commitshow status <repo>`.') + c.muted(' │'));
+        const tip = 'Tip: cached audit (< 7d) is free — commitshow status <repo>';
+        lines.push('  ' + boxRow(tip.length, c.dim(tip)));
     }
     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('│'));
+        const tip = 'Sign in (commit.show) for a higher daily cap.';
+        lines.push('  ' + boxRow(tip.length, c.dim(tip)));
     }
-    lines.push('  ' + c.muted('└' + horiz + '┘'));
+    lines.push('  ' + boxBottom());
     return lines.join('\n');
 }
 function wrapText(s, width) {
@@ -386,24 +483,35 @@ function wrapText(s, width) {
 }
 export function renderUpsell() {
     const lines = [];
-    const bar = '─'.repeat(58);
-    lines.push('  ' + c.muted('┌' + bar + '┐'));
-    lines.push('  ' + c.muted('│ ') + c.bold(c.gold('Preview')) + c.muted(' · ') + c.cream('not entered in the season') + ' '.repeat(58 - 35) + c.muted('│'));
-    lines.push('  ' + c.muted('│' + ' '.repeat(58) + '│'));
-    lines.push('  ' + c.muted('│ ') + c.cream('Audition to unlock:') + ' '.repeat(58 - 20) + c.muted('│'));
+    const titleVisible = 'Preview · not entered in the season';
+    const headVisible = 'Audition to unlock:';
+    const ctaVisible = '→ https://commit.show/submit';
+    lines.push('  ' + boxTop());
+    lines.push('  ' + boxRow(titleVisible.length, c.bold(c.gold('Preview')) + c.muted(' · ') + c.cream('not entered in the season')));
+    lines.push('  ' + boxBlank());
+    lines.push('  ' + boxRow(headVisible.length, c.cream(headVisible)));
+    // Backstage = our brand for the prompt-extraction analysis (Phase 2 brief).
+    // Lead the unlock list with it because it's the most concrete, immediate
+    // payoff on signup: see how the project was built (delegation map, failure
+    // log, decision archaeology) and unlock +15-20 audit points typical.
+    // Tags are 15-char column-aligned so the · separator lines up vertically.
+    // Tags column-padded to 16 chars (1 trailing space guaranteed so the · in
+    // `rest` always has a visual gap from the tag, even when the tag fills 15).
     const items = [
-        'Scout forecasts · human verdicts (30% of score)',
-        'Season ranking  · top 20% graduate each 3-week cycle',
-        'Hall of Fame    · permanent archive + public badge',
-        'Live applauds   · notifications when reviewers react',
-        'Recommit loop   · weekly delta + trajectory share card',
+        { tag: 'Backstage       ', rest: '· build process + prompts · +15 pts', tone: c.gold },
+        { tag: 'Scout forecasts ', rest: '· human verdicts (30% of score)', tone: c.teal },
+        { tag: 'Season ranking  ', rest: '· top 20% graduate per cycle', tone: c.teal },
+        { tag: 'Hall of Fame    ', rest: '· permanent archive + badge', tone: c.teal },
+        { tag: 'Live applauds   ', rest: '· notifications on reactions', tone: c.teal },
+        { tag: 'Recommit loop   ', rest: '· weekly delta + share card', tone: c.teal },
     ];
     for (const it of items) {
-        lines.push('  ' + c.muted('│ ') + c.teal('→ ') + c.cream(pad(it, 54)) + c.muted('│'));
+        const visible = `→ ${it.tag}${it.rest}`;
+        lines.push('  ' + boxRow(visible.length, it.tone('→ ') + c.cream(it.tag) + c.muted(it.rest)));
     }
-    lines.push('  ' + c.muted('│' + ' '.repeat(58) + '│'));
-    lines.push('  ' + c.muted('│ ') + c.gold('→ https://commit.show/submit') + ' '.repeat(58 - 30) + c.muted('│'));
-    lines.push('  ' + c.muted('└' + bar + '┘'));
+    lines.push('  ' + boxBlank());
+    lines.push('  ' + boxRow(ctaVisible.length, c.gold(ctaVisible)));
+    lines.push('  ' + boxBottom());
     return lines.join('\n');
 }
 export function writeAuditJson(dir, json) {

package/package.json

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