@memlab/mcp-server 2.18.1 → 2.86.0

package/dist/tools/round-audit.js

@@ -0,0 +1,258 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall memory_lab
+ */
+import fs from 'fs';
+import path from 'path';
+import { z } from 'zod';
+import { errorResult, formatNumber, markdownTable, toolResult, } from '../utils.js';
+const MIN_ANALYZABLE_RUNGS = 3;
+const WEAK_STEP_RATE = 0.5;
+/**
+ * Decide whether a completed round can carry a conclusion.
+ *
+ * The recurring failure is not a round that fails — it is a round that LOOKS
+ * complete and is not. One run reported `165 ok / 135 fail`, was written up as
+ * valid, and had two of its ten declared operations at 58/165 and 0/165. Another
+ * was split down the middle by a page reload and read as "the app shrank, the
+ * cleanest round on record". Every signal needed to catch both is already in the
+ * manifest; nothing was reading it.
+ *
+ * Split out as a pure function so the adjudication is testable without a run.
+ */
+export function auditManifest(m) {
+    const checks = [];
+    const rungs = m.rungs ?? [];
+    checks.push(rungs.length >= MIN_ANALYZABLE_RUNGS
+        ? {
+            name: 'rung count',
+            status: 'ok',
+            detail: `${rungs.length} rungs — enough to separate a trend from a single GC-band sample.`,
+        }
+        : {
+            name: 'rung count',
+            status: 'blocking',
+            detail: `${rungs.length} rung(s); ${MIN_ANALYZABLE_RUNGS} are needed. Two points make every series ` +
+                'monotonic by construction. Record this round as UNANALYZED, not as "no leak".',
+        });
+    const splits = m.ladder_splits_after_rung ?? [];
+    const restarted = rungs.filter(r => r.isolate_restarted).length;
+    checks.push(splits.length === 0 && restarted === 0
+        ? {
+            name: 'ladder continuity',
+            status: 'ok',
+            detail: 'One isolate throughout — all rungs are comparable.',
+        }
+        : {
+            name: 'ladder continuity',
+            status: 'blocking',
+            detail: `The page reloaded after rung(s) ${splits.join(', ')} (${restarted} rung(s) flagged). ` +
+                'Rungs across that boundary are DIFFERENT V8 isolates. Any delta spanning it is ' +
+                'meaningless — analyze each segment on its own, or re-drive.',
+        });
+    const steps = m.steps ?? {};
+    const stepNames = Object.keys(steps);
+    if (stepNames.length === 0) {
+        checks.push({
+            name: 'per-step landing',
+            status: 'caveat',
+            detail: 'The combo declared no steps, so there is no evidence any particular surface was ' +
+                'actually exercised — only that the cycle returned true. Declare `Combo.steps` to ' +
+                'make coverage checkable.',
+        });
+    }
+    else {
+        const dead = stepNames.filter(n => (steps[n].landed ?? 0) === 0);
+        const weak = stepNames.filter(n => (steps[n].landed ?? 0) > 0 && (steps[n].rate ?? 1) < WEAK_STEP_RATE);
+        const raised = stepNames.filter(n => (steps[n].errors ?? 0) > 0);
+        if (dead.length > 0) {
+            checks.push({
+                name: 'per-step landing',
+                status: 'blocking',
+                detail: `${dead.length} declared step(s) NEVER landed: ${dead.join(', ')}. ` +
+                    'The ladder says nothing about those surfaces, however many cycles ran.',
+            });
+        }
+        else if (weak.length > 0) {
+            checks.push({
+                name: 'per-step landing',
+                status: 'caveat',
+                detail: `${weak.length} step(s) landed below ${WEAK_STEP_RATE * 100}%: ` +
+                    weak
+                        .map(n => `${n} ${steps[n].landed}/${steps[n].attempted}`)
+                        .join(', ') +
+                    '. Those surfaces are barely exercised; scope the conclusion accordingly.',
+            });
+        }
+        else {
+            checks.push({
+                name: 'per-step landing',
+                status: 'ok',
+                detail: `All ${stepNames.length} declared step(s) landed on the majority of cycles.`,
+            });
+        }
+        if (raised.length > 0) {
+            checks.push({
+                name: 'step exceptions',
+                status: 'caveat',
+                detail: `${raised.length} step(s) RAISED at least once: ${raised.join(', ')}. ` +
+                    'An exception is a bug in the combo, not a fact about the app — check it before ' +
+                    'reading anything into that step.',
+            });
+        }
+    }
+    const mutators = m.mutates_content_per_cycle ?? [];
+    checks.push(mutators.length === 0
+        ? {
+            name: 'content confound',
+            status: 'ok',
+            detail: 'No combo added content while driving; a per-cycle rate is attributable.',
+        }
+        : {
+            name: 'content confound',
+            status: 'blocking',
+            detail: `${mutators.join(', ')} added content DURING the ladder, so per-content and ` +
+                'per-interaction growth are inseparable. A slope from this run is not attributable ' +
+                'no matter how linear it is. Seed the content once up front and re-drive.',
+        });
+    const gating = m.gating_verified ?? {};
+    const gateKeys = Object.keys(gating);
+    // Prefer the runner's own summary. Counting read-back entries here while the
+    // runner counted declared-minus-absent produced two different fractions for
+    // the same bring-up ("16 verified" vs "14/16"), and both were quoted.
+    const summary = m.gating_summary;
+    // `declared === 0` is NOT a verified round. Taking the summary branch for it
+    // reported "0/0 prop(s) verified in-page. The round ran with every declared
+    // prop applied and read back." at status `ok` — a clean bill for a round that
+    // gated nothing. It belongs with the no-summary case below, which says so.
+    if (summary?.declared != null && summary.declared > 0) {
+        const verified = summary.verified ?? 0;
+        const absent = summary.absent ?? 0;
+        checks.push({
+            name: 'gating',
+            status: absent > 0 ? 'caveat' : 'ok',
+            detail: `${verified}/${summary.declared} prop(s) verified in-page` +
+                (absent > 0
+                    ? `, ${absent} absent from this build's registry (${(summary.absent_props ?? []).join(', ')}). ` +
+                        'Absent is not failed — the prop does not exist in this build — but a round compared against ' +
+                        'one where it did exist is not comparing the same configuration.'
+                    : '. The round ran with every declared prop applied and read back.'),
+        });
+    }
+    else {
+        checks.push(gateKeys.length === 0
+            ? {
+                name: 'gating',
+                status: 'caveat',
+                detail: 'No verified gating recorded. If the round depends on a flag being on or off, ' +
+                    'nothing here shows it actually was.',
+            }
+            : {
+                name: 'gating',
+                status: 'ok',
+                detail: `${gateKeys.length} gating value(s) verified in-page — a count of read-back entries, not of declared props. A runner new enough to write \`gating_summary\` reports the declared/verified/absent split instead.`,
+            });
+    }
+    const totals = m.totals ?? {};
+    const cycles = totals.cycles ?? 0;
+    const ok = totals.ok ?? 0;
+    const landRate = cycles > 0 ? ok / cycles : 0;
+    checks.push(cycles === 0
+        ? {
+            name: 'cycle landing',
+            status: 'blocking',
+            detail: 'No cycles ran.',
+        }
+        : landRate >= WEAK_STEP_RATE
+            ? {
+                name: 'cycle landing',
+                status: 'ok',
+                detail: `${formatNumber(ok)}/${formatNumber(cycles)} cycles landed (${(landRate * 100).toFixed(0)}%).`,
+            }
+            : {
+                name: 'cycle landing',
+                status: 'caveat',
+                detail: `only ${formatNumber(ok)}/${formatNumber(cycles)} cycles landed (${(landRate * 100).toFixed(0)}%).`,
+            });
+    const caveats = m.caveats ?? [];
+    if (caveats.length > 0) {
+        checks.push({
+            name: 'recorded caveats',
+            status: 'caveat',
+            detail: `${caveats.length} caveat(s) recorded by the runner — read them before concluding.`,
+        });
+    }
+    const verdict = checks.some(c => c.status === 'blocking')
+        ? 'UNTRUSTWORTHY'
+        : checks.some(c => c.status === 'caveat')
+            ? 'CAVEATED'
+            : 'TRUSTWORTHY';
+    return { checks, verdict };
+}
+const ICON = {
+    ok: '✅',
+    caveat: '⚠️',
+    blocking: '❌',
+};
+export function registerRoundAudit(server) {
+    server.tool('memlab_round_audit', "Read a leak hunt's `run.json` and say whether the round can carry a conclusion at all — BEFORE anyone reads its numbers. " +
+        'Checks rung count, ladder continuity (a mid-run page reload silently splits the ladder into two V8 isolates), ' +
+        'per-step landing (a declared surface that never actually opened), step exceptions, the content-mutation confound, ' +
+        'verified gating, and the overall cycle landing rate.\n\n' +
+        'Every one of these is already in the manifest and nothing was reading it. The failures this catches are rounds ' +
+        'that LOOK complete: one was written up as valid with two of its ten declared operations at 58/165 and 0/165; ' +
+        'another was split by a page reload and read as "the app shrank, cleanest round on record" when its valid segment ' +
+        'said the opposite.\n\n' +
+        'Returns TRUSTWORTHY / CAVEATED / UNTRUSTWORTHY. Run it first; `memlab_analyze_run` answers what the round MEASURED, ' +
+        'this answers whether the round is worth measuring.', {
+        run_dir: z
+            .string()
+            .describe("Path to the hunt's output directory, or directly to its run.json."),
+    }, async ({ run_dir }) => {
+        try {
+            const manifestPath = run_dir.endsWith('.json')
+                ? run_dir
+                : path.join(run_dir, 'run.json');
+            if (!fs.existsSync(manifestPath)) {
+                return errorResult(new Error(`No manifest at ${manifestPath}. Point at the hunt's output directory (the one containing run.json and snapshots/).`));
+            }
+            const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+            const { checks, verdict } = auditManifest(manifest);
+            const lines = [
+                `## Round audit — \`${manifest.run_id ?? path.basename(path.dirname(manifestPath))}\``,
+                '',
+                markdownTable(['', 'Check', 'Finding'], checks.map(c => [ICON[c.status], c.name, c.detail])),
+                '',
+                `**Verdict: ${verdict}**`,
+                '',
+            ];
+            if (verdict === 'UNTRUSTWORTHY') {
+                lines.push('At least one blocking problem means a conclusion drawn from this round would not be supported by it. ' +
+                    'Fix and re-drive, or scope the conclusion to the part of the ladder that is still valid — and say which part that is.');
+            }
+            else if (verdict === 'CAVEATED') {
+                lines.push('Usable, but the caveats above have to travel with any number taken from it. A caveat dropped between ' +
+                    'the run and the write-up is how an unsupported claim gets recorded as a measurement.');
+            }
+            else {
+                lines.push('No structural problem found. This says the round is well-formed, NOT that its findings are real — ' +
+                    'replication (`memlab_replicate`) and retainer evidence are separate questions.');
+            }
+            if ((manifest.caveats ?? []).length > 0) {
+                lines.push('', '### Caveats recorded by the runner', '');
+                for (const c of manifest.caveats ?? [])
+                    lines.push(`- ${c}`);
+            }
+            return toolResult(lines.join('\n'), null);
+        }
+        catch (e) {
+            return errorResult(e instanceof Error ? e : new Error(String(e)));
+        }
+    });
+}
+//# sourceMappingURL=round-audit.js.map

