@angriff36/manifest 2.18.0

package/dist/manifest/profiling.js

@@ -0,0 +1,186 @@
+/**
+ * Performance profiling instrumentation for Manifest runtime engine.
+ *
+ * Records timing data for each execution phase to enable performance analysis
+ * and flame graph visualization in diagnostic tools.
+ */
+/**
+ * A collector that accumulates timing data during command execution.
+ * Instances are created per-command and attached to the execution context.
+ */
+export class ProfileCollector {
+    phases = [];
+    startTime = 0;
+    commandStartTime = 0;
+    currentPhaseStart = new Map();
+    slowestExpression;
+    /** Start a new command profiling session */
+    start(startTime) {
+        this.commandStartTime = startTime;
+        this.startTime = performance.now();
+        this.phases = [];
+        this.currentPhaseStart.clear();
+        this.slowestExpression = undefined;
+    }
+    /** Mark the start of a phase */
+    startPhase(phase) {
+        this.currentPhaseStart.set(phase, performance.now());
+    }
+    /** Mark the end of a phase and record its timing */
+    endPhase(phase, metadata, children) {
+        const phaseStart = this.currentPhaseStart.get(phase);
+        if (phaseStart === undefined) {
+            console.warn(`ProfileCollector: endPhase called without startPhase for ${phase}`);
+            return;
+        }
+        const now = performance.now();
+        const duration = now - phaseStart;
+        const startOffset = phaseStart - this.startTime;
+        const endOffset = now - this.startTime;
+        this.phases.push({
+            phase,
+            duration,
+            startOffset,
+            endOffset,
+            children,
+            metadata,
+        });
+        // Track slowest expression if metadata includes expression info
+        if (metadata?.expression && duration > 0) {
+            if (!this.slowestExpression || duration > this.slowestExpression.duration) {
+                this.slowestExpression = {
+                    phase,
+                    expression: metadata.expression,
+                    duration,
+                };
+            }
+        }
+        this.currentPhaseStart.delete(phase);
+    }
+    /** Complete profiling and return the final profile data */
+    complete(commandName, entityName, instanceId, success, entityGraphSize, instancesLoaded) {
+        const endTime = performance.now();
+        const totalDuration = endTime - this.startTime;
+        return {
+            entityName,
+            commandName,
+            instanceId,
+            totalDuration,
+            startTime: this.commandStartTime,
+            endTime: this.commandStartTime + totalDuration,
+            success,
+            phases: [...this.phases],
+            slowestExpression: this.slowestExpression,
+            entityGraphSize,
+            instancesLoaded,
+        };
+    }
+    /** Get current phase timing data (for intermediate reporting) */
+    getPhases() {
+        return this.phases;
+    }
+    /** Get the current elapsed time since profiling started */
+    getElapsed() {
+        return performance.now() - this.startTime;
+    }
+}
+/**
+ * Aggregate multiple command profiles into a summary.
+ */
+export function summarizeProfiles(profiles) {
+    if (profiles.length === 0) {
+        return {
+            totalCommands: 0,
+            totalDuration: 0,
+            averageDuration: 0,
+            slowestCommand: { commandName: 'N/A', duration: 0 },
+            fastestCommand: { commandName: 'N/A', duration: 0 },
+            phaseStats: new Map(),
+            slowestCommands: [],
+        };
+    }
+    const totalDuration = profiles.reduce((sum, p) => sum + p.totalDuration, 0);
+    const averageDuration = totalDuration / profiles.length;
+    // Find slowest and fastest
+    let slowest = profiles[0];
+    let fastest = profiles[0];
+    for (const profile of profiles) {
+        if (profile.totalDuration > slowest.totalDuration)
+            slowest = profile;
+        if (profile.totalDuration < fastest.totalDuration)
+            fastest = profile;
+    }
+    // Aggregate per-phase stats
+    const phaseStats = new Map();
+    const phaseTotals = new Map();
+    for (const profile of profiles) {
+        for (const phase of profile.phases) {
+            const existing = phaseTotals.get(phase.phase) || { total: 0, count: 0 };
+            existing.total += phase.duration;
+            existing.count += 1;
+            phaseTotals.set(phase.phase, existing);
+        }
+    }
+    for (const [phase, data] of phaseTotals.entries()) {
+        phaseStats.set(phase, {
+            totalDuration: data.total,
+            averageDuration: data.total / data.count,
+            maxDuration: Math.max(...profiles.flatMap(p => p.phases.filter(ph => ph.phase === phase).map(ph => ph.duration))),
+            percentOfTotal: (data.total / totalDuration) * 100,
+            executionCount: data.count,
+        });
+    }
+    // Sort commands by duration (slowest first)
+    const slowestCommands = [...profiles]
+        .sort((a, b) => b.totalDuration - a.totalDuration)
+        .slice(0, 10)
+        .map(p => ({
+        commandName: p.commandName,
+        entityName: p.entityName,
+        duration: p.totalDuration,
+    }));
+    return {
+        totalCommands: profiles.length,
+        totalDuration,
+        averageDuration,
+        slowestCommand: {
+            commandName: slowest.commandName,
+            entityName: slowest.entityName,
+            duration: slowest.totalDuration,
+        },
+        fastestCommand: {
+            commandName: fastest.commandName,
+            entityName: fastest.entityName,
+            duration: fastest.totalDuration,
+        },
+        phaseStats,
+        slowestCommands,
+    };
+}
+/**
+ * Convert profile data to a flame graph format suitable for visualization.
+ * Returns a hierarchical structure with phases and children.
+ */
+export function toFlameGraph(profile) {
+    const root = {
+        name: profile.entityName
+            ? `${profile.entityName}.${profile.commandName}`
+            : profile.commandName,
+        value: profile.totalDuration,
+        phase: 'total',
+        children: profile.phases.map(phase => ({
+            name: phase.phase,
+            value: phase.duration,
+            phase: phase.phase,
+            children: phase.children?.map(child => ({
+                name: child.metadata?.name || child.phase,
+                value: child.duration,
+                phase: child.phase,
+                metadata: child.metadata,
+            })) || [],
+            metadata: phase.metadata,
+        })),
+    };
+    return root;
+}
+//# sourceMappingURL=profiling.js.map

