firmwareloop 0.2.0__tar.gz → 0.2.1__tar.gz

{firmwareloop-0.2.0 → firmwareloop-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.2.0
+Version: 0.2.1
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -381,7 +381,7 @@ claude mcp remove --scope user agentic-hil
 ├── demo-firmware/    示例固件（CMake；宿主编译模拟 MCU，闭环验证载体）
 ├── demo-make/        示例固件（Make；构建测试载体）
 ├── docs/             DEPENDENCY_MATRIX / REUSE_PLAN / V0.0.2_GAP_VERIFICATION
-├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.2.0)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.2.1)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -391,7 +391,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.2.0）
+## 能力验证状态（v0.2.1）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.2.0 → firmwareloop-0.2.1}/README.md

@@ -353,7 +353,7 @@ claude mcp remove --scope user agentic-hil
 ├── demo-firmware/    示例固件（CMake；宿主编译模拟 MCU，闭环验证载体）
 ├── demo-make/        示例固件（Make；构建测试载体）
 ├── docs/             DEPENDENCY_MATRIX / REUSE_PLAN / V0.0.2_GAP_VERIFICATION
-├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.2.0)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.2.1)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -363,7 +363,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.2.0）
+## 能力验证状态（v0.2.1）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.2.0 → firmwareloop-0.2.1}/firmwareloop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.2.0
+Version: 0.2.1
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -381,7 +381,7 @@ claude mcp remove --scope user agentic-hil
 ├── demo-firmware/    示例固件（CMake；宿主编译模拟 MCU，闭环验证载体）
 ├── demo-make/        示例固件（Make；构建测试载体）
 ├── docs/             DEPENDENCY_MATRIX / REUSE_PLAN / V0.0.2_GAP_VERIFICATION
-├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.2.0)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.2.1)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -391,7 +391,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.2.0）
+## 能力验证状态（v0.2.1）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.2.0 → firmwareloop-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "firmwareloop"
-version = "0.2.0"
+version = "0.2.1"
 description = "AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)"
 readme = "README.md"
 authors = [

{firmwareloop-0.2.0 → firmwareloop-0.2.1}/tools/__init__.py

@@ -2,4 +2,4 @@
 FirmwareLoop - AI Agent Firmware Development and Lab Automation Platform.
 """
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"

{firmwareloop-0.2.0 → firmwareloop-0.2.1}/tools/fw_mcp_server.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 """
-fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.2.0).
+fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.2.1).
 
 Exposes high-level firmware engineering and hardware management tools to AI Coding
 Agents (Antigravity CLI, Claude Code CLI, Qoder IDE, CodeBuddy IDE, Cursor) via the Model Context
@@ -1619,7 +1619,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
                 },
                 "serverInfo": {
                     "name": "firmwareloop",
-                    "version": "0.2.0"
+                    "version": "0.2.1"
                 }
             }
         }
@@ -1708,10 +1708,53 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
     return None
 
 
+def _local_bin_entrypoints() -> list:
+    """uv tool 入口点 exe (~/.local/bin)——本命令自身与常驻 MCP server 都从这里运行。"""
+    home = os.path.expanduser("~")
+    return [os.path.join(home, ".local", "bin", name)
+            for name in ("fwloop.exe", "fw-mcp.exe", "agentic-hil.exe")]
+
+
+def _stash_local_bin_entrypoints() -> list:
+    """升级前把入口点 exe 重命名让位 (Windows 允许 rename 运行中的 exe, 不允许覆盖写)。
+
+    否则 `fwloop update` 第一次必然失败: uv 复制新 fwloop.exe 的目标文件正是当前
+    命令自己的启动映像 (被锁定, os error 32), 第二次则因 "Nothing to upgrade"
+    跳过入口点同步。返回 [(原路径, 备份路径)]。
+    """
+    stashed = []
+    for path in _local_bin_entrypoints():
+        if not os.path.isfile(path):
+            continue
+        stash = path + ".upgrading"
+        try:
+            if os.path.exists(stash):   # 上次升级残留 (旧映像仍被运行中进程持有)
+                os.remove(stash)
+            os.rename(path, stash)
+            stashed.append((path, stash))
+            print(f"[*] Entrypoint stashed for upgrade: {os.path.basename(path)} -> .upgrading")
+        except OSError:
+            pass   # 让位失败不阻塞升级: uv 直接覆盖, 若 os error 32 走针对性诊断
+    return stashed
+
+
+def _settle_stashed_entrypoints(stashed) -> None:
+    """升级收尾: uv 已写入新入口点 -> 删备份 (旧映像仍被运行中进程持有时留待下次);
+    uv 未写入 (升级失败/中止) -> 还原旧入口点, 保证 fwloop 命令不消失。"""
+    for path, stash in stashed:
+        try:
+            if os.path.isfile(path):
+                os.remove(stash)          # 新 exe 已就位, 备份可弃
+            else:
+                os.rename(stash, path)    # 升级未完成: 还原
+        except OSError:
+            pass                          # 旧映像仍被本命令/常驻 MCP 持有, 留待下次清理
+
+
 def handle_cli_update() -> int:
     """Handle `firmwareloop update` command."""
     print("============================================================")
