@lumenflow/metrics 2.2.2 → 2.3.1

package/dist/index.d.ts

@@ -3,6 +3,8 @@
  *
  * DORA/SPACE analytics and flow metrics for LumenFlow workflow framework.
  *
+ * WU-1160: Verified no .mjs references exist in this package.
+ *
  * @module @lumenflow/metrics
  */
 export declare const METRICS_VERSION = "0.1.0";
@@ -10,4 +12,5 @@ export type { DORAStatusTier, WUMetrics, GitCommit, SkipGatesEntry, DeploymentFr
 export { calculateDeploymentFrequency, calculateLeadTime, calculateCFR, calculateMTTR, calculateDORAMetrics, identifyEmergencyFixes, DEPLOYMENT_FREQUENCY, LEAD_TIME_HOURS, CFR_PERCENT, MTTR_HOURS, STATISTICS, } from './dora/index.js';
 export { calculateFlowState, analyzeBottlenecks, criticalPath, impactScore, topologicalSort, getBottleneckAnalysis, generateFlowReport, captureMetricsSnapshot, type DependencyGraph, } from './flow/index.js';
 export { createTelemetryEmitter, TELEMETRY_PATHS, type TelemetryEmitter, } from './telemetry/index.js';
+export { createMethodologyTelemetryEmitter, METHODOLOGY_TELEMETRY_PATHS, isMethodologyTelemetryEnabled, type MethodologyTelemetryEmitter, type MethodologyTelemetryEvent, type MethodologyTelemetryInput, type MethodologyTelemetryConfig, type TestingMethodologyValue, type ArchitectureMethodologyValue, type MethodologyEventContext, } from './methodology-telemetry.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,eAAe,UAAU,CAAC;AAGvC,YAAY,EACV,cAAc,EACd,SAAS,EACT,SAAS,EACT,cAAc,EACd,0BAA0B,EAC1B,eAAe,EACf,wBAAwB,EACxB,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,cAAc,EACd,2BAA2B,EAC3B,8BAA8B,EAC9B,2BAA2B,EAC3B,gBAAgB,EAChB,eAAe,EACf,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,4BAA4B,EAC5B,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,UAAU,EACV,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,eAAe,UAAU,CAAC;AAGvC,YAAY,EACV,cAAc,EACd,SAAS,EACT,SAAS,EACT,cAAc,EACd,0BAA0B,EAC1B,eAAe,EACf,wBAAwB,EACxB,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,cAAc,EACd,2BAA2B,EAC3B,8BAA8B,EAC9B,2BAA2B,EAC3B,gBAAgB,EAChB,eAAe,EACf,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,4BAA4B,EAC5B,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,UAAU,EACV,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,iCAAiC,EACjC,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,GAC7B,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -3,6 +3,8 @@
  *
  * DORA/SPACE analytics and flow metrics for LumenFlow workflow framework.
  *
+ * WU-1160: Verified no .mjs references exist in this package.
+ *
  * @module @lumenflow/metrics
  */
 export const METRICS_VERSION = '0.1.0';
@@ -12,4 +14,6 @@ export { calculateDeploymentFrequency, calculateLeadTime, calculateCFR, calculat
 export { calculateFlowState, analyzeBottlenecks, criticalPath, impactScore, topologicalSort, getBottleneckAnalysis, generateFlowReport, captureMetricsSnapshot, } from './flow/index.js';
 // Telemetry
 export { createTelemetryEmitter, TELEMETRY_PATHS, } from './telemetry/index.js';
+// Methodology Telemetry (WU-1270)
+export { createMethodologyTelemetryEmitter, METHODOLOGY_TELEMETRY_PATHS, isMethodologyTelemetryEnabled, } from './methodology-telemetry.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAoCvC,eAAe;AACf,OAAO,EACL,4BAA4B,EAC5B,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,UAAU,EACV,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,eAAe;AACf,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,GAEvB,MAAM,iBAAiB,CAAC;AAEzB,YAAY;AACZ,OAAO,EACL,sBAAsB,EACtB,eAAe,GAEhB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAoCvC,eAAe;AACf,OAAO,EACL,4BAA4B,EAC5B,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,UAAU,EACV,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,eAAe;AACf,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,GAEvB,MAAM,iBAAiB,CAAC;AAEzB,YAAY;AACZ,OAAO,EACL,sBAAsB,EACtB,eAAe,GAEhB,MAAM,sBAAsB,CAAC;AAE9B,kCAAkC;AAClC,OAAO,EACL,iCAAiC,EACjC,2BAA2B,EAC3B,6BAA6B,GAQ9B,MAAM,4BAA4B,CAAC"}

package/dist/methodology-telemetry.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Methodology Telemetry Module
+ *
+ * WU-1270: Opt-in telemetry for methodology mode tracking.
+ * Captures methodology.testing and methodology.architecture values on wu:spawn.
+ * Privacy-preserving: No PII or project-identifying information collected.
+ *
+ * @module @lumenflow/metrics/methodology-telemetry
+ */
+import type { TelemetryEmitFn } from './types.js';
+/**
+ * Telemetry paths for methodology tracking
+ */
+export declare const METHODOLOGY_TELEMETRY_PATHS: {
+    readonly METHODOLOGY: ".lumenflow/telemetry/methodology.ndjson";
+};
+/**
+ * Testing methodology values (from resolve-policy.ts)
+ */
+export type TestingMethodologyValue = 'tdd' | 'test-after' | 'none';
+/**
+ * Architecture methodology values (from resolve-policy.ts)
+ */
+export type ArchitectureMethodologyValue = 'hexagonal' | 'layered' | 'none';
+/**
+ * Event context indicating where the telemetry was triggered
+ */
+export type MethodologyEventContext = 'spawn';
+/**
+ * Input for methodology telemetry emission
+ *
+ * Note: wuId and lane are accepted as input but NOT emitted
+ * to preserve privacy (no project-identifying information).
+ */
+export interface MethodologyTelemetryInput {
+    /** Testing methodology value */
+    testing: TestingMethodologyValue;
+    /** Architecture methodology value */
+    architecture: ArchitectureMethodologyValue;
+    /** Context in which telemetry was triggered */
+    eventContext: MethodologyEventContext;
+    /** WU ID (not emitted - privacy) */
+    wuId?: string;
+    /** Lane name (not emitted - privacy) */
+    lane?: string;
+}
+/**
+ * Methodology telemetry event structure (emitted to NDJSON)
+ *
+ * Privacy-preserving: Does NOT include:
+ * - WU ID
+ * - Lane name
+ * - Project name
+ * - Any other project-identifying information
+ */
+export interface MethodologyTelemetryEvent {
+    /** ISO timestamp */
+    timestamp: string;
+    /** Event type identifier */
+    event_type: 'methodology.selection';
+    /** Testing methodology value */
+    methodology_testing: TestingMethodologyValue;
+    /** Architecture methodology value */
+    methodology_architecture: ArchitectureMethodologyValue;
+    /** Context where telemetry was triggered */
+    event_context: MethodologyEventContext;
+    /** Index signature for Record compatibility */
+    [key: string]: string;
+}
+/**
+ * Methodology telemetry emitter interface
+ */
+export interface MethodologyTelemetryEmitter {
+    /**
+     * Emit a methodology selection event
+     * @param data - Methodology telemetry input
+     * @param logPath - Optional custom log path
+     */
+    emitMethodologySelection(data: MethodologyTelemetryInput, logPath?: string): void;
+}
+/**
+ * Create a methodology telemetry emitter
+ *
+ * @param emit - Telemetry emit function (writes to NDJSON file)
+ * @returns Methodology telemetry emitter
+ *
+ * @example
+ * ```typescript
+ * import { createMethodologyTelemetryEmitter } from '@lumenflow/metrics/methodology-telemetry';
+ *
+ * const emit = (path: string, event: Record<string, unknown>) => {
+ *   fs.appendFileSync(path, JSON.stringify(event) + '\n');
+ * };
+ *
+ * const emitter = createMethodologyTelemetryEmitter(emit);
+ *
+ * // Emit methodology selection (wuId is NOT included in output)
+ * emitter.emitMethodologySelection({
+ *   testing: 'tdd',
+ *   architecture: 'hexagonal',
+ *   eventContext: 'spawn',
+ *   wuId: 'WU-1270', // Accepted but not emitted
+ * });
+ * ```
+ */
+export declare function createMethodologyTelemetryEmitter(emit: TelemetryEmitFn): MethodologyTelemetryEmitter;
+/**
+ * Configuration structure for methodology telemetry opt-in
+ */
+export interface MethodologyTelemetryConfig {
+    telemetry?: {
+        methodology?: {
+            /** Whether methodology telemetry is enabled (opt-in) */
+            enabled?: boolean;
+        };
+    };
+}
+/**
+ * Check if methodology telemetry is enabled in configuration
+ *
+ * Methodology telemetry is OPT-IN only. Returns false unless
+ * explicitly enabled via config.
+ *
+ * @param config - Configuration object with optional telemetry settings
+ * @returns true if methodology telemetry is enabled
+ *
+ * @example
+ * ```yaml
+ * # .lumenflow.config.yaml
+ * telemetry:
+ *   methodology:
+ *     enabled: true  # Opt-in to methodology tracking
+ * ```
+ */
+export declare function isMethodologyTelemetryEnabled(config: MethodologyTelemetryConfig): boolean;
+//# sourceMappingURL=methodology-telemetry.d.ts.map

package/dist/methodology-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"methodology-telemetry.d.ts","sourceRoot":"","sources":["../src/methodology-telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,2BAA2B;;CAE9B,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,YAAY,GAAG,MAAM,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,gCAAgC;IAChC,OAAO,EAAE,uBAAuB,CAAC;IACjC,qCAAqC;IACrC,YAAY,EAAE,4BAA4B,CAAC;IAC3C,+CAA+C;IAC/C,YAAY,EAAE,uBAAuB,CAAC;IACtC,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,yBAAyB;IACxC,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,UAAU,EAAE,uBAAuB,CAAC;IACpC,gCAAgC;IAChC,mBAAmB,EAAE,uBAAuB,CAAC;IAC7C,qCAAqC;IACrC,wBAAwB,EAAE,4BAA4B,CAAC;IACvD,4CAA4C;IAC5C,aAAa,EAAE,uBAAuB,CAAC;IACvC,+CAA+C;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,wBAAwB,CAAC,IAAI,EAAE,yBAAyB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnF;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,eAAe,GACpB,2BAA2B,CAmB7B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE;YACZ,wDAAwD;YACxD,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;KACH,CAAC;CACH;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAEzF"}

package/dist/methodology-telemetry.js

@@ -0,0 +1,77 @@
+/**
+ * Methodology Telemetry Module
+ *
+ * WU-1270: Opt-in telemetry for methodology mode tracking.
+ * Captures methodology.testing and methodology.architecture values on wu:spawn.
+ * Privacy-preserving: No PII or project-identifying information collected.
+ *
+ * @module @lumenflow/metrics/methodology-telemetry
+ */
+/**
+ * Telemetry paths for methodology tracking
+ */
+export const METHODOLOGY_TELEMETRY_PATHS = {
+    METHODOLOGY: '.lumenflow/telemetry/methodology.ndjson',
+};
+/**
+ * Create a methodology telemetry emitter
+ *
+ * @param emit - Telemetry emit function (writes to NDJSON file)
+ * @returns Methodology telemetry emitter
+ *
+ * @example
+ * ```typescript
+ * import { createMethodologyTelemetryEmitter } from '@lumenflow/metrics/methodology-telemetry';
+ *
+ * const emit = (path: string, event: Record<string, unknown>) => {
+ *   fs.appendFileSync(path, JSON.stringify(event) + '\n');
+ * };
+ *
+ * const emitter = createMethodologyTelemetryEmitter(emit);
+ *
+ * // Emit methodology selection (wuId is NOT included in output)
+ * emitter.emitMethodologySelection({
+ *   testing: 'tdd',
+ *   architecture: 'hexagonal',
+ *   eventContext: 'spawn',
+ *   wuId: 'WU-1270', // Accepted but not emitted
+ * });
+ * ```
+ */
+export function createMethodologyTelemetryEmitter(emit) {
+    return {
+        emitMethodologySelection(data, logPath = METHODOLOGY_TELEMETRY_PATHS.METHODOLOGY) {
+            // Create event WITHOUT project-identifying information
+            // wuId and lane are intentionally NOT included (privacy requirement)
+            const event = {
+                timestamp: new Date().toISOString(),
+                event_type: 'methodology.selection',
+                methodology_testing: data.testing,
+                methodology_architecture: data.architecture,
+                event_context: data.eventContext,
+            };
+            emit(logPath, event);
+        },
+    };
+}
+/**
+ * Check if methodology telemetry is enabled in configuration
+ *
+ * Methodology telemetry is OPT-IN only. Returns false unless
+ * explicitly enabled via config.
+ *
+ * @param config - Configuration object with optional telemetry settings
+ * @returns true if methodology telemetry is enabled
+ *
+ * @example
+ * ```yaml
+ * # .lumenflow.config.yaml
+ * telemetry:
+ *   methodology:
+ *     enabled: true  # Opt-in to methodology tracking
+ * ```
+ */
+export function isMethodologyTelemetryEnabled(config) {
+    return config.telemetry?.methodology?.enabled === true;
+}
+//# sourceMappingURL=methodology-telemetry.js.map

package/dist/methodology-telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methodology-telemetry.js","sourceRoot":"","sources":["../src/methodology-telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,WAAW,EAAE,yCAAyC;CAC9C,CAAC;AAwEX;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,iCAAiC,CAC/C,IAAqB;IAErB,OAAO;QACL,wBAAwB,CACtB,IAA+B,EAC/B,UAAkB,2BAA2B,CAAC,WAAW;YAEzD,uDAAuD;YACvD,qEAAqE;YACrE,MAAM,KAAK,GAA8B;gBACvC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,UAAU,EAAE,uBAAuB;gBACnC,mBAAmB,EAAE,IAAI,CAAC,OAAO;gBACjC,wBAAwB,EAAE,IAAI,CAAC,YAAY;gBAC3C,aAAa,EAAE,IAAI,CAAC,YAAY;aACjC,CAAC;YAEF,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC;AAcD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAAkC;IAC9E,OAAO,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;AACzD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/metrics",
-  "version": "2.2.2",
+  "version": "2.3.1",
   "description": "DORA/SPACE analytics and flow metrics for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",