@deveco-test/deveco-code 1.0.3 → 1.0.4

package/resources/deveco/skills/hmos-runtime-fix-skill/scripts/collect-hilog.mjs

@@ -0,0 +1,120 @@
+/*
+ * Copyright (c) 2026 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import fs from 'node:fs';
+import fsp from 'node:fs/promises';
+import path from 'node:path';
+import process from 'node:process';
+import { runDevecoCli } from './shared/deveco-cli.mjs';
+import { printKv, toErrorMessage } from './shared/utils.mjs';
+
+function cleanLines(input) {
+  return input
+    .split(/\r?\n/)
+    .map((line) => line.trimEnd())
+    .filter((line) => line.trim().length > 0);
+}
+
+function parseArgs(argv) {
+  const map = new Map();
+  const optionalKeys = new Set(['device-id']);
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const t = argv[i];
+    if (!t.startsWith('--')) {
+      continue;
+    }
+    const key = t.slice(2);
+    const val = argv[i + 1];
+    if (!val || val.startsWith('--')) {
+      if (optionalKeys.has(key)) {
+        map.set(key, '');
+        continue;
+      }
+
+      throw new Error(`Missing value for --${key}`);
+    }
+    map.set(key, val);
+    i += 1;
+  }
+
+  const outputDir = map.get('output-dir');
+  if (!outputDir) {
+    throw new Error('Required: --output-dir');
+  }
+
+  return {
+    outputDir,
+    deviceId: map.get('device-id') ?? '',
+    lines: Number(map.get('lines') ?? '4000'),
+  };
+}
+
+function printCollectFailed(nextAction) {
+  printKv({
+    status: 'collect_failed',
+    source: 'device_hilog',
+    log_file: '',
+    log_excerpt: '',
+    next_action: nextAction,
+  });
+}
+
+async function collectHilogText(deviceId, lines) {
+  const out = await runDevecoCli([
+    'log',
+    ...(deviceId ? ['--device', deviceId] : []),
+    '--tail',
+    String(lines),
+  ]);
+  if (out.exitCode !== 0) {
+    throw new Error(out.stderr || out.stdout || `devecocli log failed (code=${out.exitCode})`);
+  }
+
+  const all = cleanLines(out.stdout);
+  return all.slice(Math.max(0, all.length - lines)).join('\n');
+}
+
+async function writeHilogSnapshot(outputDir, recent) {
+  fs.mkdirSync(outputDir, { recursive: true });
+  const logFile = path.join(outputDir, `hilog-${Date.now()}.txt`);
+  await fsp.writeFile(logFile, recent, 'utf8');
+  return logFile;
+}
+
+function printCollected(logFile, recent) {
+  printKv({
+    status: 'collected',
+    source: 'device_hilog',
+    log_file: logFile,
+    log_excerpt: recent.slice(0, 800),
+    next_action: `A hilog snapshot is available. Parse it with parse-jscrash-log.mjs --log-file "${logFile}" --source hilog if you want more crash detail.`,
+  });
+}
+
+async function main() {
+  try {
+    const { outputDir, deviceId, lines } = parseArgs(process.argv.slice(2));
+    const recent = await collectHilogText(deviceId, lines);
+    const logFile = await writeHilogSnapshot(outputDir, recent);
+    printCollected(logFile, recent);
+    process.exit(0);
+  } catch (err) {
+    printCollectFailed(toErrorMessage(err));
+    process.exit(1);
+  }
+}
+
+await main();

package/resources/deveco/skills/hmos-runtime-fix-skill/scripts/jscrash-report.mjs

@@ -0,0 +1,138 @@
+/*
+ * Copyright (c) 2026 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import fs from 'node:fs/promises';
+import process from 'node:process';
+import {
+  buildCrashReport,
+  buildNextActionText,
+  formatCrashReportText,
+} from './shared/jscrash-parse.mjs';
+import { runDevecoCli } from './shared/deveco-cli.mjs';
+import { printKv, toErrorMessage } from './shared/utils.mjs';
+
+function parseArgs(argv) {
+  const map = new Map();
+  const flags = new Set();
+  const optionalKeys = new Set(['log-text', 'log-file', 'bundle-name', 'process-hint', 'device-id']);
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const token = argv[i];
+    if (token === '--include-text') {
+      flags.add('include-text');
+      continue;
+    }
+    if (!token.startsWith('--')) {
+      continue;
+    }
+    const key = token.slice(2);
+    const value = argv[i + 1];
+    if (!value || value.startsWith('--')) {
+      if (optionalKeys.has(key)) {
+        map.set(key, '');
+        continue;
+      }
+      throw new Error(`Missing value for --${key}`);
+    }
+    map.set(key, value);
+    i += 1;
+  }
+
+  const logText = map.get('log-text');
+  const logFile = map.get('log-file');
+  if (logText && logFile) {
+    throw new Error('Provide at most one of --log-text or --log-file');
+  }
+
+  return {
+    logText,
+    logFile,
+    bundleName: map.get('bundle-name') ?? '',
+    processHint: map.get('process-hint') ?? '',
+    deviceId: map.get('device-id') ?? '',
+    includeText: flags.has('include-text'),
+  };
+}
+
+async function collectCrashText(deviceId, bundleName) {
+  const out = await runDevecoCli([
+    'log',
+    '--crash',
+    ...(deviceId ? ['--device', deviceId] : []),
+    ...(bundleName ? ['--bundle-name', bundleName] : []),
+  ]);
+  if (out.exitCode !== 0) {
+    throw new Error(out.stderr || out.stdout || `devecocli log --crash failed (code=${out.exitCode})`);
+  }
+  return out.stdout;
+}
+
+async function loadInput(args) {
+  if (args.logText) {
+    return { text: args.logText, source: 'text' };
+  }
+  if (args.logFile) {
+    return { text: await fs.readFile(args.logFile, 'utf8'), source: 'file' };
+  }
+  return { text: await collectCrashText(args.deviceId, args.bundleName), source: 'device_crash' };
+}
+
+function printReport(report, source, includeText) {
+  printKv({
+    status: report.status === 'detected' ? 'detected' : 'no_crash_signature',
+    source,
+    error_type: report.errorType,
+    error_message: report.errorMessage,
+    suspected_file: report.suspectedFile,
+    top_stack: report.topStack.join('|'),
+    keywords: report.keywords.join(','),
+    next_action: buildNextActionText(report),
+  });
+
+  if (includeText) {
+    console.log('');
+    console.log(formatCrashReportText(report));
+  }
+}
+
+async function main() {
+  try {
+    const args = parseArgs(process.argv.slice(2));
+    const input = await loadInput(args);
+    const report = buildCrashReport(
+      input.text,
+      input.source,
+      args.deviceId || 'default',
+      args.bundleName,
+      args.processHint,
+    );
+    printReport(report, input.source, args.includeText);
+    process.exit(0);
+  } catch (err) {
+    printKv({
+      status: 'parse_failed',
+      source: 'text',
+      error_type: '',
+      error_message: '',
+      suspected_file: '',
+      top_stack: '',
+      keywords: '',
+      next_action: toErrorMessage(err),
+    });
+    process.exit(1);
+  }
+}
+
+await main();

package/resources/deveco/skills/hmos-runtime-fix-skill/scripts/parse-jscrash-log.mjs

@@ -0,0 +1,126 @@
+/*
+ * Copyright (c) 2026 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import process from 'node:process';
+import fs from 'node:fs/promises';
+import {
+  buildCrashReport,
+  buildNextActionText,
+  formatCrashReportText,
+} from './shared/jscrash-parse.mjs';
+import { printKv, toErrorMessage } from './shared/utils.mjs';
+
+function parseArgs(argv) {
+  const map = new Map();
+  const flags = new Set();
+  const optionalKeys = new Set(['bundle-name', 'process-hint', 'device', 'source']);
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const t = argv[i];
+    if (t === '--include-text') {
+      flags.add('include-text');
+      continue;
+    }
+    if (!t.startsWith('--')) {
+      continue;
+    }
+    const key = t.slice(2);
+    const val = argv[i + 1];
+    if (!val || val.startsWith('--')) {
+      if (optionalKeys.has(key)) {
+        map.set(key, '');
+        continue;
+      }
+
+      throw new Error(`Missing value for --${key}`);
+    }
+    map.set(key, val);
+    i += 1;
+  }
+
+  const logFile = map.get('log-file');
+  const logText = map.get('log-text');
+  if ((logFile && logText) || (!logFile && !logText)) {
+    throw new Error('Provide exactly one of --log-file or --log-text');
+  }
+
+  return {
+    logFile,
+    logText,
+    bundleName: map.get('bundle-name') ?? '',
+    processHint: map.get('process-hint') ?? '',
+    source: map.get('source') ?? (logFile ? 'file' : 'text'),
+    device: map.get('device') ?? 'default',
+    includeText: flags.has('include-text'),
+  };
+}
+
+async function readLogText(logFile) {
+  try {
+    return await fs.readFile(logFile, 'utf8');
+  } catch {
+    throw new Error(`log file not found: ${logFile}`);
+  }
+}
+
+async function main() {
+  try {
+    const args = parseArgs(process.argv.slice(2));
+    let raw = '';
+    if (args.logFile) {
+      raw = await readLogText(args.logFile);
+    } else if (args.logText) {
+      raw = args.logText;
+    }
+
+    const report = buildCrashReport(raw, args.source, args.device, args.bundleName, args.processHint);
+    const nextAction = buildNextActionText(report);
+
+    const topStackJoined = report.topStack.join('|');
+    const keywordsJoined = report.keywords.join(',');
+
+    printKv({
+      status: report.status === 'detected' ? 'detected' : 'no_crash_signature',
+      source: args.source,
+      error_type: report.errorType,
+      error_message: report.errorMessage,
+      suspected_file: report.suspectedFile,
+      top_stack: topStackJoined,
+      keywords: keywordsJoined,
+      next_action: nextAction,
+    });
+
+    if (args.includeText) {
+      console.log('');
+      console.log(formatCrashReportText(report));
+    }
+
+    process.exit(0);
+  } catch (err) {
+    printKv({
+      status: 'parse_failed',
+      source: 'text',
+      error_type: '',
+      error_message: '',
+      suspected_file: '',
+      top_stack: '',
+      keywords: '',
+      next_action: toErrorMessage(err),
+    });
+    process.exit(1);
+  }
+}
+
+await main();

package/resources/deveco/skills/hmos-runtime-fix-skill/scripts/shared/deveco-cli.mjs

@@ -0,0 +1,79 @@
+/*
+ * Copyright (c) 2026 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { spawn } from 'node:child_process';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import process from 'node:process';
+
+export async function runDevecoCli(args) {
+  const invocation = await resolveDevecoCli();
+  return new Promise((resolve, reject) => {
+    const child = spawn(invocation.command, [...invocation.args, ...args], {
+      windowsHide: true,
+      stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    let stdout = '';
+    let stderr = '';
+    child.stdout.setEncoding('utf8');
+    child.stderr.setEncoding('utf8');
+    child.stdout.on('data', (chunk) => {
+      stdout += chunk;
+    });
+    child.stderr.on('data', (chunk) => {
+      stderr += chunk;
+    });
+    child.on('error', reject);
+    child.on('close', (exitCode) => resolve({ stdout, stderr, exitCode: exitCode ?? 1 }));
+  });
+}
+
+async function resolveDevecoCli() {
+  if (process.platform !== 'win32') {
+    return { command: 'devecocli', args: [] };
+  }
+
+  const directories = String(process.env.PATH || process.env.Path || '')
+    .split(path.delimiter)
+    .map((directory) => directory.trim().replace(/^"|"$/g, ''))
+    .filter((directory) => directory.length > 0);
+
+  for (const directory of directories) {
+    const executable = path.join(directory, 'devecocli.exe');
+    if (await exists(executable)) {
+      return { command: executable, args: [] };
+    }
+
+    const shim = path.join(directory, 'devecocli.cmd');
+    const pointer = path.join(directory, '.deveco-cli-path');
+    if (!(await exists(shim)) || !(await exists(pointer))) {
+      continue;
+    }
+
+    const entry = (await fs.readFile(pointer, 'utf8')).trim();
+    if (entry && (await exists(entry))) {
+      return { command: process.execPath, args: [entry] };
+    }
+  }
+
+  throw new Error('devecocli executable was not found in PATH');
+}
+
+function exists(file) {
+  return fs.access(file).then(
+    () => true,
+    () => false,
+  );
+}