sheets: add nika

sheets/nika

@@ -0,0 +1,55 @@
+# nika
+# Workflow engine for AI: .nika.yaml DAGs statically checked before
+# execution (schema, permits, cost), tamper-evident traces after.
+
+# List the embedded example workflows:
+nika examples list
+
+# Run an example offline (no API key, no model server):
+nika examples run 01-hello --model mock/echo
+
+# Run the same example against a local Ollama model:
+nika examples run 01-hello --model ollama/llama3.2:3b
+
+# Scaffold a new workflow from a template:
+nika new --from daily-brief my-workflow.nika.yaml
+
+# Statically check a workflow (exit 0 = clean, 2 = findings):
+nika check my-workflow.nika.yaml
+
+# Generate the tightest permits: block (default-deny once present):
+nika check --infer-permits my-workflow.nika.yaml
+
+# Explain a diagnostic code:
+nika explain NIKA-SEC-004
+
+# Run a workflow with a variable and a hard cost cap:
+nika run my-workflow.nika.yaml --var topic=rust --max-cost-usd 2
+
+# Narrate what a workflow does (waves, cost, touches) before running it:
+nika explain my-workflow.nika.yaml
+
+# Show the anatomy of a workflow (tasks, waves, cost floor):
+nika inspect my-workflow.nika.yaml
+
+# List providers and models this machine can run:
+nika catalog
+
+# List the built-in nika:* tools an invoke task can reach:
+nika tools
+
+# Check provider keys, PATH and local model servers:
+nika doctor
+
+# Verify the hash chain of the latest run's trace:
+nika trace verify
+
+# Read the latest trace as a human card:
+nika trace show
+
+# Pin a workflow's offline behavior as a golden test, then replay it:
+nika test my-workflow.nika.yaml --update
+nika test my-workflow.nika.yaml
+
+# Serve the read-only MCP oracle over stdio (for agent clients):
+nika mcp