@whyshu/argent-engine 0.7.5 → 0.7.7

package/engine/verticals/mercadolibre/manifest.json

@@ -1,11 +1,11 @@
 {
   "id": "mercadolibre",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "title": "美客多（MercadoLibre）业务线",
   "_note": "P2a 落位：flows/prompts/暂停开关/日志/会话文件已命名空间化；角色/preset/技能仍是旧名（legacyNaming，P2b/P5 在有重启窗口时改名）；能力与计费单位仍在 base（随重装窗口改 SKU id）；适配器仍在 scripts/integrations（P4 端口化时搬）。",
-  "_versionNote": "0.1.1（2026-10-06）：`requires.argent` 由 `>=0.2 <0.3` 抬到 `>=0.3 <0.4`（平台现役 VERSION=0.3.0）—— 修前「Argent 能力 → 概览」把这唯一的业务线标成 `⚠️ 版本不满足`，而它实际能跑（口径与事实相反）。同批 `version` +1（P0-5，见 docs/Argent-工作台口径审计-2026-10-06.md）。｜0.1.2（2026-10-09）：**平台抬到 0.4.0** ⇒ `requires.argent` 同步抬到 `>=0.4 <0.5`（不改则会重演 P0-5：兼容区间把现役平台挡在门外）。判据已固化为门禁 `node scripts/check-version-consistency.mjs`（**平台版本必须落在每条业务线声明的兼容区间内**），不再靠人记得复核。⚠️ `verifiedOn.argent` **刻意维持 `0.3.0`**：该字段记的是\"**真装真跑过**\"，本批只抬版本号、内核无行为改动，未在 0.4.0 上跑过生产 ⇒ 落地后补登，⛔ 不预填。",
+  "_versionNote": "0.1.1（2026-10-06）：`requires.argent` 由 `>=0.2 <0.3` 抬到 `>=0.3 <0.4`（平台现役 VERSION=0.3.0）—— 修前「Argent 能力 → 概览」把这唯一的业务线标成 `⚠️ 版本不满足`，而它实际能跑（口径与事实相反）。同批 `version` +1（P0-5，见 docs/Argent-工作台口径审计-2026-10-06.md）。｜0.1.2（2026-10-09）：**平台抬到 0.4.0** ⇒ `requires.argent` 同步抬到 `>=0.4 <0.5`（不改则会重演 P0-5：兼容区间把现役平台挡在门外）。判据已固化为门禁 `node scripts/check-version-consistency.mjs`（**平台版本必须落在每条业务线声明的兼容区间内**），不再靠人记得复核。⚠️ `verifiedOn.argent` **刻意维持 `0.3.0`**：该字段记的是\"**真装真跑过**\"，本批只抬版本号、内核无行为改动，未在 0.4.0 上跑过生产 ⇒ 落地后补登，⛔ 不预填。｜0.1.3（2026-10-21）：平台版本线已到 0.7.6 ⇒ `requires.argent` 由 `>=0.4 <0.5` 抬到 `>=0.7 <0.8`（原区间把现役平台挡在门外；`check-version-consistency` R1-LOCKSTEP 实测报红）。",
   "requires": {
-    "argent": ">=0.4 <0.5",
+    "argent": ">=0.7 <0.8",
     "dsh": ">=0.1.5 <0.2"
   },
   "verifiedOn": {
@@ -50,7 +50,8 @@
     "ml-invoice",
     "ml-invoice-xzh",
     "ml-store-daily-report",
-    "ml-config-guide"
+    "ml-config-guide",
+    "ml-full-appointment"
   ],
   "flows": [
     "mercadolibre.full",

package/engine/verticals/mercadolibre/prompts/daily-report.failure.md

@@ -43,7 +43,7 @@
 
 ```bash
 node {{cloneScripts}}/feishu-card.mjs --template need-human --flow {{flow}} --case '{{case}}' \
-  --reason '<卡在哪/缺什么>' --ask '<要用户定什么>' --to internal --send
+  --reason '<卡在哪/缺什么>' --ask '<要用户定什么>' --to daily --send
 ```
 
 `needs_agent` 类由引擎在唤醒时自动发 failure-alert 卡片（与你重复也没关系，卡片是给人看的）。

package/engine/verticals/mercadolibre/prompts/daily-report.md

@@ -27,21 +27,18 @@
   失败才退回影子取证（见步骤②）并把问题暴露出来；
 - 认领最多 {{max}} 张；台账：`{{ledger}}`。
 
-## 收尾必做：发飞书**卡片**（2026-09-17 用户口径：流程/告警类一律卡片）
+## 收尾：日报结果通知（2026-10-20 修订）
 
-本轮结束时，用共用构造器把结果发成卡片（**不要发纯文本长消息**）：
+- **日报成功时不要再发 flow-result 汇总卡**：`daily-report.mjs` 已经把日报表卡发到
+  日报群（`ML_DAILY_CHAT_ID`），再发一张汇总卡只会重复刷屏。
+- **只有失败 / needs_human / blocked** 才发卡片；落点必须是**日报群**，不是内部群：
 
 ```bash
-# 流程结果汇报（一票一行：<票号>=<状态>|<细节>；状态用 done / failed / blocked 等）
-node {{cloneScripts}}/feishu-card.mjs --template flow-result \
-  --flow {{flow}} --flow-title '{{flowTitle}}' \
-  --result '<票号>=done|<做了什么>' --note '本轮一句话小结' --to internal --send
-
-# 需要人确认时（needs_human / blocked）：用需人工卡，写清「卡在哪」与「要你定什么」
 node {{cloneScripts}}/feishu-card.mjs --template need-human \
-  --flow {{flow}} --case '<票号>' --reason '<卡在哪>' --ask '<要用户定什么>' --to internal --send
+  --flow {{flow}} --case '{{case}}' \
+  --reason '<卡在哪/缺什么>' --ask '<要用户定什么>' --to daily --send
 ```
 
 - 先 `--dry-run`（不带 `--send`）看一眼卡片 JSON 再发；发送失败**不要**反复重试，改把结论写进台账；
-- 落点固定内部群（`--to internal`，= `FULL_INTERNAL_CHAT_ID`）；日报类才用 `--to daily`；
+- ⛔ 日报流程不要用 `--to internal`；内部群只接收 FULL/发票等内部流程卡片。
 - 台账照旧记（卡片是给人看的，台账是给引擎看的，两者都要）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whyshu/argent-engine",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "description": "Argent 引擎（L1）：流程/台账/重试/守卫/审计/浏览器自动化 —— 逐字节来自 argent-dsh 仓库",
   "type": "module",
   "engines": {

package/engine/scripts/ml-ads.mjs

@@ -1,181 +0,0 @@
-#!/usr/bin/env node
-/**
- * ml-ads.mjs —— Mercado Ads（Product Ads）**只读**效果报告 CLI。
- *
- * ## 干什么
- * 用与日报同一条授权链（`~/.dsh/argent/ml-api-stores.json`）逐店拉广告数据，输出：
- *   花费 / 广告销售额 / ROAS / ACoS / 点击 / CTR / CPC / 广告单量，
- *   外加**告警**（ACoS 超标、烧钱零转化、ROAS 过低）和活动级下钻。
- *
- * ## 用法
- *   node scripts/ml-ads.mjs                          # 全部已授权店铺 · 近 7 个完整自然日
- *   node scripts/ml-ads.mjs --store 1店               # 店铺子串过滤
- *   node scripts/ml-ads.mjs --days 30                 # 回溯天数（MELI 上限 90）
- *   node scripts/ml-ads.mjs --to 2026-10-16           # 指定结束日（站点本地）
- *   node scripts/ml-ads.mjs --detail                  # 附「花钱最多 / ACoS 超标」活动
- *   node scripts/ml-ads.mjs --json                    # 结构化输出（stdout 纯 JSON）
- *   node scripts/ml-ads.mjs --lines                   # 只输出中文卡片行（给日报/角色回复用）
- *   node scripts/ml-ads.mjs --list                    # 只列每店广告主，不拉活动
- *   node scripts/ml-ads.mjs --acos-bad 30 --min-spend 200   # 告警阈值
- *
- * ## 只读纪律
- *   · 只发 GET（`/advertising/...`）；⛔ 不改预算/暂停/调价，也不写任何客户数据；
- *   · 唯一写盘 = token 轮换回写（MELI refresh_token 是轮换制，不写回下次必 429）：
- *     原子写（tmp + rename）、保持 600；
- *   · API 基址：`ML_API_BASE` → 默认平台地址（引擎 lib 里⛔不含域名，只在本 CLI 注入）。
- */
-import { readFileSync, writeFileSync, renameSync, existsSync, mkdirSync, chmodSync } from 'node:fs'
-import { join, dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { resolveDataDir } from './lib/argent-datadir.mjs'
-import {
-  loadEnvFile, refreshStoreToken, apiGet as coreApiGet,
-  SITE_TZ, SITE_CURRENCY, fallbackSite, startOfLocalDayUTC, localDateStr, matchStores,
-} from './lib/daily-report-core.mjs'
-import {
-  fetchAdsReport, classifyAdsAlerts, adsCardLines, fmtMoney, ADS_ALERT_DEFAULTS,
-} from './lib/ml-ads-core.mjs'
-
-const API_BASE = () => process.env.ML_API_BASE || 'https://api.mercadolibre.com'
-
-const args = process.argv.slice(2)
-const argVal = (n) => { const i = args.indexOf(n); return i >= 0 && args[i + 1] ? args[i + 1] : null }
-const has = (n) => args.includes(n)
-
-if (has('-h') || has('--help')) {
-  console.log(`Mercado Ads 只读报告
-
-用法: node scripts/ml-ads.mjs [选项]
-  --store <名或uid>   店铺过滤（名称子串 / uid 全等，与日报同一判据）
-  --days <n>          回溯天数，默认 7（MELI 上限 90）
-  --to <YYYY-MM-DD>   结束日（站点本地），默认「昨天」
-  --detail            附活动级下钻（花钱最多 + ACoS 超标）
-  --list              只列出每店广告主（1 请求/店）
-  --json              结构化 JSON（stdout）
-  --lines             中文卡片行（给日报分区/角色回复复用）
-  --acos-warn <n>     ACoS 黄色阈值，默认 ${ADS_ALERT_DEFAULTS.acosWarn}
-  --acos-bad <n>      ACoS 红色阈值，默认 ${ADS_ALERT_DEFAULTS.acosBad}
-  --min-spend <n>     告警最小花费（本币），默认 ${ADS_ALERT_DEFAULTS.minSpend}
-  --env <path>        daily-report.env 路径
-退出码: 0 正常 ｜ 1 用法/取数失败 ｜ 2 全部店铺失败`)
-  process.exit(0)
-}
-
-const DATA_DIR = resolveDataDir({ env: process.env }).dir
-const ENV_PATH = argVal('--env') || join(DATA_DIR, 'daily-report.env')
-const STORES_PATH = process.env.ML_API_STORES_JSON || join(DATA_DIR, 'ml-api-stores.json')
-const env = loadEnvFile(ENV_PATH)
-const doc = existsSync(STORES_PATH) ? JSON.parse(readFileSync(STORES_PATH, 'utf8')) : { stores: [] }
-const stores = doc.stores || []
-
-const persistStores = () => {
-  try {
-    mkdirSync(dirname(STORES_PATH), { recursive: true })
-    const tmp = `${STORES_PATH}.tmp`
-    writeFileSync(tmp, JSON.stringify({ stores }, null, 2) + '\n', { mode: 0o600 })
-    renameSync(tmp, STORES_PATH)
-    chmodSync(STORES_PATH, 0o600)
-  } catch (e) { console.error(`✗ token 写回失败：${e.message}`) }
-}
-const apiGet = (path, token) => coreApiGet(path, token, { base: API_BASE() })
-
-const alertOpts = {
-  acosWarn: Number(argVal('--acos-warn') || ADS_ALERT_DEFAULTS.acosWarn),
-  acosBad: Number(argVal('--acos-bad') || ADS_ALERT_DEFAULTS.acosBad),
-  minSpend: Number(argVal('--min-spend') || ADS_ALERT_DEFAULTS.minSpend),
-  minRoas: ADS_ALERT_DEFAULTS.minRoas,
-}
-
-const FLAG_JSON = has('--json')
-const FLAG_LINES = has('--lines')
-const FLAG_DETAIL = has('--detail')
-const FLAG_LIST = has('--list')
-const days = Math.max(1, Math.min(90, Number(argVal('--days') || 7)))
-const toArg = argVal('--to')
-
-const now = new Date()
-const picked = matchStores(stores, (argVal('--store') || '').split(',').map((x) => x.trim()).filter(Boolean))
-if (!picked.length) {
-  console.error(`✗ 没有匹配到店铺（已授权 ${stores.length} 家）`)
-  process.exit(1)
-}
-
-const results = []
-for (const store of picked) {
-  const site = fallbackSite(store.site)
-  const tz = SITE_TZ[site]
-  const todayStart = startOfLocalDayUTC(tz, now)
-  const toMs = toArg ? startOfLocalDayUTC(tz, new Date(`${toArg}T12:00:00Z`)) : todayStart - 86400000
-  const fromMs = toMs - (days - 1) * 86400000
-  const dateFrom = localDateStr(tz, new Date(fromMs))
-  const dateTo = localDateStr(tz, new Date(toMs))
-  const row = { store: store.name, site, uid: store.user_id, currency: SITE_CURRENCY[site] || '', dateFrom, dateTo }
-  try {
-    const token = await refreshStoreToken(env, store, { onRotate: persistStores })
-    if (FLAG_LIST) {
-      const adv = await apiGet('/advertising/advertisers?product_id=PADS', token)
-      row.advertisers = (adv.advertisers || []).map((a) => ({ advertiser_id: a.advertiser_id, site: a.site_id, name: a.advertiser_name }))
-      results.push(row)
-      continue
-    }
-    const report = await fetchAdsReport({ apiGet, token, site, dateFrom, dateTo })
-    row.report = report
-    row.alerts = classifyAdsAlerts(report.totals, alertOpts)
-    results.push(row)
-  } catch (e) {
-    row.error = String(e.message || e)
-    results.push(row)
-  }
-}
-
-// ── 输出 ───────────────────────────────────────────────────
-const ok = results.filter((r) => !r.error)
-if (!ok.length) {
-  if (FLAG_JSON) console.log(JSON.stringify({ results }, null, 2))
-  else for (const r of results) console.error(`✗ ${r.store}：${r.error}`)
-  process.exit(2)
-}
-if (FLAG_JSON) { console.log(JSON.stringify({ generatedAt: now.toISOString(), days, results }, null, 2)); process.exit(0) }
-
-if (FLAG_LINES) {
-  for (const r of ok) {
-    const lines = adsCardLines(r.report, { currency: r.currency, alertOpts })
-    console.log(`### ${r.store}`)
-    console.log(lines.join('\n'))
-  }
-  process.exit(0)
-}
-
-if (FLAG_LIST) {
-  for (const r of results) {
-    if (r.error) { console.log(`${r.store}: ✗ ${r.error}`); continue }
-    console.log(`${r.store}（${r.site}）：` + (r.advertisers.length ? r.advertisers.map((a) => `${a.advertiser_id}(${a.site})`).join(', ') : '无广告主'))
-  }
-  process.exit(0)
-}
-
-const hdr = ['店铺', '站点', '花费', '销售额', 'ROAS', 'ACoS', '点击', 'CTR', '广告单量', '活动']
-let text = `## 📣 Mercado Ads · ${ok[0].dateFrom} ~ ${ok[0].dateTo}（近 ${days} 天）\n\n`
-text += '| ' + hdr.join(' | ') + ' |\n|' + hdr.map(() => '---').join('|') + '|\n'
-const allAlerts = []
-for (const r of results) {
-  if (r.error) { text += `| ${r.store} | ${r.site} | — | — | — | — | — | — | — | ✗ ${r.error.slice(0, 40)} |\n`; continue }
-  const t = r.report.totals
-  const c = r.currency ? r.currency + ' ' : ''
-  text += `| ${r.store} | ${r.site} | ${c}${fmtMoney(t.cost)} | ${c}${fmtMoney(t.amount)} | ${t.roas} | ${t.acos}% | ${t.clicks} | ${t.ctr}% | ${t.units} | ${t.campaigns} |\n`
-  for (const a of r.alerts) allAlerts.push({ store: r.store, ...a })
-  if (FLAG_DETAIL) {
-    for (const a of r.report.advertisers) {
-      const top = [...(a.topCampaigns.top || [])]
-      for (const cp of top) text += `| ↳ ${r.store}·${cp.name.slice(0, 24)} | ${a.advertiserId} | ${c}${fmtMoney(cp.cost)} | ${c}${fmtMoney(cp.amount)} | ${cp.roas} | ${cp.acos}% | ${cp.clicks} | — | ${cp.units} | — |\n`
-    }
-  }
-}
-text += '\n'
-if (allAlerts.length) {
-  text += '### ⚠️ 告警\n'
-  for (const a of allAlerts) text += `- ${a.level === 'red' ? '🔴' : '🟡'} **${a.store}**：${a.text}\n`
-} else {
-  text += '✅ 无告警（ACoS 与 ROAS 均在阈值内）\n'
-}
-console.log(text)