memorydetective 1.7.0 → 1.8.1

package/dist/tools/captureScenarioState.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Composite snapshot for verify-fix loops: capture a memgraph + screenshot +
+ * UI tree from the current simulator state into one labeled bundle. The
+ * intended workflow is `captureScenarioState({label:"before"})` → run a fix
+ * (or further repro via replayScenario) → `captureScenarioState({label:"after"})`
+ * → diffMemgraphs across the two outputs.
+ *
+ * Each sub-capture (memgraph, screenshot, uiTree) is best-effort: if one
+ * fails, the others still proceed and the failure is surfaced via
+ * `subFailures` so the caller has partial state instead of nothing.
+ */
+import { z } from "zod";
+import { type WorkaroundNotice } from "./captureMemgraph.js";
+export declare const captureScenarioStateShape: {
+    readonly simulatorUDID: z.ZodString;
+    readonly pid: z.ZodOptional<z.ZodNumber>;
+    readonly appName: z.ZodOptional<z.ZodString>;
+    readonly outputDir: z.ZodString;
+    readonly label: z.ZodDefault<z.ZodString>;
+    readonly include: z.ZodDefault<z.ZodArray<z.ZodEnum<["memgraph", "screenshot", "uiTree"]>, "many">>;
+};
+export declare const captureScenarioStateSchema: z.ZodEffects<z.ZodObject<{
+    readonly simulatorUDID: z.ZodString;
+    readonly pid: z.ZodOptional<z.ZodNumber>;
+    readonly appName: z.ZodOptional<z.ZodString>;
+    readonly outputDir: z.ZodString;
+    readonly label: z.ZodDefault<z.ZodString>;
+    readonly include: z.ZodDefault<z.ZodArray<z.ZodEnum<["memgraph", "screenshot", "uiTree"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    simulatorUDID: string;
+    label: string;
+    outputDir: string;
+    include: ("screenshot" | "memgraph" | "uiTree")[];
+    pid?: number | undefined;
+    appName?: string | undefined;
+}, {
+    simulatorUDID: string;
+    outputDir: string;
+    pid?: number | undefined;
+    appName?: string | undefined;
+    label?: string | undefined;
+    include?: ("screenshot" | "memgraph" | "uiTree")[] | undefined;
+}>, {
+    simulatorUDID: string;
+    label: string;
+    outputDir: string;
+    include: ("screenshot" | "memgraph" | "uiTree")[];
+    pid?: number | undefined;
+    appName?: string | undefined;
+}, {
+    simulatorUDID: string;
+    outputDir: string;
+    pid?: number | undefined;
+    appName?: string | undefined;
+    label?: string | undefined;
+    include?: ("screenshot" | "memgraph" | "uiTree")[] | undefined;
+}>;
+export type CaptureScenarioStateInput = z.infer<typeof captureScenarioStateSchema>;
+export interface CaptureScenarioSubFailure {
+    kind: "memgraph" | "screenshot" | "uiTree";
+    reason: string;
+}
+export interface CaptureScenarioStateResult {
+    ok: boolean;
+    label: string;
+    outputDir: string;
+    memgraphPath?: string;
+    screenshotPath?: string;
+    uiTreePath?: string;
+    /** Surfaced from captureMemgraph when leaks fails with a known issue. */
+    memgraphWorkaroundNotice?: WorkaroundNotice;
+    subFailures: CaptureScenarioSubFailure[];
+    warnings?: string[];
+}
+export declare function captureScenarioState(input: CaptureScenarioStateInput): Promise<CaptureScenarioStateResult>;
+/** Pure: replace filesystem-unsafe characters in a label. Exposed for tests. */
+export declare function sanitizeLabel(label: string): string;

package/dist/tools/captureScenarioState.js

@@ -0,0 +1,159 @@
+/**
+ * Composite snapshot for verify-fix loops: capture a memgraph + screenshot +
+ * UI tree from the current simulator state into one labeled bundle. The
+ * intended workflow is `captureScenarioState({label:"before"})` → run a fix
+ * (or further repro via replayScenario) → `captureScenarioState({label:"after"})`
+ * → diffMemgraphs across the two outputs.
+ *
+ * Each sub-capture (memgraph, screenshot, uiTree) is best-effort: if one
+ * fails, the others still proceed and the failure is surfaced via
+ * `subFailures` so the caller has partial state instead of nothing.
+ */
+import { z } from "zod";
+import { existsSync, mkdirSync } from "node:fs";
+import { writeFile } from "node:fs/promises";
+import { join as joinPath, resolve as resolvePath } from "node:path";
+import { captureMemgraph, } from "./captureMemgraph.js";
+import { takeScreenshot } from "../runtime/simctl.js";
+import { checkAxeAvailable, describeUI } from "../runtime/axe.js";
+export const captureScenarioStateShape = {
+    simulatorUDID: z
+        .string()
+        .min(1)
+        .describe("UDID of the booted simulator hosting the target app. Used for screenshot + UI tree captures."),
+    pid: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("PID of the host-side app process. Mutually exclusive with `appName`. Pass the value returned by bootAndLaunchForLeakInvestigation."),
+    appName: z
+        .string()
+        .optional()
+        .describe("App executable name as visible in pgrep. Mutually exclusive with `pid`."),
+    outputDir: z
+        .string()
+        .min(1)
+        .describe("Absolute directory where the snapshot files are written. Created if it does not exist."),
+    label: z
+        .string()
+        .min(1)
+        .default("snapshot")
+        .describe("Filename prefix for the captured artifacts. Use \"before\" / \"after\" for verify-fix flows."),
+    include: z
+        .array(z.enum(["memgraph", "screenshot", "uiTree"]))
+        .default(["memgraph", "screenshot", "uiTree"])
+        .describe("Which artifacts to capture. Default captures all three."),
+};
+export const captureScenarioStateSchema = z
+    .object(captureScenarioStateShape)
+    .superRefine((val, ctx) => {
+    const targets = [val.pid, val.appName].filter((v) => v !== undefined).length;
+    if (targets !== 1) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Provide exactly one of `pid` or `appName`.",
+        });
+    }
+});
+export async function captureScenarioState(input) {
+    const outputDir = resolvePath(input.outputDir);
+    if (!existsSync(outputDir)) {
+        mkdirSync(outputDir, { recursive: true });
+    }
+    const subFailures = [];
+    const warnings = [];
+    const safeLabel = sanitizeLabel(input.label);
+    let memgraphPath;
+    let memgraphWorkaroundNotice;
+    if (input.include.includes("memgraph")) {
+        const target = joinPath(outputDir, `${safeLabel}.memgraph`);
+        try {
+            const result = await captureMemgraph({
+                ...(input.pid ? { pid: input.pid } : {}),
+                ...(input.appName ? { appName: input.appName } : {}),
+                output: target,
+            });
+            if (result.ok && result.output) {
+                memgraphPath = result.output;
+            }
+            else {
+                memgraphWorkaroundNotice = result.workaroundNotice;
+                subFailures.push({
+                    kind: "memgraph",
+                    reason: result.workaroundNotice?.message ??
+                        result.stderr ??
+                        "captureMemgraph reported ok:false without a workaroundNotice.",
+                });
+            }
+            if (result.warnings) {
+                warnings.push(...result.warnings);
+            }
+        }
+        catch (err) {
+            subFailures.push({
+                kind: "memgraph",
+                reason: err.message,
+            });
+        }
+    }
+    let screenshotPath;
+    if (input.include.includes("screenshot")) {
+        const target = joinPath(outputDir, `${safeLabel}.png`);
+        try {
+            await takeScreenshot(input.simulatorUDID, target);
+            screenshotPath = target;
+        }
+        catch (err) {
+            subFailures.push({
+                kind: "screenshot",
+                reason: err.message,
+            });
+        }
+    }
+    let uiTreePath;
+    if (input.include.includes("uiTree")) {
+        const target = joinPath(outputDir, `${safeLabel}.ui.json`);
+        const availability = await checkAxeAvailable();
+        if (!availability.available) {
+            subFailures.push({
+                kind: "uiTree",
+                reason: availability.installHint ??
+                    "axe CLI not found. uiTree capture requires axe.",
+            });
+        }
+        else {
+            try {
+                const tree = await describeUI(input.simulatorUDID);
+                await writeFile(target, JSON.stringify(tree, null, 2), "utf8");
+                uiTreePath = target;
+            }
+            catch (err) {
+                subFailures.push({
+                    kind: "uiTree",
+                    reason: err.message,
+                });
+            }
+        }
+    }
+    const ok = subFailures.length === 0;
+    return {
+        ok,
+        label: input.label,
+        outputDir,
+        ...(memgraphPath ? { memgraphPath } : {}),
+        ...(screenshotPath ? { screenshotPath } : {}),
+        ...(uiTreePath ? { uiTreePath } : {}),
+        ...(memgraphWorkaroundNotice ? { memgraphWorkaroundNotice } : {}),
+        subFailures,
+        ...(warnings.length > 0 ? { warnings } : {}),
+    };
+}
+/** Pure: replace filesystem-unsafe characters in a label. Exposed for tests. */
+export function sanitizeLabel(label) {
+    return label
+        .replace(/[\/\\:*?"<>|\s]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 64) || "snapshot";
+}
+//# sourceMappingURL=captureScenarioState.js.map

package/dist/tools/captureScenarioState.js.map

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

package/dist/tools/detectLeaksInXCUITest.d.ts

@@ -29,9 +29,9 @@ export declare const detectLeaksInXCUITestSchema: z.ZodObject<{
     appName: string;
     workspace: string;
     scheme: string;
+    outputDir: string;
     testIdentifier: string;
     destination: string;
-    outputDir: string;
     allowlistPatterns: string[];
     skipBuild: boolean;
 }, {
@@ -39,8 +39,8 @@ export declare const detectLeaksInXCUITestSchema: z.ZodObject<{
     workspace: string;
     scheme: string;
     testIdentifier: string;
-    destination?: string | undefined;
     outputDir?: string | undefined;
+    destination?: string | undefined;
     allowlistPatterns?: string[] | undefined;
     skipBuild?: boolean | undefined;
 }>;

package/dist/tools/getInvestigationPlaybook.d.ts

@@ -27,12 +27,27 @@ export interface PlaybookStep {
     /** Optional notes about how to interpret the result before moving to the next step. */
     resultGuidance?: string;
 }
+export interface PlaybookTroubleshooting {
+    /** Tool whose failure this entry addresses. */
+    tool: string;
+    /**
+     * Stable identifier matching `workaroundNotice.issue` when the underlying
+     * tool emits one. Lets the LLM agent branch deterministically.
+     */
+    issueId?: string;
+    /** One-line description of the symptom that triggers this entry. */
+    trigger: string;
+    /** Ordered recovery steps the agent can take. */
+    recovery: string[];
+}
 export interface Playbook {
     kind: PlaybookKind;
     summary: string;
     steps: PlaybookStep[];
     /** Pointers to alternative playbooks the agent might want next. */
     seeAlso?: PlaybookKind[];
+    /** Known failure modes for tools used in this playbook + recovery paths. */
+    troubleshooting?: PlaybookTroubleshooting[];
 }
 declare const PLAYBOOKS: Record<PlaybookKind, Playbook>;
 export interface GetInvestigationPlaybookResult {

package/dist/tools/getInvestigationPlaybook.js

@@ -69,7 +69,7 @@ const PLAYBOOKS = {
             {
                 step: 6,
                 tool: "swiftFindSymbolReferences",
-                purpose: "List every callsite — useful to compare capture-list patterns across them and detect inconsistencies.",
+                purpose: "List every callsite, useful to compare capture-list patterns across them and detect inconsistencies.",
                 argsTemplate: {
                     symbolName: "<class from step 3>",
                     filePath: "<from step 5 result>",
@@ -77,6 +77,29 @@ const PLAYBOOKS = {
             },
         ],
         seeAlso: ["verify-fix"],
+        troubleshooting: [
+            {
+                tool: "captureMemgraph",
+                issueId: "minimal-corpse",
+                trigger: "leaks --outputGraph aborts with 'Failed to get DYLD info for task' on macOS 26.x. Known regression in Apple's leaks tooling.",
+                recovery: [
+                    "Read `workaroundNotice.fallbacks` from the captureMemgraph result for ordered options.",
+                    "Open Xcode > Debug > View Memory Graph Hierarchy on the running process, then File > Export Memory Graph to save a .memgraph manually. Pass that path to analyzeMemgraph.",
+                    "Fall back to recordTimeProfile (template Allocations) + analyzeAllocations to identify top live classes. This is not full cycle detection but reveals leak suspects.",
+                    "Once Phase 2 ships, relaunch the app via bootAndLaunchForLeakInvestigation with MallocStackLogging=1 and retry capture.",
+                ],
+            },
+            {
+                tool: "captureMemgraph",
+                issueId: "permission-denied",
+                trigger: "leaks cannot attach to the target process due to insufficient privileges (task_for_pid failure).",
+                recovery: [
+                    "Confirm the target was built with a debuggable entitlement (DEBUG, not Release).",
+                    "Grant Developer Tools access to the parent shell in System Settings > Privacy & Security.",
+                    "Use Xcode's Memory Graph button while the app is attached to the debugger.",
+                ],
+            },
+        ],
     },
     "perf-hangs": {
         kind: "perf-hangs",

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/tools/replayScenario.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Drive the iOS Simulator through a sequence of UI actions to amplify a
+ * suspected leak before capturing a memgraph. Tied to the leak/perf workflow:
+ * the only reason this tool exists is to make verify-fix loops reproducible
+ * (same scenario before/after a fix) and to surface leaks that only manifest
+ * after N iterations of a flow.
+ *
+ * Soft dependency on `axe` (https://github.com/cameroncooke/AXe). When axe is
+ * not on PATH, this tool returns ok:false with a structured workaroundNotice
+ * pointing the caller at the install instructions, instead of throwing.
+ */
+import { z } from "zod";
+import { type TapTarget } from "../runtime/axe.js";
+declare const actionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"tap">;
+    label: z.ZodOptional<z.ZodString>;
+    elementId: z.ZodOptional<z.ZodString>;
+    coords: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+}, "strip", z.ZodTypeAny, {
+    type: "tap";
+    label?: string | undefined;
+    elementId?: string | undefined;
+    coords?: [number, number] | undefined;
+}, {
+    type: "tap";
+    label?: string | undefined;
+    elementId?: string | undefined;
+    coords?: [number, number] | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"swipe">;
+    from: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    to: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    durationMs: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "swipe";
+    from: [number, number];
+    to: [number, number];
+    durationMs: number;
+}, {
+    type: "swipe";
+    from: [number, number];
+    to: [number, number];
+    durationMs?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"wait">;
+    seconds: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "wait";
+    seconds: number;
+}, {
+    type: "wait";
+    seconds: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"type">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "type";
+    text: string;
+}, {
+    type: "type";
+    text: string;
+}>]>;
+export type ReplayAction = z.infer<typeof actionSchema>;
+export declare const replayScenarioShape: {
+    readonly simulatorUDID: z.ZodString;
+    readonly actions: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"tap">;
+        label: z.ZodOptional<z.ZodString>;
+        elementId: z.ZodOptional<z.ZodString>;
+        coords: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "tap";
+        label?: string | undefined;
+        elementId?: string | undefined;
+        coords?: [number, number] | undefined;
+    }, {
+        type: "tap";
+        label?: string | undefined;
+        elementId?: string | undefined;
+        coords?: [number, number] | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"swipe">;
+        from: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        to: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        durationMs: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "swipe";
+        from: [number, number];
+        to: [number, number];
+        durationMs: number;
+    }, {
+        type: "swipe";
+        from: [number, number];
+        to: [number, number];
+        durationMs?: number | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"wait">;
+        seconds: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "wait";
+        seconds: number;
+    }, {
+        type: "wait";
+        seconds: number;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"type">;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "type";
+        text: string;
+    }, {
+        type: "type";
+        text: string;
+    }>]>, "many">;
+    readonly repeat: z.ZodDefault<z.ZodNumber>;
+    readonly settleBetweenActionsMs: z.ZodDefault<z.ZodNumber>;
+    readonly finalUITreePath: z.ZodOptional<z.ZodString>;
+};
+export declare const replayScenarioSchema: z.ZodObject<{
+    readonly simulatorUDID: z.ZodString;
+    readonly actions: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"tap">;
+        label: z.ZodOptional<z.ZodString>;
+        elementId: z.ZodOptional<z.ZodString>;
+        coords: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "tap";
+        label?: string | undefined;
+        elementId?: string | undefined;
+        coords?: [number, number] | undefined;
+    }, {
+        type: "tap";
+        label?: string | undefined;
+        elementId?: string | undefined;
+        coords?: [number, number] | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"swipe">;
+        from: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        to: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        durationMs: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "swipe";
+        from: [number, number];
+        to: [number, number];
+        durationMs: number;
+    }, {
+        type: "swipe";
+        from: [number, number];
+        to: [number, number];
+        durationMs?: number | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"wait">;
+        seconds: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "wait";
+        seconds: number;
+    }, {
+        type: "wait";
+        seconds: number;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"type">;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "type";
+        text: string;
+    }, {
+        type: "type";
+        text: string;
+    }>]>, "many">;
+    readonly repeat: z.ZodDefault<z.ZodNumber>;
+    readonly settleBetweenActionsMs: z.ZodDefault<z.ZodNumber>;
+    readonly finalUITreePath: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    repeat: number;
+    simulatorUDID: string;
+    actions: ({
+        type: "tap";
+        label?: string | undefined;
+        elementId?: string | undefined;
+        coords?: [number, number] | undefined;
+    } | {
+        type: "swipe";
+        from: [number, number];
+        to: [number, number];
+        durationMs: number;
+    } | {
+        type: "wait";
+        seconds: number;
+    } | {
+        type: "type";
+        text: string;
+    })[];
+    settleBetweenActionsMs: number;
+    finalUITreePath?: string | undefined;
+}, {
+    simulatorUDID: string;
+    actions: ({
+        type: "tap";
+        label?: string | undefined;
+        elementId?: string | undefined;
+        coords?: [number, number] | undefined;
+    } | {
+        type: "swipe";
+        from: [number, number];
+        to: [number, number];
+        durationMs?: number | undefined;
+    } | {
+        type: "wait";
+        seconds: number;
+    } | {
+        type: "type";
+        text: string;
+    })[];
+    repeat?: number | undefined;
+    settleBetweenActionsMs?: number | undefined;
+    finalUITreePath?: string | undefined;
+}>;
+export type ReplayScenarioInput = z.infer<typeof replayScenarioSchema>;
+export interface ReplayScenarioFailure {
+    iteration: number;
+    stepIndex: number;
+    reason: string;
+}
+export interface ReplayScenarioWorkaroundNotice {
+    issue: "axe-not-found";
+    message: string;
+}
+export interface ReplayScenarioResult {
+    ok: boolean;
+    executedSteps: number;
+    failures: ReplayScenarioFailure[];
+    totalDurationMs: number;
+    finalUITreePath?: string;
+    workaroundNotice?: ReplayScenarioWorkaroundNotice;
+}
+export declare function replayScenario(input: ReplayScenarioInput): Promise<ReplayScenarioResult>;
+/** Pure: convert a tap-action input shape into the runtime TapTarget union. Exposed for tests. */
+export declare function resolveTapTarget(action: {
+    label?: string;
+    elementId?: string;
+    coords?: [number, number];
+}): TapTarget;
+export {};