@skastr0/pulsar-ts-pack 0.1.0

package/dist/signals/ts-ab-03-type-indirection-depth.js

@@ -0,0 +1,162 @@
+import { SignalComputeError, summarize } from "@skastr0/pulsar-core/signal";
+import { scoreThresholdViolationShare } from "@skastr0/pulsar-core/signal";
+import { Effect, Schema } from "effect";
+import { Node } from "ts-morph";
+import { TsProjectTag } from "../ts-project.js";
+import { isExcluded } from "./shared-globs.js";
+import { buildLocalAliasMap, createWalkContext, measureDeclaration, } from "./ts-ab-03-indirection-walker.js";
+const TsAb03Config = Schema.Struct({
+    exclude_globs: Schema.Array(Schema.String),
+    max_depth: Schema.Number,
+    max_traversal_steps: Schema.Number,
+    top_n_diagnostics: Schema.Number,
+});
+export const TsAb03 = {
+    id: "TS-AB-03-type-indirection-depth",
+    title: "Type indirection depth",
+    aliases: ["TS-AB-03"],
+    tier: 1,
+    category: "abstraction-bloat",
+    kind: "legibility",
+    configSchema: TsAb03Config,
+    defaultConfig: {
+        exclude_globs: [
+            "**/*.test.ts",
+            "**/*.test.tsx",
+            "**/*.spec.ts",
+            "**/*.spec.tsx",
+            "**/*.stories.ts",
+            "**/*.stories.tsx",
+            "**/*.d.ts",
+            "**/node_modules/**",
+            "**/dist/**",
+            "**/.turbo/**",
+            "**/vendor/**",
+            "**/gen/**",
+            "**/generated/**",
+            "**/*.gen.ts",
+            "**/*.gen.tsx",
+            "**/*.generated.ts",
+            "**/*.generated.tsx",
+            "**/sst-env.d.ts",
+            "**/__tests__/**",
+            "**/test/**",
+            "**/tests/**",
+            "**/test-support/**",
+            "**/*test-support.ts",
+            "**/*test-support.tsx",
+            "**/*.test-support.ts",
+            "**/*.test-support.tsx",
+            "**/test-helpers.ts",
+            "**/*test-helpers.ts",
+            "**/*test-helpers.tsx",
+            "**/*.test-helpers.ts",
+            "**/*.test-helpers.tsx",
+            "**/test-mocks.ts",
+            "**/*test-mocks.ts",
+            "**/*test-mocks.tsx",
+            "**/*.test-mocks.ts",
+            "**/*.test-mocks.tsx",
+            "**/test-harness.ts",
+            "**/*test-harness.ts",
+            "**/*test-harness.tsx",
+            "**/*.test-harness.ts",
+            "**/*.test-harness.tsx",
+            "**/happydom.ts",
+        ],
+        max_depth: 4,
+        max_traversal_steps: 16,
+        top_n_diagnostics: 10,
+    },
+    inputs: [],
+    compute: (config) => Effect.gen(function* () {
+        const project = yield* TsProjectTag;
+        const result = yield* Effect.try({
+            try: () => {
+                const declarations = [];
+                const byFile = new Map();
+                for (const sourceFile of project.getSourceFiles()) {
+                    const file = sourceFile.getFilePath();
+                    if (isExcluded(file, config.exclude_globs))
+                        continue;
+                    const localAliases = buildLocalAliasMap(sourceFile);
+                    const aliasDepthCache = new Map();
+                    for (const declaration of collectTrackedDeclarations(sourceFile)) {
+                        const result = measureDeclaration(declaration, createWalkContext(config.max_traversal_steps, localAliases, aliasDepthCache));
+                        declarations.push({
+                            file,
+                            name: declaration.getName() ?? "<anonymous>",
+                            line: declaration.getStartLineNumber(),
+                            depth: result.depth,
+                            exported: isExportedDeclaration(declaration),
+                            chain: result.chain,
+                            cycle: result.cycle,
+                            truncated: result.truncated,
+                        });
+                        const bucket = byFile.get(file) ?? [];
+                        bucket.push(result.depth);
+                        byFile.set(file, bucket);
+                    }
+                }
+                declarations.sort(compareIndirectionEntries);
+                const byFileSummary = new Map();
+                for (const [file, values] of byFile) {
+                    byFileSummary.set(file, summarize(values));
+                }
+                return {
+                    declarations,
+                    byFile: byFileSummary,
+                    repoDistribution: summarize(declarations.map((entry) => entry.depth)),
+                    overThreshold: declarations.filter((entry) => entry.depth > config.max_depth),
+                    maxDepth: config.max_depth,
+                    traversalCap: config.max_traversal_steps,
+                    diagnosticLimit: config.top_n_diagnostics,
+                };
+            },
+            catch: (cause) => new SignalComputeError({
+                signalId: "TS-AB-03-type-indirection-depth",
+                message: String(cause),
+                cause,
+            }),
+        });
+        return result;
+    }),
+    score: (out) => {
+        return scoreThresholdViolationShare(out.declarations.length, out.overThreshold.length);
+    },
+    diagnose: (out) => out.overThreshold.slice(0, out.diagnosticLimit).map((entry) => ({
+        severity: typeIndirectionSeverity(entry, out.maxDepth),
+        message: `Type indirection \`${entry.name}\` resolves through ${entry.depth} layers: ` +
+            entry.chain.join(" → "),
+        location: { file: entry.file, line: entry.line },
+        data: {
+            ...entry,
+            maxDepth: out.maxDepth,
+            traversalCap: out.traversalCap,
+        },
+    })),
+};
+const collectTrackedDeclarations = (sourceFile) => {
+    const results = [];
+    results.push(...sourceFile.getTypeAliases());
+    results.push(...sourceFile.getInterfaces().filter(hasExportModifier));
+    results.push(...sourceFile.getClasses().filter(hasExportModifier));
+    results.push(...sourceFile.getEnums().filter(hasExportModifier));
+    return results;
+};
+const hasExportModifier = (node) => {
+    const candidate = node;
+    return candidate.getModifiers?.().some((modifier) => modifier.getKindName() === "ExportKeyword") ?? false;
+};
+const isExportedDeclaration = (node) => !Node.isTypeAliasDeclaration(node) || hasExportModifier(node);
+const typeIndirectionSeverity = (entry, maxDepth) => entry.exported || entry.depth >= maxDepth + 2 ? "warn" : "info";
+const compareIndirectionEntries = (left, right) => {
+    if (right.depth !== left.depth) {
+        return right.depth - left.depth;
+    }
+    if (left.file !== right.file) {
+        return left.file.localeCompare(right.file);
+    }
+    return left.line - right.line;
+};
+//# sourceMappingURL=ts-ab-03-type-indirection-depth.js.map

