Skip to content

project-rustia.md

Latest commit

 

History

History
49 lines (42 loc) · 2.71 KB

project-rustia.md

File metadata and controls

49 lines (42 loc) · 2.71 KB

Project: rustia

Goal

Provide serde-based LLM JSON parsing and function-calling tool adapter utilities for Rust with three crates: runtime (rustia), derive proc-macro companion (rustia-macros), and aisdk adapter (rustia-llm).

Project ID

rustia

Domain Ownership Map

  • crates/rustia (core)
  • crates/rustia-llm (llm)
  • crates/rustia-macros (macros)

Domain Contract Documents

  • docs/crates-rustia-core-foundation.md
  • docs/crates-rustia-llm-foundation.md
  • docs/crates-rustia-macros-foundation.md

Cross-Domain Invariants

  • Component identifiers remain stable: core, llm, macros.
  • Runtime and macro boundaries remain explicitly separated across crates.
  • Runtime, adapter, and macro crates remain publishable (publish = true) and are eligible for workspace-managed cargo-mono publish.
  • Stable public API contract identifiers:
    • Runtime: Validate, IValidation, IValidationError, LLMData, LlmJsonParseResult, LlmJsonParseError
    • Adapter: LlmToolInput, LlmToolOutput, LlmToolSpec, tool, LlmToolBuildError, LlmToolInputError, LlmToolExecutionError
    • Macro: #[derive(LLMData)]
  • LLMData::parse performs parse-only coercion of stringified non-string JSON values (object/array/number/boolean/null) before returning validation failures, while direct Validate::validate / validate_equals calls remain strict.
  • rustia-llm::tool must parse aisdk tool inputs via LLMData::parse before handler execution and return deterministic validation feedback on failure.
  • LLMData derive expansion must remain compatible with runtime trait bounds and helper types from crates/rustia.
  • Lenient parse parity baseline is pinned to samchon/rustia@29a02742661d476ce5ef5414fe32acc7e97c0e6c parse tests.
  • Parity exclusions remain explicit and stable: undefined, non-finite numbers (Infinity, -Infinity), and lone-surrogate expectations.
  • Release tag eligibility remains explicit through root workspace metadata: [workspace.metadata.cargo-mono.publish.tag].packages must include rustia, rustia-llm, and rustia-macros.

Change Policy

  • Update this index and related crate contract docs together when runtime parsing semantics, adapter contracts, or derive expansion contracts change.
  • Keep root and crate-domain AGENTS.md ownership mappings synchronized with this index when rustia component paths or stability policies change.
  • Update root Cargo.toml publish-tag package configuration in the same change when rustia package release eligibility changes.
  • When upstream parity baseline commit changes, update this index, runtime contract docs, and parity tests together.

References

  • docs/project-template.md
  • docs/domain-template.md
  • docs/README.md