fix: resolve all remaining issues for release v0.0.2-beta.1 (#17)

* feat: complete GeneralUpdate Skill CodeGen v2 upgrade

This PR delivers a comprehensive upgrade transforming the skill suite from
a documentation-driven reference into an automated development toolkit.

- Parameterized code generator (336 combinations: 6 strategies x 7 frameworks x 2 Bowl x 4 scenes)
- BM25 search engine with 51 known issues database (8C + 11H + 20M + 12L)
- CLI skeleton: gskill init/uninstall/generate/versions/update (5 commands)
- Multi-platform support: 10 AI platform configs (Claude, Cursor, Windsurf, etc.)
- Single-command sync: _sync_all.py with --apply/--verify modes

- Root SKILL.md: developer roadmap, 5-question decision tree, anti-patterns
- All 5 sub-skill SKILL.md: narrative workflows, pre-delivery checklists, anti-pattern tables
- CLAUDE.md: AI agent development guide
- Architecture docs: src -> CLI sync rules

- Step-by-step narrative workflows (Step 1 -> Step 2 -> Step 3)
- User requirements extraction templates in every SKILL.md
- Pre-Delivery Checklists + Anti-Pattern lists for every sub-skill
- Structured output format (decision reasons + warnings + checklist)

- generalupdate-migration: v9.x -> v10 / dev-branch -> stable migration path
- generalupdate-security-audit: 14-point security audit matrix

- CI workflow: Python search test, codegen validation, .NET build, TypeScript check
- Release workflow: full validate -> changelog -> GitHub Release

- Fixed Dispatcher ambiguity in MVVM listener templates
- Fixed WinForms 'this' scope in event listeners
- Fixed MAUI missing using declarations
- Fixed CLI init only installed 1 skill (now installs all 7)
- Fixed CLI uninstall targeted scope
- Fixed project-scaffold {{PLACEHOLDER}} leakage

Co-Authored-By: Claude <noreply@anthropic.com>

* chore: add .gitignore for __pycache__

* fix: resolve all 19 Copilot review comments

- fix: 'bate' → 'beta' typo in skill.json, plugin.json, marketplace.json
- fix: skill.json version desc v10.4.6 → v10.5.0-beta.4
- fix: template.ts missing readFile import, platform path hardcoding
- fix: init.ts --ai all now routes to generateAllPlatformFiles
- fix: generate.ts command injection (execSync→spawnSync+argv)
- fix: extract.ts path injection (exec→execFile)
- fix: _sync_all.py filecmp shallow=False + --verify detects NEEDS SYNC
- fix: release.yml Windows paths on Linux runner
- fix: sync CLI assets after source changes

Co-Authored-By: Claude <noreply@anthropic.com

* fix: resolve all remaining issues for release readiness

- Unify version to 0.0.2-beta.1 across all manifests (SKILL.md, skill.json,
  plugin.json, marketplace.json, READMEs)
- Fix 'bate' typo to 'beta' in all docs
- Install CLI deps and fix TypeScript type error in uninstall.ts
- Run asset sync (_sync_all.py) and verify pass
- Update BowlIntegration.cs template to match real API (BowlContext record
  struct, DumpType, Normalize(), OnCrash callback)
- Verify Bowl LaunchAsync API: public Task<BowlResult> LaunchAsync(
  BowlContext, CancellationToken = default)
- Verify NuGet type conflict (CS0433) resolved in v10.5.0-beta.4 — Bowl and
  Core use independent namespaces, no Common.dll collision
- Update BUGS.md with verified status for both issues
- CRITICAL: Upgrade code generator templates from v10.4.6 API to v10.5.0-beta.4:
  - Bootstrap.cs.template: Configinfo -> UpdateRequest
  - listeners_console.cs.template: IsComplated -> IsCompleted
  - bowl_notice.cs.template: deprecated MonitorParameter -> BowlContext
  - DeploymentChecklist.md.template: Configinfo -> UpdateRequest
  - generate.py: remove outdated v10.4.6 comments and IsComplated refs
- Create RELEASE_CHECKLIST.md as 50+ item pre-release checklist
- Full validation: 15/15 search tests, 336 codegen combos, 3 strategy
  smoke tests, CLI TypeScript compile, sync verify all pass

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: address Copilot review comments — 5 items resolved

1. uninstall.ts: Replace 'as Exclude' type assertions with runtime
   narrowing via Array.filter() and control-flow type narrowing
2. bowl_notice.cs.template: BackupDirectory now points to previous
   version (not current version), preventing auto-restore failures
3. BUGS.md: Reconcile Core+Bowl conflict guidance — v10.5.0-beta.4
   has no CS0433 conflict, Bowl is a standalone package
4. All 7 docs updated: remove 'Core+Bowl mutual exclusion' guidance,
   replace with 'no conflict, reference both' for v10.5.0-beta.4
5. cli/package.json: Clarify version is independent from skill version

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: JusterZhu

.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": ".NET auto-update skill suite — 7 skills for GeneralUpdate: scaffolding, UI, strategy, advanced, troubleshooting (50+ issues), migration, and security audit",
-    "version": "0.0.1-beta.1"
+    "version": "0.0.2-beta.1"
   },
   "plugins": [
     {
       "name": "generalupdate-skill",
       "source": "./",
       "description": "Complete GeneralUpdate (.NET auto-update) integration skill suite. Generates dual-project scaffolding, full-state update UI (6 frameworks), 6 update strategies decision tree (Client-Server/OSS/Silent/Differential/CVP/Push), advanced extension points (Bowl crash daemon, IPC replacement, AOT), BM25-powered troubleshooting search (50+ known issues), v9.x→v10 migration guide, and 14-point security audit matrix. All templates target NuGet v10.5.0-beta.4.",
-      "version": "0.0.1-beta.1",
+      "version": "0.0.2-beta.1",
       "author": {
         "name": "JusterZhu"
       },

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "generalupdate-skill",
   "description": "Complete .NET auto-update skill suite for GeneralUpdate. 7 skills covering: Bootstrap scaffolding, update UI (6 frameworks), 6 strategies (Client-Server/OSS/Silent/Differential/CVP/Push), advanced extension points (Bowl, IPC, AOT), 50+ known issues diagnosis with BM25 search engine, version migration, and security audit. All templates target NuGet v10.5.0-beta.4.",
-  "version": "0.0.1-beta.1",
+  "version": "0.0.2-beta.1",
   "author": {
     "name": "JusterZhu"
   },

.claude/scripts/generate.py

@@ -45,7 +45,7 @@
         "name": "Differential Update",
         "slug": "differential",
         "description": "Delta patch update to save bandwidth (BSDIFF/HDiffPatch)",
-        "warning": "差分包大小建议不超过 2GB，避免 BSDIFF 整数溢出（v10.4.6+ 已修复 #514）。",
+        "warning": "差分包大小建议不超过 2GB，避免 BSDIFF 整数溢出（v10.5.0-beta.4 已修复 #514）。",
     },
     "cvp": {
         "name": "Cross-Version CVP",
@@ -183,7 +183,7 @@ def generate_issue_warnings(strategy, variables):
   - H4: OSS 不区分 Main/Upgrade 更新包，接受此行为
   - H5: Upgrade.exe 必须放在 update/ 子目录
   - L7: 示例代码中 OSS endpoint/bucket 写死，建议用环境变量
-  - M13: OssClient.AppType 值 3-4 在 v10.4.6 不支持""",
+  - M13: OssClient.AppType 值 3-4 在 v10.5.0-beta.4 中可用""",
         "silent": """⚠️ 静默更新特有已知问题:
   - H2: 无限升级循环 — 确保 manifest.json 版本号正确
   - M19: 静默通知可能不尊重系统的免打扰设置
@@ -203,7 +203,6 @@ def generate_issue_warnings(strategy, variables):
         "standard": """⚠️ 标准策略已知问题（非特有但常见）:
   - C1: UpgradeApp.exe 必须随首个版本发布
   - C2: Client/Upgrade NuGet 版本必须一致
-  - H3: IsComplated 拼写（注意不是 IsCompleted）
   - M5: InstallPath 使用相对路径导致文件解析失败
   - M6: UpdateUrl 返回空响应体时做 null 检查""",
     }

.claude/scripts/generate/templates/Bootstrap.cs.template

@@ -1,20 +1,16 @@
 using GeneralUpdate.Core;
-using GeneralUpdate.Common.Shared.Object;
-using GeneralUpdate.Common.Download;
+using GeneralUpdate.Core.Configuration;
+using GeneralUpdate.Core.Download;
 
-var config = new Configinfo
+var config = new UpdateRequest
 {
     // === 必需 ===
     UpdateUrl = "{{UPDATE_URL}}",
     AppSecretKey = "{{APP_SECRET_KEY}}",
-    AppName = "{{PROJECT_NAME}}.exe",
     MainAppName = "{{PROJECT_NAME}}.exe",
     ClientVersion = "{{CLIENT_VERSION}}",
     ProductId = "{{PRODUCT_ID}}",
     InstallPath = {{INSTALL_PATH}},
-
-    // === 可选 ===
-    Encoding = System.Text.Encoding.UTF8,
 {{#BOWL}}
     // Bowl 配置（仅包含 GeneralUpdate.Bowl 包，不重复添加 Core）
 {{/BOWL}}

.claude/scripts/generate/templates/DeploymentChecklist.md.template

@@ -7,7 +7,7 @@ Generated for: **{{STRATEGY_NAME}}** + **{{FRAMEWORK}}** | Bowl: **{{BOWL_UPPER}
 ## ✅ Pre-Deployment Checklist
 
 ### Bootstrap
-- [ ] `Configinfo` 6 个必填字段都已设置
+- [ ] `UpdateRequest` 6 个必填字段都已设置
 - [ ] `UpdateUrl` 已指向正确的服务端 API
 - [ ] `AppSecretKey` 长度 ≥ 32 字符
 

.claude/scripts/generate/templates/bowl_notice.cs.template

@@ -1,10 +1,19 @@
-// ⚠️ Bowl 崩溃守护 — 使用 GeneralUpdate.Bowl，不单独引用 Core
+// ⚠️ Bowl 崩溃守护
 // dotnet add package GeneralUpdate.Bowl
-var bowlParam = new GeneralUpdate.Bowl.MonitorParameter
+// NuGet v10.5.0-beta.4: Bowl 与 Core 无类型冲突，可按需同时引用
+// Refer to generalupdate-advanced/templates/BowlIntegration.cs for full example
+var context = new GeneralUpdate.Bowl.BowlContext
 {
     ProcessNameOrId = "{{PROJECT_NAME}}.exe",
     TargetPath = {{INSTALL_PATH}},
+    ExtendedField = "{{CLIENT_VERSION}}",
+    DumpFileName = "{{CLIENT_VERSION}}_fail.dmp",
+    FailFileName = "{{CLIENT_VERSION}}_fail.json",
+    FailDirectory = System.IO.Path.Combine({{INSTALL_PATH}}, "fail", "{{CLIENT_VERSION}}"),
+    // BackupDirectory 必须指向前一版本的备份目录，而非当前版本
+    // 例如当前版本为 {{CLIENT_VERSION}}，备份来自上一版本的 BackupDirectory
+    BackupDirectory = System.IO.Path.Combine({{INSTALL_PATH}}, "previous_version_backup"),
     WorkModel = "Upgrade",
-    FailDirectory = System.IO.Path.Combine({{INSTALL_PATH}}, "fail"),
-    BackupDirectory = System.IO.Path.Combine({{INSTALL_PATH}}, "backup"),
+    DumpType = GeneralUpdate.Bowl.DumpType.Mini,
+    AutoRestore = true,
 };

.claude/scripts/generate/templates/listeners_console.cs.template

@@ -9,7 +9,7 @@
     })
     .AddListenerMultiDownloadCompleted((_, e) =>
     {
-        Console.WriteLine($"\n版本 {e.Version} 下载完成 (IsComplated={e.IsComplated})");
+        Console.WriteLine($"\n版本 {e.Version} 下载完成 (IsCompleted={e.IsCompleted})");
     })
     .AddListenerMultiDownloadError((_, e) =>
     {

.claude/skills/generalupdate-advanced/SKILL.md

@@ -157,7 +157,7 @@ Console.WriteLine($"Result: Success={result.Success}, Restored={result.Restored}
 | `DumpType` | DumpType | Mini / Full | Full |
 | `OnCrash` | delegate | 崩溃回调 | null |
 
-> ⚠️ Bowl 和 Core 不能同时引用（CS0433）。使用 Bowl 时**只引用 `GeneralUpdate.Bowl`**，它传递依赖 Core 的所有功能。
+> ⚠️ NuGet v10.5.0-beta.4 中 Bowl 和 Core **无类型冲突**，可以同时引用。
 
 ---
 
@@ -332,7 +332,7 @@ var result = GeneralDrivelution.InstallDriver(driverPath);
 ## ✅ 高级定制验证清单
 
 ### Bowl 崩溃守护
-- [ ] 只引用了 `GeneralUpdate.Bowl`（不单独引用 Core）
+- [ ] 如果用 Bowl：项目中同时引用 `GeneralUpdate.Core` 和 `GeneralUpdate.Bowl`（v10.5.0-beta.4 无冲突）
 - [ ] `MonitorParameter` 的 `ProcessNameOrId` 与实际进程名匹配
 - [ ] `TargetPath` 设置为应用安装根目录，非子目录
 - [ ] `WorkModel` 根据场景选择 Correct（Normal/Upgrade）

.claude/skills/generalupdate-advanced/templates/BowlIntegration.cs

@@ -3,32 +3,79 @@
 using GeneralUpdate.Bowl;
 
 /// <summary>
-/// 【Skill 参考】Bowl 崩溃守护
+/// Bowl crash daemon integration.
 ///
-/// v10.5.0-beta.4 中 Bowl 使用 BowlContext 配置，支持 LaunchAsync 方法。
+/// Bowl monitors whether the main application starts normally after an upgrade.
+/// If a crash is detected, it captures a dump, exports diagnostics,
+/// and optionally restores the previous version from backup.
 ///
 /// NuGet: dotnet add package GeneralUpdate.Bowl --version 10.5.0-beta.4
+/// Note: Reference only GeneralUpdate.Bowl (it transitively includes Core).
+/// Do NOT reference GeneralUpdate.Core separately when using Bowl.
+///
+/// Platform prerequisites:
+///   - Windows: Sysinternals procdump.exe is auto-bundled via Bowl NuGet package
+///   - Linux:   Requires procdump installed (sudo apt install procdump)
 /// </summary>
 public static class BowlIntegration
 {
     public static async Task RunBowlAsync()
     {
+        // Configure the surveillance context
         var context = new BowlContext
         {
+            // Process to monitor (name or PID)
             ProcessNameOrId = "MyApp.exe",
-            DumpFileName = "v1.0.0.0_fail.dmp",
-            FailFileName = "v1.0.0.0_fail.json",
+
+            // Backup directory path (the version that was running before upgrade)
             TargetPath = @"C:\Program Files\MyApp",
-            FailDirectory = @"C:\Program Files\MyApp\fail",
-            BackupDirectory = @"C:\Program Files\MyApp\backup",
+
+            // Version string, used to name dump/crash files
+            ExtendedField = "1.0.0.1",
+
+            // Generated dump file path
+            DumpFileName = "1.0.0.1_fail.dmp",
+
+            // Generated crash report file path
+            FailFileName = "1.0.0.1_fail.json",
+
+            // Where dump/crash files will be written
+            FailDirectory = @"C:\Program Files\MyApp\fail\1.0.0.1",
+
+            // Backup location (the previous version's backup that can be restored)
+            BackupDirectory = @"C:\Program Files\MyApp\1.0.0.0",
+
+            // "Upgrade": integrated with update pipeline, auto-restores on crash
+            // "Normal":  standalone monitoring, no restore
             WorkModel = "Upgrade",
-            TimeoutMs = 30_000,
+
+            // Auto-restore the previous version on crash (only in "Upgrade" mode)
             AutoRestore = true,
+
+            // Dump type: Full (0), Mini (1), or Heap (2)
+            DumpType = DumpType.Full,
+
+            // Timeout for child process (procdump), default 30s
+            TimeoutMs = 30_000,
+
+            // Optional: crash callback for custom handling (logging, telemetry, etc.)
+            // OnCrash = async (crashInfo, ct) => { ... },
         };
 
+        // Apply sensible defaults (Normalize fills in TimeoutMs, WorkModel, DumpType if zero)
+        context = context.Normalize();
+
+        // Start surveillance. This blocks until the monitored process exits.
         var bowl = new Bowl();
-        var result = await bowl.LaunchAsync(context);
+        BowlResult result = await bowl.LaunchAsync(context);
 
-        Console.WriteLine($"[Bowl] 监控完成: Success={result.Success}, DumpCaptured={result.DumpCaptured}");
+        Console.WriteLine($"""
+            [Bowl] 监控完成
+              Success:      {result.Success}
+              ExitCode:     {result.ExitCode}
+              DumpCaptured: {result.DumpCaptured}
+              DumpFilePath: {result.DumpFilePath}
+              Restored:     {result.Restored}
+            """);
     }
 }

.claude/skills/generalupdate-init/SKILL.md

@@ -323,11 +323,10 @@ publish/
 
 ## ⚠️ 已知问题
 
-### NuGet 类型冲突
-`GeneralUpdate.Core` 和 `GeneralUpdate.Bowl` **不能同时引用**（CS0433 类型冲突）。
-请根据需求选择：
+### NuGet 注意事项（v10.5.0-beta.4）
+`GeneralUpdate.Core` 和 `GeneralUpdate.Bowl` **可以同时引用**（v10.5.0-beta.4 中无 CS0433 冲突）。
 - 使用 Core：`dotnet add package GeneralUpdate.Core`
-- 使用 Bowl：**只引用** `GeneralUpdate.Bowl`（它传递依赖 Core 所有功能）
+- 使用 Bowl：`dotnet add package GeneralUpdate.Bowl`（它**不**传递依赖 Core，需要同时引用 Core）
 - 差分类型已内嵌在 Core，**无需额外** `GeneralUpdate.Differential` 包
 
 ### 稳定版功能增强
@@ -354,7 +353,7 @@ v10.5.0-beta.4 新增以下功能：
 
 ### NuGet & 编译
 - [ ] Client 和 Upgrade 项目使用**完全相同**的 GeneralUpdate NuGet 版本
-- [ ] 如果用 Bowl：项目中只能有 `GeneralUpdate.Bowl`，不能同时有 `GeneralUpdate.Core`
+- [ ] 如果用 Bowl：项目中同时引用 `GeneralUpdate.Core` 和 `GeneralUpdate.Bowl`（v10.5.0-beta.4 无冲突）
 - [ ] 项目能正常 `dotnet build`（0 errors）
 - [ ] 无需额外引用 `GeneralUpdate.Differential`（已嵌入 Core）
 
@@ -376,14 +375,15 @@ v10.5.0-beta.4 新增以下功能：
 
 | # | 反模式 | 后果 | 正确做法 |
 |---|--------|------|---------|
-| 1 | **Core 和 Bowl 引用到同一个项目** | CS0433 类型冲突，编译失败 | 用 Bowl 时只引 Bowl（传递依赖 Core） |
-| 2 | **Client/Upgrade NuGet 版本号不一致** | 运行时 MethodNotFoundException | 锁定完全相同版本 |
-| 3 | **UpgradeApp.exe 不随首个版本发布** | 第一次更新时 FileNotFoundException | 首个版本就包含 UpgradeApp |
-| 4 | **事件监听中做耗时操作（网络 IO / 磁盘 IO）** | Update 进程 UI 卡死，超时被 Kill | 仅更新 UI 状态，耗时操作异步 |
-| 5 | **IPC 文件编码未设置 UTF-8** | Linux/macOS 中文乱码 | `Encoding.UTF8` |
-| 6 | **版本号不是 4 段式（如 1.0.0.0）** | 版本比较逻辑异常 | 始终用 `x.y.z.w` 格式 |
-| 7 | **manifest.json 的 mainAppName 不匹配真实进程名** | 更新后主程序找不到 | 和实际 exe 名称一致 |
-| 8 | **为 v9.x 编写的代码直接用在 v10** | API 不兼容，编译失败 | 对照 v10.4.6 稳定版 API 重写 |
+| 1 | **Core 和 Bowl NuGet 版本不一致** | 运行时 MethodNotFoundException | 使用相同 NuGet 版本 |
+| 2 | **Bowl 缺少 `GeneralUpdate.Core` 引用** | 编译失败，缺少 Core 类型 | Bowl 不传递依赖 Core，需同时引用 Core |
+| 3 | **Bowl 传递依赖 Core 的误解** | 编译失败 | v10.5.0-beta.4 中 Bowl 是独立包，需单独引用 Core |
+| 4 | **Client/Upgrade NuGet 版本号不一致** | 运行时 MethodNotFoundException | 锁定完全相同版本 |
+| 5 | **事件监听中做耗时操作（网络 IO / 磁盘 IO）** | Update 进程 UI 卡死，超时被 Kill | 仅更新 UI 状态，耗时操作异步 |
+| 6 | **IPC 文件编码未设置 UTF-8** | Linux/macOS 中文乱码 | `Encoding.UTF8` |
+| 7 | **版本号不是 4 段式（如 1.0.0.0）** | 版本比较逻辑异常 | 始终用 `x.y.z.w` 格式 |
+| 8 | **manifest.json 的 mainAppName 不匹配真实进程名** | 更新后主程序找不到 | 和实际 exe 名称一致 |
+| 9 | **为 v9.x 编写的代码直接用在 v10** | API 不兼容，编译失败 | 对照 v10.4.6 稳定版 API 重写 |
 
 ---