@corelayer-ai/cli 0.4.4 → 0.4.5

package/dist/commands/issues.js

@@ -1,7 +1,7 @@
-import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
+import { createInterface } from "node:readline/promises";
 import { CorelayerClient } from "../lib/api-client.js";
-import { readConfig, resolveToken, resolveApiUrl } from "../lib/config.js";
+import { readConfig, resolveApiUrl, resolveToken } from "../lib/config.js";
 import { fail, formatDate, printJson, printTable } from "../lib/output.js";
 function readFlag(args, flag) {
     const index = args.indexOf(flag);
@@ -27,7 +27,9 @@ function removeFlags(args) {
             arg === "--page" ||
             arg === "--feedback" ||
             arg === "--last-seen-before" ||
-            arg === "--last-seen-before-or-on") {
+            arg === "--last-seen-before-or-on" ||
+            arg === "--since" ||
+            arg === "--duration") {
             skipNext = true;
             continue;
         }
@@ -55,8 +57,9 @@ USAGE:
 
 SUBCOMMANDS:
   list                  List issues in a group
-  get <id>              Show details for one issue
+  get <id|slug>         Show details for one issue
   summary               Summarize issue health for a group
+  diff                  Show issues new or changed since a timestamp
   close <id>            Close an issue (write operation)
   bulk-close            Close many issues in one request (write operation)
   reopen <id>           Reopen a closed issue (write operation)
@@ -66,25 +69,49 @@ OPTIONS:
   --group <id>          Group ID (or set default-group via 'corelayer config set')
   --status <status>     Filter by status (list)
   --severity <sev>      Filter by severity (list)
-  --limit <n>           Limit results (list)
-  --page <n>            Page number (list)
+  --limit <n>           Limit results (list, diff)
+  --page <n>            Page number (list, diff)
   --feedback <text>     Feedback message (close)
   --last-seen-before <date|preset>
                         Filter bulk-close to issues seen before a cutoff
   --last-seen-before-or-on <date|preset>
                         Filter bulk-close to issues seen on or before a cutoff
+  --since <timestamp|preset>
+                        Diff: ISO 8601 timestamp or preset (1hour, 24hours, 7days, 14days, 30days)
+  --duration <duration>
+                        Diff: human-friendly duration (e.g. 2hours, 4hours, 30m, 1d)
   --yes                 Skip confirmation prompt (delete)
   --json                Output as JSON
   -h, --help            Print help
 
 EXAMPLES:
   corelayer issues list --group g_123 --status Open
-  corelayer issues get i_456 --json
+  corelayer issues get corelayer-prod-engine-20260602-1 --json
+  corelayer issues diff --group g_123 --since 2026-06-01T00:00:00Z
+  corelayer issues diff --group g_123 --since 24hours
+  corelayer issues diff --group g_123 --duration 2hours --limit 50
   corelayer issues close i_456 --feedback "fixed in deploy 2026-04-07"
   corelayer issues bulk-close --group g_123 --last-seen-before-or-on 14days --feedback "Not seen in two weeks"
   corelayer issues delete i_456 --yes
 `);
 }
+function parseDuration(value) {
+    const match = value
+        .trim()
+        .toLowerCase()
+        .match(/^(\d+(?:\.\d+)?)\s*(m|min|minutes?|h|hr|hours?|d|days?)$/);
+    if (!match)
+        return null;
+    const n = parseFloat(match[1]);
+    const unit = match[2];
+    if (unit.startsWith("m"))
+        return Math.round(n * 60 * 1000);
+    if (unit.startsWith("h"))
+        return Math.round(n * 60 * 60 * 1000);
+    if (unit.startsWith("d"))
+        return Math.round(n * 24 * 60 * 60 * 1000);
+    return null;
+}
 export async function runIssues(args, ctx) {
     if (args.includes("--help") || args.includes("-h")) {
         printHelp();
@@ -114,7 +141,7 @@ export async function runIssues(args, ctx) {
             printJson(result);
             return;
         }
-        const rows = result.issues.map(issue => [
+        const rows = result.issues.map((issue) => [
             issue.id,
             issue.slug || "-",
             issue.severity || "-",
@@ -129,11 +156,11 @@ export async function runIssues(args, ctx) {
         return;
     }
     if (sub === "get") {
-        const issueId = commandArgs[0];
-        if (!issueId) {
-            fail("Usage: corelayer issues get <issueId>");
+        const issueIdentifier = commandArgs[0];
+        if (!issueIdentifier) {
+            fail("Usage: corelayer issues get <issueId|slug>");
         }
-        const issue = await client.getIssue(issueId);
+        const issue = await client.getIssue(issueIdentifier);
         if (ctx.json) {
             printJson(issue);
             return;
@@ -239,5 +266,50 @@ export async function runIssues(args, ctx) {
         printJson(summary);
         return;
     }
-    fail("Usage: corelayer issues <list|get|close|bulk-close|reopen|delete|summary> [options]");
+    if (sub === "diff") {
+        const groupId = readFlag(args, "--group") || config.defaults?.group;
+        if (!groupId) {
+            fail("groupId is required. Use --group <groupId> or set default-group via corelayer config set default-group <groupId>");
+        }
+        const sinceFlag = readFlag(args, "--since");
+        const durationFlag = readFlag(args, "--duration");
+        if (!sinceFlag && !durationFlag) {
+            fail("One of --since <timestamp|preset> or --duration <duration> is required.\n" +
+                "Examples: --since 2026-06-01T00:00:00Z  --since 24hours  --duration 2hours");
+        }
+        let sinceValue;
+        if (durationFlag) {
+            const ms = parseDuration(durationFlag);
+            if (ms === null) {
+                fail(`Invalid --duration value: "${durationFlag}". Examples: 30m, 2hours, 4h, 1d, 7days`);
+            }
+            sinceValue = new Date(Date.now() - ms).toISOString();
+        }
+        else {
+            sinceValue = sinceFlag;
+        }
+        const result = await client.diffIssues(groupId, sinceValue, {
+            limit: readFlag(args, "--limit"),
+            page: readFlag(args, "--page"),
+        });
+        if (ctx.json) {
+            printJson(result);
+            return;
+        }
+        process.stdout.write(`DIFF SINCE ${result.since}\n`);
+        const rows = result.issues.map((issue) => [
+            issue.id,
+            issue.slug || "-",
+            issue.severity || "-",
+            issue.status || "-",
+            issue.title || "-",
+            formatDate(issue.last_seen_at || issue.lastSeenAt),
+        ]);
+        printTable(["ID", "SLUG", "SEVERITY", "STATUS", "TITLE", "LAST SEEN"], rows);
+        if (!ctx.quiet) {
+            process.stdout.write(`${result.total} issue${result.total === 1 ? "" : "s"} changed since ${result.since}\n`);
+        }
+        return;
+    }
+    fail("Usage: corelayer issues <list|get|close|bulk-close|reopen|delete|summary|diff> [options]");
 }

package/dist/lib/api-client.js

@@ -94,6 +94,15 @@ export class CorelayerClient {
     async deleteIssue(issueId) {
         await this.request("DELETE", `/api/v1/issues/${issueId}`);
     }
+    async diffIssues(groupId, since, options = {}) {
+        const params = new URLSearchParams({ groupId, since });
+        for (const [key, value] of Object.entries(options)) {
+            if (value !== undefined && value !== null && value !== "") {
+                params.set(key, String(value));
+            }
+        }
+        return this.request("GET", `/api/v1/issues/diff?${params.toString()}`);
+    }
     async getIssueSummary(groupId) {
         const params = new URLSearchParams({ groupId });
         return this.request("GET", `/api/v1/issues/summary?${params.toString()}`);
@@ -130,13 +139,13 @@ export class CorelayerClient {
         const suffix = params.toString() ? `?${params.toString()}` : "";
         const raw = await this.request("GET", `/api/v1/integrations/accounts${suffix}`);
         return {
-            accounts: (raw.accounts ?? []).map(account => ({
+            accounts: (raw.accounts ?? []).map((account) => ({
                 id: account.id,
                 group_id: account.group_id,
                 provider_code: account.provider_code,
                 is_active: account.is_active,
                 created_at: account.created_at,
-                resources: (account.resources ?? []).map(resource => ({
+                resources: (account.resources ?? []).map((resource) => ({
                     id: resource.id,
                     resource_type: resource.resource_type,
                     external_id: resource.external_id,
@@ -144,7 +153,7 @@ export class CorelayerClient {
                     is_active: resource.is_active,
                 })),
             })),
-            providers: (raw.providers ?? []).map(provider => ({
+            providers: (raw.providers ?? []).map((provider) => ({
                 provider_code: provider.provider_code,
                 display_name: provider.display_name,
             })),

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@corelayer-ai/cli",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "Corelayer CLI",
   "type": "module",
   "bin": {
-    "corelayer": "./dist/index.js"
+    "corelayer": "dist/index.js"
   },
   "files": [
     "dist",

package/skill/SKILL.md

@@ -37,12 +37,23 @@ corelayer issues list --status open
 ### Inspect a specific issue
 
 ```bash
-corelayer issues get <issueId>
-corelayer issues get <issueId> --json
+corelayer issues get <issueId|slug>
+corelayer issues get <issueId|slug> --json
 ```
 
 Returns: title, status, severity, event count, what happened, root cause, and next steps.
 
+### Diff issues since a timestamp (post-deploy triage)
+
+```bash
+corelayer issues diff --group <groupId> --since 2026-06-01T00:00:00Z
+corelayer issues diff --group <groupId> --since 24hours
+corelayer issues diff --group <groupId> --duration 2hours --limit 50
+corelayer issues diff --group <groupId> --duration 30m --json
+```
+
+Returns issues that are new or changed since the given timestamp. Useful after PR merges/deploys to identify regressions or newly surfaced issues.
+
 ### Triage issues
 
 ```bash
@@ -84,7 +95,7 @@ Setting a default group avoids repeating `--group` on every command.
 List issues for a group. Requires `--group` or a configured default group.
 Filterable by status (`open`, `closed`) and severity (`critical`, `high`, `medium`, `low`).
 
-### `corelayer issues get <issueId>`
+### `corelayer issues get <issueId|slug>`
 
 Get full details for an issue including AI-generated analysis: what happened, root cause, and next steps.
 
@@ -92,6 +103,18 @@ Get full details for an issue including AI-generated analysis: what happened, ro
 
 Returns a JSON severity breakdown for the group.
 
+### `corelayer issues diff --group <id> (--since <timestamp|preset> | --duration <duration>) [--limit <n>] [--page <n>]`
+
+Returns issues that are new or updated since the given point in time. Useful for post-deploy triage — run after a PR merge to see what regressions or new errors have surfaced.
+
+`--since` accepts an ISO 8601 timestamp (`2026-06-01T00:00:00Z`) or a preset: `1hour`, `24hours`, `7days`, `14days`, `30days`.
+
+`--duration` accepts human-friendly durations: `30m`, `2hours`, `4h`, `1d`, `7days`. The duration is subtracted from the current time to compute the since-timestamp.
+
+`--limit` and `--page` paginate results. The API defaults to 20 results and caps `--limit` at 100.
+
+Use `--json` for machine-readable output suitable for agent automation.
+
 ### `corelayer issues close <issueId> [--feedback "..."]`
 
 Close an issue. Optionally provide feedback (e.g., link to the fix).
@@ -139,7 +162,7 @@ Clear stored credentials.
 ```bash
 corelayer issues summary
 corelayer issues list --severity critical
-corelayer issues get <id> --json
+corelayer issues get <issueId|slug> --json
 ```
 
 ### Scripting and automation