package/dist/signals/ts-ab-03-type-indirection-depth.js.map

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

package/dist/signals/ts-ab-04-analysis.d.ts

@@ -0,0 +1,33 @@
+import { type Project } from "ts-morph";
+export interface SingleImplPair {
+    readonly interfaceFile: string;
+    readonly interfaceName: string;
+    readonly implementationFile: string;
+    readonly implementationName: string;
+    readonly hasTestSubstitute: boolean;
+}
+export interface DeadInterface {
+    readonly interfaceFile: string;
+    readonly interfaceName: string;
+    readonly line: number;
+}
+export interface TsAb04Output {
+    readonly pairs: ReadonlyArray<SingleImplPair>;
+    readonly flaggedPairs: ReadonlyArray<SingleImplPair>;
+    readonly totalInterfaces: number;
+    readonly ratio: number;
+    readonly deadInterfaces: ReadonlyArray<DeadInterface>;
+    readonly deadInterfaceRatio: number;
+    readonly singleImplementationPressure: number;
+    readonly deadInterfacePressure: number;
+    readonly diagnosticLimit: number;
+}
+interface TsAb04AnalysisConfig {
+    readonly exclude_globs: ReadonlyArray<string>;
+    readonly test_globs: ReadonlyArray<string>;
+    readonly public_entry_globs: ReadonlyArray<string>;
+    readonly top_n_diagnostics: number;
+}
+export declare const computeInterfaceImplementationRatio: (project: Project, config: TsAb04AnalysisConfig) => TsAb04Output;
+export {};
+//# sourceMappingURL=ts-ab-04-analysis.d.ts.map

