@goliapkg/sentori-cli 0.3.0 → 0.5.0

package/lib/native-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-artifacts.js","sourceRoot":"","sources":["../src/native-artifacts.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goliapkg/sentori-cli",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Sentori CLI \u2014 upload source maps so dashboard stack traces resolve to your original source.",
   "license": "MIT",
   "homepage": "https://sentori.golia.jp",

package/src/__tests__/issue.test.ts

@@ -0,0 +1,95 @@
+import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
+
+import { formatIssueLine, issueList, issuePatch } from '../issue.js'
+
+const cfg = {
+  apiUrl: 'https://api.example.com/',
+  projectId: 'proj-1',
+  token: 'sk_test',
+}
+
+const sample = {
+  errorType: 'TypeError',
+  eventCount: 17,
+  id: 'issue-1',
+  lastSeen: '2026-05-13T00:00:00Z',
+  messageSample: 'undefined is not an object',
+  status: 'active' as const,
+}
+
+const origFetch = globalThis.fetch
+let calls: { body: string | undefined; headers: Headers; method: string; url: string }[]
+beforeEach(() => {
+  calls = []
+})
+afterEach(() => {
+  globalThis.fetch = origFetch
+})
+
+function mockFetch(respBody: string, init: ResponseInit = { status: 200 }): void {
+  globalThis.fetch = (async (url: Request | string | URL, opts?: RequestInit) => {
+    calls.push({
+      body: typeof opts?.body === 'string' ? opts.body : undefined,
+      headers: new Headers(opts?.headers),
+      method: opts?.method ?? 'GET',
+      url: String(url),
+    })
+    return new Response(respBody, {
+      headers: { 'content-type': 'application/json' },
+      ...init,
+    })
+  }) as typeof fetch
+}
+
+describe('issueList', () => {
+  test('GETs /admin/api/projects/<id>/issues with query params + Bearer', async () => {
+    mockFetch(JSON.stringify([sample]))
+    const rows = await issueList({ config: cfg, limit: 20, status: 'active' })
+    expect(calls).toHaveLength(1)
+    expect(calls[0]?.method).toBe('GET')
+    expect(calls[0]?.url).toBe(
+      'https://api.example.com/admin/api/projects/proj-1/issues?status=active&limit=20',
+    )
+    expect(calls[0]?.headers.get('authorization')).toBe('Bearer sk_test')
+    expect(rows).toHaveLength(1)
+    expect(rows[0]?.id).toBe('issue-1')
+  })
+
+  test('omits empty query params', async () => {
+    mockFetch(JSON.stringify([]))
+    await issueList({ config: cfg })
+    expect(calls[0]?.url).toBe('https://api.example.com/admin/api/projects/proj-1/issues')
+  })
+
+  test('throws with server detail on non-2xx', async () => {
+    mockFetch('forbidden', { status: 403, statusText: 'Forbidden' })
+    await expect(issueList({ config: cfg })).rejects.toThrow('403 Forbidden — forbidden')
+  })
+})
+
+describe('issuePatch', () => {
+  test('PATCHes /issues/<id> with the body', async () => {
+    mockFetch(JSON.stringify({ ...sample, status: 'resolved' }))
+    const updated = await issuePatch(cfg, 'issue-1', {
+      resolvedInRelease: 'app@1.2.4+457',
+      status: 'resolved',
+    })
+    expect(calls[0]?.method).toBe('PATCH')
+    expect(calls[0]?.url).toBe('https://api.example.com/admin/api/projects/proj-1/issues/issue-1')
+    expect(JSON.parse(calls[0]?.body ?? '{}')).toEqual({
+      resolvedInRelease: 'app@1.2.4+457',
+      status: 'resolved',
+    })
+    expect(updated.status).toBe('resolved')
+  })
+})
+
+describe('formatIssueLine', () => {
+  test('renders id + status + title + event count on one line', () => {
+    const line = formatIssueLine(sample)
+    expect(line).toContain('issue-1')
+    expect(line).toContain('active')
+    expect(line).toContain('TypeError: undefined is not an object')
+    expect(line).toContain('17×')
+  })
+})

package/src/__tests__/native-artifacts.test.ts

