@goliapkg/sentori-cli 0.6.0 → 1.1.0

package/lib/react-native.js

@@ -3,7 +3,8 @@ import { existsSync, mkdtempSync, rmSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { uploadSourcemaps } from './upload.js';
+import { uploadArtifact } from './upload.js';
+import { basename } from 'node:path';
 /** Resolve `react-native/scripts/compose-source-maps.js` from the
  *  current project's node_modules. Returns null if react-native isn't
  *  installed or the version doesn't ship that script. */
@@ -52,14 +53,21 @@ export async function reactNativeUpload(opts) {
     const composed = composeSourceMaps(opts.metroMap, opts.hermesMap);
     try {
         const paths = [composed, ...(opts.bundle ? [opts.bundle] : [])];
-        const r = await uploadSourcemaps({
-            apiUrl: opts.apiUrl,
-            dryRun: opts.dryRun,
-            paths,
-            release: opts.release,
-            token: opts.token,
-        });
-        return { files: r.files, uploaded: r.uploaded };
+        if (opts.dryRun)
+            return { files: paths };
+        let uploaded = 0;
+        for (const p of paths) {
+            await uploadArtifact({
+                apiUrl: opts.apiUrl,
+                token: opts.token,
+                release: opts.release,
+                kind: 'sourcemap',
+                path: p,
+                name: basename(p),
+            });
+            uploaded += 1;
+        }
+        return { files: paths, uploaded };
     }
     finally {
         try {

package/lib/react-native.js.map

@@ -1 +1 @@
-{"version":3,"file":"react-native.js","sourceRoot":"","sources":["../src/react-native.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"react-native.js","sourceRoot":"","sources":["../src/react-native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC;;yDAEyD;AACzD,MAAM,UAAU,oBAAoB,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;IAC1D,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;IACnD,KAAK,MAAM,EAAE,IAAI;QACf,6CAA6C;QAC7C,oEAAoE;KACrE,EAAE,CAAC;QACF,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;YACzB,IAAI,UAAU,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAA;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,WAAW;QACb,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;uEAEuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,SAAiB;IACnE,KAAK,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAA;IAC3D,CAAC;IACD,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAA;IACrC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,iFAAiF;YAC/E,iFAAiF,CACpF,CAAA;IACH,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAC5E,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;IAC3F,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC,CAAA;IAC/E,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAClF,OAAO,GAAG,CAAA;AACZ,CAAC;AAaD;0DAC0D;AAC1D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAqB;IAI3D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;IACjE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC/D,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;QACxC,IAAI,QAAQ,GAAG,CAAC,CAAA;QAChB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,cAAc,CAAC;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,CAAC;gBACP,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;aAClB,CAAC,CAAA;YACF,QAAQ,IAAI,CAAC,CAAA;QACf,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;IACnC,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YACjC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;AACH,CAAC"}

package/lib/upload.d.ts

@@ -1,24 +1,25 @@
-export type UploadOptions = {
-    release: string;
-    token: string;
-    /** Sentori API base, e.g. https://sentori.golia.jp or your host. */
+export type UploadOpts = {
     apiUrl: string;
-    /** Files or directories. Directories are scanned one level deep. */
-    paths: string[];
-    dryRun?: boolean;
+    token: string;
+    release: string;
+    kind: 'dsym' | 'proguard' | 'sourcemap';
+    path: string;
+    /** Override the stored artifact name (defaults to the filename). */
+    name?: string;
 };
-export type UploadResult = {
-    files: string[];
-    uploaded?: number;
-    artifacts?: {
-        kind: string;
-        name: string;
-    }[];
+/** Gzip a payload for the wire (pass-through if it already is gzip),
+ *  renaming `foo` → `foo.gz` to match. Shared by every artifact
+ *  upload path so dSYM/mapping and sourcemap cannot drift. */
+export declare function gzipForWire(bytes: Buffer | Uint8Array, name: string): {
+    wire: Uint8Array;
+    wireName: string;
 };
-/** Resolve `paths` (files or dirs) to a deduped list of files to upload.
- *  A directory contributes its top-level `.map` / `.js` / `.bundle` /
- *  `.hbc` files; a file given explicitly is taken as-is (even if its
- *  extension isn't in the list — the caller asked for it). */
-export declare function collectFiles(paths: string[]): Promise<string[]>;
-export declare function uploadSourcemaps(opts: UploadOptions): Promise<UploadResult>;
+/** Exact-range copy into a standalone ArrayBuffer. `wire.buffer` is
+ *  NOT safe here: Node pools small Buffers, so the backing buffer can
+ *  be 16 KB of pool (offset view) — a Blob built on it would ship
+ *  garbage bytes around the payload. */
+export declare function wireArrayBuffer(wire: Uint8Array): ArrayBuffer;
+export declare function uploadArtifact(opts: UploadOpts): Promise<{
+    id: string;
+}>;
 //# sourceMappingURL=upload.d.ts.map

package/lib/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC7C,CAAA;AAED;;;8DAG8D;AAC9D,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBrE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAiCjF"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAA;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAMD;;8DAE8D;AAC9D,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,UAAU,EAC1B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAWxC;AAED;;;wCAGwC;AACxC,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAE7D;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAoC9E"}

package/lib/upload.js

@@ -1,65 +1,73 @@
-import { readFile, readdir, stat } from 'node:fs/promises';
-import { basename, join } from 'node:path';
-// Files worth uploading: source maps, and the bundle they map (so the
-// dashboard can show the minified line too if a frame falls outside
-// the map). `.jsbundle` (iOS) and `.bundle` (Android) are RN's bundle
-// names; `.hbc` is the Hermes bytecode bundle.
-const UPLOADABLE = /\.(map|js|jsbundle|bundle|hbc)$/i;
-/** Resolve `paths` (files or dirs) to a deduped list of files to upload.
- *  A directory contributes its top-level `.map` / `.js` / `.bundle` /
- *  `.hbc` files; a file given explicitly is taken as-is (even if its
- *  extension isn't in the list — the caller asked for it). */
-export async function collectFiles(paths) {
-    const out = [];
-    for (const p of paths) {
-        const s = await stat(p).catch(() => null);
-        if (!s)
-            throw new Error(`no such file or directory: ${p}`);
-        if (s.isDirectory()) {
-            for (const entry of await readdir(p)) {
-                const full = join(p, entry);
-                const es = await stat(full).catch(() => null);
-                if (es?.isFile() && UPLOADABLE.test(entry))
-                    out.push(full);
-            }
-        }
-        else {
-            out.push(p);
-        }
+// Unified symbolication-artifact upload: sourcemap / dsym / proguard
+// all land on `POST /v1/releases/{release}/artifacts` (multipart
+// `kind` + `file`), authenticated with an api-scope token. A late
+// upload triggers retro-symbolication server-side, which is what
+// makes the lenient exit-0 contract honest — nothing is lost
+// forever.
+//
+// Uploads are gzipped on the wire (server ≥ 2.1.0 inflates
+// transparently). Symbolication artifacts compress well — a plain
+// R8 mapping ~10:1, DWARF ~3:1 — and the server's transport cap is
+// smaller than its decompressed cap precisely so that the big ones
+// (a real RN app's main dSYM runs hundreds of MB) fit as gzip.
+import { readFileSync } from 'node:fs';
+import { basename } from 'node:path';
+import { gzipSync } from 'node:zlib';
+/** Transport-side limit on the current server (256 MB). Used only to
+ *  produce a useful error message — the server is the authority. */
+const WIRE_LIMIT = 256 * 1024 * 1024;
+/** Gzip a payload for the wire (pass-through if it already is gzip),
+ *  renaming `foo` → `foo.gz` to match. Shared by every artifact
+ *  upload path so dSYM/mapping and sourcemap cannot drift. */
+export function gzipForWire(bytes, name) {
+    const alreadyGz = bytes.length >= 2 && bytes[0] === 0x1f && bytes[1] === 0x8b;
+    const wire = alreadyGz ? new Uint8Array(bytes) : new Uint8Array(gzipSync(bytes));
+    const wireName = alreadyGz || name.endsWith('.gz') ? name : `${name}.gz`;
+    if (wire.length > WIRE_LIMIT) {
+        throw new Error(`${name} is ${Math.round(wire.length / 1024 / 1024)} MB gzipped — ` +
+            `over the server's ${WIRE_LIMIT / 1024 / 1024} MB transport limit even compressed`);
     }
-    const deduped = [...new Set(out)];
-    if (deduped.length === 0) {
-        throw new Error('no .map / .js / .bundle files found in the given path(s)');
-    }
-    return deduped;
+    return { wire, wireName };
+}
+/** Exact-range copy into a standalone ArrayBuffer. `wire.buffer` is
+ *  NOT safe here: Node pools small Buffers, so the backing buffer can
+ *  be 16 KB of pool (offset view) — a Blob built on it would ship
+ *  garbage bytes around the payload. */
+export function wireArrayBuffer(wire) {
+    return wire.buffer.slice(wire.byteOffset, wire.byteOffset + wire.byteLength);
 }
-export async function uploadSourcemaps(opts) {
-    const files = await collectFiles(opts.paths);
-    if (opts.dryRun)
-        return { files };
+export async function uploadArtifact(opts) {
+    const bytes = readFileSync(opts.path);
+    if (bytes.length === 0)
+        throw new Error(`empty file: ${opts.path}`);
+    // Already-compressed input (foo.map.gz) is passed through; the
+    // server strips the .gz suffix from the stored name after inflating.
+    const { wire, wireName } = gzipForWire(bytes, opts.name ?? basename(opts.path));
     const form = new FormData();
-    for (const f of files) {
-        const buf = await readFile(f);
-        form.append('file', new Blob([buf]), basename(f));
+    form.append('kind', opts.kind);
+    form.append('file', new Blob([wireArrayBuffer(wire)]), wireName);
+    const url = `${opts.apiUrl.replace(/\/+$/, '')}/v1/releases/${encodeURIComponent(opts.release)}/artifacts`;
+    let resp;
+    try {
+        resp = await fetch(url, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${opts.token}` },
+            body: form,
+        });
+    }
+    catch (e) {
+        // A proxy that hits its body-size cap tends to reset the
+        // connection instead of answering, which surfaces here as a bare
+        // network error. Say so — "fetch failed" cost one team a round of
+        // debugging before they found the 413 underneath.
+        throw new Error(`network error (${e instanceof Error ? e.message : String(e)}) — ` +
+            `if the file is large this can be a proxy body-size cap rejecting ` +
+            `the upload (${Math.round(wire.length / 1024 / 1024)} MB on the wire)`);
     }
-    const base = opts.apiUrl.replace(/\/+$/, '');
-    const url = `${base}/admin/api/releases/${encodeURIComponent(opts.release)}/sourcemaps`;
-    const resp = await fetch(url, {
-        body: form,
-        headers: { Authorization: `Bearer ${opts.token}` },
-        method: 'POST',
-    });
     if (!resp.ok) {
-        let detail = '';
-        try {
-            detail = await resp.text();
-        }
-        catch {
-            // ignore
-        }
-        throw new Error(`${resp.status} ${resp.statusText}${detail ? ` — ${detail.slice(0, 300)}` : ''}`);
+        const detail = await resp.text().catch(() => '');
+        throw new Error(`${resp.status} ${resp.statusText}${detail ? ` — ${detail.slice(0, 200)}` : ''}`);
     }
-    const body = (await resp.json().catch(() => ({})));
-    return { artifacts: body.artifacts, files, uploaded: body.uploaded ?? files.length };
+    return (await resp.json());
 }
 //# sourceMappingURL=upload.js.map

package/lib/upload.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goliapkg/sentori-cli",
-  "version": "0.6.0",
+  "version": "1.1.0",
   "description": "Sentori CLI — upload source maps so dashboard stack traces resolve to your original source.",
   "license": "Apache-2.0 OR MIT",
   "author": "GOLIA K.K. <takagi@golia.jp> (https://golia.jp)",
@@ -42,7 +42,7 @@
   "devDependencies": {
     "@types/bun": "latest",
     "@types/node": "*",
-    "typescript": "^6"
+    "typescript": "^7"
   },
   "publishConfig": {
     "access": "public"

package/src/__tests__/lenient.test.ts

@@ -0,0 +1,32 @@
+// Build-time iron rule: upload failure exits 0 with a friendly,
+// actionable note; --strict opts into a real non-zero.
+
+import { describe, expect, test } from 'bun:test'
+
+import { isStrict, lenientFail, stripStrict } from '../lenient.js'
+
+describe('lenient upload contract', () => {
+  test('default: failure exits 0', () => {
+    const code = lenientFail(false, {
+      failure: 'network down',
+      impact: 'stacks stay minified',
+      retry: 'sentori-cli upload sourcemap ...',
+    })
+    expect(code).toBe(0)
+  })
+
+  test('--strict: failure exits 1', () => {
+    const code = lenientFail(true, {
+      failure: 'network down',
+      impact: 'stacks stay minified',
+      retry: 'retry-cmd',
+    })
+    expect(code).toBe(1)
+  })
+
+  test('strict flag parses and strips', () => {
+    expect(isStrict(['--release', 'r', '--strict'])).toBe(true)
+    expect(isStrict(['--release', 'r'])).toBe(false)
+    expect(stripStrict(['--strict', 'a'])).toEqual(['a'])
+  })
+})

package/src/__tests__/mcp.test.ts

@@ -1,124 +1,32 @@
-import { afterEach, beforeEach, describe, expect, test } from 'bun:test'
+// The MCP tool surface mirrors the /api closed loop 1:1.
 
-import { buildTools } from '../mcp.js'
-
-const ADMIN = {
-  apiUrl: 'https://api.example.com/',
-  projectId: 'proj-uuid',
-  token: 'sk_test',
-}
-
-const origFetch = globalThis.fetch
-let calls: { body: string | null; headers: Headers; method: string; url: string }[]
+import { describe, expect, test } from 'bun:test'
 
-beforeEach(() => {
-  calls = []
-})
-afterEach(() => {
-  globalThis.fetch = origFetch
-})
+import { buildTools } from '../mcp.js'
 
-function mockFetch(status = 200, body: unknown = {}): void {
-  globalThis.fetch = (async (url: Request | string | URL, init?: RequestInit) => {
-    const b = init?.body
-    calls.push({
-      body: typeof b === 'string' ? b : null,
-      headers: new Headers(init?.headers),
-      method: init?.method ?? 'GET',
-      url: String(url),
-    })
-    return new Response(status === 204 ? '' : JSON.stringify(body), { status })
-  }) as typeof fetch
-}
+describe('mcp tools', () => {
+  const tools = buildTools()
 
-describe('buildTools', () => {
-  test('returns the expected set of tools with required input schema fields', () => {
-    const tools = buildTools()
-    const names = new Set(tools.map((t) => t.name))
-    for (const expected of [
+  test('exactly the four closed-loop tools exist', () => {
+    expect(tools.map((t) => t.name).sort()).toEqual([
+      'sentori_issue_bundle',
       'sentori_issue_list',
-      'sentori_issue_get',
-      'sentori_issue_comment',
-      'sentori_issue_transition',
-      'sentori_issue_assign',
-      'sentori_issue_set_priority',
-      'sentori_issue_set_labels',
-      'sentori_issue_watch',
-    ]) {
-      expect(names.has(expected)).toBe(true)
-    }
+      'sentori_issue_note',
+      'sentori_issue_resolve',
+    ])
+  })
+
+  test('every tool has a description and an object schema', () => {
     for (const t of tools) {
-      // Every tool advertises a description + an input schema.
-      expect(typeof t.description).toBe('string')
-      expect(t.inputSchema).toBeDefined()
+      expect(t.description.length).toBeGreaterThan(20)
       expect((t.inputSchema as { type?: string }).type).toBe('object')
     }
   })
-})
 
-describe('tool handlers proxy to admin API', () => {
-  test('sentori_issue_list calls GET .../issues with filters', async () => {
-    const tools = buildTools()
-    const list = tools.find((t) => t.name === 'sentori_issue_list')!
-    mockFetch(200, [])
-    await list.handler(
-      { limit: 25, priority: 'p0', projectId: 'proj-uuid', status: 'active' },
-      ADMIN,
-    )
-    expect(calls.length).toBe(1)
-    expect(calls[0]!.url).toContain('/admin/api/projects/proj-uuid/issues?')
-    expect(calls[0]!.url).toContain('status=active')
-    expect(calls[0]!.url).toContain('priority=p0')
-    expect(calls[0]!.url).toContain('limit=25')
-    expect(calls[0]!.method).toBe('GET')
-    expect(calls[0]!.headers.get('authorization')).toBe('Bearer sk_test')
-  })
-
-  test('sentori_issue_get fetches issue + activity in parallel', async () => {
-    const tools = buildTools()
-    const get = tools.find((t) => t.name === 'sentori_issue_get')!
-    mockFetch(200, { stub: true })
-    await get.handler({ issueId: 'iss-uuid', projectId: 'proj-uuid' }, ADMIN)
-    expect(calls.length).toBe(2)
-    const paths = calls.map((c) => c.url).sort()
-    expect(paths[0]).toContain('/admin/api/projects/proj-uuid/issues/iss-uuid')
-    expect(paths[1]).toContain('/admin/api/projects/proj-uuid/issues/iss-uuid/activity')
-  })
-
-  test('sentori_issue_transition PATCHes status', async () => {
-    const tools = buildTools()
-    const t = tools.find((x) => x.name === 'sentori_issue_transition')!
-    mockFetch(200, { id: 'x' })
-    await t.handler({ issueId: 'iss', projectId: 'proj', status: 'resolved' }, ADMIN)
-    expect(calls[0]!.method).toBe('PATCH')
-    expect(JSON.parse(calls[0]!.body!).status).toBe('resolved')
-  })
-
-  test('sentori_issue_set_labels rejects non-string array entries', async () => {
-    const tools = buildTools()
-    const t = tools.find((x) => x.name === 'sentori_issue_set_labels')!
-    await expect(
-      t.handler({ issueId: 'iss', labels: ['ok', 42], projectId: 'proj' }, ADMIN),
-    ).rejects.toThrow(/each label/)
-  })
-
-  test('sentori_issue_watch=true → PUT, watch=false → DELETE', async () => {
-    const tools = buildTools()
-    const t = tools.find((x) => x.name === 'sentori_issue_watch')!
-    mockFetch(204)
-    await t.handler({ issueId: 'iss', projectId: 'proj', watch: true }, ADMIN)
-    expect(calls[0]!.method).toBe('PUT')
-    calls.length = 0
-    await t.handler({ issueId: 'iss', projectId: 'proj', watch: false }, ADMIN)
-    expect(calls[0]!.method).toBe('DELETE')
-  })
-
-  test('handler surfaces a non-2xx as an Error', async () => {
-    const tools = buildTools()
-    const t = tools.find((x) => x.name === 'sentori_issue_comment')!
-    mockFetch(500, { error: 'boom' })
-    await expect(
-      t.handler({ body: 'hello', issueId: 'iss', projectId: 'proj' }, ADMIN),
-    ).rejects.toThrow(/500/)
+  test('bundle/note/resolve require issueId', () => {
+    for (const name of ['sentori_issue_bundle', 'sentori_issue_note', 'sentori_issue_resolve']) {
+      const t = tools.find((x) => x.name === name)!
+      expect((t.inputSchema as { required?: string[] }).required).toContain('issueId')
+    }
   })
 })

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

@@ -13,8 +13,7 @@ import {
 
 const ADMIN = {
   apiUrl: 'https://api.example.com/',
-  projectId: 'proj-1',
-  token: 'sk_test',
+    token: 'sk_test',
 }
 
 let dir = ''
@@ -51,19 +50,17 @@ describe('uploadMapping', () => {
     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',
+      'https://api.example.com/v1/releases/app%401.0.0%2B1/artifacts',
     )
     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')
+    await uploadMapping({ ...ADMIN, debugId: '1234-uuid', path, release: 'r' })
+    expect(calls[0]?.url).toContain('/v1/releases/r/artifacts')
   })
 
   test('throws on empty file', async () => {
@@ -96,11 +93,7 @@ describe('uploadDsym (explicit single-slice)', () => {
     })
     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(calls[0]?.url).toContain('/v1/releases/app%401.0.0%2B1/artifacts')
     expect(r.slices).toEqual([{ arch: 'arm64', debugId: '1234ABCD-1234-1234-1234-1234567890AB' }])
   })
 })
@@ -130,3 +123,41 @@ describe('helpers', () => {
     expect(slices).toEqual([])
   })
 })
+
+describe('gzip on the wire', () => {
+  test('mapping upload body is gzip and filename gains .gz', async () => {
+    const captured: { name: string; bytes: Uint8Array }[] = []
+    globalThis.fetch = (async (_url: Request | string | URL, init?: RequestInit) => {
+      const form = init?.body as FormData
+      const file = form.get('file') as File
+      captured.push({
+        bytes: new Uint8Array(await file.arrayBuffer()),
+        name: file.name,
+      })
+      return new Response('{}', { status: 201 })
+    }) as typeof fetch
+    const path = join(dir, 'mapping.txt')
+    await writeFile(path, 'foo.bar -> a.b:\n'.repeat(1000))
+    await uploadMapping({ ...ADMIN, path, release: 'r' })
+    expect(captured).toHaveLength(1)
+    expect(captured[0]?.name).toEndWith('.gz')
+    expect(captured[0]?.bytes[0]).toBe(0x1f)
+    expect(captured[0]?.bytes[1]).toBe(0x8b)
+  })
+
+  test('already-gzipped input passes through un-recompressed', async () => {
+    const { gzipSync } = await import('node:zlib')
+    const pre = gzipSync('already compressed')
+    const captured: Uint8Array[] = []
+    globalThis.fetch = (async (_url: Request | string | URL, init?: RequestInit) => {
+      const form = init?.body as FormData
+      const file = form.get('file') as File
+      captured.push(new Uint8Array(await file.arrayBuffer()))
+      return new Response('{}', { status: 201 })
+    }) as typeof fetch
+    const path = join(dir, 'mapping.txt.gz')
+    await writeFile(path, pre)
+    await uploadMapping({ ...ADMIN, path, release: 'r' })
+    expect(Buffer.from(captured[0] ?? [])).toEqual(pre)
+  })
+})

package/src/__tests__/probes.test.ts

@@ -0,0 +1,41 @@
+// The probe scanner: finds sentori.probe('REF') call sites, skips
+// junk dirs, dedupes.
+
+import { mkdtemp, mkdir, 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 { scanProbes } from '../probes.js'
+
+let dir = ''
+beforeEach(async () => {
+  dir = await mkdtemp(join(tmpdir(), 'sentori-probes-'))
+})
+afterEach(async () => {
+  await rm(dir, { force: true, recursive: true })
+})
+
+describe('scanProbes', () => {
+  test('finds refs across quote styles and dedupes', async () => {
+    await writeFile(
+      join(dir, 'a.ts'),
+      `sentori.probe('SENT-1'); probe("SENT-2", {x:1}); sentori.probe(\`SENT-1\`)`,
+    )
+    await writeFile(join(dir, 'b.tsx'), `if (bad) { sentori.probe('SENT-3') }`)
+    expect(scanProbes(dir)).toEqual(['SENT-1', 'SENT-2', 'SENT-3'])
+  })
+
+  test('skips node_modules and non-source files', async () => {
+    await mkdir(join(dir, 'node_modules'), { recursive: true })
+    await writeFile(join(dir, 'node_modules', 'x.ts'), `probe('NOPE')`)
+    await writeFile(join(dir, 'notes.md'), `probe('ALSO-NOPE')`)
+    expect(scanProbes(dir)).toEqual([])
+  })
+
+  test('dynamic refs are invisible (documented limitation)', async () => {
+    await writeFile(join(dir, 'c.ts'), 'sentori.probe(ref)')
+    expect(scanProbes(dir)).toEqual([])
+  })
+})