code-state — anomaly A2 detector

Package scope and prerequisites

This catalog ships instructions, not the executable runtime. Python modules, scripts, local services and optional tools named below must be installed separately from the upstream project. Check their availability before running commands; if they are missing, explain the prerequisite instead of claiming execution or results. The host agent may use model tokens while following these instructions.

Commands, APIs and runtime behavior described below are conditional examples for a compatible upstream installation; they are not evidence of execution in this package.

When NOT to use

• The smell is a duplicated function body — use code_duplication.
• The smell is a chain of passthrough functions — use code_wrappers.

The upstream detector is described by A2 of the upstream docs/local-analysis-policy.md (not bundled here):

• etat_global — module-level NAME = {} / [] / set() / dict() (and common constructors). Constants and None are ignored. Assignments inside if TYPE_CHECKING are ignored.
• import_circulaire — cycles in the local import graph. Relative and absolute imports that resolve inside the scanned tree are followed. if TYPE_CHECKING imports are not edges.

python -m skills.code_state.cli [path]
python -m skills.code_state.cli skills --json
python -m skills.code_state.test_code_state

The documented upstream mode is report-only; verify the installed command exit status and CI integration. Pairs with code_wrappers (A3).