@@ -0,0 +1,132 @@
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+
+import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
+
+import {
+  dsymSlicesFromDwarfdump,
+  dwarfBinariesIn,
+  uploadDsym,
+  uploadMapping,
+} from '../native-artifacts.js'
+
+const ADMIN = {
+  apiUrl: 'https://api.example.com/',
+  projectId: 'proj-1',
+  token: 'sk_test',
+}
+
+let dir = ''
+const origFetch = globalThis.fetch
+let calls: { body: Buffer | null; headers: Headers; method: string; url: string }[]
+beforeEach(async () => {
+  dir = await mkdtemp(join(tmpdir(), 'sentori-cli-native-'))
+  calls = []
+})
+afterEach(async () => {
+  globalThis.fetch = origFetch
+  await rm(dir, { force: true, recursive: true })
+})
+
+function mockFetch(status = 200, respBody = ''): void {
+  globalThis.fetch = (async (url: Request | string | URL, init?: RequestInit) => {
+    const body = init?.body
+    calls.push({
+      body: body instanceof Uint8Array ? Buffer.from(body) : null,
+      headers: new Headers(init?.headers),
+      method: init?.method ?? 'GET',
+      url: String(url),
+    })
+    return new Response(respBody, { status })
+  }) as typeof fetch
+}
+
+describe('uploadMapping', () => {
+  test('POSTs raw bytes to /mappings with Bearer + release query', async () => {
+    mockFetch()
+    const path = join(dir, 'mapping.txt')
+    await writeFile(path, '# pg_map_id: abc\nfoo.bar -> a.b:\n')
+    await uploadMapping({ ...ADMIN, path, release: 'app@1.0.0+1' })
+    expect(calls).toHaveLength(1)
+    expect(calls[0]?.method).toBe('POST')
+    expect(calls[0]?.url).toBe(
+      'https://api.example.com/admin/api/projects/proj-1/mappings?release=app%401.0.0%2B1',
+    )
+    expect(calls[0]?.headers.get('authorization')).toBe('Bearer sk_test')
+    expect(calls[0]?.headers.get('content-type')).toBe('application/octet-stream')
+    expect(calls[0]?.body?.toString()).toContain('pg_map_id')
+  })
+
+  test('sets x-sentori-debug-id when given', async () => {
+    mockFetch()
+    const path = join(dir, 'mapping.txt')
+    await writeFile(path, 'x')
+    await uploadMapping({ ...ADMIN, debugId: '1234-uuid', path })
+    expect(calls[0]?.headers.get('x-sentori-debug-id')).toBe('1234-uuid')
+  })
+
+  test('throws on empty file', async () => {
+    const path = join(dir, 'empty.txt')
+    await writeFile(path, '')
+    await expect(uploadMapping({ ...ADMIN, path })).rejects.toThrow('empty mapping file')
+  })
+
+  test('throws on non-2xx with server detail', async () => {
+    mockFetch(403, 'forbidden')
+    const path = join(dir, 'mapping.txt')
+    await writeFile(path, 'x')
+    await expect(uploadMapping({ ...ADMIN, path })).rejects.toThrow('403')
+  })
+})
+
+describe('uploadDsym (explicit single-slice)', () => {
+  test('POSTs to /dsyms with x-sentori-debug-id, x-sentori-arch, release + objectName', async () => {
+    mockFetch()
+    const path = join(dir, 'Foo.dSYM/Contents/Resources/DWARF/Foo')
+    await mkdir(join(dir, 'Foo.dSYM/Contents/Resources/DWARF'), { recursive: true })
+    await writeFile(path, 'macho-bytes')
+    const r = await uploadDsym({
+      ...ADMIN,
+      arch: 'arm64',
+      debugId: '1234abcd-1234-1234-1234-1234567890ab',
+      objectName: 'Foo',
+      path,
+      release: 'app@1.0.0+1',
+    })
+    expect(calls).toHaveLength(1)
+    expect(calls[0]?.method).toBe('POST')
+    expect(calls[0]?.url).toContain('/admin/api/projects/proj-1/dsyms')
+    expect(calls[0]?.url).toContain('release=app%401.0.0%2B1')
+    expect(calls[0]?.url).toContain('objectName=Foo')
+    expect(calls[0]?.headers.get('x-sentori-debug-id')).toBe('1234ABCD-1234-1234-1234-1234567890AB')
+    expect(calls[0]?.headers.get('x-sentori-arch')).toBe('arm64')
+    expect(r.slices).toEqual([{ arch: 'arm64', debugId: '1234ABCD-1234-1234-1234-1234567890AB' }])
+  })
+})
+
+describe('helpers', () => {
+  test('dwarfBinariesIn walks a .dSYM bundle', async () => {
+    const bundle = join(dir, 'Foo.dSYM')
+    const dwarfDir = join(bundle, 'Contents/Resources/DWARF')
+    await mkdir(dwarfDir, { recursive: true })
+    await writeFile(join(dwarfDir, 'Foo'), 'x')
+    await writeFile(join(dwarfDir, '.DS_Store'), 'noise')
+    const found = dwarfBinariesIn(bundle)
+    expect(found.map((p) => p.replace(bundle + '/', ''))).toEqual([
+      'Contents/Resources/DWARF/Foo',
+    ])
+  })
+
+  test('dwarfBinariesIn on a plain file returns just that file', async () => {
+    const f = join(dir, 'binary')
+    await writeFile(f, 'x')
+    expect(dwarfBinariesIn(f)).toEqual([f])
+  })
+
+  test('dsymSlicesFromDwarfdump returns [] when dwarfdump fails (or is absent)', () => {
+    // pass a path that doesn't exist; dwarfdump exits non-zero (or isn't installed)
+    const slices = dsymSlicesFromDwarfdump(join(dir, 'nope.dSYM'))
+    expect(slices).toEqual([])
+  })
+})

