deveco_hmigbot 0.1.0

package/skills/migrate-core/scripts/wire/extractors.mjs

@@ -0,0 +1,258 @@
+#!/usr/bin/env node
+/**
+ * extractors.mjs — 路由真源提取器（三轨之二：navGraph / Compose；manifest 轨在 wire-routes 主体）。
+ *
+ * 安卓导航真源按应用形态分三轨（形态画像由 feasibility 产出）：
+ *   ① 多 Activity：AndroidManifest（wire-routes 原生）
+ *   ② Jetpack Navigation：res/navigation/*.xml 配置（本文件 extractNavGraph——配置化最可靠）
+ *   ③ 单 Activity + Compose：NavHost { composable("route") } 代码（本文件 extractCompose）
+ * Fragment 手动事务等散代码形态无静态真源 → 走台账 pages 账兜底（wire-routes --from-ledger）。
+ * 输出统一 {route, fqcn, launcher} 形状（与 manifest 轨一致），路由名规范化为标识符安全形式。
+ */
+
+/** 路由名规范化：路径参数剥离（details/{id}→Details）、分隔符驼峰、首字母大写、非法字符清除。 */
+export function normalizeRoute(raw) {
+  const base = String(raw).split('?')[0].split('/').filter(s => s && !/^\{.*\}$/.test(s)).join('_');
+  const cleaned = base.replace(/\{[^}]*\}/g, '').replace(/[^\w]+/g, '_').replace(/^_+|_+$/g, '');
+  return cleaned.split('_').filter(Boolean).map(s => s[0].toUpperCase() + s.slice(1)).join('') || 'Route';
+}
+
+/**
+ * ② Jetpack Navigation：解析 res/navigation/*.xml。
+ * <navigation app:startDestination="@id/homeFragment"> <fragment android:id="@+id/homeFragment" android:name="com.x.HomeFragment"/>
+ * dialog/activity 目的地同收。返回 [{route, fqcn, launcher}]。
+ */
+export function extractNavGraph(xml) {
+  const text = xml.replace(/<!--[\s\S]*?-->/g, '');
+  const start = (text.match(/startDestination\s*=\s*"@\+?id\/([^"]+)"/) || [])[1] || null;
+  const out = [];
+  for (const m of text.matchAll(/<(fragment|dialog|activity)\b([^>]*)>/g)) {
+    const attrs = m[2];
+    const id = (attrs.match(/android:id\s*=\s*"@\+?id\/([^"]+)"/) || [])[1];
+    const name = (attrs.match(/android:name\s*=\s*"([^"]+)"/) || [])[1] || '';
+    if (!id) continue;
+    out.push({ route: normalizeRoute(id), fqcn: name || `navgraph:${id}`, launcher: id === start });
+  }
+  return out;
+}
+
+/**
+ * ③ Compose Navigation：解析含 NavHost 的 Kotlin 文本。
+ * 认三种注册形态：composable("route/{id}") / composable<TypedRoute>() / dialog("route")；
+ * startDestination = "route" | TypedRoute 判 launcher。串内路由为真源；typed route 取类型名。
+ */
+export function extractCompose(kt) {
+  const text = kt.replace(/\/\/[^\n]*/g, '').replace(/\/\*[\s\S]*?\*\//g, '');
+  // startDestination（Navigation 2）| rememberNavBackStack(<首键>)（Navigation 3，无 startDestination）判 launcher
+  const start = (text.match(/startDestination\s*=\s*"([^"]+)"/) || text.match(/startDestination\s*=\s*([A-Z][\w.]*)/)
+    || text.match(/rememberNavBackStack\s*\(\s*([A-Za-z_][\w.]*)/) || [])[1] || null;
+  const out = []; const seen = new Set();
+  const push = (rawRoute, fqcn, rawForLauncher) => {
+    const route = normalizeRoute(rawRoute);
+    if (seen.has(route)) return; seen.add(route);
+    out.push({ route, fqcn, launcher: start !== null && rawForLauncher === start });
+  };
+  for (const m of text.matchAll(/\b(?:composable|dialog|bottomSheet)\s*\(\s*(?:route\s*=\s*)?"([^"]+)"/g)) {
+    push(m[1], `compose:"${m[1]}"`, m[1]);
+  }
+  for (const m of text.matchAll(/\b(?:composable|dialog|entry)\s*<\s*([A-Za-z_][\w.]*)\s*>/g)) {
+    push(m[1].replace(/(NavKey|Route)$/, "") || m[1], `compose:<${m[1]}>`, m[1]);
+  }
+  return out;
+}
+
+/**
+ * ③b Compose 工程级提取（常量引用式实证形态）：composable(Destinations.RECIPE_LIST) 散布在
+ * 各页面文件、常量定义在别处——两遍扫：先收全工程 `const val NAME = "串"` 表（Container.NAME
+ * 与 NAME 双键），再解 composable(引用/字面量) 与 startDestination。files: [{path, text}]。
+ */
+export function extractComposeProject(files, opts = {}) {
+  const strip = (t) => t.replace(/\/\/[^\n]*/g, '').replace(/\/\*[\s\S]*?\*\//g, '');
+  const consts = new Map();
+  for (const { text } of files) {
+    const t = strip(text);
+    for (const m of t.matchAll(/\bconst\s+val\s+(\w+)\s*=\s*"([^"]+)"/g)) consts.set(m[1], m[2]);
+  }
+  const deref = (ref) => consts.get(ref.split('.').pop()) ?? null;
+  let start = null;
+  const cands = []; const seen = new Set();
+  const push = (raw, fqcn, launchKey) => {
+    const route = normalizeRoute(raw);
+    if (seen.has(route)) return; seen.add(route);
+    cands.push({ route, fqcn, launchKey });
+  };
+  // startDestination 归属：多模块工程里各特性各有 NavHost，"第一个遇到的 startDestination"是任意的；
+  // 顶层宿主文件（opts.hostFiles，由 launcher activity 两跳定位）先扫，它的起点才是应用首页。
+  const hostSet = new Set(opts.hostFiles || []);
+  const ordered = hostSet.size ? [...files.filter(f => hostSet.has(f.path)), ...files.filter(f => !hostSet.has(f.path))] : files;
+  const stripped = ordered.map(f => strip(f.text));
+  // Navigation 3 经包装函数起栈：rememberNavBackStack(param) 且 param 是所在函数形参 → 到调用点取实参（命名或按位）。
+  // 这是 Kotlin 形参转发的通用解析，不是某个工程的特判；解不到就交给下一条规则。
+  const forwarded = (t, ident, idx) => {
+    const before = t.slice(0, idx);
+    const fi = before.lastIndexOf('fun ');
+    if (fi < 0) return null;
+    const open = before.indexOf('(', fi); if (open < 0) return null;
+    const fname = before.slice(fi + 4, open).trim().split(/\s+/).pop();
+    const params = balancedArgs(t, open).map(p => p.split(':')[0].trim());
+    const pi = params.indexOf(ident); if (pi < 0) return null;
+    const callRe = new RegExp(`\\b${fname}\\s*\\(`, 'g');
+    for (const t2 of stripped) {
+      let c;
+      while ((c = callRe.exec(t2)) !== null) {
+        if (t2.slice(Math.max(0, c.index - 4), c.index).includes('fun ')) continue; // 跳过定义本身
+        const args = balancedArgs(t2, c.index + c[0].length - 1);
+        const named = args.find(a => new RegExp(`^${ident}\\s*=`).test(a));
+        const val = (named ? named.split('=').slice(1).join('=') : args[pi] || '').trim();
+        if (/^[A-Za-z_][\w.]*$/.test(val)) return val;
+        const lit = val.match(/^"([^"]+)"$/); if (lit) return lit[1];
+      }
+    }
+    return null;
+  };
+  for (const t of stripped) {
+    const s = t.match(/startDestination\s*=\s*"([^"]+)"/) || t.match(/startDestination\s*=\s*([A-Za-z_][\w.]*)/);
+    if (s && start === null) start = s[1].includes('"') ? s[1] : (deref(s[1]) ?? s[1]);
+    // Navigation 3：无 startDestination，首页 = rememberNavBackStack(<首个 NavKey>) 的初始键（typed 形态，与 entry<Key> 同键匹配）
+    const n3 = t.match(/rememberNavBackStack\s*\(\s*([A-Za-z_][\w.]*)/);
+    if (n3 && start === null) start = forwarded(t, n3[1], n3.index) ?? n3[1];
+    for (const m of t.matchAll(/\b(?:composable|dialog|bottomSheet)\s*\(\s*(?:route\s*=\s*)?"([^"]+)"/g)) push(m[1], `compose:"${m[1]}"`, m[1]);
+    for (const m of t.matchAll(/\b(?:composable|dialog|bottomSheet)\s*\(\s*(?:route\s*=\s*)?([A-Za-z_][\w.]*)\s*[,)]/g)) {
+      const lit = deref(m[1]);
+      if (lit !== null) push(lit, `compose:${m[1]}="${lit}"`, lit);
+    }
+    for (const m of t.matchAll(/\b(?:composable|dialog|entry)\s*<\s*([A-Za-z_][\w.]*)\s*>/g)) push(m[1].replace(/(NavKey|Route)$/, "") || m[1], `compose:<${m[1]}>`, m[1]);
+  }
+  return cands.map(c => ({ route: c.route, fqcn: c.fqcn, launcher: start !== null && c.launchKey === start }));
+}
+
+/** 括号平衡的实参/形参切分：text[openIdx]==='('，按顶层逗号切，遇匹配的 ')' 结束（泛型尖括号一并计深） */
+function balancedArgs(text, openIdx) {
+  const out = []; let depth = 0, cur = '';
+  for (let i = openIdx; i < text.length; i++) {
+    const ch = text[i];
+    if ('({[<'.includes(ch)) { depth++; if (depth === 1) continue; }
+    else if (')}]>'.includes(ch)) { depth--; if (depth === 0) { if (cur.trim()) out.push(cur.trim()); return out; } }
+    else if (ch === ',' && depth === 1) { out.push(cur.trim()); cur = ''; continue; }
+    cur += ch;
+  }
+  return out;
+}
+
+/**
+ * 顶层 NavHost 宿主定位：从 launcher activity 文件出发，沿"调用的 @Composable → 定义它的文件"最多走 maxHops 跳，
+ * 含 NavHost( / NavDisplay( 的文件即宿主（setContent { App() } → App.kt 里的 NavHost 是常见形态）。
+ * 找不到宿主 = launcher activity 不是 Compose 壳（经典多屏 Activity 内嵌特性级 NavHost），首页应保留为该 activity。
+ * files: [{path, text}]；返回宿主文件路径数组。
+ */
+export function findComposeHostFiles(files, activityPath, maxHops = 2) {
+  const HOST = /\bNavHost\s*\(|\bNavDisplay\s*\(/;
+  const strip = (t) => t.replace(/\/\/[^\n]*/g, '').replace(/\/\*[\s\S]*?\*\//g, '');
+  const byPath = new Map(files.map(f => [f.path, strip(f.text)]));
+  const startText = byPath.get(activityPath);
+  if (startText === undefined) return [];
+  const hosts = new Set(); const visited = new Set([activityPath]);
+  if (HOST.test(startText)) hosts.add(activityPath);
+  let frontier = [activityPath];
+  for (let hop = 0; hop < maxHops && frontier.length; hop++) {
+    const next = [];
+    for (const p of frontier) {
+      const callees = [...new Set([...byPath.get(p).matchAll(/\b([A-Z][A-Za-z0-9_]*)\s*\(/g)].map(m => m[1]))];
+      if (!callees.length) continue;
+      const defRe = new RegExp(`\\bfun\\s+(?:${callees.join('|')})\\s*\\(`);
+      for (const [q, t] of byPath) {
+        if (visited.has(q) || !defRe.test(t)) continue;
+        visited.add(q); next.push(q);
+        if (HOST.test(t)) hosts.add(q);
+      }
+    }
+    frontier = next;
+  }
+  return [...hosts];
+}
+
+/**
+ * 应用级初始化真源。安卓 Application.onCreate 在任何页面之前必跑（数据库/偏好/通知渠道/DI…），
+ * 鸿蒙由 EntryAbility.onCreate 承担；规划按页面与后端域切片时这段横切初始化没有归属，漏接只在下游以别的错误露头
+ * （实证两应用崩溃）。这里只做确定性定位，不判怎么迁、不拆项：
+ *   manifest <application android:name> → 类文件（按包声明精确匹配，工程内沿父类链最多 4 跳）→ 每级 onCreate 的文件与行范围；
+ *   另抽 ContentProvider 与 androidx.startup 初始化器（都是"启动即跑"的入口）；DI 框架只做标注。
+ *   调用名清单（callHints）只是提示，不进台账：正则抽调用在不同语言习惯下有噪声，逐项拆解由 2b 读锚定的源码段完成。
+ * 入参：xml=manifest 文本（已去注释），files=[{path,text}] 工程内 .kt/.java。返回 null=无自定义 Application 且无 provider/startup。
+ */
+export function extractAppInit(xml, files, opts = {}) {
+  // 多模块工程：Application 类常声明在 app 模块 manifest，而承载 LAUNCHER 的可能是别的模块（实证两工程）——
+  // 主 manifest 没有就按 extras（其余候选 manifest）顺序找；provider/startup 各 manifest 取并集（按名去重）。
+  const manifests = [{ path: opts.manifest || 'AndroidManifest.xml', text: xml }, ...((opts.extras || []).filter(e => e && e.text))];
+  const nameOf = (attrs) => (attrs.match(/android:name\s*=\s*["']([^"']+)["']/) || [])[1];
+  const attrsOf = (text, tag) => [...text.matchAll(new RegExp(`<${tag}\\b((?:"[^"]*"|'[^']*'|[^>"'])*)(/?)>`, 'g'))];
+  // 多产品仓（一个仓多个 app 模块各有 Application）：全部候选如实列出，取首个（承载 launcher 的模块优先），ambiguous 标记交流程确认产品
+  let nameAttr = null, pkg = '', appManifest = null;
+  const applicationCandidates = [];
+  for (const mf of manifests) {
+    const app = attrsOf(mf.text, 'application')[0];
+    const nm = app ? nameOf(app[1]) : null;
+    if (!nm) continue;
+    const p = (mf.text.match(/\bpackage\s*=\s*["']([^"']+)["']/) || [])[1] || '';
+    const cls = nm.startsWith('.') ? p + nm : nm;
+    if (!applicationCandidates.some(c => c.applicationClass === cls)) applicationCandidates.push({ applicationClass: cls, manifest: mf.path });
+    // 首个为默认；opts.preferClass（wire-routes --app-class，多产品仓按所选产品显式指定）命中则以它为主
+    if (!nameAttr || (opts.preferClass && (cls === opts.preferClass || cls.endsWith('.' + opts.preferClass)))) { nameAttr = nm; pkg = p; appManifest = mf.path; }
+  }
+  const providers = [], startupInitializers = [];
+  for (const mf of manifests) {
+    const lineAt = (idx) => mf.text.slice(0, idx).split('\n').length;
+    for (const m of attrsOf(mf.text, 'provider')) { const nm = nameOf(m[1]); if (nm && !providers.some(p => p.name === nm)) providers.push({ name: nm, line: lineAt(m.index), manifest: mf.path }); }
+    for (const m of attrsOf(mf.text, 'meta-data')) {
+      if (!/android:value\s*=\s*["']androidx\.startup["']/.test(m[1])) continue;
+      const nm = nameOf(m[1]); if (nm && !startupInitializers.some(p => p.name === nm)) startupInitializers.push({ name: nm, line: lineAt(m.index), manifest: mf.path });
+    }
+  }
+  if (!nameAttr && !providers.length && !startupInitializers.length) return null;
+  const fqcn = nameAttr ? (nameAttr.startsWith('.') ? pkg + nameAttr : nameAttr) : null;
+  const src = files.filter(f => /\.(kt|java)$/.test(f.path));
+  // 类文件定位：同名类可能散在多个模块/目录（实证多模块工程），先按包声明精确匹配，再退到仅按类名；都要求文件里真有 class 声明。
+  const findClass = (nm, pkgHint) => {
+    const decl = new RegExp(`\\bclass\\s+${nm}\\b`);
+    const hits = src.filter(f => decl.test(f.text));
+    if (pkgHint) { const byPkg = hits.find(f => new RegExp(`^\\s*package\\s+${pkgHint.replace(/\./g, '\\.')}\\s*;?\\s*$`, 'm').test(f.text)); if (byPkg) return byPkg; }
+    return hits[0] || null;
+  };
+  // 只定位，不解释：onCreate 的文件与行范围（子类与每级父类各一段）是确定性事实；每一项怎么迁由 2b 读这段源码逐项判断。
+  // 调用名清单仅作提示（callHints），不进台账——正则抽调用在不同语言习惯下有噪声，噪声不能变成断言。
+  const onCreateSites = [], callHints = [], superChain = [];
+  const simple = fqcn ? fqcn.split('.').pop() : null;
+  let cur = fqcn ? findClass(simple, fqcn.slice(0, -(simple.length + 1))) : null, curName = simple, hops = 0;
+  const file = cur ? cur.path : null;
+  let di = null;
+  while (cur && hops < 4) {
+    superChain.push(curName);
+    if (!di) { const code = cur.text.replace(/\/\/.*$/gm, '').replace(/\/\*[\s\S]*?\*\//g, ''); di = /@HiltAndroidApp/.test(code) ? 'Hilt' : /\bstartKoin\b/.test(code) ? 'Koin' : /Dagger\w*Component/.test(code) ? 'Dagger' : null; }
+    const oc = cur.text.search(/\b(?:fun|void)\s+onCreate\s*\(\s*\)/);
+    if (oc >= 0) {
+      const open = cur.text.indexOf('{', oc);
+      let d = 0, end = -1;
+      for (let j = open; j >= 0 && j < cur.text.length; j++) { if (cur.text[j] === '{') d++; else if (cur.text[j] === '}') { d--; if (!d) { end = j; break; } } }
+      if (open >= 0 && end > open) {
+        const startLine = cur.text.slice(0, oc).split('\n').length, endLine = cur.text.slice(0, end).split('\n').length;
+        const body = cur.text.slice(open + 1, end).replace(/\/\/.*$/gm, '').replace(/\/\*[\s\S]*?\*\//g, '');
+        const meaningful = body.split('\n').filter(l => l.trim() && !/^\s*super\.onCreate\s*\(/.test(l)).length;
+        onCreateSites.push({ cls: curName, file: cur.path, startLine, endLine, bodyLines: meaningful });
+        for (const m of body.matchAll(/(?<![.\w$])([A-Za-z_][\w]*(?:\.[A-Za-z_][\w]*)*)\s*[({]/g)) {
+          const callee = m[1];
+          if (/^(if|for|while|when|switch|return|catch|try|finally|else|do|init|object|companion|class|fun|synchronized|super|this)$/.test(callee) || /^super\./.test(callee)) continue;
+          if (!callHints.includes(callee)) callHints.push(callee);
+        }
+      }
+    }
+    const sup = (cur.text.match(new RegExp(`\\bclass\\s+${curName}\\b[^{]*?(?::|\\bextends)\\s*([A-Za-z_][\\w.]*)`)) || [])[1];
+    if (!sup) break;
+    const supSimple = sup.split('.').pop();
+    if (/^(Application|MultiDexApplication|DaggerApplication|Hilt_\w+|Any|Object)$/.test(supSimple)) break;
+    const next = findClass(supSimple, sup.includes('.') ? sup.slice(0, -(supSimple.length + 1)) : null);
+    if (!next) { superChain.push(supSimple + '?'); break; }
+    cur = next; curName = supSimple; hops++;
+  }
+  const workManagerProvider = src.some(f => superChain.some(c => new RegExp(`\\bclass\\s+${c.replace(/\?$/, '')}\\b`).test(f.text)) && /Configuration\.Provider/.test(f.text));
+  return { applicationClass: fqcn, appManifest, applicationCandidates, ambiguous: applicationCandidates.length > 1, file, classFound: !!file, superChain, onCreateSites, callHints, providers, startupInitializers, workManagerProvider, di };
+}