scribeclock 0.1.3 → 0.1.4

package/README.md

@@ -50,7 +50,7 @@ Run `scribeclock --help` for the full list and `scribeclock <command> --help` fo
 | Cloudflare | `cf accounts\|zones\|dns\|dns set\|dns rm\|dns diff\|pages\|deployments\|deploy-status\|workers\|purge\|request` |
 | Team | `team` · `overlap [files…]` (exit 4 on overlap) · `team report` · `handoff [record]` |
 | Git | `branch KEY [--create]` · `commit -m "…"` · `pr KEY` · `changelog --since <tag>` |
-| Bug reports | `connect [--env] [--vault] [--create]` · `issues [show\|resolve --release X\|ignore\|reopen\|task]` · `bug "title" [-d …] [--log file] [--stack file]` · `ingest keys\|revoke\|test\|snippets` · `health [--days N]` |
+| Bug reports | `connect [--env] [--vault] [--create]` · `issues [show\|resolve --release X\|ignore\|reopen\|task\|urgency]` · `analytics [--days N] [--report X] [--csv]` · `ingest settings [--immediate critical --per-hour 2 --every 120]` · `bug "title" [-d …] [--log file] [--stack file]` · `ingest keys\|revoke\|test\|snippets\|forward [provider]` · `health [--days N]` |
 | Ops & agents | `doctor` · `watch tasks [--on-change cmd]` · `serve --stdio` · `mcp-config <client> [--install]` · `ask "…"` |
 | Raw tools | `tools` · `call <tool> [--arg v \| --args '{json}']` · `<tool_name> …` · `refresh` |
 
@@ -77,6 +77,7 @@ scribeclock issues show 3f2a9c1b   # stack trace, breadcrumbs, trace logs, conte
 scribeclock bug "Checkout button does nothing" -d "Click Pay → nothing" --log logs/app.log
 scribeclock issues resolve 3f2a9c1b --release 1.4.3   # a later hit in another release reopens it as a regression
 scribeclock health --days 30
+scribeclock ingest forward sentry     # webhook URL + steps to forward Sentry / PostHog / Bugsnag / Rollbar / Crashlytics issues here
 ```
 
 ```bash

package/dist/commands/ingest.js