package/src/index.ts

@@ -1,12 +1,14 @@
 #!/usr/bin/env node
 import { parseArgs } from 'node:util'
 
+import { formatIssueLine, issueList, issuePatch } from './issue.js'
+import { uploadDsym, uploadMapping } from './native-artifacts.js'
 import { reactNativeUpload } from './react-native.js'
 import { uploadSourcemaps } from './upload.js'
 
-const HELP = `sentori-cli — upload release artifacts to Sentori
+const HELP = `sentori-cli — Sentori command-line interface
 
-Usage:
+Source-map upload:
   sentori-cli upload sourcemap [options] <path...>
       Upload one or more files or directories. A directory is scanned
       (one level) for *.map / *.js / *.jsbundle / *.bundle / *.hbc;
@@ -18,14 +20,30 @@ Usage:
       and upload it (plus the bundle). Use this for a Hermes release
       build. Requires --metro-map and --hermes-map.
 
-Options (both commands):
+Native artifacts (project-scoped, need --project + admin token):
+  sentori-cli upload dsym --project <uuid> [--release <r>] [--object-name <n>] [--debug-id <uuid> --arch <a>] <path>
+      Upload iOS dSYM debug info. By default walks a Foo.dSYM bundle
+      and uses "dwarfdump --uuid" to enumerate slices, uploading each.
+      Pass --debug-id and --arch to upload a single slice without
+      dwarfdump (useful in Linux CI where the toolchain isn't there).
+
+  sentori-cli upload mapping --project <uuid> [--release <r>] [--debug-id <uuid>] <mapping.txt>
+      Upload an R8 / ProGuard mapping (raw bytes). If the file starts
+      with a "# pg_map_id:" line the server sniffs the debug-id from
+      it; otherwise you can pass it explicitly.
+
+CI triage:
+  sentori-cli issue list --project <uuid> [--status active|silenced|resolved|closed] [--limit N] [--error-type <t>]
+  sentori-cli issue resolve <issue-uuid> --project <uuid> [--in-release <r>]
+  sentori-cli issue silence <issue-uuid> --project <uuid>
+
+Options (upload commands):
   --release <r>     release identifier — MUST equal the value the SDK
-                    reports via init({ release }). Required. A mismatch
-                    means the dashboard silently can't symbolicate.
+                    reports via init({ release }). Required.
   --token <t>       Sentori token (or set $SENTORI_TOKEN).
   --api-url <url>   Sentori API base (default https://api.sentori.golia.jp,
-                    or $SENTORI_API_URL). For a self-hosted instance,
-                    your host. (Accepts --ingest-url as an alias.)
+                    or $SENTORI_API_URL). For a self-hosted instance, your
+                    host. (Accepts --ingest-url as an alias.)
   --dry-run         describe what would be uploaded; don't upload.
   -h, --help        show this help.
 
@@ -34,6 +52,16 @@ Options (react-native upload):
   --hermes-map <p>  the *.hbc.map the Hermes compiler emits.
   --bundle <p>      optional: also upload the bundle (.jsbundle / .bundle).
 
