firmwareloop 0.0.12__tar.gz → 0.0.13__tar.gz

{firmwareloop-0.0.12 → firmwareloop-0.0.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.0.12
+Version: 0.0.13
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -135,10 +135,12 @@ claude mcp add --scope user fwloop -- fwloop
 claude mcp add --scope user agentic-hil -- agentic-hil mcp-stdio
 ```
 
-3. **Qoder IDE**：
-```bash
-qoder.cmd mcp add --global fwloop -- fwloop
-```
+3. **Qoder / Qoder CN**：
+`fwloop setup` 会直接写入 IDE 设置页读取的用户级文件：
+- 国际版：`~/.qoder/mcp.json`
+- 国内版：`~/.qoder-cn/mcp.json`
+
+不要依赖 `qoder.cmd --add-mcp`：它写到 `%APPDATA%\Qoder\User\mcp.json`，设置页看不到。
 
 4. **Cursor / 其他 IDE**（在工程根目录的 `.mcp.json` 中并联配置）：
 ```json
@@ -180,7 +182,7 @@ fwloop init
 
 | 命令 | 适用级别 | 核心作用 | 使用时机 |
 |---|---|---|---|
-| **`fwloop setup`** | **系统全局级** | 给各大 Agent（Antigravity / Claude Code）配置全局 MCP 与同步技能包 | **全电脑只需跑 1 次** |
+| **`fwloop setup`** | **系统全局级** | 给各大 Agent（Antigravity / Claude Code / Qoder / Qoder CN）配置全局 MCP 与同步技能包 | **全电脑只需跑 1 次** |
 | **`fwloop init`** | **工程项目级** | 在当前单片机代码目录下生成 `AGENTS.md`、`GEMINI.md`、`CLAUDE.md` 与台架配置 | **每个新单片机项目跑 1 次** |
 | **`fwloop doctor`** | **环境诊断** | 检查编译器（Keil/GCC）、Python 环境、串口与探针连接健康度 | 随时排查环境时使用 |
 | **`fwloop update`** | **自动更新** | 一键自动拉取最新代码并热重载依赖 | 升级工具版本时使用 |
@@ -336,7 +338,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.0.12)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.0.13)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -346,7 +348,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.0.12）
+## 能力验证状态（v0.0.13）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.0.12 → firmwareloop-0.0.13}/README.md

@@ -107,10 +107,12 @@ claude mcp add --scope user fwloop -- fwloop
 claude mcp add --scope user agentic-hil -- agentic-hil mcp-stdio
 ```
 
-3. **Qoder IDE**：
-```bash
-qoder.cmd mcp add --global fwloop -- fwloop
-```
+3. **Qoder / Qoder CN**：
+`fwloop setup` 会直接写入 IDE 设置页读取的用户级文件：
+- 国际版：`~/.qoder/mcp.json`
+- 国内版：`~/.qoder-cn/mcp.json`
+
+不要依赖 `qoder.cmd --add-mcp`：它写到 `%APPDATA%\Qoder\User\mcp.json`，设置页看不到。
 
 4. **Cursor / 其他 IDE**（在工程根目录的 `.mcp.json` 中并联配置）：
 ```json
@@ -152,7 +154,7 @@ fwloop init
 
 | 命令 | 适用级别 | 核心作用 | 使用时机 |
 |---|---|---|---|
-| **`fwloop setup`** | **系统全局级** | 给各大 Agent（Antigravity / Claude Code）配置全局 MCP 与同步技能包 | **全电脑只需跑 1 次** |
+| **`fwloop setup`** | **系统全局级** | 给各大 Agent（Antigravity / Claude Code / Qoder / Qoder CN）配置全局 MCP 与同步技能包 | **全电脑只需跑 1 次** |
 | **`fwloop init`** | **工程项目级** | 在当前单片机代码目录下生成 `AGENTS.md`、`GEMINI.md`、`CLAUDE.md` 与台架配置 | **每个新单片机项目跑 1 次** |
 | **`fwloop doctor`** | **环境诊断** | 检查编译器（Keil/GCC）、Python 环境、串口与探针连接健康度 | 随时排查环境时使用 |
 | **`fwloop update`** | **自动更新** | 一键自动拉取最新代码并热重载依赖 | 升级工具版本时使用 |
