@opensip-cli/checks-typescript 0.1.0

package/dist/checks/quality/observability/observability-coverage/__tests__/logger-detector.test.js

@@ -0,0 +1,94 @@
+/**
+ * @fileoverview Direct unit tests for the observability-coverage logger
+ * detector helper module.
+ *
+ * Exercises:
+ *   - logger.* / this.logger.* / direct logToFitnessFile/logToCLIFile detection
+ *   - line-range filtering (out-of-range calls are excluded)
+ *   - non-logger property access calls (e.g., db.info) are ignored
+ *   - fileImportsLogger over import-path patterns and direct identifiers
+ */
+import { describe, expect, it } from 'vitest';
+import { detectLoggerCalls, fileImportsLogger } from '../logger-detector.js';
+describe('logger-detector — detectLoggerCalls', () => {
+    it('returns an empty array when the source has no parseable AST', () => {
+        // Empty path yields a falsy SourceFile from getSharedSourceFile in some
+        // configurations; even when it parses, an empty body has no calls.
+        expect(detectLoggerCalls('', 'empty.ts', 1, 5)).toEqual([]);
+    });
+    it('detects bare-identifier logger calls (logger.info)', () => {
+        const src = `
+      export function f() {
+        logger.info({ msg: 'hi' })
+      }
+    `;
+        const calls = detectLoggerCalls(src, 'a.ts', 1, 10);
+        expect(calls).toHaveLength(1);
+        expect(calls[0]?.level).toBe('info');
+    });
+    it('detects this.logger.* calls inside class methods', () => {
+        const src = `
+      export class S {
+        run() {
+          this.logger.warn({ msg: 'hi' })
+          this.logger.error('boom')
+        }
+      }
+    `;
+        const calls = detectLoggerCalls(src, 'class.ts', 1, 20);
+        expect(calls.map((c) => c.level).sort()).toEqual(['error', 'warn']);
+    });
+    it('excludes calls outside the requested line range', () => {
+        const src = [
+            'function a() {', // line 1
+            '  logger.info({ msg: 1 })', // line 2  (in range)
+            '}', // line 3
+            'function b() {', // line 4
+            '  logger.warn({ msg: 2 })', // line 5  (out of range)
+            '}', // line 6
+        ].join('\n');
+        const calls = detectLoggerCalls(src, 'range.ts', 1, 3);
+        expect(calls).toHaveLength(1);
+        expect(calls[0]?.level).toBe('info');
+    });
+    it('detects logToFitnessFile / logToCLIFile direct calls', () => {
+        const src = `
+      logToFitnessFile({ msg: 'a' })
+      logToCLIFile({ msg: 'b' })
+    `;
+        const calls = detectLoggerCalls(src, 'direct.ts', 1, 10);
+        expect(calls).toHaveLength(2);
+        // Direct calls are normalized to 'info' level.
+        expect(calls.every((c) => c.level === 'info')).toBe(true);
+    });
+    it('does not match non-logger property access calls', () => {
+        const src = `
+      const db = { info(_: unknown) {}, warn(_: unknown) {} }
+      db.info({ msg: 'no' })
+      db.warn({ msg: 'no' })
+    `;
+        expect(detectLoggerCalls(src, 'no.ts', 1, 10)).toEqual([]);
+    });
+    it('ignores property-access calls whose method is not a known logger level', () => {
+        const src = `
+      logger.trace({ msg: 'unknown level' })
+      logger.fatal({ msg: 'unknown level' })
+    `;
+        // Detector recognizes only info/warn/error/debug.
+        expect(detectLoggerCalls(src, 'level.ts', 1, 10)).toEqual([]);
+    });
+});
+describe('logger-detector — fileImportsLogger', () => {
+    it('detects import-from-/logger paths', () => {
+        expect(fileImportsLogger(`import { logger } from '@some/pkg/logger'`)).toBe(true);
+        expect(fileImportsLogger(`import x from '../utils/logger'`)).toBe(true);
+    });
+    it('detects logToFitnessFile / logToCLIFile direct identifier usage', () => {
+        expect(fileImportsLogger('export const f = () => logToFitnessFile({})')).toBe(true);
+        expect(fileImportsLogger('export const g = () => logToCLIFile({})')).toBe(true);
+    });
+    it('returns false when neither pattern is present', () => {
+        expect(fileImportsLogger("import x from 'react'\nexport const x = 1")).toBe(false);
+    });
+});
+//# sourceMappingURL=logger-detector.test.js.map

