Metadata-Version: 2.4
Name: cognition-engine
Version: 0.5.1
Summary: Aggregate distribution package for the Cognition Engine v0.5.0 multi-package baseline.
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.14
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cognition-engine-schemas==0.5.1
Requires-Dist: cognition-engine-behavior-contracts==0.5.1
Requires-Dist: cognition-engine-config-contexts==0.5.1
Requires-Dist: cognition-engine-config-assembly==0.5.1
Requires-Dist: cognition-engine-runtime==0.5.1
Requires-Dist: cognition-engine-composition==0.5.1
Requires-Dist: cognition-engine-contract-core==0.5.1
Requires-Dist: cognition-engine-adk-adapter==0.5.1
Requires-Dist: cognition-engine-observability-hub==0.5.1
Requires-Dist: cognition-engine-runtime-container==0.5.1
Provides-Extra: release
Requires-Dist: build>=1.4.4; extra == "release"
Requires-Dist: twine>=6.2.0; extra == "release"
Provides-Extra: test
Requires-Dist: pytest>=9.0.3; extra == "test"
Requires-Dist: pytest-cov>=7.1.0; extra == "test"
Requires-Dist: pytest-mock>=3.15.1; extra == "test"
Requires-Dist: pytest-asyncio>=1.3.0; extra == "test"
Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
Requires-Dist: pytest-timeout>=2.4.0; extra == "test"
Requires-Dist: factory-boy>=3.3.3; extra == "test"
Requires-Dist: Faker>=40.15.0; extra == "test"
Requires-Dist: freezegun>=1.5.5; extra == "test"
Requires-Dist: hypothesis>=6.152.1; extra == "test"
Requires-Dist: pytest-html>=4.2.0; extra == "test"
Requires-Dist: pytest-json-report>=1.5.0; extra == "test"
Dynamic: license-file

# 认知引擎

认知引擎是一个面向 AI 协作研发场景的治理型运行控制面项目。

当前公开版本：`v0.5.1`

v0.5.1 是认知引擎在 `v0.5.0` 模块化包结构基线之后的发布工程补丁版本。本版本重点补强 PyPI 包元数据、子包发布说明接入、多包构建检查与公开安装验证路径，为后续更稳定的发布流程和运行控制面能力演进提供基础。

## 当前版本定位

v0.5.1 聚焦于发布工程补丁，重点包括：

1. 将 10 个子包的 README 接入 PyPI long_description；
2. 清零子包 `twine check` 中的 long_description 相关 warning；
3. 将根包与 10 个子包版本同步到 `0.5.1`；
4. 将根包依赖同步到 `cognition-engine-*==0.5.1`；
5. 保持根聚合包与子包的模块化发布结构；
6. 保持公开主线为模块化包结构，不扩大为完整产品化运行时平台。

## 当前包结构

当前公开主线包含以下主要能力区域：

- `contract_core`
- `runtime_container`
- `adk_adapter`
- `observability_hub`

同时包含以下支撑性结构：

- schemas
- behavior contracts
- configuration contexts
- configuration assembly
- runtime primitives
- composition

## 安装方式

从 PyPI 安装：

```bash
uv pip install --prerelease=allow cognition-engine==0.5.1
```

说明：v0.5.1 当前依赖 `google-adk>=2.0.0b1`，安装时需要允许预发布依赖解析。

或从源码安装：

```bash
git clone https://github.com/peacock-lab/cognition-engine.git
cd cognition-engine
pip install .
```

## 最小验证路径

完成安装后，可执行 v0.5.1 主线包导入 smoke 验证：

```bash
python -c "import contract_core, runtime_container, adk_adapter, observability_hub; print('cognition-engine 0.5.1 import ok')"
```

如需在源码开发环境中运行测试，可执行：

```bash
pytest
```

## 当前能力边界

v0.5.1 主要修补公开包发布元数据、构建检查和安装验证基础，不承诺完整产品化运行时平台。

当前版本不承诺：

1. 完整智能体治理闭环；
2. 完整控制台或可视化后台；
3. 完整生产级多模型调度；
4. 完整企业级配置中心；
5. 完整 ADK 能力封装替代；
6. 自动 PyPI 发布、自动 tag 或自动 GitHub Release。

## 文档入口

- 快速开始：`QUICKSTART.md`
- 版本历史：`CHANGELOG.md`
- 版本发布记录：GitHub Releases
- 包发布记录：PyPI