@@ -308,7 +310,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.0.12)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.0.13)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -318,7 +320,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.0.12）
+## 能力验证状态（v0.0.13）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.0.12 → firmwareloop-0.0.13}/firmwareloop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firmwareloop
-Version: 0.0.12
+Version: 0.0.13
 Summary: AI Agent Firmware Development and Lab Automation Platform (Dual-Tier MCP Server)
 Author-email: WeilinZhang <19523330249@163.com>
 License: MIT
@@ -135,10 +135,12 @@ claude mcp add --scope user fwloop -- fwloop
 claude mcp add --scope user agentic-hil -- agentic-hil mcp-stdio
 ```
 
-3. **Qoder IDE**：
-```bash
-qoder.cmd mcp add --global fwloop -- fwloop
-```
+3. **Qoder / Qoder CN**：
+`fwloop setup` 会直接写入 IDE 设置页读取的用户级文件：
+- 国际版：`~/.qoder/mcp.json`
+- 国内版：`~/.qoder-cn/mcp.json`
+
+不要依赖 `qoder.cmd --add-mcp`：它写到 `%APPDATA%\Qoder\User\mcp.json`，设置页看不到。
 
 4. **Cursor / 其他 IDE**（在工程根目录的 `.mcp.json` 中并联配置）：
 ```json
@@ -180,7 +182,7 @@ fwloop init
 
 | 命令 | 适用级别 | 核心作用 | 使用时机 |
 |---|---|---|---|
-| **`fwloop setup`** | **系统全局级** | 给各大 Agent（Antigravity / Claude Code）配置全局 MCP 与同步技能包 | **全电脑只需跑 1 次** |
+| **`fwloop setup`** | **系统全局级** | 给各大 Agent（Antigravity / Claude Code / Qoder / Qoder CN）配置全局 MCP 与同步技能包 | **全电脑只需跑 1 次** |
 | **`fwloop init`** | **工程项目级** | 在当前单片机代码目录下生成 `AGENTS.md`、`GEMINI.md`、`CLAUDE.md` 与台架配置 | **每个新单片机项目跑 1 次** |
 | **`fwloop doctor`** | **环境诊断** | 检查编译器（Keil/GCC）、Python 环境、串口与探针连接健康度 | 随时排查环境时使用 |
 | **`fwloop update`** | **自动更新** | 一键自动拉取最新代码并热重载依赖 | 升级工具版本时使用 |
@@ -336,7 +338,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.0.12)
+├── pyproject.toml    标准 Python 包配置与 CLI 入口声明 (v0.0.13)
 ├── .mcp.example.json 双层 MCP 配置模板（firmwareloop + agentic-hil）
 ├── AGENTS.md         通用智能体规范（Antigravity / Qoder / Cursor 等）
 ├── CLAUDE.md         Claude Code CLI 指南
@@ -346,7 +348,7 @@ claude mcp remove --scope user agentic-hil
 
 ---
 
-## 能力验证状态（v0.0.12）
+## 能力验证状态（v0.0.13）
 
 > 状态定义：`Implemented`（已实现）/ `Simulator Validated`（模拟验证）/
 > `Real Hardware Validated`（真机验证）/ `Experimental` / `Not Implemented`

{firmwareloop-0.0.12 → firmwareloop-0.0.13}/pyproject.toml

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

{firmwareloop-0.0.12 → firmwareloop-0.0.13}/tools/__init__.py

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

{firmwareloop-0.0.12 → firmwareloop-0.0.13}/tools/acceptance-scenario.ps1