package/dist/signals/ts-ab-04-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-ab-04-analysis.d.ts","sourceRoot":"","sources":["../../src/signals/ts-ab-04-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAA0D,MAAM,UAAU,CAAA;AAKrG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;IAC7C,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;IACpD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;IACrD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAA;IAC7C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAA;IACtC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CACjC;AAED,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC7C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAClD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CACnC;AAeD,eAAO,MAAM,mCAAmC,GAC9C,SAAS,OAAO,EAChB,QAAQ,oBAAoB,KAC3B,YAWF,CAAA"}

package/dist/signals/ts-ab-04-analysis.js

@@ -0,0 +1,212 @@
+import { Node, SyntaxKind } from "ts-morph";
+import { createModuleResolver } from "../graph/module-graph.js";
+import { isExcluded, matchesAnyGlob } from "./shared-globs.js";
+import { hasExportModifier } from "./shared-ts-morph-modifiers.js";
+export const computeInterfaceImplementationRatio = (project, config) => {
+    const { productionFiles, testFiles } = selectInterfaceAnalysisFiles(project, config);
+    const candidateInterfaces = collectCandidateInterfaces(productionFiles, config);
+    const prodImplementations = buildImplementationIndex(productionFiles);
+    const testImplementations = buildImplementationIndex(testFiles);
+    const accumulator = buildInterfaceImplementationAccumulator(candidateInterfaces, prodImplementations, testImplementations);
+    return buildInterfaceImplementationOutput(accumulator, config.top_n_diagnostics);
+};
+const selectInterfaceAnalysisFiles = (project, config) => {
+    const sourceFiles = project
+        .getSourceFiles()
+        .filter((sourceFile) => !isExcluded(sourceFile.getFilePath(), config.exclude_globs));
+    return {
+        productionFiles: sourceFiles.filter((sourceFile) => !matchesAnyGlob(sourceFile.getFilePath(), config.test_globs)),
+        testFiles: sourceFiles.filter((sourceFile) => matchesAnyGlob(sourceFile.getFilePath(), config.test_globs)),
+    };
+};
+const collectCandidateInterfaces = (productionFiles, config) => {
+    const publicInterfaces = buildPublicInterfaceKeySet(productionFiles, config.public_entry_globs);
+    return productionFiles
+        .flatMap((sourceFile) => sourceFile.getInterfaces())
+        .filter((iface) => !publicInterfaces.has(interfaceKey(iface)));
+};
+const buildInterfaceImplementationAccumulator = (candidateInterfaces, prodImplementations, testImplementations) => {
+    const accumulator = {
+        pairs: [],
+        deadInterfaces: [],
+        totalInterfaces: 0,
+    };
+    for (const iface of candidateInterfaces) {
+        addInterfaceImplementationFinding(iface, prodImplementations, testImplementations, accumulator);
+    }
+    return accumulator;
+};
+const addInterfaceImplementationFinding = (iface, prodImplementations, testImplementations, accumulator) => {
+    const productionImplementations = prodImplementations.get(iface.getName()) ?? [];
+    const hasTestSubstitute = (testImplementations.get(iface.getName()) ?? []).length > 0;
+    if (productionImplementations.length === 0) {
+        addDeadInterfaceFinding(iface, accumulator);
+        return;
+    }
+    accumulator.totalInterfaces += 1;
+    if (productionImplementations.length !== 1)
+        return;
+    const implementation = productionImplementations[0];
+    accumulator.pairs.push({
+        interfaceFile: iface.getSourceFile().getFilePath(),
+        interfaceName: iface.getName(),
+        implementationFile: implementation.file,
+        implementationName: implementation.name,
+        hasTestSubstitute,
+    });
+};
+const addDeadInterfaceFinding = (iface, accumulator) => {
+    if (hasStructuralTypeUsage(iface))
+        return;
+    accumulator.totalInterfaces += 1;
+    accumulator.deadInterfaces.push({
+        interfaceFile: iface.getSourceFile().getFilePath(),
+        interfaceName: iface.getName(),
+        line: iface.getStartLineNumber(),
+    });
+};
+const buildInterfaceImplementationOutput = (accumulator, diagnosticLimit) => {
+    const flaggedPairs = accumulator.pairs
+        .filter((pair) => !pair.hasTestSubstitute)
+        .sort(compareSingleImplPairs);
+    const totalInterfaces = accumulator.totalInterfaces;
+    const ratio = totalInterfaces === 0 ? 0 : flaggedPairs.length / totalInterfaces;
+    const deadInterfaceRatio = totalInterfaces === 0 ? 0 : accumulator.deadInterfaces.length / totalInterfaces;
+    return {
+        pairs: accumulator.pairs,
+        flaggedPairs,
+        totalInterfaces,
+        ratio,
+        deadInterfaces: accumulator.deadInterfaces.sort(compareDeadInterfaces),
+        deadInterfaceRatio,
+        singleImplementationPressure: Math.min(1, ratio / 0.5),
+        deadInterfacePressure: Math.min(0.25, deadInterfaceRatio * 0.25),
+        diagnosticLimit,
+    };
+};
+const compareSingleImplPairs = (left, right) => {
+    const interfaceCompare = left.interfaceFile.localeCompare(right.interfaceFile);
+    if (interfaceCompare !== 0)
+        return interfaceCompare;
+    return left.interfaceName.localeCompare(right.interfaceName);
+};
+const compareDeadInterfaces = (left, right) => {
+    const fileCompare = left.interfaceFile.localeCompare(right.interfaceFile);
+    if (fileCompare !== 0)
+        return fileCompare;
+    return left.interfaceName.localeCompare(right.interfaceName);
+};
+const buildPublicInterfaceKeySet = (sourceFiles, publicEntryGlobs) => {
+    const sourceFileByPath = new Map(sourceFiles.map((sourceFile) => [sourceFile.getFilePath(), sourceFile]));
+    const resolver = createModuleResolver(sourceFiles, []);
+    const publicKeys = new Set();
+    const visited = new Set();
+    for (const sourceFile of sourceFiles) {
+        if (!matchesAnyGlob(sourceFile.getFilePath(), publicEntryGlobs))
+            continue;
+        collectPublicInterfacesFromExports(sourceFile, sourceFileByPath, resolver, publicKeys, visited);
+    }
+    return publicKeys;
+};
+const collectPublicInterfacesFromExports = (sourceFile, sourceFileByPath, resolver, publicKeys, visited) => {
+    const file = sourceFile.getFilePath();
+    if (visited.has(file))
+        return;
+    visited.add(file);
+    for (const iface of sourceFile.getInterfaces()) {
+        if (hasExportModifier(iface)) {
+            publicKeys.add(interfaceKey(iface));
+        }
+    }
+    for (const declaration of sourceFile.getExportDeclarations()) {
+        const targetPath = resolver.resolve(file, declaration);
+        const targetFile = targetPath === undefined ? undefined : sourceFileByPath.get(targetPath);
+        const namedExports = declaration.getNamedExports();
+        if (targetFile === undefined)
+            continue;
+        if (namedExports.length > 0) {
+            for (const specifier of namedExports) {
+                const iface = targetFile.getInterface(specifier.getName());
+                if (iface !== undefined) {
+                    publicKeys.add(interfaceKey(iface));
+                }
+            }
+            continue;
+        }
+        collectPublicInterfacesFromExports(targetFile, sourceFileByPath, resolver, publicKeys, visited);
+    }
+};
+const interfaceKey = (iface) => `${iface.getSourceFile().getFilePath()}:${iface.getName()}`;
+const hasStructuralTypeUsage = (iface) => {
+    const nameNode = iface.getNameNode();
+    return iface.findReferencesAsNodes().some((reference) => {
+        if (reference.getSourceFile().getFilePath() === iface.getSourceFile().getFilePath() &&
+            reference.getStart() === nameNode.getStart()) {
+            return false;
+        }
+        return !isImplementationReference(reference);
+    });
+};
+const isImplementationReference = (reference) => isClassImplementsReference(reference) || isTypedObjectLiteralReference(reference);
+const isClassImplementsReference = (reference) => {
+    const heritageExpression = reference.getFirstAncestorByKind(SyntaxKind.ExpressionWithTypeArguments);
+    const heritageClause = heritageExpression?.getParentIfKind(SyntaxKind.HeritageClause);
+    return heritageClause?.getToken() === SyntaxKind.ImplementsKeyword;
+};
+const isTypedObjectLiteralReference = (reference) => {
+    const variableDeclaration = reference.getFirstAncestorByKind(SyntaxKind.VariableDeclaration);
+    if (variableDeclaration === undefined)
+        return false;
+    const initializer = variableDeclaration.getInitializer();
+    if (!Node.isObjectLiteralExpression(initializer))
+        return false;
+    const typeNode = variableDeclaration.getTypeNode();
+    if (typeNode === undefined)
+        return false;
+    return reference.getStart() >= typeNode.getStart() && reference.getEnd() <= typeNode.getEnd();
+};
+const buildImplementationIndex = (sourceFiles) => {
+    const byInterface = new Map();
+    const add = (interfaceName, descriptor) => {
+        if (interfaceName === undefined || interfaceName.length === 0)
+            return;
+        const bucket = byInterface.get(interfaceName) ?? new Map();
+        bucket.set(`${descriptor.file}:${descriptor.name}`, descriptor);
+        byInterface.set(interfaceName, bucket);
+    };
+    for (const sourceFile of sourceFiles) {
+        const file = sourceFile.getFilePath();
+        for (const classDeclaration of sourceFile.getClasses()) {
+            const name = classDeclaration.getName() ?? "<anonymous-class>";
+            for (const heritage of classDeclaration.getImplements()) {
+                add(rootReferenceName(heritage.getExpression().getText()), { file, name });
+            }
+        }
+        for (const declaration of sourceFile.getVariableDeclarations()) {
+            if (!Node.isObjectLiteralExpression(declaration.getInitializer()))
+                continue;
+            add(rootReferenceName(declaration.getTypeNode()?.getText()), {
+                file,
+                name: declaration.getName(),
+            });
+        }
+    }
+    return new Map([...byInterface.entries()].map(([interfaceName, descriptors]) => [
+        interfaceName,
+        [...descriptors.values()].sort(compareImplementationDescriptors),
+    ]));
+};
+const rootReferenceName = (text) => {
+    const trimmed = text?.trim();
+    if (trimmed === undefined || trimmed.length === 0)
+        return undefined;
+    const match = /^[$A-Z_a-z][$\w]*/.exec(trimmed);
+    return match?.[0];
+};
+const compareImplementationDescriptors = (left, right) => {
+    const fileCompare = left.file.localeCompare(right.file);
+    if (fileCompare !== 0)
+        return fileCompare;
+    return left.name.localeCompare(right.name);
+};
+//# sourceMappingURL=ts-ab-04-analysis.js.map

