diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 9081435..a69bf52 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -36,7 +36,8 @@ env:
RUST_BACKTRACE: short
RUSTFLAGS: -D warnings
# Crate publish order (dependencies first)
- CRATES: "masterror-template masterror-derive masterror"
+ # template → derive → knowledge → masterror → cli
+ CRATES: "masterror-template masterror-derive masterror-knowledge masterror masterror-cli"
jobs:
# ════════════════════════════════════════════════════════════════════════════
@@ -58,13 +59,160 @@ jobs:
echo "version=$MSRV" >> "$GITHUB_OUTPUT"
echo "MSRV: $MSRV"
+ # ════════════════════════════════════════════════════════════════════════════
+ # Detect changed crates (dependency-aware)
+ # ════════════════════════════════════════════════════════════════════════════
+
+ changes:
+ name: Detect Changes
+ runs-on: ubuntu-latest
+ outputs:
+ # Individual crate changes
+ template: ${{ steps.filter.outputs.template }}
+ derive: ${{ steps.filter.outputs.derive }}
+ knowledge: ${{ steps.filter.outputs.knowledge }}
+ masterror: ${{ steps.filter.outputs.masterror }}
+ cli: ${{ steps.filter.outputs.cli }}
+ # Dependency-aware: need to rebuild these
+ need-template: ${{ steps.deps.outputs.need-template }}
+ need-derive: ${{ steps.deps.outputs.need-derive }}
+ need-knowledge: ${{ steps.deps.outputs.need-knowledge }}
+ need-masterror: ${{ steps.deps.outputs.need-masterror }}
+ need-cli: ${{ steps.deps.outputs.need-cli }}
+ # Any library changed (for full workspace checks)
+ any-lib: ${{ steps.deps.outputs.any-lib }}
+ # CI/config changed (force full rebuild)
+ ci: ${{ steps.filter.outputs.ci }}
+ steps:
+ - uses: actions/checkout@v5
+
+ - name: Detect file changes
+ uses: dorny/paths-filter@v3
+ id: filter
+ with:
+ filters: |
+ template:
+ - 'masterror-template/**'
+ derive:
+ - 'masterror-derive/**'
+ knowledge:
+ - 'masterror-knowledge/**'
+ masterror:
+ - 'src/**'
+ - 'Cargo.toml'
+ - 'build.rs'
+ cli:
+ - 'masterror-cli/**'
+ ci:
+ - '.github/workflows/**'
+ - 'Cargo.lock'
+ - 'deny.toml'
+ - 'cliff.toml'
+ - '.cargo/**'
+
+ - name: Compute dependency graph
+ id: deps
+ run: |
+ # Dependency graph:
+ # template ← derive ← masterror
+ # ↗
+ # knowledge ← cli
+ # ↘ masterror (optional feature)
+
+ TEMPLATE="${{ steps.filter.outputs.template }}"
+ DERIVE="${{ steps.filter.outputs.derive }}"
+ KNOWLEDGE="${{ steps.filter.outputs.knowledge }}"
+ MASTERROR="${{ steps.filter.outputs.masterror }}"
+ CLI="${{ steps.filter.outputs.cli }}"
+ CI="${{ steps.filter.outputs.ci }}"
+
+ # Force all if CI config changed or workflow_dispatch
+ if [[ "$CI" == "true" ]] || [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
+ echo "CI config changed or manual trigger - rebuilding all"
+ echo "need-template=true" >> "$GITHUB_OUTPUT"
+ echo "need-derive=true" >> "$GITHUB_OUTPUT"
+ echo "need-knowledge=true" >> "$GITHUB_OUTPUT"
+ echo "need-masterror=true" >> "$GITHUB_OUTPUT"
+ echo "need-cli=true" >> "$GITHUB_OUTPUT"
+ echo "any-lib=true" >> "$GITHUB_OUTPUT"
+ exit 0
+ fi
+
+ # template: standalone
+ NEED_TEMPLATE="$TEMPLATE"
+
+ # derive: depends on template
+ if [[ "$DERIVE" == "true" ]] || [[ "$TEMPLATE" == "true" ]]; then
+ NEED_DERIVE=true
+ else
+ NEED_DERIVE=false
+ fi
+
+ # knowledge: standalone
+ NEED_KNOWLEDGE="$KNOWLEDGE"
+
+ # masterror: depends on template, derive, optionally knowledge
+ if [[ "$MASTERROR" == "true" ]] || [[ "$TEMPLATE" == "true" ]] || \
+ [[ "$DERIVE" == "true" ]] || [[ "$KNOWLEDGE" == "true" ]]; then
+ NEED_MASTERROR=true
+ else
+ NEED_MASTERROR=false
+ fi
+
+ # cli: depends on knowledge
+ if [[ "$CLI" == "true" ]] || [[ "$KNOWLEDGE" == "true" ]]; then
+ NEED_CLI=true
+ else
+ NEED_CLI=false
+ fi
+
+ # Any library changed?
+ if [[ "$NEED_TEMPLATE" == "true" ]] || [[ "$NEED_DERIVE" == "true" ]] || \
+ [[ "$NEED_KNOWLEDGE" == "true" ]] || [[ "$NEED_MASTERROR" == "true" ]] || \
+ [[ "$NEED_CLI" == "true" ]]; then
+ ANY_LIB=true
+ else
+ ANY_LIB=false
+ fi
+
+ echo "need-template=$NEED_TEMPLATE" >> "$GITHUB_OUTPUT"
+ echo "need-derive=$NEED_DERIVE" >> "$GITHUB_OUTPUT"
+ echo "need-knowledge=$NEED_KNOWLEDGE" >> "$GITHUB_OUTPUT"
+ echo "need-masterror=$NEED_MASTERROR" >> "$GITHUB_OUTPUT"
+ echo "need-cli=$NEED_CLI" >> "$GITHUB_OUTPUT"
+ echo "any-lib=$ANY_LIB" >> "$GITHUB_OUTPUT"
+
+ echo "Summary:"
+ echo " template: $TEMPLATE → need: $NEED_TEMPLATE"
+ echo " derive: $DERIVE → need: $NEED_DERIVE"
+ echo " knowledge: $KNOWLEDGE → need: $NEED_KNOWLEDGE"
+ echo " masterror: $MASTERROR → need: $NEED_MASTERROR"
+ echo " cli: $CLI → need: $NEED_CLI"
+ echo " any-lib: $ANY_LIB"
+
+ # GitHub Step Summary
+ cat >> $GITHUB_STEP_SUMMARY << EOF
+ ## 🔍 Change Detection
+
+ | Crate | Changed | Rebuild |
+ |-------|---------|---------|
+ | masterror-template | $([[ "$TEMPLATE" == "true" ]] && echo "✅" || echo "—") | $([[ "$NEED_TEMPLATE" == "true" ]] && echo "🔨" || echo "⏭️") |
+ | masterror-derive | $([[ "$DERIVE" == "true" ]] && echo "✅" || echo "—") | $([[ "$NEED_DERIVE" == "true" ]] && echo "🔨" || echo "⏭️") |
+ | masterror-knowledge | $([[ "$KNOWLEDGE" == "true" ]] && echo "✅" || echo "—") | $([[ "$NEED_KNOWLEDGE" == "true" ]] && echo "🔨" || echo "⏭️") |
+ | masterror | $([[ "$MASTERROR" == "true" ]] && echo "✅" || echo "—") | $([[ "$NEED_MASTERROR" == "true" ]] && echo "🔨" || echo "⏭️") |
+ | masterror-cli | $([[ "$CLI" == "true" ]] && echo "✅" || echo "—") | $([[ "$NEED_CLI" == "true" ]] && echo "🔨" || echo "⏭️") |
+
+ **Legend:** ✅ = changed, 🔨 = will rebuild, ⏭️ = skipped, — = no changes
+ EOF
+
# ════════════════════════════════════════════════════════════════════════════
# STAGE 1: CHECKS (parallel matrix)
# ════════════════════════════════════════════════════════════════════════════
check:
name: Check (${{ matrix.rust }} / ${{ matrix.os }})
- needs: msrv
+ needs: [msrv, changes]
+ if: needs.changes.outputs.any-lib == 'true'
runs-on: ${{ matrix.os }}
strategy:
fail-fast: false
@@ -124,6 +272,8 @@ jobs:
fmt:
name: Format
+ needs: changes
+ if: needs.changes.outputs.any-lib == 'true'
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v5
@@ -138,6 +288,8 @@ jobs:
docs:
name: Documentation
+ needs: changes
+ if: needs.changes.outputs.any-lib == 'true'
runs-on: ubuntu-latest
env:
RUSTDOCFLAGS: -D warnings
@@ -155,6 +307,8 @@ jobs:
no-std:
name: no_std (${{ matrix.name }})
+ needs: changes
+ if: needs.changes.outputs.need-masterror == 'true'
runs-on: ubuntu-latest
strategy:
fail-fast: false
@@ -185,7 +339,7 @@ jobs:
save-if: ${{ github.ref == 'refs/heads/main' }}
- name: Check ${{ matrix.name }}
- run: cargo check ${{ matrix.args }}
+ run: cargo check -p masterror ${{ matrix.args }}
security:
name: Security Audit
@@ -225,8 +379,16 @@ jobs:
test:
name: Test Suite
- needs: [check, fmt, no-std, security, reuse]
- if: ${{ !inputs.skip_tests }}
+ needs: [changes, check, fmt, no-std, security, reuse]
+ if: |
+ always() &&
+ !inputs.skip_tests &&
+ needs.changes.outputs.any-lib == 'true' &&
+ (needs.check.result == 'success' || needs.check.result == 'skipped') &&
+ (needs.fmt.result == 'success' || needs.fmt.result == 'skipped') &&
+ (needs['no-std'].result == 'success' || needs['no-std'].result == 'skipped') &&
+ needs.security.result == 'success' &&
+ needs.reuse.result == 'success'
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v5
@@ -262,7 +424,11 @@ jobs:
coverage:
name: Coverage
- needs: test
+ needs: [changes, test]
+ if: |
+ always() &&
+ needs.changes.outputs.any-lib == 'true' &&
+ needs.test.result == 'success'
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v5
@@ -309,9 +475,13 @@ jobs:
benchmarks:
name: Benchmarks
- needs: test
+ needs: [changes, test]
runs-on: ubuntu-latest
- if: github.event_name == 'pull_request' || github.ref == 'refs/heads/main'
+ if: |
+ always() &&
+ needs.changes.outputs.need-masterror == 'true' &&
+ needs.test.result == 'success' &&
+ (github.event_name == 'pull_request' || github.ref == 'refs/heads/main')
steps:
- uses: actions/checkout@v5
@@ -340,12 +510,18 @@ jobs:
changelog:
name: Update Changelog
- needs: [check, fmt, no-std, security, reuse]
+ needs: [changes, check, fmt, no-std, security, reuse]
runs-on: ubuntu-latest
if: |
+ always() &&
(github.event_name == 'push' || github.event_name == 'workflow_dispatch') &&
github.ref == 'refs/heads/main' &&
- !contains(github.event.head_commit.message || '', '[skip ci]')
+ !contains(github.event.head_commit.message || '', '[skip ci]') &&
+ (needs.check.result == 'success' || needs.check.result == 'skipped') &&
+ (needs.fmt.result == 'success' || needs.fmt.result == 'skipped') &&
+ (needs['no-std'].result == 'success' || needs['no-std'].result == 'skipped') &&
+ needs.security.result == 'success' &&
+ needs.reuse.result == 'success'
steps:
- uses: actions/checkout@v5
with:
@@ -412,10 +588,12 @@ jobs:
release:
name: Release
- needs: [test, changelog]
+ needs: [changes, test, changelog]
if: |
always() &&
+ needs.changes.outputs.any-lib == 'true' &&
(needs.test.result == 'success' || needs.test.result == 'skipped') &&
+ (needs.changelog.result == 'success' || needs.changelog.result == 'skipped') &&
(github.event_name == 'push' || github.event_name == 'workflow_dispatch') &&
github.ref == 'refs/heads/main' &&
!contains(github.event.head_commit.message || '', '[skip ci]')
@@ -508,7 +686,7 @@ jobs:
declare -A LOCAL REMOTE NEEDS_PUBLISH
PUBLISHED_ANY=false
- for crate in masterror-template masterror-derive masterror; do
+ for crate in $CRATES; do
LOCAL[$crate]=$(get_local_version "$crate")
REMOTE[$crate]=$(get_remote_version "$crate")
@@ -527,16 +705,21 @@ jobs:
# Dependency-aware publishing
# ══════════════════════════════════════════════════════════════════
- # If derive changes, masterror should also be republished
- # (it depends on derive, users need consistent versions)
+ # Dependency consistency warnings
if [[ "${NEEDS_PUBLISH[masterror-derive]}" == "true" ]] && \
[[ "${NEEDS_PUBLISH[masterror]}" == "false" ]]; then
warn "masterror-derive changed but masterror version unchanged"
warn "Consider bumping masterror version for dependency consistency"
fi
- # Publish in order: template → derive → masterror
- for crate in masterror-template masterror-derive masterror; do
+ if [[ "${NEEDS_PUBLISH[masterror-knowledge]}" == "true" ]] && \
+ [[ "${NEEDS_PUBLISH[masterror-cli]}" == "false" ]]; then
+ warn "masterror-knowledge changed but masterror-cli version unchanged"
+ warn "Consider bumping masterror-cli version for dependency consistency"
+ fi
+
+ # Publish in order: template → derive → knowledge → masterror → cli
+ for crate in $CRATES; do
if [[ "${NEEDS_PUBLISH[$crate]}" == "true" ]]; then
if publish_crate "$crate"; then
PUBLISHED_ANY=true
@@ -605,7 +788,9 @@ jobs:
|-------|--------|
| masterror-template | ${{ steps.publish.outputs.published == 'true' && '✅ Published' || '⏭️ Skipped' }} |
| masterror-derive | ${{ steps.publish.outputs.published == 'true' && '✅ Published' || '⏭️ Skipped' }} |
+ | masterror-knowledge | ${{ steps.publish.outputs.published == 'true' && '✅ Published' || '⏭️ Skipped' }} |
| masterror | ${{ steps.publish.outputs.published == 'true' && '✅ Published' || '⏭️ Skipped' }} |
+ | masterror-cli | ${{ steps.publish.outputs.published == 'true' && '✅ Published' || '⏭️ Skipped' }} |
**Version:** `${{ steps.publish.outputs.version }}`
EOF
@@ -681,19 +866,48 @@ jobs:
ci-success:
name: CI Success
- needs: [check, fmt, docs, no-std, security, reuse, test]
+ needs: [changes, check, fmt, docs, no-std, security, reuse, test]
if: always()
runs-on: ubuntu-latest
steps:
- name: Check all jobs
run: |
- results="${{ needs.check.result }} ${{ needs.fmt.result }} ${{ needs.docs.result }} ${{ needs.no-std.result }} ${{ needs.security.result }} ${{ needs.reuse.result }} ${{ needs.test.result }}"
-
- for r in $results; do
- if [[ "$r" == "failure" ]]; then
- echo "::error::One or more required jobs failed"
- exit 1
- fi
- done
+ echo "Job results:"
+ echo " changes: ${{ needs.changes.result }}"
+ echo " check: ${{ needs.check.result }}"
+ echo " fmt: ${{ needs.fmt.result }}"
+ echo " docs: ${{ needs.docs.result }}"
+ echo " no-std: ${{ needs['no-std'].result }}"
+ echo " security: ${{ needs.security.result }}"
+ echo " reuse: ${{ needs.reuse.result }}"
+ echo " test: ${{ needs.test.result }}"
+
+ FAILED=false
+
+ # Changes detection must succeed
+ [[ "${{ needs.changes.result }}" != "success" ]] && \
+ echo "::error::Changes detection failed" && FAILED=true
+
+ # Security and REUSE must always pass
+ [[ "${{ needs.security.result }}" == "failure" ]] && \
+ echo "::error::Security audit failed" && FAILED=true
+ [[ "${{ needs.reuse.result }}" == "failure" ]] && \
+ echo "::error::REUSE compliance failed" && FAILED=true
+
+ # Other jobs: failure is not OK (skipped is fine)
+ [[ "${{ needs.check.result }}" == "failure" ]] && \
+ echo "::error::Check job failed" && FAILED=true
+ [[ "${{ needs.fmt.result }}" == "failure" ]] && \
+ echo "::error::Format job failed" && FAILED=true
+ [[ "${{ needs.docs.result }}" == "failure" ]] && \
+ echo "::error::Docs job failed" && FAILED=true
+ [[ "${{ needs['no-std'].result }}" == "failure" ]] && \
+ echo "::error::no-std job failed" && FAILED=true
+ [[ "${{ needs.test.result }}" == "failure" ]] && \
+ echo "::error::Test job failed" && FAILED=true
+
+ if [[ "$FAILED" == "true" ]]; then
+ exit 1
+ fi
- echo "✅ All CI checks passed!"
+ echo "✅ All CI checks passed (some may have been skipped due to no changes)"
diff --git a/.hooks/pre-commit b/.hooks/pre-commit
index eeacd39..ccc498a 100755
--- a/.hooks/pre-commit
+++ b/.hooks/pre-commit
@@ -20,6 +20,25 @@ else
echo " - pip: pip install reuse"
fi
+echo "🔧 Linting GitHub Actions..."
+if command -v actionlint &> /dev/null; then
+ actionlint
+else
+ echo "⚠️ Warning: actionlint not installed, skipping Actions linting"
+ echo " Install with:"
+ echo " - Arch Linux: paru -S actionlint"
+ echo " - Go: go install github.com/rhysd/actionlint/cmd/actionlint@latest"
+ echo " - Homebrew: brew install actionlint"
+fi
+
+echo "🔒 Checking no_std compatibility..."
+cargo check --no-default-features -q
+cargo check --features std -q
+cargo check --no-default-features --features tracing -q
+cargo check --no-default-features --features metrics -q
+cargo check --no-default-features --features colored -q
+cargo check --all-features -q
+
echo "🔍 Running clippy (all features, all targets)..."
cargo clippy --workspace --all-targets --all-features -- -D warnings
diff --git a/Cargo.lock b/Cargo.lock
index 2bb2db3..d2f553b 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -156,7 +156,7 @@ dependencies = [
"serde_json",
"serde_urlencoded",
"smallvec",
- "socket2 0.6.1",
+ "socket2 0.6.2",
"time",
"tracing",
"url",
@@ -225,12 +225,56 @@ version = "0.1.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4b46cbb362ab8752921c97e041f5e366ee6297bd428a31275b9fcf1e380f7299"
+[[package]]
+name = "anstream"
+version = "0.6.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "43d5b281e737544384e969a5ccad3f1cdd24b48086a0fc1b2a5262a26b8f4f4a"
+dependencies = [
+ "anstyle",
+ "anstyle-parse",
+ "anstyle-query",
+ "anstyle-wincon",
+ "colorchoice",
+ "is_terminal_polyfill",
+ "utf8parse",
+]
+
[[package]]
name = "anstyle"
version = "1.0.13"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5192cca8006f1fd4f7237516f40fa183bb07f8fbdfedaa0036de5ea9b0b45e78"
+[[package]]
+name = "anstyle-parse"
+version = "0.2.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4e7644824f0aa2c7b9384579234ef10eb7efb6a0deb83f9630a49594dd9c15c2"
+dependencies = [
+ "utf8parse",
+]
+
+[[package]]
+name = "anstyle-query"
+version = "1.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "40c48f72fd53cd289104fc64099abca73db4166ad86ea0b4341abe65af83dadc"
+dependencies = [
+ "windows-sys 0.61.2",
+]
+
+[[package]]
+name = "anstyle-wincon"
+version = "3.0.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "291e6a250ff86cd4a820112fb8898808a366d8f9f58ce16d1f538353ad55747d"
+dependencies = [
+ "anstyle",
+ "once_cell_polyfill",
+ "windows-sys 0.61.2",
+]
+
[[package]]
name = "anyhow"
version = "1.0.100"
@@ -258,6 +302,27 @@ version = "0.5.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7d902e3d592a523def97af8f317b08ce16b7ab854c1985a0c671e6f15cebc236"
+[[package]]
+name = "arrayvec"
+version = "0.7.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7c02d123df017efcdfbd739ef81735b36c5ba83ec3c59c80a9d7ecc718f92e50"
+
+[[package]]
+name = "assert_cmd"
+version = "2.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9c5bcfa8749ac45dd12cb11055aeeb6b27a3895560d60d71e3c23bf979e60514"
+dependencies = [
+ "anstyle",
+ "bstr",
+ "libc",
+ "predicates",
+ "predicates-core",
+ "predicates-tree",
+ "wait-timeout",
+]
+
[[package]]
name = "async-trait"
version = "0.1.89"
@@ -435,6 +500,17 @@ dependencies = [
"hybrid-array",
]
+[[package]]
+name = "bstr"
+version = "1.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "63044e1ae8e69f3b5a92c736ca6269b8d12fa7efe39bf34ddb06d102cf0e2cab"
+dependencies = [
+ "memchr",
+ "regex-automata",
+ "serde",
+]
+
[[package]]
name = "bumpalo"
version = "3.19.1"
@@ -482,9 +558,9 @@ checksum = "37b2a672a2cb129a2e41c10b1224bb368f9f37a2b16b612598138befd7b37eb5"
[[package]]
name = "cc"
-version = "1.2.53"
+version = "1.2.54"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "755d2fce177175ffca841e9a06afdb2c4ab0f593d53b4dee48147dfaade85932"
+checksum = "6354c81bbfd62d9cfa9cb3c773c2b7b2a3a482d569de977fd0e961f6e7c00583"
dependencies = [
"find-msvc-tools",
"shlex",
@@ -544,6 +620,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c6e6ff9dcd79cff5cd969a17a545d79e84ab086e444102a591e288a8aa3ce394"
dependencies = [
"clap_builder",
+ "clap_derive",
]
[[package]]
@@ -552,8 +629,23 @@ version = "4.5.54"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "fa42cf4d2b7a41bc8f663a7cab4031ebafa1bf3875705bfaf8466dc60ab52c00"
dependencies = [
+ "anstream",
"anstyle",
"clap_lex",
+ "strsim",
+ "terminal_size",
+]
+
+[[package]]
+name = "clap_derive"
+version = "4.5.49"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2a0b5487afeab2deb2ff4e03a807ad1a03ac532ff5a2cee5d86884440c7f7671"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "quote",
+ "syn",
]
[[package]]
@@ -562,6 +654,12 @@ version = "0.7.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "c3e64b0cc0439b12df2fa678eae89a1c56a529fd067a9115f7827f1fffd22b32"
+[[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"
@@ -972,6 +1070,12 @@ version = "0.1.13"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "56254986775e3233ffa9c4d7d3faaf6d36a2c09d30b20687e9f88bc8bafc16c8"
+[[package]]
+name = "difflib"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6184e33543162437515c2e2b48714794e37845ec9851711914eec9d308f6ebe8"
+
[[package]]
name = "digest"
version = "0.10.7"
@@ -996,6 +1100,27 @@ dependencies = [
"subtle",
]
+[[package]]
+name = "dirs"
+version = "6.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c3e8aa94d75141228480295a7d0e7feb620b1a5ad9f12bc40be62411e38cce4e"
+dependencies = [
+ "dirs-sys",
+]
+
+[[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",
+ "windows-sys 0.61.2",
+]
+
[[package]]
name = "displaydoc"
version = "0.2.5"
@@ -1185,6 +1310,15 @@ version = "0.1.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8591b0bcc8a98a64310a2fae1bb3e9b8564dd10e381e6e28010fde8e8e8568db"
+[[package]]
+name = "float-cmp"
+version = "0.10.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b09cf3155332e944990140d967ff5eceb70df778b34f77d8075db46e4704e6d8"
+dependencies = [
+ "num-traits",
+]
+
[[package]]
name = "flume"
version = "0.11.1"
@@ -1551,9 +1685,9 @@ checksum = "df3b46402a9d5adb4c86a0cf463f42e19994e3ee891101b1841f30a545cb49a9"
[[package]]
name = "hybrid-array"
-version = "0.4.5"
+version = "0.4.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f471e0a81b2f90ffc0cb2f951ae04da57de8baa46fa99112b062a5173a5088d0"
+checksum = "b41fb3dc24fe72c2e3a4685eed55917c2fb228851257f4a8f2d985da9443c3e5"
dependencies = [
"typenum",
]
@@ -1612,7 +1746,7 @@ dependencies = [
"libc",
"percent-encoding",
"pin-project-lite",
- "socket2 0.5.10",
+ "socket2 0.6.2",
"tokio",
"tower-service",
"tracing",
@@ -1838,6 +1972,12 @@ version = "1.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7655c9839580ee829dfacba1d1278c2b7883e50a277ff7541299489d6bdfdc45"
+[[package]]
+name = "is_terminal_polyfill"
+version = "1.70.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a6cb138bb79a146c1bd460005623e142ef0181e3d0219cb493e02f7d08a35695"
+
[[package]]
name = "itertools"
version = "0.13.0"
@@ -1897,9 +2037,9 @@ checksum = "bcc35a38544a891a5f7c865aca548a982ccb3b8650a5b06d0fd33a10283c56fc"
[[package]]
name = "libm"
-version = "0.2.15"
+version = "0.2.16"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f9fbbcab51052fe104eb5e5d351cf728d30a5be1fe14d9be8a3b097481fb97de"
+checksum = "b6d2cec3eae94f9f509c767b45932f1ada8350c4bdb85af2fcab4a3c14807981"
[[package]]
name = "libredox"
@@ -1964,7 +2104,7 @@ checksum = "a94d21414c1f4a51209ad204c1776a3d0765002c76c6abcb602a6f09f1e881c7"
[[package]]
name = "masterror"
-version = "0.27.2"
+version = "0.28.0"
dependencies = [
"actix-web",
"anyhow",
@@ -1978,9 +2118,11 @@ dependencies = [
"log",
"log-mdc",
"masterror-derive",
+ "masterror-knowledge",
"masterror-template",
"metrics",
"owo-colors",
+ "phf",
"redis",
"reqwest",
"ryu",
@@ -2005,6 +2147,21 @@ dependencies = [
"wasm-bindgen",
]
+[[package]]
+name = "masterror-cli"
+version = "0.1.0"
+dependencies = [
+ "assert_cmd",
+ "clap",
+ "dirs",
+ "masterror-knowledge",
+ "owo-colors",
+ "predicates",
+ "serde",
+ "serde_json",
+ "toml",
+]
+
[[package]]
name = "masterror-derive"
version = "0.11.2"
@@ -2015,6 +2172,24 @@ dependencies = [
"syn",
]
+[[package]]
+name = "masterror-knowledge"
+version = "0.1.0"
+dependencies = [
+ "aho-corasick",
+ "arrayvec",
+]
+
+[[package]]
+name = "masterror-rustc"
+version = "0.1.0"
+dependencies = [
+ "libc",
+ "masterror-knowledge",
+ "owo-colors",
+ "windows-sys 0.59.0",
+]
+
[[package]]
name = "masterror-template"
version = "0.4.1"
@@ -2122,6 +2297,12 @@ dependencies = [
"tempfile",
]
+[[package]]
+name = "normalize-line-endings"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61807f77802ff30975e01f4f071c8ba10c022052f98b3294119f3e615d13e5be"
+
[[package]]
name = "nu-ansi-term"
version = "0.50.3"
@@ -2182,9 +2363,9 @@ dependencies = [
[[package]]
name = "num-conv"
-version = "0.1.0"
+version = "0.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "51d515d32fb182ee37cda2ccdcb92950d6a3c2893aa280e540671c2cd0f3b1d9"
+checksum = "cf97ec579c3c42f953ef76dbf8d55ac91fb219dde70e49aa4a6b7d74e9919050"
[[package]]
name = "num-integer"
@@ -2242,6 +2423,12 @@ version = "1.21.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "42f5e15c9953c5e4ccceeb2e7382a716482c34515315f7b03532b8b4e8393d2d"
+[[package]]
+name = "once_cell_polyfill"
+version = "1.70.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "384b8ab6d37215f3c5301a95a4accb5d64aa607f1fcb26a11b5303878451b4fe"
+
[[package]]
name = "oorandom"
version = "11.1.5"
@@ -2292,6 +2479,12 @@ dependencies = [
"vcpkg",
]
+[[package]]
+name = "option-ext"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "04744f49eae99ab78e0d5c0b603ab218f515ea8cfe5a456d7629ad883a3b6e7d"
+
[[package]]
name = "ordered-multimap"
version = "0.7.3"
@@ -2415,6 +2608,48 @@ dependencies = [
"sha2 0.10.9",
]
+[[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",
+]
+
+[[package]]
+name = "phf_shared"
+version = "0.11.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "67eabc2ef2a60eb7faa00097bd1ffdb5bd28e62bf39990626a582201b7a754e5"
+dependencies = [
+ "siphasher",
+]
+
[[package]]
name = "pin-project"
version = "1.1.10"
@@ -2532,6 +2767,36 @@ dependencies = [
"zerocopy",
]
+[[package]]
+name = "predicates"
+version = "3.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a5d19ee57562043d37e82899fade9a22ebab7be9cef5026b07fda9cdd4293573"
+dependencies = [
+ "anstyle",
+ "difflib",
+ "float-cmp",
+ "normalize-line-endings",
+ "predicates-core",
+ "regex",
+]
+
+[[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 = "pretty_assertions"
version = "1.4.1"
@@ -2697,7 +2962,7 @@ dependencies = [
"itoa",
"percent-encoding",
"ryu",
- "socket2 0.6.1",
+ "socket2 0.6.2",
"url",
"xxhash-rust",
]
@@ -2720,6 +2985,17 @@ dependencies = [
"bitflags",
]
+[[package]]
+name = "redox_users"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a4e608c6638b9c18977b00b475ac1f28d14e84b27d8d42f70e0bf1e3dec127ac"
+dependencies = [
+ "getrandom 0.2.17",
+ "libredox",
+ "thiserror",
+]
+
[[package]]
name = "ref-cast"
version = "1.0.25"
@@ -3196,6 +3472,12 @@ dependencies = [
"rand_core 0.6.4",
]
+[[package]]
+name = "siphasher"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b2aa850e253778c88a04c3d7323b043aeda9d3e30d5971937c1855769763678e"
+
[[package]]
name = "slab"
version = "0.4.11"
@@ -3223,9 +3505,9 @@ dependencies = [
[[package]]
name = "socket2"
-version = "0.6.1"
+version = "0.6.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "17129e116933cf371d018bb80ae557e889637989d8638274fb25622827b03881"
+checksum = "86f4aa3ad99f2088c990dfa82d367e19cb29268ed67c574d10d0a4bfe71f07e0"
dependencies = [
"libc",
"windows-sys 0.60.2",
@@ -3612,6 +3894,22 @@ 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",
+ "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 = "thiserror"
version = "2.0.18"
@@ -3643,9 +3941,9 @@ dependencies = [
[[package]]
name = "time"
-version = "0.3.45"
+version = "0.3.46"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f9e442fc33d7fdb45aa9bfeb312c095964abdf596f7567261062b2a7107aaabd"
+checksum = "9da98b7d9b7dad93488a84b8248efc35352b0b2657397d4167e7ad67e5d535e5"
dependencies = [
"deranged",
"itoa",
@@ -3658,15 +3956,15 @@ dependencies = [
[[package]]
name = "time-core"
-version = "0.1.7"
+version = "0.1.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8b36ee98fd31ec7426d599183e8fe26932a8dc1fb76ddb6214d05493377d34ca"
+checksum = "7694e1cfe791f8d31026952abf09c69ca6f6fa4e1a1229e18988f06a04a12dca"
[[package]]
name = "time-macros"
-version = "0.2.25"
+version = "0.2.26"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "71e552d1249bf61ac2a52db88179fd0673def1e1ad8243a00d9ec9ed71fee3dd"
+checksum = "78cc610bac2dcee56805c99642447d4c5dbde4d01f752ffea0199aee1f601dc4"
dependencies = [
"num-conv",
"time-core",
@@ -3728,7 +4026,7 @@ dependencies = [
"parking_lot",
"pin-project-lite",
"signal-hook-registry",
- "socket2 0.6.1",
+ "socket2 0.6.2",
"tokio-macros",
"windows-sys 0.61.2",
]
@@ -3826,7 +4124,7 @@ dependencies = [
"hyper-util",
"percent-encoding",
"pin-project",
- "socket2 0.6.1",
+ "socket2 0.6.2",
"sync_wrapper",
"tokio",
"tokio-stream",
@@ -4074,6 +4372,12 @@ 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 = "utoipa"
version = "5.4.0"
@@ -4157,6 +4461,15 @@ version = "0.9.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"
+[[package]]
+name = "wait-timeout"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09ac3b126d3914f9849036f826e054cbabdc8519970b8998ddaf3b5bd3c65f11"
+dependencies = [
+ "libc",
+]
+
[[package]]
name = "walkdir"
version = "2.5.0"
diff --git a/Cargo.toml b/Cargo.toml
index 3b7d835..ab0e5cd 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -4,7 +4,7 @@
[package]
name = "masterror"
-version = "0.27.2"
+version = "0.28.0"
rust-version = "1.92"
edition = "2024"
license = "MIT"
@@ -42,6 +42,9 @@ include = [
members = [
"masterror-derive",
"masterror-template",
+ "masterror-knowledge",
+ "masterror-cli",
+ "masterror-rustc",
"examples/axum-rest-api",
"examples/custom-domain-errors",
"examples/sqlx-database",
@@ -60,8 +63,9 @@ readme = "README.md"
[features]
-default = ["std"]
+default = ["std", "derive"]
std = ["uuid/std", "serde/std"]
+derive = ["dep:masterror-derive", "dep:masterror-template"]
tracing = ["dep:tracing", "dep:log", "dep:log-mdc", "std"]
metrics = ["dep:metrics", "std"]
backtrace = ["std"]
@@ -82,19 +86,22 @@ tokio = ["dep:tokio", "std"]
reqwest = ["dep:reqwest", "std"]
teloxide = ["dep:teloxide-core", "std"]
init-data = ["dep:init-data-rs", "std"]
+phf = ["dep:phf"]
frontend = ["dep:wasm-bindgen", "dep:js-sys", "dep:serde-wasm-bindgen", "std"]
turnkey = ["std"]
tonic = ["dep:tonic", "std"]
openapi = ["dep:utoipa", "std"]
benchmarks = ["std"]
+knowledge = ["dep:masterror-knowledge"]
[workspace.dependencies]
masterror-derive = { version = "0.11" }
masterror-template = { version = "0.4" }
+masterror-knowledge = { version = "0.1" }
[dependencies]
-masterror-derive = { version = "0.11" }
-masterror-template = { workspace = true }
+masterror-derive = { version = "0.11", optional = true }
+masterror-template = { workspace = true, optional = true }
tracing = { version = "0.1", optional = true, default-features = false, features = [
"attributes",
"std",
@@ -147,6 +154,8 @@ tonic = { version = "0.14", optional = true }
owo-colors = { version = "4", optional = true, default-features = false, features = [
"supports-colors",
] }
+masterror-knowledge = { path = "masterror-knowledge", optional = true }
+phf = { version = "0.11", optional = true, features = ["macros"] }
[dev-dependencies]
anyhow = { version = "1", default-features = false, features = ["std"] }
@@ -158,6 +167,7 @@ tokio = { version = "1", features = [
"rt-multi-thread",
"net",
"time",
+ "io-util",
], default-features = false }
trybuild = "1"
toml = "0.9"
@@ -179,6 +189,7 @@ toml = "0.9"
[package.metadata.masterror.readme]
feature_order = [
"std",
+ "derive",
"axum",
"actix",
"openapi",
@@ -189,6 +200,7 @@ feature_order = [
"colored",
"sqlx",
"sqlx-migrate",
+ "phf",
"reqwest",
"redis",
"validator",
@@ -200,6 +212,7 @@ feature_order = [
"tonic",
"frontend",
"turnkey",
+ "knowledge",
"benchmarks",
]
feature_snippet_group = 4
@@ -226,6 +239,9 @@ description = "Actix Web ResponseError and Responder implementations"
[package.metadata.masterror.readme.features.std]
description = "Enable std support (default); required for runtime integrations"
+[package.metadata.masterror.readme.features.derive]
+description = "Enable #[derive(Error, Masterror)] proc-macros (default)"
+
[package.metadata.masterror.readme.features.openapi]
description = "Generate utoipa OpenAPI schema for ErrorResponse"
@@ -283,6 +299,12 @@ description = "Log to the browser console and convert to JsValue on WASM"
[package.metadata.masterror.readme.features.turnkey]
description = "Ship Turnkey-specific error taxonomy and conversions"
+[package.metadata.masterror.readme.features.knowledge]
+description = "Rust compiler error explanations and best practices (en/ru/ko)"
+
+[package.metadata.masterror.readme.features.phf]
+description = "Use compile-time perfect hash maps for O(1) SQLSTATE lookups"
+
[package.metadata.masterror.readme.features.benchmarks]
description = "Enable Criterion benchmarks and CI baseline tooling"
extra = ["Primarily used for local profiling and continuous benchmarking runs"]
diff --git a/README.ko.md b/README.ko.md
index 0fe7d7d..72f2008 100644
--- a/README.ko.md
+++ b/README.ko.md
@@ -25,6 +25,8 @@ SPDX-License-Identifier: MIT
> 🇬🇧 [Read README in English](README.md)
> 🇷🇺 [Читайте README на русском языке](README.ru.md)
+ **참고:** [masterror-cli](https://github.com/RAprogramm/masterror-cli) — Rust 컴파일러 오류를 상세한 해결책, 모범 사례 및 다국어 지원과 함께 설명하는 CLI 도구입니다. `cargo install masterror-cli` 또는 [AUR](https://aur.archlinux.org/packages/masterror-cli)에서 설치하세요.
+
> [!IMPORTANT]
@@ -584,25 +586,60 @@ let error = AppError::not_found("사용자를 찾을 수 없음")
println!("{}", error);
~~~
-**프로덕션 vs 개발 출력:**
+**오류 출력:**
-`colored` 기능 없이 오류는 `AppErrorKind` 레이블을 표시합니다:
-~~~
-NotFound
~~~
-
-`colored` 기능 사용 시 컨텍스트가 포함된 전체 여러 줄 형식:
-~~~
-Error: NotFound
+Not found
Code: NOT_FOUND
Message: 사용자를 찾을 수 없음
Context:
user_id: 12345
request_id: abc-def
+
+Backtrace:
+ → divide at src/main.rs:16
+ → main at src/main.rs:4
~~~
-이러한 구분은 프로덕션 로그를 깔끔하게 유지하면서 로컬 디버깅 세션 중에 개발자에게 풍부한 컨텍스트를 제공합니다.
+- `colored` — 터미널에서 구문 강조
+- `backtrace` — 자동 스택 추적 (사용자 코드만 필터링, 지원되는 터미널에서 클릭 가능한 링크)
+
+
+WezTerm: 클릭 가능한 backtrace 링크
+
+`$EDITOR`에서 파일을 열려면 `~/.wezterm.lua`에 추가하세요:
+
+~~~lua
+wezterm.on('open-uri', function(window, pane, uri)
+ if uri:find('^editor://') then
+ local path = uri:match('path=([^&]+)')
+ local line = uri:match('line=(%d+)')
+ local editor = os.getenv('EDITOR') or 'hx'
+ local args = { editor }
+
+ if path then
+ if line and (editor:find('hx') or editor:find('helix')) then
+ table.insert(args, path .. ':' .. line)
+ elseif line and (editor:find('vim') or editor:find('nvim')) then
+ table.insert(args, '+' .. line)
+ table.insert(args, path)
+ else
+ table.insert(args, path)
+ end
+
+ window:perform_action(
+ wezterm.action.SpawnCommandInNewTab { args = args },
+ pane
+ )
+ end
+ return false
+ end
+ return true
+end)
+~~~
+
+
diff --git a/README.md b/README.md
index bcafb01..fdb1193 100644
--- a/README.md
+++ b/README.md
@@ -26,6 +26,8 @@ SPDX-License-Identifier: MIT
> 🇷🇺 [Читайте README на русском языке](README.ru.md)
> 🇰🇷 [한국어 README](README.ko.md)
+ **See also:** [masterror-cli](https://github.com/RAprogramm/masterror-cli) — CLI tool that explains Rust compiler errors with detailed solutions, best practices, and multi-language support. Install via `cargo install masterror-cli` or from [AUR](https://aur.archlinux.org/packages/masterror-cli).
+
---
@@ -113,6 +115,7 @@ of redaction and metadata.
| [`masterror`](https://crates.io/crates/masterror) | Core error types, metadata builders, transports, integrations and the prelude. | Application crates, services and libraries that want a stable error surface. |
| [`masterror-derive`](masterror-derive/README.md) | Proc-macros backing `#[derive(Error)]`, `#[derive(Masterror)]`, `#[app_error]` and `#[provide]`. | Brought in automatically via `masterror`; depend directly only for macro hacking. |
| [`masterror-template`](masterror-template/README.md) | Shared template parser used by the derive macros for formatter analysis. | Internal dependency; reuse when you need the template parser elsewhere. |
+| [`masterror-knowledge`](masterror-knowledge/README.md) | Knowledge base with 31+ error explanations and 15 best practices in 3 languages. | Used by [masterror-cli](https://github.com/RAprogramm/masterror-cli); depend directly for custom tooling. |
@@ -135,6 +138,7 @@ Pick only what you need; everything is off by default.
colored terminal output.
- **Async & IO integrations:** `tokio`, `reqwest`, `sqlx`, `sqlx-migrate`,
`redis`, `validator`, `config`.
+- **Performance:** `phf` for O(1) compile-time perfect hash SQLSTATE lookups.
- **Messaging & bots:** `teloxide`, `telegram-webapp-sdk`.
- **Front-end tooling:** `frontend` for WASM/browser console logging.
- **gRPC:** `tonic` to emit `tonic::Status` responses.
@@ -159,15 +163,16 @@ The build script keeps the full feature snippet below in sync with
~~~toml
[dependencies]
-masterror = { version = "0.27.2", default-features = false }
+masterror = { version = "0.28.0", default-features = false }
# or with features:
-# masterror = { version = "0.27.2", features = [
-# "std", "axum", "actix", "openapi",
-# "serde_json", "tracing", "metrics", "backtrace",
-# "colored", "sqlx", "sqlx-migrate", "reqwest",
-# "redis", "validator", "config", "tokio",
-# "multipart", "teloxide", "init-data", "tonic",
-# "frontend", "turnkey", "benchmarks"
+# masterror = { version = "0.28.0", features = [
+# "std", "derive", "axum", "actix",
+# "openapi", "serde_json", "tracing", "metrics",
+# "backtrace", "colored", "sqlx", "sqlx-migrate",
+# "phf", "reqwest", "redis", "validator",
+# "config", "tokio", "multipart", "teloxide",
+# "init-data", "tonic", "frontend", "turnkey",
+# "knowledge", "benchmarks"
# ] }
~~~
@@ -640,7 +645,7 @@ Enable the `colored` feature for enhanced terminal output in local mode:
~~~toml
[dependencies]
-masterror = { version = "0.27.2", features = ["colored"] }
+masterror = { version = "0.28.0", features = ["colored"] }
~~~
With `colored` enabled, errors display with syntax highlighting:
@@ -656,31 +661,63 @@ let error = AppError::not_found("User not found")
.with_field(field::str("user_id", "12345"))
.with_field(field::str("request_id", "abc-def"));
-// Without 'colored': plain text
-// With 'colored': color-coded output in terminals
println!("{}", error);
~~~
-**Production vs Development Output:**
+**Error Output:**
-Without `colored` feature, errors display their `AppErrorKind` label:
-~~~
-NotFound
~~~
-
-With `colored` feature, full multi-line format with context:
-~~~
-Error: NotFound
+Not found
Code: NOT_FOUND
Message: User not found
Context:
user_id: 12345
request_id: abc-def
+
+Backtrace:
+ → divide at src/main.rs:16
+ → main at src/main.rs:4
~~~
-This separation keeps production logs clean while giving developers rich context
-during local debugging sessions.
+- `colored` — syntax highlighting in terminal
+- `backtrace` — automatic stack trace (filtered to your code only, clickable links in supported terminals)
+
+
+WezTerm: clickable backtrace links
+
+Add to `~/.wezterm.lua` to open files in your `$EDITOR`:
+
+~~~lua
+wezterm.on('open-uri', function(window, pane, uri)
+ if uri:find('^editor://') then
+ local path = uri:match('path=([^&]+)')
+ local line = uri:match('line=(%d+)')
+ local editor = os.getenv('EDITOR') or 'hx'
+ local args = { editor }
+
+ if path then
+ if line and (editor:find('hx') or editor:find('helix')) then
+ table.insert(args, path .. ':' .. line)
+ elseif line and (editor:find('vim') or editor:find('nvim')) then
+ table.insert(args, '+' .. line)
+ table.insert(args, path)
+ else
+ table.insert(args, path)
+ end
+
+ window:perform_action(
+ wezterm.action.SpawnCommandInNewTab { args = args },
+ pane
+ )
+ end
+ return false
+ end
+ return true
+end)
+~~~
+
+
diff --git a/README.ru.md b/README.ru.md
index a1c46b9..be448d7 100644
--- a/README.ru.md
+++ b/README.ru.md
@@ -25,6 +25,8 @@ SPDX-License-Identifier: MIT
> 🇬🇧 [Read README in English](README.md)
> 🇰🇷 [한국어 README](README.ko.md)
+ **См. также:** [masterror-cli](https://github.com/RAprogramm/masterror-cli) — CLI-инструмент для объяснения ошибок компилятора Rust с подробными решениями, лучшими практиками и поддержкой нескольких языков. Установка: `cargo install masterror-cli` или из [AUR](https://aur.archlinux.org/packages/masterror-cli).
+
> [!IMPORTANT]
@@ -585,25 +587,60 @@ let error = AppError::not_found("Пользователь не найден")
println!("{}", error);
~~~
-**Вывод в Production vs Development:**
+**Вывод ошибок:**
-Без функции `colored` ошибки отображают метку `AppErrorKind`:
-~~~
-NotFound
~~~
-
-С функцией `colored` полный многострочный формат с контекстом:
-~~~
-Error: NotFound
+Not found
Code: NOT_FOUND
Message: Пользователь не найден
Context:
user_id: 12345
request_id: abc-def
+
+Backtrace:
+ → divide at src/main.rs:16
+ → main at src/main.rs:4
~~~
-Такое разделение сохраняет production логи чистыми, предоставляя разработчикам богатый контекст во время локальных сессий отладки.
+- `colored` — подсветка синтаксиса в терминале
+- `backtrace` — автоматический стек вызовов (фильтруется до вашего кода, кликабельные ссылки в поддерживаемых терминалах)
+
+
+WezTerm: кликабельные ссылки в backtrace
+
+Добавьте в `~/.wezterm.lua` для открытия файлов в `$EDITOR`:
+
+~~~lua
+wezterm.on('open-uri', function(window, pane, uri)
+ if uri:find('^editor://') then
+ local path = uri:match('path=([^&]+)')
+ local line = uri:match('line=(%d+)')
+ local editor = os.getenv('EDITOR') or 'hx'
+ local args = { editor }
+
+ if path then
+ if line and (editor:find('hx') or editor:find('helix')) then
+ table.insert(args, path .. ':' .. line)
+ elseif line and (editor:find('vim') or editor:find('nvim')) then
+ table.insert(args, '+' .. line)
+ table.insert(args, path)
+ else
+ table.insert(args, path)
+ end
+
+ window:perform_action(
+ wezterm.action.SpawnCommandInNewTab { args = args },
+ pane
+ )
+ end
+ return false
+ end
+ return true
+end)
+~~~
+
+
diff --git a/README.template.md b/README.template.md
index 381a842..e3ab140 100644
--- a/README.template.md
+++ b/README.template.md
@@ -26,6 +26,8 @@ SPDX-License-Identifier: MIT
> 🇷🇺 [Читайте README на русском языке](README.ru.md)
> 🇰🇷 [한국어 README](README.ko.md)
+ **See also:** [masterror-cli](https://github.com/RAprogramm/masterror-cli) — CLI tool that explains Rust compiler errors with detailed solutions, best practices, and multi-language support. Install via `cargo install masterror-cli` or from [AUR](https://aur.archlinux.org/packages/masterror-cli).
+
---
@@ -113,6 +115,7 @@ of redaction and metadata.
| [`masterror`](https://crates.io/crates/masterror) | Core error types, metadata builders, transports, integrations and the prelude. | Application crates, services and libraries that want a stable error surface. |
| [`masterror-derive`](masterror-derive/README.md) | Proc-macros backing `#[derive(Error)]`, `#[derive(Masterror)]`, `#[app_error]` and `#[provide]`. | Brought in automatically via `masterror`; depend directly only for macro hacking. |
| [`masterror-template`](masterror-template/README.md) | Shared template parser used by the derive macros for formatter analysis. | Internal dependency; reuse when you need the template parser elsewhere. |
+| [`masterror-knowledge`](masterror-knowledge/README.md) | Knowledge base with 31+ error explanations and 15 best practices in 3 languages. | Used by [masterror-cli](https://github.com/RAprogramm/masterror-cli); depend directly for custom tooling. |
@@ -135,6 +138,7 @@ Pick only what you need; everything is off by default.
colored terminal output.
- **Async & IO integrations:** `tokio`, `reqwest`, `sqlx`, `sqlx-migrate`,
`redis`, `validator`, `config`.
+- **Performance:** `phf` for O(1) compile-time perfect hash SQLSTATE lookups.
- **Messaging & bots:** `teloxide`, `telegram-webapp-sdk`.
- **Front-end tooling:** `frontend` for WASM/browser console logging.
- **gRPC:** `tonic` to emit `tonic::Status` responses.
@@ -651,31 +655,63 @@ let error = AppError::not_found("User not found")
.with_field(field::str("user_id", "12345"))
.with_field(field::str("request_id", "abc-def"));
-// Without 'colored': plain text
-// With 'colored': color-coded output in terminals
println!("{}", error);
~~~
-**Production vs Development Output:**
+**Error Output:**
-Without `colored` feature, errors display their `AppErrorKind` label:
-~~~
-NotFound
~~~
-
-With `colored` feature, full multi-line format with context:
-~~~
-Error: NotFound
+Not found
Code: NOT_FOUND
Message: User not found
Context:
user_id: 12345
request_id: abc-def
+
+Backtrace:
+ → divide at src/main.rs:16
+ → main at src/main.rs:4
~~~
-This separation keeps production logs clean while giving developers rich context
-during local debugging sessions.
+- `colored` — syntax highlighting in terminal
+- `backtrace` — automatic stack trace (filtered to your code only, clickable links in supported terminals)
+
+
+WezTerm: clickable backtrace links
+
+Add to `~/.wezterm.lua` to open files in your `$EDITOR`:
+
+~~~lua
+wezterm.on('open-uri', function(window, pane, uri)
+ if uri:find('^editor://') then
+ local path = uri:match('path=([^&]+)')
+ local line = uri:match('line=(%d+)')
+ local editor = os.getenv('EDITOR') or 'hx'
+ local args = { editor }
+
+ if path then
+ if line and (editor:find('hx') or editor:find('helix')) then
+ table.insert(args, path .. ':' .. line)
+ elseif line and (editor:find('vim') or editor:find('nvim')) then
+ table.insert(args, '+' .. line)
+ table.insert(args, path)
+ else
+ table.insert(args, path)
+ end
+
+ window:perform_action(
+ wezterm.action.SpawnCommandInNewTab { args = args },
+ pane
+ )
+ end
+ return false
+ end
+ return true
+end)
+~~~
+
+
diff --git a/REUSE.toml b/REUSE.toml
new file mode 100644
index 0000000..aa45311
--- /dev/null
+++ b/REUSE.toml
@@ -0,0 +1,15 @@
+# SPDX-FileCopyrightText: 2025-2026 RAprogramm
+#
+# SPDX-License-Identifier: MIT
+
+version = 1
+
+[[annotations]]
+path = ["**/Cargo.lock", "pkg/aur/.SRCINFO", "**/.cargo/config.toml"]
+SPDX-FileCopyrightText = "2025-2026 RAprogramm "
+SPDX-License-Identifier = "MIT"
+
+[[annotations]]
+path = ["masterror-knowledge/src/errors/**"]
+SPDX-FileCopyrightText = "2025-2026 RAprogramm "
+SPDX-License-Identifier = "MIT"
diff --git a/images/masterror-knowledge.png b/images/masterror-knowledge.png
new file mode 100644
index 0000000..31baba7
Binary files /dev/null and b/images/masterror-knowledge.png differ
diff --git a/images/masterror-knowledge.png.license b/images/masterror-knowledge.png.license
new file mode 100644
index 0000000..c6d90e7
--- /dev/null
+++ b/images/masterror-knowledge.png.license
@@ -0,0 +1,3 @@
+SPDX-FileCopyrightText: 2025-2026 RAprogramm
+
+SPDX-License-Identifier: MIT
diff --git a/masterror-cli/Cargo.toml b/masterror-cli/Cargo.toml
new file mode 100644
index 0000000..9b0b998
--- /dev/null
+++ b/masterror-cli/Cargo.toml
@@ -0,0 +1,55 @@
+# SPDX-FileCopyrightText: 2025-2026 RAprogramm
+#
+# SPDX-License-Identifier: MIT
+
+[package]
+name = "masterror-cli"
+version = "0.1.0"
+edition.workspace = true
+rust-version.workspace = true
+license.workspace = true
+repository.workspace = true
+description = "CLI tool for explaining Rust compiler errors in human-friendly language"
+keywords = ["rust", "compiler", "errors", "explain", "cli"]
+categories = ["command-line-utilities", "development-tools"]
+
+[[bin]]
+name = "masterror"
+path = "src/main.rs"
+
+[[bin]]
+name = "cargo-masterror"
+path = "src/main.rs"
+
+[features]
+default = ["show-why", "show-fix", "show-link", "show-translation"]
+
+# Display sections
+show-why = []
+show-fix = []
+show-link = []
+show-translation = []
+
+# Show original compiler output before masterror block
+show-original = []
+
+[dependencies]
+masterror-knowledge = { version = "0.1", path = "../masterror-knowledge" }
+
+# CLI framework
+clap = { version = "4", features = ["derive", "env", "wrap_help"] }
+
+# Colored output
+owo-colors = { version = "4", features = ["supports-colors"] }
+
+# Serialization
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+toml = "0.9"
+
+# Config paths
+dirs = "6"
+
+[dev-dependencies]
+assert_cmd = "2"
+predicates = "3"
diff --git a/masterror-cli/src/commands.rs b/masterror-cli/src/commands.rs
new file mode 100644
index 0000000..7f2c260
--- /dev/null
+++ b/masterror-cli/src/commands.rs
@@ -0,0 +1,16 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! CLI commands.
+
+mod check;
+mod explain;
+pub mod init;
+mod list;
+pub mod practice;
+
+pub use check::run as check;
+pub use explain::run as explain;
+pub use init::run as init;
+pub use list::run as list;
diff --git a/masterror-cli/src/commands/check.rs b/masterror-cli/src/commands/check.rs
new file mode 100644
index 0000000..d84bbb3
--- /dev/null
+++ b/masterror-cli/src/commands/check.rs
@@ -0,0 +1,126 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! Check command - run cargo check and explain errors.
+
+use std::{
+ io::{BufRead, BufReader},
+ process::{Command, Stdio}
+};
+
+use masterror_knowledge::Lang;
+
+use crate::{
+ error::{AppError, Result},
+ options::DisplayOptions,
+ output,
+ parser::CargoMessage
+};
+
+/// Allowed cargo arguments whitelist.
+const ALLOWED_ARGS: &[&str] = &[
+ "--release",
+ "--all-targets",
+ "--all-features",
+ "--no-default-features",
+ "-p",
+ "--package",
+ "--workspace",
+ "--lib",
+ "--bins",
+ "--bin",
+ "--examples",
+ "--example",
+ "--tests",
+ "--test",
+ "--benches",
+ "--bench",
+ "--features",
+ "-F",
+ "--target",
+ "--profile",
+ "-j",
+ "--jobs",
+ "-v",
+ "--verbose",
+ "-q",
+ "--quiet",
+ "--locked",
+ "--frozen",
+ "--offline"
+];
+
+/// Validate cargo arguments against whitelist.
+fn validate_args(args: &[String]) -> Result<()> {
+ for arg in args {
+ if arg.starts_with('-') {
+ let is_allowed = ALLOWED_ARGS
+ .iter()
+ .any(|allowed| arg == *allowed || arg.starts_with(&format!("{allowed}=")));
+ if !is_allowed {
+ return Err(AppError::InvalidArgument {
+ arg: arg.clone()
+ });
+ }
+ }
+ }
+ Ok(())
+}
+
+/// Run cargo check and explain errors.
+pub fn run(lang: Lang, args: &[String], opts: &DisplayOptions) -> Result<()> {
+ validate_args(args)?;
+
+ let msg_format = if opts.colored {
+ "--message-format=json-diagnostic-rendered-ansi"
+ } else {
+ "--message-format=json"
+ };
+
+ let mut cmd = Command::new("cargo")
+ .arg("check")
+ .arg(msg_format)
+ .args(args)
+ .stdout(Stdio::piped())
+ .stderr(Stdio::inherit())
+ .spawn()?;
+
+ let stdout = cmd
+ .stdout
+ .take()
+ .ok_or_else(|| AppError::Io(std::io::Error::other("failed to capture stdout")))?;
+ let reader = BufReader::new(stdout);
+
+ let mut error_count = 0;
+
+ for line in reader.lines() {
+ let line = line?;
+ if let Ok(msg) = serde_json::from_str::(&line)
+ && msg.is_error()
+ {
+ error_count += 1;
+ output::print_error(lang, &msg, opts);
+ println!();
+ }
+ }
+
+ let status = cmd.wait()?;
+
+ if error_count > 0 {
+ println!("Found {error_count} error(s). Run `masterror explain ` for details.");
+ }
+
+ if !status.success() {
+ match status.code() {
+ Some(code) => {
+ return Err(AppError::CargoFailed {
+ code
+ });
+ }
+ None => return Err(AppError::CargoSignaled)
+ }
+ }
+
+ Ok(())
+}
diff --git a/masterror-cli/src/commands/explain.rs b/masterror-cli/src/commands/explain.rs
new file mode 100644
index 0000000..0a6dcf7
--- /dev/null
+++ b/masterror-cli/src/commands/explain.rs
@@ -0,0 +1,174 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! Explain command - explain a specific error code or best practice.
+
+use masterror_knowledge::{
+ BestPractice, ErrorEntry, ErrorRegistry, Lang, PracticeRegistry, UiMsg
+};
+use owo_colors::OwoColorize;
+
+use crate::{
+ error::{AppError, Result},
+ options::DisplayOptions
+};
+
+/// Explain a specific error code (E0382) or best practice (RA001).
+pub fn run(lang: Lang, code: &str, opts: &DisplayOptions) -> Result<()> {
+ let upper = code.to_uppercase();
+
+ if upper.starts_with("RA") {
+ let registry = PracticeRegistry::new();
+ if let Some(practice) = registry.find(&upper) {
+ print_practice(lang, practice, opts);
+ return Ok(());
+ }
+ }
+
+ let registry = ErrorRegistry::new();
+ if let Some(entry) = registry.find(code) {
+ print_error(lang, entry, opts);
+ return Ok(());
+ }
+
+ Err(AppError::UnknownErrorCode {
+ code: code.to_string()
+ })
+}
+
+fn print_error(lang: Lang, entry: &ErrorEntry, opts: &DisplayOptions) {
+ println!();
+
+ let title = entry.title.get(lang.code());
+ if opts.colored {
+ println!("{} - {}", entry.code.yellow().bold(), title.bold());
+ } else {
+ println!("{} - {title}", entry.code);
+ }
+
+ let category = entry.category.name(lang.code());
+ if opts.colored {
+ println!("{}: {}", UiMsg::Category.get(lang), category.dimmed());
+ } else {
+ println!("{}: {category}", UiMsg::Category.get(lang));
+ }
+
+ println!();
+ let why_label = UiMsg::LabelWhy.get(lang);
+ if opts.colored {
+ println!("{}", why_label.green().bold());
+ } else {
+ println!("{why_label}");
+ }
+ println!("{}", entry.explanation.get(lang.code()));
+
+ if !entry.fixes.is_empty() {
+ println!();
+ let fix_label = UiMsg::LabelFix.get(lang);
+ if opts.colored {
+ println!("{}", fix_label.green().bold());
+ } else {
+ println!("{fix_label}");
+ }
+ for (i, fix) in entry.fixes.iter().enumerate() {
+ println!();
+ println!("{}. {}", i + 1, fix.description.get(lang.code()));
+ println!("```rust");
+ println!("{}", fix.code);
+ println!("```");
+ }
+ }
+
+ if !entry.links.is_empty() {
+ println!();
+ let link_label = UiMsg::LabelLink.get(lang);
+ if opts.colored {
+ println!("{}", link_label.cyan().bold());
+ } else {
+ println!("{link_label}");
+ }
+ for link in entry.links {
+ if opts.colored {
+ println!(" - {} {}", link.title, link.url.dimmed());
+ } else {
+ println!(" - {} {}", link.title, link.url);
+ }
+ }
+ }
+
+ println!();
+}
+
+/// Print best practice details.
+pub fn print_practice(lang: Lang, practice: &BestPractice, opts: &DisplayOptions) {
+ println!();
+
+ let title = practice.title.get(lang.code());
+ if opts.colored {
+ println!("{} - {}", practice.code.yellow().bold(), title.bold());
+ } else {
+ println!("{} - {title}", practice.code);
+ }
+
+ let category = practice.category.name(lang.code());
+ if opts.colored {
+ println!("{}: {}", UiMsg::Category.get(lang), category.dimmed());
+ } else {
+ println!("{}: {category}", UiMsg::Category.get(lang));
+ }
+
+ println!();
+ let why_label = UiMsg::LabelWhyMatters.get(lang);
+ if opts.colored {
+ println!("{}", why_label.green().bold());
+ } else {
+ println!("{why_label}");
+ }
+ println!("{}", practice.explanation.get(lang.code()));
+
+ println!();
+ let how_label = UiMsg::LabelHowToApply.get(lang);
+ if opts.colored {
+ println!("{}", how_label.green().bold());
+ } else {
+ println!("{how_label}");
+ }
+
+ println!();
+ let avoid_label = UiMsg::LabelAvoid.get(lang);
+ if opts.colored {
+ println!("{}. {}", "1".cyan(), avoid_label.red());
+ } else {
+ println!("1. {avoid_label}");
+ }
+ println!("```rust");
+ println!("{}", practice.bad_example);
+ println!("```");
+
+ println!();
+ let prefer_label = UiMsg::LabelPrefer.get(lang);
+ if opts.colored {
+ println!("{}. {}", "2".cyan(), prefer_label.green());
+ } else {
+ println!("2. {prefer_label}");
+ }
+ println!("```rust");
+ println!("{}", practice.good_example);
+ println!("```");
+
+ println!();
+ let link_label = UiMsg::LabelLink.get(lang);
+ if opts.colored {
+ println!("{}", link_label.cyan().bold());
+ } else {
+ println!("{link_label}");
+ }
+ if opts.colored {
+ println!(" - RustManifest {}", practice.source.dimmed());
+ } else {
+ println!(" - RustManifest {}", practice.source);
+ }
+
+ println!();
+}
diff --git a/masterror-cli/src/commands/init.rs b/masterror-cli/src/commands/init.rs
new file mode 100644
index 0000000..59d9d0e
--- /dev/null
+++ b/masterror-cli/src/commands/init.rs
@@ -0,0 +1,295 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! Init command - create configuration file interactively.
+
+use std::io::{self, Write};
+
+use masterror_knowledge::{Lang, UiMsg};
+use owo_colors::OwoColorize;
+
+use crate::{
+ config::{Config, DisplayConfig, GeneralConfig},
+ error::Result
+};
+
+/// Run init command - create configuration interactively.
+pub fn run(_lang: Lang, colored: bool) -> Result<()> {
+ println!();
+ print_welcome(colored);
+ println!();
+
+ // First ask language - this affects all subsequent prompts
+ let lang_value = prompt_language(colored)?;
+ let lang = masterror_knowledge::Lang::from_code(&lang_value);
+
+ let color_value = prompt_colors(lang, colored)?;
+ let display = prompt_display(lang, colored)?;
+ let save_location = prompt_save_location(lang, colored)?;
+
+ let config = Config {
+ general: GeneralConfig {
+ lang: lang_value,
+ colored: color_value
+ },
+ display,
+ aliases: default_aliases()
+ };
+
+ let saved_path = match save_location {
+ SaveLocation::Global => {
+ config.save()?;
+ Config::path()
+ .map(|p| p.display().to_string())
+ .unwrap_or_else(|| "~/.config/masterror/config.toml".to_string())
+ }
+ SaveLocation::Local => {
+ let path = config.save_local()?;
+ path.display().to_string()
+ }
+ };
+
+ println!();
+ print_success(lang, colored, &saved_path);
+ print_tips(lang, colored, &save_location);
+
+ Ok(())
+}
+
+/// Check if first run and prompt for setup.
+pub fn check_first_run(colored: bool) -> Result {
+ if !Config::is_first_run() {
+ return Ok(false);
+ }
+
+ println!();
+ if colored {
+ println!(
+ "{}",
+ "Welcome to masterror! Let's set up your preferences.".cyan()
+ );
+ println!(
+ "{}",
+ "(This only happens once. Run `masterror init` to reconfigure later.)".dimmed()
+ );
+ } else {
+ println!("Welcome to masterror! Let's set up your preferences.");
+ println!("(This only happens once. Run `masterror init` to reconfigure later.)");
+ }
+ println!();
+
+ run(Lang::En, colored)?;
+ Ok(true)
+}
+
+#[derive(Clone, Copy)]
+enum SaveLocation {
+ Global,
+ Local
+}
+
+fn print_welcome(colored: bool) {
+ let title = "masterror - Rust compiler error explainer";
+ let subtitle = "Let's configure your preferences";
+
+ if colored {
+ println!("{}", title.bold().cyan());
+ println!("{}", subtitle.dimmed());
+ } else {
+ println!("{title}");
+ println!("{subtitle}");
+ }
+}
+
+fn prompt_language(colored: bool) -> Result {
+ println!();
+ if colored {
+ println!(
+ "{}",
+ "Select your language / Выберите язык / 언어 선택".bold()
+ );
+ println!(" {} - English", "en".cyan());
+ println!(" {} - Русский", "ru".cyan());
+ println!(" {} - 한국어", "ko".cyan());
+ } else {
+ println!("Select your language / Выберите язык / 언어 선택");
+ println!(" en - English");
+ println!(" ru - Русский");
+ println!(" ko - 한국어");
+ }
+
+ if colored {
+ print!("{} [en/ru/ko] ({}): ", "Choice".bold(), "en".dimmed());
+ } else {
+ print!("Choice [en/ru/ko] (en): ");
+ }
+ io::stdout().flush()?;
+
+ let mut input = String::new();
+ io::stdin().read_line(&mut input)?;
+ let choice = input.trim().to_lowercase();
+
+ Ok(
+ if choice.is_empty() || !["en", "ru", "ko"].contains(&choice.as_str()) {
+ "en".to_string()
+ } else {
+ choice
+ }
+ )
+}
+
+fn prompt_colors(lang: Lang, colored: bool) -> Result {
+ let prompt = UiMsg::InitColorPrompt.get(lang);
+
+ if colored {
+ print!("{} [y/n] ({}): ", prompt.bold(), "y".dimmed());
+ } else {
+ print!("{prompt} [y/n] (y): ");
+ }
+ io::stdout().flush()?;
+
+ let mut input = String::new();
+ io::stdin().read_line(&mut input)?;
+ Ok(!matches!(input.trim().to_lowercase().as_str(), "n" | "no"))
+}
+
+fn prompt_display(lang: Lang, colored: bool) -> Result {
+ let prompt = UiMsg::InitDisplayPrompt.get(lang);
+ println!();
+ if colored {
+ println!("{}", prompt.bold());
+ } else {
+ println!("{prompt}");
+ }
+
+ let translation = prompt_bool(lang, colored, UiMsg::InitShowTranslation, true)?;
+ let why = prompt_bool(lang, colored, UiMsg::InitShowWhy, true)?;
+ let fix = prompt_bool(lang, colored, UiMsg::InitShowFix, true)?;
+ let links = prompt_bool(lang, colored, UiMsg::InitShowLinks, true)?;
+ let original = prompt_bool(lang, colored, UiMsg::InitShowOriginal, false)?;
+
+ Ok(DisplayConfig {
+ translation,
+ why,
+ fix,
+ links,
+ original
+ })
+}
+
+fn prompt_save_location(lang: Lang, colored: bool) -> Result {
+ println!();
+ let global_label = UiMsg::InitSaveGlobal.get(lang);
+ let local_label = UiMsg::InitSaveLocal.get(lang);
+
+ if colored {
+ println!("{}", UiMsg::InitSavePrompt.get(lang).bold());
+ println!(" {} - {}", "1".cyan(), global_label);
+ println!(" {} - {}", "2".cyan(), local_label);
+ } else {
+ println!("{}", UiMsg::InitSavePrompt.get(lang));
+ println!(" 1 - {global_label}");
+ println!(" 2 - {local_label}");
+ }
+
+ if colored {
+ print!("{} [1/2] ({}): ", "Choice".bold(), "1".dimmed());
+ } else {
+ print!("Choice [1/2] (1): ");
+ }
+ io::stdout().flush()?;
+
+ let mut input = String::new();
+ io::stdin().read_line(&mut input)?;
+
+ Ok(match input.trim() {
+ "2" => SaveLocation::Local,
+ _ => SaveLocation::Global
+ })
+}
+
+fn prompt_bool(lang: Lang, colored: bool, msg: UiMsg, default: bool) -> Result {
+ let label = msg.get(lang);
+ let default_str = if default { "y" } else { "n" };
+
+ if colored {
+ print!(" {} [y/n] ({}): ", label, default_str.dimmed());
+ } else {
+ print!(" {label} [y/n] ({default_str}): ");
+ }
+ io::stdout().flush()?;
+
+ let mut input = String::new();
+ io::stdin().read_line(&mut input)?;
+ let trimmed = input.trim().to_lowercase();
+
+ Ok(if trimmed.is_empty() {
+ default
+ } else {
+ matches!(trimmed.as_str(), "y" | "yes" | "д" | "да")
+ })
+}
+
+fn print_success(lang: Lang, colored: bool, path: &str) {
+ let msg = UiMsg::InitSuccess.get(lang);
+
+ if colored {
+ println!("{} {}", msg.green(), path.dimmed());
+ } else {
+ println!("{msg} {path}");
+ }
+}
+
+fn print_tips(lang: Lang, colored: bool, location: &SaveLocation) {
+ println!();
+ let tip = UiMsg::InitTip.get(lang);
+
+ if colored {
+ println!("{}", tip.dimmed());
+ } else {
+ println!("{tip}");
+ }
+
+ match location {
+ SaveLocation::Global => {
+ let global_path = Config::path()
+ .map(|p| p.display().to_string())
+ .unwrap_or_else(|| "~/.config/masterror/config.toml".to_string());
+ if colored {
+ println!(" {} {}", "Global:".dimmed(), global_path.dimmed());
+ } else {
+ println!(" Global: {global_path}");
+ }
+ }
+ SaveLocation::Local => {
+ if colored {
+ println!(" {} .masterror.toml", "Local:".dimmed());
+ } else {
+ println!(" Local: .masterror.toml");
+ }
+ }
+ }
+
+ println!();
+ let usage = UiMsg::InitUsage.get(lang);
+ if colored {
+ println!("{}", usage.cyan());
+ println!(" {} cargo masterror check", "$".dimmed());
+ println!(" {} masterror explain E0382", "$".dimmed());
+ } else {
+ println!("{usage}");
+ println!(" $ cargo masterror check");
+ println!(" $ masterror explain E0382");
+ }
+ println!();
+}
+
+fn default_aliases() -> std::collections::HashMap {
+ let mut aliases = std::collections::HashMap::new();
+ aliases.insert("c".to_string(), "check".to_string());
+ aliases.insert("e".to_string(), "explain".to_string());
+ aliases.insert("l".to_string(), "list".to_string());
+ aliases.insert("p".to_string(), "practice".to_string());
+ aliases
+}
diff --git a/masterror-cli/src/commands/list.rs b/masterror-cli/src/commands/list.rs
new file mode 100644
index 0000000..3d67f53
--- /dev/null
+++ b/masterror-cli/src/commands/list.rs
@@ -0,0 +1,74 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! List command - list all known error codes.
+
+use masterror_knowledge::{Category, ErrorRegistry, Lang};
+
+use crate::{
+ error::{AppError, Result},
+ options::DisplayOptions,
+ output::{print_category_header, print_code_title, print_title}
+};
+
+/// List all known error codes.
+pub fn run(lang: Lang, category: Option<&str>, opts: &DisplayOptions) -> Result<()> {
+ let registry = ErrorRegistry::new();
+
+ println!();
+ print_title("Known Rust Compiler Errors", opts.colored);
+ println!();
+
+ let mut entries: Vec<_> = if let Some(cat) = category {
+ let cat = parse_category(cat);
+ if let Some(c) = cat {
+ registry.by_category(c)
+ } else {
+ return Err(AppError::InvalidCategory {
+ name: category.unwrap_or("").to_string()
+ });
+ }
+ } else {
+ registry.all().collect()
+ };
+
+ if entries.is_empty() {
+ println!(" No errors found.");
+ return Ok(());
+ }
+
+ entries.sort_by_key(|e| e.code);
+
+ let mut current_cat: Option = None;
+ for entry in &entries {
+ if current_cat != Some(entry.category) {
+ current_cat = Some(entry.category);
+ println!();
+ print_category_header(entry.category.name(lang.code()), opts.colored);
+ println!();
+ }
+ print_code_title(entry.code, entry.title.get(lang.code()), opts.colored);
+ }
+
+ println!();
+ println!("Total: {} errors", entries.len());
+ println!();
+ println!("Use `masterror explain ` to see details.");
+ println!("Use `masterror practice` to see best practices.");
+ println!();
+
+ Ok(())
+}
+
+fn parse_category(s: &str) -> Option {
+ match s.to_lowercase().as_str() {
+ "ownership" | "own" => Some(Category::Ownership),
+ "borrowing" | "borrow" => Some(Category::Borrowing),
+ "lifetimes" | "lifetime" | "life" => Some(Category::Lifetimes),
+ "types" | "type" => Some(Category::Types),
+ "traits" | "trait" => Some(Category::Traits),
+ "resolution" | "resolve" | "names" => Some(Category::Resolution),
+ _ => None
+ }
+}
diff --git a/masterror-cli/src/commands/practice.rs b/masterror-cli/src/commands/practice.rs
new file mode 100644
index 0000000..b651b04
--- /dev/null
+++ b/masterror-cli/src/commands/practice.rs
@@ -0,0 +1,92 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! Practice command - show best practices from RustManifest.
+
+use masterror_knowledge::{Lang, PracticeCategory, PracticeRegistry};
+
+use super::explain::print_practice;
+use crate::{
+ error::{AppError, Result},
+ options::DisplayOptions,
+ output::{print_category_header, print_code_title, print_title}
+};
+
+/// List all best practices or filter by category.
+pub fn list(lang: Lang, category: Option<&str>, opts: &DisplayOptions) -> Result<()> {
+ let registry = PracticeRegistry::new();
+
+ println!();
+ print_title("RustManifest Best Practices", opts.colored);
+ println!();
+
+ let practices: Vec<_> = if let Some(cat) = category {
+ let cat = parse_category(cat);
+ if let Some(c) = cat {
+ registry.by_category(c)
+ } else {
+ return Err(AppError::InvalidCategory {
+ name: category.unwrap_or("").to_string()
+ });
+ }
+ } else {
+ registry.all().collect()
+ };
+
+ if practices.is_empty() {
+ println!(" No practices found.");
+ return Ok(());
+ }
+
+ let mut sorted = practices;
+ sorted.sort_by_key(|p| p.code);
+
+ let mut current_cat: Option = None;
+ for practice in &sorted {
+ if current_cat != Some(practice.category) {
+ current_cat = Some(practice.category);
+ println!();
+ print_category_header(practice.category.name(lang.code()), opts.colored);
+ println!();
+ }
+ print_code_title(practice.code, practice.title.get(lang.code()), opts.colored);
+ }
+
+ println!();
+ println!("Total: {} practices", sorted.len());
+ println!();
+ println!("Use `masterror practice ` to see details.");
+ println!();
+
+ Ok(())
+}
+
+/// Show a specific best practice.
+pub fn show(lang: Lang, code: &str, opts: &DisplayOptions) -> Result<()> {
+ let registry = PracticeRegistry::new();
+
+ let Some(practice) = registry.find(code) else {
+ return Err(AppError::UnknownPracticeCode {
+ code: code.to_string()
+ });
+ };
+
+ print_practice(lang, practice, opts);
+ Ok(())
+}
+
+fn parse_category(s: &str) -> Option {
+ match s.to_lowercase().as_str() {
+ "error-handling" | "error_handling" | "errorhandling" | "errors" => {
+ Some(PracticeCategory::ErrorHandling)
+ }
+ "performance" | "perf" => Some(PracticeCategory::Performance),
+ "naming" | "names" => Some(PracticeCategory::Naming),
+ "documentation" | "docs" | "doc" => Some(PracticeCategory::Documentation),
+ "design" | "architecture" | "arch" => Some(PracticeCategory::Design),
+ "testing" | "tests" | "test" => Some(PracticeCategory::Testing),
+ "security" | "sec" => Some(PracticeCategory::Security),
+ _ => None
+ }
+}
diff --git a/masterror-cli/src/config.rs b/masterror-cli/src/config.rs
new file mode 100644
index 0000000..b9b0cb0
--- /dev/null
+++ b/masterror-cli/src/config.rs
@@ -0,0 +1,203 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! Configuration management for masterror-cli.
+//!
+//! Supports layered configuration (highest priority first):
+//! 1. CLI arguments
+//! 2. Environment variables
+//! 3. Local project config (.masterror.toml in current directory)
+//! 4. Global config (~/.config/masterror/config.toml)
+//! 5. Default values
+
+use std::{collections::HashMap, env, fs, path::PathBuf};
+
+use serde::{Deserialize, Serialize};
+
+use crate::error::{AppError, Result};
+
+/// Global config file name.
+const CONFIG_FILE: &str = "config.toml";
+
+/// Local project config file name.
+const LOCAL_CONFIG_FILE: &str = ".masterror.toml";
+
+/// Config directory name.
+const CONFIG_DIR: &str = "masterror";
+
+/// Application configuration.
+#[derive(Debug, Clone, Default, Serialize, Deserialize)]
+#[serde(default)]
+pub struct Config {
+ /// General settings.
+ pub general: GeneralConfig,
+ /// Display settings.
+ pub display: DisplayConfig,
+ /// Command aliases.
+ pub aliases: HashMap
+}
+
+/// General configuration options.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(default)]
+pub struct GeneralConfig {
+ /// Language code (en, ru, ko).
+ pub lang: String,
+ /// Enable colored output.
+ pub colored: bool
+}
+
+/// Display section toggles.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(default)]
+pub struct DisplayConfig {
+ /// Show translated error message.
+ pub translation: bool,
+ /// Show "why this happens" explanation.
+ pub why: bool,
+ /// Show fix suggestions.
+ pub fix: bool,
+ /// Show documentation links.
+ pub links: bool,
+ /// Show original compiler output.
+ pub original: bool
+}
+
+impl Default for GeneralConfig {
+ fn default() -> Self {
+ Self {
+ lang: "en".to_string(),
+ colored: true
+ }
+ }
+}
+
+impl Default for DisplayConfig {
+ fn default() -> Self {
+ Self {
+ translation: true,
+ why: true,
+ fix: true,
+ links: true,
+ original: false
+ }
+ }
+}
+
+impl Config {
+ /// Get global config directory path.
+ pub fn dir() -> Option {
+ dirs::config_dir().map(|p| p.join(CONFIG_DIR))
+ }
+
+ /// Get global config file path.
+ pub fn path() -> Option {
+ Self::dir().map(|p| p.join(CONFIG_FILE))
+ }
+
+ /// Get local project config path (.masterror.toml in current directory).
+ pub fn local_path() -> Option {
+ env::current_dir().ok().map(|p| p.join(LOCAL_CONFIG_FILE))
+ }
+
+ /// Check if this is the first run (no global config exists).
+ pub fn is_first_run() -> bool {
+ Self::path().is_none_or(|p| !p.exists())
+ }
+
+ /// Load config with layered priority:
+ /// 1. Local .masterror.toml (if exists)
+ /// 2. Global ~/.config/masterror/config.toml
+ /// 3. Defaults
+ pub fn load() -> Result {
+ // Try local config first
+ if let Some(local_path) = Self::local_path()
+ && local_path.exists()
+ {
+ let content = fs::read_to_string(&local_path)?;
+ let config: Config = toml::from_str(&content).map_err(|e| AppError::ConfigParse {
+ path: local_path.clone(),
+ message: e.message().to_string()
+ })?;
+ return Ok(config);
+ }
+
+ // Try global config
+ let Some(path) = Self::path() else {
+ return Ok(Self::default());
+ };
+
+ if !path.exists() {
+ return Ok(Self::default());
+ }
+
+ let content = fs::read_to_string(&path)?;
+ let config: Config = toml::from_str(&content).map_err(|e| AppError::ConfigParse {
+ path: path.clone(),
+ message: e.message().to_string()
+ })?;
+
+ Ok(config)
+ }
+
+ /// Save config to global file.
+ pub fn save(&self) -> Result<()> {
+ let Some(dir) = Self::dir() else {
+ return Err(AppError::Io(std::io::Error::other(
+ "could not determine config directory"
+ )));
+ };
+
+ fs::create_dir_all(&dir)?;
+
+ let path = dir.join(CONFIG_FILE);
+ let content = toml::to_string_pretty(self).map_err(|e| AppError::ConfigParse {
+ path: path.clone(),
+ message: e.to_string()
+ })?;
+
+ fs::write(&path, content)?;
+ Ok(())
+ }
+
+ /// Save config to local project file (.masterror.toml).
+ pub fn save_local(&self) -> Result {
+ let path = env::current_dir()?.join(LOCAL_CONFIG_FILE);
+ let content = toml::to_string_pretty(self).map_err(|e| AppError::ConfigParse {
+ path: path.clone(),
+ message: e.to_string()
+ })?;
+
+ fs::write(&path, &content)?;
+ Ok(path)
+ }
+
+ /// Resolve command alias.
+ #[allow(dead_code)]
+ pub fn resolve_alias<'a>(&'a self, cmd: &'a str) -> &'a str {
+ self.aliases.get(cmd).map(String::as_str).unwrap_or(cmd)
+ }
+}
+
+#[cfg(test)]
+mod tests {
+ use super::*;
+
+ #[test]
+ fn test_default_config() {
+ let config = Config::default();
+ assert_eq!(config.general.lang, "en");
+ assert!(config.general.colored);
+ assert!(config.display.why);
+ assert!(config.display.fix);
+ }
+
+ #[test]
+ fn test_toml_roundtrip() {
+ let config = Config::default();
+ let toml = toml::to_string_pretty(&config).unwrap();
+ let parsed: Config = toml::from_str(&toml).unwrap();
+ assert_eq!(parsed.general.lang, config.general.lang);
+ }
+}
diff --git a/masterror-cli/src/error.rs b/masterror-cli/src/error.rs
new file mode 100644
index 0000000..bfeb345
--- /dev/null
+++ b/masterror-cli/src/error.rs
@@ -0,0 +1,169 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! Application error types for masterror-cli.
+
+use std::{fmt, io, path::PathBuf};
+
+/// Application-wide error type.
+#[derive(Debug)]
+pub enum AppError {
+ /// I/O error (file operations, process spawning).
+ Io(io::Error),
+ /// JSON parsing error from cargo output.
+ Json(serde_json::Error),
+ /// Cargo check process failed with exit code.
+ CargoFailed {
+ /// Exit code from cargo process.
+ code: i32
+ },
+ /// Cargo check process was terminated by signal.
+ CargoSignaled,
+ /// Unknown error code requested.
+ UnknownErrorCode {
+ /// The requested error code.
+ code: String
+ },
+ /// Unknown practice code requested.
+ UnknownPracticeCode {
+ /// The requested practice code.
+ code: String
+ },
+ /// Invalid category name.
+ InvalidCategory {
+ /// The invalid category name.
+ name: String
+ },
+ /// Invalid command-line argument.
+ InvalidArgument {
+ /// The invalid argument.
+ arg: String
+ },
+ /// Config file parse error.
+ ConfigParse {
+ /// Path to config file.
+ path: PathBuf,
+ /// Error message.
+ message: String
+ },
+ /// Error with additional context.
+ #[allow(dead_code)]
+ WithContext {
+ /// Context message.
+ context: String,
+ /// Original error.
+ source: Box
+ }
+}
+
+impl fmt::Display for AppError {
+ fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+ match self {
+ Self::Io(e) => write!(f, "I/O error: {e}"),
+ Self::Json(e) => write!(f, "JSON parse error: {e}"),
+ Self::CargoFailed {
+ code
+ } => write!(f, "cargo check failed with exit code {code}"),
+ Self::CargoSignaled => write!(f, "cargo check was terminated by signal"),
+ Self::UnknownErrorCode {
+ code
+ } => write!(f, "unknown error code: {code}"),
+ Self::UnknownPracticeCode {
+ code
+ } => write!(f, "unknown practice code: {code}"),
+ Self::InvalidCategory {
+ name
+ } => write!(f, "invalid category: {name}"),
+ Self::InvalidArgument {
+ arg
+ } => write!(f, "invalid argument: {arg}"),
+ Self::ConfigParse {
+ path,
+ message
+ } => write!(f, "config error in {}: {message}", path.display()),
+ Self::WithContext {
+ context,
+ source
+ } => write!(f, "{context}: {source}")
+ }
+ }
+}
+
+impl std::error::Error for AppError {
+ fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
+ match self {
+ Self::Io(e) => Some(e),
+ Self::Json(e) => Some(e),
+ Self::WithContext {
+ source, ..
+ } => Some(source.as_ref()),
+ _ => None
+ }
+ }
+}
+
+impl From for AppError {
+ fn from(err: io::Error) -> Self {
+ Self::Io(err)
+ }
+}
+
+impl From for AppError {
+ fn from(err: serde_json::Error) -> Self {
+ Self::Json(err)
+ }
+}
+
+/// Result type alias for AppError.
+pub type Result = std::result::Result;
+
+/// Extension trait for adding context to Results.
+///
+/// # Example
+///
+/// ```ignore
+/// use masterror::error::ResultExt;
+///
+/// fs::read_to_string(path).context("reading config")?;
+/// ```
+#[allow(dead_code)]
+pub trait ResultExt {
+ /// Add static context to an error.
+ fn context(self, ctx: &'static str) -> Result;
+
+ /// Add dynamic context to an error.
+ fn with_context(self, f: F) -> Result
+ where
+ F: FnOnce() -> S,
+ S: Into;
+}
+
+impl ResultExt for std::result::Result
+where
+ E: Into
+{
+ fn context(self, ctx: &'static str) -> Result {
+ self.map_err(|e| {
+ let inner = e.into();
+ AppError::WithContext {
+ context: ctx.to_string(),
+ source: Box::new(inner)
+ }
+ })
+ }
+
+ fn with_context(self, f: F) -> Result
+ where
+ F: FnOnce() -> S,
+ S: Into
+ {
+ self.map_err(|e| {
+ let inner = e.into();
+ AppError::WithContext {
+ context: f().into(),
+ source: Box::new(inner)
+ }
+ })
+ }
+}
diff --git a/masterror-cli/src/main.rs b/masterror-cli/src/main.rs
new file mode 100644
index 0000000..47b006a
--- /dev/null
+++ b/masterror-cli/src/main.rs
@@ -0,0 +1,131 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! masterror CLI - Rust compiler error explainer.
+
+mod commands;
+mod config;
+mod error;
+mod options;
+mod output;
+mod parser;
+mod sections;
+
+use clap::{Parser, Subcommand};
+use masterror_knowledge::Lang;
+
+use crate::{config::Config, options::DisplayOptions};
+
+#[derive(Parser)]
+#[command(name = "masterror")]
+#[command(author, version, about = "Rust compiler error explainer")]
+struct Cli {
+ /// Language for explanations (en, ru, ko)
+ #[arg(short, long, env = "MASTERROR_LANG")]
+ lang: Option,
+
+ /// Disable colored output
+ #[arg(long, env = "NO_COLOR")]
+ no_color: bool,
+
+ #[command(subcommand)]
+ command: Commands
+}
+
+#[derive(Subcommand)]
+enum Commands {
+ /// Initialize configuration file
+ Init,
+ /// Run cargo check and explain errors
+ #[command(visible_alias = "c")]
+ Check {
+ #[arg(trailing_var_arg = true)]
+ args: Vec
+ },
+ /// Explain a specific error code (E0382) or best practice (RA001)
+ #[command(visible_alias = "e")]
+ Explain { code: String },
+ /// List all known error codes
+ #[command(visible_alias = "l")]
+ List {
+ #[arg(short, long)]
+ category: Option
+ },
+ /// Show RustManifest best practices
+ #[command(visible_alias = "p")]
+ Practice {
+ /// Practice code (RA001-RA015) or empty for list
+ code: Option,
+ /// Filter by category
+ #[arg(short, long)]
+ category: Option
+ }
+}
+
+fn main() {
+ let args: Vec = std::env::args().collect();
+ let cli = if args.get(1).is_some_and(|a| a == "masterror") {
+ Cli::parse_from(
+ args.into_iter()
+ .enumerate()
+ .filter_map(|(i, a)| if i == 1 { None } else { Some(a) })
+ )
+ } else {
+ Cli::parse()
+ };
+
+ // Check for first run and run setup if needed (except for init command)
+ if !matches!(cli.command, Commands::Init)
+ && let Err(e) = commands::init::check_first_run(true)
+ {
+ eprintln!("Setup failed: {e}");
+ std::process::exit(1);
+ }
+
+ let config = Config::load().unwrap_or_default();
+ let lang_str = cli.lang.as_deref().unwrap_or(&config.general.lang);
+ let lang = Lang::from_code(lang_str);
+ let colored = if cli.no_color {
+ false
+ } else {
+ config.general.colored
+ };
+
+ let opts = DisplayOptions {
+ colored,
+ show_translation: config.display.translation,
+ show_why: config.display.why,
+ show_fix: config.display.fix,
+ show_links: config.display.links,
+ show_original: config.display.original
+ };
+
+ let result = match &cli.command {
+ Commands::Init => commands::init(lang, opts.colored),
+ Commands::Check {
+ args
+ } => commands::check(lang, args, &opts),
+ Commands::Explain {
+ code
+ } => commands::explain(lang, code, &opts),
+ Commands::List {
+ category
+ } => commands::list(lang, category.as_deref(), &opts),
+ Commands::Practice {
+ code,
+ category
+ } => {
+ if let Some(c) = code {
+ commands::practice::show(lang, c, &opts)
+ } else {
+ commands::practice::list(lang, category.as_deref(), &opts)
+ }
+ }
+ };
+
+ if let Err(e) = result {
+ eprintln!("Error: {e}");
+ std::process::exit(1);
+ }
+}
diff --git a/masterror-cli/src/options.rs b/masterror-cli/src/options.rs
new file mode 100644
index 0000000..8256a87
--- /dev/null
+++ b/masterror-cli/src/options.rs
@@ -0,0 +1,138 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! Display options for masterror output.
+
+/// What sections to show in masterror block.
+#[derive(Clone, Copy, Debug, PartialEq, Eq)]
+pub struct DisplayOptions {
+ /// Enable colored output.
+ pub colored: bool,
+ /// Show translated error message.
+ pub show_translation: bool,
+ /// Show "why this happens" explanation.
+ pub show_why: bool,
+ /// Show fix suggestions.
+ pub show_fix: bool,
+ /// Show documentation links.
+ pub show_links: bool,
+ /// Show original compiler output.
+ pub show_original: bool
+}
+
+impl DisplayOptions {
+ /// Default options as const value.
+ pub const DEFAULT: Self = Self {
+ colored: true,
+ show_translation: true,
+ show_why: true,
+ show_fix: true,
+ show_links: true,
+ show_original: false
+ };
+
+ /// Create new builder for constructing DisplayOptions.
+ #[allow(dead_code)]
+ pub const fn builder() -> DisplayOptionsBuilder {
+ DisplayOptionsBuilder::new()
+ }
+}
+
+impl Default for DisplayOptions {
+ fn default() -> Self {
+ Self::DEFAULT
+ }
+}
+
+/// Builder for constructing DisplayOptions with const support.
+///
+/// # Example
+///
+/// ```ignore
+/// use masterror_cli::options::DisplayOptions;
+///
+/// const OPTS: DisplayOptions = DisplayOptions::builder()
+/// .colored(false)
+/// .show_original(true)
+/// .build();
+/// ```
+#[derive(Clone, Copy, Debug)]
+#[allow(dead_code)]
+pub struct DisplayOptionsBuilder {
+ colored: bool,
+ show_translation: bool,
+ show_why: bool,
+ show_fix: bool,
+ show_links: bool,
+ show_original: bool
+}
+
+#[allow(dead_code)]
+impl DisplayOptionsBuilder {
+ /// Create new builder with default values.
+ pub const fn new() -> Self {
+ Self {
+ colored: true,
+ show_translation: true,
+ show_why: true,
+ show_fix: true,
+ show_links: true,
+ show_original: false
+ }
+ }
+
+ /// Set colored output.
+ pub const fn colored(mut self, value: bool) -> Self {
+ self.colored = value;
+ self
+ }
+
+ /// Set show translation.
+ pub const fn show_translation(mut self, value: bool) -> Self {
+ self.show_translation = value;
+ self
+ }
+
+ /// Set show why explanation.
+ pub const fn show_why(mut self, value: bool) -> Self {
+ self.show_why = value;
+ self
+ }
+
+ /// Set show fix suggestions.
+ pub const fn show_fix(mut self, value: bool) -> Self {
+ self.show_fix = value;
+ self
+ }
+
+ /// Set show documentation links.
+ pub const fn show_links(mut self, value: bool) -> Self {
+ self.show_links = value;
+ self
+ }
+
+ /// Set show original compiler output.
+ pub const fn show_original(mut self, value: bool) -> Self {
+ self.show_original = value;
+ self
+ }
+
+ /// Build the DisplayOptions.
+ pub const fn build(self) -> DisplayOptions {
+ DisplayOptions {
+ colored: self.colored,
+ show_translation: self.show_translation,
+ show_why: self.show_why,
+ show_fix: self.show_fix,
+ show_links: self.show_links,
+ show_original: self.show_original
+ }
+ }
+}
+
+impl Default for DisplayOptionsBuilder {
+ fn default() -> Self {
+ Self::new()
+ }
+}
diff --git a/masterror-cli/src/output.rs b/masterror-cli/src/output.rs
new file mode 100644
index 0000000..55f9c58
--- /dev/null
+++ b/masterror-cli/src/output.rs
@@ -0,0 +1,114 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! Terminal output formatting for errors.
+
+use masterror_knowledge::{ErrorEntry, ErrorRegistry, Lang, UiMsg};
+use owo_colors::OwoColorize;
+
+use crate::{options::DisplayOptions, parser::CargoMessage, sections};
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Colored output helpers
+// ─────────────────────────────────────────────────────────────────────────────
+
+/// Print text as bold title.
+pub fn print_title(text: &str, colored: bool) {
+ if colored {
+ println!("{}", text.bold());
+ } else {
+ println!("{text}");
+ }
+}
+
+/// Print category header (yellow bold).
+pub fn print_category_header(text: &str, colored: bool) {
+ if colored {
+ println!(" {}", text.yellow().bold());
+ } else {
+ println!(" {text}");
+ }
+}
+
+/// Print code with title (code in cyan).
+pub fn print_code_title(code: &str, title: &str, colored: bool) {
+ if colored {
+ println!(" {} - {title}", code.cyan());
+ } else {
+ println!(" {code} - {title}");
+ }
+}
+
+/// Print section label (green bold).
+pub fn print_label(label: &str, colored: bool) {
+ if colored {
+ println!("{}", label.green().bold());
+ } else {
+ println!("{label}");
+ }
+}
+
+/// Print dimmed text.
+pub fn print_dimmed(text: &str, colored: bool) {
+ if colored {
+ println!("{}", text.dimmed());
+ } else {
+ println!("{text}");
+ }
+}
+
+const SEPARATOR: &str = "--- masterror ----------------------------------------";
+const SEPARATOR_END: &str = "------------------------------------------------------";
+
+/// Print error with masterror explanation.
+pub fn print_error(lang: Lang, msg: &CargoMessage, opts: &DisplayOptions) {
+ let rendered = msg.rendered_output();
+
+ if opts.show_original
+ && let Some(r) = rendered
+ {
+ print!("{}", r.trim_end());
+ }
+
+ let Some(code) = msg.error_code() else {
+ if opts.show_original {
+ println!();
+ }
+ return;
+ };
+
+ let registry = ErrorRegistry::new();
+ let Some(entry) = registry.find(code) else {
+ if opts.show_original {
+ println!();
+ }
+ return;
+ };
+
+ println!();
+ print_block(lang, entry, rendered, opts);
+}
+
+fn print_block(lang: Lang, entry: &ErrorEntry, rendered: Option<&str>, opts: &DisplayOptions) {
+ print_dimmed(SEPARATOR, opts.colored);
+
+ if opts.show_translation {
+ sections::translation::print(lang, rendered, opts.colored);
+ }
+
+ if opts.show_why {
+ print_label(UiMsg::LabelWhy.get(lang), opts.colored);
+ println!("{}", entry.explanation.get(lang.code()));
+ }
+
+ if opts.show_fix {
+ sections::fix::print(lang, entry.fixes, opts.colored);
+ }
+
+ if opts.show_links {
+ sections::link::print(lang, entry.links, opts.colored);
+ }
+
+ print_dimmed(SEPARATOR_END, opts.colored);
+}
diff --git a/masterror-cli/src/parser.rs b/masterror-cli/src/parser.rs
new file mode 100644
index 0000000..6b25c8f
--- /dev/null
+++ b/masterror-cli/src/parser.rs
@@ -0,0 +1,62 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! Cargo JSON output parser.
+
+use serde::Deserialize;
+
+/// Top-level cargo message.
+#[derive(Deserialize)]
+pub struct CargoMessage {
+ pub reason: String,
+ pub message: Option,
+ /// Full rendered compiler output.
+ pub rendered: Option
+}
+
+/// Compiler diagnostic message.
+#[derive(Deserialize)]
+pub struct DiagnosticMessage {
+ pub level: String,
+ #[allow(dead_code)]
+ pub message: String,
+ pub code: Option,
+ pub rendered: Option
+}
+
+/// Error code info.
+#[derive(Deserialize)]
+pub struct DiagnosticCode {
+ pub code: String
+}
+
+impl CargoMessage {
+ /// Check if this is a compiler error message.
+ pub fn is_error(&self) -> bool {
+ self.reason == "compiler-message"
+ && self.message.as_ref().is_some_and(|m| m.level == "error")
+ }
+
+ /// Get the error code if present.
+ pub fn error_code(&self) -> Option<&str> {
+ self.message
+ .as_ref()
+ .and_then(|m| m.code.as_ref())
+ .map(|c| c.code.as_str())
+ }
+
+ /// Get the error message.
+ #[allow(dead_code)]
+ pub fn error_message(&self) -> Option<&str> {
+ self.message.as_ref().map(|m| m.message.as_str())
+ }
+
+ /// Get rendered output (from message or top-level).
+ pub fn rendered_output(&self) -> Option<&str> {
+ self.message
+ .as_ref()
+ .and_then(|m| m.rendered.as_deref())
+ .or(self.rendered.as_deref())
+ }
+}
diff --git a/masterror-cli/src/sections.rs b/masterror-cli/src/sections.rs
new file mode 100644
index 0000000..82c32d3
--- /dev/null
+++ b/masterror-cli/src/sections.rs
@@ -0,0 +1,9 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! Output sections for masterror block.
+
+pub mod fix;
+pub mod link;
+pub mod translation;
diff --git a/masterror-cli/src/sections/fix.rs b/masterror-cli/src/sections/fix.rs
new file mode 100644
index 0000000..113c62d
--- /dev/null
+++ b/masterror-cli/src/sections/fix.rs
@@ -0,0 +1,35 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! Fix section - shows fix suggestions with code examples.
+
+use masterror_knowledge::{FixSuggestion, Lang, UiMsg};
+use owo_colors::OwoColorize;
+
+/// Print fix suggestions with code examples.
+pub fn print(lang: Lang, fixes: &[FixSuggestion], colored: bool) {
+ if fixes.is_empty() {
+ return;
+ }
+
+ let label = UiMsg::LabelFix.get(lang);
+
+ if colored {
+ println!("{}", label.green().bold());
+ } else {
+ println!("{label}");
+ }
+
+ for (i, fix) in fixes.iter().enumerate() {
+ let desc = fix.description.get(lang.code());
+ let num = i + 1;
+ if colored {
+ println!(" {}. {}", num.cyan(), desc);
+ println!(" {}", fix.code.dimmed());
+ } else {
+ println!(" {num}. {desc}");
+ println!(" {}", fix.code);
+ }
+ }
+}
diff --git a/masterror-cli/src/sections/link.rs b/masterror-cli/src/sections/link.rs
new file mode 100644
index 0000000..d8e8843
--- /dev/null
+++ b/masterror-cli/src/sections/link.rs
@@ -0,0 +1,31 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! Link section - shows documentation URLs.
+
+use masterror_knowledge::{DocLink, Lang, UiMsg};
+use owo_colors::OwoColorize;
+
+/// Print documentation links with titles.
+pub fn print(lang: Lang, links: &[DocLink], colored: bool) {
+ if links.is_empty() {
+ return;
+ }
+
+ let label = UiMsg::LabelLink.get(lang);
+
+ if colored {
+ println!("{}", label.blue().bold());
+ } else {
+ println!("{label}");
+ }
+
+ for link in links {
+ if colored {
+ println!(" {} {}", link.title.cyan(), link.url.underline().dimmed());
+ } else {
+ println!(" {} {}", link.title, link.url);
+ }
+ }
+}
diff --git a/masterror-cli/src/sections/translation.rs b/masterror-cli/src/sections/translation.rs
new file mode 100644
index 0000000..c9a4758
--- /dev/null
+++ b/masterror-cli/src/sections/translation.rs
@@ -0,0 +1,33 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! Translation section - shows full translated compiler error.
+
+use masterror_knowledge::{Lang, UiMsg, phrases::translate_rendered};
+use owo_colors::OwoColorize;
+
+/// Print full translated copy of compiler error.
+pub fn print(lang: Lang, rendered: Option<&str>, colored: bool) {
+ if matches!(lang, Lang::En) {
+ return;
+ }
+
+ let Some(rendered) = rendered else {
+ return;
+ };
+
+ let translated = translate_rendered(rendered, lang);
+
+ let label = UiMsg::LabelTranslation.get(lang);
+
+ if colored {
+ println!("{}", label.cyan().bold());
+ } else {
+ println!("{label}");
+ }
+
+ for line in translated.lines() {
+ println!(" {line}");
+ }
+}
diff --git a/masterror-derive/src/app_error_impl.rs b/masterror-derive/src/app_error_impl.rs
index c9a944c..b5f7b49 100644
--- a/masterror-derive/src/app_error_impl.rs
+++ b/masterror-derive/src/app_error_impl.rs
@@ -170,20 +170,26 @@ fn enum_app_code_impl(input: &ErrorInput, variants: &[VariantData]) -> TokenStre
}
}
-fn variant_app_error_pattern(enum_ident: &syn::Ident, variant: &VariantData) -> TokenStream {
+fn variant_pattern(
+ enum_ident: &syn::Ident,
+ variant: &VariantData,
+ with_binding: bool
+) -> TokenStream {
let ident = &variant.ident;
- match &variant.fields {
- Fields::Unit => quote! { err @ #enum_ident::#ident },
- Fields::Named(_) => quote! { err @ #enum_ident::#ident { .. } },
- Fields::Unnamed(_) => quote! { err @ #enum_ident::#ident(..) }
+ match (&variant.fields, with_binding) {
+ (Fields::Unit, true) => quote! { err @ #enum_ident::#ident },
+ (Fields::Unit, false) => quote! { #enum_ident::#ident },
+ (Fields::Named(_), true) => quote! { err @ #enum_ident::#ident { .. } },
+ (Fields::Named(_), false) => quote! { #enum_ident::#ident { .. } },
+ (Fields::Unnamed(_), true) => quote! { err @ #enum_ident::#ident(..) },
+ (Fields::Unnamed(_), false) => quote! { #enum_ident::#ident(..) }
}
}
+fn variant_app_error_pattern(enum_ident: &syn::Ident, variant: &VariantData) -> TokenStream {
+ variant_pattern(enum_ident, variant, true)
+}
+
fn variant_app_code_pattern(enum_ident: &syn::Ident, variant: &VariantData) -> TokenStream {
- let ident = &variant.ident;
- match &variant.fields {
- Fields::Unit => quote! { #enum_ident::#ident },
- Fields::Named(_) => quote! { #enum_ident::#ident { .. } },
- Fields::Unnamed(_) => quote! { #enum_ident::#ident(..) }
- }
+ variant_pattern(enum_ident, variant, false)
}
diff --git a/masterror-derive/src/input/parse_attr.rs b/masterror-derive/src/input/parse_attr.rs
index 6e2f53a..6fa9094 100644
--- a/masterror-derive/src/input/parse_attr.rs
+++ b/masterror-derive/src/input/parse_attr.rs
@@ -25,26 +25,28 @@ use super::{
};
use crate::template_support::parse_display_template;
-/// Extracts masterror specification from attributes.
-pub(crate) fn extract_masterror_spec(
+/// Generic attribute extraction with duplicate detection.
+fn extract_single_attr(
attrs: &[Attribute],
+ attr_name: &str,
+ parse_fn: impl Fn(&Attribute) -> syn::Result,
errors: &mut Vec
-) -> Result, ()> {
+) -> Result, ()> {
let mut spec = None;
let mut had_error = false;
for attr in attrs {
- if !path_is(attr, "masterror") {
+ if !path_is(attr, attr_name) {
continue;
}
if spec.is_some() {
errors.push(Error::new_spanned(
attr,
- "duplicate #[masterror(...)] attribute"
+ format!("duplicate #[{attr_name}(...)] attribute")
));
had_error = true;
continue;
}
- match parse_masterror_attribute(attr) {
+ match parse_fn(attr) {
Ok(parsed) => spec = Some(parsed),
Err(err) => {
errors.push(err);
@@ -55,34 +57,20 @@ pub(crate) fn extract_masterror_spec(
if had_error { Err(()) } else { Ok(spec) }
}
+/// Extracts masterror specification from attributes.
+pub(crate) fn extract_masterror_spec(
+ attrs: &[Attribute],
+ errors: &mut Vec
+) -> Result, ()> {
+ extract_single_attr(attrs, "masterror", parse_masterror_attribute, errors)
+}
+
/// Extracts app_error specification from attributes.
pub(crate) fn extract_app_error_spec(
attrs: &[Attribute],
errors: &mut Vec
) -> Result, ()> {
- let mut spec = None;
- let mut had_error = false;
- for attr in attrs {
- if !path_is(attr, "app_error") {
- continue;
- }
- if spec.is_some() {
- errors.push(Error::new_spanned(
- attr,
- "duplicate #[app_error(...)] attribute"
- ));
- had_error = true;
- continue;
- }
- match parse_app_error_attribute(attr) {
- Ok(parsed) => spec = Some(parsed),
- Err(err) => {
- errors.push(err);
- had_error = true;
- }
- }
- }
- if had_error { Err(()) } else { Ok(spec) }
+ extract_single_attr(attrs, "app_error", parse_app_error_attribute, errors)
}
/// Extracts display specification from error attributes.
diff --git a/masterror-knowledge/Cargo.toml b/masterror-knowledge/Cargo.toml
new file mode 100644
index 0000000..fce37d1
--- /dev/null
+++ b/masterror-knowledge/Cargo.toml
@@ -0,0 +1,25 @@
+# SPDX-FileCopyrightText: 2025-2026 RAprogramm
+#
+# SPDX-License-Identifier: MIT
+
+[package]
+name = "masterror-knowledge"
+version = "0.1.0"
+edition.workspace = true
+rust-version.workspace = true
+license.workspace = true
+repository.workspace = true
+description = "Knowledge base for Rust compiler errors and best practices"
+keywords = ["rust", "compiler", "errors", "explain", "learning"]
+categories = ["development-tools", "command-line-utilities"]
+
+[features]
+default = ["lang-ru", "lang-ko"]
+
+# Languages
+lang-ru = []
+lang-ko = []
+
+[dependencies]
+arrayvec = "0.7"
+aho-corasick = "1"
diff --git a/masterror-knowledge/README.md b/masterror-knowledge/README.md
new file mode 100644
index 0000000..bf83138
--- /dev/null
+++ b/masterror-knowledge/README.md
@@ -0,0 +1,88 @@
+
+
+
+
+
+
masterror-knowledge
+
Knowledge base for Rust compiler errors and best practices
+
+ [](https://crates.io/crates/masterror-knowledge)
+ [](https://docs.rs/masterror-knowledge)
+ 
+
- + '_ {
+ self.errors.values().copied()
+ }
+
+ /// Get errors by category.
+ pub fn by_category(&self, cat: Category) -> Vec<&'static ErrorEntry> {
+ self.errors
+ .values()
+ .filter(|e| e.category == cat)
+ .copied()
+ .collect()
+ }
+}
+
+impl Default for &'static ErrorRegistry {
+ fn default() -> Self {
+ ErrorRegistry::new()
+ }
+}
diff --git a/masterror-knowledge/src/errors/abi.rs b/masterror-knowledge/src/errors/abi.rs
new file mode 100644
index 0000000..17eca72
--- /dev/null
+++ b/masterror-knowledge/src/errors/abi.rs
@@ -0,0 +1,18 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! ABI and FFI related errors.
+
+mod e0044;
+mod e0045;
+mod e0060;
+mod e0130;
+
+use super::ErrorEntry;
+
+static ENTRIES: &[&ErrorEntry] = &[&e0044::ENTRY, &e0045::ENTRY, &e0060::ENTRY, &e0130::ENTRY];
+
+pub fn entries() -> &'static [&'static ErrorEntry] {
+ ENTRIES
+}
diff --git a/masterror-knowledge/src/errors/abi/e0044.rs b/masterror-knowledge/src/errors/abi/e0044.rs
new file mode 100644
index 0000000..a221a09
--- /dev/null
+++ b/masterror-knowledge/src/errors/abi/e0044.rs
@@ -0,0 +1,50 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! E0044: foreign items cannot have type/const parameters
+
+use crate::errors::{Category, DocLink, ErrorEntry, FixSuggestion, LocalizedText};
+
+pub static ENTRY: ErrorEntry = ErrorEntry {
+ code: "E0044",
+ title: LocalizedText::new(
+ "Foreign items cannot have type parameters",
+ "Внешние элементы не могут иметь параметры типа",
+ "외부 항목은 타입 매개변수를 가질 수 없음"
+ ),
+ category: Category::Abi,
+ explanation: LocalizedText::new(
+ "\
+Foreign items declared in `extern` blocks cannot have generic type or const
+parameters. Foreign functions (from C libraries) have concrete signatures.
+
+Example:
+ extern \"C\" {
+ fn some_func(x: T); // Error: generic not allowed
+ }",
+ "\
+Внешние элементы, объявленные в блоках `extern`, не могут иметь обобщённые
+параметры типа или константы. Внешние функции имеют конкретные сигнатуры.",
+ "\
+`extern` 블록에 선언된 외부 항목은 제네릭 타입이나 const 매개변수를 가질 수 없습니다."
+ ),
+ fixes: &[FixSuggestion {
+ description: LocalizedText::new(
+ "Create separate declarations for each type",
+ "Создать отдельные объявления для каждого типа",
+ "각 타입에 대해 별도의 선언 생성"
+ ),
+ code: "extern \"C\" {\n fn some_func_i32(x: i32);\n fn some_func_i64(x: i64);\n}"
+ }],
+ links: &[
+ DocLink {
+ title: "Rust Reference: External blocks",
+ url: "https://doc.rust-lang.org/reference/items/external-blocks.html"
+ },
+ DocLink {
+ title: "Error Code Reference",
+ url: "https://doc.rust-lang.org/error_codes/E0044.html"
+ }
+ ]
+};
diff --git a/masterror-knowledge/src/errors/abi/e0045.rs b/masterror-knowledge/src/errors/abi/e0045.rs
new file mode 100644
index 0000000..95d8005
--- /dev/null
+++ b/masterror-knowledge/src/errors/abi/e0045.rs
@@ -0,0 +1,45 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! E0045: variadic parameters on non-C ABI function
+
+use crate::errors::{Category, DocLink, ErrorEntry, FixSuggestion, LocalizedText};
+
+pub static ENTRY: ErrorEntry = ErrorEntry {
+ code: "E0045",
+ title: LocalizedText::new(
+ "Variadic parameters on non-C ABI",
+ "Вариативные параметры с не-C ABI",
+ "비 C ABI에서 가변 매개변수"
+ ),
+ category: Category::Abi,
+ explanation: LocalizedText::new(
+ "\
+Variadic parameters (`...`) can only be used with functions using the C ABI.
+Rust only supports variadic parameters for FFI interoperability with C.
+
+Example:
+ extern \"Rust\" {
+ fn foo(x: u8, ...); // Error: variadic not allowed
+ }",
+ "\
+Вариативные параметры (`...`) можно использовать только с функциями,
+использующими C ABI. Rust поддерживает вариативные параметры только для
+взаимодействия с C через FFI.",
+ "\
+가변 매개변수(`...`)는 C ABI를 사용하는 함수에서만 사용할 수 있습니다."
+ ),
+ fixes: &[FixSuggestion {
+ description: LocalizedText::new(
+ "Use extern \"C\" for variadic functions",
+ "Использовать extern \"C\" для вариативных функций",
+ "가변 함수에 extern \"C\" 사용"
+ ),
+ code: "extern \"C\" {\n fn foo(x: u8, ...);\n}"
+ }],
+ links: &[DocLink {
+ title: "Error Code Reference",
+ url: "https://doc.rust-lang.org/error_codes/E0045.html"
+ }]
+};
diff --git a/masterror-knowledge/src/errors/abi/e0060.rs b/masterror-knowledge/src/errors/abi/e0060.rs
new file mode 100644
index 0000000..189b030
--- /dev/null
+++ b/masterror-knowledge/src/errors/abi/e0060.rs
@@ -0,0 +1,47 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! E0060: variadic function called with insufficient arguments
+
+use crate::errors::{Category, DocLink, ErrorEntry, FixSuggestion, LocalizedText};
+
+pub static ENTRY: ErrorEntry = ErrorEntry {
+ code: "E0060",
+ title: LocalizedText::new(
+ "Variadic function called with insufficient arguments",
+ "Вариативная функция вызвана с недостаточным количеством аргументов",
+ "가변 함수가 불충분한 인수로 호출됨"
+ ),
+ category: Category::Abi,
+ explanation: LocalizedText::new(
+ "\
+Variadic external C functions still require their minimum fixed arguments.
+You cannot call a variadic function with fewer arguments than the non-variadic
+part requires.
+
+Example:
+ extern \"C\" {
+ fn printf(fmt: *const c_char, ...) -> c_int;
+ }
+ unsafe { printf(); } // Error: missing format string argument",
+ "\
+Вариативные внешние C функции по-прежнему требуют минимальные фиксированные
+аргументы. Нельзя вызвать вариативную функцию с меньшим количеством аргументов,
+чем требует невариативная часть.",
+ "\
+가변 외부 C 함수는 여전히 최소한의 고정 인수가 필요합니다."
+ ),
+ fixes: &[FixSuggestion {
+ description: LocalizedText::new(
+ "Provide required arguments",
+ "Предоставить обязательные аргументы",
+ "필수 인수 제공"
+ ),
+ code: "unsafe {\n printf(c\"test\\n\".as_ptr());\n printf(c\"%d\\n\".as_ptr(), 42);\n}"
+ }],
+ links: &[DocLink {
+ title: "Error Code Reference",
+ url: "https://doc.rust-lang.org/error_codes/E0060.html"
+ }]
+};
diff --git a/masterror-knowledge/src/errors/abi/e0130.rs b/masterror-knowledge/src/errors/abi/e0130.rs
new file mode 100644
index 0000000..e42e8a6
--- /dev/null
+++ b/masterror-knowledge/src/errors/abi/e0130.rs
@@ -0,0 +1,59 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! E0130: patterns aren't allowed in foreign function declarations
+
+use crate::errors::{Category, DocLink, ErrorEntry, FixSuggestion, LocalizedText};
+
+pub static ENTRY: ErrorEntry = ErrorEntry {
+ code: "E0130",
+ title: LocalizedText::new(
+ "Patterns aren't allowed in foreign function declarations",
+ "Паттерны не разрешены в объявлениях внешних функций",
+ "외부 함수 선언에서 패턴이 허용되지 않음"
+ ),
+ category: Category::Types,
+ explanation: LocalizedText::new(
+ "\
+A pattern (like tuple destructuring) was used as an argument in a foreign
+function declaration. Foreign functions (declared with extern \"C\") must
+use simple identifiers with explicit type annotations rather than patterns.",
+ "\
+Паттерн (например, деструктуризация кортежа) был использован как аргумент
+в объявлении внешней функции. Внешние функции (объявленные с extern \"C\")
+должны использовать простые идентификаторы с явными аннотациями типов.",
+ "\
+외부 함수 선언에서 패턴(튜플 구조 분해 등)이 인수로 사용되었습니다.
+외부 함수(extern \"C\"로 선언)는 패턴 대신 명시적 타입 주석이 있는
+간단한 식별자를 사용해야 합니다."
+ ),
+ fixes: &[
+ FixSuggestion {
+ description: LocalizedText::new(
+ "Use a struct instead of tuple destructuring",
+ "Использовать структуру вместо деструктуризации кортежа",
+ "튜플 구조 분해 대신 구조체 사용"
+ ),
+ code: "struct SomeStruct {\n a: u32,\n b: u32,\n}\n\nextern \"C\" {\n fn foo(s: SomeStruct);\n}"
+ },
+ FixSuggestion {
+ description: LocalizedText::new(
+ "Use a simple identifier with the tuple type",
+ "Использовать простой идентификатор с типом кортежа",
+ "튜플 타입과 함께 간단한 식별자 사용"
+ ),
+ code: "extern \"C\" {\n fn foo(a: (u32, u32));\n}"
+ }
+ ],
+ links: &[
+ DocLink {
+ title: "Rust Book: FFI",
+ url: "https://doc.rust-lang.org/book/ch19-01-unsafe-rust.html#using-extern-functions-to-call-external-code"
+ },
+ DocLink {
+ title: "Error Code Reference",
+ url: "https://doc.rust-lang.org/error_codes/E0130.html"
+ }
+ ]
+};
diff --git a/masterror-knowledge/src/errors/async/e0706.rs b/masterror-knowledge/src/errors/async/e0706.rs
new file mode 100644
index 0000000..59109e5
--- /dev/null
+++ b/masterror-knowledge/src/errors/async/e0706.rs
@@ -0,0 +1,59 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! E0706: async fn in trait (no longer emitted)
+
+use crate::errors::{Category, DocLink, ErrorEntry, FixSuggestion, LocalizedText};
+
+pub static ENTRY: ErrorEntry = ErrorEntry {
+ code: "E0706",
+ title: LocalizedText::new(
+ "Async fn not supported in traits",
+ "Async fn не поддерживается в трейтах",
+ "트레이트에서 async fn 지원되지 않음"
+ ),
+ category: Category::Async,
+ explanation: LocalizedText::new(
+ "\
+Note: This error code is no longer emitted by the compiler.
+
+Previously, `async fn`s were not supported in traits because they return
+`impl Future`, which requires Generic Associated Types (GATs).
+
+Modern Rust now supports async functions in traits natively.",
+ "\
+Примечание: Эта ошибка больше не выдаётся компилятором.
+
+Ранее `async fn` не поддерживались в трейтах, так как они возвращают
+`impl Future`, что требовало GATs. Современный Rust поддерживает это.",
+ "\
+참고: 이 오류 코드는 더 이상 컴파일러에서 발생하지 않습니다.
+
+이전에는 `async fn`이 트레이트에서 지원되지 않았습니다."
+ ),
+ fixes: &[
+ FixSuggestion {
+ description: LocalizedText::new(
+ "Use native async trait (modern Rust)",
+ "Используйте встроенную поддержку async trait",
+ "네이티브 async 트레이트 사용"
+ ),
+ code: "trait MyTrait {\n async fn foo(&self);\n}"
+ },
+ FixSuggestion {
+ description: LocalizedText::new(
+ "Use async-trait crate (legacy)",
+ "Используйте крейт async-trait",
+ "async-trait 크레이트 사용"
+ ),
+ code: "#[async_trait]\ntrait MyTrait {\n async fn foo(&self);\n}"
+ }
+ ],
+ links: &[
+ DocLink {
+ title: "Error Code Reference",
+ url: "https://doc.rust-lang.org/error_codes/E0706.html"
+ }
+ ]
+};
diff --git a/masterror-knowledge/src/errors/async/e0708.rs b/masterror-knowledge/src/errors/async/e0708.rs
new file mode 100644
index 0000000..c50855d
--- /dev/null
+++ b/masterror-knowledge/src/errors/async/e0708.rs
@@ -0,0 +1,46 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! E0708: async non-move closure with parameters (no longer emitted)
+
+use crate::errors::{Category, DocLink, ErrorEntry, FixSuggestion, LocalizedText};
+
+pub static ENTRY: ErrorEntry = ErrorEntry {
+ code: "E0708",
+ title: LocalizedText::new(
+ "Async non-move closure with parameters",
+ "Async замыкание без move с параметрами",
+ "매개변수가 있는 async non-move 클로저"
+ ),
+ category: Category::Async,
+ explanation: LocalizedText::new(
+ "\
+Note: This error code is no longer emitted by the compiler.
+
+Previously, `async` closures with parameters required the `move` keyword.
+Modern Rust has relaxed this restriction.",
+ "\
+Примечание: Эта ошибка больше не выдаётся компилятором.
+
+Ранее `async` замыкания с параметрами требовали ключевое слово `move`.",
+ "\
+참고: 이 오류 코드는 더 이상 컴파일러에서 발생하지 않습니다."
+ ),
+ fixes: &[
+ FixSuggestion {
+ description: LocalizedText::new(
+ "Add move keyword (legacy fix)",
+ "Добавьте ключевое слово move",
+ "move 키워드 추가"
+ ),
+ code: "let add_one = async move |num: u8| {\n num + 1\n};"
+ }
+ ],
+ links: &[
+ DocLink {
+ title: "Error Code Reference",
+ url: "https://doc.rust-lang.org/error_codes/E0708.html"
+ }
+ ]
+};
diff --git a/masterror-knowledge/src/errors/async/e0727.rs b/masterror-knowledge/src/errors/async/e0727.rs
new file mode 100644
index 0000000..e3d7682
--- /dev/null
+++ b/masterror-knowledge/src/errors/async/e0727.rs
@@ -0,0 +1,48 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! E0727: `yield` used in async context
+
+use crate::errors::{Category, DocLink, ErrorEntry, FixSuggestion, LocalizedText};
+
+pub static ENTRY: ErrorEntry = ErrorEntry {
+ code: "E0727",
+ title: LocalizedText::new(
+ "yield clause used in async context",
+ "yield используется в асинхронном контексте",
+ "async 컨텍스트에서 yield 사용됨"
+ ),
+ category: Category::Async,
+ explanation: LocalizedText::new(
+ "\
+A `yield` clause was used in an `async` context. The `yield` keyword is used
+for coroutines/generators, but mixing it with async blocks is not supported.
+
+The async machinery handles its own suspension points via `.await`, and
+coroutine yields are a separate mechanism that cannot be mixed.",
+ "\
+Ключевое слово `yield` было использовано в `async` контексте.
+`yield` используется для корутин/генераторов, но смешивание с async блоками
+не поддерживается.",
+ "\
+`async` 컨텍스트에서 `yield` 절이 사용되었습니다. `yield` 키워드는
+코루틴/제너레이터용이며 async 블록과 혼합할 수 없습니다."
+ ),
+ fixes: &[
+ FixSuggestion {
+ description: LocalizedText::new(
+ "Move yield outside async block",
+ "Переместите yield за пределы async блока",
+ "yield를 async 블록 밖으로 이동"
+ ),
+ code: "#[coroutine] || {\n yield;\n}"
+ }
+ ],
+ links: &[
+ DocLink {
+ title: "Error Code Reference",
+ url: "https://doc.rust-lang.org/error_codes/E0727.html"
+ }
+ ]
+};
diff --git a/masterror-knowledge/src/errors/async/e0728.rs b/masterror-knowledge/src/errors/async/e0728.rs
new file mode 100644
index 0000000..84dd171
--- /dev/null
+++ b/masterror-knowledge/src/errors/async/e0728.rs
@@ -0,0 +1,58 @@
+// SPDX-FileCopyrightText: 2025-2026 RAprogramm
+//
+// SPDX-License-Identifier: MIT
+
+//! E0728: await used outside async context
+
+use crate::errors::{Category, DocLink, ErrorEntry, FixSuggestion, LocalizedText};
+
+pub static ENTRY: ErrorEntry = ErrorEntry {
+ code: "E0728",
+ title: LocalizedText::new(
+ "await used outside async context",
+ "await используется вне асинхронного контекста",
+ "async 컨텍스트 외부에서 await 사용"
+ ),
+ category: Category::Async,
+ explanation: LocalizedText::new(
+ "\
+The `await` keyword was used outside of an `async` function or `async` block.
+
+The `await` keyword is used to suspend the current computation until the
+given future is ready to produce a value. It is only legal within an async
+context, such as an `async fn` or an `async` block.",
+ "\
+Ключевое слово `await` используется вне `async` функции или `async` блока.
+
+`await` приостанавливает текущее вычисление до готовности future.
+Оно допустимо только в async контексте.",
+ "\
+`await` 키워드가 `async` 함수나 `async` 블록 외부에서 사용되었습니다.
+
+`await`는 현재 계산을 일시 중지하며 async 컨텍스트 내에서만 유효합니다."
+ ),
+ fixes: &[
+ FixSuggestion {
+ description: LocalizedText::new(
+ "Use await inside async function",
+ "Используйте await внутри async функции",
+ "async 함수 내에서 await 사용"
+ ),
+ code: "async fn foo() {\n some_future().await;\n}"
+ },
+ FixSuggestion {
+ description: LocalizedText::new(
+ "Use await inside async block",
+ "Используйте await внутри async блока",
+ "async 블록 내에서 await 사용"
+ ),
+ code: "fn bar() -> impl Future