slopbrick 0.42.0 → 0.43.0

package/dist/index.d.cts

@@ -1155,9 +1155,8 @@ type AiDebt = 'low' | 'medium' | 'high' | 'critical';
 declare const AI_SECURITY_NUMERIC: Record<'low' | 'medium' | 'high' | 'critical', number>;
 /** Inputs to the pure `buildRepositoryHealth` function. Every input is optional. */
 interface RepositoryHealthInputs {
-    /** v0.15.0 U.4+: 0-100, higher = better. The new headline score
-     *  that replaces slopIndex. Tests and callers should pass this
-     *  going forward. */
+    /** v0.21.0: 0-100, lower = better (raw amount of slop).
+     *  Replaces the v0.15-v0.20.1 inverted cleanliness reading. */
     aiSlopScore?: number;
     /** v0.15.0 U.4+: 0-100, higher = better. */
     engineeringHygiene?: number;
@@ -1401,15 +1400,15 @@ interface ProjectReport {
     generatedAt: string;
     configPath?: string;
     /**
-     * v0.20.0: renamed from `aiSlopScore` to `aiSlopScore` because the
-     * old name implied a property of the *code* (quality) when it
-     * actually measures a property of the *tool's detection* (how
-     * many AI-detection rules fire on this codebase). 0-100, higher
-     * is better — but 'better' means 'fewer rule fires', not
-     * 'higher quality code'. The name "AI Slop Score" matches the
-     * existing description ("measures AI-slop signatures") and the
-     * slopbrick brand. See the pre-publish checklist in
-     * CONTRIBUTING.md for the full rationale.
+     * v0.21.0: 0-100, **lower = better** (raw amount of slop).
+     * The CI gate is `aiSlopScore <= meanSlop` (where meanSlop defaults
+     * to 30). Higher values mean more AI-detection rules fired on this
+     * codebase. The previous v0.15-v0.20.1 reading inverted this to
+     * "cleanliness" (higher = better), which made the JSON output and
+     * the CLI gate disagree. This field has been lower-is-better
+     * since v0.21.0; the JSDoc that said "0-100, higher is better"
+     * was a stale v0.15-era comment that survived past the inversion.
+     * Fixed in v0.42.0.
      */
     aiSlopScore: number;
     engineeringHygiene: number;
@@ -1578,6 +1577,18 @@ interface ProjectReport {
         p90Slop: number;
         individualSlopThreshold: number;
     };
+    /**
+     * v0.42.0 (user-review fix): names of thresholds that tripped in this
+     * scan. Optional for backward compat with v0.41 and earlier reports.
+     * Empty/undefined means all gates passed.
+     *
+     * Possible values: 'meanSlop', 'p90Slop', 'individualSlopThreshold',
+     * 'category:<name>' (per-category thresholds).
+     *
+     * CI consumers can grep this field directly instead of parsing the
+     * stderr message. See threshold.ts#failedThresholds for source.
+     */
+    failedThresholds?: string[];
     /** Research/flywheel snapshot — present when the flywheel directory has artifacts. */
     research?: ResearchMetrics;
     topOffenders?: TopOffender[];
@@ -1654,9 +1665,12 @@ interface ProjectReport {
     /** v0.14.5i — Number of distinct rules marked defaultOff. The ratio
      *  suppressedCount / defaultOffRuleCount is the calibration coverage. */
     defaultOffRuleCount?: number;
-    /** v0.14.5j — The previous run's Slop Index, if any. Used by
+    /** v0.14.5j — The previous run's value, if any. Used by
      *  formatPretty to render a "±N from last run" delta so the user
-     *  can see the trajectory without grep'ing the run log. */
+     *  can see the trajectory without grep'ing the run log. The
+     *  name is kept as `previousSlopIndex` for backward compat with
+     *  telemetry consumers, but the value is the previous
+     *  aiSlopScore (since v0.21: lower = cleaner). */
     previousSlopIndex?: number;
     /** v0.14.5j — ISO timestamp of the previous run, paired with
      *  previousSlopIndex so the delta line can say "vs 2026-06-27". */
@@ -1729,6 +1743,16 @@ declare function runCli({ start }: {
 
 declare function thresholdExceeded(report: ProjectReport, config: ResolvedConfig): boolean;
 declare function failedThresholdCount(report: ProjectReport, config: ResolvedConfig): number;
+/**
+ * v0.42.0 (user-review fix): failedThresholdCount() returned just the
+ * count. The CLI then printed "{n} threshold(s) failed. See details
+ * above." — but in --brief the user sees only the headline CI gate
+ * ("AI Slop Score <= 15 -> fail"), not the per-threshold list.
+ *
+ * This function returns the actual list of failed threshold names so
+ * the caller can name them in the final error message.
+ */
+declare function failedThresholds(report: ProjectReport, config: ResolvedConfig): string[];
 declare function baselineStatusMessage(baseline: BaselineMeta): string;
 interface StagedGatingResult {
     failed: boolean;
@@ -1776,4 +1800,4 @@ declare function formatBadge(report: ProjectReport): string;
 /** Render an array of values as a Unicode sparkline (▁▂▃▄▅▆▇█). */
 declare function formatSparkline(values: number[]): string;
 
-export { AI_SECURITY_NUMERIC, type AiDebt, type AiMaintenanceCost, type AiMaintenanceCostResult, type AstroComponentFact, type AutoRelaxedRule, type AutoTunedRule, type BaselineCache, type BaselineMeta, type CachedFile, type Category, type ClassNameFact, type ClusterInput, type ClusterParamOverrides, type ClusterParams, type CommentFact, type ComponentFacts, type ComponentScore, type ComponentSizeFact, type CompositeRule, type CompositeRuleEntry, type ConsoleCallFact, type Constitution, DEFAULT_CONFIG, type DangerouslySetInnerHtmlFact, type DbDriftLevel, type DbFinding, type DialogCallFact, type DisabledLintRuleFact, type DocDriftLevel, type DocFinding, type DomQueryFact, type ElementFact, type EvalCallFact, type ExplicitAnyFact, type FetchCallFact, type FileScanResult, type FixSuggestion, type FlywheelOutput, type FlywheelState, type Framework$1 as Framework, type HealthFile, type HookCallFact, type HookDependencyArrayFact, type HookFact, type ImportFact, type InlineEventHandlerFact, type Issue, type JsxAttributeStringLiteralFact, type JsxTextLiteralFact, type KeyPropFact, type LogicalExpressionFact, type MagicNumberSpacingConfig, type MaintenanceAxes, type MaintenanceAxisHealth, type NonNullAssertionFact, type OptimisticUpdateFact, type ProjectReport, type PropMutationFact, type PropPassThroughFact, REPOSITORY_HEALTH_WEIGHTS, type ReportReadResult, type RepositoryHealth, type RepositoryHealthInputs, type ResearchMetrics, type ResolvedConfig, type Rule, type RuleContext, type RuleSeverity, type RuleSuggestion, type ScanCache, type ScanFacts, type ScanProjectOptions, type ScanSelfScanConfig, type Severity, type SlopAuditRun, type StateBinding, type StateBindingFact, type StringLiteralFact, type StylePropFact, type TamaguiStylePropFact, type TopOffender, type UseEffectBodyFact, VERSION, baselineStatusMessage, colorForSlop, failedThresholdCount, filterByDisabledDirectives, filterIssues, formatBadge, formatReportFromFile, formatSparkline, loadConfig, readReportFile, runCli, runInitWizard, scanProject, serializeConfig, stagedGating, thresholdExceeded };
+export { AI_SECURITY_NUMERIC, type AiDebt, type AiMaintenanceCost, type AiMaintenanceCostResult, type AstroComponentFact, type AutoRelaxedRule, type AutoTunedRule, type BaselineCache, type BaselineMeta, type CachedFile, type Category, type ClassNameFact, type ClusterInput, type ClusterParamOverrides, type ClusterParams, type CommentFact, type ComponentFacts, type ComponentScore, type ComponentSizeFact, type CompositeRule, type CompositeRuleEntry, type ConsoleCallFact, type Constitution, DEFAULT_CONFIG, type DangerouslySetInnerHtmlFact, type DbDriftLevel, type DbFinding, type DialogCallFact, type DisabledLintRuleFact, type DocDriftLevel, type DocFinding, type DomQueryFact, type ElementFact, type EvalCallFact, type ExplicitAnyFact, type FetchCallFact, type FileScanResult, type FixSuggestion, type FlywheelOutput, type FlywheelState, type Framework$1 as Framework, type HealthFile, type HookCallFact, type HookDependencyArrayFact, type HookFact, type ImportFact, type InlineEventHandlerFact, type Issue, type JsxAttributeStringLiteralFact, type JsxTextLiteralFact, type KeyPropFact, type LogicalExpressionFact, type MagicNumberSpacingConfig, type MaintenanceAxes, type MaintenanceAxisHealth, type NonNullAssertionFact, type OptimisticUpdateFact, type ProjectReport, type PropMutationFact, type PropPassThroughFact, REPOSITORY_HEALTH_WEIGHTS, type ReportReadResult, type RepositoryHealth, type RepositoryHealthInputs, type ResearchMetrics, type ResolvedConfig, type Rule, type RuleContext, type RuleSeverity, type RuleSuggestion, type ScanCache, type ScanFacts, type ScanProjectOptions, type ScanSelfScanConfig, type Severity, type SlopAuditRun, type StateBinding, type StateBindingFact, type StringLiteralFact, type StylePropFact, type TamaguiStylePropFact, type TopOffender, type UseEffectBodyFact, VERSION, baselineStatusMessage, colorForSlop, failedThresholdCount, failedThresholds, filterByDisabledDirectives, filterIssues, formatBadge, formatReportFromFile, formatSparkline, loadConfig, readReportFile, runCli, runInitWizard, scanProject, serializeConfig, stagedGating, thresholdExceeded };

package/dist/index.d.ts

@@ -1155,9 +1155,8 @@ type AiDebt = 'low' | 'medium' | 'high' | 'critical';
 declare const AI_SECURITY_NUMERIC: Record<'low' | 'medium' | 'high' | 'critical', number>;
 /** Inputs to the pure `buildRepositoryHealth` function. Every input is optional. */
 interface RepositoryHealthInputs {
-    /** v0.15.0 U.4+: 0-100, higher = better. The new headline score
-     *  that replaces slopIndex. Tests and callers should pass this
-     *  going forward. */
+    /** v0.21.0: 0-100, lower = better (raw amount of slop).
+     *  Replaces the v0.15-v0.20.1 inverted cleanliness reading. */
     aiSlopScore?: number;
     /** v0.15.0 U.4+: 0-100, higher = better. */
     engineeringHygiene?: number;
@@ -1401,15 +1400,15 @@ interface ProjectReport {
     generatedAt: string;
     configPath?: string;
     /**
-     * v0.20.0: renamed from `aiSlopScore` to `aiSlopScore` because the
-     * old name implied a property of the *code* (quality) when it
-     * actually measures a property of the *tool's detection* (how
-     * many AI-detection rules fire on this codebase). 0-100, higher
-     * is better — but 'better' means 'fewer rule fires', not
-     * 'higher quality code'. The name "AI Slop Score" matches the
-     * existing description ("measures AI-slop signatures") and the
-     * slopbrick brand. See the pre-publish checklist in
-     * CONTRIBUTING.md for the full rationale.
+     * v0.21.0: 0-100, **lower = better** (raw amount of slop).
+     * The CI gate is `aiSlopScore <= meanSlop` (where meanSlop defaults
+     * to 30). Higher values mean more AI-detection rules fired on this
+     * codebase. The previous v0.15-v0.20.1 reading inverted this to
+     * "cleanliness" (higher = better), which made the JSON output and
+     * the CLI gate disagree. This field has been lower-is-better
+     * since v0.21.0; the JSDoc that said "0-100, higher is better"
+     * was a stale v0.15-era comment that survived past the inversion.
+     * Fixed in v0.42.0.
      */
     aiSlopScore: number;
     engineeringHygiene: number;
@@ -1578,6 +1577,18 @@ interface ProjectReport {
         p90Slop: number;
         individualSlopThreshold: number;
     };
+    /**
+     * v0.42.0 (user-review fix): names of thresholds that tripped in this
+     * scan. Optional for backward compat with v0.41 and earlier reports.
+     * Empty/undefined means all gates passed.
+     *
+     * Possible values: 'meanSlop', 'p90Slop', 'individualSlopThreshold',
+     * 'category:<name>' (per-category thresholds).
+     *
+     * CI consumers can grep this field directly instead of parsing the
+     * stderr message. See threshold.ts#failedThresholds for source.
+     */
+    failedThresholds?: string[];
     /** Research/flywheel snapshot — present when the flywheel directory has artifacts. */
     research?: ResearchMetrics;
     topOffenders?: TopOffender[];
@@ -1654,9 +1665,12 @@ interface ProjectReport {
     /** v0.14.5i — Number of distinct rules marked defaultOff. The ratio
      *  suppressedCount / defaultOffRuleCount is the calibration coverage. */
     defaultOffRuleCount?: number;
-    /** v0.14.5j — The previous run's Slop Index, if any. Used by
+    /** v0.14.5j — The previous run's value, if any. Used by
      *  formatPretty to render a "±N from last run" delta so the user
-     *  can see the trajectory without grep'ing the run log. */
+     *  can see the trajectory without grep'ing the run log. The
+     *  name is kept as `previousSlopIndex` for backward compat with
+     *  telemetry consumers, but the value is the previous
+     *  aiSlopScore (since v0.21: lower = cleaner). */
     previousSlopIndex?: number;
     /** v0.14.5j — ISO timestamp of the previous run, paired with
      *  previousSlopIndex so the delta line can say "vs 2026-06-27". */
@@ -1729,6 +1743,16 @@ declare function runCli({ start }: {
 
 declare function thresholdExceeded(report: ProjectReport, config: ResolvedConfig): boolean;
 declare function failedThresholdCount(report: ProjectReport, config: ResolvedConfig): number;
+/**
+ * v0.42.0 (user-review fix): failedThresholdCount() returned just the
+ * count. The CLI then printed "{n} threshold(s) failed. See details
+ * above." — but in --brief the user sees only the headline CI gate
+ * ("AI Slop Score <= 15 -> fail"), not the per-threshold list.
+ *
+ * This function returns the actual list of failed threshold names so
+ * the caller can name them in the final error message.
+ */
+declare function failedThresholds(report: ProjectReport, config: ResolvedConfig): string[];
 declare function baselineStatusMessage(baseline: BaselineMeta): string;
 interface StagedGatingResult {
     failed: boolean;
@@ -1776,4 +1800,4 @@ declare function formatBadge(report: ProjectReport): string;
 /** Render an array of values as a Unicode sparkline (▁▂▃▄▅▆▇█). */
 declare function formatSparkline(values: number[]): string;
 
-export { AI_SECURITY_NUMERIC, type AiDebt, type AiMaintenanceCost, type AiMaintenanceCostResult, type AstroComponentFact, type AutoRelaxedRule, type AutoTunedRule, type BaselineCache, type BaselineMeta, type CachedFile, type Category, type ClassNameFact, type ClusterInput, type ClusterParamOverrides, type ClusterParams, type CommentFact, type ComponentFacts, type ComponentScore, type ComponentSizeFact, type CompositeRule, type CompositeRuleEntry, type ConsoleCallFact, type Constitution, DEFAULT_CONFIG, type DangerouslySetInnerHtmlFact, type DbDriftLevel, type DbFinding, type DialogCallFact, type DisabledLintRuleFact, type DocDriftLevel, type DocFinding, type DomQueryFact, type ElementFact, type EvalCallFact, type ExplicitAnyFact, type FetchCallFact, type FileScanResult, type FixSuggestion, type FlywheelOutput, type FlywheelState, type Framework$1 as Framework, type HealthFile, type HookCallFact, type HookDependencyArrayFact, type HookFact, type ImportFact, type InlineEventHandlerFact, type Issue, type JsxAttributeStringLiteralFact, type JsxTextLiteralFact, type KeyPropFact, type LogicalExpressionFact, type MagicNumberSpacingConfig, type MaintenanceAxes, type MaintenanceAxisHealth, type NonNullAssertionFact, type OptimisticUpdateFact, type ProjectReport, type PropMutationFact, type PropPassThroughFact, REPOSITORY_HEALTH_WEIGHTS, type ReportReadResult, type RepositoryHealth, type RepositoryHealthInputs, type ResearchMetrics, type ResolvedConfig, type Rule, type RuleContext, type RuleSeverity, type RuleSuggestion, type ScanCache, type ScanFacts, type ScanProjectOptions, type ScanSelfScanConfig, type Severity, type SlopAuditRun, type StateBinding, type StateBindingFact, type StringLiteralFact, type StylePropFact, type TamaguiStylePropFact, type TopOffender, type UseEffectBodyFact, VERSION, baselineStatusMessage, colorForSlop, failedThresholdCount, filterByDisabledDirectives, filterIssues, formatBadge, formatReportFromFile, formatSparkline, loadConfig, readReportFile, runCli, runInitWizard, scanProject, serializeConfig, stagedGating, thresholdExceeded };
+export { AI_SECURITY_NUMERIC, type AiDebt, type AiMaintenanceCost, type AiMaintenanceCostResult, type AstroComponentFact, type AutoRelaxedRule, type AutoTunedRule, type BaselineCache, type BaselineMeta, type CachedFile, type Category, type ClassNameFact, type ClusterInput, type ClusterParamOverrides, type ClusterParams, type CommentFact, type ComponentFacts, type ComponentScore, type ComponentSizeFact, type CompositeRule, type CompositeRuleEntry, type ConsoleCallFact, type Constitution, DEFAULT_CONFIG, type DangerouslySetInnerHtmlFact, type DbDriftLevel, type DbFinding, type DialogCallFact, type DisabledLintRuleFact, type DocDriftLevel, type DocFinding, type DomQueryFact, type ElementFact, type EvalCallFact, type ExplicitAnyFact, type FetchCallFact, type FileScanResult, type FixSuggestion, type FlywheelOutput, type FlywheelState, type Framework$1 as Framework, type HealthFile, type HookCallFact, type HookDependencyArrayFact, type HookFact, type ImportFact, type InlineEventHandlerFact, type Issue, type JsxAttributeStringLiteralFact, type JsxTextLiteralFact, type KeyPropFact, type LogicalExpressionFact, type MagicNumberSpacingConfig, type MaintenanceAxes, type MaintenanceAxisHealth, type NonNullAssertionFact, type OptimisticUpdateFact, type ProjectReport, type PropMutationFact, type PropPassThroughFact, REPOSITORY_HEALTH_WEIGHTS, type ReportReadResult, type RepositoryHealth, type RepositoryHealthInputs, type ResearchMetrics, type ResolvedConfig, type Rule, type RuleContext, type RuleSeverity, type RuleSuggestion, type ScanCache, type ScanFacts, type ScanProjectOptions, type ScanSelfScanConfig, type Severity, type SlopAuditRun, type StateBinding, type StateBindingFact, type StringLiteralFact, type StylePropFact, type TamaguiStylePropFact, type TopOffender, type UseEffectBodyFact, VERSION, baselineStatusMessage, colorForSlop, failedThresholdCount, failedThresholds, filterByDisabledDirectives, filterIssues, formatBadge, formatReportFromFile, formatSparkline, loadConfig, readReportFile, runCli, runInitWizard, scanProject, serializeConfig, stagedGating, thresholdExceeded };