@@ -94,12 +94,12 @@ $report = [ordered]@{
 # ---- 1. build --------------------------------------------------------------------
 $build = Invoke-Tool 'build.ps1' @('-Configuration', 'Debug', '-Json')
 $report.steps.build = [ordered]@{
-    ok       = $build.ok
-    errors   = $build.errors
-    warnings = $build.warnings
-    artifact = $build.artifact
-    sha256   = $build.artifact_sha256
-    detail   = if ($build.ok) { $null } else { $build.diagnostics }
+    ok       = [bool]($build.PSObject.Properties['ok'] -and $build.ok)
+    errors   = if ($build.PSObject.Properties['errors']) { $build.errors } else { 1 }
+    warnings = if ($build.PSObject.Properties['warnings']) { $build.warnings } else { 0 }
+    artifact = if ($build.PSObject.Properties['artifact']) { $build.artifact } else { $null }
+    sha256   = if ($build.PSObject.Properties['artifact_sha256']) { $build.artifact_sha256 } else { $null }
+    detail   = if ($build.PSObject.Properties['diagnostics']) { $build.diagnostics } elseif ($build.PSObject.Properties['error']) { $build.error } else { $null }
 }
 
 # --- evidence: build.json + hardware.json (Spec §25; identity probing in real
@@ -114,8 +114,11 @@ if ($Mode -eq 'real') {
     $ahilTool = $null
     $g2 = Get-Command agentic-hil -ErrorAction SilentlyContinue
     if ($g2) { $ahilTool = $g2.Source }
-    if (-not $ahilTool -and (Test-Path -LiteralPath (Join-Path $repoRoot '.venv\Scripts\agentic-hil.exe'))) {
-        $ahilTool = Join-Path $repoRoot '.venv\Scripts\agentic-hil.exe'
+    if (-not $ahilTool) {
+        $c1 = Join-Path $repoRoot '.venv\Scripts\agentic-hil.exe'
+        $c2 = Join-Path $repoRoot '.venv/bin/agentic-hil'
+        if (Test-Path -LiteralPath $c1) { $ahilTool = $c1 }
+        elseif (Test-Path -LiteralPath $c2) { $ahilTool = $c2 }
     }
     if ($ahilTool) {
         $probes = Invoke-FwProcess -FilePath $ahilTool -Arguments @('debugger-probes') -WorkingDirectory $repoRoot -TimeoutMs 60000

{firmwareloop-0.0.12 → firmwareloop-0.0.13}/tools/common/fw.psm1

@@ -76,18 +76,25 @@ function New-FwError {
 function Resolve-FwPython {
     <#
     .SYNOPSIS
-        Locate a project Python: prefer .venv\Scripts\python.exe relative to
-        repo root, then PATH. Never hardcoded absolute paths (Spec §25).
+        Locate a project Python: prefer .venv\Scripts\python.exe (Windows) or
+        .venv/bin/python (Linux/macOS) relative to repo root, then PATH.
+        Never hardcoded absolute paths (Spec §25).
     #>
     param([string]$RepoRoot)
     $candidates = @()
     if ($RepoRoot) {
         $candidates += (Join-Path $RepoRoot '.venv\Scripts\python.exe')
+        $candidates += (Join-Path $RepoRoot '.venv\bin\python')
+        $candidates += (Join-Path $RepoRoot '.venv/bin/python')
         $candidates += (Join-Path $RepoRoot 'venv\Scripts\python.exe')
+        $candidates += (Join-Path $RepoRoot 'venv\bin\python')
+        $candidates += (Join-Path $RepoRoot 'venv/bin/python')
     }
     foreach ($path in $candidates) {
         if (Test-Path -LiteralPath $path) { return (Resolve-Path -LiteralPath $path).Path }
     }
+    $fromPath = Get-Command python3 -ErrorAction SilentlyContinue
+    if ($fromPath) { return $fromPath.Source }
     $fromPath = Get-Command python -ErrorAction SilentlyContinue
     if ($fromPath) { return $fromPath.Source }
     return $null

{firmwareloop-0.0.12 → firmwareloop-0.0.13}/tools/doctor.ps1

@@ -19,13 +19,20 @@ Import-Module (Join-Path $PSScriptRoot 'common\fw.psm1') -Force
 
 $repoRoot = Get-FwRepoRoot
 $python = Resolve-FwPython -RepoRoot $repoRoot
-$venvBin = if ($python -and $python -match '.venv[\\/]Scripts[\\/]python.exe$') { Split-Path $python } else { $null }
+$venvBin = if ($python -and ($python -match '[\\/]\.venv[\\/](Scripts|bin)[\\/]python(\.exe)?$')) { Split-Path $python } else { $null }
 
 function Test-Tool {
     param([string]$Name)
     # prefer the project venv bin dir (tools installed without polluting PATH)
-    $candidate = if ($venvBin) { Join-Path $venvBin ($Name + '.exe') } else { $null }
-    $cmd = if ($candidate -and (Test-Path -LiteralPath $candidate)) {
+    $candidate = $null
+    if ($venvBin) {
+        if (Test-Path -LiteralPath (Join-Path $venvBin ($Name + '.exe'))) {
+            $candidate = Join-Path $venvBin ($Name + '.exe')
+        } elseif (Test-Path -LiteralPath (Join-Path $venvBin $Name)) {
+            $candidate = Join-Path $venvBin $Name
+        }
+    }
+    $cmd = if ($candidate) {
         Get-Item -LiteralPath $candidate
     } else {
         Get-Command $Name -ErrorAction SilentlyContinue

{firmwareloop-0.0.12 → firmwareloop-0.0.13}/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.0.12).
+fw_mcp_server.py - FirmwareLoop High-Level Workflow & Device MCP Server (v0.0.13).
 
 Exposes high-level firmware engineering and hardware management tools to AI Coding
 Agents (Antigravity CLI, Claude Code CLI, Qoder IDE, Cursor) via the Model Context
@@ -1160,7 +1160,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
                 },
                 "serverInfo": {
                     "name": "firmwareloop",
-                    "version": "0.0.12"
+                    "version": "0.0.13"
                 }
             }
         }
@@ -1252,7 +1252,7 @@ def process_request(req: Dict[str, Any]) -> Optional[Dict[str, Any]]:
 def handle_cli_update() -> int:
     """Handle `firmwareloop update` command."""
     print("============================================================")
-    print("  FirmwareLoop Auto-Updater (v0.0.12)")
+    print("  FirmwareLoop Auto-Updater (v0.0.13)")
     print("============================================================")
 
     is_git_repo = os.path.exists(os.path.join(REPO_ROOT, ".git"))
@@ -1291,20 +1291,28 @@ def handle_cli_update() -> int:
         print("============================================================")
         return 0
     else:
-        print("[*] Global / uv-managed installation detected.")
+        print("[*] Global installation detected.")
         uv_path = shutil.which("uv")
         if uv_path:
-            print("[*] Refreshing uv cache for firmwareloop...")
+            print("[*] Upgrading firmwareloop via `uv tool upgrade firmwareloop`...")
             try:
-                subprocess.run([uv_path, "cache", "clean", "firmwareloop"], capture_output=True)
-                print("[+] uv cache refreshed! The next run will automatically fetch the latest release from GitHub.")
-                return 0
+                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 refreshing uv cache: {e}")
+                print(f"[-] Error upgrading via uv tool: {e}")
                 return 1
         else:
-            print("[*] Upgrading via pip...")
+            print("[*] Upgrading via pip (`pip install --upgrade firmwareloop`)...")
             res = subprocess.run([sys.executable, "-m", "pip", "install", "--upgrade", "firmwareloop"])
+            if res.returncode == 0:
+                print("[+] FirmwareLoop has been upgraded to the latest version!")
             return res.returncode
 
 
@@ -1316,10 +1324,78 @@ def handle_cli_doctor() -> int:
     return res.returncode
 
 
+QODER_USER_MCP_SERVERS = {
+    "firmwareloop": {"command": "fwloop", "type": "stdio"},
+    "agentic-hil": {"command": "agentic-hil", "args": ["mcp-stdio"], "type": "stdio"},
+}
+
+QODER_USER_MCP_EDITIONS = (
+    ("Qoder", ".qoder"),
+    ("Qoder CN", ".qoder-cn"),
+)
+
+
+def upsert_qoder_mcp_json(mcp_path: str, servers: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+    """Merge MCP servers into a Qoder user-level ~/.qoder[-cn]/mcp.json without dropping existing entries."""
+    payload = dict(servers or QODER_USER_MCP_SERVERS)
+    data: Dict[str, Any] = {}
+    if os.path.exists(mcp_path):
+        try:
+            with open(mcp_path, "r", encoding="utf-8-sig") as f:
+                loaded = json.load(f)
+            if isinstance(loaded, dict):
+                data = loaded
+        except Exception:
+            data = {}
+    mcp_servers = data.get("mcpServers")
+    if not isinstance(mcp_servers, dict):
+        mcp_servers = {}
+    mcp_servers.update(payload)
+    data["mcpServers"] = mcp_servers
+    parent = os.path.dirname(mcp_path)
+    if parent:
+        os.makedirs(parent, exist_ok=True)
+    with open(mcp_path, "w", encoding="utf-8") as f:
+        json.dump(data, f, indent=2)
+        f.write("\n")
+    return data
+
+
+def configure_qoder_user_mcp(user_home: str) -> List[Dict[str, Any]]:
+    """Write firmwareloop MCP entries into installed Qoder / Qoder CN user mcp.json files."""
+    results: List[Dict[str, Any]] = []
+    for label, folder in QODER_USER_MCP_EDITIONS:
+        edition_dir = os.path.join(user_home, folder)
+        mcp_file = os.path.join(edition_dir, "mcp.json")
+        if not os.path.isdir(edition_dir):
+            results.append({
+                "edition": label,
+                "ok": False,
+                "path": mcp_file,
+                "reason": "not_installed",
+            })
+            continue
+        try:
+            upsert_qoder_mcp_json(mcp_file)
+            results.append({
+                "edition": label,
+                "ok": True,
+                "path": mcp_file,
+            })
+        except Exception as exc:
+            results.append({
+                "edition": label,
+                "ok": False,
+                "path": mcp_file,
+                "reason": str(exc),
+            })
+    return results
+
+
 def handle_cli_setup() -> int:
     """Handle `firmwareloop setup` command: simultaneously configure Antigravity CLI, Claude Code CLI, and Qoder IDE."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.0.12)")
+    print("  FirmwareLoop Multi-Agent Global Setup Helper (v0.0.13)")
     print("============================================================")
     print("")
 
@@ -1372,22 +1448,24 @@ def handle_cli_setup() -> int:
     except Exception as e:
         print(f"    - Global MCP Config: [Warning] Could not update .claude.json: {e}")
 
-    # 3. Qoder IDE
-    print("\n[3] Qoder IDE:")
-    qoder_cmd = shutil.which("qoder.cmd") or shutil.which("qoder")
-    if qoder_cmd:
-        try:
-            r1 = subprocess.run([qoder_cmd, "--add-mcp", json.dumps({"name": "firmwareloop", "command": "fwloop"})], shell=True, capture_output=True, text=True)
-            r2 = subprocess.run([qoder_cmd, "--add-mcp", json.dumps({"name": "agentic-hil", "command": "agentic-hil", "args": ["mcp-stdio"]})], shell=True, capture_output=True, text=True)
-            if r1.returncode == 0 and r2.returncode == 0:
-                print("    - User Profile MCP: [OK] Automatically registered to Qoder User Profile")
-                configured_agents.append("Qoder IDE")
-            else:
-                print(f"    - User Profile MCP: [Notice] Qoder CLI output: {r1.stdout.strip()}")
-        except Exception as e:
-            print(f"    - User Profile MCP: [Warning] Could not invoke qoder CLI: {e}")
+    # 3. Qoder / Qoder CN user-level MCP
+    # IDE settings read ~/.qoder/mcp.json and ~/.qoder-cn/mcp.json.
+    # qoder.cmd --add-mcp writes the VS Code-style %APPDATA%\Qoder\User\mcp.json, which the settings page does not show.
+    print("\n[3] Qoder IDE / Qoder CN:")
+    qoder_results = configure_qoder_user_mcp(user_home)
+    qoder_ok = [item for item in qoder_results if item.get("ok")]
+    if qoder_ok:
+        for item in qoder_ok:
+            print(f"    - {item['edition']}: [OK] Written to {item['path']}")
+        configured_agents.append("Qoder")
     else:
-        print("    - User Profile MCP: Qoder CLI not in PATH (Workspace .mcp.json supported)")
+        print("    - User MCP: neither ~/.qoder nor ~/.qoder-cn found (Workspace .mcp.json still supported)")
+    for item in qoder_results:
+        if item.get("ok"):
+            continue
+        if item.get("reason") == "not_installed":
+            continue
+        print(f"    - {item['edition']}: [Warning] Could not write {item['path']}: {item.get('reason')}")
 
     # 4. Global Skills Sync for Antigravity and Claude Code
     ag_skills_dir = os.path.join(user_home, ".gemini", "antigravity-cli", "skills")
@@ -1422,7 +1500,7 @@ def handle_cli_setup() -> int:
 def handle_cli_init() -> int:
     """Handle `firmwareloop init` command."""
     print("============================================================")
-    print("  FirmwareLoop Multi-Agent Project Initializer (v0.0.12)")
+    print("  FirmwareLoop Multi-Agent Project Initializer (v0.0.13)")
     print("============================================================")
     cwd = os.getcwd()
     print(f"[*] Initializing multi-agent guidelines & bench config in:\n    {cwd}\n")
@@ -1443,7 +1521,7 @@ def handle_cli_init() -> int:
 
 
 def print_cli_help() -> None:
-    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.0.12)
+    print("""FirmwareLoop (fwloop) — AI Agent Firmware Engineering & Lab Automation Platform (v0.0.13)
 
 Usage:
   fwloop [command]   (or: firmwareloop [command])
@@ -1474,7 +1552,7 @@ def main() -> None:
         elif cmd in ["setup", "register"]:
             sys.exit(handle_cli_setup())
         elif cmd in ["version", "-v", "--version"]:
-            print("FirmwareLoop v0.0.12")
+            print("FirmwareLoop v0.0.13")
             sys.exit(0)
         elif cmd in ["help", "-h", "--help"]:
             print_cli_help()

{firmwareloop-0.0.12 → firmwareloop-0.0.13}/tools/setup-agent-mcp.ps1

@@ -1,6 +1,6 @@
 <#
 .SYNOPSIS
-    Dual-Tier MCP setup and registration helper (v0.0.12).
+    Dual-Tier MCP setup and registration helper (v0.0.13).
     Inspects installed AI coding agents (Qoder, Claude Code, Antigravity, Cursor)
     and configures global MCP / skills or prints exact registration commands.
 
@@ -87,31 +87,69 @@ $report.agents.claude_code = [ordered]@{
     )
 }
 
-# 2. Qoder IDE / CLI 全局 User Profile MCP 自动配置
-$qoderCmd = $null
-foreach ($name in @('qoder.cmd', 'qoder', 'qodercli')) {
-    $c = Get-Command $name -ErrorAction SilentlyContinue
-    if ($c) { $qoderCmd = $c; break }
+# 2. Qoder / Qoder CN user-level MCP (~/.qoder/mcp.json, ~/.qoder-cn/mcp.json)
+# The IDE settings page reads these files. qoder.cmd --add-mcp writes
+# %APPDATA%\Qoder\User\mcp.json, which the settings UI does not show.
+function Merge-FwQoderUserMcp {
+    param([string]$McpPath)
+    $data = [ordered]@{ mcpServers = [ordered]@{} }
+    if (Test-Path -LiteralPath $McpPath) {
+        try {
+            $existing = Get-Content -LiteralPath $McpPath -Raw -Encoding UTF8 | ConvertFrom-Json
+            if ($existing.PSObject.Properties['mcpServers'] -and $existing.mcpServers) {
+                $data.mcpServers = [ordered]@{}
+                $existing.mcpServers.PSObject.Properties | ForEach-Object {
+                    $data.mcpServers[$_.Name] = $_.Value
+                }
+            }
+        } catch {
+            $data = [ordered]@{ mcpServers = [ordered]@{} }
+        }
+    }
+    $data.mcpServers['firmwareloop'] = [pscustomobject]@{ command = 'fwloop'; type = 'stdio' }
+    $data.mcpServers['agentic-hil'] = [pscustomobject]@{ command = 'agentic-hil'; args = @('mcp-stdio'); type = 'stdio' }
+    $parent = Split-Path -Parent $McpPath
+    if (-not (Test-Path -LiteralPath $parent)) {
+        New-Item -ItemType Directory -Force -Path $parent | Out-Null
+    }
+    $utf8NoBom = [System.Text.UTF8Encoding]::new($false)
+    [System.IO.File]::WriteAllText($McpPath, ((ConvertTo-Json -InputObject $data -Depth 10) + [Environment]::NewLine), $utf8NoBom)
 }
-$qoderConfigured = $false
-if ($qoderCmd) {
-    try {
-        $fwJsonStr = '{"name":"firmwareloop","command":"fwloop"}'
-        $ahilJsonStr = '{"name":"agentic-hil","command":"agentic-hil","args":["mcp-stdio"]}'
-        & $qoderCmd.Source --add-mcp $fwJsonStr | Out-Null
-        & $qoderCmd.Source --add-mcp $ahilJsonStr | Out-Null
-        $qoderConfigured = $true
-    } catch {
-        # ignore non-fatal error
+
+$qoderEditions = @(
+    [ordered]@{ name = 'Qoder'; dirName = '.qoder' },
+    [ordered]@{ name = 'Qoder CN'; dirName = '.qoder-cn' }
+)
+$qoderWritten = @()
+$qoderResults = @()
+foreach ($edition in $qoderEditions) {
+    $editionDir = Join-Path $env:USERPROFILE $edition.dirName
+    $mcpFile = Join-Path $editionDir 'mcp.json'
+    $entry = [ordered]@{
+        name = $edition.name
+        path = $mcpFile
+        detected = (Test-Path -LiteralPath $editionDir)
+        configured = $false
+    }
+    if ($entry.detected) {
+        try {
+            Merge-FwQoderUserMcp -McpPath $mcpFile
+            $entry.configured = $true
+            $qoderWritten += $mcpFile
+        } catch {
+            $entry.error = $_.Exception.Message
+        }
     }
+    $qoderResults += [pscustomobject]$entry
 }
+$qoderConfigured = ($qoderWritten.Count -gt 0)
 $report.agents.qoder = [ordered]@{
-    detected = ($null -ne $qoderCmd)
-    path = if ($qoderCmd) { $qoderCmd.Source } else { $null }
+    detected = ($qoderResults | Where-Object { $_.detected } | Measure-Object).Count -gt 0
     user_profile_configured = $qoderConfigured
+    written_files = $qoderWritten
+    editions = $qoderResults
     registration_commands = @(
-        "qoder.cmd --add-mcp '{\`"name\`":\`"firmwareloop\`",\`"command\`":\`"fwloop\`"}'",
-        "qoder.cmd --add-mcp '{\`"name\`":\`"agentic-hil\`",\`"command\`":\`"agentic-hil\`",\`"args\`":[\`"mcp-stdio\`"]}'"
+        "fwloop setup   # writes ~/.qoder/mcp.json and ~/.qoder-cn/mcp.json"
     )
 }
 
@@ -204,7 +242,7 @@ if ($Json) {
     Write-FwJson ([pscustomobject]$report)
 } else {
     Write-Host "============================================================" -ForegroundColor Cyan
-    Write-Host "  FirmwareLoop Dual-Tier MCP & Agent Setup Helper (v0.0.10)" -ForegroundColor Green
+    Write-Host "  FirmwareLoop Dual-Tier MCP & Agent Setup Helper (v0.0.13)" -ForegroundColor Green
     Write-Host "============================================================" -ForegroundColor Cyan
     Write-Host ""
     Write-Host "[1] Google Antigravity / Gemini CLI:" -ForegroundColor Yellow
@@ -221,11 +259,15 @@ if ($Json) {
     Write-Host "    $($report.agents.claude_code.registration_commands[0])"
     Write-Host "    $($report.agents.claude_code.registration_commands[1])"
     Write-Host ""
-    Write-Host "[3] Qoder IDE:" -ForegroundColor Yellow
-    if ($qoderConfigured) {
-        Write-Host "    - User Profile MCP: [OK] Automatically registered to Qoder User Profile" -ForegroundColor Green
-    } else {
-        Write-Host "    - User Profile MCP: Run $($report.agents.qoder.registration_commands[0])"
+    Write-Host "[3] Qoder IDE / Qoder CN:" -ForegroundColor Yellow
+    foreach ($edition in $qoderResults) {
+        if ($edition.configured) {
+            Write-Host "    - $($edition.name): [OK] Written to $($edition.path)" -ForegroundColor Green
+        } elseif ($edition.detected) {
+            Write-Host "    - $($edition.name): [Warning] Could not write $($edition.path)"
+        } else {
+            Write-Host "    - $($edition.name): not installed ($($edition.path))"
+        }
     }
     Write-Host "    - Workspace: Project root '.mcp.json' is automatically detected"
     Write-Host ""

{firmwareloop-0.0.12 → firmwareloop-0.0.13}/tools/test-backends.ps1

@@ -64,11 +64,20 @@ foreach ($c in $cases) {
 }
 
 # ---- 2. fake executable execution (keil / iar / west / esp-idf) ----------------
+$runningOnWindows = $IsWindows -or ($null -ne $env:OS -and $env:OS -like "*Windows*")
+$ext = if ($runningOnWindows) { '.cmd' } else { '.sh' }
+
+if (-not $runningOnWindows) {
+    Get-ChildItem -LiteralPath $fake -Filter *.sh | ForEach-Object {
+        try { & chmod +x $_.FullName } catch { }
+    }
+}
+
 $execCases = @(
-    @{ name = 'keil';  args = @('-Backend', 'keil', '-SourceDir', 'tests/backend/fixtures/keil-proj', '-BackendTool', (Join-Path $fake 'UV4.cmd'), '-Json') },
-    @{ name = 'iar';   args = @('-Backend', 'iar', '-SourceDir', 'tests/backend/fixtures/iar-proj', '-BackendTool', (Join-Path $fake 'IarBuild.cmd'), '-Json') },
-    @{ name = 'zephyr'; args = @('-Backend', 'zephyr', '-BackendTool', (Join-Path $fake 'west.cmd'), '-Json') },
-    @{ name = 'esp-idf'; args = @('-Backend', 'esp-idf', '-BackendTool', (Join-Path $fake 'idf.py.cmd'), '-Json') }
+    @{ name = 'keil';  args = @('-Backend', 'keil', '-SourceDir', 'tests/backend/fixtures/keil-proj', '-BackendTool', (Join-Path $fake "UV4$ext"), '-Json') },
+    @{ name = 'iar';   args = @('-Backend', 'iar', '-SourceDir', 'tests/backend/fixtures/iar-proj', '-BackendTool', (Join-Path $fake "IarBuild$ext"), '-Json') },
+    @{ name = 'zephyr'; args = @('-Backend', 'zephyr', '-BackendTool', (Join-Path $fake "west$ext"), '-Json') },
+    @{ name = 'esp-idf'; args = @('-Backend', 'esp-idf', '-BackendTool', (Join-Path $fake "idf.py$ext"), '-Json') }
 )
 foreach ($c in $execCases) {
     $r = Invoke-Build -ToolArgs $c.args
@@ -80,11 +89,15 @@ foreach ($c in $execCases) {
 }
 
 # ---- 3. cmake real build still green -------------------------------------------
-$r = Invoke-Build -ToolArgs @('-Configuration', 'Debug', '-Clean', '-Json')
+$r = Invoke-Build -ToolArgs @('-Backend', 'cmake', '-Configuration', 'Debug', '-Clean', '-Json')
 $jsonLine = ($r.stdout -split "`r?`n" | Where-Object { $_.TrimStart().StartsWith('{') } | Select-Object -Last 1)
-$j = $jsonLine | ConvertFrom-Json
-Assert -Name 'real.cmake' -Ok ($r.exit_code -eq 0 -and $j.ok -and $j.artifacts.primary.path -like '*firmware.elf*') `
-    -Detail "exit=$($r.exit_code) artifact=$($j.artifacts.primary.path)"
+$j = if ($jsonLine) { try { $jsonLine | ConvertFrom-Json } catch { $null } } else { $null }
+$hasArtifact = $false
+if ($j -and $j.PSObject.Properties['ok'] -and $j.ok -and $j.PSObject.Properties['artifacts'] -and $j.artifacts.PSObject.Properties['primary'] -and $j.artifacts.primary.PSObject.Properties['path']) {
+    $hasArtifact = $j.artifacts.primary.path -like '*firmware.elf*'
+}
+Assert -Name 'real.cmake' -Ok ($r.exit_code -eq 0 -and $hasArtifact) `
+    -Detail "exit=$($r.exit_code) output=$jsonLine"
 
 # ---- summary -------------------------------------------------------------------
 $failed = @($results | Where-Object { -not $_.ok }).Count

{firmwareloop-0.0.12 → firmwareloop-0.0.13}/tools/test.ps1

@@ -45,8 +45,9 @@ $env:FW_RUN_DIR = $runsDir
 $doctor = Invoke-FwProcess -FilePath 'pwsh' -Arguments @('-NoProfile', '-NonInteractive', '-File', (Join-Path $PSScriptRoot 'doctor.ps1'), '-Json') -WorkingDirectory $repoRoot -TimeoutMs 120000
 if ($doctor.exit_code -in @(0, 1)) {
     try {
-        $d = $doctor.stdout | ConvertFrom-Json
-        if ($d.checks) {
+        $jsonLine = ($doctor.stdout -split "`r?`n" | Where-Object { $_.TrimStart().StartsWith('{') } | Select-Object -Last 1)
+        $d = if ($jsonLine) { try { $jsonLine | ConvertFrom-Json } catch { $null } } else { $null }
+        if ($d -and $d.PSObject.Properties['checks'] -and $d.checks) {
             $deps = [ordered]@{}
             foreach ($p in $d.checks.PSObject.Properties) {
                 $v = $p.Value
@@ -55,7 +56,7 @@ if ($doctor.exit_code -in @(0, 1)) {
             }
             $deps | ConvertTo-Json -Depth 4 | Set-Content -LiteralPath (Join-Path $runsDir 'dependencies.json') -Encoding utf8
         }
-        if ($d.host) {
+        if ($d -and $d.PSObject.Properties['host'] -and $d.host) {
             $d.host | ConvertTo-Json -Depth 4 | Set-Content -LiteralPath (Join-Path $runsDir 'environment.json') -Encoding utf8
         }
     } catch {