diff --git a/.gitignore b/.gitignore
index ad679558..a7715742 100644
--- a/.gitignore
+++ b/.gitignore
@@ -13,9 +13,36 @@ target
# Contains mutation testing data
**/mutants.out*/
+.meva
+
# RustRover
# JetBrains specific template is maintained in a separate JetBrains.gitignore that can
# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
# and can be added to the global gitignore or merged into this file. For a more nuclear
# option (not recommended) you can uncomment the following to ignore the entire idea folder.
#.idea/
+
+# Ignore all the files created by running `cargo run --bin meva -- init` at the root of the project
+.idea/workspace.xml
+.idea/dictionaries/project.xml
+.idea/codeStyles/*
+.idea/vcs.xml
+.idea/inspectionProfiles/**
+.idea/inspectionProfiles/Project_Default.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/shelf
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+/server_files
\ No newline at end of file
diff --git a/Cargo.lock b/Cargo.lock
index 8bf84e68..babbdb9a 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -3,412 +3,7346 @@
version = 4
[[package]]
-name = "aho-corasick"
-version = "1.1.3"
+name = "ab_glyph"
+version = "0.2.32"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8e60d3430d3a69478ad0993f19238d2df97c507009a52b3c10addcd7f6bcb916"
+checksum = "01c0457472c38ea5bd1c3b5ada5e368271cb550be7a4ca4a0b4634e9913f6cc2"
dependencies = [
- "memchr",
+ "ab_glyph_rasterizer",
+ "owned_ttf_parser",
]
[[package]]
-name = "anstyle"
-version = "1.0.11"
+name = "ab_glyph_rasterizer"
+version = "0.1.10"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "862ed96ca487e809f1c8e5a8447f6ee2cf102f846893800b20cebdf541fc6bbd"
+checksum = "366ffbaa4442f4684d91e2cd7c5ea7c4ed8add41959a31447066e279e432b618"
[[package]]
-name = "cfg-if"
-version = "1.0.1"
+name = "accesskit"
+version = "0.21.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9555578bc9e57714c812a1f84e4fc5b4d21fcb063490c624de019f7464c91268"
+checksum = "cf203f9d3bd8f29f98833d1fbef628df18f759248a547e7e01cfbf63cda36a99"
[[package]]
-name = "cli"
-version = "0.1.0"
+name = "accesskit_atspi_common"
+version = "0.14.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "890d241cf51fc784f0ac5ac34dfc847421f8d39da6c7c91a0fcc987db62a8267"
dependencies = [
- "engine",
- "mockall",
- "plugins",
- "pretty_assertions",
- "rstest",
- "shared",
+ "accesskit",
+ "accesskit_consumer",
+ "atspi-common",
+ "serde",
+ "thiserror 1.0.69",
+ "zvariant",
]
[[package]]
-name = "diff"
-version = "0.1.13"
+name = "accesskit_consumer"
+version = "0.31.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "56254986775e3233ffa9c4d7d3faaf6d36a2c09d30b20687e9f88bc8bafc16c8"
+checksum = "db81010a6895d8707f9072e6ce98070579b43b717193d2614014abd5cb17dd43"
+dependencies = [
+ "accesskit",
+ "hashbrown 0.15.5",
+]
[[package]]
-name = "downcast"
-version = "0.11.0"
+name = "accesskit_macos"
+version = "0.22.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1435fa1053d8b2fbbe9be7e97eca7f33d37b28409959813daefc1446a14247f1"
-
-[[package]]
-name = "engine"
-version = "0.1.0"
+checksum = "a0089e5c0ac0ca281e13ea374773898d9354cc28d15af9f0f7394d44a495b575"
dependencies = [
- "mockall",
- "pretty_assertions",
- "rstest",
- "shared",
+ "accesskit",
+ "accesskit_consumer",
+ "hashbrown 0.15.5",
+ "objc2 0.5.2",
+ "objc2-app-kit 0.2.2",
+ "objc2-foundation 0.2.2",
]
[[package]]
-name = "equivalent"
-version = "1.0.2"
+name = "accesskit_unix"
+version = "0.17.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
+checksum = "301e55b39cfc15d9c48943ce5f572204a551646700d0e8efa424585f94fec528"
+dependencies = [
+ "accesskit",
+ "accesskit_atspi_common",
+ "async-channel",
+ "async-executor",
+ "async-task",
+ "atspi",
+ "futures-lite",
+ "futures-util",
+ "serde",
+ "zbus",
+]
[[package]]
-name = "fragile"
-version = "2.0.1"
+name = "accesskit_windows"
+version = "0.29.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "28dd6caf6059519a65843af8fe2a3ae298b14b80179855aeb4adc2c1934ee619"
+checksum = "d2d63dd5041e49c363d83f5419a896ecb074d309c414036f616dc0b04faca971"
+dependencies = [
+ "accesskit",
+ "accesskit_consumer",
+ "hashbrown 0.15.5",
+ "static_assertions",
+ "windows 0.61.3",
+ "windows-core 0.61.2",
+]
[[package]]
-name = "futures-core"
-version = "0.3.31"
+name = "accesskit_winit"
+version = "0.29.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "05f29059c0c2090612e8d742178b0580d2dc940c837851ad723096f87af6663e"
+checksum = "c8cfabe59d0eaca7412bfb1f70198dd31e3b0496fee7e15b066f9c36a1a140a0"
+dependencies = [
+ "accesskit",
+ "accesskit_macos",
+ "accesskit_unix",
+ "accesskit_windows",
+ "raw-window-handle",
+ "winit",
+]
[[package]]
-name = "futures-macro"
-version = "0.3.31"
+name = "addr2line"
+version = "0.24.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "162ee34ebcb7c64a8abebc059ce0fee27c2262618d7b60ed8faf72fef13c3650"
+checksum = "dfbe277e56a376000877090da837660b4427aad530e3028d44e0bffe4f89a1c1"
dependencies = [
- "proc-macro2",
- "quote",
- "syn",
+ "gimli",
]
[[package]]
-name = "futures-task"
-version = "0.3.31"
+name = "adler2"
+version = "2.0.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f90f7dce0722e95104fcb095585910c0977252f286e354b5e3bd38902cd99988"
+checksum = "320119579fcad9c21884f5c4861d16174d0e06250625266f50fe6898340abefa"
[[package]]
-name = "futures-timer"
-version = "3.0.3"
+name = "aead"
+version = "0.5.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f288b0a4f20f9a56b5d1da57e2227c661b7b16168e2f72365f57b63326e29b24"
+checksum = "d122413f284cf2d62fb1b7db97e02edb8cda96d769b16e443a4f6195e35662b0"
+dependencies = [
+ "crypto-common 0.1.6",
+ "generic-array",
+]
[[package]]
-name = "futures-util"
-version = "0.3.31"
+name = "aes"
+version = "0.8.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9fa08315bb612088cc391249efdc3bc77536f16c91f6cf495e6fbe85b20a4a81"
+checksum = "b169f7a6d4742236a0a00c541b845991d0ac43e546831af1249753ab4c3aa3a0"
dependencies = [
- "futures-core",
- "futures-macro",
- "futures-task",
- "pin-project-lite",
- "pin-utils",
- "slab",
+ "cfg-if",
+ "cipher",
+ "cpufeatures",
]
[[package]]
-name = "glob"
-version = "0.3.2"
+name = "aes-gcm"
+version = "0.10.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a8d1add55171497b4705a648c6b583acafb01d58050a51727785f0b2c8e0a2b2"
-
-[[package]]
-name = "gui"
-version = "0.1.0"
+checksum = "831010a0f742e1209b3bcea8fab6a8e149051ba6099432c8cb2cc117dec3ead1"
dependencies = [
- "engine",
- "mockall",
- "plugins",
- "pretty_assertions",
- "rstest",
- "shared",
+ "aead",
+ "aes",
+ "cipher",
+ "ctr",
+ "ghash",
+ "subtle",
]
[[package]]
-name = "hashbrown"
-version = "0.15.4"
+name = "ahash"
+version = "0.8.12"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5971ac85611da7067dbfcabef3c70ebb5606018acd9e2a3903a0da507521e0d5"
+checksum = "5a15f179cd60c4584b8a8c596927aadc462e27f2ca70c04e0071964a73ba7a75"
+dependencies = [
+ "cfg-if",
+ "getrandom 0.3.3",
+ "once_cell",
+ "version_check",
+ "zerocopy",
+]
[[package]]
-name = "indexmap"
-version = "2.10.0"
+name = "aho-corasick"
+version = "1.1.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fe4cd85333e22411419a0bcae1297d25e58c9443848b11dc6a86fefe8c78a661"
+checksum = "8e60d3430d3a69478ad0993f19238d2df97c507009a52b3c10addcd7f6bcb916"
dependencies = [
- "equivalent",
- "hashbrown",
+ "memchr",
]
[[package]]
-name = "memchr"
-version = "2.7.5"
+name = "aligned"
+version = "0.4.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "32a282da65faaf38286cf3be983213fcf1d2e2a58700e808f83f4ea9a4804bc0"
+checksum = "377e4c0ba83e4431b10df45c1d4666f178ea9c552cac93e60c3a88bf32785923"
+dependencies = [
+ "as-slice",
+]
[[package]]
-name = "mockall"
-version = "0.13.1"
+name = "aligned-vec"
+version = "0.6.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "39a6bfcc6c8c7eed5ee98b9c3e33adc726054389233e201c95dab2d41a3839d2"
+checksum = "dc890384c8602f339876ded803c97ad529f3842aba97f6392b3dba0dd171769b"
dependencies = [
- "cfg-if",
- "downcast",
- "fragile",
- "mockall_derive",
- "predicates",
- "predicates-tree",
+ "equator",
]
[[package]]
-name = "mockall_derive"
-version = "0.13.1"
+name = "android-activity"
+version = "0.6.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "25ca3004c2efe9011bd4e461bd8256445052b9615405b4f7ea43fc8ca5c20898"
+checksum = "ef6978589202a00cd7e118380c448a08b6ed394c3a8df3a430d0898e3a42d046"
dependencies = [
- "cfg-if",
- "proc-macro2",
- "quote",
- "syn",
+ "android-properties",
+ "bitflags 2.9.4",
+ "cc",
+ "cesu8",
+ "jni",
+ "jni-sys",
+ "libc",
+ "log",
+ "ndk",
+ "ndk-context",
+ "ndk-sys",
+ "num_enum",
+ "thiserror 1.0.69",
]
[[package]]
-name = "pin-project-lite"
-version = "0.2.16"
+name = "android-properties"
+version = "0.2.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3b3cff922bd51709b605d9ead9aa71031d81447142d828eb4a6eba76fe619f9b"
+checksum = "fc7eb209b1518d6bb87b283c20095f5228ecda460da70b44f0802523dea6da04"
[[package]]
-name = "pin-utils"
-version = "0.1.0"
+name = "android_system_properties"
+version = "0.1.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8b870d8c151b6f2fb93e84a13146138f05d02ed11c7e7c54f8826aaaf7c9f184"
-
-[[package]]
-name = "plugins"
-version = "0.1.0"
+checksum = "819e7219dbd41043ac279b19830f2efc897156490d7fd6ea916720117ee66311"
dependencies = [
- "mockall",
- "pretty_assertions",
- "rstest",
- "shared",
+ "libc",
]
[[package]]
-name = "predicates"
-version = "3.1.3"
+name = "anstream"
+version = "0.6.20"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a5d19ee57562043d37e82899fade9a22ebab7be9cef5026b07fda9cdd4293573"
+checksum = "3ae563653d1938f79b1ab1b5e668c87c76a9930414574a6583a7b7e11a8e6192"
dependencies = [
"anstyle",
- "predicates-core",
+ "anstyle-parse",
+ "anstyle-query",
+ "anstyle-wincon",
+ "colorchoice",
+ "is_terminal_polyfill",
+ "utf8parse",
]
[[package]]
-name = "predicates-core"
-version = "1.0.9"
+name = "anstyle"
+version = "1.0.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "727e462b119fe9c93fd0eb1429a5f7647394014cf3c04ab2c0350eeb09095ffa"
+checksum = "862ed96ca487e809f1c8e5a8447f6ee2cf102f846893800b20cebdf541fc6bbd"
[[package]]
-name = "predicates-tree"
-version = "1.0.12"
+name = "anstyle-parse"
+version = "0.2.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "72dd2d6d381dfb73a193c7fca536518d7caee39fc8503f74e7dc0be0531b425c"
+checksum = "4e7644824f0aa2c7b9384579234ef10eb7efb6a0deb83f9630a49594dd9c15c2"
dependencies = [
- "predicates-core",
- "termtree",
+ "utf8parse",
]
[[package]]
-name = "pretty_assertions"
-version = "1.4.1"
+name = "anstyle-query"
+version = "1.1.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3ae130e2f271fbc2ac3a40fb1d07180839cdbbe443c7a27e1e3c13c5cac0116d"
+checksum = "9e231f6134f61b71076a3eab506c379d4f36122f2af15a9ff04415ea4c3339e2"
dependencies = [
- "diff",
- "yansi",
+ "windows-sys 0.60.2",
]
[[package]]
-name = "proc-macro-crate"
-version = "3.3.0"
+name = "anstyle-wincon"
+version = "3.0.10"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "edce586971a4dfaa28950c6f18ed55e0406c1ab88bbce2c6f6293a7aaba73d35"
+checksum = "3e0633414522a32ffaac8ac6cc8f748e090c5717661fddeea04219e2344f5f2a"
dependencies = [
- "toml_edit",
+ "anstyle",
+ "once_cell_polyfill",
+ "windows-sys 0.60.2",
]
[[package]]
-name = "proc-macro2"
-version = "1.0.95"
+name = "anyhow"
+version = "1.0.100"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "02b3e5e68a3a1a02aad3ec490a98007cbc13c37cbe84a3cd7b8e406d76e7f778"
-dependencies = [
- "unicode-ident",
-]
+checksum = "a23eb6b1614318a8071c9b2521f36b424b2c83db5eb3a0fead4a6c0809af6e61"
[[package]]
-name = "quote"
-version = "1.0.40"
+name = "arbitrary"
+version = "1.4.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1885c039570dc00dcb4ff087a89e185fd56bae234ddc7f056a945bf36467248d"
-dependencies = [
- "proc-macro2",
-]
+checksum = "c3d036a3c4ab069c7b410a2ce876bd74808d2d0888a82667669f8e783a898bf1"
[[package]]
-name = "regex"
-version = "1.11.1"
+name = "arboard"
+version = "3.6.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b544ef1b4eac5dc2db33ea63606ae9ffcfac26c1416a2806ae0bf5f56b201191"
+checksum = "0348a1c054491f4bfe6ab86a7b6ab1e44e45d899005de92f58b3df180b36ddaf"
dependencies = [
- "aho-corasick",
- "memchr",
- "regex-automata",
- "regex-syntax",
+ "clipboard-win",
+ "image",
+ "log",
+ "objc2 0.6.3",
+ "objc2-app-kit 0.3.2",
+ "objc2-core-foundation",
+ "objc2-core-graphics",
+ "objc2-foundation 0.3.2",
+ "parking_lot",
+ "percent-encoding",
+ "windows-sys 0.60.2",
+ "x11rb",
]
[[package]]
-name = "regex-automata"
-version = "0.4.9"
+name = "arg_enum_proc_macro"
+version = "0.3.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "809e8dc61f6de73b46c85f4c96486310fe304c434cfa43669d7b40f711150908"
+checksum = "0ae92a5119aa49cdbcf6b9f893fe4e1d98b04ccbf82ee0584ad948a44a734dea"
dependencies = [
- "aho-corasick",
- "memchr",
- "regex-syntax",
+ "proc-macro2",
+ "quote",
+ "syn",
]
[[package]]
-name = "regex-syntax"
-version = "0.8.5"
+name = "arrayref"
+version = "0.3.9"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2b15c43186be67a4fd63bee50d0303afffcef381492ebe2c5d87f324e1b8815c"
+checksum = "76a2e8124351fda1ef8aaaa3bbd7ebbcb486bbcd4225aca0aa0d84bb2db8fecb"
[[package]]
-name = "relative-path"
-version = "1.9.3"
+name = "arrayvec"
+version = "0.7.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ba39f3699c378cd8970968dcbff9c43159ea4cfbd88d43c00b22f2ef10a435d2"
+checksum = "7c02d123df017efcdfbd739ef81735b36c5ba83ec3c59c80a9d7ecc718f92e50"
[[package]]
-name = "rstest"
-version = "0.25.0"
+name = "as-raw-xcb-connection"
+version = "1.0.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6fc39292f8613e913f7df8fa892b8944ceb47c247b78e1b1ae2f09e019be789d"
-dependencies = [
- "futures-timer",
- "futures-util",
- "rstest_macros",
- "rustc_version",
-]
+checksum = "175571dd1d178ced59193a6fc02dde1b972eb0bc56c892cde9beeceac5bf0f6b"
[[package]]
-name = "rstest_macros"
-version = "0.25.0"
+name = "as-slice"
+version = "0.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1f168d99749d307be9de54d23fd226628d99768225ef08f6ffb52e0182a27746"
+checksum = "516b6b4f0e40d50dcda9365d53964ec74560ad4284da2e7fc97122cd83174516"
dependencies = [
- "cfg-if",
- "glob",
- "proc-macro-crate",
- "proc-macro2",
- "quote",
- "regex",
- "relative-path",
- "rustc_version",
- "syn",
- "unicode-ident",
+ "stable_deref_trait",
]
[[package]]
-name = "rustc_version"
-version = "0.4.1"
+name = "ash"
+version = "0.38.0+1.3.281"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cfcb3a22ef46e85b45de6ee7e79d063319ebb6594faafcf1c225ea92ab6e9b92"
+checksum = "0bb44936d800fea8f016d7f2311c6a4f97aebd5dc86f09906139ec848cf3a46f"
dependencies = [
- "semver",
+ "libloading",
]
[[package]]
-name = "semver"
-version = "1.0.26"
+name = "ashpd"
+version = "0.11.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "56e6fa9c48d24d85fb3de5ad847117517440f6beceb7798af16b4a87d616b8d0"
-
-[[package]]
-name = "shared"
-version = "0.1.0"
+checksum = "6cbdf310d77fd3aaee6ea2093db7011dc2d35d2eb3481e5607f1f8d942ed99df"
dependencies = [
- "mockall",
- "pretty_assertions",
- "rstest",
+ "async-fs",
+ "async-net",
+ "enumflags2",
+ "futures-channel",
+ "futures-util",
+ "rand 0.9.2",
+ "raw-window-handle",
+ "serde",
+ "serde_repr",
+ "url",
+ "wayland-backend",
+ "wayland-client",
+ "wayland-protocols",
+ "zbus",
]
[[package]]
-name = "slab"
-version = "0.4.10"
+name = "async-broadcast"
+version = "0.7.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "04dc19736151f35336d325007ac991178d504a119863a2fcb3758cdb5e52c50d"
+checksum = "435a87a52755b8f27fcf321ac4f04b2802e337c8c4872923137471ec39c37532"
+dependencies = [
+ "event-listener",
+ "event-listener-strategy",
+ "futures-core",
+ "pin-project-lite",
+]
[[package]]
-name = "syn"
-version = "2.0.104"
+name = "async-channel"
+version = "2.5.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "17b6f705963418cdb9927482fa304bc562ece2fdd4f616084c50b7023b435a40"
+checksum = "924ed96dd52d1b75e9c1a3e6275715fd320f5f9439fb5a4a11fa51f4221158d2"
dependencies = [
- "proc-macro2",
- "quote",
- "unicode-ident",
+ "concurrent-queue",
+ "event-listener-strategy",
+ "futures-core",
+ "pin-project-lite",
]
[[package]]
-name = "termtree"
-version = "0.5.1"
+name = "async-executor"
+version = "1.13.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8f50febec83f5ee1df3015341d8bd429f2d1cc62bcba7ea2076759d315084683"
+checksum = "497c00e0fd83a72a79a39fcbd8e3e2f055d6f6c7e025f3b3d91f4f8e76527fb8"
+dependencies = [
+ "async-task",
+ "concurrent-queue",
+ "fastrand",
+ "futures-lite",
+ "pin-project-lite",
+ "slab",
+]
[[package]]
-name = "toml_datetime"
-version = "0.6.11"
+name = "async-fs"
+version = "2.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "22cddaf88f4fbc13c51aebbf5f8eceb5c7c5a9da2ac40a13519eb5b0a0e8f11c"
+checksum = "8034a681df4aed8b8edbd7fbe472401ecf009251c8b40556b304567052e294c5"
+dependencies = [
+ "async-lock",
+ "blocking",
+ "futures-lite",
+]
[[package]]
-name = "toml_edit"
-version = "0.22.27"
+name = "async-io"
+version = "2.6.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "41fe8c660ae4257887cf66394862d21dbca4a6ddd26f04a3560410406a2f819a"
+checksum = "456b8a8feb6f42d237746d4b3e9a178494627745c3c56c6ea55d92ba50d026fc"
dependencies = [
- "indexmap",
- "toml_datetime",
- "winnow",
+ "autocfg",
+ "cfg-if",
+ "concurrent-queue",
+ "futures-io",
+ "futures-lite",
+ "parking",
+ "polling",
+ "rustix 1.1.2",
+ "slab",
+ "windows-sys 0.61.2",
]
[[package]]
-name = "unicode-ident"
-version = "1.0.18"
+name = "async-lock"
+version = "3.4.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5a5f39404a5da50712a4c1eecf25e90dd62b613502b7e925fd4e4d19b5c96512"
+checksum = "5fd03604047cee9b6ce9de9f70c6cd540a0520c813cbd49bae61f33ab80ed1dc"
+dependencies = [
+ "event-listener",
+ "event-listener-strategy",
+ "pin-project-lite",
+]
[[package]]
-name = "winnow"
-version = "0.7.12"
+name = "async-net"
+version = "2.0.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f3edebf492c8125044983378ecb5766203ad3b4c2f7a922bd7dd207f6d443e95"
+checksum = "b948000fad4873c1c9339d60f2623323a0cfd3816e5181033c6a5cb68b2accf7"
dependencies = [
- "memchr",
+ "async-io",
+ "blocking",
+ "futures-lite",
]
[[package]]
-name = "yansi"
+name = "async-process"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc50921ec0055cdd8a16de48773bfeec5c972598674347252c0399676be7da75"
+dependencies = [
+ "async-channel",
+ "async-io",
+ "async-lock",
+ "async-signal",
+ "async-task",
+ "blocking",
+ "cfg-if",
+ "event-listener",
+ "futures-lite",
+ "rustix 1.1.2",
+]
+
+[[package]]
+name = "async-recursion"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3b43422f69d8ff38f95f1b2bb76517c91589a924d1559a0e935d7c8ce0274c11"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "async-signal"
+version = "0.2.13"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "43c070bbf59cd3570b6b2dd54cd772527c7c3620fce8be898406dd3ed6adc64c"
+dependencies = [
+ "async-io",
+ "async-lock",
+ "atomic-waker",
+ "cfg-if",
+ "futures-core",
+ "futures-io",
+ "rustix 1.1.2",
+ "signal-hook-registry",
+ "slab",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "async-task"
+version = "4.7.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8b75356056920673b02621b35afd0f7dda9306d03c79a30f5c56c44cf256e3de"
+
+[[package]]
+name = "async-trait"
+version = "0.1.89"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9035ad2d096bed7955a320ee7e2230574d28fd3c3a0f186cbea1ff3c7eed5dbb"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "atomic-waker"
+version = "1.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1505bd5d3d116872e7271a6d4e16d81d0c8570876c8de68093a09ac269d8aac0"
+
+[[package]]
+name = "atspi"
+version = "0.25.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c83247582e7508838caf5f316c00791eee0e15c0bf743e6880585b867e16815c"
+dependencies = [
+ "atspi-common",
+ "atspi-connection",
+ "atspi-proxies",
+]
+
+[[package]]
+name = "atspi-common"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "33dfc05e7cdf90988a197803bf24f5788f94f7c94a69efa95683e8ffe76cfdfb"
+dependencies = [
+ "enumflags2",
+ "serde",
+ "static_assertions",
+ "zbus",
+ "zbus-lockstep",
+ "zbus-lockstep-macros",
+ "zbus_names",
+ "zvariant",
+]
+
+[[package]]
+name = "atspi-connection"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4193d51303d8332304056ae0004714256b46b6635a5c556109b319c0d3784938"
+dependencies = [
+ "atspi-common",
+ "atspi-proxies",
+ "futures-lite",
+ "zbus",
+]
+
+[[package]]
+name = "atspi-proxies"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d2eebcb9e7e76f26d0bcfd6f0295e1cd1e6f33bedbc5698a971db8dc43d7751c"
+dependencies = [
+ "atspi-common",
+ "serde",
+ "zbus",
+]
+
+[[package]]
+name = "autocfg"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
+
+[[package]]
+name = "av-scenechange"
+version = "0.14.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0f321d77c20e19b92c39e7471cf986812cbb46659d2af674adc4331ef3f18394"
+dependencies = [
+ "aligned",
+ "anyhow",
+ "arg_enum_proc_macro",
+ "arrayvec",
+ "log",
+ "num-rational",
+ "num-traits",
+ "pastey",
+ "rayon",
+ "thiserror 2.0.17",
+ "v_frame",
+ "y4m",
+]
+
+[[package]]
+name = "av1-grain"
+version = "0.2.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8cfddb07216410377231960af4fcab838eaa12e013417781b78bd95ee22077f8"
+dependencies = [
+ "anyhow",
+ "arrayvec",
+ "log",
+ "nom",
+ "num-rational",
+ "v_frame",
+]
+
+[[package]]
+name = "avif-serialize"
+version = "0.8.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "47c8fbc0f831f4519fe8b810b6a7a91410ec83031b8233f730a0480029f6a23f"
+dependencies = [
+ "arrayvec",
+]
+
+[[package]]
+name = "backtrace"
+version = "0.3.75"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6806a6321ec58106fea15becdad98371e28d92ccbc7c8f1b3b6dd724fe8f1002"
+dependencies = [
+ "addr2line",
+ "cfg-if",
+ "libc",
+ "miniz_oxide",
+ "object",
+ "rustc-demangle",
+ "windows-targets 0.52.6",
+]
+
+[[package]]
+name = "backtrace-ext"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "537beee3be4a18fb023b570f80e3ae28003db9167a751266b259926e25539d50"
+dependencies = [
+ "backtrace",
+]
+
+[[package]]
+name = "base16ct"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4c7f02d4ea65f2c1853089ffd8d2787bdbc63de2f0d29dedbcf8ccdfa0ccd4cf"
+
+[[package]]
+name = "base64"
+version = "0.22.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
+
+[[package]]
+name = "base64ct"
+version = "1.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "55248b47b0caf0546f7988906588779981c43bb1bc9d0c44087278f80cdb44ba"
+
+[[package]]
+name = "bcrypt-pbkdf"
+version = "0.10.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6aeac2e1fe888769f34f05ac343bbef98b14d1ffb292ab69d4608b3abc86f2a2"
+dependencies = [
+ "blowfish",
+ "pbkdf2 0.12.2",
+ "sha2",
+]
+
+[[package]]
+name = "bincode"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "36eaf5d7b090263e8150820482d5d93cd964a81e4019913c972f4edcc6edb740"
+dependencies = [
+ "bincode_derive",
+ "serde",
+ "unty",
+]
+
+[[package]]
+name = "bincode_derive"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bf95709a440f45e986983918d0e8a1f30a9b1df04918fc828670606804ac3c09"
+dependencies = [
+ "virtue",
+]
+
+[[package]]
+name = "bit-set"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08807e080ed7f9d5433fa9b275196cfc35414f66a0c79d864dc51a0d825231a3"
+dependencies = [
+ "bit-vec",
+]
+
+[[package]]
+name = "bit-vec"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5e764a1d40d510daf35e07be9eb06e75770908c27d411ee6c92109c9840eaaf7"
+
+[[package]]
+name = "bit_field"
+version = "0.10.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1e4b40c7323adcfc0a41c4b88143ed58346ff65a288fc144329c5c45e05d70c6"
+
+[[package]]
+name = "bitflags"
+version = "1.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
+
+[[package]]
+name = "bitflags"
+version = "2.9.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2261d10cca569e4643e526d8dc2e62e433cc8aba21ab764233731f8d369bf394"
+
+[[package]]
+name = "bitstream-io"
+version = "4.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "60d4bd9d1db2c6bdf285e223a7fa369d5ce98ec767dec949c6ca62863ce61757"
+dependencies = [
+ "core2",
+]
+
+[[package]]
+name = "block"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0d8c1fef690941d3e7788d328517591fecc684c084084702d6ff1641e993699a"
+
+[[package]]
+name = "block-buffer"
+version = "0.10.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71"
+dependencies = [
+ "generic-array",
+]
+
+[[package]]
+name = "block-buffer"
+version = "0.11.0-rc.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e9ef36a6fcdb072aa548f3da057640ec10859eb4e91ddf526ee648d50c76a949"
+dependencies = [
+ "hybrid-array",
+]
+
+[[package]]
+name = "block-padding"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a8894febbff9f758034a5b8e12d87918f56dfc64a8e1fe757d65e29041538d93"
+dependencies = [
+ "generic-array",
+]
+
+[[package]]
+name = "block2"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2c132eebf10f5cad5289222520a4a058514204aed6d791f1cf4fe8088b82d15f"
+dependencies = [
+ "objc2 0.5.2",
+]
+
+[[package]]
+name = "block2"
+version = "0.6.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cdeb9d870516001442e364c5220d3574d2da8dc765554b4a617230d33fa58ef5"
+dependencies = [
+ "objc2 0.6.3",
+]
+
+[[package]]
+name = "blocking"
+version = "1.6.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e83f8d02be6967315521be875afa792a316e28d57b5a2d401897e2a7921b7f21"
+dependencies = [
+ "async-channel",
+ "async-task",
+ "futures-io",
+ "futures-lite",
+ "piper",
+]
+
+[[package]]
+name = "blowfish"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e412e2cd0f2b2d93e02543ceae7917b3c70331573df19ee046bcbc35e45e87d7"
+dependencies = [
+ "byteorder",
+ "cipher",
+]
+
+[[package]]
+name = "bstr"
+version = "1.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "234113d19d0d7d613b40e86fb654acf958910802bcceab913a4f9e7cda03b1a4"
+dependencies = [
+ "memchr",
+ "serde",
+]
+
+[[package]]
+name = "built"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f4ad8f11f288f48ca24471bbd51ac257aaeaaa07adae295591266b792902ae64"
+
+[[package]]
+name = "bumpalo"
+version = "3.19.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "46c5e41b57b8bba42a04676d81cb89e9ee8e859a1a66f80a5a72e1cb76b34d43"
+
+[[package]]
+name = "bytemuck"
+version = "1.24.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbdf580320f38b612e485521afda1ee26d10cc9884efaaa750d383e13e3c5f4"
+dependencies = [
+ "bytemuck_derive",
+]
+
+[[package]]
+name = "bytemuck_derive"
+version = "1.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f9abbd1bc6865053c427f7198e6af43bfdedc55ab791faed4fbd361d789575ff"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "byteorder"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b"
+
+[[package]]
+name = "byteorder-lite"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f1fe948ff07f4bd06c30984e69f5b4899c516a3ef74f34df92a2df2ab535495"
+
+[[package]]
+name = "bytes"
+version = "1.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d71b6127be86fdcfddb610f7182ac57211d4b18a3e9c82eb2d17662f2227ad6a"
+
+[[package]]
+name = "calloop"
+version = "0.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b99da2f8558ca23c71f4fd15dc57c906239752dd27ff3c00a1d56b685b7cbfec"
+dependencies = [
+ "bitflags 2.9.4",
+ "log",
+ "polling",
+ "rustix 0.38.44",
+ "slab",
+ "thiserror 1.0.69",
+]
+
+[[package]]
+name = "calloop"
+version = "0.14.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb9f6e1368bd4621d2c86baa7e37de77a938adf5221e5dd3d6133340101b309e"
+dependencies = [
+ "bitflags 2.9.4",
+ "polling",
+ "rustix 1.1.2",
+ "slab",
+ "tracing",
+]
+
+[[package]]
+name = "calloop-wayland-source"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "95a66a987056935f7efce4ab5668920b5d0dac4a7c99991a67395f13702ddd20"
+dependencies = [
+ "calloop 0.13.0",
+ "rustix 0.38.44",
+ "wayland-backend",
+ "wayland-client",
+]
+
+[[package]]
+name = "calloop-wayland-source"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "138efcf0940a02ebf0cc8d1eff41a1682a46b431630f4c52450d6265876021fa"
+dependencies = [
+ "calloop 0.14.3",
+ "rustix 1.1.2",
+ "wayland-backend",
+ "wayland-client",
+]
+
+[[package]]
+name = "cbc"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "26b52a9543ae338f279b96b0b9fed9c8093744685043739079ce85cd58f289a6"
+dependencies = [
+ "cipher",
+]
+
+[[package]]
+name = "cc"
+version = "1.2.37"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "65193589c6404eb80b450d618eaf9a2cafaaafd57ecce47370519ef674a7bd44"
+dependencies = [
+ "find-msvc-tools",
+ "jobserver",
+ "libc",
+ "shlex",
+]
+
+[[package]]
+name = "cesu8"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6d43a04d8753f35258c91f8ec639f792891f748a1edbd759cf1dcea3382ad83c"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2fd1289c04a9ea8cb22300a459a72a385d7c73d3259e2ed7dcb2af674838cfa9"
+
+[[package]]
+name = "cfg_aliases"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "613afe47fcd5fac7ccf1db93babcb082c5994d996f20b8b159f2ad1658eb5724"
+
+[[package]]
+name = "cgl"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ced0551234e87afee12411d535648dd89d2e7f34c78b753395567aff3d447ff"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "chacha20"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c3613f74bd2eac03dad61bd53dbe620703d4371614fe0bc3b9f04dd36fe4e818"
+dependencies = [
+ "cfg-if",
+ "cipher",
+ "cpufeatures",
+]
+
+[[package]]
+name = "chardetng"
+version = "0.1.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "14b8f0b65b7b08ae3c8187e8d77174de20cb6777864c6b832d8ad365999cf1ea"
+dependencies = [
+ "cfg-if",
+ "encoding_rs",
+ "memchr",
+]
+
+[[package]]
+name = "chrono"
+version = "0.4.42"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "145052bdd345b87320e369255277e3fb5152762ad123a901ef5c262dd38fe8d2"
+dependencies = [
+ "iana-time-zone",
+ "js-sys",
+ "num-traits",
+ "serde",
+ "wasm-bindgen",
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "cipher"
+version = "0.4.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "773f3b9af64447d2ce9850330c473515014aa235e6a783b02db81ff39e4a3dad"
+dependencies = [
+ "crypto-common 0.1.6",
+ "inout",
+]
+
+[[package]]
+name = "clap"
+version = "4.5.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7eac00902d9d136acd712710d71823fb8ac8004ca445a89e73a41d45aa712931"
+dependencies = [
+ "clap_builder",
+ "clap_derive",
+]
+
+[[package]]
+name = "clap_builder"
+version = "4.5.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2ad9bbf750e73b5884fb8a211a9424a1906c1e156724260fdae972f31d70e1d6"
+dependencies = [
+ "anstream",
+ "anstyle",
+ "clap_lex",
+ "strsim",
+]
+
+[[package]]
+name = "clap_derive"
+version = "4.5.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bbfd7eae0b0f1a6e63d4b13c9c478de77c2eb546fba158ad50b4203dc24b9f9c"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "clap_lex"
+version = "0.7.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b94f61472cee1439c0b966b47e3aca9ae07e45d070759512cd390ea2bebc6675"
+
+[[package]]
+name = "cli"
+version = "0.1.0"
+dependencies = [
+ "async-trait",
+ "clap",
+ "dateparser",
+ "engine",
+ "globset",
+ "miette",
+ "mockall",
+ "owo-colors",
+ "plugins",
+ "pretty_assertions",
+ "regex",
+ "rstest",
+ "shared",
+ "strum",
+ "strum_macros",
+ "thiserror 2.0.17",
+ "tokio",
+ "url",
+]
+
+[[package]]
+name = "clipboard-win"
+version = "5.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bde03770d3df201d4fb868f2c9c59e66a3e4e2bd06692a0fe701e7103c7e84d4"
+dependencies = [
+ "error-code",
+]
+
+[[package]]
+name = "codespan-reporting"
+version = "0.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fe6d2e5af09e8c8ad56c969f2157a3d4238cebc7c55f0a517728c38f7b200f81"
+dependencies = [
+ "serde",
+ "termcolor",
+ "unicode-width 0.2.1",
+]
+
+[[package]]
+name = "color_quant"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3d7b894f5411737b7867f4827955924d7c254fc9f4d91a6aad6b097804b1018b"
+
+[[package]]
+name = "colorchoice"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b05b61dc5112cbb17e4b6cd61790d9845d13888356391624cbe7e41efeac1e75"
+
+[[package]]
+name = "combine"
+version = "4.6.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ba5a308b75df32fe02788e748662718f03fde005016435c444eea572398219fd"
+dependencies = [
+ "bytes",
+ "memchr",
+]
+
+[[package]]
+name = "concurrent-queue"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4ca0197aee26d1ae37445ee532fefce43251d24cc7c166799f4d46817f1d3973"
+dependencies = [
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "const-oid"
+version = "0.9.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c2459377285ad874054d797f3ccebf984978aa39129f6eafde5cdc8315b612f8"
+
+[[package]]
+name = "const-oid"
+version = "0.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0dabb6555f92fb9ee4140454eb5dcd14c7960e1225c6d1a6cc361f032947713e"
+
+[[package]]
+name = "core-foundation"
+version = "0.9.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "91e195e091a93c46f7102ec7818a2aa394e1e1771c3ab4825963fa03e45afb8f"
+dependencies = [
+ "core-foundation-sys",
+ "libc",
+]
+
+[[package]]
+name = "core-foundation"
+version = "0.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b2a6cd9ae233e7f62ba4e9353e81a88df7fc8a5987b8d445b4d90c879bd156f6"
+dependencies = [
+ "core-foundation-sys",
+ "libc",
+]
+
+[[package]]
+name = "core-foundation-sys"
+version = "0.8.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "773648b94d0e5d620f64f280777445740e61fe701025087ec8b57f45c791888b"
+
+[[package]]
+name = "core-graphics"
+version = "0.23.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c07782be35f9e1140080c6b96f0d44b739e2278479f64e02fdab4e32dfd8b081"
+dependencies = [
+ "bitflags 1.3.2",
+ "core-foundation 0.9.4",
+ "core-graphics-types 0.1.3",
+ "foreign-types",
+ "libc",
+]
+
+[[package]]
+name = "core-graphics-types"
+version = "0.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "45390e6114f68f718cc7a830514a96f903cccd70d02a8f6d9f643ac4ba45afaf"
+dependencies = [
+ "bitflags 1.3.2",
+ "core-foundation 0.9.4",
+ "libc",
+]
+
+[[package]]
+name = "core-graphics-types"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3d44a101f213f6c4cdc1853d4b78aef6db6bdfa3468798cc1d9912f4735013eb"
+dependencies = [
+ "bitflags 2.9.4",
+ "core-foundation 0.10.1",
+ "libc",
+]
+
+[[package]]
+name = "core2"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b49ba7ef1ad6107f8824dbe97de947cbaac53c44e7f9756a1fba0d37c1eec505"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "cpufeatures"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "59ed5838eebb26a2bb2e58f6d5b5316989ae9d08bab10e0e6d103e656d1b0280"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "crc32fast"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9481c1c90cbf2ac953f07c8d4a58aa3945c425b7185c9154d67a65e4230da511"
+dependencies = [
+ "cfg-if",
+]
+
+[[package]]
+name = "crossbeam-deque"
+version = "0.8.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9dd111b7b7f7d55b72c0a6ae361660ee5853c9af73f70c3c2ef6858b950e2e51"
+dependencies = [
+ "crossbeam-epoch",
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "crossbeam-epoch"
+version = "0.9.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5b82ac4a3c2ca9c3460964f020e1402edd5753411d7737aa39c3714ad1b5420e"
+dependencies = [
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "crossbeam-utils"
+version = "0.8.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d0a5c400df2834b80a4c3327b3aad3a4c4cd4de0629063962b03235697506a28"
+
+[[package]]
+name = "crunchy"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "460fbee9c2c2f33933d720630a6a0bac33ba7053db5344fac858d4b8952d77d5"
+
+[[package]]
+name = "crypto-bigint"
+version = "0.5.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0dc92fb57ca44df6db8059111ab3af99a63d5d0f8375d9972e319a379c6bab76"
+dependencies = [
+ "generic-array",
+ "rand_core 0.6.4",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "crypto-common"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1bfb12502f3fc46cca1bb51ac28df9d618d813cdc3d2f25b9fe775a34af26bb3"
+dependencies = [
+ "generic-array",
+ "rand_core 0.6.4",
+ "typenum",
+]
+
+[[package]]
+name = "crypto-common"
+version = "0.2.0-rc.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6a8235645834fbc6832939736ce2f2d08192652269e11010a6240f61b908a1c6"
+dependencies = [
+ "hybrid-array",
+]
+
+[[package]]
+name = "cryptovec"
+version = "0.7.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae2b4855ffe5a3fe35d5aa2d91b719fbcae83f3b90b97c4dac9d797282e3a7d7"
+dependencies = [
+ "libc",
+ "winapi",
+]
+
+[[package]]
+name = "ctr"
+version = "0.9.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0369ee1ad671834580515889b80f2ea915f23b8be8d0daa4bbaf2ac5c7590835"
+dependencies = [
+ "cipher",
+]
+
+[[package]]
+name = "cursor-icon"
+version = "1.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f27ae1dd37df86211c42e150270f82743308803d90a6f6e6651cd730d5e1732f"
+
+[[package]]
+name = "curve25519-dalek"
+version = "4.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "97fb8b7c4503de7d6ae7b42ab72a5a59857b4c937ec27a3d4539dba95b5ab2be"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "curve25519-dalek-derive",
+ "digest 0.10.7",
+ "fiat-crypto",
+ "rustc_version",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "curve25519-dalek-derive"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f46882e17999c6cc590af592290432be3bce0428cb0d5f8b6715e4dc7b383eb3"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "data-encoding"
+version = "2.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2a2330da5de22e8a3cb63252ce2abb30116bf5265e89c0e01bc17015ce30a476"
+
+[[package]]
+name = "data-url"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "be1e0bca6c3637f992fc1cc7cbc52a78c1ef6db076dbf1059c4323d6a2048376"
+
+[[package]]
+name = "dateparser"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c2ef451feee09ae5ecd8a02e738bd9adee9266b8fa9b44e22d3ce968d8694238"
+dependencies = [
+ "anyhow",
+ "chrono",
+ "lazy_static",
+ "regex",
+]
+
+[[package]]
+name = "der"
+version = "0.7.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e7c1832837b905bbfb5101e07cc24c8deddf52f93225eee6ead5f4d63d53ddcb"
+dependencies = [
+ "const-oid 0.9.6",
+ "pem-rfc7468",
+ "zeroize",
+]
+
+[[package]]
+name = "diff"
+version = "0.1.13"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "56254986775e3233ffa9c4d7d3faaf6d36a2c09d30b20687e9f88bc8bafc16c8"
+
+[[package]]
+name = "digest"
+version = "0.10.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
+dependencies = [
+ "block-buffer 0.10.4",
+ "const-oid 0.9.6",
+ "crypto-common 0.1.6",
+ "subtle",
+]
+
+[[package]]
+name = "digest"
+version = "0.11.0-rc.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6749b668519cd7149ee3d11286a442a8a8bdc3a9d529605f579777bfccc5a4bc"
+dependencies = [
+ "block-buffer 0.11.0-rc.5",
+ "const-oid 0.10.1",
+ "crypto-common 0.2.0-rc.4",
+]
+
+[[package]]
+name = "dirs"
+version = "5.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "44c45a9d03d6676652bcb5e724c7e988de1acad23a711b5217ab9cbecbec2225"
+dependencies = [
+ "dirs-sys 0.4.1",
+]
+
+[[package]]
+name = "dirs"
+version = "6.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c3e8aa94d75141228480295a7d0e7feb620b1a5ad9f12bc40be62411e38cce4e"
+dependencies = [
+ "dirs-sys 0.5.0",
+]
+
+[[package]]
+name = "dirs-sys"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "520f05a5cbd335fae5a99ff7a6ab8627577660ee5cfd6a94a6a929b52ff0321c"
+dependencies = [
+ "libc",
+ "option-ext",
+ "redox_users 0.4.6",
+ "windows-sys 0.48.0",
+]
+
+[[package]]
+name = "dirs-sys"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e01a3366d27ee9890022452ee61b2b63a67e6f13f58900b651ff5665f0bb1fab"
+dependencies = [
+ "libc",
+ "option-ext",
+ "redox_users 0.5.2",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "dispatch"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bd0c93bb4b0c6d9b77f4435b0ae98c24d17f1c45b2ff844c6151a07256ca923b"
+
+[[package]]
+name = "dispatch2"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "89a09f22a6c6069a18470eb92d2298acf25463f14256d24778e1230d789a2aec"
+dependencies = [
+ "bitflags 2.9.4",
+ "block2 0.6.2",
+ "libc",
+ "objc2 0.6.3",
+]
+
+[[package]]
+name = "displaydoc"
+version = "0.2.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "97369cbbc041bc366949bc74d34658d6cda5621039731c6310521892a3a20ae0"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "dlib"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "330c60081dcc4c72131f8eb70510f1ac07223e5d4163db481a04a0befcffa412"
+dependencies = [
+ "libloading",
+]
+
+[[package]]
+name = "document-features"
+version = "0.2.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d4b8a88685455ed29a21542a33abd9cb6510b6b129abadabdcef0f4c55bc8f61"
+dependencies = [
+ "litrs",
+]
+
+[[package]]
+name = "downcast"
+version = "0.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1435fa1053d8b2fbbe9be7e97eca7f33d37b28409959813daefc1446a14247f1"
+
+[[package]]
+name = "downcast-rs"
+version = "1.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "75b325c5dbd37f80359721ad39aca5a29fb04c89279657cffdda8736d0c0b9d2"
+
+[[package]]
+name = "dpi"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d8b14ccef22fc6f5a8f4d7d768562a182c04ce9a3b3157b91390b52ddfdf1a76"
+
+[[package]]
+name = "ecdsa"
+version = "0.16.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ee27f32b5c5292967d2d4a9d7f1e0b0aed2c15daded5a60300e4abb9d8020bca"
+dependencies = [
+ "der",
+ "digest 0.10.7",
+ "elliptic-curve",
+ "rfc6979",
+ "signature",
+ "spki",
+]
+
+[[package]]
+name = "ecolor"
+version = "0.33.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "71ddb8ac7643d1dba1bb02110e804406dd459a838efcb14011ced10556711a8e"
+dependencies = [
+ "bytemuck",
+ "emath",
+]
+
+[[package]]
+name = "ed25519"
+version = "2.2.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "115531babc129696a58c64a4fef0a8bf9e9698629fb97e9e40767d235cfbcd53"
+dependencies = [
+ "pkcs8",
+ "signature",
+]
+
+[[package]]
+name = "ed25519-dalek"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "70e796c081cee67dc755e1a36a0a172b897fab85fc3f6bc48307991f64e4eca9"
+dependencies = [
+ "curve25519-dalek",
+ "ed25519",
+ "rand_core 0.6.4",
+ "serde",
+ "sha2",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "editor-command"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ee98e369cc618396b828ba0231d5bc39857ee1d8e9dcb1c1adef49a21bb5c427"
+dependencies = [
+ "shell-words",
+]
+
+[[package]]
+name = "eframe"
+version = "0.33.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "457481173e6db5ca9fa2be93a58df8f4c7be639587aeb4853b526c6cf87db4e6"
+dependencies = [
+ "ahash",
+ "bytemuck",
+ "document-features",
+ "egui",
+ "egui-wgpu",
+ "egui-winit",
+ "egui_glow",
+ "glow",
+ "glutin",
+ "glutin-winit",
+ "image",
+ "js-sys",
+ "log",
+ "objc2 0.5.2",
+ "objc2-app-kit 0.2.2",
+ "objc2-foundation 0.2.2",
+ "parking_lot",
+ "percent-encoding",
+ "profiling",
+ "raw-window-handle",
+ "static_assertions",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "web-sys",
+ "web-time",
+ "windows-sys 0.61.2",
+ "winit",
+]
+
+[[package]]
+name = "egui"
+version = "0.33.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6a9b567d356674e9a5121ed3fedfb0a7c31e059fe71f6972b691bcd0bfc284e3"
+dependencies = [
+ "accesskit",
+ "ahash",
+ "bitflags 2.9.4",
+ "emath",
+ "epaint",
+ "log",
+ "nohash-hasher",
+ "profiling",
+ "smallvec",
+ "unicode-segmentation",
+]
+
+[[package]]
+name = "egui-phosphor"
+version = "0.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e3b2838620355debaeb7fa3cc331a1d8ab77e6387d40e65686fa468c229dbf63"
+dependencies = [
+ "egui",
+]
+
+[[package]]
+name = "egui-wgpu"
+version = "0.33.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5e4d209971c84b2352a06174abdba701af1e552ce56b144d96f2bd50a3c91236"
+dependencies = [
+ "ahash",
+ "bytemuck",
+ "document-features",
+ "egui",
+ "epaint",
+ "log",
+ "profiling",
+ "thiserror 2.0.17",
+ "type-map",
+ "web-time",
+ "wgpu",
+ "winit",
+]
+
+[[package]]
+name = "egui-winit"
+version = "0.33.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ec6687e5bb551702f4ad10ac428bab12acf9d53047ebb1082d4a0ed8c6251a29"
+dependencies = [
+ "accesskit_winit",
+ "arboard",
+ "bytemuck",
+ "egui",
+ "log",
+ "objc2 0.5.2",
+ "objc2-foundation 0.2.2",
+ "objc2-ui-kit",
+ "profiling",
+ "raw-window-handle",
+ "smithay-clipboard",
+ "web-time",
+ "webbrowser",
+ "winit",
+]
+
+[[package]]
+name = "egui_extras"
+version = "0.33.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d01d34e845f01c62e3fded726961092e70417d66570c499b9817ab24674ca4ed"
+dependencies = [
+ "ahash",
+ "egui",
+ "ehttp",
+ "enum-map",
+ "image",
+ "log",
+ "mime_guess2",
+ "profiling",
+ "resvg",
+]
+
+[[package]]
+name = "egui_glow"
+version = "0.33.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6420863ea1d90e750f75075231a260030ad8a9f30a7cef82cdc966492dc4c4eb"
+dependencies = [
+ "bytemuck",
+ "egui",
+ "glow",
+ "log",
+ "memoffset",
+ "profiling",
+ "wasm-bindgen",
+ "web-sys",
+ "winit",
+]
+
+[[package]]
+name = "ehttp"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "04499d3c719edecfad5c9b46031726c8540905d73be6d7e4f9788c4a298da908"
+dependencies = [
+ "document-features",
+ "js-sys",
+ "ureq",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "web-sys",
+]
+
+[[package]]
+name = "either"
+version = "1.15.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "48c757948c5ede0e46177b7add2e67155f70e33c07fea8284df6576da70b3719"
+
+[[package]]
+name = "elliptic-curve"
+version = "0.13.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b5e6043086bf7973472e0c7dff2142ea0b680d30e18d9cc40f267efbf222bd47"
+dependencies = [
+ "base16ct",
+ "crypto-bigint",
+ "digest 0.10.7",
+ "ff",
+ "generic-array",
+ "group",
+ "hkdf",
+ "pem-rfc7468",
+ "pkcs8",
+ "rand_core 0.6.4",
+ "sec1",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "emath"
+version = "0.33.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "491bdf728bf25ddd9ad60d4cf1c48588fa82c013a2440b91aa7fc43e34a07c32"
+dependencies = [
+ "bytemuck",
+]
+
+[[package]]
+name = "encoding_rs"
+version = "0.8.35"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "75030f3c4f45dafd7586dd6780965a8c7e8e285a5ecb86713e63a79c5b2766f3"
+dependencies = [
+ "cfg-if",
+]
+
+[[package]]
+name = "endi"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "66b7e2430c6dff6a955451e2cfc438f09cea1965a9d6f87f7e3b90decc014099"
+
+[[package]]
+name = "engine"
+version = "0.1.0"
+dependencies = [
+ "async-trait",
+ "bincode",
+ "chardetng",
+ "chrono",
+ "cryptovec",
+ "dirs 6.0.0",
+ "encoding_rs",
+ "flate2",
+ "globset",
+ "hex",
+ "itertools",
+ "mockall",
+ "owo-colors",
+ "path-absolutize",
+ "plugins",
+ "pretty_assertions",
+ "rayon",
+ "regex",
+ "rstest",
+ "russh",
+ "russh-keys",
+ "serde",
+ "serde_json",
+ "sha1 0.11.0-rc.2",
+ "shared",
+ "similar",
+ "strum",
+ "strum_macros",
+ "tempfile",
+ "thiserror 2.0.17",
+ "tokio",
+ "toml",
+ "toml_edit",
+ "tree-ds",
+ "url",
+ "walkdir",
+]
+
+[[package]]
+name = "enum-map"
+version = "2.7.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6866f3bfdf8207509a033af1a75a7b08abda06bbaaeae6669323fd5a097df2e9"
+dependencies = [
+ "enum-map-derive",
+]
+
+[[package]]
+name = "enum-map-derive"
+version = "0.17.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f282cfdfe92516eb26c2af8589c274c7c17681f5ecc03c18255fe741c6aa64eb"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "enumflags2"
+version = "0.7.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1027f7680c853e056ebcec683615fb6fbbc07dbaa13b4d5d9442b146ded4ecef"
+dependencies = [
+ "enumflags2_derive",
+ "serde",
+]
+
+[[package]]
+name = "enumflags2_derive"
+version = "0.7.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "67c78a4d8fdf9953a5c9d458f9efe940fd97a0cab0941c075a813ac594733827"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "epaint"
+version = "0.33.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "009d0dd3c2163823a0abdb899451ecbc78798dec545ee91b43aff1fa790bab62"
+dependencies = [
+ "ab_glyph",
+ "ahash",
+ "bytemuck",
+ "ecolor",
+ "emath",
+ "epaint_default_fonts",
+ "log",
+ "nohash-hasher",
+ "parking_lot",
+ "profiling",
+]
+
+[[package]]
+name = "epaint_default_fonts"
+version = "0.33.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5c4fbe202b6578d3d56428fa185cdf114a05e49da05f477b3c7f0fbb221f1862"
+
+[[package]]
+name = "equator"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4711b213838dfee0117e3be6ac926007d7f433d7bbe33595975d4190cb07e6fc"
+dependencies = [
+ "equator-macro",
+]
+
+[[package]]
+name = "equator-macro"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "44f23cf4b44bfce11a86ace86f8a73ffdec849c9fd00a386a53d278bd9e81fb3"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "equivalent"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
+
+[[package]]
+name = "errno"
+version = "0.3.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb"
+dependencies = [
+ "libc",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "error-code"
+version = "3.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dea2df4cf52843e0452895c455a1a2cfbb842a1e7329671acf418fdc53ed4c59"
+
+[[package]]
+name = "euclid"
+version = "0.22.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ad9cdb4b747e485a12abb0e6566612956c7a1bafa3bdb8d682c5b6d403589e48"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "event-listener"
+version = "5.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e13b66accf52311f30a0db42147dadea9850cb48cd070028831ae5f5d4b856ab"
+dependencies = [
+ "concurrent-queue",
+ "parking",
+ "pin-project-lite",
+]
+
+[[package]]
+name = "event-listener-strategy"
+version = "0.5.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8be9f3dfaaffdae2972880079a491a1a8bb7cbed0b8dd7a347f668b4150a3b93"
+dependencies = [
+ "event-listener",
+ "pin-project-lite",
+]
+
+[[package]]
+name = "exr"
+version = "1.74.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4300e043a56aa2cb633c01af81ca8f699a321879a7854d3896a0ba89056363be"
+dependencies = [
+ "bit_field",
+ "half",
+ "lebe",
+ "miniz_oxide",
+ "rayon-core",
+ "smallvec",
+ "zune-inflate",
+]
+
+[[package]]
+name = "fastrand"
+version = "2.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "37909eebbb50d72f9059c3b6d82c0463f2ff062c9e95845c43a6c9c0355411be"
+
+[[package]]
+name = "fax"
+version = "0.2.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f05de7d48f37cd6730705cbca900770cab77a89f413d23e100ad7fad7795a0ab"
+dependencies = [
+ "fax_derive",
+]
+
+[[package]]
+name = "fax_derive"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a0aca10fb742cb43f9e7bb8467c91aa9bcb8e3ffbc6a6f7389bb93ffc920577d"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "fdeflate"
+version = "0.3.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1e6853b52649d4ac5c0bd02320cddc5ba956bdb407c4b75a2c6b75bf51500f8c"
+dependencies = [
+ "simd-adler32",
+]
+
+[[package]]
+name = "ff"
+version = "0.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c0b50bfb653653f9ca9095b427bed08ab8d75a137839d9ad64eb11810d5b6393"
+dependencies = [
+ "rand_core 0.6.4",
+ "subtle",
+]
+
+[[package]]
+name = "fiat-crypto"
+version = "0.2.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "28dea519a9695b9977216879a3ebfddf92f1c08c05d984f8996aecd6ecdc811d"
+
+[[package]]
+name = "find-msvc-tools"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7fd99930f64d146689264c637b5af2f0233a933bef0d8570e2526bf9e083192d"
+
+[[package]]
+name = "flate2"
+version = "1.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4a3d7db9596fecd151c5f638c0ee5d5bd487b6e0ea232e5dc96d5250f6f94b1d"
+dependencies = [
+ "crc32fast",
+ "miniz_oxide",
+]
+
+[[package]]
+name = "flexi_logger"
+version = "0.31.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "31e5335674a3a259527f97e9176a3767dcc9b220b8e29d643daeb2d6c72caf8b"
+dependencies = [
+ "chrono",
+ "log",
+ "nu-ansi-term",
+ "regex",
+ "thiserror 2.0.17",
+]
+
+[[package]]
+name = "float-cmp"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "98de4bbd547a563b716d8dfa9aad1cb19bfab00f4fa09a6a4ed21dbcf44ce9c4"
+
+[[package]]
+name = "foldhash"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d9c4f5dac5e15c24eb999c26181a6ca40b39fe946cbe4c263c7209467bc83af2"
+
+[[package]]
+name = "foldhash"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "77ce24cb58228fbb8aa041425bb1050850ac19177686ea6e0f41a70416f56fdb"
+
+[[package]]
+name = "foreign-types"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d737d9aa519fb7b749cbc3b962edcf310a8dd1f4b67c91c4f83975dbdd17d965"
+dependencies = [
+ "foreign-types-macros",
+ "foreign-types-shared",
+]
+
+[[package]]
+name = "foreign-types-macros"
+version = "0.2.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1a5c6c585bc94aaf2c7b51dd4c2ba22680844aba4c687be581871a6f518c5742"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "foreign-types-shared"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "aa9a19cbb55df58761df49b23516a86d432839add4af60fc256da840f66ed35b"
+
+[[package]]
+name = "form_urlencoded"
+version = "1.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb4cb245038516f5f85277875cdaa4f7d2c9a0fa0468de06ed190163b1581fcf"
+dependencies = [
+ "percent-encoding",
+]
+
+[[package]]
+name = "fragile"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "28dd6caf6059519a65843af8fe2a3ae298b14b80179855aeb4adc2c1934ee619"
+
+[[package]]
+name = "futures"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "65bc07b1a8bc7c85c5f2e110c476c7389b4554ba72af57d8445ea63a576b0876"
+dependencies = [
+ "futures-channel",
+ "futures-core",
+ "futures-executor",
+ "futures-io",
+ "futures-sink",
+ "futures-task",
+ "futures-util",
+]
+
+[[package]]
+name = "futures-channel"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2dff15bf788c671c1934e366d07e30c1814a8ef514e1af724a602e8a2fbe1b10"
+dependencies = [
+ "futures-core",
+ "futures-sink",
+]
+
+[[package]]
+name = "futures-core"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05f29059c0c2090612e8d742178b0580d2dc940c837851ad723096f87af6663e"
+
+[[package]]
+name = "futures-executor"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1e28d1d997f585e54aebc3f97d39e72338912123a67330d723fdbb564d646c9f"
+dependencies = [
+ "futures-core",
+ "futures-task",
+ "futures-util",
+]
+
+[[package]]
+name = "futures-io"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9e5c1b78ca4aae1ac06c48a526a655760685149f0d465d21f37abfe57ce075c6"
+
+[[package]]
+name = "futures-lite"
+version = "2.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f78e10609fe0e0b3f4157ffab1876319b5b0db102a2c60dc4626306dc46b44ad"
+dependencies = [
+ "fastrand",
+ "futures-core",
+ "futures-io",
+ "parking",
+ "pin-project-lite",
+]
+
+[[package]]
+name = "futures-macro"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "162ee34ebcb7c64a8abebc059ce0fee27c2262618d7b60ed8faf72fef13c3650"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "futures-sink"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e575fab7d1e0dcb8d0c7bcf9a63ee213816ab51902e6d244a95819acacf1d4f7"
+
+[[package]]
+name = "futures-task"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f90f7dce0722e95104fcb095585910c0977252f286e354b5e3bd38902cd99988"
+
+[[package]]
+name = "futures-timer"
+version = "3.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f288b0a4f20f9a56b5d1da57e2227c661b7b16168e2f72365f57b63326e29b24"
+
+[[package]]
+name = "futures-util"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9fa08315bb612088cc391249efdc3bc77536f16c91f6cf495e6fbe85b20a4a81"
+dependencies = [
+ "futures-channel",
+ "futures-core",
+ "futures-io",
+ "futures-macro",
+ "futures-sink",
+ "futures-task",
+ "memchr",
+ "pin-project-lite",
+ "pin-utils",
+ "slab",
+]
+
+[[package]]
+name = "generic-array"
+version = "0.14.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4bb6743198531e02858aeaea5398fcc883e71851fcbcb5a2f773e2fb6cb1edf2"
+dependencies = [
+ "typenum",
+ "version_check",
+ "zeroize",
+]
+
+[[package]]
+name = "gethostname"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1bd49230192a3797a9a4d6abe9b3eed6f7fa4c8a8a4947977c6f80025f92cbd8"
+dependencies = [
+ "rustix 1.1.2",
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.2.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "335ff9f135e4384c8150d6f27c6daed433577f86b4750418338c01a1a2528592"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "wasi 0.11.1+wasi-snapshot-preview1",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "26145e563e54f2cadc477553f1ec5ee650b00862f0a58bcd12cbdc5f0ea2d2f4"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "r-efi",
+ "wasi 0.14.7+wasi-0.2.4",
+]
+
+[[package]]
+name = "ghash"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0d8a4362ccb29cb0b265253fb0a2728f592895ee6854fd9bc13f2ffda266ff1"
+dependencies = [
+ "opaque-debug",
+ "polyval",
+]
+
+[[package]]
+name = "gif"
+version = "0.14.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f5df2ba84018d80c213569363bdcd0c64e6933c67fe4c1d60ecf822971a3c35e"
+dependencies = [
+ "color_quant",
+ "weezl",
+]
+
+[[package]]
+name = "gimli"
+version = "0.31.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "07e28edb80900c19c28f1072f2e8aeca7fa06b23cd4169cefe1af5aa3260783f"
+
+[[package]]
+name = "gl_generator"
+version = "0.14.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1a95dfc23a2b4a9a2f5ab41d194f8bfda3cabec42af4e39f08c339eb2a0c124d"
+dependencies = [
+ "khronos_api",
+ "log",
+ "xml-rs",
+]
+
+[[package]]
+name = "glob"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0cc23270f6e1808e30a928bdc84dea0b9b4136a8bc82338574f23baf47bbd280"
+
+[[package]]
+name = "globset"
+version = "0.4.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "54a1028dfc5f5df5da8a56a73e6c153c9a9708ec57232470703592a3f18e49f5"
+dependencies = [
+ "aho-corasick",
+ "bstr",
+ "log",
+ "regex-automata",
+ "regex-syntax",
+]
+
+[[package]]
+name = "glow"
+version = "0.16.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c5e5ea60d70410161c8bf5da3fdfeaa1c72ed2c15f8bbb9d19fe3a4fad085f08"
+dependencies = [
+ "js-sys",
+ "slotmap",
+ "wasm-bindgen",
+ "web-sys",
+]
+
+[[package]]
+name = "glutin"
+version = "0.32.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "12124de845cacfebedff80e877bb37b5b75c34c5a4c89e47e1cdd67fb6041325"
+dependencies = [
+ "bitflags 2.9.4",
+ "cfg_aliases",
+ "cgl",
+ "dispatch2",
+ "glutin_egl_sys",
+ "glutin_glx_sys",
+ "glutin_wgl_sys",
+ "libloading",
+ "objc2 0.6.3",
+ "objc2-app-kit 0.3.2",
+ "objc2-core-foundation",
+ "objc2-foundation 0.3.2",
+ "once_cell",
+ "raw-window-handle",
+ "wayland-sys",
+ "windows-sys 0.52.0",
+ "x11-dl",
+]
+
+[[package]]
+name = "glutin-winit"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85edca7075f8fc728f28cb8fbb111a96c3b89e930574369e3e9c27eb75d3788f"
+dependencies = [
+ "cfg_aliases",
+ "glutin",
+ "raw-window-handle",
+ "winit",
+]
+
+[[package]]
+name = "glutin_egl_sys"
+version = "0.7.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4c4680ba6195f424febdc3ba46e7a42a0e58743f2edb115297b86d7f8ecc02d2"
+dependencies = [
+ "gl_generator",
+ "windows-sys 0.52.0",
+]
+
+[[package]]
+name = "glutin_glx_sys"
+version = "0.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8a7bb2938045a88b612499fbcba375a77198e01306f52272e692f8c1f3751185"
+dependencies = [
+ "gl_generator",
+ "x11-dl",
+]
+
+[[package]]
+name = "glutin_wgl_sys"
+version = "0.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2c4ee00b289aba7a9e5306d57c2d05499b2e5dc427f84ac708bd2c090212cf3e"
+dependencies = [
+ "gl_generator",
+]
+
+[[package]]
+name = "gpu-alloc"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fbcd2dba93594b227a1f57ee09b8b9da8892c34d55aa332e034a228d0fe6a171"
+dependencies = [
+ "bitflags 2.9.4",
+ "gpu-alloc-types",
+]
+
+[[package]]
+name = "gpu-alloc-types"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "98ff03b468aa837d70984d55f5d3f846f6ec31fe34bbb97c4f85219caeee1ca4"
+dependencies = [
+ "bitflags 2.9.4",
+]
+
+[[package]]
+name = "gpu-allocator"
+version = "0.27.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c151a2a5ef800297b4e79efa4f4bec035c5f51d5ae587287c9b952bdf734cacd"
+dependencies = [
+ "log",
+ "presser",
+ "thiserror 1.0.69",
+ "windows 0.58.0",
+]
+
+[[package]]
+name = "gpu-descriptor"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b89c83349105e3732062a895becfc71a8f921bb71ecbbdd8ff99263e3b53a0ca"
+dependencies = [
+ "bitflags 2.9.4",
+ "gpu-descriptor-types",
+ "hashbrown 0.15.5",
+]
+
+[[package]]
+name = "gpu-descriptor-types"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fdf242682df893b86f33a73828fb09ca4b2d3bb6cc95249707fc684d27484b91"
+dependencies = [
+ "bitflags 2.9.4",
+]
+
+[[package]]
+name = "group"
+version = "0.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0f9ef7462f7c099f518d754361858f86d8a07af53ba9af0fe635bbccb151a63"
+dependencies = [
+ "ff",
+ "rand_core 0.6.4",
+ "subtle",
+]
+
+[[package]]
+name = "gui"
+version = "0.1.0"
+dependencies = [
+ "chrono",
+ "eframe",
+ "egui",
+ "egui-phosphor",
+ "egui_extras",
+ "engine",
+ "image",
+ "mockall",
+ "plugins",
+ "pretty_assertions",
+ "rfd",
+ "rstest",
+ "shared",
+ "strum",
+ "strum_macros",
+ "tokio",
+ "url",
+]
+
+[[package]]
+name = "half"
+version = "2.7.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6ea2d84b969582b4b1864a92dc5d27cd2b77b622a8d79306834f1be5ba20d84b"
+dependencies = [
+ "cfg-if",
+ "crunchy",
+ "num-traits",
+ "zerocopy",
+]
+
+[[package]]
+name = "hashbrown"
+version = "0.15.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9229cfe53dfd69f0609a49f65461bd93001ea1ef889cd5529dd176593f5338a1"
+dependencies = [
+ "foldhash 0.1.5",
+]
+
+[[package]]
+name = "hashbrown"
+version = "0.16.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "841d1cc9bed7f9236f321df977030373f4a4163ae1a7dbfe1a51a2c1a51d9100"
+dependencies = [
+ "foldhash 0.2.0",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "hermit-abi"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc0fef456e4baa96da950455cd02c081ca953b141298e41db3fc7e36b1da849c"
+
+[[package]]
+name = "hex"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7f24254aa9a54b5c858eaee2f5bccdb46aaf0e486a595ed5fd8f86ba55232a70"
+
+[[package]]
+name = "hex-literal"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6fe2267d4ed49bc07b63801559be28c718ea06c4738b7a03c94df7386d2cde46"
+
+[[package]]
+name = "hexf-parse"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dfa686283ad6dd069f105e5ab091b04c62850d3e4cf5d67debad1933f55023df"
+
+[[package]]
+name = "hkdf"
+version = "0.12.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7b5f8eb2ad728638ea2c7d47a21db23b7b58a72ed6a38256b8a1849f15fbbdf7"
+dependencies = [
+ "hmac",
+]
+
+[[package]]
+name = "hmac"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6c49c37c09c17a53d937dfbb742eb3a961d65a994e6bcdcf37e7399d0cc8ab5e"
+dependencies = [
+ "digest 0.10.7",
+]
+
+[[package]]
+name = "hybrid-array"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c7116c472cf19838450b1d421b4e842569f52b519d640aee9ace1ebcf5b21051"
+dependencies = [
+ "typenum",
+]
+
+[[package]]
+name = "iana-time-zone"
+version = "0.1.64"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "33e57f83510bb73707521ebaffa789ec8caf86f9657cad665b092b581d40e9fb"
+dependencies = [
+ "android_system_properties",
+ "core-foundation-sys",
+ "iana-time-zone-haiku",
+ "js-sys",
+ "log",
+ "wasm-bindgen",
+ "windows-core 0.62.0",
+]
+
+[[package]]
+name = "iana-time-zone-haiku"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f31827a206f56af32e590ba56d5d2d085f558508192593743f16b2306495269f"
+dependencies = [
+ "cc",
+]
+
+[[package]]
+name = "icu_collections"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4c6b649701667bbe825c3b7e6388cb521c23d88644678e83c0c4d0a621a34b43"
+dependencies = [
+ "displaydoc",
+ "potential_utf",
+ "yoke",
+ "zerofrom",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_locale_core"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "edba7861004dd3714265b4db54a3c390e880ab658fec5f7db895fae2046b5bb6"
+dependencies = [
+ "displaydoc",
+ "litemap",
+ "tinystr",
+ "writeable",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_normalizer"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5f6c8828b67bf8908d82127b2054ea1b4427ff0230ee9141c54251934ab1b599"
+dependencies = [
+ "icu_collections",
+ "icu_normalizer_data",
+ "icu_properties",
+ "icu_provider",
+ "smallvec",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_normalizer_data"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7aedcccd01fc5fe81e6b489c15b247b8b0690feb23304303a9e560f37efc560a"
+
+[[package]]
+name = "icu_properties"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e93fcd3157766c0c8da2f8cff6ce651a31f0810eaa1c51ec363ef790bbb5fb99"
+dependencies = [
+ "icu_collections",
+ "icu_locale_core",
+ "icu_properties_data",
+ "icu_provider",
+ "zerotrie",
+ "zerovec",
+]
+
+[[package]]
+name = "icu_properties_data"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "02845b3647bb045f1100ecd6480ff52f34c35f82d9880e029d329c21d1054899"
+
+[[package]]
+name = "icu_provider"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85962cf0ce02e1e0a629cc34e7ca3e373ce20dda4c4d7294bbd0bf1fdb59e614"
+dependencies = [
+ "displaydoc",
+ "icu_locale_core",
+ "writeable",
+ "yoke",
+ "zerofrom",
+ "zerotrie",
+ "zerovec",
+]
+
+[[package]]
+name = "idna"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3b0875f23caa03898994f6ddc501886a45c7d3d62d04d2d90788d47be1b1e4de"
+dependencies = [
+ "idna_adapter",
+ "smallvec",
+ "utf8_iter",
+]
+
+[[package]]
+name = "idna_adapter"
+version = "1.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3acae9609540aa318d1bc588455225fb2085b9ed0c4f6bd0d9d5bcd86f1a0344"
+dependencies = [
+ "icu_normalizer",
+ "icu_properties",
+]
+
+[[package]]
+name = "image"
+version = "0.25.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6506c6c10786659413faa717ceebcb8f70731c0a60cbae39795fdf114519c1a"
+dependencies = [
+ "bytemuck",
+ "byteorder-lite",
+ "color_quant",
+ "exr",
+ "gif",
+ "image-webp",
+ "moxcms",
+ "num-traits",
+ "png 0.18.0",
+ "qoi",
+ "ravif",
+ "rayon",
+ "rgb",
+ "tiff",
+ "zune-core 0.5.0",
+ "zune-jpeg 0.5.6",
+]
+
+[[package]]
+name = "image-webp"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "525e9ff3e1a4be2fbea1fdf0e98686a6d98b4d8f937e1bf7402245af1909e8c3"
+dependencies = [
+ "byteorder-lite",
+ "quick-error",
+]
+
+[[package]]
+name = "imagesize"
+version = "0.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "edcd27d72f2f071c64249075f42e205ff93c9a4c5f6c6da53e79ed9f9832c285"
+
+[[package]]
+name = "imgref"
+version = "1.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e7c5cedc30da3a610cac6b4ba17597bdf7152cf974e8aab3afb3d54455e371c8"
+
+[[package]]
+name = "indexmap"
+version = "2.11.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92119844f513ffa41556430369ab02c295a3578af21cf945caa3e9e0c2481ac3"
+dependencies = [
+ "equivalent",
+ "hashbrown 0.15.5",
+]
+
+[[package]]
+name = "inout"
+version = "0.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "879f10e63c20629ecabbb64a8010319738c66a5cd0c29b02d63d272b03751d01"
+dependencies = [
+ "block-padding",
+ "generic-array",
+]
+
+[[package]]
+name = "interpolate_name"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c34819042dc3d3971c46c2190835914dfbe0c3c13f61449b2997f4e9722dfa60"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "is_ci"
+version = "1.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7655c9839580ee829dfacba1d1278c2b7883e50a277ff7541299489d6bdfdc45"
+
+[[package]]
+name = "is_terminal_polyfill"
+version = "1.70.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7943c866cc5cd64cbc25b2e01621d07fa8eb2a1a23160ee81ce38704e97b8ecf"
+
+[[package]]
+name = "itertools"
+version = "0.14.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2b192c782037fadd9cfa75548310488aabdbf3d2da73885b31bd0abd03351285"
+dependencies = [
+ "either",
+]
+
+[[package]]
+name = "itoa"
+version = "1.0.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4a5f13b858c8d314ee3e8f639011f7ccefe71f97f96e50151fb991f267928e2c"
+
+[[package]]
+name = "jni"
+version = "0.21.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1a87aa2bb7d2af34197c04845522473242e1aa17c12f4935d5856491a7fb8c97"
+dependencies = [
+ "cesu8",
+ "cfg-if",
+ "combine",
+ "jni-sys",
+ "log",
+ "thiserror 1.0.69",
+ "walkdir",
+ "windows-sys 0.45.0",
+]
+
+[[package]]
+name = "jni-sys"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8eaf4bc02d17cbdd7ff4c7438cafcdf7fb9a4613313ad11b4f8fefe7d3fa0130"
+
+[[package]]
+name = "jobserver"
+version = "0.1.34"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9afb3de4395d6b3e67a780b6de64b51c978ecf11cb9a462c66be7d4ca9039d33"
+dependencies = [
+ "getrandom 0.3.3",
+ "libc",
+]
+
+[[package]]
+name = "js-sys"
+version = "0.3.80"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "852f13bec5eba4ba9afbeb93fd7c13fe56147f055939ae21c43a29a0ecb2702e"
+dependencies = [
+ "once_cell",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "khronos-egl"
+version = "6.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6aae1df220ece3c0ada96b8153459b67eebe9ae9212258bb0134ae60416fdf76"
+dependencies = [
+ "libc",
+ "libloading",
+ "pkg-config",
+]
+
+[[package]]
+name = "khronos_api"
+version = "3.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e2db585e1d738fc771bf08a151420d3ed193d9d895a36df7f6f8a9456b911ddc"
+
+[[package]]
+name = "kurbo"
+version = "0.11.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c62026ae44756f8a599ba21140f350303d4f08dcdcc71b5ad9c9bb8128c13c62"
+dependencies = [
+ "arrayvec",
+ "euclid",
+ "smallvec",
+]
+
+[[package]]
+name = "lazy_static"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
+dependencies = [
+ "spin 0.9.8",
+]
+
+[[package]]
+name = "lebe"
+version = "0.5.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7a79a3332a6609480d7d0c9eab957bca6b455b91bb84e66d19f5ff66294b85b8"
+
+[[package]]
+name = "libc"
+version = "0.2.175"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6a82ae493e598baaea5209805c49bbf2ea7de956d50d7da0da1164f9c6d28543"
+
+[[package]]
+name = "libfuzzer-sys"
+version = "0.4.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5037190e1f70cbeef565bd267599242926f724d3b8a9f510fd7e0b540cfa4404"
+dependencies = [
+ "arbitrary",
+ "cc",
+]
+
+[[package]]
+name = "libloading"
+version = "0.8.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d7c4b02199fee7c5d21a5ae7d8cfa79a6ef5bb2fc834d6e9058e89c825efdc55"
+dependencies = [
+ "cfg-if",
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "libm"
+version = "0.2.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f9fbbcab51052fe104eb5e5d351cf728d30a5be1fe14d9be8a3b097481fb97de"
+
+[[package]]
+name = "libredox"
+version = "0.1.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "416f7e718bdb06000964960ffa43b4335ad4012ae8b99060261aa4a8088d5ccb"
+dependencies = [
+ "bitflags 2.9.4",
+ "libc",
+ "redox_syscall 0.5.18",
+]
+
+[[package]]
+name = "linux-raw-sys"
+version = "0.4.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d26c52dbd32dccf2d10cac7725f8eae5296885fb5703b261f7d0a0739ec807ab"
+
+[[package]]
+name = "linux-raw-sys"
+version = "0.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "df1d3c3b53da64cf5760482273a98e575c651a67eec7f77df96b5b642de8f039"
+
+[[package]]
+name = "litemap"
+version = "0.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6373607a59f0be73a39b6fe456b8192fcc3585f602af20751600e974dd455e77"
+
+[[package]]
+name = "litrs"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "11d3d7f243d5c5a8b9bb5d6dd2b1602c0cb0b9db1621bafc7ed66e35ff9fe092"
+
+[[package]]
+name = "lock_api"
+version = "0.4.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "224399e74b87b5f3557511d98dff8b14089b3dadafcab6bb93eab67d3aace965"
+dependencies = [
+ "scopeguard",
+]
+
+[[package]]
+name = "log"
+version = "0.4.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "34080505efa8e45a4b816c349525ebe327ceaa8559756f0356cba97ef3bf7432"
+
+[[package]]
+name = "loop9"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fae87c125b03c1d2c0150c90365d7d6bcc53fb73a9acaef207d2d065860f062"
+dependencies = [
+ "imgref",
+]
+
+[[package]]
+name = "malloc_buf"
+version = "0.0.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "62bb907fe88d54d8d9ce32a3cceab4218ed2f6b7d35617cafe9adf84e43919cb"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "maybe-rayon"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ea1f30cedd69f0a2954655f7188c6a834246d2bcf1e315e2ac40c4b24dc9519"
+dependencies = [
+ "cfg-if",
+ "rayon",
+]
+
+[[package]]
+name = "md5"
+version = "0.7.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "490cc448043f947bae3cbee9c203358d62dbee0db12107a74be5c30ccfd09771"
+
+[[package]]
+name = "memchr"
+version = "2.7.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a282da65faaf38286cf3be983213fcf1d2e2a58700e808f83f4ea9a4804bc0"
+
+[[package]]
+name = "memmap2"
+version = "0.9.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "744133e4a0e0a658e1374cf3bf8e415c4052a15a111acd372764c55b4177d490"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "metal"
+version = "0.32.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "00c15a6f673ff72ddcc22394663290f870fb224c1bfce55734a75c414150e605"
+dependencies = [
+ "bitflags 2.9.4",
+ "block",
+ "core-graphics-types 0.2.0",
+ "foreign-types",
+ "log",
+ "objc",
+ "paste",
+]
+
+[[package]]
+name = "miette"
+version = "7.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5f98efec8807c63c752b5bd61f862c165c115b0a35685bdcfd9238c7aeb592b7"
+dependencies = [
+ "backtrace",
+ "backtrace-ext",
+ "cfg-if",
+ "miette-derive",
+ "owo-colors",
+ "supports-color",
+ "supports-hyperlinks",
+ "supports-unicode",
+ "terminal_size",
+ "textwrap",
+ "unicode-width 0.1.14",
+]
+
+[[package]]
+name = "miette-derive"
+version = "7.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "db5b29714e950dbb20d5e6f74f9dcec4edbcc1067bb7f8ed198c097b8c1a818b"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "mime"
+version = "0.3.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6877bb514081ee2a7ff5ef9de3281f14a4dd4bceac4c09388074a6b5df8a139a"
+
+[[package]]
+name = "mime_guess2"
+version = "2.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1706dc14a2e140dec0a7a07109d9a3d5890b81e85bd6c60b906b249a77adf0ca"
+dependencies = [
+ "mime",
+ "phf",
+ "phf_shared",
+ "unicase",
+]
+
+[[package]]
+name = "miniz_oxide"
+version = "0.8.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fa76a2c86f704bdb222d66965fb3d63269ce38518b83cb0575fca855ebb6316"
+dependencies = [
+ "adler2",
+ "simd-adler32",
+]
+
+[[package]]
+name = "mio"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "69d83b0086dc8ecf3ce9ae2874b2d1290252e2a30720bea58a5c6639b0092873"
+dependencies = [
+ "libc",
+ "wasi 0.11.1+wasi-snapshot-preview1",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "mockall"
+version = "0.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "39a6bfcc6c8c7eed5ee98b9c3e33adc726054389233e201c95dab2d41a3839d2"
+dependencies = [
+ "cfg-if",
+ "downcast",
+ "fragile",
+ "mockall_derive",
+ "predicates",
+ "predicates-tree",
+]
+
+[[package]]
+name = "mockall_derive"
+version = "0.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "25ca3004c2efe9011bd4e461bd8256445052b9615405b4f7ea43fc8ca5c20898"
+dependencies = [
+ "cfg-if",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "moxcms"
+version = "0.7.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "80986bbbcf925ebd3be54c26613d861255284584501595cf418320c078945608"
+dependencies = [
+ "num-traits",
+ "pxfm",
+]
+
+[[package]]
+name = "naga"
+version = "27.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "066cf25f0e8b11ee0df221219010f213ad429855f57c494f995590c861a9a7d8"
+dependencies = [
+ "arrayvec",
+ "bit-set",
+ "bitflags 2.9.4",
+ "cfg-if",
+ "cfg_aliases",
+ "codespan-reporting",
+ "half",
+ "hashbrown 0.16.1",
+ "hexf-parse",
+ "indexmap",
+ "libm",
+ "log",
+ "num-traits",
+ "once_cell",
+ "rustc-hash 1.1.0",
+ "spirv",
+ "thiserror 2.0.17",
+ "unicode-ident",
+]
+
+[[package]]
+name = "ndk"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c3f42e7bbe13d351b6bead8286a43aac9534b82bd3cc43e47037f012ebfd62d4"
+dependencies = [
+ "bitflags 2.9.4",
+ "jni-sys",
+ "log",
+ "ndk-sys",
+ "num_enum",
+ "raw-window-handle",
+ "thiserror 1.0.69",
+]
+
+[[package]]
+name = "ndk-context"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "27b02d87554356db9e9a873add8782d4ea6e3e58ea071a9adb9a2e8ddb884a8b"
+
+[[package]]
+name = "ndk-sys"
+version = "0.6.0+11769913"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ee6cda3051665f1fb8d9e08fc35c96d5a244fb1be711a03b71118828afc9a873"
+dependencies = [
+ "jni-sys",
+]
+
+[[package]]
+name = "new_debug_unreachable"
+version = "1.0.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "650eef8c711430f1a879fdd01d4745a7deea475becfb90269c06775983bbf086"
+
+[[package]]
+name = "nix"
+version = "0.30.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "74523f3a35e05aba87a1d978330aef40f67b0304ac79c1c00b294c9830543db6"
+dependencies = [
+ "bitflags 2.9.4",
+ "cfg-if",
+ "cfg_aliases",
+ "libc",
+ "memoffset",
+]
+
+[[package]]
+name = "nohash-hasher"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2bf50223579dc7cdcfb3bfcacf7069ff68243f8c363f62ffa99cf000a6b9c451"
+
+[[package]]
+name = "nom"
+version = "8.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "df9761775871bdef83bee530e60050f7e54b1105350d6884eb0fb4f46c2f9405"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "noop_proc_macro"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0676bb32a98c1a483ce53e500a81ad9c3d5b3f7c920c28c24e9cb0980d0b5bc8"
+
+[[package]]
+name = "nu-ansi-term"
+version = "0.50.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7957b9740744892f114936ab4a57b3f487491bbeafaf8083688b16841a4240e5"
+dependencies = [
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "num-bigint"
+version = "0.4.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a5e44f723f1133c9deac646763579fdb3ac745e418f2a7af9cd0c431da1f20b9"
+dependencies = [
+ "num-integer",
+ "num-traits",
+ "rand 0.8.5",
+]
+
+[[package]]
+name = "num-bigint-dig"
+version = "0.8.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "82c79c15c05d4bf82b6f5ef163104cc81a760d8e874d38ac50ab67c8877b647b"
+dependencies = [
+ "lazy_static",
+ "libm",
+ "num-integer",
+ "num-iter",
+ "num-traits",
+ "rand 0.8.5",
+ "smallvec",
+ "zeroize",
+]
+
+[[package]]
+name = "num-derive"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ed3955f1a9c7c0c15e092f9c887db08b1fc683305fdf6eb6684f22555355e202"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "num-integer"
+version = "0.1.46"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7969661fd2958a5cb096e56c8e1ad0444ac2bbcd0061bd28660485a44879858f"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "num-iter"
+version = "0.1.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1429034a0490724d0075ebb2bc9e875d6503c3cf69e235a8941aa757d83ef5bf"
+dependencies = [
+ "autocfg",
+ "num-integer",
+ "num-traits",
+]
+
+[[package]]
+name = "num-rational"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f83d14da390562dca69fc84082e73e548e1ad308d24accdedd2720017cb37824"
+dependencies = [
+ "num-bigint",
+ "num-integer",
+ "num-traits",
+]
+
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+ "libm",
+]
+
+[[package]]
+name = "num_enum"
+version = "0.7.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b1207a7e20ad57b847bbddc6776b968420d38292bbfe2089accff5e19e82454c"
+dependencies = [
+ "num_enum_derive",
+ "rustversion",
+]
+
+[[package]]
+name = "num_enum_derive"
+version = "0.7.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ff32365de1b6743cb203b710788263c44a03de03802daf96092f2da4fe6ba4d7"
+dependencies = [
+ "proc-macro-crate",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "objc"
+version = "0.2.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "915b1b472bc21c53464d6c8461c9d3af805ba1ef837e1cac254428f4a77177b1"
+dependencies = [
+ "malloc_buf",
+]
+
+[[package]]
+name = "objc-sys"
+version = "0.3.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cdb91bdd390c7ce1a8607f35f3ca7151b65afc0ff5ff3b34fa350f7d7c7e4310"
+
+[[package]]
+name = "objc2"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "46a785d4eeff09c14c487497c162e92766fbb3e4059a71840cecc03d9a50b804"
+dependencies = [
+ "objc-sys",
+ "objc2-encode",
+]
+
+[[package]]
+name = "objc2"
+version = "0.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b7c2599ce0ec54857b29ce62166b0ed9b4f6f1a70ccc9a71165b6154caca8c05"
+dependencies = [
+ "objc2-encode",
+]
+
+[[package]]
+name = "objc2-app-kit"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e4e89ad9e3d7d297152b17d39ed92cd50ca8063a89a9fa569046d41568891eff"
+dependencies = [
+ "bitflags 2.9.4",
+ "block2 0.5.1",
+ "libc",
+ "objc2 0.5.2",
+ "objc2-core-data",
+ "objc2-core-image",
+ "objc2-foundation 0.2.2",
+ "objc2-quartz-core",
+]
+
+[[package]]
+name = "objc2-app-kit"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d49e936b501e5c5bf01fda3a9452ff86dc3ea98ad5f283e1455153142d97518c"
+dependencies = [
+ "bitflags 2.9.4",
+ "block2 0.6.2",
+ "objc2 0.6.3",
+ "objc2-core-foundation",
+ "objc2-core-graphics",
+ "objc2-foundation 0.3.2",
+]
+
+[[package]]
+name = "objc2-cloud-kit"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "74dd3b56391c7a0596a295029734d3c1c5e7e510a4cb30245f8221ccea96b009"
+dependencies = [
+ "bitflags 2.9.4",
+ "block2 0.5.1",
+ "objc2 0.5.2",
+ "objc2-core-location",
+ "objc2-foundation 0.2.2",
+]
+
+[[package]]
+name = "objc2-contacts"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a5ff520e9c33812fd374d8deecef01d4a840e7b41862d849513de77e44aa4889"
+dependencies = [
+ "block2 0.5.1",
+ "objc2 0.5.2",
+ "objc2-foundation 0.2.2",
+]
+
+[[package]]
+name = "objc2-core-data"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "617fbf49e071c178c0b24c080767db52958f716d9eabdf0890523aeae54773ef"
+dependencies = [
+ "bitflags 2.9.4",
+ "block2 0.5.1",
+ "objc2 0.5.2",
+ "objc2-foundation 0.2.2",
+]
+
+[[package]]
+name = "objc2-core-foundation"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2a180dd8642fa45cdb7dd721cd4c11b1cadd4929ce112ebd8b9f5803cc79d536"
+dependencies = [
+ "bitflags 2.9.4",
+ "dispatch2",
+ "objc2 0.6.3",
+]
+
+[[package]]
+name = "objc2-core-graphics"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e022c9d066895efa1345f8e33e584b9f958da2fd4cd116792e15e07e4720a807"
+dependencies = [
+ "bitflags 2.9.4",
+ "dispatch2",
+ "objc2 0.6.3",
+ "objc2-core-foundation",
+ "objc2-io-surface",
+]
+
+[[package]]
+name = "objc2-core-image"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "55260963a527c99f1819c4f8e3b47fe04f9650694ef348ffd2227e8196d34c80"
+dependencies = [
+ "block2 0.5.1",
+ "objc2 0.5.2",
+ "objc2-foundation 0.2.2",
+ "objc2-metal",
+]
+
+[[package]]
+name = "objc2-core-location"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "000cfee34e683244f284252ee206a27953279d370e309649dc3ee317b37e5781"
+dependencies = [
+ "block2 0.5.1",
+ "objc2 0.5.2",
+ "objc2-contacts",
+ "objc2-foundation 0.2.2",
+]
+
+[[package]]
+name = "objc2-encode"
+version = "4.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ef25abbcd74fb2609453eb695bd2f860d389e457f67dc17cafc8b8cbc89d0c33"
+
+[[package]]
+name = "objc2-foundation"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ee638a5da3799329310ad4cfa62fbf045d5f56e3ef5ba4149e7452dcf89d5a8"
+dependencies = [
+ "bitflags 2.9.4",
+ "block2 0.5.1",
+ "dispatch",
+ "libc",
+ "objc2 0.5.2",
+]
+
+[[package]]
+name = "objc2-foundation"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e3e0adef53c21f888deb4fa59fc59f7eb17404926ee8a6f59f5df0fd7f9f3272"
+dependencies = [
+ "bitflags 2.9.4",
+ "objc2 0.6.3",
+ "objc2-core-foundation",
+]
+
+[[package]]
+name = "objc2-io-surface"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "180788110936d59bab6bd83b6060ffdfffb3b922ba1396b312ae795e1de9d81d"
+dependencies = [
+ "bitflags 2.9.4",
+ "objc2 0.6.3",
+ "objc2-core-foundation",
+]
+
+[[package]]
+name = "objc2-link-presentation"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a1a1ae721c5e35be65f01a03b6d2ac13a54cb4fa70d8a5da293d7b0020261398"
+dependencies = [
+ "block2 0.5.1",
+ "objc2 0.5.2",
+ "objc2-app-kit 0.2.2",
+ "objc2-foundation 0.2.2",
+]
+
+[[package]]
+name = "objc2-metal"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dd0cba1276f6023976a406a14ffa85e1fdd19df6b0f737b063b95f6c8c7aadd6"
+dependencies = [
+ "bitflags 2.9.4",
+ "block2 0.5.1",
+ "objc2 0.5.2",
+ "objc2-foundation 0.2.2",
+]
+
+[[package]]
+name = "objc2-quartz-core"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e42bee7bff906b14b167da2bac5efe6b6a07e6f7c0a21a7308d40c960242dc7a"
+dependencies = [
+ "bitflags 2.9.4",
+ "block2 0.5.1",
+ "objc2 0.5.2",
+ "objc2-foundation 0.2.2",
+ "objc2-metal",
+]
+
+[[package]]
+name = "objc2-symbols"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0a684efe3dec1b305badae1a28f6555f6ddd3bb2c2267896782858d5a78404dc"
+dependencies = [
+ "objc2 0.5.2",
+ "objc2-foundation 0.2.2",
+]
+
+[[package]]
+name = "objc2-ui-kit"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8bb46798b20cd6b91cbd113524c490f1686f4c4e8f49502431415f3512e2b6f"
+dependencies = [
+ "bitflags 2.9.4",
+ "block2 0.5.1",
+ "objc2 0.5.2",
+ "objc2-cloud-kit",
+ "objc2-core-data",
+ "objc2-core-image",
+ "objc2-core-location",
+ "objc2-foundation 0.2.2",
+ "objc2-link-presentation",
+ "objc2-quartz-core",
+ "objc2-symbols",
+ "objc2-uniform-type-identifiers",
+ "objc2-user-notifications",
+]
+
+[[package]]
+name = "objc2-uniform-type-identifiers"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "44fa5f9748dbfe1ca6c0b79ad20725a11eca7c2218bceb4b005cb1be26273bfe"
+dependencies = [
+ "block2 0.5.1",
+ "objc2 0.5.2",
+ "objc2-foundation 0.2.2",
+]
+
+[[package]]
+name = "objc2-user-notifications"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "76cfcbf642358e8689af64cee815d139339f3ed8ad05103ed5eaf73db8d84cb3"
+dependencies = [
+ "bitflags 2.9.4",
+ "block2 0.5.1",
+ "objc2 0.5.2",
+ "objc2-core-location",
+ "objc2-foundation 0.2.2",
+]
+
+[[package]]
+name = "object"
+version = "0.36.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "62948e14d923ea95ea2c7c86c71013138b66525b86bdc08d2dcc262bdb497b87"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "42f5e15c9953c5e4ccceeb2e7382a716482c34515315f7b03532b8b4e8393d2d"
+
+[[package]]
+name = "once_cell_polyfill"
+version = "1.70.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a4895175b425cb1f87721b59f0f286c2092bd4af812243672510e1ac53e2e0ad"
+
+[[package]]
+name = "opaque-debug"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c08d65885ee38876c4f86fa503fb49d7b507c2b62552df7c70b2fce627e06381"
+
+[[package]]
+name = "option-ext"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "04744f49eae99ab78e0d5c0b603ab218f515ea8cfe5a456d7629ad883a3b6e7d"
+
+[[package]]
+name = "orbclient"
+version = "0.3.49"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "247ad146e19b9437f8604c21f8652423595cf710ad108af40e77d3ae6e96b827"
+dependencies = [
+ "libredox",
+]
+
+[[package]]
+name = "ordered-float"
+version = "5.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7f4779c6901a562440c3786d08192c6fbda7c1c2060edd10006b05ee35d10f2d"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "ordered-stream"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9aa2b01e1d916879f73a53d01d1d6cee68adbb31d6d9177a8cfce093cced1d50"
+dependencies = [
+ "futures-core",
+ "pin-project-lite",
+]
+
+[[package]]
+name = "owned_ttf_parser"
+version = "0.25.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "36820e9051aca1014ddc75770aab4d68bc1e9e632f0f5627c4086bc216fb583b"
+dependencies = [
+ "ttf-parser",
+]
+
+[[package]]
+name = "owo-colors"
+version = "4.2.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9c6901729fa79e91a0913333229e9ca5dc725089d1c363b2f4b4760709dc4a52"
+
+[[package]]
+name = "p256"
+version = "0.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c9863ad85fa8f4460f9c48cb909d38a0d689dba1f6f6988a5e3e0d31071bcd4b"
+dependencies = [
+ "ecdsa",
+ "elliptic-curve",
+ "primeorder",
+ "sha2",
+]
+
+[[package]]
+name = "p384"
+version = "0.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fe42f1670a52a47d448f14b6a5c61dd78fce51856e68edaa38f7ae3a46b8d6b6"
+dependencies = [
+ "ecdsa",
+ "elliptic-curve",
+ "primeorder",
+ "sha2",
+]
+
+[[package]]
+name = "p521"
+version = "0.13.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fc9e2161f1f215afdfce23677034ae137bbd45016a880c2eb3ba8eb95f085b2"
+dependencies = [
+ "base16ct",
+ "ecdsa",
+ "elliptic-curve",
+ "primeorder",
+ "rand_core 0.6.4",
+ "sha2",
+]
+
+[[package]]
+name = "parking"
+version = "2.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f38d5652c16fde515bb1ecef450ab0f6a219d619a7274976324d5e377f7dceba"
+
+[[package]]
+name = "parking_lot"
+version = "0.12.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93857453250e3077bd71ff98b6a65ea6621a19bb0f559a85248955ac12c45a1a"
+dependencies = [
+ "lock_api",
+ "parking_lot_core",
+]
+
+[[package]]
+name = "parking_lot_core"
+version = "0.9.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2621685985a2ebf1c516881c026032ac7deafcda1a2c9b7850dc81e3dfcb64c1"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "redox_syscall 0.5.18",
+ "smallvec",
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "password-hash"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7676374caaee8a325c9e7a2ae557f216c5563a171d6997b0ef8a65af35147700"
+dependencies = [
+ "base64ct",
+ "rand_core 0.6.4",
+ "subtle",
+]
+
+[[package]]
+name = "paste"
+version = "1.0.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "57c0d7b74b563b49d38dae00a0c37d4d6de9b432382b2892f0574ddcae73fd0a"
+
+[[package]]
+name = "pastey"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "35fb2e5f958ec131621fdd531e9fc186ed768cbe395337403ae56c17a74c68ec"
+
+[[package]]
+name = "path-absolutize"
+version = "3.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e4af381fe79fa195b4909485d99f73a80792331df0625188e707854f0b3383f5"
+dependencies = [
+ "path-dedot",
+]
+
+[[package]]
+name = "path-dedot"
+version = "3.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "07ba0ad7e047712414213ff67533e6dd477af0a4e1d14fb52343e53d30ea9397"
+dependencies = [
+ "once_cell",
+]
+
+[[package]]
+name = "pbkdf2"
+version = "0.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "83a0692ec44e4cf1ef28ca317f14f8f07da2d95ec3fa01f86e4467b725e60917"
+dependencies = [
+ "digest 0.10.7",
+ "hmac",
+ "password-hash",
+ "sha2",
+]
+
+[[package]]
+name = "pbkdf2"
+version = "0.12.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8ed6a7761f76e3b9f92dfb0a60a6a6477c61024b775147ff0973a02653abaf2"
+dependencies = [
+ "digest 0.10.7",
+ "hmac",
+]
+
+[[package]]
+name = "pem-rfc7468"
+version = "0.7.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "88b39c9bfcfc231068454382784bb460aae594343fb030d46e9f50a645418412"
+dependencies = [
+ "base64ct",
+]
+
+[[package]]
+name = "percent-encoding"
+version = "2.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b4f627cb1b25917193a259e49bdad08f671f8d9708acfd5fe0a8c1455d87220"
+
+[[package]]
+name = "phf"
+version = "0.11.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fd6780a80ae0c52cc120a26a1a42c1ae51b247a253e4e06113d23d2c2edd078"
+dependencies = [
+ "phf_macros",
+ "phf_shared",
+]
+
+[[package]]
+name = "phf_generator"
+version = "0.11.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3c80231409c20246a13fddb31776fb942c38553c51e871f8cbd687a4cfb5843d"
+dependencies = [
+ "phf_shared",
+ "rand 0.8.5",
+]
+
+[[package]]
+name = "phf_macros"
+version = "0.11.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f84ac04429c13a7ff43785d75ad27569f2951ce0ffd30a3321230db2fc727216"
+dependencies = [
+ "phf_generator",
+ "phf_shared",
+ "proc-macro2",
+ "quote",
+ "syn",
+ "unicase",
+]
+
+[[package]]
+name = "phf_shared"
+version = "0.11.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "67eabc2ef2a60eb7faa00097bd1ffdb5bd28e62bf39990626a582201b7a754e5"
+dependencies = [
+ "siphasher",
+ "unicase",
+]
+
+[[package]]
+name = "pico-args"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5be167a7af36ee22fe3115051bc51f6e6c7054c9348e28deb4f49bd6f705a315"
+
+[[package]]
+name = "pin-project"
+version = "1.1.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "677f1add503faace112b9f1373e43e9e054bfdd22ff1a63c1bc485eaec6a6a8a"
+dependencies = [
+ "pin-project-internal",
+]
+
+[[package]]
+name = "pin-project-internal"
+version = "1.1.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6e918e4ff8c4549eb882f14b3a4bc8c8bc93de829416eacf579f1207a8fbf861"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pin-project-lite"
+version = "0.2.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3b3cff922bd51709b605d9ead9aa71031d81447142d828eb4a6eba76fe619f9b"
+
+[[package]]
+name = "pin-utils"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8b870d8c151b6f2fb93e84a13146138f05d02ed11c7e7c54f8826aaaf7c9f184"
+
+[[package]]
+name = "piper"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "96c8c490f422ef9a4efd2cb5b42b76c8613d7e7dfc1caf667b8a3350a5acc066"
+dependencies = [
+ "atomic-waker",
+ "fastrand",
+ "futures-io",
+]
+
+[[package]]
+name = "pkcs1"
+version = "0.7.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c8ffb9f10fa047879315e6625af03c164b16962a5368d724ed16323b68ace47f"
+dependencies = [
+ "der",
+ "pkcs8",
+ "spki",
+]
+
+[[package]]
+name = "pkcs5"
+version = "0.7.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e847e2c91a18bfa887dd028ec33f2fe6f25db77db3619024764914affe8b69a6"
+dependencies = [
+ "aes",
+ "cbc",
+ "der",
+ "pbkdf2 0.12.2",
+ "scrypt",
+ "sha2",
+ "spki",
+]
+
+[[package]]
+name = "pkcs8"
+version = "0.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f950b2377845cebe5cf8b5165cb3cc1a5e0fa5cfa3e1f7f55707d8fd82e0a7b7"
+dependencies = [
+ "der",
+ "pkcs5",
+ "rand_core 0.6.4",
+ "spki",
+]
+
+[[package]]
+name = "pkg-config"
+version = "0.3.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7edddbd0b52d732b21ad9a5fab5c704c14cd949e5e9a1ec5929a24fded1b904c"
+
+[[package]]
+name = "plugins"
+version = "0.1.0"
+dependencies = [
+ "chrono",
+ "mockall",
+ "owo-colors",
+ "pretty_assertions",
+ "rstest",
+ "serde",
+ "serde_json",
+ "shared",
+ "strum",
+ "strum_macros",
+ "thiserror 2.0.17",
+ "wait-timeout",
+]
+
+[[package]]
+name = "png"
+version = "0.17.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "82151a2fc869e011c153adc57cf2789ccb8d9906ce52c0b39a6b5697749d7526"
+dependencies = [
+ "bitflags 1.3.2",
+ "crc32fast",
+ "fdeflate",
+ "flate2",
+ "miniz_oxide",
+]
+
+[[package]]
+name = "png"
+version = "0.18.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "97baced388464909d42d89643fe4361939af9b7ce7a31ee32a168f832a70f2a0"
+dependencies = [
+ "bitflags 2.9.4",
+ "crc32fast",
+ "fdeflate",
+ "flate2",
+ "miniz_oxide",
+]
+
+[[package]]
+name = "polling"
+version = "3.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5d0e4f59085d47d8241c88ead0f274e8a0cb551f3625263c05eb8dd897c34218"
+dependencies = [
+ "cfg-if",
+ "concurrent-queue",
+ "hermit-abi",
+ "pin-project-lite",
+ "rustix 1.1.2",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "pollster"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2f3a9f18d041e6d0e102a0a46750538147e5e8992d3b4873aaafee2520b00ce3"
+
+[[package]]
+name = "poly1305"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8159bd90725d2df49889a078b54f4f79e87f1f8a8444194cdca81d38f5393abf"
+dependencies = [
+ "cpufeatures",
+ "opaque-debug",
+ "universal-hash",
+]
+
+[[package]]
+name = "polyval"
+version = "0.6.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9d1fe60d06143b2430aa532c94cfe9e29783047f06c0d7fd359a9a51b729fa25"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "opaque-debug",
+ "universal-hash",
+]
+
+[[package]]
+name = "portable-atomic"
+version = "1.11.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f84267b20a16ea918e43c6a88433c2d54fa145c92a811b5b047ccbe153674483"
+
+[[package]]
+name = "portable-atomic-util"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d8a2f0d8d040d7848a709caf78912debcc3f33ee4b3cac47d73d1e1069e83507"
+dependencies = [
+ "portable-atomic",
+]
+
+[[package]]
+name = "potential_utf"
+version = "0.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b73949432f5e2a09657003c25bca5e19a0e9c84f8058ca374f49e0ebe605af77"
+dependencies = [
+ "zerovec",
+]
+
+[[package]]
+name = "ppv-lite86"
+version = "0.2.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85eae3c4ed2f50dcfe72643da4befc30deadb458a9b590d720cde2f2b1e97da9"
+dependencies = [
+ "zerocopy",
+]
+
+[[package]]
+name = "predicates"
+version = "3.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a5d19ee57562043d37e82899fade9a22ebab7be9cef5026b07fda9cdd4293573"
+dependencies = [
+ "anstyle",
+ "predicates-core",
+]
+
+[[package]]
+name = "predicates-core"
+version = "1.0.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "727e462b119fe9c93fd0eb1429a5f7647394014cf3c04ab2c0350eeb09095ffa"
+
+[[package]]
+name = "predicates-tree"
+version = "1.0.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72dd2d6d381dfb73a193c7fca536518d7caee39fc8503f74e7dc0be0531b425c"
+dependencies = [
+ "predicates-core",
+ "termtree",
+]
+
+[[package]]
+name = "presser"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e8cf8e6a8aa66ce33f63993ffc4ea4271eb5b0530a9002db8455ea6050c77bfa"
+
+[[package]]
+name = "pretty_assertions"
+version = "1.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ae130e2f271fbc2ac3a40fb1d07180839cdbbe443c7a27e1e3c13c5cac0116d"
+dependencies = [
+ "diff",
+ "yansi",
+]
+
+[[package]]
+name = "primeorder"
+version = "0.13.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "353e1ca18966c16d9deb1c69278edbc5f194139612772bd9537af60ac231e1e6"
+dependencies = [
+ "elliptic-curve",
+]
+
+[[package]]
+name = "proc-macro-crate"
+version = "3.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "219cb19e96be00ab2e37d6e299658a0cfa83e52429179969b0f0121b4ac46983"
+dependencies = [
+ "toml_edit",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.101"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "89ae43fd86e4158d6db51ad8e2b80f313af9cc74f5c0e03ccb87de09998732de"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "profiling"
+version = "1.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3eb8486b569e12e2c32ad3e204dbaba5e4b5b216e9367044f25f1dba42341773"
+dependencies = [
+ "profiling-procmacros",
+]
+
+[[package]]
+name = "profiling-procmacros"
+version = "1.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "52717f9a02b6965224f95ca2a81e2e0c5c43baacd28ca057577988930b6c3d5b"
+dependencies = [
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pxfm"
+version = "0.1.27"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7186d3822593aa4393561d186d1393b3923e9d6163d3fbfd6e825e3e6cf3e6a8"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "qoi"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7f6d64c71eb498fe9eae14ce4ec935c555749aef511cca85b5568910d6e48001"
+dependencies = [
+ "bytemuck",
+]
+
+[[package]]
+name = "quick-error"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a993555f31e5a609f617c12db6250dedcac1b0a85076912c436e6fc9b2c8e6a3"
+
+[[package]]
+name = "quick-xml"
+version = "0.36.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f7649a7b4df05aed9ea7ec6f628c67c9953a43869b8bc50929569b2999d443fe"
+dependencies = [
+ "memchr",
+ "serde",
+]
+
+[[package]]
+name = "quick-xml"
+version = "0.37.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "331e97a1af0bf59823e6eadffe373d7b27f485be8748f71471c662c1f269b7fb"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.40"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1885c039570dc00dcb4ff087a89e185fd56bae234ddc7f056a945bf36467248d"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "r-efi"
+version = "5.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "69cdb34c158ceb288df11e18b4bd39de994f6657d83847bdffdbd7f346754b0f"
+
+[[package]]
+name = "rand"
+version = "0.8.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "34af8d1a0e25924bc5b7c43c079c942339d8f0a8b57c39049bef581b46327404"
+dependencies = [
+ "libc",
+ "rand_chacha 0.3.1",
+ "rand_core 0.6.4",
+]
+
+[[package]]
+name = "rand"
+version = "0.9.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6db2770f06117d490610c7488547d543617b21bfa07796d7a12f6f1bd53850d1"
+dependencies = [
+ "rand_chacha 0.9.0",
+ "rand_core 0.9.3",
+]
+
+[[package]]
+name = "rand_chacha"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6c10a63a0fa32252be49d21e7709d4d4baf8d231c2dbce1eaa8141b9b127d88"
+dependencies = [
+ "ppv-lite86",
+ "rand_core 0.6.4",
+]
+
+[[package]]
+name = "rand_chacha"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d3022b5f1df60f26e1ffddd6c66e8aa15de382ae63b3a0c1bfc0e4d3e3f325cb"
+dependencies = [
+ "ppv-lite86",
+ "rand_core 0.9.3",
+]
+
+[[package]]
+name = "rand_core"
+version = "0.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c"
+dependencies = [
+ "getrandom 0.2.16",
+]
+
+[[package]]
+name = "rand_core"
+version = "0.9.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "99d9a13982dcf210057a8a78572b2217b667c3beacbf3a0d8b454f6f82837d38"
+dependencies = [
+ "getrandom 0.3.3",
+]
+
+[[package]]
+name = "range-alloc"
+version = "0.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c3d6831663a5098ea164f89cff59c6284e95f4e3c76ce9848d4529f5ccca9bde"
+
+[[package]]
+name = "rav1e"
+version = "0.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "43b6dd56e85d9483277cde964fd1bdb0428de4fec5ebba7540995639a21cb32b"
+dependencies = [
+ "aligned-vec",
+ "arbitrary",
+ "arg_enum_proc_macro",
+ "arrayvec",
+ "av-scenechange",
+ "av1-grain",
+ "bitstream-io",
+ "built",
+ "cfg-if",
+ "interpolate_name",
+ "itertools",
+ "libc",
+ "libfuzzer-sys",
+ "log",
+ "maybe-rayon",
+ "new_debug_unreachable",
+ "noop_proc_macro",
+ "num-derive",
+ "num-traits",
+ "paste",
+ "profiling",
+ "rand 0.9.2",
+ "rand_chacha 0.9.0",
+ "simd_helpers",
+ "thiserror 2.0.17",
+ "v_frame",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "ravif"
+version = "0.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ef69c1990ceef18a116855938e74793a5f7496ee907562bd0857b6ac734ab285"
+dependencies = [
+ "avif-serialize",
+ "imgref",
+ "loop9",
+ "quick-error",
+ "rav1e",
+ "rayon",
+ "rgb",
+]
+
+[[package]]
+name = "raw-window-handle"
+version = "0.6.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "20675572f6f24e9e76ef639bc5552774ed45f1c30e2951e1e99c59888861c539"
+
+[[package]]
+name = "rayon"
+version = "1.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "368f01d005bf8fd9b1206fb6fa653e6c4a81ceb1466406b81792d87c5677a58f"
+dependencies = [
+ "either",
+ "rayon-core",
+]
+
+[[package]]
+name = "rayon-core"
+version = "1.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "22e18b0f0062d30d4230b2e85ff77fdfe4326feb054b9783a3460d8435c8ab91"
+dependencies = [
+ "crossbeam-deque",
+ "crossbeam-utils",
+]
+
+[[package]]
+name = "redox_syscall"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4722d768eff46b75989dd134e5c353f0d6296e5aaa3132e776cbdb56be7731aa"
+dependencies = [
+ "bitflags 1.3.2",
+]
+
+[[package]]
+name = "redox_syscall"
+version = "0.5.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ed2bf2547551a7053d6fdfafda3f938979645c44812fbfcda098faae3f1a362d"
+dependencies = [
+ "bitflags 2.9.4",
+]
+
+[[package]]
+name = "redox_users"
+version = "0.4.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ba009ff324d1fc1b900bd1fdb31564febe58a8ccc8a6fdbb93b543d33b13ca43"
+dependencies = [
+ "getrandom 0.2.16",
+ "libredox",
+ "thiserror 1.0.69",
+]
+
+[[package]]
+name = "redox_users"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a4e608c6638b9c18977b00b475ac1f28d14e84b27d8d42f70e0bf1e3dec127ac"
+dependencies = [
+ "getrandom 0.2.16",
+ "libredox",
+ "thiserror 2.0.17",
+]
+
+[[package]]
+name = "regex"
+version = "1.11.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8b5288124840bee7b386bc413c487869b360b2b4ec421ea56425128692f2a82c"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-automata"
+version = "0.4.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "833eb9ce86d40ef33cb1306d8accf7bc8ec2bfea4355cbdebb3df68b40925cad"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-syntax"
+version = "0.8.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "caf4aa5b0f434c91fe5c7f1ecb6a5ece2130b02ad2a590589dda5146df959001"
+
+[[package]]
+name = "relative-path"
+version = "1.9.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ba39f3699c378cd8970968dcbff9c43159ea4cfbd88d43c00b22f2ef10a435d2"
+
+[[package]]
+name = "renderdoc-sys"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "19b30a45b0cd0bcca8037f3d0dc3421eaf95327a17cad11964fb8179b4fc4832"
+
+[[package]]
+name = "resvg"
+version = "0.45.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a8928798c0a55e03c9ca6c4c6846f76377427d2c1e1f7e6de3c06ae57942df43"
+dependencies = [
+ "log",
+ "pico-args",
+ "rgb",
+ "svgtypes",
+ "tiny-skia",
+ "usvg",
+]
+
+[[package]]
+name = "rfc6979"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8dd2a808d456c4a54e300a23e9f5a67e122c3024119acbfd73e3bf664491cb2"
+dependencies = [
+ "hmac",
+ "subtle",
+]
+
+[[package]]
+name = "rfd"
+version = "0.16.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a15ad77d9e70a92437d8f74c35d99b4e4691128df018833e99f90bcd36152672"
+dependencies = [
+ "ashpd",
+ "block2 0.6.2",
+ "dispatch2",
+ "js-sys",
+ "log",
+ "objc2 0.6.3",
+ "objc2-app-kit 0.3.2",
+ "objc2-core-foundation",
+ "objc2-foundation 0.3.2",
+ "pollster",
+ "raw-window-handle",
+ "urlencoding",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "web-sys",
+ "windows-sys 0.60.2",
+]
+
+[[package]]
+name = "rgb"
+version = "0.8.52"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c6a884d2998352bb4daf0183589aec883f16a6da1f4dde84d8e2e9a5409a1ce"
+dependencies = [
+ "bytemuck",
+]
+
+[[package]]
+name = "ring"
+version = "0.17.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a4689e6c2294d81e88dc6261c768b63bc4fcdb852be6d1352498b114f61383b7"
+dependencies = [
+ "cc",
+ "cfg-if",
+ "getrandom 0.2.16",
+ "libc",
+ "untrusted",
+ "windows-sys 0.52.0",
+]
+
+[[package]]
+name = "roxmltree"
+version = "0.20.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6c20b6793b5c2fa6553b250154b78d6d0db37e72700ae35fad9387a46f487c97"
+
+[[package]]
+name = "rsa"
+version = "0.9.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78928ac1ed176a5ca1d17e578a1825f3d81ca54cf41053a592584b020cfd691b"
+dependencies = [
+ "const-oid 0.9.6",
+ "digest 0.10.7",
+ "num-bigint-dig",
+ "num-integer",
+ "num-traits",
+ "pkcs1",
+ "pkcs8",
+ "rand_core 0.6.4",
+ "sha2",
+ "signature",
+ "spki",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "rstest"
+version = "0.25.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6fc39292f8613e913f7df8fa892b8944ceb47c247b78e1b1ae2f09e019be789d"
+dependencies = [
+ "futures-timer",
+ "futures-util",
+ "rstest_macros",
+ "rustc_version",
+]
+
+[[package]]
+name = "rstest_macros"
+version = "0.25.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1f168d99749d307be9de54d23fd226628d99768225ef08f6ffb52e0182a27746"
+dependencies = [
+ "cfg-if",
+ "glob",
+ "proc-macro-crate",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "relative-path",
+ "rustc_version",
+ "syn",
+ "unicode-ident",
+]
+
+[[package]]
+name = "russh"
+version = "0.44.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6500eedfaf8cd81597899d896908a4b9cd5cb566db875e843c04ccf92add2c16"
+dependencies = [
+ "aes",
+ "aes-gcm",
+ "async-trait",
+ "bitflags 2.9.4",
+ "byteorder",
+ "cbc",
+ "chacha20",
+ "ctr",
+ "curve25519-dalek",
+ "digest 0.10.7",
+ "elliptic-curve",
+ "flate2",
+ "futures",
+ "generic-array",
+ "hex-literal",
+ "hmac",
+ "log",
+ "num-bigint",
+ "once_cell",
+ "p256",
+ "p384",
+ "p521",
+ "poly1305",
+ "rand 0.8.5",
+ "rand_core 0.6.4",
+ "russh-cryptovec",
+ "russh-keys",
+ "sha1 0.10.6",
+ "sha2",
+ "ssh-encoding",
+ "ssh-key",
+ "subtle",
+ "thiserror 1.0.69",
+ "tokio",
+]
+
+[[package]]
+name = "russh-cryptovec"
+version = "0.7.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fadd2c0ab350e21c66556f94ee06f766d8bdae3213857ba7610bfd8e10e51880"
+dependencies = [
+ "libc",
+ "winapi",
+]
+
+[[package]]
+name = "russh-keys"
+version = "0.44.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fb8c0bfe024d4edd242f65a2ac6c8bf38a892930050b9eb90909d8fc2c413c8d"
+dependencies = [
+ "aes",
+ "async-trait",
+ "bcrypt-pbkdf",
+ "block-padding",
+ "byteorder",
+ "cbc",
+ "ctr",
+ "data-encoding",
+ "der",
+ "digest 0.10.7",
+ "dirs 5.0.1",
+ "ecdsa",
+ "ed25519-dalek",
+ "elliptic-curve",
+ "futures",
+ "hmac",
+ "inout",
+ "log",
+ "md5",
+ "num-integer",
+ "p256",
+ "p384",
+ "p521",
+ "pbkdf2 0.11.0",
+ "pkcs1",
+ "pkcs5",
+ "pkcs8",
+ "rand 0.8.5",
+ "rand_core 0.6.4",
+ "rsa",
+ "russh-cryptovec",
+ "sec1",
+ "serde",
+ "sha1 0.10.6",
+ "sha2",
+ "spki",
+ "ssh-encoding",
+ "ssh-key",
+ "thiserror 1.0.69",
+ "tokio",
+ "tokio-stream",
+ "typenum",
+ "zeroize",
+]
+
+[[package]]
+name = "rustc-demangle"
+version = "0.1.26"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "56f7d92ca342cea22a06f2121d944b4fd82af56988c270852495420f961d4ace"
+
+[[package]]
+name = "rustc-hash"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08d43f7aa6b08d49f382cde6a7982047c3426db949b1424bc4b7ec9ae12c6ce2"
+
+[[package]]
+name = "rustc-hash"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "357703d41365b4b27c590e3ed91eabb1b663f07c4c084095e60cbed4362dff0d"
+
+[[package]]
+name = "rustc_version"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cfcb3a22ef46e85b45de6ee7e79d063319ebb6594faafcf1c225ea92ab6e9b92"
+dependencies = [
+ "semver",
+]
+
+[[package]]
+name = "rustix"
+version = "0.38.44"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fdb5bc1ae2baa591800df16c9ca78619bf65c0488b41b96ccec5d11220d8c154"
+dependencies = [
+ "bitflags 2.9.4",
+ "errno",
+ "libc",
+ "linux-raw-sys 0.4.15",
+ "windows-sys 0.59.0",
+]
+
+[[package]]
+name = "rustix"
+version = "1.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cd15f8a2c5551a84d56efdc1cd049089e409ac19a3072d5037a17fd70719ff3e"
+dependencies = [
+ "bitflags 2.9.4",
+ "errno",
+ "libc",
+ "linux-raw-sys 0.11.0",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "rustls"
+version = "0.23.35"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "533f54bc6a7d4f647e46ad909549eda97bf5afc1585190ef692b4286b198bd8f"
+dependencies = [
+ "log",
+ "once_cell",
+ "ring",
+ "rustls-pki-types",
+ "rustls-webpki",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "rustls-pki-types"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "708c0f9d5f54ba0272468c1d306a52c495b31fa155e91bc25371e6df7996908c"
+dependencies = [
+ "zeroize",
+]
+
+[[package]]
+name = "rustls-webpki"
+version = "0.103.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2ffdfa2f5286e2247234e03f680868ac2815974dc39e00ea15adc445d0aafe52"
+dependencies = [
+ "ring",
+ "rustls-pki-types",
+ "untrusted",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
+
+[[package]]
+name = "ryu"
+version = "1.0.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "28d3b2b1366ec20994f1fd18c3c594f05c5dd4bc44d8bb0c1c632c8d6829481f"
+
+[[package]]
+name = "salsa20"
+version = "0.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "97a22f5af31f73a954c10289c93e8a50cc23d971e80ee446f1f6f7137a088213"
+dependencies = [
+ "cipher",
+]
+
+[[package]]
+name = "same-file"
+version = "1.0.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93fc1dc3aaa9bfed95e02e6eadabb4baf7e3078b0bd1b4d7b6b0b68378900502"
+dependencies = [
+ "winapi-util",
+]
+
+[[package]]
+name = "scoped-tls"
+version = "1.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e1cf6437eb19a8f4a6cc0f7dca544973b0b78843adbfeb3683d1a94a0024a294"
+
+[[package]]
+name = "scopeguard"
+version = "1.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
+
+[[package]]
+name = "scrypt"
+version = "0.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0516a385866c09368f0b5bcd1caff3366aace790fcd46e2bb032697bb172fd1f"
+dependencies = [
+ "pbkdf2 0.12.2",
+ "salsa20",
+ "sha2",
+]
+
+[[package]]
+name = "sctk-adwaita"
+version = "0.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6277f0217056f77f1d8f49f2950ac6c278c0d607c45f5ee99328d792ede24ec"
+dependencies = [
+ "ab_glyph",
+ "log",
+ "memmap2",
+ "smithay-client-toolkit 0.19.2",
+ "tiny-skia",
+]
+
+[[package]]
+name = "sec1"
+version = "0.7.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d3e97a565f76233a6003f9f5c54be1d9c5bdfa3eccfb189469f11ec4901c47dc"
+dependencies = [
+ "base16ct",
+ "der",
+ "generic-array",
+ "pkcs8",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "semver"
+version = "1.0.27"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d767eb0aabc880b29956c35734170f26ed551a859dbd361d140cdbeca61ab1e2"
+
+[[package]]
+name = "sequential_gen"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3d630b1418311e028ceb45e1e567845501a9d9c770a258b80d2edc025ffad17c"
+dependencies = [
+ "lazy_static",
+ "uuid",
+]
+
+[[package]]
+name = "serde"
+version = "1.0.225"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fd6c24dee235d0da097043389623fb913daddf92c76e9f5a1db88607a0bcbd1d"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.225"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "659356f9a0cb1e529b24c01e43ad2bdf520ec4ceaf83047b83ddcc2251f96383"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.225"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ea936adf78b1f766949a4977b91d2f5595825bd6ec079aa9543ad2685fc4516"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.145"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "402a6f66d8c709116cf22f558eab210f5a50187f702eb4d7e5ef38d9a7f1c79c"
+dependencies = [
+ "itoa",
+ "memchr",
+ "ryu",
+ "serde",
+ "serde_core",
+]
+
+[[package]]
+name = "serde_plain"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ce1fc6db65a611022b23a0dec6975d63fb80a302cb3388835ff02c097258d50"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "serde_repr"
+version = "0.1.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "175ee3e80ae9982737ca543e96133087cbd9a485eecc3bc4de9c1a37b47ea59c"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_spanned"
+version = "1.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2789234a13a53fc4be1b51ea1bab45a3c338bdb884862a257d10e5a74ae009e6"
+dependencies = [
+ "serde_core",
+]
+
+[[package]]
+name = "server"
+version = "0.1.0"
+dependencies = [
+ "anyhow",
+ "async-trait",
+ "cryptovec",
+ "engine",
+ "flexi_logger",
+ "log",
+ "mockall",
+ "pretty_assertions",
+ "rstest",
+ "russh",
+ "russh-keys",
+ "serde",
+ "serde_plain",
+ "thiserror 2.0.17",
+ "tokio",
+ "toml",
+]
+
+[[package]]
+name = "sha1"
+version = "0.10.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e3bf829a2d51ab4a5ddf1352d8470c140cadc8301b2ae1789db023f01cedd6ba"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "digest 0.10.7",
+]
+
+[[package]]
+name = "sha1"
+version = "0.11.0-rc.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c5e046edf639aa2e7afb285589e5405de2ef7e61d4b0ac1e30256e3eab911af9"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "digest 0.11.0-rc.2",
+]
+
+[[package]]
+name = "sha2"
+version = "0.10.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a7507d819769d01a365ab707794a4084392c824f54a7a6a7862f8c3d0892b283"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "digest 0.10.7",
+]
+
+[[package]]
+name = "shared"
+version = "0.1.0"
+dependencies = [
+ "editor-command",
+ "mockall",
+ "owo-colors",
+ "path-absolutize",
+ "pretty_assertions",
+ "rstest",
+ "tempfile",
+ "up_finder",
+]
+
+[[package]]
+name = "shell-words"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "24188a676b6ae68c3b2cb3a01be17fbf7240ce009799bb56d5b1409051e78fde"
+
+[[package]]
+name = "shlex"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
+
+[[package]]
+name = "signal-hook-registry"
+version = "1.4.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b2a4719bff48cee6b39d12c020eeb490953ad2443b7055bd0b21fca26bd8c28b"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "signature"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "77549399552de45a898a580c1b41d445bf730df867cc44e6c0233bbc4b8329de"
+dependencies = [
+ "digest 0.10.7",
+ "rand_core 0.6.4",
+]
+
+[[package]]
+name = "simd-adler32"
+version = "0.3.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e320a6c5ad31d271ad523dcf3ad13e2767ad8b1cb8f047f75a8aeaf8da139da2"
+
+[[package]]
+name = "simd_helpers"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "95890f873bec569a0362c235787f3aca6e1e887302ba4840839bcc6459c42da6"
+dependencies = [
+ "quote",
+]
+
+[[package]]
+name = "similar"
+version = "2.7.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bbbb5d9659141646ae647b42fe094daf6c6192d1620870b449d9557f748b2daa"
+
+[[package]]
+name = "simplecss"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7a9c6883ca9c3c7c90e888de77b7a5c849c779d25d74a1269b0218b14e8b136c"
+dependencies = [
+ "log",
+]
+
+[[package]]
+name = "siphasher"
+version = "1.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "56199f7ddabf13fe5074ce809e7d3f42b42ae711800501b5b16ea82ad029c39d"
+
+[[package]]
+name = "slab"
+version = "0.4.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7a2ae44ef20feb57a68b23d846850f861394c2e02dc425a50098ae8c90267589"
+
+[[package]]
+name = "slotmap"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bdd58c3c93c3d278ca835519292445cb4b0d4dc59ccfdf7ceadaab3f8aeb4038"
+dependencies = [
+ "version_check",
+]
+
+[[package]]
+name = "smallvec"
+version = "1.15.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "67b1b7a3b5fe4f1376887184045fcf45c69e92af734b7aaddc05fb777b6fbd03"
+
+[[package]]
+name = "smithay-client-toolkit"
+version = "0.19.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3457dea1f0eb631b4034d61d4d8c32074caa6cd1ab2d59f2327bd8461e2c0016"
+dependencies = [
+ "bitflags 2.9.4",
+ "calloop 0.13.0",
+ "calloop-wayland-source 0.3.0",
+ "cursor-icon",
+ "libc",
+ "log",
+ "memmap2",
+ "rustix 0.38.44",
+ "thiserror 1.0.69",
+ "wayland-backend",
+ "wayland-client",
+ "wayland-csd-frame",
+ "wayland-cursor",
+ "wayland-protocols",
+ "wayland-protocols-wlr",
+ "wayland-scanner",
+ "xkeysym",
+]
+
+[[package]]
+name = "smithay-client-toolkit"
+version = "0.20.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0512da38f5e2b31201a93524adb8d3136276fa4fe4aafab4e1f727a82b534cc0"
+dependencies = [
+ "bitflags 2.9.4",
+ "calloop 0.14.3",
+ "calloop-wayland-source 0.4.1",
+ "cursor-icon",
+ "libc",
+ "log",
+ "memmap2",
+ "rustix 1.1.2",
+ "thiserror 2.0.17",
+ "wayland-backend",
+ "wayland-client",
+ "wayland-csd-frame",
+ "wayland-cursor",
+ "wayland-protocols",
+ "wayland-protocols-experimental",
+ "wayland-protocols-misc",
+ "wayland-protocols-wlr",
+ "wayland-scanner",
+ "xkeysym",
+]
+
+[[package]]
+name = "smithay-clipboard"
+version = "0.7.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "71704c03f739f7745053bde45fa203a46c58d25bc5c4efba1d9a60e9dba81226"
+dependencies = [
+ "libc",
+ "smithay-client-toolkit 0.20.0",
+ "wayland-backend",
+]
+
+[[package]]
+name = "smol_str"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dd538fb6910ac1099850255cf94a94df6551fbdd602454387d0adb2d1ca6dead"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "socket2"
+version = "0.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "17129e116933cf371d018bb80ae557e889637989d8638274fb25622827b03881"
+dependencies = [
+ "libc",
+ "windows-sys 0.60.2",
+]
+
+[[package]]
+name = "spin"
+version = "0.9.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6980e8d7511241f8acf4aebddbb1ff938df5eebe98691418c4468d0b72a96a67"
+
+[[package]]
+name = "spin"
+version = "0.10.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d5fe4ccb98d9c292d56fec89a5e07da7fc4cf0dc11e156b41793132775d3e591"
+dependencies = [
+ "lock_api",
+]
+
+[[package]]
+name = "spirv"
+version = "0.3.0+sdk-1.3.268.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "eda41003dc44290527a59b13432d4a0379379fa074b70174882adfbdfd917844"
+dependencies = [
+ "bitflags 2.9.4",
+]
+
+[[package]]
+name = "spki"
+version = "0.7.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d91ed6c858b01f942cd56b37a94b3e0a1798290327d1236e4d9cf4eaca44d29d"
+dependencies = [
+ "base64ct",
+ "der",
+]
+
+[[package]]
+name = "ssh-cipher"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "caac132742f0d33c3af65bfcde7f6aa8f62f0e991d80db99149eb9d44708784f"
+dependencies = [
+ "aes",
+ "aes-gcm",
+ "cbc",
+ "chacha20",
+ "cipher",
+ "ctr",
+ "poly1305",
+ "ssh-encoding",
+ "subtle",
+]
+
+[[package]]
+name = "ssh-encoding"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "eb9242b9ef4108a78e8cd1a2c98e193ef372437f8c22be363075233321dd4a15"
+dependencies = [
+ "base64ct",
+ "pem-rfc7468",
+ "sha2",
+]
+
+[[package]]
+name = "ssh-key"
+version = "0.6.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3b86f5297f0f04d08cabaa0f6bff7cb6aec4d9c3b49d87990d63da9d9156a8c3"
+dependencies = [
+ "bcrypt-pbkdf",
+ "ed25519-dalek",
+ "num-bigint-dig",
+ "p256",
+ "p384",
+ "p521",
+ "rand_core 0.6.4",
+ "rsa",
+ "sec1",
+ "sha2",
+ "signature",
+ "ssh-cipher",
+ "ssh-encoding",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "stable_deref_trait"
+version = "1.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596"
+
+[[package]]
+name = "static_assertions"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a2eb9349b6444b326872e140eb1cf5e7c522154d69e7a0ffb0fb81c06b37543f"
+
+[[package]]
+name = "strict-num"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6637bab7722d379c8b41ba849228d680cc12d0a45ba1fa2b48f2a30577a06731"
+dependencies = [
+ "float-cmp",
+]
+
+[[package]]
+name = "strsim"
+version = "0.11.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7da8b5736845d9f2fcb837ea5d9e2628564b3b043a70948a3f0b778838c5fb4f"
+
+[[package]]
+name = "strum"
+version = "0.27.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "af23d6f6c1a224baef9d3f61e287d2761385a5b88fdab4eb4c6f11aeb54c4bcf"
+
+[[package]]
+name = "strum_macros"
+version = "0.27.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7695ce3845ea4b33927c055a39dc438a45b059f7c1b3d91d38d10355fb8cbca7"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "subtle"
+version = "2.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292"
+
+[[package]]
+name = "supports-color"
+version = "3.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c64fc7232dd8d2e4ac5ce4ef302b1d81e0b80d055b9d77c7c4f51f6aa4c867d6"
+dependencies = [
+ "is_ci",
+]
+
+[[package]]
+name = "supports-hyperlinks"
+version = "3.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "804f44ed3c63152de6a9f90acbea1a110441de43006ea51bcce8f436196a288b"
+
+[[package]]
+name = "supports-unicode"
+version = "3.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b7401a30af6cb5818bb64852270bb722533397edcfc7344954a38f420819ece2"
+
+[[package]]
+name = "svgtypes"
+version = "0.15.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68c7541fff44b35860c1a7a47a7cadf3e4a304c457b58f9870d9706ece028afc"
+dependencies = [
+ "kurbo",
+ "siphasher",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ede7c438028d4436d71104916910f5bb611972c5cfd7f89b8300a8186e6fada6"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "synstructure"
+version = "0.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "728a70f3dbaf5bab7f0c4b1ac8d7ae5ea60a4b5549c8a5914361c99147a709d2"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "tempfile"
+version = "3.23.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2d31c77bdf42a745371d260a26ca7163f1e0924b64afa0b688e61b5a9fa02f16"
+dependencies = [
+ "fastrand",
+ "getrandom 0.3.3",
+ "once_cell",
+ "rustix 1.1.2",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "termcolor"
+version = "1.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "06794f8f6c5c898b3275aebefa6b8a1cb24cd2c6c79397ab15774837a0bc5755"
+dependencies = [
+ "winapi-util",
+]
+
+[[package]]
+name = "terminal_size"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "60b8cb979cb11c32ce1603f8137b22262a9d131aaa5c37b5678025f22b8becd0"
+dependencies = [
+ "rustix 1.1.2",
+ "windows-sys 0.60.2",
+]
+
+[[package]]
+name = "termtree"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f50febec83f5ee1df3015341d8bd429f2d1cc62bcba7ea2076759d315084683"
+
+[[package]]
+name = "textwrap"
+version = "0.16.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c13547615a44dc9c452a8a534638acdf07120d4b6847c8178705da06306a3057"
+dependencies = [
+ "unicode-linebreak",
+ "unicode-width 0.2.1",
+]
+
+[[package]]
+name = "thiserror"
+version = "1.0.69"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6aaf5339b578ea85b50e080feb250a3e8ae8cfcdff9a461c9ec2904bc923f52"
+dependencies = [
+ "thiserror-impl 1.0.69",
+]
+
+[[package]]
+name = "thiserror"
+version = "2.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f63587ca0f12b72a0600bcba1d40081f830876000bb46dd2337a3051618f4fc8"
+dependencies = [
+ "thiserror-impl 2.0.17",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "1.0.69"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4fee6c4efc90059e10f81e6d42c60a18f76588c3d74cb83a0b242a2b6c7504c1"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "2.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ff15c8ecd7de3849db632e14d18d2571fa09dfc5ed93479bc4485c7a517c913"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "tiff"
+version = "0.10.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "af9605de7fee8d9551863fd692cce7637f548dbd9db9180fcc07ccc6d26c336f"
+dependencies = [
+ "fax",
+ "flate2",
+ "half",
+ "quick-error",
+ "weezl",
+ "zune-jpeg 0.4.21",
+]
+
+[[package]]
+name = "tiny-skia"
+version = "0.11.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "83d13394d44dae3207b52a326c0c85a8bf87f1541f23b0d143811088497b09ab"
+dependencies = [
+ "arrayref",
+ "arrayvec",
+ "bytemuck",
+ "cfg-if",
+ "log",
+ "png 0.17.16",
+ "tiny-skia-path",
+]
+
+[[package]]
+name = "tiny-skia-path"
+version = "0.11.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9c9e7fc0c2e86a30b117d0462aa261b72b7a99b7ebd7deb3a14ceda95c5bdc93"
+dependencies = [
+ "arrayref",
+ "bytemuck",
+ "strict-num",
+]
+
+[[package]]
+name = "tinystr"
+version = "0.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "42d3e9c45c09de15d06dd8acf5f4e0e399e85927b7f00711024eb7ae10fa4869"
+dependencies = [
+ "displaydoc",
+ "zerovec",
+]
+
+[[package]]
+name = "tokio"
+version = "1.48.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ff360e02eab121e0bc37a2d3b4d4dc622e6eda3a8e5253d5435ecf5bd4c68408"
+dependencies = [
+ "bytes",
+ "libc",
+ "mio",
+ "parking_lot",
+ "pin-project-lite",
+ "signal-hook-registry",
+ "socket2",
+ "tokio-macros",
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "tokio-macros"
+version = "2.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "af407857209536a95c8e56f8231ef2c2e2aff839b22e07a1ffcbc617e9db9fa5"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "tokio-stream"
+version = "0.1.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "eca58d7bba4a75707817a2c44174253f9236b2d5fbd055602e9d5c07c139a047"
+dependencies = [
+ "futures-core",
+ "pin-project-lite",
+ "tokio",
+]
+
+[[package]]
+name = "toml"
+version = "0.9.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae2a4cf385da23d1d53bc15cdfa5c2109e93d8d362393c801e87da2f72f0e201"
+dependencies = [
+ "indexmap",
+ "serde_core",
+ "serde_spanned",
+ "toml_datetime",
+ "toml_parser",
+ "toml_writer",
+ "winnow",
+]
+
+[[package]]
+name = "toml_datetime"
+version = "0.7.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a197c0ec7d131bfc6f7e82c8442ba1595aeab35da7adbf05b6b73cd06a16b6be"
+dependencies = [
+ "serde_core",
+]
+
+[[package]]
+name = "toml_edit"
+version = "0.23.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c2ad0b7ae9cfeef5605163839cb9221f453399f15cfb5c10be9885fcf56611f9"
+dependencies = [
+ "indexmap",
+ "toml_datetime",
+ "toml_parser",
+ "toml_writer",
+ "winnow",
+]
+
+[[package]]
+name = "toml_parser"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b551886f449aa90d4fe2bdaa9f4a2577ad2dde302c61ecf262d80b116db95c10"
+dependencies = [
+ "winnow",
+]
+
+[[package]]
+name = "toml_writer"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fcc842091f2def52017664b53082ecbbeb5c7731092bad69d2c63050401dfd64"
+
+[[package]]
+name = "tracing"
+version = "0.1.43"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2d15d90a0b5c19378952d479dc858407149d7bb45a14de0142f6c534b16fc647"
+dependencies = [
+ "log",
+ "pin-project-lite",
+ "tracing-attributes",
+ "tracing-core",
+]
+
+[[package]]
+name = "tracing-attributes"
+version = "0.1.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7490cfa5ec963746568740651ac6781f701c9c5ea257c58e057f3ba8cf69e8da"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "tracing-core"
+version = "0.1.35"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7a04e24fab5c89c6a36eb8558c9656f30d81de51dfa4d3b45f26b21d61fa0a6c"
+dependencies = [
+ "once_cell",
+]
+
+[[package]]
+name = "tree-ds"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "710c388a2bb52d1a7186ae4aa2e92c6fae0606426bf4bdfb4106fa1e8e5c602e"
+dependencies = [
+ "lazy_static",
+ "sequential_gen",
+ "serde",
+ "spin 0.10.0",
+ "thiserror 2.0.17",
+]
+
+[[package]]
+name = "ttf-parser"
+version = "0.25.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d2df906b07856748fa3f6e0ad0cbaa047052d4a7dd609e231c4f72cee8c36f31"
+
+[[package]]
+name = "type-map"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb30dbbd9036155e74adad6812e9898d03ec374946234fbcebd5dfc7b9187b90"
+dependencies = [
+ "rustc-hash 2.1.1",
+]
+
+[[package]]
+name = "typed-builder"
+version = "0.21.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fef81aec2ca29576f9f6ae8755108640d0a86dd3161b2e8bca6cfa554e98f77d"
+dependencies = [
+ "typed-builder-macro",
+]
+
+[[package]]
+name = "typed-builder-macro"
+version = "0.21.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1ecb9ecf7799210407c14a8cfdfe0173365780968dc57973ed082211958e0b18"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "typenum"
+version = "1.18.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1dccffe3ce07af9386bfd29e80c0ab1a8205a2fc34e4bcd40364df902cfa8f3f"
+
+[[package]]
+name = "uds_windows"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "89daebc3e6fd160ac4aa9fc8b3bf71e1f74fbf92367ae71fb83a037e8bf164b9"
+dependencies = [
+ "memoffset",
+ "tempfile",
+ "winapi",
+]
+
+[[package]]
+name = "unicase"
+version = "2.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "75b844d17643ee918803943289730bec8aac480150456169e647ed0b576ba539"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f63a545481291138910575129486daeaf8ac54aee4387fe7906919f7830c7d9d"
+
+[[package]]
+name = "unicode-linebreak"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3b09c83c3c29d37506a3e260c08c03743a6bb66a9cd432c6934ab501a190571f"
+
+[[package]]
+name = "unicode-segmentation"
+version = "1.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f6ccf251212114b54433ec949fd6a7841275f9ada20dddd2f29e9ceea4501493"
+
+[[package]]
+name = "unicode-width"
+version = "0.1.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7dd6e30e90baa6f72411720665d41d89b9a3d039dc45b8faea1ddd07f617f6af"
+
+[[package]]
+name = "unicode-width"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4a1a07cc7db3810833284e8d372ccdc6da29741639ecc70c9ec107df0fa6154c"
+
+[[package]]
+name = "universal-hash"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc1de2c688dc15305988b563c3854064043356019f97a4b46276fe734c4f07ea"
+dependencies = [
+ "crypto-common 0.1.6",
+ "subtle",
+]
+
+[[package]]
+name = "untrusted"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ecb6da28b8a351d773b68d5825ac39017e680750f980f3a1a85cd8dd28a47c1"
+
+[[package]]
+name = "unty"
+version = "0.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6d49784317cd0d1ee7ec5c716dd598ec5b4483ea832a2dced265471cc0f690ae"
+
+[[package]]
+name = "up_finder"
+version = "0.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "be33efd9986755f20533a6d724f20c4f62f680de544999f47ae04cffc1d996ae"
+dependencies = [
+ "rustc-hash 2.1.1",
+ "typed-builder",
+]
+
+[[package]]
+name = "ureq"
+version = "2.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "02d1a66277ed75f640d608235660df48c8e3c19f3b4edb6a263315626cc3c01d"
+dependencies = [
+ "base64",
+ "flate2",
+ "log",
+ "once_cell",
+ "rustls",
+ "rustls-pki-types",
+ "url",
+ "webpki-roots 0.26.11",
+]
+
+[[package]]
+name = "url"
+version = "2.5.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08bc136a29a3d1758e07a9cca267be308aeebf5cfd5a10f3f67ab2097683ef5b"
+dependencies = [
+ "form_urlencoded",
+ "idna",
+ "percent-encoding",
+ "serde",
+]
+
+[[package]]
+name = "urlencoding"
+version = "2.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "daf8dba3b7eb870caf1ddeed7bc9d2a049f3cfdfae7cb521b087cc33ae4c49da"
+
+[[package]]
+name = "usvg"
+version = "0.45.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "80be9b06fbae3b8b303400ab20778c80bbaf338f563afe567cf3c9eea17b47ef"
+dependencies = [
+ "base64",
+ "data-url",
+ "flate2",
+ "imagesize",
+ "kurbo",
+ "log",
+ "pico-args",
+ "roxmltree",
+ "simplecss",
+ "siphasher",
+ "strict-num",
+ "svgtypes",
+ "tiny-skia-path",
+ "xmlwriter",
+]
+
+[[package]]
+name = "utf8_iter"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6c140620e7ffbb22c2dee59cafe6084a59b5ffc27a8859a5f0d494b5d52b6be"
+
+[[package]]
+name = "utf8parse"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821"
+
+[[package]]
+name = "uuid"
+version = "1.18.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2f87b8aa10b915a06587d0dec516c282ff295b475d94abf425d62b57710070a2"
+dependencies = [
+ "getrandom 0.3.3",
+ "js-sys",
+ "serde",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "v_frame"
+version = "0.3.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "666b7727c8875d6ab5db9533418d7c764233ac9c0cff1d469aec8fa127597be2"
+dependencies = [
+ "aligned-vec",
+ "num-traits",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "version_check"
+version = "0.9.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"
+
+[[package]]
+name = "virtue"
+version = "0.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "051eb1abcf10076295e815102942cc58f9d5e3b4560e46e53c21e8ff6f3af7b1"
+
+[[package]]
+name = "wait-timeout"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b9f3bf741a801531993db6478b95682117471f76916f5e690dd8d45395b09349"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "walkdir"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29790946404f91d9c5d06f9874efddea1dc06c5efe94541a7d6863108e3a5e4b"
+dependencies = [
+ "same-file",
+ "winapi-util",
+]
+
+[[package]]
+name = "wasi"
+version = "0.11.1+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
+
+[[package]]
+name = "wasi"
+version = "0.14.7+wasi-0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "883478de20367e224c0090af9cf5f9fa85bed63a95c1abf3afc5c083ebc06e8c"
+dependencies = [
+ "wasip2",
+]
+
+[[package]]
+name = "wasip2"
+version = "1.0.1+wasi-0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0562428422c63773dad2c345a1882263bbf4d65cf3f42e90921f787ef5ad58e7"
+dependencies = [
+ "wit-bindgen",
+]
+
+[[package]]
+name = "wasm-bindgen"
+version = "0.2.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ab10a69fbd0a177f5f649ad4d8d3305499c42bab9aef2f7ff592d0ec8f833819"
+dependencies = [
+ "cfg-if",
+ "once_cell",
+ "rustversion",
+ "wasm-bindgen-macro",
+ "wasm-bindgen-shared",
+]
+
+[[package]]
+name = "wasm-bindgen-backend"
+version = "0.2.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0bb702423545a6007bbc368fde243ba47ca275e549c8a28617f56f6ba53b1d1c"
+dependencies = [
+ "bumpalo",
+ "log",
+ "proc-macro2",
+ "quote",
+ "syn",
+ "wasm-bindgen-shared",
+]
+
+[[package]]
+name = "wasm-bindgen-futures"
+version = "0.4.53"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a0b221ff421256839509adbb55998214a70d829d3a28c69b4a6672e9d2a42f67"
+dependencies = [
+ "cfg-if",
+ "js-sys",
+ "once_cell",
+ "wasm-bindgen",
+ "web-sys",
+]
+
+[[package]]
+name = "wasm-bindgen-macro"
+version = "0.2.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc65f4f411d91494355917b605e1480033152658d71f722a90647f56a70c88a0"
+dependencies = [
+ "quote",
+ "wasm-bindgen-macro-support",
+]
+
+[[package]]
+name = "wasm-bindgen-macro-support"
+version = "0.2.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ffc003a991398a8ee604a401e194b6b3a39677b3173d6e74495eb51b82e99a32"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+ "wasm-bindgen-backend",
+ "wasm-bindgen-shared",
+]
+
+[[package]]
+name = "wasm-bindgen-shared"
+version = "0.2.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "293c37f4efa430ca14db3721dfbe48d8c33308096bd44d80ebaa775ab71ba1cf"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "wayland-backend"
+version = "0.3.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "673a33c33048a5ade91a6b139580fa174e19fb0d23f396dca9fa15f2e1e49b35"
+dependencies = [
+ "cc",
+ "downcast-rs",
+ "rustix 1.1.2",
+ "scoped-tls",
+ "smallvec",
+ "wayland-sys",
+]
+
+[[package]]
+name = "wayland-client"
+version = "0.31.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c66a47e840dc20793f2264eb4b3e4ecb4b75d91c0dd4af04b456128e0bdd449d"
+dependencies = [
+ "bitflags 2.9.4",
+ "rustix 1.1.2",
+ "wayland-backend",
+ "wayland-scanner",
+]
+
+[[package]]
+name = "wayland-csd-frame"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "625c5029dbd43d25e6aa9615e88b829a5cad13b2819c4ae129fdbb7c31ab4c7e"
+dependencies = [
+ "bitflags 2.9.4",
+ "cursor-icon",
+ "wayland-backend",
+]
+
+[[package]]
+name = "wayland-cursor"
+version = "0.31.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "447ccc440a881271b19e9989f75726d60faa09b95b0200a9b7eb5cc47c3eeb29"
+dependencies = [
+ "rustix 1.1.2",
+ "wayland-client",
+ "xcursor",
+]
+
+[[package]]
+name = "wayland-protocols"
+version = "0.32.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "efa790ed75fbfd71283bd2521a1cfdc022aabcc28bdcff00851f9e4ae88d9901"
+dependencies = [
+ "bitflags 2.9.4",
+ "wayland-backend",
+ "wayland-client",
+ "wayland-scanner",
+]
+
+[[package]]
+name = "wayland-protocols-experimental"
+version = "20250721.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "40a1f863128dcaaec790d7b4b396cc9b9a7a079e878e18c47e6c2d2c5a8dcbb1"
+dependencies = [
+ "bitflags 2.9.4",
+ "wayland-backend",
+ "wayland-client",
+ "wayland-protocols",
+ "wayland-scanner",
+]
+
+[[package]]
+name = "wayland-protocols-misc"
+version = "0.3.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2dfe33d551eb8bffd03ff067a8b44bb963919157841a99957151299a6307d19c"
+dependencies = [
+ "bitflags 2.9.4",
+ "wayland-backend",
+ "wayland-client",
+ "wayland-protocols",
+ "wayland-scanner",
+]
+
+[[package]]
+name = "wayland-protocols-plasma"
+version = "0.3.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a07a14257c077ab3279987c4f8bb987851bf57081b93710381daea94f2c2c032"
+dependencies = [
+ "bitflags 2.9.4",
+ "wayland-backend",
+ "wayland-client",
+ "wayland-protocols",
+ "wayland-scanner",
+]
+
+[[package]]
+name = "wayland-protocols-wlr"
+version = "0.3.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "efd94963ed43cf9938a090ca4f7da58eb55325ec8200c3848963e98dc25b78ec"
+dependencies = [
+ "bitflags 2.9.4",
+ "wayland-backend",
+ "wayland-client",
+ "wayland-protocols",
+ "wayland-scanner",
+]
+
+[[package]]
+name = "wayland-scanner"
+version = "0.31.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "54cb1e9dc49da91950bdfd8b848c49330536d9d1fb03d4bfec8cae50caa50ae3"
+dependencies = [
+ "proc-macro2",
+ "quick-xml 0.37.5",
+ "quote",
+]
+
+[[package]]
+name = "wayland-sys"
+version = "0.31.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "34949b42822155826b41db8e5d0c1be3a2bd296c747577a43a3e6daefc296142"
+dependencies = [
+ "dlib",
+ "log",
+ "once_cell",
+ "pkg-config",
+]
+
+[[package]]
+name = "web-sys"
+version = "0.3.80"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fbe734895e869dc429d78c4b433f8d17d95f8d05317440b4fad5ab2d33e596dc"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "web-time"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5a6580f308b1fad9207618087a65c04e7a10bc77e02c8e84e9b00dd4b12fa0bb"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+
+[[package]]
+name = "webbrowser"
+version = "1.0.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "00f1243ef785213e3a32fa0396093424a3a6ea566f9948497e5a2309261a4c97"
+dependencies = [
+ "core-foundation 0.10.1",
+ "jni",
+ "log",
+ "ndk-context",
+ "objc2 0.6.3",
+ "objc2-foundation 0.3.2",
+ "url",
+ "web-sys",
+]
+
+[[package]]
+name = "webpki-roots"
+version = "0.26.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "521bc38abb08001b01866da9f51eb7c5d647a19260e00054a8c7fd5f9e57f7a9"
+dependencies = [
+ "webpki-roots 1.0.4",
+]
+
+[[package]]
+name = "webpki-roots"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b2878ef029c47c6e8cf779119f20fcf52bde7ad42a731b2a304bc221df17571e"
+dependencies = [
+ "rustls-pki-types",
+]
+
+[[package]]
+name = "weezl"
+version = "0.1.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a28ac98ddc8b9274cb41bb4d9d4d5c425b6020c50c46f25559911905610b4a88"
+
+[[package]]
+name = "wgpu"
+version = "27.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bfe68bac7cde125de7a731c3400723cadaaf1703795ad3f4805f187459cd7a77"
+dependencies = [
+ "arrayvec",
+ "bitflags 2.9.4",
+ "cfg-if",
+ "cfg_aliases",
+ "document-features",
+ "hashbrown 0.16.1",
+ "js-sys",
+ "log",
+ "naga",
+ "parking_lot",
+ "portable-atomic",
+ "profiling",
+ "raw-window-handle",
+ "smallvec",
+ "static_assertions",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "web-sys",
+ "wgpu-core",
+ "wgpu-hal",
+ "wgpu-types",
+]
+
+[[package]]
+name = "wgpu-core"
+version = "27.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "27a75de515543b1897b26119f93731b385a19aea165a1ec5f0e3acecc229cae7"
+dependencies = [
+ "arrayvec",
+ "bit-set",
+ "bit-vec",
+ "bitflags 2.9.4",
+ "bytemuck",
+ "cfg_aliases",
+ "document-features",
+ "hashbrown 0.16.1",
+ "indexmap",
+ "log",
+ "naga",
+ "once_cell",
+ "parking_lot",
+ "portable-atomic",
+ "profiling",
+ "raw-window-handle",
+ "rustc-hash 1.1.0",
+ "smallvec",
+ "thiserror 2.0.17",
+ "wgpu-core-deps-apple",
+ "wgpu-core-deps-emscripten",
+ "wgpu-core-deps-windows-linux-android",
+ "wgpu-hal",
+ "wgpu-types",
+]
+
+[[package]]
+name = "wgpu-core-deps-apple"
+version = "27.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0772ae958e9be0c729561d5e3fd9a19679bcdfb945b8b1a1969d9bfe8056d233"
+dependencies = [
+ "wgpu-hal",
+]
+
+[[package]]
+name = "wgpu-core-deps-emscripten"
+version = "27.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b06ac3444a95b0813ecfd81ddb2774b66220b264b3e2031152a4a29fda4da6b5"
+dependencies = [
+ "wgpu-hal",
+]
+
+[[package]]
+name = "wgpu-core-deps-windows-linux-android"
+version = "27.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "71197027d61a71748e4120f05a9242b2ad142e3c01f8c1b47707945a879a03c3"
+dependencies = [
+ "wgpu-hal",
+]
+
+[[package]]
+name = "wgpu-hal"
+version = "27.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5b21cb61c57ee198bc4aff71aeadff4cbb80b927beb912506af9c780d64313ce"
+dependencies = [
+ "android_system_properties",
+ "arrayvec",
+ "ash",
+ "bit-set",
+ "bitflags 2.9.4",
+ "block",
+ "bytemuck",
+ "cfg-if",
+ "cfg_aliases",
+ "core-graphics-types 0.2.0",
+ "glow",
+ "glutin_wgl_sys",
+ "gpu-alloc",
+ "gpu-allocator",
+ "gpu-descriptor",
+ "hashbrown 0.16.1",
+ "js-sys",
+ "khronos-egl",
+ "libc",
+ "libloading",
+ "log",
+ "metal",
+ "naga",
+ "ndk-sys",
+ "objc",
+ "once_cell",
+ "ordered-float",
+ "parking_lot",
+ "portable-atomic",
+ "portable-atomic-util",
+ "profiling",
+ "range-alloc",
+ "raw-window-handle",
+ "renderdoc-sys",
+ "smallvec",
+ "thiserror 2.0.17",
+ "wasm-bindgen",
+ "web-sys",
+ "wgpu-types",
+ "windows 0.58.0",
+ "windows-core 0.58.0",
+]
+
+[[package]]
+name = "wgpu-types"
+version = "27.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "afdcf84c395990db737f2dd91628706cb31e86d72e53482320d368e52b5da5eb"
+dependencies = [
+ "bitflags 2.9.4",
+ "bytemuck",
+ "js-sys",
+ "log",
+ "thiserror 2.0.17",
+ "web-sys",
+]
+
+[[package]]
+name = "winapi"
+version = "0.3.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419"
+dependencies = [
+ "winapi-i686-pc-windows-gnu",
+ "winapi-x86_64-pc-windows-gnu",
+]
+
+[[package]]
+name = "winapi-i686-pc-windows-gnu"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
+
+[[package]]
+name = "winapi-util"
+version = "0.1.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22"
+dependencies = [
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "winapi-x86_64-pc-windows-gnu"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
+
+[[package]]
+name = "windows"
+version = "0.58.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dd04d41d93c4992d421894c18c8b43496aa748dd4c081bac0dc93eb0489272b6"
+dependencies = [
+ "windows-core 0.58.0",
+ "windows-targets 0.52.6",
+]
+
+[[package]]
+name = "windows"
+version = "0.61.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9babd3a767a4c1aef6900409f85f5d53ce2544ccdfaa86dad48c91782c6d6893"
+dependencies = [
+ "windows-collections",
+ "windows-core 0.61.2",
+ "windows-future",
+ "windows-link 0.1.3",
+ "windows-numerics",
+]
+
+[[package]]
+name = "windows-collections"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3beeceb5e5cfd9eb1d76b381630e82c4241ccd0d27f1a39ed41b2760b255c5e8"
+dependencies = [
+ "windows-core 0.61.2",
+]
+
+[[package]]
+name = "windows-core"
+version = "0.58.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6ba6d44ec8c2591c134257ce647b7ea6b20335bf6379a27dac5f1641fcf59f99"
+dependencies = [
+ "windows-implement 0.58.0",
+ "windows-interface 0.58.0",
+ "windows-result 0.2.0",
+ "windows-strings 0.1.0",
+ "windows-targets 0.52.6",
+]
+
+[[package]]
+name = "windows-core"
+version = "0.61.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c0fdd3ddb90610c7638aa2b3a3ab2904fb9e5cdbecc643ddb3647212781c4ae3"
+dependencies = [
+ "windows-implement 0.60.0",
+ "windows-interface 0.59.1",
+ "windows-link 0.1.3",
+ "windows-result 0.3.4",
+ "windows-strings 0.4.2",
+]
+
+[[package]]
+name = "windows-core"
+version = "0.62.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "57fe7168f7de578d2d8a05b07fd61870d2e73b4020e9f49aa00da8471723497c"
+dependencies = [
+ "windows-implement 0.60.0",
+ "windows-interface 0.59.1",
+ "windows-link 0.2.1",
+ "windows-result 0.4.0",
+ "windows-strings 0.5.0",
+]
+
+[[package]]
+name = "windows-future"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc6a41e98427b19fe4b73c550f060b59fa592d7d686537eebf9385621bfbad8e"
+dependencies = [
+ "windows-core 0.61.2",
+ "windows-link 0.1.3",
+ "windows-threading",
+]
+
+[[package]]
+name = "windows-implement"
+version = "0.58.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2bbd5b46c938e506ecbce286b6628a02171d56153ba733b6c741fc627ec9579b"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "windows-implement"
+version = "0.60.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a47fddd13af08290e67f4acabf4b459f647552718f683a7b415d290ac744a836"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "windows-interface"
+version = "0.58.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "053c4c462dc91d3b1504c6fe5a726dd15e216ba718e84a0e46a88fbe5ded3515"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "windows-interface"
+version = "0.59.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bd9211b69f8dcdfa817bfd14bf1c97c9188afa36f4750130fcdf3f400eca9fa8"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "windows-link"
+version = "0.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5e6ad25900d524eaabdbbb96d20b4311e1e7ae1699af4fb28c17ae66c80d798a"
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+
+[[package]]
+name = "windows-numerics"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9150af68066c4c5c07ddc0ce30421554771e528bde427614c61038bc2c92c2b1"
+dependencies = [
+ "windows-core 0.61.2",
+ "windows-link 0.1.3",
+]
+
+[[package]]
+name = "windows-result"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1d1043d8214f791817bab27572aaa8af63732e11bf84aa21a45a78d6c317ae0e"
+dependencies = [
+ "windows-targets 0.52.6",
+]
+
+[[package]]
+name = "windows-result"
+version = "0.3.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "56f42bd332cc6c8eac5af113fc0c1fd6a8fd2aa08a0119358686e5160d0586c6"
+dependencies = [
+ "windows-link 0.1.3",
+]
+
+[[package]]
+name = "windows-result"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7084dcc306f89883455a206237404d3eaf961e5bd7e0f312f7c91f57eb44167f"
+dependencies = [
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "windows-strings"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4cd9b125c486025df0eabcb585e62173c6c9eddcec5d117d3b6e8c30e2ee4d10"
+dependencies = [
+ "windows-result 0.2.0",
+ "windows-targets 0.52.6",
+]
+
+[[package]]
+name = "windows-strings"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "56e6c93f3a0c3b36176cb1327a4958a0353d5d166c2a35cb268ace15e91d3b57"
+dependencies = [
+ "windows-link 0.1.3",
+]
+
+[[package]]
+name = "windows-strings"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7218c655a553b0bed4426cf54b20d7ba363ef543b52d515b3e48d7fd55318dda"
+dependencies = [
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "windows-sys"
+version = "0.45.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "75283be5efb2831d37ea142365f009c02ec203cd29a3ebecbc093d52315b66d0"
+dependencies = [
+ "windows-targets 0.42.2",
+]
+
+[[package]]
+name = "windows-sys"
+version = "0.48.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "677d2418bec65e3338edb076e806bc1ec15693c5d0104683f2efe857f61056a9"
+dependencies = [
+ "windows-targets 0.48.5",
+]
+
+[[package]]
+name = "windows-sys"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d"
+dependencies = [
+ "windows-targets 0.52.6",
+]
+
+[[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.3",
+]
+
+[[package]]
+name = "windows-sys"
+version = "0.61.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
+dependencies = [
+ "windows-link 0.2.1",
+]
+
+[[package]]
+name = "windows-targets"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e5180c00cd44c9b1c88adb3693291f1cd93605ded80c250a75d472756b4d071"
+dependencies = [
+ "windows_aarch64_gnullvm 0.42.2",
+ "windows_aarch64_msvc 0.42.2",
+ "windows_i686_gnu 0.42.2",
+ "windows_i686_msvc 0.42.2",
+ "windows_x86_64_gnu 0.42.2",
+ "windows_x86_64_gnullvm 0.42.2",
+ "windows_x86_64_msvc 0.42.2",
+]
+
+[[package]]
+name = "windows-targets"
+version = "0.48.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a2fa6e2155d7247be68c096456083145c183cbbbc2764150dda45a87197940c"
+dependencies = [
+ "windows_aarch64_gnullvm 0.48.5",
+ "windows_aarch64_msvc 0.48.5",
+ "windows_i686_gnu 0.48.5",
+ "windows_i686_msvc 0.48.5",
+ "windows_x86_64_gnu 0.48.5",
+ "windows_x86_64_gnullvm 0.48.5",
+ "windows_x86_64_msvc 0.48.5",
+]
+
+[[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.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d5fe6031c4041849d7c496a8ded650796e7b6ecc19df1a431c1a363342e5dc91"
+dependencies = [
+ "windows-link 0.1.3",
+ "windows_aarch64_gnullvm 0.53.0",
+ "windows_aarch64_msvc 0.53.0",
+ "windows_i686_gnu 0.53.0",
+ "windows_i686_gnullvm 0.53.0",
+ "windows_i686_msvc 0.53.0",
+ "windows_x86_64_gnu 0.53.0",
+ "windows_x86_64_gnullvm 0.53.0",
+ "windows_x86_64_msvc 0.53.0",
+]
+
+[[package]]
+name = "windows-threading"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b66463ad2e0ea3bbf808b7f1d371311c80e115c0b71d60efc142cafbcfb057a6"
+dependencies = [
+ "windows-link 0.1.3",
+]
+
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "597a5118570b68bc08d8d59125332c54f1ba9d9adeedeef5b99b02ba2b0698f8"
+
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.48.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2b38e32f0abccf9987a4e3079dfb67dcd799fb61361e53e2882c3cbaf0d905d8"
+
+[[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.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "86b8d5f90ddd19cb4a147a5fa63ca848db3df085e25fee3cc10b39b6eebae764"
+
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e08e8864a60f06ef0d0ff4ba04124db8b0fb3be5776a5cd47641e942e58c4d43"
+
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.48.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc35310971f3b2dbbf3f0690a219f40e2d9afcf64f9ab7cc1be722937c26b4bc"
+
+[[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.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c7651a1f62a11b8cbd5e0d42526e55f2c99886c77e007179efff86c2b137e66c"
+
+[[package]]
+name = "windows_i686_gnu"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c61d927d8da41da96a81f029489353e68739737d3beca43145c8afec9a31a84f"
+
+[[package]]
+name = "windows_i686_gnu"
+version = "0.48.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a75915e7def60c94dcef72200b9a8e58e5091744960da64ec734a6c6e9b3743e"
+
+[[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.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c1dc67659d35f387f5f6c479dc4e28f1d4bb90ddd1a5d3da2e5d97b42d6272c3"
+
+[[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.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ce6ccbdedbf6d6354471319e781c0dfef054c81fbc7cf83f338a4296c0cae11"
+
+[[package]]
+name = "windows_i686_msvc"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "44d840b6ec649f480a41c8d80f9c65108b92d89345dd94027bfe06ac444d1060"
+
+[[package]]
+name = "windows_i686_msvc"
+version = "0.48.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f55c233f70c4b27f66c523580f78f1004e8b5a8b659e05a4eb49d4166cca406"
+
+[[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.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "581fee95406bb13382d2f65cd4a908ca7b1e4c2f1917f143ba16efe98a589b5d"
+
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8de912b8b8feb55c064867cf047dda097f92d51efad5b491dfb98f6bbb70cb36"
+
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.48.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "53d40abd2583d23e4718fddf1ebec84dbff8381c07cae67ff7768bbf19c6718e"
+
+[[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.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2e55b5ac9ea33f2fc1716d1742db15574fd6fc8dadc51caab1c16a3d3b4190ba"
+
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "26d41b46a36d453748aedef1486d5c7a85db22e56aff34643984ea85514e94a3"
+
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.48.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b7b52767868a23d5bab768e390dc5f5c55825b6d30b86c844ff2dc7414044cc"
+
+[[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.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0a6e035dd0599267ce1ee132e51c27dd29437f63325753051e71dd9e42406c57"
+
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.42.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9aec5da331524158c6d1a4ac0ab1541149c0b9505fde06423b02f5ef0106b9f0"
+
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.48.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ed94fce61571a4006852b7389a063ab983c02eb1bb37b47f8272ce92d06d9538"
+
+[[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.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "271414315aff87387382ec3d271b52d7ae78726f5d44ac98b4f4030c91880486"
+
+[[package]]
+name = "winit"
+version = "0.30.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c66d4b9ed69c4009f6321f762d6e61ad8a2389cd431b97cb1e146812e9e6c732"
+dependencies = [
+ "ahash",
+ "android-activity",
+ "atomic-waker",
+ "bitflags 2.9.4",
+ "block2 0.5.1",
+ "bytemuck",
+ "calloop 0.13.0",
+ "cfg_aliases",
+ "concurrent-queue",
+ "core-foundation 0.9.4",
+ "core-graphics",
+ "cursor-icon",
+ "dpi",
+ "js-sys",
+ "libc",
+ "memmap2",
+ "ndk",
+ "objc2 0.5.2",
+ "objc2-app-kit 0.2.2",
+ "objc2-foundation 0.2.2",
+ "objc2-ui-kit",
+ "orbclient",
+ "percent-encoding",
+ "pin-project",
+ "raw-window-handle",
+ "redox_syscall 0.4.1",
+ "rustix 0.38.44",
+ "sctk-adwaita",
+ "smithay-client-toolkit 0.19.2",
+ "smol_str",
+ "tracing",
+ "unicode-segmentation",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "wayland-backend",
+ "wayland-client",
+ "wayland-protocols",
+ "wayland-protocols-plasma",
+ "web-sys",
+ "web-time",
+ "windows-sys 0.52.0",
+ "x11-dl",
+ "x11rb",
+ "xkbcommon-dl",
+]
+
+[[package]]
+name = "winnow"
+version = "0.7.13"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "21a0236b59786fed61e2a80582dd500fe61f18b5dca67a4a067d0bc9039339cf"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "wit-bindgen"
+version = "0.46.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f17a85883d4e6d00e8a97c586de764dabcc06133f7f1d55dce5cdc070ad7fe59"
+
+[[package]]
+name = "writeable"
+version = "0.6.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9edde0db4769d2dc68579893f2306b26c6ecfbe0ef499b013d731b7b9247e0b9"
+
+[[package]]
+name = "x11-dl"
+version = "2.21.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "38735924fedd5314a6e548792904ed8c6de6636285cb9fec04d5b1db85c1516f"
+dependencies = [
+ "libc",
+ "once_cell",
+ "pkg-config",
+]
+
+[[package]]
+name = "x11rb"
+version = "0.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9993aa5be5a26815fe2c3eacfc1fde061fc1a1f094bf1ad2a18bf9c495dd7414"
+dependencies = [
+ "as-raw-xcb-connection",
+ "gethostname",
+ "libc",
+ "libloading",
+ "once_cell",
+ "rustix 1.1.2",
+ "x11rb-protocol",
+]
+
+[[package]]
+name = "x11rb-protocol"
+version = "0.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ea6fc2961e4ef194dcbfe56bb845534d0dc8098940c7e5c012a258bfec6701bd"
+
+[[package]]
+name = "xcursor"
+version = "0.3.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bec9e4a500ca8864c5b47b8b482a73d62e4237670e5b5f1d6b9e3cae50f28f2b"
+
+[[package]]
+name = "xkbcommon-dl"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d039de8032a9a8856a6be89cea3e5d12fdd82306ab7c94d74e6deab2460651c5"
+dependencies = [
+ "bitflags 2.9.4",
+ "dlib",
+ "log",
+ "once_cell",
+ "xkeysym",
+]
+
+[[package]]
+name = "xkeysym"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b9cc00251562a284751c9973bace760d86c0276c471b4be569fe6b068ee97a56"
+
+[[package]]
+name = "xml-rs"
+version = "0.8.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ae8337f8a065cfc972643663ea4279e04e7256de865aa66fe25cec5fb912d3f"
+
+[[package]]
+name = "xmlwriter"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ec7a2a501ed189703dba8b08142f057e887dfc4b2cc4db2d343ac6376ba3e0b9"
+
+[[package]]
+name = "y4m"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7a5a4b21e1a62b67a2970e6831bc091d7b87e119e7f9791aef9702e3bef04448"
+
+[[package]]
+name = "yansi"
version = "1.0.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "cfe53a6657fd280eaa890a3bc59152892ffa3e30101319d168b781ed6529b049"
+
+[[package]]
+name = "yoke"
+version = "0.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72d6e5c6afb84d73944e5cedb052c4680d5657337201555f9f2a16b7406d4954"
+dependencies = [
+ "stable_deref_trait",
+ "yoke-derive",
+ "zerofrom",
+]
+
+[[package]]
+name = "yoke-derive"
+version = "0.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b659052874eb698efe5b9e8cf382204678a0086ebf46982b79d6ca3182927e5d"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+ "synstructure",
+]
+
+[[package]]
+name = "zbus"
+version = "5.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b622b18155f7a93d1cd2dc8c01d2d6a44e08fb9ebb7b3f9e6ed101488bad6c91"
+dependencies = [
+ "async-broadcast",
+ "async-executor",
+ "async-io",
+ "async-lock",
+ "async-process",
+ "async-recursion",
+ "async-task",
+ "async-trait",
+ "blocking",
+ "enumflags2",
+ "event-listener",
+ "futures-core",
+ "futures-lite",
+ "hex",
+ "nix",
+ "ordered-stream",
+ "serde",
+ "serde_repr",
+ "tracing",
+ "uds_windows",
+ "uuid",
+ "windows-sys 0.61.2",
+ "winnow",
+ "zbus_macros",
+ "zbus_names",
+ "zvariant",
+]
+
+[[package]]
+name = "zbus-lockstep"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6998de05217a084b7578728a9443d04ea4cd80f2a0839b8d78770b76ccd45863"
+dependencies = [
+ "zbus_xml",
+ "zvariant",
+]
+
+[[package]]
+name = "zbus-lockstep-macros"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "10da05367f3a7b7553c8cdf8fa91aee6b64afebe32b51c95177957efc47ca3a0"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+ "zbus-lockstep",
+ "zbus_xml",
+ "zvariant",
+]
+
+[[package]]
+name = "zbus_macros"
+version = "5.12.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1cdb94821ca8a87ca9c298b5d1cbd80e2a8b67115d99f6e4551ac49e42b6a314"
+dependencies = [
+ "proc-macro-crate",
+ "proc-macro2",
+ "quote",
+ "syn",
+ "zbus_names",
+ "zvariant",
+ "zvariant_utils",
+]
+
+[[package]]
+name = "zbus_names"
+version = "4.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7be68e64bf6ce8db94f63e72f0c7eb9a60d733f7e0499e628dfab0f84d6bcb97"
+dependencies = [
+ "serde",
+ "static_assertions",
+ "winnow",
+ "zvariant",
+]
+
+[[package]]
+name = "zbus_xml"
+version = "5.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "589e9a02bfafb9754bb2340a9e3b38f389772684c63d9637e76b1870377bec29"
+dependencies = [
+ "quick-xml 0.36.2",
+ "serde",
+ "static_assertions",
+ "zbus_names",
+ "zvariant",
+]
+
+[[package]]
+name = "zerocopy"
+version = "0.8.27"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0894878a5fa3edfd6da3f88c4805f4c8558e2b996227a3d864f47fe11e38282c"
+dependencies = [
+ "zerocopy-derive",
+]
+
+[[package]]
+name = "zerocopy-derive"
+version = "0.8.27"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "88d2b8d9c68ad2b9e4340d7832716a4d21a22a1154777ad56ea55c51a9cf3831"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "zerofrom"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "50cc42e0333e05660c3587f3bf9d0478688e15d870fab3346451ce7f8c9fbea5"
+dependencies = [
+ "zerofrom-derive",
+]
+
+[[package]]
+name = "zerofrom-derive"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d71e5d6e06ab090c67b5e44993ec16b72dcbaabc526db883a360057678b48502"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+ "synstructure",
+]
+
+[[package]]
+name = "zeroize"
+version = "1.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b97154e67e32c85465826e8bcc1c59429aaaf107c1e4a9e53c8d8ccd5eff88d0"
+
+[[package]]
+name = "zerotrie"
+version = "0.2.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2a59c17a5562d507e4b54960e8569ebee33bee890c70aa3fe7b97e85a9fd7851"
+dependencies = [
+ "displaydoc",
+ "yoke",
+ "zerofrom",
+]
+
+[[package]]
+name = "zerovec"
+version = "0.11.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6c28719294829477f525be0186d13efa9a3c602f7ec202ca9e353d310fb9a002"
+dependencies = [
+ "yoke",
+ "zerofrom",
+ "zerovec-derive",
+]
+
+[[package]]
+name = "zerovec-derive"
+version = "0.11.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "eadce39539ca5cb3985590102671f2567e659fca9666581ad3411d59207951f3"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "zune-core"
+version = "0.4.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3f423a2c17029964870cfaabb1f13dfab7d092a62a29a89264f4d36990ca414a"
+
+[[package]]
+name = "zune-core"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "111f7d9820f05fd715df3144e254d6fc02ee4088b0644c0ffd0efc9e6d9d2773"
+
+[[package]]
+name = "zune-inflate"
+version = "0.2.54"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "73ab332fe2f6680068f3582b16a24f90ad7096d5d39b974d1c0aff0125116f02"
+dependencies = [
+ "simd-adler32",
+]
+
+[[package]]
+name = "zune-jpeg"
+version = "0.4.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29ce2c8a9384ad323cf564b67da86e21d3cfdff87908bc1223ed5c99bc792713"
+dependencies = [
+ "zune-core 0.4.12",
+]
+
+[[package]]
+name = "zune-jpeg"
+version = "0.5.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f520eebad972262a1dde0ec455bce4f8b298b1e5154513de58c114c4c54303e8"
+dependencies = [
+ "zune-core 0.5.0",
+]
+
+[[package]]
+name = "zvariant"
+version = "5.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2be61892e4f2b1772727be11630a62664a1826b62efa43a6fe7449521cb8744c"
+dependencies = [
+ "endi",
+ "enumflags2",
+ "serde",
+ "url",
+ "winnow",
+ "zvariant_derive",
+ "zvariant_utils",
+]
+
+[[package]]
+name = "zvariant_derive"
+version = "5.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "da58575a1b2b20766513b1ec59d8e2e68db2745379f961f86650655e862d2006"
+dependencies = [
+ "proc-macro-crate",
+ "proc-macro2",
+ "quote",
+ "syn",
+ "zvariant_utils",
+]
+
+[[package]]
+name = "zvariant_utils"
+version = "3.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c6949d142f89f6916deca2232cf26a8afacf2b9fdc35ce766105e104478be599"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "serde",
+ "syn",
+ "winnow",
+]
diff --git a/Cargo.toml b/Cargo.toml
index 4f0d42cb..a8f9e941 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -2,12 +2,37 @@
resolver = "3"
-members = ["engine", "cli", "gui", "plugins", "shared"]
+members = ["engine", "cli", "gui", "plugins", "shared", "server"]
[workspace.package]
authors = ["Mikołaj Karbowski", "Adam Grącikowski"]
[workspace.dependencies]
+thiserror = "2"
rstest = "0.25.0"
mockall = "0.13.1"
pretty_assertions = "1.4.1"
+tempfile = "3.23.0"
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0.143"
+toml = "0.9.2"
+up_finder = "0.0.4"
+dirs = "6.0.0"
+editor-command = "1.0.0"
+globset = "0.4.16"
+chrono = { version = "0.4.42", features = ["serde"] }
+dateparser = "0.2.1"
+clap = { version = "4.5.41", features = ["derive"] }
+strum = "0.27"
+strum_macros = "0.27"
+regex = "1.11.3"
+similar = "2.7.0"
+owo-colors = "4.2.3"
+path-absolutize = { version = "3.1.1", features = ["once_cell_cache"] }
+async-trait = "0.1.89"
+tokio = { version = "1", features = ["full"] }
+russh = "0.44.0"
+russh-keys = "0.44.0"
+cryptovec = "0.7.0"
+url = "2.5.7"
+itertools = "0.14.0"
diff --git a/README.md b/README.md
index f270385f..0565391c 100644
--- a/README.md
+++ b/README.md
@@ -1,155 +1,925 @@
-# meva
-
-A distributed version control system written in Rust, developed as part of an engineering thesis.
-
-## Workspace structure
-
-The workspace contains five crates, organized as follows:
+
+ 
+
+
+# 🪶 MEVA
+
+
+ 
+ 
+ 
+ 
+ 
+ 
+ 
+
+
+**MEVA** (ang. _Modular & Extensible Versioning Assistant_) to rozproszony system kontroli wersji wyposażony w interfejsy CLI oraz GUI, zaimplementowany w języku Rust. Projekt został zrealizowany w ramach pracy inżynierskiej na Wydziale Matematyki i Nauk Informacyjnych Politechniki Warszawskiej przez zespół w składzie:
+
+- **[Adam Grącikowski](https://github.com/adamgracikowski)**
+- **[Mikołaj Karbowski](https://github.com/mikolajkarbowski)**
+
+Promotorem pracy był **[mgr inż. Tomasz Herman](https://github.com/tomasz-herman)**.
+
+## Spis treści
+
+- [Obsługiwane polecenia](#obslugiwane-polecenia)
+- [Graficzny interfejs użytkownika](#graficzny-interfejs-uzytkownika)
+- [Architektura](#architektura)
+ - [Struktura projektu](#struktura-projektu)
+ - [Model rozproszony i architektura repozytoriów](#model-rozproszony-i-architektura-repozytoriów)
+ - [Warstwa sieciowa i protokoły synchronizacji](#warstwa-sieciowa-i-protokoly-synchronizacji)
+- [Skrypty użytkownika](#skrypty-uzytkownika)
+ - [Założenia systemu skryptów użytkownika](#zalozenia-systemu-skryptow-uzytkownika)
+ - [Koncepcja niezależności językowej](#koncepcja-niezaleznosci-jezykowej)
+ - [Fizyczna organizacja i konfiguracja skyptów użytkownika](#fizyczna-organizacja-i-konfiguracja-skyptow-uzytkownika)
+ - [Struktura obiektów kontekstu](#struktura-obiektow-kontekstu)
+ - [Przykład implementacji](#przyklad-implementacji)
+- [Instalacja](#instalacja)
+ - [Wymagania wstępne i środowisko budowania](#wymagania-wstepne-i-srodowisko-budowania)
+ - [Instalacja klienta CLI](#instalacja-klienta-cli)
+ - [Instalacja klienta GUI](#instalacja-klienta-gui)
+ - [Instalacja i konfiguracja serwera SSH](#instalacja-i-konfiguracja-serwera-ssh)
+ - [Weryfikacja instalacji](#weryfikacja-instalacji)
+- [Instrukcja użytkownika](#instrukcja-uzytkownika)
+ - [Praca z interfejsem CLI](#praca-z-interfejsem-cli)
+ - [Praca z interfejsem GUI](#praca-z-interfejsem-gui)
+ - [Praca z serwerem SSH](#praca-z-serwerem-ssh)
+- [Generowanie dokumentacji projektu](#generowanie-dokumentacji-projektu)
+
+## Obsługiwane polecenia
+
+| Polecenie | Opis |
+| :--------- | :----------------------------------------------------------------------------------------- |
+| `init` | Inicjalizuje nowe, puste repozytorium. |
+| `add` | Dodaje zawartość plików do indeksu. |
+| `commit` | Tworzy nowe zatwierdzenie w repozytorium. |
+| `status` | Wyświetla stan plików w drzewie roboczym (zmodyfikowane, nieśledzone). |
+| `log` | Pokazuje historię commitów. |
+| `ls-files` | Wyświetla informacje o plikach w indeksie i drzewie roboczym. |
+| `ls-tree` | Wyświetla zawartość obiektu drzewa. |
+| `show` | Wyświetla szczegóły zatwierdzenia. |
+| `diff` | Pokazuje zmiany między zatwierdzeniami, zatwierdzeniem a drzewem roboczym itp. |
+| `restore` | Przywraca pliki w drzewie roboczym. |
+| `config` | Pobiera i ustawia opcje konfiguracyjne (`create`, `get`, `set`, `unset`, `list`, `edit`). |
+| `ignore` | Zarządza ignorowaniem plików (`add`, `remove`, `check`, `edit`). |
+| `branch` | Listuje, tworzy lub usuwa gałęzie. |
+| `checkout` | Przełącza gałęzie lub przywraca pliki drzewa roboczego. |
+| `merge` | Scala historię z innej gałęzi do bieżącej. |
+| `remote` | Zarządza zdalnymi repozytoriami (`add`, `remove`, `show`, `rename`, `get-url`, `set-url`). |
+| `clone` | Klonuje repozytorium do nowego katalogu. |
+| `fetch` | Pobiera obiekty i referencje ze zdalnego repozytorium. |
+| `pull` | Pobiera (`fetch`) i scala (`merge`) zmiany ze zdalnego repozytorium lub z lokalnej gałęzi. |
+| `push` | Aktualizuje zdalne referencje wraz z powiązanymi obiektami. |
+| `plugins` | Zarządza systemem skryptów użytkownika (`register`, `unregister`, `list`, `info`, `edit`). |
+
+## Graficzny interfejs użytkownika
+
+
+
+Ekran startowy aplikacji (Dashboard).
+
+
+
+ 
+
+
+
+
+
+
+Widok ustawień z formularzem edycji oraz listą globalnych zmiennych konfiguracyjnych.
+
+
+
+ 
+
+
+
+
+
+
+Błąd ładowania konfiguracji lokalnej przy braku otwartego repozytorium.
+
+
+
+ 
+
+
+
+
+
+
+Menu główne aplikacji z opcjami tworzenia i klonowania repozytorium.
+
+
+
+ 
+
+
+
+
+
+
+Okno dialogowe inicjalizacji nowego repozytorium.
+
+
+
+ 
+
+
+
+
+
+
+Okno dialogowe klonowania zdalnego repozytorium.
+
+
+
+ 
+
+
+
+
+
+
+Komunikat błędu wyświetlany przy próbie otwarcia katalogu z niezainicjowanym repozytorium.
+
+
+
+ 
+
+
+
+
+
+
+Podział plików na sekcje Staged i Unstaged z widocznymi ikonami statusu.
+
+
+
+ 
+
+
+
+
+
+
+Interaktywna lista historii commitów z rozwiniętymi szczegółami zmian.
+
+
+
+ 
+
+
+
+
+
+
+Okno dialogowe zatwierdzania zmian.
+
+
+
+ 
+
+
+
+
+
+
+Widok różnicowy z podświetlaniem składni.
+
+
+
+ 
+
+
+
+
+
+
+Menu kontekstowe pliku z opcją podglądu różnic i odrzucenia zmian.
+
+
+
+ 
+
+
+
+
+
+
+Okno dialogowe do zarządzania gałęziami.
+
+
+
+ 
+
+
+
+
+
+
+Stan aplikacji po wykryciu konfliktu w trakcie operacji scalania.
+
+
+
+ 
+
+
+
+
+
+
+Menu kontekstowe pliku z opcją rozpoczęcia rozwiązywania konfliktu.
+
+
+
+ 
+
+
+
+
+
+
+Edycja pliku ze znacznikami konfliktów w zewnętrznym edytorze.
+
+
+
+ 
+
+
+
+
+
+
+Oznaczenie konfliktu jako rozwiązanego.
+
+
+
+ 
+
+
+
+
+
+
+Pasek stanu z informacją o śledzonej gałęzi (2 zmiany do pobrania, 4 do wysłania).
+
+
+
+ 
+
+
+
+
+
+
+Widok paska statusu z widocznymi przyciskami akcji sieciowych.
+
+
+
+ 
+
+
+
+
+
+
+Lista aktywnych pluginów z filtrem ustawionym na zdarzenia pre-execute.
+
+
+
+ 
+
+
+
+
+
+
+Widok nieaktywnego pluginu z widocznym przyciskiem Enable.
+
+
+
+ 
+
+
+
+
+
+
+Edycja źródła skryptu wywołana przyciskiem Edit.
+
+
+
+ 
+
+
+
+
+
+
+Formularz rejestracji nowego pluginu.
+
+
+
+ 
+
+
+
+
+## Architektura
+
+### Struktura projektu
+
+Projekt `meva` zorganizowany jest jako _Rust Workspace_ i został podzielony jest na 6 modułów (ang. _crates_).
```
meva/
-├── Cargo.toml
-├── Cargo.lock
-├── engine/
-│ ├── Cargo.toml
-│ └── src/
-│ └── ...
-├── cli/
-│ ├── Cargo.toml
-│ └── src/
-│ └── ...
├── gui/
-│ ├── Cargo.toml
-│ └── src/
-│ └── ...
+│ └── ...
+├── cli/
+│ └── ...
+├── server/
+│ └── ...
+├── engine/
+│ └── ...
├── plugins/
-│ ├── Cargo.toml
-│ └── src/
-│ └── ...
+│ └── ...
├── shared/
-│ ├── Cargo.toml
-│ └── src/
-│ └── ...
-├── tests/
│ └── ...
-└── target/
- └── ...
+├── Cargo.toml
+├── LICENSE
+└── README.md
```
-It consists of 5 crates:
+| Moduł | Opis |
+| :-------- | :--------------------------------------------------------------------------------------------------------------------------------------------- |
+| `cli` | Interfejs wiersza poleceń, który pozwala na skryptowe zarządzanie repozytorium. |
+| `gui` | Interfejs graficzny dla użytkownika końcowego w formie aplikacji desktopowej, wspierający podzbiór funkcjonalności interfejsu wiersza poleceń. |
+| `server` | Moduł sieciowy. Obsługuje protokoły synchronizacji z repozytorium zdalnym, a także uwierzytelnianie i autoryzację użytkowników. |
+| `engine` | Główny moduł implementujący logikę poszczególnych operacji na repozytorium. |
+| `plugins` | System rozszerzeń w postaci skryptów użytkownika, uruchamianych jako procesy potomne. |
+| `shared` | Biblioteka pomocnicza, przechowująca logikę wspólną dla wszystkich modułów. |
-- Library crates:
- - `shared`,
- - `engine`,
- - `plugins`.
-- Binary crates:
- - `cli`,
- - `gui`.
+Projekt generuje trzy niezależne pliki wykonywalne: `meva`, `meva-gui` oraz `meva-server` odpowiednio dla modułów `cli`, `gui` oraz `server`.
-## Getting Started
+### Model rozproszony i architektura repozytoriów
-> The installation guide assumes you have already installed [Rust](https://www.rust-lang.org/learn/get-started).
+System kontroli wersji MEVA należy do klasy systemów rozproszonych (DVCS ang. _Distributed Version Control System_). W przeciwieństwie do systemów scentralizowanych (ang. _centralized_), takich jak SVN, gdzie pełna historia zmian znajduje się wyłącznie na głównym serwerze, w modelu przyjętym przez system MEVA każdy użytkownik posiada własną, kompletną kopię zdalnego repozytorium.
-### Building the project
+Diagram ilustruje współpracę dwóch niezależnych użytkowników za pośrednictwem węzła centralnego:
-To build all crates in the workspace:
+
+ 
+
-```bash
-cargo build
+Węzeł oznaczony jako `Repozytorium zdalne` pełni funkcję źródła danych (ang. _single source of truth_). Przechowuje ono wspólną historię projektu, do której dostęp mają wyłącznie uprawnieni użytkownicy. `Użytkownik 2`, za pośrednictwem aplikacji desktopowej (`Klient GUI`), rozpoczyna pracę poprzez wykonania operacji `clone`. Jej wynikiem jest lokalna kopii zdalnego repozytorium, oznaczona na schemacie jako `Repozytorium lokalne 2`.
+
+Zarówno `Użytkownik 1`, korzystający z interfejsu konsolowego (`Klient CLI`), jak i `Użytkownik 2` przesyłają swoje zatwierdzone zmiany za pomocą polecenia `push`. Operacja ta aktualizuje stan zdalnego repozytorium.
+
+W celu zsynchronizowania stanu swojego lokalnego repozytorium z postępami innych członków zespołu, użytkownicy wykorzystują polecenia `fetch` (pobranie brakujących obiektów bez integracji zmian) oraz `pull` (pobranie zmian połączone ze ich scalaniem).
+
+### Warstwa sieciowa i protokoły synchronizacji
+
+System MEVA nie implementuje własnego, niskopoziomowego protokołu transportowego opartego bezpośrednio na gniazdach TCP. Zamiast tego, przyjęto architekturę opartą na tunelowaniu ruchu przez protokół SSH (ang. _Secure Shell_). Całość wymiany danych, w tym negocjacja historii oraz transfer obiektów, odbywa się wewnątrz bezpiecznego kanału.
+
+#### Protokół pobierania danych
+
+Protokół pobierania danych (`meva-upload-pack`) stanowi fundament operacji `fetch` oraz `clone`. Jego zadaniem jest synchronizacja stanu repozytorium lokalnego z repozytorium zdalnym poprzez pobranie jedynie brakujących obiektów historii. Protokół ten jest uruchamiany bezpośrednio po zakończeniu wstępnej fazy rozgłaszania referencji i składa się z dwóch etapów: negocjacji historii oraz transferu danych (generowania i wysyłania paczki).
+
+Diagram sekwencji dla protokołu `meva-upload-pack`:
+
+
+ 
+
+
+#### Protokół wysyłania danych
+
+Protokół wysyłania danych (`meva-receive-pack`) stanowi fundament operacji `push`. Jego zadaniem jest synchronizacja stanu repozytorium zdalnego z repozytorium lokalnym klienta, a także zarządzanie stanem zdalnych referencji. Protokół ten jest uruchamiany bezpośrednio po zakończeniu wstępnej fazy rozgłaszania referencji i składa się z 3 etapów: przesyłania poleceń aktualizacji referencji, transferu danych (generowania i wysyłania paczki) oraz raportowania aktualizacji referencji.
+
+Diagram sekwencji dla protokołu `meva-receive-pack`:
+
+
+ 
+
+
+## Skrypty użytkownika
+
+System kontroli wersji MEVA został zaprojektowany jako rozwiązanie otwarte na rozszerzenia. Oprócz wbudowanego zestawu poleceń, udostępnia on mechanizm skryptów użytkownika (nazywanych również pluginami), który pozwala na automatyzację zadań, walidację danych oraz integrację zewnętrznych narzędzi bez konieczności ingerencji w kod źródłowy samej aplikacji.
+
+### Założenia systemu skryptów użytkownika
+
+Projektując moduł skryptów użytkownika, przyjęto szereg założeń definiujących jego zachowanie, zakres oraz sposób interakcji z otoczeniem:
+
+- **Model zdarzeń**: System obsługuje dwa rodzaje zdarzeń:
+ - `pre-execute`: Występujące przed wykonaniem właściwej operacji (np. `commit`, `push`). Służy do walidacji oraz modyfikacji danych wejściowych. Błąd zwrócony przez plugin w tej fazie skutkuje natychmiastowym przerwaniem całej operacji.
+ - `post-execute`: Występujące po pomyślnym wykonaniu operacji. Służy do raportowania i analizowania wyników polecenia. Błąd w tej fazie nie wpływa na wynik operacji wykonanej już na repozytorium.
+
+- **Zakresy**: Pluginy mogą być rejestrowane na dwóch poziomach widoczności:
+ - **Lokalny**: Ogranicza działanie skryptu do pojedynczego repozytorium. Konfiguracja i skrypty przechowywane są wewnątrz katalogu `.meva/plugins/`.
+ - **Globalny**: Rozszerza widoczność na wszystkie repozytoria danego użytkownika w systemie. Konfiguracja i skrypty przechowywane są w katalogu domowym użytkownika (`~/.meva/plugins/`).
+
+- **Niezależna komunikacja**: Interfejs wymiany danych między systemem a pluginem jest zrealizowany poprzez system plików. W momencie wywołania, skrypt otrzymuje ścieżkę do tymczasowego pliku JSON (tzw. pliku kontekstu), co uniezależnia mechanizm od języka programowania, w którym napisano rozszerzenie.
+
+- **Synchroniczne wykonanie**: Pluginy są uruchamiane synchronicznie, jeden po drugim. Kolejność ich wykonywania wynika z priorytetu (`order`) nadanego podczas rejestracji.
+
+- **Kontrola czasu wykonania**: Istnieje możliwość zdefiniowania maksymalnego czasu wykonania osobno dla każdego zarejestrowanego skryptu. Jeżeli wykonanie logiki zapisanej w pluginie potrwa dłużej niż określony limit, system automatycznie przerywa wykonanie, informując o przekroczeniu czasu.
+
+- **Przechwytywanie wejścia/wyjścia**: System w pełni zarządza standardowymi strumieniami (`stdin`, `stdout`, `stderr`) każdego skryptu. Strumienie wyjściowe są przechwytywane w czasie rzeczywistym, dzięki czemu komunikaty wypisywane na standardowe wyjście (`stdout`) i standardowe wyjście błędów (`stderr`) są jednocześnie prezentowane użytkownikowi w konsoli oraz zapisywane w logach wywołania. Skrypty mogą pobierać dane od użytkownika poprzez standardowe wejście (`stdin`).
+
+- **Konfiguracja**: Działanie całego systemu rozszerzeń jest kontrolowane przez wpisy w głównych plikach konfiguracyjnych (sekcja `[plugins]`), co pozwala na ich szybkie włączenie lub wyłączenie bez konieczności odinstalowywania skryptów czy rekompilacji kodu.
+
+### Koncepcja niezależności językowej
+
+Istotną cechą systemu rozszerzeń jest brak wymogu tworzenia pluginów w konkretnym języku programowania. Zamiast dostarczać wewnętrzne API lub biblioteki dynamiczne (`.dll`, ang. _dynamic link libraries_), system **MEVA** wykorzystuje mechanizm procesów potomnych oraz komunikację opartą na plikach. Procesy potomne komunikują się poprzez ustandaryzowany plik kontekstu operacji w formacie [JSON](https://json.org/json-en.html).
+
+Plugin został zdefiniowany jako dowolny plik wykonywalny lub skrypt interpretowany (na przykład w języku `Python`, `JavaScript`, `PowerShell` czy `Bash`).
+
+Proces wymiany danych wygląda następująco:
+
+1. System MEVA generuje plik tymczasowy w formacie JSON, zawierający metadane polecenia (kontekst wykonywanej operacji).
+2. System uruchamia skrypt użytkownika jako osobny proces, przekazując ścieżkę do pliku kontekstu jako pierwszy argument wywołania.
+3. Skrypt odczytuje dane, wykonuje swoją logikę i (opcjonalnie) modyfikuje plik kontekstu. Może również zapisać w nim informację o błędzie oraz zwrócić niezerowy kod wyjścia, przerywając wykonanie kolejnych skryptów lub samego polecenia.
+
+Dzięki takiemu podejściu użytkownik ma pełną swobodę w doborze technologii do tworzenia rozszerzeń, o ile w danym środowisku systemowym dostępny jest odpowiedni interpreter.
+
+### Fizyczna organizacja i konfiguracja skyptów użytkownika
+
+System pluginów posiada własną, ustrukturyzowaną hierarchię plików, która umożliwia logiczną organizację skryptów i ich metadanych. Zdefiniowano dwa poziomy zasięgu pluginów: globalny (dla użytkownika systemu operacyjnego) oraz lokalny (dla konkretnego repozytorium).
+
+```
+.meva/plugins/
+├── .invocations/
+│ ├── commit/
+│ │ ├── 20260112-202222/
+│ │ │ ├── invocation.log
+│ │ │ ├── pre-execute-context.json
+│ │ │ ├── post-execute-context.json
+│ │ │ ├── stdout.log
+│ │ │ └── stderr.log
+│ │ └── ...
+│ └── ...
+├── commit/
+│ ├── plugins.json
+│ ├── validate_message.py
+│ └── ...
+├── config/
+│ ├── set/
+│ │ ├── plugins.json
+│ │ └── ...
+│ └── unset/
+│ ├── plugins.json
+│ └── ...
+└── ...
+```
+
+### Struktura obiektów kontekstu
+
+Komunikacja między systemem MEVA a skryptami użytkownika odbywa się poprzez wymianę sformalizowanych obiektów danych w formacie JSON.
+
+Każdy plik kontekstu operacji, do którego ścieżka jest przekazywana jako pierwszy argument pozycyjny podczas uruchamiania skryptu, zawiera cztery główne sekcje: metadane (`context`), dane wejściowe (`pre-payload`), dane wyjściowe (`post-payload`) oraz kanał błędów (`error`).
+
+```json
+{
+ "context": {
+ "command": "commit",
+ "event": "pre-execute",
+ "timestamp": "2026-01-12T12:34:56Z",
+ "working_dir": "/home/john/company_project"
+ },
+ "pre-payload": {
+ "message": "Implement user authentication.",
+ "author": {
+ "name": "John Doe",
+ "email": "john.doe@example.com"
+ },
+ "amend": false
+ },
+ "post-payload": {
+ "commit_hash": "a1b2c3d4e5f6...",
+ "changes": [
+ {
+ "added": {
+ "new_path": "src/auth.rs",
+ "insertions": 45
+ }
+ }
+ ]
+ },
+ "error": null
+}
```
-To build a specific crate only:
+Rola poszczególnych sekcji obiektu JSON jest następująca:
-```bash
-cargo build -p
+1. `context`: Sekcja zawierająca podstawowe informacje o kontekście wywołania skryptu użytkownika. Znajdują się tu informacje o typie polecenia (`command`), rodzaju zdarzenia (`event`), czasie wywołania (`timestamp`) oraz katalogu roboczym (`working_dir`).
+2. `pre-payload`: Sekcja zawierająca dane wejściowe specyficzne dla danego polecenia. Są one dostępne zarówno w fazie `pre-execute`, jak i `post-execute`.
+3. `post-payload`: Sekcja przeznaczona na wynik działania operacji. W fazie `pre-execute` wartość ta zawsze wynosi `null`. W fazie `post-execute` (jak na rysunku przedstawiającym kontekst polecenia `commit`) zawiera ona informacje dotyczące rezultatu polecenia.
+4. `error`: Opcjonalna sekcja, która w przypadku poprawnego wykonania skryptu użytkownika przyjmuje wartość `null`. Plugin może ją zmodyfikować w celu zgłoszenia błędu wykonania.
+
+W przypadku polecenia `commit` informacje zawarte w `pre-payload` obejmują między innymi treść wiadomości, dane autora oraz flagi sterujące (np. `amend`). Sekcja `post-payload` zawiera natomiast między innymi skrót zatwierdzenia, a także listę plików objętych zatwierdzeniem wraz z metadanymi (np. liczbę zmodyfikowanych linii).
+
+#### Struktura obiektów błędu
+
+Skrypt użytkownika ma możliwość przerwania łańcucha wywołań następujących po nim pluginów, a w fazie `pre-execute` — dodatkowo zablokowania wykonania głównego polecenia (np. uniemożliwienia utworzenia zatwierdzenia, którego format wiadomości nie spełnia określonych wymogów).
+
+Sygnałem do przerwania operacji jest zakończenie procesu pluginu z kodem wyjścia (ang. _exit code_) różnym od zera. W takiej sytuacji system **MEVA** analizuje pole `error` w pliku kontekstu, aby wyświetlić użytkownikowi przyczynę blokady.
+
+```json
+{
+ "code": "VALIDATION_ERROR",
+ "message": "Commit message must reference an Azure DevOps work item (e.g. AB#1234)",
+ "details": "Regex pattern '^AB#\\d+' not matched"
+}
```
-Replace `` with one of: `engine`, `cli`, `gui`, `plugins`, or `shared`.
+Obiekt ten składa się z trzech pól:
-### Running the project
+1. `code`: Stały identyfikator typu błędu (np. `VALIDATION_ERROR`).
+2. `message`: Komunikat przeznaczony bezpośrednio dla użytkownika końcowego, wyjaśniający, dlaczego operacja została przerwana.
+3. `details`: Opcjonalne pole zawierające szczegóły techniczne, pomocne w diagnostyce.
-To run the CLI binary:
+### Przykład implementacji
-```bash
-cargo run -p cli
+W celu zaprezentowania praktycznego zastosowania omówionych mechanizmów, przedstawiona zostanie przykładowa implementacja pluginu walidacyjnego. Scenariusz ten zakłada integrację systemu MEVA z platformą Azure DevOps. Jedną z cech tej platformy jest identyfikowanie elementów roboczych (ang. _work items_) poprzez unikalny identyfikator (liczbę).
+
+Wymaganiem biznesowym może być oznaczanie każdego zatwierdzenia identyfikatorem odpowiadającego mu elementu roboczego poprzez umieszczenie tego identyfikatora na początku wiadomości zatwierdzenia.
+
+Poniżej przedstawiono kompletny kod skryptu napisanego w języku Python. Realizuje on logikę walidacji w fazie `pre-execute`, wykorzystując mechanizm pliku kontekstu do komunikacji z systemem MEVA.
+
+```python
+#!/usr/bin/env python3
+import sys, json, re
+
+filename = sys.argv[1]
+with open(filename, "r", encoding="utf-8") as f:
+ data = json.load(f)
+
+msg = data.get("pre-payload", {}).get("message", "")
+
+pattern = r"^AB#[0-9]+"
+
+if not re.match(pattern, msg):
+ data["error"] = {
+ "code": "VALIDATION_ERROR",
+ "message": "Commit message must reference an Azure DevOps work item (e.g. AB#1234)",
+ "details": f"Regex pattern '{pattern}' not matched"
+ }
+ with open(filename, "w", encoding="utf-8") as f:
+ json.dump(data, f, indent=2)
+ sys.exit(1)
+
+data["error"] = None
+with open(filename, "w", encoding="utf-8") as f:
+ json.dump(data, f, indent=2)
+
+sys.exit(0)
```
-To run the GUI binary:
+Wszystkie pliki związane z rozszerzeniami przechowywane są w katalogu `plugins/`. Dla zasięgu lokalnego katalog ten znajduje się wewnątrz folderu `.meva/`, natomiast dla zasięgu globalnego jego lokalizacja to katalog domowy użytkownika (ścieżka ``~/.meva/plugins/`).
-```bash
-cargo run -p gui
+Pluginy są grupowane w katalogach odpowiadających nazwom poleceń, na które mają one reagować (np. `commit/`, `config/set/`). Taka struktura umożliwa szybkie zlokalizowanie wszystkich skryptów zarejestrowanych na wywołanie konkretnego polecenia.
+
+## Instalacja
+
+Zarówno narzędzie wiersza poleceń (CLI), jak i interfejs graficzny (GUI) są dystrybuowane jako
+samodzielne pliki wykonywalne, co eliminuje konieczność instalowania skomplikowanych zależności
+w systemie użytkownika końcowego.
+
+### Wymagania wstępne i środowisko budowania
+
+System MEVA został napisany w języku [Rust](https://www.rust-lang.org/learn/get-started), dlatego do skompilowania kodu źródłowego wymagana jest obecność dedykowanych dla tego języka narzędzi (ang. _Rust toolchain_). Zalecana wersja kompilatora to 1.88.0 lub nowsza.
+
+Aby zweryfikować poprawność instalacji środowiska, należy wywołać w wierszu poleceń polecenia sprawdzające wersje kompilatora [rustc](https://cargo-book.irust.net/en-us/getting-started/installation.html) oraz menedżera pakietów [cargo](https://cargo-book.irust.net/en-us/getting-started/installation.html):
+
+```sh
+rustc --version
+# rustc 1.88.0 (6b00bc388 2025-06-23)
+
+cargo --version
+# cargo 1.88.0 (873a06493 2025-05-10)
```
-### Running tests
+### Instalacja klienta CLI
-To run all tests in the workspace:
+Klient wiersza poleceń jest podstawowym narzędziem do interakcji z systemem MEVA. Jego instalacja polega na skompilowaniu kodu źródłowego oraz skonfigurowaniu ścieżek systemowych.
-```bash
-cargo test
+Kompilację należy wykonać z poziomu katalogu głównego projektu, wykorzystując menedżer pa
+kietów cargo:
+
+```sh
+cargo build --release --bin meva
```
-To run tests for a specific crate:
+Wygenerowany plik wykonywalny zostanie domyślnie umieszczony w katalogu `target/release/`.
+
+Uruchomienie systemu MEVA za pomocą wiersza poleceń z dowolnego miejsca systemu operacyjnego wymaga dodania ścieżki z plikiem wykonywalnym do zmiennej środowiskowej `PATH`.
+
+#### Konfiguracja globalna użytkownika
+
+Po zainstalowaniu oprogramowania, należy zdefiniować tożsamość użytkownika. Konfiguracja tożsamości polega na określeniu wartości dla kluczy `user.name` oraz `user.email` w globalnym pliku konfiguracyjnym w katalogu domowym użytkownika.
+
+W celu stworzenia pliku konfiguracyjnego oraz ustawienia wartości `user.name` oraz `user.email` należy wykonać następujące polecenia:
-```bash
-cargo test -p
+```
+meva config create
+meva config set --global user.name "John Doe"
+meva config set --global user.email "john.doe@example.com"
```
-### Adding dependencies
+### Instalacja klienta GUI
-You can manage dependencies in your workspace efficiently with Cargo's CLI.
+Aplikacja kliencka z graficznym interfejsem użytkownika MEVA GUI stanowi alternatywę dla narzędzi wiersza poleceń, oferując wizualną reprezentację historii zmian i statusu repozytorium. W celu skompilowanie interfejsu graficznego, należy użyć polecenia:
-To add a regular dependency to a chosen crate:
+```sh
+cargo build --release --bin meva-gui
+```
-```bash
-cargo add -p
+Podobnie jak w przypadku klienta konsolowego, wynikowy plik wykonywalny (`meva-gui` lub `meva-gui.exe`) zostanie domyślnie umieszczony w katalogu `target/release/`.
+
+Uruchomienie aplikacji desktopowej MEVA GUI za pomocą wiersza poleceń z dowolnego miejsca systemu operacyjnego wymaga dodania ścieżki z plikiem wykonywalnym do zmiennej środowi
+skowej `PATH`.
+
+### Instalacja i konfiguracja serwera SSH
+
+Proces budowania wersji produkcyjnej serwera przebiega analogicznie do procedur opisanych dla narzędzi klienckich. W przypadku serwera SSH cel binarny nazywa się `meva-server`. Właściwe polecenie kompilacji przyjmuje postać:
+
+```sh
+cargo build --release --bin meva-server
```
-To add a development-only dependency:
+#### Generowanie kluczy kryptograficznych
-```bash
-cargo add --dev -p
+Fundamentem bezpieczeństwa serwera MEVA jest asymetryczna kryptografia oparta na protokole SSH. Aby serwer mógł bezpiecznie zestawiać połączenia i potwierdzać swoją tożsamość przed klientami, konieczne jest wygenerowanie pary kluczy hosta.
+
+Polecenie generujące parę kluczy wygląda następująco:
+
+```sh
+ssh-keygen -t ed25519 -f ./server_host_key -C "meva-server-host"
```
-To remove a dependency from a crate:
+#### Struktura katalogów serwera
-```bash
-cargo remove -p
+```
+opt/meva-server/
+├── bin/
+│ └── meva-server
+├── config/
+│ ├── mevaserverconfig.toml
+│ ├── access.toml
+│ └── authorized_keys
+├── secrets/
+│ ├── server_host_key
+│ └── server_host_key.pub
+├── logs/
+│ └── ...
+└── repositories/
+ └── ...
```
-Examples:
+| Katalog | Przeznaczenie |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `bin/` | Katalog, w którym przechowywany jest plik wykonywalny zdalnego serwera SSH. |
+| `config/` | Katalog, w którym przechowywane są wszystkie pliki sterujące zachowaniem serwera. |
+| `secrets/` | Katalog dla danych krytycznych z punktu widzenia bezpieczeństwa, w szczególności dla klucza prywatnego serwera. |
+| `logs/` | Katalog na pliki z logami serwera, umożliwiające monitorowanie jego pracy oraz diagnostykę błędów. |
+| `repositories/` | Katalog, w którym serwer przechowuje pliki i historię wszystkich obsługiwanych repozytoriów. Każde repozytorium otrzymuje własny podkatalog, wewnątrz którego znajduje się właściwa baza danych systemu MEVA. |
-```bash
-cargo add regex -p engine # Regular dependency for 'engine'
-cargo add insta --dev -p plugins # Dev dependency for 'plugins'
-cargo remove regex -p engine # Removes regular regex dependency
+W systemie MS Windows odpowiednikiem katalogu `opt/` jest folder `Program Files`.
+
+#### Plik z konfiguracją podstawową
+
+```toml
+[server]
+port = 2223
+address = "0.0.0.0"
+host_key = "./secrets/server_host_key"
+repositories_root = "./repositories"
+
+[access]
+authorized_keys = "./config/authorized_keys"
+policy_file = "./config/access.toml"
+
+[logging]
+level = "info"
+detailed = true
+log_file = "./logs/server.log"
+rotate_size = 10485760 # Rotacja przy 10MiB
+keep_logs = 7 # Przechowywanie 7 ostatnich plików
+```
+
+**Sekcja `[server]`:**
+
+Sekcja ta definiuje podstawowe parametry pracy usługi sieciowej oraz lo
+kalizację danych.
+
+- `port`: Numer portu TCP, na którym serwer nasłuchuje połączeń przychodzących (domyślnie 2223, aby uniknąć konfliktu z systemowym SSH na porcie 22).
+- `address`: Adres IP interfejsu sieciowego. Wartość `0.0.0.0` oznacza nasłuchiwanie na wszystkich dostępnych interfejsach sieciowych.
+- `host_key`: Względna lub bezwzględna ścieżka do pliku zawierającego klucz prywatny serwera.
+- `repositories_root`: Ścieżka do katalogu głównego, w którym przechowywane będą wszystkie repozytoria systemu MEVA.
+
+**Sekcja [access]:**
+
+Wskazuje lokalizację plików odpowiedzialnych za uwierzytelnianie i autory
+zację.
+
+- `authorized_keys`: Ścieżka do pliku zawierającego listę kluczy publicznych użytkowników uprawnionych do nawiązania połączenia.
+- `policy_file`: Ścieżka do pliku access.toml, definiującego szczegółowe uprawnienia dla poszczególnych użytkowników i repozytoriów.
+
+**Sekcja [logging]:**
+
+Konfiguruje sposób zbierania logów w trakcie działania serwera.
+
+- `level`: Określa minimalny poziom ważności komunikatów zapisywanych w logach. Możliwe wartości (od najmniej do najbardziej szczegółowych) to:
+ - `error`: Tylko błędy krytyczne uniemożliwiające dalsze działanie.
+ - `warn`: Ostrzeżenia o potencjalnych problemach.
+ - `info`: Standardowe informacje o przebiegu działania operacji.
+ - `debug`: Szczegółowe informacje diagnostyczne przydatne w trakcie diagnozowania błędów.
+- `detailed`: Wartość logiczna (`true`/`false`). Określa sposób formatowania wpisów. Jeśli ustawiona na `true`, logi zawierają dodatkowe metadane, takie jak sygnatura czasowa, nazwa pliku źródłowego i numer linii kodu, w której wystąpiło zdarzenie.
+- `log_file`: Ścieżka do pliku wyjściowego, w którym zapisywane są logi.
+- `rotate_size`: Maksymalny rozmiar pliku logów w bajtach, po przekroczeniu którego następuje jego rotacja (zamknięcie i zmiana nazwy). Wartość 10485760 odpowiada 10 MiB (mebibajtów).
+- `keep_logs`: Liczba plików archiwalnych przechowywanych po rotacji. Starsze pliki są automatycznie usuwane, co pozwala na kontrolowanie zużycia przestrzeni dyskowej.
+
+#### Plik z definicją kontroli dostępu
+
+Wsystemie MEVA zaimplementowano model uprwanień oparty na rolach, definiowanych w pliku `access.toml`. Model ten umożliwia przypisywanie uprawnień odczytu (`read`) oraz zapisu (`write`) zdefiniowanym użytkownikom do poszczególnych repozytoriów. Wpisy w pliku `access.toml` mają postać:
+
+```toml
+[company_project.john-doe]
+read = true
+write = true
+```
+
+#### Plik z kluczami publicznymi klientów
+
+Plik ten przechowuje listę kluczy publicznych (w formacie SSH Ed25519) użytkowników uprawnionych do łączenia się z serwerem.
+Przykładowy wpis w pliku `authorized_keys` wygląda następująco:
+
+```txt
+ssh-ed25519 john-doe
+```
+
+gdzie `john-doe` to nazwa użytkownika, która posłuży do jego identyfikacji w systemie uprawnień.
+
+#### Struktura katalogu repozytoriów
+
+Katalog zdefiniowany w pliku konfiguracyjnym `mevaserverconfig.toml` jako `repositories_root` jest miejscem, w którym serwer przechowuje pliki i historię wszystkich obsługiwanych repozytoriów. Każde repozytoium otrzymuje własny podkatalog, wewnątrz którego znajduje się właściwa baza danych systemu MEVA. Gdy użytkownik końcowy wykonuje operację push, przy pomocy interfejsu CLI lub GUI, serwer autoryzuje żądanie, a następnie zapisuje nowe obiekty w odpowiednim podkatalogu.
+
+#### Uruchomienie serwera SSH
+
+Aplikacja `meva-server` przyjmuje ścieżkę do głównego pliku konfiguracyjnego (plik `mevaserverconfig.toml`) jako argument pozycyjny. Dodatkowo, poziom szczegółowości komunikatów diagnostycznych wyświetlanych na standardowym wyjściu (`stdout`) sterowany jest poprzez zmienną środowiskową `RUST_LOG`.
+
+Polecenie uruchomienia serwera w systemie operacyjnym MS Windows:
+
+```
+$env:RUST_LOG = "info"; .\bin\meva-server.exe ‘
+"C:\meva\server\config\mevaserverconfig.toml"
+```
+
+Polecenie uruchomienia serwera w systemie operacyjnym Linux:
+
+```
+RUST_LOG=info ./bin/meva-server \
+"/opt/meva-server/config/mevaserverconfig.toml"
+```
+
+### Weryfikacja instalacji
+
+Aby uruchomić zestaw testów jednostkowych zdefiniowanych w kodzie źródłowym, należy w głównym katalogu projektu wywołać polecenie:
+
+```
+cargo test
+```
+
+Polecenie to automatycznie skompiluje kod w trybie testowym (który może zawierać dodatkowe asercje niewidoczne w wersji produkcyjnej), a następnie uruchomi wszystkie funkcje oznaczone atrybutem `#[test]`.
+
+**Pomyślny przebieg testów:**
+
+```
+...
+test repositories::meva_repository::tests::init_creates_expected_structure ... ok
+test repositories::meva_repository::tests::init_fails_if_repo_already_exists ... ok
+test result: ok. 47 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out;
+finished in 0.04s
```
-To share a dependency (or dev-dependency) version across multiple crates, declare it in your workspace root `Cargo.toml` using `[workspace.dependencies]`:
+Jeśli środowisko nie spełnia wymagań, testy zakończą się niepowodzeniem, oznaczonym komunikatem `FAILED`:
+
+```
+...
+test repositories::meva_repository::tests::init_creates_expected_structure ... ok
+test repositories::meva_repository::tests::init_fails_if_repo_already_exists ... FAILED
+test result: FAILED. 46 passed; 1 failed; 0 ignored; 0 measured; 0 filtered out;
+finished in 0.01s
+```
+
+## Instrukcja użytkownika
+
+### Praca z interfejsem CLI
+
+#### Wyświetlanie pomocy
+
+Interfejs linii poleceń został wyposażony w mechanizm pomocy o ustandaryzowanym formacie komunikatów oraz walidację wprowadzanych argumentów.
+System pomocy dostępny jest na dwóch poziomach:
+
+- Pomoc globalna: Wywołanie `meva –-help` (lub w wersji skróconej `-h`) wyświetla listę wszystkich dostępnych poleceń podrzędnych wraz z ich krótkim opisem oraz dostępne flagi globalne.
+- Pomoc kontekstowa: Każde polecenie (np. `commit`, `clone`) posiada własny ekran pomocy, dostępny poprzez wywołanie: `meva –-help`. Prezentuje on składnię danej operacji, wymagane i opcjonalne argumenty pozycyjne oraz flagi.
+
+#### Edycja plików konfiguracyjnych
+
+System MEVA opiera swoje działanie na plikach konfiguracyjnych w formacie [TOML](https://toml.io/pl/v1.0.0). Umożliwiają one dostosowanie zachowania narzędzia, od podstawowych danych użytkownika po ustawienia sieciowe i parametry skryptów użytkownika.
+Zarządzanie konfiguracją odbywa się za pomocą polecenia zbiorczego `meva config`.
+
+**Domyślna zawartość globalnego pliku konfiguracyjnego:**
```toml
-[workspace.dependencies]
- =
+# Meva Configuration File
+# Edit this file to customize your global settings
+[user]
+name = "Your Name"
+email = "your.email@example.com"
+signing_key = "path/to/client/signing/key"
+
+[editor]
+default = "vim"
+
+[plugins]
+enabled = false
+collect_logs = false
+```
+
+### Praca z interfejsem GUI
+
+Oprócz interfejsu wiersza poleceń, system MEVA oferuje dedykowaną aplikację desktopową, która ułatwia zarządzanie repozytoriami użytkownikom preferującym środowiska graficzne. GUI stanowi nakładkę na silnik CLI, zapewniając dostęp do ograniczonego zbioru funkcjonalności systemu.
+
+### Praca z serwerem SSH
+
+Bieżące utrzymanie serwera MEVA sprowadza się do zarządzania plikami konfiguracyjnymi znajdującymi się w katalogu `config/`. Poniżej opisano kluczowe procedury administracyjne na przykładzie wdrożenia projektu o nazwie `company_project` dla użytkownika `john-doe`.
+
+#### Tworzenie repozytorium
+
+Fizyczne utworzenie struktury danych repozytorium odbywa się poprzez polecenie `meva init` wywołane w stworzonym dla projektu katalogu umieszczonym wewnątrz katalogu `repositories/`. Wprzypadku projektu o nazwie `company_project` polecenie powinno zostać wywołane z poziomu `repositories/company_project/`.
+
+#### Dodawanie użytkowników
+
+Proces rejestracji nowego użytkownika w systemie składa się z dwóch etapów: wygenerowania pary kluczy po stronie klienta oraz zarejestrowania klucza publicznego na serwerze.
+
+**Generowanie klucza po stronie klienta:**
+
+```sh
+ssh-keygen -t ed25519 -f ./id_ed25519 -C "john-doe"
```
-In any crate that should use a workspace-provided dependency, reference it like so in its own `Cargo.toml`:
+Wwyniku tej operacji użytkownik uzyskuje plik klucza publicznego `id_ed25519.pub`, którego zawartość musi bezpiecznym kanałem przekazać administratorowi serwera.
+
+Administrator, po otrzymaniu klucza publicznego, musi dodać go do pliku `authorized_keys`, znajdującego się w katalogu konfiguracyjnym serwera
+(np. `/opt/meva-server/config/authorized_keys`). Każdy klucz powinien znajdować się w osobnej linii i kończyć się identyfikatorem użytkownika, który będzie później wykorzystywany w polityce dostępu.
+
+Ostatnim etapem jest zdefiniowanie uprawnień w pliku access.toml. W celu umożliwienia użytkownikowi `john-doe` pracy z repozytorium `company_project`, należy dodać nową sekcję o schematycznej nazwie `[nazwa_projektu.nazwa_użytkownika]`.
+
+**Konfiguracja uprawnień w pliku `access.toml`:**
```toml
-[dependencies]
- = { workspace = true }
+[company_project.john-doe]
+read = true
+write = true
+```
+
+
-### Generating docs
+## Generowanie dokumentacji projektu
-To generate documentation for all crates and open it:
+Aby wygenerować dokumentację publicznego API poszczególnych modułów projektu i otworzyć ją w domyślnej przeglądarce należy użyć polecenia:
```bash
cargo doc --open
```
-To include documentation for private items:
+Aby wygenerować kompletną dokumentację, uwzględniającą również elementy prywatne (przydatne dla deweloperów rozwijających projekt) i otworzyć ją w przeglądarce należy użyć polecenia:
```bash
cargo doc --document-private-items --open
diff --git a/cli/Cargo.toml b/cli/Cargo.toml
index 0917a37a..1890361b 100644
--- a/cli/Cargo.toml
+++ b/cli/Cargo.toml
@@ -4,10 +4,26 @@ version = "0.1.0"
edition = "2024"
authors.workspace = true
+[[bin]]
+name = "meva"
+path = "src/main.rs"
+
[dependencies]
shared = { path = "../shared" }
engine = { path = "../engine" }
plugins = { path = "../plugins" }
+clap.workspace = true
+dateparser.workspace = true
+thiserror.workspace = true
+miette = { version = "7.6.0", features = ["fancy"] }
+globset.workspace = true
+strum.workspace = true
+strum_macros.workspace = true
+owo-colors.workspace = true
+regex.workspace = true
+async-trait.workspace = true
+tokio.workspace = true
+url.workspace = true
[dev-dependencies]
rstest.workspace = true
diff --git a/cli/src/commands.rs b/cli/src/commands.rs
new file mode 100644
index 00000000..d67d5bb8
--- /dev/null
+++ b/cli/src/commands.rs
@@ -0,0 +1,98 @@
+pub mod add;
+pub mod branch;
+pub mod checkout;
+pub mod clone;
+pub mod commit;
+pub mod config;
+pub mod diff;
+pub mod fetch;
+pub mod ignore;
+pub mod init;
+pub mod log;
+pub mod ls_files;
+pub mod ls_tree;
+pub mod merge;
+pub mod meva_command;
+pub mod plugins;
+pub mod pull;
+pub mod push;
+pub mod remote;
+pub mod restore;
+pub mod show;
+pub mod status;
+
+pub use add::AddCommand;
+pub use branch::BranchCommand;
+pub use checkout::CheckoutCommand;
+pub use clone::CloneCommand;
+pub use commit::CommitCommand;
+pub use config::ConfigCommand;
+pub use diff::DiffCommand;
+pub use fetch::FetchCommand;
+pub use ignore::IgnoreCommand;
+pub use init::InitCommand;
+pub use log::LogCommand;
+pub use ls_files::LsFilesCommand;
+pub use ls_tree::LsTreeCommand;
+pub use merge::MergeCommand;
+pub use plugins::PluginsCommand;
+pub use pull::PullCommand;
+pub use push::PushCommand;
+pub use remote::RemoteCommand;
+pub use restore::RestoreCommand;
+pub use show::ShowCommand;
+pub use status::StatusCommand;
+
+use clap::ArgMatches;
+use miette::{Context, Result};
+
+use engine::engine_container::MevaContainer;
+pub use meva_command::MevaCommand;
+
+/// Executes the appropriate subcommand based on the provided matches.
+pub async fn execute_multiple(
+ matches: &ArgMatches,
+ container: &MevaContainer,
+ subcommands: Vec>>,
+) -> Result<()> {
+ if let Some((name, sub_matches)) = matches.subcommand()
+ && let Some(sub) = subcommands.into_iter().find(|c| c.name() == name)
+ {
+ return sub
+ .execute(sub_matches, container)
+ .await
+ .wrap_err(format!("Error running `{name}` subcommand"));
+ }
+
+ Ok(())
+}
+
+/// Collection type for Meva commands.
+pub type CommandsCollection = Vec>>;
+
+/// Collects all available Meva commands into a single collection.
+pub fn collect_commands() -> CommandsCollection {
+ vec![
+ Box::new(InitCommand),
+ Box::new(ConfigCommand),
+ Box::new(IgnoreCommand),
+ Box::new(PluginsCommand),
+ Box::new(AddCommand),
+ Box::new(LsFilesCommand),
+ Box::new(ShowCommand),
+ Box::new(StatusCommand),
+ Box::new(CommitCommand),
+ Box::new(DiffCommand),
+ Box::new(LsTreeCommand),
+ Box::new(LogCommand),
+ Box::new(RestoreCommand),
+ Box::new(CloneCommand),
+ Box::new(RemoteCommand),
+ Box::new(FetchCommand),
+ Box::new(BranchCommand),
+ Box::new(PushCommand),
+ Box::new(PullCommand),
+ Box::new(CheckoutCommand),
+ Box::new(MergeCommand),
+ ]
+}
diff --git a/cli/src/commands/add.rs b/cli/src/commands/add.rs
new file mode 100644
index 00000000..45f0cb32
--- /dev/null
+++ b/cli/src/commands/add.rs
@@ -0,0 +1,143 @@
+use std::path::PathBuf;
+
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgGroup, ArgMatches, Command, value_parser};
+use miette::{IntoDiagnostic, Result};
+
+use crate::commands::MevaCommand;
+use crate::extensions::WithVerbose;
+use engine::EngineContainer;
+use engine::engine_container::MevaContainer;
+use engine::handlers::add::AddRequest;
+
+/// CLI command for adding files to the Meva staging area.
+///
+/// The `AddCommand` allows
+/// users to select files or directories to add to the repository's staging area.
+///
+/// # Supported arguments
+/// - **`path`**: Optional path to file or directory. Use `.` to add the current directory.
+/// - **`--all, -a`**: Add all files in the repository.
+/// - **`--force, -f`**: Add files even if they are normally ignored.
+/// - **`--update, -u`**: Add modified and deleted files only. Conflicts with `--all`.
+/// - **`--dry-run, -n`**: Show which files *would* be added, without actually staging them.
+/// - **`--verbose, -v`**: Increase verbosity of output.
+#[derive(Default)]
+pub struct AddCommand;
+
+impl AddCommand {
+ /// Path argument key.
+ const ARG_PATH: &'static str = "path";
+
+ /// `--all` flag key.
+ const ARG_ALL: &'static str = "all";
+
+ /// `--force` flag key.
+ const ARG_FORCE: &'static str = "force";
+
+ /// `--update` flag key.
+ const ARG_UPDATE: &'static str = "update";
+
+ /// `--dry-run` flag key.
+ const ARG_DRY_RUN: &'static str = "dry-run";
+}
+
+#[async_trait]
+impl MevaCommand for AddCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "add"
+ }
+
+ fn about(&self) -> &'static str {
+ "Add files to the staging area"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the underlying Clap [`Command`] definition for this command.
+ ///
+ /// This defines supported arguments, their flags, and argument groups.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_PATH)
+ .value_name("PATH")
+ .help("Path to file or directory to add, use '.' for current catalog")
+ .value_parser(value_parser!(PathBuf))
+ .index(1),
+ )
+ .arg(
+ Arg::new(Self::ARG_ALL)
+ .short('a')
+ .long(Self::ARG_ALL)
+ .help("Adds all files to staging area")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_FORCE)
+ .short('f')
+ .long(Self::ARG_FORCE)
+ .help("Add file to staging area despite it's ignored")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_UPDATE)
+ .short('u')
+ .help("Add modified and deleted files only")
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_ALL),
+ )
+ .arg(
+ Arg::new(Self::ARG_DRY_RUN)
+ .short('n')
+ .long(Self::ARG_DRY_RUN)
+ .help("Show files to be added without adding them")
+ .action(ArgAction::SetTrue),
+ )
+ .with_verbose_arg("Enable verbose output")
+ .group(
+ ArgGroup::new("path_group")
+ .args([Self::ARG_PATH, Self::ARG_ALL, Self::ARG_UPDATE])
+ .required(true)
+ .multiple(true),
+ )
+ }
+
+ /// Executes the `add` command.
+ ///
+ /// - Reads all flags and arguments from `matches`.
+ /// - Constructs an [`AddRequest`] with the provided options.
+ /// - Delegates to the repository's [`add_handler`] to perform the operation.
+ ///
+ /// Returns a [`miette::Result`] with diagnostic information if an error occurs.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ let all_flag = matches.get_flag(Self::ARG_ALL);
+ let force_flag = matches.get_flag(Self::ARG_FORCE);
+ let update_flag = matches.get_flag(Self::ARG_UPDATE);
+ let dry_run_flag = matches.get_flag(Self::ARG_DRY_RUN);
+ let verbose_flag = matches.get_flag(Command::ARG_VERBOSE);
+ let path_arg = matches.get_one::(Self::ARG_PATH);
+
+ let handler = container.add_handler().into_diagnostic()?;
+ let interceptor = container.plugins_interceptor().into_diagnostic()?;
+
+ let request = AddRequest {
+ all_flag,
+ force_flag,
+ update_flag,
+ dry_run_flag,
+ verbose_flag,
+ path_arg: path_arg.cloned(),
+ };
+
+ handler
+ .handle_add(request, &interceptor)
+ .into_diagnostic()?;
+
+ Ok(())
+ }
+}
diff --git a/cli/src/commands/branch.rs b/cli/src/commands/branch.rs
new file mode 100644
index 00000000..7d6fed49
--- /dev/null
+++ b/cli/src/commands/branch.rs
@@ -0,0 +1,237 @@
+use crate::commands::MevaCommand;
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgGroup, ArgMatches, Command};
+use engine::engine_container::{EngineContainer, MevaContainer};
+use engine::handlers::branch::{
+ BranchOperations, CreateRequest, DeleteRequest, ListRequest, RenameRequest, Request,
+ SetUpstream,
+};
+use engine::revision_parsing::Revision;
+use miette::{IntoDiagnostic, Result};
+
+/// Implements the `branch` command for Meva DVCS.
+///
+/// Allows listing, creating, deleting, and renaming branches within the repository.
+/// It handles argument parsing to dispatch the appropriate request (Create, Delete,
+/// Rename, or List) to the [`BranchHandler`].
+#[derive(Default)]
+pub struct BranchCommand;
+
+impl BranchCommand {
+ /// First positional argument: branch name (creation/deletion) or old branch name (renaming).
+ const ARG_NAME: &'static str = "branch-name";
+
+ /// Second positional argument: start point (creation) or new branch name (renaming).
+ const ARG_TARGET: &'static str = "target";
+
+ /// Flag to delete a branch.
+ const ARG_DELETE: &'static str = "delete";
+
+ /// Flag to force delete a branch (even if unmerged).
+ const ARG_FORCE_DELETE: &'static str = "force-delete";
+
+ /// Flag to rename a branch.
+ const ARG_MOVE: &'static str = "move";
+
+ /// Flag to show verbose output (sha1 and commit subject).
+ const ARG_VERBOSE: &'static str = "verbose";
+
+ /// Flag to explicitly list branches.
+ const ARG_LIST: &'static str = "list";
+
+ /// Flag to list both local and remote-tracking branches.
+ const ARG_ALL: &'static str = "all";
+
+ /// Flag to list only remote-tracking branches.
+ const ARG_REMOTES: &'static str = "remotes";
+
+ /// Flag to configure local branch upstream.
+ const ARG_SET_UPSTREAM: &'static str = "set-upstream-to";
+}
+
+#[async_trait]
+impl MevaCommand for BranchCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "branch"
+ }
+
+ fn about(&self) -> &'static str {
+ "List, create, or delete branches"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `branch` command using `clap`.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_NAME)
+ .value_name("NAME")
+ .help("The name of the branch to create, delete, or rename")
+ .index(1)
+ .required(false),
+ )
+ .arg(
+ Arg::new(Self::ARG_TARGET)
+ .value_name("START_POINT/NEW_NAME")
+ .help("The new branch head (creation) or new name (rename)")
+ .index(2)
+ .required(false),
+ )
+ .arg(
+ Arg::new(Self::ARG_DELETE)
+ .short('d')
+ .long(Self::ARG_DELETE)
+ .help("Delete a branch")
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_MOVE)
+ .conflicts_with(Self::ARG_TARGET)
+ .requires(Self::ARG_NAME),
+ )
+ .arg(
+ Arg::new(Self::ARG_FORCE_DELETE)
+ .short('D')
+ .help("Force delete a branch")
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_MOVE)
+ .conflicts_with(Self::ARG_TARGET)
+ .requires(Self::ARG_NAME),
+ )
+ .arg(
+ Arg::new(Self::ARG_MOVE)
+ .short('m')
+ .long(Self::ARG_MOVE)
+ .help("Move/rename a branch")
+ .action(ArgAction::SetTrue)
+ .requires(Self::ARG_NAME)
+ .requires(Self::ARG_TARGET),
+ )
+ .arg(
+ Arg::new(Self::ARG_LIST)
+ .short('l')
+ .long(Self::ARG_LIST)
+ .help("List branches")
+ .action(ArgAction::SetTrue)
+ .conflicts_with_all([Self::ARG_DELETE, Self::ARG_FORCE_DELETE, Self::ARG_MOVE]),
+ )
+ .arg(
+ Arg::new(Self::ARG_ALL)
+ .short('a')
+ .long(Self::ARG_ALL)
+ .help("List both remote-tracking and local branches")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_REMOTES)
+ .short('r')
+ .long(Self::ARG_REMOTES)
+ .help("List the remote-tracking branches")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_VERBOSE)
+ .short('v')
+ .long(Self::ARG_VERBOSE)
+ .help("Show sha1 and commit subject line")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_SET_UPSTREAM)
+ .short('u')
+ .long(Self::ARG_SET_UPSTREAM)
+ .value_name("UPSTREAM")
+ .num_args(1)
+ .conflicts_with_all([
+ Self::ARG_DELETE,
+ Self::ARG_FORCE_DELETE,
+ Self::ARG_MOVE,
+ Self::ARG_LIST,
+ ]),
+ )
+ .group(
+ ArgGroup::new("delete_mode")
+ .args([Self::ARG_DELETE, Self::ARG_FORCE_DELETE])
+ .multiple(false),
+ )
+ }
+
+ /// Executes the `branch` command.
+ ///
+ /// Maps the CLI arguments to a specific `Request` variant (`Delete`, `Rename`, `Create`, or `List`)
+ /// and delegates execution to the `BranchHandler`.
+ ///
+ /// # Returns
+ /// * `Result<()>`: Indicates success or returns a detailed error if the operation fails.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ let branch_name = matches.get_one::(Self::ARG_NAME);
+ let second_arg = matches.get_one::(Self::ARG_TARGET);
+ let delete = matches.get_flag(Self::ARG_DELETE);
+ let force_delete = matches.get_flag(Self::ARG_FORCE_DELETE);
+ let move_arg = matches.get_flag(Self::ARG_MOVE);
+ let verbose = matches.get_flag(Self::ARG_VERBOSE);
+ let all = matches.get_flag(Self::ARG_ALL);
+ let remotes = matches.get_flag(Self::ARG_REMOTES);
+ let upstream = matches.get_one::(Self::ARG_SET_UPSTREAM);
+
+ let mut print_list = false;
+
+ let request = if delete || force_delete {
+ let request = DeleteRequest {
+ branch_name: branch_name.cloned().unwrap(),
+ force: force_delete,
+ };
+
+ Request::Delete(request)
+ } else if move_arg {
+ let request = RenameRequest {
+ old_name: branch_name.cloned().unwrap(),
+ new_name: second_arg.cloned().unwrap(),
+ };
+
+ Request::Rename(request)
+ } else if let Some(upstream) = upstream {
+ let request = SetUpstream {
+ local_branch: branch_name.cloned(),
+ remote_branch: upstream.clone(),
+ };
+
+ Request::SetUpstream(request)
+ } else if let Some(branch_name) = branch_name {
+ let start_point = match second_arg {
+ None => Revision::head(Vec::new()),
+ Some(start_point) => start_point.parse::().into_diagnostic()?,
+ };
+
+ let request = CreateRequest {
+ branch_name: branch_name.clone(),
+ start_point,
+ };
+
+ Request::Create(request)
+ } else {
+ let request = ListRequest {
+ verbose,
+ local: !remotes,
+ remotes: remotes || all,
+ };
+
+ print_list = true;
+
+ Request::List(request)
+ };
+
+ let handler = container.branch_handler().into_diagnostic()?;
+
+ let response = handler.branch(request).into_diagnostic()?;
+
+ if print_list && response.branches.is_some() {
+ println!("{}", response.branches.unwrap());
+ }
+
+ Ok(())
+ }
+}
diff --git a/cli/src/commands/checkout.rs b/cli/src/commands/checkout.rs
new file mode 100644
index 00000000..e4aec18a
--- /dev/null
+++ b/cli/src/commands/checkout.rs
@@ -0,0 +1,154 @@
+use crate::commands::MevaCommand;
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command, value_parser};
+use engine::{
+ EngineContainer,
+ engine_container::MevaContainer,
+ handlers::{
+ branch::{self, BranchOperations, CreateRequest},
+ checkout::{self, CheckoutOperations},
+ },
+ revision_parsing::Revision,
+};
+use miette::IntoDiagnostic;
+
+/// Implements the `checkout` command for Meva DVCS.
+///
+/// Updates files in the working tree to match the version in the index or the specified tree.
+/// This command is used to switch between branches, restore files, or move the `HEAD`
+/// pointer to a specific commit.
+///
+/// ### States of HEAD
+/// - **Attached HEAD**: Switching to a local branch (e.g., `master`) updates `HEAD` to point
+/// symbolically to that branch.
+/// - **Detached HEAD**: Checking out a commit hash, tag, or using the `--detach` flag
+/// points `HEAD` directly to a commit, leaving no active branch.
+#[derive(Default)]
+pub struct CheckoutCommand;
+
+impl CheckoutCommand {
+ /// Positional argument: the target to check out.
+ /// Can be a branch name (e.g., "main"), a commit hash, or a relative
+ /// reference like "HEAD~1".
+ const ARG_TARGET: &'static str = "target";
+
+ /// Flag key for creating a new branch and switching to it.
+ /// Corresponds to the `-b ` option.
+ /// If a target is provided, the new branch starts there; otherwise, it starts at `HEAD`.
+ const ARG_NEW_BRANCH: &'static str = "new-branch";
+
+ /// Flag key for forcing the checkout.
+ /// Corresponds to the `-f, --force` flag.
+ /// Overwrites local changes in the working tree without safety checks.
+ const ARG_FORCE: &'static str = "force";
+
+ /// Flag key for explicitly entering a detached HEAD state.
+ /// Corresponds to the `--detach` flag.
+ /// Useful when you want to inspect a branch's tip without switching to it.
+ const ARG_DETACH: &'static str = "detach";
+
+ /// Flag key for performing a three-way merge when switching branches.
+ /// Corresponds to the `-m, --merge` flag.
+ /// Attempts to carry your local changes over to the new branch by merging them.
+ const ARG_MERGE: &'static str = "merge";
+}
+
+#[async_trait]
+impl MevaCommand for CheckoutCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "checkout"
+ }
+
+ fn about(&self) -> &'static str {
+ "Switch branches or restore working tree files"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_NEW_BRANCH)
+ .short('b')
+ .value_name("NEW_BRANCH")
+ .help("Create and checkout a new branch"),
+ )
+ .arg(
+ Arg::new(Self::ARG_FORCE)
+ .short('f')
+ .long(Self::ARG_FORCE)
+ .help("Force checkout (discard local changes)")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_DETACH)
+ .long(Self::ARG_DETACH)
+ .help("Detach HEAD at named commit")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_MERGE)
+ .short('m')
+ .long(Self::ARG_MERGE)
+ .help("Perform a three-way merge between current branch, working tree, and new branch")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_TARGET)
+ .value_name("BRANCH_OR_COMMIT")
+ .value_parser(value_parser!(Revision))
+ .default_value("HEAD")
+ .help("Branch name or commit hash to switch to")
+ .required_unless_present(Self::ARG_NEW_BRANCH)
+ .index(1)
+ )
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let mut target = matches
+ .get_one::(Self::ARG_TARGET)
+ .unwrap()
+ .clone();
+ let new_branch = matches.get_one::(Self::ARG_NEW_BRANCH);
+ let force = matches.get_flag(Self::ARG_FORCE);
+ let detach = matches.get_flag(Self::ARG_DETACH);
+ let merge = matches.get_flag(Self::ARG_MERGE);
+
+ // Create new branch
+ if let Some(branch_name) = new_branch {
+ let request = CreateRequest {
+ branch_name: branch_name.to_string(),
+ start_point: target,
+ };
+
+ container
+ .branch_handler()
+ .into_diagnostic()?
+ .branch(branch::Request::Create(request))
+ .into_diagnostic()?;
+
+ target = branch_name.parse::().unwrap();
+ }
+
+ let request = checkout::Request {
+ force,
+ detach,
+ merge,
+ target,
+ };
+
+ let handler = container.checkout_handler().into_diagnostic()?;
+
+ handler.checkout(request).into_diagnostic()?;
+
+ Ok(())
+ }
+}
diff --git a/cli/src/commands/clone.rs b/cli/src/commands/clone.rs
new file mode 100644
index 00000000..7e54937e
--- /dev/null
+++ b/cli/src/commands/clone.rs
@@ -0,0 +1,111 @@
+use crate::{commands::MevaCommand, extensions::WithVerbose};
+use async_trait::async_trait;
+use clap::{Arg, ArgMatches, Command, ValueHint};
+use engine::{EngineContainer, engine_container::MevaContainer, handlers::clone::Request};
+use miette::{IntoDiagnostic, Result};
+use std::path::PathBuf;
+use url::Url;
+
+/// Implements the `clone` command for Meva DVCS.
+///
+/// Clones a remote repository into a new directory, creates a
+/// tracking connection to the remote repository (origin), and checks out
+/// the default branch.
+#[derive(Default)]
+pub struct CloneCommand;
+
+impl CloneCommand {
+ /// Argument name for specifying the remote repository URL.
+ const ARG_REPOSITORY: &'static str = "repository";
+
+ /// Argument name for specifying the target directory.
+ const ARG_DIRECTORY: &'static str = "directory";
+
+ /// Argument name for specifying the origin name.
+ const ARG_ORIGIN: &'static str = "origin";
+
+ /// Argument name for specifying the server public key.
+ const ARG_SERVER_KEY: &'static str = "server-key";
+}
+
+#[async_trait]
+impl MevaCommand for CloneCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "clone"
+ }
+
+ fn about(&self) -> &'static str {
+ "Clones a remote repository into a local directory"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `clone` command using `clap`.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_verbose_arg("Enable verbose output")
+ .arg(
+ Arg::new(Self::ARG_REPOSITORY)
+ .value_name("REPOSITORY")
+ .index(1)
+ .required(true)
+ .value_parser(clap::value_parser!(Url))
+ .help("Address of the repository to clone"),
+ )
+ .arg(
+ Arg::new(Self::ARG_DIRECTORY)
+ .value_name("DIRECTORY")
+ .index(2)
+ .value_hint(ValueHint::DirPath)
+ .value_parser(clap::value_parser!(PathBuf))
+ .help("Directory to clone into"),
+ )
+ .arg(
+ Arg::new(Self::ARG_ORIGIN)
+ .long(Self::ARG_ORIGIN)
+ .value_name("ORIGIN")
+ .default_value("origin")
+ .help("Optional origin name to set for the cloned repository"),
+ )
+ .arg(
+ Arg::new(Self::ARG_SERVER_KEY)
+ .long(Self::ARG_SERVER_KEY)
+ .short('s')
+ .required(true)
+ .value_hint(ValueHint::FilePath)
+ .value_parser(clap::value_parser!(PathBuf))
+ .help("Path to server's public key"),
+ )
+ }
+
+ /// Executes the `clone` command.
+ ///
+ /// # Returns
+ /// * `Result<()>`: Indicates success or returns a detailed error if the clone fails.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ let request = Request {
+ url: matches
+ .get_one::(Self::ARG_REPOSITORY)
+ .unwrap()
+ .clone(),
+ directory: matches.get_one::(Self::ARG_DIRECTORY).cloned(),
+ origin: matches.get_one::(Self::ARG_ORIGIN).unwrap().clone(),
+ server_key: matches
+ .get_one::(Self::ARG_SERVER_KEY)
+ .unwrap()
+ .clone(),
+ quiet: !matches.get_flag(Command::ARG_VERBOSE),
+ };
+
+ let handler = container.clone_handler().into_diagnostic()?;
+ let response = handler.handle_clone(request).await.into_diagnostic()?;
+
+ print!("{response}");
+
+ Ok(())
+ }
+}
diff --git a/cli/src/commands/commit.rs b/cli/src/commands/commit.rs
new file mode 100644
index 00000000..eaa1069c
--- /dev/null
+++ b/cli/src/commands/commit.rs
@@ -0,0 +1,244 @@
+use crate::commands::MevaCommand;
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command};
+use engine::diff_builder::{DiffStat, FileChangeKind};
+use engine::errors::{CommitError, EngineError};
+use engine::handlers::{add::AddRequest, commit::Request, commit::Response};
+use engine::objects::Person;
+use engine::{EngineContainer, engine_container::MevaContainer};
+use miette::IntoDiagnostic;
+use owo_colors::OwoColorize;
+
+/// Implements the `commit` command for Meva DVCS.
+///
+/// Creates a new commit object that records the current stage contents,
+/// along with a user-supplied message and optional metadata (author, date, etc.).
+/// Supports automatically staging changes, amending the last commit, or performing a dry run
+/// to preview the commit without persisting it.
+#[derive(Default)]
+pub struct CommitCommand;
+
+impl CommitCommand {
+ /// Argument key for specifying the commit message.
+ /// Corresponds to the `-m, --message ` option.
+ const ARG_MESSAGE: &'static str = "message";
+
+ /// Argument key for overriding the commit author.
+ /// Format: `"Name Surname "`
+ /// Corresponds to the `--author ` option.
+ const ARG_AUTHOR: &'static str = "author";
+
+ /// Flag key for staging all modified and deleted files before commiting.
+ /// Corresponds to the `-a, --all` flag.
+ const ARG_ALL: &'static str = "all";
+
+ /// Flag key for performing a dry run (no commit is actually created).
+ /// Corresponds to the `-n --dry-run` flag.
+ const ARG_DRY_RUN: &'static str = "dry-run";
+
+ /// Flag key for amending the tip of the current branch instead of creating a new commit.
+ /// Corresponds to the `--amend` flag.
+ const ARG_AMEND: &'static str = "amend";
+
+ /// Displays a formatted summary of a successfully created commit.
+ ///
+ /// Includes:
+ /// - Shortened commit hash and message,
+ /// - Diff statistics summary (added/deleted lines),
+ /// - List of file changes (created, deleted, modified).
+ ///
+ /// # Arguments
+ /// * `response` - The [`Response`] returned by the commit handler.
+ fn display_real_commit_response(&self, response: Response) {
+ let stat = DiffStat::from(response.changes.as_ref());
+ println!(
+ "[{}] {}",
+ response
+ .commit_hash
+ .unwrap_or_default()
+ .get(..7)
+ .unwrap_or("-"),
+ response.commit.message.cyan()
+ );
+ println!("{}", stat.summary_string());
+ for change in response.changes {
+ match change.kind {
+ FileChangeKind::Added { new_path, mode, .. } => match mode {
+ Some(mode) => println!(
+ "{} mode {:o} {}",
+ "create".green(),
+ mode,
+ new_path.display()
+ ),
+ None => println!("create {}", new_path.display()),
+ },
+ FileChangeKind::Deleted { old_path, mode, .. } => match mode {
+ Some(mode) => {
+ println!("{} mode {:o} {}", "delete".red(), mode, old_path.display())
+ }
+ None => println!("delete {}", old_path.display()),
+ },
+ FileChangeKind::Modified { .. } => {}
+ }
+ }
+ }
+
+ /// Displays the results of a dry-run commit.
+ ///
+ /// Shows which files *would* be committed, but does not perform
+ /// any actual repository changes.
+ ///
+ /// # Arguments
+ /// * `response` - The [`Response`] produced by the commit handler during a dry run.
+ fn display_dry_run_response(&self, response: Response) {
+ println!("Changes to be committed:");
+ for change in response.changes {
+ match change.kind {
+ FileChangeKind::Added { new_path, .. } => {
+ println!("\t{} {}", "new file".green(), new_path.display().green());
+ }
+ FileChangeKind::Deleted { old_path, .. } => {
+ println!("\t{} {}", "deleted".red(), old_path.display().red());
+ }
+ FileChangeKind::Modified { new_path, .. } => {
+ println!("\t{} {}", "modified".yellow(), new_path.display().yellow());
+ }
+ };
+ }
+ }
+}
+
+#[async_trait]
+impl MevaCommand for CommitCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "commit"
+ }
+
+ fn about(&self) -> &'static str {
+ "Create a new commit object containing the current stage contents and message"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `commit` command using `clap`.
+ ///
+ /// Adds the following options and flags:
+ /// - `-m, --message `: Commit message describing the changes.
+ /// - `--author `: Override the default author (`"Name "` format).
+ /// - `-n, --dry-run`: Show what would be committed without actually creating the commit.
+ /// - `--amend`: Amend the tip of the current branch instead of creating a new commit.
+ /// - `-a, --all`: Stage all modified and deleted files before committing.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_MESSAGE)
+ .value_name("MESSAGE")
+ .short('m')
+ .long(Self::ARG_MESSAGE)
+ .help("Commit message describing the changes")
+ .required(true),
+ )
+ .arg(
+ Arg::new(Self::ARG_AUTHOR)
+ .value_name("AUTHOR")
+ .long(Self::ARG_AUTHOR)
+ .help("Override the default author (format: \"Name Surname \")")
+ .value_parser(clap::value_parser!(Person)),
+ )
+ .arg(
+ Arg::new(Self::ARG_DRY_RUN)
+ .value_name("DRY_RUN")
+ .short('n')
+ .long(Self::ARG_DRY_RUN)
+ .help("Show what would be committed without creating a commit")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_AMEND)
+ .value_name("AMEND")
+ .long(Self::ARG_AMEND)
+ .help("Amend the tip of the current branch instead of creating a new commit")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_ALL)
+ .value_name("ALL")
+ .short('a')
+ .long(Self::ARG_ALL)
+ .help("Stage all modified and deleted files before committing")
+ .action(ArgAction::SetTrue),
+ )
+ }
+
+ /// Executes the `commit` command.
+ ///
+ /// Reads the provided CLI options (message, author, etc.) and performs
+ /// the necessary repository operations:
+ ///
+ /// * If the `--all` flag is set, stages all modified and deleted files
+ /// before creating the commit.
+ /// * Builds a [`Request`] using the collected arguments
+ /// (message, author, date, dry-run, amend).
+ /// * Invokes the commit handler to either create the commit
+ /// or show a preview when `--dry-run` is used.
+ ///
+ /// # Returns
+ /// * [`miette::Result`]: Indicates success or a diagnostic error if the commit operation fails.
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let message = matches.get_one::(Self::ARG_MESSAGE).unwrap();
+ let author = matches.get_one::(Self::ARG_AUTHOR);
+ let all_arg = matches.get_flag(Self::ARG_ALL);
+ let dry_run = matches.get_flag(Self::ARG_DRY_RUN);
+ let amend = matches.get_flag(Self::ARG_AMEND);
+
+ let interceptor = container.plugins_interceptor().into_diagnostic()?;
+
+ if all_arg {
+ let add_handler = container.add_handler().into_diagnostic()?;
+ let add_request = AddRequest {
+ all_flag: true,
+ force_flag: false,
+ update_flag: false,
+ dry_run_flag: false,
+ verbose_flag: false,
+ path_arg: None,
+ };
+ add_handler
+ .handle_add(add_request, &interceptor)
+ .into_diagnostic()?;
+ }
+
+ let commit_request = Request {
+ dry_run,
+ amend,
+ message: message.clone(),
+ author: author.cloned(),
+ };
+
+ let commit_handler = container.commit_handler(dry_run).into_diagnostic()?;
+
+ let response = match commit_handler.handle_commit(commit_request, &interceptor) {
+ Ok(val) => val,
+ Err(err @ EngineError::Commit(CommitError::NothingToCommit)) => {
+ println!("{}", err.yellow());
+ return Ok(());
+ }
+ Err(e) => return Err(miette::miette!(e)),
+ };
+
+ match response.commit_hash {
+ None => self.display_dry_run_response(response),
+ Some(_) => self.display_real_commit_response(response),
+ }
+
+ Ok(())
+ }
+}
diff --git a/cli/src/commands/config.rs b/cli/src/commands/config.rs
new file mode 100644
index 00000000..63da9401
--- /dev/null
+++ b/cli/src/commands/config.rs
@@ -0,0 +1,69 @@
+pub mod subcommands;
+
+use crate::commands::{MevaCommand, execute_multiple};
+
+use async_trait::async_trait;
+use clap::ArgMatches;
+use engine::engine_container::MevaContainer;
+use miette::Result;
+use subcommands::*;
+
+/// Implements the `config` command for Meva DVCS.
+///
+/// Serves as a namespace for configuration-related subcommands:
+/// list, get, set, unset, and edit settings at global/local/file scopes.
+#[derive(Default)]
+pub struct ConfigCommand;
+
+#[async_trait]
+impl MevaCommand for ConfigCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "config"
+ }
+
+ fn about(&self) -> &'static str {
+ "Manage Meva configuration (system, global, or local)"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Define the set of subcommands under `config` namespace.
+ ///
+ /// Returns boxed instances of each config operation command.
+ fn subcommands(&self) -> Vec>> {
+ vec![
+ Box::new(ConfigListCommand),
+ Box::new(ConfigGetCommand),
+ Box::new(ConfigSetCommand),
+ Box::new(ConfigUnsetCommand),
+ Box::new(ConfigEditCommand),
+ Box::new(ConfigCreateCommand),
+ ]
+ }
+
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ execute_multiple(matches, container, self.subcommands()).await
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = ConfigCommand;
+ assert_eq!(cmd.name(), "config");
+ assert_eq!(
+ cmd.about(),
+ "Manage Meva configuration (system, global, or local)"
+ );
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/config/subcommands.rs b/cli/src/commands/config/subcommands.rs
new file mode 100644
index 00000000..18411eea
--- /dev/null
+++ b/cli/src/commands/config/subcommands.rs
@@ -0,0 +1,13 @@
+pub mod create;
+pub mod edit;
+pub mod get;
+pub mod list;
+pub mod set;
+pub mod unset;
+
+pub use create::ConfigCreateCommand;
+pub use edit::ConfigEditCommand;
+pub use get::ConfigGetCommand;
+pub use list::ConfigListCommand;
+pub use set::ConfigSetCommand;
+pub use unset::ConfigUnsetCommand;
diff --git a/cli/src/commands/config/subcommands/create.rs b/cli/src/commands/config/subcommands/create.rs
new file mode 100644
index 00000000..ffe397a5
--- /dev/null
+++ b/cli/src/commands/config/subcommands/create.rs
@@ -0,0 +1,70 @@
+use std::path::PathBuf;
+
+use async_trait::async_trait;
+use clap::{ArgMatches, Command};
+use engine::EngineContainer;
+use engine::engine_container::MevaContainer;
+use engine::handlers::config::CreateRequest;
+use miette::IntoDiagnostic;
+
+use crate::commands::MevaCommand;
+use crate::extensions::WithFile;
+
+/// Implements the `create` subcommand for Meva configuration management.
+///
+/// Creates a new configuration file at the specified path or the default global location.
+#[derive(Default)]
+pub struct ConfigCreateCommand;
+
+#[async_trait]
+impl MevaCommand for ConfigCreateCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "create"
+ }
+
+ fn about(&self) -> &'static str {
+ "Create a new configuration file"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_file_arg("Path to the configuration file to create")
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let file = matches.get_one::(Command::ARG_FILE);
+
+ let request = CreateRequest {
+ file: file.cloned(),
+ };
+
+ let config_handler = container.config_handler().into_diagnostic()?;
+ config_handler.handle_create(request).into_diagnostic()?;
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = ConfigCreateCommand;
+ assert_eq!(cmd.name(), "create");
+ assert_eq!(cmd.about(), "Create a new configuration file");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/config/subcommands/edit.rs b/cli/src/commands/config/subcommands/edit.rs
new file mode 100644
index 00000000..cacbbae2
--- /dev/null
+++ b/cli/src/commands/config/subcommands/edit.rs
@@ -0,0 +1,76 @@
+use async_trait::async_trait;
+use clap::{ArgMatches, Command};
+use engine::engine_container::MevaContainer;
+use engine::{ConfigDocument, ConfigLoader, MevaConfigLoader};
+use miette::{Context, IntoDiagnostic};
+use shared::OpenInEditor;
+
+use crate::commands::MevaCommand;
+use crate::extensions::{LocationSelection, WithLocations};
+
+/// Implements the `edit` subcommand for Meva configuration management.
+///
+/// Opens the chosen configuration file in the user's preferred editor,
+/// respecting any `editor.default` override in config or falling back to OS defaults.
+#[derive(Default)]
+pub struct ConfigEditCommand;
+
+#[async_trait]
+impl MevaCommand for ConfigEditCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "edit"
+ }
+
+ fn about(&self) -> &'static str {
+ "Open the config file in your default editor"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command().with_location_args(
+ "Use the global (user) config file",
+ "Use the repository-local config file",
+ "Path to an arbitrary config file",
+ )
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ _container: &Self::Container,
+ ) -> miette::Result<()> {
+ let loader = MevaConfigLoader::default();
+ let override_cmd = loader.get("editor.default", None).ok();
+ let location = matches
+ .get_config_location()
+ .get_default_path()
+ .into_diagnostic()
+ .wrap_err("Failed to determine configuration file path")?;
+
+ ConfigDocument::validate_existing_file(&location).into_diagnostic()?;
+
+ location.open_in_editor(override_cmd).into_diagnostic()?;
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = ConfigEditCommand;
+ assert_eq!(cmd.name(), "edit");
+ assert_eq!(cmd.about(), "Open the config file in your default editor");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/config/subcommands/get.rs b/cli/src/commands/config/subcommands/get.rs
new file mode 100644
index 00000000..3eeaf040
--- /dev/null
+++ b/cli/src/commands/config/subcommands/get.rs
@@ -0,0 +1,101 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgMatches, Command};
+use engine::EngineContainer;
+use engine::engine_container::MevaContainer;
+use engine::handlers::config::GetRequest;
+use miette::IntoDiagnostic;
+
+use crate::commands::MevaCommand;
+use crate::extensions::{LocationSelection, WithLocations};
+
+#[derive(Default)]
+pub struct ConfigGetCommand;
+
+/// Implements the `get` subcommand for Meva configuration management.
+///
+/// Retrieves the value of a specified TOML key from the chosen
+/// configuration scope, with an optional default fallback if the key is missing.
+impl ConfigGetCommand {
+ const ARG_KEY: &'static str = "key";
+
+ const ARG_DEFAULT: &'static str = "default";
+}
+
+#[async_trait]
+impl MevaCommand for ConfigGetCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "get"
+ }
+
+ fn about(&self) -> &'static str {
+ "Get the value for a given configuration key"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_location_args(
+ "Use the global (user) config file",
+ "Use the repository-local config file",
+ "Path to an arbitrary config file",
+ )
+ .arg(
+ Arg::new(Self::ARG_KEY)
+ .value_name("KEY")
+ .help("TOML path to the config entry")
+ .required(true)
+ .index(1),
+ )
+ .arg(
+ Arg::new(Self::ARG_DEFAULT)
+ .short('d')
+ .long("default")
+ .value_name("DEFAULT")
+ .help("Default value if entry is missing"),
+ )
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let location = matches.get_config_location();
+ let key = matches.get_one::(Self::ARG_KEY).unwrap();
+ let default = matches.get_one::(Self::ARG_DEFAULT);
+
+ let config_handler = container.config_handler().into_diagnostic()?;
+
+ let request = GetRequest {
+ location,
+ key: key.clone(),
+ default: default.cloned(),
+ };
+
+ let response = config_handler.handle_get(request).into_diagnostic()?;
+
+ println!("{}", response.value);
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = ConfigGetCommand;
+ assert_eq!(cmd.name(), "get");
+ assert_eq!(cmd.about(), "Get the value for a given configuration key");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/config/subcommands/list.rs b/cli/src/commands/config/subcommands/list.rs
new file mode 100644
index 00000000..4246f604
--- /dev/null
+++ b/cli/src/commands/config/subcommands/list.rs
@@ -0,0 +1,93 @@
+use async_trait::async_trait;
+use clap::{ArgMatches, Command};
+use engine::EngineContainer;
+use engine::engine_container::MevaContainer;
+use engine::handlers::config::ListRequest;
+use miette::IntoDiagnostic;
+use owo_colors::OwoColorize;
+
+use crate::commands::MevaCommand;
+use crate::extensions::{LocationSelection, WithLocations};
+
+/// Implements the `list` subcommand for Meva configuration management.
+///
+/// Retrieves and displays all key/value pairs from the selected
+/// configuration scope.
+#[derive(Default)]
+pub struct ConfigListCommand;
+
+#[async_trait]
+impl MevaCommand for ConfigListCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "list"
+ }
+
+ fn about(&self) -> &'static str {
+ "Print all available configuration entries"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command().with_location_args(
+ "Use the global (user) config file",
+ "Use the repository-local config file",
+ "Path to an arbitrary config file",
+ )
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let location = matches.get_config_location();
+
+ let config_handler = container.config_handler().into_diagnostic()?;
+
+ let request = ListRequest { location };
+
+ let response = config_handler.handle_list(request).into_diagnostic()?;
+
+ if response.key_values.is_empty() {
+ println!(
+ "{}",
+ "Config file has no key-value pairs to display.".yellow()
+ );
+ }
+
+ let max_key_len = response
+ .key_values
+ .iter()
+ .map(|(k, _)| k.len())
+ .max()
+ .unwrap_or(0);
+
+ for (key, value) in response.key_values {
+ let padded_key = format!("{key: &'static str {
+ "set"
+ }
+
+ fn about(&self) -> &'static str {
+ "Set the value for a given configuration key"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_location_args(
+ "Use the global (user) config file",
+ "Use the repository-local config file",
+ "Path to an arbitrary config file",
+ )
+ .with_key_arg("TOML path to the config entry")
+ .arg(
+ Arg::new(Self::ARG_VALUE)
+ .value_name("VALUE")
+ .help("Value to assign")
+ .required(true)
+ .index(2),
+ )
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let key = matches.get_one::(Command::ARG_KEY).unwrap();
+ let value = matches.get_one::(Self::ARG_VALUE).unwrap();
+ let location = matches.get_config_location();
+
+ let config_handler = container.config_handler().into_diagnostic()?;
+ let interceptor = container.plugins_interceptor().into_diagnostic()?;
+
+ let request = SetRequest {
+ location,
+ key: key.clone(),
+ value: value.clone(),
+ };
+
+ let response = config_handler
+ .handle_set(request, &interceptor)
+ .into_diagnostic()?;
+
+ println!(
+ "{} {} {}",
+ response.key.green().bold(),
+ "=".dimmed(),
+ response.value
+ );
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = ConfigSetCommand;
+ assert_eq!(cmd.name(), "set");
+ assert_eq!(cmd.about(), "Set the value for a given configuration key");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/config/subcommands/unset.rs b/cli/src/commands/config/subcommands/unset.rs
new file mode 100644
index 00000000..76aa1bc6
--- /dev/null
+++ b/cli/src/commands/config/subcommands/unset.rs
@@ -0,0 +1,82 @@
+use async_trait::async_trait;
+use clap::{ArgMatches, Command};
+use engine::EngineContainer;
+use engine::engine_container::MevaContainer;
+use engine::handlers::config::UnsetRequest;
+use miette::IntoDiagnostic;
+
+use crate::commands::MevaCommand;
+use crate::extensions::{LocationSelection, WithKey, WithLocations};
+
+/// Implements the `unset` subcommand for Meva configuration management.
+///
+/// Removes a specified TOML key from the chosen configuration scope.
+#[derive(Default)]
+pub struct ConfigUnsetCommand;
+
+#[async_trait]
+impl MevaCommand for ConfigUnsetCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "unset"
+ }
+
+ fn about(&self) -> &'static str {
+ "Remove a configuration entry"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_location_args(
+ "Use the global (user) config file",
+ "Use the repository-local config file",
+ "Path to an arbitrary config file",
+ )
+ .with_key_arg("TOML path to the config entry")
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let key = matches.get_one::(Command::ARG_KEY).unwrap();
+ let location = matches.get_config_location();
+
+ let config_handler = container.config_handler().into_diagnostic()?;
+ let interceptor = container.plugins_interceptor().into_diagnostic()?;
+
+ let request = UnsetRequest {
+ location,
+ key: key.clone(),
+ };
+
+ let response = config_handler
+ .handle_unset(request, &interceptor)
+ .into_diagnostic()?;
+
+ println!("{}", response.value);
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = ConfigUnsetCommand;
+ assert_eq!(cmd.name(), "unset");
+ assert_eq!(cmd.about(), "Remove a configuration entry");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/diff.rs b/cli/src/commands/diff.rs
new file mode 100644
index 00000000..91288fac
--- /dev/null
+++ b/cli/src/commands/diff.rs
@@ -0,0 +1,192 @@
+use std::path::PathBuf;
+
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command, value_parser};
+use engine::{
+ EngineContainer,
+ diff_builder::DiffMode,
+ engine_container::MevaContainer,
+ handlers::diff::{Request, Response},
+ revision_parsing::Revision,
+};
+
+use miette::{IntoDiagnostic, Result};
+use shared::PathToString;
+
+use crate::commands::MevaCommand;
+
+/// Implements the `diff` command for Meva DVCS.
+///
+/// Shows changes between commits, the index, and the working tree.
+#[derive(Default)]
+pub struct DiffCommand;
+
+impl DiffCommand {
+ /// Argument name for the `--cached` flag.
+ /// When set, the command compares the index to the specified commit (default: HEAD).
+ const ARG_CACHED: &'static str = "cached";
+
+ /// Argument name for the `--name-only` flag.
+ /// When set, only the names of changed files are printed, not their contents.
+ const ARG_NAME_ONLY: &'static str = "name-only";
+
+ /// Argument name for the `--stat` flag.
+ /// When set, print a summary diffstat instead of the full diff output.
+ const ARG_STAT: &'static str = "stat";
+
+ /// Positional argument name for the first revision/range.
+ /// Examples: `HEAD`, `HEAD~1`, a commit id, or other revision expressions.
+ const ARG_RANGE1: &'static str = "range1";
+
+ /// Positional argument name for the second revision/range.
+ /// When present, the diff is shown between RANGE1 and RANGE2.
+ const ARG_RANGE2: &'static str = "range2";
+
+ /// Positional argument name for paths limiting the diff.
+ /// Any number of paths can be provided; use `--` to separate ranges from paths.
+ const ARG_PATHS: &'static str = "paths";
+
+ /// Displays the diff response based on the selected DiffMode.
+ ///
+ /// Provides different output formats depending on the requested comparison type.
+ fn display_response(&self, mode: &DiffMode, response: &Response) {
+ match mode {
+ DiffMode::NameOnly => {
+ if let Some(files) = &response.files {
+ for file in files {
+ println!("{}", file.path().to_utf8_string());
+ }
+ }
+ }
+ DiffMode::Stat => {
+ if let Some(stat) = &response.stat {
+ println!("{stat}")
+ }
+ }
+ DiffMode::Full => {
+ if let Some(files) = &response.files {
+ for file in files {
+ file.display_full();
+ }
+ }
+ }
+ }
+ }
+}
+
+#[async_trait]
+impl MevaCommand for DiffCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "diff"
+ }
+
+ fn about(&self) -> &'static str {
+ "Show changes between commits, the index, and the working tree"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `diff` command using `clap`.
+ ///
+ /// Adds flags and positional arguments with helpful descriptions and value
+ /// parsers. The positional revision arguments use the `Revision` parser
+ /// defined in the `engine::revision_parsing` module.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_CACHED)
+ .short('c')
+ .long(Self::ARG_CACHED)
+ .action(ArgAction::SetTrue)
+ .help("Compare the index to the specified commit (default: HEAD). If HEAD doesn't exist, show all changes")
+ )
+ .arg(
+ Arg::new(Self::ARG_NAME_ONLY)
+ .short('n')
+ .long(Self::ARG_NAME_ONLY)
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_STAT)
+ .help("Show only names of changed files")
+ )
+ .arg(
+ Arg::new(Self::ARG_STAT)
+ .short('s')
+ .long(Self::ARG_STAT)
+ .action(ArgAction::SetTrue)
+ .help("Show summary diffstat instead of the full diff")
+ )
+ .arg(
+ Arg::new(Self::ARG_RANGE1)
+ .value_name("RANGE1")
+ .index(1)
+ .value_parser(value_parser!(Revision))
+ .required(false)
+ .help("First range (e.g. commit, HEAD, HEAD~1)")
+ )
+ .arg(
+ Arg::new(Self::ARG_RANGE2)
+ .value_name("RANGE2")
+ .index(2)
+ .value_parser(value_parser!(Revision))
+ .required(false)
+ .help("Second range (e.g. commit)")
+ )
+ .arg(
+ Arg::new(Self::ARG_PATHS)
+ .value_name("PATHS")
+ .index(3)
+ .num_args(0..)
+ .value_parser(value_parser!(PathBuf))
+ .last(true)
+ .help("Limit the diff to the given paths (use -- to separate ranges from paths)")
+ )
+ }
+
+ /// Executes the `diff` command.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ let cached = matches.get_flag(Self::ARG_CACHED);
+ let from = matches.get_one::(Self::ARG_RANGE1);
+ let to = matches.get_one::(Self::ARG_RANGE2);
+ let paths = matches
+ .get_many::(Self::ARG_PATHS)
+ .map(|vals| vals.cloned().collect::>());
+
+ let mode = if matches.get_flag(Self::ARG_NAME_ONLY) {
+ DiffMode::NameOnly
+ } else if matches.get_flag(Self::ARG_STAT) {
+ DiffMode::Stat
+ } else {
+ DiffMode::Full
+ };
+
+ let request = Request::new(from.cloned(), to.cloned(), cached, mode, paths);
+
+ let handler = container.diff_handler().into_diagnostic()?;
+ let response = handler.handle_diff(request).into_diagnostic()?;
+ self.display_response(&mode, &response);
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = DiffCommand;
+ assert_eq!(cmd.name(), "diff");
+ assert_eq!(
+ cmd.about(),
+ "Show changes between commits, the index, and the working tree"
+ );
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/fetch.rs b/cli/src/commands/fetch.rs
new file mode 100644
index 00000000..1fcf28eb
--- /dev/null
+++ b/cli/src/commands/fetch.rs
@@ -0,0 +1,113 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command};
+use engine::{EngineContainer, engine_container::MevaContainer, handlers::fetch::Request};
+
+use miette::{IntoDiagnostic, Result};
+
+use crate::{commands::MevaCommand, extensions::WithVerbose};
+
+/// Represents the `fetch` command in the CLI.
+///
+/// This command is responsible for downloading objects and references from a remote
+/// repository. It serves as the entry point for the fetch logic, handling argument
+/// parsing and delegating the execution to the appropriate engine handler.
+#[derive(Default)]
+pub struct FetchCommand;
+
+impl FetchCommand {
+ /// The name of the argument used to specify the prune flag.
+ const ARG_PRUNE: &'static str = "prune";
+
+ /// The name of the argument used to specify the remote origin.
+ const ARG_ORIGIN: &'static str = "origin";
+
+ /// The name of the argument used to specify a specific branch.
+ const ARG_BRANCH: &'static str = "branch";
+}
+
+#[async_trait]
+impl MevaCommand for FetchCommand {
+ type Container = MevaContainer;
+
+ /// Returns the name of the command as invoked from the command line.
+ fn name(&self) -> &'static str {
+ "fetch"
+ }
+
+ /// Returns a brief description of the command's purpose, displayed in help messages.
+ fn about(&self) -> &'static str {
+ "Download objects and refs from a remote repository"
+ }
+
+ /// Returns the current version of the command.
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `fetch` command using `clap`.
+ ///
+ /// This method defines the accepted arguments:
+ /// - `[ORIGIN]`: The remote repository to fetch from (defaults to "origin").
+ /// - `[BRANCH]`: An optional specific branch to fetch.
+ /// - `--prune` (`-p`): A flag to remove remote-tracking branches that no longer exist on the remote.
+ /// - `--verbose`: Inherited from `WithVerbose` extension.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_ORIGIN)
+ .value_name("ORIGIN")
+ .index(1)
+ .required(false)
+ .default_value("origin")
+ .help("Remote name to fetch from"),
+ )
+ .arg(
+ Arg::new(Self::ARG_BRANCH)
+ .value_name("BRANCH")
+ .index(2)
+ .required(false)
+ .help("Branch to fetch"),
+ )
+ .arg(
+ Arg::new(Self::ARG_PRUNE)
+ .long(Self::ARG_PRUNE)
+ .short('p')
+ .action(ArgAction::SetTrue)
+ .help("Remove remote-tracking branches that no longer exist on the remote"),
+ )
+ .with_verbose_arg("Enable verbose output")
+ }
+
+ /// Executes the `fetch` command logic.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ let request = Request {
+ origin: matches.get_one::(Self::ARG_ORIGIN).unwrap().clone(),
+ branch: matches.get_one::(Self::ARG_BRANCH).cloned(),
+ prune: matches.get_flag(Self::ARG_PRUNE),
+ verbose: matches.get_flag(Command::ARG_VERBOSE),
+ };
+
+ let handler = container.fetch_handler().into_diagnostic()?;
+ let _ = handler.handle_fetch(request).await.into_diagnostic()?;
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = FetchCommand;
+ assert_eq!(cmd.name(), "fetch");
+ assert_eq!(
+ cmd.about(),
+ "Download objects and refs from a remote repository"
+ );
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/ignore.rs b/cli/src/commands/ignore.rs
new file mode 100644
index 00000000..0554c370
--- /dev/null
+++ b/cli/src/commands/ignore.rs
@@ -0,0 +1,67 @@
+pub mod subcommands;
+
+use crate::commands::{MevaCommand, execute_multiple};
+
+use async_trait::async_trait;
+use clap::ArgMatches;
+use engine::engine_container::MevaContainer;
+use miette::Result;
+use subcommands::*;
+
+/// Implements the `ignore` command for Meva DVCS.
+///
+/// Serves as a namespace for subcommands managing ignore patterns:
+/// add, remove, check, and edit ignore rules for files and directories.
+#[derive(Default)]
+pub struct IgnoreCommand;
+
+#[async_trait]
+impl MevaCommand for IgnoreCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "ignore"
+ }
+
+ fn about(&self) -> &'static str {
+ "Manage ignore patterns for files and directories"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Define the set of subcommands under `ignore` namespace.
+ ///
+ /// Returns boxed instances of each ignore operation command.
+ fn subcommands(&self) -> Vec>> {
+ vec![
+ Box::new(IgnoreAddCommand),
+ Box::new(IgnoreCheckCommand),
+ Box::new(IgnoreEditCommand),
+ Box::new(IgnoreRemoveCommand),
+ ]
+ }
+
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ execute_multiple(matches, container, self.subcommands()).await
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = IgnoreCommand;
+ assert_eq!(cmd.name(), "ignore");
+ assert_eq!(
+ cmd.about(),
+ "Manage ignore patterns for files and directories"
+ );
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/ignore/subcommands.rs b/cli/src/commands/ignore/subcommands.rs
new file mode 100644
index 00000000..26a70046
--- /dev/null
+++ b/cli/src/commands/ignore/subcommands.rs
@@ -0,0 +1,9 @@
+pub mod add;
+pub mod check;
+pub mod edit;
+pub mod remove;
+
+pub use add::IgnoreAddCommand;
+pub use check::IgnoreCheckCommand;
+pub use edit::IgnoreEditCommand;
+pub use remove::IgnoreRemoveCommand;
diff --git a/cli/src/commands/ignore/subcommands/add.rs b/cli/src/commands/ignore/subcommands/add.rs
new file mode 100644
index 00000000..214db6f9
--- /dev/null
+++ b/cli/src/commands/ignore/subcommands/add.rs
@@ -0,0 +1,84 @@
+use std::path::PathBuf;
+
+use async_trait::async_trait;
+use clap::{ArgMatches, Command};
+use engine::{
+ IgnoreOperations, IgnoreService, RepositoryLayout, engine_container::MevaContainer,
+ repositories::meva_repository_layout::MevaRepositoryLayout,
+};
+use globset::Glob;
+use miette::IntoDiagnostic;
+use owo_colors::OwoColorize;
+use shared::PathToString;
+
+use crate::{
+ commands::MevaCommand,
+ extensions::{WithFile, WithPattern},
+};
+
+/// Implements the `add` subcommand for Meva ignored files management.
+///
+/// Adds the specified pattern to the chosen ignore file,
+/// ensuring the ignore rule is appended without duplicates or formatting errors.
+#[derive(Default)]
+pub struct IgnoreAddCommand;
+
+#[async_trait]
+impl MevaCommand for IgnoreAddCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "add"
+ }
+
+ fn about(&self) -> &'static str {
+ "Appends a pattern to the ignore file"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_pattern_arg("Pattern to append to the ignore file")
+ .with_file_arg("Path to a specific ignore file")
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ _container: &Self::Container,
+ ) -> miette::Result<()> {
+ let pattern = matches.get_one::(Command::ARG_PATTERN).unwrap();
+ let file = matches.get_one::(Command::ARG_FILE);
+
+ let layout = MevaRepositoryLayout::from_env().into_diagnostic()?;
+ let ignore_service = IgnoreService::new(layout.ignore_file_name());
+
+ let result_path = ignore_service.add(pattern, file).into_diagnostic()?;
+
+ println!(
+ "Pattern '{}' appended to {}",
+ pattern.green(),
+ result_path.to_utf8_string().cyan()
+ );
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = IgnoreAddCommand;
+ assert_eq!(cmd.name(), "add");
+ assert_eq!(cmd.about(), "Appends a pattern to the ignore file");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/ignore/subcommands/check.rs b/cli/src/commands/ignore/subcommands/check.rs
new file mode 100644
index 00000000..542b5443
--- /dev/null
+++ b/cli/src/commands/ignore/subcommands/check.rs
@@ -0,0 +1,129 @@
+use std::path::{Path, PathBuf};
+
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command};
+use engine::{
+ IgnoreOperations, IgnoreResult, IgnoreService, RepositoryLayout,
+ engine_container::MevaContainer, repositories::meva_repository_layout::MevaRepositoryLayout,
+};
+use miette::IntoDiagnostic;
+
+use crate::{commands::MevaCommand, extensions::WithFile};
+
+/// Implements the `check` subcommand for Meva ignored files management.
+///
+/// Checks whether the specified path is ignored according to the rules of the chosen ignore file,
+/// optionally providing an explanation of which patterns matched.
+#[derive(Default)]
+pub struct IgnoreCheckCommand;
+
+impl IgnoreCheckCommand {
+ const ARG_PATH: &'static str = "path";
+
+ const ARG_EXPLAIN: &'static str = "explain";
+
+ #[allow(dead_code)]
+ fn print_check_result(result: &IgnoreResult, checked_path: &Path, explain: bool) {
+ match result {
+ IgnoreResult::Ignored { patterns, path } => {
+ if explain {
+ println!(
+ "'{}' is ignored by the following pattern{} in {}:",
+ checked_path.to_string_lossy(),
+ if patterns.len() == 1 { "" } else { "s" },
+ path.to_string_lossy()
+ );
+ for pattern in patterns {
+ println!("{pattern}");
+ }
+ } else {
+ println!("ignored");
+ }
+ }
+ IgnoreResult::NotIgnored { path } => {
+ if explain {
+ println!(
+ "'{}' is not ignored by {}",
+ checked_path.to_string_lossy(),
+ path.to_string_lossy()
+ );
+ } else {
+ println!("not ignored");
+ }
+ }
+ }
+ }
+}
+
+#[async_trait]
+impl MevaCommand for IgnoreCheckCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "check"
+ }
+
+ fn about(&self) -> &'static str {
+ "Check if a path is ignored by the rules of the ignore file"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_file_arg("Path to a specific ignore file")
+ .arg(
+ Arg::new(Self::ARG_EXPLAIN)
+ .short('e')
+ .long(Self::ARG_EXPLAIN)
+ .help("Explain why the path is ignored")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_PATH)
+ .value_name("PATH")
+ .help("Path to check for ignore rule match")
+ .value_parser(clap::value_parser!(PathBuf))
+ .index(1),
+ )
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ _container: &Self::Container,
+ ) -> miette::Result<()> {
+ let file = matches.get_one::(Command::ARG_FILE);
+ let explain = matches.get_flag(Self::ARG_EXPLAIN);
+ let checked_path = matches.get_one::(Self::ARG_PATH).unwrap();
+
+ let layout = MevaRepositoryLayout::from_env().into_diagnostic()?;
+ let ignore_service = IgnoreService::new(layout.ignore_file_name());
+
+ let ignore_result = ignore_service.check(checked_path, file).into_diagnostic()?;
+
+ Self::print_check_result(&ignore_result, checked_path, explain);
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = IgnoreCheckCommand;
+ assert_eq!(cmd.name(), "check");
+ assert_eq!(
+ cmd.about(),
+ "Check if a path is ignored by the rules of the ignore file"
+ );
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/ignore/subcommands/edit.rs b/cli/src/commands/ignore/subcommands/edit.rs
new file mode 100644
index 00000000..579bbaa7
--- /dev/null
+++ b/cli/src/commands/ignore/subcommands/edit.rs
@@ -0,0 +1,79 @@
+use std::path::PathBuf;
+
+use async_trait::async_trait;
+use clap::{ArgMatches, Command};
+use engine::{
+ ConfigLoader, IgnoreOperations, IgnoreService, MevaConfigLoader, RepositoryLayout,
+ engine_container::MevaContainer, repositories::meva_repository_layout::MevaRepositoryLayout,
+};
+use miette::IntoDiagnostic;
+use shared::OpenInEditor;
+
+use crate::{commands::MevaCommand, extensions::WithFile};
+
+/// Implements the `edit` subcommand for Meva ignored files management.
+///
+/// Opens the chosen configuration file in the user's preferred editor,
+/// respecting any `editor.default` override in config or falling back to OS defaults.
+#[derive(Default)]
+pub struct IgnoreEditCommand;
+
+#[async_trait]
+impl MevaCommand for IgnoreEditCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "edit"
+ }
+
+ fn about(&self) -> &'static str {
+ "Open the ignore file in your default editor"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_file_arg("Path to a specific ignore file")
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ _container: &Self::Container,
+ ) -> miette::Result<()> {
+ let file = matches.get_one::(Command::ARG_FILE);
+
+ let layout = MevaRepositoryLayout::from_env().into_diagnostic()?;
+ let ignore_service = IgnoreService::new(layout.ignore_file_name());
+
+ let loader = MevaConfigLoader::default();
+ let override_cmd = loader.get("editor.default", None).ok();
+
+ let ignore_file = match file {
+ Some(p) => p.to_path_buf(),
+ None => ignore_service.find_ignore_file(None).into_diagnostic()?,
+ };
+
+ ignore_file.open_in_editor(override_cmd).into_diagnostic()?;
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = IgnoreEditCommand;
+ assert_eq!(cmd.name(), "edit");
+ assert_eq!(cmd.about(), "Open the ignore file in your default editor");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/ignore/subcommands/remove.rs b/cli/src/commands/ignore/subcommands/remove.rs
new file mode 100644
index 00000000..f0b8d408
--- /dev/null
+++ b/cli/src/commands/ignore/subcommands/remove.rs
@@ -0,0 +1,94 @@
+use std::path::PathBuf;
+
+use async_trait::async_trait;
+use clap::{ArgMatches, Command};
+use engine::{
+ IgnoreOperations, IgnoreService, RepositoryLayout, engine_container::MevaContainer,
+ repositories::meva_repository_layout::MevaRepositoryLayout,
+};
+use globset::Glob;
+use miette::IntoDiagnostic;
+
+use crate::{
+ commands::MevaCommand,
+ extensions::{WithFile, WithPattern},
+};
+
+/// Implements the `remove` subcommand for Meva ignored files management.
+///
+/// Removes the specified pattern from the chosen ignore file,
+/// reporting how many lines were deleted or if the pattern was not present.
+#[derive(Default)]
+pub struct IgnoreRemoveCommand;
+
+#[async_trait]
+impl MevaCommand for IgnoreRemoveCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "remove"
+ }
+
+ fn about(&self) -> &'static str {
+ "Remove a pattern from the ignore file"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_pattern_arg("Pattern to remove from the ignore file")
+ .with_file_arg("Path to a specific ignore file")
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ _container: &Self::Container,
+ ) -> miette::Result<()> {
+ let pattern = matches.get_one::(Command::ARG_PATTERN).unwrap();
+ let file = matches.get_one::(Command::ARG_FILE);
+
+ let layout = MevaRepositoryLayout::from_env().into_diagnostic()?;
+ let ignore_service = IgnoreService::new(layout.ignore_file_name());
+
+ let (result_path, removed_patterns) =
+ ignore_service.remove(pattern, file).into_diagnostic()?;
+
+ if removed_patterns.is_empty() {
+ println!(
+ "No lines matching “{}” were found in {}.",
+ pattern.glob(),
+ result_path.to_string_lossy()
+ );
+ } else {
+ println!(
+ "Removed {} line{} from {}:",
+ removed_patterns.len(),
+ if removed_patterns.len() == 1 { "" } else { "s" },
+ result_path.to_string_lossy()
+ );
+ for pat in &removed_patterns {
+ println!("{pat}");
+ }
+ }
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = IgnoreRemoveCommand;
+ assert_eq!(cmd.name(), "remove");
+ assert_eq!(cmd.about(), "Remove a pattern from the ignore file");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/init.rs b/cli/src/commands/init.rs
new file mode 100644
index 00000000..53ad4cbf
--- /dev/null
+++ b/cli/src/commands/init.rs
@@ -0,0 +1,187 @@
+use std::path::PathBuf;
+
+use async_trait::async_trait;
+use clap::{Arg, ArgMatches, Command, ValueHint};
+use engine::{EngineContainer, engine_container::MevaContainer, handlers::init::Request};
+use miette::{IntoDiagnostic, Result};
+
+use crate::commands::MevaCommand;
+
+/// Implements the `init` command for Meva DVCS.
+///
+/// Initializes a new repository at a specified path,
+/// optionally setting the initial branch name.
+#[derive(Default)]
+pub struct InitCommand;
+
+impl InitCommand {
+ /// Argument name for specifying the initial branch.
+ const ARG_INITIAL_BRANCH: &'static str = "initial-branch";
+
+ /// Argument name for specifying the repository path.
+ const ARG_PATH: &'static str = "path";
+}
+
+#[async_trait]
+impl MevaCommand for InitCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "init"
+ }
+
+ fn about(&self) -> &'static str {
+ "Create an empty Meva repository"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `init` command using `clap`.
+ ///
+ /// Adds two arguments:
+ /// - `-b, --initial-branch `: Name of the initial branch (default: "master")
+ /// - ``: Path to initialize the repository (default: current directory)
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_INITIAL_BRANCH)
+ .short('b')
+ .long(Self::ARG_INITIAL_BRANCH)
+ .value_name("BRANCH")
+ .help("Name of the initial branch")
+ .default_value("master")
+ .require_equals(false),
+ )
+ .arg(
+ Arg::new(Self::ARG_PATH)
+ .value_name("PATH")
+ .help("Path to initialize repository")
+ .default_value(".")
+ .value_parser(clap::value_parser!(PathBuf))
+ .value_hint(ValueHint::FilePath)
+ .index(1),
+ )
+ }
+
+ /// Executes the `init` command.
+ ///
+ /// Initializes a new Meva repository at the specified path using the provided
+ /// initial branch name. If the repository already exists or an error occurs
+ /// during initialization, the error is reported.
+ ///
+ /// # Arguments
+ /// * `matches`: Parsed command-line arguments containing:
+ /// - `initial-branch`: The name of the initial branch (defaults to "master").
+ /// - `path`: The target directory to initialize the repository (defaults to current dir).
+ ///
+ /// # Returns
+ /// * `Result<()>`: Indicates success or detailed error if initialization fails.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ let branch = matches.get_one::(Self::ARG_INITIAL_BRANCH).unwrap();
+ let target = matches.get_one::(Self::ARG_PATH).unwrap();
+
+ let handler = container.init_handler().into_diagnostic()?;
+ let interceptor = container.plugins_interceptor().into_diagnostic()?;
+
+ let request = Request {
+ working_dir: target.clone(),
+ initial_branch: branch.clone(),
+ };
+
+ let response = handler
+ .handle_init(request, &interceptor)
+ .into_diagnostic()?;
+
+ println!(
+ "Repository initialized successfully at: {}",
+ response.repository_dir.to_string_lossy()
+ );
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+ use std::path::PathBuf;
+
+ fn get_matches_from(args: &[&str]) -> ArgMatches {
+ let cmd = InitCommand;
+ cmd.build_command().try_get_matches_from(args).unwrap()
+ }
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = InitCommand;
+ assert_eq!(cmd.name(), "init");
+ assert_eq!(cmd.about(), "Create an empty Meva repository");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+
+ #[rstest]
+ fn test_command_builds_with_expected_args() {
+ let cmd = InitCommand;
+ let clap_cmd = cmd.build_command();
+
+ // Check command name
+ assert_eq!(clap_cmd.get_name(), "init");
+
+ // Check arguments exist
+ assert!(
+ clap_cmd
+ .get_arguments()
+ .any(|a| a.get_id() == InitCommand::ARG_INITIAL_BRANCH)
+ );
+ assert!(
+ clap_cmd
+ .get_arguments()
+ .any(|a| a.get_id() == InitCommand::ARG_PATH)
+ );
+
+ // Check default values for args
+ let branch_arg = clap_cmd
+ .get_arguments()
+ .find(|a| a.get_id() == InitCommand::ARG_INITIAL_BRANCH)
+ .unwrap();
+ assert_eq!(
+ branch_arg.get_default_values().first().map(|v| v.to_str()),
+ Some(Some("master"))
+ );
+
+ let path_arg = clap_cmd
+ .get_arguments()
+ .find(|a| a.get_id() == InitCommand::ARG_PATH)
+ .unwrap();
+ assert_eq!(
+ path_arg.get_default_values().first().map(|v| v.to_str()),
+ Some(Some("."))
+ );
+ }
+
+ #[rstest]
+ #[case(&["init"], "master", ".")]
+ #[case(&["init", "-b", "develop"], "develop", ".")]
+ #[case(&["init", "--initial-branch=feature"], "feature", ".")]
+ #[case(&["init", "-b", "dev", "./repo_path"], "dev", "./repo_path")]
+ #[case(&["init", "./some_path"], "master", "./some_path")]
+ fn test_init_parses_args_correctly(
+ #[case] args: &[&str],
+ #[case] expected_branch: &str,
+ #[case] expected_path: &str,
+ ) {
+ let matches = get_matches_from(args);
+
+ let branch = matches
+ .get_one::(InitCommand::ARG_INITIAL_BRANCH)
+ .unwrap();
+ let path = matches.get_one::(InitCommand::ARG_PATH).unwrap();
+
+ assert_eq!(branch, expected_branch);
+ assert_eq!(path.to_str().unwrap(), expected_path);
+ }
+}
diff --git a/cli/src/commands/log.rs b/cli/src/commands/log.rs
new file mode 100644
index 00000000..9f471ee2
--- /dev/null
+++ b/cli/src/commands/log.rs
@@ -0,0 +1,201 @@
+use crate::commands::MevaCommand;
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command, value_parser};
+use dateparser::DateTimeUtc;
+use engine::EngineContainer;
+use engine::engine_container::MevaContainer;
+use engine::handlers::log::{LogOperations, Request, Response};
+use engine::revision_parsing::Revision;
+use miette::{IntoDiagnostic, Result};
+use owo_colors::OwoColorize;
+use regex::Regex;
+
+/// Implements the `log` command for Meva DVCS.
+///
+/// Displays the repository's branch history, allowing inspection of commit metadata,
+/// messages, and optional change statistics.
+/// Supports flexible output formatting and filtering options, such as compact one-line view,
+/// commit range limits, time-based filters, and pattern matching on commit messages.
+#[derive(Default)]
+pub struct LogCommand;
+
+impl LogCommand {
+ /// Flag for displaying commits in a condensed, one-line format.
+ const ARG_ONELINE: &'static str = "oneline";
+
+ /// Flag for including file-level statistics (added/deleted lines per file).
+ const ARG_STAT: &'static str = "stat";
+
+ /// Argument key for limiting the number of displayed commits.
+ const ARG_MAX_COUNT: &'static str = "max-count";
+
+ /// Skips the first N commits in the history.
+ const ARG_SKIP: &'static str = "skip";
+
+ /// Filters commits created after (and including) the specified date.
+ const ARG_AFTER: &'static str = "after";
+
+ /// Filters commits created before (and including) the specified date.
+ const ARG_BEFORE: &'static str = "before";
+
+ /// Shows only commits with messages matching the provided regular expression.
+ const ARG_GREP: &'static str = "grep";
+
+ /// Restricts output to commits with multiple parents (merge commits).
+ const ARG_MERGES: &'static str = "merges";
+
+ /// Excludes merge commits from the output.
+ const ARG_NO_MERGES: &'static str = "no-merges";
+
+ /// Optional starting revision (e.g., branch, tag, or commit hash).
+ const ARG_REVISION: &'static str = "revision";
+
+ /// Renders the command output in the appropriate format.
+ ///
+ /// Depending on the `oneline` flag, this method prints either
+ /// a condensed or detailed view of each commit.
+ fn display_response(&self, response: Response, oneline: bool) {
+ if response.entries.is_empty() {
+ println!("{}", "No commits found.".yellow());
+ return;
+ }
+
+ for entry in response.entries {
+ match oneline {
+ false => println!("{}", entry.snapshot),
+ true => {
+ let hash = entry.snapshot.hash.get(0..7).unwrap_or("-");
+ let message = entry.snapshot.message;
+ println!("{} {message}", hash.yellow());
+ }
+ }
+ if entry.stats.is_some() {
+ println!("{}", entry.stats.unwrap());
+ }
+ }
+ }
+}
+
+#[async_trait]
+impl MevaCommand for LogCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "log"
+ }
+
+ fn about(&self) -> &'static str {
+ "Display commit history of the repository"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `log` command.
+ ///
+ /// Adds all filtering, formatting and range options to control commit history display.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_ONELINE)
+ .short('o')
+ .long(Self::ARG_ONELINE)
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_STAT)
+ .help("Condensed view: show each commit on one line (` `)"),
+ )
+ .arg(
+ Arg::new(Self::ARG_STAT)
+ .long(Self::ARG_STAT)
+ .action(ArgAction::SetTrue)
+ .help("Show diffstat (number of added and deleted lines per file)"),
+ )
+ .arg(
+ Arg::new(Self::ARG_MAX_COUNT)
+ .short('n')
+ .long(Self::ARG_MAX_COUNT)
+ .value_name("NUMBER")
+ .value_parser(value_parser!(u32))
+ .help("Limit the number of commits to show"),
+ )
+ .arg(
+ Arg::new(Self::ARG_SKIP)
+ .long(Self::ARG_SKIP)
+ .value_name("N")
+ .value_parser(value_parser!(u32))
+ .help("Skip the first N commits"),
+ )
+ .arg(
+ Arg::new(Self::ARG_AFTER)
+ .long(Self::ARG_AFTER)
+ .value_name("DATE")
+ .value_parser(value_parser!(DateTimeUtc))
+ .help("Show commits made after (and including) the given date"),
+ )
+ .arg(
+ Arg::new(Self::ARG_BEFORE)
+ .long(Self::ARG_BEFORE)
+ .value_name("DATE")
+ .value_parser(value_parser!(DateTimeUtc))
+ .help("Show commits made before (and including) the given date"),
+ )
+ .arg(
+ Arg::new(Self::ARG_GREP)
+ .long(Self::ARG_GREP)
+ .value_name("PATTERN")
+ .value_parser(value_parser!(Regex))
+ .help("Show only commits with a message matching the given regular expression"),
+ )
+ .arg(
+ Arg::new(Self::ARG_MERGES)
+ .long(Self::ARG_MERGES)
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_NO_MERGES)
+ .help("Show only merge commits (commits with two or more parents)"),
+ )
+ .arg(
+ Arg::new(Self::ARG_NO_MERGES)
+ .long(Self::ARG_NO_MERGES)
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_MERGES)
+ .help("Exclude merge commits (show only commits with one or zero parents)"),
+ )
+ .arg(
+ Arg::new(Self::ARG_REVISION)
+ .value_name("REVISION")
+ .value_parser(value_parser!(Revision))
+ .required(false)
+ .help("Optional revision to start the log from (e.g. HEAD, branch, tag, or hash)"),
+ )
+ }
+
+ /// Executes the `log` command.
+ ///
+ /// Collects CLI options and builds a [`Request`] to pass to the log handler.
+ /// The handler is responsible for querying commits and formatting output
+ /// according to the specified options.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ let oneline = matches.get_flag(Self::ARG_ONELINE);
+ let handler = container.log_handler().into_diagnostic()?;
+
+ let request = Request {
+ oneline,
+ stat: matches.get_flag(Self::ARG_STAT),
+ merges: matches.get_flag(Self::ARG_MERGES),
+ no_merges: matches.get_flag(Self::ARG_NO_MERGES),
+ max_count: matches.get_one::(Self::ARG_MAX_COUNT).cloned(),
+ skip: matches.get_one::(Self::ARG_SKIP).copied(),
+ after: matches.get_one::(Self::ARG_AFTER).map(|a| a.0),
+ before: matches
+ .get_one::(Self::ARG_BEFORE)
+ .map(|b| b.0),
+ grep: matches.get_one::(Self::ARG_GREP).cloned(),
+ revision: matches.get_one::(Self::ARG_REVISION).cloned(),
+ };
+
+ let response = handler.log(request).into_diagnostic()?;
+ self.display_response(response, oneline);
+ Ok(())
+ }
+}
diff --git a/cli/src/commands/ls_files.rs b/cli/src/commands/ls_files.rs
new file mode 100644
index 00000000..4548cf0a
--- /dev/null
+++ b/cli/src/commands/ls_files.rs
@@ -0,0 +1,164 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgGroup, ArgMatches, Command, value_parser};
+use engine::{
+ EngineContainer,
+ engine_container::MevaContainer,
+ handlers::ls_files::{LsFilesFilter, Request},
+};
+use miette::{IntoDiagnostic, Result};
+
+use crate::commands::MevaCommand;
+
+/// Implements the `ls-files` command for Meva DVCS.
+///
+/// Displays information about files in the index and working directory.
+#[derive(Default)]
+pub struct LsFilesCommand;
+
+impl LsFilesCommand {
+ /// Argument name for `--cached` flag.
+ /// When provided, shows only files that are tracked (present in the index).
+ const ARG_CACHED: &'static str = "cached";
+
+ /// Argument name for `--deleted` flag.
+ /// When set, lists files removed from the working tree but still in the index.
+ const ARG_DELETED: &'static str = "deleted";
+
+ /// Argument name for `--others` flag.
+ /// When set, lists files that are not tracked (untracked files including ignored ones).
+ const ARG_OTHERS: &'static str = "others";
+
+ /// Argument name for `--stage` flag.
+ /// Displays extended information about file statuses i.e., mode bits, object names, and stage numbers
+ const ARG_STAGE: &'static str = "stage";
+
+ /// Argument name for `--abbrev` option.
+ /// With `--stage`, this limits the printed object identifier to the
+ /// first N characters (range: 1–40).
+ const ARG_ABBREV: &'static str = "abbrev";
+
+ /// Argument name for `--full-name` flag.
+ /// Always prints full file paths, regardless of the current working directory.
+ const ARG_FULL_NAME: &'static str = "full-name";
+}
+
+#[async_trait]
+impl MevaCommand for LsFilesCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "ls-files"
+ }
+
+ fn about(&self) -> &'static str {
+ "Show information about files in the index and the working tree"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI definition for the `ls-files` command using `clap`.
+ ///
+ /// Adds several mutually exclusive filter options (`--cached`, `--deleted`, `--others`)
+ /// as well as options for controlling output format (`--stage`, `--abbrev`, `--full-name`).
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_CACHED)
+ .short('c')
+ .long(Self::ARG_CACHED)
+ .help("Show only files in the index (tracked)")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_DELETED)
+ .short('d')
+ .long(Self::ARG_DELETED)
+ .help("Show files that have been deleted from the working tree but are still in the index")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_OTHERS)
+ .short('o')
+ .long(Self::ARG_OTHERS)
+ .help("Show untracked files (not in the index)")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_STAGE)
+ .short('s')
+ .long(Self::ARG_STAGE)
+ .help("Display extended information about file status")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_ABBREV)
+ .long(Self::ARG_ABBREV)
+ .value_name("N")
+ .value_parser(value_parser!(u8).range(1..=40))
+ .requires(Self::ARG_STAGE)
+ .help("With --stage, prints only the first N characters of object identifiers"),
+ )
+ .arg(
+ Arg::new(Self::ARG_FULL_NAME)
+ .long(Self::ARG_FULL_NAME)
+ .help("Always show full paths (regardless of the calling directory)")
+ .action(ArgAction::SetTrue),
+ ).group(
+ ArgGroup::new("filters")
+ .args([
+ Self::ARG_CACHED,
+ Self::ARG_DELETED,
+ Self::ARG_OTHERS,
+ ])
+ .multiple(false)
+ )
+ }
+
+ /// Executes the `ls-files` command.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ let filter = if matches.get_flag(Self::ARG_DELETED) {
+ LsFilesFilter::Deleted
+ } else if matches.get_flag(Self::ARG_OTHERS) {
+ LsFilesFilter::Others
+ } else {
+ LsFilesFilter::Cached
+ };
+
+ let request = Request {
+ stage: matches.get_flag(Self::ARG_STAGE),
+ abbrev: matches.get_one::(Self::ARG_ABBREV).cloned(),
+ full_name: matches.get_flag(Self::ARG_FULL_NAME),
+ filter,
+ };
+
+ let handler = container.ls_files_handler().into_diagnostic()?;
+
+ let response = handler.handle_ls_files(request).into_diagnostic()?;
+
+ for file in response.files {
+ println!("{file}");
+ }
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = LsFilesCommand;
+ assert_eq!(cmd.name(), "ls-files");
+ assert_eq!(
+ cmd.about(),
+ "Show information about files in the index and the working tree"
+ );
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/ls_tree.rs b/cli/src/commands/ls_tree.rs
new file mode 100644
index 00000000..ab7cc05c
--- /dev/null
+++ b/cli/src/commands/ls_tree.rs
@@ -0,0 +1,168 @@
+use crate::commands::MevaCommand;
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command, value_parser};
+use engine::EngineContainer;
+use engine::engine_container::MevaContainer;
+use engine::handlers::ls_tree::Request;
+use engine::revision_parsing::Revision;
+use miette::{IntoDiagnostic, Result};
+use std::path::PathBuf;
+
+/// Implements the `ls-tree` command for Meva DVCS.
+///
+/// Lists the contents of a tree object or snapshot (commit) in the repository.
+/// This command lists the contents of a given tree object.
+///
+/// Supports recursive listing, filtering by path, and multiple display modes:
+/// - **default view** – shows object type, mode, and SHA-1 hash,
+/// - **long view (`-l`)** – includes file size for blob entries,
+/// - **name-only view (`--name-only`)** – prints only filenames and directories.
+///
+/// Can be used to inspect historical snapshots, branches, or arbitrary commit hashes.
+#[derive(Default)]
+pub struct LsTreeCommand;
+
+impl LsTreeCommand {
+ /// Argument key for specifying the commit, tag, or branch to inspect.
+ /// Corresponds to the `` argument (e.g., `HEAD`, branch name, or hash).
+ const ARG_SNAPSHOT_ID: &'static str = "snapshot_id";
+
+ /// Argument key for specifying optional path filters.
+ /// Allows restricting the listing to specific files or directories.
+ const ARG_PATHS: &'static str = "paths";
+
+ /// Flag key for listing entries recursively.
+ /// Corresponds to the `-r, --recursive` flag.
+ const ARG_RECURSIVE: &'static str = "recursive";
+
+ /// Flag key for including tree (directory) entries in the output.
+ /// Corresponds to the `-t` flag.
+ const ARG_TREE: &'static str = "tree";
+
+ /// Flag key for displaying additional information such as file size.
+ /// Corresponds to the `-l` flag.
+ const ARG_LONG: &'static str = "long";
+
+ /// Flag key for listing only names (without metadata).
+ /// Corresponds to the `--name-only` flag.
+ const ARG_NAME_ONLY: &'static str = "name-only";
+}
+
+#[async_trait]
+impl MevaCommand for LsTreeCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "ls-tree"
+ }
+
+ fn about(&self) -> &'static str {
+ "List the contents of a tree object or snapshot (commit) in the repository"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `ls-tree` command using `clap`.
+ ///
+ /// Adds the following options and flags:
+ /// - `-r, --recursive`: Recursively list all tree entries.
+ /// - `-t`: Include tree (directory) entries in the output.
+ /// - `-l`: Show detailed output including file sizes (for blobs).
+ /// - `--name-only`: Display only names of files and directories (no metadata).
+ /// - ``: Required identifier of the commit, branch, or tag.
+ /// - `[PATHS...]`: Optional file or directory paths to narrow the scope.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_RECURSIVE)
+ .short('r')
+ .long(Self::ARG_RECURSIVE)
+ .action(ArgAction::SetTrue)
+ .help("List tree entries recursively, including subdirectories"),
+ )
+ .arg(
+ Arg::new(Self::ARG_TREE)
+ .short('t')
+ .action(ArgAction::SetTrue)
+ .help("Show tree (directory) entries as well. Without this flag, only file (blob) entries are shown"),
+ )
+ .arg(
+ Arg::new(Self::ARG_LONG)
+ .short('l')
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_NAME_ONLY)
+ .help("Show file sizes (in bytes) for blob entries. Cannot be used together with --name-only"),
+ )
+ .arg(
+ Arg::new(Self::ARG_NAME_ONLY)
+ .long(Self::ARG_NAME_ONLY)
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_LONG)
+ .help("List only filenames (and directory names), without type, mode, or object ID"),
+ )
+ .arg(
+ Arg::new(Self::ARG_SNAPSHOT_ID)
+ .value_name("SNAPSHOT-ID")
+ .value_parser(value_parser!(Revision))
+ .required(true)
+ .help("Snapshot identifier (e.g. HEAD, commit hash, tag, or branch)"),
+ )
+ .arg(
+ Arg::new(Self::ARG_PATHS)
+ .value_name("PATHS")
+ .num_args(0..)
+ .last(true)
+ .help("Optional path to a directory or file within the tree"),
+ )
+ }
+
+ /// Executes the `ls-tree` command.
+ ///
+ /// Reads the provided CLI arguments (revision, paths, flags) and performs
+ /// a repository tree listing. Depending on the options, it may:
+ ///
+ /// * List the entire tree (`--recursive`),
+ /// * Include directories (`-t`),
+ /// * Show file sizes (`-l`),
+ /// * Or display only file and directory names (`--name-only`).
+ ///
+ /// # Returns
+ ///
+ /// * [`Result`]: Indicates success or a diagnostic error
+ /// if the tree resolution or listing fails.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ let recursive = matches.get_flag(Self::ARG_RECURSIVE);
+ let tree = matches.get_flag(Self::ARG_TREE);
+ let long = matches.get_flag(Self::ARG_LONG);
+ let name_only = matches.get_flag(Self::ARG_NAME_ONLY);
+ let revision = matches
+ .get_one::(Self::ARG_SNAPSHOT_ID)
+ .cloned()
+ .unwrap();
+ let paths = match matches.get_many::(Self::ARG_PATHS) {
+ Some(vals) => vals.map(PathBuf::from).collect(),
+ None => Vec::new(),
+ };
+
+ let request = Request {
+ recursive,
+ tree,
+ long,
+ name_only,
+ revision,
+ paths,
+ };
+
+ let handler = container.ls_tree_handler().into_diagnostic()?;
+
+ let response = handler.handle_ls_tree(request).into_diagnostic()?;
+
+ for entry in response.display_entries {
+ println!("{entry}");
+ }
+
+ Ok(())
+ }
+}
diff --git a/cli/src/commands/merge.rs b/cli/src/commands/merge.rs
new file mode 100644
index 00000000..0b989618
--- /dev/null
+++ b/cli/src/commands/merge.rs
@@ -0,0 +1,130 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command};
+use miette::Result;
+
+use engine::engine_container::MevaContainer;
+
+use crate::{commands::MevaCommand, extensions::WithVerbose};
+
+/// Implements the `merge` command for Meva DVCS.
+#[derive(Default)]
+pub struct MergeCommand;
+
+impl MergeCommand {
+ /// The branch to merge into the current branch
+ const ARG_BRANCH: &'static str = "branch";
+
+ /// Merge changes but do not create a merge commit (squash)
+ const ARG_SQUASH: &'static str = "squash";
+
+ /// Abort the current merge process and restore the previous state
+ const ARG_ABORT: &'static str = "abort";
+
+ /// Use the given message as the merge commit message
+ const ARG_MESSAGE: &'static str = "message";
+
+ /// Allow fast-forward merge if possible
+ const ARG_FAST_FORWARD: &'static str = "ff";
+
+ /// Create a merge commit even when fast-forward is possible
+ const ARG_NO_FAST_FORWARD: &'static str = "no-ff";
+}
+
+#[async_trait]
+impl MevaCommand for MergeCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "merge"
+ }
+
+ fn about(&self) -> &'static str {
+ "Join development histories together"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `merge` command.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_verbose_arg("Enable verbose output during the merge process")
+ .arg(
+ Arg::new(Self::ARG_BRANCH)
+ .help("The branch to merge into the current branch")
+ .value_name("BRANCH")
+ .required_unless_present(Self::ARG_ABORT),
+ )
+ .arg(
+ Arg::new(Self::ARG_ABORT)
+ .long(Self::ARG_ABORT)
+ .short('a')
+ .help("Abort the current merge process and restore the previous state")
+ .action(ArgAction::SetTrue)
+ .conflicts_with_all([
+ Self::ARG_BRANCH,
+ Self::ARG_SQUASH,
+ Self::ARG_MESSAGE,
+ Self::ARG_FAST_FORWARD,
+ Self::ARG_NO_FAST_FORWARD,
+ ]),
+ )
+ .arg(
+ Arg::new(Self::ARG_SQUASH)
+ .long(Self::ARG_SQUASH)
+ .short('s')
+ .help("Merge changes but do not create a merge commit (squash)")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_FAST_FORWARD)
+ .long(Self::ARG_FAST_FORWARD)
+ .help("Allow fast-forward merge if possible")
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_NO_FAST_FORWARD),
+ )
+ .arg(
+ Arg::new(Self::ARG_NO_FAST_FORWARD)
+ .long(Self::ARG_NO_FAST_FORWARD)
+ .help("Create a merge commit even when fast-forward is possible")
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_FAST_FORWARD),
+ )
+ .arg(
+ Arg::new(Self::ARG_MESSAGE)
+ .long(Self::ARG_MESSAGE)
+ .short('m')
+ .value_name("MESSAGE")
+ .help("Use the given message as the merge commit message")
+ .requires(Self::ARG_BRANCH),
+ )
+ }
+
+ /// Executes the `merge` command.
+ ///
+ /// # Arguments
+ /// * `matches`: Parsed command-line arguments.
+ /// * `container`: Dependency injection container.
+ ///
+ /// # Returns
+ /// * `Result<()>`: Success or error during execution.
+ async fn execute(&self, _matches: &ArgMatches, _container: &Self::Container) -> Result<()> {
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = MergeCommand;
+ assert_eq!(cmd.name(), "merge");
+ assert_eq!(cmd.about(), "Join development histories together");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/meva_command.rs b/cli/src/commands/meva_command.rs
new file mode 100644
index 00000000..6aa2235c
--- /dev/null
+++ b/cli/src/commands/meva_command.rs
@@ -0,0 +1,62 @@
+use async_trait::async_trait;
+use clap::{ArgMatches, Command};
+use engine::{EngineContainer, engine_container::MevaContainer};
+use miette::Result;
+
+/// A trait representing a top-level command in the Meva CLI.
+#[async_trait]
+pub trait MevaCommand: Send + Sync {
+ type Container: EngineContainer + Send + Sync;
+
+ /// Returns the unique name of the command.
+ fn name(&self) -> &'static str;
+
+ /// Returns a brief description of what the command does.
+ fn about(&self) -> &'static str;
+
+ /// Returns the version string for the command.
+ fn version(&self) -> &'static str;
+
+ /// Builds and returns the `clap::Command` for this command.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ }
+
+ /// Builds a basic `clap::Command` with name, description and version.
+ fn build_base_command(&self) -> Command {
+ let cmd = Command::new(self.name())
+ .about(self.about())
+ .version(self.version());
+
+ self.register_subcommands(cmd)
+ }
+
+ /// Adds subcommands for this command to the given command mutable instance.
+ fn register_subcommands(&self, mut cmd: Command) -> Command {
+ for sub in self.subcommands() {
+ cmd = cmd.subcommand(sub.build_command());
+ }
+ cmd
+ }
+
+ /// Executes the command logic.
+ ///
+ /// This is the entry point for the command's runtime behavior. Implementations
+ /// should use the provided `matches` to extract arguments and the `container`
+ /// to access necessary services or handlers.
+ ///
+ /// # Arguments
+ /// * `matches`: The parsed CLI arguments for this command.
+ /// * `container`: The dependency injection container providing access to core engine features.
+ ///
+ /// # Returns
+ /// * `Result<()>`: Indicates whether the execution succeeded. Errors are propagated via `miette`.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()>;
+
+ /// Returns a vector of boxed subcommands for this command.
+ ///
+ /// Default implementation returns an empty vector.
+ fn subcommands(&self) -> Vec>> {
+ Vec::new()
+ }
+}
diff --git a/cli/src/commands/plugins.rs b/cli/src/commands/plugins.rs
new file mode 100644
index 00000000..f6f35615
--- /dev/null
+++ b/cli/src/commands/plugins.rs
@@ -0,0 +1,66 @@
+pub mod subcommands;
+
+use crate::commands::{MevaCommand, execute_multiple};
+
+use async_trait::async_trait;
+use clap::ArgMatches;
+use engine::engine_container::MevaContainer;
+use miette::Result;
+use subcommands::*;
+
+/// Implements the `plugins` top-level command for Meva.
+///
+/// The `plugins` command serves as a namespace for all plugin-related operations
+/// such as listing, editing, registering, unregistering, or retrieving information
+/// about plugins.
+#[derive(Default)]
+pub struct PluginsCommand;
+
+#[async_trait]
+impl MevaCommand for PluginsCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "plugins"
+ }
+
+ fn about(&self) -> &'static str {
+ "Manage plugins"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Define the set of subcommands under `plugins` namespace.
+ ///
+ /// Returns boxed instances of each ignore operation command.
+ fn subcommands(&self) -> Vec>> {
+ vec![
+ Box::new(PluginsEditCommand),
+ Box::new(PluginsInfoCommand),
+ Box::new(PluginsListCommand),
+ Box::new(PluginsRegisterCommand),
+ Box::new(PluginsUnregisterCommand),
+ ]
+ }
+
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ execute_multiple(matches, container, self.subcommands()).await
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = PluginsCommand;
+ assert_eq!(cmd.name(), "plugins");
+ assert_eq!(cmd.about(), "Manage plugins");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/plugins/subcommands.rs b/cli/src/commands/plugins/subcommands.rs
new file mode 100644
index 00000000..4a82e4e3
--- /dev/null
+++ b/cli/src/commands/plugins/subcommands.rs
@@ -0,0 +1,11 @@
+mod edit;
+mod info;
+mod list;
+mod register;
+mod unregister;
+
+pub use edit::PluginsEditCommand;
+pub use info::PluginsInfoCommand;
+pub use list::PluginsListCommand;
+pub use register::PluginsRegisterCommand;
+pub use unregister::PluginsUnregisterCommand;
diff --git a/cli/src/commands/plugins/subcommands/edit.rs b/cli/src/commands/plugins/subcommands/edit.rs
new file mode 100644
index 00000000..c99fcfd3
--- /dev/null
+++ b/cli/src/commands/plugins/subcommands/edit.rs
@@ -0,0 +1,126 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command};
+use engine::{
+ ConfigLoader, EngineContainer, MevaConfigLoader,
+ engine_container::MevaContainer,
+ handlers::plugins::{EditRequest, PluginsOperations},
+};
+use miette::IntoDiagnostic;
+use plugins::{CommandType, ScopeType};
+use shared::OpenInEditor;
+
+use crate::{
+ commands::MevaCommand,
+ extensions::{WithCommandPlugin, WithScope},
+};
+
+#[derive(Default)]
+pub struct PluginsEditCommand;
+
+impl PluginsEditCommand {
+ const ARG_ENABLE: &'static str = "enable";
+
+ const ARG_DISABLE: &'static str = "disable";
+}
+
+#[async_trait]
+impl MevaCommand for PluginsEditCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "edit"
+ }
+
+ fn about(&self) -> &'static str {
+ "Open the file with plugin's source code in your default editor"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_command_and_plugin_arg(
+ "The command associated with the plugin",
+ "The name of the plugin to edit",
+ )
+ .with_scope_arg("Scope of the plugin")
+ .arg(
+ Arg::new(Self::ARG_ENABLE)
+ .short('e')
+ .long(Self::ARG_ENABLE)
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_DISABLE)
+ .help("Enable plugin"),
+ )
+ .arg(
+ Arg::new(Self::ARG_DISABLE)
+ .short('d')
+ .long(Self::ARG_DISABLE)
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_ENABLE)
+ .help("Disable plugin"),
+ )
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let command_str = matches.get_one::(Command::ARG_COMMAND).unwrap();
+ let name = matches.get_one::(Command::ARG_PLUGIN).unwrap();
+ let scope_str = matches.get_one::(Command::ARG_SCOPE).unwrap();
+ let enable = matches.get_flag(Self::ARG_ENABLE);
+ let disable = matches.get_flag(Self::ARG_DISABLE);
+
+ let enabled = if enable || disable {
+ Some(!disable)
+ } else {
+ None
+ };
+
+ let request = EditRequest {
+ command: command_str.parse::().unwrap(),
+ name: name.clone(),
+ scope: scope_str.parse::().unwrap(),
+ enabled,
+ };
+
+ let handler = container.plugins_handler().into_diagnostic()?;
+
+ let response = handler.edit(request).into_diagnostic()?;
+
+ if enabled.is_none() {
+ let loader = MevaConfigLoader::default();
+ let override_cmd = loader.get("editor.default", None).ok();
+ response
+ .source_file
+ .open_in_editor(override_cmd)
+ .into_diagnostic()?;
+ } else {
+ println!("{response}");
+ }
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = PluginsEditCommand;
+ assert_eq!(cmd.name(), "edit");
+ assert_eq!(
+ cmd.about(),
+ "Open the file with plugin's source code in your default editor"
+ );
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/plugins/subcommands/info.rs b/cli/src/commands/plugins/subcommands/info.rs
new file mode 100644
index 00000000..4720af8c
--- /dev/null
+++ b/cli/src/commands/plugins/subcommands/info.rs
@@ -0,0 +1,87 @@
+use async_trait::async_trait;
+use clap::{ArgMatches, Command};
+use engine::{
+ EngineContainer,
+ engine_container::MevaContainer,
+ handlers::plugins::{InfoRequest, PluginsOperations},
+};
+use miette::IntoDiagnostic;
+use plugins::{CommandType, ScopeType};
+
+use crate::{
+ commands::MevaCommand,
+ extensions::{WithCommandPlugin, WithScope},
+};
+
+#[derive(Default)]
+pub struct PluginsInfoCommand;
+
+#[async_trait]
+impl MevaCommand for PluginsInfoCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "info"
+ }
+
+ fn about(&self) -> &'static str {
+ "Display detailed information about a registered plugin"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_command_and_plugin_arg(
+ "The command associated with the plugin",
+ "The name of the plugin to show details for",
+ )
+ .with_scope_arg("Scope of the plugin")
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let command_str = matches.get_one::(Command::ARG_COMMAND).unwrap();
+ let scope_str = matches.get_one::(Command::ARG_SCOPE).unwrap();
+
+ let request = InfoRequest {
+ name: matches
+ .get_one::(Command::ARG_PLUGIN)
+ .unwrap()
+ .clone(),
+ command: command_str.parse::().unwrap(),
+ scope: scope_str.parse::().unwrap(),
+ };
+
+ let handler = container.plugins_handler().into_diagnostic()?;
+
+ let response = handler.info(request).into_diagnostic()?;
+
+ println!("{response}");
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = PluginsInfoCommand;
+ assert_eq!(cmd.name(), "info");
+ assert_eq!(
+ cmd.about(),
+ "Display detailed information about a registered plugin"
+ );
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/plugins/subcommands/list.rs b/cli/src/commands/plugins/subcommands/list.rs
new file mode 100644
index 00000000..05b98bd5
--- /dev/null
+++ b/cli/src/commands/plugins/subcommands/list.rs
@@ -0,0 +1,127 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgGroup, ArgMatches, Command, builder::PossibleValuesParser};
+use engine::{
+ EngineContainer,
+ engine_container::MevaContainer,
+ handlers::plugins::{ListRequest, PluginsOperations},
+};
+use miette::IntoDiagnostic;
+use plugins::{CommandType, EventType, ScopeType};
+use strum::VariantNames;
+
+use crate::{commands::MevaCommand, extensions::WithScope};
+
+#[derive(Default)]
+pub struct PluginsListCommand;
+
+impl PluginsListCommand {
+ const ARG_COMMAND: &'static str = "command";
+
+ const ARG_EVENT: &'static str = "event";
+
+ const ARG_DISABLED: &'static str = "disabled";
+
+ const ARG_ENABLED: &'static str = "enabled";
+}
+
+#[async_trait]
+impl MevaCommand for PluginsListCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "list"
+ }
+
+ fn about(&self) -> &'static str {
+ "List registered plugins with optional filters"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_COMMAND)
+ .index(1)
+ .required(true)
+ .value_name("COMMAND")
+ .value_parser(PossibleValuesParser::new(CommandType::VARIANTS))
+ .help("Filter plugins by associated command"),
+ )
+ .arg(
+ Arg::new(Self::ARG_EVENT)
+ .index(2)
+ .required(true)
+ .value_name("EVENT")
+ .value_parser(PossibleValuesParser::new(EventType::VARIANTS))
+ .help("Filter plugins by event"),
+ )
+ .with_scope_arg("Scope of the plugin")
+ .arg(
+ Arg::new(Self::ARG_ENABLED)
+ .short('E')
+ .long(Self::ARG_ENABLED)
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_DISABLED)
+ .help("Include enabled plugins in the output"),
+ )
+ .arg(
+ Arg::new(Self::ARG_DISABLED)
+ .short('D')
+ .long(Self::ARG_DISABLED)
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_ENABLED)
+ .help("Include disabled plugins in the output"),
+ )
+ .group(
+ ArgGroup::new("filter")
+ .args([Self::ARG_ENABLED, Self::ARG_DISABLED])
+ .multiple(true),
+ )
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let command_str = matches.get_one::(Self::ARG_COMMAND).unwrap();
+ let event_str = matches.get_one::(Self::ARG_EVENT).unwrap();
+ let scope_str = matches.get_one::(Command::ARG_SCOPE).unwrap();
+
+ let include_disabled = matches.get_flag(Self::ARG_DISABLED);
+ let include_enabled = matches.get_flag(Self::ARG_ENABLED) || !include_disabled;
+
+ let request = ListRequest {
+ command: command_str.parse::().unwrap(),
+ event: event_str.parse::().unwrap(),
+ scope: scope_str.parse::().unwrap(),
+ include_disabled,
+ include_enabled,
+ };
+
+ let handler = container.plugins_handler().into_diagnostic()?;
+ let response = handler.list(request).into_diagnostic()?;
+
+ println!("{response}");
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = PluginsListCommand;
+ assert_eq!(cmd.name(), "list");
+ assert_eq!(cmd.about(), "List registered plugins with optional filters");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/plugins/subcommands/register.rs b/cli/src/commands/plugins/subcommands/register.rs
new file mode 100644
index 00000000..6142831f
--- /dev/null
+++ b/cli/src/commands/plugins/subcommands/register.rs
@@ -0,0 +1,178 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command, ValueHint, builder::PossibleValuesParser};
+use engine::{
+ EngineContainer,
+ engine_container::MevaContainer,
+ handlers::plugins::{PluginsOperations, RegisterRequest},
+};
+use miette::IntoDiagnostic;
+use owo_colors::OwoColorize;
+use plugins::{CommandType, EventType, ScopeType};
+use shared::PathToString;
+use std::path::PathBuf;
+use strum::VariantNames;
+
+use crate::{
+ commands::MevaCommand,
+ extensions::{WithCommandPlugin, WithFile, WithScope},
+};
+
+#[derive(Default)]
+pub struct PluginsRegisterCommand;
+
+impl PluginsRegisterCommand {
+ const ARG_PATH: &'static str = "path";
+
+ const ARG_DESCRIPTION: &'static str = "description";
+
+ const ARG_EVENT: &'static str = "event";
+
+ const ARG_ORDER: &'static str = "order";
+
+ const ARG_TIMEOUT: &'static str = "timeout";
+
+ const ARG_DISABLED: &'static str = "disabled";
+
+ const ARG_INTERPRETER: &'static str = "interpreter";
+}
+
+#[async_trait]
+impl MevaCommand for PluginsRegisterCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "register"
+ }
+
+ fn about(&self) -> &'static str {
+ "Register a new plugin"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_command_and_plugin_arg("Command type (kebab-case)", "Plugin name")
+ .arg(
+ Arg::new(Self::ARG_PATH)
+ .value_name("PATH")
+ .index(3)
+ .required(true)
+ .value_parser(clap::value_parser!(PathBuf))
+ .value_hint(ValueHint::FilePath)
+ .help("Path to the script to register"),
+ )
+ .with_file_arg("Relative path to the file")
+ .with_scope_arg("Scope of the plugin")
+ .arg(
+ Arg::new(Self::ARG_DESCRIPTION)
+ .short('d')
+ .long(Self::ARG_DESCRIPTION)
+ .value_name("DESCRIPTION")
+ .help("Plugin description"),
+ )
+ .arg(
+ Arg::new(Self::ARG_EVENT)
+ .short('e')
+ .long(Self::ARG_EVENT)
+ .value_name("EVENT")
+ .default_value("post-execute")
+ .value_parser(PossibleValuesParser::new(EventType::VARIANTS))
+ .help("Event type (kebab-case)"),
+ )
+ .arg(
+ Arg::new(Self::ARG_ORDER)
+ .short('o')
+ .long(Self::ARG_ORDER)
+ .value_name("ORDER")
+ .default_value("1")
+ .value_parser(clap::value_parser!(u32))
+ .help("Execution order (integer)"),
+ )
+ .arg(
+ Arg::new(Self::ARG_TIMEOUT)
+ .short('t')
+ .long(Self::ARG_TIMEOUT)
+ .value_name("TIMEOUT")
+ .value_parser(clap::value_parser!(u64))
+ .help("Execution timeout in milliseconds (integer)"),
+ )
+ .arg(
+ Arg::new(Self::ARG_DISABLED)
+ .short('D')
+ .long(Self::ARG_DISABLED)
+ .action(ArgAction::SetTrue)
+ .help("Disable plugin"),
+ )
+ .arg(
+ Arg::new(Self::ARG_INTERPRETER)
+ .short('i')
+ .long(Self::ARG_INTERPRETER)
+ .value_name("INTERPRETER")
+ .required(false)
+ .help("Interpreter used use to run the script (e.g. 'python3')"),
+ )
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let command_str = matches.get_one::(Command::ARG_COMMAND).unwrap();
+ let event_str = matches.get_one::(Self::ARG_EVENT).unwrap();
+ let scope_str = matches.get_one::(Command::ARG_SCOPE).unwrap();
+
+ let request = RegisterRequest {
+ path: matches.get_one::(Self::ARG_PATH).unwrap().clone(),
+ scope: scope_str.parse::().unwrap(),
+ name: matches
+ .get_one::(Command::ARG_PLUGIN)
+ .unwrap()
+ .clone(),
+ description: matches.get_one::(Self::ARG_DESCRIPTION).cloned(),
+ file: matches.get_one::(Command::ARG_FILE).cloned(),
+ command: command_str.parse::().unwrap(),
+ event: event_str.parse::().unwrap(),
+ order: *matches.get_one::(Self::ARG_ORDER).unwrap(),
+ timeout: matches.get_one::(Self::ARG_TIMEOUT).cloned(),
+ enabled: !matches.get_flag(Self::ARG_DISABLED),
+ interpreter: matches.get_one::(Self::ARG_INTERPRETER).cloned(),
+ };
+
+ let handler = container.plugins_handler().into_diagnostic()?;
+
+ let response = handler.register(request).into_diagnostic()?;
+
+ println!("{}", "Plugin registered successfully!".green().bold());
+
+ println!(
+ "Source code copied to: {}",
+ response.plugin_source_file.to_utf8_string().cyan()
+ );
+
+ println!(
+ "Metadata saved at: {}",
+ response.plugins_metadata_file.to_utf8_string().cyan()
+ );
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = PluginsRegisterCommand;
+ assert_eq!(cmd.name(), "register");
+ assert_eq!(cmd.about(), "Register a new plugin");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/plugins/subcommands/unregister.rs b/cli/src/commands/plugins/subcommands/unregister.rs
new file mode 100644
index 00000000..82e05941
--- /dev/null
+++ b/cli/src/commands/plugins/subcommands/unregister.rs
@@ -0,0 +1,98 @@
+use async_trait::async_trait;
+use clap::{ArgMatches, Command};
+use engine::{
+ EngineContainer,
+ engine_container::MevaContainer,
+ handlers::plugins::{PluginsOperations, UnregisterRequest},
+};
+use miette::IntoDiagnostic;
+use owo_colors::OwoColorize;
+use plugins::{CommandType, ScopeType};
+
+use crate::{
+ commands::MevaCommand,
+ extensions::{WithCommandPlugin, WithScope},
+};
+
+#[derive(Default)]
+pub struct PluginsUnregisterCommand;
+
+#[async_trait]
+impl MevaCommand for PluginsUnregisterCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "unregister"
+ }
+
+ fn about(&self) -> &'static str {
+ "Unregister a previously registered plugin"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_command_and_plugin_arg(
+ "The command associated with the plugin",
+ "The plugin name to unregister",
+ )
+ .with_scope_arg("Scope of the plugin")
+ }
+
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let command_str = matches.get_one::(Command::ARG_COMMAND).unwrap();
+ let default_scope = ScopeType::Local.to_string();
+ let scope_str = matches
+ .get_one::(Command::ARG_SCOPE)
+ .unwrap_or(&default_scope);
+
+ let request = UnregisterRequest {
+ command: command_str.parse::().unwrap().clone(),
+ name: matches
+ .get_one::(Command::ARG_PLUGIN)
+ .unwrap()
+ .clone(),
+ scope: scope_str.parse::().unwrap(),
+ };
+
+ let handler = container.plugins_handler().into_diagnostic()?;
+
+ let response = handler.unregister(request).into_diagnostic()?;
+
+ println!("{}", "Plugin unregistered successfully!".green().bold());
+
+ println!(
+ "Removed entry from configuration file: {}",
+ response.plugins_metadata_file.display().cyan()
+ );
+
+ println!(
+ "Deleted source code file: {}",
+ response.plugin_source_file.display().cyan()
+ );
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = PluginsUnregisterCommand;
+ assert_eq!(cmd.name(), "unregister");
+ assert_eq!(cmd.about(), "Unregister a previously registered plugin");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/pull.rs b/cli/src/commands/pull.rs
new file mode 100644
index 00000000..71167a6e
--- /dev/null
+++ b/cli/src/commands/pull.rs
@@ -0,0 +1,85 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgMatches, Command};
+use miette::Result;
+
+use engine::engine_container::MevaContainer;
+
+use crate::{commands::MevaCommand, extensions::WithVerbose};
+
+/// Implements the `pull` command for Meva DVCS.
+#[derive(Default)]
+pub struct PullCommand;
+
+impl PullCommand {
+ const ARG_ORIGIN: &'static str = "origin";
+
+ const ARG_BRANCH: &'static str = "branch";
+}
+
+#[async_trait]
+impl MevaCommand for PullCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "pull"
+ }
+
+ fn about(&self) -> &'static str {
+ "Fetch and integrate the latest changes from the remote repository into your local branch"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `pull` command.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_verbose_arg("Enable verbose output when pulling from remote server")
+ .arg(
+ Arg::new(Self::ARG_ORIGIN)
+ .value_name("ORIGIN")
+ .index(1)
+ .required(false)
+ .default_value("origin")
+ .help("Name of the remote repository to pull from"),
+ )
+ .arg(
+ Arg::new(Self::ARG_BRANCH)
+ .value_name("BRANCH")
+ .index(2)
+ .required(false)
+ .help("Name of the branch to pull from"),
+ )
+ }
+
+ /// Executes the `pull` command.
+ ///
+ /// # Arguments
+ /// * `matches`: Parsed command-line arguments.
+ /// * `container`: Dependency injection container.
+ ///
+ /// # Returns
+ /// * `Result<()>`: Success or error during execution.
+ async fn execute(&self, _matches: &ArgMatches, _container: &Self::Container) -> Result<()> {
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = PullCommand;
+ assert_eq!(cmd.name(), "pull");
+ assert_eq!(
+ cmd.about(),
+ "Fetch and integrate the latest changes from the remote repository into your local branch"
+ );
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/push.rs b/cli/src/commands/push.rs
new file mode 100644
index 00000000..dd9e54c0
--- /dev/null
+++ b/cli/src/commands/push.rs
@@ -0,0 +1,120 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command};
+use miette::{IntoDiagnostic, Result};
+
+use engine::{EngineContainer, engine_container::MevaContainer, handlers::push::Request};
+
+use crate::{commands::MevaCommand, extensions::WithVerbose};
+
+/// Implements the `push` command for Meva DVCS.
+///
+/// This command pushes local commits to a remote repository.
+/// It supports pushing specific branches or all local branches
+/// Deletion of remote branches is also supported.
+#[derive(Default)]
+pub struct PushCommand;
+
+impl PushCommand {
+ const ARG_ORIGIN: &'static str = "origin";
+
+ const ARG_BRANCH: &'static str = "branch";
+
+ const ARG_ALL: &'static str = "all";
+
+ const ARG_DELETE: &'static str = "delete";
+}
+
+#[async_trait]
+impl MevaCommand for PushCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "push"
+ }
+
+ fn about(&self) -> &'static str {
+ "Push local commits to a remote repository"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `push` command.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_verbose_arg("Enable verbose output when pushing to remote server")
+ .arg(
+ Arg::new(Self::ARG_ORIGIN)
+ .value_name("ORIGIN")
+ .index(1)
+ .required(false)
+ .default_value("origin")
+ .help("Name of the remote repository to push to"),
+ )
+ .arg(
+ Arg::new(Self::ARG_BRANCH)
+ .value_name("BRANCH")
+ .index(2)
+ .required(false)
+ .help("Name of the branch to push to"),
+ )
+ .arg(
+ Arg::new(Self::ARG_ALL)
+ .long(Self::ARG_ALL)
+ .short('a')
+ .help("Push all local branches to the specified remote")
+ .action(ArgAction::SetTrue)
+ .conflicts_with_all([Self::ARG_BRANCH, Self::ARG_DELETE]),
+ )
+ .arg(
+ Arg::new(Self::ARG_DELETE)
+ .long(Self::ARG_DELETE)
+ .short('d')
+ .help("Delete the given remote branch.")
+ .action(ArgAction::SetTrue)
+ .requires(Self::ARG_BRANCH),
+ )
+ }
+
+ /// Executes the `push` command.
+ ///
+ /// # Arguments
+ /// * `matches`: Parsed command-line arguments.
+ /// * `container`: Dependency injection container.
+ ///
+ /// # Returns
+ /// * `Result<()>`: Success or error during execution.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ let request = Request {
+ origin: matches.get_one::(Self::ARG_ORIGIN).unwrap().clone(),
+ branch: matches.get_one::(Self::ARG_BRANCH).cloned(),
+ all: matches.get_flag(Self::ARG_ALL),
+ delete: matches.get_flag(Self::ARG_DELETE),
+ verbose: matches.get_flag(Command::ARG_VERBOSE),
+ };
+
+ let handler = container.push_handler().into_diagnostic()?;
+
+ let response = handler.handle_push(request).await.into_diagnostic()?;
+
+ println!();
+ println!("{response}");
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = PushCommand;
+ assert_eq!(cmd.name(), "push");
+ assert_eq!(cmd.about(), "Push local commits to a remote repository");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/remote.rs b/cli/src/commands/remote.rs
new file mode 100644
index 00000000..2ed0f790
--- /dev/null
+++ b/cli/src/commands/remote.rs
@@ -0,0 +1,113 @@
+mod subcommands;
+
+use subcommands::*;
+
+use async_trait::async_trait;
+use clap::{ArgMatches, Command};
+use miette::{IntoDiagnostic, Result};
+
+use engine::{
+ EngineContainer, engine_container::MevaContainer, handlers::remote::RemoteOperations,
+};
+
+use crate::{
+ commands::{MevaCommand, execute_multiple},
+ extensions::WithVerbose,
+};
+
+/// Implements the `remote` command for Meva DVCS.
+///
+/// This command manages the set of tracked repositories ("remotes").
+/// It acts as a parent command for operations like adding, removing, or renaming remotes.
+/// If no subcommand is provided, it defaults to listing the configured remotes.
+#[derive(Default)]
+pub struct RemoteCommand;
+
+#[async_trait]
+impl MevaCommand for RemoteCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "remote"
+ }
+
+ fn about(&self) -> &'static str {
+ "Manage remote repositories"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `remote` command.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_verbose_arg("Enable verbose output when listing remotes")
+ }
+
+ /// Registers the list of available subcommands for `remote`.
+ ///
+ /// Includes: `add`, `get-url`, `remove`, `rename`, `set-url`, and `show`.
+ fn subcommands(&self) -> Vec>> {
+ vec![
+ Box::new(RemoteAddCommand),
+ Box::new(RemoteGetUrlCommand),
+ Box::new(RemoteRemoveCommand),
+ Box::new(RemoteRenameCommand),
+ Box::new(RemoteSetUrlCommand),
+ Box::new(RemoteShowCommand),
+ ]
+ }
+
+ /// Executes the `remote` command.
+ ///
+ /// Delegates execution to a subcommand if one is specified in `matches`.
+ /// If no subcommand is provided, it performs the default action of listing
+ /// the configured remotes (checking `ARG_VERBOSE` for detailed output).
+ ///
+ /// # Arguments
+ /// * `matches`: Parsed command-line arguments.
+ /// * `container`: Dependency injection container.
+ ///
+ /// # Returns
+ /// * `Result<()>`: Success or error during execution.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ // Try to execute a subcommand first
+ let handled = execute_multiple(matches, container, self.subcommands()).await?;
+
+ // If no subcommand was invoked, fall back to listing remotes
+ if matches.subcommand_name().is_none() {
+ let verbose = matches.get_flag(Command::ARG_VERBOSE);
+ let handler = container.remote_handler().into_diagnostic()?;
+ let response = handler.list().into_diagnostic()?;
+
+ let mut remotes_vec: Vec<_> = response.remotes.iter().collect();
+ remotes_vec.sort_by(|(name_a, _), (name_b, _)| name_a.cmp(name_b));
+
+ for (name, entry) in remotes_vec {
+ if verbose {
+ println!("{}", entry.display_verbose(name));
+ } else {
+ println!("{name}");
+ }
+ }
+ }
+
+ Ok(handled)
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = RemoteCommand;
+ assert_eq!(cmd.name(), "remote");
+ assert_eq!(cmd.about(), "Manage remote repositories");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/remote/subcommands.rs b/cli/src/commands/remote/subcommands.rs
new file mode 100644
index 00000000..bdba6f51
--- /dev/null
+++ b/cli/src/commands/remote/subcommands.rs
@@ -0,0 +1,13 @@
+mod add;
+mod get_url;
+mod remove;
+mod rename;
+mod set_url;
+mod show;
+
+pub use add::RemoteAddCommand;
+pub use get_url::RemoteGetUrlCommand;
+pub use remove::RemoteRemoveCommand;
+pub use rename::RemoteRenameCommand;
+pub use set_url::RemoteSetUrlCommand;
+pub use show::RemoteShowCommand;
diff --git a/cli/src/commands/remote/subcommands/add.rs b/cli/src/commands/remote/subcommands/add.rs
new file mode 100644
index 00000000..4e43d93b
--- /dev/null
+++ b/cli/src/commands/remote/subcommands/add.rs
@@ -0,0 +1,114 @@
+use std::path::PathBuf;
+
+use async_trait::async_trait;
+use clap::{Arg, ArgMatches, Command, ValueHint};
+use engine::{
+ EngineContainer,
+ engine_container::MevaContainer,
+ handlers::remote::{AddRequest, RemoteOperations},
+};
+use miette::IntoDiagnostic;
+use url::Url;
+
+use crate::{commands::MevaCommand, extensions::WithName};
+
+/// Implements the `remote add` subcommand for Meva DVCS.
+///
+/// This command registers a new remote repository with a specific name and URL
+/// in the local repository configuration. It optionally performs an immediate fetch.
+#[derive(Default)]
+pub struct RemoteAddCommand;
+
+impl RemoteAddCommand {
+ /// Argument name for the remote URL.
+ const ARG_URL: &'static str = "url";
+
+ /// Argument name for specifying the server public key.
+ const ARG_SERVER_KEY: &'static str = "server-key";
+}
+
+#[async_trait]
+impl MevaCommand for RemoteAddCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "add"
+ }
+
+ fn about(&self) -> &'static str {
+ "Add a new remote repository"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `remote add` command.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_name_arg("Name for the remote")
+ .arg(
+ Arg::new(Self::ARG_URL)
+ .value_name("URL")
+ .index(2)
+ .required(true)
+ .value_parser(clap::value_parser!(Url))
+ .help("Repository URL (e.g. ssh://user@host:port/repository)"),
+ )
+ .arg(
+ Arg::new(Self::ARG_SERVER_KEY)
+ .value_name("SERVER_KEY")
+ .index(3)
+ .required(true)
+ .value_hint(ValueHint::FilePath)
+ .value_parser(clap::value_parser!(PathBuf))
+ .help("Path to server's public key"),
+ )
+ }
+
+ /// Executes the `remote add` command.
+ ///
+ /// Registers the new remote configuration. If the configuration is successful
+ /// and the fetch flag is set, it initiates a fetch operation from the new remote.
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let name = matches
+ .get_one::(Command::ARG_NAME)
+ .unwrap()
+ .to_string();
+
+ let request = AddRequest {
+ name: name.clone(),
+ url: matches.get_one::(Self::ARG_URL).unwrap().clone(),
+ pub_key: matches
+ .get_one::(Self::ARG_SERVER_KEY)
+ .unwrap()
+ .clone(),
+ };
+
+ let handler = container.remote_handler().into_diagnostic()?;
+
+ let response = handler.add(request).into_diagnostic()?;
+
+ println!("{}", response.remote.display_verbose(&name));
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = RemoteAddCommand;
+ assert_eq!(cmd.name(), "add");
+ assert_eq!(cmd.about(), "Add a new remote repository");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/remote/subcommands/get_url.rs b/cli/src/commands/remote/subcommands/get_url.rs
new file mode 100644
index 00000000..0c570ce6
--- /dev/null
+++ b/cli/src/commands/remote/subcommands/get_url.rs
@@ -0,0 +1,96 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgMatches, Command, builder::PossibleValuesParser};
+use engine::{
+ EngineContainer,
+ engine_container::MevaContainer,
+ handlers::remote::{GetUrlRequest, RemoteOperations},
+ network::RemoteDirection,
+};
+use miette::IntoDiagnostic;
+use strum::VariantNames;
+
+use crate::{commands::MevaCommand, extensions::WithName};
+
+/// Implements the `remote get-url` subcommand for Meva DVCS.
+///
+/// This command retrieves and displays the URL associated with a tracked remote.
+/// It allows filtering based on whether the URL is used for fetching or pushing.
+#[derive(Default)]
+pub struct RemoteGetUrlCommand;
+
+impl RemoteGetUrlCommand {
+ /// Argument name for the direction selection (fetch/push).
+ const ARG_DIRECTION: &'static str = "direction";
+}
+
+#[async_trait]
+impl MevaCommand for RemoteGetUrlCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "get-url"
+ }
+
+ fn about(&self) -> &'static str {
+ "Show the URL of a remote"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `remote get-url` command.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_name_arg("Name for the remote")
+ .arg(
+ Arg::new(Self::ARG_DIRECTION)
+ .long(Self::ARG_DIRECTION)
+ .short('d')
+ .value_name("DIRECTION")
+ .default_value("fetch")
+ .value_parser(PossibleValuesParser::new(RemoteDirection::VARIANTS))
+ .help("Select which URL(s) to show"),
+ )
+ }
+
+ /// Executes the `remote get-url` command.
+ ///
+ /// Looks up the specified remote in the configuration and prints the requested URL.
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let direction_str = matches.get_one::(Self::ARG_DIRECTION).unwrap();
+ let request = GetUrlRequest {
+ name: matches
+ .get_one::(Command::ARG_NAME)
+ .unwrap()
+ .clone(),
+ direction: direction_str.parse::().unwrap(),
+ };
+
+ let handler = container.remote_handler().into_diagnostic()?;
+ let response = handler.get_url(request).into_diagnostic()?;
+
+ println!("{}", response.url);
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = RemoteGetUrlCommand;
+ assert_eq!(cmd.name(), "get-url");
+ assert_eq!(cmd.about(), "Show the URL of a remote");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/remote/subcommands/remove.rs b/cli/src/commands/remote/subcommands/remove.rs
new file mode 100644
index 00000000..61c0e238
--- /dev/null
+++ b/cli/src/commands/remote/subcommands/remove.rs
@@ -0,0 +1,78 @@
+use async_trait::async_trait;
+use clap::{ArgMatches, Command};
+use engine::{
+ EngineContainer,
+ engine_container::MevaContainer,
+ handlers::remote::{RemoteOperations, RemoveRequest},
+};
+use miette::IntoDiagnostic;
+
+use crate::{commands::MevaCommand, extensions::WithName};
+
+/// Implements the `remote remove` subcommand for Meva DVCS.
+///
+/// This command removes a remote repository configuration from the local repository.
+/// Once removed, the repository will no longer track changes from that specific remote.
+#[derive(Default)]
+pub struct RemoteRemoveCommand;
+
+#[async_trait]
+impl MevaCommand for RemoteRemoveCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "remove"
+ }
+
+ fn about(&self) -> &'static str {
+ "Remove an existing remote"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `remote remove` command.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_name_arg("Name for the remote")
+ }
+
+ /// Executes the `remote remove` command.
+ ///
+ /// Deletes the configuration for the specified remote name.
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let request = RemoveRequest {
+ name: matches
+ .get_one::(Command::ARG_NAME)
+ .unwrap()
+ .clone(),
+ };
+
+ let handler = container.remote_handler().into_diagnostic()?;
+ let response = handler.remove(request).into_diagnostic()?;
+
+ println!("{}", response.removed_value);
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = RemoteRemoveCommand;
+ assert_eq!(cmd.name(), "remove");
+ assert_eq!(cmd.about(), "Remove an existing remote");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/remote/subcommands/rename.rs b/cli/src/commands/remote/subcommands/rename.rs
new file mode 100644
index 00000000..08b5aec3
--- /dev/null
+++ b/cli/src/commands/remote/subcommands/rename.rs
@@ -0,0 +1,108 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgMatches, Command};
+use engine::{
+ EngineContainer,
+ engine_container::MevaContainer,
+ handlers::remote::{RemoteOperations, RenameRequest},
+};
+use miette::IntoDiagnostic;
+
+use crate::commands::MevaCommand;
+
+/// Implements the `remote rename` subcommand for Meva DVCS.
+///
+/// This command updates the identifier of an existing remote repository.
+/// It changes the name used to reference the remote in other commands
+/// (like fetch or push) without altering the remote URL itself.
+#[derive(Default)]
+pub struct RemoteRenameCommand;
+
+impl RemoteRenameCommand {
+ /// Argument name for the new name of the remote.
+ const ARG_NEW_NAME: &'static str = "new-name";
+
+ /// Argument name for the current (old) name of the remote.
+ const ARG_OLD_NAME: &'static str = "old-name";
+}
+
+#[async_trait]
+impl MevaCommand for RemoteRenameCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "rename"
+ }
+
+ fn about(&self) -> &'static str {
+ "Rename a remote"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `remote rename` command.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_OLD_NAME)
+ .value_name("OLD_NAME")
+ .index(1)
+ .required(true)
+ .help("Current name of the remote"),
+ )
+ .arg(
+ Arg::new(Self::ARG_NEW_NAME)
+ .value_name("NEW_NAME")
+ .index(2)
+ .required(true)
+ .help("New name for the remote"),
+ )
+ }
+
+ /// Executes the `remote rename` command.
+ ///
+ /// Validates that the old name exists and the new name is not already taken,
+ /// then updates the repository configuration to reflect the name change.
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let request = RenameRequest {
+ old_name: matches
+ .get_one::(Self::ARG_OLD_NAME)
+ .unwrap()
+ .clone(),
+ new_name: matches
+ .get_one::(Self::ARG_NEW_NAME)
+ .unwrap()
+ .clone(),
+ };
+
+ let handler = container.remote_handler().into_diagnostic()?;
+ let response = handler.rename(request).into_diagnostic()?;
+
+ println!(
+ "Remote renamed: {} -> {}",
+ response.old_name, response.new_name
+ );
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = RemoteRenameCommand;
+ assert_eq!(cmd.name(), "rename");
+ assert_eq!(cmd.about(), "Rename a remote");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/remote/subcommands/set_url.rs b/cli/src/commands/remote/subcommands/set_url.rs
new file mode 100644
index 00000000..f2674383
--- /dev/null
+++ b/cli/src/commands/remote/subcommands/set_url.rs
@@ -0,0 +1,129 @@
+use std::path::PathBuf;
+
+use async_trait::async_trait;
+use clap::{Arg, ArgMatches, Command, ValueHint, builder::PossibleValuesParser};
+use engine::{
+ EngineContainer,
+ engine_container::MevaContainer,
+ handlers::remote::{RemoteOperations, SetUrlRequest},
+ network::RemoteDirection,
+};
+use miette::IntoDiagnostic;
+use strum::VariantNames;
+use url::Url;
+
+use crate::{commands::MevaCommand, extensions::WithName};
+
+/// Implements the `remote set-url` subcommand for Meva DVCS.
+///
+/// This command updates the URL for an existing remote repository.
+/// It supports changing either the fetch URL (default) or the push URL,
+/// and can selectively replace a specific URL if the remote has multiple.
+#[derive(Default)]
+pub struct RemoteSetUrlCommand;
+
+impl RemoteSetUrlCommand {
+ /// Argument name for the direction selection (fetch/push).
+ const ARG_DIRECTION: &'static str = "direction";
+
+ /// Argument name for the new URL.
+ const ARG_NEW_URL: &'static str = "new-url";
+
+ /// Argument name for specifying the server public key.
+ const ARG_NEW_SERVER_KEY: &'static str = "new-server-key";
+}
+
+#[async_trait]
+impl MevaCommand for RemoteSetUrlCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "set-url"
+ }
+
+ fn about(&self) -> &'static str {
+ "Set the URL of a remote"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `remote set-url` command.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_name_arg("Name for the remote")
+ .arg(
+ Arg::new(Self::ARG_NEW_URL)
+ .value_name("NEW_URL")
+ .index(2)
+ .required(true)
+ .value_parser(clap::value_parser!(Url))
+ .help("New repository URL (e.g. ssh://user@host:port/repository)"),
+ )
+ .arg(
+ Arg::new(Self::ARG_NEW_SERVER_KEY)
+ .value_name("NEW_SERVER_KEY")
+ .index(3)
+ .required(true)
+ .value_hint(ValueHint::FilePath)
+ .value_parser(clap::value_parser!(PathBuf))
+ .help("Path to new server's public key"),
+ )
+ .arg(
+ Arg::new(Self::ARG_DIRECTION)
+ .long(Self::ARG_DIRECTION)
+ .short('d')
+ .value_name("DIRECTION")
+ .default_value("fetch")
+ .value_parser(PossibleValuesParser::new(RemoteDirection::VARIANTS))
+ .help("Select which URL(s) to show"),
+ )
+ }
+
+ /// Executes the `remote set-url` command.
+ ///
+ /// Updates the configuration for the specified remote.
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let direction_str = matches.get_one::(Self::ARG_DIRECTION).unwrap();
+
+ let request = SetUrlRequest {
+ name: matches
+ .get_one::(Command::ARG_NAME)
+ .unwrap()
+ .clone(),
+ new_url: matches.get_one::(Self::ARG_NEW_URL).unwrap().clone(),
+ new_server_key: matches
+ .get_one::(Self::ARG_NEW_SERVER_KEY)
+ .unwrap()
+ .clone(),
+ direction: direction_str.parse::().unwrap(),
+ };
+
+ let handler = container.remote_handler().into_diagnostic()?;
+ handler.set_url(request).into_diagnostic()?;
+
+ println!("Remote URL changed successfully.");
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = RemoteSetUrlCommand;
+ assert_eq!(cmd.name(), "set-url");
+ assert_eq!(cmd.about(), "Set the URL of a remote");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/remote/subcommands/show.rs b/cli/src/commands/remote/subcommands/show.rs
new file mode 100644
index 00000000..cc6536dc
--- /dev/null
+++ b/cli/src/commands/remote/subcommands/show.rs
@@ -0,0 +1,100 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command};
+use engine::{
+ EngineContainer,
+ engine_container::MevaContainer,
+ handlers::remote::{RemoteOperations, ShowRequest},
+};
+use miette::IntoDiagnostic;
+use owo_colors::OwoColorize;
+
+use crate::{
+ commands::MevaCommand,
+ extensions::{WithName, WithVerbose},
+};
+
+/// Implements the `remote show` subcommand for Meva DVCS.
+///
+/// This command displays detailed information about a specific remote repository,
+/// such as its URLs and the status of tracked branches. It can optionally retrieve
+/// live data from the remote or rely solely on local configuration.
+#[derive(Default)]
+pub struct RemoteShowCommand;
+
+impl RemoteShowCommand {
+ /// Argument name for the no-fetch flag.
+ const ARG_NO_FETCH: &'static str = "no-fetch";
+}
+
+#[async_trait]
+impl MevaCommand for RemoteShowCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "show"
+ }
+
+ fn about(&self) -> &'static str {
+ "Show the URL of a remote"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `remote show` command.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .with_name_arg("Name for the remote")
+ .with_verbose_arg("Enable verbose output")
+ .arg(
+ Arg::new(Self::ARG_NO_FETCH)
+ .short('n')
+ .long("no-fetch")
+ .action(ArgAction::SetTrue)
+ .help("Use local configuration for tracked branches"),
+ )
+ }
+
+ /// Executes the `remote show` command.
+ ///
+ /// Retrieves and prints details about the specified remote.
+ /// Unless `--no-fetch` is specified, this command may attempt to contact
+ /// the remote server to display the most up-to-date branch status.
+ async fn execute(
+ &self,
+ matches: &ArgMatches,
+ container: &Self::Container,
+ ) -> miette::Result<()> {
+ let name = matches.get_one::(Command::ARG_NAME).unwrap();
+
+ let request = ShowRequest {
+ name: name.clone(),
+ no_fetch: matches.get_flag(Self::ARG_NO_FETCH),
+ verbose: matches.get_flag(Command::ARG_VERBOSE),
+ };
+
+ let handler = container.remote_handler().into_diagnostic()?;
+ let response = handler.show(request).await.into_diagnostic()?;
+
+ println!("* Remote {}", name.bold());
+ println!("{response}");
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = RemoteShowCommand;
+ assert_eq!(cmd.name(), "show");
+ assert_eq!(cmd.about(), "Show the URL of a remote");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/restore.rs b/cli/src/commands/restore.rs
new file mode 100644
index 00000000..bec2131a
--- /dev/null
+++ b/cli/src/commands/restore.rs
@@ -0,0 +1,121 @@
+use crate::commands::MevaCommand;
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command, value_parser};
+use engine::engine_container::{EngineContainer, MevaContainer};
+use engine::handlers::restore::Request;
+use engine::revision_parsing::Revision;
+use miette::{IntoDiagnostic, Result};
+use std::path::PathBuf;
+
+/// CLI command for restoring files in the working tree or staging area.
+///
+/// The [RestoreCommand] allows users to restore files from a specific snapshot (commit)
+/// either to the working directory, the staging area, or both.
+///
+/// # Supported arguments
+/// - **`--staged`**: Restore changes in the staging area (index).
+/// - **`--worktree`**: Restore changes in the working tree.
+/// - **`--source `**: Specify the source snapshot (commit) to restore from.
+/// Defaults to `HEAD` if not provided.
+/// - **``**: Optional list of file or directory paths to restore.
+/// If omitted, the entire repository is restored.
+#[derive(Default)]
+pub struct RestoreCommand;
+
+impl RestoreCommand {
+ /// `--staged` flag key.
+ const ARG_STAGED: &'static str = "staged";
+
+ /// `--worktree` flag key.
+ const ARG_WORKTREE: &'static str = "worktree";
+
+ /// `--source` option key.
+ const ARG_SOURCE: &'static str = "source";
+
+ /// `` argument key.
+ const ARG_PATHS: &'static str = "paths";
+}
+
+#[async_trait]
+impl MevaCommand for RestoreCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "restore"
+ }
+ fn about(&self) -> &'static str {
+ "Restore files in the working tree or staging area from a snapshot"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the underlying Clap [`Command`] definition for this command.
+ ///
+ /// This defines supported flags, arguments, and default behaviors
+ /// for restoring files from a snapshot.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_STAGED)
+ .long(Self::ARG_STAGED)
+ .help("Restore changes in the staging area (index)")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_WORKTREE)
+ .long(Self::ARG_WORKTREE)
+ .help("Restore changes in the working tree")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_SOURCE)
+ .value_name("SOURCE")
+ .long(Self::ARG_SOURCE)
+ .help("Specify the source snapshot (commit) to restore from. Defaults to HEAD.")
+ .default_value("HEAD")
+ .value_parser(value_parser!(Revision)),
+ )
+ .arg(
+ Arg::new(Self::ARG_PATHS)
+ .value_name("PATHS")
+ .help("Optional paths to restore. If not specified, the whole repository is restored.")
+ .num_args(0..)
+ .last(true),
+ )
+ }
+
+ /// Executes the `restore` command.
+ ///
+ /// - Reads all flags and arguments from `matches`.
+ /// - Constructs a [`Request`] with the selected restore options.
+ /// - Delegates to the repository’s [`restore_handler`] to perform the restore operation.
+ ///
+ /// Returns a [`miette::Result`] with diagnostic information if an error occurs.
+ async fn execute(&self, matches: &ArgMatches, container: &MevaContainer) -> Result<()> {
+ let staged = matches.get_flag(Self::ARG_STAGED);
+ let worktree = matches.get_flag(Self::ARG_WORKTREE);
+ let source = matches
+ .get_one::(Self::ARG_SOURCE)
+ .cloned()
+ .unwrap();
+ let paths = match matches.get_many::(Self::ARG_PATHS) {
+ Some(vals) => vals.map(PathBuf::from).collect(),
+ None => Vec::new(),
+ };
+
+ let handler = container.restore_handler().into_diagnostic()?;
+
+ let request = Request {
+ staged,
+ worktree,
+ source,
+ paths,
+ };
+
+ handler.handle_restore(request).into_diagnostic()?;
+
+ Ok(())
+ }
+}
diff --git a/cli/src/commands/show.rs b/cli/src/commands/show.rs
new file mode 100644
index 00000000..ed9f1da1
--- /dev/null
+++ b/cli/src/commands/show.rs
@@ -0,0 +1,227 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgGroup, ArgMatches, Command, value_parser};
+use engine::{
+ EngineContainer,
+ diff_builder::ChangeKind,
+ engine_container::MevaContainer,
+ handlers::show::{PatchMode, Request, Response},
+ revision_parsing::Revision,
+};
+use miette::{IntoDiagnostic, Result};
+
+use crate::commands::MevaCommand;
+
+/// Implements the `show` command for Meva DVCS.
+///
+/// Displays information about a specific snapshot (commit) in the repository.
+#[derive(Default)]
+pub struct ShowCommand;
+
+impl ShowCommand {
+ /// Argument name for specifying the snapshot identifier to display.
+ const ARG_SNAPSHOT_ID: &'static str = "snapshot-id";
+
+ /// Argument name for the `--patch` flag.
+ /// Displays the patch (diff) between the selected snapshot and its parent.
+ const ARG_PATCH: &'static str = "patch";
+
+ /// Argument name for the `--no-patch` flag.
+ /// Shows only the snapshot header (author, date, message) without the diff.
+ const ARG_NO_PATCH: &'static str = "no-patch";
+
+ /// Argument name for the `--name-only` flag.
+ /// Displays only the names of modified files in the snapshot.
+ const ARG_NAME_ONLY: &'static str = "name-only";
+
+ /// Argument name for the `--name-status` flag.
+ /// Displays modified file names along with their change types (A, M, D).
+ const ARG_NAME_STATUS: &'static str = "name-status";
+
+ /// Argument name for the `--stat` flag.
+ /// Displays a summary with the number of changed lines per file.
+ const ARG_STAT: &'static str = "stat";
+
+ /// Helper method for rendering the `Response` object depending on the selected `PatchMode`.
+ ///
+ /// This function handles multiple display modes:
+ /// - [PatchMode::Patch]: shows unified diffs or per-file diffs.
+ /// - [PatchMode::NameOnly]: prints only filenames.
+ /// - [PatchMode::NameStatus]: prints filenames with change kinds.
+ /// - [PatchMode::Stat]: prints summary statistics.
+ fn display_response(&self, mode: &PatchMode, response: &Response) {
+ println!("{}", response.snapshot);
+
+ match mode {
+ PatchMode::Patch => self.display_patch(response),
+ PatchMode::NameOnly => self.display_name_only(response),
+ PatchMode::NameStatus => self.display_name_status(response),
+ PatchMode::Stat => self.display_stat(response),
+ _ => (),
+ };
+ }
+
+ /// Shows unified diffs or per-file diffs.
+ fn display_patch(&self, response: &Response) {
+ if let Some(files) = &response.files {
+ for file in files {
+ file.display_full();
+ }
+ }
+ }
+
+ /// Prints only filenames.
+ fn display_name_only(&self, response: &Response) {
+ if let Some(files) = &response.files {
+ for file in files {
+ println!("{}", file.path().display());
+ }
+ }
+ }
+
+ /// Prints filenames with change kinds.
+ fn display_name_status(&self, response: &Response) {
+ if let Some(files) = &response.files {
+ for file in files {
+ println!(
+ "{}\t{}",
+ ChangeKind::from(&file.kind),
+ file.path().display()
+ );
+ }
+ }
+ }
+
+ /// Prints summary statistics.
+ fn display_stat(&self, response: &Response) {
+ if let Some(stat) = &response.stat {
+ println!("{stat}");
+ }
+ }
+}
+
+#[async_trait]
+impl MevaCommand for ShowCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "show"
+ }
+
+ fn about(&self) -> &'static str {
+ "Show information about a snapshot"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI command structure for the `show` command.
+ ///
+ /// Defines options controlling the output format and filtering behavior:
+ /// - `--patch` (default) displays the diff.
+ /// - `--no-patch` hides diff output.
+ /// - `--name-only` and `--name-status` show affected files in different formats.
+ /// - `--stat` displays change statistics.
+ ///
+ /// Uses `ArgGroup` to make these format options mutually exclusive.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_SNAPSHOT_ID)
+ .value_name("SNAPSHOT_ID")
+ .help("The snapshot identifier")
+ .default_value("HEAD")
+ .value_parser(value_parser!(Revision))
+ .index(1),
+ )
+ .arg(
+ Arg::new(Self::ARG_PATCH)
+ .short('p')
+ .long(Self::ARG_PATCH)
+ .help("Show the patch (diff) between the snapshot and its parent")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_NO_PATCH)
+ .long(Self::ARG_NO_PATCH)
+ .help("Show only the snapshot header (author, date, message), without the diff")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_NAME_ONLY)
+ .long(Self::ARG_NAME_ONLY)
+ .help("List only the files modified in the snapshot")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_NAME_STATUS)
+ .long(Self::ARG_NAME_STATUS)
+ .help("Show the list of files with the type of change (A, M, D)")
+ .action(ArgAction::SetTrue),
+ )
+ .arg(
+ Arg::new(Self::ARG_STAT)
+ .long(Self::ARG_STAT)
+ .help("Add statistics about the number of changed lines for each file")
+ .action(ArgAction::SetTrue),
+ )
+ .group(
+ ArgGroup::new("format")
+ .args([
+ Self::ARG_PATCH,
+ Self::ARG_NO_PATCH,
+ Self::ARG_NAME_ONLY,
+ Self::ARG_NAME_STATUS,
+ Self::ARG_STAT,
+ ])
+ .multiple(false),
+ )
+ }
+
+ /// Executes the `show` command.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ let snapshot_id = matches.get_one::(Self::ARG_SNAPSHOT_ID).unwrap();
+
+ let handler = container.show_handler().into_diagnostic()?;
+
+ let mode = if matches.get_flag(Self::ARG_PATCH) {
+ PatchMode::Patch
+ } else if matches.get_flag(Self::ARG_NO_PATCH) {
+ PatchMode::NoPatch
+ } else if matches.get_flag(Self::ARG_NAME_ONLY) {
+ PatchMode::NameOnly
+ } else if matches.get_flag(Self::ARG_NAME_STATUS) {
+ PatchMode::NameStatus
+ } else if matches.get_flag(Self::ARG_STAT) {
+ PatchMode::Stat
+ } else {
+ PatchMode::Patch
+ };
+
+ let request = Request {
+ snapshot_id: snapshot_id.clone(),
+ mode,
+ };
+
+ let response = handler.handle_show(request).into_diagnostic()?;
+
+ self.display_response(&mode, &response);
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = ShowCommand;
+ assert_eq!(cmd.name(), "show");
+ assert_eq!(cmd.about(), "Show information about a snapshot");
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/commands/status.rs b/cli/src/commands/status.rs
new file mode 100644
index 00000000..3ee3a435
--- /dev/null
+++ b/cli/src/commands/status.rs
@@ -0,0 +1,130 @@
+use async_trait::async_trait;
+use clap::{Arg, ArgAction, ArgMatches, Command};
+use engine::{EngineContainer, engine_container::MevaContainer, handlers::status::Request};
+
+use crate::commands::MevaCommand;
+
+use miette::{IntoDiagnostic, Result};
+
+/// Implements the `status` command for Meva DVCS.
+///
+/// Displays the current working tree status, including tracked, untracked,
+/// and ignored files. Supports short output format and branch information.
+#[derive(Default)]
+pub struct StatusCommand;
+
+impl StatusCommand {
+ /// Argument name for enabling short format (`-s` / `--short`).
+ const ARG_SHORT: &'static str = "short";
+
+ /// Argument name for showing branch information (`-b` / `--branch`).
+ const ARG_BRANCH: &'static str = "branch";
+
+ /// Argument name for hiding branch information (`--no-branch`).
+ const ARG_NO_BRANCH: &'static str = "no-branch";
+
+ /// Argument name for including ignored files in the output (`-i` / `--ignored`).
+ const ARG_IGNORED: &'static str = "ignored";
+}
+
+#[async_trait]
+impl MevaCommand for StatusCommand {
+ type Container = MevaContainer;
+
+ fn name(&self) -> &'static str {
+ "status"
+ }
+
+ fn about(&self) -> &'static str {
+ "Display the current state of the working directory"
+ }
+
+ fn version(&self) -> &'static str {
+ "1.0.0"
+ }
+
+ /// Builds the CLI argument parser for the `status` command using `clap`.
+ ///
+ /// This command supports several flags:
+ /// - `-s, --short` – Display output in short format.
+ /// - `-b, --branch` – Include branch and tracking information.
+ /// - `--no-branch` – Suppress branch and tracking info.
+ /// - `-u, --untracked` – Include untracked files in output.
+ /// - `-i, --ignored` – Include ignored files in output.
+ ///
+ /// Conflicts:
+ /// - `--branch` and `--no-branch` cannot be used together.
+ fn build_command(&self) -> Command {
+ self.build_base_command()
+ .arg(
+ Arg::new(Self::ARG_SHORT)
+ .short('s')
+ .long(Self::ARG_SHORT)
+ .action(ArgAction::SetTrue)
+ .help("Give the output in the short-format"),
+ )
+ .arg(
+ Arg::new(Self::ARG_BRANCH)
+ .short('b')
+ .long(Self::ARG_BRANCH)
+ .action(ArgAction::SetTrue)
+ .help("Show the branch and tracking info"),
+ )
+ .arg(
+ Arg::new(Self::ARG_NO_BRANCH)
+ .long(Self::ARG_NO_BRANCH)
+ .action(ArgAction::SetTrue)
+ .conflicts_with(Self::ARG_BRANCH)
+ .help("Do not show the branch and tracking info"),
+ )
+ .arg(
+ Arg::new(Self::ARG_IGNORED)
+ .short('i')
+ .long(Self::ARG_IGNORED)
+ .action(ArgAction::SetTrue)
+ .help("Show ignored files"),
+ )
+ }
+
+ /// Executes the `status` command.
+ async fn execute(&self, matches: &ArgMatches, container: &Self::Container) -> Result<()> {
+ let request = Request::from_flags(
+ matches.get_flag(Self::ARG_SHORT),
+ matches.get_flag(Self::ARG_BRANCH),
+ matches.get_flag(Self::ARG_NO_BRANCH),
+ matches.get_flag(Self::ARG_IGNORED),
+ );
+
+ let short_format = request.short_format;
+ let show_branch = request.show_branch;
+
+ let handler = container.status_handler().into_diagnostic()?;
+
+ let response = handler.handle_status(request.clone()).into_diagnostic()?;
+
+ println!(
+ "{}",
+ response.render_status(Some(short_format), Some(show_branch))
+ );
+
+ Ok(())
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ #[rstest]
+ fn test_command_name_about_version() {
+ let cmd = StatusCommand;
+ assert_eq!(cmd.name(), "status");
+ assert_eq!(
+ cmd.about(),
+ "Display the current state of the working directory"
+ );
+ assert_eq!(cmd.version(), "1.0.0");
+ }
+}
diff --git a/cli/src/extensions.rs b/cli/src/extensions.rs
new file mode 100644
index 00000000..da95e640
--- /dev/null
+++ b/cli/src/extensions.rs
@@ -0,0 +1,5 @@
+pub mod arg_matches;
+pub mod command;
+
+pub use arg_matches::*;
+pub use command::*;
diff --git a/cli/src/extensions/arg_matches.rs b/cli/src/extensions/arg_matches.rs
new file mode 100644
index 00000000..37e1a44d
--- /dev/null
+++ b/cli/src/extensions/arg_matches.rs
@@ -0,0 +1,3 @@
+pub mod location_selection;
+
+pub use location_selection::LocationSelection;
diff --git a/cli/src/extensions/arg_matches/location_selection.rs b/cli/src/extensions/arg_matches/location_selection.rs
new file mode 100644
index 00000000..6eee4ff5
--- /dev/null
+++ b/cli/src/extensions/arg_matches/location_selection.rs
@@ -0,0 +1,79 @@
+use std::path::PathBuf;
+
+use clap::{ArgMatches, Command};
+
+use engine::ConfigLocation;
+
+use crate::extensions::WithLocations;
+
+/// Trait to extract the chosen configuration source from CLI matches.
+///
+/// Provides a method to map parsed arguments into a `ConfigLocation` enum.
+pub trait LocationSelection {
+ /// Inspect parsed arguments and return the corresponding `ConfigLocation`.
+ fn get_config_location(&self) -> ConfigLocation;
+}
+
+impl LocationSelection for ArgMatches {
+ fn get_config_location(&self) -> ConfigLocation {
+ if self.get_flag(Command::ARG_GLOBAL) {
+ ConfigLocation::Global
+ } else if self.get_flag(Command::ARG_LOCAL) {
+ ConfigLocation::Local
+ } else if let Some(path) = self.get_one::(Command::ARG_FILE) {
+ ConfigLocation::File(path.clone())
+ } else {
+ // Default fallback when no location is explicitly specified
+ ConfigLocation::Local
+ }
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use crate::extensions::WithLocations;
+ use pretty_assertions::assert_eq;
+ use rstest::rstest;
+
+ fn build_command() -> Command {
+ Command::new("cmd").with_location_args(
+ "use global config",
+ "use local config",
+ "use custom config file",
+ )
+ }
+
+ fn get_matches(args: &[&str]) -> ArgMatches {
+ build_command()
+ .try_get_matches_from(std::iter::once("cmd").chain(args.iter().copied()))
+ .unwrap()
+ }
+
+ #[rstest]
+ fn returns_global_location() {
+ let matches = get_matches(&["--global"]);
+ assert_eq!(matches.get_config_location(), ConfigLocation::Global);
+ }
+
+ #[rstest]
+ fn returns_local_location() {
+ let matches = get_matches(&["--local"]);
+ assert_eq!(matches.get_config_location(), ConfigLocation::Local);
+ }
+
+ #[rstest]
+ fn returns_file_location() {
+ let matches = get_matches(&["--file", "custom.toml"]);
+ assert_eq!(
+ matches.get_config_location(),
+ ConfigLocation::File(PathBuf::from("custom.toml")),
+ );
+ }
+
+ #[rstest]
+ fn returns_local_as_default_when_nothing_given() {
+ let matches = get_matches(&[]);
+ assert_eq!(matches.get_config_location(), ConfigLocation::Local);
+ }
+}
diff --git a/cli/src/extensions/command.rs b/cli/src/extensions/command.rs
new file mode 100644
index 00000000..6e6946cb
--- /dev/null
+++ b/cli/src/extensions/command.rs
@@ -0,0 +1,17 @@
+mod with_command_and_plugin;
+mod with_file;
+mod with_key;
+mod with_locations;
+mod with_name;
+mod with_pattern;
+mod with_scope;
+mod with_verbose;
+
+pub use with_command_and_plugin::WithCommandPlugin;
+pub use with_file::WithFile;
+pub use with_key::WithKey;
+pub use with_locations::WithLocations;
+pub use with_name::WithName;
+pub use with_pattern::WithPattern;
+pub use with_scope::WithScope;
+pub use with_verbose::WithVerbose;
diff --git a/cli/src/extensions/command/with_command_and_plugin.rs b/cli/src/extensions/command/with_command_and_plugin.rs
new file mode 100644
index 00000000..f4e0327d
--- /dev/null
+++ b/cli/src/extensions/command/with_command_and_plugin.rs
@@ -0,0 +1,61 @@
+use clap::{Arg, Command, builder::PossibleValuesParser};
+use plugins::CommandType;
+use strum::VariantNames;
+
+/// Trait to add required `command` and `plugin` arguments to a Clap command.
+///
+/// This allows CLI commands to explicitly specify which command type and plugin
+/// they want to operate on.
+pub trait WithCommandPlugin {
+ /// Constant name of the CLI argument for the command.
+ const ARG_COMMAND: &'static str;
+
+ /// Constant name of the CLI argument for the plugin.
+ const ARG_PLUGIN: &'static str;
+
+ /// Extends a `Command` by adding the `command` and `plugin` positional arguments.
+ ///
+ /// # Arguments
+ ///
+ /// * `self` – The command being extended.
+ /// * `command_help` – Help message describing the purpose of the `command` argument.
+ /// * `plugin_help` – Help message describing the purpose of the `plugin` argument.
+ ///
+ /// # Returns
+ ///
+ /// The original [`Command`] with both `command` and `plugin` arguments appended.
+ fn with_command_and_plugin_arg(
+ self,
+ command_help: &'static str,
+ plugin_help: &'static str,
+ ) -> Self;
+}
+
+impl WithCommandPlugin for Command {
+ const ARG_COMMAND: &'static str = "command";
+
+ const ARG_PLUGIN: &'static str = "plugin";
+
+ fn with_command_and_plugin_arg(
+ self,
+ command_help: &'static str,
+ plugin_help: &'static str,
+ ) -> Self {
+ self.arg(
+ Arg::new(Self::ARG_COMMAND)
+ .value_name("COMMAND")
+ .index(1)
+ .required(true)
+ // Restricts values to the variants of `CommandType`
+ .value_parser(PossibleValuesParser::new(CommandType::VARIANTS))
+ .help(command_help),
+ )
+ .arg(
+ Arg::new(Self::ARG_PLUGIN)
+ .value_name("PLUGIN")
+ .index(2)
+ .required(true)
+ .help(plugin_help),
+ )
+ }
+}
diff --git a/cli/src/extensions/command/with_file.rs b/cli/src/extensions/command/with_file.rs
new file mode 100644
index 00000000..72bc96fc
--- /dev/null
+++ b/cli/src/extensions/command/with_file.rs
@@ -0,0 +1,89 @@
+use std::path::PathBuf;
+
+use clap::{Arg, Command, ValueHint};
+
+/// Trait to add an optional `file` argument to a Clap command.
+pub trait WithFile {
+ /// Constant name of the CLI argument for the key.
+ const ARG_FILE: &'static str;
+
+ /// Extends a `Command` by adding a `file` argument with the provided help text.
+ ///
+ /// # Arguments
+ ///
+ /// * `self` - The command being extended.
+ /// * `file_help` - Help message describing the purpose of the `file` argument.
+ ///
+ /// # Returns
+ ///
+ /// The original `Command` with the `file` argument appended.
+ fn with_file_arg(self, key_help: &'static str) -> Self;
+}
+
+impl WithFile for Command {
+ const ARG_FILE: &'static str = "file";
+
+ fn with_file_arg(self, file_help: &'static str) -> Self {
+ self.arg(
+ Arg::new(Self::ARG_FILE)
+ .short('f')
+ .long(Self::ARG_FILE)
+ .value_name("FILE")
+ .value_parser(clap::value_parser!(PathBuf))
+ .value_hint(ValueHint::FilePath)
+ .help(file_help),
+ )
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use clap::Command;
+ use pretty_assertions::assert_eq;
+ use rstest::{fixture, rstest};
+ use std::path::PathBuf;
+
+ #[fixture]
+ fn cmd() -> Command {
+ Command::new("cli").with_file_arg("help text")
+ }
+
+ #[rstest]
+ fn adds_argument_with_correct_properties(cmd: Command) {
+ let arg = cmd
+ .get_arguments()
+ .find(|a| a.get_id() == "file")
+ .expect("Argument should exist");
+
+ assert_eq!(arg.get_short(), Some('f'));
+ assert_eq!(arg.get_long(), Some("file"));
+ assert_eq!(
+ arg.get_value_names().unwrap().iter().next().unwrap(),
+ "FILE"
+ );
+ }
+
+ #[rstest]
+ #[case(vec!["cli", "-f", "path/to.x"], Some("path/to.x"))]
+ #[case(vec!["cli", "--file", "other/file.y"], Some("other/file.y"))]
+ #[case(vec!["cli"], None)]
+ fn yields_file_arg_as_pathbuf(
+ #[case] args: Vec<&str>,
+ #[case] expected: Option<&str>,
+ cmd: Command,
+ ) {
+ let matches = cmd.clone().try_get_matches_from(args).unwrap();
+ let got: Option<&PathBuf> = matches.get_one("file");
+
+ match expected {
+ Some(file) => {
+ let want = PathBuf::from(file);
+ assert_eq!(got.unwrap(), &want);
+ }
+ None => {
+ assert!(got.is_none());
+ }
+ }
+ }
+}
diff --git a/cli/src/extensions/command/with_key.rs b/cli/src/extensions/command/with_key.rs
new file mode 100644
index 00000000..a0a35dbb
--- /dev/null
+++ b/cli/src/extensions/command/with_key.rs
@@ -0,0 +1,76 @@
+use clap::{Arg, Command};
+
+/// Trait to add a required `key` argument to a Clap command.
+pub trait WithKey {
+ /// Constant name of the CLI argument for the key.
+ const ARG_KEY: &'static str;
+
+ /// Extends a `Command` by adding a positional `key` argument with the given help text.
+ ///
+ /// # Arguments
+ ///
+ /// * `self` - The command being extended.
+ /// * `key_help` - Help message describing the purpose of the `key` argument.
+ ///
+ /// # Returns
+ ///
+ /// The original `Command` with the `key` argument appended.
+ fn with_key_arg(self, key_help: &'static str) -> Self;
+}
+
+impl WithKey for Command {
+ const ARG_KEY: &'static str = "key";
+
+ fn with_key_arg(self, key_help: &'static str) -> Self {
+ self.arg(
+ Arg::new(Self::ARG_KEY)
+ .value_name("KEY")
+ .help(key_help)
+ .required(true)
+ .index(1),
+ )
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use clap::Command;
+ use pretty_assertions::assert_eq;
+ use rstest::{fixture, rstest};
+
+ #[fixture]
+ fn cmd() -> Command {
+ Command::new("cmd").with_key_arg("help text")
+ }
+
+ #[rstest]
+ fn adds_argument_with_correct_properties(cmd: Command) {
+ let arg = cmd
+ .get_positionals()
+ .find(|a| a.get_id() == "key")
+ .expect("Argument should exist");
+
+ assert!(arg.is_required_set());
+ assert_eq!(arg.get_index(), Some(1));
+ assert_eq!(arg.get_value_names().unwrap().iter().next().unwrap(), "KEY");
+ }
+
+ #[rstest]
+ #[case(vec!["cmd", "secret-key"], Some("secret-key"))]
+ #[case(vec!["cmd"], None)]
+ fn yields_key_arg(#[case] args: Vec<&str>, #[case] expected: Option<&str>, cmd: Command) {
+ let matches = cmd.clone().try_get_matches_from(args);
+
+ match expected {
+ Some(key) => {
+ let m = matches.unwrap();
+ let got: &String = m.get_one("key").expect("Should have value");
+ assert_eq!(got, key);
+ }
+ None => {
+ assert!(matches.is_err());
+ }
+ }
+ }
+}
diff --git a/cli/src/extensions/command/with_locations.rs b/cli/src/extensions/command/with_locations.rs
new file mode 100644
index 00000000..25f99015
--- /dev/null
+++ b/cli/src/extensions/command/with_locations.rs
@@ -0,0 +1,151 @@
+use std::path::PathBuf;
+
+use clap::{Arg, ArgAction, ArgGroup, Command, ValueHint};
+
+/// Trait for adding CLI flags or options to select configuration source locations.
+///
+/// Provides argument names and a convenience method to attach mutually-exclusive
+/// options for global, local, or explicit file configurations.
+pub trait WithLocations {
+ /// Argument name for the global location flag.
+ const ARG_GLOBAL: &'static str;
+
+ /// Argument name for the local location flag.
+ const ARG_LOCAL: &'static str;
+
+ /// Argument name for the custom location flag
+ const ARG_FILE: &'static str;
+
+ /// Extend a `Command` with location-selection arguments.
+ ///
+ /// # Arguments
+ ///
+ /// * `self` - The `Command` to augment.
+ /// * `global_help` - Help text for the global flag.
+ /// * `local_help` - Help text for the local flag.
+ /// * `file_help` - Help text for the file option.
+ ///
+ /// # Returns
+ ///
+ /// The updated `Command` with global, local, and file options,
+ /// constrained to be mutually exclusive, grouped under "location".
+ fn with_location_args(
+ self,
+ global_help: &'static str,
+ local_help: &'static str,
+ file_help: &'static str,
+ ) -> Self;
+}
+
+impl WithLocations for Command {
+ const ARG_GLOBAL: &'static str = "global";
+
+ const ARG_LOCAL: &'static str = "local";
+
+ const ARG_FILE: &'static str = "file";
+
+ fn with_location_args(
+ self,
+ global_help: &'static str,
+ local_help: &'static str,
+ file_help: &'static str,
+ ) -> Self {
+ self.arg(
+ Arg::new(Self::ARG_GLOBAL)
+ .short('g')
+ .long(Self::ARG_GLOBAL)
+ .help(global_help)
+ .action(ArgAction::SetTrue)
+ // Cannot be used with local or file
+ .conflicts_with_all([Self::ARG_LOCAL, Self::ARG_FILE]),
+ )
+ .arg(
+ Arg::new(Self::ARG_LOCAL)
+ .short('l')
+ .long(Self::ARG_LOCAL)
+ .help(local_help)
+ .action(ArgAction::SetTrue)
+ // Cannot be used with global or file
+ .conflicts_with_all([Self::ARG_GLOBAL, Self::ARG_FILE]),
+ )
+ .arg(
+ Arg::new(Self::ARG_FILE)
+ .short('f')
+ .long(Self::ARG_FILE)
+ .value_name("FILE")
+ .help(file_help)
+ .value_hint(ValueHint::FilePath)
+ .value_parser(clap::value_parser!(PathBuf))
+ // Cannot be used with global or local
+ .conflicts_with_all([Self::ARG_GLOBAL, Self::ARG_LOCAL]),
+ )
+ .group(
+ ArgGroup::new("location")
+ .args([Self::ARG_GLOBAL, Self::ARG_LOCAL, Self::ARG_FILE])
+ .required(false),
+ )
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use clap::error::ErrorKind;
+ use pretty_assertions::assert_eq;
+ use rstest::{fixture, rstest};
+
+ #[fixture]
+ fn cmd() -> Command {
+ Command::new("cmd").with_location_args("global help", "local help", "file help")
+ }
+
+ #[rstest]
+ fn test_global_flag(cmd: Command) {
+ let matches = cmd.try_get_matches_from(vec!["cmd", "--global"]).unwrap();
+ assert!(matches.get_flag("global"));
+ assert!(!matches.get_flag("local"));
+ assert!(matches.get_one::("file").is_none());
+ }
+
+ #[rstest]
+ fn test_local_flag(cmd: Command) {
+ let matches = cmd.try_get_matches_from(vec!["cmd", "-l"]).unwrap();
+ assert!(matches.get_flag("local"));
+ assert!(!matches.get_flag("global"));
+ assert!(matches.get_one::("file").is_none());
+ }
+
+ #[rstest]
+ fn test_file_option(cmd: Command) {
+ let path = "config.toml";
+ let matches = cmd
+ .try_get_matches_from(vec!["cmd", "--file", path])
+ .unwrap();
+ assert_eq!(
+ matches.get_one::("file"),
+ Some(&PathBuf::from(path))
+ );
+ assert!(!matches.get_flag("global"));
+ assert!(!matches.get_flag("local"));
+ }
+
+ #[rstest]
+ fn test_conflicting_flags_global_local(cmd: Command) {
+ let result = cmd.try_get_matches_from(vec!["cmd", "-g", "-l"]);
+ assert!(result.is_err_and(|e| e.kind() == ErrorKind::ArgumentConflict));
+ }
+
+ #[rstest]
+ fn test_conflicting_flags_global_file(cmd: Command) {
+ let result = cmd.try_get_matches_from(vec!["cmd", "--global", "--file", "conf.toml"]);
+ assert!(result.is_err_and(|e| e.kind() == ErrorKind::ArgumentConflict));
+ }
+
+ #[rstest]
+ fn test_no_flags(cmd: Command) {
+ let matches = cmd.try_get_matches_from(vec!["cmd"]).unwrap();
+ assert!(!matches.get_flag("global"));
+ assert!(!matches.get_flag("local"));
+ assert!(matches.get_one::("file").is_none());
+ }
+}
diff --git a/cli/src/extensions/command/with_name.rs b/cli/src/extensions/command/with_name.rs
new file mode 100644
index 00000000..ce4f6425
--- /dev/null
+++ b/cli/src/extensions/command/with_name.rs
@@ -0,0 +1,79 @@
+use clap::{Arg, Command};
+
+/// Trait to add a required `name` argument to a Clap command.
+pub trait WithName {
+ /// Constant name of the CLI argument for the name.
+ const ARG_NAME: &'static str;
+
+ /// Extends a `Command` by adding a positional `name` argument with the given help text.
+ ///
+ /// # Arguments
+ ///
+ /// * `self` - The command being extended.
+ /// * `key_help` - Help message describing the purpose of the `name` argument.
+ ///
+ /// # Returns
+ ///
+ /// The original `Command` with the `name` argument appended.
+ fn with_name_arg(self, name_help: &'static str) -> Self;
+}
+
+impl WithName for Command {
+ const ARG_NAME: &'static str = "name";
+
+ fn with_name_arg(self, name_help: &'static str) -> Self {
+ self.arg(
+ Arg::new(Self::ARG_NAME)
+ .value_name("NAME")
+ .index(1)
+ .required(true)
+ .help(name_help),
+ )
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use clap::Command;
+ use pretty_assertions::assert_eq;
+ use rstest::{fixture, rstest};
+
+ #[fixture]
+ fn cmd() -> Command {
+ Command::new("cmd").with_name_arg("help text")
+ }
+
+ #[rstest]
+ fn adds_argument_with_correct_properties(cmd: Command) {
+ let arg = cmd
+ .get_positionals()
+ .find(|a| a.get_id() == "name")
+ .expect("Argument should exist");
+
+ assert!(arg.is_required_set());
+ assert_eq!(arg.get_index(), Some(1));
+ assert_eq!(
+ arg.get_value_names().unwrap().iter().next().unwrap(),
+ "NAME"
+ );
+ }
+
+ #[rstest]
+ #[case(vec!["cmd", "origin"], Some("origin"))]
+ #[case(vec!["cmd"], None)]
+ fn yields_key_arg(#[case] args: Vec<&str>, #[case] expected: Option<&str>, cmd: Command) {
+ let matches = cmd.clone().try_get_matches_from(args);
+
+ match expected {
+ Some(key) => {
+ let m = matches.unwrap();
+ let got: &String = m.get_one("name").expect("Should have value");
+ assert_eq!(got, key);
+ }
+ None => {
+ assert!(matches.is_err());
+ }
+ }
+ }
+}
diff --git a/cli/src/extensions/command/with_pattern.rs b/cli/src/extensions/command/with_pattern.rs
new file mode 100644
index 00000000..42982b04
--- /dev/null
+++ b/cli/src/extensions/command/with_pattern.rs
@@ -0,0 +1,87 @@
+use clap::{Arg, Command};
+use globset::Glob;
+
+/// Trait to add a required `pattern` argument to a Clap command.
+pub trait WithPattern {
+ /// Constant name of the CLI argument for the pattern.
+ const ARG_PATTERN: &'static str;
+
+ /// Extends a `Command` by adding a positional `pattern` argument with the given help text.
+ /// Uses `Glob` parser to interpret pattern syntax, typically for matching file paths.
+ ///
+ /// # Arguments
+ ///
+ /// * `self` - The command being extended.
+ /// * `pattern_help` - Help message describing the purpose of the `pattern` argument.
+ ///
+ /// # Returns
+ ///
+ /// The original `Command` with the `pattern` argument appended.
+ fn with_pattern_arg(self, key_help: &'static str) -> Self;
+}
+
+impl WithPattern for Command {
+ const ARG_PATTERN: &'static str = "pattern";
+
+ fn with_pattern_arg(self, pattern_help: &'static str) -> Self {
+ self.arg(
+ Arg::new(Self::ARG_PATTERN)
+ .value_name("PATTERN")
+ .value_parser(clap::value_parser!(Glob))
+ .help(pattern_help)
+ .required(true)
+ .index(1),
+ )
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use clap::Command;
+ use pretty_assertions::assert_eq;
+ use rstest::{fixture, rstest};
+
+ #[fixture]
+ fn cmd() -> Command {
+ Command::new("cmd").with_pattern_arg("help text")
+ }
+
+ #[rstest]
+ fn adds_argument_with_correct_properties(cmd: Command) {
+ let arg = cmd
+ .get_positionals()
+ .find(|a| a.get_id() == "pattern")
+ .expect("Argument should exist");
+
+ assert!(arg.is_required_set());
+ assert_eq!(arg.get_index(), Some(1));
+ assert_eq!(
+ arg.get_value_names().unwrap().iter().next().unwrap(),
+ "PATTERN"
+ );
+ }
+
+ #[rstest]
+ #[case(vec!["cmd", "*.sh"], Some("*.sh"))]
+ #[case(vec!["cmd"], None)]
+ fn yields_pattern_arg_as_glob(
+ #[case] args: Vec<&str>,
+ #[case] expected: Option<&str>,
+ cmd: Command,
+ ) {
+ let matches = cmd.clone().try_get_matches_from(args);
+
+ match expected {
+ Some(pattern) => {
+ let m = matches.unwrap();
+ let got: &Glob = m.get_one("pattern").expect("Should have value");
+ let want = Glob::new(pattern).unwrap();
+ assert_eq!(got, &want);
+ }
+ None => {
+ assert!(matches.is_err());
+ }
+ }
+ }
+}
diff --git a/cli/src/extensions/command/with_scope.rs b/cli/src/extensions/command/with_scope.rs
new file mode 100644
index 00000000..097e384e
--- /dev/null
+++ b/cli/src/extensions/command/with_scope.rs
@@ -0,0 +1,90 @@
+use clap::{Arg, Command, builder::PossibleValuesParser};
+use plugins::ScopeType;
+use strum::VariantNames;
+
+/// Trait to add an optional `scope` argument to a Clap command.
+///
+/// This argument allows users to specify the scope in which the command should operate
+/// (e.g., local, global, etc.), using the variants defined in [`ScopeType`].
+pub trait WithScope {
+ /// Constant name of the CLI argument for the scope.
+ const ARG_SCOPE: &'static str;
+
+ /// Extends a `Command` by adding a `scope` argument with the given help text.
+ ///
+ /// # Arguments
+ ///
+ /// * `self` – The command being extended.
+ /// * `scope_help` – Help message describing the purpose of the `scope` argument.
+ ///
+ /// # Returns
+ ///
+ /// The original [`Command`] with the `scope` argument appended.
+ fn with_scope_arg(self, scope_help: &'static str) -> Self;
+}
+
+impl WithScope for Command {
+ const ARG_SCOPE: &'static str = "scope";
+
+ fn with_scope_arg(self, scope_help: &'static str) -> Self {
+ self.arg(
+ Arg::new(Self::ARG_SCOPE)
+ .short('s')
+ .long(Self::ARG_SCOPE)
+ .default_value("local")
+ // Uses the variants of `ScopeType` as allowed values
+ .value_parser(PossibleValuesParser::new(ScopeType::VARIANTS))
+ .help(scope_help),
+ )
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+ use clap::error::ErrorKind;
+ use pretty_assertions::assert_eq;
+ use rstest::{fixture, rstest};
+
+ #[fixture]
+ fn cmd() -> Command {
+ Command::new("cmd").with_scope_arg("scope help")
+ }
+
+ #[rstest]
+ fn test_short_scope_local(cmd: Command) {
+ let matches = cmd
+ .try_get_matches_from(vec!["cmd", "-s", "local"])
+ .unwrap();
+ assert_eq!(
+ matches.get_one::("scope"),
+ Some(&"local".to_string())
+ );
+ }
+
+ #[rstest]
+ fn test_long_scope_global(cmd: Command) {
+ let matches = cmd
+ .try_get_matches_from(vec!["cmd", "--scope", "global"])
+ .unwrap();
+ assert_eq!(
+ matches.get_one::("scope"),
+ Some(&"global".to_string())
+ );
+ }
+
+ #[rstest]
+ fn test_invalid_scope_value(cmd: Command) {
+ let result = cmd.try_get_matches_from(vec!["cmd", "--scope", "invalid"]);
+ assert!(result.is_err_and(|e| e.kind() == ErrorKind::InvalidValue));
+ }
+
+ #[rstest]
+ fn test_no_scope_provided(cmd: Command) {
+ let matches = cmd.try_get_matches_from(vec!["cmd"]).unwrap();
+ assert_eq!(
+ matches.get_one::("scope"),
+ Some(&"local".to_string())
+ );
+ }
+}
diff --git a/cli/src/extensions/command/with_verbose.rs b/cli/src/extensions/command/with_verbose.rs
new file mode 100644
index 00000000..8bde929a
--- /dev/null
+++ b/cli/src/extensions/command/with_verbose.rs
@@ -0,0 +1,33 @@
+use clap::{Arg, Command};
+
+/// Trait to add a `verbose` flag to a Clap command.
+pub trait WithVerbose {
+ /// Constant name of the CLI flag for the verbose.
+ const ARG_VERBOSE: &'static str;
+
+ /// Extends a `Command` by adding a `verbose` flag with the given help text.
+ ///
+ /// # Arguments
+ ///
+ /// * `self` - The command being extended.
+ /// * `key_help` - Help message describing the purpose of the `verbose` flag.
+ ///
+ /// # Returns
+ ///
+ /// The original `Command` with the `verbose` flag appended.
+ fn with_verbose_arg(self, verbose_help: &'static str) -> Self;
+}
+
+impl WithVerbose for Command {
+ const ARG_VERBOSE: &'static str = "verbose";
+
+ fn with_verbose_arg(self, verbose_help: &'static str) -> Self {
+ self.arg(
+ Arg::new(Self::ARG_VERBOSE)
+ .long(Self::ARG_VERBOSE)
+ .short('v')
+ .action(clap::ArgAction::SetTrue)
+ .help(verbose_help),
+ )
+ }
+}
diff --git a/cli/src/main.rs b/cli/src/main.rs
index e7a11a96..2d2c76ca 100644
--- a/cli/src/main.rs
+++ b/cli/src/main.rs
@@ -1,3 +1,26 @@
-fn main() {
- println!("Hello, world!");
+mod commands;
+mod extensions;
+mod meva_cli;
+
+use miette::Result;
+
+use crate::meva_cli::MevaCli;
+use commands::collect_commands;
+use engine::engine_container::MevaContainer;
+
+#[tokio::main]
+async fn main() -> Result<()> {
+ miette::set_panic_hook();
+
+ let container = MevaContainer;
+ let mut cli = MevaCli::new(container);
+
+ let commands = collect_commands();
+
+ for command in commands {
+ cli.add_command(command);
+ }
+
+ cli.run().await?;
+ Ok(())
}
diff --git a/cli/src/meva_cli.rs b/cli/src/meva_cli.rs
new file mode 100644
index 00000000..ed2444cb
--- /dev/null
+++ b/cli/src/meva_cli.rs
@@ -0,0 +1,94 @@
+use std::collections::HashMap;
+
+use clap::{Command, error::ErrorKind};
+use engine::engine_container::MevaContainer;
+use miette::{IntoDiagnostic, Result, WrapErr, miette};
+
+use crate::commands::MevaCommand;
+
+/// The main entry point for the Meva CLI application.
+///
+/// This struct orchestrates the entire command-line interface lifecycle.
+pub struct MevaCli {
+ /// Registry of available commands, mapped from command name to the command instance.
+ commands: HashMap<&'static str, Box>>,
+
+ /// Dependency injection container providing access to core engine services.
+ container: MevaContainer,
+}
+
+impl MevaCli {
+ /// Creates a new `MevaCli` instance with the provided dependency container.
+ ///
+ /// The instance starts with no registered commands. Use [`add_command`](Self::add_command) to populate it.
+ ///
+ /// # Arguments
+ /// * `container`: The initialized `MevaContainer` holding shared resources/services.
+ pub fn new(container: MevaContainer) -> Self {
+ Self {
+ commands: HashMap::new(),
+ container,
+ }
+ }
+
+ /// Registers a command with the CLI.
+ ///
+ /// The command is stored in an internal registry keyed by its name (as returned by `command.name()`).
+ ///
+ /// # Arguments
+ /// * `command`: A boxed instance implementing the `MevaCommand` trait.
+ pub fn add_command(&mut self, command: Box>) {
+ self.commands.insert(command.name(), command);
+ }
+
+ /// Constructs the `clap` argument parser configuration.
+ ///
+ /// This method iterates over all registered commands, adding them as subcommands
+ /// to the main application parser. It also configures global settings such as
+ /// the application name, version, and description.
+ ///
+ /// # Returns
+ /// A fully configured [`clap::Command`] builder ready for argument parsing.
+ fn build_cli(&self) -> Command {
+ let mut cli = Command::new("meva")
+ .about("Meva distributed version control system")
+ .version("1.0.0")
+ .subcommand_required(true)
+ .arg_required_else_help(true);
+
+ for command in self.commands.values() {
+ cli = cli.subcommand(command.build_command());
+ }
+
+ cli
+ }
+
+ /// Executes the CLI application.
+ pub async fn run(&self) -> Result<()> {
+ let matches = match self.build_cli().try_get_matches() {
+ Ok(m) => m,
+ Err(err) => {
+ return match err.kind() {
+ // DisplayHelp and DisplayVersion are not "errors" in the traditional sense,
+ // so we print the info and exit gracefully.
+ ErrorKind::DisplayHelp | ErrorKind::DisplayVersion => {
+ err.print().into_diagnostic()?;
+ Ok(())
+ }
+ _ => Err(miette!("Failed to parse command-line arguments:\n{}", err)),
+ };
+ }
+ };
+
+ if let Some((name, sub_matches)) = matches.subcommand()
+ && let Some(cmd) = self.commands.get(name)
+ {
+ return cmd
+ .execute(sub_matches, &self.container)
+ .await
+ .wrap_err_with(|| format!("Error running `{name}` command"));
+ }
+
+ Ok(())
+ }
+}
diff --git a/docs/images/distributed-architecture.png b/docs/images/distributed-architecture.png
new file mode 100644
index 00000000..742b6a8c
Binary files /dev/null and b/docs/images/distributed-architecture.png differ
diff --git a/docs/images/feather.png b/docs/images/feather.png
new file mode 100644
index 00000000..80e11520
Binary files /dev/null and b/docs/images/feather.png differ
diff --git a/docs/images/gui/gui-branch.png b/docs/images/gui/gui-branch.png
new file mode 100644
index 00000000..d8bbadd6
Binary files /dev/null and b/docs/images/gui/gui-branch.png differ
diff --git a/docs/images/gui/gui-clone-repo.png b/docs/images/gui/gui-clone-repo.png
new file mode 100644
index 00000000..75bd33fa
Binary files /dev/null and b/docs/images/gui/gui-clone-repo.png differ
diff --git a/docs/images/gui/gui-commit-modal.png b/docs/images/gui/gui-commit-modal.png
new file mode 100644
index 00000000..11d066f9
Binary files /dev/null and b/docs/images/gui/gui-commit-modal.png differ
diff --git a/docs/images/gui/gui-config-error.png b/docs/images/gui/gui-config-error.png
new file mode 100644
index 00000000..4b4dbd63
Binary files /dev/null and b/docs/images/gui/gui-config-error.png differ
diff --git a/docs/images/gui/gui-conflict-editor.png b/docs/images/gui/gui-conflict-editor.png
new file mode 100644
index 00000000..e69048ee
Binary files /dev/null and b/docs/images/gui/gui-conflict-editor.png differ
diff --git a/docs/images/gui/gui-conflict-mark.png b/docs/images/gui/gui-conflict-mark.png
new file mode 100644
index 00000000..8f1c64b9
Binary files /dev/null and b/docs/images/gui/gui-conflict-mark.png differ
diff --git a/docs/images/gui/gui-conflict-menu.png b/docs/images/gui/gui-conflict-menu.png
new file mode 100644
index 00000000..8517582a
Binary files /dev/null and b/docs/images/gui/gui-conflict-menu.png differ
diff --git a/docs/images/gui/gui-conflict-unmerged.png b/docs/images/gui/gui-conflict-unmerged.png
new file mode 100644
index 00000000..54d73754
Binary files /dev/null and b/docs/images/gui/gui-conflict-unmerged.png differ
diff --git a/docs/images/gui/gui-context-menu.png b/docs/images/gui/gui-context-menu.png
new file mode 100644
index 00000000..92bd2580
Binary files /dev/null and b/docs/images/gui/gui-context-menu.png differ
diff --git a/docs/images/gui/gui-create-repo.png b/docs/images/gui/gui-create-repo.png
new file mode 100644
index 00000000..00efe31f
Binary files /dev/null and b/docs/images/gui/gui-create-repo.png differ
diff --git a/docs/images/gui/gui-dashboard.png b/docs/images/gui/gui-dashboard.png
new file mode 100644
index 00000000..a5c87ca7
Binary files /dev/null and b/docs/images/gui/gui-dashboard.png differ
diff --git a/docs/images/gui/gui-diff.png b/docs/images/gui/gui-diff.png
new file mode 100644
index 00000000..09e1cf2c
Binary files /dev/null and b/docs/images/gui/gui-diff.png differ
diff --git a/docs/images/gui/gui-history.png b/docs/images/gui/gui-history.png
new file mode 100644
index 00000000..173a0909
Binary files /dev/null and b/docs/images/gui/gui-history.png differ
diff --git a/docs/images/gui/gui-menu-file.png b/docs/images/gui/gui-menu-file.png
new file mode 100644
index 00000000..011d0eae
Binary files /dev/null and b/docs/images/gui/gui-menu-file.png differ
diff --git a/docs/images/gui/gui-open-error.png b/docs/images/gui/gui-open-error.png
new file mode 100644
index 00000000..03c411c0
Binary files /dev/null and b/docs/images/gui/gui-open-error.png differ
diff --git a/docs/images/gui/gui-plugin-edit.png b/docs/images/gui/gui-plugin-edit.png
new file mode 100644
index 00000000..6847beb4
Binary files /dev/null and b/docs/images/gui/gui-plugin-edit.png differ
diff --git a/docs/images/gui/gui-plugin-register.png b/docs/images/gui/gui-plugin-register.png
new file mode 100644
index 00000000..6442ae5f
Binary files /dev/null and b/docs/images/gui/gui-plugin-register.png differ
diff --git a/docs/images/gui/gui-plugins-list-disabled.png b/docs/images/gui/gui-plugins-list-disabled.png
new file mode 100644
index 00000000..6484898a
Binary files /dev/null and b/docs/images/gui/gui-plugins-list-disabled.png differ
diff --git a/docs/images/gui/gui-plugins-list-enabled.png b/docs/images/gui/gui-plugins-list-enabled.png
new file mode 100644
index 00000000..64f4ee6b
Binary files /dev/null and b/docs/images/gui/gui-plugins-list-enabled.png differ
diff --git a/docs/images/gui/gui-settings-view.png b/docs/images/gui/gui-settings-view.png
new file mode 100644
index 00000000..da63684d
Binary files /dev/null and b/docs/images/gui/gui-settings-view.png differ
diff --git a/docs/images/gui/gui-staging.png b/docs/images/gui/gui-staging.png
new file mode 100644
index 00000000..bf4a967b
Binary files /dev/null and b/docs/images/gui/gui-staging.png differ
diff --git a/docs/images/gui/gui-status-bar.png b/docs/images/gui/gui-status-bar.png
new file mode 100644
index 00000000..4d23efe4
Binary files /dev/null and b/docs/images/gui/gui-status-bar.png differ
diff --git a/docs/images/gui/gui-sync-actions.png b/docs/images/gui/gui-sync-actions.png
new file mode 100644
index 00000000..97f6cdda
Binary files /dev/null and b/docs/images/gui/gui-sync-actions.png differ
diff --git a/docs/images/receive-pack.png b/docs/images/receive-pack.png
new file mode 100644
index 00000000..7285452b
Binary files /dev/null and b/docs/images/receive-pack.png differ
diff --git a/docs/images/upload-pack.png b/docs/images/upload-pack.png
new file mode 100644
index 00000000..b6c973bc
Binary files /dev/null and b/docs/images/upload-pack.png differ
diff --git a/docs/plugins/examples/bash/infinite_counter.sh b/docs/plugins/examples/bash/infinite_counter.sh
new file mode 100644
index 00000000..77a53814
--- /dev/null
+++ b/docs/plugins/examples/bash/infinite_counter.sh
@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+
+# Description:
+# Example of Bash plugin which demonstrates:
+# - printing messages to standard output (stdout) every 100 ms,
+# - timeout behaviour.
+#
+# Invocation:
+# chmod +x infinite_counter.sh
+# ./infinite_counter.sh
+#
+# Expected behavior:
+# - stdout: 0, 1, 2, 3, ... (printed continuously),
+# - exit status: plugin will be terminated by the plugin runner when timeout is reached.
+#
+# Example configuration entry (JSON):
+# {
+# "name": "infinite_counter",
+# "description": "Demonstrates plugin runner timeout behavior",
+# "file": "infinite_counter.sh",
+# "event": "pre-execute",
+# "order": 1,
+# "timeout": 500,
+# "enabled": true,
+# "interpreter": "bash"
+# }
+
+i=0
+
+while true; do
+ echo "$i"
+ ((i++))
+ sleep 0.1
+done
\ No newline at end of file
diff --git a/docs/plugins/examples/bash/nonzero_exit.sh b/docs/plugins/examples/bash/nonzero_exit.sh
new file mode 100644
index 00000000..133e23c1
--- /dev/null
+++ b/docs/plugins/examples/bash/nonzero_exit.sh
@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+
+# Description:
+# Example of Bash plugin which demonstrates:
+# - printing a message to standard output (stdout),
+# - printing a message to standard error (stderr),
+# - exiting with a non-zero status code (3).
+#
+# Invocation:
+# chmod +x nonzero_exit.sh
+# ./nonzero_exit.sh
+#
+# Expected behavior:
+# - stdout: "This is a message to stdout",
+# - stderr: "This is a message to stderr",
+# - exit status: 3.
+#
+# Example configuration entry (JSON):
+# {
+# "name": "nonzero_exit",
+# "description": "Demonstrates exiting with a non-zero status code",
+# "file": "nonzero_exit.sh",
+# "event": "pre-execute",
+# "order": 1,
+# "timeout": null,
+# "enabled": true,
+# "interpreter": "bash"
+# }
+
+echo "This is a message to stdout"
+echo "This is a message to stderr" >&2
+exit 3
\ No newline at end of file
diff --git a/docs/plugins/examples/bash/print_arg.sh b/docs/plugins/examples/bash/print_arg.sh
new file mode 100644
index 00000000..884e47d4
--- /dev/null
+++ b/docs/plugins/examples/bash/print_arg.sh
@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+
+# Description:
+# Example Bash plugin which demonstrates:
+# - reading a file specified as the first argument in the console,
+# - printing its content to standard output (stdout),
+# - handling file-not-found or read errors by printing to standard error (stderr).
+#
+# Invocation:
+# chmod +x print_arg.sh
+# ./print_arg.sh
+#
+# Expected behavior:
+# - stdout: content of the specified file,
+# - stderr: error messages if the file does not exist or cannot be read,
+# - exit status: 0 on success, 1 on error.
+#
+# Example configuration entry (JSON):
+# {
+# "name": "print_arg",
+# "description": null,
+# "file": "print_arg.sh",
+# "event": "pre-execute",
+# "order": 1,
+# "timeout": null,
+# "enabled": true,
+# "interpreter": "bash"
+# }
+
+filename="$1"
+
+if [ ! -f "$filename" ]; then
+ echo "Error: File '$filename' not found." >&2
+ exit 1
+fi
+
+cat "$filename" || {
+ echo "Error reading file '$filename'" >&2
+ exit 1
+}
\ No newline at end of file
diff --git a/docs/plugins/examples/bash/write_error.sh b/docs/plugins/examples/bash/write_error.sh
new file mode 100644
index 00000000..201cc388
--- /dev/null
+++ b/docs/plugins/examples/bash/write_error.sh
@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+
+# Description:
+# Example Bash plugin that writes a business logic error
+# to the "error" field of a JSON file representing plugin execution results using 'jq'.
+#
+# Dependencies:
+# Requires 'jq' to be installed (sudo apt install jq / brew install jq).
+#
+# Invocation:
+# chmod +x write_error.sh
+# ./write_error.sh
+#
+# Expected behavior:
+# - The "error" field in the JSON file will be updated.
+# - exit status: 1.
+#
+# Example configuration entry (JSON):
+# {
+# "name": "write_error",
+# "description": null,
+# "file": "write_error.sh",
+# "event": "pre-execute",
+# "order": 1,
+# "timeout": null,
+# "enabled": true,
+# "interpreter": "bash"
+# }
+
+filename="$1"
+
+if [ -z "$filename" ]; then
+ echo "Usage: $0 " >&2
+ exit 1
+fi
+
+if [ ! -f "$filename" ]; then
+ echo "Error: File '$filename' not found." >&2
+ exit 1
+fi
+
+if ! command -v jq &> /dev/null; then
+ echo "Error: 'jq' is not installed. Please install it to manipulate JSON files in Bash." >&2
+ exit 1
+fi
+
+error_payload='{
+ "code": "BUSINESS_LOGIC_ERROR",
+ "message": "A business rule was violated during plugin execution",
+ "details": "Optional additional context or stack trace"
+}'
+
+if jq --argjson err "$error_payload" '.error = $err' "$filename" > "${filename}.tmp"; then
+ mv "${filename}.tmp" "$filename"
+ echo "Updated error in $filename"
+ exit 1
+else
+ echo "Error parsing or writing JSON." >&2
+ rm -f "${filename}.tmp"
+ exit 1
+fi
\ No newline at end of file
diff --git a/docs/plugins/examples/js/infinite_counter.js b/docs/plugins/examples/js/infinite_counter.js
new file mode 100644
index 00000000..234918b6
--- /dev/null
+++ b/docs/plugins/examples/js/infinite_counter.js
@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/*
+Description:
+Example of Node.js plugin which demonstrates:
+- printing messages to standard output (stdout) every 100 ms,
+- timeout behaviour.
+
+Invocation:
+On Linux / macOS:
+ node infinite_counter.js
+ ./infinite_counter.js
+On Windows:
+ node infinite_counter.js
+
+Expected behavior:
+- stdout: 0, 1, 2, 3, ... (printed continuously),
+- exit status: plugin will be terminated by the plugin runner when timeout is reached.
+
+Example configuration entry (JSON):
+{
+ "name": "infinite_counter",
+ "description": "Demonstrates plugin runner timeout behavior",
+ "file": "infinite_counter.js",
+ "event": "pre-execute",
+ "order": 1,
+ "timeout": 500,
+ "enabled": true,
+ "interpreter": "node"
+}
+*/
+
+let i = 0;
+
+function loop() {
+ console.log(i);
+ i++;
+ setTimeout(loop, 100); // 100 ms
+}
+
+loop();
diff --git a/docs/plugins/examples/js/init_files.js b/docs/plugins/examples/js/init_files.js
new file mode 100644
index 00000000..0ecf22e4
--- /dev/null
+++ b/docs/plugins/examples/js/init_files.js
@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+/*
+Description:
+Example of a Node.js plugin script which demonstrates:
+- creating README.md, LICENSE (MIT), and .mevaignore files,
+- handling missing fields in invocation input by writing an error object,
+- prompting the user for author name,
+- writing output or error messages in JSON to stdout/stderr.
+
+Invocation:
+On Linux / macOS:
+ node init_files.js /path/to/invocation_input.json
+On Windows:
+ node init_files.js /path/to/invocation_input.json
+
+Expected behavior:
+- if 'post-payload.repository_dir' exists and directory is valid:
+ -> README.md, LICENSE, and .mevaignore are created if not already present,
+ -> JSON with {"created": [...]} or friendly message is printed to stdout.
+- if required fields are missing:
+ -> JSON with {"error": {...}} is printed to stdout/stderr,
+ -> input JSON file is updated with 'error' field.
+
+Example configuration entry (JSON):
+{
+ "name": "init_files",
+ "description": "Creates README.md, LICENSE and .mevaignore in a newly initialized repository",
+ "file": "init_files.js",
+ "event": "post-execute",
+ "order": 1,
+ "timeout": null,
+ "enabled": true,
+ "interpreter": "node"
+}
+*/
+
+const fs = require("fs");
+const path = require("path");
+const readline = require("readline");
+
+function makeError(jsonPath, code, message, details = null) {
+ let payload = {};
+ try {
+ const fileData = fs.readFileSync(jsonPath, "utf-8");
+ payload = JSON.parse(fileData);
+ } catch {
+ // ignore JSON errors here
+ }
+ payload.error = { code, message, details };
+ try {
+ fs.writeFileSync(jsonPath, JSON.stringify(payload, null, 2), "utf-8");
+ } catch {
+ // ignore write errors here
+ }
+ console.error(JSON.stringify(payload.error));
+ process.exit(1);
+}
+
+function loadJson(jsonPath) {
+ try {
+ const data = fs.readFileSync(jsonPath, "utf-8");
+ return JSON.parse(data);
+ } catch (err) {
+ makeError(
+ jsonPath,
+ "JSON_PARSE_ERROR",
+ "Failed to parse input JSON",
+ err.message
+ );
+ }
+}
+
+function safeWrite(filePath, content) {
+ if (fs.existsSync(filePath)) return false;
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
+ fs.writeFileSync(filePath, content, "utf-8");
+ return true;
+}
+
+function prompt(question) {
+ const rl = readline.createInterface({
+ input: process.stdin,
+ output: process.stdout,
+ });
+ return new Promise((resolve) =>
+ rl.question(question, (answer) => {
+ rl.close();
+ resolve(answer.trim());
+ })
+ );
+}
+
+async function main() {
+ const args = process.argv.slice(2);
+ const jsonPath = path.resolve(args[0]);
+ const payload = loadJson(jsonPath);
+
+ const postPayload = payload["post-payload"];
+ if (!postPayload || !postPayload.repository_dir) {
+ makeError(
+ jsonPath,
+ "MISSING_FIELD",
+ "post-payload.repository_dir is required"
+ );
+ }
+
+ const repoDir = path.resolve(postPayload.repository_dir);
+ if (!fs.existsSync(repoDir) || !fs.lstatSync(repoDir).isDirectory()) {
+ makeError(
+ jsonPath,
+ "DIR_NOT_FOUND",
+ `Repository directory does not exist: ${repoDir}`
+ );
+ }
+
+ const year = new Date().getFullYear();
+
+ console.log("Enter your full name for license copyright:");
+ const author = await prompt("Full name: ");
+ if (!author) {
+ makeError(
+ jsonPath,
+ "MISSING_AUTHOR",
+ "Author name for LICENSE is required."
+ );
+ }
+
+ const readmeContent = `# ${path.basename(repoDir)}
+
+A concise description of the project purpose and features.
+
+## Table of Contents
+- [Installation](#installation)
+- [Usage](#usage)
+- [Configuration](#configuration)
+- [Development](#development)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Installation
+Steps to install the project locally:
+1. Clone the repository.
+2. Install dependencies.
+3. Run initial setup if needed.
+
+## Usage
+Examples of how to use this project:
+\`\`\`
+command-to-run --with options
+\`\`\`
+
+## Configuration
+List available configuration options and environment variables.
+
+## Development
+Instructions for contributors and developers:
+- Run tests: \`command-to-test\`
+- Run linting: \`command-to-lint\`
+- Build or compile: \`command-to-build\`
+
+## Contributing
+To contribute:
+1. Fork the repository.
+2. Create a feature branch.
+3. Make changes with clear commits.
+4. Submit a pull request after testing.
+
+## License
+This project is licensed under the MIT License. See the \`LICENSE\` file for details.
+`;
+
+ const mitLicense = `MIT License
+
+Copyright (c) ${year} ${author}
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+`;
+
+ const mevaignoreContent = `# VS Code / Editor artifacts
+.vscode/
+.idea/
+*.code-workspace
+.env
+
+# Python cache and artifacts
+__pycache__/
+.python-version
+
+# Build and distribution
+dist/
+build/
+
+# Dependency management
+.venv/
+venv/
+
+# Logs and temporary files
+*.log
+tmp/
+`;
+
+ try {
+ const created = [];
+ if (safeWrite(path.join(repoDir, "README.md"), readmeContent))
+ created.push("README.md");
+ if (safeWrite(path.join(repoDir, "LICENSE"), mitLicense))
+ created.push("LICENSE");
+ if (safeWrite(path.join(repoDir, ".mevaignore"), mevaignoreContent))
+ created.push(".mevaignore");
+
+ if (created.length) {
+ console.log("Files created:");
+ created.forEach((f) => console.log(`- ${f}`));
+ } else {
+ console.log("No files were created (all files already exist).");
+ }
+ process.exit(0);
+ } catch (err) {
+ makeError(jsonPath, "WRITE_ERROR", "Error writing files", err.message);
+ }
+}
+
+main();
diff --git a/docs/plugins/examples/js/nonzero_exit.js b/docs/plugins/examples/js/nonzero_exit.js
new file mode 100644
index 00000000..a4d3ad13
--- /dev/null
+++ b/docs/plugins/examples/js/nonzero_exit.js
@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/**
+Description:
+Example of Node.js plugin which demonstrates:
+- printing a message to standard output (stdout),
+- printing a message to standard error (stderr),
+- exiting with a non-zero status code (3).
+
+Invocation:
+On Linux / macOS:
+ node nonzero_exit.js
+ ./nonzero_exit.js
+On Windows:
+ node nonzero_exit.js
+
+Expected behavior:
+- stdout: "This is a message to stdout",
+- stderr: "This is a message to stderr",
+- exit status: 3.
+
+Example configuration entry (JSON):
+{
+ "name": "nonzero_exit",
+ "description": "Demonstrates exiting with a non-zero status code",
+ "file": "nonzero_exit.js",
+ "event": "pre-execute",
+ "order": 1,
+ "timeout": null,
+ "enabled": true,
+ "interpreter": "node"
+}
+*/
+
+console.log("This is a message to stdout");
+console.error("This is a message to stderr");
+
+process.exit(3);
diff --git a/docs/plugins/examples/js/print_arg.js b/docs/plugins/examples/js/print_arg.js
new file mode 100644
index 00000000..e4f5ca9f
--- /dev/null
+++ b/docs/plugins/examples/js/print_arg.js
@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/*
+Description:
+Example Node.js plugin which demonstrates:
+- reading a file specified as the first argument in the console,
+- printing its content to standard output (stdout),
+- handling file-not-found or read errors by printing to standard error (stderr).
+
+Invocation:
+On Linux / macOS:
+ node print_arg.js
+ ./print_arg.js
+On Windows:
+ node print_arg.js
+
+Expected behavior:
+- stdout: content of the specified file,
+- stderr: error messages if the file does not exist or cannot be read,
+- exit status: 0 on success, 1 on error.
+
+Example configuration entry (JSON):
+{
+ "name": "print_arg",
+ "description": null,
+ "file": "print_arg.js",
+ "event": "pre-execute",
+ "order": 1,
+ "timeout": null,
+ "enabled": true,
+ "interpreter": "node"
+}
+ */
+
+const fs = require("fs");
+
+const args = process.argv.slice(2);
+const filename = args[0];
+
+try {
+ const content = fs.readFileSync(filename, { encoding: "utf8" });
+ console.log(content);
+} catch (err) {
+ if (err.code === "ENOENT") {
+ console.error(`Error: File '${filename}' not found.`);
+ } else {
+ console.error(`Error reading file '${filename}': ${err.message}`);
+ }
+ process.exit(1);
+}
diff --git a/docs/plugins/examples/js/write_error.js b/docs/plugins/examples/js/write_error.js
new file mode 100644
index 00000000..7fe86f16
--- /dev/null
+++ b/docs/plugins/examples/js/write_error.js
@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+/*
+Description:
+Example Node.js plugin that writes a business logic error
+to the "error" field of a JSON file representing plugin execution results.
+
+Invocation:
+On Linux / macOS:
+ node write_error.js
+ ./write_error.js
+On Windows:
+ node write_error.js
+
+Expected behavior:
+- The "error" field in the JSON file will be updated with a serialized InvocationError:
+ {
+ "code": "BUSINESS_LOGIC_ERROR",
+ "message": "A business rule was violated during plugin execution",
+ "details": "Optional additional context or stack trace"
+ },
+- exit status: 1 (indicating the plugin returned an error).
+
+Example configuration entry (JSON):
+{
+ "name": "write_error",
+ "description": null,
+ "file": "write_error.js",
+ "event": "pre-execute",
+ "order": 1,
+ "timeout": null,
+ "enabled": true,
+ "interpreter": "node"
+}
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+const args = process.argv.slice(2);
+const filename = args[0];
+
+const invocationError = {
+ code: "BUSINESS_LOGIC_ERROR",
+ message: "A business rule was violated during plugin execution",
+ details: "Optional additional context or stack trace",
+};
+
+try {
+ const rawData = fs.readFileSync(filename, "utf8");
+ const data = JSON.parse(rawData);
+
+ data.error = invocationError;
+
+ fs.writeFileSync(filename, JSON.stringify(data, null, 2), "utf8");
+
+ console.log(`Updated error in ${filename}`);
+ process.exit(1);
+} catch (err) {
+ if (err.code === "ENOENT") {
+ console.error(`Error: File '${filename}' not found.`);
+ } else if (err.name === "SyntaxError") {
+ console.error(`Error parsing JSON: ${err.message}`);
+ } else {
+ console.error(`Unexpected error: ${err.message}`);
+ }
+ process.exit(1);
+}
diff --git a/docs/plugins/examples/powershell/infinite_counter.ps1 b/docs/plugins/examples/powershell/infinite_counter.ps1
new file mode 100644
index 00000000..bc4a8db3
--- /dev/null
+++ b/docs/plugins/examples/powershell/infinite_counter.ps1
@@ -0,0 +1,33 @@
+<#
+Description:
+Example of PowerShell plugin which demonstrates:
+- printing messages to standard output (stdout) every 100 ms,
+- timeout behaviour.
+
+Invocation:
+On Windows:
+ powershell infinite_counter.ps1
+
+Expected behavior:
+- stdout: 0, 1, 2, 3, ... (printed continuously),
+- exit status: plugin will be terminated by the plugin runner when timeout is reached.
+
+Example configuration entry (JSON):
+{
+ "name": "infinite_counter",
+ "description": "Demonstrates plugin runner timeout behavior",
+ "file": "infinite_counter.ps1",
+ "event": "pre-execute",
+ "order": 1,
+ "timeout": 500,
+ "enabled": true,
+ "interpreter": "powershell"
+}
+#>
+
+$i = 0
+while ($true) {
+ Write-Output $i
+ $i++
+ Start-Sleep -Milliseconds 100
+}
\ No newline at end of file
diff --git a/docs/plugins/examples/powershell/nonzero_exit.ps1 b/docs/plugins/examples/powershell/nonzero_exit.ps1
new file mode 100644
index 00000000..ca73a86e
--- /dev/null
+++ b/docs/plugins/examples/powershell/nonzero_exit.ps1
@@ -0,0 +1,33 @@
+<#
+Description:
+Example of PowerShell plugin which demonstrates:
+- printing a message to standard output (stdout),
+- printing a message to standard error (stderr),
+- exiting with a non-zero status code (3).
+
+Invocation:
+On Windows:
+ powershell nonzero_exit.ps1
+
+Expected behavior:
+- stdout: "This is a message to stdout",
+- stderr: "This is a message to stderr",
+- exit status: 3.
+
+Example configuration entry (JSON):
+{
+ "name": "nonzero_exit",
+ "description": "Demonstrates exiting with a non-zero status code",
+ "file": "nonzero_exit.ps1",
+ "event": "pre-execute",
+ "order": 1,
+ "timeout": null,
+ "enabled": true,
+ "interpreter": "powershell"
+}
+#>
+
+Write-Output "This is a message to stdout"
+Write-Error "This is a message to stderr"
+
+$host.SetShouldExit(3)
\ No newline at end of file
diff --git a/docs/plugins/examples/powershell/print_arg.ps1 b/docs/plugins/examples/powershell/print_arg.ps1
new file mode 100644
index 00000000..c45befae
--- /dev/null
+++ b/docs/plugins/examples/powershell/print_arg.ps1
@@ -0,0 +1,45 @@
+<#
+Description:
+Example Powershell plugin which demonstrates:
+- reading a file specified as the first argument in the console,
+- printing its content to standard output (stdout),
+- handling file-not-found or read errors by printing to standard error (stderr).
+
+Invocation:
+On Windows:
+ powershell print_arg.ps1
+
+Expected behavior:
+- stdout: content of the specified file,
+- stderr: error messages if the file does not exist or cannot be read,
+- exit status: 0 on success, 1 on error.
+
+Example configuration entry (JSON):
+{
+ "name": "print_arg",
+ "description": null,
+ "file": "print_arg.ps1",
+ "event": "pre-execute",
+ "order": 1,
+ "timeout": null,
+ "enabled": true,
+ "interpreter": "powershell"
+}
+#>
+
+param (
+ [Parameter(Mandatory = $true)]
+ [string]$filename
+)
+
+try {
+ Get-Content -Path $filename -ErrorAction Stop | ForEach-Object {
+ Write-Output $_
+ }
+}
+catch {
+ Write-Error "Error reading file '$filename': $_"
+ $host.SetShouldExit(1)
+}
+
+$host.SetShouldExit(0)
\ No newline at end of file
diff --git a/docs/plugins/examples/python/infinite_counter.py b/docs/plugins/examples/python/infinite_counter.py
new file mode 100644
index 00000000..8dcea94c
--- /dev/null
+++ b/docs/plugins/examples/python/infinite_counter.py
@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+"""
+Description:
+Example of Python plugin which demonstrates:
+- printing messages to standard output (stdout) every 100 ms,
+- timeout behaviour.
+
+Invocation:
+On Linux / macOS:
+ python3 infinite_counter.py
+ ./infinite_counter.py
+On Windows:
+ python infinite_counter.py
+
+Expected behavior:
+- stdout: 0, 1, 2, 3, ... (printed continuously),
+- exit status: plugin will be terminated by the plugin runner when timeout is reached.
+
+Example configuration entry (JSON):
+{
+ "name": "infinite_counter",
+ "description": "Demonstrates plugin runner timeout behavior",
+ "file": "infinite_counter.py",
+ "event": "pre-execute",
+ "order": 1,
+ "timeout": 500,
+ "enabled": true,
+ "interpreter": "python"
+}
+"""
+
+import time
+
+i = 0
+while True:
+ print(i, flush=True)
+ i += 1
+ time.sleep(0.1) # 100 ms
diff --git a/docs/plugins/examples/python/init_files.py b/docs/plugins/examples/python/init_files.py
new file mode 100644
index 00000000..6481eb90
--- /dev/null
+++ b/docs/plugins/examples/python/init_files.py
@@ -0,0 +1,184 @@
+#!/usr/bin/env python3
+"""
+Description:
+Example of Python plugin which demonstrates:
+- creating README.md, LICENSE (MIT) and .mevaignore files,
+- handling missing fields in InvocationInput by writing an error object.
+
+Invocation:
+On Linux / macOS:
+ python3 init_files.py /path/to/invocation_input.json
+ ./init_files.py /path/to/invocation_input.json
+On Windows:
+ python init_files.py /path/to/invocation_input.json
+
+Expected behavior:
+- if 'post-payload.repository_dir' exists and directory is valid:
+ -> README.md, LICENSE and .mevaignore are created if not already present,
+ -> JSON with {"created": [...]} is printed to stdout.
+- if required fields are missing:
+ -> JSON with {"error": {...}} is printed to stdout,
+ -> input JSON file is updated with 'error' field.
+
+Example configuration entry (JSON):
+{
+ "name": "init_files",
+ "description": "Creates README.md, LICENSE and .mevaignore in a newly initialized repository",
+ "file": "init_files.py",
+ "event": "post-execute",
+ "order": 1,
+ "timeout": null,
+ "enabled": true,
+ "interpreter": "python"
+}
+"""
+
+import sys
+import json
+from pathlib import Path
+from datetime import datetime
+from typing import Any, Dict, Optional, List
+
+def make_error(json_path: Path, code: str, message: str, details: Optional[str] = None):
+ try:
+ payload = json.loads(json_path.read_text(encoding="utf-8"))
+ except Exception:
+ payload = {}
+ payload["error"] = {
+ "code": code,
+ "message": message,
+ "details": details,
+ }
+ json_path.write_text(json.dumps(payload, indent=2), encoding="utf-8")
+ sys.exit(1)
+
+def load_json(p: Path) -> Dict[str, Any]:
+ try:
+ return json.loads(p.read_text(encoding="utf-8"))
+ except Exception as e:
+ make_error(p, "JSON_PARSE_ERROR", "Failed to parse input JSON", str(e))
+
+def safe_write(path: Path, content: str) -> bool:
+ if path.exists():
+ return False
+ path.parent.mkdir(parents=True, exist_ok=True)
+ path.write_text(content, encoding="utf-8")
+ return True
+
+def main():
+ json_path = Path(sys.argv[1])
+ payload = load_json(json_path)
+
+ post = payload.get("post-payload")
+ if not post or "repository_dir" not in post:
+ make_error(json_path, "MISSING_FIELD", "post-payload.repository_dir is required")
+
+ repo_dir = Path(post["repository_dir"]).resolve()
+ if not repo_dir.exists():
+ make_error(json_path, "DIR_NOT_FOUND", f"Repository directory does not exist: {repo_dir}")
+
+ year = datetime.now().year
+
+ print("Enter your full name for license copyright:", flush=True)
+ author = input().strip()
+ if not author:
+ make_error(json_path, "MISSING_AUTHOR", "Author name for LICENSE is required.")
+
+ readme_content = (
+ "# " + repo_dir.name + "\n\n"
+ "A concise description of the project purpose and features.\n\n"
+ "## Table of Contents\n"
+ "- [Installation](#installation)\n"
+ "- [Usage](#usage)\n"
+ "- [Configuration](#configuration)\n"
+ "- [Development](#development)\n"
+ "- [Contributing](#contributing)\n"
+ "- [License](#license)\n\n"
+ "## Installation\n"
+ "Steps to install the project locally:\n"
+ "1. Clone the repository.\n"
+ "2. Install dependencies.\n"
+ "3. Run initial setup if needed.\n\n"
+ "## Usage\n"
+ "Examples of how to use this project:\n"
+ "```\n"
+ "command-to-run --with options\n"
+ "```\n\n"
+ "## Configuration\n"
+ "List available configuration options and environment variables.\n\n"
+ "## Development\n"
+ "Instructions for contributors and developers:\n"
+ "- Run tests: `command-to-test`\n"
+ "- Run linting: `command-to-lint`\n"
+ "- Build or compile: `command-to-build`\n\n"
+ "## Contributing\n"
+ "To contribute:\n"
+ "1. Fork the repository.\n"
+ "2. Create a feature branch.\n"
+ "3. Make changes with clear commits.\n"
+ "4. Submit a pull request after testing.\n\n"
+ "## License\n"
+ "This project is licensed under the MIT License. See the `LICENSE` file for details.\n"
+ )
+
+ mit_license = (
+ "MIT License\n\n"
+ f"Copyright (c) {year} {author}\n\n"
+ "Permission is hereby granted, free of charge, to any person obtaining a copy\n"
+ "of this software and associated documentation files (the \"Software\"), to deal\n"
+ "in the Software without restriction, including without limitation the rights\n"
+ "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n"
+ "copies of the Software, and to permit persons to whom the Software is\n"
+ "furnished to do so, subject to the following conditions:\n\n"
+ "THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n"
+ "IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n"
+ "FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n"
+ "AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n"
+ "LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n"
+ "OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n"
+ "SOFTWARE.\n"
+ )
+
+ mevaignore_content = (
+ "# VS Code / Editor artifacts\n"
+ ".vscode/\n"
+ ".idea/\n"
+ "*.code-workspace\n"
+ ".env\n\n"
+ "# Python cache and artifacts\n"
+ "__pycache__/\n"
+ ".python-version\n\n"
+ "# Build and distribution\n"
+ "dist/\n"
+ "build/\n\n"
+ "# Dependency management\n"
+ ".venv/\n"
+ "venv/\n\n"
+ "# Logs and temporary files\n"
+ "*.log\n"
+ "tmp/\n"
+ )
+
+ try:
+ created: List[str] = []
+ if safe_write(repo_dir / "README.md", readme_content):
+ created.append("README.md")
+ if safe_write(repo_dir / "LICENSE", mit_license):
+ created.append("LICENSE")
+ if safe_write(repo_dir / ".mevaignore", mevaignore_content):
+ created.append(".mevaignore")
+
+ if created:
+ print("Files created:", flush=True)
+ for file in created:
+ print(f"- {file}", flush=True)
+ else:
+ print("No files were created (all files already exist).", flush=True)
+ sys.exit(0)
+
+ except Exception as e:
+ make_error(json_path, "WRITE_ERROR", "Error writing files", str(e))
+ sys.exit(1)
+
+if __name__ == "__main__":
+ main()
diff --git a/docs/plugins/examples/python/nonzero_exit.py b/docs/plugins/examples/python/nonzero_exit.py
new file mode 100644
index 00000000..39b5cb27
--- /dev/null
+++ b/docs/plugins/examples/python/nonzero_exit.py
@@ -0,0 +1,39 @@
+#!/usr/bin/env python3
+"""
+Description:
+Example of Node.js plugin which demonstrates:
+- printing a message to standard output (stdout),
+- printing a message to standard error (stderr),
+- exiting with a non-zero status code (3).
+
+Invocation:
+On Linux / macOS:
+ python3 nonzero_exit.py
+ ./nonzero_exit.py
+On Windows:
+ python nonzero_exit.py
+
+Expected behavior:
+- stdout: "This is a message to stdout",
+- stderr: "This is a message to stderr",
+- exit status: 3.
+
+Example configuration entry (JSON):
+{
+ "name": "nonzero_exit",
+ "description": "Demonstrates exiting with a non-zero status code",
+ "file": "nonzero_exit.py",
+ "event": "pre-execute",
+ "order": 1,
+ "timeout": null,
+ "enabled": true,
+ "interpreter": "python"
+}
+"""
+
+import sys
+
+print("This is a message to stdout", flush=True)
+print("This is a message to stderr", file=sys.stderr, flush=True)
+
+sys.exit(3)
\ No newline at end of file
diff --git a/docs/plugins/examples/python/print_arg.py b/docs/plugins/examples/python/print_arg.py
new file mode 100644
index 00000000..5f4c4e0b
--- /dev/null
+++ b/docs/plugins/examples/python/print_arg.py
@@ -0,0 +1,48 @@
+#!/usr/bin/env python3
+"""
+Description:
+Example Python plugin which demonstrates:
+- reading a file specified as the first argument in the console,
+- printing its content to standard output (stdout),
+- handling file-not-found or read errors by printing to standard error (stderr).
+
+Invocation:
+On Linux / macOS:
+ python3 print_arg.py
+ ./print_arg.py
+On Windows:
+ python print_arg.py
+
+Expected behavior:
+- stdout: content of the specified file,
+- stderr: error messages if the file does not exist or cannot be read,
+- exit status: 0 on success, 1 on error.
+
+Example configuration entry (JSON):
+{
+ "name": "print_arg",
+ "description": null,
+ "file": "print_arg.py",
+ "event": "pre-execute",
+ "order": 1,
+ "timeout": null,
+ "enabled": true,
+ "interpreter": "python"
+}
+"""
+
+import sys
+
+filename = sys.argv[1]
+
+try:
+ with open(filename, "r", encoding="utf-8") as f:
+ for line in f:
+ print(line, end="", flush=True)
+ print(flush=True)
+except FileNotFoundError:
+ print(f"Error: File '{filename}' not found.", file=sys.stderr, flush=True)
+ sys.exit(1)
+except Exception as e:
+ print(f"Error reading file '{filename}': {e}", file=sys.stderr, flush=True)
+ sys.exit(1)
\ No newline at end of file
diff --git a/docs/plugins/examples/python/write_error.py b/docs/plugins/examples/python/write_error.py
new file mode 100644
index 00000000..8a764b77
--- /dev/null
+++ b/docs/plugins/examples/python/write_error.py
@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+"""
+Description:
+Example Python plugin that writes a business logic error
+to the "error" field of a JSON file representing plugin execution results.
+
+Invocation:
+On Linux / macOS:
+ python3 write_error.py
+ ./write_error.py
+On Windows:
+ python write_error.py
+
+Expected behavior:
+- The "error" field in the JSON file will be updated with a serialized InvocationError:
+ {
+ "code": "BUSINESS_LOGIC_ERROR",
+ "message": "A business rule was violated during plugin execution",
+ "details": "Optional additional context or stack trace"
+ },
+- exit status: 1 (indicating the plugin returned an error).
+
+Example configuration entry (JSON):
+{
+ "name": "write_error",
+ "description": null,
+ "file": "write_error.py",
+ "event": "pre-execute",
+ "order": 1,
+ "timeout": null,
+ "enabled": true,
+ "interpreter": "python"
+}
+"""
+
+import sys
+import json
+
+filename = sys.argv[1]
+
+invocation_error = {
+ "code": "BUSINESS_LOGIC_ERROR",
+ "message": "A business rule was violated during plugin execution",
+ "details": "Optional additional context or stack trace"
+}
+
+try:
+ with open(filename, "r", encoding="utf-8") as f:
+ data = json.load(f)
+
+ data["error"] = invocation_error
+
+ with open(filename, "w", encoding="utf-8") as f:
+ json.dump(data, f, indent=2)
+
+ print(f"Updated error in {filename}", flush=True)
+ sys.exit(1)
+
+except FileNotFoundError:
+ print(f"Error: File '{filename}' not found.", file=sys.stderr, flush=True)
+ sys.exit(1)
+except json.JSONDecodeError as e:
+ print(f"Error parsing JSON: {e}", file=sys.stderr, flush=True)
+ sys.exit(1)
+except Exception as e:
+ print(f"Unexpected error: {e}", file=sys.stderr, flush=True)
+ sys.exit(1)
diff --git a/engine/Cargo.toml b/engine/Cargo.toml
index d29147f9..29c4dd21 100644
--- a/engine/Cargo.toml
+++ b/engine/Cargo.toml
@@ -6,6 +6,38 @@ authors.workspace = true
[dependencies]
shared = { path = "../shared" }
+plugins = { path = "../plugins" }
+tempfile.workspace = true
+thiserror.workspace = true
+serde.workspace = true
+serde_json.workspace = true
+regex.workspace = true
+toml.workspace = true
+toml_edit = "0.23.2"
+dirs.workspace = true
+globset.workspace = true
+walkdir = "2.5.0"
+sha1 = "0.11.0-rc.0"
+hex = "0.4.3"
+chrono.workspace = true
+rayon = "1.11.0"
+flate2 = "1.1.2"
+bincode = "2.0.1"
+encoding_rs = "0.8.35"
+chardetng = "0.1.17"
+tree-ds = "0.2.0"
+similar.workspace = true
+owo-colors.workspace = true
+path-absolutize.workspace = true
+russh.workspace = true
+russh-keys.workspace = true
+cryptovec.workspace = true
+async-trait.workspace = true
+tokio.workspace = true
+url.workspace = true
+itertools.workspace = true
+strum.workspace = true
+strum_macros.workspace = true
[dev-dependencies]
rstest.workspace = true
diff --git a/engine/src/branch_manager.rs b/engine/src/branch_manager.rs
new file mode 100644
index 00000000..4250a7ec
--- /dev/null
+++ b/engine/src/branch_manager.rs
@@ -0,0 +1,189 @@
+mod branch;
+mod branch_info;
+mod remove_branches_result;
+
+pub mod meva_branch_manager;
+
+use crate::errors::EngineResult;
+use crate::objects::MevaCommit;
+
+pub use branch::{Branch, BranchType};
+pub use branch_info::BranchInfo;
+pub use meva_branch_manager::MevaBranchManager;
+pub use remove_branches_result::RemoveBranchesResult;
+
+/// Defines a common interface for managing commits within a branch.
+///
+/// This trait handles the lifecycle of branches within the repository, including:
+/// - **Commit Operations**: adding, amending, and retrieving commits.
+/// - **Branch Management**: creating, deleting, renaming, and listing branches.
+/// - **State Inspection**: identifying the current active branch.
+pub trait BranchManager: Send + Sync {
+ /// Retrieves the name of the currently active branch (pointed to by HEAD).
+ ///
+ /// # Returns
+ ///
+ /// * `Ok(Some(name))` - If HEAD points to a valid branch reference (e.g., "main").
+ /// * `Ok(None)` - If HEAD is in a "detached" state (points directly to a commit hash)
+ /// or if the repository is empty.
+ ///
+ /// # Errors
+ ///
+ /// Returns an [`EngineResult`] if the HEAD file cannot be read or parsed.
+ fn current_branch_name(&self) -> EngineResult>;
+
+ /// Adds a new commit to the branch.
+ ///
+ /// # Arguments
+ ///
+ /// * `commit` – The [`MevaCommit`] object to add.
+ ///
+ /// # Returns
+ ///
+ /// Returns the SHA-1 hash of the newly added commit.
+ ///
+ /// # Errors
+ ///
+ /// Returns an [`EngineResult`] containing errors that occur during
+ /// commit storage or hash computation.
+ fn add_commit(&self, commit: MevaCommit) -> EngineResult;
+
+ /// Amends the latest commit in the branch with a new [`MevaCommit`].
+ ///
+ /// Returns the SHA-1 hash of the updated commit.
+ fn amend_last_commit(&self, commit: MevaCommit) -> EngineResult;
+
+ /// Returns the SHA-1 hash of the most recent commit in the branch.
+ ///
+ /// # Returns
+ ///
+ /// Returns `Ok(Some(hash))` if there is at least one commit,
+ /// `Ok(None)` if the branch has no commits yet.
+ ///
+ /// # Errors
+ ///
+ /// Returns an [`EngineResult`] if an error occurs during retrieval.
+ fn last_commit_hash(&self) -> EngineResult>;
+
+ /// Returns the most recent commit object in the branch.
+ ///
+ /// # Returns
+ ///
+ /// Returns `Ok(Some(commit))` if there is at least one commit,
+ /// `Ok(None)` if the branch has no commits yet.
+ ///
+ /// # Errors
+ ///
+ /// Returns an [`EngineResult`] if an error occurs during retrieval
+ /// or object deserialization.
+ fn last_commit(&self) -> EngineResult>;
+
+ /// Configures a tracking relationship (upstream) for a local branch.
+ ///
+ /// This updates the `.meva/mevaconfig` file, allowing commands like `push` or `pull`
+ /// to know which remote and branch to synchronize with.
+ ///
+ /// ### Configuration Format:
+ /// ```toml
+ /// [branch "local_name"]
+ /// remote = "origin"
+ /// merge = "refs/heads/remote_name"
+ /// ```
+ ///
+ /// # Arguments
+ ///
+ /// * `local_branch_name` – The name of the local branch to configure (e.g., "main").
+ /// * `remote_branch_name` – The full remote-tracking branch name (e.g., "origin/main").
+ ///
+ /// # Errors
+ ///
+ /// * [`BranchError::NotLocalBranch`] – If the first argument is not a local branch.
+ /// * [`BranchError::NotRemoteBranch`] – If the second argument is not a remote-tracking branch.
+ /// * [`BranchError::BranchNotFound`] – If either reference cannot be resolved.
+ fn set_upstream(&self, local_branch_name: &str, remote_branch_name: &str) -> EngineResult<()>;
+
+ /// Creates a new branch based on the provided definition.
+ ///
+ /// # Arguments
+ ///
+ /// * `branch` - A [`Branch`] struct containing the name and the target commit hash.
+ ///
+ /// # Errors
+ ///
+ /// Returns an error if a branch with the same name already exists.
+ fn create_branch(&self, branch: &Branch) -> EngineResult<()>;
+
+ /// Creates multiple branches in a batch operation.
+ ///
+ /// Iterates through the provided slice and creates each branch.
+ ///
+ /// # Arguments
+ ///
+ /// * `branches` - A slice of [`Branch`] definitions to create.
+ fn create_branches(&self, branches: &[Branch]) -> EngineResult<()>;
+
+ /// Deletes a specific branch.
+ ///
+ /// # Arguments
+ ///
+ /// * `branch_name` - The name of the branch to delete.
+ /// * `force` - If `true`, the branch will be deleted even if it contains
+ /// commits not merged into the current branch. If `false`, such an attempt
+ /// will return an error.
+ ///
+ /// # Errors
+ ///
+ /// Returns an error if the branch does not exist or if `force` is false
+ /// and the branch is not fully merged.
+ fn remove_branch(&self, branch_name: &str, force: bool) -> EngineResult<()>;
+
+ /// Deletes multiple branches in a batch operation.
+ ///
+ /// # Arguments
+ ///
+ /// * `branch_names` - A list of branch names to remove.
+ /// * `force` - Applies the force-delete logic to all specified branches.
+ ///
+ /// # Returns
+ ///
+ /// Returns a [`RemoveBranchesResult`] which aggregates information about
+ /// which deletions succeeded and which failed.
+ fn remove_branches(
+ &self,
+ branch_names: &[&str],
+ force: bool,
+ ) -> EngineResult;
+
+ /// Renames an existing branch.
+ ///
+ /// # Arguments
+ ///
+ /// * `old_branch_name` - The current name of the branch.
+ /// * `new_branch` - The desired new name.
+ ///
+ /// # Errors
+ ///
+ /// Returns an error if:
+ /// * `old_branch_name` does not exist.
+ /// * `new_branch` already exists.
+ fn rename_branch(&self, old_branch_name: &str, new_branch: &str) -> EngineResult<()>;
+
+ /// Lists branches present in the repository.
+ ///
+ /// # Arguments
+ ///
+ /// * `local` - Include local branches (`refs/heads/`) in the list.
+ /// * `remotes` - Include remote-tracking branches (`refs/remotes/`) in the list.
+ /// * `detailed` - If `true`, fetches commit details (hash and message) for each branch.
+ /// This involves reading objects from storage and is more expensive than a simple name list.
+ ///
+ /// # Returns
+ ///
+ /// Returns a vector of [`BranchInfo`] objects representing the filtered list of branches.
+ fn list_branches(
+ &self,
+ local: bool,
+ remotes: bool,
+ detailed: bool,
+ ) -> EngineResult>;
+}
diff --git a/engine/src/branch_manager/branch.rs b/engine/src/branch_manager/branch.rs
new file mode 100644
index 00000000..1e583cf6
--- /dev/null
+++ b/engine/src/branch_manager/branch.rs
@@ -0,0 +1,33 @@
+use strum_macros::Display;
+
+/// Categorizes a branch based on its location and purpose within the repository.
+///
+/// This distinction is crucial for determining where the branch reference
+/// is stored on the filesystem and how it interacts with commands
+#[derive(Debug, Clone, Eq, Hash, PartialEq, Display)]
+pub enum BranchType {
+ /// A standard local branch.
+ Local,
+
+ /// A remote-tracking branch.
+ Remote,
+}
+
+/// Represents a branch definition in the Meva system.
+///
+/// A branch is essentially a lightweight, named pointer to a specific commit.
+/// This structure holds the metadata required to locate, identify, and manipulate
+/// that pointer.
+#[derive(Debug, Clone)]
+pub struct Branch {
+ /// The human-readable name of the branch (e.g., "main", "feature/login").
+ ///
+ /// Note: This name should not contain the full reference path (like `refs/heads/`).
+ pub name: String,
+
+ /// The category of the branch (Local or Remote).
+ pub branch_type: BranchType,
+
+ /// The SHA-1 hash of the commit that this branch currently points to.
+ pub head_hash: String,
+}
diff --git a/engine/src/branch_manager/branch_info.rs b/engine/src/branch_manager/branch_info.rs
new file mode 100644
index 00000000..49083931
--- /dev/null
+++ b/engine/src/branch_manager/branch_info.rs
@@ -0,0 +1,58 @@
+use super::BranchType;
+
+/// Represents information about a single branch returned by a listing operation.
+///
+/// This enum allows the system to be efficient by fetching and returning
+/// only the necessary data based on the requested verbosity level.
+#[derive(Debug)]
+pub enum BranchInfo {
+ /// Minimal representation containing only the branch name.
+ ///
+ /// This variant is returned by default when listing branches without
+ /// the verbose (`-v`) flag, avoiding the cost of reading commit objects.
+ NameOnly {
+ /// The name of the branch (e.g., "main", "feature/login").
+ name: String,
+
+ /// The type of the branch.
+ branch_type: BranchType,
+ },
+
+ /// Extended representation including the tip commit's details.
+ ///
+ /// This variant is returned when the verbose (`-v`) flag is active.
+ /// It requires resolving the commit hash to a commit object to retrieve the message.
+ Detailed {
+ /// The name of the branch.
+ name: String,
+
+ /// The SHA-1 hash of the commit the branch points to.
+ commit_hash: String,
+
+ /// The commit message associated with the hash.
+ commit_message: String,
+
+ /// The type of the branch.
+ branch_type: BranchType,
+ },
+}
+
+impl BranchInfo {
+ /// Retrieves the name of the branch.
+ pub fn get_name(&self) -> String {
+ let name = match self {
+ Self::NameOnly { name, .. } => name,
+ Self::Detailed { name, .. } => name,
+ };
+ name.clone()
+ }
+
+ /// Retrieves the type of the branch (e.g., Local or Remote).
+ pub fn get_type(&self) -> BranchType {
+ let branch_type = match self {
+ Self::NameOnly { branch_type, .. } => branch_type,
+ Self::Detailed { branch_type, .. } => branch_type,
+ };
+ branch_type.clone()
+ }
+}
diff --git a/engine/src/branch_manager/meva_branch_manager.rs b/engine/src/branch_manager/meva_branch_manager.rs
new file mode 100644
index 00000000..2d074e95
--- /dev/null
+++ b/engine/src/branch_manager/meva_branch_manager.rs
@@ -0,0 +1,444 @@
+use crate::branch_manager::{Branch, BranchInfo, BranchType, RemoveBranchesResult};
+use crate::config::ConfigDocumentOperations;
+use crate::errors::{BranchError, CommitError, EngineResult, RefEntryError};
+use crate::objects::MevaCommit;
+use crate::ref_manager::{BranchRefEntry, Head, HeadMode, RefEntry};
+use crate::traversal::CommitHistoryWalker;
+use crate::{BranchManager, ConfigDocument, ObjectStorage, RefManager};
+use std::collections::{HashMap, HashSet};
+use std::sync::Arc;
+
+/// `MevaBranchManager` is a concrete implementation of [`BranchManager`]
+/// This manager handles the complete lifecycle of branches and commits, ensuring
+/// data integrity and safety. Its responsibilities include:
+/// - **Commit Management**: adding new commits and retrieving the branch tip.
+/// - **Branch Lifecycle**: creating, listing, renaming, and deleting branches.
+/// - **Safety Checks**: verifying if a branch is fully merged into `HEAD` before deletion
+/// to prevent accidental data loss.
+pub struct MevaBranchManager {
+ /// Provides storage for commit objects.
+ object_storage: Arc,
+
+ /// Service for traversing the commit graph (used for merge checks).
+ history_traversal: Arc,
+
+ /// Provides access to branch references (HEAD, etc.).
+ ref_manager: Arc,
+}
+
+impl MevaBranchManager {
+ /// Creates a new [`MevaBranchManager`].
+ ///
+ /// # Arguments
+ ///
+ /// * `repo_layout` - Access to repository paths.
+ /// * `object_storage` – Storage backend for reading/writing commit objects.
+ /// * `history_traversal` - Service for walking the commit graph (BFS/DFS).
+ /// * `ref_manager` - Manager for reading and updating references.
+ pub fn new(
+ object_storage: Arc,
+ history_traversal: Arc,
+ ref_manager: Arc,
+ ) -> Self {
+ Self {
+ history_traversal,
+ object_storage,
+ ref_manager,
+ }
+ }
+
+ /// Updates the branch head to point to a new commit.
+ ///
+ /// Depending on the current [`HeadMode`], this method either:
+ /// - updates the direct HEAD reference (in detached state), or
+ /// - updates the symbolic reference (e.g. a branch name) to the given commit hash.
+ ///
+ /// # Arguments
+ ///
+ /// * `hash` – The SHA-1 hash of the commit to move the HEAD to.
+ ///
+ /// # Errors
+ ///
+ /// Returns an [`EngineError`] if reading or updating HEAD or the reference fails.
+ fn move_head(&self, hash: &str) -> EngineResult<()> {
+ let head = self.ref_manager.read_head()?;
+
+ match head.mode {
+ HeadMode::Direct => {
+ let new_head = Head {
+ mode: head.mode,
+ target: hash.to_string(),
+ };
+ self.ref_manager.update_head(new_head)?;
+ }
+ HeadMode::Symbolic => {
+ let ref_entry = RefEntry {
+ name: head.target.clone(),
+ commit_hash: hash.to_string(),
+ };
+ self.ref_manager.update_ref(&ref_entry)?;
+ }
+ }
+
+ Ok(())
+ }
+
+ /// Checks if a single branch is safe to delete.
+ ///
+ /// A branch is considered safe to delete if:
+ /// 1. **It is NOT the current active branch** (you cannot delete the branch you are currently on).
+ /// 2. It is a remote-tracking branch.
+ /// 3. Its tip commit is reachable from the current `HEAD` (fully merged).
+ ///
+ /// Returns `false` if the branch is the current active branch.
+ fn is_safe_to_delete(&self, branch_ref: &BranchRefEntry) -> EngineResult {
+ if matches!(branch_ref.branch_type, BranchType::Remote) {
+ return Ok(true);
+ }
+
+ let head = self.ref_manager.read_head()?;
+ if head.target == branch_ref.ref_entry.name {
+ return Ok(false);
+ }
+
+ let head_hash = match self.ref_manager.resolve_commit_hash(&head)? {
+ Some(hash) => hash,
+ None => {
+ return Err(
+ BranchError::NoHead(self.current_branch_name()?.unwrap_or("".into())).into(),
+ );
+ }
+ };
+
+ let safe_to_delete = self.history_traversal.walk_bfs(head_hash)?;
+
+ Ok(safe_to_delete.contains(&branch_ref.ref_entry.commit_hash.to_string()))
+ }
+
+ /// Optimized batch check for branch deletion safety.
+ ///
+ /// Performs a single BFS traversal starting from `HEAD` to determine which
+ /// of the provided branches are fully merged.
+ ///
+ /// # Arguments
+ ///
+ /// * `branch_refs` - A slice of references to check.
+ ///
+ /// # Returns
+ ///
+ /// A vector of tuples, where each tuple contains the original reference
+ /// and a boolean indicating whether it is safe to delete.
+ fn are_safe_to_delete<'a>(
+ &self,
+ branch_refs: &[&'a BranchRefEntry],
+ ) -> EngineResult> {
+ let head = self.ref_manager.read_head()?;
+ let head_hash = self.ref_manager.resolve_commit_hash(&head)?;
+ if head_hash.is_none() {
+ return Err(
+ BranchError::NoHead(self.current_branch_name()?.unwrap_or("".into())).into(),
+ );
+ }
+ let head_hash = head_hash.unwrap();
+
+ let safe_to_delete: HashSet = self
+ .history_traversal
+ .walk_bfs(head_hash.clone())?
+ .into_iter()
+ .collect();
+
+ let mut result = Vec::new();
+ for &branch_ref in branch_refs {
+ if matches!(branch_ref.branch_type, BranchType::Remote) {
+ result.push((branch_ref, true));
+ } else if branch_ref.ref_entry.name == head.target {
+ result.push((branch_ref, false));
+ } else {
+ let safe = safe_to_delete.contains(&branch_ref.ref_entry.commit_hash.to_string());
+ result.push((branch_ref, safe));
+ }
+ }
+
+ Ok(result)
+ }
+}
+
+impl BranchManager for MevaBranchManager {
+ fn current_branch_name(&self) -> EngineResult> {
+ let head = self.ref_manager.read_head()?;
+ match head.mode {
+ HeadMode::Symbolic => {
+ let prefix = self.ref_manager.heads_refs_prefix();
+ Ok(head.target.strip_prefix(&prefix).map(String::from))
+ }
+ HeadMode::Direct => Ok(None),
+ }
+ }
+
+ fn add_commit(&self, mut commit: MevaCommit) -> EngineResult {
+ let last_commit_hash = self.last_commit_hash()?;
+ match last_commit_hash {
+ Some(last_commit_hash) => {
+ commit.parents = vec![last_commit_hash];
+ }
+ None => {
+ commit.parents = vec![];
+ }
+ }
+
+ let hash = self.object_storage.add_commit(commit)?;
+
+ self.move_head(&hash)?;
+
+ Ok(hash)
+ }
+
+ fn amend_last_commit(&self, mut commit: MevaCommit) -> EngineResult {
+ let last_commit = self.last_commit()?.ok_or(CommitError::NoCommitToAmend)?;
+
+ commit.parents = last_commit.parents.clone();
+
+ let hash = self.object_storage.add_commit(commit)?;
+ self.move_head(&hash)?;
+
+ Ok(hash)
+ }
+
+ fn last_commit_hash(&self) -> EngineResult> {
+ let head = self.ref_manager.read_head()?;
+
+ Ok(match head.mode {
+ HeadMode::Direct => Some(head.target),
+ HeadMode::Symbolic => self
+ .ref_manager
+ .read_ref(&head.target)?
+ .map(|e| e.commit_hash),
+ })
+ }
+
+ fn last_commit(&self) -> EngineResult> {
+ if let Some(hash) = self.last_commit_hash()? {
+ let object = self.object_storage.get_object(&hash)?;
+ let commit = MevaCommit::try_from(object)?;
+
+ Ok(Some(commit))
+ } else {
+ Ok(None)
+ }
+ }
+
+ fn set_upstream(&self, local_branch_name: &str, remote_branch_name: &str) -> EngineResult<()> {
+ let local_branch_ref = self
+ .ref_manager
+ .resolve_branch_ref(local_branch_name)?
+ .ok_or_else(|| BranchError::BranchNotFound(local_branch_name.to_string()))?;
+ let remote_branch_ref = self
+ .ref_manager
+ .resolve_branch_ref(remote_branch_name)?
+ .ok_or_else(|| BranchError::BranchNotFound(remote_branch_name.to_string()))?;
+
+ if local_branch_ref.branch_type != BranchType::Local {
+ return Err(BranchError::NotLocalBranch(local_branch_name.to_string()).into());
+ }
+
+ if remote_branch_ref.branch_type != BranchType::Remote {
+ return Err(BranchError::NotRemoteBranch(remote_branch_name.to_string()).into());
+ }
+
+ let local_config_path = self.object_storage.layout().config_file();
+ let mut config_document = ConfigDocument::load(local_config_path)?;
+
+ let remote_branch_parts: Vec<_> = remote_branch_name.splitn(2, '/').collect();
+ let remote_name = remote_branch_parts[0];
+ let remote_branch_path = remote_branch_parts[1];
+
+ let mut branch_data = HashMap::new();
+ branch_data.insert("remote".to_string(), remote_name.to_string());
+ branch_data.insert(
+ "merge".to_string(),
+ format!(
+ "{}{}",
+ self.ref_manager.heads_refs_prefix(),
+ remote_branch_path
+ ),
+ );
+
+ config_document.set_table(&format!("branch.{local_branch_name}"), &branch_data)?;
+
+ config_document.save()
+ }
+
+ fn create_branch(&self, branch: &Branch) -> EngineResult<()> {
+ let ref_entry = RefEntry::new_branch_entry(branch)?;
+ self.ref_manager.update_ref(&ref_entry)
+ }
+
+ fn create_branches(&self, branch: &[Branch]) -> EngineResult<()> {
+ for branch in branch {
+ self.create_branch(branch)?;
+ }
+
+ Ok(())
+ }
+
+ fn remove_branch(&self, branch_name: &str, force: bool) -> EngineResult<()> {
+ let ref_entry = self.ref_manager.resolve_branch_ref(branch_name)?;
+
+ match ref_entry {
+ None => Err(BranchError::BranchNotFound(branch_name.to_owned()).into()),
+ Some(branch_entry) => {
+ if force || self.is_safe_to_delete(&branch_entry)? {
+ self.ref_manager.remove_ref(&branch_entry.ref_entry.name)?;
+ Ok(())
+ } else {
+ Err(
+ BranchError::NotSafeToDelete(branch_entry.ref_entry.name.to_string())
+ .into(),
+ )
+ }
+ }
+ }
+ }
+
+ fn remove_branches(
+ &self,
+ branch_names: &[&str],
+ force: bool,
+ ) -> EngineResult {
+ let mut result = RemoveBranchesResult {
+ deleted: Vec::new(),
+ failed: Vec::new(),
+ };
+
+ let mut branch_entries: HashMap = HashMap::new();
+ for &branch_name in branch_names {
+ let ref_entry = self.ref_manager.resolve_branch_ref(branch_name)?;
+
+ match ref_entry {
+ None => result.failed.push((
+ branch_name.to_string(),
+ BranchError::BranchNotFound(branch_name.to_owned()).into(),
+ )),
+ Some(branch_entry) => {
+ branch_entries.insert(branch_entry, branch_name);
+ }
+ }
+ }
+
+ let safe_to_delete = match force {
+ false => self.are_safe_to_delete(&branch_entries.keys().collect::>())?,
+ true => branch_entries.keys().map(|k| (k, true)).collect(),
+ };
+
+ for (branch_entry, safe) in safe_to_delete {
+ let branch_name = *branch_entries.get(branch_entry).unwrap();
+ if safe {
+ match self.ref_manager.remove_ref(&branch_entry.ref_entry.name) {
+ Ok(_) => {
+ result.deleted.push(branch_name.to_owned());
+ }
+ Err(e) => {
+ result.failed.push((branch_name.to_owned(), e));
+ }
+ }
+ } else {
+ result.failed.push((
+ branch_name.to_owned(),
+ BranchError::NotSafeToDelete(branch_name.to_owned()).into(),
+ ));
+ }
+ }
+
+ Ok(result)
+ }
+
+ fn rename_branch(&self, old_branch_name: &str, new_branch_name: &str) -> EngineResult<()> {
+ let old_branch_ref = self.ref_manager.resolve_branch_ref(old_branch_name)?;
+ let new_branch_ref = self.ref_manager.resolve_branch_ref(new_branch_name)?;
+
+ if old_branch_ref.is_none() {
+ return Err(BranchError::BranchNotFound(old_branch_name.to_owned()).into());
+ } else if new_branch_ref.is_some() {
+ return Err(BranchError::BranchAlreadyExists(new_branch_name.to_owned()).into());
+ }
+
+ let old_branch_ref = old_branch_ref.unwrap();
+
+ let new_branch = Branch {
+ name: new_branch_name.to_string(),
+ branch_type: old_branch_ref.branch_type,
+ head_hash: old_branch_ref.ref_entry.commit_hash,
+ };
+ let new_branch_ref = RefEntry::new_branch_entry(&new_branch)?;
+
+ self.ref_manager.update_ref(&new_branch_ref)?;
+ self.ref_manager
+ .remove_ref(&old_branch_ref.ref_entry.name)?;
+
+ Ok(())
+ }
+
+ fn list_branches(
+ &self,
+ local: bool,
+ remotes: bool,
+ detailed: bool,
+ ) -> EngineResult> {
+ let local_branches = match local {
+ true => self.ref_manager.collect_refs_heads()?,
+ false => Vec::new(),
+ };
+
+ let remote_branches = match remotes {
+ true => self.ref_manager.collect_refs_remotes("")?,
+ false => Vec::new(),
+ };
+
+ let local_prefix = self.ref_manager.heads_refs_prefix();
+ let remote_prefix = self.ref_manager.remotes_refs_prefix();
+
+ let process_entry = |ref_entry: RefEntry,
+ prefix: &str,
+ branch_type: BranchType|
+ -> EngineResult {
+ let branch_name = ref_entry
+ .name
+ .strip_prefix(prefix)
+ .ok_or_else(|| RefEntryError::RefPrefixMismatch {
+ name: ref_entry.name.clone(),
+ prefix: prefix.to_owned(),
+ })?
+ .to_owned();
+
+ if detailed {
+ let commit_object = self.object_storage.get_object(&ref_entry.commit_hash)?;
+ let commit = MevaCommit::try_from(commit_object)?;
+
+ Ok(BranchInfo::Detailed {
+ name: branch_name,
+ commit_message: commit.message,
+ commit_hash: ref_entry.commit_hash,
+ branch_type,
+ })
+ } else {
+ Ok(BranchInfo::NameOnly {
+ name: branch_name,
+ branch_type,
+ })
+ }
+ };
+
+ let local_iter = local_branches
+ .into_iter()
+ .map(|entry| process_entry(entry, &local_prefix, BranchType::Local));
+
+ let remote_iter = remote_branches
+ .into_iter()
+ .map(|entry| process_entry(entry, &remote_prefix, BranchType::Remote));
+
+ let branches_info: Vec =
+ local_iter.chain(remote_iter).collect::>()?;
+
+ Ok(branches_info)
+ }
+}
diff --git a/engine/src/branch_manager/remove_branches_result.rs b/engine/src/branch_manager/remove_branches_result.rs
new file mode 100644
index 00000000..550f7bb2
--- /dev/null
+++ b/engine/src/branch_manager/remove_branches_result.rs
@@ -0,0 +1,19 @@
+use crate::errors::EngineError;
+
+/// Aggregates the results of a batch branch deletion operation.
+///
+/// This structure is used when deleting multiple branches at once. It allows
+/// the operation to proceed even if some individual deletions fail, providing
+/// a complete report of successes and failures afterward.
+#[derive(Debug)]
+pub struct RemoveBranchesResult {
+ /// A list of names of the branches that were successfully removed.
+ pub deleted: Vec,
+
+ /// A list of branches that failed to be deleted, paired with the specific error.
+ ///
+ /// Each entry contains:
+ /// 1. The name of the branch.
+ /// 2. The [`EngineError`] explaining why the deletion failed (e.g., "branch not found", "branch not safe to delete").
+ pub failed: Vec<(String, EngineError)>,
+}
diff --git a/engine/src/commit_builder.rs b/engine/src/commit_builder.rs
new file mode 100644
index 00000000..278a06dc
--- /dev/null
+++ b/engine/src/commit_builder.rs
@@ -0,0 +1,15 @@
+pub mod meva_commit_builder;
+
+use crate::errors::EngineResult;
+use crate::objects::{MevaCommit, Person};
+
+pub use meva_commit_builder::MevaCommitBuilder;
+
+/// Defines the interface for constructing commits from the current repository state.
+///
+/// A [`CommitBuilder`] is responsible for producing a fully-formed [`MevaCommit`]
+/// by assembling all necessary metadata and referencing the tree representing
+/// the repository contents.
+pub trait CommitBuilder {
+ fn build_commit(&self, message: String, author: Person) -> EngineResult;
+}
diff --git a/engine/src/commit_builder/meva_commit_builder.rs b/engine/src/commit_builder/meva_commit_builder.rs
new file mode 100644
index 00000000..d63c09db
--- /dev/null
+++ b/engine/src/commit_builder/meva_commit_builder.rs
@@ -0,0 +1,216 @@
+use crate::CommitBuilder;
+use crate::ObjectStorage;
+use crate::errors::{EngineError, EngineResult, NodeError, PathError, TreeError};
+use crate::index::{Index, file_mode::FileMode};
+use crate::objects::{MevaCommit, MevaTree, Person, TreeEntry};
+use chrono::Utc;
+use path_absolutize::Absolutize;
+use shared::StripBase;
+use shared::{CumulativePaths, PathToString};
+use std::path::Path;
+use std::sync::Arc;
+use tree_ds::prelude::{Node, Tree};
+
+/// Builder responsible for constructing and storing a commit tree in memory.
+///
+/// A commit is represented as a hierarchical [`Tree`] where:
+/// - each directory and file path corresponds to a node,
+/// - the root node represents the repository root,
+/// - leaf nodes store file hashes (SHA-1).
+///
+/// The builder uses the in-memory [`MevaIndex`] to discover tracked files and
+/// their associated object hashes, then arranges them into a tree structure.
+/// Finally, it stores the resulting tree objects in the object storage.
+///
+/// This structure is the core mechanism for assembling commits in Meva.
+pub struct MevaCommitBuilder {
+ /// The object storage backend responsible for persisting objects (trees, blobs, commits).
+ object_storage: Arc,
+
+ /// The index providing the list of tracked files and their object hashes.
+ index: Arc,
+}
+
+/// Represents the value stored in a file node within the constructed commit tree.
+///
+/// Each [`TreeValue`] corresponds to a single file entry and stores:
+/// - `hash`: The SHA-1 hash of the blob.
+/// - `mode`: The file mode (executable, normal file, etc.).
+///
+/// This type is used internally when building tree hierarchies.
+#[derive(Debug, Clone, Eq, PartialEq)]
+struct TreeValue {
+ pub hash: String,
+ pub mode: FileMode,
+}
+
+impl MevaCommitBuilder {
+ /// Creates a new [`MevaCommitBuilder`].
+ ///
+ /// # Arguments
+ /// * `object_storage` — Backend responsible for writing commit-related objects.
+ /// * `index` — Source of tracked files used to construct the commit tree.
+ pub fn new(object_storage: Arc, index: Arc) -> Self {
+ Self {
+ object_storage,
+ index,
+ }
+ }
+
+ /// Stores a complete [`Tree`] of repository contents recursively in object storage.
+ ///
+ /// Returns the hash of the root tree object.
+ fn store_tree_objects(&self, tree: Tree) -> EngineResult {
+ let root_node_id = tree
+ .get_root_node()
+ .ok_or(TreeError::from(NodeError::RootNodeMissing))?
+ .get_node_id()
+ .map_err(|_| TreeError::from(NodeError::NodeMissingId))?;
+
+ self.store_tree_recursively(&tree, root_node_id)
+ }
+
+ /// Recursively traverses the tree and stores each subtree as a [`MevaTree`] object.
+ ///
+ /// Returns the SHA-1 hash of the stored tree.
+ fn store_tree_recursively(
+ &self,
+ tree: &Tree,
+ root_id: String,
+ ) -> EngineResult {
+ let root = tree
+ .get_node_by_id(&root_id)
+ .ok_or(TreeError::from(NodeError::NodeNotFound { id: root_id }))?;
+
+ let node_ids = root
+ .get_children_ids()
+ .map_err(|e| TreeError::OperationFailed {
+ message: e.to_string(),
+ })?;
+
+ let mut tree_entries: Vec = Vec::new();
+ for node_id in node_ids {
+ let node =
+ tree.get_node_by_id(&node_id)
+ .ok_or(TreeError::from(NodeError::NodeNotFound {
+ id: node_id.clone(),
+ }))?;
+ let name = Path::new(&node_id)
+ .file_name()
+ .ok_or(PathError::EmptyPath)?
+ .to_utf8_string();
+ if let Some(tree_value) = node.get_value().map_err(|e| TreeError::OperationFailed {
+ message: e.to_string(),
+ })? {
+ tree_entries.push(TreeEntry::blob(name, tree_value.mode, tree_value.hash));
+ } else {
+ let hash = self.store_tree_recursively(tree, node_id)?;
+ tree_entries.push(TreeEntry::tree(name, hash));
+ }
+ }
+
+ self.object_storage.add_tree(MevaTree::new(tree_entries))
+ }
+
+ /// Builds a hierarchical [`Tree`] from the current index state.
+ ///
+ /// Converts tracked paths and their associated blob hashes into a
+ /// nested directory structure.
+ ///
+ /// # Errors
+ ///
+ /// Returns an [`EngineResult`] if index loading, path resolution,
+ /// or tree construction fails.
+ fn build_tree_from_index(&self) -> EngineResult> {
+ let entries = self.index.get_entries();
+ let working_dir = self.object_storage.layout().working_dir();
+ let meva_repository_dir = working_dir.absolutize()?;
+
+ let mut tree: Tree = Tree::new(None);
+ let root_key = meva_repository_dir.to_utf8_string();
+ tree.add_node(Node::new(root_key.clone(), None), None)
+ .map_err(|e| TreeError::OperationFailed {
+ message: e.to_string(),
+ })?;
+
+ for entry in entries {
+ let entry_absolute_path = Path::new(&entry.path);
+ let relative_path = entry_absolute_path.strip_base(&meva_repository_dir);
+
+ let components = relative_path.cumulative_paths();
+
+ let first_key = components
+ .first()
+ .ok_or(EngineError::EmptyCollection)?
+ .to_utf8_string();
+ if tree.get_node_by_id(&first_key).is_none() {
+ let node_val = match components.len() {
+ 1 => Some(TreeValue {
+ hash: entry.sha1.clone(),
+ mode: entry.mode,
+ }),
+ _ => None,
+ };
+ let node = Node::new(first_key, node_val);
+ tree.add_node(node, Some(&root_key))
+ .map_err(|e| TreeError::OperationFailed {
+ message: e.to_string(),
+ })?;
+ }
+
+ for window in components.windows(2) {
+ let parent_key = window[0].to_utf8_string();
+ let key = window[1].to_utf8_string();
+
+ if tree.get_node_by_id(&key).is_some() {
+ continue;
+ }
+
+ let node_val = if key == components.last().unwrap().to_utf8_string() {
+ Some(TreeValue {
+ hash: entry.sha1.clone(),
+ mode: entry.mode,
+ })
+ } else {
+ None
+ };
+
+ let node = Node::new(key, node_val);
+ tree.add_node(node, Some(&parent_key))
+ .map_err(|e| TreeError::OperationFailed {
+ message: e.to_string(),
+ })?;
+ }
+ }
+
+ Ok(tree)
+ }
+}
+
+impl CommitBuilder for MevaCommitBuilder {
+ /// Builds a new [`MevaCommit`] from the current index.
+ ///
+ /// Constructs a full tree from the index, serializes and stores all
+ /// related [`MevaTree`] objects, and returns a new commit referencing
+ /// the root tree.
+ ///
+ /// The resulting commit **does not have its parent set** — this must be
+ /// handled externally (e.g., by the branch manager).
+ ///
+ /// # Arguments
+ ///
+ /// * `message` – Commit message describing the change.
+ /// * `author` – Author information (name and email).
+ ///
+ /// # Errors
+ ///
+ /// Returns an [`EngineResult`] if index loading, tree construction,
+ /// or object storage fails.
+ fn build_commit(&self, message: String, author: Person) -> EngineResult {
+ let tree = self.build_tree_from_index()?;
+
+ let root_tree_hash = self.store_tree_objects(tree)?;
+
+ Ok(MevaCommit::new(root_tree_hash, message, author, Utc::now()))
+ }
+}
diff --git a/engine/src/config.rs b/engine/src/config.rs
new file mode 100644
index 00000000..9c74b2f0
--- /dev/null
+++ b/engine/src/config.rs
@@ -0,0 +1,9 @@
+pub mod config_document;
+pub mod config_document_operations;
+pub mod config_loader;
+pub mod config_location;
+
+pub use config_document::ConfigDocument;
+pub use config_document_operations::ConfigDocumentOperations;
+pub use config_loader::{ConfigLoader, ConfigLoaderExtensions, MevaConfigLoader};
+pub use config_location::ConfigLocation;
diff --git a/engine/src/config/config_document.rs b/engine/src/config/config_document.rs
new file mode 100644
index 00000000..29cbff65
--- /dev/null
+++ b/engine/src/config/config_document.rs
@@ -0,0 +1,453 @@
+use std::{
+ collections::HashMap,
+ fs,
+ path::{Path, PathBuf},
+};
+
+use toml_edit::{Datetime, DocumentMut, Item, Table, Value, value};
+
+use crate::{
+ config::ConfigDocumentOperations,
+ errors::{ConfigError, EngineResult},
+};
+
+/// Represents an editable TOML configuration file on disk.
+pub struct ConfigDocument {
+ /// Filesystem path to the TOML file.
+ pub path: PathBuf,
+
+ /// In-memory mutable representation of the TOML document.
+ pub doc: DocumentMut,
+}
+
+impl ConfigDocument {
+ /// Load and parse a TOML file from the given path.
+ ///
+ /// # Arguments
+ ///
+ /// * `path` – Path reference to the TOML configuration file.
+ ///
+ /// # Returns
+ ///
+ /// An `EngineResult` containing a new `ConfigDocument` on success,
+ /// or an error if reading or parsing fails.
+ pub fn load>(path: P) -> EngineResult {
+ Self::validate_existing_file(path.as_ref())?;
+
+ let path_buf: PathBuf = path.as_ref().into();
+
+ let content = fs::read_to_string(&path_buf)?;
+ let doc = content.parse::().map_err(ConfigError::Toml)?;
+
+ Ok(Self {
+ path: path_buf,
+ doc,
+ })
+ }
+
+ /// Write the current in-memory TOML document back to disk.
+ ///
+ /// # Returns
+ ///
+ /// An `EngineResult<()>` indicating success or containing an I/O error.
+ pub fn save(&self) -> EngineResult<()> {
+ fs::write(&self.path, self.doc.to_string())?;
+ Ok(())
+ }
+
+ /// Validates that the provided path refers to an existing regular file.
+ pub fn validate_existing_file(path: &Path) -> EngineResult<()> {
+ if !path.is_file() {
+ return Err(ConfigError::InvalidConfigFile {
+ path: path.display().to_string(),
+ reason: "path is not a regular file or it does not exist".to_string(),
+ }
+ .into());
+ }
+
+ Ok(())
+ }
+
+ /// Split a dotted key path into its segments.
+ fn split_key_path(path: &str) -> Vec<&str> {
+ path.split('.').filter(|s| !s.is_empty()).collect()
+ }
+
+ /// Parse a string into a TOML `Item`, trying multiple types.
+ ///
+ /// Supports bool, integer, float, datetime, or falls back to string.
+ fn parse_item(s: &str) -> EngineResult- {
+ let trimmed = s.trim();
+
+ if let Ok(it) = trimmed.parse::
- () {
+ return Ok(it);
+ }
+ if let Ok(b) = trimmed.parse::() {
+ return Ok(value(b));
+ }
+ if let Ok(i) = trimmed.parse::() {
+ return Ok(value(i));
+ }
+ if let Ok(f) = trimmed.parse::() {
+ return Ok(value(f));
+ }
+ if let Ok(dt) = trimmed.parse::() {
+ return Ok(value(dt));
+ }
+
+ // Fallback to raw string value
+ Ok(value(s))
+ }
+
+ /// Convert a TOML `Value` to its string representation.
+ fn value_to_string(value: &Value) -> Option {
+ match value {
+ Value::String(s) => Some(s.value().clone()),
+ Value::Integer(i) => Some(i.value().to_string()),
+ Value::Float(f) => Some(f.value().to_string()),
+ Value::Boolean(b) => Some(b.value().to_string()),
+ Value::Datetime(dt) => Some(dt.value().to_string()),
+ Value::Array(arr) => {
+ // Recursively convert each element in the array
+ let elems = arr
+ .iter()
+ .map(Self::value_to_string)
+ .collect::>>()?;
+ Some(format!("[{}]", elems.join(",")))
+ }
+ Value::InlineTable(table) => Some(table.to_string()),
+ }
+ }
+
+ /// Recursively collect all key/value pairs from a TOML `Item`.
+ ///
+ /// # Arguments
+ ///
+ /// * `prefix` – Current key path prefix (dot-separated).
+ /// * `item` – The TOML item to traverse.
+ /// * `result` – Accumulates found (key, value) tuples.
+ fn collect_key_values(prefix: &str, item: &Item, result: &mut Vec<(String, String)>) {
+ match item {
+ // Recurse into tables, appending each sub-key
+ Item::Table(table) => {
+ for (key, value) in table.iter() {
+ let full_key = if prefix.is_empty() {
+ key.to_string()
+ } else {
+ format!("{prefix}.{key}")
+ };
+ Self::collect_key_values(&full_key, value, result);
+ }
+ }
+ // Convert leaf values to string and push them to the result
+ Item::Value(value) => {
+ if let Some(value_str) = Self::value_to_string(value) {
+ result.push((prefix.to_string(), value_str));
+ }
+ }
+ _ => {} // Ignore other item types
+ }
+ }
+
+ /// Converts a TOML [`Item`] into a [`HashMap`] of strings if it represents a table.
+ ///
+ /// This method handles both standard tables and inline tables.
+ ///
+ /// # Returns
+ /// `Some(HashMap)` containing the key-value pairs if the item is a table,
+ /// or `None` if the item is a primitive value or array.
+ fn item_to_map(item: &Item) -> Option> {
+ let mut map = HashMap::new();
+
+ match item {
+ Item::Table(table) => {
+ for (k, v) in table.iter() {
+ if let Some(val_str) = Self::value_to_string(v.as_value()?) {
+ map.insert(k.to_string(), val_str);
+ }
+ }
+ Some(map)
+ }
+ Item::Value(Value::InlineTable(table)) => {
+ for (k, v) in table.iter() {
+ if let Some(val_str) = Self::value_to_string(v) {
+ map.insert(k.to_string(), val_str);
+ }
+ }
+ Some(map)
+ }
+ _ => None,
+ }
+ }
+}
+
+impl ConfigDocumentOperations for ConfigDocument {
+ fn get(&self, key_path: &str, default: Option<&String>) -> EngineResult {
+ let keys = Self::split_key_path(key_path);
+ let mut current_item = self.doc.as_item();
+
+ for key in keys {
+ current_item = match current_item.get(key) {
+ Some(item) => item,
+ None => {
+ return match default {
+ Some(val) => Ok(val.to_string()),
+ None => Err(ConfigError::KeyNotFound {
+ key: key_path.to_string(),
+ }
+ .into()),
+ };
+ }
+ }
+ }
+
+ match current_item {
+ Item::Value(value) => Self::value_to_string(value).ok_or_else(|| {
+ ConfigError::InvalidValueType {
+ type_name: value.type_name().to_string(),
+ }
+ .into()
+ }),
+ _ => Err(ConfigError::InvalidValueType {
+ type_name: current_item.type_name().to_string(),
+ }
+ .into()),
+ }
+ }
+
+ fn get_table(&self, key_path: &str) -> EngineResult> {
+ let keys = Self::split_key_path(key_path);
+ let mut current_item = self.doc.as_item();
+
+ for key in keys {
+ current_item = match current_item.get(key) {
+ Some(item) => item,
+ None => {
+ return Err(ConfigError::KeyNotFound {
+ key: key_path.to_string(),
+ }
+ .into());
+ }
+ }
+ }
+
+ if !current_item.is_table() && !current_item.is_inline_table() {
+ return Err(ConfigError::InvalidValueType {
+ type_name: current_item.type_name().to_string(),
+ }
+ .into());
+ }
+
+ let mut collected_vec = Vec::new();
+
+ Self::collect_key_values("", current_item, &mut collected_vec);
+ let result_map: HashMap = collected_vec.into_iter().collect();
+
+ Ok(result_map)
+ }
+
+ fn get_subtables(
+ &self,
+ key_path: &str,
+ ) -> EngineResult>> {
+ let keys = Self::split_key_path(key_path);
+ let mut current_item = self.doc.as_item();
+
+ for key in keys {
+ match current_item.get(key) {
+ Some(item) => current_item = item,
+ None => {
+ return Err(ConfigError::KeyNotFound {
+ key: key_path.to_string(),
+ }
+ .into());
+ }
+ }
+ }
+
+ let mut result = HashMap::new();
+
+ if let Some(table) = current_item.as_table() {
+ for (key, item) in table.iter() {
+ if let Some(properties) = Self::item_to_map(item) {
+ result.insert(key.to_string(), properties);
+ }
+ }
+ } else if let Some(inline_table) = current_item.as_inline_table() {
+ for (key, item) in inline_table.iter() {
+ let item_wrapper = Item::Value(item.clone());
+ if let Some(properties) = Self::item_to_map(&item_wrapper) {
+ result.insert(key.to_string(), properties);
+ }
+ }
+ }
+
+ Ok(result)
+ }
+
+ fn set(&mut self, key_path: &str, val: &str) -> EngineResult<()> {
+ let keys = Self::split_key_path(key_path);
+
+ if keys.is_empty() {
+ return Err(ConfigError::InvalidKey {
+ key: key_path.to_string(),
+ }
+ .into());
+ }
+
+ let item = Self::parse_item(val)?;
+ let mut current_table = self.doc.as_table_mut();
+
+ for &seg in &keys[..keys.len() - 1] {
+ let entry = current_table.entry(seg);
+ let next = entry.or_insert(Item::Table(Table::new()));
+ current_table = next.as_table_mut().unwrap();
+ }
+
+ let last = keys[keys.len() - 1];
+ current_table[last] = item;
+
+ Ok(())
+ }
+
+ fn set_table(&mut self, key_path: &str, values: &HashMap) -> EngineResult<()> {
+ let keys = Self::split_key_path(key_path);
+
+ let mut current_table = self.doc.as_table_mut();
+
+ for key in keys {
+ let entry = current_table.entry(key);
+
+ let item = entry.or_insert(Item::Table(Table::new()));
+
+ let item_name = item.type_name().to_string();
+
+ current_table = item.as_table_mut().ok_or(ConfigError::InvalidValueType {
+ type_name: item_name,
+ })?;
+
+ current_table.set_implicit(false);
+ }
+
+ for (k, v) in values {
+ let item = Self::parse_item(v)?;
+ current_table.insert(k, item);
+ }
+
+ Ok(())
+ }
+
+ fn unset(&mut self, key_path: &str) -> EngineResult {
+ let keys = Self::split_key_path(key_path);
+
+ if keys.is_empty() {
+ return Err(ConfigError::InvalidKey {
+ key: key_path.to_string(),
+ }
+ .into());
+ }
+
+ let mut current = self.doc.as_item_mut();
+
+ for key in &keys[..keys.len() - 1] {
+ if let Some(item) = current.get_mut(key) {
+ current = item;
+ } else {
+ return Err(ConfigError::KeyNotFound {
+ key: key_path.to_string(),
+ }
+ .into());
+ }
+ }
+
+ let last_key = keys[keys.len() - 1];
+
+ if let Some(table) = current.as_table_like_mut() {
+ if let Some(removed_item) = table.remove(last_key) {
+ let value_str = match removed_item {
+ Item::Value(v) => {
+ Self::value_to_string(&v).ok_or_else(|| ConfigError::InvalidValueType {
+ type_name: v.type_name().to_string(),
+ })?
+ }
+ Item::Table(t) => t.to_string(),
+ other => {
+ let s = other.to_string();
+ if s.is_empty() {
+ return Err(ConfigError::InvalidValueType {
+ type_name: other.type_name().to_string(),
+ }
+ .into());
+ } else {
+ s
+ }
+ }
+ };
+
+ return Ok(value_str);
+ } else {
+ return Err(ConfigError::KeyNotFound {
+ key: key_path.to_string(),
+ }
+ .into());
+ }
+ }
+
+ Err(ConfigError::KeyNotFound {
+ key: key_path.to_string(),
+ }
+ .into())
+ }
+
+ fn list(&self) -> Vec<(String, String)> {
+ let mut result = Vec::new();
+ Self::collect_key_values("", self.doc.as_item(), &mut result);
+ result
+ }
+
+ fn rename_entry(
+ &mut self,
+ parent_path: &str,
+ old_key: &str,
+ new_key: &str,
+ ) -> EngineResult<()> {
+ let keys = Self::split_key_path(parent_path);
+ let mut current_item = self.doc.as_item_mut();
+
+ for key in keys {
+ if let Some(item) = current_item.get_mut(key) {
+ current_item = item;
+ } else {
+ return Err(ConfigError::KeyNotFound {
+ key: parent_path.to_string(),
+ }
+ .into());
+ }
+ }
+
+ let current_item_type = current_item.type_name().to_string();
+
+ let parent_table = current_item
+ .as_table_mut()
+ .ok_or(ConfigError::InvalidValueType {
+ type_name: current_item_type,
+ })?;
+
+ if parent_table.contains_key(new_key) {
+ return Err(ConfigError::KeyAlreadyExists {
+ key: format!("{parent_path}.{new_key}"),
+ }
+ .into());
+ }
+
+ if let Some(item) = parent_table.remove(old_key) {
+ parent_table.insert(new_key, item);
+ Ok(())
+ } else {
+ Err(ConfigError::KeyNotFound {
+ key: format!("{parent_path}.{old_key}"),
+ }
+ .into())
+ }
+ }
+}
diff --git a/engine/src/config/config_document_operations.rs b/engine/src/config/config_document_operations.rs
new file mode 100644
index 00000000..63479a8f
--- /dev/null
+++ b/engine/src/config/config_document_operations.rs
@@ -0,0 +1,83 @@
+use std::collections::HashMap;
+
+use crate::errors::EngineResult;
+
+/// Defines operations for accessing and modifying configuration values
+pub trait ConfigDocumentOperations {
+ /// Retrieves the value at the specified key path.
+ ///
+ /// # Arguments
+ ///
+ /// * `key_path` – A dot‑separated string indicating the nested configuration key.
+ /// * `default` – An optional fallback value if the key is not present.
+ ///
+ /// # Returns
+ ///
+ /// An `EngineResult` wrapping the found value as `String`, or an error if retrieval fails.
+ fn get(&self, key_path: &str, default: Option<&String>) -> EngineResult;
+
+ /// Retrieves all values within a specific table section as a flat `HashMap`.
+ ///
+ /// This flattens nested keys relative to the requested `key_path`.
+ /// For example, if `[remote.origin]` has a key `url`, the result map will contain "url".
+ fn get_table(&self, key_path: &str) -> EngineResult>;
+
+ /// Retrieves immediate sub-tables of a given key path.
+ ///
+ /// # Returns
+ /// A map where the key is the sub-table name (e.g., "origin") and the value
+ /// is a map of that sub-table's properties.
+ fn get_subtables(
+ &self,
+ key_path: &str,
+ ) -> EngineResult>>;
+
+ /// Sets or overrides the value at the specified key path.
+ ///
+ /// # Arguments
+ ///
+ /// * `key_path` – A dot‑separated string indicating where to store the value.
+ /// * `val` – The new string value to assign.
+ ///
+ /// # Returns
+ ///
+ /// An `EngineResult<()>` indicating success or containing an error.
+ fn set(&mut self, key_path: &str, val: &str) -> EngineResult<()>;
+
+ /// Sets multiple values within a specific table section.
+ ///
+ /// This ensures the target table exists and populates it with the provided
+ /// key-value pairs.
+ fn set_table(&mut self, key_path: &str, values: &HashMap) -> EngineResult<()>;
+
+ /// Removes the value at the specified key path, if it exists.
+ ///
+ /// # Arguments
+ ///
+ /// * `key_path` – A dot‑separated string for the key to remove.
+ ///
+ /// # Returns
+ ///
+ /// An `EngineResult` indicating success or containing an error.
+ fn unset(&mut self, key_path: &str) -> EngineResult;
+
+ /// Lists all configuration entries as key/value pairs.
+ ///
+ /// # Returns
+ ///
+ /// A `Vec` of tuples where each tuple contains the full key path and its corresponding value.
+ fn list(&self) -> Vec<(String, String)>;
+
+ /// Renames an entry within a specific table.
+ ///
+ /// # Arguments
+ ///
+ /// * `parent_path` - The path to the table containing the key.
+ /// * `old_key` - The current name of the key.
+ /// * `new_key` - The new name for the key.
+ ///
+ /// # Errors
+ /// Returns `KeyAlreadyExists` if `new_key` is already present in the table.
+ fn rename_entry(&mut self, parent_path: &str, old_key: &str, new_key: &str)
+ -> EngineResult<()>;
+}
diff --git a/engine/src/config/config_loader.rs b/engine/src/config/config_loader.rs
new file mode 100644
index 00000000..24f009d3
--- /dev/null
+++ b/engine/src/config/config_loader.rs
@@ -0,0 +1,222 @@
+use std::{fmt::Debug, io::Write, path::Path, str::FromStr};
+
+use shared::fs::create_file_with_dirs;
+
+use crate::{
+ ConfigLocation,
+ config::{ConfigDocument, ConfigDocumentOperations},
+ errors::{ConfigError, EngineError, EngineResult},
+};
+
+pub trait ConfigLoader: Send + Sync + Debug {
+ /// Retrieve a configuration value by key, searching through each
+ /// configured location until found or falling back to default.
+ ///
+ /// # Arguments
+ ///
+ /// * `key_path` - Dot-separated key string (e.g., "section.key").
+ /// * `default` - Optional default value if key is missing in all locations.
+ ///
+ /// # Returns
+ ///
+ /// The found `String` value or an error if not found or on I/O issues.
+ fn get(&self, key_path: &str, default: Option<&String>) -> EngineResult;
+
+ /// Create a new local configuration file with default settings.
+ ///
+ /// # Arguments
+ ///
+ /// * `path` - Path where the local config file should be created.
+ fn create_local_config(&self, path: &Path) -> EngineResult<()>;
+
+ /// Create a new global configuration file with default settings.
+ /// If the file already exists, it will not overwrite it.
+ fn create_global_config(&self, path: Option<&Path>) -> EngineResult<()>;
+
+ /// Returns the default content for a local configuration file.
+ fn get_default_local_config(&self) -> &str;
+
+ /// Returns the default content for a global configuration file.
+ fn get_default_global_config(&self) -> &str;
+}
+
+/// Responsible for loading configuration values from multiple sources
+/// in a defined search order (e.g., local, global).
+#[derive(Debug)]
+pub struct MevaConfigLoader {
+ /// Ordered list of locations to search for configuration files.
+ locations: Vec,
+}
+
+impl Default for MevaConfigLoader {
+ /// Creates a loader with the default search order.
+ fn default() -> Self {
+ Self {
+ locations: vec![ConfigLocation::Local, ConfigLocation::Global],
+ }
+ }
+}
+
+impl MevaConfigLoader {
+ /// Creates a loader with a custom list of locations.
+ ///
+ /// # Arguments
+ ///
+ /// * `locations` - A vector of `ConfigLocation` enums defining the search order.
+ #[allow(dead_code)]
+ fn with_locations(locations: Vec) -> Self {
+ Self { locations }
+ }
+
+ /// Attempt to load a configuration value from a single location.
+ ///
+ /// # Arguments
+ ///
+ /// * `loc` - The `ConfigLocation` to load from (local, global, system).
+ /// * `key_path` - The dot-separated key string.
+ /// * `default` - Optional default value if the key is missing.
+ ///
+ /// # Returns
+ ///
+ /// The found value or an error wrapped in [`EngineResult`].
+ fn try_load_from(
+ &self,
+ location: &ConfigLocation,
+ key_path: &str,
+ default: Option<&String>,
+ ) -> EngineResult {
+ match location.get_default_path() {
+ Ok(path) => {
+ let doc = ConfigDocument::load(&path)?;
+ doc.get(key_path, default)
+ }
+ Err(err) => Err(err),
+ }
+ }
+}
+
+impl ConfigLoader for MevaConfigLoader {
+ fn get(&self, key_path: &str, default: Option<&String>) -> EngineResult {
+ let mut last_key_not_found = None;
+
+ for loc in &self.locations {
+ match self.try_load_from(loc, key_path, None) {
+ Ok(val) => {
+ return Ok(val);
+ }
+ Err(err) => match err {
+ EngineError::Config(ConfigError::KeyNotFound { .. }) => {
+ last_key_not_found = Some(err);
+ }
+ EngineError::Config(ConfigError::ConfigNotFound { .. }) => {
+ continue;
+ }
+ other => {
+ return Err(other);
+ }
+ },
+ }
+ }
+
+ match default {
+ Some(default) => Ok(default.clone()),
+ None => Err(last_key_not_found.unwrap_or_else(|| {
+ EngineError::Config(ConfigError::KeyNotFound {
+ key: key_path.to_string(),
+ })
+ })),
+ }
+ }
+
+ fn create_local_config(&self, path: &Path) -> EngineResult<()> {
+ let (mut config_file, created) = create_file_with_dirs(path)?;
+
+ if created {
+ config_file.write_all(self.get_default_local_config().as_bytes())?;
+ }
+
+ Ok(())
+ }
+
+ fn create_global_config(&self, path: Option<&Path>) -> EngineResult<()> {
+ let global_path = ConfigLocation::Global.get_default_path()?;
+ let path = path.unwrap_or(&global_path);
+ let (mut config_file, created) = create_file_with_dirs(path)?;
+
+ if created {
+ config_file.write_all(self.get_default_global_config().as_bytes())?;
+ }
+
+ Ok(())
+ }
+
+ fn get_default_local_config(&self) -> &str {
+ let default_config = concat!(
+ "# Meva Configuration File\n",
+ "# Edit this file to customize your local settings\n",
+ "\n",
+ "[plugins]\n",
+ "enabled = false\n",
+ "collect_logs = false\n",
+ "\n"
+ );
+
+ default_config
+ }
+
+ fn get_default_global_config(&self) -> &str {
+ let default_config = concat!(
+ "# Meva Configuration File\n",
+ "# Edit this file to customize your global settings\n",
+ "\n",
+ "# [user]\n",
+ "# name = \"Your Name\"\n",
+ "# email = \"your.email@example.com\"\n",
+ "# signing_key = \"path/to/your/signing/key\"\n",
+ "\n",
+ "# [editor]\n",
+ "# default = \"vim\"\n",
+ "\n",
+ "[plugins]\n",
+ "enabled = false\n",
+ "collect_logs = false\n",
+ "\n"
+ );
+
+ default_config
+ }
+}
+
+pub trait ConfigLoaderExtensions: ConfigLoader {
+ /// Retrieve a configuration value and parse it into a specific type.
+ ///
+ /// # Arguments
+ ///
+ /// * `key` - Dot-separated key string to locate the configuration value.
+ /// * `default` - Default value returned if key is missing.
+ ///
+ /// # Returns
+ ///
+ /// Parsed value of type `T`, or an error if parsing fails.
+ fn get_parsed(&self, key: &str, default: T) -> EngineResult
+ where
+ T: FromStr + ToString,
+ ::Err: std::fmt::Display;
+}
+
+impl ConfigLoaderExtensions for L {
+ fn get_parsed(&self, key: &str, default: T) -> EngineResult
+ where
+ T: FromStr + ToString,
+ ::Err: std::fmt::Display,
+ {
+ let default_string = default.to_string();
+ let raw_value = self.get(key, Some(&default_string))?;
+
+ raw_value.parse::().map_err(|e| {
+ EngineError::Config(ConfigError::InvalidValueType {
+ type_name: format!("{}: {}", std::any::type_name::(), e),
+ })
+ })
+ }
+}
diff --git a/engine/src/config/config_location.rs b/engine/src/config/config_location.rs
new file mode 100644
index 00000000..050fd8ef
--- /dev/null
+++ b/engine/src/config/config_location.rs
@@ -0,0 +1,110 @@
+use std::path::{Path, PathBuf};
+
+use shared::UpwardSearch;
+use strum_macros::{Display, EnumIter};
+
+use crate::{
+ RepositoryLayout,
+ errors::{ConfigError, EngineResult},
+ repositories::meva_repository_layout::MevaRepositoryLayout,
+};
+
+/// Defines where to load configuration from: global, local repository, or a specific file.
+#[derive(Debug, Default, Clone, PartialEq, Eq, EnumIter, Display)]
+pub enum ConfigLocation {
+ /// User-level config file in the OS config directory
+ #[default]
+ Global,
+
+ /// Repository-specific config file, searched upward from current working directory
+ Local,
+
+ /// Explicit config file path provided by user
+ File(PathBuf),
+}
+
+impl ConfigLocation {
+ /// Determines the `ConfigLocation` variant based on a given path.
+ ///
+ /// # Arguments
+ ///
+ /// * `path` - The path to check against known global and local config locations.
+ ///
+ /// # Returns
+ ///
+ /// Returns `Global` if the path matches the OS config directory, `Local` if it matches
+ /// a repository-specific config, or `File` for any other path.
+ pub fn from_path(path: &Path) -> EngineResult {
+ let layout = MevaRepositoryLayout::from_env()?;
+
+ let path = path.canonicalize()?;
+ let expected_global =
+ Self::global_path(layout.repository_dir_name(), layout.config_file_name())?;
+ if path == expected_global {
+ return Ok(ConfigLocation::Global);
+ }
+
+ if let Ok(local_candidate) =
+ Self::local_path(layout.repository_dir_name(), layout.config_file_name())
+ && path == local_candidate
+ {
+ return Ok(ConfigLocation::Local);
+ }
+
+ Ok(ConfigLocation::File(path.to_path_buf()))
+ }
+
+ /// Resolve the full path to the configuration file for this location variant.
+ ///
+ /// # Returns
+ ///
+ /// A `PathBuf` pointing to the config file, or an error if resolution fails.
+ pub fn get_default_path(&self) -> EngineResult {
+ let layout = MevaRepositoryLayout::from_env()?;
+ match self {
+ ConfigLocation::Global => {
+ Self::global_path(layout.repository_dir_name(), layout.config_file_name())
+ }
+ ConfigLocation::Local => {
+ Self::local_path(layout.repository_dir_name(), layout.config_file_name())
+ }
+ ConfigLocation::File(path) => Ok(path.to_path_buf()),
+ }
+ }
+
+ /// Compute the global configuration path in the OS config directory.
+ ///
+ /// # Arguments
+ ///
+ /// * `repository_dir` – Marker directory name indicating the repo root.
+ /// * `config_file` – The filename for the config.
+ ///
+ /// # Errors
+ ///
+ /// * `HomeDirNotFound` if the OS config directory is unavailable.
+ pub fn global_path(repository_dir: &str, config_file: &str) -> EngineResult {
+ let base = dirs::config_dir().ok_or(ConfigError::HomeDirNotFound)?;
+ // Prefix filename with a dot for hidden file convention
+ Ok(base.join(repository_dir).join(format!(".{config_file}")))
+ }
+
+ /// Locate the repository root by searching upward, then append the config file.
+ ///
+ /// # Arguments
+ ///
+ /// * `repository_dir` – Marker directory name indicating the repo root.
+ /// * `config_file` – The filename for the config.
+ ///
+ /// # Errors
+ ///
+ /// * `ConfigNotFound` if no ancestor directory contains `repository_dir`.
+ fn local_path(repository_dir: &str, config_file: &str) -> EngineResult {
+ let repo = std::env::current_dir()?
+ .search_dir_up(repository_dir)
+ .ok_or(ConfigError::ConfigNotFound {
+ location: ConfigLocation::Local,
+ })?;
+
+ Ok(repo.join(config_file))
+ }
+}
diff --git a/engine/src/diff_builder.rs b/engine/src/diff_builder.rs
new file mode 100644
index 00000000..bf862169
--- /dev/null
+++ b/engine/src/diff_builder.rs
@@ -0,0 +1,210 @@
+mod meva_diff_builder;
+mod models;
+
+use crate::errors::EngineResult;
+use crate::index::WorkingDirEntry;
+use crate::index::index_entry::IndexEntry;
+use crate::objects::{MevaCommit, ObjectEntry};
+use crate::revision_parsing::Revision;
+pub use meva_diff_builder::MevaDiffBuilder;
+pub use models::{
+ ChangeKind, DiffMode, DiffStat, FileChange, FileChangeKind, FileDiffStat, Hunk, HunkLine,
+ HunkLineType, RevisionRange, RevisionSide,
+};
+use std::collections::HashMap;
+use std::path::PathBuf;
+
+/// Defines the interface for computing diffs between repository states.
+///
+/// A [`DiffBuilder`] is responsible for comparing snapshots of the repository:
+/// commits, the index, and the working directory.
+///
+/// Implementations of this trait provide the full set of comparison strategies
+/// needed to detect added, removed, and modified files. The output is always a
+/// list of [`FileChange`] structures representing semantic differences between
+/// snapshots.
+pub trait DiffBuilder: Send + Sync {
+ /// Computes the difference between two repository snapshots (commits).
+ ///
+ /// # Arguments
+ ///
+ /// * `from` - The starting revision for the diff.
+ /// * `to` - The ending revision for the diff.
+ /// * `mode` - The level of detail for the diff ([`DiffMode`]).
+ /// * `paths` - An optional slice of paths to limit the diff to. If `None`, all paths are considered.
+ ///
+ /// # Returns
+ ///
+ /// A [`EngineResult`] containing a vector of [`FileChange`] objects representing the differences.
+ fn diff_snapshots(
+ &self,
+ from: &Revision,
+ to: &Revision,
+ mode: &DiffMode,
+ paths: Option<&[PathBuf]>,
+ ) -> EngineResult>;
+
+ /// Computes the difference between a commit and its first parent.
+ /// If the commit has no parents (an initial commit), it shows all files as added.
+ ///
+ /// # Arguments
+ ///
+ /// * `child` - The revision of the commit to analyze.
+ /// * `mode` - The level of detail for the diff.
+ /// * `include_changes` - If `false`, skips the diff calculation and returns an empty vector of changes.
+ ///
+ /// # Returns
+ ///
+ /// A tuple containing the resolved child commit, its hash, and a vector of file changes.
+ fn diff_snapshot_with_parent(
+ &self,
+ child: &Revision,
+ mode: &DiffMode,
+ include_changes: bool,
+ ) -> EngineResult<(MevaCommit, String, Vec)>;
+
+ /// Computes the difference between a repository snapshot and the working directory.
+ ///
+ /// # Arguments
+ ///
+ /// * `from` - The revision to compare against the working directory.
+ /// * `mode` - The level of detail for the diff ([`DiffMode`]).
+ /// * `paths` - An optional slice of paths to limit the diff to.
+ ///
+ /// # Returns
+ ///
+ /// A [`EngineResult`] containing a vector of [`FileChange`] objects.
+ fn diff_snapshot_working_dir(
+ &self,
+ from: &Revision,
+ mode: &DiffMode,
+ paths: Option<&[PathBuf]>,
+ ) -> EngineResult>;
+
+ /// Computes the difference between a repository snapshot and the index (staging area).
+ ///
+ /// # Arguments
+ ///
+ /// * `from` - The revision to compare against the index.
+ /// * `mode` - The level of detail for the diff ([`DiffMode`]).
+ /// * `paths` - An optional slice of paths to limit the diff to.
+ ///
+ /// # Returns
+ ///
+ /// A [`EngineResult`] containing a vector of [`FileChange`] objects.
+ fn diff_snapshot_index(
+ &self,
+ from: &Revision,
+ mode: &DiffMode,
+ paths: Option<&[PathBuf]>,
+ ) -> EngineResult>;
+
+ /// Computes the difference between the index (staging area) and the working directory.
+ ///
+ /// This method detects changes that have not been staged yet (e.g., modifications,
+ /// deletions, and untracked files which are considered 'added' relative to the index).
+ ///
+ /// # Arguments
+ ///
+ /// * `mode` - The level of detail for the diff ([`DiffMode`]).
+ /// * `paths` - An optional slice of paths to limit the diff to. If `None`, the entire
+ /// working directory is compared.
+ /// * `index_map` - An optional, pre-computed map of index entries. If `None`, this
+ /// method will generate its own map from the loaded index.
+ /// * `working_map` - An optional, pre-computed map of working directory entries.
+ /// If `None`, this method will scan the working directory to create one.
+ ///
+ /// # Returns
+ ///
+ /// A [`EngineResult`] containing a vector of [`FileChange`] objects.
+ fn diff_index_working_dir(
+ &self,
+ mode: &DiffMode,
+ paths: Option<&[PathBuf]>,
+ index_map: Option