deveco-harness 0.1.0 → 0.1.1-test.0

package/dist/arkts-check.cjs

@@ -0,0 +1,401 @@
+#!/usr/bin/env node
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+
+// --- Argument parsing ---
+
+function parseArgs(argv) {
+  const args = { project: '', files: [] };
+  let i = 2;
+  while (i < argv.length) {
+    if (argv[i] === '--project' && argv[i + 1]) {
+      args.project = path.resolve(argv[++i]);
+    } else if (argv[i] === '--files') {
+      i++;
+      while (i < argv.length && !argv[i].startsWith('--')) {
+        args.files.push(argv[i++]);
+      }
+      continue;
+    } else if (!argv[i].startsWith('--')) {
+      args.files.push(argv[i]);
+    }
+    i++;
+  }
+  return args;
+}
+
+// --- DevEco SDK detection ---
+
+function findDevecoHome() {
+  const envHome = (process.env.DEVECO_HOME || '').trim();
+  if (envHome && fs.existsSync(envHome)) return envHome;
+
+  const candidates = [];
+  if (process.platform === 'win32') {
+    const userHome = (process.env.USERPROFILE || '').trim();
+    candidates.push(
+      'C:\\Program Files\\Huawei\\DevEco Studio',
+      'C:\\Program Files\\DevEco Studio',
+      'C:\\Program Files (x86)\\DevEco Studio',
+      userHome ? path.join(userHome, 'DevEco Studio') : '',
+    );
+  } else if (process.platform === 'darwin') {
+    candidates.push('/Applications/DevEco-Studio.app/Contents');
+  } else {
+    const home = (process.env.HOME || '').trim();
+    if (home) {
+      candidates.push(path.join(home, 'devecostudio/Contents'));
+      candidates.push(path.join(home, 'DevEco-Studio/Contents'));
+    }
+  }
+  for (const c of candidates.filter(Boolean)) {
+    if (fs.existsSync(c)) return c;
+  }
+  return null;
+}
+function findEtsLoader(devecoHome) {
+  const candidates = [
+    path.join(devecoHome, 'sdk', 'default', 'openharmony', 'ets', 'build-tools', 'ets-loader'),
+    path.join(devecoHome, 'sdk', 'openharmony', 'ets', 'build-tools', 'ets-loader'),
+  ];
+  for (const c of candidates) {
+    if (fs.existsSync(path.join(c, 'lib', 'ets_checker.js'))) return c;
+  }
+  return null;
+}
+
+// --- Collect .ets files from project ---
+
+function collectEtsFiles(projectPath) {
+  const results = [];
+  const srcDir = path.join(projectPath, 'entry', 'src', 'main', 'ets');
+  if (!fs.existsSync(srcDir)) return results;
+
+  function walk(dir) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (entry.name === 'node_modules' || entry.name === 'oh_modules' || entry.name === 'build') continue;
+        walk(full);
+      } else if (entry.name.endsWith('.ets') && !entry.name.endsWith('.d.ets')) {
+        results.push(full);
+      }
+    }
+  }
+  walk(srcDir);
+  return results;
+}
+
+// --- Diagnostic output capture ---
+
+function parseDiagnosticLine(line) {
+  const errorMatch = line.match(/ArkTS:(ERROR|WARN)\s+File:\s+(.+?):(\d+):(\d+)/);
+  if (errorMatch) {
+    return { severity: errorMatch[1].toLowerCase(), file: errorMatch[2], line: parseInt(errorMatch[3]), column: parseInt(errorMatch[4]) };
+  }
+  return null;
+}
+
+function parseMessageLine(line) {
+  const trimmed = line.trim();
+  const ruleMatch = trimmed.match(/^(.+?)\s*\(([a-z][\w-]+)\)\s*$/);
+  if (ruleMatch) {
+    return { message: ruleMatch[1].trim(), rule: ruleMatch[2] };
+  }
+  return { message: trimmed, rule: '' };
+}
+
+// --- Project-level validation (A-class checks) ---
+
+function loadSystemResourceNames(devecoHome) {
+  const candidates = [
+    path.join(devecoHome, 'sdk', 'default', 'openharmony', 'previewer', 'common', 'resources', 'entry', 'resources.txt'),
+    path.join(devecoHome, 'sdk', 'openharmony', 'previewer', 'common', 'resources', 'entry', 'resources.txt'),
+  ];
+  let resFile = '';
+  for (const c of candidates) {
+    if (fs.existsSync(c)) { resFile = c; break; }
+  }
+  if (!resFile) return null;
+
+  const names = new Set();
+  const content = fs.readFileSync(resFile, 'utf-8');
+  const linePattern = /^id:\d+,\s*'[^']*'\s+'([^']+)'/;
+  for (const line of content.split('\n')) {
+    const m = line.match(linePattern);
+    if (m) names.add(m[1]);
+  }
+  return names;
+}
+
+function validateSystemResources(files, devecoHome, projectPath) {
+  const validNames = loadSystemResourceNames(devecoHome);
+  if (!validNames) return [];
+
+  const diagnostics = [];
+  const refPattern = /\$r\(\s*['"]sys\.(media|symbol)\.([^'"]+)['"]\s*\)/g;
+
+  for (const filePath of files) {
+    if (!fs.existsSync(filePath)) continue;
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const fileLines = content.split('\n');
+    for (let i = 0; i < fileLines.length; i++) {
+      let match;
+      refPattern.lastIndex = 0;
+      while ((match = refPattern.exec(fileLines[i])) !== null) {
+        const resName = match[2];
+        if (!validNames.has(resName)) {
+          diagnostics.push({
+            file: path.relative(projectPath, filePath),
+            line: i + 1,
+            column: match.index + 1,
+            severity: 'error',
+            message: `Unknown resource name '${resName}'. No matching sys.${match[1]} resource found in SDK.`,
+            rule: 'resource-name-check',
+          });
+        }
+      }
+    }
+  }
+  return diagnostics;
+}
+
+function validateRouterPages(projectPath) {
+  const candidates = [
+    path.join(projectPath, 'entry', 'src', 'main', 'resources', 'base', 'profile', 'main_pages.json'),
+    path.join(projectPath, 'src', 'main', 'resources', 'base', 'profile', 'main_pages.json'),
+  ];
+  let mainPagesPath = '';
+  for (const c of candidates) {
+    if (fs.existsSync(c)) { mainPagesPath = c; break; }
+  }
+  if (!mainPagesPath) return [];
+
+  let config;
+  try {
+    config = JSON.parse(fs.readFileSync(mainPagesPath, 'utf-8'));
+  } catch { return []; }
+
+  const pages = config.src || [];
+  const diagnostics = [];
+  const etsBase = path.join(projectPath, 'entry', 'src', 'main', 'ets');
+
+  for (let i = 0; i < pages.length; i++) {
+    const pagePath = pages[i];
+    const etsFile = path.join(etsBase, pagePath + '.ets');
+    if (!fs.existsSync(etsFile)) {
+      diagnostics.push({
+        file: path.relative(projectPath, mainPagesPath),
+        line: i + 2,
+        column: 1,
+        severity: 'error',
+        message: `Page '${pagePath}.ets' does not exist. Registered in main_pages.json but file not found at entry/src/main/ets/${pagePath}.ets`,
+        rule: 'page-file-exists',
+      });
+    }
+  }
+  return diagnostics;
+}
+
+function validateModelVersion(projectPath) {
+  const hvigorPath = path.join(projectPath, 'hvigor', 'hvigor-config.json5');
+  const ohPkgPath = path.join(projectPath, 'oh-package.json5');
+  if (!fs.existsSync(hvigorPath) || !fs.existsSync(ohPkgPath)) return [];
+
+  const extractVersion = (file) => {
+    const content = fs.readFileSync(file, 'utf-8');
+    const m = content.match(/["']?modelVersion["']?\s*:\s*["']([^"']+)["']/);
+    return m ? m[1] : null;
+  };
+
+  const hvigorVer = extractVersion(hvigorPath);
+  const ohPkgVer = extractVersion(ohPkgPath);
+
+  if (hvigorVer && ohPkgVer && hvigorVer !== ohPkgVer) {
+    return [{
+      file: 'hvigor/hvigor-config.json5',
+      line: 1,
+      column: 1,
+      severity: 'error',
+      message: `modelVersion mismatch: hvigor-config.json5 has '${hvigorVer}' but oh-package.json5 has '${ohPkgVer}'. They must be consistent.`,
+      rule: 'model-version-consistency',
+    }];
+  }
+  return [];
+}
+
+// --- Main ---
+
+function main() {
+  const args = parseArgs(process.argv);
+
+  if (!args.project) {
+    process.stdout.write(JSON.stringify({ success: false, error: 'Missing --project argument', errors: [], summary: { errorCount: 0, warnCount: 0 } }));
+    process.exit(1);
+  }
+
+  if (!fs.existsSync(args.project)) {
+    process.stdout.write(JSON.stringify({ success: false, error: `Project path not found: ${args.project}`, errors: [], summary: { errorCount: 0, warnCount: 0 } }));
+    process.exit(1);
+  }
+
+  const devecoHome = findDevecoHome();
+  if (!devecoHome) {
+    process.stdout.write(JSON.stringify({ success: false, error: 'Cannot find DevEco Studio. Set DEVECO_HOME environment variable.', errors: [], summary: { errorCount: 0, warnCount: 0 } }));
+    process.exit(1);
+  }
+
+  const etsLoaderPath = findEtsLoader(devecoHome);
+  if (!etsLoaderPath) {
+    process.stdout.write(JSON.stringify({ success: false, error: `Cannot find ets-loader in DevEco SDK at: ${devecoHome}`, errors: [], summary: { errorCount: 0, warnCount: 0 } }));
+    process.exit(1);
+  }
+  let files = args.files.map(f => path.isAbsolute(f) ? f : path.resolve(args.project, f));
+  if (files.length === 0) {
+    files = collectEtsFiles(args.project);
+  }
+
+  if (files.length === 0) {
+    process.stdout.write(JSON.stringify({ success: true, errors: [], summary: { errorCount: 0, warnCount: 0 } }));
+    process.exit(0);
+  }
+
+  const fileMap = {};
+  files.forEach((f, i) => { fileMap[`file_${i}`] = f; });
+
+  const moduleJsonCandidates = [
+    path.join(args.project, 'entry', 'src', 'main', 'module.json5'),
+    path.join(args.project, 'src', 'main', 'module.json5'),
+    path.join(args.project, 'entry', 'module.json5'),
+  ];
+  let aceModuleJsonPath = '';
+  for (const candidate of moduleJsonCandidates) {
+    if (fs.existsSync(candidate)) {
+      aceModuleJsonPath = candidate;
+      break;
+    }
+  }
+
+  const captured = [];
+  const origLog = console.log;
+  const origError = console.error;
+  const origWarn = console.warn;
+  const capture = (...args) => { captured.push(args.map(String).join(' ')); };
+  console.log = capture;
+  console.error = capture;
+  console.warn = capture;
+
+  // Set externalApiPaths so main.js discovers HMS SDK modules (@hms.*, @kit.*)
+  const hmsSdkEts = path.join(devecoHome, 'sdk', 'default', 'hms', 'ets');
+  if (fs.existsSync(hmsSdkEts)) {
+    const existing = process.env.externalApiPaths || '';
+    process.env.externalApiPaths = existing
+      ? existing + path.delimiter + hmsSdkEts
+      : hmsSdkEts;
+  }
+
+  try {
+    const etsChecker = require(path.join(etsLoaderPath, 'lib', 'ets_checker.js'));
+    const mainModule = require(path.join(etsLoaderPath, 'main.js'));
+
+    Object.assign(mainModule.partialUpdateConfig, {
+      executeArkTSLinter: true,
+      standardArkTSLinter: true,
+    });
+
+    process.env.compileMode = 'moduleJson';
+
+    const projectConfig = {
+      projectPath: args.project,
+      projectRootPath: args.project,
+      modulePath: args.project,
+      cachePath: path.join(args.project, '.cache', 'arkts-check'),
+      aceModuleJsonPath: aceModuleJsonPath,
+      compileMode: 'esmodule',
+      etsLoaderPath: etsLoaderPath,
+      packageManagerType: 'ohpm',
+      packageDir: 'oh_modules',
+      runtimeOS: 'OpenHarmony',
+      sdkInfo: '5.0.0',
+      compatibleSdkVersion: 12,
+      bundleType: '',
+      compilerTypes: [],
+      resolveModulePaths: [],
+    };
+
+    const cacheDir = projectConfig.cachePath;
+    if (!fs.existsSync(cacheDir)) {
+      fs.mkdirSync(cacheDir, { recursive: true });
+    }
+
+    const logger = {
+      debug: capture,
+      info: capture,
+      warn: capture,
+      error: capture,
+    };
+
+    etsChecker.etsStandaloneChecker(fileMap, logger, projectConfig);
+  } catch (e) {
+    captured.push(`Internal error: ${e.message}`);
+  } finally {
+    console.log = origLog;
+    console.error = origError;
+    console.warn = origWarn;
+  }
+
+  const diagnostics = [];
+  let current = null;
+
+  const lines = captured.flatMap(entry => entry.split('\n'));
+
+  for (const line of lines) {
+    const clean = line.replace(/\x1b\[\d+m/g, '').replace(/\[(\d+)m/g, '');
+    const loc = parseDiagnosticLine(clean);
+    if (loc) {
+      current = loc;
+      continue;
+    }
+    if (current && clean.trim() && !clean.includes('ArkTS:') && !clean.includes('For details about')) {
+      const { message, rule } = parseMessageLine(clean);
+      diagnostics.push({
+        file: path.relative(args.project, current.file),
+        line: current.line,
+        column: current.column,
+        severity: current.severity === 'error' ? 'error' : 'warning',
+        message,
+        rule,
+      });
+      current = null;
+    }
+  }
+
+  // A-class project-level checks
+  const extraDiags = [
+    ...validateSystemResources(files, devecoHome, args.project),
+    ...validateRouterPages(args.project),
+    ...validateModelVersion(args.project),
+  ];
+  diagnostics.push(...extraDiags);
+
+  const isStageProject = aceModuleJsonPath !== '';
+  const filtered = isStageProject
+    ? diagnostics.filter(d => !d.message.includes('the current Mode is FA'))
+    : diagnostics;
+
+  const errorCount = filtered.filter(d => d.severity === 'error').length;
+  const warnCount = filtered.filter(d => d.severity === 'warning').length;
+
+  const result = {
+    success: errorCount === 0,
+    errors: filtered,
+    summary: { errorCount, warnCount },
+  };
+
+  process.stdout.write(JSON.stringify(result, null, 2));
+  process.exit(errorCount > 0 ? 1 : 0);
+}
+
+main();

package/dist/index.js

@@ -180,6 +180,7 @@ function applySkillConfig(hostConfig, pluginConfig, directory) {
 }
 
 // src/tool/arkts-check.ts
+import fs from "node:fs";
 import path6 from "node:path";
 import { tool } from "@opencode-ai/plugin";
 
@@ -313,6 +314,17 @@ function runCommand(command, args, cwd, signal, env = process.env) {
 }
 
 // src/tool/arkts-check.ts
+function arktsCheckScriptPath() {
+  const candidates = [
+    path6.join(packageRoot(), "dist", "arkts-check.cjs"),
+    path6.join(packageRoot(), "src", "tool", "arkts-check.cjs")
+  ];
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate))
+      return candidate;
+  }
+  throw new Error("deveco-harness arkts-check.cjs not found. Reinstall or rebuild the plugin package.");
+}
 function createArktsCheckTool() {
   return tool({
     description: "Run ArkTS strict-mode static syntax/type check on .ets files. " + "Detects compiler-level violations such as `arkts-no-standalone-this`, `arkts-no-obj-literals-as-types`, and other ArkTS spec issues. " + "Returns structured diagnostics by file, line, column, and rule. " + "Call this after writing or editing any .ets file, before running build_project — catches most ArkTS errors faster than a full build. " + "Do NOT call for non-.ets source files, or when DevEco Studio is not installed locally.",
@@ -332,7 +344,7 @@ function createArktsCheckTool() {
         throw new Error("DevEco Studio not found. Set the DEVECO_HOME environment variable and retry.");
       }
       const node = nodePath(home);
-      const script = path6.join(import.meta.dirname, "arkts-check.cjs");
+      const script = arktsCheckScriptPath();
       const cmdArgs = ["--project", projectPath];
       if (args.files?.length) {
         cmdArgs.push("--files", ...args.files);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deveco-harness",
-  "version": "0.1.0",
+  "version": "0.1.1-test.0",
   "description": "OpenCode plugin for DevEco and HarmonyOS development workflows",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
     "deveco-harness.example.jsonc"
   ],
   "scripts": {
-    "build": "bun build ./src/index.ts --outdir ./dist --target node --external '@deveco-codegenie/mcp-bridge' --external '@opencode-ai/plugin' --external jsonc-parser",
+    "build": "bun build ./src/index.ts --outdir ./dist --target node --external '@deveco-codegenie/mcp-bridge' --external '@opencode-ai/plugin' --external jsonc-parser && bun run script/copy-assets.ts",
     "prepublishOnly": "bun run build",
     "typecheck": "tsc --noEmit"
   },