ts-knowledge-graph 0.1.1 → 0.1.4

package/dist/commands/verify_command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify_command.d.ts","sourceRoot":"","sources":["../../src/commands/verify_command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,qBAAa,aAAa;IACzB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAuBvC,OAAO,CAAC,MAAM,CAAC,KAAK;IAapB,OAAO,CAAC,MAAM,CAAC,UAAU;IAUzB,OAAO,CAAC,MAAM,CAAC,kBAAkB;CASjC"}

package/dist/commands/verify_command.js

@@ -0,0 +1,57 @@
+import chalk from 'chalk';
+import { ProjectVerifier } from '../verify/project_verifier.js';
+export class VerifyCommand {
+    static register(program) {
+        program
+            .command('verify')
+            .description('run the project type-check + test gates and return one keep/revert verdict for an edit')
+            .option('-C, --cwd <path>', 'project directory whose package.json scripts are run', process.cwd())
+            .option('--typecheck-script <name>', 'npm script for the type-check gate', 'typecheck')
+            .option('--test-script <name>', 'npm script for the test gate', 'test')
+            .option('--skip-typecheck', 'skip the type-check gate', false)
+            .option('--skip-tests', 'skip the test gate (degrades to type-check-only)', false)
+            .option('--json', 'emit the verdict as JSON', false)
+            .action(async (options) => {
+            const report = await ProjectVerifier.verify({
+                cwd: options.cwd,
+                typecheckScript: options.typecheckScript,
+                testScript: options.testScript,
+                skipTypecheck: options.skipTypecheck === true,
+                skipTests: options.skipTests === true,
+            });
+            VerifyCommand.print(report, options.json === true);
+            process.exitCode = report.ok === true ? 0 : 1;
+        });
+    }
+    static print(report, json) {
+        if (json === true) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        for (const check of report.checks) {
+            VerifyCommand.printCheck(check);
+        }
+        const verdict = report.ok === true ? chalk.green('✓') : chalk.red('✗');
+        console.log(`\n${verdict} ${report.summary}`);
+        VerifyCommand.printFailureOutput(report);
+    }
+    static printCheck(check) {
+        if (check.status === 'skipped') {
+            console.log(`${chalk.yellow('•')} ${chalk.bold(check.name.padEnd(10))} ${chalk.yellow('skipped')}  ${chalk.gray(check.skippedReason ?? '')}`);
+            return;
+        }
+        const mark = check.status === 'pass' ? chalk.green('✓') : chalk.red('✗');
+        const timing = chalk.gray(`${(check.durationMs / 1000).toFixed(1)}s`);
+        console.log(`${mark} ${chalk.bold(check.name.padEnd(10))} ${chalk.gray(check.command ?? '')}  ${timing}`);
+    }
+    static printFailureOutput(report) {
+        if (report.ok === true) {
+            return;
+        }
+        for (const check of report.checks.filter((candidate) => candidate.status === 'fail')) {
+            console.log(chalk.bold(`\n— ${check.name} output (tail) —`));
+            console.log(check.output.trimEnd());
+        }
+    }
+}
+//# sourceMappingURL=verify_command.js.map

package/dist/commands/verify_command.js.map

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

package/dist/commands/web_command.d.ts

