moult 0.1.0

data/schema/health.schema.json

@@ -0,0 +1,157 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/moult-rb/moult-rb/blob/main/schema/health.schema.json",
+  "title": "Moult health report",
+  "description": "Typed output contract for `moult health`. One of Moult's two protected APIs. The composite is a confidence-graded health SIGNAL aggregated from the other analyses, never a verdict: it carries its contributing components and their reasons so the number is auditable, and it never asserts a pass/fail. The components list is open: future analyses (boundaries, flags) plug in as additional entries without a schema bump.",
+  "type": "object",
+  "required": ["schema_version", "tool", "analysis", "overall", "components", "files"],
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": {
+      "description": "Bumped only on a breaking change to this shape.",
+      "type": "integer",
+      "const": 1
+    },
+    "tool": {
+      "type": "object",
+      "required": ["name", "version"],
+      "additionalProperties": false,
+      "properties": {
+        "name": {"type": "string"},
+        "version": {"type": "string"}
+      }
+    },
+    "analysis": {
+      "type": "object",
+      "required": ["root", "git_ref", "generated_at", "coverage", "churn"],
+      "additionalProperties": false,
+      "properties": {
+        "root": {"type": "string"},
+        "git_ref": {"type": ["string", "null"]},
+        "generated_at": {"type": ["string", "null"], "format": "date-time"},
+        "coverage": {"$ref": "common.schema.json#/$defs/coverage_source"},
+        "churn": {
+          "type": "object",
+          "required": ["window", "since"],
+          "additionalProperties": false,
+          "properties": {
+            "window": {"description": "Human description of the churn window fed to the complexity component.", "type": ["string", "null"]},
+            "since": {"description": "Resolved --since boundary, when an explicit one was given.", "type": ["string", "null"]}
+          }
+        }
+      }
+    },
+    "overall": {
+      "description": "The composite health signal. score/grade are null only when no component ran.",
+      "type": "object",
+      "required": ["score", "grade", "components_present", "components_total", "files_total"],
+      "additionalProperties": false,
+      "properties": {
+        "score": {"$ref": "#/$defs/nullable_unit_interval"},
+        "grade": {"$ref": "#/$defs/nullable_grade"},
+        "components_present": {"description": "Components that actually contributed to the composite.", "type": "integer", "minimum": 0},
+        "components_total": {"description": "Components considered (present + skipped + errored).", "type": "integer", "minimum": 0},
+        "files_total": {"description": "Signal-bearing files; files[] may be display-limited but this is the full count.", "type": "integer", "minimum": 0}
+      }
+    },
+    "components": {
+      "description": "One entry per considered analysis. Absent analyses still appear (present=false) so the record of what ran is honest. Open-ended: new analyses add entries without a schema bump.",
+      "type": "array",
+      "items": {"$ref": "#/$defs/component"}
+    },
+    "files": {
+      "description": "Per-file roll-up, the cross-analysis join surface. Each file carries its contributing symbol_ids so findings join to the hotspots/deadcode/duplication/coverage contracts.",
+      "type": "array",
+      "items": {"$ref": "#/$defs/file"}
+    }
+  },
+  "$defs": {
+    "nullable_unit_interval": {
+      "description": "A health score in [0, 1] (1 = healthy), or null where not asserted. A graded signal, never a verdict.",
+      "oneOf": [
+        {"type": "null"},
+        {"$ref": "common.schema.json#/$defs/unit_interval"}
+      ]
+    },
+    "grade": {
+      "description": "Letter grade bucketed from a health score. A coarse reading of the same signal, never a pass/fail gate.",
+      "type": "string",
+      "enum": ["A", "B", "C", "D", "F"]
+    },
+    "nullable_grade": {
+      "oneOf": [
+        {"type": "null"},
+        {"$ref": "#/$defs/grade"}
+      ]
+    },
+    "reason": {
+      "description": "One auditable contribution to a component's sub-score. `value` is the observed [0, 1] quantity (a ratio/sub-score), not a signed delta - health sub-scores are ratios, not delta-sums.",
+      "type": "object",
+      "required": ["rule", "value", "detail"],
+      "additionalProperties": false,
+      "properties": {
+        "rule": {"type": "string"},
+        "value": {"$ref": "common.schema.json#/$defs/unit_interval"},
+        "detail": {"type": "string"}
+      }
+    },
+    "component": {
+      "description": "One graded component of the composite. Carries its category, its static weight, its renormalized share among present components, an auditable stats summary, and its reasons. Never asserts certainty.",
+      "type": "object",
+      "required": ["name", "category", "present", "score", "weight", "normalized_weight", "summary", "reasons", "diagnostic"],
+      "additionalProperties": false,
+      "properties": {
+        "name": {"description": "Stable component slot key, e.g. \"complexity\", \"dead_code\", \"duplication\", \"coverage\".", "type": "string"},
+        "category": {"$ref": "common.schema.json#/$defs/category"},
+        "present": {"description": "Whether this analysis contributed to the composite.", "type": "boolean"},
+        "score": {
+          "description": "Health sub-score in [0, 1] (1 = healthy); null when the component is absent.",
+          "$ref": "#/$defs/nullable_unit_interval"
+        },
+        "weight": {
+          "description": "Static, pinned weight of this component before renormalization.",
+          "$ref": "common.schema.json#/$defs/unit_interval"
+        },
+        "normalized_weight": {
+          "description": "Share of the composite this component carried, renormalized over present components; null when absent.",
+          "$ref": "#/$defs/nullable_unit_interval"
+        },
+        "summary": {
+          "description": "Small free-form stats hash backing the sub-score (counts/ratios). Auditable, not a strict surface; {} when absent.",
+          "type": "object"
+        },
+        "reasons": {
+          "description": "The observations behind the sub-score, in application order.",
+          "type": "array",
+          "items": {"$ref": "#/$defs/reason"}
+        },
+        "diagnostic": {
+          "description": "Why a component was skipped or errored; null when it contributed normally.",
+          "type": ["string", "null"]
+        }
+      }
+    },
+    "file": {
+      "description": "One file's rolled-up health. Joins to the other analyses via the symbol_ids it lists.",
+      "type": "object",
+      "required": ["path", "score", "grade", "components", "symbol_ids", "symbol_count"],
+      "additionalProperties": false,
+      "properties": {
+        "path": {"type": "string"},
+        "score": {"$ref": "common.schema.json#/$defs/unit_interval"},
+        "grade": {"$ref": "#/$defs/grade"},
+        "components": {
+          "description": "Per-component sub-scores for this file, present components only. Open-ended map keyed by component name.",
+          "type": "object",
+          "additionalProperties": {"$ref": "common.schema.json#/$defs/unit_interval"}
+        },
+        "symbol_ids": {
+          "description": "Contributing join keys (\"<path>:<start_line>:<fqname>\"), shared with the other contracts. Capped for payload size; symbol_count records the true total.",
+          "type": "array",
+          "items": {"type": "string"}
+        },
+        "symbol_count": {"description": "Total contributing symbols before the symbol_ids cap.", "type": "integer", "minimum": 0}
+      }
+    }
+  }
+}

