memorydetective 1.5.0 → 1.7.0

package/dist/tools/compareTracesByPattern.js

@@ -0,0 +1,312 @@
+import { z } from "zod";
+import { existsSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { analyzeHangs, } from "./analyzeHangs.js";
+import { analyzeAnimationHitches, } from "./analyzeAnimationHitches.js";
+import { analyzeAppLaunch, } from "./analyzeAppLaunch.js";
+/**
+ * Trace-side counterpart to `verifyFix` (which works on `.memgraph`).
+ * Compares before/after `.trace` bundles for a specific perf category
+ * (hangs, animation-hitches, app-launch) and returns a per-category
+ * PASS/PARTIAL/FAIL verdict + numerical deltas.
+ *
+ * Designed for CI gating: a build script can run a hangs-fix PR's
+ * before/after traces through this tool and fail the merge if the
+ * regression target isn't met.
+ *
+ * Composes with the underlying analyzers — same data shape, just
+ * surfaced as a diff.
+ */
+export const compareTracesByPatternSchema = z.object({
+    before: z
+        .string()
+        .min(1)
+        .describe("Absolute path to the baseline `.trace` (pre-fix)."),
+    after: z
+        .string()
+        .min(1)
+        .describe("Absolute path to the post-fix `.trace`."),
+    category: z
+        .enum(["hangs", "animation-hitches", "app-launch"])
+        .describe("Which perf category to verify. `hangs` parses the `potential-hangs` schema, `animation-hitches` parses `animation-hitches`, `app-launch` parses the launch breakdown."),
+    thresholds: z
+        .object({
+        hangsMaxLongestMs: z
+            .number()
+            .nonnegative()
+            .optional()
+            .describe("For `category: hangs` — PASS requires `after.longestMs <= this`. Default 0 (i.e. PASS only when no hangs remain)."),
+        hitchesMaxLongestMs: z
+            .number()
+            .nonnegative()
+            .optional()
+            .describe("For `category: animation-hitches` — PASS requires `after.longestMs <= this`. Default 100 (Apple's user-perceptible threshold)."),
+        appLaunchMaxTotalMs: z
+            .number()
+            .nonnegative()
+            .optional()
+            .describe("For `category: app-launch` — PASS requires `after.totalMs <= this`. Default 1000 (1 second total cold-launch budget)."),
+    })
+        .optional()
+        .default({}),
+    hangsMinDurationMs: z
+        .number()
+        .nonnegative()
+        .default(250)
+        .describe("For `category: hangs` — only count hangs longer than this. Default 250ms (Apple's user-perceptible threshold for hangs)."),
+    hitchesMinDurationMs: z
+        .number()
+        .nonnegative()
+        .default(100)
+        .describe("For `category: animation-hitches` — only count hitches longer than this. Default 100ms (Apple's user-perceptible threshold)."),
+});
+/** Pure: build the comparison from two analyzer results. */
+export function compareHangs(before, after, thresholdLongestMs) {
+    const beforeStats = {
+        count: before.totals.hangs,
+        longestMs: before.totals.longestMs,
+        averageMs: before.totals.averageMs,
+        totalMs: before.totals.totalDurationMs,
+    };
+    const afterStats = {
+        count: after.totals.hangs,
+        longestMs: after.totals.longestMs,
+        averageMs: after.totals.averageMs,
+        totalMs: after.totals.totalDurationMs,
+    };
+    const delta = {
+        count: afterStats.count - beforeStats.count,
+        longestMs: afterStats.longestMs - beforeStats.longestMs,
+        averageMs: afterStats.averageMs - beforeStats.averageMs,
+        totalMs: afterStats.totalMs - beforeStats.totalMs,
+    };
+    const verdict = decideVerdict({
+        beforeCount: beforeStats.count,
+        afterCount: afterStats.count,
+        afterLongestMs: afterStats.longestMs,
+        thresholdLongestMs,
+    });
+    return { beforeStats, afterStats, delta, verdict };
+}
+/** Pure: same shape as `compareHangs` for animation-hitches. */
+export function compareAnimationHitches(before, after, thresholdLongestMs) {
+    // For animation-hitches, "count" reflects user-perceptible hitches (>100ms)
+    // — the metric users actually feel. The schema's `rows` field is total
+    // hitches including the imperceptible ones.
+    const beforeStats = {
+        count: before.totals.perceptible,
+        longestMs: before.totals.longestMs,
+        averageMs: before.totals.averageMs,
+        totalMs: before.totals.totalDurationMs,
+    };
+    const afterStats = {
+        count: after.totals.perceptible,
+        longestMs: after.totals.longestMs,
+        averageMs: after.totals.averageMs,
+        totalMs: after.totals.totalDurationMs,
+    };
+    const delta = {
+        count: afterStats.count - beforeStats.count,
+        longestMs: afterStats.longestMs - beforeStats.longestMs,
+        averageMs: afterStats.averageMs - beforeStats.averageMs,
+        totalMs: afterStats.totalMs - beforeStats.totalMs,
+    };
+    const verdict = decideVerdict({
+        beforeCount: beforeStats.count,
+        afterCount: afterStats.count,
+        afterLongestMs: afterStats.longestMs,
+        thresholdLongestMs,
+    });
+    return { beforeStats, afterStats, delta, verdict };
+}
+/** Pure: app-launch comparison. The "count" field reflects launch-event count
+ *  (typically 1 per trace); the meaningful number is `totalMs`. */
+export function compareAppLaunch(before, after, thresholdTotalMs) {
+    const beforeStats = {
+        count: 1,
+        longestMs: before.totalLaunchMs,
+        averageMs: before.totalLaunchMs,
+        totalMs: before.totalLaunchMs,
+    };
+    const afterStats = {
+        count: 1,
+        longestMs: after.totalLaunchMs,
+        averageMs: after.totalLaunchMs,
+        totalMs: after.totalLaunchMs,
+    };
+    const delta = {
+        count: 0,
+        longestMs: afterStats.longestMs - beforeStats.longestMs,
+        averageMs: afterStats.averageMs - beforeStats.averageMs,
+        totalMs: afterStats.totalMs - beforeStats.totalMs,
+    };
+    // Verdict semantics for app-launch differ: it's about absolute totalMs
+    // crossing the threshold, not "did the count drop".
+    let verdict;
+    if (afterStats.totalMs <= thresholdTotalMs) {
+        verdict = "PASS";
+    }
+    else if (afterStats.totalMs < beforeStats.totalMs) {
+        verdict = "PARTIAL";
+    }
+    else {
+        verdict = "FAIL";
+    }
+    return { beforeStats, afterStats, delta, verdict };
+}
+/** Shared verdict logic for hangs + hitches. */
+function decideVerdict({ beforeCount, afterCount, afterLongestMs, thresholdLongestMs, }) {
+    // PASS: nothing left above the threshold.
+    if (afterCount === 0 || afterLongestMs <= thresholdLongestMs) {
+        return "PASS";
+    }
+    // PARTIAL: still present but reduced from before.
+    if (afterCount < beforeCount) {
+        return "PARTIAL";
+    }
+    // FAIL: same or worse.
+    return "FAIL";
+}
+function buildDiagnosis(category, beforeStats, afterStats, verdict, thresholdField, thresholdValue) {
+    const verb = category === "hangs"
+        ? "hangs"
+        : category === "animation-hitches"
+            ? "hitches"
+            : "launch time";
+    if (verdict === "PASS") {
+        if (category === "app-launch") {
+            return `Launch time fell to ${afterStats.totalMs.toFixed(0)}ms (was ${beforeStats.totalMs.toFixed(0)}ms), within the ${thresholdValue}ms budget. PASS.`;
+        }
+        if (afterStats.count === 0) {
+            return `All ${verb} resolved (was ${beforeStats.count}, now 0). PASS.`;
+        }
+        return `${verb} reduced to ${afterStats.count} (was ${beforeStats.count}); longest ${afterStats.longestMs.toFixed(0)}ms is below the ${thresholdValue}ms threshold. PASS.`;
+    }
+    if (verdict === "PARTIAL") {
+        return `${verb}: ${beforeStats.count}→${afterStats.count} count, ${beforeStats.longestMs.toFixed(0)}ms→${afterStats.longestMs.toFixed(0)}ms longest. Reduced but still above the ${thresholdValue}ms threshold. PARTIAL.`;
+    }
+    return `${verb}: ${beforeStats.count}→${afterStats.count} count, ${beforeStats.longestMs.toFixed(0)}ms→${afterStats.longestMs.toFixed(0)}ms longest. No improvement vs. before. FAIL — the fix did not address the regression.`;
+}
+export async function compareTracesByPattern(input) {
+    const beforePath = resolvePath(input.before);
+    const afterPath = resolvePath(input.after);
+    if (!existsSync(beforePath)) {
+        throw new Error(`Trace bundle not found: ${beforePath}`);
+    }
+    if (!existsSync(afterPath)) {
+        throw new Error(`Trace bundle not found: ${afterPath}`);
+    }
+    const t = input.thresholds ?? {};
+    if (input.category === "hangs") {
+        const threshold = t.hangsMaxLongestMs ?? 0;
+        const [b, a] = await Promise.all([
+            analyzeHangs({
+                tracePath: beforePath,
+                topN: 10,
+                minDurationMs: input.hangsMinDurationMs ?? 250,
+            }),
+            analyzeHangs({
+                tracePath: afterPath,
+                topN: 10,
+                minDurationMs: input.hangsMinDurationMs ?? 250,
+            }),
+        ]);
+        const cmp = compareHangs(b, a, threshold);
+        const diagnosis = buildDiagnosis("hangs", cmp.beforeStats, cmp.afterStats, cmp.verdict, "hangsMaxLongestMs", threshold);
+        return {
+            ok: true,
+            before: beforePath,
+            after: afterPath,
+            category: "hangs",
+            verdict: cmp.verdict,
+            beforeStats: cmp.beforeStats,
+            afterStats: cmp.afterStats,
+            delta: cmp.delta,
+            thresholdApplied: { field: "hangsMaxLongestMs", value: threshold },
+            diagnosis,
+            ...(cmp.verdict !== "PASS"
+                ? {
+                    suggestedNextCalls: [
+                        {
+                            tool: "analyzeHangs",
+                            args: { tracePath: afterPath, minDurationMs: 250 },
+                            why: "Inspect the remaining post-fix hangs to identify which call sites still need attention.",
+                        },
+                    ],
+                }
+                : {}),
+        };
+    }
+    if (input.category === "animation-hitches") {
+        const threshold = t.hitchesMaxLongestMs ?? 100;
+        const [b, a] = await Promise.all([
+            analyzeAnimationHitches({
+                tracePath: beforePath,
+                topN: 10,
+                minDurationMs: input.hitchesMinDurationMs ?? 100,
+            }),
+            analyzeAnimationHitches({
+                tracePath: afterPath,
+                topN: 10,
+                minDurationMs: input.hitchesMinDurationMs ?? 100,
+            }),
+        ]);
+        const cmp = compareAnimationHitches(b, a, threshold);
+        const diagnosis = buildDiagnosis("animation-hitches", cmp.beforeStats, cmp.afterStats, cmp.verdict, "hitchesMaxLongestMs", threshold);
+        return {
+            ok: true,
+            before: beforePath,
+            after: afterPath,
+            category: "animation-hitches",
+            verdict: cmp.verdict,
+            beforeStats: cmp.beforeStats,
+            afterStats: cmp.afterStats,
+            delta: cmp.delta,
+            thresholdApplied: { field: "hitchesMaxLongestMs", value: threshold },
+            diagnosis,
+            ...(cmp.verdict !== "PASS"
+                ? {
+                    suggestedNextCalls: [
+                        {
+                            tool: "analyzeAnimationHitches",
+                            args: { tracePath: afterPath, minDurationMs: 100 },
+                            why: "Identify which views still hitch in the post-fix trace.",
+                        },
+                    ],
+                }
+                : {}),
+        };
+    }
+    // app-launch
+    const threshold = t.appLaunchMaxTotalMs ?? 1000;
+    const [b, a] = await Promise.all([
+        analyzeAppLaunch({ tracePath: beforePath }),
+        analyzeAppLaunch({ tracePath: afterPath }),
+    ]);
+    const cmp = compareAppLaunch(b, a, threshold);
+    const diagnosis = buildDiagnosis("app-launch", cmp.beforeStats, cmp.afterStats, cmp.verdict, "appLaunchMaxTotalMs", threshold);
+    return {
+        ok: true,
+        before: beforePath,
+        after: afterPath,
+        category: "app-launch",
+        verdict: cmp.verdict,
+        beforeStats: cmp.beforeStats,
+        afterStats: cmp.afterStats,
+        delta: cmp.delta,
+        thresholdApplied: { field: "appLaunchMaxTotalMs", value: threshold },
+        diagnosis,
+        ...(cmp.verdict !== "PASS"
+            ? {
+                suggestedNextCalls: [
+                    {
+                        tool: "analyzeAppLaunch",
+                        args: { tracePath: afterPath },
+                        why: "Find which launch phase (process-creation / dyld / ObjC-init / AppDelegate / first-frame) still dominates the post-fix launch.",
+                    },
+                ],
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=compareTracesByPattern.js.map

package/dist/tools/compareTracesByPattern.js.map

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

package/dist/tools/getInvestigationPlaybook.d.ts

@@ -34,10 +34,13 @@ export interface Playbook {
     /** Pointers to alternative playbooks the agent might want next. */
     seeAlso?: PlaybookKind[];
 }
+declare const PLAYBOOKS: Record<PlaybookKind, Playbook>;
 export interface GetInvestigationPlaybookResult {
     ok: boolean;
     playbook: Playbook;
 }
 export declare function getInvestigationPlaybook(input: GetInvestigationPlaybookInput): Promise<GetInvestigationPlaybookResult>;
-/** Exposed for tests. */
+/** Exposed for tests + the prompts surface. */
 export declare const PLAYBOOK_KINDS: PlaybookKind[];
+/** Exposed for the prompts surface (see src/runtime/prompts.ts). */
+export { PLAYBOOKS };

package/dist/tools/getInvestigationPlaybook.js

@@ -215,6 +215,8 @@ export async function getInvestigationPlaybook(input) {
     }
     return { ok: true, playbook };
 }
-/** Exposed for tests. */
+/** Exposed for tests + the prompts surface. */
 export const PLAYBOOK_KINDS = Object.keys(PLAYBOOKS);
+/** Exposed for the prompts surface (see src/runtime/prompts.ts). */
+export { PLAYBOOKS };
 //# sourceMappingURL=getInvestigationPlaybook.js.map

package/dist/tools/getInvestigationPlaybook.js.map

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

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION: string;

package/dist/version.js

@@ -0,0 +1,15 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+// Single source of truth for the runtime version string. Reads from
+// package.json so the CLI banner, the MCP server handshake, and any other
+// surface that reports a version can never drift out of sync with the
+// published artifact.
+//
+// Layout assumption: this file (compiled to dist/version.js) sits one level
+// below package.json — true both at dev time (src/ ↔ package.json) and after
+// `npm install` (node_modules/<pkg>/dist/ ↔ node_modules/<pkg>/package.json).
+const here = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8"));
+export const VERSION = pkg.version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,oEAAoE;AACpE,0EAA0E;AAC1E,sEAAsE;AACtE,sBAAsB;AACtB,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAChC,CAAC;AAEzB,MAAM,CAAC,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorydetective",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "MCP server for iOS leak hunting and performance investigation. Reads .memgraph + .trace files, captures new ones via xctrace and leaks(1), classifies retain cycles.",
   "type": "module",
   "bin": {