package/dist/signals/ts-ab-04-analysis.js.map

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

package/dist/signals/ts-ab-04-interface-impl-ratio.d.ts

@@ -0,0 +1,14 @@
+import type { Signal } from "@skastr0/pulsar-core/signal";
+import { Schema } from "effect";
+import { type TsAb04Output } from "./ts-ab-04-analysis.js";
+import { TsProjectTag } from "../ts-project.js";
+declare const TsAb04Config: Schema.Struct<{
+    exclude_globs: Schema.Array$<typeof Schema.String>;
+    test_globs: Schema.Array$<typeof Schema.String>;
+    public_entry_globs: Schema.Array$<typeof Schema.String>;
+    top_n_diagnostics: typeof Schema.Number;
+}>;
+type TsAb04Config = typeof TsAb04Config.Type;
+export declare const TsAb04: Signal<TsAb04Config, TsAb04Output, TsProjectTag>;
+export {};
+//# sourceMappingURL=ts-ab-04-interface-impl-ratio.d.ts.map

package/dist/signals/ts-ab-04-interface-impl-ratio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-ab-04-interface-impl-ratio.d.ts","sourceRoot":"","sources":["../../src/signals/ts-ab-04-interface-impl-ratio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,MAAM,EAAE,MAAM,6BAA6B,CAAA;AACrE,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,QAAA,MAAM,YAAY;;;;;EAKhB,CAAA;AACF,KAAK,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAE5C,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAkEnE,CAAA"}