data/schema/hotspots.schema.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/moult-rb/moult-rb/blob/main/schema/hotspots.schema.json",
+  "title": "Moult hotspots report",
+  "description": "Typed output contract for `moult hotspots`. One of Moult's two protected APIs.",
+  "type": "object",
+  "required": ["schema_version", "tool", "analysis", "hotspots"],
+  "additionalProperties": false,
+  "properties": {
+    "schema_version": {
+      "description": "Bumped only on a breaking change to this shape.",
+      "type": "integer",
+      "const": 1
+    },
+    "tool": {
+      "type": "object",
+      "required": ["name", "version"],
+      "additionalProperties": false,
+      "properties": {
+        "name": {"type": "string"},
+        "version": {"type": "string"}
+      }
+    },
+    "analysis": {
+      "type": "object",
+      "required": ["root", "git_ref", "generated_at", "churn"],
+      "additionalProperties": false,
+      "properties": {
+        "root": {"type": "string"},
+        "git_ref": {"type": ["string", "null"]},
+        "generated_at": {"type": ["string", "null"], "format": "date-time"},
+        "churn": {
+          "type": "object",
+          "required": ["window", "since"],
+          "additionalProperties": false,
+          "properties": {
+            "window": {"type": ["string", "null"]},
+            "since": {"type": ["string", "null"]}
+          }
+        }
+      }
+    },
+    "hotspots": {
+      "type": "array",
+      "items": {"$ref": "#/$defs/hotspot"}
+    }
+  },
+  "$defs": {
+    "method": {
+      "type": "object",
+      "required": ["symbol_id", "name", "span", "abc", "confidence", "category"],
+      "additionalProperties": false,
+      "properties": {
+        "symbol_id": {
+          "description": "Stable join key for the Phase 3 coverage merge: \"<path>:<start_line>:<fqname>\".",
+          "type": "string"
+        },
+        "name": {
+          "description": "Lexical fully-qualified name (Class#method or Class.method).",
+          "type": "string"
+        },
+        "span": {"$ref": "common.schema.json#/$defs/span"},
+        "abc": {
+          "description": "Flog-style weighted ABC complexity score.",
+          "type": "number",
+          "minimum": 0
+        },
+        "confidence": {"$ref": "common.schema.json#/$defs/confidence"},
+        "category": {"$ref": "common.schema.json#/$defs/category"}
+      }
+    },
+    "hotspot": {
+      "type": "object",
+      "required": ["path", "score", "complexity", "churn", "methods", "confidence", "category"],
+      "additionalProperties": false,
+      "properties": {
+        "path": {
+          "description": "Path relative to the analysis root.",
+          "type": "string"
+        },
+        "score": {
+          "description": "Ranking score: complexity x churn.",
+          "type": "number",
+          "minimum": 0
+        },
+        "complexity": {
+          "description": "Aggregate ABC complexity for the file.",
+          "type": "number",
+          "minimum": 0
+        },
+        "churn": {
+          "description": "Commits touching the file within the churn window.",
+          "type": "integer",
+          "minimum": 0
+        },
+        "methods": {
+          "description": "Worst methods in the file, highest ABC first.",
+          "type": "array",
+          "items": {"$ref": "#/$defs/method"}
+        },
+        "confidence": {"$ref": "common.schema.json#/$defs/confidence"},
+        "category": {"$ref": "common.schema.json#/$defs/category"}
+      }
+    }
+  }
+}

