ModelCraft foundation: workspace, quality gates, FE model, command engine, geometry boundary

A pure-Rust CAE modeling workspace following the SolidCraft conventions:
- modelcraft-model: nodes and elements by label with hostile-input validation
- modelcraft-geometry: SolidCraft's kernel (pinned git dependency) behind our own API;
  tessellation into a face-tagged boundary surface for volume meshing
- modelcraft-engine: CommandSpec registry, Session::execute with rollback and panic guard,
  scripts and a journal
- modelcraft-cli: list commands, run scripts
- xtask: layers (only geometry may use solidcraft-*), assets, licences, tests, wasm, ci
- AGENTS.md, architecture, ADR 0001 (libraries and licences), roadmap, CI

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01NmAttHhUZTokgPeEJia8sm

apps/modelcraft-cli/Cargo.toml

@@ -0,0 +1,13 @@
+[package]
+name = "modelcraft-cli"
+description = "ModelCraft from the command line: list commands, run scripts"
+version.workspace = true
+edition.workspace = true
+license.workspace = true
+
+[lints]
+workspace = true
+
+[dependencies]
+modelcraft-engine = { workspace = true }
+serde_json = { workspace = true }

apps/modelcraft-cli/src/main.rs

@@ -0,0 +1,58 @@
+//! modelcraft-cli commands
+//! modelcraft-cli run <script.json>
+#![deny(clippy::unwrap_used, clippy::expect_used, clippy::panic, clippy::unimplemented, clippy::todo, clippy::unreachable)]
+#![forbid(unsafe_code)]
+
+use std::process::ExitCode;
+
+use modelcraft_engine::Session;
+use serde_json::json;
+
+const USAGE: &str = "\
+usage:
+  modelcraft-cli commands              list every command with its parameters
+  modelcraft-cli run <script.json>     run a script (a JSON array of {\"command\", \"params\"})
+                                       and print the model summary
+";
+
+/// Largest script accepted (bytes).
+const MAX_SCRIPT_BYTES: u64 = 256 * 1024 * 1024;
+
+fn main() -> ExitCode {
+    let args: Vec<String> = std::env::args().skip(1).collect();
+    let result = match args.first().map(String::as_str) {
+        Some("commands") => {
+            for c in modelcraft_engine::commands() {
+                println!("{:<24} {:<18} {}", c.id, c.label, c.params);
+            }
+            Ok(())
+        }
+        Some("run") => args.get(1).ok_or_else(|| format!("run needs a script\n\n{USAGE}")).and_then(|p| run(p)),
+        Some("-h" | "--help" | "help") | None => {
+            print!("{USAGE}");
+            Ok(())
+        }
+        Some(other) => Err(format!("unknown command `{other}`\n\n{USAGE}")),
+    };
+    match result {
+        Ok(()) => ExitCode::SUCCESS,
+        Err(e) => {
+            eprintln!("error: {e}");
+            ExitCode::FAILURE
+        }
+    }
+}
+
+fn run(path: &str) -> Result<(), String> {
+    let size = std::fs::metadata(path).map_err(|e| format!("{path}: {e}"))?.len();
+    if size > MAX_SCRIPT_BYTES {
+        return Err(format!("{path}: larger than {} MB", MAX_SCRIPT_BYTES / (1024 * 1024)));
+    }
+    let text = std::fs::read_to_string(path).map_err(|e| format!("{path}: {e}"))?;
+    let script: serde_json::Value = serde_json::from_str(&text).map_err(|e| format!("{path}: {e}"))?;
+    let mut session = Session::default();
+    session.run_script(&script).map_err(|e| e.to_string())?;
+    let info = session.execute("model.info", &json!({})).map_err(|e| e.to_string())?;
+    println!("{}", serde_json::to_string_pretty(&info).map_err(|e| e.to_string())?);
+    Ok(())
+}