feat: batch update - gift card breakdown spec, backend APIs, miniprogram pages, ETL finance recharge, docs & migrations

.kiro/hooks/cwd-guard-shell.kiro.hook

@@ -1,8 +1,8 @@
 {
   "enabled": true,
   "name": "CWD Guard for Shell",
-  "description": "在 AI 执行 shell 命令前，检查是否在运行 Python 脚本。如果是，提醒 AI 确认 cwd 是否正确（仓库根 C:\\NeoZQYY），避免相对路径解析到错误位置。",
-  "version": "1",
+  "description": "在 AI 执行 shell 命令前，校验 cwd、命令语法和 Python 调用安全性，防止常见 Windows/PowerShell 陷阱。",
+  "version": "2",
   "when": {
     "type": "preToolUse",
     "toolTypes": [
@@ -11,6 +11,6 @@
   },
   "then": {
     "type": "askAgent",
-    "prompt": "如果即将执行的命令包含 `python` 且涉及 scripts/ops/、.kiro/scripts/、apps/etl/connectors/feiqiu/scripts/ 下的脚本，请确认：1) cwd 参数是否设置为仓库根目录 C:\\NeoZQYY；2) 脚本是否已有 ensure_repo_root() 校验。如果 cwd 不对且脚本无校验，请修正 cwd 后再执行。对于非 Python 命令或不涉及上述目录的命令，直接放行。"
+    "prompt": "请对即将执行的 shell 命令做以下检查，发现问题则修正后再执行，全部通过则直接放行：\n\n1. **cwd 校验**：如果命令涉及 scripts/ops/、.kiro/scripts/、apps/etl/connectors/feiqiu/scripts/ 下的 Python 脚本，cwd 必须为仓库根 C:\\NeoZQYY。ETL 模块命令 cwd 应为 apps/etl/connectors/feiqiu/，后端命令应为 apps/backend/，前端命令应为 apps/admin-web/。\n2. **裸调 Python/Node 拦截**：如果命令包含 `python`、`node`、`ipython` 但没有跟 `-c`、`-m` 或脚本路径参数，必须修正（会导致 REPL 劫持 shell）。\n3. **命令连接符**：如果使用了 `&&`，替换为 `;`（PowerShell 语法）。\n4. **环境变量语法**：如果使用了 `$VAR_NAME` 读取环境变量，替换为 `$env:VAR_NAME`（PowerShell 语法）。\n\n对于不涉及上述问题的命令，直接放行。"
   }
-}
+}

.kiro/hooks/repl-hijack-guard.kiro.hook

@@ -0,0 +1,16 @@
+{
+  "enabled": true,
+  "name": "REPL 劫持检测与恢复",
+  "description": "在 shell 命令执行后检查输出，若发现 REPL 劫持症状（exit code 0 但无输出、出现 >>> 提示符），先尝试 exit 命令自救，失败则提醒用户手动终止进程。",
+  "version": "1",
+  "when": {
+    "type": "postToolUse",
+    "toolTypes": [
+      "shell"
+    ]
+  },
+  "then": {
+    "type": "askAgent",
+    "prompt": "检查刚执行的 shell 命令输出，判断是否出现 REPL 劫持症状：\n1. exit code 0 但完全无输出（对于预期有输出的命令）\n2. 输出中出现 `>>>` 或 `...` 等 Python REPL 提示符\n3. 输出中出现 `>` 等 Node REPL 提示符\n\n如果检测到症状：\n- 第一步：立即执行 `exit` 命令尝试退出 REPL\n- 第二步：执行一条验证命令（如 `echo \"shell_ok\"`）确认 shell 已恢复\n- 如果恢复成功：重新执行原命令\n- 如果仍未恢复：停止重试，提醒用户在外部终端执行 `Get-Process python* | Stop-Process -Force`，等用户确认后再继续\n\n如果没有症状，直接放行，不做任何操作。"
+  }
+}