glitchgrab 1.2.1 → 1.4.0

package/README.md

@@ -161,13 +161,174 @@ curl -H "Authorization: Bearer gg_your_token" \
       "issue": {
         "githubNumber": 42,
         "githubUrl": "https://github.com/your/repo/issues/42",
-        "title": "Button not working"
+        "title": "Button not working",
+        "labels": ["bug"],
+        "severity": "medium",
+        "githubState": "open"
       }
     }
   ]
 }
 ```
 
+### Response fields
+
+| Field | Description |
+|-------|-------------|
+| `id` | Report ID — use this for [managing issues](#managing-issues-approve--reject--close) |
+| `source` | `SDK_AUTO` (crash) or `SDK_USER_REPORT` (user clicked report) |
+| `status` | `PENDING`, `PROCESSING`, `CREATED`, `FAILED` |
+| `reporterPrimaryKey` | The `userId` you passed in the session prop |
+| `reporterName` | Reporter's display name |
+| `issue.githubState` | Live GitHub issue state: `open`, `closed`, or `null` if deleted |
+| `issue.labels` | Labels on the GitHub issue (e.g., `["bug", "approved"]`) |
+| `issue.severity` | AI-assigned severity |
+```
+
+## Managing Issues (Approve / Reject / Close)
+
+Once a report creates a GitHub issue, you can manage it from the dashboard or via API.
+
+### Dashboard
+
+Go to **Reports > Product Issues**. Each open report shows:
+- **Approve** — adds `approved` label to GitHub issue
+- **Reject** — adds `rejected` label to GitHub issue
+- **Close** — closes the GitHub issue
+
+### REST API
+
+`POST /api/v1/reports/{reportId}/actions`
+
+Auth: `Bearer gg_` token or dashboard session.
+
+#### Approve a report
+
+```bash
+curl -X POST \
+  -H "Authorization: Bearer gg_your_token" \
+  -H "Content-Type: application/json" \
+  -d '{"action": "label", "label": "approved"}' \
+  https://glitchgrab.dev/api/v1/reports/REPORT_ID/actions
+```
+
+#### Reject a report
+
+```bash
+curl -X POST \
+  -H "Authorization: Bearer gg_your_token" \
+  -H "Content-Type: application/json" \
+  -d '{"action": "label", "label": "rejected"}' \
+  https://glitchgrab.dev/api/v1/reports/REPORT_ID/actions
+```
+
+#### Close an issue
+
+```bash
+curl -X POST \
+  -H "Authorization: Bearer gg_your_token" \
+  -H "Content-Type: application/json" \
+  -d '{"action": "close"}' \
+  https://glitchgrab.dev/api/v1/reports/REPORT_ID/actions
+```
+
+#### Reopen an issue
+
+```bash
+curl -X POST \
+  -H "Authorization: Bearer gg_your_token" \
+  -H "Content-Type: application/json" \
+  -d '{"action": "reopen"}' \
+  https://glitchgrab.dev/api/v1/reports/REPORT_ID/actions
+```
+
+#### Remove a label
+
+```bash
+curl -X POST \
+  -H "Authorization: Bearer gg_your_token" \
+  -H "Content-Type: application/json" \
+  -d '{"action": "unlabel", "label": "rejected"}' \
+  https://glitchgrab.dev/api/v1/reports/REPORT_ID/actions
+```
+
+#### Add any custom label
+
+```bash
+curl -X POST \
+  -H "Authorization: Bearer gg_your_token" \
+  -H "Content-Type: application/json" \
+  -d '{"action": "label", "label": "high-priority"}' \
+  https://glitchgrab.dev/api/v1/reports/REPORT_ID/actions
+```
+
+### How to get the report ID
+
+Use the [Fetching Reports API](#fetching-reports-by-user) to list reports. Each report has an `id` field — use that as `REPORT_ID`.
+
+### How it works
+
+1. End-user reports a bug via SDK -> GitHub issue created
+2. You fetch reports via API or view on dashboard
+3. Approve/reject/close via API or dashboard buttons
+4. Labels and state sync directly to GitHub — GitHub is the source of truth
+
+## Conversation Thread (Comments)
+
+Each report has a conversation thread powered by GitHub issue comments. No extra database — comments live on GitHub.
+
+### View a report with comments
+
+```bash
+curl -H "Authorization: Bearer gg_your_token" \
+  https://glitchgrab.dev/api/v1/sdk/reports/REPORT_ID
+```
+
+Returns the full issue body + all comments:
+
+```json
+{
+  "success": true,
+  "data": {
+    "id": "cmn7abc123",
+    "issue": {
+      "title": "Button not working",
+      "body": "## Description\n\nThe submit button...",
+      "githubState": "open",
+      "labels": ["bug"]
+    },
+    "comments": [
+      {
+        "author": "WebNaresh",
+        "body": "Can you share your browser version?",
+        "createdAt": "2026-03-27T10:00:00Z"
+      },
+      {
+        "author": "WebNaresh",
+        "body": "It's Chrome 120 on Windows\n\n---\n> Commented by: **Vivek** (vivek@example.com)",
+        "createdAt": "2026-03-27T10:05:00Z"
+      }
+    ]
+  }
+}
+```
+
+### Reply to a report
+
+```bash
+curl -X POST \
+  -H "Authorization: Bearer gg_your_token" \
+  -H "Content-Type: application/json" \
+  -d '{"message": "I can reproduce this, fixing now", "reporterName": "Vivek", "reporterEmail": "vivek@example.com"}' \
+  https://glitchgrab.dev/api/v1/sdk/reports/REPORT_ID/comments
+```
+
+The comment is posted to the GitHub issue with attribution: "Commented by: **Vivek** (vivek@example.com)".
+
+### Dashboard
+
+Click any report on the Reports page to see the full conversation thread. Reply directly from the dashboard — comments sync to GitHub.
+
 ## Error Boundary
 
 Wrap components to auto-capture React errors:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glitchgrab",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",