fensu-cli 0.2.1__tar.gz → 0.4.0__tar.gz

{fensu_cli-0.2.1 → fensu_cli-0.4.0}/Cargo.lock

@@ -23,6 +23,12 @@ version = "0.2.21"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "683d7910e743518b0e34f1186f92494becacb047c7b6bf616c96772180fef923"
 
+[[package]]
+name = "ambient-authority"
+version = "0.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e9d4ee0d472d1cd2e28c97dfa124b3d8d992e10eb0a035f33f5d12e3a177ba3b"
+
 [[package]]
 name = "arc-swap"
 version = "1.9.2"
@@ -118,6 +124,48 @@ version = "1.12.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "fc652a48c352aef3ea3aed32080501cf3ef6ed5da78602a020c991775b0aff04"
 
+[[package]]
+name = "cap-fs-ext"
+version = "4.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d78e5a3368ae89b7cb68186411452b4b9fac8b41be9c19bf3f47c2d2c8e36e6b"
+dependencies = [
+ "cap-primitives",
+ "cap-std",
+ "io-lifetimes 3.0.1",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "cap-primitives"
+version = "4.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cdadbd7c002d3a484b35243669abdae85a0ebaded5a61117169dc3400f9a7ff0"
+dependencies = [
+ "ambient-authority",
+ "fs-set-times",
+ "io-extras",
+ "io-lifetimes 3.0.1",
+ "ipnet",
+ "maybe-owned",
+ "rustix",
+ "rustix-linux-procfs",
+ "windows-sys 0.61.2",
+ "winx",
+]
+
+[[package]]
+name = "cap-std"
+version = "4.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7281235d6e96d3544ca18bba9049be92f4190f8d923e3caef1b5f66cfa752608"
+dependencies = [
+ "cap-primitives",
+ "io-extras",
+ "io-lifetimes 3.0.1",
+ "rustix",
+]
+
 [[package]]
 name = "castaway"
 version = "0.2.4"
@@ -311,7 +359,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb"
 dependencies = [
  "libc",
- "windows-sys",
+ "windows-sys 0.61.2",
 ]
 
 [[package]]
@@ -344,8 +392,12 @@ checksum = "9f1f227452a390804cdb637b74a86990f2a7d7ba4b7d5693aac9b4dd6defd8d6"
 
 [[package]]
 name = "fensu-cli"
-version = "0.2.1"
+version = "0.4.0"
 dependencies = [
+ "cap-fs-ext",
+ "cap-std",
+ "dunce",
+ "encoding_rs",
  "fensu-facts",
  "fensu-memory",
  "fensu-native",
@@ -356,7 +408,9 @@ dependencies = [
  "serde",
  "serde_json",
  "sha2",
+ "tempfile",
  "toml",
+ "unicode-normalization",
  "walkdir",
 ]
 
@@ -382,6 +436,7 @@ version = "0.1.0"
 dependencies = [
  "gix",
  "hex",
+ "libc",
  "pulldown-cmark",
  "rayon",
  "rusqlite",
@@ -401,8 +456,10 @@ dependencies = [
  "rayon",
  "ruff_python_ast",
  "rusqlite",
+ "serde",
  "serde_json",
  "sha2",
+ "tempfile",
  "unicode-ident",
 ]
 
@@ -456,6 +513,17 @@ version = "0.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "77ce24cb58228fbb8aa041425bb1050850ac19177686ea6e0f41a70416f56fdb"
 
+[[package]]
+name = "fs-set-times"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94e7099f6313ecacbe1256e8ff9d617b75d1bcb16a6fddef94866d225a01a14a"
+dependencies = [
+ "io-lifetimes 2.0.4",
+ "rustix",
+ "windows-sys 0.59.0",
+]
+
 [[package]]
 name = "generic-array"
 version = "0.14.7"
@@ -1050,7 +1118,7 @@ dependencies = [
  "bitflags 2.13.0",
  "gix-path",
  "libc",
- "windows-sys",
+ "windows-sys 0.61.2",
 ]
 
 [[package]]
@@ -1274,6 +1342,34 @@ version = "0.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "71dd52191aae121e8611f1e8dc3e324dd0dd1dee1e6dd91d10ee07a3cfb4d9d8"
 
+[[package]]
+name = "io-extras"
+version = "0.19.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "20fd6de4ccfcc187e38bc21cfa543cb5a302cb86a8b114eb7f0bf0dc9f8ac00f"
+dependencies = [
+ "io-lifetimes 3.0.1",
+ "windows-sys 0.60.2",
+]
+
+[[package]]
+name = "io-lifetimes"
+version = "2.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "06432fb54d3be7964ecd3649233cddf80db2832f47fec34c01f65b3d9d774983"
+
+[[package]]
+name = "io-lifetimes"
+version = "3.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2f0fb0570afe1fed943c5c3d4102d5358592d8625fda6a0007fdbe65a92fba96"
+
+[[package]]
+name = "ipnet"
+version = "2.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d98f6fed1fde3f8c21bc40a1abb88dd75e67924f9cffc3ef95607bad8017f8e2"
+
 [[package]]
 name = "is-macro"
 version = "0.3.7"
@@ -1445,6 +1541,12 @@ dependencies = [
  "syn",
 ]
 
+[[package]]
+name = "maybe-owned"
+version = "0.3.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4facc753ae494aeb6e3c22f839b158aebd4f9270f55cd3c79906c45476c47ab4"
+
 [[package]]
 name = "memchr"
 version = "2.8.3"
@@ -1914,7 +2016,17 @@ dependencies = [
  "errno",
  "libc",
  "linux-raw-sys",
- "windows-sys",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "rustix-linux-procfs"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2fc84bf7e9aa16c4f2c758f27412dc9841341e16aa682d9c7ac308fe3ee12056"
+dependencies = [
+ "once_cell",
+ "rustix",
 ]
 
 [[package]]
@@ -2110,7 +2222,7 @@ dependencies = [
  "getrandom 0.4.3",
  "once_cell",
  "rustix",
- "windows-sys",
+ "windows-sys 0.61.2",
 ]
 
 [[package]]
@@ -2333,7 +2445,7 @@ version = "0.1.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22"
 dependencies = [
- "windows-sys",
+ "windows-sys 0.61.2",
 ]
 
 [[package]]
@@ -2342,6 +2454,24 @@ version = "0.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
 
+[[package]]
+name = "windows-sys"
+version = "0.59.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1e38bc4d79ed67fd075bcc251a1c39b32a1776bbe92e5bef1f0bf1f8c531853b"
+dependencies = [
+ "windows-targets 0.52.6",
+]
+
+[[package]]
+name = "windows-sys"
+version = "0.60.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2f500e4d28234f72040990ec9d39e3a6b950f9f22d3dba18416c35882612bcb"
+dependencies = [
+ "windows-targets 0.53.5",
+]
+
 [[package]]
 name = "windows-sys"
 version = "0.61.2"
@@ -2351,6 +2481,135 @@ dependencies = [
  "windows-link",
 ]
 
+[[package]]
+name = "windows-targets"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973"
+dependencies = [
+ "windows_aarch64_gnullvm 0.52.6",
+ "windows_aarch64_msvc 0.52.6",
+ "windows_i686_gnu 0.52.6",
+ "windows_i686_gnullvm 0.52.6",
+ "windows_i686_msvc 0.52.6",
+ "windows_x86_64_gnu 0.52.6",
+ "windows_x86_64_gnullvm 0.52.6",
+ "windows_x86_64_msvc 0.52.6",
+]
+
+[[package]]
+name = "windows-targets"
+version = "0.53.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4945f9f551b88e0d65f3db0bc25c33b8acea4d9e41163edf90dcd0b19f9069f3"
+dependencies = [
+ "windows-link",
+ "windows_aarch64_gnullvm 0.53.1",
+ "windows_aarch64_msvc 0.53.1",
+ "windows_i686_gnu 0.53.1",
+ "windows_i686_gnullvm 0.53.1",
+ "windows_i686_msvc 0.53.1",
+ "windows_x86_64_gnu 0.53.1",
+ "windows_x86_64_gnullvm 0.53.1",
+ "windows_x86_64_msvc 0.53.1",
+]
+
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
+
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a9d8416fa8b42f5c947f8482c43e7d89e73a173cead56d044f6a56104a6d1b53"
+
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
+
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b9d782e804c2f632e395708e99a94275910eb9100b2114651e04744e9b125006"
+
+[[package]]
+name = "windows_i686_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
+
+[[package]]
+name = "windows_i686_gnu"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "960e6da069d81e09becb0ca57a65220ddff016ff2d6af6a223cf372a506593a3"
+
+[[package]]
+name = "windows_i686_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
+
+[[package]]
+name = "windows_i686_gnullvm"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fa7359d10048f68ab8b09fa71c3daccfb0e9b559aed648a8f95469c27057180c"
+
+[[package]]
+name = "windows_i686_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
+
+[[package]]
+name = "windows_i686_msvc"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1e7ac75179f18232fe9c285163565a57ef8d3c89254a30685b57d83a38d326c2"
+
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
+
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9c3842cdd74a865a8066ab39c8a7a473c0778a3f29370b5fd6b4b9aa7df4a499"
+
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
+
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ffa179e2d07eee8ad8f57493436566c7cc30ac536a3379fdf008f47f6bb7ae1"
+
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
+
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d6bbff5f0aada427a1e5a6da5f1f98158182f26556f345ac9e04d36d0ebed650"
+
 [[package]]
 name = "winnow"
 version = "0.7.15"
@@ -2363,6 +2622,16 @@ version = "1.0.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "23b97319f7b8343df12cc98938e5c3eb436064524c8d2b4e30a1d3a36eecdf81"
 
+[[package]]
+name = "winx"
+version = "0.36.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3f3fd376f71958b862e7afb20cfe5a22830e1963462f3a17f49d82a6c1d1f42d"
+dependencies = [
+ "bitflags 2.13.0",
+ "windows-sys 0.59.0",
+]
+
 [[package]]
 name = "zerocopy"
 version = "0.8.54"

{fensu_cli-0.2.1 → fensu_cli-0.4.0}/Cargo.toml

@@ -8,11 +8,15 @@ license = "Apache-2.0"
 publish = false
 
 [workspace.dependencies]
+cap-fs-ext = "4"
+cap-std = "4"
 dunce = "1.0"
+encoding_rs = "0.8"
 flate2 = { version = "1", default-features = false, features = ["zlib"] }
 gix = { version = "0.85.0", default-features = false, features = ["excludes", "sha1"] }
 globset = "0.4"
 hex = "0.4"
+libc = "0.2"
 proc-macro2 = { version = "1", features = ["span-locations"] }
 pyo3 = { version = "0.29", features = ["abi3-py312"] }
 pulldown-cmark = { version = "0.13.4", default-features = false }
@@ -32,6 +36,7 @@ syn = { version = "2", features = ["full", "visit", "extra-traits"] }
 tempfile = "3"
 toml = "0.9"
 unicode-ident = "1"
+unicode-normalization = "0.1"
 walkdir = "2"
 
 [workspace.lints.rust]

{fensu_cli-0.2.1 → fensu_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fensu-cli
-Version: 0.2.1
+Version: 0.4.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
@@ -16,7 +16,7 @@ Project-URL: Repository, https://github.com/chio-labs/fensu
 
 # fensu-cli
 
-This package supplies the native `fensu` executable. Install `fensu` for
-the Python authoring API, native extension, command fallback, and this binary as
-one locked dependency set.
+This package supplies the native `fensu` executable. Install `fensu` for the
+Python authoring API, native extension, callback host, and this binary as one
+locked dependency set.
 

fensu_cli-0.4.0/README.md

@@ -0,0 +1,5 @@
+# fensu-cli
+
+This package supplies the native `fensu` executable. Install `fensu` for the
+Python authoring API, native extension, callback host, and this binary as one
+locked dependency set.

{fensu_cli-0.2.1 → fensu_cli-0.4.0}/crates/fensu-cli/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "fensu-cli"
-version = "0.2.1" # x-release-please-version
+version = "0.4.0" # x-release-please-version
 edition.workspace = true
 license.workspace = true
 publish = false
@@ -14,6 +14,10 @@ name = "fensu"
 path = "src/main.rs"
 
 [dependencies]
+cap-fs-ext.workspace = true
+cap-std.workspace = true
+dunce.workspace = true
+encoding_rs.workspace = true
 globset.workspace = true
 rayon.workspace = true
 ruff_python_ast.workspace = true
@@ -23,10 +27,14 @@ serde_json.workspace = true
 sha2.workspace = true
 fensu-facts = { workspace = true, default-features = false }
 # Keep the complete local workspace dependency graph in the CLI sdist.
-fensu-memory.workspace = true
+fensu-memory = { workspace = true, features = ["sqlite-engine"] }
 fensu-native = { workspace = true, default-features = false }
 toml.workspace = true
+unicode-normalization.workspace = true
 walkdir.workspace = true
 
+[dev-dependencies]
+tempfile.workspace = true
+
 [build-dependencies]
 serde_json.workspace = true

fensu_cli-0.4.0/crates/fensu-cli/assets/catalogue.json

@@ -0,0 +1 @@
+[{"code":"FFA001","family":"annotations","slug":"parameter-annotation","message":"function parameters must define type annotations","remediation":"Annotate every parameter with the value type accepted by the function.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFA002","family":"annotations","slug":"return-annotation","message":"functions must define return type annotations","remediation":"Declare the returned value type, using None when the function returns no value.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFA101","family":"annotations","slug":"module-variable-annotation","message":"module-level variables must define type annotations","remediation":"Add an explicit annotation to the first module-level assignment.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFA102","family":"annotations","slug":"class-attribute-annotation","message":"class attributes must define type annotations","remediation":"Annotate the class attribute where it is first assigned.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFA103","family":"annotations","slug":"local-variable-annotation","message":"local variables must define type annotations on first binding unless assigned a scalar literal","remediation":"Annotate first bindings whose type is not evident from a number, string, bool, bytes, or f-string literal.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFL001","family":"layers","slug":"absolute-imports-only","message":"use absolute imports; relative imports hide package boundaries","remediation":"Replace relative imports with an absolute import path.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFL002","family":"layers","slug":"no-star-imports","message":"star imports hide names from dependency-boundary analysis","remediation":"Import each required name explicitly.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFL101","family":"layers","slug":"no-sibling-package-internals","message":"subpackage code must not import sibling internals","remediation":"Publish the dependency through the owning sibling's main/ entry or role files.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFL102","family":"layers","slug":"no-cross-package-internals","message":"cross-package imports must use public surfaces, not helpers or internals","remediation":"Import from classes, models, types, constants, exceptions, or a thin main/ entry.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFL103","family":"layers","slug":"no-internal-public-surface-imports","message":"internal code must import from the owning module, not the bare package","remediation":"Import from the concrete owning module below the package surface.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFL104","family":"layers","slug":"no-cross-domain-private-main-imports","message":"domain-private main entries may only be imported within their owning domain","remediation":"Remove the leading underscore to publish the main entry, or route the caller through a public main entry owned by the target domain.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFL105","family":"layers","slug":"public-main-entry-external-use","message":"public main entries must have an importer outside their owning domain","remediation":"Prefix the entry module filename with '_' until another domain or tooling imports it.","severity":"error","enabled_by_default":true,"execution_owner":"project"},{"code":"FFL110","family":"layers","slug":"no-cross-file-use-of-helper-private-class","message":"helper-private classes are file-local details; move shared classes to classes/","remediation":"If another module needs this class, move it to the owning classes/ package.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFL301","family":"layers","slug":"no-runtime-imports-from-tooling","message":"runtime code must not import from tooling modules","remediation":"Move reusable logic into the runtime package or keep the dependency inside tooling.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFH001","family":"hygiene","slug":"single-line-docstrings","message":"docstrings must be a single line; move extended explanation into docs or tests","remediation":"Keep one concise summary line and move extended rationale into documentation or tests.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFH002","family":"hygiene","slug":"no-standalone-comments","message":"standalone comments are not allowed; prefer clear names or docs/tests","remediation":"Replace the comment with clearer names or move lasting explanation into documentation or tests.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFH003","family":"hygiene","slug":"no-raw-builtin-raise","message":"runtime code must raise structured errors instead of raw built-in exceptions","remediation":"Raise a domain-specific exception from exceptions.py with a stable actionable message.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFH004","family":"hygiene","slug":"no-assert-in-runtime","message":"runtime code must not use assert for invariants; raise a structured error","remediation":"Replace assert with an explicit guard that raises a domain-specific exception.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFH005","family":"hygiene","slug":"no-swallowed-exception-probe","message":"runtime code must not swallow broad exceptions as existence probe answers","remediation":"Use an explicit metadata or existence check, or catch only the expected exception and preserve failures.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFH006","family":"hygiene","slug":"no-complex-comprehensions-in-tooling","message":"nested or multi-generator comprehensions hide control flow and data shapes","remediation":"Extract a named helper when the transformation has a coherent purpose. For one-off local logic, use simple statements with named intermediate values instead of nested comprehension control flow.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFH007","family":"hygiene","slug":"no-unnamed-string-decisions","message":"string literals must not directly control comparison behavior","remediation":"Name the decision value in constants.py or compare against an enum member so the branch expresses the concept it represents.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFH008","family":"hygiene","slug":"no-magic-numeric-comparisons","message":"non-canonical numeric literals must not directly control comparisons","remediation":"Name the threshold or sentinel in constants.py and compare against that name; only -1, 0, and 1 are self-explanatory comparison values.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFH009","family":"hygiene","slug":"no-import-time-side-effects","message":"runtime and tooling modules must not execute standalone calls during import","remediation":"Move the operation into an explicit function or assign a pure constructor result.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFS001","family":"shape","slug":"too-many-statements","message":"main functions must stay phase-shaped and below the statement limit","remediation":"Extract cohesive phases into helpers that return explicit result models.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFS002","family":"shape","slug":"too-many-distinct-calls","message":"main functions must not coordinate too many distinct callees","remediation":"Group related work into named phase helpers and keep main/ as a short ordered flow.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFS003","family":"shape","slug":"too-many-locals","message":"main functions must not juggle too many local variables","remediation":"Let each extracted phase own its intermediates and return one structured result.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFS010","family":"shape","slug":"max-arguments","message":"functions must stay below the configured argument limit","remediation":"Reduce the function's responsibility or group cohesive inputs into a typed model.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFS011","family":"shape","slug":"max-statements-global","message":"functions must stay below the global statement limit","remediation":"Split the function at a meaningful phase boundary with explicit inputs and outputs.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFS101","family":"shape","slug":"meaningful-project-result-discarded","message":"main orchestrators must consume meaningful project-local call results","remediation":"Assign, return, or explicitly discard the phase result with _ = call(...).","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFS102","family":"shape","slug":"parameter-mutation-in-phase-helpers","message":"helpers must return values instead of mutating parameters","remediation":"Return a new or updated value so dataflow remains visible to the caller.","severity":"error","enabled_by_default":false,"execution_owner":"file"},{"code":"FFS110","family":"shape","slug":"default-mutation-return","message":"functions that mutate parameters must return every mutated parameter","remediation":"Return each mutated parameter explicitly, or avoid parameter mutation and return a new value.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFS120","family":"shape","slug":"keyword-only-arguments","message":"functions beyond the parameter threshold must be entirely keyword-only","remediation":"Insert * before the first non-receiver parameter so every call argument names its meaning.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFS130","family":"shape","slug":"no-outer-state-mutation","message":"functions must not mutate module-global or closure-captured state","remediation":"Pass state explicitly and return the updated value instead of mutating outer scope.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFS131","family":"shape","slug":"no-complex-comprehensions","message":"nested or multi-generator comprehensions hide control flow and data shapes","remediation":"Extract a named helper when the transformation has a coherent purpose. For one-off local logic, use simple statements with named intermediate values instead of nested comprehension control flow.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFS201","family":"shape","slug":"mutable-result-model","message":"dataclass result models must be frozen","remediation":"Declare the shared result model with @dataclass(frozen=True).","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT001","family":"tests","slug":"test-layout","message":"tests must live under a configured test root and supported scope","remediation":"Move the test beneath a configured test root and unit, integration, or e2e scope.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT002","family":"tests","slug":"test-scope","message":"test scope must be unit, integration, or e2e","remediation":"Move the test under tests/unit, tests/integration, or tests/e2e.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT003","family":"tests","slug":"test-mirrored-root","message":"test directories must mirror a configured runtime or tooling root","remediation":"Mirror the complete configured source or tooling path beneath the test scope.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT004","family":"tests","slug":"src-mirror-depth","message":"runtime tests must include an area beneath the configured source root","remediation":"Move the test beneath the package and source area it exercises.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT005","family":"tests","slug":"src-package-exists","message":"runtime tests must mirror a configured source package","remediation":"Correct the mirrored package name or move the test to the package it exercises.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT006","family":"tests","slug":"src-area-exists","message":"runtime tests must mirror an existing source package area","remediation":"Correct the mirrored area path so it matches the runtime module location.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT007","family":"tests","slug":"scripts-mirror-depth","message":"tooling tests must include an area beneath the configured tooling root","remediation":"Move the test beneath the configured tooling area it exercises.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT008","family":"tests","slug":"scripts-area-exists","message":"tooling tests must mirror an existing configured tooling area","remediation":"Correct the mirrored area path so it matches the tooling location.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT101","family":"tests","slug":"init-module-empty","message":"test package __init__.py files must be empty or docstring-only","remediation":"Remove runtime declarations from __init__.py and import them from their owning module.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT102","family":"tests","slug":"absolute-imports","message":"tests must use absolute imports","remediation":"Replace the relative import with the full tests or application package path.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT103","family":"tests","slug":"no-top-level-helpers","message":"test modules may contain only tests, imports, and declarations","remediation":"Move reusable functions into the local helpers.py module.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT104","family":"tests","slug":"no-if-in-tests","message":"tests and local test helpers must not contain conditional control flow","remediation":"Use parametrized cases when setup and assertions remain branch-free; otherwise split the behavior into separate test functions. Keep local test helpers deterministic with per-variant functions or dataclass-driven case data.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT105","family":"tests","slug":"private-constant-order","message":"private test constants must appear before test functions","remediation":"Move the private constant above the first test so module setup is visible before behavior.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT106","family":"tests","slug":"no-complex-comprehensions","message":"nested or multi-generator comprehensions hide control flow and data shapes","remediation":"Extract a named helper when the transformation has a coherent purpose. For one-off local logic, use simple statements with named intermediate values instead of nested comprehension control flow.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT201","family":"tests","slug":"test-types-description","message":"test-case dataclasses must define a description field","remediation":"Add description: str so parametrized cases explain the behavior they represent.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT202","family":"tests","slug":"test-types-expected-field","message":"test-case dataclasses must define at least one expected_ field","remediation":"Name expected outcomes with an expected_ prefix and assert against them in the test.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT203","family":"tests","slug":"local-test-types-import","message":"tests must import test-case types from their local _test_types.py","remediation":"Move the dataclass beside the test and import it through the mirrored absolute path.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT204","family":"tests","slug":"local-test-types-file","message":"test directories must provide a local _test_types.py","remediation":"Create _test_types.py beside the test. Custom-rule tests should define a local wrapper dataclass there rather than parametrizing directly with RuleCase.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT301","family":"tests","slug":"test-file-name","message":"test modules must use a test_ filename","remediation":"Rename the module to test_<behavior>.py.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT302","family":"tests","slug":"test-function-name","message":"test functions must use test_given_<state>_when_<action>_then_<outcome>","remediation":"Rename the test so its precondition, action, and expected behavior are explicit.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT401","family":"tests","slug":"dataclass-parametrize","message":"tests must use dataclass-backed pytest parameterization","remediation":"Add @pytest.mark.parametrize with local test_case dataclass instances.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT402","family":"tests","slug":"accepts-test-case","message":"parametrized tests must accept a test_case argument","remediation":"Name the parameter test_case and read inputs and expectations from that object.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT403","family":"tests","slug":"test-case-annotation","message":"test_case parameters must use a local test-case dataclass annotation","remediation":"Annotate test_case with a dataclass imported from the local _test_types.py.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT404","family":"tests","slug":"expected-field-assertion","message":"tests must assert against an expected_ field from test_case","remediation":"Store the expected outcome on test_case and reference it in a behavior assertion.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT405","family":"tests","slug":"parametrize-arguments","message":"pytest parametrize decorators must define parameter names and values","remediation":"Pass both the parameter-name string and the case sequence to parametrize.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT406","family":"tests","slug":"parametrize-test-case","message":"pytest parametrize must expose cases through the test_case parameter","remediation":"Use \"test_case\" as the parametrize parameter name.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT407","family":"tests","slug":"parametrize-ids","message":"pytest parametrize decorators must define readable case ids","remediation":"Set ids to the case descriptions, normally with ids=lambda case: case.description.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT408","family":"tests","slug":"inline-parametrize-values","message":"pytest parametrize values must be a visible list, tuple, or local comprehension","remediation":"Inline the case sequence in @pytest.mark.parametrize so its cases are visible beside the test.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT411","family":"tests","slug":"nonempty-parametrize-values","message":"pytest parametrize case sequences must not be empty","remediation":"Add at least one behavior case or remove the test until a real case exists.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT412","family":"tests","slug":"no-dict-test-cases","message":"pytest cases must use typed dataclasses instead of dictionaries","remediation":"Define a local frozen test-case dataclass and construct one instance per case.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT413","family":"tests","slug":"local-test-case-constructors","message":"pytest cases must construct dataclasses from the local _test_types.py","remediation":"Parametrize using a dataclass imported from local _test_types.py. For framework harness inputs such as RuleCase, store their fields in the local dataclass and construct the framework object inside the test.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFT414","family":"tests","slug":"description-lambda-ids","message":"pytest case ids must come from each test case description","remediation":"Use ids=lambda case: case.description so failures identify the behavior clearly.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR001","family":"roles","slug":"models-only-models","message":"models role files may contain only structured runtime models","remediation":"Move functions and non-model declarations to their owning role module.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR002","family":"roles","slug":"types-only-types","message":"types role files may contain only type-layer declarations","remediation":"Move runtime values and functions out of types.py into their owning runtime role.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR003","family":"roles","slug":"constants-only-constants","message":"constants role files may contain only assignments and imports","remediation":"Move functions and classes out of constants.py into their owning role module.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR004","family":"roles","slug":"exceptions-only-exceptions","message":"exceptions role files may contain only custom exceptions","remediation":"Move non-exception declarations out of exceptions.py into their owning role.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR101","family":"roles","slug":"model-declaration-outside-models","message":"structured runtime models must be defined in the models role","remediation":"Move the dataclass or structured model into models.py or a models/ package.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR102","family":"roles","slug":"type-declaration-outside-types","message":"type-layer declarations must be defined in the types role","remediation":"Move the protocol, enum, TypedDict, or public type alias into types.py.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR103","family":"roles","slug":"constant-outside-constants","message":"public uppercase constants must be defined in the constants role","remediation":"Move the public constant into constants.py and import it from there.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR104","family":"roles","slug":"exception-declaration-outside-exceptions","message":"custom exceptions must be defined in the exceptions role","remediation":"Move the exception class into exceptions.py or an exceptions/ package.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR201","family":"roles","slug":"banned-generic-filename","message":"generic filenames hide module ownership","remediation":"Rename the module after the domain concept or operation it owns.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR202","family":"roles","slug":"helpers-module-name","message":"use an _helpers package instead of helpers.py","remediation":"Replace helpers.py with an _helpers/ package of specifically named modules.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR203","family":"roles","slug":"classes-module-name","message":"use a classes package instead of classes.py","remediation":"Replace classes.py with a classes/ package containing one class per module.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR204","family":"roles","slug":"banned-generic-package-name","message":"runtime package directories must identify an owner","remediation":"Rename the package after the business domain or technical capability it owns.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR205","family":"roles","slug":"helpers-classes-file-private","message":"plain classes in _helpers modules must be file-private","remediation":"Prefix a file-local helper class with _, or move a shared class into classes/.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR301","family":"roles","slug":"helpers-package-layout","message":"_helpers/ packages must use bounded flat-or-grouped containers","remediation":"Keep _helpers/ flat or group every module into bounded shallow buckets; do not mix modules and Python-containing buckets in one container.","severity":"error","enabled_by_default":true,"execution_owner":"package"},{"code":"FFR302","family":"roles","slug":"main-package-layout","message":"main/ packages must use bounded flat-or-grouped orchestration containers","remediation":"Keep main/ flat or group every entry into bounded shallow buckets; do not mix modules and Python-containing buckets in one container.","severity":"error","enabled_by_default":true,"execution_owner":"package"},{"code":"FFR303","family":"roles","slug":"helpers-reserved-role-filenames","message":"_helpers/ packages must not contain reserved role filenames","remediation":"Rename the helper module after its specific operation, or move role-owned declarations to the corresponding sibling models, types, constants, or exceptions role.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR304","family":"roles","slug":"nested-direct-modules","message":"nested runtime packages may contain only role-oriented direct modules","remediation":"Move additional implementation modules under the package's _helpers/ boundary.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR305","family":"roles","slug":"nested-direct-subpackages","message":"nested runtime packages must use explicit role boundaries","remediation":"Move feature subpackages under _helpers/ or use a supported role such as main/ or classes/.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR306","family":"roles","slug":"top-level-domain-shape","message":"top-level domains must be either role leaves or subdomain branches","remediation":"Keep direct role content in a leaf domain, or move it into a named subdomain when the domain contains subdomains.","severity":"error","enabled_by_default":true,"execution_owner":"domain"},{"code":"FFR307","family":"roles","slug":"top-level-direct-modules","message":"top-level domains must not contain ad hoc direct modules","remediation":"Move the module under a direct role boundary or into an owning named subdomain.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR308","family":"roles","slug":"shared-domain-prefix","message":"sibling domains must not encode one parent domain through a shared name prefix","remediation":"Create one parent domain from the shared prefix and move each remaining suffix beneath it as a named subdomain.","severity":"error","enabled_by_default":true,"execution_owner":"scope"},{"code":"FFR309","family":"roles","slug":"leaf-main-boundary","message":"leaf runtime domains and subdomains must expose meaningful behavior through main/","remediation":"Add a focused main/ entry module only when the leaf owns behavior; otherwise move passive declarations into the closest domain or subdomain whose main/ behavior owns and uses them.","severity":"error","enabled_by_default":true,"execution_owner":"leaf"},{"code":"FFR401","family":"roles","slug":"entry-module-shape","message":"main/ entry modules must expose one focused public function","remediation":"Keep only imports, one public entry function, and at most two small private glue functions; move phase logic to _helpers/.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR402","family":"roles","slug":"init-module-empty","message":"nested __init__.py files must be empty or docstring-only","remediation":"Remove runtime declarations and import from the concrete owning module instead.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR403","family":"roles","slug":"no-reexport-shim","message":"internal modules must not exist only to re-export imports","remediation":"Import the implementation module directly or expose a deliberate API through an approved public surface.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR404","family":"roles","slug":"no-internal-helper-exports","message":"_helpers/ modules must not publish an __all__ surface","remediation":"Keep _helpers/ internal and expose public behavior through main/, classes/, models, types, constants, or exceptions.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR405","family":"roles","slug":"main-entry-name-collision","message":"main/ cannot define a module and package with the same entry name","remediation":"Choose either the flat entry module or the same-named package and remove the competing surface.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR406","family":"roles","slug":"public-surface-shape","message":"root package surfaces may contain only imports and one __all__ declaration","remediation":"Move runtime behavior into an owning module and keep the root __init__.py as a deliberate import surface.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR501","family":"roles","slug":"classes-one-class-per-module","message":"classes/ modules must define exactly one top-level class","remediation":"Split additional classes into separately named modules under classes/.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR502","family":"roles","slug":"helpers-package-shape","message":"_helpers/ packages must contain no main.py orchestration entrypoints","remediation":"Move main.py orchestration into the sibling main/ role; helper depth is enforced by FFR301.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR503","family":"roles","slug":"private-definition-ordering","message":"private constants and dataclasses must appear before top-level functions","remediation":"Move private module declarations above the first function so readers see module state before behavior.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR601","family":"roles","slug":"source-file-line-count","message":"source files must stay below the configured line limit","remediation":"Split the file by a cohesive role or concern instead of extracting arbitrary numbered fragments.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR701","family":"roles","slug":"tooling-entrypoint-shape","message":"direct scripts must remain focused command adapters","remediation":"Keep one public main(), optional private _parse_args() and _build_parser(), and move implementation into a scripts/<tool>/main/ entry.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR702","family":"roles","slug":"tooling-entrypoint-delegation","message":"direct scripts must delegate to an imported main/ entrypoint","remediation":"Import a typed entry function from a runtime or scripts/<tool>/main/ module and return its result from main().","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR703","family":"roles","slug":"tooling-entrypoint-line-count","message":"direct scripts must stay below the configured line limit","remediation":"Move command implementation into a named tooling or runtime package.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR704","family":"roles","slug":"rules-role-content","message":"tooling rules/ modules may contain only decorated rule declarations","remediation":"Keep imports and @rule functions here; move supporting implementation into _helpers/, classes/, models.py, types.py, constants.py, or exceptions.py.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR705","family":"roles","slug":"tooling-package-layout","message":"tool packages must organize implementation through explicit roles","remediation":"Use main/, _helpers/, classes/, rules/, models.py, types.py, constants.py, or exceptions.py directly beneath scripts/<tool>/.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR706","family":"roles","slug":"descriptive-rule-module-names","message":"rule module filenames must describe their policy rather than repeat one rule code","remediation":"Rename the module after the policy or rule family it implements, using a name such as conditional_test_flow.py instead of fft104.py.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFR707","family":"roles","slug":"custom-rule-test-coverage","message":"configured custom rules must have statically declared public-harness cases","remediation":"Add statically visible RuleCase construction passed to evaluate_rule for each custom rule. When FFT413 is active, parametrize with a local _test_types.py dataclass and convert it to RuleCase inside the test.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFN001","family":"naming","slug":"validator-must-not-return","message":"functions under no-return naming contracts must not return values","remediation":"Remove the meaningful return and raise on invalid input, or rename a value-producing function as a query such as is_valid or get_validation_result.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFN002","family":"naming","slug":"predicate-must-return-bool","message":"predicate names must declare an ordinary boolean result","remediation":"Return bool (or TypeGuard/TypeIs), or rename the function to describe the value it returns, such as read_status or current_status.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFN003","family":"naming","slug":"value-name-must-return-value","message":"value-producing names must not declare a no-value result","remediation":"Return the queried or converted value, or rename the function to describe its side effect, such as initialize_cache or export_json.","severity":"error","enabled_by_default":true,"execution_owner":"file"},{"code":"FFN004","family":"naming","slug":"iterator-name-must-produce-iterator","message":"iterator names must produce an iterator or generator","remediation":"Return an iterator or generator, or rename an eager collection function with a name such as collect_items.","severity":"error","enabled_by_default":true,"execution_owner":"file"}]