@@ -0,0 +1,46 @@
+import { Command } from 'commander';
+/**
+ * `web` command — serves the knowledge graph database in an interactive web
+ * visualisation. The graph is read from Kùzu once at startup and injected into
+ * the page as `/data/graph_data.js`; all other assets are served statically
+ * from the contribs/web_visualisation/web directory.
+ */
+export declare class WebCommand {
+    static register(program: Command): void;
+    private static run;
+    /**
+     * Reads every node and edge from the database and renders them as the
+     * `window.GRAPH_DATA` script the visualisation page loads on boot.
+     */
+    private static buildDataScript;
+    /**
+     * Decodes the JSON `metadata` column into a record so the visualisation can
+     * read `metadata.runtime`. A missing, empty (`{}`), or malformed value yields
+     * `undefined`, which `JSON.stringify` omits — keeping the payload small and
+     * letting un-enriched nodes simply carry no metadata.
+     */
+    private static decodeMetadata;
+    /**
+     * Renders the `window.GRAPH_SOURCE` script that lets the visualisation link
+     * file paths to GitHub. Returns an empty string when `sourceDir` is not a
+     * GitHub work tree, so the page falls back to plain-text file paths.
+     */
+    private static buildSourceScript;
+    /**
+     * Detects the GitHub repository, HEAD commit, and in-repo path prefix for the
+     * directory the graph was extracted from. Returns `undefined` when `sourceDir`
+     * is not a Git work tree, has no GitHub `origin` remote, or Git is unavailable.
+     */
+    private static detectGitHubSource;
+    /**
+     * Normalises a Git `origin` URL to its GitHub web base
+     * (`https://<host>/<owner>/<repo>`), or `undefined` for non-GitHub remotes.
+     * Handles the SCP-like (`git@host:owner/repo.git`), `https://`, `git://`, and
+     * `ssh://` forms, with or without a trailing `.git`. The host is kept as-is so
+     * GitHub Enterprise remotes resolve to their own domain.
+     */
+    static githubBaseUrl(remoteUrl: string): string | undefined;
+    private static handle;
+    private static notFound;
+}
+//# sourceMappingURL=web_command.d.ts.map

package/dist/commands/web_command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web_command.d.ts","sourceRoot":"","sources":["../../src/commands/web_command.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4CpC;;;;;GAKG;AACH,qBAAa,UAAU;IACtB,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;mBAYlB,GAAG;IAoBxB;;;OAGG;mBACkB,eAAe;IAsCpC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAe7B;;;;OAIG;mBACkB,iBAAiB;IAUtC;;;;OAIG;mBACkB,kBAAkB;IAsBvC;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;mBA8BtC,MAAM;IAwB3B,OAAO,CAAC,MAAM,CAAC,QAAQ;CAIvB"}

package/dist/commands/web_command.js

