feat(cli): implement cougr doctor toolchain diagnostics (#247)

.github/workflows/core.yml

@@ -8,6 +8,7 @@ on:
       - 'internal/**'
       - 'tests/**'
       - 'benches/**'
+      - 'cli/**'
       - 'Cargo.toml'
       - 'Cargo.lock'
       - '.github/workflows/core.yml'
@@ -19,6 +20,7 @@ on:
       - 'internal/**'
       - 'tests/**'
       - 'benches/**'
+      - 'cli/**'
       - 'Cargo.toml'
       - 'Cargo.lock'
       - '.github/workflows/core.yml'
@@ -59,3 +61,9 @@ jobs:
 
       - name: Build library
         run: cargo build
+
+      - name: Run hygiene check (cli)
+        run: cargo run --bin cougr -- check --path .
+
+      - name: Run verified check (canonical examples)
+        run: cargo run --bin cougr -- check --path . --verified --canonical-only

Cargo.toml

@@ -4,6 +4,7 @@ members = [
     "internal/cougr-core-circuits",
     "internal/cougr-core-session",
     "internal/cougr-core-test",
+    "cli",
 ]
 resolver = "2"
 

cli/Cargo.toml

@@ -0,0 +1,18 @@
+[package]
+name = "cougr-cli"
+version = "0.1.0"
+edition = "2021"
+description = "Cougr CLI — hygiene and development tooling for the Cougr ECS framework"
+license = "MIT"
+publish = false
+
+[[bin]]
+name = "cougr"
+path = "src/main.rs"
+
+[dependencies]
+clap = { version = "4", features = ["derive"] }
+regex = "1"
+anyhow = "1"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"