package/dist/checks/quality/observability/observability-coverage/__tests__/logger-detector.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-detector.test.js","sourceRoot":"","sources":["../../../../../../src/checks/quality/observability/observability-coverage/__tests__/logger-detector.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE7E,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,wEAAwE;QACxE,mEAAmE;QACnE,MAAM,CAAC,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,GAAG,GAAG;;;;KAIX,CAAC;QACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG;;;;;;;KAOX,CAAC;QACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,GAAG,GAAG;YACV,gBAAgB,EAAE,SAAS;YAC3B,2BAA2B,EAAE,qBAAqB;YAClD,GAAG,EAAE,SAAS;YACd,gBAAgB,EAAE,SAAS;YAC3B,2BAA2B,EAAE,yBAAyB;YACtD,GAAG,EAAE,SAAS;SACf,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,GAAG,GAAG;;;KAGX,CAAC;QACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,+CAA+C;QAC/C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,GAAG,GAAG;;;;KAIX,CAAC;QACF,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,GAAG,GAAG;;;KAGX,CAAC;QACF,kDAAkD;QAClD,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,iBAAiB,CAAC,2CAA2C,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClF,MAAM,CAAC,iBAAiB,CAAC,iCAAiC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,CAAC,iBAAiB,CAAC,6CAA6C,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpF,MAAM,CAAC,iBAAiB,CAAC,yCAAyC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,iBAAiB,CAAC,2CAA2C,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/checks/quality/observability/observability-coverage/analyzer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview AST function extractor for observability coverage analysis
+ */
+import type { FunctionInfo } from './types.js';
+/**
+ * Extract functions, arrow functions, class methods, and constructors from
+ * TypeScript source code using the raw compiler API.
+ *
+ * This module only performs AST extraction. Logger detection is handled
+ * separately by the logger-detector module.
+ */
+export declare function extractFunctions(content: string, filePath: string): FunctionInfo[];
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/checks/quality/observability/observability-coverage/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../../../../src/checks/quality/observability/observability-coverage/analyzer.ts"],"names":[],"mappings":"AACA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAyE/C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CA8ClF"}

package/dist/checks/quality/observability/observability-coverage/analyzer.js