package/dist/tools/round-audit.js.map

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

package/dist/tools/round-digest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall memory_lab
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerRoundDigest(server: McpServer): void;
+//# sourceMappingURL=round-digest.d.ts.map

package/dist/tools/round-digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-digest.d.ts","sourceRoot":"","sources":["../../src/tools/round-digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAkJvE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4J3D"}

package/dist/tools/round-digest.js

@@ -0,0 +1,190 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall memory_lab
+ */
+import { z } from 'zod';
+import fs from 'fs';
+import path from 'path';
+import { auditManifest } from './round-audit.js';
+import { errorResult, toolResult, formatNumber, markdownTable, } from '../utils.js';
+/** `run.json`, whether given the file or the directory holding it. */
+function resolveManifestPath(input) {
+    let p = input;
+    try {
+        if (fs.existsSync(p) && fs.statSync(p).isDirectory()) {
+            p = path.join(p, 'run.json');
+        }
+    }
+    catch {
+        return null;
+    }
+    return fs.existsSync(p) ? p : null;
+}
+/** Words `analyze_run` uses in an adjudication cell. */
+const VERDICT_RE = /LEAK CANDIDATE|LEAK|STEP FUNCTION|LINEAR|FLAT|ARTIFACT|NOISE|SHRANK|BOUNDED|NOT A LEAK|CANDIDATE|↑|↓/i;
+/** Split a markdown row into trimmed cells, dropping the empty outer pair. */
+function cells(line) {
+    const parts = line.split('|').map(c => c.trim());
+    if (parts.length > 0 && parts[0] === '')
+        parts.shift();
+    if (parts.length > 0 && parts[parts.length - 1] === '')
+        parts.pop();
+    return parts;
+}
+function parseAnalysis(text) {
+    const rows = [];
+    let skipped = 0;
+    let header = null;
+    let verdictCol = -1;
+    for (const line of text.split('\n')) {
+        const trimmed = line.trimStart();
+        if (!trimmed.startsWith('|')) {
+            // A blank line or prose ends the current table, so a header cannot leak
+            // into the next one.
+            if (trimmed === '') {
+                header = null;
+                verdictCol = -1;
+            }
+            continue;
+        }
+        if (/^\s*\|[\s:|-]+\|?\s*$/.test(line))
+            continue; // separator
+        const cs = cells(line);
+        if (cs.length < 2)
+            continue;
+        if (header == null) {
+            header = cs.map(c => c.toLowerCase());
+            verdictCol = header.findIndex(h => h.includes('adjudication') || h.includes('verdict'));
+            continue;
+        }
+        if (verdictCol < 0 || verdictCol >= cs.length) {
+            // A table with no verdict column (the ladder, the owner breakdown) is
+            // not a failure to parse — it simply is not what this reads.
+            continue;
+        }
+        const verdict = cs[verdictCol];
+        if (!VERDICT_RE.test(verdict)) {
+            skipped++;
+            continue;
+        }
+        // Column names vary between analysis sections; find each by heading rather
+        // than by position, and leave a cell blank when the table does not have it.
+        const at = (...names) => {
+            for (const n of names) {
+                const i = header?.findIndex(h => h.includes(n)) ?? -1;
+                if (i >= 0 && i < cs.length)
+                    return cs[i];
+            }
+            return '';
+        };
+        rows.push({
+            metric: cs[0].replace(/^`|`$/g, ''),
+            delta: at('δ count', 'count', 'delta'),
+            rate: at('δ/cycle', '/cycle', 'rate'),
+            size: at('δ size', 'size'),
+            verdict,
+        });
+    }
+    return { rows, skipped };
+}
+export function registerRoundDigest(server) {
+    server.tool('memlab_round_digest', "The verdict table for a finished leak-hunt round, and nothing else. `memlab_analyze_run` writes ~30 KB of prose per round, which in practice gets grepped for verdicts rather than read — across a five-round sweep that is the single largest avoidable token cost in the analysis phase. This reads the run manifest plus any `*_analysis.txt` next to it and returns: the audit verdict and its blocking checks, the ladder shape (including whether a page reload split it), the per-metric rate/fit/verdict rows, and the round's own caveats. The full analysis stays on disk and is named in the output, so nothing is lost — it is just not paid for by default.", {
+        run_dir: z
+            .string()
+            .describe('Path to a leak-hunt run directory, or directly to its run.json.'),
+        include_analysis: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe('Parse `*_analysis.txt` files next to the manifest for their verdict rows (default true). Set false for the manifest audit alone.'),
+        max_metrics: z
+            .number()
+            .optional()
+            .default(25)
+            .describe('Maximum metric rows to show (default 25).'),
+    }, async ({ run_dir, include_analysis, max_metrics }) => {
+        try {
+            const manifestPath = resolveManifestPath(run_dir);
+            if (manifestPath == null) {
+                return errorResult(`No run.json at ${run_dir} (nor at ${path.join(run_dir, 'run.json')}).`);
+            }
+            const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+            const dir = path.dirname(manifestPath);
+            const audit = auditManifest(manifest);
+            const rungs = manifest.rungs ?? [];
+            const splits = manifest.ladder_splits_after_rung ?? [];
+            const lines = [
+                `# Round digest — ${manifest.run_id ?? path.basename(dir)}`,
+                '',
+                `**Audit verdict: ${audit.verdict}**`,
+                '',
+            ];
+            // Only the checks that change what a reader may claim. An "ok" check is
+            // the absence of a problem and does not need a row.
+            const notable = audit.checks.filter(c => c.status !== 'ok');
+            if (notable.length > 0) {
+                lines.push(markdownTable(['Check', 'Status', 'Detail'], notable.map(c => [c.name, c.status.toUpperCase(), c.detail])), '');
+            }
+            else {
+                lines.push('_All audit checks passed._', '');
+            }
+            const totals = manifest.totals ?? {};
+            lines.push(`Cycles ${formatNumber(totals.cycles ?? 0)} (ok ${formatNumber(totals.ok ?? 0)} / fail ${formatNumber(totals.fail ?? 0)}) · ` +
+                `${rungs.length} rung(s)` +
+                (splits.length > 0
+                    ? ` · ⚠ ladder split after rung ${splits.join(', ')} — deltas spanning a split compare two V8 isolates`
+                    : '') +
+                (manifest.stop_reason ? ` · stop: ${manifest.stop_reason}` : ''), '');
+            if (rungs.length > 0) {
+                const first = rungs[0];
+                const last = rungs[rungs.length - 1];
+                const delta = (last.post_gc_heap_mb ?? 0) - (first.post_gc_heap_mb ?? 0);
+                lines.push(`Post-GC heap ${(first.post_gc_heap_mb ?? 0).toFixed(1)} → ${(last.post_gc_heap_mb ?? 0).toFixed(1)} MB (${delta >= 0 ? '+' : ''}${delta.toFixed(1)} MB). ` +
+                    'Aggregate heap is the weakest signal in a round; the per-metric rows below decide.', '');
+            }
+            if (include_analysis) {
+                const analysisFiles = fs
+                    .readdirSync(dir)
+                    .filter(f => f.endsWith('_analysis.txt') || f === 'analysis.txt')
+                    .sort();
+                if (analysisFiles.length === 0) {
+                    lines.push('_No `*_analysis.txt` beside the manifest — run `memlab_analyze_run` first for the per-metric verdicts._', '');
+                }
+                for (const file of analysisFiles) {
+                    const { rows, skipped } = parseAnalysis(fs.readFileSync(path.join(dir, file), 'utf8'));
+                    lines.push(`## ${file}`, '');
+                    if (rows.length === 0) {
+                        lines.push(`_No verdict rows recognised (${formatNumber(skipped)} table line(s) skipped). Read the file directly: ${path.join(dir, file)}_`, '');
+                        continue;
+                    }
+                    lines.push(markdownTable(['Metric', 'Δ count', 'Δ/cycle', 'Δ size', 'Verdict'], rows
+                        .slice(0, max_metrics)
+                        .map(r => [r.metric, r.delta, r.rate, r.size, r.verdict]), new Set([1, 2, 3])), '');
+                    if (rows.length > max_metrics) {
+                        lines.push(`_${formatNumber(rows.length - max_metrics)} further row(s) not shown; raise \`max_metrics\`._`, '');
+                    }
+                    // Never silent about what was not parsed: a digest that quietly
+                    // dropped the one row carrying the finding would be worse than no
+                    // digest at all.
+                    if (skipped > 0) {
+                        lines.push(`_${formatNumber(skipped)} table line(s) in this file were not recognised as verdict rows and are not represented above._`, '');
+                    }
+                }
+            }
+            if ((manifest.caveats ?? []).length > 0) {
+                lines.push('## Round caveats (carry these into the write-up)', '', ...(manifest.caveats ?? []).map(c => `- ${c}`), '');
+            }
+            lines.push(`_Full analysis and manifest: ${dir}_`, '_This is a summary of files on disk, not a re-analysis. Run `memlab_analyze_run` to produce or refresh them._');
+            return toolResult(lines.join('\n'));
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=round-digest.js.map

package/dist/tools/round-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-digest.js","sourceRoot":"","sources":["../../src/tools/round-digest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,WAAW,EACX,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AA8BrB,sEAAsE;AACtE,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,CAAC,GAAG,KAAK,CAAC;IACd,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACrD,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrC,CAAC;AAyBD,wDAAwD;AACxD,MAAM,UAAU,GACd,uGAAuG,CAAC;AAE1G,8EAA8E;AAC9E,SAAS,KAAK,CAAC,IAAY;IACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACvD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IACpE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,GAAoB,IAAI,CAAC;IACnC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,wEAAwE;YACxE,qBAAqB;YACrB,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;gBACnB,MAAM,GAAG,IAAI,CAAC;gBACd,UAAU,GAAG,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,YAAY;QAC9D,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAE5B,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YACtC,UAAU,GAAG,MAAM,CAAC,SAAS,CAC3B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CACzD,CAAC;YACF,SAAS;QACX,CAAC;QACD,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;YAC9C,sEAAsE;YACtE,6DAA6D;YAC7D,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC;QAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QACD,2EAA2E;QAC3E,4EAA4E;QAC5E,MAAM,EAAE,GAAG,CAAC,GAAG,KAAe,EAAU,EAAE;YACxC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,GAAG,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBACtD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM;oBAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,IAAI,CAAC,IAAI,CAAC;YACR,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;YACnC,KAAK,EAAE,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;YACtC,IAAI,EAAE,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC;YACrC,IAAI,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;YAC1B,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAC,IAAI,EAAE,OAAO,EAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,0oBAA0oB,EAC1oB;QACE,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CACP,iEAAiE,CAClE;QACH,gBAAgB,EAAE,CAAC;aAChB,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,OAAO,CAAC,IAAI,CAAC;aACb,QAAQ,CACP,kIAAkI,CACnI;QACH,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,2CAA2C,CAAC;KACzD,EACD,KAAK,EAAE,EAAC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAC,EAAE,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;gBACzB,OAAO,WAAW,CAChB,kBAAkB,OAAO,YAAY,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,CACxE,CAAC;YACJ,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CACvB,CAAC;YACjB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YAEvC,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,wBAAwB,IAAI,EAAE,CAAC;YAEvD,MAAM,KAAK,GAAa;gBACtB,oBAAoB,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;gBAC3D,EAAE;gBACF,oBAAoB,KAAK,CAAC,OAAO,IAAI;gBACrC,EAAE;aACH,CAAC;YAEF,wEAAwE;YACxE,oDAAoD;YACpD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;YAC5D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CACR,aAAa,CACX,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAC7B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAC7D,EACD,EAAE,CACH,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;YAC/C,CAAC;YAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CACR,UAAU,YAAY,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,WAAW,YAAY,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM;gBAC3H,GAAG,KAAK,CAAC,MAAM,UAAU;gBACzB,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;oBAChB,CAAC,CAAC,gCAAgC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,oDAAoD;oBACvG,CAAC,CAAC,EAAE,CAAC;gBACP,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAClE,EAAE,CACH,CAAC;YAEF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACvB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACrC,MAAM,KAAK,GACT,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC;gBAC7D,KAAK,CAAC,IAAI,CACR,gBAAgB,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;oBACzJ,oFAAoF,EACtF,EAAE,CACH,CAAC;YACJ,CAAC;YAED,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,aAAa,GAAG,EAAE;qBACrB,WAAW,CAAC,GAAG,CAAC;qBAChB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,cAAc,CAAC;qBAChE,IAAI,EAAE,CAAC;gBACV,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC/B,KAAK,CAAC,IAAI,CACR,yGAAyG,EACzG,EAAE,CACH,CAAC;gBACJ,CAAC;gBACD,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;oBACjC,MAAM,EAAC,IAAI,EAAE,OAAO,EAAC,GAAG,aAAa,CACnC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAC9C,CAAC;oBACF,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACtB,KAAK,CAAC,IAAI,CACR,gCAAgC,YAAY,CAAC,OAAO,CAAC,oDAAoD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAChI,EAAE,CACH,CAAC;wBACF,SAAS;oBACX,CAAC;oBACD,KAAK,CAAC,IAAI,CACR,aAAa,CACX,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,EACrD,IAAI;yBACD,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;yBACrB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAC3D,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CACnB,EACD,EAAE,CACH,CAAC;oBACF,IAAI,IAAI,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;wBAC9B,KAAK,CAAC,IAAI,CACR,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,oDAAoD,EAC/F,EAAE,CACH,CAAC;oBACJ,CAAC;oBACD,gEAAgE;oBAChE,kEAAkE;oBAClE,iBAAiB;oBACjB,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;wBAChB,KAAK,CAAC,IAAI,CACR,IAAI,YAAY,CAAC,OAAO,CAAC,iGAAiG,EAC1H,EAAE,CACH,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxC,KAAK,CAAC,IAAI,CACR,kDAAkD,EAClD,EAAE,EACF,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAC9C,EAAE,CACH,CAAC;YACJ,CAAC;YAED,KAAK,CAAC,IAAI,CACR,gCAAgC,GAAG,GAAG,EACtC,+GAA+G,CAChH,CAAC;YAEF,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/script-census.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall memory_lab
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerScriptCensus(server: McpServer): void;
+//# sourceMappingURL=script-census.d.ts.map

package/dist/tools/script-census.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-census.d.ts","sourceRoot":"","sources":["../../src/tools/script-census.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAuEvE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyJ5D"}