cognitive-modules 2.2.0__tar.gz → 2.2.2__tar.gz

{cognitive_modules-2.2.0 → cognitive_modules-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cognitive-modules
-Version: 2.2.0
+Version: 2.2.2
 Summary: Structured LLM task runner with schema validation, confidence scoring, and subagent orchestration
 Author: ziel-io
 License: MIT
@@ -59,7 +59,10 @@ Dynamic: license-file
 # Cognitive Modules
 
 [![CI](https://github.com/ziel-io/cognitive-modules/actions/workflows/ci.yml/badge.svg)](https://github.com/ziel-io/cognitive-modules/actions/workflows/ci.yml)
-[![PyPI version](https://badge.fury.io/py/cognitive-modules.svg)](https://pypi.org/project/cognitive-modules/)
+[![npm version](https://img.shields.io/npm/v/cognitive-modules-cli.svg)](https://www.npmjs.com/package/cognitive-modules-cli)
+[![PyPI version](https://img.shields.io/pypi/v/cognitive-modules.svg)](https://pypi.org/project/cognitive-modules/)
+[![npm downloads](https://img.shields.io/npm/dm/cognitive-modules-cli.svg)](https://www.npmjs.com/package/cognitive-modules-cli)
+[![Node.js 18+](https://img.shields.io/badge/node-18+-green.svg)](https://nodejs.org/)
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
@@ -88,7 +91,24 @@ Cognitive Modules is an AI task definition specification designed for generation
 - **Subagent Orchestration** - `@call:module` supports inter-module calls
 - **Parameter Passing** - `$ARGUMENTS` runtime substitution
 - **Multi-LLM Support** - OpenAI / Anthropic / MiniMax / Ollama
-- **Public Registry** - `cogn install registry:module-name`
+- **Public Registry** - `cog install registry:module-name`
+
+## Version Selection
+
+| Version | Spec | npm | PyPI | Status |
+|---------|------|-----|------|--------|
+| **v2.2** | v2.2 | `2.2.0` | `2.2.1` | ✅ Stable (recommended) |
+| **v2.5** | v2.5 | `2.5.0-beta.x` | `2.5.0bx` | 🧪 Beta (streaming + multimodal) |
+
+```bash
+# Install stable v2.2
+npm install cognitive-modules-cli@2.2.0
+pip install cognitive-modules==2.2.1
+
+# Install beta v2.5 (streaming + multimodal)
+npm install cognitive-modules-cli@beta
+pip install cognitive-modules==2.5.0b1
+```
 
 ## Installation
 
@@ -96,30 +116,27 @@ Cognitive Modules is an AI task definition specification designed for generation
 
 ```bash
 # Zero-install quick start (recommended)
-npx cogn run code-reviewer --args "your code"
+npx cognitive-modules-cli@2.2.0 run code-reviewer --args "your code"
 
 # Global installation
-npm install -g cogn
-
-# Or install with full package name
-npm install -g cognitive-modules-cli
+npm install -g cognitive-modules-cli@2.2.0
 ```
 
 ### Python (pip)
 
 ```bash
-pip install cognitive-modules
+pip install cognitive-modules==2.2.1
 
 # With LLM support
-pip install cognitive-modules[openai]      # OpenAI
-pip install cognitive-modules[anthropic]   # Claude
-pip install cognitive-modules[all]         # All providers
+pip install "cognitive-modules[openai]==2.2.1"      # OpenAI
+pip install "cognitive-modules[anthropic]==2.2.1"   # Claude
+pip install "cognitive-modules[all]==2.2.1"         # All providers
 ```
 
 | Platform | Package | Command | Features |
 |----------|---------|---------|----------|
-| **npm** | `cogn` | `cog` | ✅ Recommended, zero-install, full features |
-| pip | `cognitive-modules` | `cogn` | ✅ Full features |
+| **npm** | `cognitive-modules-cli` | `cog` | ✅ Recommended, zero-install, full features |
+| pip | `cognitive-modules` | `cog` | ✅ Full features |
 
 ## Quick Start
 
@@ -129,7 +146,7 @@ export LLM_PROVIDER=openai
 export OPENAI_API_KEY=sk-xxx
 
 # Run code review (npm)
-npx cogn run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
+npx cognitive-modules-cli run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
 
 # Or use globally installed cog command
 cog run code-reviewer --args "..." --pretty
@@ -195,70 +212,70 @@ All modules now return the unified v2.2 envelope format:
 | **Risk Aggregation** | `meta.risk = max(changes[*].risk)` |
 | **Parameter Passing** | `$ARGUMENTS` runtime substitution |
 | **Subagents** | `@call:module` for inter-module calls |
-| **Validation Tools** | `cogn validate` / `cogn validate --v22` |
+| **Validation Tools** | `cog validate` / `cog validate --v22` |
 
 ## Integration Methods
 
 | Method | Command | Use Case |
 |--------|---------|----------|
-| CLI | `cogn run` | Command line |
-| HTTP API | `cogn serve` | n8n, Coze, Dify |
-| MCP Server | `cogn mcp` | Claude, Cursor |
+| CLI | `cog run` | Command line |
+| HTTP API | `cog serve` | n8n, Coze, Dify |
+| MCP Server | `cog mcp` | Claude, Cursor |
 
 ## CLI Commands
 
 ```bash
 # Module management
-cogn list                    # List installed modules
-cogn info <module>           # View module details
-cogn validate <module>       # Validate module structure
-cogn validate <module> --v22 # Validate v2.2 format
+cog list                    # List installed modules
+cog info <module>           # View module details
+cog validate <module>       # Validate module structure
+cog validate <module> --v22 # Validate v2.2 format
 
 # Run modules
-cogn run <module> input.json -o output.json --pretty
-cogn run <module> --args "requirements" --pretty
-cogn run <module> --args "requirements" --subagent  # Enable subagent
+cog run <module> input.json -o output.json --pretty
+cog run <module> --args "requirements" --pretty
+cog run <module> --args "requirements" --subagent  # Enable subagent
 
 # Create modules
-cogn init <name> -d "description"
-cogn init <name> --format v22  # Create v2.2 format module
+cog init <name> -d "description"
+cog init <name> --format v22  # Create v2.2 format module
 
 # Migrate modules
-cogn migrate <module>        # Migrate v1/v2.1 module to v2.2
+cog migrate <module>        # Migrate v1/v2.1 module to v2.2
 
 # Install from GitHub (recommended)
-cogn add ziel-io/cognitive-modules -m code-simplifier
-cogn add org/repo -m module-name --tag v1.0.0   # Install specific version
-cogn remove <module>                             # Remove module
+cog add ziel-io/cognitive-modules -m code-simplifier
+cog add org/repo -m module-name --tag v1.0.0   # Install specific version
+cog remove <module>                             # Remove module
 
 # Version management
-cogn update <module>                 # Update to latest version
-cogn update <module> --tag v2.0.0    # Update to specific version
-cogn versions <url>                  # View available versions
+cog update <module>                 # Update to latest version
+cog update <module> --tag v2.0.0    # Update to specific version
+cog versions <url>                  # View available versions
 
 # Other installation methods
-cogn install github:user/repo/path
-cogn install registry:module-name
-cogn uninstall <module>
+cog install github:user/repo/path
+cog install registry:module-name
+cog uninstall <module>
 
 # Registry
-cogn registry                # View public modules
-cogn search <query>          # Search modules
+cog registry                # View public modules
+cog search <query>          # Search modules
 
 # Environment check
-cogn doctor
+cog doctor
 ```
 
 ## Built-in Modules
 
 | Module | Tier | Function | Example |
 |--------|------|----------|---------|
-| `code-reviewer` | decision | Code review | `cogn run code-reviewer --args "your code"` |
-| `code-simplifier` | decision | Code simplification | `cogn run code-simplifier --args "complex code"` |
-| `task-prioritizer` | decision | Task priority sorting | `cogn run task-prioritizer --args "task1,task2"` |
-| `api-designer` | decision | REST API design | `cogn run api-designer --args "order system"` |
-| `ui-spec-generator` | exploration | UI spec generation | `cogn run ui-spec-generator --args "e-commerce homepage"` |
-| `product-analyzer` | exploration | Product analysis (subagent) | `cogn run product-analyzer --args "health product" -s` |
+| `code-reviewer` | decision | Code review | `cog run code-reviewer --args "your code"` |
+| `code-simplifier` | decision | Code simplification | `cog run code-simplifier --args "complex code"` |
+| `task-prioritizer` | decision | Task priority sorting | `cog run task-prioritizer --args "task1,task2"` |
+| `api-designer` | decision | REST API design | `cog run api-designer --args "order system"` |
+| `ui-spec-generator` | exploration | UI spec generation | `cog run ui-spec-generator --args "e-commerce homepage"` |
+| `product-analyzer` | exploration | Product analysis (subagent) | `cog run product-analyzer --args "health product" -s` |
 
 ## Module Format
 
@@ -370,7 +387,7 @@ export MINIMAX_API_KEY=sk-xxx
 export LLM_PROVIDER=ollama
 
 # Check configuration
-cogn doctor
+cog doctor
 ```
 
 ## Migrating to v2.2
@@ -379,13 +396,13 @@ Migrate from v1 or v2.1 modules to v2.2:
 
 ```bash
 # Auto-migrate single module
-cogn migrate code-reviewer
+cog migrate code-reviewer
 
 # Migrate all modules
-cogn migrate --all
+cog migrate --all
 
 # Verify migration result
-cogn validate code-reviewer --v22
+cog validate code-reviewer --v22
 ```
 
 Manual migration steps:
@@ -408,8 +425,8 @@ pip install -e ".[dev]"
 pytest tests/ -v
 
 # Create new module (v2.2 format)
-cogn init my-module -d "module description" --format v22
-cogn validate my-module --v22
+cog init my-module -d "module description" --format v22
+cog validate my-module --v22
 ```
 
 ## Project Structure
@@ -443,8 +460,8 @@ cognitive-modules/
 
 | Platform | Package | Command | Installation |
 |----------|---------|---------|--------------|
-| Python | `cognitive-modules` | `cogn` | `pip install cognitive-modules` |
-| Node.js | `cogn` or `cognitive-modules-cli` | `cog` | `npm install -g cogn` or `npx cogn` |
+| Python | `cognitive-modules` | `cog` | `pip install cognitive-modules` |
+| Node.js | `cognitive-modules-cli` | `cog` | `npm install -g cognitive-modules-cli` |
 
 Both versions share the same module format and v2.2 specification.
 

{cognitive_modules-2.2.0 → cognitive_modules-2.2.2}/README.md

@@ -1,7 +1,10 @@
 # Cognitive Modules
 
 [![CI](https://github.com/ziel-io/cognitive-modules/actions/workflows/ci.yml/badge.svg)](https://github.com/ziel-io/cognitive-modules/actions/workflows/ci.yml)
-[![PyPI version](https://badge.fury.io/py/cognitive-modules.svg)](https://pypi.org/project/cognitive-modules/)
+[![npm version](https://img.shields.io/npm/v/cognitive-modules-cli.svg)](https://www.npmjs.com/package/cognitive-modules-cli)
+[![PyPI version](https://img.shields.io/pypi/v/cognitive-modules.svg)](https://pypi.org/project/cognitive-modules/)
+[![npm downloads](https://img.shields.io/npm/dm/cognitive-modules-cli.svg)](https://www.npmjs.com/package/cognitive-modules-cli)
+[![Node.js 18+](https://img.shields.io/badge/node-18+-green.svg)](https://nodejs.org/)
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
@@ -30,7 +33,24 @@ Cognitive Modules is an AI task definition specification designed for generation
 - **Subagent Orchestration** - `@call:module` supports inter-module calls
 - **Parameter Passing** - `$ARGUMENTS` runtime substitution
 - **Multi-LLM Support** - OpenAI / Anthropic / MiniMax / Ollama
-- **Public Registry** - `cogn install registry:module-name`
+- **Public Registry** - `cog install registry:module-name`
+
+## Version Selection
+
+| Version | Spec | npm | PyPI | Status |
+|---------|------|-----|------|--------|
+| **v2.2** | v2.2 | `2.2.0` | `2.2.1` | ✅ Stable (recommended) |
+| **v2.5** | v2.5 | `2.5.0-beta.x` | `2.5.0bx` | 🧪 Beta (streaming + multimodal) |
+
+```bash
+# Install stable v2.2
+npm install cognitive-modules-cli@2.2.0
+pip install cognitive-modules==2.2.1
+
+# Install beta v2.5 (streaming + multimodal)
+npm install cognitive-modules-cli@beta
+pip install cognitive-modules==2.5.0b1
+```
 
 ## Installation
 
@@ -38,30 +58,27 @@ Cognitive Modules is an AI task definition specification designed for generation
 
 ```bash
 # Zero-install quick start (recommended)
-npx cogn run code-reviewer --args "your code"
+npx cognitive-modules-cli@2.2.0 run code-reviewer --args "your code"
 
 # Global installation
-npm install -g cogn
-
-# Or install with full package name
-npm install -g cognitive-modules-cli
+npm install -g cognitive-modules-cli@2.2.0
 ```
 
 ### Python (pip)
 
 ```bash
-pip install cognitive-modules
+pip install cognitive-modules==2.2.1
 
 # With LLM support
-pip install cognitive-modules[openai]      # OpenAI
-pip install cognitive-modules[anthropic]   # Claude
-pip install cognitive-modules[all]         # All providers
+pip install "cognitive-modules[openai]==2.2.1"      # OpenAI
+pip install "cognitive-modules[anthropic]==2.2.1"   # Claude
+pip install "cognitive-modules[all]==2.2.1"         # All providers
 ```
 
 | Platform | Package | Command | Features |
 |----------|---------|---------|----------|
-| **npm** | `cogn` | `cog` | ✅ Recommended, zero-install, full features |
-| pip | `cognitive-modules` | `cogn` | ✅ Full features |
+| **npm** | `cognitive-modules-cli` | `cog` | ✅ Recommended, zero-install, full features |
+| pip | `cognitive-modules` | `cog` | ✅ Full features |
 
 ## Quick Start
 
@@ -71,7 +88,7 @@ export LLM_PROVIDER=openai
 export OPENAI_API_KEY=sk-xxx
 
 # Run code review (npm)
-npx cogn run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
+npx cognitive-modules-cli run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
 
 # Or use globally installed cog command
 cog run code-reviewer --args "..." --pretty
@@ -137,70 +154,70 @@ All modules now return the unified v2.2 envelope format:
 | **Risk Aggregation** | `meta.risk = max(changes[*].risk)` |
 | **Parameter Passing** | `$ARGUMENTS` runtime substitution |
 | **Subagents** | `@call:module` for inter-module calls |
-| **Validation Tools** | `cogn validate` / `cogn validate --v22` |
+| **Validation Tools** | `cog validate` / `cog validate --v22` |
 
 ## Integration Methods
 
 | Method | Command | Use Case |
 |--------|---------|----------|
-| CLI | `cogn run` | Command line |
-| HTTP API | `cogn serve` | n8n, Coze, Dify |
-| MCP Server | `cogn mcp` | Claude, Cursor |
+| CLI | `cog run` | Command line |
+| HTTP API | `cog serve` | n8n, Coze, Dify |
+| MCP Server | `cog mcp` | Claude, Cursor |
 
 ## CLI Commands
 
 ```bash
 # Module management
-cogn list                    # List installed modules
-cogn info <module>           # View module details
-cogn validate <module>       # Validate module structure
-cogn validate <module> --v22 # Validate v2.2 format
+cog list                    # List installed modules
+cog info <module>           # View module details
+cog validate <module>       # Validate module structure
+cog validate <module> --v22 # Validate v2.2 format
 
 # Run modules
-cogn run <module> input.json -o output.json --pretty
-cogn run <module> --args "requirements" --pretty
-cogn run <module> --args "requirements" --subagent  # Enable subagent
+cog run <module> input.json -o output.json --pretty
+cog run <module> --args "requirements" --pretty
+cog run <module> --args "requirements" --subagent  # Enable subagent
 
 # Create modules
-cogn init <name> -d "description"
-cogn init <name> --format v22  # Create v2.2 format module
+cog init <name> -d "description"
+cog init <name> --format v22  # Create v2.2 format module
 
 # Migrate modules
-cogn migrate <module>        # Migrate v1/v2.1 module to v2.2
+cog migrate <module>        # Migrate v1/v2.1 module to v2.2
 
 # Install from GitHub (recommended)
-cogn add ziel-io/cognitive-modules -m code-simplifier
-cogn add org/repo -m module-name --tag v1.0.0   # Install specific version
-cogn remove <module>                             # Remove module
+cog add ziel-io/cognitive-modules -m code-simplifier
+cog add org/repo -m module-name --tag v1.0.0   # Install specific version
+cog remove <module>                             # Remove module
 
 # Version management
-cogn update <module>                 # Update to latest version
-cogn update <module> --tag v2.0.0    # Update to specific version
-cogn versions <url>                  # View available versions
+cog update <module>                 # Update to latest version
+cog update <module> --tag v2.0.0    # Update to specific version
+cog versions <url>                  # View available versions
 
 # Other installation methods
-cogn install github:user/repo/path
-cogn install registry:module-name
-cogn uninstall <module>
+cog install github:user/repo/path
+cog install registry:module-name
+cog uninstall <module>
 
 # Registry
-cogn registry                # View public modules
-cogn search <query>          # Search modules
+cog registry                # View public modules
+cog search <query>          # Search modules
 
 # Environment check
-cogn doctor
+cog doctor
 ```
 
 ## Built-in Modules
 
 | Module | Tier | Function | Example |
 |--------|------|----------|---------|
-| `code-reviewer` | decision | Code review | `cogn run code-reviewer --args "your code"` |
-| `code-simplifier` | decision | Code simplification | `cogn run code-simplifier --args "complex code"` |
-| `task-prioritizer` | decision | Task priority sorting | `cogn run task-prioritizer --args "task1,task2"` |
-| `api-designer` | decision | REST API design | `cogn run api-designer --args "order system"` |
-| `ui-spec-generator` | exploration | UI spec generation | `cogn run ui-spec-generator --args "e-commerce homepage"` |
-| `product-analyzer` | exploration | Product analysis (subagent) | `cogn run product-analyzer --args "health product" -s` |
+| `code-reviewer` | decision | Code review | `cog run code-reviewer --args "your code"` |
+| `code-simplifier` | decision | Code simplification | `cog run code-simplifier --args "complex code"` |
+| `task-prioritizer` | decision | Task priority sorting | `cog run task-prioritizer --args "task1,task2"` |
+| `api-designer` | decision | REST API design | `cog run api-designer --args "order system"` |
+| `ui-spec-generator` | exploration | UI spec generation | `cog run ui-spec-generator --args "e-commerce homepage"` |
+| `product-analyzer` | exploration | Product analysis (subagent) | `cog run product-analyzer --args "health product" -s` |
 
 ## Module Format
 
@@ -312,7 +329,7 @@ export MINIMAX_API_KEY=sk-xxx
 export LLM_PROVIDER=ollama
 
 # Check configuration
-cogn doctor
+cog doctor
 ```
 
 ## Migrating to v2.2
@@ -321,13 +338,13 @@ Migrate from v1 or v2.1 modules to v2.2:
 
 ```bash
 # Auto-migrate single module
-cogn migrate code-reviewer
+cog migrate code-reviewer
 
 # Migrate all modules
-cogn migrate --all
+cog migrate --all
 
 # Verify migration result
-cogn validate code-reviewer --v22
+cog validate code-reviewer --v22
 ```
 
 Manual migration steps:
@@ -350,8 +367,8 @@ pip install -e ".[dev]"
 pytest tests/ -v
 
 # Create new module (v2.2 format)
-cogn init my-module -d "module description" --format v22
-cogn validate my-module --v22
+cog init my-module -d "module description" --format v22
+cog validate my-module --v22
 ```
 
 ## Project Structure
@@ -385,8 +402,8 @@ cognitive-modules/
 
 | Platform | Package | Command | Installation |
 |----------|---------|---------|--------------|
-| Python | `cognitive-modules` | `cogn` | `pip install cognitive-modules` |
-| Node.js | `cogn` or `cognitive-modules-cli` | `cog` | `npm install -g cogn` or `npx cogn` |
+| Python | `cognitive-modules` | `cog` | `pip install cognitive-modules` |
+| Node.js | `cognitive-modules-cli` | `cog` | `npm install -g cognitive-modules-cli` |
 
 Both versions share the same module format and v2.2 specification.
 

{cognitive_modules-2.2.0 → cognitive_modules-2.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cognitive-modules"
-version = "2.2.0"
+version = "2.2.2"
 description = "Structured LLM task runner with schema validation, confidence scoring, and subagent orchestration"
 readme = "README.md"
 license = {text = "MIT"}
@@ -76,7 +76,7 @@ docs = [
 ]
 
 [project.scripts]
-cogn = "cognitive.cli:app"
+cog = "cognitive.cli:app"
 
 [project.urls]
 Homepage = "https://github.com/ziel-io/cognitive-modules"

{cognitive_modules-2.2.0 → cognitive_modules-2.2.2}/src/cognitive/loader.py

@@ -184,16 +184,20 @@ def load_v2_format(module_path: Path) -> dict:
         "require_suggested_mapping": overflow_raw.get("require_suggested_mapping", True)
     }
     
-    enums = manifest.get("enums", {
+    # Merge enums with defaults (ensure defaults are applied even if partial config exists)
+    enums_defaults = {
         "strategy": "extensible" if tier in ("decision", "exploration") else "strict",
         "unknown_tag": "custom"
-    })
+    }
+    enums = {**enums_defaults, **manifest.get("enums", {})}
     
-    compat = manifest.get("compat", {
+    # Merge compat with defaults (ensure defaults are applied even if partial config exists)
+    compat_defaults = {
         "accepts_v21_payload": True,
         "runtime_auto_wrap": True,
         "schema_output_alias": "data"
-    })
+    }
+    compat = {**compat_defaults, **manifest.get("compat", {})}
     
     io_config = manifest.get("io", {})
     tests = manifest.get("tests", [])