craftlabs-authorization-sdk/native/AGENTS.md

NATIVE (Rust)

Part of: craftlabs-authorization-sdk Build: Cargo workspace (Rust 1.70+)

STRUCTURE

native/
├── craft-core/               # cdylib — exports craft_* C ABI
│   ├── src/
│   │   ├── lib.rs            # C entry points: craft_initialize, craft_activate, etc.
│   │   ├── trait_provider.rs # Provider trait
│   │   ├── security/         # anti_debug, obfuscation, integrity, string_encrypt, dynamic_api
│   │   ├── provider_selfhosted/ # activate, license, heartbeat, cache, protocol
│   │   ├── crypto.rs, device.rs, session.rs, error.rs, license.rs, heartbeat.rs
│   │   └── ...
│   └── tests/c_api_test.rs
├── craftlabs-auth-cli/       # CLI binary
│   └── src/
│       ├── main.rs           # status/activate/check/info/release/migrate commands
│       ├── config.rs         # Config loading
│       └── platform_api.rs   # Platform API client
├── Cargo.toml                # Workspace root
├── build/Makefile            # Alternative build wrapper
└── .deprecated-cmake/        # Old CMake build (unused)

WHERE TO LOOK

Task	Location
C ABI exports	craft-core/src/lib.rs
Provider trait	craft-core/src/trait_provider.rs
Self-hosted logic	craft-core/src/provider_selfhosted/
Security (anti-debug, obfuscation)	craft-core/src/security/
CLI commands	craftlabs-auth-cli/src/main.rs
Platform API client	craftlabs-auth-cli/src/platform_api.rs

CONVENTIONS

• C ABI: extern "C" + #[no_mangle]; all public functions prefixed craft_
• Provider trait: Provider trait with initialize, activate, check_license, heartbeat, release, close
• Security module: each concern in separate file under security/
• Error handling: error.rs defines error types; fn fail_result() for C return

ANTI-PATTERNS

• Do not mix JNI/JNA Rust glue — bridge is Java-side via JNA
• Do not use the deprecated CMake build under .deprecated-cmake/