Crate rsfulmen 

rsfulmen

Rust helper library for the Fulmen ecosystem.

rsfulmen provides foundry catalogs, config utilities, and cross-platform helpers that follow the same patterns as tsfulmen and pyfulmen.

Features

• foundry (default) - Foundry catalogs (core + opt-in heavy catalogs)
• foundry-core - Lightweight catalogs (signals, exit-codes, etc.)
• config (default) - XDG-compliant configuration path utilities
• crucible (default) - Embedded Crucible assets + metadata shim
• docscribe (default) - Doc access + frontmatter parsing
• three-layer-config (default) - Enterprise layered config loading
• schema-id (default) - schema_id tagging + offline resolution
• similarity (default) - Text similarity + suggestions (heavy)
• schema-validation (default) - JSON Schema validation helpers (heavy)
• error-handling (default) - Canonical error envelope + propagation
• telemetry-metrics (default) - Telemetry + metrics export
• appidentity (default) - App identity discovery from .fulmen/app.yaml
• logging (default) - Structured logging with SIMPLE/STRUCTURED profiles
• fulhash (default) - Canonical hashing (xxh3-128 + SHA-256)
• pathfinder (default) - Safe filesystem discovery with glob patterns
• ascii (default) - Terminal utilities + Unicode-aware string handling
• fulencode (default) - Encoding/decoding, detection, normalization, BOM helpers

Quick Start

use rsfulmen::config::get_fulmen_config_dir;

// Get the Fulmen config directory for the current platform
let config_dir = get_fulmen_config_dir();
println!("Fulmen config: {:?}", config_dir);

Crucible Integration

rsfulmen syncs schemas, documentation, and configuration defaults from Crucible, the Fulmen SSOT repository.

Run make sync-ssot to update synced assets.

Modules

appidentityappidentity

App identity discovery from .fulmen/app.yaml.

asciiascii

Terminal utilities and Unicode-aware string handling.

configconfig

Configuration path utilities following the Fulmen Config Path Standard.

cruciblecrucible

Embedded Crucible assets and sync metadata. Crucible Shim

docscribedocscribe

Access and processing of embedded Crucible documentation assets. Docscribe

error_handlingerror-handling

Canonical error envelope + propagation helpers. Error Handling & Propagation

foundryfoundry

Foundry catalog data structures.

fulencodefulencode

Canonical encoding/decoding, detection, normalization, and BOM helpers. Fulencode: canonical encoding/decoding, detection, normalization, and BOM helpers.

fulhashfulhash

Canonical hashing with xxh3-128 (default) and SHA-256.

logginglogging

Structured logging with SIMPLE and STRUCTURED profiles.

module_registrycrucible

Programmatic access to SSOT module registries. Module Registry (Compliance)

pathfinderpathfinder

Safe filesystem discovery with glob patterns.

schema_idschema-id

schema_id tagging and offline schema URI resolution. Schema ID Helpers

schema_validationschema-validation

Schema validation utilities backed by embedded Crucible schemas. Schema Validation

signalsfoundry-core

Runtime signal handling plus signal catalog helpers.

similaritysimilarity

Text similarity utilities. Similarity Utilities

telemetry_metricstelemetry-metrics

Telemetry + taxonomy-backed metrics export. Telemetry & Metrics Export

Constants

CRUCIBLE_VERSION

Crucible SSOT version this library was synced from.

VERSION

Library version information.