metadata

@@ -0,0 +1,185 @@
+--- !ruby/object:Gem::Specification
+name: moult
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- The Moult authors
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-06-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: prism
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.24'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.24'
+- !ruby/object:Gem::Dependency
+  name: rubydex
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: flay
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+description: Moult sheds dead code. `moult hotspots` ranks files by a complexity x
+  churn score (Prism-parsed ABC complexity per method x per-file git churn); `moult
+  deadcode` lists confidence-graded unused-method and unused-constant candidates over
+  a rubydex definition graph, with Rails entrypoint awareness. Every finding carries
+  a confidence and its reasons, never a claim of certain death.
+email:
+- contact@moult.dev
+executables:
+- moult
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- NOTICE
+- README.md
+- exe/moult
+- lib/moult.rb
+- lib/moult/abc.rb
+- lib/moult/boundaries.rb
+- lib/moult/boundaries/packwerk.rb
+- lib/moult/boundaries/severity.rb
+- lib/moult/boundaries_report.rb
+- lib/moult/churn.rb
+- lib/moult/cli.rb
+- lib/moult/cli/boundaries_command.rb
+- lib/moult/cli/coverage_command.rb
+- lib/moult/cli/dead_code_command.rb
+- lib/moult/cli/duplication_command.rb
+- lib/moult/cli/flags_command.rb
+- lib/moult/cli/gate_command.rb
+- lib/moult/cli/health_command.rb
+- lib/moult/cli/hotspots_command.rb
+- lib/moult/clones.rb
+- lib/moult/cloud_upload.rb
+- lib/moult/confidence.rb
+- lib/moult/confidence/rules.rb
+- lib/moult/coverage.rb
+- lib/moult/coverage/resolver.rb
+- lib/moult/coverage_report.rb
+- lib/moult/dead_code.rb
+- lib/moult/dead_code_report.rb
+- lib/moult/diff.rb
+- lib/moult/discovery.rb
+- lib/moult/duplication.rb
+- lib/moult/duplication/confidence.rb
+- lib/moult/duplication_report.rb
+- lib/moult/flag_scanner.rb
+- lib/moult/flags.rb
+- lib/moult/flags/classification.rb
+- lib/moult/flags/snapshot.rb
+- lib/moult/flags/staleness.rb
+- lib/moult/flags_report.rb
+- lib/moult/formatters/boundaries_json.rb
+- lib/moult/formatters/boundaries_table.rb
+- lib/moult/formatters/coverage_json.rb
+- lib/moult/formatters/coverage_table.rb
+- lib/moult/formatters/dead_code_json.rb
+- lib/moult/formatters/dead_code_table.rb
+- lib/moult/formatters/duplication_json.rb
+- lib/moult/formatters/duplication_table.rb
+- lib/moult/formatters/flags_json.rb
+- lib/moult/formatters/flags_table.rb
+- lib/moult/formatters/gate_github.rb
+- lib/moult/formatters/gate_json.rb
+- lib/moult/formatters/gate_message.rb
+- lib/moult/formatters/gate_sarif.rb
+- lib/moult/formatters/gate_table.rb
+- lib/moult/formatters/health_json.rb
+- lib/moult/formatters/health_table.rb
+- lib/moult/formatters/json.rb
+- lib/moult/formatters/table.rb
+- lib/moult/formatters/text_table.rb
+- lib/moult/gate.rb
+- lib/moult/gate/config.rb
+- lib/moult/gate/evaluation.rb
+- lib/moult/gate/policy.rb
+- lib/moult/gate_report.rb
+- lib/moult/git.rb
+- lib/moult/health.rb
+- lib/moult/health/score.rb
+- lib/moult/health_report.rb
+- lib/moult/index.rb
+- lib/moult/parser.rb
+- lib/moult/rails_conventions.rb
+- lib/moult/report.rb
+- lib/moult/scoring.rb
+- lib/moult/span.rb
+- lib/moult/symbol_id.rb
+- lib/moult/symbol_scanner.rb
+- lib/moult/version.rb
+- schema/boundaries.schema.json
+- schema/common.schema.json
+- schema/coverage.schema.json
+- schema/deadcode.schema.json
+- schema/duplication.schema.json
+- schema/flags.schema.json
+- schema/gate.schema.json
+- schema/health.schema.json
+- schema/hotspots.schema.json
+homepage: https://github.com/moult-rb/moult-rb
+licenses:
+- Apache-2.0
+metadata:
+  homepage_uri: https://github.com/moult-rb/moult-rb
+  source_code_uri: https://github.com/moult-rb/moult-rb
+  changelog_uri: https://github.com/moult-rb/moult-rb/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/moult-rb/moult-rb/issues
+  documentation_uri: https://github.com/moult-rb/moult-rb#readme
+  rubygems_mfa_required: 'true'
+  allowed_push_host: https://rubygems.org
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Confidence-graded codebase intelligence for Ruby and Rails.
+test_files: []