cognitive-modules 0.5.0__py3-none-any.whl → 0.5.1__py3-none-any.whl

cognitive/__init__.py

@@ -9,4 +9,4 @@ Usage:
     cog doctor                   # Check environment setup
 """
 
-__version__ = "0.5.0"
+__version__ = "0.5.1"

cognitive/loader.py

@@ -166,12 +166,23 @@ def load_v2_format(module_path: Path) -> dict:
     tier: Optional[ModuleTier] = manifest.get("tier")
     schema_strictness: SchemaStrictness = manifest.get("schema_strictness", "medium")
     
-    overflow = manifest.get("overflow", {
-        "enabled": False,
-        "recoverable": True,
-        "max_items": 5,
-        "require_suggested_mapping": True
-    })
+    # Determine default max_items based on strictness (SPEC-v2.2)
+    # high=0 (disabled), medium=5, low=20
+    strictness_max_items = {
+        "high": 0,
+        "medium": 5,
+        "low": 20
+    }
+    default_max_items = strictness_max_items.get(schema_strictness, 5)
+    default_enabled = schema_strictness != "high"
+    
+    overflow_raw = manifest.get("overflow", {})
+    overflow = {
+        "enabled": overflow_raw.get("enabled", default_enabled),
+        "recoverable": overflow_raw.get("recoverable", True),
+        "max_items": overflow_raw.get("max_items", default_max_items),
+        "require_suggested_mapping": overflow_raw.get("require_suggested_mapping", True)
+    }
     
     enums = manifest.get("enums", {
         "strategy": "extensible" if tier in ("decision", "exploration") else "strict",

cognitive/runner.py

@@ -80,21 +80,49 @@ EnvelopeResponse = Union[EnvelopeResponseV22, EnvelopeSuccessV21, EnvelopeFailur
 RISK_LEVELS = {"none": 0, "low": 1, "medium": 2, "high": 3}
 RISK_NAMES = ["none", "low", "medium", "high"]
 
+RiskRule = Literal["max_changes_risk", "max_issues_risk", "explicit"]
 
-def aggregate_risk(changes: list[dict]) -> RiskLevel:
-    """Compute max risk from list of changes."""
-    if not changes:
+
+def aggregate_risk_from_list(items: list[dict]) -> RiskLevel:
+    """Compute max risk from list of items with risk field."""
+    if not items:
         return "medium"  # Default conservative
     
     max_level = 0
-    for change in changes:
-        risk = change.get("risk", "medium")
+    for item in items:
+        risk = item.get("risk", "medium")
         level = RISK_LEVELS.get(risk, 2)
         max_level = max(max_level, level)
     
     return RISK_NAMES[max_level]
 
 
+def aggregate_risk(
+    data: dict,
+    risk_rule: RiskRule = "max_changes_risk"
+) -> RiskLevel:
+    """
+    Compute aggregated risk based on risk_rule.
+    
+    Rules:
+    - max_changes_risk: max(data.changes[*].risk) - default
+    - max_issues_risk: max(data.issues[*].risk) - for review modules
+    - explicit: return "medium", module should set risk explicitly
+    """
+    if risk_rule == "max_changes_risk":
+        changes = data.get("changes", [])
+        return aggregate_risk_from_list(changes)
+    elif risk_rule == "max_issues_risk":
+        issues = data.get("issues", [])
+        return aggregate_risk_from_list(issues)
+    elif risk_rule == "explicit":
+        return "medium"  # Module should override
+    else:
+        # Fallback to changes
+        changes = data.get("changes", [])
+        return aggregate_risk_from_list(changes)
+
+
 # =============================================================================
 # Schema Validation
 # =============================================================================
@@ -120,15 +148,19 @@ def validate_data(data: dict, schema: dict, label: str = "Data") -> list[str]:
 def repair_envelope(
     data: dict,
     meta_schema: Optional[dict] = None,
-    max_explain_length: int = 280
+    max_explain_length: int = 280,
+    risk_rule: RiskRule = "max_changes_risk"
 ) -> dict:
     """
     Attempt to repair envelope format issues without changing semantics.
     
-    Repairs:
+    Repairs (lossless only):
     - Missing meta fields (fill with conservative defaults)
     - Truncate explain if too long