package/dist/signals/ts-ab-04-interface-impl-ratio.js

@@ -0,0 +1,66 @@
+import { SignalComputeError } from "@skastr0/pulsar-core/signal";
+import { Effect, Schema } from "effect";
+import { computeInterfaceImplementationRatio, } from "./ts-ab-04-analysis.js";
+import { TsProjectTag } from "../ts-project.js";
+const TsAb04Config = Schema.Struct({
+    exclude_globs: Schema.Array(Schema.String),
+    test_globs: Schema.Array(Schema.String),
+    public_entry_globs: Schema.Array(Schema.String),
+    top_n_diagnostics: Schema.Number,
+});
+export const TsAb04 = {
+    id: "TS-AB-04-interface-implementation-ratio",
+    title: "Interface implementation ratio",
+    aliases: ["TS-AB-04"],
+    tier: 1,
+    category: "abstraction-bloat",
+    kind: "legibility",
+    cacheVersion: "structural-interface-usage-v1",
+    configSchema: TsAb04Config,
+    defaultConfig: {
+        exclude_globs: ["**/node_modules/**", "**/dist/**", "**/.turbo/**"],
+        test_globs: ["**/*.test.ts", "**/*.spec.ts", "**/__tests__/**"],
+        public_entry_globs: ["**/src/index.ts", "**/index.ts"],
+        top_n_diagnostics: 20,
+    },
+    inputs: [],
+    compute: (config) => Effect.gen(function* () {
+        const project = yield* TsProjectTag;
+        const result = yield* Effect.try({
+            try: () => computeInterfaceImplementationRatio(project, config),
+            catch: (cause) => new SignalComputeError({
+                signalId: "TS-AB-04-interface-implementation-ratio",
+                message: String(cause),
+                cause,
+            }),
+        });
+        return result;
+    }),
+    score: (out) => Math.max(0, 1 - Math.max(out.singleImplementationPressure, out.deadInterfacePressure)),
+    outputMetadata: (out) => out.totalInterfaces === 0 ? { applicability: "not_applicable" } : undefined,
+    diagnose: (out) => {
+        const diagnostics = [];
+        diagnostics.push(...out.flaggedPairs.map((pair) => ({
+            severity: "warn",
+            message: `Single-implementation interface ${pair.interfaceName} -> ${pair.implementationName}`,
+            location: { file: pair.interfaceFile },
+            data: {
+                interfaceFile: pair.interfaceFile,
+                interfaceName: pair.interfaceName,
+                implementationFile: pair.implementationFile,
+                implementationName: pair.implementationName,
+            },
+        })));
+        diagnostics.push(...out.deadInterfaces.map((iface) => ({
+            severity: "warn",
+            message: `Dead interface with no implementation: ${iface.interfaceName}`,
+            location: { file: iface.interfaceFile, line: iface.line },
+            data: {
+                interfaceFile: iface.interfaceFile,
+                interfaceName: iface.interfaceName,
+            },
+        })));
+        return diagnostics.slice(0, out.diagnosticLimit);
+    },
+};
+//# sourceMappingURL=ts-ab-04-interface-impl-ratio.js.map

