scribeclock 0.1.6 → 0.1.7

package/README.md

@@ -72,6 +72,7 @@ the app become tasks on the project; docs: https://scribeclock.com/help/bug-repo
 ```bash
 scribeclock connect --env          # links this repo to its project, writes .scribeclock.json + SCRIBECLOCK_INGEST_KEY to .env
 scribeclock ingest prompt --platform ios | pbcopy   # the prompt to paste into your AI agent: key, event shape, stack-specific steps
+scribeclock issues diagnose 3f2a9c1b --comment       # root-cause brief: where it died, likely causes, what to check, files to open
 scribeclock ingest test            # sends a test error straight to https://scribeclock.com/ingest → issue + task
 scribeclock issues                 # what users hit: level, title, where, count, users, last seen, task
 scribeclock issues show 3f2a9c1b   # stack trace, breadcrumbs, trace logs, context

package/dist/commands/ingest.js

@@ -477,6 +477,36 @@ async function issueStatusCommand(ctx, inv, status) {
             ctx.out.info(ctx.out.dim("Tip: pass --release <version> (or --commit) so a later occurrence in another release counts as a regression."));
     });
 }
+export const issuesDiagnose = cmd({
+    path: "issues diagnose",
+    group: "Bug reports",
+    summary: "Root-cause brief for an issue: where it died (app frames only), likely causes with evidence, what to check, files to open, the trail to reproduce.",
+    description: "Reads everything stored for the issue and prints a diagnosis: the app's own frames with reporter and runtime plumbing removed (Swift symbols demangled), the failure category and the most likely causes with the evidence and the exact checks for each, the files / functions to open, the breadcrumb trail to reproduce, impact by release and environment, the device and the last trace logs, similar open issues. --comment posts it on the issue's task; --model adds an analysis from the organization's configured AI provider.",
+    tool: "diagnose_issue",
+    positionals: [{ name: "issue", required: true, description: "Issue id (short or full) or a task key (#123)." }],
+    flags: [
+        { name: "events", alias: "n", type: "number", description: "Recent events to read (default 10)." },
+        { name: "comment", type: "boolean", description: "Post the brief as a comment on the linked task." },
+        { name: "model", type: "boolean", description: "Also ask the organization's AI provider for a written analysis." },
+    ],
+    examples: ["scribeclock issues diagnose 3f2a9c1b", "scribeclock issues diagnose '#731' --comment", "scribeclock issues diagnose 3f2a9c1b --json | jq .diagnosis.open_in_code"],
+    async run(ctx, inv) {
+        const ref = requirePositional(inv, 0, "An issue id", "scribeclock issues diagnose 3f2a9c1b");
+        const data = await ctx.call("diagnose_issue", { issue_id: ref, event_limit: num(inv.flags.events), post_comment: inv.flags.comment === true, with_model: inv.flags.model === true });
+        return emit(ctx, data, () => {
+            ctx.out.log(String(data.markdown ?? ""));
+            if (data.model_analysis) {
+                ctx.out.log("");
+                ctx.out.log(ctx.out.bold("Analysis from your AI provider"));
+                ctx.out.log(String(data.model_analysis));
+            }
+            else if (data.model_note)
+                ctx.out.info(ctx.out.dim(String(data.model_note)));
+            if (data.posted_comment)
+                ctx.out.info("Posted on the task.");
+        });
+    },
+});
 export const issuesResolve = cmd({
     path: "issues resolve",
     group: "Bug reports",
@@ -1064,4 +1094,4 @@ export const analyticsCommand = cmd({
         });
     },
 });
-export const INGEST_COMMANDS = [connectCommand, issuesList, issuesShow, issuesResolve, issuesIgnore, issuesReopen, issuesTask, bugCommand, ingestKeys, ingestRevoke, ingestTest, ingestSnippetsCommand, ingestPromptCommand, ingestForward, ingestSettings, issuesUrgency, analyticsCommand, healthCommand];
+export const INGEST_COMMANDS = [connectCommand, issuesList, issuesShow, issuesDiagnose, issuesResolve, issuesIgnore, issuesReopen, issuesTask, bugCommand, ingestKeys, ingestRevoke, ingestTest, ingestSnippetsCommand, ingestPromptCommand, ingestForward, ingestSettings, issuesUrgency, analyticsCommand, healthCommand];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scribeclock",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "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",