commitshow 0.1.1 → 0.1.3

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/colors.js

@@ -11,6 +11,7 @@ function rgb(r, g, b) {
 }
 export const c = {
     gold: rgb(0xF0, 0xC0, 0x40),
+    goldDeep: rgb(0xD4, 0xA8, 0x38), // slightly darker · used for big-digit hero
     cream: rgb(0xF8, 0xF5, 0xEE),
     teal: rgb(0x00, 0xD4, 0xAA),
     scarlet: rgb(0xC8, 0x10, 0x2E),

package/dist/lib/render.js

@@ -94,19 +94,22 @@ export function renderAudit(view) {
     lines.push('  ' + c.bold(c.cream(name)) + '   ' + c.muted(slug));
     lines.push('');
     // 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);
+    // Always brand gold (slightly deeper tone for screenshot legibility) so
+    // the wordmark + score read as one cohesive brand mark. Band info is
+    // surfaced in the small caption underneath instead of via color.
     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));
+        lines.push('  ' + ' '.repeat(leftPad) + c.goldDeep(row));
     }
-    // Caption beneath the big number — small "/ 100 · band"
+    // Caption · small "/ 100 · band" · band tinted so the signal lives there.
     const band = total >= 75 ? 'strong' : total >= 50 ? 'mid' : 'weak';
+    const bandTone = scoreTone(total);
     const caption = `/ 100 · ${band}`;
-    lines.push('  ' + ' '.repeat(Math.floor((58 - caption.length) / 2)) + c.muted(caption));
+    // Center the caption (visible chars only — color codes don't take width).
+    const capPad = Math.floor((58 - caption.length) / 2);
+    lines.push('  ' + ' '.repeat(capPad) + c.muted('/ 100 · ') + bandTone(band));
     lines.push('');
     // 3-axis bars
     const auditLine = `  Audit  ${pad(`${p.score_auto}/50`, 7)}  ${scoreBar(p.score_auto, 50)}`;
@@ -298,6 +301,69 @@ 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 horiz = '─'.repeat(58);
+    lines.push('  ' + c.muted('┌' + horiz + '┐'));
+    lines.push('  ' + c.muted('│ ') + c.bold(c.gold('commit.show')) + c.muted(' · ') + c.scarlet(label) + ' '.repeat(Math.max(0, 58 - 14 - label.length)) + c.muted('│'));
+    lines.push('  ' + c.muted('│' + ' '.repeat(58) + '│'));
+    if (projectName) {
+        lines.push('  ' + c.muted('│ ') + c.cream(`Repo: ${projectName}`) + ' '.repeat(Math.max(0, 56 - 6 - projectName.length)) + c.muted('│'));
+        lines.push('  ' + c.muted('│' + ' '.repeat(58) + '│'));
+    }
+    for (const w of wrapText(detail, 54)) {
+        lines.push('  ' + c.muted('│ ') + c.cream(w) + ' '.repeat(Math.max(0, 56 - w.length)) + c.muted('│'));
+    }
+    if (err.retry_after_seconds && err.retry_after_seconds > 0) {
+        lines.push('  ' + c.muted('│' + ' '.repeat(58) + '│'));
+        const t = `Retry after ~${untilHuman(err.retry_after_seconds)}`;
+        lines.push('  ' + c.muted('│ ') + c.dim(t) + ' '.repeat(Math.max(0, 56 - t.length)) + c.muted('│'));
+    }
+    lines.push('  ' + c.muted('│' + ' '.repeat(58) + '│'));
+    const statusLine = `Status check: commitshow status ${projectName ?? '<repo>'}`;
+    lines.push('  ' + c.muted('│ ') + c.dim(statusLine) + ' '.repeat(Math.max(0, 56 - statusLine.length)) + c.muted('│'));
+    if (projectUrl) {
+        lines.push('  ' + c.muted('│ ') + c.dim('Web view: ') + c.cream(projectUrl.length > 44 ? projectUrl.slice(0, 41) + '…' : projectUrl) + ' '.repeat(Math.max(0, 46 - Math.min(44, projectUrl.length))) + c.muted('│'));
+    }
+    lines.push('  ' + c.muted('└' + horiz + '┘'));
+    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);

package/package.json

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