package/dist/signals/ts-ab-04-interface-impl-ratio.js.map

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

package/dist/signals/ts-ab-05-generic-proliferation.d.ts

@@ -0,0 +1,27 @@
+import type { DistributionalSummary, Signal } from "@skastr0/pulsar-core/signal";
+import { Schema } from "effect";
+import { TsProjectTag } from "../ts-project.js";
+declare const TsAb05Config: Schema.Struct<{
+    exclude_globs: Schema.Array$<typeof Schema.String>;
+    max_generic_parameters: typeof Schema.Number;
+    top_n_diagnostics: typeof Schema.Number;
+}>;
+type TsAb05Config = typeof TsAb05Config.Type;
+interface GenericAnalysis {
+    readonly file: string;
+    readonly declarationName: string;
+    readonly line: number;
+    readonly paramCount: number;
+    readonly maxConstraintDepth: number;
+    readonly returnOnlyParams: ReadonlyArray<string>;
+}
+interface TsAb05Output {
+    readonly byDeclaration: ReadonlyArray<GenericAnalysis>;
+    readonly distribution: DistributionalSummary;
+    readonly overThreshold: ReadonlyArray<GenericAnalysis>;
+    readonly genericThreshold: number;
+    readonly diagnosticLimit: number;
+}
+export declare const TsAb05: Signal<TsAb05Config, TsAb05Output, TsProjectTag>;
+export {};
+//# sourceMappingURL=ts-ab-05-generic-proliferation.d.ts.map

package/dist/signals/ts-ab-05-generic-proliferation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-ab-05-generic-proliferation.d.ts","sourceRoot":"","sources":["../../src/signals/ts-ab-05-generic-proliferation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,qBAAqB,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAA;AAC5F,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAG/C,QAAA,MAAM,YAAY;;;;EAIhB,CAAA;AACF,KAAK,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAE5C,UAAU,eAAe;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACjD;AAED,UAAU,YAAY;IACpB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IACtD,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAA;IAC5C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;IACtD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CACjC;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAoHnE,CAAA"}