cognitive-modules 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

cognitive/loader.py

@@ -1,17 +1,22 @@
 """
-Module Loader - Load cognitive modules in both old and new formats.
+Module Loader - Load cognitive modules in all formats.
 
-Old format (6 files):
+Format v2 (recommended):
+  - module.yaml (machine-readable manifest)
+  - prompt.md (human-readable prompt)
+  - schema.json (input + output + error)
+  - tests/ (golden tests)
+
+Format v1 (legacy, still supported):
+  - MODULE.md (YAML frontmatter + prompt)
+  - schema.json (input + output)
+
+Format v0 (old, deprecated):
   - module.md (YAML frontmatter)
   - input.schema.json
   - output.schema.json
   - constraints.yaml
   - prompt.txt
-  - examples/
-
-New format (2 files):
-  - MODULE.md (YAML frontmatter + prompt)
-  - schema.json (input + output combined)
 """
 
 import json
@@ -22,13 +27,15 @@ import yaml
 
 
 def detect_format(module_path: Path) -> str:
-    """Detect module format: 'new' or 'old'."""
-    if (module_path / "MODULE.md").exists():
-        return "new"
+    """Detect module format: 'v2', 'v1', or 'v0'."""
+    if (module_path / "module.yaml").exists():
+        return "v2"
+    elif (module_path / "MODULE.md").exists():
+        return "v1"
     elif (module_path / "module.md").exists():
-        return "old"
+        return "v0"
     else:
-        raise FileNotFoundError(f"No MODULE.md or module.md found in {module_path}")
+        raise FileNotFoundError(f"No module.yaml, MODULE.md, or module.md found in {module_path}")
 
 
 def parse_frontmatter(content: str) -> tuple[dict, str]:
@@ -45,8 +52,79 @@ def parse_frontmatter(content: str) -> tuple[dict, str]:
     return frontmatter, body
 
 
-def load_new_format(module_path: Path) -> dict:
-    """Load module in new format (MODULE.md + schema.json)."""
+def load_v2_format(module_path: Path) -> dict:
+    """Load module in v2 format (module.yaml + prompt.md + schema.json)."""
+    # Load module.yaml
+    with open(module_path / "module.yaml", 'r', encoding='utf-8') as f:
+        manifest = yaml.safe_load(f)
+    
+    # Load prompt.md
+    prompt_path = module_path / "prompt.md"
+    if prompt_path.exists():
+        with open(prompt_path, 'r', encoding='utf-8') as f:
+            prompt = f.read()
+    else:
+        prompt = ""
+    
+    # Load schema.json
+    schema_path = module_path / "schema.json"
+    if schema_path.exists():
+        with open(schema_path, 'r', encoding='utf-8') as f:
+            schema = json.load(f)
+        input_schema = schema.get("input", {})
+        output_schema = schema.get("output", {})
+        error_schema = schema.get("error", {})
+    else:
+        input_schema = {}
+        output_schema = {}
+        error_schema = {}
+    
+    # Extract constraints
+    constraints_raw = manifest.get("constraints", {})
+    constraints = {
+        "operational": {
+            "no_external_network": constraints_raw.get("no_network", True),
+            "no_side_effects": constraints_raw.get("no_side_effects", True),
+            "no_file_write": constraints_raw.get("no_file_write", True),
+            "no_inventing_data": constraints_raw.get("no_inventing_data", True),
+        },
+        "output_quality": {
+            "require_confidence": manifest.get("output", {}).get("require_confidence", True),
+            "require_rationale": manifest.get("output", {}).get("require_rationale", True),
+            "require_behavior_equivalence": manifest.get("output", {}).get("require_behavior_equivalence", False),
+        }
+    }
+    
+    # Extract tools policy
+    tools = manifest.get("tools", {})
+    
+    # Extract output contract
+    output_contract = manifest.get("output", {})
+    
+    # Extract failure contract
+    failure_contract = manifest.get("failure", {})
+    
+    return {
+        "name": manifest.get("name", module_path.name),
+        "version": manifest.get("version", "1.0.0"),
+        "responsibility": manifest.get("responsibility", ""),
+        "excludes": manifest.get("excludes", []),
+        "path": module_path,
+        "format": "v2",
+        "metadata": manifest,
+        "input_schema": input_schema,
+        "output_schema": output_schema,
+        "error_schema": error_schema,
+        "constraints": constraints,
+        "tools": tools,
+        "output_contract": output_contract,
+        "failure_contract": failure_contract,
+        "prompt": prompt,
+    }
+
+
+def load_v1_format(module_path: Path) -> dict:
+    """Load module in v1 format (MODULE.md + schema.json)."""
     # Load MODULE.md
     with open(module_path / "MODULE.md", 'r', encoding='utf-8') as f:
         content = f.read()
