deveco_hmigbot 0.21.5

package/skills/migrate-core/scripts/feasibility/feasibility.mjs

@@ -0,0 +1,235 @@
+#!/usr/bin/env node
+/**
+ * feasibility.mjs — 开工体检 / 红黄绿自动分诊（纯脚本，分钟级，零模型）
+ *
+ * 三张账：三方库 × 等价物表（库墙） / manifest 系统集成面 × 开放度表（平台墙） / UI 技术判型。
+ * 结论：逐能力三档（green/yellow/red），应用级颜色推导（红项才红；黄项=带预案继续）。
+ * 全自动纪律：本工具只出画像与处置建议，不问人。红灯的停/走由上层策略（尽力而为/快速失败）决定。
+ *
+ * 用法：node feasibility.mjs --src <Android 工程根> [--json out.json] [--gate]
+ * 退出码：默认恒 0；--gate 时 green=0 / yellow=4 / red=5（供工作流 check() 分诊）。
+ */
+import { readFileSync, readdirSync, statSync, writeFileSync, existsSync } from 'node:fs';
+import { join, resolve, relative, sep, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { extractNavGraph, extractComposeProject } from '../wire/extractors.mjs';
+
+const argv = process.argv.slice(2);
+const argOf = (n, d) => { const i = argv.indexOf(n); return i >= 0 && argv[i + 1] ? argv[i + 1] : d; };
+const SRC = argOf('--src', null);
+const OUT = argOf('--json', null);
+const GATE = argv.includes('--gate');
+if (!SRC) { console.error('usage: feasibility.mjs --src <android root> [--json out] [--gate]'); process.exit(3); }
+const HERE = dirname(fileURLToPath(import.meta.url));
+const LIBS = JSON.parse(readFileSync(join(HERE, 'tables', 'lib-equivalence.json'), 'utf8'));
+// 工作区级裁决缓存（spec/lib-adjudications.json）：本轮"待裁决依赖"的结论落工作区合并读——
+// 套件表只由维护者审后更新（回流走 feedback，不直接改语料/表）
+const ADJ = join(dirname(resolve(argOf('--json', 'spec/feasibility.json'))), 'lib-adjudications.json');
+if (existsSync(ADJ)) {
+  try {
+    const adj = JSON.parse(readFileSync(ADJ, 'utf8'));
+    for (const e of (Array.isArray(adj) ? adj : adj.entries || [])) if (e && e.match) LIBS.entries.push({ source: 'adjudicated(workspace)', ...e });
+  } catch { console.error('[feasibility] lib-adjudications.json 解析失败，忽略'); }
+}
+const CAPS = JSON.parse(readFileSync(join(HERE, 'tables', 'system-capabilities.json'), 'utf8'));
+// 第②层：权威映射数据导入——优先级低于种子实证缓存（数组顺序即优先级）。
+// 默认自动装载 tables/imported-arkts-core.json（由套件仓 devtools/import-arkts-core-map.mjs 从 ArkTs-Core
+// 官方 50+ 库映射表转换而来）；--extra-map 可再叠加（openharmony-tpc 三方库地图等）。
+for (const mapFile of [join(HERE, 'tables', 'imported-arkts-core.json'), argOf('--extra-map', null)].filter(Boolean)) {
+  if (existsSync(mapFile)) {
+    const em = JSON.parse(readFileSync(mapFile, 'utf8'));
+    LIBS.entries.push(...(em.entries || em));
+  }
+}
+const PROBE = argv.includes('--probe-ohpm');
+async function probeOhpm(artifact) {
+  // 第③层：ohpm 生态确定性探测（在线，best-effort；失败=无线索，不定罪）
+  try {
+    const q = artifact.split(':').pop();
+    const url = (LIBS.ohpmSearch || '').replace('{q}', encodeURIComponent(q));
+    if (!url) return null;
+    const res = await fetch(url, { signal: AbortSignal.timeout(6000) });
+    if (!res.ok) return null;
+    const j = await res.json();
+    const rows = j?.body?.rows || j?.rows || [];
+    return rows.slice(0, 3).map(r => r.name || r.packageName).filter(Boolean);
+  } catch { return null; }
+}
+
+const EXCLUDE = new Set(['build', '.git', '.gradle', 'node_modules', '.idea']);
+function walk(dir, acc, depth = 0) {
+  if (depth > 14) return acc;
+  let es; try { es = readdirSync(dir); } catch { return acc; }
+  for (const e of es) {
+    if (EXCLUDE.has(e)) continue;
+    const p = join(dir, e);
+    let st; try { st = statSync(p); } catch { continue; }
+    if (st.isDirectory()) walk(p, acc, depth + 1);
+    else acc.push(p);
+  }
+  return acc;
+}
+const files = walk(resolve(SRC), []);
+const rel = f => String(f).replace(resolve(SRC) + sep, '');
+
+// ---------- 1) 依赖清单（build.gradle / .kts / libs.versions.toml） ----------
+const gradleFiles = files.filter(f => /build\.gradle(\.kts)?$/.test(f));
+const tomlFiles = files.filter(f => f.endsWith('libs.versions.toml'));
+const deps = new Set();
+for (const f of gradleFiles) {
+  const code = readFileSync(f, 'utf8');
+  for (const m of code.matchAll(/(?:implementation|api|compileOnly|runtimeOnly|kapt|ksp)\s*[\(\s]\s*["']([\w.\-]+:[\w.\-]+)(?::[^"']*)?["']/g)) deps.add(m[1]);
+}
+for (const f of tomlFiles) {
+  const code = readFileSync(f, 'utf8');
+  for (const m of code.matchAll(/module\s*=\s*["']([\w.\-]+:[\w.\-]+)["']/g)) deps.add(m[1]);
+  for (const m of code.matchAll(/group\s*=\s*["']([\w.\-]+)["']\s*,\s*name\s*=\s*["']([\w.\-]+)["']/g)) deps.add(`${m[1]}:${m[2]}`);
+  for (const m of code.matchAll(/name\s*=\s*["']([\w.\-]+)["']\s*,\s*group\s*=\s*["']([\w.\-]+)["']/g)) deps.add(`${m[2]}:${m[1]}`); // 内联表 name 在前的写法
+}
+// settings.gradle(.kts) 的 versionCatalogs { library(...) } DSL——盲区会让库墙假阴偏绿
+for (const f of files.filter(x => /settings\.gradle(\.kts)?$/.test(x))) {
+  const code = readFileSync(f, 'utf8');
+  for (const m of code.matchAll(/library\s*\(\s*["'][^"']+["']\s*,\s*["']([\w.\-]+)["']\s*,\s*["']([\w.\-]+)["']\s*\)/g)) deps.add(`${m[1]}:${m[2]}`);
+  for (const m of code.matchAll(/library\s*\(\s*["'][^"']+["']\s*,\s*["']([\w.\-]+:[\w.\-]+)(?::[^"']*)?["']\s*\)/g)) deps.add(m[1]);
+}
+// 源码规模 + import 面（供 none 库的调用面统计）
+const srcFiles = files.filter(f => /\.(java|kt)$/.test(f) && f.includes(`${sep}src${sep}`) && !f.includes(`${sep}test`));
+let totalLines = 0;
+const importLines = [];
+for (const f of srcFiles) {
+  const code = readFileSync(f, 'utf8');
+  totalLines += code.split('\n').length;
+  for (const m of code.matchAll(/^import\s+([\w.]+)/gm)) importLines.push(m[1]);
+}
+const libFindings = [];
+for (const d of deps) {
+  const entry = LIBS.entries.find(e => new RegExp(e.match, e.source === 'official-map' ? 'i' : '').test(d));
+  if (!entry) {
+    // 缓存未命中：不猜。可选 ohpm 探测给线索，最终 status=unadjudicated，
+    // 由迁移流程的裁决步（模型+证据）定夺并回写缓存（source=adjudicated）。
+    const f = { dep: d, status: 'unadjudicated', note: '缓存未命中——待裁决回写' };
+    // 调用面无论如何先量出来（身份无关的确定性事实，供裁决用）
+    const guessPrefix = d.split(':')[0];
+    f.callFace = importLines.filter(i => i.startsWith(guessPrefix)).length;
+    if (PROBE) {
+      const hits = await probeOhpm(d);
+      if (hits && hits.length) f.ohpmHints = hits;
+    }
+    libFindings.push(f);
+    continue;
+  }
+  if (entry.status === 'ignore') continue;
+  const finding = { dep: d, status: entry.status, harmony: entry.harmony || null, note: entry.note, evidence: entry.evidence, source: entry.source || 'seed' };
+  if (entry.status === 'none' && entry.importPrefix) {
+    finding.callFace = importLines.filter(i => i.startsWith(entry.importPrefix)).length;
+    finding.overThreshold = finding.callFace >= (LIBS.noneCallFaceThreshold || 20);
+  }
+  libFindings.push(finding);
+}
+
+// ---------- 2) 系统集成面（manifest + 关键源码标记） ----------
+const manifests = files.filter(f => f.endsWith('AndroidManifest.xml') && f.includes(`${sep}main${sep}`));
+let manifestText = manifests.map(f => readFileSync(f, 'utf8')).join('\n');
+// 源码级标记补充（AppOpsManager 这类 manifest 看不到的）；超采样上限必须告知——静默截断=漏检谎报
+const SAMPLE_CAP = 800;
+const srcSampleTruncated = srcFiles.length > SAMPLE_CAP;
+const srcSample = srcFiles.slice(0, SAMPLE_CAP).map(f => readFileSync(f, 'utf8')).join('\n');
+const capFindings = [];
+for (const e of CAPS.entries) {
+  const re = new RegExp(e.marker);
+  const inManifest = re.test(manifestText);
+  const inSrc = re.test(srcSample);
+  if (inManifest || inSrc) {
+    // 平台墙按调用面分档：边缘能力（全工程命中 ≤ coreThreshold，默认 3）不拦全应用——降黄
+    // 置灰照迁；主业级能力（高频命中，如拨号器 telecom 全家桶）才红。表条目可覆写阈值。
+    const g = new RegExp(e.marker, 'g');
+    const face = ((srcSample.match(g) || []).length) + ((manifestText.match(g) || []).length);
+    let wall = e.wall, disposition = e.disposition;
+    const th = e.coreThreshold ?? 3;
+    if (wall === 'red' && face <= th) { wall = 'yellow'; disposition = `边缘能力（命中 ${face} 处）置灰降级：${e.disposition}`; }
+    capFindings.push({ cap: e.cap, wall, callFace: face, where: inManifest ? 'manifest' : 'source', disposition, evidence: e.evidence });
+  }
+}
+
+// ---------- 3) UI 技术判型 ----------
+const layoutXml = files.filter(f => /\/res\/layout[^/]*\/.*\.xml$/.test(f.replace(/\\/g, '/'))).length;
+const hasCompose = [...deps].some(d => d.includes('compose')) || /androidx\.compose/.test(srcSample);
+const uiTech = hasCompose && layoutXml > 5 ? 'mixed' : hasCompose ? 'compose' : 'xml';
+
+// ---------- 3.5) 跨端框架检测（壳应用改道，不走原生重写） ----------
+const XP = JSON.parse(readFileSync(join(HERE, 'tables', 'cross-platform.json'), 'utf8'));
+// 强证据=依赖清单/manifest 命中；文件名命中（排除文档类）只算弱证据——
+// docs/uni-app-对比.md 这类路径不许把整单打成红灯改道
+const xpStrongHay = [...deps].join('\n') + '\n' + manifestText.slice(0, 20000);
+const xpPathHay = files.filter(f => !/\.(md|txt|html?|pdf)$/i.test(f)).slice(0, 4000).map(f => f.split(sep).pop()).join('\n');
+const crossPlatform = XP.entries.map(e => {
+  const re = new RegExp(e.marker, 'i');
+  if (re.test(xpStrongHay)) return { framework: e.framework, disposition: e.disposition };
+  if (re.test(xpPathHay)) return { framework: e.framework, disposition: e.disposition, weak: true };
+  return null;
+}).filter(Boolean);
+const xpStrong = crossPlatform.filter(c => !c.weak);
+const xpWeak = crossPlatform.filter(c => c.weak);
+
+// ---------- 4) 裁决 ----------
+const redLibs = libFindings.filter(l => l.status === 'none' && l.overThreshold);
+const redCaps = capFindings.filter(c => c.wall === 'red');
+const yellowItems = [
+  ...libFindings.filter(l => (l.status === 'none' && !l.overThreshold) || l.status === 'partial'),
+  ...capFindings.filter(c => c.wall === 'yellow'),
+];
+const verdict = xpStrong.length ? 'red' : (redLibs.length || redCaps.length) ? 'red' : ((yellowItems.length || xpWeak.length) ? 'yellow' : 'green');
+
+// ---------- 应用形态画像（下游按此分派：路由提取轨/语料加载/门配置） ----------
+const srcTexts = srcFiles.map(f => { try { return readFileSync(f, 'utf8'); } catch { return ''; } });
+const cnt = (re) => srcTexts.reduce((n, t) => n + (t.match(re) || []).length, 0);
+const navGraphXml = files.filter(f => /[\\/]res[\\/]navigation[\\/][^\\/]+\.xml$/.test(f)).length;
+const manifestActs = files.filter(f => f.endsWith('AndroidManifest.xml') && f.includes(`${sep}main${sep}`))
+  .reduce((n, f) => { try { return n + ((readFileSync(f, 'utf8').match(/<activity[\s>]/g) || []).length); } catch { return n; } }, 0);
+const composableN = cnt(/@Composable/g), navHostN = cnt(/\bNavHost\s*\(/g), fragmentN = cnt(/:\s*(?:Dialog)?Fragment\(|extends\s+(?:Dialog)?Fragment\b/g);
+const presenterN = cnt(/\bPresenter\b/g), viewModelN = cnt(/:\s*ViewModel\(|extends\s+ViewModel\b|AndroidViewModel/g);
+// 规模档建议值（标准只给默认，模型结合调用深度可改判并写理由）
+// 页面数按路由真源数（与 wire-routes 同一套提取器）：manifest Activity + navGraph 目的地 + Compose 目的地；三者都空时才退回 Fragment 计数
+const navDest = new Set();
+for (const f of files.filter(f => /[\\/]res[\\/]navigation[\\/][^\\/]+\.xml$/.test(f))) { try { for (const r of extractNavGraph(readFileSync(f, 'utf8'))) navDest.add(r.route); } catch { /* 坏 XML 不计 */ } }
+const composeDest = new Set();
+if (composableN) { try { for (const r of extractComposeProject(srcFiles.map((f, i) => ({ path: f, text: srcTexts[i] })))) composeDest.add(r.route); } catch { /* 提取失败不计 */ } }
+const pagesApprox = manifestActs + navDest.size + composeDest.size + ((navDest.size || composeDest.size) ? 0 : Math.round(fragmentN / 2));
+const sizeClass = (totalLines <= 15000 && srcFiles.length <= 120 && pagesApprox <= 8 && deps.size <= 25) ? 'small' : 'standard';
+// 阶段形态一次定（写进 feasibility.json，各阶段只读 shape.*，不再现场判断"要不要跑"）：
+//   explore    inline=主会话亲读源码产卡 / workflow=按域并行探索
+//   foundation inline=地基片作 wave-0 并入切片流水 / wave=独立地基波再派生 manifest
+//   adversary  false=不置 risk / derived=按台账 degradations 派生 risk
+// 只是默认值：模型结合调用深度可改判，改判连理由写回 feasibility.json（实测 20 个几百行应用里 9 个跑了空地基波）。
+const shape = sizeClass === 'small'
+  ? { explore: 'inline', foundation: 'inline', adversary: false }
+  : { explore: 'workflow', foundation: 'wave', adversary: 'derived' };
+const profile = {
+  activities: manifestActs,
+  uiParadigm: composableN > 20 ? (layoutXml > 10 ? 'mixed' : 'compose') : 'xml',
+  navSources: [manifestActs > 1 ? 'manifest' : null, navGraphXml ? 'navgraph' : null, navHostN ? 'compose-navhost' : null].filter(Boolean),
+  fragments: fragmentN, archHints: [presenterN > 20 ? 'mvp' : null, viewModelN > 5 ? 'mvvm' : null].filter(Boolean),
+  sizeClass, sizeSignals: { lines: totalLines, files: srcFiles.length, pagesApprox, deps: deps.size }, shape,
+};
+
+const report = {
+  src: relative(process.cwd(), resolve(SRC)) || '.', verdict, profile,
+  scale: { srcFiles: srcFiles.length, lines: totalLines, uiTech, layoutXml, sampleTruncated: srcSampleTruncated ? `能力标记源码采样 ${SAMPLE_CAP}/${srcFiles.length} 文件（超限部分未扫，结论可能偏绿）` : null },
+  deps: [...deps].sort(),
+  libFindings, capFindings,
+  crossPlatform,
+  summary: {
+    red: [...xpStrong.map(c => `跨端框架 ${c.framework}——改道：${c.disposition}`), ...redLibs.map(l => `库墙 ${l.dep}（调用面 ${l.callFace}）：${l.note}`), ...redCaps.map(c => `平台墙 ${c.cap} → 处置：${c.disposition}`)],
+    yellow: [...xpWeak.map(c => `疑似跨端痕迹 ${c.framework}（仅文件名弱证据）——人工回源码确认，坐实再改道`), ...yellowItems.map(i => i.dep ? `${i.dep}（${i.status}）→ ${i.harmony || i.note}` : `${i.cap} → ${i.disposition}`)],
+    unadjudicated: libFindings.filter(l => l.status === 'unadjudicated').map(l => `${l.dep}（调用面 ${l.callFace}${l.ohpmHints ? '，ohpm 线索: ' + l.ohpmHints.join('/') : ''}）`),
+  },
+};
+if (OUT) writeFileSync(OUT, JSON.stringify(report, null, 2));
+const C = { red: '🔴', yellow: '🟡', green: '🟢' }[verdict];
+console.log(`[feasibility] ${resolve(SRC)}`);
+console.log(`  ${C} ${verdict.toUpperCase()} · 源 ${srcFiles.length} 文件/${totalLines} 行 · UI=${uiTech}(layout xml ${layoutXml}) · 依赖 ${deps.size}`);
+if (srcSampleTruncated) console.log(`  ⚠ ${report.scale.sampleTruncated}`);
+for (const s of report.summary.red) console.log(`  🔴 ${s}`);
+for (const s of report.summary.yellow.slice(0, 12)) console.log(`  🟡 ${s}`);
+if (report.summary.unadjudicated.length) console.log(`  ？待裁决依赖 ${report.summary.unadjudicated.length} 个（流程裁决步定夺后回写缓存）：${report.summary.unadjudicated.slice(0, 5).join('; ')}${report.summary.unadjudicated.length > 5 ? '…' : ''}`);
+process.exit(GATE ? ({ red: 5, yellow: 4, green: 0 })[verdict] : 0);

package/skills/migrate-core/scripts/feasibility/tables/cross-platform.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.1.0",
+  "_doc": "跨端框架检测表（数据即语料）。命中即整单分诊为 red-reroute：这类应用的安卓层只是壳，按原生流程重写是错路——正确处置是改走对应框架的鸿蒙方案。marker 匹配依赖坐标/文件路径/清单内容。",
+  "entries": [
+    { "framework": "Flutter", "marker": "io\\.flutter|libflutter\\.so|flutter_assets", "disposition": "改走 Flutter-ohos（官方鸿蒙支持）或 ArkUI-X 评估；原生重写=重做整个 Dart 层，错路" },
+    { "framework": "React Native", "marker": "com\\.facebook\\.react|index\\.android\\.bundle|libreactnative", "disposition": "改走 react-native-harmony（RNOH）；JS 业务层可大部复用" },
+    { "framework": "Taro/小程序壳", "marker": "com\\.tarojs|taro-runtime", "disposition": "Taro 鸿蒙端编译目标评估" },
+    { "framework": "uni-app", "marker": "io\\.dcloud|uni-app", "disposition": "uni-app x 鸿蒙目标评估" },
+    { "framework": "Cordova/WebView 壳", "marker": "org\\.apache\\.cordova|cordova\\.js", "disposition": "鸿蒙 ArkWeb 壳 + 原 H5 资源复用，仅重写桥接层" }
+  ]
+}

package/skills/migrate-core/scripts/feasibility/tables/deprecated-api.json

@@ -0,0 +1,10 @@
+{
+  "version": "0.1.0",
+  "_doc": "废弃/过时 API → 替代写法对照表（数据即语料；官方 hmos-arkts-deprecated-interface-checker 的蒸馏落点）。当前只建表未接检查器——接入闭合检查时须配基准靶再启用。match 匹配 .ets 源码文本；[待查证] 条目首用按本工程 SDK 核实。种子 4 条蒸馏自内部构建错误材料。",
+  "entries": [
+    { "match": "@ohos\\.router|(?<![\\w.])router\\.(pushUrl|replaceUrl|back)\\(", "deprecated": "@ohos.router 页面路由", "replacement": "Navigation + NavPathStack（壳层路由）", "note": "官方将 @ohos.router 标为“不推荐”（未正式 deprecated），推荐 Navigation 作为路由框架；新工程路由一律 Navigation 体系" },
+    { "match": "getContext\\(this\\)|getContext\\(\\)", "deprecated": "getContext(this) 取上下文", "replacement": "this.getUIContext().getHostContext()", "note": "组件内取 UIAbilityContext 走 UIContext 实例链" },
+    { "match": "AlertDialog\\.show\\(|(?<![\\w.])promptAction\\.(showToast|showDialog|openCustomDialog)\\(", "deprecated": "AlertDialog.show / promptAction 全局形", "replacement": "UIContext 实例形（this.getUIContext().showAlertDialog(...) / this.getUIContext().getPromptAction().showToast|showDialog|openCustomDialog(...)）", "note": "AlertDialog.show 与 promptAction 全局形自 API 18 废弃（官方 API 参考已核实）；改 UIContext 实例调用" },
+    { "match": "from ['\"]@ohos\\.", "deprecated": "@ohos.* 裸模块导入", "replacement": "@kit.* 聚合导入（如 @kit.ArkUI / @kit.AbilityKit / @kit.CoreFileKit）", "note": "Kit 聚合是官方推荐导入形态；逐模块对照 Kit 归属" }
+  ]
+}