ceddcozum 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# ceddcozum
+
+Pediatric clinical calculators from the terminal. 32 tools for growth, neonatal, bone mineral, diabetes, puberty, organ size, blood pressure, and more.
+
+All calculations run locally — no API keys, no network requests, no patient data transmitted.
+
+## Install
+
+```bash
+# Run directly (no install)
+npx ceddcozum --list
+
+# Or install globally
+npm install -g ceddcozum
+```
+
+## Usage
+
+```bash
+# Run a calculator
+ceddcozum auxology --args '{"sex":"male","age":5.5,"height":110,"weight":19}'
+
+# JSON output (for piping / LLM agents)
+ceddcozum auxology --args '{"sex":"male","age":5.5,"height":110}' --format json
+
+# View tool schema (OpenAI function format)
+ceddcozum auxology --schema
+
+# Export all schemas for LLM tool-calling
+ceddcozum --schemas
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `ceddcozum --list` | List all 32 available tools |
+| `ceddcozum <tool> --args '{...}'` | Run a calculator with JSON args |
+| `ceddcozum <tool> --schema` | Show tool schema (OpenAI format) |
+| `ceddcozum --schemas` | Dump all schemas |
+| `--format human` | Human-readable output (default) |
+| `--format json` | JSON `ToolResult[]` array |
+
+## LLM Agent Integration
+
+```bash
+# 1. Get schemas for your LLM system prompt
+ceddcozum --schemas > tools.json
+
+# 2. Agent decides to call a tool
+ceddcozum auxology --args '{"sex":"female","age":3,"height":92}' --format json
+
+# 3. Parse JSON array — each item has: label, value, unit?, sds?, percentile?
+```
+
+## ToolResult Schema
+
+```typescript
+interface ToolResult {
+  label: string       // Human-readable label
+  value: string       // Computed value
+  unit?: string       // Unit of measurement
+  sds?: number        // Standard deviation score
+  percentile?: number // Percentile (0-100)
+}
+```
+
+## License
+
+MIT