JobyKit.Lint (JobyKit v0.1.0)

Lint engine for JobyKit-installed apps. Verifies wrapper-contract invariants by introspecting a manifest module and scanning the host's component source files.

Rules

:manifest_drift (error) — a manifest entry points at a function that is not actually a Phoenix function component. Caught first because every other check depends on the entry being live.
:missing_data_component (error) — a registered wrapper does not carry data-component="Module.function" in its source.
:missing_rest_global (warning) — a registered wrapper does not declare attr :rest, :global, blocking pass-through of phx- and aria- attributes from callers.
:unregistered_wrapper (warning) — a function carries a data-component="..." attribute but is not registered in the manifest, making it invisible to /design.json and to agents.

Each violation is a map with :rule, :severity, :message, :file, :line, :module, :function. The engine is pure data — formatting and exit codes live in Mix.Tasks.JobyKit.Lint.

Summary

Run the lint engine. Returns a list of violations in deterministic order (drift first, then per-entry checks in manifest declaration order, then unregistered wrappers sorted by data-component string).

Types

severity()

@type severity() :: :error | :warning | :info

violation()

@type violation() :: %{
  rule: atom(),
  severity: severity(),
  message: String.t(),
  file: String.t() | nil,
  line: non_neg_integer() | nil,
  module: module() | nil,
  function: atom() | nil
}

Functions

run(opts)

@spec run(keyword()) :: [violation()]

Options

:manifest — required. The host's manifest module (use JobyKit.Manifest).
:paths — list of glob patterns to scan for the unregistered- wrapper rule. Defaults to ["lib/**/*.ex"]. Patterns are resolved relative to cwd.