@gracker/smartperfetto 1.0.13

package/dist/services/multiTraceComparisonStore.js

@@ -0,0 +1,220 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiTraceComparisonRunRepository = void 0;
+exports.createMultiTraceComparisonRunRepository = createMultiTraceComparisonRunRepository;
+const crypto_1 = __importDefault(require("crypto"));
+const multiTraceComparison_1 = require("../types/multiTraceComparison");
+const enterpriseAuditService_1 = require("./enterpriseAuditService");
+function parseJson(value, fallback) {
+    if (!value)
+        return fallback;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return fallback;
+    }
+}
+function mapRun(row, inputRows) {
+    const orderedInputs = [...inputRows].sort((a, b) => a.ordinal - b.ordinal);
+    return {
+        id: row.id,
+        tenantId: row.tenant_id,
+        workspaceId: row.workspace_id,
+        ...(row.created_by ? { createdBy: row.created_by } : {}),
+        inputSnapshotIds: orderedInputs.map(input => input.snapshot_id),
+        ...(row.baseline_snapshot_id ? { baselineSnapshotId: row.baseline_snapshot_id } : {}),
+        query: row.query,
+        status: row.status,
+        ...(row.result_json ? { result: parseJson(row.result_json, undefined) } : {}),
+        ...(row.report_id ? { reportId: row.report_id } : {}),
+        ...(row.error ? { error: row.error } : {}),
+        schemaVersion: row.schema_version,
+        createdAt: row.created_at,
+        ...(row.completed_at ? { completedAt: row.completed_at } : {}),
+    };
+}
+function uniqueSnapshotIds(baselineSnapshotId, candidates) {
+    const seen = new Set();
+    const ids = [];
+    for (const id of [baselineSnapshotId, ...candidates]) {
+        const normalized = id?.trim();
+        if (!normalized || seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        ids.push(normalized);
+    }
+    return ids;
+}
+class MultiTraceComparisonRunRepository {
+    constructor(db) {
+        this.db = db;
+    }
+    createRun(scope, input) {
+        const now = Date.now();
+        const id = input.id || crypto_1.default.randomUUID();
+        const baselineSnapshotId = input.baselineSnapshotId?.trim() || undefined;
+        const inputSnapshotIds = uniqueSnapshotIds(baselineSnapshotId, input.candidateSnapshotIds);
+        if (inputSnapshotIds.length < 2) {
+            throw new Error('comparison run requires at least two snapshots');
+        }
+        const write = this.db.transaction(() => {
+            this.db.prepare(`
+        INSERT INTO multi_trace_comparison_runs
+          (id, tenant_id, workspace_id, created_by, baseline_snapshot_id,
+           query, status, result_json, report_id, error, schema_version,
+           created_at, completed_at)
+        VALUES
+          (@id, @tenantId, @workspaceId, @createdBy, @baselineSnapshotId,
+           @query, @status, NULL, NULL, NULL, @schemaVersion, @createdAt, NULL)
+      `).run({
+                id,
+                tenantId: scope.tenantId,
+                workspaceId: scope.workspaceId,
+                createdBy: scope.userId ?? null,
+                baselineSnapshotId: baselineSnapshotId ?? null,
+                query: input.query,
+                status: input.status ?? 'pending',
+                schemaVersion: multiTraceComparison_1.MULTI_TRACE_COMPARISON_RUN_SCHEMA_VERSION,
+                createdAt: now,
+            });
+            const insertInput = this.db.prepare(`
+        INSERT INTO multi_trace_comparison_inputs
+          (comparison_id, snapshot_id, role, ordinal)
+        VALUES
+          (@comparisonId, @snapshotId, @role, @ordinal)
+      `);
+            inputSnapshotIds.forEach((snapshotId, ordinal) => {
+                insertInput.run({
+                    comparisonId: id,
+                    snapshotId,
+                    role: snapshotId === baselineSnapshotId ? 'baseline' : 'candidate',
+                    ordinal,
+                });
+            });
+            (0, enterpriseAuditService_1.recordEnterpriseAuditEvent)(this.db, {
+                tenantId: scope.tenantId,
+                workspaceId: scope.workspaceId,
+                actorUserId: scope.userId,
+                action: 'comparison.created',
+                resourceType: 'multi_trace_comparison_run',
+                resourceId: id,
+                metadata: {
+                    baselineSnapshotId: baselineSnapshotId ?? null,
+                    inputSnapshotCount: inputSnapshotIds.length,
+                    status: input.status ?? 'pending',
+                },
+            });
+        });
+        write();
+        const run = this.getRun(scope, id);
+        if (!run) {
+            throw new Error('Failed to persist comparison run');
+        }
+        return run;
+    }
+    getRun(scope, comparisonId) {
+        const row = this.db.prepare(`
+      SELECT *
+      FROM multi_trace_comparison_runs
+      WHERE tenant_id = @tenantId
+        AND workspace_id = @workspaceId
+        AND id = @comparisonId
+        AND (created_by = @userId OR created_by IS NULL)
+      LIMIT 1
+    `).get({
+            tenantId: scope.tenantId,
+            workspaceId: scope.workspaceId,
+            userId: scope.userId ?? null,
+            comparisonId,
+        });
+        if (!row)
+            return null;
+        const inputRows = this.db.prepare(`
+      SELECT snapshot_id, role, ordinal
+      FROM multi_trace_comparison_inputs
+      WHERE comparison_id = ?
+      ORDER BY ordinal ASC
+    `).all(row.id);
+        return mapRun(row, inputRows);
+    }
+    updateRun(scope, comparisonId, input) {
+        const completedAt = input.completedAt
+            ?? (['completed', 'failed', 'needs_selection'].includes(input.status)
+                ? Date.now()
+                : null);
+        const resultJson = input.result ? JSON.stringify(input.result) : null;
+        const hasBaselineSnapshotId = input.baselineSnapshotId !== undefined;
+        const update = this.db.transaction(() => {
+            const result = this.db.prepare(`
+        UPDATE multi_trace_comparison_runs
+        SET status = @status,
+            baseline_snapshot_id = CASE
+              WHEN @hasBaselineSnapshotId = 1 THEN @baselineSnapshotId
+              ELSE baseline_snapshot_id
+            END,
+            result_json = @resultJson,
+            report_id = @reportId,
+            error = @error,
+            completed_at = @completedAt
+        WHERE tenant_id = @tenantId
+          AND workspace_id = @workspaceId
+          AND id = @comparisonId
+          AND (created_by = @userId OR created_by IS NULL)
+      `).run({
+                tenantId: scope.tenantId,
+                workspaceId: scope.workspaceId,
+                userId: scope.userId ?? null,
+                comparisonId,
+                status: input.status,
+                hasBaselineSnapshotId: hasBaselineSnapshotId ? 1 : 0,
+                baselineSnapshotId: input.baselineSnapshotId ?? null,
+                resultJson,
+                reportId: input.reportId ?? null,
+                error: input.error ?? null,
+                completedAt,
+            });
+            if (result.changes > 0 && hasBaselineSnapshotId) {
+                this.db.prepare(`
+          UPDATE multi_trace_comparison_inputs
+          SET role = CASE
+            WHEN snapshot_id = @baselineSnapshotId THEN 'baseline'
+            ELSE 'candidate'
+          END
+          WHERE comparison_id = @comparisonId
+        `).run({
+                    comparisonId,
+                    baselineSnapshotId: input.baselineSnapshotId,
+                });
+            }
+            return result;
+        })();
+        if (update.changes === 0)
+            return null;
+        (0, enterpriseAuditService_1.recordEnterpriseAuditEvent)(this.db, {
+            tenantId: scope.tenantId,
+            workspaceId: scope.workspaceId,
+            actorUserId: scope.userId,
+            action: 'comparison.updated',
+            resourceType: 'multi_trace_comparison_run',
+            resourceId: comparisonId,
+            metadata: {
+                status: input.status,
+                baselineSnapshotId: input.baselineSnapshotId ?? null,
+                reportId: input.reportId ?? null,
+            },
+        });
+        return this.getRun(scope, comparisonId);
+    }
+}
+exports.MultiTraceComparisonRunRepository = MultiTraceComparisonRunRepository;
+function createMultiTraceComparisonRunRepository(db) {
+    return new MultiTraceComparisonRunRepository(db);
+}
+//# sourceMappingURL=multiTraceComparisonStore.js.map

package/dist/services/multiTraceComparisonStore.js.map

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

package/dist/services/oemSdkKnowledgeIngester.d.ts

@@ -0,0 +1,62 @@
+import type { RagStore } from './ragStore';
+export interface OemSdkDocument {
+    /** Vendor identifier — `mtk`, `qualcomm`, `samsung`, etc. */
+    vendor: string;
+    /** Document path or url, e.g. `tuning/cpu-freq-floor.md`. */
+    docPath: string;
+    /** Markdown / plain-text content. */
+    content: string;
+    /** Approximate epoch-ms timestamp when the doc was captured. */
+    fetchedAt: number;
+    /** License — `proprietary` is typical; explicit non-empty string
+     *  required. */
+    license: string;
+    /** Optional title; falls back to last path segment. */
+    title?: string;
+    /** Optional author / curator. */
+    author?: string;
+}
+export interface OemSdkFetcher {
+    fetchDocs(opts?: {
+        vendor?: string;
+    }): Promise<OemSdkDocument[]>;
+}
+export interface OemSdkIngestOptions {
+    /** Maximum characters per chunk. Defaults to 1500 (matches blog). */
+    maxChunkChars?: number;
+    /** Restrict to a vendor (forwarded to fetcher). */
+    vendor?: string;
+}
+export interface OemSdkIngestError {
+    vendor: string;
+    docPath: string;
+    reason: string;
+}
+export interface OemSdkIngestResult {
+    docsProcessed: number;
+    chunksAdded: number;
+    chunksSkipped: number;
+    errors: OemSdkIngestError[];
+}
+/** Compose a stable URI from vendor + docPath so retrieval can
+ * filter by vendor via prefix match. */
+declare function uriFor(vendor: string, docPath: string): string;
+declare function makeChunkId(uri: string, offset: number): string;
+/** Paragraph-based chunker; same shape as the blog ingester's. */
+declare function chunkText(text: string, maxChars: number): Array<{
+    text: string;
+    offset: number;
+}>;
+export declare class OemSdkKnowledgeIngester {
+    private readonly store;
+    private readonly fetcher;
+    constructor(store: RagStore, fetcher: OemSdkFetcher);
+    ingest(opts?: OemSdkIngestOptions): Promise<OemSdkIngestResult>;
+}
+export declare const __TEST_ONLY__: {
+    chunkText: typeof chunkText;
+    makeChunkId: typeof makeChunkId;
+    uriFor: typeof uriFor;
+};
+export {};
+//# sourceMappingURL=oemSdkKnowledgeIngester.d.ts.map

package/dist/services/oemSdkKnowledgeIngester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oemSdkKnowledgeIngester.d.ts","sourceRoot":"","sources":["../../src/services/oemSdkKnowledgeIngester.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAGzC,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB;oBACgB;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,IAAI,CAAC,EAAE;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,mBAAmB;IAClC,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAID;wCACwC;AACxC,iBAAS,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,iBAAS,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKxD;AAMD,kEAAkE;AAClE,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAAC,CA0BxF;AAED,qBAAa,uBAAuB;IAEhC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,aAAa;IAGnC,MAAM,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAuE1E;AAED,eAAO,MAAM,aAAa;;;;CAAmC,CAAC"}

package/dist/services/oemSdkKnowledgeIngester.js

@@ -0,0 +1,154 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__TEST_ONLY__ = exports.OemSdkKnowledgeIngester = void 0;
+/**
+ * OemSdkKnowledgeIngester — pulls vendor-published SDK / tuning
+ * docs and writes them to a `RagStore` under the `oem_sdk` source
+ * kind. Plan 55 M2 entry layer.
+ *
+ * Like AOSP, OEM SDK docs require an explicit license string at
+ * ingestion. Unlike AOSP, the typical license is `proprietary` —
+ * the agent must surface "source unavailable" if license policy
+ * later blocks retrieval (§5.2 contract).
+ *
+ * M2 scope:
+ * - Pluggable fetcher; production wiring is operator-driven (the
+ *   admin route lets curators upload pre-redacted vendor docs).
+ * - Markdown / plain-text ingestion only for M2. PDF parsing is
+ *   intentionally out of scope — operators should pre-extract.
+ * - vendor field carried on every chunk via a deterministic
+ *   `vendor::path` URI prefix so retrieval can scope by vendor.
+ *
+ * @module oemSdkKnowledgeIngester
+ */
+const crypto_1 = require("crypto");
+const DEFAULT_MAX_CHUNK_CHARS = 1500;
+/** Compose a stable URI from vendor + docPath so retrieval can
+ * filter by vendor via prefix match. */
+function uriFor(vendor, docPath) {
+    return `oem://${vendor}/${docPath.replace(/^\//, '')}`;
+}
+function makeChunkId(uri, offset) {
+    return (0, crypto_1.createHash)('sha256')
+        .update(`${uri}|${offset}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+function estimateTokenCount(text) {
+    return Math.max(1, Math.round(text.length / 4));
+}
+/** Paragraph-based chunker; same shape as the blog ingester's. */
+function chunkText(text, maxChars) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return [];
+    const paragraphs = trimmed
+        .split(/\n\s*\n+/)
+        .map(p => p.trim())
+        .filter(p => p.length > 0);
+    const out = [];
+    let cursor = 0;
+    let buf = '';
+    let bufStart = 0;
+    for (const p of paragraphs) {
+        if (buf.length === 0) {
+            buf = p;
+            bufStart = cursor;
+        }
+        else if (buf.length + 2 + p.length <= maxChars) {
+            buf += '\n\n' + p;
+        }
+        else {
+            out.push({ text: buf, offset: bufStart });
+            buf = p;
+            bufStart = cursor;
+        }
+        cursor += p.length + 2;
+    }
+    if (buf.length > 0)
+        out.push({ text: buf, offset: bufStart });
+    return out;
+}
+class OemSdkKnowledgeIngester {
+    constructor(store, fetcher) {
+        this.store = store;
+        this.fetcher = fetcher;
+    }
+    async ingest(opts = {}) {
+        const maxChars = opts.maxChunkChars ?? DEFAULT_MAX_CHUNK_CHARS;
+        const result = {
+            docsProcessed: 0,
+            chunksAdded: 0,
+            chunksSkipped: 0,
+            errors: [],
+        };
+        let docs;
+        try {
+            docs = await this.fetcher.fetchDocs({ vendor: opts.vendor });
+        }
+        catch (err) {
+            result.errors.push({
+                vendor: '<fetcher>',
+                docPath: '<fetcher>',
+                reason: err instanceof Error ? err.message : String(err),
+            });
+            return result;
+        }
+        for (const doc of docs) {
+            result.docsProcessed++;
+            if (!doc.license || doc.license.trim().length === 0) {
+                result.errors.push({
+                    vendor: doc.vendor,
+                    docPath: doc.docPath,
+                    reason: 'license required for kind=oem_sdk; entry rejected',
+                });
+                result.chunksSkipped++;
+                continue;
+            }
+            if (!doc.vendor || doc.vendor.trim().length === 0) {
+                result.errors.push({
+                    vendor: '<missing>',
+                    docPath: doc.docPath,
+                    reason: 'vendor field required',
+                });
+                result.chunksSkipped++;
+                continue;
+            }
+            try {
+                const uri = uriFor(doc.vendor, doc.docPath);
+                const packed = chunkText(doc.content, maxChars);
+                for (const p of packed) {
+                    const chunk = {
+                        chunkId: makeChunkId(uri, p.offset),
+                        kind: 'oem_sdk',
+                        uri,
+                        title: doc.title ?? doc.docPath.split('/').pop(),
+                        snippet: p.text,
+                        tokenCount: estimateTokenCount(p.text),
+                        license: doc.license,
+                        indexedAt: doc.fetchedAt,
+                        verifiedAt: doc.fetchedAt,
+                        author: doc.author,
+                    };
+                    this.store.addChunk(chunk);
+                    result.chunksAdded++;
+                }
+            }
+            catch (err) {
+                result.errors.push({
+                    vendor: doc.vendor,
+                    docPath: doc.docPath,
+                    reason: err instanceof Error ? err.message : String(err),
+                });
+                result.chunksSkipped++;
+            }
+        }
+        return result;
+    }
+}
+exports.OemSdkKnowledgeIngester = OemSdkKnowledgeIngester;
+exports.__TEST_ONLY__ = { chunkText, makeChunkId, uriFor };
+//# sourceMappingURL=oemSdkKnowledgeIngester.js.map

package/dist/services/oemSdkKnowledgeIngester.js.map

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

package/dist/services/perfettoLocalService.d.ts

@@ -0,0 +1,25 @@
+import { EventEmitter } from 'events';
+export interface PerfettoServerStatus {
+    running: boolean;
+    port?: number;
+    pid?: number;
+    traceFile?: string;
+    uptime?: number;
+}
+export declare class PerfettoLocalService extends EventEmitter {
+    private process;
+    private port;
+    private traceProcessorPath;
+    private currentTraceFile;
+    private startTime;
+    constructor();
+    startServer(traceFile?: string): Promise<PerfettoServerStatus>;
+    stopServer(): Promise<void>;
+    loadTrace(traceFile: string): Promise<PerfettoServerStatus>;
+    getStatus(): PerfettoServerStatus;
+    private findAvailablePort;
+    get getPort(): number;
+    get getTraceProcessorUrl(): string;
+}
+export declare const perfettoLocalService: PerfettoLocalService;
+//# sourceMappingURL=perfettoLocalService.d.ts.map

package/dist/services/perfettoLocalService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perfettoLocalService.d.ts","sourceRoot":"","sources":["../../src/services/perfettoLocalService.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAKtC,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,SAAS,CAAuB;;IAgBlC,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAyF9D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B3B,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAajE,SAAS,IAAI,oBAAoB;YAanB,iBAAiB;IAoB/B,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,oBAAoB,IAAI,MAAM,CAEjC;CACF;AAGD,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}