@@ -0,0 +1,226 @@
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { createServer } from 'node:http';
+import { extname, join, normalize, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { promisify } from 'node:util';
+import chalk from 'chalk';
+import { KuzuStore } from '../store/kuzu_store.js';
+import { DEFAULT_DB_PATH } from './command_helpers.js';
+const execFileAsync = promisify(execFile);
+/**
+ * Static assets of the web visualisation, resolved relative to this module so
+ * the same path works from `src/` (tsx) and from `dist/` (published package).
+ */
+const WEB_ROOT = fileURLToPath(new URL('../../contribs/web_visualisation/web', import.meta.url));
+const DATA_SCRIPT_PATH = '/data/graph_data.js';
+const DEFAULT_PORT = '4173';
+const MIME_TYPES = {
+    '.css': 'text/css; charset=utf-8',
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.png': 'image/png',
+    '.svg': 'image/svg+xml',
+};
+/**
+ * `web` command — serves the knowledge graph database in an interactive web
+ * visualisation. The graph is read from Kùzu once at startup and injected into
+ * the page as `/data/graph_data.js`; all other assets are served statically
+ * from the contribs/web_visualisation/web directory.
+ */
+export class WebCommand {
+    static register(program) {
+        program
+            .command('web')
+            .description('serve the knowledge graph database in a web visualisation')
+            .option('-d, --db <path>', 'Kùzu database path', DEFAULT_DB_PATH)
+            .option('-p, --port <port>', 'HTTP port to listen on', DEFAULT_PORT)
+            .option('-s, --source <dir>', 'project root the graph was extracted from, used to link files to GitHub', '.')
+            .action(async (options) => {
+            await WebCommand.run(options);
+        });
+    }
+    static async run(options) {
+        const dbPath = resolve(options.db);
+        if (existsSync(dbPath) === false) {
+            console.error(chalk.red(`database not found at ${dbPath} — run \`extract\` then \`load\` first`));
+            process.exitCode = 1;
+            return;
+        }
+        const sourceScript = await WebCommand.buildSourceScript(resolve(options.source));
+        const dataScript = sourceScript + await WebCommand.buildDataScript(dbPath);
+        const server = createServer((request, response) => {
+            void WebCommand.handle(request, response, dataScript);
+        });
+        server.listen(Number(options.port), () => {
+            console.log(chalk.green(`✓ serving the knowledge graph at http://localhost:${options.port}/`));
+            console.log(chalk.gray('  press Ctrl+C to stop'));
+        });
+    }
+    /**
+     * Reads every node and edge from the database and renders them as the
+     * `window.GRAPH_DATA` script the visualisation page loads on boot.
+     */
+    static async buildDataScript(dbPath) {
+        const store = new KuzuStore(dbPath);
+        await store.initSchema();
+        try {
+            const nodeRows = await store.run('MATCH (n:GraphNode) RETURN n.id AS id, n.kind AS kind, n.name AS name, n.filePath AS filePath, n.exported AS exported, n.startLine AS startLine, n.endLine AS endLine, n.metadata AS metadata');
+            const edgeRows = await store.run('MATCH (f:GraphNode)-[e:Edge]->(t:GraphNode) RETURN f.id AS from, e.kind AS kind, t.id AS to, e.metadata AS metadata');
+            const nodes = nodeRows.map((row) => ({
+                id: String(row.id),
+                kind: String(row.kind),
+                name: String(row.name),
+                filePath: String(row.filePath),
+                exported: row.exported === true,
+                range: {
+                    startLine: Number(row.startLine),
+                    startColumn: 0,
+                    endLine: Number(row.endLine),
+                    endColumn: 0,
+                },
+                metadata: WebCommand.decodeMetadata(row.metadata),
+            }));
+            const edges = edgeRows.map((row, index) => ({
+                id: `e${index}`,
+                kind: String(row.kind),
+                from: String(row.from),
+                to: String(row.to),
+                metadata: WebCommand.decodeMetadata(row.metadata),
+            }));
+            console.log(chalk.cyan(`loaded ${nodes.length} nodes, ${edges.length} edges from ${dbPath}`));
+            return `window.GRAPH_DATA = ${JSON.stringify({ nodes, edges })};\n`;
+        }
+        finally {
+            await store.close();
+        }
+    }
+    /**
+     * Decodes the JSON `metadata` column into a record so the visualisation can
+     * read `metadata.runtime`. A missing, empty (`{}`), or malformed value yields
+     * `undefined`, which `JSON.stringify` omits — keeping the payload small and
+     * letting un-enriched nodes simply carry no metadata.
+     */
+    static decodeMetadata(value) {
+        if (typeof value !== 'string' || value.length === 0) {
+            return undefined;
+        }
+        try {
+            const parsed = JSON.parse(value);
+            if (typeof parsed === 'object' && parsed !== null && Object.keys(parsed).length > 0) {
+                return parsed;
+            }
+            return undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Renders the `window.GRAPH_SOURCE` script that lets the visualisation link
+     * file paths to GitHub. Returns an empty string when `sourceDir` is not a
+     * GitHub work tree, so the page falls back to plain-text file paths.
+     */
+    static async buildSourceScript(sourceDir) {
+        const github = await WebCommand.detectGitHubSource(sourceDir);
+        if (github === undefined) {
+            console.log(chalk.gray('no GitHub remote detected — file paths will not link to source'));
+            return '';
+        }
+        console.log(chalk.cyan(`linking files to ${github.baseUrl} @ ${github.commit.slice(0, 7)}`));
+        return `window.GRAPH_SOURCE = ${JSON.stringify({ github })};\n`;
+    }
+    /**
+     * Detects the GitHub repository, HEAD commit, and in-repo path prefix for the
+     * directory the graph was extracted from. Returns `undefined` when `sourceDir`
+     * is not a Git work tree, has no GitHub `origin` remote, or Git is unavailable.
+     */
+    static async detectGitHubSource(sourceDir) {
+        const git = async (...args) => {
+            try {
+                const { stdout } = await execFileAsync('git', ['-C', sourceDir, ...args]);
+                return stdout.trim();
+            }
+            catch {
+                return undefined;
+            }
+        };
+        if (await git('rev-parse', '--is-inside-work-tree') !== 'true') {
+            return undefined;
+        }
+        const remoteUrl = await git('remote', 'get-url', 'origin');
+        const commit = await git('rev-parse', 'HEAD');
+        const baseUrl = remoteUrl === undefined ? undefined : WebCommand.githubBaseUrl(remoteUrl);
+        if (baseUrl === undefined || commit === undefined) {
+            return undefined;
+        }
+        return { baseUrl, commit, prefix: await git('rev-parse', '--show-prefix') ?? '' };
+    }
+    /**
+     * Normalises a Git `origin` URL to its GitHub web base
+     * (`https://<host>/<owner>/<repo>`), or `undefined` for non-GitHub remotes.
+     * Handles the SCP-like (`git@host:owner/repo.git`), `https://`, `git://`, and
+     * `ssh://` forms, with or without a trailing `.git`. The host is kept as-is so
+     * GitHub Enterprise remotes resolve to their own domain.
+     */
+    static githubBaseUrl(remoteUrl) {
+        const trimmed = remoteUrl.trim();
+        let host;
+        let path;
+        if (trimmed.includes('://') === true) {
+            try {
+                const parsed = new URL(trimmed);
+                host = parsed.host;
+                path = parsed.pathname;
+            }
+            catch {
+                return undefined;
+            }
+        }
+        else {
+            const scpMatch = trimmed.match(/^[^@]+@([^:]+):(.+)$/);
+            if (scpMatch === null) {
+                return undefined;
+            }
+            host = scpMatch[1];
+            path = scpMatch[2];
+        }
+        if (host.toLowerCase().includes('github') === false) {
+            return undefined;
+        }
+        const segments = path.replace(/\.git$/, '').split('/').filter((segment) => segment.length > 0);
+        if (segments.length < 2) {
+            return undefined;
+        }
+        return `https://${host}/${segments[0]}/${segments[1]}`;
+    }
+    static async handle(request, response, dataScript) {
+        const url = new URL(request.url ?? '/', 'http://localhost');
+        const pathname = url.pathname === '/' ? '/index.html' : url.pathname;
+        if (pathname === DATA_SCRIPT_PATH) {
+            response.writeHead(200, { 'content-type': MIME_TYPES['.js'] });
+            response.end(dataScript);
+            return;
+        }
+        const filePath = normalize(join(WEB_ROOT, pathname));
+        if (filePath.startsWith(WEB_ROOT + sep) === false) {
+            WebCommand.notFound(response);
+            return;
+        }
+        try {
+            const content = await readFile(filePath);
+            response.writeHead(200, { 'content-type': MIME_TYPES[extname(filePath)] ?? 'application/octet-stream' });
+            response.end(content);
+        }
+        catch {
+            WebCommand.notFound(response);
+        }
+    }
+    static notFound(response) {
+        response.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' });
+        response.end('not found');
+    }
+}
+//# sourceMappingURL=web_command.js.map

package/dist/commands/web_command.js.map

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

package/dist/commands/who_calls_command.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+export declare class WhoCallsCommand {
+    static register(program: Command): void;
+}
+//# sourceMappingURL=who_calls_command.d.ts.map

package/dist/commands/who_calls_command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"who_calls_command.d.ts","sourceRoot":"","sources":["../../src/commands/who_calls_command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,qBAAa,eAAe;IAC3B,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAIvC"}

package/dist/commands/who_calls_command.js

@@ -0,0 +1,7 @@
+import { CommandHelpers } from './command_helpers.js';
+export class WhoCallsCommand {
+    static register(program) {
+        CommandHelpers.registerSymbolQuery(program, 'who-calls', '<id>', 'list symbols that call <id>', (query, arg) => query.whoCalls(arg));
+    }
+}
+//# sourceMappingURL=who_calls_command.js.map

package/dist/commands/who_calls_command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"who_calls_command.js","sourceRoot":"","sources":["../../src/commands/who_calls_command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,OAAO,eAAe;IAC3B,MAAM,CAAC,QAAQ,CAAC,OAAgB;QAC/B,cAAc,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAC9G,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,CAAC;CACD"}

package/dist/enrich/cpu_profile.d.ts

@@ -0,0 +1,127 @@
+import { z } from 'zod';
+/**
+ * The on-disk shape of a `node --cpu-prof` output (`.cpuprofile`). `samples`
+ * holds one profile-node id per sampling tick; `timeDeltas` holds the elapsed
+ * microseconds preceding each tick. Both are optional because some producers
+ * emit only per-node `hitCount`.
+ */
+export declare const CpuProfileSchema: z.ZodObject<{
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        callFrame: z.ZodObject<{
+            functionName: z.ZodString;
+            scriptId: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            url: z.ZodString;
+            lineNumber: z.ZodNumber;
+            columnNumber: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            functionName: string;
+            url: string;
+            lineNumber: number;
+            columnNumber: number;
+            scriptId?: string | number | undefined;
+        }, {
+            functionName: string;
+            url: string;
+            lineNumber: number;
+            columnNumber: number;
+            scriptId?: string | number | undefined;
+        }>;
+        hitCount: z.ZodOptional<z.ZodNumber>;
+        children: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        id: number;
+        callFrame: {
+            functionName: string;
+            url: string;
+            lineNumber: number;
+            columnNumber: number;
+            scriptId?: string | number | undefined;
+        };
+        hitCount?: number | undefined;
+        children?: number[] | undefined;
+    }, {
+        id: number;
+        callFrame: {
+            functionName: string;
+            url: string;
+            lineNumber: number;
+            columnNumber: number;
+            scriptId?: string | number | undefined;
+        };
+        hitCount?: number | undefined;
+        children?: number[] | undefined;
+    }>, "many">;
+    startTime: z.ZodOptional<z.ZodNumber>;
+    endTime: z.ZodOptional<z.ZodNumber>;
+    samples: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    timeDeltas: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+}, "strip", z.ZodTypeAny, {
+    nodes: {
+        id: number;
+        callFrame: {
+            functionName: string;
+            url: string;
+            lineNumber: number;
+            columnNumber: number;
+            scriptId?: string | number | undefined;
+        };
+        hitCount?: number | undefined;
+        children?: number[] | undefined;
+    }[];
+    startTime?: number | undefined;
+    endTime?: number | undefined;
+    samples?: number[] | undefined;
+    timeDeltas?: number[] | undefined;
+}, {
+    nodes: {
+        id: number;
+        callFrame: {
+            functionName: string;
+            url: string;
+            lineNumber: number;
+            columnNumber: number;
+            scriptId?: string | number | undefined;
+        };
+        hitCount?: number | undefined;
+        children?: number[] | undefined;
+    }[];
+    startTime?: number | undefined;
+    endTime?: number | undefined;
+    samples?: number[] | undefined;
+    timeDeltas?: number[] | undefined;
+}>;
+export type CpuProfileData = z.infer<typeof CpuProfileSchema>;
+/**
+ * One executing location distilled from the profile: its call frame plus the
+ * self time and sample count attributed to it. `line` is converted to the
+ * one-based convention so it can be compared against graph node ranges.
+ */
+export type FrameSample = {
+    functionName: string;
+    url: string;
+    line: number;
+    column: number;
+    samples: number;
+    selfMicros: number;
+};
+export declare class CpuProfile {
+    /**
+     * Parses and validates raw `.cpuprofile` JSON text. Throws a `ZodError` if
+     * the document does not match the V8 profile shape.
+     */
+    static parse(jsonText: string): CpuProfileData;
+    /**
+     * Collapses the profile into one {@link FrameSample} per profile node that
+     * received at least one sample.
+     *
+     * Self time is summed from `timeDeltas`, attributing `timeDeltas[i]` to
+     * `samples[i]` — the standard self-time approximation where total attributed
+     * time equals the sum of all deltas. When `samples`/`timeDeltas` are absent,
+     * it falls back to each node's `hitCount` with zero self time.
+     */
+    static aggregate(profile: CpuProfileData): FrameSample[];
+    /** Total number of sampling ticks in the profile, for coverage reporting. */
+    static totalSamples(profile: CpuProfileData): number;
+}
+//# sourceMappingURL=cpu_profile.d.ts.map

package/dist/enrich/cpu_profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpu_profile.d.ts","sourceRoot":"","sources":["../../src/enrich/cpu_profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsBxB;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM3B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAa,UAAU;IACtB;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc;IAI9C;;;;;;;;OAQG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,WAAW,EAAE;IAyCxD,6EAA6E;IAC7E,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM;CAMpD"}

package/dist/enrich/cpu_profile.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+/**
+ * A single call frame as it appears in a V8 CPU profile node. Line and column
+ * numbers are **zero-based** in the V8 inspector protocol, unlike the one-based
+ * lines ts-morph (and therefore the graph's `range`) uses.
+ */
+const CallFrameSchema = z.object({
+    functionName: z.string(),
+    scriptId: z.union([z.string(), z.number()]).optional(),
+    url: z.string(),
+    lineNumber: z.number(),
+    columnNumber: z.number(),
+});
+const ProfileNodeSchema = z.object({
+    id: z.number(),
+    callFrame: CallFrameSchema,
+    hitCount: z.number().optional(),
+    children: z.array(z.number()).optional(),
+});
+/**
+ * The on-disk shape of a `node --cpu-prof` output (`.cpuprofile`). `samples`
+ * holds one profile-node id per sampling tick; `timeDeltas` holds the elapsed
+ * microseconds preceding each tick. Both are optional because some producers
+ * emit only per-node `hitCount`.
+ */
+export const CpuProfileSchema = z.object({
+    nodes: z.array(ProfileNodeSchema),
+    startTime: z.number().optional(),
+    endTime: z.number().optional(),
+    samples: z.array(z.number()).optional(),
+    timeDeltas: z.array(z.number()).optional(),
+});
+export class CpuProfile {
+    /**
+     * Parses and validates raw `.cpuprofile` JSON text. Throws a `ZodError` if
+     * the document does not match the V8 profile shape.
+     */
+    static parse(jsonText) {
+        return CpuProfileSchema.parse(JSON.parse(jsonText));
+    }
+    /**
+     * Collapses the profile into one {@link FrameSample} per profile node that
+     * received at least one sample.
+     *
+     * Self time is summed from `timeDeltas`, attributing `timeDeltas[i]` to
+     * `samples[i]` — the standard self-time approximation where total attributed
+     * time equals the sum of all deltas. When `samples`/`timeDeltas` are absent,
+     * it falls back to each node's `hitCount` with zero self time.
+     */
+    static aggregate(profile) {
+        const samplesByNode = new Map();
+        const microsByNode = new Map();
+        const samples = profile.samples;
+        if (samples !== undefined && samples.length > 0) {
+            const deltas = profile.timeDeltas ?? [];
+            for (let index = 0; index < samples.length; index += 1) {
+                const nodeId = samples[index];
+                samplesByNode.set(nodeId, (samplesByNode.get(nodeId) ?? 0) + 1);
+                const delta = deltas[index] ?? 0;
+                const safeDelta = delta > 0 ? delta : 0;
+                microsByNode.set(nodeId, (microsByNode.get(nodeId) ?? 0) + safeDelta);
+            }
+        }
+        else {
+            for (const node of profile.nodes) {
+                const hits = node.hitCount ?? 0;
+                if (hits > 0) {
+                    samplesByNode.set(node.id, hits);
+                }
+            }
+        }
+        const frames = [];
+        for (const node of profile.nodes) {
+            const sampleCount = samplesByNode.get(node.id) ?? 0;
+            if (sampleCount === 0) {
+                continue;
+            }
+            frames.push({
+                functionName: node.callFrame.functionName,
+                url: node.callFrame.url,
+                line: node.callFrame.lineNumber + 1,
+                column: node.callFrame.columnNumber,
+                samples: sampleCount,
+                selfMicros: microsByNode.get(node.id) ?? 0,
+            });
+        }
+        return frames;
+    }
+    /** Total number of sampling ticks in the profile, for coverage reporting. */
+    static totalSamples(profile) {
+        if (profile.samples !== undefined && profile.samples.length > 0) {
+            return profile.samples.length;
+        }
+        return profile.nodes.reduce((sum, node) => sum + (node.hitCount ?? 0), 0);
+    }
+}
+//# sourceMappingURL=cpu_profile.js.map

package/dist/enrich/cpu_profile.js.map

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