Canonical Definition
{
"function": {
"description": "Run build and test checks across canonical OS apps, or a selected subset. By default it uses the canonical runtime apps from etc/apps.toml and runs cargo check plus cargo test for Rust apps. Use this to verify repo health after migrations, platform changes, or cross-app refactors.",
"name": "test_apps",
"parameters": {
"properties": {
"apps": {
"description": "Optional list of app slugs to test. Defaults to all canonical apps from etc/apps.toml.",
"items": {
"type": "string"
},
"type": "array"
},
"checks": {
"description": "Checks to run per app. Supported values: check, test. Defaults to ['check', 'test'].",
"items": {
"type": "string"
},
"type": "array"
},
"fail_fast": {
"description": "Stop after the first failed app/check. Defaults to false.",
"type": "boolean"
},
"include_reference": {
"description": "Whether to also include non-canonical reference Rust apps discovered under Apps/. Defaults to false.",
"type": "boolean"
},
"timeout_seconds": {
"description": "Per-command timeout in seconds. Defaults to 600.",
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"metadata": {
"artifact_type": "tool",
"consumers": [
"all"
],
"execution_kind": "cli",
"owner_app": "os-v3",
"promotion_reason": "Cross-app verification is foundational platform functionality for canonical runtime governance and regression detection.",
"scope": "global",
"version": "1.0.0"
},
"type": "function"
}