-    print("  FirmwareLoop Auto-Updater (v0.2.0)")
+    print("  FirmwareLoop Auto-Updater (v0.2.1)")
     print("============================================================")
 
     is_git_repo = os.path.exists(os.path.join(REPO_ROOT, ".git"))
@@ -1754,19 +1797,24 @@ def handle_cli_update() -> int:
         uv_path = shutil.which("uv")
         if uv_path:
             print("[*] Upgrading firmwareloop via `uv tool upgrade firmwareloop`...")
+            # 关键: 入口点 exe (.local\bin\fwloop.exe) 正被本命令自身运行——Windows 禁止
+            # 覆盖运行中的 exe (os error 32), 不让位则第一次 upgrade 必然失败。
+            # rename 让位 (运行中的 exe 允许重命名), uv 复制新入口点后在收尾阶段清理/还原。
+            stashed = _stash_local_bin_entrypoints()
             try:
                 res = subprocess.run([uv_path, "tool", "upgrade", "firmwareloop"])
-                if res.returncode == 0:
-                    print("\n============================================================")
-                    print("[+] FirmwareLoop has been upgraded to the latest version!")
-                    print("============================================================")
-                    return 0
-                else:
-                    print(f"[-] uv tool upgrade returned code {res.returncode}")
-                    return res.returncode
-            except Exception as e:
-                print(f"[-] Error upgrading via uv tool: {e}")
-                return 1
+            finally:
+                _settle_stashed_entrypoints(stashed)
+            if res.returncode == 0:
+                print("\n============================================================")
+                print("[+] FirmwareLoop has been upgraded to the latest version!")
+                print("============================================================")
+                return 0
+            print(f"[-] uv tool upgrade returned code {res.returncode}")
+            print("    工具环境可能已升级成功, 仅入口点 exe 未更新 (os error 32 = 文件被占用)。")
+            print("    占用者通常是本命令自身或常驻的 MCP server 进程; 关闭 IDE 后重跑一次")
+            print("    `fwloop update` 即可完成收尾。")
+            return res.returncode
         else:
             print("[*] Upgrading via pip (`pip install --upgrade firmwareloop`)...")
             res = subprocess.run([sys.executable, "-m", "pip", "install", "--upgrade", "firmwareloop"])
@@ -1981,7 +2029,7 @@ def set_ndtdbg_dlldir(dll_path: str) -> str:
 def handle_cli_setup() -> int:
     """Handle `firmwareloop setup` command: simultaneously configure Antigravity CLI, Claude Code CLI, Qoder IDE, and CodeBuddy IDE."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.2.0)")
+    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.2.1)")
     print("============================================================")
     print("")
 
@@ -2106,7 +2154,7 @@ def handle_cli_setup() -> int:
 def handle_cli_init() -> int:
     """Handle `firmwareloop init` command."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Project Initializer (v0.2.0)")
+    print("  FirmwareLoop Multi-Agent Project Initializer (v0.2.1)")
     print("============================================================")
     cwd = os.getcwd()
     print(f"[*] Initializing multi-agent guidelines & bench config in:\n    {cwd}\n")
@@ -2127,7 +2175,7 @@ def handle_cli_init() -> int:
 
 
 def print_cli_help() -> None:
-    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.2.0)
+    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.2.1)
 
 Usage:
   fwloop [command]   (or: firmwareloop [command])
@@ -2167,7 +2215,7 @@ def main() -> None:
                 sys.exit(2)
             sys.exit(handle_cli_ndtdebugtool(args[1]))
         elif cmd in ["version", "-v", "--version"]:
-            print("FirmwareLoop v0.2.0")
+            print("FirmwareLoop v0.2.1")
             sys.exit(0)
         elif cmd in ["help", "-h", "--help"]:
             print_cli_help()

{firmwareloop-0.2.0 → firmwareloop-0.2.1}/tools/ndtdbg_bridge.ps1