@@ -79,8 +157,11 @@ def load_new_format(module_path: Path) -> dict:
     
     return {
         "name": metadata.get("name", module_path.name),
+        "version": metadata.get("version", "1.0.0"),
+        "responsibility": metadata.get("responsibility", ""),
+        "excludes": metadata.get("excludes", []),
         "path": module_path,
-        "format": "new",
+        "format": "v1",
         "metadata": metadata,
         "input_schema": input_schema,
         "output_schema": output_schema,
@@ -89,8 +170,8 @@ def load_new_format(module_path: Path) -> dict:
     }
 
 
-def load_old_format(module_path: Path) -> dict:
-    """Load module in old format (6 files)."""
+def load_v0_format(module_path: Path) -> dict:
+    """Load module in v0 format (old 6-file format)."""
     # Load module.md
     with open(module_path / "module.md", 'r', encoding='utf-8') as f:
         content = f.read()
@@ -114,8 +195,11 @@ def load_old_format(module_path: Path) -> dict:
     
     return {
         "name": metadata.get("name", module_path.name),
+        "version": metadata.get("version", "1.0.0"),
+        "responsibility": metadata.get("responsibility", ""),
+        "excludes": [],
         "path": module_path,
-        "format": "old",
+        "format": "v0",
         "metadata": metadata,
         "input_schema": input_schema,
         "output_schema": output_schema,
@@ -127,7 +211,37 @@ def load_old_format(module_path: Path) -> dict:
 def load_module(module_path: Path) -> dict:
     """Load a module, auto-detecting format."""
     fmt = detect_format(module_path)
-    if fmt == "new":
-        return load_new_format(module_path)
+    if fmt == "v2":
+        return load_v2_format(module_path)
+    elif fmt == "v1":
+        return load_v1_format(module_path)
     else:
-        return load_old_format(module_path)
+        return load_v0_format(module_path)
+
+
+def find_module(name: str, search_paths: list[Path]) -> Optional[dict]:
+    """Find and load a module by name from search paths."""
+    for base_path in search_paths:
+        module_path = base_path / name
+        if module_path.exists():
+            try:
+                return load_module(module_path)
+            except FileNotFoundError:
+                continue
+    return None
+
+
+def list_modules(search_paths: list[Path]) -> list[dict]:
+    """List all modules in search paths."""
+    modules = []
+    for base_path in search_paths:
+        if not base_path.exists():
+            continue
+        for module_dir in base_path.iterdir():
+            if module_dir.is_dir():
+                try:
+                    module = load_module(module_dir)
+                    modules.append(module)
+                except FileNotFoundError:
+                    continue
+    return modules

cognitive/registry.py

@@ -31,7 +31,7 @@ SEARCH_PATHS = [
 USER_MODULES_DIR = Path.home() / ".cognitive" / "modules"
 
 # Default registry URL
-DEFAULT_REGISTRY_URL = "https://raw.githubusercontent.com/leizii/cognitive-modules/main/cognitive-registry.json"
+DEFAULT_REGISTRY_URL = "https://raw.githubusercontent.com/ziel-io/cognitive-modules/main/cognitive-registry.json"
 
 # Local registry cache
 REGISTRY_CACHE = Path.home() / ".cognitive" / "registry-cache.json"

cognitive/templates.py

@@ -83,7 +83,7 @@ EXAMPLE_OUTPUT = {
 def get_schema_template(name: str) -> dict:
     """Generate schema template as dict."""
     return {
-        "$schema": "https://cognitive-modules.io/schema/v1",
+        "$schema": "https://ziel-io.github.io/cognitive-modules/schema/v1.json",
         "$id": name,
         "title": f"{name.replace('-', ' ').title()} Schema",
         "input": {

cognitive_modules-0.2.0.dist-info/METADATA

@@ -0,0 +1,418 @@
+Metadata-Version: 2.4
+Name: cognitive-modules
+Version: 0.2.0
+Summary: Structured LLM task runner with schema validation, confidence scoring, and subagent orchestration
+Author: ziel-io
+License: MIT
+Project-URL: Homepage, https://github.com/ziel-io/cognitive-modules
+Project-URL: Documentation, https://github.com/ziel-io/cognitive-modules#readme
+Project-URL: Repository, https://github.com/ziel-io/cognitive-modules
+Project-URL: Issues, https://github.com/ziel-io/cognitive-modules/issues
+Keywords: llm,cognitive,modules,ai,cli,schema,validation,prompt,agent,subagent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: jsonschema>=4.17.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.18.0; extra == "anthropic"
+Provides-Extra: ollama
+Requires-Dist: requests>=2.28.0; extra == "ollama"
+Provides-Extra: minimax
+Requires-Dist: openai>=1.0.0; extra == "minimax"
+Provides-Extra: all
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: anthropic>=0.18.0; extra == "all"
+Requires-Dist: requests>=2.28.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
+Requires-Dist: pymdown-extensions>=10.0.0; extra == "docs"
+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/)
+[![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)
+
+> 可验证的结构化 AI 任务规范
+
+Cognitive Modules 是一种 AI 任务定义规范，专为需要**强约束、可验证、可审计**的生成任务设计。
+
+## 特性
+
+- **强类型契约** - JSON Schema 双向验证输入输出
+- **可解释输出** - 强制输出 `confidence` + `rationale`
+- **子代理编排** - `@call:module` 支持模块间调用
+- **参数传递** - `$ARGUMENTS` 运行时替换
+- **多 LLM 支持** - OpenAI / Anthropic / MiniMax / Ollama
+- **公共注册表** - `cog install registry:module-name`
+
+## 安装
+
+```bash
+# 基础安装
+pip install cognitive-modules
+
+# 带 LLM 支持
+pip install cognitive-modules[openai]      # OpenAI
+pip install cognitive-modules[anthropic]   # Claude
+pip install cognitive-modules[all]         # 全部
+```
+
+## 快速开始
+
+```bash
+# 配置 LLM
+export LLM_PROVIDER=openai
+export OPENAI_API_KEY=sk-xxx
+
+# 或使用 MiniMax
+export LLM_PROVIDER=minimax
+export MINIMAX_API_KEY=sk-xxx
+
+# 运行代码审查
+cog run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
+
+# 运行任务排序
+cog run task-prioritizer --args "修复bug(紧急), 写文档, 优化性能" --pretty
+
+# 运行 API 设计
+cog run api-designer --args "用户系统 CRUD API" --pretty
+```
+
+## 与 Skills 对比
+
+| | Skills | Cognitive Modules |
+|---|--------|------------------|
+| 定位 | 轻量指令扩展 | 可验证的结构化任务 |
+| 输入校验 | ❌ | ✅ JSON Schema |
+| 输出校验 | ❌ | ✅ JSON Schema |
+| 置信度 | ❌ | ✅ 必须 0-1 |
+| 推理过程 | ❌ | ✅ 必须 rationale |
+| 参数传递 | ✅ $ARGUMENTS | ✅ $ARGUMENTS |
+| 子代理 | ✅ context: fork | ✅ @call + context |
+| 验证工具 | ❌ | ✅ cog validate |
+| 注册表 | ❌ | ✅ cog install |
+
+## CLI 命令
+
+```bash
+# 模块管理
+cog list                    # 列出已安装模块
+cog info <module>           # 查看模块详情
+cog validate <module>       # 验证模块结构
+
+# 运行模块
+cog run <module> input.json -o output.json --pretty
+cog run <module> --args "需求描述" --pretty
+cog run <module> --args "需求" --subagent  # 启用子代理
+
+# 创建模块
+cog init <name> -d "描述"
+
+# 安装/卸载
+cog install github:user/repo/path
+cog install registry:module-name
+cog uninstall <module>
+
+# 注册表
+cog registry                # 查看公共模块
+cog search <query>          # 搜索模块
+
+# 环境检查
+cog doctor
+```
+
+## 内置模块
+
+| 模块 | 功能 | 示例 |
+|------|------|------|
+| `code-reviewer` | 代码审查 | `cog run code-reviewer --args "你的代码"` |
+| `code-simplifier` | 代码简化 | `cog run code-simplifier --args "复杂代码"` |
+| `task-prioritizer` | 任务优先级排序 | `cog run task-prioritizer --args "任务1,任务2"` |
+| `api-designer` | REST API 设计 | `cog run api-designer --args "订单系统"` |
+| `ui-spec-generator` | UI 规范生成 | `cog run ui-spec-generator --args "电商首页"` |
+| `product-analyzer` | 产品分析（子代理示例） | `cog run product-analyzer --args "健康产品" -s` |
+
+## 模块格式
+
+### 新格式（推荐）
+
+```
+my-module/
+├── MODULE.md       # 元数据 + 指令
+├── schema.json     # 输入输出 Schema
+└── examples/
+    ├── input.json
+    └── output.json
+```
+
+### MODULE.md
+
+```yaml
+---
+name: my-module
+version: 1.0.0
+responsibility: 一句话描述
+
+excludes:
+  - 不做的事情
+
+constraints:
+  no_network: true
+  no_inventing_data: true
+  require_confidence: true
+  require_rationale: true
+
+context: fork  # 可选：隔离执行
+---
+
+# 指令
+
+根据用户需求 $ARGUMENTS 执行任务。
+
+可以调用其他模块：
+@call:other-module($ARGUMENTS)
+```
+
+## 在 AI 工具中使用
+
+### Cursor / Codex CLI
+
+在项目根目录创建 `AGENTS.md`：
+
+```markdown
+## 代码审查
+
+当需要审查代码时：
+1. 读取 `~/.cognitive/modules/code-reviewer/MODULE.md`
+2. 按 schema.json 格式输出
+3. 包含 issues、summary、rationale、confidence
+```
+
+### 直接对话
+
+```
+读取 ~/.cognitive/modules/code-reviewer/MODULE.md，
+审查这段代码：def login(u,p): ...
+```
+
+## 配置 LLM
+
+```bash
+# OpenAI
+export LLM_PROVIDER=openai
+export OPENAI_API_KEY=sk-xxx
+
+# Anthropic Claude
+export LLM_PROVIDER=anthropic
+export ANTHROPIC_API_KEY=sk-ant-xxx
+
+# MiniMax
+export LLM_PROVIDER=minimax
+export MINIMAX_API_KEY=sk-xxx
+
+# Ollama（本地）
+export LLM_PROVIDER=ollama
+
+# 检查配置
+cog doctor
+```
+
+## 创建新模块（完整流程）
+
+以 `code-simplifier` 为例：
+
+### Step 1: 创建目录结构
+
+```bash
+mkdir -p cognitive/modules/code-simplifier
+```
+
+### Step 2: 编写 MODULE.md
+
+```bash
+cat > cognitive/modules/code-simplifier/MODULE.md << 'EOF'
+---
+name: code-simplifier
+version: 1.0.0
+responsibility: Simplify complex code while preserving functionality
+
+excludes:
+  - Changing the code's behavior
+  - Adding new features
+  - Removing functionality
+
+constraints:
+  no_network: true
+  no_side_effects: true
+  require_confidence: true
+  require_rationale: true
+---
+
+# Code Simplifier Module
+
+You are an expert at refactoring and simplifying code.
+
+## Input
+
+Code to simplify: $ARGUMENTS
+
+## Simplification Strategies
+
+1. **Remove redundancy** - Eliminate duplicate code
+2. **Improve naming** - Use clear, descriptive names
+3. **Reduce nesting** - Flatten deep conditionals
+4. **Simplify logic** - Use built-in functions
+
+## Output Requirements
+
+Return JSON containing:
+- `simplified_code`: The simplified version
+- `changes`: List of changes made
+- `summary`: Brief description
+- `rationale`: Explanation of decisions
+- `confidence`: Confidence score [0-1]
+EOF
+```
+
+### Step 3: 编写 schema.json
+
+```bash
+cat > cognitive/modules/code-simplifier/schema.json << 'EOF'
+{
+  "$schema": "https://ziel-io.github.io/cognitive-modules/schema/v1.json",
+  "input": {
+    "type": "object",
+    "properties": {
+      "code": { "type": "string" },
+      "language": { "type": "string" },
+      "$ARGUMENTS": { "type": "string" }
+    }
+  },
+  "output": {
+    "type": "object",
+    "required": ["simplified_code", "changes", "summary", "rationale", "confidence"],
+    "properties": {
+      "simplified_code": { "type": "string" },
+      "changes": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "type": { "type": "string" },
+            "description": { "type": "string" }
+          }
+        }
+      },
+      "summary": { "type": "string" },
+      "rationale": { "type": "string" },
+      "confidence": { "type": "number", "minimum": 0, "maximum": 1 }
+    }
+  }
+}
+EOF
+```
+
+### Step 4: 验证模块
+
+```bash
+cog validate code-simplifier
+cog list  # 确认模块出现在列表中
+```
+
+### Step 5: 测试运行
+
+```bash
+cog run code-simplifier --args "def calc(x): if x > 0: if x < 10: return x * 2 else: return x else: return 0" --pretty
+```
+
+### Step 6: 添加示例（可选）
+
+```bash
+mkdir -p cognitive/modules/code-simplifier/examples
+# 添加 input.json 和 output.json 作为测试用例
+```
+
+### 模块设计要点
+
+| 要素 | 必须 | 说明 |
+|------|------|------|
+| `name` | ✅ | 唯一标识符，kebab-case |
+| `version` | ✅ | 语义化版本 |
+| `responsibility` | ✅ | 一句话描述职责 |
+| `excludes` | ✅ | 明确列出不做的事 |
+| `$ARGUMENTS` | ✅ | 支持命令行参数 |
+| `confidence` | ✅ | 输出必须包含 0-1 置信度 |
+| `rationale` | ✅ | 输出必须包含推理过程 |
+| `schema.json` | ✅ | 定义输入输出契约 |
+
+## 开发
+
+```bash
+# 克隆
+git clone https://github.com/ziel-io/cognitive-modules.git
+cd cognitive-modules
+
+# 安装开发依赖
+pip install -e ".[dev]"
+
+# 运行测试
+pytest tests/ -v
+
+# 创建新模块（使用模板）
+cog init my-module -d "模块描述"
+cog validate my-module
+```
+
+## 项目结构
+
+```
+cognitive-modules/
+├── src/cognitive/          # CLI 源码
+│   ├── cli.py              # 命令入口
+│   ├── loader.py           # 模块加载
+│   ├── runner.py           # 模块执行
+│   ├── subagent.py         # 子代理编排
+│   ├── validator.py        # 模块验证
+│   ├── registry.py         # 模块安装
+│   ├── templates.py        # 模块模板
+│   └── providers/          # LLM 后端
+├── cognitive/modules/      # 内置模块
+├── tests/                  # 单元测试
+├── SPEC.md                 # 规范文档
+├── INTEGRATION.md          # 集成指南
+└── cognitive-registry.json # 公共注册表
+```
+
+## 文档
+
+- [SPEC.md](SPEC.md) - 完整规范（含上下文哲学）
+- [INTEGRATION.md](INTEGRATION.md) - Agent 工具集成指南
+
+## License
+
+MIT

cognitive_modules-0.2.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+cognitive/__init__.py,sha256=uSX5NuOWyW0qtq1bnxbzabZ0OQakAtsjF0MWbjQBvwE,401
+cognitive/cli.py,sha256=q0vHCHFmig9gQ85KRyIrX6vrJZFm5nXF_bW5qQRGEPU,14608
+cognitive/loader.py,sha256=i9ulJtd5Itj4QYhUYfuHOXtzCBBtY8L1EkMu5yM-0SU,8094
+cognitive/registry.py,sha256=aBkkpg5PtL_tKDIOXpv6vblB7x_Ax0eVaWgejuQTfCE,8851
+cognitive/runner.py,sha256=9uxBAGd3gtXnwUm5x2CjhXi_S1gd2nfjRfM3Q_1f30Q,4362
+cognitive/subagent.py,sha256=fb7LWwNF6YcJtC_T1dK0EvzqWMBnav-kiCIpvVohEBw,8142
+cognitive/templates.py,sha256=lKC197X9aQIA-npUvVCaplSwvhxjsH_KYVCQtrTZrL4,4712
+cognitive/validator.py,sha256=1v1HUHYOlAc2sYCkIq_gnUMMnca0fdtQwr7UMBFpp04,12200
+cognitive/providers/__init__.py,sha256=hqhVA1IEXpVtyCAteXhO5yD8a8ikQpVIPEKJVHLtRFY,7492
+cognitive_modules-0.2.0.dist-info/licenses/LICENSE,sha256=NXFYUy2hPJdh3NHRxMChTnMiQD9k8zFxkmR7gWefexc,1064
+cognitive_modules-0.2.0.dist-info/METADATA,sha256=d6Jm2ALcRX56UBBvKDWn8uiLx8MIcnUhK4RLl8x2uvg,11381
+cognitive_modules-0.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+cognitive_modules-0.2.0.dist-info/entry_points.txt,sha256=PKHlfrFmve5K2349ryipySKbOOsKxo_vIq1NNT-iBV0,42
+cognitive_modules-0.2.0.dist-info/top_level.txt,sha256=kGIfDucCKylo8cRBtxER_v3DHIea-Sol9x9YSJo1u3Y,10
+cognitive_modules-0.2.0.dist-info/RECORD,,

{cognitive_modules-0.1.0.dist-info → cognitive_modules-0.2.0.dist-info}/licenses/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 leizii
+Copyright (c) 2026 ziel-io
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

cognitive_modules-0.1.0.dist-info/METADATA

@@ -1,295 +0,0 @@
-Metadata-Version: 2.4
-Name: cognitive-modules
-Version: 0.1.0
-Summary: Structured LLM task runner with schema validation, confidence scoring, and subagent orchestration
-Author: leizii
-License: MIT
-Project-URL: Homepage, https://github.com/leizii/cognitive-modules
-Project-URL: Documentation, https://github.com/leizii/cognitive-modules#readme
-Project-URL: Repository, https://github.com/leizii/cognitive-modules
-Project-URL: Issues, https://github.com/leizii/cognitive-modules/issues
-Keywords: llm,cognitive,modules,ai,cli,schema,validation,prompt,agent,subagent
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: jsonschema>=4.17.0
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: typer>=0.9.0
-Requires-Dist: rich>=13.0.0
-Provides-Extra: openai
-Requires-Dist: openai>=1.0.0; extra == "openai"
-Provides-Extra: anthropic
-Requires-Dist: anthropic>=0.18.0; extra == "anthropic"
-Provides-Extra: ollama
-Requires-Dist: requests>=2.28.0; extra == "ollama"
-Provides-Extra: minimax
-Requires-Dist: openai>=1.0.0; extra == "minimax"
-Provides-Extra: all
-Requires-Dist: openai>=1.0.0; extra == "all"
-Requires-Dist: anthropic>=0.18.0; extra == "all"
-Requires-Dist: requests>=2.28.0; extra == "all"
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: build>=1.0.0; extra == "dev"
-Requires-Dist: twine>=4.0.0; extra == "dev"
-Dynamic: license-file
-
-# Cognitive Modules
-
-> 可验证的结构化 AI 任务规范
-
-Cognitive Modules 是一种 AI 任务定义规范，专为需要**强约束、可验证、可审计**的生成任务设计。
-
-## 与 Skills 的区别
-
-| | Skills | Cognitive Modules |
-|---|--------|------------------|
-| 定位 | 轻量指令扩展 | 可验证的结构化任务 |
-| 输入校验 | 无 | JSON Schema |
-| 输出校验 | 无 | JSON Schema |
-| 置信度 | 无 | 必须 0-1 |
-| 推理过程 | 无 | 必须 rationale |
-| 适用场景 | 快捷命令 | 规范生成、设计文档 |
-
-## 快速开始
-
-```bash
-# 克隆
-git clone https://github.com/leizii/cognitive-modules.git
-cd cognitive-modules
-
-# 安装依赖
-pip install typer rich jsonschema pyyaml
-
-# 运行
-./cog --help
-```
-
-## CLI 命令
-
-```bash
-# 模块管理
-cog list                    # 列出已安装模块
-cog info <module>           # 查看模块详情
-cog validate <module>       # 验证模块结构
-
-# 创建模块
-cog init <name> -d "描述"    # 从模板创建新模块
-
-# 运行模块
-cog run <module> input.json -o output.json --pretty
-
-# 直接传参数（无需 JSON 文件）
-cog run <module> --args "你的需求描述" -o output.json
-
-# 启用子代理模式（支持 @call 调用其他模块）
-cog run <module> --args "需求" --subagent
-
-# 安装/卸载
-cog install <source>        # 从 git/本地/注册表安装
-cog uninstall <module>      # 卸载模块
-
-# 注册表
-cog registry                # 查看公共模块
-cog search <query>          # 搜索模块
-
-# 环境检查
-cog doctor                  # 检查 LLM 配置
-```
-
-## 安装来源
-
-```bash
-# 从本地安装
-cog install ./path/to/module
-
-# 从 GitHub 安装
-cog install github:leizii/cognitive-modules/cognitive/modules/ui-spec-generator
-
-# 从注册表安装
-cog install registry:ui-spec-generator
-```
-
-## 模块格式
-
-### 新格式（推荐，2 文件）
-
-```
-my-module/
-├── MODULE.md       # 元数据 + 指令
-├── schema.json     # 输入输出 Schema
-└── examples/       # 可选
-    ├── input.json
-    └── output.json
-```
-
-### 旧格式（兼容，6 文件）
-
-```
-my-module/
-├── module.md
-├── input.schema.json
-├── output.schema.json
-├── constraints.yaml
-├── prompt.txt
-└── examples/
-```
-
-## MODULE.md 格式
-
-```yaml
----
-name: my-module
-version: 1.0.0
-responsibility: 一句话描述
-
-excludes:
-  - 不做的事情
-
-constraints:
-  no_network: true
-  no_inventing_data: true
-  require_confidence: true
-  require_rationale: true
----
-
-# 指令内容
-
-（这里写 prompt）
-```
-
-## 在 Codex / Cursor 中使用
-
-### 方式 1：直接对话（零配置）
-
-```
-读取 ~/.cognitive/modules/ui-spec-generator/MODULE.md，
-为电商首页生成 UI 规范，保存到 ui-spec.json
-```
-
-### 方式 2：AGENTS.md（项目约定）
-
-在项目根目录创建 `AGENTS.md`：
-
-```markdown
-## UI 规范生成
-
-当需要生成 UI 规范时：
-1. 读取 `~/.cognitive/modules/ui-spec-generator/MODULE.md`
-2. 按 schema.json 格式输出
-3. 保存到 ui-spec.json
-```
-
-### 方式 3：包装成 Skill
-
-```yaml
-# ~/.claude/skills/ui-spec/SKILL.md
----
-name: ui-spec
-description: 生成 UI 规范
----
-执行 ~/.cognitive/modules/ui-spec-generator/MODULE.md
-```
-
-## 配置 LLM（仅 CLI 需要）
-
-```bash
-# OpenAI
-export LLM_PROVIDER=openai
-export OPENAI_API_KEY=sk-xxx
-
-# Anthropic Claude
-export LLM_PROVIDER=anthropic
-export ANTHROPIC_API_KEY=sk-ant-xxx
-
-# Ollama（本地免费）
-export LLM_PROVIDER=ollama
-
-# 不配置则使用 stub（返回示例输出）
-```
-
-## 模块搜索路径
-
-模块按以下顺序查找：
-
-1. `./cognitive/modules/` - 项目本地
-2. `~/.cognitive/modules/` - 用户全局
-3. `$COGNITIVE_MODULES_PATH` - 自定义路径
-
-## 创建新模块
-
-```bash
-# 1. 创建骨架
-cog init my-module -d "模块职责描述"
-
-# 2. 编辑 MODULE.md 添加指令
-# 3. 编辑 schema.json 定义输入输出
-# 4. 验证
-cog validate my-module
-
-# 5. 全局安装（可选）
-cog install ./cognitive/modules/my-module
-```
-
-## 内置模块
-
-### ui-spec-generator
-
-将产品需求转换为前端可实现的 UI 规范。
-
-**输出包含**：
-- 信息架构（sections + hierarchy）
-- 组件定义（type, props, states）
-- 交互设计（events, transitions）
-- 响应式规则（breakpoints, layout）
-- 可访问性（WCAG 要求）
-- 验收标准（可测试条件）
-- 置信度 + 推理过程
-
-```bash
-cog run ui-spec-generator examples/input.json -o ui-spec.json --pretty
-```
-
-## 项目结构
-
-```
-cognitive-modules/
-├── README.md               # 本文件
-├── SPEC.md                 # 规范文档
-├── INTEGRATION.md          # Agent 集成指南
-├── AGENTS.md               # Agent 约定示例
-├── cognitive-registry.json # 公共模块注册表
-├── src/cognitive/          # CLI 源码
-│   ├── cli.py              # 命令入口
-│   ├── loader.py           # 模块加载（支持新旧格式）
-│   ├── runner.py           # 模块执行
-│   ├── validator.py        # 模块验证
-│   ├── registry.py         # 模块发现与安装
-│   ├── templates.py        # 模块模板
-│   └── providers/          # LLM 后端
-├── cognitive/modules/      # 内置模块
-│   └── ui-spec-generator/
-└── pyproject.toml
-```
-
-## 文档
-
-- [SPEC.md](SPEC.md) - 完整规范文档
-- [INTEGRATION.md](INTEGRATION.md) - Agent 工具集成指南
-- [AGENTS.md](AGENTS.md) - Agent 约定示例
-
-## License
-
-MIT

cognitive_modules-0.1.0.dist-info/RECORD

@@ -1,15 +0,0 @@
-cognitive/__init__.py,sha256=uSX5NuOWyW0qtq1bnxbzabZ0OQakAtsjF0MWbjQBvwE,401
-cognitive/cli.py,sha256=q0vHCHFmig9gQ85KRyIrX6vrJZFm5nXF_bW5qQRGEPU,14608
-cognitive/loader.py,sha256=E_lSuy2ERBWfziOHr3f13nLq-wEYvBqIKrGlPk4PQyA,4031
-cognitive/registry.py,sha256=Adb9246LH5mj6aObpZs-QkqdB3iC7f9-3C0kItgfvrI,8850
-cognitive/runner.py,sha256=9uxBAGd3gtXnwUm5x2CjhXi_S1gd2nfjRfM3Q_1f30Q,4362
-cognitive/subagent.py,sha256=fb7LWwNF6YcJtC_T1dK0EvzqWMBnav-kiCIpvVohEBw,8142
-cognitive/templates.py,sha256=fEd1Tj5A12PUE256dC7-cnsulWzm6MTrcQ0yLPWrtx0,4692
-cognitive/validator.py,sha256=1v1HUHYOlAc2sYCkIq_gnUMMnca0fdtQwr7UMBFpp04,12200
-cognitive/providers/__init__.py,sha256=hqhVA1IEXpVtyCAteXhO5yD8a8ikQpVIPEKJVHLtRFY,7492
-cognitive_modules-0.1.0.dist-info/licenses/LICENSE,sha256=f7MIeafHCzp_CW2Oq1aAjmZjFUa3hBILmBEMl7AsK7k,1063
-cognitive_modules-0.1.0.dist-info/METADATA,sha256=wS_z7RLTFaawk0XDoqiRNoibRrfM6UH9hxRliNcUm28,7530
-cognitive_modules-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-cognitive_modules-0.1.0.dist-info/entry_points.txt,sha256=PKHlfrFmve5K2349ryipySKbOOsKxo_vIq1NNT-iBV0,42
-cognitive_modules-0.1.0.dist-info/top_level.txt,sha256=kGIfDucCKylo8cRBtxER_v3DHIea-Sol9x9YSJo1u3Y,10
-cognitive_modules-0.1.0.dist-info/RECORD,,