package/dist/manifest/profiling.js.map

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

package/dist/manifest/projections/analytics/generator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Analytics projection for Manifest IR.
+ *
+ * Generates typed analytics event schemas for Segment, Amplitude, Mixpanel,
+ * or Snowplow from IR command executions and entity state changes.
+ *
+ * Surfaces:
+ *   - analytics.tracking-plan → JSON tracking plan document (all events with schemas)
+ *   - analytics.events        → TypeScript typed event interfaces and a track() function
+ *   - analytics.handlers      → Typed analytics.track() calls injected into command handlers
+ *
+ * The tracking plan follows the Segment/Tracking Plan spec format so it can
+ * be consumed by any provider's schema validation tooling.
+ */
+import type { IR } from '../../ir';
+import type { ProjectionTarget, ProjectionRequest, ProjectionResult } from '../interface';
+export declare const SURFACE_TRACKING_PLAN: "analytics.tracking-plan";
+export declare const SURFACE_EVENTS: "analytics.events";
+export declare const SURFACE_HANDLERS: "analytics.handlers";
+export declare const SURFACES: readonly ["analytics.tracking-plan", "analytics.events", "analytics.handlers"];
+export declare class AnalyticsProjection implements ProjectionTarget {
+    readonly name = "analytics";
+    readonly description = "Typed analytics event schemas and track() calls for Segment, Amplitude, Mixpanel, or Snowplow";
+    readonly surfaces: readonly ["analytics.tracking-plan", "analytics.events", "analytics.handlers"];
+    generate(ir: IR, request: ProjectionRequest): ProjectionResult;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/manifest/projections/analytics/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/analytics/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,EAAE,EAIH,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,cAAc,CAAC;AAUtB,eAAO,MAAM,qBAAqB,EAAG,yBAAkC,CAAC;AACxE,eAAO,MAAM,cAAc,EAAG,kBAA2B,CAAC;AAC1D,eAAO,MAAM,gBAAgB,EAAG,oBAA6B,CAAC;AAC9D,eAAO,MAAM,QAAQ,gFAIX,CAAC;AAyvBX,qBAAa,mBAAoB,YAAW,gBAAgB;IAC1D,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,mGAC8E;IAClG,QAAQ,CAAC,QAAQ,iFAAY;IAE7B,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB;CAiD/D"}