@@ -120,6 +120,48 @@ sys.excepthook = lambda t, v, tb: report(v, level="fatal")`,
         },
     ];
 }
+/** Forward webhooks from an existing bug tracker (mirrors supabase/functions/_shared/ingestProviders.ts). */
+export function providerSetups(key) {
+    const u = (p) => `${INGEST_URL}/${p}?key=${key}`;
+    return [
+        { id: "sentry", label: "Sentry", url: u("sentry"), steps: ["Alerts → Create Alert Rule → action “Send a notification via a webhook”, or Settings → Developer Settings → Internal Integrations → Webhook URL (issue + error webhooks on).", "Paste the URL. For an internal integration, store its Client Secret on the key: scribeclock update_ingest_key --key-id <id> --webhook-secret <secret>", "Each Sentry issue becomes one ScribeClock issue; the task links back to Sentry."] },
+        { id: "posthog", label: "PostHog", url: u("posthog"), steps: ["Data pipelines → Destinations → Webhook; keep the default body ({ event, person }).", "Filter on the $exception event for error tracking; other events are counted as analytics.", "Optional: header X-ScribeClock-Secret matching the key's webhook secret."] },
+        { id: "bugsnag", label: "Bugsnag", url: u("bugsnag"), steps: ["Project Settings → Integrations → Data forwarding → Webhook.", "Paste the URL and pick the triggers to forward (new, reopened, spikes).", "Optional shared secret: add ?secret=… to the URL and set the same value on the key."] },
+        { id: "rollbar", label: "Rollbar", url: u("rollbar"), steps: ["Project → Settings → Notifications → Webhook.", "Paste the URL; enable new item / reactivated item / high occurrence rules.", "Optional shared secret: ?secret=… on the URL."] },
+        { id: "crashlytics", label: "Firebase Crashlytics", url: u("crashlytics"), steps: ["Crashlytics has no outgoing webhook: add a Cloud Function on the Firebase Alerts trigger (onNewFatalIssuePublished, onRegressionAlertPublished, onNewNonfatalIssuePublished).", "POST { alertType, appId, payload } from the alert to this URL — snippet: https://scribeclock.com/help/bug-reports#forward", "Each Crashlytics issue becomes one ScribeClock issue with a link to the Firebase console."] },
+        { id: "webhook", label: "Anything else", url: u("webhook"), steps: ["Point the tool's webhook at this URL with a JSON body.", "Common fields are picked up: message / title, stack, level / severity, url, user, environment, release, id (grouping), url (link back); the whole payload is kept under extra.", "When you control the body, send the native event shape instead (scribeclock ingest snippets)."] },
+    ];
+}
+export const ingestForward = cmd({
+    path: "ingest forward",
+    group: "Bug reports",
+    summary: "Webhook URLs and steps to forward Sentry, PostHog, Bugsnag, Rollbar, Crashlytics or any tool's reports into this project.",
+    description: "Prints the per-provider URL (the ingest key rides in it, since most tools cannot set headers) and where to paste it. Each issue in the other tool becomes one ScribeClock issue and task that links back. Set a webhook secret on the key (update_ingest_key --webhook-secret) to verify Sentry signatures or a shared secret the tool echoes.",
+    tool: ["list_ingest_keys"],
+    positionals: [{ name: "provider", description: "sentry, posthog, bugsnag, rollbar, crashlytics or webhook (default: all)." }],
+    flags: [{ name: "key", alias: "k", type: "string", description: `Ingest key to embed (default: ${KEY_ENV} from the environment / .env).` }],
+    examples: ["scribeclock ingest forward", "scribeclock ingest forward sentry", "scribeclock ingest forward posthog --json | jq -r .providers[0].url"],
+    async run(ctx, inv) {
+        const key = ingestKeyFor(ctx, str(inv.flags.key)) ?? "sc_ing_<your-key>";
+        const want = inv.positionals[0]?.toLowerCase();
+        const providers = providerSetups(key).filter((p) => !want || p.id === want);
+        if (!providers.length)
+            throw usageError(`Unknown provider "${want}".`, "One of: sentry, posthog, bugsnag, rollbar, crashlytics, webhook.");
+        if (ctx.flags.json) {
+            ctx.out.jsonOut({ ok: true, providers });
+            return EXIT.OK;
+        }
+        for (const p of providers) {
+            ctx.out.log(ctx.out.bold(`── ${p.label}`));
+            ctx.out.log(`  ${p.url}`);
+            p.steps.forEach((s, i) => ctx.out.log(`  ${i + 1}. ${s}`));
+            ctx.out.log("");
+        }
+        if (key.startsWith("sc_ing_<"))
+            ctx.out.info(ctx.out.dim(`No ingest key found: run \`scribeclock connect --env\` first, or pass --key.`));
+        return EXIT.OK;
+    },
+});
 // ───────────────────────────── connect ─────────────────────────────
 export const connectCommand = cmd({
     path: "connect",
@@ -226,6 +268,18 @@ function levelPaint(ctx, level) {
         return ctx.out.yellow("warning");
     return ctx.out.dim(l);
 }
+function urgencyPaint(ctx, u) {
+    const s = String(u ?? "");
+    if (s === "critical")
+        return ctx.out.red(ctx.out.bold("critical"));
+    if (s === "high")
+        return ctx.out.red("high");
+    if (s === "medium")
+        return ctx.out.yellow("medium");
+    if (s === "low")
+        return ctx.out.dim("low");
+    return s;
+}
 function issueStatusPaint(ctx, status) {
     const s = String(status ?? "");
     if (s === "open")
@@ -255,12 +309,13 @@ export const issuesList = cmd({
         PROJECT_FLAG,
         REPO_FLAG,
         { name: "status", alias: "s", type: "string", choices: ["open", "resolved", "ignored", "all"], description: "Default open." },
+        { name: "urgency", alias: "u", type: "string", choices: ["critical", "high", "medium", "low"], description: "Only this urgency." },
         { name: "level", alias: "l", type: "string", choices: ["fatal", "error", "warning", "info"], description: "Only this level." },
         { name: "kind", alias: "k", type: "string", choices: ["error", "bug_report", "message"], description: "Only this kind." },
         { name: "environment", alias: "e", type: "string", description: "Only issues seen in this environment." },
         { name: "release", type: "string", description: "Only issues seen in this release." },
         { name: "since", type: "string", placeholder: "<date>", description: "Only issues seen since (YYYY-MM-DD or ISO)." },
-        { name: "order", type: "string", choices: ["last_seen", "first_seen", "count", "users", "level"], description: "Sort (default last_seen)." },
+        { name: "order", type: "string", choices: ["urgency", "last_seen", "first_seen", "count", "users", "level"], description: "Sort (default urgency, then last seen)." },
         { name: "limit", alias: "n", type: "number", description: "Max issues (default 50)." },
         { name: "ids", type: "boolean", description: "Print short ids only." },
     ],
@@ -269,6 +324,7 @@ export const issuesList = cmd({
         const data = await ctx.call("list_issues", {
             ...issueTargetArgs(ctx, inv),
             status: str(inv.flags.status),
+            urgency: str(inv.flags.urgency),
             level: str(inv.flags.level),
             kind: str(inv.flags.kind),
             environment: str(inv.flags.environment),
@@ -292,8 +348,9 @@ export const issuesList = cmd({
                     ctx.out.info(ctx.out.dim(String(data.hint)));
                 return;
             }
-            ctx.out.table(["id", "level", "title", "where", "count", "users", "last seen", "status", "task"], issues.map((i) => [i.short_id, levelPaint(ctx, i.level), i.title, i.culprit ?? "", i.event_count, i.user_count, relTime(String(i.last_seen_at ?? ""), ctx.now()), issueStatusPaint(ctx, i.status), i.task?.key ?? ""]), { maxWidth: 48 });
-            ctx.out.info(ctx.out.dim(`${String(data.total ?? issues.length)} issue${Number(data.total ?? issues.length) === 1 ? "" : "s"} · ${String(summary.open ?? 0)} open · ${String(summary.new_24h ?? 0)} new in 24 h · ${String(summary.events_24h ?? 0)} events in 24 h${Number(summary.regressed_7d ?? 0) ? ` · ${String(summary.regressed_7d)} regressed this week` : ""}`));
+            ctx.out.table(["id", "urgency", "level", "title", "where", "count", "users", "last seen", "status", "task"], issues.map((i) => [i.short_id, urgencyPaint(ctx, i.urgency), levelPaint(ctx, i.level), i.title, i.culprit ?? "", i.event_count, i.user_count, relTime(String(i.last_seen_at ?? ""), ctx.now()), issueStatusPaint(ctx, i.status), i.task?.key ?? ""]), { maxWidth: 44 });
+            const u = (summary.by_urgency ?? {});
+            ctx.out.info(ctx.out.dim(`${String(data.total ?? issues.length)} issue${Number(data.total ?? issues.length) === 1 ? "" : "s"} · ${String(summary.open ?? 0)} open (${String(u.critical ?? 0)} critical, ${String(u.high ?? 0)} high) · ${String(summary.new_24h ?? 0)} new in 24 h · ${String(summary.events_24h ?? 0)} events in 24 h${Number(summary.regressed_7d ?? 0) ? ` · ${String(summary.regressed_7d)} regressed this week` : ""}`));
         });
     },
 });
@@ -318,8 +375,10 @@ export const issuesShow = cmd({
             const task = i.task;
             out.kv([
                 ["status", issueStatusPaint(ctx, i.status)],
+                ["urgency", `${urgencyPaint(ctx, i.urgency)}${i.urgency_pinned ? out.dim(" (pinned)") : ""}`],
                 ["level", levelPaint(ctx, i.level)],
                 ["kind", i.kind],
+                ["bundled", Number(i.bundled_fingerprints ?? 1) > 1 ? `${String(i.bundled_fingerprints)} similar fingerprints bundled` : ""],
                 ["where", i.culprit],
                 ["project", i.project?.name],
                 ["repo", i.repo],
@@ -768,4 +827,204 @@ export const healthCommand = cmd({
         });
     },
 });
-export const INGEST_COMMANDS = [connectCommand, issuesList, issuesShow, issuesResolve, issuesIgnore, issuesReopen, issuesTask, bugCommand, ingestKeys, ingestRevoke, ingestTest, ingestSnippetsCommand, healthCommand];
+export const issuesUrgency = cmd({
+    path: "issues urgency",
+    group: "Bug reports",
+    summary: "Pin an issue's urgency (critical, high, medium, low) or set it back to auto; the task priority follows.",
+    tool: "update_issue",
+    positionals: [{ name: "issue", required: true, description: "Issue id or task key." }, { name: "urgency", required: true, description: "critical | high | medium | low | auto" }],
+    examples: ["scribeclock issues urgency 3f2a9c1b critical", "scribeclock issues urgency '#731' auto"],
+    async run(ctx, inv) {
+        const ref = requirePositional(inv, 0, "An issue id", "scribeclock issues urgency 3f2a9c1b high");
+        const urgency = requirePositional(inv, 1, "An urgency", "scribeclock issues urgency 3f2a9c1b high").toLowerCase();
+        if (!["critical", "high", "medium", "low", "auto"].includes(urgency))
+            throw usageError(`Unknown urgency "${urgency}".`, "One of: critical, high, medium, low, auto.");
+        const data = await ctx.call("update_issue", { issue_id: /^#?\d+$/.test(ref) ? taskKey(ctx, ref) : ref, urgency });
+        return emit(ctx, data, () => {
+            const i = (data.issue ?? {});
+            ctx.out.log(`${ctx.out.green("✓")} ${String(i.short_id ?? ref)} urgency ${urgencyPaint(ctx, i.urgency)}${i.urgency_pinned ? "" : ctx.out.dim(" (auto)")} — ${String(i.title ?? "")}`);
+        });
+    },
+});
+export const ingestSettings = cmd({
+    path: "ingest settings",
+    group: "Bug reports",
+    summary: "Show or change how bug reports notify people: immediate emails by urgency, hourly cap, digest cadence, extra recipients, similarity.",
+    tool: "ingest_settings",
+    flags: [
+        PROJECT_FLAG,
+        { name: "immediate", type: "string", choices: ["critical", "high", "medium", "low", "never"], description: "Email right away at or above this urgency (default high)." },
+        { name: "per-hour", type: "number", description: "At most this many immediate emails per hour (default 3); the rest wait for the digest." },
+        { name: "digest", type: "string", choices: ["on", "off"], description: "Bundle everything else into one digest email." },
+        { name: "every", type: "number", placeholder: "<minutes>", description: "Digest cadence in minutes (15–1440, default 60)." },
+        { name: "emails", type: "array", placeholder: "<a@x,b@y>", description: "Extra recipients besides the organization's task managers." },
+        { name: "similarity", type: "number", description: "0.3–1.0: how alike two report titles must be to bundle into one issue (default 0.70)." },
+    ],
+    examples: ["scribeclock ingest settings", "scribeclock ingest settings --immediate critical --per-hour 2 --every 120", "scribeclock ingest settings --digest off --emails oncall@acme.com"],
+    async run(ctx, inv) {
+        const project_id = projectArg(ctx, inv, { required: true });
+        const args = { project_id };
+        if (str(inv.flags.immediate))
+            args.immediate_min_urgency = inv.flags.immediate;
+        if (num(inv.flags["per-hour"]) !== undefined)
+            args.immediate_per_hour = inv.flags["per-hour"];
+        if (str(inv.flags.digest))
+            args.digest_enabled = inv.flags.digest === "on";
+        if (num(inv.flags.every) !== undefined)
+            args.digest_interval_minutes = inv.flags.every;
+        if (list(inv.flags.emails))
+            args.notify_emails = list(inv.flags.emails);
+        if (num(inv.flags.similarity) !== undefined)
+            args.similarity_threshold = inv.flags.similarity;
+        const data = await ctx.call("ingest_settings", args);
+        return emit(ctx, data, () => {
+            const sset = (data.settings ?? {});
+            ctx.out.log(ctx.out.bold(`Bug report notifications${data.changed ? ctx.out.green(" (updated)") : ""}`));
+            ctx.out.kv([
+                ["email immediately", sset.immediate_min_urgency === "never" ? "never" : `${String(sset.immediate_min_urgency)} and above, at most ${String(sset.immediate_per_hour)} per hour`],
+                ["digest", sset.digest_enabled ? `every ${String(sset.digest_interval_minutes)} min` : "off"],
+                ["extra recipients", sset.notify_emails?.join(", ")],
+                ["similarity", String(sset.similarity_threshold)],
+                ["pending for digest", data.pending_digest_items],
+                ["immediate emails (24 h)", data.immediate_emails_24h],
+            ]);
+            const recent = (data.recent ?? []);
+            if (recent.length) {
+                ctx.out.log("");
+                ctx.out.log(ctx.out.bold("Recent notifications"));
+                ctx.out.table(["when", "kind", "urgency", "mode", "title"], recent.slice(0, 10).map((n) => [relTime(String(n.created_at ?? ""), ctx.now()), n.kind, urgencyPaint(ctx, n.urgency), n.sent_at ? String(n.mode) : `${String(n.mode)} (pending)`, n.title]), { maxWidth: 56, indent: 2 });
+            }
+        });
+    },
+});
+function pct(v) {
+    return v === null || v === undefined ? "–" : `${String(v)}%`;
+}
+function delta(cur, prev) {
+    const c = Number(cur ?? 0);
+    const p = Number(prev ?? 0);
+    if (!p)
+        return c ? "new" : "–";
+    const d = Math.round(((c - p) / p) * 100);
+    return `${d >= 0 ? "+" : ""}${d}%`;
+}
+export const analyticsCommand = cmd({
+    path: "analytics",
+    group: "Bug reports",
+    summary: "Usage and stability report: active users, sessions, retention, crash-free rates, top screens and clicks, releases, issues by urgency.",
+    description: "Everything behind the project's Analytics page, as tables (or --json for the raw series to chart or feed into a report). Pass --report to print one section only; --csv writes the daily series as CSV.",
+    tool: "project_analytics",
+    flags: [
+        PROJECT_FLAG,
+        REPO_FLAG,
+        { name: "days", alias: "d", type: "number", description: "Window in days (default 30, max 180)." },
+        { name: "environment", alias: "e", type: "string", description: "Only this environment." },
+        { name: "report", type: "string", choices: ["overview", "daily", "retention", "screens", "clicks", "events", "breakdowns", "releases", "issues", "hourly"], description: "One section only." },
+        { name: "csv", type: "boolean", description: "Print the daily series as CSV." },
+    ],
+    examples: ["scribeclock analytics", "scribeclock analytics --days 7 --report releases", "scribeclock analytics --days 90 --csv > usage.csv", "scribeclock analytics --json | jq .totals"],
+    async run(ctx, inv) {
+        const data = await ctx.call("project_analytics", { ...issueTargetArgs(ctx, inv), days: num(inv.flags.days), environment: str(inv.flags.environment) });
+        const daily = (data.daily ?? []);
+        if (inv.flags.csv) {
+            const cols = ["day", "users", "new_users", "sessions", "avg_session_minutes", "pageviews", "clicks", "events", "errors", "crashes", "warnings", "bug_reports", "issues_opened", "issues_resolved", "crash_free_sessions_pct", "crash_free_users_pct"];
+            ctx.out.log(cols.join(","));
+            for (const d of daily)
+                ctx.out.log(cols.map((c) => String(d[c] ?? "")).join(","));
+            return EXIT.OK;
+        }
+        return emit(ctx, data, () => {
+            const out = ctx.out;
+            const t = (data.totals ?? {});
+            const prev = (data.previous ?? {});
+            const report = str(inv.flags.report) ?? "all";
+            const show = (name) => report === "all" || report === name;
+            const p = (data.project ?? {});
+            out.log(`${out.bold(String(p.name ?? ""))} · last ${String(data.days)} days${data.environment ? ` · ${String(data.environment)}` : ""}`);
+            if (show("overview")) {
+                out.log("");
+                out.log(out.bold("Overview") + out.dim("  (vs previous window)"));
+                out.kv([
+                    ["active users", `${String(t.users ?? 0)} (${delta(t.users, prev.users)}) · ${String(t.new_users ?? 0)} new · stickiness ${pct(t.stickiness_pct)} · MAU ${String(t.mau ?? 0)}`],
+                    ["sessions", `${String(t.sessions ?? 0)} (${delta(t.sessions, prev.sessions)}) · ${String(t.avg_session_minutes ?? 0)} min avg · ${String(t.avg_screens_per_session ?? 0)} screens/session`],
+                    ["crash-free", `${pct(t.crash_free_sessions_pct)} sessions · ${pct(t.crash_free_users_pct)} users`],
+                    ["page views / clicks", `${String(t.pageviews ?? 0)} / ${String(t.clicks ?? 0)} · ${String(t.events ?? 0)} events (${delta(t.events, prev.events)})`],
+                    ["errors / crashes", `${String(t.errors ?? 0)} (${delta(t.errors, prev.errors)}) / ${String(t.crashes ?? 0)} (${delta(t.crashes, prev.crashes)}) · ${String(t.users_affected ?? 0)} users affected`],
+                    ["bug reports", `${String(t.bug_reports ?? 0)} (${delta(t.bug_reports, prev.bug_reports)})`],
+                    ["issues", `${String(t.issues_opened ?? 0)} opened · ${String(t.issues_resolved ?? 0)} resolved · ${String(t.issues_regressed ?? 0)} regressed · ${String(t.open_issues ?? 0)} open · MTTR ${String(t.mttr_hours ?? 0)} h`],
+                    ["emails", `${String(t.emails_immediate ?? 0)} immediate · ${String(t.emails_digest ?? 0)} digests`],
+                ]);
+            }
+            if (show("daily") && daily.some((d) => Number(d.users) || Number(d.events) || Number(d.errors) || Number(d.crashes))) {
+                out.log("");
+                out.log(out.bold("Per day"));
+                out.table(["day", "users", "new", "sessions", "views", "clicks", "errors", "crashes", "bugs", "crash-free"], daily.map((d) => [d.day, d.users, d.new_users, d.sessions, d.pageviews, d.clicks, d.errors, d.crashes, d.bug_reports, pct(d.crash_free_sessions_pct)]), { indent: 2 });
+            }
+            const ret = (data.retention ?? []);
+            if (show("retention") && ret.length) {
+                out.log("");
+                out.log(out.bold("Retention") + out.dim("  weekly cohorts: active 1–4 weeks after first seen"));
+                out.table(["cohort week", "users", "week 1", "week 2", "week 3", "week 4"], ret.map((r) => [r.cohort_week, r.users, pct(r.week1_pct), pct(r.week2_pct), pct(r.week3_pct), pct(r.week4_pct)]), { indent: 2 });
+            }
+            const screens = (data.top_screens ?? []);
+            if (show("screens") && screens.length) {
+                out.log("");
+                out.log(out.bold("Top screens"));
+                out.table(["screen", "views", "users", "clicks", "errors"], screens.map((x) => [x.screen, x.views, x.users, x.clicks, x.errors]), { indent: 2, maxWidth: 50 });
+            }
+            const clicks = (data.top_clicks ?? []);
+            if (show("clicks") && clicks.length) {
+                out.log("");
+                out.log(out.bold("Top clicks"));
+                out.table(["screen", "element", "clicks"], clicks.map((x) => [x.screen, x.element, x.clicks]), { indent: 2, maxWidth: 50 });
+            }
+            const events = (data.top_events ?? []);
+            if (show("events") && events.length) {
+                out.log("");
+                out.log(out.bold("Top events"));
+                out.table(["event", "count", "users", "environments"], events.map((x) => [x.name, x.count, x.users, x.environments?.join(", ") ?? ""]), { indent: 2 });
+            }
+            const bd = (data.breakdowns ?? {});
+            if (show("breakdowns")) {
+                for (const key of ["platform", "country", "browser", "os", "environment"]) {
+                    const rows = (bd[key] ?? []);
+                    if (!rows.length || (rows.length === 1 && rows[0].value === "unknown"))
+                        continue;
+                    out.log("");
+                    out.log(out.bold(`By ${key}`));
+                    out.table([key, "sessions", "users"], rows.map((x) => [x.value, x.sessions, x.users]), { indent: 2 });
+                }
+            }
+            const releases = (data.releases ?? []);
+            if (show("releases") && releases.length) {
+                out.log("");
+                out.log(out.bold("Releases"));
+                out.table(["release", "sessions", "users", "crash-free", "errors", "crashes", "issues", "adoption", "first seen"], releases.map((r) => [r.release, r.sessions, r.users, pct(r.crash_free_sessions_pct), r.errors, r.crashes, r.issues, pct(r.adoption_pct), relTime(String(r.first_seen_at ?? ""), ctx.now())]), { indent: 2 });
+            }
+            const iss = (data.issues ?? {});
+            if (show("issues")) {
+                const u = (iss.open_by_urgency ?? {});
+                out.log("");
+                out.log(out.bold("Issues") + out.dim(`  open: ${String(u.critical ?? 0)} critical · ${String(u.high ?? 0)} high · ${String(u.medium ?? 0)} medium · ${String(u.low ?? 0)} low`));
+                const top = (iss.top_by_users ?? []);
+                if (top.length)
+                    out.table(["id", "urgency", "title", "users", "count", "task"], top.map((i) => [i.short_id, urgencyPaint(ctx, i.urgency), i.title, i.user_count, i.event_count, i.task?.key ?? ""]), { indent: 2, maxWidth: 50 });
+                const byScreen = (iss.errors_by_screen ?? []);
+                if (byScreen.length) {
+                    out.log(out.dim(`  errors by screen: ${byScreen.map((x) => `${String(x.screen)} ${String(x.errors)}`).join(" · ")}`));
+                }
+            }
+            const hourly = (data.hourly ?? []);
+            if (show("hourly") && hourly.some((h) => Number(h.events) || Number(h.errors))) {
+                out.log("");
+                out.log(out.bold("Hour of day (UTC)") + out.dim("  events / errors"));
+                const max = Math.max(1, ...hourly.map((h) => Number(h.events)));
+                out.log(`  ${hourly.map((h) => String(h.hour).padStart(2, "0")).join(" ")}`);
+                out.log(`  ${hourly.map((h) => { const n = Number(h.events); const lvl = n === 0 ? " " : n < max / 4 ? "▁" : n < max / 2 ? "▃" : n < (3 * max) / 4 ? "▅" : "█"; return ` ${lvl}`; }).join(" ")}`);
+            }
+            if (data.hint && !Number(t.events) && !Number(t.sessions))
+                out.info(out.dim(String(data.hint)));
+        });
+    },
+});
+export const INGEST_COMMANDS = [connectCommand, issuesList, issuesShow, issuesResolve, issuesIgnore, issuesReopen, issuesTask, bugCommand, ingestKeys, ingestRevoke, ingestTest, ingestSnippetsCommand, ingestForward, ingestSettings, issuesUrgency, analyticsCommand, healthCommand];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scribeclock",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "ScribeClock from the terminal: tasks, time clock, projects, PRDs, meetings, files, vault and Cloudflare — a thin client over the ScribeClock MCP server.",
   "license": "UNLICENSED",
   "author": "Haydar Al-Karar LLC, dba Karar Tech",