@skastr0/pulsar-ts-pack 0.1.0

package/dist/signals/ts-ld-07-classification.js

@@ -0,0 +1,164 @@
+import { ts } from "ts-morph";
+import { compilerPropertyNameText as propertyNameText } from "./shared-compiler-functions.js";
+import { collectLocalExportedNames, isBoundaryDeclaration, isBoundaryFunctionOwner, isBoundaryParameter, isBoundaryProperty, isBoundaryVariable, isReturnTypeOwner, isWithinExportedTypeSurface, } from "./ts-ld-07-boundary.js";
+const BASE_WEIGHT_BY_KIND = {
+    parameter: 3,
+    return: 3,
+    property: 2.5,
+    variable: 2,
+    "type-alias": 2.5,
+    assertion: 2,
+    heritage: 2,
+    unknown: 1,
+};
+const BOUNDARY_MULTIPLIER = 2;
+export const collectUnsafeTypeOccurrences = (sourceFile) => {
+    const compilerSourceFile = sourceFile.compilerNode;
+    const exportedNames = collectLocalExportedNames(compilerSourceFile);
+    const occurrences = [];
+    const visit = (node) => {
+        if (node.kind === ts.SyntaxKind.AnyKeyword) {
+            const classified = classifyAnyKeyword(node, compilerSourceFile, exportedNames);
+            const line = compilerSourceFile.getLineAndCharacterOfPosition(node.getStart(compilerSourceFile)).line + 1;
+            const baseWeight = unsafeTypeWeight(classified.kind, classified.boundary);
+            occurrences.push({
+                ...classified,
+                findingId: unsafeTypeFindingId(line, classified.kind, classified.target),
+                line,
+                severity: classified.boundary ? "warn" : "info",
+                visible: true,
+                baseWeight,
+                weight: baseWeight,
+            });
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(compilerSourceFile);
+    return occurrences;
+};
+const classifyAnyKeyword = (node, sourceFile, exportedNames) => {
+    let current = node.parent;
+    while (current !== undefined && current !== sourceFile) {
+        const classified = classifyAnyKeywordAncestor(current, node, sourceFile, exportedNames);
+        if (classified !== undefined)
+            return classified;
+        current = current.parent;
+    }
+    return {
+        kind: "unknown",
+        target: "<unknown>",
+        boundary: false,
+    };
+};
+const classifyAnyKeywordAncestor = (current, node, sourceFile, exportedNames) => classifyAnyAssertion(current, sourceFile) ??
+    classifyAnyParameter(current, sourceFile, exportedNames) ??
+    classifyAnyReturn(current, node, sourceFile, exportedNames) ??
+    classifyAnyProperty(current, exportedNames) ??
+    classifyAnyVariable(current, sourceFile, exportedNames) ??
+    classifyAnyTypeAlias(current, exportedNames) ??
+    classifyAnyHeritage(current, sourceFile, exportedNames);
+const classifyAnyAssertion = (current, sourceFile) => ts.isAsExpression(current) || ts.isTypeAssertionExpression(current)
+    ? {
+        kind: "assertion",
+        target: assertionTargetName(current, sourceFile),
+        boundary: false,
+    }
+    : undefined;
+const classifyAnyParameter = (current, sourceFile, exportedNames) => ts.isParameter(current)
+    ? {
+        kind: "parameter",
+        target: parameterName(current, sourceFile),
+        boundary: isBoundaryParameter(current, exportedNames),
+    }
+    : undefined;
+const classifyAnyReturn = (current, node, sourceFile, exportedNames) => isReturnTypeOwner(current) && current.type !== undefined && isAncestorOf(current.type, node)
+    ? {
+        kind: "return",
+        target: functionLikeName(current, sourceFile),
+        boundary: isBoundaryFunctionOwner(current, exportedNames),
+    }
+    : undefined;
+const classifyAnyProperty = (current, exportedNames) => ts.isPropertySignature(current) || ts.isPropertyDeclaration(current)
+    ? {
+        kind: "property",
+        target: propertyNameText(current.name),
+        boundary: isBoundaryProperty(current, exportedNames),
+    }
+    : undefined;
+const classifyAnyVariable = (current, sourceFile, exportedNames) => ts.isVariableDeclaration(current)
+    ? {
+        kind: "variable",
+        target: current.name.getText(sourceFile),
+        boundary: isBoundaryVariable(current, exportedNames),
+    }
+    : undefined;
+const classifyAnyTypeAlias = (current, exportedNames) => ts.isTypeAliasDeclaration(current)
+    ? {
+        kind: "type-alias",
+        target: current.name.text,
+        boundary: isBoundaryDeclaration(current, exportedNames),
+    }
+    : undefined;
+const classifyAnyHeritage = (current, sourceFile, exportedNames) => ts.isHeritageClause(current)
+    ? {
+        kind: "heritage",
+        target: heritageOwnerName(current, sourceFile),
+        boundary: isWithinExportedTypeSurface(current, exportedNames),
+    }
+    : undefined;
+const isAncestorOf = (ancestor, node) => {
+    let current = node;
+    while (current !== undefined) {
+        if (current === ancestor)
+            return true;
+        current = current.parent;
+    }
+    return false;
+};
+const parameterName = (parameter, sourceFile) => parameter.name.getText(sourceFile);
+const functionLikeName = (owner, sourceFile) => {
+    if (ts.isFunctionDeclaration(owner) || ts.isFunctionExpression(owner)) {
+        return owner.name?.text ?? "<anonymous>";
+    }
+    if (ts.isMethodDeclaration(owner) || ts.isMethodSignature(owner)) {
+        return propertyNameText(owner.name);
+    }
+    if (ts.isArrowFunction(owner) || ts.isFunctionTypeNode(owner)) {
+        return nearestNamedDeclaration(owner, sourceFile) ?? "<anonymous>";
+    }
+    if (ts.isCallSignatureDeclaration(owner)) {
+        return nearestNamedDeclaration(owner, sourceFile) ?? "<call signature>";
+    }
+    return nearestNamedDeclaration(owner, sourceFile) ?? "<construct signature>";
+};
+const nearestNamedDeclaration = (node, sourceFile) => {
+    let current = node.parent;
+    while (current !== undefined && current !== sourceFile) {
+        if (ts.isVariableDeclaration(current))
+            return current.name.getText(sourceFile);
+        if (ts.isTypeAliasDeclaration(current) ||
+            ts.isInterfaceDeclaration(current) ||
+            ts.isClassDeclaration(current)) {
+            return current.name?.text;
+        }
+        if (ts.isPropertyAssignment(current) || ts.isPropertySignature(current)) {
+            return current.name.getText(sourceFile);
+        }
+        current = current.parent;
+    }
+    return undefined;
+};
+const assertionTargetName = (assertion, sourceFile) => {
+    const expression = assertion.expression;
+    if (ts.isIdentifier(expression) || ts.isPropertyAccessExpression(expression)) {
+        return expression.getText(sourceFile);
+    }
+    return "<expression>";
+};
+const heritageOwnerName = (clause, sourceFile) => nearestNamedDeclaration(clause, sourceFile) ?? "<heritage>";
+const unsafeTypeWeight = (kind, boundary) => {
+    const base = BASE_WEIGHT_BY_KIND[kind];
+    return boundary ? base * BOUNDARY_MULTIPLIER : base;
+};
+const unsafeTypeFindingId = (line, kind, target) => `${line}:${kind}:${target}`;
+//# sourceMappingURL=ts-ld-07-classification.js.map

package/dist/signals/ts-ld-07-classification.js.map

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

package/dist/signals/ts-ld-07-output.d.ts

@@ -0,0 +1,8 @@
+import { type SourceFile } from "ts-morph";
+import type { CalibrationDecision } from "@skastr0/pulsar-core/calibration";
+import type { TsLd07Config, TsLd07Output, UnsafeTypeFileSummary, UnsafeTypeOccurrence } from "./ts-ld-07-unsafe-type-erosion.js";
+export declare const buildUnsafeTypeOutput: (byFile: ReadonlyMap<string, UnsafeTypeFileSummary>, occurrences: ReadonlyArray<UnsafeTypeOccurrence>, analyzedFiles: number, analyzedLines: number, config: TsLd07Config, calibrationDecisions?: ReadonlyArray<CalibrationDecision>) => TsLd07Output;
+export declare const summarizeFileOccurrences: (occurrences: ReadonlyArray<UnsafeTypeOccurrence>) => UnsafeTypeFileSummary;
+export declare const countNonEmptyLines: (sourceFile: SourceFile) => number;
+export declare const compareUnsafeOccurrences: (left: UnsafeTypeOccurrence, right: UnsafeTypeOccurrence) => number;
+//# sourceMappingURL=ts-ld-07-output.d.ts.map

package/dist/signals/ts-ld-07-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-ld-07-output.d.ts","sourceRoot":"","sources":["../../src/signals/ts-ld-07-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAC3E,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,mCAAmC,CAAA;AAE1C,eAAO,MAAM,qBAAqB,GAChC,QAAQ,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,EAClD,aAAa,aAAa,CAAC,oBAAoB,CAAC,EAChD,eAAe,MAAM,EACrB,eAAe,MAAM,EACrB,QAAQ,YAAY,EACpB,uBAAsB,aAAa,CAAC,mBAAmB,CAAM,KAC5D,YA+BF,CAAA;AAED,eAAO,MAAM,wBAAwB,GACnC,aAAa,aAAa,CAAC,oBAAoB,CAAC,KAC/C,qBAQD,CAAA;AAEF,eAAO,MAAM,kBAAkB,GAAI,YAAY,UAAU,KAAG,MAC0B,CAAA;AAEtF,eAAO,MAAM,wBAAwB,GACnC,MAAM,oBAAoB,EAC1B,OAAO,oBAAoB,KAC1B,MAMF,CAAA"}

package/dist/signals/ts-ld-07-output.js

@@ -0,0 +1,44 @@
+export const buildUnsafeTypeOutput = (byFile, occurrences, analyzedFiles, analyzedLines, config, calibrationDecisions = []) => {
+    const weightedUnsafe = occurrences.reduce((sum, occurrence) => sum + occurrence.weight, 0);
+    const boundaryOccurrences = occurrences.filter((occurrence) => occurrence.boundary).length;
+    const boundaryWeightedUnsafe = occurrences.reduce((sum, occurrence) => sum + (occurrence.boundary ? occurrence.weight : 0), 0);
+    const analyzedKloc = Math.max(1, analyzedLines / 1000);
+    const densityPerKloc = weightedUnsafe / analyzedKloc;
+    return {
+        byFile,
+        occurrences,
+        topOccurrences: occurrences.slice(0, config.top_n_diagnostics),
+        calibrationDecisions,
+        totalOccurrences: occurrences.length,
+        boundaryOccurrences,
+        weightedUnsafe,
+        boundaryWeightedUnsafe,
+        analyzedFiles,
+        analyzedLines,
+        densityPerKloc,
+        densityPressure: thresholdPressure(densityPerKloc, config.max_weighted_unsafe_per_kloc),
+        boundaryPressure: thresholdPressure(boundaryWeightedUnsafe, config.max_boundary_weighted_unsafe),
+        densityThreshold: config.max_weighted_unsafe_per_kloc,
+        boundaryThreshold: config.max_boundary_weighted_unsafe,
+        diagnosticLimit: config.top_n_diagnostics,
+    };
+};
+export const summarizeFileOccurrences = (occurrences) => ({
+    occurrences: occurrences.length,
+    boundaryOccurrences: occurrences.filter((occurrence) => occurrence.boundary).length,
+    weightedUnsafe: occurrences.reduce((sum, occurrence) => sum + occurrence.weight, 0),
+    boundaryWeightedUnsafe: occurrences.reduce((sum, occurrence) => sum + (occurrence.boundary ? occurrence.weight : 0), 0),
+});
+export const countNonEmptyLines = (sourceFile) => sourceFile.getFullText().split(/\r?\n/u).filter((line) => line.trim() !== "").length;
+export const compareUnsafeOccurrences = (left, right) => {
+    if (left.boundary !== right.boundary)
+        return left.boundary ? -1 : 1;
+    const byWeight = right.weight - left.weight;
+    if (byWeight !== 0)
+        return byWeight;
+    if (left.file !== right.file)
+        return left.file.localeCompare(right.file);
+    return left.line - right.line;
+};
+const thresholdPressure = (value, threshold) => threshold <= 0 ? 0 : value / threshold;
+//# sourceMappingURL=ts-ld-07-output.js.map

package/dist/signals/ts-ld-07-output.js.map

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

package/dist/signals/ts-ld-07-unsafe-type-erosion.d.ts

@@ -0,0 +1,52 @@
+import type { Signal } from "@skastr0/pulsar-core/signal";
+import type { CalibrationDecision } from "@skastr0/pulsar-core/calibration";
+import { Schema } from "effect";
+import { TsProjectTag } from "../ts-project.js";
+declare const TsLd07Config: Schema.Struct<{
+    exclude_globs: Schema.Array$<typeof Schema.String>;
+    max_weighted_unsafe_per_kloc: typeof Schema.Number;
+    max_boundary_weighted_unsafe: typeof Schema.Number;
+    top_n_diagnostics: typeof Schema.Number;
+}>;
+export type TsLd07Config = typeof TsLd07Config.Type;
+export type UnsafeTypeKind = "parameter" | "return" | "property" | "variable" | "type-alias" | "assertion" | "heritage" | "unknown";
+export interface UnsafeTypeOccurrence {
+    readonly findingId: string;
+    readonly file: string;
+    readonly line: number;
+    readonly kind: UnsafeTypeKind;
+    readonly target: string;
+    readonly boundary: boolean;
+    readonly severity: "info" | "warn" | "block";
+    readonly visible: boolean;
+    readonly baseWeight: number;
+    readonly weight: number;
+    readonly policyDecisions?: ReadonlyArray<CalibrationDecision>;
+}
+export interface UnsafeTypeFileSummary {
+    readonly occurrences: number;
+    readonly boundaryOccurrences: number;
+    readonly weightedUnsafe: number;
+    readonly boundaryWeightedUnsafe: number;
+}
+export interface TsLd07Output {
+    readonly byFile: ReadonlyMap<string, UnsafeTypeFileSummary>;
+    readonly occurrences: ReadonlyArray<UnsafeTypeOccurrence>;
+    readonly topOccurrences: ReadonlyArray<UnsafeTypeOccurrence>;
+    readonly calibrationDecisions: ReadonlyArray<CalibrationDecision>;
+    readonly totalOccurrences: number;
+    readonly boundaryOccurrences: number;
+    readonly weightedUnsafe: number;
+    readonly boundaryWeightedUnsafe: number;
+    readonly analyzedFiles: number;
+    readonly analyzedLines: number;
+    readonly densityPerKloc: number;
+    readonly densityPressure: number;
+    readonly boundaryPressure: number;
+    readonly densityThreshold: number;
+    readonly boundaryThreshold: number;
+    readonly diagnosticLimit: number;
+}
+export declare const TsLd07: Signal<TsLd07Config, TsLd07Output, TsProjectTag>;
+export {};
+//# sourceMappingURL=ts-ld-07-unsafe-type-erosion.d.ts.map

package/dist/signals/ts-ld-07-unsafe-type-erosion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-ld-07-unsafe-type-erosion.d.ts","sourceRoot":"","sources":["../../src/signals/ts-ld-07-unsafe-type-erosion.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAErE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAC3E,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAG/C,QAAA,MAAM,YAAY;;;;;EAKhB,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAEnD,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,QAAQ,GACR,UAAU,GACV,UAAU,GACV,YAAY,GACZ,WAAW,GACX,UAAU,GACV,SAAS,CAAA;AAEb,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;CAC9D;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAA;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;IAC3D,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;IACzD,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;IAC5D,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IACjE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAA;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CACjC;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAsFnE,CAAA"}

package/dist/signals/ts-ld-07-unsafe-type-erosion.js

@@ -0,0 +1,96 @@
+import { SignalComputeError } from "@skastr0/pulsar-core/signal";
+import { CalibrationContextTag } from "@skastr0/pulsar-core/calibration";
+import { Effect, Schema } from "effect";
+import { TsProjectTag } from "../ts-project.js";
+import { computeUnsafeTypeErosionOutput } from "./ts-ld-07-analysis.js";
+const TsLd07Config = Schema.Struct({
+    exclude_globs: Schema.Array(Schema.String),
+    max_weighted_unsafe_per_kloc: Schema.Number,
+    max_boundary_weighted_unsafe: Schema.Number,
+    top_n_diagnostics: Schema.Number,
+});
+export const TsLd07 = {
+    id: "TS-LD-07-unsafe-type-erosion",
+    title: "Unsafe type erosion",
+    aliases: ["TS-LD-07"],
+    tier: 1,
+    category: "legibility-decay",
+    kind: "legibility",
+    configSchema: TsLd07Config,
+    defaultConfig: {
+        exclude_globs: [
+            "**/*.test.ts",
+            "**/*.test.tsx",
+            "**/*.spec.ts",
+            "**/*.spec.tsx",
+            "**/*.stories.ts",
+            "**/*.stories.tsx",
+            "**/*.d.ts",
+            "**/node_modules/**",
+            "**/dist/**",
+            "**/build/**",
+            "**/coverage/**",
+            "**/.turbo/**",
+            "**/vendor/**",
+            "**/gen/**",
+            "**/generated/**",
+            "**/*.gen.ts",
+            "**/*.gen.tsx",
+            "**/*.generated.ts",
+            "**/*.generated.tsx",
+            "**/__tests__/**",
+            "**/test/**",
+            "**/tests/**",
+        ],
+        max_weighted_unsafe_per_kloc: 10,
+        max_boundary_weighted_unsafe: 48,
+        top_n_diagnostics: 10,
+    },
+    configDirections: {
+        max_weighted_unsafe_per_kloc: "higher-is-looser",
+        max_boundary_weighted_unsafe: "higher-is-looser",
+    },
+    inputs: [],
+    compute: (config) => Effect.gen(function* () {
+        const project = yield* TsProjectTag;
+        const calibration = yield* Effect.serviceOption(CalibrationContextTag);
+        const result = yield* Effect.try({
+            try: () => project.getSourceFiles(),
+            catch: (cause) => new SignalComputeError({
+                signalId: "TS-LD-07-unsafe-type-erosion",
+                message: String(cause),
+                cause,
+            }),
+        });
+        const output = yield* computeUnsafeTypeErosionOutput(result, config, calibration).pipe(Effect.mapError((cause) => new SignalComputeError({
+            signalId: "TS-LD-07-unsafe-type-erosion",
+            message: String(cause),
+            cause,
+        })));
+        return output;
+    }),
+    score: (out) => {
+        if (out.totalOccurrences === 0)
+            return 1;
+        const pressure = Math.max(out.densityPressure, out.boundaryPressure);
+        return 1 / (1 + pressure);
+    },
+    diagnose: (out) => out.topOccurrences.map((occurrence) => ({
+        severity: occurrence.severity,
+        message: `Unsafe \`any\` in ${occurrence.boundary ? "boundary " : ""}` +
+            `${unsafeKindLabel(occurrence.kind)} \`${occurrence.target}\``,
+        location: { file: occurrence.file, line: occurrence.line },
+        data: {
+            ...occurrence,
+            densityPerKloc: out.densityPerKloc,
+            densityThreshold: out.densityThreshold,
+            boundaryThreshold: out.boundaryThreshold,
+        },
+    })),
+};
+const unsafeKindLabel = (kind) => {
+    if (kind === "type-alias")
+        return "type alias";
+    return kind;
+};
+//# sourceMappingURL=ts-ld-07-unsafe-type-erosion.js.map

package/dist/signals/ts-ld-07-unsafe-type-erosion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-ld-07-unsafe-type-erosion.js","sourceRoot":"","sources":["../../src/signals/ts-ld-07-unsafe-type-erosion.ts"],"names":[],"mappings":"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"}

package/dist/signals/ts-rp-01-hotspot-model.d.ts

@@ -0,0 +1,34 @@
+interface HotspotConfig {
+    readonly top_n: number;
+    readonly min_churn: number;
+    readonly min_complexity: number;
+    readonly threshold_softness: number;
+    readonly peer_percentile_floor: number;
+}
+export type Quadrant = "top-right" | "top-left" | "bottom-right" | "bottom-left";
+export interface Hotspot {
+    readonly file: string;
+    readonly churn: number;
+    readonly complexity: number;
+    readonly hotspotScore: number;
+    readonly quadrant: Quadrant;
+    readonly rank: number;
+}
+export interface HotspotOutput {
+    readonly hotspots: ReadonlyArray<Hotspot>;
+    readonly diagnosticLimit?: number;
+    readonly totalFilesConsidered: number;
+    readonly topRightShare: number;
+    readonly topRightPressure: number;
+    readonly medianChurn: number;
+    readonly medianComplexity: number;
+    readonly legacyFilesConsidered: number;
+    readonly legacyTopRightShare: number;
+    readonly softFilesConsidered: number;
+    readonly softTopRightShare: number;
+    readonly softTopRightPressure: number;
+    readonly stabilizationWeight: number;
+}
+export declare const computeHotspotOutput: (config: HotspotConfig, inputs: ReadonlyMap<string, unknown>) => HotspotOutput;
+export {};
+//# sourceMappingURL=ts-rp-01-hotspot-model.d.ts.map

package/dist/signals/ts-rp-01-hotspot-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-rp-01-hotspot-model.d.ts","sourceRoot":"","sources":["../../src/signals/ts-rp-01-hotspot-model.ts"],"names":[],"mappings":"AAGA,UAAU,aAAa;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAA;CACvC;AAED,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,GAAG,aAAa,CAAA;AAEhF,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;CACrC;AAqBD,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,aAAa,EACrB,QAAQ,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,KACnC,aAyBF,CAAA"}

package/dist/signals/ts-rp-01-hotspot-model.js

@@ -0,0 +1,188 @@
+export const computeHotspotOutput = (config, inputs) => {
+    const { complexity, churn } = resolveHotspotInputs(inputs);
+    if (complexity === undefined || churn === undefined) {
+        return emptyHotspotOutput(config);
+    }
+    const files = buildHotspotCandidates(complexity, churn, config);
+    const legacyEntries = files.filter((entry) => entry.churn >= config.min_churn && entry.complexity >= config.min_complexity);
+    const softEntries = files.filter((entry) => entry.thresholdWeight > 0);
+    const legacy = summarizeHotspots(legacyEntries, (entry) => entry.churn * entry.complexity);
+    const soft = summarizeHotspots(softEntries, (entry) => entry.churn * entry.complexity * entry.thresholdWeight);
+    const softTopRightPressure = computeSoftTopRightPressure(softEntries, config.min_churn, config.min_complexity, config.threshold_softness, config.peer_percentile_floor);
+    return assembleHotspotOutput(config, legacy, soft, softTopRightPressure);
+};
+const resolveHotspotInputs = (inputs) => ({
+    complexity: (inputs.get("TS-LD-01-cyclomatic-complexity") ??
+        inputs.get("TS-LD-01")),
+    churn: inputs.get("SHARED-CHURN-01"),
+});
+const emptyHotspotOutput = (config) => ({
+    hotspots: [],
+    totalFilesConsidered: 0,
+    topRightShare: 0,
+    topRightPressure: 0,
+    medianChurn: 0,
+    medianComplexity: 0,
+    legacyFilesConsidered: 0,
+    legacyTopRightShare: 0,
+    softFilesConsidered: 0,
+    softTopRightShare: 0,
+    softTopRightPressure: 0,
+    stabilizationWeight: 0,
+    diagnosticLimit: config.top_n,
+});
+const buildHotspotCandidates = (complexity, churn, config) => {
+    const files = [];
+    for (const [file, summary] of complexity.byFile) {
+        const cplx = summary.max;
+        const c = churn.byFile.get(file) ?? 0;
+        if (c <= 0)
+            continue;
+        const thresholdWeight = softGate(c, config.min_churn, config.threshold_softness) *
+            softGate(cplx, config.min_complexity, config.threshold_softness);
+        files.push({ file, churn: c, complexity: cplx, thresholdWeight });
+    }
+    return files;
+};
+const assembleHotspotOutput = (config, legacy, soft, softTopRightPressure) => {
+    const legacyFilesConsidered = legacy.ranked.length;
+    const softFilesConsidered = soft.ranked.length;
+    const stabilizationWeight = stabilizationBlendWeight(legacyFilesConsidered === 0 ? softFilesConsidered : legacyFilesConsidered);
+    const useSoftShape = stabilizationWeight >= 0.5;
+    const chosen = useSoftShape ? soft : legacy;
+    return {
+        hotspots: chosen.ranked,
+        diagnosticLimit: config.top_n,
+        totalFilesConsidered: chosen.ranked.length,
+        topRightShare: chosen.topRightShare,
+        topRightPressure: useSoftShape ? softTopRightPressure : 0,
+        medianChurn: chosen.medianChurn,
+        medianComplexity: chosen.medianComplexity,
+        legacyFilesConsidered,
+        legacyTopRightShare: legacy.topRightShare,
+        softFilesConsidered,
+        softTopRightShare: soft.topRightShare,
+        softTopRightPressure,
+        stabilizationWeight,
+    };
+};
+const median = (values) => {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 0) {
+        return ((sorted[mid - 1] ?? 0) + (sorted[mid] ?? 0)) / 2;
+    }
+    return sorted[mid] ?? 0;
+};
+const classifyQuadrant = (churn, complexity, medChurn, medComplexity) => {
+    const highChurn = churn > medChurn;
+    const highComplexity = complexity > medComplexity;
+    if (highChurn && highComplexity)
+        return "top-right";
+    if (highChurn && !highComplexity)
+        return "top-left";
+    if (!highChurn && highComplexity)
+        return "bottom-right";
+    return "bottom-left";
+};
+const softGate = (value, minimum, softness) => {
+    if (minimum <= 0)
+        return value > 0 ? 1 : 0;
+    const clampedSoftness = Math.max(0, Math.min(0.99, softness));
+    const lower = Math.max(0, minimum * (1 - clampedSoftness));
+    const upper = Math.max(lower + Number.EPSILON, minimum * (1 + clampedSoftness));
+    if (value <= lower)
+        return 0;
+    if (value >= upper)
+        return 1;
+    const t = (value - lower) / (upper - lower);
+    return t * t * (3 - 2 * t);
+};
+const percentileRank = (value, values) => {
+    if (values.length <= 1)
+        return 1;
+    const sorted = [...values].sort((a, b) => a - b);
+    let lastIndex = 0;
+    for (let index = 0; index < sorted.length; index += 1) {
+        if ((sorted[index] ?? 0) <= value) {
+            lastIndex = index;
+        }
+    }
+    return lastIndex / (sorted.length - 1);
+};
+const aboveFloor = (value, floor) => {
+    const effectiveFloor = Math.max(0, Math.min(0.95, floor));
+    if (effectiveFloor >= 1)
+        return 0;
+    return Math.max(0, Math.min(1, (value - effectiveFloor) / (1 - effectiveFloor)));
+};
+const normalizeObservedMagnitude = (value, minimum, softness) => {
+    const clampedSoftness = Math.max(0, Math.min(0.99, softness));
+    const lower = Math.max(0, minimum * (1 - clampedSoftness));
+    const upper = Math.max(lower + 1, minimum * 8);
+    if (upper <= lower)
+        return 1;
+    return Math.max(0, Math.min(1, (value - lower) / (upper - lower)));
+};
+const summarizeHotspots = (entries, hotspotScoreFor) => {
+    if (entries.length === 0) {
+        return {
+            ranked: [],
+            topRightShare: 0,
+            medianChurn: 0,
+            medianComplexity: 0,
+        };
+    }
+    const churnValues = entries.map((entry) => entry.churn);
+    const complexityValues = entries.map((entry) => entry.complexity);
+    const medianChurn = median(churnValues);
+    const medianComplexity = median(complexityValues);
+    const scored = entries.map((entry) => ({
+        file: entry.file,
+        churn: entry.churn,
+        complexity: entry.complexity,
+        hotspotScore: hotspotScoreFor(entry),
+        quadrant: classifyQuadrant(entry.churn, entry.complexity, medianChurn, medianComplexity),
+        rank: 0,
+    }));
+    scored.sort((left, right) => right.hotspotScore - left.hotspotScore);
+    const ranked = scored.map((hotspot, index) => ({ ...hotspot, rank: index + 1 }));
+    const topRight = ranked.filter((hotspot) => hotspot.quadrant === "top-right").length;
+    return {
+        ranked,
+        topRightShare: ranked.length === 0 ? 0 : topRight / ranked.length,
+        medianChurn,
+        medianComplexity,
+    };
+};
+const computeSoftTopRightPressure = (entries, minChurn, minComplexity, thresholdSoftness, peerPercentileFloor) => {
+    if (entries.length === 0)
+        return 0;
+    const churnValues = entries.map((entry) => entry.churn);
+    const complexityValues = entries.map((entry) => entry.complexity);
+    let total = 0;
+    for (const entry of entries) {
+        const churnPercentile = percentileRank(entry.churn, churnValues);
+        const complexityPercentile = percentileRank(entry.complexity, complexityValues);
+        const churnIntensity = normalizeObservedMagnitude(entry.churn, minChurn, thresholdSoftness);
+        const complexityIntensity = normalizeObservedMagnitude(entry.complexity, minComplexity, thresholdSoftness);
+        total +=
+            entry.thresholdWeight *
+                aboveFloor(churnPercentile, peerPercentileFloor) *
+                aboveFloor(complexityPercentile, peerPercentileFloor) *
+                Math.sqrt(churnIntensity * complexityIntensity);
+    }
+    return total / entries.length;
+};
+const stabilizationBlendWeight = (consideredFiles) => {
+    const fullyStabilizedAt = 6;
+    const fullyLegacyAt = 12;
+    if (consideredFiles <= fullyStabilizedAt)
+        return 1;
+    if (consideredFiles >= fullyLegacyAt)
+        return 0;
+    return (fullyLegacyAt - consideredFiles) / (fullyLegacyAt - fullyStabilizedAt);
+};
+//# sourceMappingURL=ts-rp-01-hotspot-model.js.map