@@ -0,0 +1,117 @@
+// @fitness-ignore-file fitness-check-architecture -- Helper module for observability-coverage check, not a standalone check
+/**
+ * @fileoverview AST function extractor for observability coverage analysis
+ */
+import { getSharedSourceFile, isAsync } from '@opensip-cli/lang-typescript';
+import * as ts from 'typescript';
+/**
+ * Recursively walk a subtree looking for a TryStatement.
+ */
+function containsTryCatch(node) {
+    if (ts.isTryStatement(node)) {
+        return true;
+    }
+    let found = false;
+    node.forEachChild((child) => {
+        if (!found && containsTryCatch(child)) {
+            found = true;
+        }
+    });
+    return found;
+}
+/**
+ * Check whether a node is a getter or setter accessor.
+ */
+function isAccessor(node) {
+    return ts.isGetAccessorDeclaration(node) || ts.isSetAccessorDeclaration(node);
+}
+/**
+ * Check whether a function-like node has a body.
+ * Abstract methods, overload signatures, and interface method signatures have no body.
+ */
+function hasBody(node) {
+    if (ts.isFunctionDeclaration(node) || ts.isMethodDeclaration(node)) {
+        return node.body !== undefined;
+    }
+    /* v8 ignore next -- defensive AST/type guard */
+    if (ts.isArrowFunction(node) || ts.isFunctionExpression(node)) {
+        return true;
+    }
+    if (ts.isConstructorDeclaration(node)) {
+        return node.body !== undefined;
+    }
+    return false;
+}
+/**
+ * Build a FunctionInfo from a function-like AST node.
+ */
+function buildFunctionInfo(name, node, body, sourceFile, filePath) {
+    const startPos = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+    const endPos = sourceFile.getLineAndCharacterOfPosition(node.getEnd());
+    const startLine = startPos.line + 1;
+    const endLine = endPos.line + 1;
+    return {
+        name,
+        filePath,
+        startLine,
+        endLine,
+        lineCount: endLine - startLine + 1,
+        isAsync: isAsync(node),
+        hasTryCatch: containsTryCatch(body),
+        hasLogging: false,
+        loggerCalls: [],
+    };
+}
+/**
+ * Extract functions, arrow functions, class methods, and constructors from
+ * TypeScript source code using the raw compiler API.
+ *
+ * This module only performs AST extraction. Logger detection is handled
+ * separately by the logger-detector module.
+ */
+export function extractFunctions(content, filePath) {
+    const parsed = getSharedSourceFile(filePath, content);
+    /* v8 ignore next -- defensive AST/type guard */
+    if (!parsed)
+        return [];
+    const sourceFile = parsed;
+    const functions = [];
+    function resolveFunctionExpressionName(node) {
+        if (ts.isVariableDeclaration(node.parent)) {
+            return node.parent.name.getText(sourceFile);
+        }
+        if (ts.isPropertyAssignment(node.parent)) {
+            return node.parent.name.getText(sourceFile);
+        }
+        /* v8 ignore next -- defensive AST/type guard */
+        if (ts.isFunctionExpression(node) && node.name) {
+            return node.name.getText(sourceFile);
+        }
+        return '<anonymous>';
+    }
+    function visit(node) {
+        // Skip getters and setters explicitly
+        if (isAccessor(node)) {
+            return;
+        }
+        if (ts.isFunctionDeclaration(node) && hasBody(node) && node.body) {
+            const name = node.name?.getText(sourceFile) ?? '<anonymous>';
+            functions.push(buildFunctionInfo(name, node, node.body, sourceFile, filePath));
+        }
+        else if (ts.isArrowFunction(node) || ts.isFunctionExpression(node)) {
+            const name = resolveFunctionExpressionName(node);
+            functions.push(buildFunctionInfo(name, node, node.body, sourceFile, filePath));
+        }
+        else if (ts.isConstructorDeclaration(node) && hasBody(node) && node.body) {
+            functions.push(buildFunctionInfo('constructor', node, node.body, sourceFile, filePath));
+        }
+        else if (ts.isMethodDeclaration(node) && hasBody(node) && node.body) {
+            const name = node.name.getText(sourceFile);
+            functions.push(buildFunctionInfo(name, node, node.body, sourceFile, filePath));
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return functions;
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/checks/quality/observability/observability-coverage/analyzer.js.map

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

package/dist/checks/quality/observability/observability-coverage/index.d.ts

@@ -0,0 +1,4 @@
+export * from './analyzer.js';
+export * from './logger-detector.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/checks/quality/observability/observability-coverage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/checks/quality/observability/observability-coverage/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC"}

package/dist/checks/quality/observability/observability-coverage/index.js

@@ -0,0 +1,4 @@
+export * from './analyzer.js';
+export * from './logger-detector.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/checks/quality/observability/observability-coverage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/checks/quality/observability/observability-coverage/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC"}

package/dist/checks/quality/observability/observability-coverage/logger-detector.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Logger call detector for observability coverage analysis
+ */
+import type { LoggerCall } from './types.js';
+/**
+ * Detect logger calls within a specific line range of a source file.
+ *
+ * Walks the AST looking for:
+ * - Property access calls like `logger.info(...)`, `logger.warn(...)`, etc.
+ * - Direct calls to `logToFitnessFile(...)` or `logToCLIFile(...)`
+ *
+ * @param content - Full source file content
+ * @param filePath - Path to the source file (used for AST parsing)
+ * @param startLine - 1-indexed start line of the range to inspect
+ * @param endLine - 1-indexed end line of the range to inspect
+ * @returns Array of detected logger calls within the given line range
+ */
+export declare function detectLoggerCalls(content: string, filePath: string, startLine: number, endLine: number): LoggerCall[];
+/**
+ * Check whether a file imports a logger.
+ *
+ * Looks for imports from a structured logger module,
+ * imports of `logToFitnessFile`, or imports of `logToCLIFile`.
+ *
+ * @param content - Full source file content
+ * @returns True if the file imports a logger, false otherwise
+ */
+export declare function fileImportsLogger(content: string): boolean;
+//# sourceMappingURL=logger-detector.d.ts.map

package/dist/checks/quality/observability/observability-coverage/logger-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-detector.d.ts","sourceRoot":"","sources":["../../../../../src/checks/quality/observability/observability-coverage/logger-detector.ts"],"names":[],"mappings":"AACA;;GAEG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,UAAU,EAAE,CAyBd;AAyED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAM1D"}

package/dist/checks/quality/observability/observability-coverage/logger-detector.js

@@ -0,0 +1,111 @@
+// @fitness-ignore-file fitness-check-architecture -- Helper module for observability-coverage check, not a standalone check
+/**
+ * @fileoverview Logger call detector for observability coverage analysis
+ */
+import { getSharedSourceFile } from '@opensip-cli/lang-typescript';
+import * as ts from 'typescript';
+/** Logger method names we recognize as logging calls */
+const LOGGER_METHODS = new Set(['info', 'warn', 'error', 'debug']);
+/**
+ * Detect logger calls within a specific line range of a source file.
+ *
+ * Walks the AST looking for:
+ * - Property access calls like `logger.info(...)`, `logger.warn(...)`, etc.
+ * - Direct calls to `logToFitnessFile(...)` or `logToCLIFile(...)`
+ *
+ * @param content - Full source file content
+ * @param filePath - Path to the source file (used for AST parsing)
+ * @param startLine - 1-indexed start line of the range to inspect
+ * @param endLine - 1-indexed end line of the range to inspect
+ * @returns Array of detected logger calls within the given line range
+ */
+export function detectLoggerCalls(content, filePath, startLine, endLine) {
+    const sourceFile = getSharedSourceFile(filePath, content);
+    /* v8 ignore next -- defensive guard */
+    if (!sourceFile)
+        return [];
+    // Local non-nullable alias so the nested `visit` function declaration —
+    // which TypeScript treats as hoisted and therefore non-narrowing — can
+    // still see a non-null SourceFile.
+    const sf = sourceFile;
+    const calls = [];
+    function visit(node) {
+        if (ts.isCallExpression(node)) {
+            const call = extractLoggerCall(node, sf, startLine, endLine);
+            if (call) {
+                calls.push(call);
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    ts.forEachChild(sf, visit);
+    return calls;
+}
+/**
+ * Check whether an expression resolves to a logger instance.
+ *
+ * Matches:
+ * - `logger`          (bare identifier)
+ * - `this.logger`     (class instance property)
+ */
+function isLoggerReceiver(node) {
+    // logger.info(...)
+    if (ts.isIdentifier(node) && node.text === 'logger') {
+        return true;
+    }
+    // this.logger.info(...)
+    if (ts.isPropertyAccessExpression(node) &&
+        node.expression.kind === ts.SyntaxKind.ThisKeyword &&
+        node.name.text === 'logger') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Extract a LoggerCall from a call expression if it matches our patterns.
+ *
+ * @returns A LoggerCall if the node is a recognized logger call within range, or undefined
+ */
+function extractLoggerCall(node, sourceFile, startLine, endLine) {
+    // @fitness-ignore-next-line null-safety -- getLineAndCharacterOfPosition always returns a valid {line, character} object
+    const lineNumber = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile)).line + 1;
+    if (lineNumber < startLine || lineNumber > endLine) {
+        return undefined;
+    }
+    // Check for property access calls: logger.info(...), this.logger.warn(...), etc.
+    if (ts.isPropertyAccessExpression(node.expression)) {
+        const propertyAccess = node.expression;
+        // @fitness-ignore-next-line null-safety -- ts.isPropertyAccessExpression guarantees .name is a valid Identifier node
+        const methodName = propertyAccess.name.text;
+        if (LOGGER_METHODS.has(methodName) && isLoggerReceiver(propertyAccess.expression)) {
+            return {
+                line: lineNumber,
+                level: methodName,
+            };
+        }
+    }
+    // Check for direct calls: logToFitnessFile(...), logToCLIFile(...)
+    if (ts.isIdentifier(node.expression) &&
+        (node.expression.text === 'logToFitnessFile' || node.expression.text === 'logToCLIFile')) {
+        return {
+            line: lineNumber,
+            level: 'info',
+        };
+    }
+    return undefined;
+}
+/**
+ * Check whether a file imports a logger.
+ *
+ * Looks for imports from a structured logger module,
+ * imports of `logToFitnessFile`, or imports of `logToCLIFile`.
+ *
+ * @param content - Full source file content
+ * @returns True if the file imports a logger, false otherwise
+ */
+export function fileImportsLogger(content) {
+    return (/(?:\/logger['"]|from\s+['"][^'"]*logger)/.test(content) ||
+        content.includes('logToFitnessFile') ||
+        content.includes('logToCLIFile'));
+}
+//# sourceMappingURL=logger-detector.js.map

package/dist/checks/quality/observability/observability-coverage/logger-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-detector.js","sourceRoot":"","sources":["../../../../../src/checks/quality/observability/observability-coverage/logger-detector.ts"],"names":[],"mappings":"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"}

package/dist/checks/quality/observability/observability-coverage/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Type definitions for observability coverage analysis
+ */
+/**
+ * Detected logger call within a function body.
+ */
+export interface LoggerCall {
+    /** 1-indexed line number */
+    readonly line: number;
+    /** Logger level (info, warn, error, debug) */
+    readonly level: 'info' | 'warn' | 'error' | 'debug';
+}
+/**
+ * Information about an extracted function from the AST.
+ */
+export interface FunctionInfo {
+    /** Function name (or '<anonymous>' for unnamed functions) */
+    readonly name: string;
+    /** Absolute file path */
+    readonly filePath: string;
+    /** 1-indexed start line */
+    readonly startLine: number;
+    /** 1-indexed end line */
+    readonly endLine: number;
+    /** Total lines of code in the function body */
+    readonly lineCount: number;
+    /** Whether the function is async */
+    readonly isAsync: boolean;
+    /** Whether the function contains a try/catch block */
+    readonly hasTryCatch: boolean;
+    /** Whether any logger calls were detected */
+    readonly hasLogging: boolean;
+    /** List of detected logger calls */
+    readonly loggerCalls: readonly LoggerCall[];
+}
+/**
+ * Aggregate coverage result across all analyzed files.
+ */
+export interface CoverageResult {
+    /** Total number of functions that require logging */
+    readonly totalFunctions: number;
+    /** Number of functions that have at least one logger call */
+    readonly functionsWithLogging: number;
+    /** Coverage percentage (0-100) */
+    readonly coveragePercent: number;
+    /** Functions that require logging but don't have it */
+    readonly unloggedFunctions: readonly FunctionInfo[];
+}
+/**
+ * Inline configuration for the observability coverage check.
+ */
+export interface CoverageConfig {
+    /** Minimum lines of code for a function to require logging */
+    readonly minLinesForLogging: number;
+    /** Whether async functions require logging (subject to minLinesForAsyncLogging) */
+    readonly requireLoggingInAsync: boolean;
+    /** Minimum lines for an async function to require logging (avoids flagging trivial async wrappers) */
+    readonly minLinesForAsyncLogging: number;
+    /** Whether functions with try/catch always require logging regardless of line count */
+    readonly requireLoggingInTryCatch: boolean;
+    /** Minimum coverage percentage before the check reports errors (vs warnings) */
+    readonly minCoveragePercent: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/checks/quality/observability/observability-coverage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/checks/quality/observability/observability-coverage/types.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2BAA2B;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,kCAAkC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,uDAAuD;IACvD,QAAQ,CAAC,iBAAiB,EAAE,SAAS,YAAY,EAAE,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,mFAAmF;IACnF,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,sGAAsG;IACtG,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,uFAAuF;IACvF,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;IAC3C,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC"}

package/dist/checks/quality/observability/observability-coverage/types.js

@@ -0,0 +1,6 @@
+// @fitness-ignore-file fitness-check-architecture -- Type definitions for observability-coverage check, not a standalone check
+/**
+ * @fileoverview Type definitions for observability coverage analysis
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/checks/quality/observability/observability-coverage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/checks/quality/observability/observability-coverage/types.ts"],"names":[],"mappings":"AAAA,+HAA+H;AAC/H;;GAEG"}

package/dist/checks/quality/observability/pii-exposure-in-logs.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview PII Exposure in Logs Check
+ *
+ * Uses AST analysis to detect PII exposure in log statements.
+ * Walks call expressions to find logger.info/warn/error/debug/trace/fatal calls,
+ * then inspects arguments for PII field names. AST context eliminates false
+ * positives from PII field names in non-log contexts (type definitions,
+ * variable names, string constants).
+ *
+ * @see Logging Standards
+ */
+/**
+ * Check: quality/pii-exposure-in-logs
+ *
+ * Detects potential PII exposure in log statements using AST analysis.
+ * Walks call expressions to find logger calls, then inspects arguments
+ * for PII field names in object literals.
+ *
+ * @see Logging Standards
+ */
+export declare const piiExposureInLogs: import("@opensip-cli/fitness").Check;
+//# sourceMappingURL=pii-exposure-in-logs.d.ts.map

package/dist/checks/quality/observability/pii-exposure-in-logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pii-exposure-in-logs.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/observability/pii-exposure-in-logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqJH;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,sCA8D5B,CAAC"}