claude-autosar 0.3.0__tar.gz

claude_autosar-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AutoC Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

claude_autosar-0.3.0/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: claude-autosar
+Version: 0.3.0
+Summary: claude-autosar - AUTOSAR BSW 双格式 (.arxml + .xdm) 配置 IO / 模板 diff / lint / verify 工具集
+Author: AutoC Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/autoc-cc/autoc-cc
+Project-URL: Repository, https://github.com/autoc-cc/autoc-cc
+Project-URL: Issues, https://github.com/autoc-cc/autoc-cc/issues
+Project-URL: Changelog, https://github.com/autoc-cc/autoc-cc/blob/main/CHANGELOG.md
+Keywords: autosar,bsw,tresos,davinci,arxml,ecu,embedded,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Manufacturing
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Embedded Systems
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: lxml>=5.0
+Requires-Dist: cantools>=39.0
+Requires-Dist: rich>=13.0
+Requires-Dist: mcp>=0.9
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: tomli-w>=1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: black>=24.4; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: isort>=5.13; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: bandit>=1.7; extra == "dev"
+Requires-Dist: pip-audit>=2.7; extra == "dev"
+Requires-Dist: pre-commit>=3.7; extra == "dev"
+Dynamic: license-file
+
+# autoc — AUTOSAR BSW AI 配置助手（Python 核心）
+
+`autoc` 是 AutoC Claude Code 插件的 Python 核心包。对 EB tresos / DaVinci
+Configurator 的 BSW 配置做读、改、验证、归档、导出，与 Claude Code 通过
+MCP 协议对接。
+
+## 特性
+
+- **不可变数据模型**：`BSWModule` / `BSWParam` / `ParamValue`（`frozen=True`，
+  `with_X()` 返回新实例）
+- **MCU 差异化解耦**：`TresosAdapter.discover()` 数据驱动 — 同一段代码
+  处理 S32K3 / TC3xx / RH850，**无 if/else 分支**
+- **协议层抽象**：`typing.Protocol + @runtime_checkable`；测试用
+  `StubTresosAdapter` / `StubDavinciAdapter`，CI 不依赖商业工具
+- **ARXML 读写**：lxml 自写 `ARXMLDocument` / ECUC 解析（reference chain
+  + type 启发式），无 `pyecarxml` 等不确定外部依赖
+- **会话 / 改参日志 / 导出**：JSONL append-only 存储 + 不可变树 + fork
+  + 自包含 HTML 导出（XSS 白名单 + 三色 callout）
+- **MCP server**：FastMCP 10 工具（`bsw_read` / `bsw_write` / `bsw_verify` /
+  `bsw_autocalc` / `arxml_validate` / `dbc_parse` / `session_list` /
+  `session_show` / `session_export` / `log_export`）
+- **路径防御**：MCP 工具的 `project` / `tresos_home` 入参在白名单
+  `_ALLOWED_PROJECT_ROOTS`（cwd）之内（ISO 21434 信任边界）
+
+## 安装
+
+```bash
+pip install claude-autosar
+```
+
+开发模式（含 dev 依赖）：
+
+```bash
+pip install -e ".[dev]"
+```
+
+## 快速上手
+
+CLI 入口 `autoc`（由 `pyproject.toml` `[project.scripts]` 提供）：
+
+```bash
+autoc --version
+autoc --help
+
+# 改 EB tresos 工程下 Mcu 模块的两个参数
+autoc eb save \
+  --project /path/to/tresos/project \
+  --module Mcu \
+  --param "Mcu/ClockConfiguration/McuClockSettingConfig_0/McuClockReferencePointFrequency=80000000" \
+  --param "Mcu/SecConfig/SecurityAttributeConfig_0/McuSecRam=ENABLE"
+```
+
+MCP 集成：在 Claude Code 子 Agent 里直接调用 `bsw_write` / `arxml_validate` /
+`session_export` 等工具，路径同 `autoc` 子命令。
+
+## 项目状态
+
+| 维度 | 值 |
+|---|---|
+| 测试 | **467 passed**（autoc 442 + plugin 25）|
+| Coverage | **90.07%**（mcp_server 47%→91%，+44pp）|
+| 静态检查 | ruff / isort / black / mypy strict 全清 |
+| 安全 | bandit -ll 0 H/M（7 low 全是 subprocess 模式 + 1 path-traversal 防御）；pip-audit 0 H/M（autoc 运行时无漏洞，3 个 transitive CVE 已记录在 SECURITY.md）|
+| Python | 3.11 / 3.12 / 3.13 |
+| License | MIT |
+
+完整 sprint-by-sprint 进度交接见 [PROGRESS.md](https://github.com/autoc-cc/autoc-cc/blob/main/PROGRESS.md)。
+
+## 目录结构
+
+```
+src/autoc/
+├── __init__.py / __main__.py
+├── cli/
+│   ├── main.py                # argparse 入口（dispatch 表 + 全局 flags）
+│   ├── repl_skin.py           # Rich 主题 + ReplSkin 业务 API
+│   ├── mcp_server.py          # FastMCP 10 工具
+│   └── commands/              # eb / davinci / session / log / export
+├── core/
+│   ├── bsw/                   # BSW 数据模型 + ARXML/ECUC 解析 + 验证
+│   ├── settings/              # 配置合并（<cwd>/.autoc/ + ~/.autoc/agent/）
+│   ├── session/               # JSONL store + 不可变树 + recorder + exporter
+│   └── log/                   # 改参 changelog
+├── adapters/                  # EB tresos / DaVinci / stub
+└── utils/                     # 跨平台路径
+```
+
+## 配套插件
+
+`autoc` 是 Python 核心；要让 Claude Code 在 `~/.autoc/agent/` 工程里直接
+调它，需要装
+[autoc-cc 插件](https://github.com/autoc-cc/autoc-cc/tree/main/packages/plugin)：
+7 个 `/autoc:*` 斜杠命令、7 个 skill、3 个 hook（ARXML guard / BSW
+validate / SessionStart 项目检测）、1 个 agent（bsw-config）、`.mcp.json`
+直接挂到本包。
+
+## License
+
+MIT — 详见 [LICENSE](https://github.com/autoc-cc/autoc-cc/blob/main/packages/autoc/LICENSE)

claude_autosar-0.3.0/README.md

@@ -0,0 +1,99 @@
+# autoc — AUTOSAR BSW AI 配置助手（Python 核心）
+
+`autoc` 是 AutoC Claude Code 插件的 Python 核心包。对 EB tresos / DaVinci
+Configurator 的 BSW 配置做读、改、验证、归档、导出，与 Claude Code 通过
+MCP 协议对接。
+
+## 特性
+
+- **不可变数据模型**：`BSWModule` / `BSWParam` / `ParamValue`（`frozen=True`，
+  `with_X()` 返回新实例）
+- **MCU 差异化解耦**：`TresosAdapter.discover()` 数据驱动 — 同一段代码
+  处理 S32K3 / TC3xx / RH850，**无 if/else 分支**
+- **协议层抽象**：`typing.Protocol + @runtime_checkable`；测试用
+  `StubTresosAdapter` / `StubDavinciAdapter`，CI 不依赖商业工具
+- **ARXML 读写**：lxml 自写 `ARXMLDocument` / ECUC 解析（reference chain
+  + type 启发式），无 `pyecarxml` 等不确定外部依赖
+- **会话 / 改参日志 / 导出**：JSONL append-only 存储 + 不可变树 + fork
+  + 自包含 HTML 导出（XSS 白名单 + 三色 callout）
+- **MCP server**：FastMCP 10 工具（`bsw_read` / `bsw_write` / `bsw_verify` /
+  `bsw_autocalc` / `arxml_validate` / `dbc_parse` / `session_list` /
+  `session_show` / `session_export` / `log_export`）
+- **路径防御**：MCP 工具的 `project` / `tresos_home` 入参在白名单
+  `_ALLOWED_PROJECT_ROOTS`（cwd）之内（ISO 21434 信任边界）
+
+## 安装
+
+```bash
+pip install claude-autosar
+```
+
+开发模式（含 dev 依赖）：
+
+```bash
+pip install -e ".[dev]"
+```
+
+## 快速上手
+
+CLI 入口 `autoc`（由 `pyproject.toml` `[project.scripts]` 提供）：
+
+```bash
+autoc --version
+autoc --help
+
+# 改 EB tresos 工程下 Mcu 模块的两个参数
+autoc eb save \
+  --project /path/to/tresos/project \
+  --module Mcu \
+  --param "Mcu/ClockConfiguration/McuClockSettingConfig_0/McuClockReferencePointFrequency=80000000" \
+  --param "Mcu/SecConfig/SecurityAttributeConfig_0/McuSecRam=ENABLE"
+```
+
+MCP 集成：在 Claude Code 子 Agent 里直接调用 `bsw_write` / `arxml_validate` /
+`session_export` 等工具，路径同 `autoc` 子命令。
+
+## 项目状态
+
+| 维度 | 值 |
+|---|---|
+| 测试 | **467 passed**（autoc 442 + plugin 25）|
+| Coverage | **90.07%**（mcp_server 47%→91%，+44pp）|
+| 静态检查 | ruff / isort / black / mypy strict 全清 |
+| 安全 | bandit -ll 0 H/M（7 low 全是 subprocess 模式 + 1 path-traversal 防御）；pip-audit 0 H/M（autoc 运行时无漏洞，3 个 transitive CVE 已记录在 SECURITY.md）|
+| Python | 3.11 / 3.12 / 3.13 |
+| License | MIT |
+
+完整 sprint-by-sprint 进度交接见 [PROGRESS.md](https://github.com/autoc-cc/autoc-cc/blob/main/PROGRESS.md)。
+
+## 目录结构
+
+```
+src/autoc/
+├── __init__.py / __main__.py
+├── cli/
+│   ├── main.py                # argparse 入口（dispatch 表 + 全局 flags）
+│   ├── repl_skin.py           # Rich 主题 + ReplSkin 业务 API
+│   ├── mcp_server.py          # FastMCP 10 工具
+│   └── commands/              # eb / davinci / session / log / export
+├── core/
+│   ├── bsw/                   # BSW 数据模型 + ARXML/ECUC 解析 + 验证
+│   ├── settings/              # 配置合并（<cwd>/.autoc/ + ~/.autoc/agent/）
+│   ├── session/               # JSONL store + 不可变树 + recorder + exporter
+│   └── log/                   # 改参 changelog
+├── adapters/                  # EB tresos / DaVinci / stub
+└── utils/                     # 跨平台路径
+```
+
+## 配套插件
+
+`autoc` 是 Python 核心；要让 Claude Code 在 `~/.autoc/agent/` 工程里直接
+调它，需要装
+[autoc-cc 插件](https://github.com/autoc-cc/autoc-cc/tree/main/packages/plugin)：
+7 个 `/autoc:*` 斜杠命令、7 个 skill、3 个 hook（ARXML guard / BSW
+validate / SessionStart 项目检测）、1 个 agent（bsw-config）、`.mcp.json`
+直接挂到本包。
+
+## License
+
+MIT — 详见 [LICENSE](https://github.com/autoc-cc/autoc-cc/blob/main/packages/autoc/LICENSE)

claude_autosar-0.3.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "claude-autosar"
+version = "0.3.0"
+description = "claude-autosar - AUTOSAR BSW 双格式 (.arxml + .xdm) 配置 IO / 模板 diff / lint / verify 工具集"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [
+    { name = "AutoC Contributors" },
+]
+keywords = ["autosar", "bsw", "tresos", "davinci", "arxml", "ecu", "embedded", "mcp"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Manufacturing",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Embedded Systems",
+    "Typing :: Typed",
+]
+dependencies = [
+    "lxml>=5.0",
+    "cantools>=39.0",
+    "rich>=13.0",
+    "mcp>=0.9",
+    "platformdirs>=4.0",
+    "tomli-w>=1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/autoc-cc/autoc-cc"
+Repository = "https://github.com/autoc-cc/autoc-cc"
+Issues = "https://github.com/autoc-cc/autoc-cc/issues"
+Changelog = "https://github.com/autoc-cc/autoc-cc/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "pytest-asyncio>=0.23",
+    "black>=24.4",
+    "ruff>=0.5",
+    "isort>=5.13",
+    "mypy>=1.10",
+    "bandit>=1.7",
+    "pip-audit>=2.7",
+    "pre-commit>=3.7",
+]
+
+[project.scripts]
+claude-autosar = "claude_autosar.cli.main:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+claude_autosar = ["py.typed"]

claude_autosar-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

claude_autosar-0.3.0/src/claude_autosar/__init__.py

@@ -0,0 +1,15 @@
+"""AutoC - AUTOSAR BSW 配置 AI 助手 Python 核心。
+
+AutoC 是一个面向 AUTOSAR BSW 工程师的终端 AI 助手：用自然语言描述
+时钟、引脚、模块等配置目标，AI 在工程里完成改参、依赖计算与校验，
+并根据结果继续调整，直到配置通过。
+
+本包提供：
+    - 命令行入口（cli.main）
+    - BSW 领域数据模型（core.bsw）
+    - 工具适配器（adapters）
+    - 工具与配置（utils, core.settings）
+"""
+
+__version__ = "0.1.0"
+__all__ = ["__version__"]

claude_autosar-0.3.0/src/claude_autosar/__main__.py

@@ -0,0 +1,6 @@
+"""python -m autoc 入口。"""
+
+from claude_autosar.cli.main import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

claude_autosar-0.3.0/src/claude_autosar/adapters/__init__.py

@@ -0,0 +1,7 @@
+"""autoc 工具适配器层。
+
+封装对 EB tresos / DaVinci Configurator 等 AUTOSAR 商业工具的 subprocess 调用，
+对外暴露 ``Protocol`` 接口（``adapters.protocol``），便于：
+    - 单元测试时用 ``StubAdapter`` 替换
+    - 未来接入其它工具时只换实现，不动业务层
+"""

claude_autosar-0.3.0/src/claude_autosar/adapters/davinci.py

@@ -0,0 +1,161 @@
+"""DaVinci Configurator 适配器默认实现。
+
+对应 Vector ``DVCfgCmd.exe`` 命令行工具。``DVCfgCmd`` 默认在
+``${SIP}/DaVinciConfigurator/Core/DVCfgCmd.exe``（SIP 路径从 ``.dpa`` 解析，
+本适配器复用 ``EcuConfigProjectContext.tool_home`` 字段作 DAVINCI_HOME，调用方
+按需从 ``.dpa`` 解析后填入）。
+
+当前 Sprint 2 仅实现 verify / save 两个核心子命令，覆盖率需求 80%+
+（Sprint 3+ 会扩展 ``Generate`` / ``Import`` 等）。
+"""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+import re
+import subprocess
+
+from claude_autosar.adapters.protocol import (
+    EcuConfigProjectContext,
+    SaveResult,
+    VerifyResult,
+)
+
+
+class DavinciAdapterError(RuntimeError):
+    """DaVinci 适配器错误。"""
+
+
+class DavinciAdapter:
+    """DaVinci Configurator 默认实现。"""
+
+    DEFAULT_TIMEOUT_S: int = 300
+
+    def __init__(self, default_timeout_s: int = DEFAULT_TIMEOUT_S) -> None:
+        if default_timeout_s <= 0:
+            raise ValueError(f"default_timeout_s must be > 0, got {default_timeout_s}")
+        self.default_timeout_s = default_timeout_s
+
+    def _dvcfg_path(self, ctx: EcuConfigProjectContext) -> Path:
+        """定位 ``DVCfgCmd.exe``。"""
+        suffix = ".exe" if os.name == "nt" else ""
+        candidates = [
+            ctx.tool_home / "Core" / f"DVCfgCmd{suffix}",
+            ctx.tool_home / f"Core/DVCfgCmd{suffix}",
+        ]
+        for c in candidates:
+            if c.is_file():
+                return c
+        raise DavinciAdapterError(
+            f"DVCfgCmd not found under {ctx.tool_home}/Core/ (tried {suffix or 'no-suffix'})"
+        )
+
+    def _run_dvcfg(
+        self,
+        ctx: EcuConfigProjectContext,
+        args: list[str],
+    ) -> subprocess.CompletedProcess[str]:
+        """运行 DVCfgCmd 子命令。"""
+        cmd_path = self._dvcfg_path(ctx)
+        cmd = [str(cmd_path), *args]
+        try:
+            return subprocess.run(
+                cmd,
+                cwd=str(ctx.project_path),
+                capture_output=True,
+                text=True,
+                encoding="utf-8",
+                errors="replace",
+                timeout=self.default_timeout_s,
+                check=False,
+            )
+        except subprocess.TimeoutExpired as e:
+            raise DavinciAdapterError(
+                f"DVCfgCmd timed out after {self.default_timeout_s}s: {' '.join(cmd)}"
+            ) from e
+        except OSError as e:
+            # OSError 覆盖 FileNotFoundError / PermissionError / IsADirectoryError
+            # 等所有 "执行 DVCfgCmd 失败" 的 IO 错误
+            raise DavinciAdapterError(
+                f"DVCfgCmd not invocable ({type(e).__name__}: {e}): {cmd_path}"
+            ) from e
+
+    def verify(
+        self,
+        ctx: EcuConfigProjectContext,
+        module: str | None = None,
+    ) -> VerifyResult:
+        """调用 ``DVCfgCmd AutocVerify``。"""
+        args = ["AutocVerify"]
+        if module:
+            args.extend(["--module", module])
+        result = self._run_dvcfg(ctx, args)
+        return VerifyResult(
+            success=result.returncode == 0,
+            returncode=result.returncode,
+            stdout=result.stdout,
+            stderr=result.stderr,
+        )
+
+    def save(
+        self,
+        ctx: EcuConfigProjectContext,
+        module: str | None = None,
+    ) -> SaveResult:
+        """调用 ``DVCfgCmd Save``。
+
+        从 stdout 解析 ``Wrote: <path>`` 模式以填充 ``written_files``，相对路径
+        相对于 ``ctx.project_path`` 解析。DaVinci 写出的是 ``.arxml`` 而非 ``.xdm``。
+        """
+        args = ["Save"]
+        if module:
+            args.extend(["--module", module])
+        result = self._run_dvcfg(ctx, args)
+        written = self._extract_written_files(ctx, result.stdout)
+        return SaveResult(
+            success=result.returncode == 0,
+            returncode=result.returncode,
+            stdout=result.stdout,
+            stderr=result.stderr,
+            written_files=written,
+        )
+
+    # ------------------------------------------------------------------
+    # stdout 解析（提取写入文件路径）
+    # ------------------------------------------------------------------
+
+    # DaVinci DVCfgCmd 的 Save 输出格式（Vector 文档）：
+    #   "Wrote: <relative-or-absolute-path>"     (最常见)
+    #   "Wrote file <path>"                     (旧版本)
+    #   "Saved <path>"                          (罕见)
+    #
+    # 必须左锚定到行首 + 强制扩展名，否则会误匹配自然语言中的 "wrote/saved"
+    # （如 "Configuration was not saved due to validation errors" 会被错配为路径 "due"）。
+    _WRITTEN_FILE_RE = re.compile(
+        r"(?:^|\n)\s*(?:wrote|written|saved)\s*(?:file\s*)?:?\s+(\S+\.(?:arxml|xdm))",
+        re.IGNORECASE,
+    )
+
+    @classmethod
+    def _extract_written_files(
+        cls,
+        ctx: EcuConfigProjectContext,
+        stdout: str,
+    ) -> tuple[Path, ...]:
+        """从 DVCfgCmd 输出中提取已写入的文件路径。
+
+        相对路径相对于 ``ctx.project_path`` 解析。
+        """
+        results: set[Path] = set()
+        for m in cls._WRITTEN_FILE_RE.finditer(stdout):
+            raw = m.group(1).rstrip(".,;")
+            p = Path(raw)
+            if not p.is_absolute():
+                p = ctx.project_path / p
+            try:
+                p = p.resolve()
+            except OSError:
+                continue
+            results.add(p)
+        return tuple(sorted(results))