@@ -497,7 +497,6 @@ try {
             $consecIoFail = 0
             $aborted = $false; $abortReason = ""
             $durationMsTotal = [int]($sDurationS * 1000)
-            $hexFmt = { param($b) $b.ToString("X2") }
             while ($true) {
                 $frameNo++
                 $frameStartMs = $sw.Elapsed.TotalMilliseconds
@@ -505,25 +504,32 @@ try {
                 foreach ($r in $sRegs) {
                     $reg = [int]$r.addr; $rlen = [int]$r.len
                     $hexOut = "-"; $tag = "OK"
-                    for ($attempt = 0; $attempt -le $sRetry; $attempt++) {
-                        $tx = New-Object byte[] 2
-                        $tx[0] = [byte]$SlaveAddr; $tx[1] = [byte]$reg
-                        $rb = New-Object byte[] $rlen
-                        if (Invoke-WriteRead $h $tx $rb) {
-                            $hexStr = (($rb | ForEach-Object $hexFmt) -join "")
-                            $allFF = $true
-                            foreach ($b in $rb) { if ($b -ne 0xFF) { $allFF = $false; break } }
-                            if ($allFF) {
-                                $tag = "FF_GAP"; $hexOut = $hexStr   # 总线高阻特征: 记录原值, 重试
-                                if ($attempt -lt $sRetry) { Start-Sleep -Milliseconds 5 }
+                    try {
+                        for ($attempt = 0; $attempt -le $sRetry; $attempt++) {
+                            $tx = New-Object byte[] 2
+                            $tx[0] = [byte]$SlaveAddr; $tx[1] = [byte]$reg
+                            $rb = New-Object byte[] $rlen
+                            if (Invoke-WriteRead $h $tx $rb) {
+                                # ForEach-Object 将管道元素绑定到 $_——scriptblock 用 param()
+                                # 形式收参恒为 null (Null 方法调用), 必须内联 $_
+                                $hexStr = (($rb | ForEach-Object { $_.ToString("X2") }) -join " ")
+                                $allFF = $true
+                                foreach ($b in $rb) { if ($b -ne 0xFF) { $allFF = $false; break } }
+                                if ($allFF) {
+                                    $tag = "FF_GAP"; $hexOut = $hexStr   # 总线高阻特征: 记录原值, 重试
+                                    if ($attempt -lt $sRetry) { Start-Sleep -Milliseconds 5 }
+                                } else {
+                                    $tag = "OK"; $hexOut = $hexStr
+                                    break
+                                }
                             } else {
-                                $tag = "OK"; $hexOut = $hexStr
-                                break
+                                $tag = "IO_FAIL"; $hexOut = "-"
+                                if ($attempt -lt $sRetry) { Start-Sleep -Milliseconds 5 }
                             }
-                        } else {
-                            $tag = "IO_FAIL"; $hexOut = "-"
-                            if ($attempt -lt $sRetry) { Start-Sleep -Milliseconds 5 }
                         }
+                    } catch {
+                        # 单寄存器异常降级为 IO_FAIL 行继续采集, 不作废整个 stream (fail-closed 韧性)
+                        $tag = "IO_FAIL"; $hexOut = "-"
                     }
                     if ($tag -eq "IO_FAIL") { $hasIoFail = $true }
                     elseif ($tag -eq "FF_GAP") { $hasGap = $true }

{firmwareloop-0.2.0 → firmwareloop-0.2.1}/tools/ndtdbg_cli.py

@@ -245,13 +245,11 @@ def cmd_stream(io: NdtBoxIo, config: dict, specs: list, interval_ms, duration_s:
         fh.write(header + "\n")
 
         def on_row(parts: list) -> None:
-            # 桥行协议: '#F', frame, t_rel_ms, reg, hex|'-', tag
+            # 桥行协议: '#F', frame, t_rel_ms, reg, hex|'-', tag (hex 已空格分隔, 直接透传)
             frame = int(parts[1]); t_rel = float(parts[2])
             reg = parts[3]; hexs = parts[4]; tag = parts[5] if len(parts) > 5 else "OK"
-            hex_fmt = (" ".join(hexs[i:i + 2] for i in range(0, len(hexs), 2))
-                       if hexs and hexs != "-" else hexs)
             line = (f"{frame},{datetime.now().isoformat(timespec='milliseconds')},"
-                    f"{t_rel:g},{reg},{hex_fmt}")
+                    f"{t_rel:g},{reg},{hexs}")
             if decode != "hex":
                 line += "," + (decode_payload(hexs, decode) or "")
             if tag != "OK":

{firmwareloop-0.2.0 → firmwareloop-0.2.1}/tools/setup-agent-mcp.ps1

@@ -1,6 +1,6 @@
 <#
 .SYNOPSIS
-    Dual-Tier MCP setup and registration helper (v0.2.0).
+    Dual-Tier MCP setup and registration helper (v0.2.1).
     Inspects installed AI coding agents (Qoder, Claude Code, Antigravity, Cursor)
     and configures global MCP / skills or prints exact registration commands.
 
@@ -242,7 +242,7 @@ if ($Json) {
     Write-FwJson ([pscustomobject]$report)
 } else {
     Write-Host "============================================================" -ForegroundColor Cyan
-    Write-Host "  FirmwareLoop Dual-Tier MCP & Agent Setup Helper (v0.2.0)" -ForegroundColor Green
+    Write-Host "  FirmwareLoop Dual-Tier MCP & Agent Setup Helper (v0.2.1)" -ForegroundColor Green
     Write-Host "============================================================" -ForegroundColor Cyan
     Write-Host ""
     Write-Host "[1] Google Antigravity / Gemini CLI:" -ForegroundColor Yellow