sruja-project

Sruja Project Skill

Procedural workflows for working with the Sruja architecture-as-code platform.

Project Overview

• Type: Rust workspace with 14 crates
• Primary language: Rust (core), TypeScript (extension)
• Architecture: Layered monolith with clear tier boundaries

Workflows

Adding a New Crate

1. Identify the tier for your crate:

   • Core Engine (sruja-diagnostics, sruja-language, sruja-engine, sruja-export, sruja-scan, sruja-graph-core)
   • Extraction (sruja-graph, sruja-extract)
   • Delivery (sruja-cli, sruja-wasm)
   • Secondary (sruja-diff, sruja-intent, sruja-agent, sruja-memory)

2. Add to workspace in root Cargo.toml:

   [workspace]
   members = ["crates/sruja-new-crate"]
   

3. Add dependencies in crates/sruja-new-crate/Cargo.toml

4. Update CLI if exposing new commands:

   • Add command definition in src/cli/commands.rs
   • Add handler in src/cli/run.rs
   • Add to src/commands/mod.rs

5. Validate:

   cargo build --release
   cargo test -p sruja-new-crate
   cargo clippy -- -D warnings
   

Adding a New CLI Command

1. Define the command in src/cli/commands.rs:

   #[command(name = "my-command")]
   MyCommand {
       #[arg(long = "repo", short = 'r', default_value = ".")]
       repo: String,
   },
   

2. Add handler in src/cli/run.rs:

   Commands::MyCommand { repo } => {
       commands::my_module::my_command(&repo)
   }
   

3. Implement the command in src/commands/my_module.rs

4. Export in src/commands/mod.rs:

   pub use my_module::my_command;
   

5. Test:

   cargo test -p sruja-cli
   ./target/release/sruja my-command --help
   

Validating Architecture Changes

1. After any .sruja file change:

   sruja lint repo.sruja
   

2. Check for drift:

   sruja sync -r .
   sruja drift -r .
   

3. Verify no layer violations:

   sruja classify -r .
   sruja drift -r . -a repo.sruja