cortexnet 3.2.1__tar.gz → 3.2.3__tar.gz

{cortexnet-3.2.1 → cortexnet-3.2.3}/PKG-INFO

@@ -1,9 +1,13 @@
 Metadata-Version: 2.4
 Name: cortexnet
-Version: 3.2.1
+Version: 3.2.3
 Summary: CortexNet: unified neural network architecture beyond Transformers
 Author: CortexNet Team
 License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/chaojixiaokeai/CortexNet
+Project-URL: Repository, https://github.com/chaojixiaokeai/CortexNet
+Project-URL: Issues, https://github.com/chaojixiaokeai/CortexNet/issues
+Project-URL: Changelog, https://github.com/chaojixiaokeai/CortexNet/blob/main/CHANGELOG.md
 Keywords: deep-learning,llm,state-space-model,sparse-attention,pytorch
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Science/Research
@@ -28,12 +32,19 @@ Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: pyflakes>=3.2.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
 Provides-Extra: distributed
 Requires-Dist: deepspeed>=0.10.0; extra == "distributed"
 Dynamic: license-file
 
 # CortexNet
 
+[![CI](https://github.com/chaojixiaokeai/CortexNet/actions/workflows/ci.yml/badge.svg)](https://github.com/chaojixiaokeai/CortexNet/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/cortexnet.svg)](https://pypi.org/project/cortexnet/)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
+
 `CortexNet` 是一个面向语言建模与推理场景的神经网络架构实现，核心思路是将多尺度状态空间建模、选择性稀疏注意力、记忆系统、条件路由与可选高级推理模块组合到同一框架中。
 
 本仓库已经完成以下整理：
@@ -58,6 +69,13 @@ python -m build
 pip install dist/*.whl
 ```
 
+## CLI
+
+```bash
+python -m cortexnet --version
+python -m cortexnet --smoke-test
+```
+
 ## Quick Start
 
 ```python
@@ -105,10 +123,25 @@ python -m pytest -q
 
 ## Docs
 
+- 文档中心（中英文完整文档）：`docs/README.md`
 - 架构说明：`ARCHITECTURE.md`
 - 模块职责图：`MODULE_MAP.md`
+- 变更记录：`CHANGELOG.md`
+- 贡献指南：`CONTRIBUTING.md`
+- 支持与问题分流：`SUPPORT.md`
+- 安全策略：`SECURITY.md`
+- 示例代码：`examples/README.md`
 
 ## Compatibility Notes
 
 - 对外推荐只使用 `CortexNet`。
 - 历史命名（如 `CortexNetV2` / `CortexNetV3`）仍保留为兼容别名，避免旧代码立即失效。
+
+## Development Commands
+
+```bash
+make install-dev
+make lint
+make test-all
+make check
+```

{cortexnet-3.2.1 → cortexnet-3.2.3}/README.md

@@ -1,5 +1,9 @@
 # CortexNet
 
+[![CI](https://github.com/chaojixiaokeai/CortexNet/actions/workflows/ci.yml/badge.svg)](https://github.com/chaojixiaokeai/CortexNet/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/cortexnet.svg)](https://pypi.org/project/cortexnet/)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
+
 `CortexNet` 是一个面向语言建模与推理场景的神经网络架构实现，核心思路是将多尺度状态空间建模、选择性稀疏注意力、记忆系统、条件路由与可选高级推理模块组合到同一框架中。
 
 本仓库已经完成以下整理：
@@ -24,6 +28,13 @@ python -m build
 pip install dist/*.whl
 ```
 
+## CLI
+
+```bash
+python -m cortexnet --version
+python -m cortexnet --smoke-test
+```
+
 ## Quick Start
 
 ```python
@@ -71,10 +82,25 @@ python -m pytest -q
 
 ## Docs
 
+- 文档中心（中英文完整文档）：`docs/README.md`
 - 架构说明：`ARCHITECTURE.md`
 - 模块职责图：`MODULE_MAP.md`
+- 变更记录：`CHANGELOG.md`
+- 贡献指南：`CONTRIBUTING.md`
+- 支持与问题分流：`SUPPORT.md`
+- 安全策略：`SECURITY.md`
+- 示例代码：`examples/README.md`
 
 ## Compatibility Notes
 
 - 对外推荐只使用 `CortexNet`。
 - 历史命名（如 `CortexNetV2` / `CortexNetV3`）仍保留为兼容别名，避免旧代码立即失效。
+
+## Development Commands
+
+```bash
+make install-dev
+make lint
+make test-all
+make check
+```

{cortexnet-3.2.1 → cortexnet-3.2.3}/cortexnet/__init__.py

@@ -100,7 +100,7 @@ CortexNetV3 = _CortexNetV3
 CortexBlockV2 = _CortexBlockV2
 CortexBlockV3 = _CortexBlockV3
 
-__version__ = "3.2.1"
+__version__ = "3.2.3"
 
 __all__ = [
     "CortexNet",

cortexnet-3.2.3/cortexnet/__main__.py

@@ -0,0 +1,45 @@
+"""CortexNet CLI entrypoint."""
+
+from __future__ import annotations
+
+import argparse
+
+import torch
+
+from . import __version__, CortexNet, CortexNetConfig
+
+
+def _run_smoke_test() -> None:
+    cfg = CortexNetConfig(vocab_size=128, hidden_size=64, num_layers=1, num_heads=2, lite=False)
+    model = CortexNet(cfg).eval()
+    input_ids = torch.randint(0, cfg.vocab_size, (1, 8))
+    with torch.no_grad():
+        out = model(input_ids)
+    print(f"smoke_ok logits_shape={tuple(out['logits'].shape)}")
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(description="CortexNet CLI")
+    parser.add_argument("--version", action="store_true", help="Print installed CortexNet version")
+    parser.add_argument("--smoke-test", action="store_true", help="Run a minimal forward-pass smoke test")
+    return parser
+
+
+def main() -> int:
+    parser = build_parser()
+    args = parser.parse_args()
+
+    if args.version:
+        print(__version__)
+        return 0
+
+    if args.smoke_test:
+        _run_smoke_test()
+        return 0
+
+    parser.print_help()
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{cortexnet-3.2.1 → cortexnet-3.2.3}/cortexnet/compat.py

@@ -12,19 +12,22 @@ CortexNet 兼容模式组件 (Compatibility Mode Components)
 这些组件在 compatibility_mode=True 时替代完整 V3 模块使用。
 """
 
+from __future__ import annotations
+
+from typing import Optional, Tuple
+
 import torch
 import torch.nn as nn
 import torch.nn.functional as F
-from typing import Optional, Tuple
 
 try:
-    from .config import CortexNetConfig
-    from .blocks import RMSNorm
     from .attention import precompute_rope_freqs, apply_rope, apply_rope_with_positions
+    from .blocks import RMSNorm
+    from .config import CortexNetConfig
 except ImportError:
-    from cortexnet.config import CortexNetConfig
-    from cortexnet.blocks import RMSNorm
     from cortexnet.attention import precompute_rope_freqs, apply_rope, apply_rope_with_positions
+    from cortexnet.blocks import RMSNorm
+    from cortexnet.config import CortexNetConfig
 
 
 class _NoOpEvolutionEngine(nn.Module):

{cortexnet-3.2.1 → cortexnet-3.2.3}/cortexnet/multi_agent.py

@@ -29,7 +29,10 @@
       替代了原先的列表推导式串行执行
 """
 
+from __future__ import annotations
+
 import logging
+
 import torch
 import torch.nn as nn
 import torch.nn.functional as F

{cortexnet-3.2.1 → cortexnet-3.2.3}/cortexnet.egg-info/PKG-INFO

@@ -1,9 +1,13 @@
 Metadata-Version: 2.4
 Name: cortexnet
-Version: 3.2.1
+Version: 3.2.3
 Summary: CortexNet: unified neural network architecture beyond Transformers
 Author: CortexNet Team
 License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/chaojixiaokeai/CortexNet
+Project-URL: Repository, https://github.com/chaojixiaokeai/CortexNet
+Project-URL: Issues, https://github.com/chaojixiaokeai/CortexNet/issues
+Project-URL: Changelog, https://github.com/chaojixiaokeai/CortexNet/blob/main/CHANGELOG.md
 Keywords: deep-learning,llm,state-space-model,sparse-attention,pytorch
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Science/Research
@@ -28,12 +32,19 @@ Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: pyflakes>=3.2.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
 Provides-Extra: distributed
 Requires-Dist: deepspeed>=0.10.0; extra == "distributed"
 Dynamic: license-file
 
 # CortexNet
 
+[![CI](https://github.com/chaojixiaokeai/CortexNet/actions/workflows/ci.yml/badge.svg)](https://github.com/chaojixiaokeai/CortexNet/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/cortexnet.svg)](https://pypi.org/project/cortexnet/)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
+
 `CortexNet` 是一个面向语言建模与推理场景的神经网络架构实现，核心思路是将多尺度状态空间建模、选择性稀疏注意力、记忆系统、条件路由与可选高级推理模块组合到同一框架中。
 
 本仓库已经完成以下整理：
@@ -58,6 +69,13 @@ python -m build
 pip install dist/*.whl
 ```
 
+## CLI
+
+```bash
+python -m cortexnet --version
+python -m cortexnet --smoke-test
+```
+
 ## Quick Start
 
 ```python
@@ -105,10 +123,25 @@ python -m pytest -q
 
 ## Docs
 
+- 文档中心（中英文完整文档）：`docs/README.md`
 - 架构说明：`ARCHITECTURE.md`
 - 模块职责图：`MODULE_MAP.md`
+- 变更记录：`CHANGELOG.md`
+- 贡献指南：`CONTRIBUTING.md`
+- 支持与问题分流：`SUPPORT.md`
+- 安全策略：`SECURITY.md`
+- 示例代码：`examples/README.md`
 
 ## Compatibility Notes
 
 - 对外推荐只使用 `CortexNet`。
 - 历史命名（如 `CortexNetV2` / `CortexNetV3`）仍保留为兼容别名，避免旧代码立即失效。
+
+## Development Commands
+
+```bash
+make install-dev
+make lint
+make test-all
+make check
+```

{cortexnet-3.2.1 → cortexnet-3.2.3}/cortexnet.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@ LICENSE
 README.md
 pyproject.toml
 cortexnet/__init__.py
+cortexnet/__main__.py
 cortexnet/adversarial.py
 cortexnet/attention.py
 cortexnet/blocks.py
@@ -29,6 +30,7 @@ cortexnet/transformer_baseline.py
 cortexnet.egg-info/PKG-INFO
 cortexnet.egg-info/SOURCES.txt
 cortexnet.egg-info/dependency_links.txt
+cortexnet.egg-info/entry_points.txt
 cortexnet.egg-info/requires.txt
 cortexnet.egg-info/top_level.txt
 cortexnet/adapter/__init__.py
@@ -41,4 +43,5 @@ cortexnet/ops/__init__.py
 cortexnet/ops/device_manager.py
 cortexnet/ops/npu_ops.py
 tests/test_all.py
-tests/test_core_modules.py
+tests/test_core_modules.py
+tests/test_public_api.py

cortexnet-3.2.3/cortexnet.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+cortexnet = cortexnet.__main__:main

{cortexnet-3.2.1 → cortexnet-3.2.3}/cortexnet.egg-info/requires.txt

@@ -5,6 +5,9 @@ numpy>=1.21.0
 pytest>=7.0
 pytest-cov>=4.0
 ruff>=0.1.0
+pyflakes>=3.2.0
+build>=1.0.0
+twine>=5.0.0
 
 [distributed]
 deepspeed>=0.10.0

{cortexnet-3.2.1 → cortexnet-3.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cortexnet"
-version = "3.2.1"
+version = "3.2.3"
 description = "CortexNet: unified neural network architecture beyond Transformers"
 readme = "README.md"
 license = "Apache-2.0"
@@ -13,6 +13,7 @@ authors = [
     {name = "CortexNet Team"},
 ]
 keywords = ["deep-learning", "llm", "state-space-model", "sparse-attention", "pytorch"]
+urls = {Homepage = "https://github.com/chaojixiaokeai/CortexNet", Repository = "https://github.com/chaojixiaokeai/CortexNet", Issues = "https://github.com/chaojixiaokeai/CortexNet/issues", Changelog = "https://github.com/chaojixiaokeai/CortexNet/blob/main/CHANGELOG.md"}
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Science/Research",
@@ -39,11 +40,17 @@ dev = [
     "pytest>=7.0",
     "pytest-cov>=4.0",
     "ruff>=0.1.0",
+    "pyflakes>=3.2.0",
+    "build>=1.0.0",
+    "twine>=5.0.0",
 ]
 distributed = [
     "deepspeed>=0.10.0",
 ]
 
+[project.scripts]
+cortexnet = "cortexnet.__main__:main"
+
 [tool.setuptools.packages.find]
 include = ["cortexnet*"]
 exclude = ["tests*", "scripts*"]
@@ -59,4 +66,4 @@ line-length = 120
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I"]
-ignore = ["E501"]
+ignore = ["E402", "E501", "I001", "W293"]

cortexnet-3.2.3/tests/test_public_api.py

@@ -0,0 +1,49 @@
+"""Public API contract tests for CortexNet."""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+
+import torch
+
+import cortexnet
+from cortexnet import CortexNet, CortexNetConfig
+
+
+def test_public_api_version() -> None:
+    assert isinstance(cortexnet.__version__, str)
+    assert cortexnet.__version__
+
+
+def test_canonical_model_name_and_aliases() -> None:
+    cfg = CortexNetConfig(vocab_size=128, hidden_size=64, num_layers=1, num_heads=2, lite=False)
+
+    model = CortexNet(cfg)
+    model_v3 = cortexnet.CortexNetV3(cfg)
+
+    assert model.__class__.__name__ == "CortexNet"
+    assert isinstance(model, cortexnet.CortexNetV3)
+    assert isinstance(model_v3, cortexnet.CortexNetV3)
+
+
+def test_forward_smoke_shape() -> None:
+    cfg = CortexNetConfig(vocab_size=128, hidden_size=64, num_layers=1, num_heads=2, lite=False)
+    model = CortexNet(cfg).eval()
+
+    input_ids = torch.randint(0, cfg.vocab_size, (2, 6))
+    with torch.no_grad():
+        out = model(input_ids)
+
+    assert "logits" in out
+    assert out["logits"].shape == (2, 6, cfg.vocab_size)
+
+
+def test_module_cli_version() -> None:
+    result = subprocess.run(
+        [sys.executable, "-m", "cortexnet", "--version"],
+        capture_output=True,
+        text=True,
+        check=True,
+    )
+    assert cortexnet.__version__ in result.stdout.strip()