cognitive-modules 0.2.0__tar.gz → 0.4.0__tar.gz

{cognitive_modules-0.2.0/src/cognitive_modules.egg-info → cognitive_modules-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cognitive-modules
-Version: 0.2.0
+Version: 0.4.0
 Summary: Structured LLM task runner with schema validation, confidence scoring, and subagent orchestration
 Author: ziel-io
 License: MIT
@@ -68,7 +68,7 @@ Cognitive Modules 是一种 AI 任务定义规范，专为需要**强约束、
 - **子代理编排** - `@call:module` 支持模块间调用
 - **参数传递** - `$ARGUMENTS` 运行时替换
 - **多 LLM 支持** - OpenAI / Anthropic / MiniMax / Ollama
-- **公共注册表** - `cog install registry:module-name`
+- **公共注册表** - `cogn install registry:module-name`
 
 ## 安装
 
@@ -94,13 +94,13 @@ 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
+cogn 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
+cogn run task-prioritizer --args "修复bug(紧急), 写文档, 优化性能" --pretty
 
 # 运行 API 设计
-cog run api-designer --args "用户系统 CRUD API" --pretty
+cogn run api-designer --args "用户系统 CRUD API" --pretty
 ```
 
 ## 与 Skills 对比
@@ -114,48 +114,58 @@ cog run api-designer --args "用户系统 CRUD API" --pretty
 | 推理过程 | ❌ | ✅ 必须 rationale |
 | 参数传递 | ✅ $ARGUMENTS | ✅ $ARGUMENTS |
 | 子代理 | ✅ context: fork | ✅ @call + context |
-| 验证工具 | ❌ | ✅ cog validate |
-| 注册表 | ❌ | ✅ cog install |
+| 验证工具 | ❌ | ✅ cogn validate |
+| 注册表 | ❌ | ✅ cogn install |
 
 ## CLI 命令
 
 ```bash
 # 模块管理
-cog list                    # 列出已安装模块
-cog info <module>           # 查看模块详情
-cog validate <module>       # 验证模块结构
+cogn list                    # 列出已安装模块
+cogn info <module>           # 查看模块详情
+cogn validate <module>       # 验证模块结构
 
 # 运行模块
-cog run <module> input.json -o output.json --pretty
-cog run <module> --args "需求描述" --pretty
-cog run <module> --args "需求" --subagent  # 启用子代理
+cogn run <module> input.json -o output.json --pretty
+cogn run <module> --args "需求描述" --pretty
+cogn run <module> --args "需求" --subagent  # 启用子代理
 
 # 创建模块
-cog init <name> -d "描述"
+cogn init <name> -d "描述"
 
-# 安装/卸载
-cog install github:user/repo/path
-cog install registry:module-name
-cog uninstall <module>
+# 从 GitHub 安装（推荐）
+cogn add ziel-io/cognitive-modules -m code-simplifier
+cogn add org/repo -m module-name --tag v1.0.0   # 安装指定版本
+cogn remove <module>                             # 删除模块
+
+# 版本管理
+cogn update <module>                 # 更新到最新版本
+cogn update <module> --tag v2.0.0    # 更新到指定版本
+cogn versions <url>                  # 查看可用版本
+
+# 其他安装方式
+cogn install github:user/repo/path
+cogn install registry:module-name
+cogn uninstall <module>
 
 # 注册表
-cog registry                # 查看公共模块
-cog search <query>          # 搜索模块
+cogn registry                # 查看公共模块
+cogn search <query>          # 搜索模块
 
 # 环境检查
-cog doctor
+cogn 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` |
+| `code-reviewer` | 代码审查 | `cogn run code-reviewer --args "你的代码"` |
+| `code-simplifier` | 代码简化 | `cogn run code-simplifier --args "复杂代码"` |
+| `task-prioritizer` | 任务优先级排序 | `cogn run task-prioritizer --args "任务1,任务2"` |
+| `api-designer` | REST API 设计 | `cogn run api-designer --args "订单系统"` |
+| `ui-spec-generator` | UI 规范生成 | `cogn run ui-spec-generator --args "电商首页"` |
+| `product-analyzer` | 产品分析（子代理示例） | `cogn run product-analyzer --args "健康产品" -s` |
 
 ## 模块格式
 
@@ -239,7 +249,7 @@ export MINIMAX_API_KEY=sk-xxx
 export LLM_PROVIDER=ollama
 
 # 检查配置
-cog doctor
+cogn doctor
 ```
 
 ## 创建新模块（完整流程）
@@ -340,14 +350,14 @@ EOF
 ### Step 4: 验证模块
 
 ```bash
-cog validate code-simplifier
-cog list  # 确认模块出现在列表中
+cogn validate code-simplifier
+cogn 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
+cogn 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: 添加示例（可选）
@@ -384,8 +394,8 @@ pip install -e ".[dev]"
 pytest tests/ -v
 
 # 创建新模块（使用模板）
-cog init my-module -d "模块描述"
-cog validate my-module
+cogn init my-module -d "模块描述"
+cogn validate my-module
 ```
 
 ## 项目结构

{cognitive_modules-0.2.0 → cognitive_modules-0.4.0}/README.md

@@ -16,7 +16,7 @@ Cognitive Modules 是一种 AI 任务定义规范，专为需要**强约束、
 - **子代理编排** - `@call:module` 支持模块间调用
 - **参数传递** - `$ARGUMENTS` 运行时替换
 - **多 LLM 支持** - OpenAI / Anthropic / MiniMax / Ollama
-- **公共注册表** - `cog install registry:module-name`
+- **公共注册表** - `cogn install registry:module-name`
 
 ## 安装
 
@@ -42,13 +42,13 @@ 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
+cogn 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
+cogn run task-prioritizer --args "修复bug(紧急), 写文档, 优化性能" --pretty
 
 # 运行 API 设计
-cog run api-designer --args "用户系统 CRUD API" --pretty
+cogn run api-designer --args "用户系统 CRUD API" --pretty
 ```
 
 ## 与 Skills 对比
@@ -62,48 +62,58 @@ cog run api-designer --args "用户系统 CRUD API" --pretty
 | 推理过程 | ❌ | ✅ 必须 rationale |
 | 参数传递 | ✅ $ARGUMENTS | ✅ $ARGUMENTS |
 | 子代理 | ✅ context: fork | ✅ @call + context |
-| 验证工具 | ❌ | ✅ cog validate |
-| 注册表 | ❌ | ✅ cog install |
+| 验证工具 | ❌ | ✅ cogn validate |
+| 注册表 | ❌ | ✅ cogn install |
 
 ## CLI 命令
 
 ```bash
 # 模块管理
-cog list                    # 列出已安装模块
-cog info <module>           # 查看模块详情
-cog validate <module>       # 验证模块结构
+cogn list                    # 列出已安装模块
+cogn info <module>           # 查看模块详情
+cogn validate <module>       # 验证模块结构
 
 # 运行模块
-cog run <module> input.json -o output.json --pretty
-cog run <module> --args "需求描述" --pretty
-cog run <module> --args "需求" --subagent  # 启用子代理
+cogn run <module> input.json -o output.json --pretty
+cogn run <module> --args "需求描述" --pretty
+cogn run <module> --args "需求" --subagent  # 启用子代理
 
 # 创建模块
-cog init <name> -d "描述"
+cogn init <name> -d "描述"
 
-# 安装/卸载
-cog install github:user/repo/path
-cog install registry:module-name
-cog uninstall <module>
+# 从 GitHub 安装（推荐）
+cogn add ziel-io/cognitive-modules -m code-simplifier
+cogn add org/repo -m module-name --tag v1.0.0   # 安装指定版本
+cogn remove <module>                             # 删除模块
+
+# 版本管理
+cogn update <module>                 # 更新到最新版本
+cogn update <module> --tag v2.0.0    # 更新到指定版本
+cogn versions <url>                  # 查看可用版本
+
+# 其他安装方式
+cogn install github:user/repo/path
+cogn install registry:module-name
+cogn uninstall <module>
 
 # 注册表
-cog registry                # 查看公共模块
-cog search <query>          # 搜索模块
+cogn registry                # 查看公共模块
+cogn search <query>          # 搜索模块
 
 # 环境检查
-cog doctor
+cogn 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` |
+| `code-reviewer` | 代码审查 | `cogn run code-reviewer --args "你的代码"` |
+| `code-simplifier` | 代码简化 | `cogn run code-simplifier --args "复杂代码"` |
+| `task-prioritizer` | 任务优先级排序 | `cogn run task-prioritizer --args "任务1,任务2"` |
+| `api-designer` | REST API 设计 | `cogn run api-designer --args "订单系统"` |
+| `ui-spec-generator` | UI 规范生成 | `cogn run ui-spec-generator --args "电商首页"` |
+| `product-analyzer` | 产品分析（子代理示例） | `cogn run product-analyzer --args "健康产品" -s` |
 
 ## 模块格式
 
@@ -187,7 +197,7 @@ export MINIMAX_API_KEY=sk-xxx
 export LLM_PROVIDER=ollama
 
 # 检查配置
-cog doctor
+cogn doctor
 ```
 
 ## 创建新模块（完整流程）
@@ -288,14 +298,14 @@ EOF
 ### Step 4: 验证模块
 
 ```bash
-cog validate code-simplifier
-cog list  # 确认模块出现在列表中
+cogn validate code-simplifier
+cogn 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
+cogn 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: 添加示例（可选）
@@ -332,8 +342,8 @@ pip install -e ".[dev]"
 pytest tests/ -v
 
 # 创建新模块（使用模板）
-cog init my-module -d "模块描述"
-cog validate my-module
+cogn init my-module -d "模块描述"
+cogn validate my-module
 ```
 
 ## 项目结构

{cognitive_modules-0.2.0 → cognitive_modules-0.4.0}/pyproject.toml

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

{cognitive_modules-0.2.0 → cognitive_modules-0.4.0}/src/cognitive/cli.py

@@ -5,8 +5,12 @@ Commands:
     cog list                      List installed modules
     cog run <module> <input>      Run a module
     cog validate <module>         Validate module structure
+    cog add <url> --module <name> Add module from GitHub (recommended)
+    cog update <module>           Update module to latest version
+    cog versions <url>            List available versions for a repo
     cog install <source>          Install module from git/local/registry
-    cog uninstall <module>        Remove an installed module
+    cog remove <module>           Remove an installed module
+    cog uninstall <module>        Remove an installed module (alias)
     cog init <name>               Create a new module from template
     cog search <query>            Search the public registry
     cog doctor                    Check environment setup
@@ -31,6 +35,11 @@ from .registry import (
     uninstall_module,
     search_registry,
     fetch_registry,
+    install_from_github_url,
+    update_module,
+    get_installed_module_info,
+    get_module_version,
+    list_github_tags,
     USER_MODULES_DIR,
 )
 from .loader import load_module, detect_format
@@ -203,6 +212,185 @@ def install_cmd(
         raise typer.Exit(1)
 
 
+@app.command("add")
+def add_cmd(
+    url: str = typer.Argument(..., help="GitHub URL or org/repo shorthand"),
+    module: str = typer.Option(None, "--module", "-m", help="Module path within repo"),
+    name: Optional[str] = typer.Option(None, "--name", "-n", help="Override module name"),
+    branch: str = typer.Option("main", "--branch", "-b", help="Git branch"),
+    tag: Optional[str] = typer.Option(None, "--tag", "-t", help="Git tag/version (e.g., v1.0.0)"),
+):
+    """
+    Add a cognitive module from GitHub.
+    
+    Examples:
+    
+        cog add https://github.com/ziel-io/cognitive-modules --module code-simplifier
+        
+        cog add ziel-io/cognitive-modules -m code-reviewer
+        
+        cog add org/repo -m my-module --tag v1.0.0
+        
+        cog add org/repo -m path/to/module --name my-module
+    """
+    rprint(f"[cyan]→[/cyan] Adding module from: {url}")
+    if module:
+        rprint(f"  Module path: {module}")
+    if tag:
+        rprint(f"  Version: {tag}")
+    
+    try:
+        target = install_from_github_url(
+            url=url,
+            module_path=module,
+            name=name,
+            branch=branch,
+            tag=tag,
+        )
+        
+        # Validate installed module
+        is_valid, errors, warnings = validate_module(str(target))
+        
+        if not is_valid:
+            rprint(f"[red]✗ Installed module failed validation:[/red]")
+            for e in errors:
+                rprint(f"  - {e}")
+            uninstall_module(target.name)
+            raise typer.Exit(1)
+        
+        # Get version info
+        version = get_module_version(target)
+        version_str = f" v{version}" if version else ""
+        
+        rprint(f"[green]✓ Added: {target.name}{version_str}[/green]")
+        rprint(f"  Location: {target}")
+        
+        if warnings:
+            rprint(f"[yellow]  Warnings: {len(warnings)}[/yellow]")
+        
+        rprint(f"\nRun with:")
+        rprint(f"  [cyan]cog run {target.name} --args \"your input\"[/cyan]")
+        
+    except Exception as e:
+        rprint(f"[red]✗ Failed to add module: {e}[/red]")
+        raise typer.Exit(1)
+
+
+@app.command("remove")
+def remove_cmd(
+    module: str = typer.Argument(..., help="Module name to remove"),
+):
+    """Remove an installed cognitive module (alias for uninstall)."""
+    uninstall_cmd(module)
+
+
+@app.command("update")
+def update_cmd(
+    module: str = typer.Argument(..., help="Module name to update"),
+    tag: Optional[str] = typer.Option(None, "--tag", "-t", help="Update to specific tag/version"),
+):
+    """
+    Update an installed module to the latest version.
+    
+    Examples:
+    
+        cog update code-simplifier
+        
+        cog update code-simplifier --tag v2.0.0
+    """
+    rprint(f"[cyan]→[/cyan] Updating module: {module}")
+    
+    # Check if module is installed
+    info = get_installed_module_info(module)
+    if not info:
+        rprint(f"[red]✗ Module not found or not installed from GitHub: {module}[/red]")
+        rprint(f"  Only modules installed with 'cog add' can be updated.")
+        raise typer.Exit(1)
+    
+    github_url = info.get("github_url")
+    if not github_url:
+        rprint(f"[red]✗ Module was not installed from GitHub: {module}[/red]")
+        raise typer.Exit(1)
+    
+    # Get current version
+    current_path = USER_MODULES_DIR / module
+    old_version = get_module_version(current_path) if current_path.exists() else None
+    
+    if old_version:
+        rprint(f"  Current version: {old_version}")
+    
+    try:
+        # Re-install from source
+        module_path = info.get("module_path")
+        branch = info.get("branch", "main")
+        
+        # Use specified tag or keep using the same ref type
+        use_tag = tag or info.get("tag")
+        
+        target = install_from_github_url(
+            url=github_url,
+            module_path=module_path,
+            name=module,
+            branch=branch if not use_tag else "main",
+            tag=use_tag,
+        )
+        
+        # Get new version
+        new_version = get_module_version(target)
+        
+        if old_version and new_version:
+            if old_version == new_version:
+                rprint(f"[green]✓ Already up to date: {module} v{new_version}[/green]")
+            else:
+                rprint(f"[green]✓ Updated: {module} v{old_version} → v{new_version}[/green]")
+        elif new_version:
+            rprint(f"[green]✓ Updated: {module} to v{new_version}[/green]")
+        else:
+            rprint(f"[green]✓ Updated: {module}[/green]")
+        
+    except Exception as e:
+        rprint(f"[red]✗ Failed to update module: {e}[/red]")
+        raise typer.Exit(1)
+
+
+@app.command("versions")
+def versions_cmd(
+    url: str = typer.Argument(..., help="GitHub URL or org/repo shorthand"),
+    limit: int = typer.Option(10, "--limit", "-l", help="Max versions to show"),
+):
+    """
+    List available versions (tags) for a GitHub repository.
+    
+    Examples:
+    
+        cog versions ziel-io/cognitive-modules
+        
+        cog versions https://github.com/org/repo
+    """
+    rprint(f"[cyan]→[/cyan] Fetching versions from: {url}\n")
+    
+    try:
+        tags = list_github_tags(url, limit=limit)
+        
+        if not tags:
+            rprint("[yellow]No tags/versions found.[/yellow]")
+            return
+        
+        table = Table(title=f"Available Versions ({len(tags)})")
+        table.add_column("Version", style="cyan")
+        table.add_column("Install Command")
+        
+        for tag in tags:
+            cmd = f"cog add {url} --tag {tag}"
+            table.add_row(tag, f"[dim]{cmd}[/dim]")
+        
+        console.print(table)
+        
+    except Exception as e:
+        rprint(f"[red]✗ Failed to fetch versions: {e}[/red]")
+        raise typer.Exit(1)
+
+
 @app.command("uninstall")
 def uninstall_cmd(
     module: str = typer.Argument(..., help="Module name to uninstall"),
@@ -403,6 +591,20 @@ def info_cmd(
     
     rprint(f"\n[bold]Path:[/bold] {m['path']}")
     rprint(f"[bold]Prompt size:[/bold] {len(m['prompt'])} chars")
+    
+    # Show installation info if available
+    install_info = get_installed_module_info(meta.get('name', module))
+    if install_info:
+        rprint(f"\n[bold]Installation:[/bold]")
+        if install_info.get("github_url"):
+            rprint(f"  Source: {install_info['github_url']}")
+        if install_info.get("tag"):
+            rprint(f"  Tag: {install_info['tag']}")
+        elif install_info.get("branch"):
+            rprint(f"  Branch: {install_info['branch']}")
+        if install_info.get("installed_time"):
+            rprint(f"  Installed: {install_info['installed_time'][:10]}")
+        rprint(f"\n  Update with: [cyan]cog update {meta.get('name', module)}[/cyan]")
 
 
 @app.callback(invoke_without_command=True)

{cognitive_modules-0.2.0 → cognitive_modules-0.4.0}/src/cognitive/loader.py

@@ -79,22 +79,28 @@ def load_v2_format(module_path: Path) -> dict:
         output_schema = {}
         error_schema = {}
     
-    # Extract constraints
+    # Extract constraints (supports both old and new format)
     constraints_raw = manifest.get("constraints", {})
+    policies_raw = manifest.get("policies", {})
+    
     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_external_network": constraints_raw.get("no_network", True) or policies_raw.get("network") == "deny",
+            "no_side_effects": constraints_raw.get("no_side_effects", True) or policies_raw.get("side_effects") == "deny",
+            "no_file_write": constraints_raw.get("no_file_write", True) or policies_raw.get("filesystem_write") == "deny",
             "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),
-        }
+        },
+        "behavior_equivalence_false_max_confidence": constraints_raw.get("behavior_equivalence_false_max_confidence", 0.7),
     }
     
+    # Extract policies (v2.1)
+    policies = manifest.get("policies", {})
+    
     # Extract tools policy
     tools = manifest.get("tools", {})
     
@@ -104,6 +110,9 @@ def load_v2_format(module_path: Path) -> dict:
     # Extract failure contract
     failure_contract = manifest.get("failure", {})
     
+    # Extract runtime requirements
+    runtime_requirements = manifest.get("runtime_requirements", {})
+    
     return {
         "name": manifest.get("name", module_path.name),
         "version": manifest.get("version", "1.0.0"),
@@ -116,9 +125,11 @@ def load_v2_format(module_path: Path) -> dict:
         "output_schema": output_schema,
         "error_schema": error_schema,
         "constraints": constraints,
+        "policies": policies,
         "tools": tools,
         "output_contract": output_contract,
         "failure_contract": failure_contract,
+        "runtime_requirements": runtime_requirements,
         "prompt": prompt,
     }