-    - Normalize risk enum values
+    - Trim whitespace from string fields
+    
+    Does NOT repair:
+    - Invalid enum values (treated as validation failure)
     """
     repaired = dict(data)
     
@@ -148,28 +180,28 @@ def repair_envelope(
     if isinstance(meta.get("confidence"), (int, float)):
         meta["confidence"] = max(0.0, min(1.0, float(meta["confidence"])))
     
-    # Repair risk
+    # Repair risk - use configurable aggregation rule
     if "risk" not in meta:
-        # Aggregate from changes if available
-        changes = data_payload.get("changes", [])
-        meta["risk"] = aggregate_risk(changes)
-    
-    # Normalize risk value
-    risk = str(meta.get("risk", "medium")).lower()
-    if risk not in RISK_LEVELS:
-        meta["risk"] = "medium"
-    else:
-        meta["risk"] = risk
+        meta["risk"] = aggregate_risk(data_payload, risk_rule)
+    
+    # Trim whitespace from risk (lossless), but do NOT invent new values
+    if isinstance(meta.get("risk"), str):
+        meta["risk"] = meta["risk"].strip().lower()
+        # If invalid after trim, leave as-is (validation will catch it)
     
     # Repair explain
     if "explain" not in meta:
         # Try to extract from rationale
         rationale = data_payload.get("rationale", "")
         if rationale:
-            meta["explain"] = rationale[:max_explain_length]
+            meta["explain"] = str(rationale)[:max_explain_length]
         else:
             meta["explain"] = "No explanation provided"
     
+    # Trim whitespace from explain (lossless)
+    if isinstance(meta.get("explain"), str):
+        meta["explain"] = meta["explain"].strip()
+    
     # Truncate explain if too long
     if len(meta.get("explain", "")) > max_explain_length:
         meta["explain"] = meta["explain"][:max_explain_length - 3] + "..."
@@ -230,13 +262,12 @@ def wrap_v21_to_v22(v21_response: dict) -> EnvelopeResponseV22:
         # Extract or compute meta fields
         confidence = data.get("confidence", 0.5)
         rationale = data.get("rationale", "")
-        changes = data.get("changes", [])
         
         return {
             "ok": True,
             "meta": {
                 "confidence": confidence,
-                "risk": aggregate_risk(changes),
+                "risk": aggregate_risk(data),  # Uses default max_changes_risk
                 "explain": rationale[:280] if rationale else "No explanation provided"
             },
             "data": data
@@ -279,13 +310,12 @@ def convert_legacy_to_envelope(data: dict, is_error: bool = False) -> EnvelopeRe
         # Legacy success response - data is the payload itself
         confidence = data.get("confidence", 0.5)
         rationale = data.get("rationale", "")
-        changes = data.get("changes", [])
         
         return {
             "ok": True,
             "meta": {
                 "confidence": confidence,
-                "risk": aggregate_risk(changes),
+                "risk": aggregate_risk(data),  # Uses default max_changes_risk
                 "explain": rationale[:280] if rationale else "No explanation provided"
             },
             "data": data
@@ -513,13 +543,17 @@ def run_module(
         data_schema = module.get("data_schema") or module.get("output_schema")
         meta_schema = module.get("meta_schema")
         
+        # Get risk_rule from module.yaml meta config
+        meta_config = module.get("metadata", {}).get("meta", {})
+        risk_rule = meta_config.get("risk_rule", "max_changes_risk")
+        
         if data_schema:
             data_to_validate = result.get("data", {})
             errors = validate_data(data_to_validate, data_schema, "Data")
             
             if errors and enable_repair:
                 # Attempt repair pass
-                result = repair_envelope(result, meta_schema)
+                result = repair_envelope(result, meta_schema, risk_rule=risk_rule)
                 
                 # Re-validate after repair
                 errors = validate_data(result.get("data", {}), data_schema, "Data")
@@ -540,7 +574,7 @@ def run_module(
         if meta_schema:
             meta_errors = validate_data(result.get("meta", {}), meta_schema, "Meta")
             if meta_errors and enable_repair:
-                result = repair_envelope(result, meta_schema)
+                result = repair_envelope(result, meta_schema, risk_rule=risk_rule)
     
     return result
 

{cognitive_modules-0.5.0.dist-info → cognitive_modules-0.5.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cognitive-modules
-Version: 0.5.0
+Version: 0.5.1
 Summary: Structured LLM task runner with schema validation, confidence scoring, and subagent orchestration
 Author: ziel-io
 License: MIT
@@ -105,10 +105,10 @@ pip install cognitive-modules[all]         # 全部
 
 ```bash
 # 全局安装
-npm install -g cognitive-modules-cli
+npm install -g cogn
 
-# 或 npx 零安装使用
-npx cognitive-modules-cli --help
+# 或 npx 零安装使用（推荐）
+npx cogn --help
 ```
 
 | 平台 | 包名 | 命令 |
@@ -402,7 +402,7 @@ cogn validate my-module --v22
 
 ```
 cognitive-modules/
-├── src/cognitive/          # CLI 源码
+├── src/cognitive/          # Python CLI 源码
 │   ├── cli.py              # 命令入口
 │   ├── loader.py           # 模块加载（支持 v0/v1/v2.2）
 │   ├── runner.py           # 模块执行（v2.2 envelope）
@@ -412,7 +412,12 @@ cognitive-modules/
 │   ├── registry.py         # 模块安装
 │   ├── templates.py        # 模块模板
 │   └── providers/          # LLM 后端
+├── packages/
+│   └── cli-node/           # Node.js CLI (npm: cognitive-modules-cli)
+│       ├── src/            # TypeScript 源码
+│       └── package.json
 ├── cognitive/modules/      # 内置模块（全部 v2.2）
+├── coze-plugin/            # Coze 集成插件
 ├── tests/                  # 单元测试
 ├── SPEC.md                 # v0.1 规范（历史）
 ├── SPEC-v2.2.md            # v2.2 规范（最新）
@@ -420,6 +425,15 @@ cognitive-modules/
 └── cognitive-registry.json # 公共注册表
 ```
 
+## 多平台支持
+
+| 平台 | 包名 | 命令 | 安装 |
+|------|------|------|------|
+| Python | `cognitive-modules` | `cogn` | `pip install cognitive-modules` |
+| Node.js | `cogn` | `cog` | `npm install -g cogn` 或 `npx cogn` |
+
+两个版本共享相同的模块格式和 v2.2 规范。
+
 ## 文档
 
 - [SPEC-v2.2.md](SPEC-v2.2.md) - v2.2 完整规范（Control/Data 分离、Tier、Overflow）

{cognitive_modules-0.5.0.dist-info → cognitive_modules-0.5.1.dist-info}/RECORD

@@ -1,18 +1,18 @@
-cognitive/__init__.py,sha256=pFMrHFn6hsXl4Jd5bosCmWcUnJcwYwPrS7qg1Ogxxhk,401
+cognitive/__init__.py,sha256=FY2NWSVD9Lq_L9DrUPjkacIex_tD2P1xYrC9qawrMYM,401
 cognitive/cli.py,sha256=tYYWkFJt-eBtWF3GwokuqIZz6vFIP3ZJj7yls1cru6E,26778
-cognitive/loader.py,sha256=p3uS5LbAhRxWnRhMsSGzlGqohAxHzVZjPm1WKtoeYes,14537
+cognitive/loader.py,sha256=NgFNcGXO56_1T1qxdvwWrpE37NoysTpuKhcQtchnros,15052
 cognitive/mcp_server.py,sha256=NUQT7IqdYB9tQ-1YYfG5MPJuq6A70FXlcV2x3lBnuvM,6852
 cognitive/migrate.py,sha256=15CXw0qWVFbC-kPau1bzPBirs8kg_b_E_1YANlJ34uI,19679
 cognitive/registry.py,sha256=qLGyvUxSDP4frs46UlPa5jCcKubqiikWT3Y9JrBqfFc,18549
-cognitive/runner.py,sha256=36b9pHa4Jiw01aslK_eFFamqHreLJ-t--nYcukmzuW4,19771
+cognitive/runner.py,sha256=kXfU3A6Per1aZ8wB26XseX48sP51FrydJ47Lgs6PHpY,21240
 cognitive/server.py,sha256=cz8zGqhGrZgFY-HM0RSCjPCpB_Mfg1jsybeoo2ALvAc,9041
 cognitive/subagent.py,sha256=fb7LWwNF6YcJtC_T1dK0EvzqWMBnav-kiCIpvVohEBw,8142
 cognitive/templates.py,sha256=lKC197X9aQIA-npUvVCaplSwvhxjsH_KYVCQtrTZrL4,4712
 cognitive/validator.py,sha256=8B02JQQdNcwvH-mtbyP8bVTRQxUrO9Prt4gU0N53fdg,21843
 cognitive/providers/__init__.py,sha256=hqhVA1IEXpVtyCAteXhO5yD8a8ikQpVIPEKJVHLtRFY,7492
-cognitive_modules-0.5.0.dist-info/licenses/LICENSE,sha256=NXFYUy2hPJdh3NHRxMChTnMiQD9k8zFxkmR7gWefexc,1064
-cognitive_modules-0.5.0.dist-info/METADATA,sha256=nHK8DmSqc1tHhwxpzTKg5AUTl2walIHNBv_LP-ErF3s,12842
-cognitive_modules-0.5.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-cognitive_modules-0.5.0.dist-info/entry_points.txt,sha256=1yqKB-MjHrRoe8FcYm-TgZDqGEZxzBPsd0xC4pcfBNU,43
-cognitive_modules-0.5.0.dist-info/top_level.txt,sha256=kGIfDucCKylo8cRBtxER_v3DHIea-Sol9x9YSJo1u3Y,10
-cognitive_modules-0.5.0.dist-info/RECORD,,
+cognitive_modules-0.5.1.dist-info/licenses/LICENSE,sha256=NXFYUy2hPJdh3NHRxMChTnMiQD9k8zFxkmR7gWefexc,1064
+cognitive_modules-0.5.1.dist-info/METADATA,sha256=m_Yf3eZtNFAVeKWdvtHquUB3BUFDVyqHkqCJo45Ghco,13361
+cognitive_modules-0.5.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+cognitive_modules-0.5.1.dist-info/entry_points.txt,sha256=1yqKB-MjHrRoe8FcYm-TgZDqGEZxzBPsd0xC4pcfBNU,43
+cognitive_modules-0.5.1.dist-info/top_level.txt,sha256=kGIfDucCKylo8cRBtxER_v3DHIea-Sol9x9YSJo1u3Y,10
+cognitive_modules-0.5.1.dist-info/RECORD,,