+Options (issue commands):
+  --project <uuid>  project id (or set $SENTORI_PROJECT_ID).
+  --token <t>       admin token, sk_… prefix (or $SENTORI_ADMIN_TOKEN /
+                    $SENTORI_TOKEN). The ingest st_pk_ token may also work
+                    on a self-hosted instance.
+  --api-url <url>   Sentori API base (same as above).
+  --in-release <r>  (resolve only) mark this release as where the fix
+                    landed; the regression detector flips the issue back
+                    to "regressed" if a matching event lands later.
+
 Hermes release build, by hand:
   npx react-native bundle --platform ios --dev false --entry-file index.js \\
     --bundle-output main.jsbundle --sourcemap-output main.jsbundle.packager.map
@@ -182,6 +210,246 @@ function reportUpload(
   }
 }
 
+// ── issue commands ────────────────────────────────────────────────
+
+type AdminCfg = { apiUrl: string; projectId: string; token: string }
+
+function parseAdminCfg(values: Record<string, unknown>): AdminCfg | null {
+  const projectId =
+    (typeof values.project === 'string' ? values.project : undefined) ??
+    process.env.SENTORI_PROJECT_ID
+  if (!projectId) {
+    console.error('error: --project <uuid> (or $SENTORI_PROJECT_ID) is required')
+    return null
+  }
+  const token =
+    (typeof values.token === 'string' ? values.token : undefined) ??
+    process.env.SENTORI_ADMIN_TOKEN ??
+    process.env.SENTORI_TOKEN
+  if (!token) {
+    console.error(
+      'error: --token (or $SENTORI_ADMIN_TOKEN / $SENTORI_TOKEN) is required for issue commands',
+    )
+    return null
+  }
+  const apiUrl =
+    (typeof values['api-url'] === 'string' ? values['api-url'] : undefined) ??
+    (typeof values['ingest-url'] === 'string' ? values['ingest-url'] : undefined) ??
+    process.env.SENTORI_API_URL ??
+    'https://api.sentori.golia.jp'
+  return { apiUrl, projectId, token }
+}
+
+async function cmdIssueList(argv: string[]): Promise<number> {
+  let parsed
+  try {
+    parsed = parseArgs({
+      args: argv,
+      options: {
+        'api-url': { type: 'string' },
+        'error-type': { type: 'string' },
+        help: { short: 'h', type: 'boolean' },
+        'ingest-url': { type: 'string' },
+        limit: { type: 'string' },
+        project: { type: 'string' },
+        status: { type: 'string' },
+        token: { type: 'string' },
+      },
+    })
+  } catch (e) {
+    console.error(`error: ${(e as Error).message}\n${HELP}`)
+    return 2
+  }
+  if (parsed.values.help) {
+    console.log(HELP)
+    return 0
+  }
+  const cfg = parseAdminCfg(parsed.values)
+  if (!cfg) return 2
+  const status = parsed.values.status
+  if (status && !['active', 'closed', 'resolved', 'silenced'].includes(status)) {
+    console.error(`error: --status must be one of: active, silenced, resolved, closed`)
+    return 2
+  }
+  const limitStr = parsed.values.limit
+  const limit = limitStr ? Number.parseInt(limitStr, 10) : undefined
+  try {
+    const rows = await issueList({
+      config: cfg,
+      errorType: parsed.values['error-type'],
+      limit,
+      status: status as 'active' | 'closed' | 'resolved' | 'silenced' | undefined,
+    })
+    if (rows.length === 0) {
+      console.log('(no matching issues)')
+      return 0
+    }
+    for (const r of rows) console.log(formatIssueLine(r))
+    return 0
+  } catch (e) {
+    console.error(`issue list failed: ${(e as Error).message}`)
+    return 1
+  }
+}
+
+async function cmdIssuePatch(
+  argv: string[],
+  body: { resolvedInRelease?: string; status: 'active' | 'closed' | 'resolved' | 'silenced' },
+  verb: 'closed' | 'resolved' | 'silenced',
+): Promise<number> {
+  let parsed
+  try {
+    parsed = parseArgs({
+      allowPositionals: true,
+      args: argv,
+      options: {
+        'api-url': { type: 'string' },
+        help: { short: 'h', type: 'boolean' },
+        'in-release': { type: 'string' },
+        'ingest-url': { type: 'string' },
+        project: { type: 'string' },
+        token: { type: 'string' },
+      },
+    })
+  } catch (e) {
+    console.error(`error: ${(e as Error).message}\n${HELP}`)
+    return 2
+  }
+  if (parsed.values.help) {
+    console.log(HELP)
+    return 0
+  }
+  const cfg = parseAdminCfg(parsed.values)
+  if (!cfg) return 2
+  const issueId = parsed.positionals[0]
+  if (!issueId) {
+    console.error('error: <issue-uuid> is required')
+    return 2
+  }
+  if (verb === 'resolved' && typeof parsed.values['in-release'] === 'string') {
+    body.resolvedInRelease = parsed.values['in-release']
+  }
+  try {
+    const updated = await issuePatch(cfg, issueId, body)
+    console.log(
+      `${issueId} → ${verb}${body.resolvedInRelease ? ` (in ${body.resolvedInRelease})` : ''}: ${updated.errorType}`,
+    )
+    return 0
+  } catch (e) {
+    console.error(`issue ${verb} failed: ${(e as Error).message}`)
+    return 1
+  }
+}
+
+// ── native artifact upload ────────────────────────────────────────
+
+async function cmdUploadDsym(argv: string[]): Promise<number> {
+  let parsed
+  try {
+    parsed = parseArgs({
+      allowPositionals: true,
+      args: argv,
+      options: {
+        'api-url': { type: 'string' },
+        arch: { type: 'string' },
+        'debug-id': { type: 'string' },
+        help: { short: 'h', type: 'boolean' },
+        'ingest-url': { type: 'string' },
+        'object-name': { type: 'string' },
+        project: { type: 'string' },
+        release: { type: 'string' },
+        token: { type: 'string' },
+      },
+    })
+  } catch (e) {
+    console.error(`error: ${(e as Error).message}\n${HELP}`)
+    return 2
+  }
+  if (parsed.values.help) {
+    console.log(HELP)
+    return 0
+  }
+  const cfg = parseAdminCfg(parsed.values)
+  if (!cfg) return 2
+  const path = parsed.positionals[0]
+  if (!path) {
+    console.error('error: a path to a .dSYM bundle or DWARF binary is required')
+    return 2
+  }
+  const debugId = parsed.values['debug-id']
+  const arch = parsed.values.arch
+  if ((debugId && !arch) || (arch && !debugId)) {
+    console.error('error: --debug-id and --arch must be passed together (or both omitted)')
+    return 2
+  }
+  try {
+    const r = await uploadDsym({
+      apiUrl: cfg.apiUrl,
+      arch: typeof arch === 'string' ? arch : undefined,
+      debugId: typeof debugId === 'string' ? debugId : undefined,
+      objectName: typeof parsed.values['object-name'] === 'string' ? parsed.values['object-name'] : undefined,
+      path,
+      projectId: cfg.projectId,
+      release: typeof parsed.values.release === 'string' ? parsed.values.release : undefined,
+      token: cfg.token,
+    })
+    console.log(`uploaded ${r.slices.length} dSYM slice(s):`)
+    for (const s of r.slices) console.log(`  ${s.debugId}  (${s.arch})`)
+    return 0
+  } catch (e) {
+    console.error(`dsym upload failed: ${(e as Error).message}`)
+    return 1
+  }
+}
+
+async function cmdUploadMapping(argv: string[]): Promise<number> {
+  let parsed
+  try {
+    parsed = parseArgs({
+      allowPositionals: true,
+      args: argv,
+      options: {
+        'api-url': { type: 'string' },
+        'debug-id': { type: 'string' },
+        help: { short: 'h', type: 'boolean' },
+        'ingest-url': { type: 'string' },
+        project: { type: 'string' },
+        release: { type: 'string' },
+        token: { type: 'string' },
+      },
+    })
+  } catch (e) {
+    console.error(`error: ${(e as Error).message}\n${HELP}`)
+    return 2
+  }
+  if (parsed.values.help) {
+    console.log(HELP)
+    return 0
+  }
+  const cfg = parseAdminCfg(parsed.values)
+  if (!cfg) return 2
+  const path = parsed.positionals[0]
+  if (!path) {
+    console.error('error: a path to mapping.txt is required')
+    return 2
+  }
+  try {
+    await uploadMapping({
+      apiUrl: cfg.apiUrl,
+      debugId: typeof parsed.values['debug-id'] === 'string' ? parsed.values['debug-id'] : undefined,
+      path,
+      projectId: cfg.projectId,
+      release: typeof parsed.values.release === 'string' ? parsed.values.release : undefined,
+      token: cfg.token,
+    })
+    console.log(`uploaded mapping for project ${cfg.projectId}${parsed.values.release ? ` / ${parsed.values.release}` : ''}`)
+    return 0
+  } catch (e) {
+    console.error(`mapping upload failed: ${(e as Error).message}`)
+    return 1
+  }
+}
+
 async function main(argv: string[]): Promise<number> {
   if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
     console.log(HELP)
@@ -189,7 +457,13 @@ async function main(argv: string[]): Promise<number> {
   }
   const [a, b, ...rest] = argv
   if (a === 'upload' && b === 'sourcemap') return cmdUploadSourcemap(rest)
+  if (a === 'upload' && b === 'dsym') return cmdUploadDsym(rest)
+  if (a === 'upload' && b === 'mapping') return cmdUploadMapping(rest)
   if (a === 'react-native' && b === 'upload') return cmdReactNativeUpload(rest)
+  if (a === 'issue' && b === 'list') return cmdIssueList(rest)
+  if (a === 'issue' && b === 'resolve') return cmdIssuePatch(rest, { status: 'resolved' }, 'resolved')
+  if (a === 'issue' && b === 'silence') return cmdIssuePatch(rest, { status: 'silenced' }, 'silenced')
+  if (a === 'issue' && b === 'close') return cmdIssuePatch(rest, { status: 'closed' }, 'closed')
   console.error(`unknown command: ${[a, b].filter(Boolean).join(' ') || '(none)'}\n`)
   console.error(HELP)
   return 2

package/src/issue.ts

@@ -0,0 +1,81 @@
+// `sentori-cli issue list / resolve / silence` — CI triage helpers.
+
+type Issue = {
+  errorType: string
+  eventCount: number
+  id: string
+  lastSeen: string
+  messageSample: string
+  status: 'active' | 'closed' | 'resolved' | 'silenced'
+}
+
+type AdminConfig = {
+  apiUrl: string
+  projectId: string
+  token: string
+}
+
+function url(c: AdminConfig, path: string): string {
+  return `${c.apiUrl.replace(/\/+$/, '')}/admin/api/projects/${c.projectId}${path}`
+}
+
+async function adminFetch<T>(c: AdminConfig, path: string, init?: RequestInit): Promise<T> {
+  const resp = await fetch(url(c, path), {
+    ...init,
+    headers: {
+      Authorization: `Bearer ${c.token}`,
+      'Content-Type': 'application/json',
+      ...(init?.headers ?? {}),
+    },
+  })
+  if (!resp.ok) {
+    let detail = ''
+    try {
+      detail = await resp.text()
+    } catch {
+      // ignore
+    }
+    throw new Error(
+      `${resp.status} ${resp.statusText}${detail ? ` — ${detail.slice(0, 300)}` : ''}`,
+    )
+  }
+  // PATCH /issues/<id> returns the row; some endpoints might return no
+  // content — handle both.
+  const txt = await resp.text()
+  return (txt ? JSON.parse(txt) : null) as T
+}
+
+export type IssueListOptions = {
+  config: AdminConfig
+  errorType?: string
+  limit?: number
+  status?: 'active' | 'closed' | 'resolved' | 'silenced'
+}
+
+export async function issueList(opts: IssueListOptions): Promise<Issue[]> {
+  const q = new URLSearchParams()
+  if (opts.status) q.set('status', opts.status)
+  if (opts.limit) q.set('limit', String(opts.limit))
+  if (opts.errorType) q.set('errorType', opts.errorType)
+  const qs = q.toString()
+  return adminFetch<Issue[]>(opts.config, `/issues${qs ? '?' + qs : ''}`)
+}
+
+export async function issuePatch(
+  config: AdminConfig,
+  issueId: string,
+  body: { resolvedInRelease?: string; status: 'active' | 'closed' | 'resolved' | 'silenced' },
+): Promise<Issue> {
+  return adminFetch<Issue>(config, `/issues/${encodeURIComponent(issueId)}`, {
+    body: JSON.stringify(body),
+    method: 'PATCH',
+  })
+}
+
+/** Format one issue for terminal output — short, one line, scannable. */
+export function formatIssueLine(i: Issue): string {
+  const status = i.status.padEnd(9)
+  const title = `${i.errorType}${i.messageSample ? `: ${i.messageSample}` : ''}`
+  const events = `${i.eventCount}×`
+  return `${i.id}  ${status}  ${title.slice(0, 80).padEnd(80)}  ${events}`
+}