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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (31) hide show
  1. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/PKG-INFO +68 -54
  2. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/README.md +67 -53
  3. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/pyproject.toml +2 -2
  4. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive_modules.egg-info/PKG-INFO +68 -54
  5. cognitive_modules-2.2.1/src/cognitive_modules.egg-info/entry_points.txt +2 -0
  6. cognitive_modules-2.2.0/src/cognitive_modules.egg-info/entry_points.txt +0 -2
  7. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/LICENSE +0 -0
  8. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/setup.cfg +0 -0
  9. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive/__init__.py +0 -0
  10. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive/cli.py +0 -0
  11. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive/loader.py +0 -0
  12. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive/mcp_server.py +0 -0
  13. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive/migrate.py +0 -0
  14. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive/providers/__init__.py +0 -0
  15. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive/registry.py +0 -0
  16. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive/runner.py +0 -0
  17. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive/server.py +0 -0
  18. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive/subagent.py +0 -0
  19. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive/templates.py +0 -0
  20. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive/validator.py +0 -0
  21. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive_modules.egg-info/SOURCES.txt +0 -0
  22. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive_modules.egg-info/dependency_links.txt +0 -0
  23. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive_modules.egg-info/requires.txt +0 -0
  24. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive_modules.egg-info/top_level.txt +0 -0
  25. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/tests/test_cli.py +0 -0
  26. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/tests/test_loader.py +0 -0
  27. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/tests/test_migrate.py +0 -0
  28. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/tests/test_registry.py +0 -0
  29. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/tests/test_runner.py +0 -0
  30. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/tests/test_subagent.py +0 -0
  31. {cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/tests/test_validator.py +0 -0
{cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: cognitive-modules
3
- Version: 2.2.0
3
+ Version: 2.2.1
4
4
  Summary: Structured LLM task runner with schema validation, confidence scoring, and subagent orchestration
5
5
  Author: ziel-io
6
6
  License: MIT
@@ -88,7 +88,24 @@ Cognitive Modules is an AI task definition specification designed for generation
88
88
  - **Subagent Orchestration** - `@call:module` supports inter-module calls
89
89
  - **Parameter Passing** - `$ARGUMENTS` runtime substitution
90
90
  - **Multi-LLM Support** - OpenAI / Anthropic / MiniMax / Ollama
91
- - **Public Registry** - `cogn install registry:module-name`
91
+ - **Public Registry** - `cog install registry:module-name`
92
+
93
+ ## Version Selection
94
+
95
+ | Version | Spec | npm | PyPI | Status |
96
+ |---------|------|-----|------|--------|
97
+ | **v2.2** | v2.2 | `2.2.0` | `2.2.0` | ✅ Stable (recommended) |
98
+ | **v2.5** | v2.5 | `2.5.0-beta.x` | `2.5.0bx` | 🧪 Beta (streaming + multimodal) |
99
+
100
+ ```bash
101
+ # Install stable v2.2
102
+ npm install cognitive-modules-cli@2.2.0
103
+ pip install cognitive-modules==2.2.0
104
+
105
+ # Install beta v2.5 (streaming + multimodal)
106
+ npm install cognitive-modules-cli@beta
107
+ pip install cognitive-modules==2.5.0b1
108
+ ```
92
109
 
93
110
  ## Installation
94
111
 
@@ -96,30 +113,27 @@ Cognitive Modules is an AI task definition specification designed for generation
96
113
 
97
114
  ```bash
98
115
  # Zero-install quick start (recommended)
99
- npx cogn run code-reviewer --args "your code"
116
+ npx cognitive-modules-cli@2.2.0 run code-reviewer --args "your code"
100
117
 
101
118
  # Global installation
102
- npm install -g cogn
103
-
104
- # Or install with full package name
105
- npm install -g cognitive-modules-cli
119
+ npm install -g cognitive-modules-cli@2.2.0
106
120
  ```
107
121
 
108
122
  ### Python (pip)
109
123
 
110
124
  ```bash
111
- pip install cognitive-modules
125
+ pip install cognitive-modules==2.2.0
112
126
 
113
127
  # With LLM support
114
- pip install cognitive-modules[openai] # OpenAI
115
- pip install cognitive-modules[anthropic] # Claude
116
- pip install cognitive-modules[all] # All providers
128
+ pip install "cognitive-modules[openai]==2.2.0" # OpenAI
129
+ pip install "cognitive-modules[anthropic]==2.2.0" # Claude
130
+ pip install "cognitive-modules[all]==2.2.0" # All providers
117
131
  ```
118
132
 
119
133
  | Platform | Package | Command | Features |
120
134
  |----------|---------|---------|----------|
121
- | **npm** | `cogn` | `cog` | ✅ Recommended, zero-install, full features |
122
- | pip | `cognitive-modules` | `cogn` | ✅ Full features |
135
+ | **npm** | `cognitive-modules-cli` | `cog` | ✅ Recommended, zero-install, full features |
136
+ | pip | `cognitive-modules` | `cog` | ✅ Full features |
123
137
 
124
138
  ## Quick Start
125
139
 
@@ -129,7 +143,7 @@ export LLM_PROVIDER=openai
129
143
  export OPENAI_API_KEY=sk-xxx
130
144
 
131
145
  # Run code review (npm)
132
- npx cogn run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
146
+ npx cognitive-modules-cli run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
133
147
 
134
148
  # Or use globally installed cog command
135
149
  cog run code-reviewer --args "..." --pretty
@@ -195,70 +209,70 @@ All modules now return the unified v2.2 envelope format:
195
209
  | **Risk Aggregation** | `meta.risk = max(changes[*].risk)` |
196
210
  | **Parameter Passing** | `$ARGUMENTS` runtime substitution |
197
211
  | **Subagents** | `@call:module` for inter-module calls |
198
- | **Validation Tools** | `cogn validate` / `cogn validate --v22` |
212
+ | **Validation Tools** | `cog validate` / `cog validate --v22` |
199
213
 
200
214
  ## Integration Methods
201
215
 
202
216
  | Method | Command | Use Case |
203
217
  |--------|---------|----------|
204
- | CLI | `cogn run` | Command line |
205
- | HTTP API | `cogn serve` | n8n, Coze, Dify |
206
- | MCP Server | `cogn mcp` | Claude, Cursor |
218
+ | CLI | `cog run` | Command line |
219
+ | HTTP API | `cog serve` | n8n, Coze, Dify |
220
+ | MCP Server | `cog mcp` | Claude, Cursor |
207
221
 
208
222
  ## CLI Commands
209
223
 
210
224
  ```bash
211
225
  # Module management
212
- cogn list # List installed modules
213
- cogn info <module> # View module details
214
- cogn validate <module> # Validate module structure
215
- cogn validate <module> --v22 # Validate v2.2 format
226
+ cog list # List installed modules
227
+ cog info <module> # View module details
228
+ cog validate <module> # Validate module structure
229
+ cog validate <module> --v22 # Validate v2.2 format
216
230
 
217
231
  # Run modules
218
- cogn run <module> input.json -o output.json --pretty
219
- cogn run <module> --args "requirements" --pretty
220
- cogn run <module> --args "requirements" --subagent # Enable subagent
232
+ cog run <module> input.json -o output.json --pretty
233
+ cog run <module> --args "requirements" --pretty
234
+ cog run <module> --args "requirements" --subagent # Enable subagent
221
235
 
222
236
  # Create modules
223
- cogn init <name> -d "description"
224
- cogn init <name> --format v22 # Create v2.2 format module
237
+ cog init <name> -d "description"
238
+ cog init <name> --format v22 # Create v2.2 format module
225
239
 
226
240
  # Migrate modules
227
- cogn migrate <module> # Migrate v1/v2.1 module to v2.2
241
+ cog migrate <module> # Migrate v1/v2.1 module to v2.2
228
242
 
229
243
  # Install from GitHub (recommended)
230
- cogn add ziel-io/cognitive-modules -m code-simplifier
231
- cogn add org/repo -m module-name --tag v1.0.0 # Install specific version
232
- cogn remove <module> # Remove module
244
+ cog add ziel-io/cognitive-modules -m code-simplifier
245
+ cog add org/repo -m module-name --tag v1.0.0 # Install specific version
246
+ cog remove <module> # Remove module
233
247
 
234
248
  # Version management
235
- cogn update <module> # Update to latest version
236
- cogn update <module> --tag v2.0.0 # Update to specific version
237
- cogn versions <url> # View available versions
249
+ cog update <module> # Update to latest version
250
+ cog update <module> --tag v2.0.0 # Update to specific version
251
+ cog versions <url> # View available versions
238
252
 
239
253
  # Other installation methods
240
- cogn install github:user/repo/path
241
- cogn install registry:module-name
242
- cogn uninstall <module>
254
+ cog install github:user/repo/path
255
+ cog install registry:module-name
256
+ cog uninstall <module>
243
257
 
244
258
  # Registry
245
- cogn registry # View public modules
246
- cogn search <query> # Search modules
259
+ cog registry # View public modules
260
+ cog search <query> # Search modules
247
261
 
248
262
  # Environment check
249
- cogn doctor
263
+ cog doctor
250
264
  ```
251
265
 
252
266
  ## Built-in Modules
253
267
 
254
268
  | Module | Tier | Function | Example |
255
269
  |--------|------|----------|---------|
256
- | `code-reviewer` | decision | Code review | `cogn run code-reviewer --args "your code"` |
257
- | `code-simplifier` | decision | Code simplification | `cogn run code-simplifier --args "complex code"` |
258
- | `task-prioritizer` | decision | Task priority sorting | `cogn run task-prioritizer --args "task1,task2"` |
259
- | `api-designer` | decision | REST API design | `cogn run api-designer --args "order system"` |
260
- | `ui-spec-generator` | exploration | UI spec generation | `cogn run ui-spec-generator --args "e-commerce homepage"` |
261
- | `product-analyzer` | exploration | Product analysis (subagent) | `cogn run product-analyzer --args "health product" -s` |
270
+ | `code-reviewer` | decision | Code review | `cog run code-reviewer --args "your code"` |
271
+ | `code-simplifier` | decision | Code simplification | `cog run code-simplifier --args "complex code"` |
272
+ | `task-prioritizer` | decision | Task priority sorting | `cog run task-prioritizer --args "task1,task2"` |
273
+ | `api-designer` | decision | REST API design | `cog run api-designer --args "order system"` |
274
+ | `ui-spec-generator` | exploration | UI spec generation | `cog run ui-spec-generator --args "e-commerce homepage"` |
275
+ | `product-analyzer` | exploration | Product analysis (subagent) | `cog run product-analyzer --args "health product" -s` |
262
276
 
263
277
  ## Module Format
264
278
 
@@ -370,7 +384,7 @@ export MINIMAX_API_KEY=sk-xxx
370
384
  export LLM_PROVIDER=ollama
371
385
 
372
386
  # Check configuration
373
- cogn doctor
387
+ cog doctor
374
388
  ```
375
389
 
376
390
  ## Migrating to v2.2
@@ -379,13 +393,13 @@ Migrate from v1 or v2.1 modules to v2.2:
379
393
 
380
394
  ```bash
381
395
  # Auto-migrate single module
382
- cogn migrate code-reviewer
396
+ cog migrate code-reviewer
383
397
 
384
398
  # Migrate all modules
385
- cogn migrate --all
399
+ cog migrate --all
386
400
 
387
401
  # Verify migration result
388
- cogn validate code-reviewer --v22
402
+ cog validate code-reviewer --v22
389
403
  ```
390
404
 
391
405
  Manual migration steps:
@@ -408,8 +422,8 @@ pip install -e ".[dev]"
408
422
  pytest tests/ -v
409
423
 
410
424
  # Create new module (v2.2 format)
411
- cogn init my-module -d "module description" --format v22
412
- cogn validate my-module --v22
425
+ cog init my-module -d "module description" --format v22
426
+ cog validate my-module --v22
413
427
  ```
414
428
 
415
429
  ## Project Structure
@@ -443,8 +457,8 @@ cognitive-modules/
443
457
 
444
458
  | Platform | Package | Command | Installation |
445
459
  |----------|---------|---------|--------------|
446
- | Python | `cognitive-modules` | `cogn` | `pip install cognitive-modules` |
447
- | Node.js | `cogn` or `cognitive-modules-cli` | `cog` | `npm install -g cogn` or `npx cogn` |
460
+ | Python | `cognitive-modules` | `cog` | `pip install cognitive-modules` |
461
+ | Node.js | `cognitive-modules-cli` | `cog` | `npm install -g cognitive-modules-cli` |
448
462
 
449
463
  Both versions share the same module format and v2.2 specification.
450
464
 
{cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/README.md RENAMED
@@ -30,7 +30,24 @@ Cognitive Modules is an AI task definition specification designed for generation
30
30
  - **Subagent Orchestration** - `@call:module` supports inter-module calls
31
31
  - **Parameter Passing** - `$ARGUMENTS` runtime substitution
32
32
  - **Multi-LLM Support** - OpenAI / Anthropic / MiniMax / Ollama
33
- - **Public Registry** - `cogn install registry:module-name`
33
+ - **Public Registry** - `cog install registry:module-name`
34
+
35
+ ## Version Selection
36
+
37
+ | Version | Spec | npm | PyPI | Status |
38
+ |---------|------|-----|------|--------|
39
+ | **v2.2** | v2.2 | `2.2.0` | `2.2.0` | ✅ Stable (recommended) |
40
+ | **v2.5** | v2.5 | `2.5.0-beta.x` | `2.5.0bx` | 🧪 Beta (streaming + multimodal) |
41
+
42
+ ```bash
43
+ # Install stable v2.2
44
+ npm install cognitive-modules-cli@2.2.0
45
+ pip install cognitive-modules==2.2.0
46
+
47
+ # Install beta v2.5 (streaming + multimodal)
48
+ npm install cognitive-modules-cli@beta
49
+ pip install cognitive-modules==2.5.0b1
50
+ ```
34
51
 
35
52
  ## Installation
36
53
 
@@ -38,30 +55,27 @@ Cognitive Modules is an AI task definition specification designed for generation
38
55
 
39
56
  ```bash
40
57
  # Zero-install quick start (recommended)
41
- npx cogn run code-reviewer --args "your code"
58
+ npx cognitive-modules-cli@2.2.0 run code-reviewer --args "your code"
42
59
 
43
60
  # Global installation
44
- npm install -g cogn
45
-
46
- # Or install with full package name
47
- npm install -g cognitive-modules-cli
61
+ npm install -g cognitive-modules-cli@2.2.0
48
62
  ```
49
63
 
50
64
  ### Python (pip)
51
65
 
52
66
  ```bash
53
- pip install cognitive-modules
67
+ pip install cognitive-modules==2.2.0
54
68
 
55
69
  # With LLM support
56
- pip install cognitive-modules[openai] # OpenAI
57
- pip install cognitive-modules[anthropic] # Claude
58
- pip install cognitive-modules[all] # All providers
70
+ pip install "cognitive-modules[openai]==2.2.0" # OpenAI
71
+ pip install "cognitive-modules[anthropic]==2.2.0" # Claude
72
+ pip install "cognitive-modules[all]==2.2.0" # All providers
59
73
  ```
60
74
 
61
75
  | Platform | Package | Command | Features |
62
76
  |----------|---------|---------|----------|
63
- | **npm** | `cogn` | `cog` | ✅ Recommended, zero-install, full features |
64
- | pip | `cognitive-modules` | `cogn` | ✅ Full features |
77
+ | **npm** | `cognitive-modules-cli` | `cog` | ✅ Recommended, zero-install, full features |
78
+ | pip | `cognitive-modules` | `cog` | ✅ Full features |
65
79
 
66
80
  ## Quick Start
67
81
 
@@ -71,7 +85,7 @@ export LLM_PROVIDER=openai
71
85
  export OPENAI_API_KEY=sk-xxx
72
86
 
73
87
  # Run code review (npm)
74
- npx cogn run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
88
+ npx cognitive-modules-cli run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
75
89
 
76
90
  # Or use globally installed cog command
77
91
  cog run code-reviewer --args "..." --pretty
@@ -137,70 +151,70 @@ All modules now return the unified v2.2 envelope format:
137
151
  | **Risk Aggregation** | `meta.risk = max(changes[*].risk)` |
138
152
  | **Parameter Passing** | `$ARGUMENTS` runtime substitution |
139
153
  | **Subagents** | `@call:module` for inter-module calls |
140
- | **Validation Tools** | `cogn validate` / `cogn validate --v22` |
154
+ | **Validation Tools** | `cog validate` / `cog validate --v22` |
141
155
 
142
156
  ## Integration Methods
143
157
 
144
158
  | Method | Command | Use Case |
145
159
  |--------|---------|----------|
146
- | CLI | `cogn run` | Command line |
147
- | HTTP API | `cogn serve` | n8n, Coze, Dify |
148
- | MCP Server | `cogn mcp` | Claude, Cursor |
160
+ | CLI | `cog run` | Command line |
161
+ | HTTP API | `cog serve` | n8n, Coze, Dify |
162
+ | MCP Server | `cog mcp` | Claude, Cursor |
149
163
 
150
164
  ## CLI Commands
151
165
 
152
166
  ```bash
153
167
  # Module management
154
- cogn list # List installed modules
155
- cogn info <module> # View module details
156
- cogn validate <module> # Validate module structure
157
- cogn validate <module> --v22 # Validate v2.2 format
168
+ cog list # List installed modules
169
+ cog info <module> # View module details
170
+ cog validate <module> # Validate module structure
171
+ cog validate <module> --v22 # Validate v2.2 format
158
172
 
159
173
  # Run modules
160
- cogn run <module> input.json -o output.json --pretty
161
- cogn run <module> --args "requirements" --pretty
162
- cogn run <module> --args "requirements" --subagent # Enable subagent
174
+ cog run <module> input.json -o output.json --pretty
175
+ cog run <module> --args "requirements" --pretty
176
+ cog run <module> --args "requirements" --subagent # Enable subagent
163
177
 
164
178
  # Create modules
165
- cogn init <name> -d "description"
166
- cogn init <name> --format v22 # Create v2.2 format module
179
+ cog init <name> -d "description"
180
+ cog init <name> --format v22 # Create v2.2 format module
167
181
 
168
182
  # Migrate modules
169
- cogn migrate <module> # Migrate v1/v2.1 module to v2.2
183
+ cog migrate <module> # Migrate v1/v2.1 module to v2.2
170
184
 
171
185
  # Install from GitHub (recommended)
172
- cogn add ziel-io/cognitive-modules -m code-simplifier
173
- cogn add org/repo -m module-name --tag v1.0.0 # Install specific version
174
- cogn remove <module> # Remove module
186
+ cog add ziel-io/cognitive-modules -m code-simplifier
187
+ cog add org/repo -m module-name --tag v1.0.0 # Install specific version
188
+ cog remove <module> # Remove module
175
189
 
176
190
  # Version management
177
- cogn update <module> # Update to latest version
178
- cogn update <module> --tag v2.0.0 # Update to specific version
179
- cogn versions <url> # View available versions
191
+ cog update <module> # Update to latest version
192
+ cog update <module> --tag v2.0.0 # Update to specific version
193
+ cog versions <url> # View available versions
180
194
 
181
195
  # Other installation methods
182
- cogn install github:user/repo/path
183
- cogn install registry:module-name
184
- cogn uninstall <module>
196
+ cog install github:user/repo/path
197
+ cog install registry:module-name
198
+ cog uninstall <module>
185
199
 
186
200
  # Registry
187
- cogn registry # View public modules
188
- cogn search <query> # Search modules
201
+ cog registry # View public modules
202
+ cog search <query> # Search modules
189
203
 
190
204
  # Environment check
191
- cogn doctor
205
+ cog doctor
192
206
  ```
193
207
 
194
208
  ## Built-in Modules
195
209
 
196
210
  | Module | Tier | Function | Example |
197
211
  |--------|------|----------|---------|
198
- | `code-reviewer` | decision | Code review | `cogn run code-reviewer --args "your code"` |
199
- | `code-simplifier` | decision | Code simplification | `cogn run code-simplifier --args "complex code"` |
200
- | `task-prioritizer` | decision | Task priority sorting | `cogn run task-prioritizer --args "task1,task2"` |
201
- | `api-designer` | decision | REST API design | `cogn run api-designer --args "order system"` |
202
- | `ui-spec-generator` | exploration | UI spec generation | `cogn run ui-spec-generator --args "e-commerce homepage"` |
203
- | `product-analyzer` | exploration | Product analysis (subagent) | `cogn run product-analyzer --args "health product" -s` |
212
+ | `code-reviewer` | decision | Code review | `cog run code-reviewer --args "your code"` |
213
+ | `code-simplifier` | decision | Code simplification | `cog run code-simplifier --args "complex code"` |
214
+ | `task-prioritizer` | decision | Task priority sorting | `cog run task-prioritizer --args "task1,task2"` |
215
+ | `api-designer` | decision | REST API design | `cog run api-designer --args "order system"` |
216
+ | `ui-spec-generator` | exploration | UI spec generation | `cog run ui-spec-generator --args "e-commerce homepage"` |
217
+ | `product-analyzer` | exploration | Product analysis (subagent) | `cog run product-analyzer --args "health product" -s` |
204
218
 
205
219
  ## Module Format
206
220
 
@@ -312,7 +326,7 @@ export MINIMAX_API_KEY=sk-xxx
312
326
  export LLM_PROVIDER=ollama
313
327
 
314
328
  # Check configuration
315
- cogn doctor
329
+ cog doctor
316
330
  ```
317
331
 
318
332
  ## Migrating to v2.2
@@ -321,13 +335,13 @@ Migrate from v1 or v2.1 modules to v2.2:
321
335
 
322
336
  ```bash
323
337
  # Auto-migrate single module
324
- cogn migrate code-reviewer
338
+ cog migrate code-reviewer
325
339
 
326
340
  # Migrate all modules
327
- cogn migrate --all
341
+ cog migrate --all
328
342
 
329
343
  # Verify migration result
330
- cogn validate code-reviewer --v22
344
+ cog validate code-reviewer --v22
331
345
  ```
332
346
 
333
347
  Manual migration steps:
@@ -350,8 +364,8 @@ pip install -e ".[dev]"
350
364
  pytest tests/ -v
351
365
 
352
366
  # Create new module (v2.2 format)
353
- cogn init my-module -d "module description" --format v22
354
- cogn validate my-module --v22
367
+ cog init my-module -d "module description" --format v22
368
+ cog validate my-module --v22
355
369
  ```
356
370
 
357
371
  ## Project Structure
@@ -385,8 +399,8 @@ cognitive-modules/
385
399
 
386
400
  | Platform | Package | Command | Installation |
387
401
  |----------|---------|---------|--------------|
388
- | Python | `cognitive-modules` | `cogn` | `pip install cognitive-modules` |
389
- | Node.js | `cogn` or `cognitive-modules-cli` | `cog` | `npm install -g cogn` or `npx cogn` |
402
+ | Python | `cognitive-modules` | `cog` | `pip install cognitive-modules` |
403
+ | Node.js | `cognitive-modules-cli` | `cog` | `npm install -g cognitive-modules-cli` |
390
404
 
391
405
  Both versions share the same module format and v2.2 specification.
392
406
 
{cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/pyproject.toml RENAMED
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "cognitive-modules"
7
- version = "2.2.0"
7
+ version = "2.2.1"
8
8
  description = "Structured LLM task runner with schema validation, confidence scoring, and subagent orchestration"
9
9
  readme = "README.md"
10
10
  license = {text = "MIT"}
@@ -76,7 +76,7 @@ docs = [
76
76
  ]
77
77
 
78
78
  [project.scripts]
79
- cogn = "cognitive.cli:app"
79
+ cog = "cognitive.cli:app"
80
80
 
81
81
  [project.urls]
82
82
  Homepage = "https://github.com/ziel-io/cognitive-modules"
{cognitive_modules-2.2.0 → cognitive_modules-2.2.1}/src/cognitive_modules.egg-info/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: cognitive-modules
3
- Version: 2.2.0
3
+ Version: 2.2.1
4
4
  Summary: Structured LLM task runner with schema validation, confidence scoring, and subagent orchestration
5
5
  Author: ziel-io
6
6
  License: MIT
@@ -88,7 +88,24 @@ Cognitive Modules is an AI task definition specification designed for generation
88
88
  - **Subagent Orchestration** - `@call:module` supports inter-module calls
89
89
  - **Parameter Passing** - `$ARGUMENTS` runtime substitution
90
90
  - **Multi-LLM Support** - OpenAI / Anthropic / MiniMax / Ollama
91
- - **Public Registry** - `cogn install registry:module-name`
91
+ - **Public Registry** - `cog install registry:module-name`
92
+
93
+ ## Version Selection
94
+
95
+ | Version | Spec | npm | PyPI | Status |
96
+ |---------|------|-----|------|--------|
97
+ | **v2.2** | v2.2 | `2.2.0` | `2.2.0` | ✅ Stable (recommended) |
98
+ | **v2.5** | v2.5 | `2.5.0-beta.x` | `2.5.0bx` | 🧪 Beta (streaming + multimodal) |
99
+
100
+ ```bash
101
+ # Install stable v2.2
102
+ npm install cognitive-modules-cli@2.2.0
103
+ pip install cognitive-modules==2.2.0
104
+
105
+ # Install beta v2.5 (streaming + multimodal)
106
+ npm install cognitive-modules-cli@beta
107
+ pip install cognitive-modules==2.5.0b1
108
+ ```
92
109
 
93
110
  ## Installation
94
111
 
@@ -96,30 +113,27 @@ Cognitive Modules is an AI task definition specification designed for generation
96
113
 
97
114
  ```bash
98
115
  # Zero-install quick start (recommended)
99
- npx cogn run code-reviewer --args "your code"
116
+ npx cognitive-modules-cli@2.2.0 run code-reviewer --args "your code"
100
117
 
101
118
  # Global installation
102
- npm install -g cogn
103
-
104
- # Or install with full package name
105
- npm install -g cognitive-modules-cli
119
+ npm install -g cognitive-modules-cli@2.2.0
106
120
  ```
107
121
 
108
122
  ### Python (pip)
109
123
 
110
124
  ```bash
111
- pip install cognitive-modules
125
+ pip install cognitive-modules==2.2.0
112
126
 
113
127
  # With LLM support
114
- pip install cognitive-modules[openai] # OpenAI
115
- pip install cognitive-modules[anthropic] # Claude
116
- pip install cognitive-modules[all] # All providers
128
+ pip install "cognitive-modules[openai]==2.2.0" # OpenAI
129
+ pip install "cognitive-modules[anthropic]==2.2.0" # Claude
130
+ pip install "cognitive-modules[all]==2.2.0" # All providers
117
131
  ```
118
132
 
119
133
  | Platform | Package | Command | Features |
120
134
  |----------|---------|---------|----------|
121
- | **npm** | `cogn` | `cog` | ✅ Recommended, zero-install, full features |
122
- | pip | `cognitive-modules` | `cogn` | ✅ Full features |
135
+ | **npm** | `cognitive-modules-cli` | `cog` | ✅ Recommended, zero-install, full features |
136
+ | pip | `cognitive-modules` | `cog` | ✅ Full features |
123
137
 
124
138
  ## Quick Start
125
139
 
@@ -129,7 +143,7 @@ export LLM_PROVIDER=openai
129
143
  export OPENAI_API_KEY=sk-xxx
130
144
 
131
145
  # Run code review (npm)
132
- npx cogn run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
146
+ npx cognitive-modules-cli run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
133
147
 
134
148
  # Or use globally installed cog command
135
149
  cog run code-reviewer --args "..." --pretty
@@ -195,70 +209,70 @@ All modules now return the unified v2.2 envelope format:
195
209
  | **Risk Aggregation** | `meta.risk = max(changes[*].risk)` |
196
210
  | **Parameter Passing** | `$ARGUMENTS` runtime substitution |
197
211
  | **Subagents** | `@call:module` for inter-module calls |
198
- | **Validation Tools** | `cogn validate` / `cogn validate --v22` |
212
+ | **Validation Tools** | `cog validate` / `cog validate --v22` |
199
213
 
200
214
  ## Integration Methods
201
215
 
202
216
  | Method | Command | Use Case |
203
217
  |--------|---------|----------|
204
- | CLI | `cogn run` | Command line |
205
- | HTTP API | `cogn serve` | n8n, Coze, Dify |
206
- | MCP Server | `cogn mcp` | Claude, Cursor |
218
+ | CLI | `cog run` | Command line |
219
+ | HTTP API | `cog serve` | n8n, Coze, Dify |
220
+ | MCP Server | `cog mcp` | Claude, Cursor |
207
221
 
208
222
  ## CLI Commands
209
223
 
210
224
  ```bash
211
225
  # Module management
212
- cogn list # List installed modules
213
- cogn info <module> # View module details
214
- cogn validate <module> # Validate module structure
215
- cogn validate <module> --v22 # Validate v2.2 format
226
+ cog list # List installed modules
227
+ cog info <module> # View module details
228
+ cog validate <module> # Validate module structure
229
+ cog validate <module> --v22 # Validate v2.2 format
216
230
 
217
231
  # Run modules
218
- cogn run <module> input.json -o output.json --pretty
219
- cogn run <module> --args "requirements" --pretty
220
- cogn run <module> --args "requirements" --subagent # Enable subagent
232
+ cog run <module> input.json -o output.json --pretty
233
+ cog run <module> --args "requirements" --pretty
234
+ cog run <module> --args "requirements" --subagent # Enable subagent
221
235
 
222
236
  # Create modules
223
- cogn init <name> -d "description"
224
- cogn init <name> --format v22 # Create v2.2 format module
237
+ cog init <name> -d "description"
238
+ cog init <name> --format v22 # Create v2.2 format module
225
239
 
226
240
  # Migrate modules
227
- cogn migrate <module> # Migrate v1/v2.1 module to v2.2
241
+ cog migrate <module> # Migrate v1/v2.1 module to v2.2
228
242
 
229
243
  # Install from GitHub (recommended)
230
- cogn add ziel-io/cognitive-modules -m code-simplifier
231
- cogn add org/repo -m module-name --tag v1.0.0 # Install specific version
232
- cogn remove <module> # Remove module
244
+ cog add ziel-io/cognitive-modules -m code-simplifier
245
+ cog add org/repo -m module-name --tag v1.0.0 # Install specific version
246
+ cog remove <module> # Remove module
233
247
 
234
248
  # Version management
235
- cogn update <module> # Update to latest version
236
- cogn update <module> --tag v2.0.0 # Update to specific version
237
- cogn versions <url> # View available versions
249
+ cog update <module> # Update to latest version
250
+ cog update <module> --tag v2.0.0 # Update to specific version
251
+ cog versions <url> # View available versions
238
252
 
239
253
  # Other installation methods
240
- cogn install github:user/repo/path
241
- cogn install registry:module-name
242
- cogn uninstall <module>
254
+ cog install github:user/repo/path
255
+ cog install registry:module-name
256
+ cog uninstall <module>
243
257
 
244
258
  # Registry
245
- cogn registry # View public modules
246
- cogn search <query> # Search modules
259
+ cog registry # View public modules
260
+ cog search <query> # Search modules
247
261
 
248
262
  # Environment check
249
- cogn doctor
263
+ cog doctor
250
264
  ```
251
265
 
252
266
  ## Built-in Modules
253
267
 
254
268
  | Module | Tier | Function | Example |
255
269
  |--------|------|----------|---------|
256
- | `code-reviewer` | decision | Code review | `cogn run code-reviewer --args "your code"` |
257
- | `code-simplifier` | decision | Code simplification | `cogn run code-simplifier --args "complex code"` |
258
- | `task-prioritizer` | decision | Task priority sorting | `cogn run task-prioritizer --args "task1,task2"` |
259
- | `api-designer` | decision | REST API design | `cogn run api-designer --args "order system"` |
260
- | `ui-spec-generator` | exploration | UI spec generation | `cogn run ui-spec-generator --args "e-commerce homepage"` |
261
- | `product-analyzer` | exploration | Product analysis (subagent) | `cogn run product-analyzer --args "health product" -s` |
270
+ | `code-reviewer` | decision | Code review | `cog run code-reviewer --args "your code"` |
271
+ | `code-simplifier` | decision | Code simplification | `cog run code-simplifier --args "complex code"` |
272
+ | `task-prioritizer` | decision | Task priority sorting | `cog run task-prioritizer --args "task1,task2"` |
273
+ | `api-designer` | decision | REST API design | `cog run api-designer --args "order system"` |
274
+ | `ui-spec-generator` | exploration | UI spec generation | `cog run ui-spec-generator --args "e-commerce homepage"` |
275
+ | `product-analyzer` | exploration | Product analysis (subagent) | `cog run product-analyzer --args "health product" -s` |
262
276
 
263
277
  ## Module Format
264
278
 
@@ -370,7 +384,7 @@ export MINIMAX_API_KEY=sk-xxx
370
384
  export LLM_PROVIDER=ollama
371
385
 
372
386
  # Check configuration
373
- cogn doctor
387
+ cog doctor
374
388
  ```
375
389
 
376
390
  ## Migrating to v2.2
@@ -379,13 +393,13 @@ Migrate from v1 or v2.1 modules to v2.2:
379
393
 
380
394
  ```bash
381
395
  # Auto-migrate single module
382
- cogn migrate code-reviewer
396
+ cog migrate code-reviewer
383
397
 
384
398
  # Migrate all modules
385
- cogn migrate --all
399
+ cog migrate --all
386
400
 
387
401
  # Verify migration result
388
- cogn validate code-reviewer --v22
402
+ cog validate code-reviewer --v22
389
403
  ```
390
404
 
391
405
  Manual migration steps:
@@ -408,8 +422,8 @@ pip install -e ".[dev]"
408
422
  pytest tests/ -v
409
423
 
410
424
  # Create new module (v2.2 format)
411
- cogn init my-module -d "module description" --format v22
412
- cogn validate my-module --v22
425
+ cog init my-module -d "module description" --format v22
426
+ cog validate my-module --v22
413
427
  ```
414
428
 
415
429
  ## Project Structure
@@ -443,8 +457,8 @@ cognitive-modules/
443
457
 
444
458
  | Platform | Package | Command | Installation |
445
459
  |----------|---------|---------|--------------|
446
- | Python | `cognitive-modules` | `cogn` | `pip install cognitive-modules` |
447
- | Node.js | `cogn` or `cognitive-modules-cli` | `cog` | `npm install -g cogn` or `npx cogn` |
460
+ | Python | `cognitive-modules` | `cog` | `pip install cognitive-modules` |
461
+ | Node.js | `cognitive-modules-cli` | `cog` | `npm install -g cognitive-modules-cli` |
448
462
 
449
463
  Both versions share the same module format and v2.2 specification.
450
464
 
cognitive_modules-2.2.1/src/cognitive_modules.egg-info/entry_points.txt ADDED
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ cog = cognitive.cli:app
cognitive_modules-2.2.0/src/cognitive_modules.egg-info/entry_points.txt DELETED
@@ -1,2 +0,0 @@
1
- [console_scripts]
2
- cogn = cognitive.cli:app