cognitive-modules 0.3.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

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/registry.py

@@ -17,8 +17,11 @@ import subprocess
 import tempfile
 from pathlib import Path
 from typing import Optional
-from urllib.request import urlopen
+from urllib.request import urlopen, Request
 from urllib.error import URLError
+import zipfile
+import io
+import re
 
 # Standard module search paths
 SEARCH_PATHS = [
@@ -54,9 +57,11 @@ def find_module(name: str) -> Optional[Path]:
     """Find a module by name, searching all paths in order."""
     for base_path in get_search_paths():
         module_path = base_path / name
-        # Support both new and old format
+        # Support v2, v1, and v0 formats
         if module_path.exists():
-            if (module_path / "MODULE.md").exists() or (module_path / "module.md").exists():
+            if (module_path / "module.yaml").exists() or \
+               (module_path / "MODULE.md").exists() or \
+               (module_path / "module.md").exists():
                 return module_path
     return None
 
@@ -75,12 +80,16 @@ def list_modules() -> list[dict]:
                 continue
             if module_dir.name in seen:
                 continue
-            # Support both formats
-            if not ((module_dir / "MODULE.md").exists() or (module_dir / "module.md").exists()):
-                continue
             
-            # Detect format
-            fmt = "new" if (module_dir / "MODULE.md").exists() else "old"
+            # Detect format: v2, v1, or v0
+            if (module_dir / "module.yaml").exists():
+                fmt = "v2"
+            elif (module_dir / "MODULE.md").exists():
+                fmt = "v1"
+            elif (module_dir / "module.md").exists():
+                fmt = "v0"
+            else:
+                continue
             
             seen.add(module_dir.name)
             modules.append({
@@ -105,9 +114,9 @@ def install_from_local(source: Path, name: Optional[str] = None) -> Path:
     if not source.exists():
         raise FileNotFoundError(f"Source not found: {source}")
     
-    # Check for valid module (either format)
-    if not ((source / "MODULE.md").exists() or (source / "module.md").exists()):
-        raise ValueError(f"Not a valid module (missing MODULE.md or module.md): {source}")
+    # Check for valid module (v2, v1, or v0 format)
+    if not _is_valid_module(source):
+        raise ValueError(f"Not a valid module (missing module.yaml, MODULE.md, or module.md): {source}")
     
     module_name = name or source.name
     target = ensure_user_modules_dir() / module_name
@@ -116,9 +125,277 @@ def install_from_local(source: Path, name: Optional[str] = None) -> Path:
         shutil.rmtree(target)
     
     shutil.copytree(source, target)
+    
+    # Record source info for update tracking
+    _record_module_source(module_name, source)
+    
     return target
 
 
+def _record_module_source(
+    name: str,
+    source: Path,
+    github_url: str = None,
+    module_path: str = None,
+    tag: str = None,
+    branch: str = None,
+    version: str = None,
+):
+    """Record module source info for future updates."""
+    manifest_path = Path.home() / ".cognitive" / "installed.json"
+    manifest_path.parent.mkdir(parents=True, exist_ok=True)
+    
+    # Load existing manifest
+    manifest = {}
+    if manifest_path.exists():
+        try:
+            with open(manifest_path, 'r') as f:
+                manifest = json.load(f)
+        except:
+            pass
+    
+    # Get current timestamp
+    from datetime import datetime
+    now = datetime.now().isoformat()
+    
+    # Update entry
+    manifest[name] = {
+        "source": str(source),
+        "github_url": github_url,
+        "module_path": module_path,
+        "tag": tag,
+        "branch": branch,
+        "version": version,
+        "installed_at": str(Path.home() / ".cognitive" / "modules" / name),
+        "installed_time": now,
+    }
+    
+    with open(manifest_path, 'w') as f:
+        json.dump(manifest, f, indent=2)
+
+
+def get_installed_module_info(name: str) -> Optional[dict]:
+    """Get installation info for a module."""
+    manifest_path = Path.home() / ".cognitive" / "installed.json"
+    if not manifest_path.exists():
+        return None
+    
+    try:
+        with open(manifest_path, 'r') as f:
+            manifest = json.load(f)
+        return manifest.get(name)
+    except:
+        return None
+
+
+def get_module_version(module_path: Path) -> Optional[str]:
+    """Extract version from a module's metadata."""
+    import yaml
+    
+    # Try v2 format (module.yaml)
+    yaml_path = module_path / "module.yaml"
+    if yaml_path.exists():
+        try:
+            with open(yaml_path, 'r') as f:
+                data = yaml.safe_load(f)
+            return data.get("version")
+        except:
+            pass
+    
+    # Try v1 format (MODULE.md with frontmatter)
+    md_path = module_path / "MODULE.md"
+    if not md_path.exists():
+        md_path = module_path / "module.md"
+    
+    if md_path.exists():
+        try:
+            with open(md_path, 'r') as f:
+                content = f.read()
+            if content.startswith("---"):
+                parts = content.split("---", 2)
+                if len(parts) >= 3:
+                    meta = yaml.safe_load(parts[1])
+                    return meta.get("version")
+        except:
+            pass
+    
+    return None
+
+
+def update_module(name: str) -> tuple[Path, str, str]:
+    """
+    Update an installed module to the latest version.
+    
+    Returns: (path, old_version, new_version)
+    """
+    info = get_installed_module_info(name)
+    if not info:
+        raise ValueError(f"Module not installed or no source info: {name}")
+    
+    github_url = info.get("github_url")
+    if not github_url:
+        raise ValueError(f"Module was not installed from GitHub, cannot update: {name}")
+    
+    # Get current version
+    current_path = USER_MODULES_DIR / name
+    old_version = get_module_version(current_path) if current_path.exists() else None
+    
+    # Re-install from source
+    module_path = info.get("module_path")
+    tag = info.get("tag")
+    branch = info.get("branch", "main")
+    
+    # If installed with a specific tag, use that tag; otherwise use branch
+    ref = tag if tag else branch
+    
+    new_path = install_from_github_url(
+        url=github_url,
+        module_path=module_path,
+        name=name,
+        tag=tag,
+        branch=branch if not tag else "main",
+    )
+    
+    # Get new version
+    new_version = get_module_version(new_path)
+    
+    return new_path, old_version, new_version
+
+
+def install_from_github_url(
+    url: str,
+    module_path: Optional[str] = None,
+    name: Optional[str] = None,
+    branch: str = "main",
+    tag: Optional[str] = None,
+) -> Path:
+    """
+    Install a module from a GitHub URL without requiring git.
+    
+    Uses GitHub's ZIP download feature for lightweight installation.
+    
+    Args:
+        url: GitHub URL or org/repo shorthand
+        module_path: Path to module within repository
+        name: Override module name
+        branch: Git branch (default: main)
+        tag: Git tag/release version (takes priority over branch)
+    
+    Examples:
+        install_from_github_url("https://github.com/ziel-io/cognitive-modules", 
+                                module_path="cognitive/modules/code-simplifier")
+        install_from_github_url("ziel-io/cognitive-modules", 
+                                module_path="code-simplifier",
+                                tag="v1.0.0")
+    """
+    # Parse shorthand (org/repo)
+    original_url = url
+    if not url.startswith("http"):
+        url = f"https://github.com/{url}"
+    
+    # Extract org/repo from URL
+    match = re.match(r"https://github\.com/([^/]+)/([^/]+)/?", url)
+    if not match:
+        raise ValueError(f"Invalid GitHub URL: {url}")
+    
+    org, repo = match.groups()
+    repo = repo.rstrip(".git")
+    github_url = f"https://github.com/{org}/{repo}"
+    
+    # Build ZIP download URL (tag takes priority over branch)
+    if tag:
+        # Try tag first, then as a release tag
+        zip_url = f"https://github.com/{org}/{repo}/archive/refs/tags/{tag}.zip"
+    else:
+        zip_url = f"https://github.com/{org}/{repo}/archive/refs/heads/{branch}.zip"
+    
+    try:
+        # Download ZIP
+        req = Request(zip_url, headers={"User-Agent": "cognitive-modules/1.0"})
+        with urlopen(req, timeout=30) as response:
+            zip_data = response.read()
+    except URLError as e:
+        if tag:
+            raise RuntimeError(f"Failed to download tag '{tag}' from GitHub: {e}")
+        raise RuntimeError(f"Failed to download from GitHub: {e}")
+    
+    # Extract to temp directory
+    with tempfile.TemporaryDirectory() as tmpdir:
+        tmppath = Path(tmpdir)
+        
+        # Extract ZIP
+        with zipfile.ZipFile(io.BytesIO(zip_data)) as zf:
+            zf.extractall(tmppath)
+        
+        # Find extracted directory (usually repo-branch or repo-tag)
+        extracted_dirs = list(tmppath.iterdir())
+        if not extracted_dirs:
+            raise RuntimeError("ZIP file was empty")
+        repo_root = extracted_dirs[0]
+        
+        # Determine source path
+        if module_path:
+            # Try different module path patterns
+            source = None
+            possible_paths = [
+                repo_root / module_path,
+                repo_root / "cognitive" / "modules" / module_path,
+                repo_root / "modules" / module_path,
+            ]
+            for p in possible_paths:
+                if p.exists() and _is_valid_module(p):
+                    source = p
+                    break
+            
+            if not source:
+                raise FileNotFoundError(
+                    f"Module not found at: {module_path}\n"
+                    f"Searched in: {[str(p.relative_to(repo_root)) for p in possible_paths]}"
+                )
+        else:
+            # Use repo root as module
+            source = repo_root
+            if not _is_valid_module(source):
+                raise ValueError(
+                    f"Repository root is not a valid module. "
+                    f"Use --module to specify the module path."
+                )
+        
+        # Determine module name and version
+        module_name = name or source.name
+        version = get_module_version(source)
+        
+        # Install to user modules dir
+        target = ensure_user_modules_dir() / module_name
+        
+        if target.exists():
+            shutil.rmtree(target)
+        
+        shutil.copytree(source, target)
+        
+        # Record source info for future updates
+        _record_module_source(
+            name=module_name,
+            source=source,
+            github_url=github_url,
+            module_path=module_path,
+            tag=tag,
+            branch=branch,
+            version=version,
+        )
+        
+        return target
+
+
+def _is_valid_module(path: Path) -> bool:
+    """Check if a directory is a valid cognitive module."""
+    return (
+        (path / "module.yaml").exists() or  # v2 format
+        (path / "MODULE.md").exists() or     # v1 format
+        (path / "module.md").exists()         # v0 format
+    )
+
+
 def install_from_git(url: str, subdir: Optional[str] = None, name: Optional[str] = None) -> Path:
     """
     Install a module from a git repository.
@@ -274,3 +551,40 @@ def search_registry(query: str) -> list[dict]:
             })
     
     return results
+
+
+def list_github_tags(url: str, limit: int = 10) -> list[str]:
+    """
+    List available tags/releases from a GitHub repository.
+    
+    Args:
+        url: GitHub URL or org/repo shorthand
+        limit: Maximum number of tags to return
+    
+    Returns:
+        List of tag names (e.g., ["v1.2.0", "v1.1.0", "v1.0.0"])
+    """
+    # Parse shorthand
+    if not url.startswith("http"):
+        url = f"https://github.com/{url}"
+    
+    match = re.match(r"https://github\.com/([^/]+)/([^/]+)/?", url)
+    if not match:
+        raise ValueError(f"Invalid GitHub URL: {url}")
+    
+    org, repo = match.groups()
+    repo = repo.rstrip(".git")
+    
+    # Use GitHub API to get tags
+    api_url = f"https://api.github.com/repos/{org}/{repo}/tags?per_page={limit}"
+    
+    try:
+        req = Request(api_url, headers={
+            "User-Agent": "cognitive-modules/1.0",
+            "Accept": "application/vnd.github.v3+json",
+        })
+        with urlopen(req, timeout=10) as response:
+            data = json.loads(response.read().decode())
+        return [tag["name"] for tag in data]
+    except URLError as e:
+        return []

{cognitive_modules-0.3.0.dist-info → cognitive_modules-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cognitive-modules
-Version: 0.3.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.3.0.dist-info → cognitive_modules-0.4.0.dist-info}/RECORD

@@ -1,15 +1,15 @@
 cognitive/__init__.py,sha256=uSX5NuOWyW0qtq1bnxbzabZ0OQakAtsjF0MWbjQBvwE,401
-cognitive/cli.py,sha256=q0vHCHFmig9gQ85KRyIrX6vrJZFm5nXF_bW5qQRGEPU,14608
+cognitive/cli.py,sha256=A8NUW5nvJpk6H3sJIZWC6HHvuSibR7QKDm0PlVGpwcs,21495
 cognitive/loader.py,sha256=3_ShEfefOMP2EJjpQ1VGTGio4K_GUWLZMQHa0RgvBwg,8715
-cognitive/registry.py,sha256=aBkkpg5PtL_tKDIOXpv6vblB7x_Ax0eVaWgejuQTfCE,8851
+cognitive/registry.py,sha256=qLGyvUxSDP4frs46UlPa5jCcKubqiikWT3Y9JrBqfFc,18549
 cognitive/runner.py,sha256=KFO_pV7YTluYaL98_5bPp_HTNgwsTvlUjgNYlI8mo-w,8467
 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.3.0.dist-info/licenses/LICENSE,sha256=NXFYUy2hPJdh3NHRxMChTnMiQD9k8zFxkmR7gWefexc,1064
-cognitive_modules-0.3.0.dist-info/METADATA,sha256=PcUIJeGz7wr78MHPEdmDRxqKuFLEzX5aEgpMRHfGN-w,11381
-cognitive_modules-0.3.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-cognitive_modules-0.3.0.dist-info/entry_points.txt,sha256=PKHlfrFmve5K2349ryipySKbOOsKxo_vIq1NNT-iBV0,42
-cognitive_modules-0.3.0.dist-info/top_level.txt,sha256=kGIfDucCKylo8cRBtxER_v3DHIea-Sol9x9YSJo1u3Y,10
-cognitive_modules-0.3.0.dist-info/RECORD,,
+cognitive_modules-0.4.0.dist-info/licenses/LICENSE,sha256=NXFYUy2hPJdh3NHRxMChTnMiQD9k8zFxkmR7gWefexc,1064
+cognitive_modules-0.4.0.dist-info/METADATA,sha256=iF4YKfLj1CzOZuoYDH0JjuH_S2eh7MbV91KQfm-pdoI,11833
+cognitive_modules-0.4.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+cognitive_modules-0.4.0.dist-info/entry_points.txt,sha256=1yqKB-MjHrRoe8FcYm-TgZDqGEZxzBPsd0xC4pcfBNU,43
+cognitive_modules-0.4.0.dist-info/top_level.txt,sha256=kGIfDucCKylo8cRBtxER_v3DHIea-Sol9x9YSJo1u3Y,10
+cognitive_modules-0.4.0.dist-info/RECORD,,

cognitive_modules-0.4.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cogn = cognitive.cli:app

cognitive_modules-0.3.0.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-cog = cognitive.cli:app