@harmonyos-arkts/opencode-plugin 0.0.13 → 0.0.15

package/dist/index.js

@@ -31452,31 +31452,28 @@ import path2 from "path";
 import fs from "fs/promises";
 import os2 from "os";
 var paths = envPaths("hm-plugin");
-var HMGlobal;
-((HMGlobal2) => {
-  HMGlobal2.Path = {
-    // Allow override via OPENCODE_TEST_HOME for test isolation
-    get home() {
-      return process.env.OPENCODE_TEST_HOME || os2.homedir();
-    },
-    data: paths.data,
-    bin: path2.join(paths.data, "bin"),
-    log: paths.log,
-    cache: paths.cache,
-    config: paths.config,
-    state: paths.data
-  };
-})(HMGlobal || (HMGlobal = {}));
+var Path = {
+  // Allow override via OPENCODE_TEST_HOME for test isolation
+  get home() {
+    return process.env.OPENCODE_TEST_HOME || os2.homedir();
+  },
+  data: paths.data,
+  bin: path2.join(paths.data, "bin"),
+  log: paths.log,
+  cache: paths.cache,
+  config: paths.config,
+  state: paths.data
+};
 await Promise.all([
-  fs.mkdir(HMGlobal.Path.data, { recursive: true }),
-  fs.mkdir(HMGlobal.Path.config, { recursive: true }),
-  fs.mkdir(HMGlobal.Path.state, { recursive: true }),
-  fs.mkdir(HMGlobal.Path.log, { recursive: true }),
-  fs.mkdir(HMGlobal.Path.bin, { recursive: true })
+  fs.mkdir(Path.data, { recursive: true }),
+  fs.mkdir(Path.config, { recursive: true }),
+  fs.mkdir(Path.state, { recursive: true }),
+  fs.mkdir(Path.log, { recursive: true }),
+  fs.mkdir(Path.bin, { recursive: true })
 ]);
 
 // src/shared/log.ts
-var logFile = path3.join(HMGlobal.Path.log, "plugin.log");
+var logFile = path3.join(Path.log, "plugin.log");
 var logDir = path3.dirname(logFile);
 var MAX_LOG_SIZE_BYTES = 5 * 1024 * 1024;
 var MAX_LOG_AGE_DAYS = 7;
@@ -31568,7 +31565,7 @@ cleanupRotatedLogs();
 
 // src/agents/prompt.ts
 var HM_DESIGN = `
-### Prd Phase
+### Design Phase
 - Use the \`harmonyos-prd-design\` skill to create prd desgin documents
 - Reference design patterns and best practices from the skill documentation
 - Design documents should be stored in the project's \`.harmonyos/\` directory
@@ -31603,11 +31600,57 @@ var HM_BUILD = `
   5. If still failing after 3 attempts, report the remaining errors to the user and ask for guidance
 - Only after a successful build should the development cycle be considered complete
 `;
-var HM_ONE2MANY = `
-### One-to-Many Adaptation Phase
-- Use the \`harmonyos-one2many-adapt\` skill to adapt the HarmonyOS application for multiple device types (phone, tablet, foldable, 2-in-1, wearable, TV)
-- After completing adaptation, you MUST proceed to the Build phase
-- **NO EXCEPTIONS**: Code must be built successfully before marking adaptation as complete
+var HM_MULTI_DEVICE = `
+## Role
+
+You are an expert in HarmonyOS "Deploy Once, Run Everywhere" (\u4E00\u591A) multi-device adaptation. Your job is to help developers adapt phone-first ArkTS applications to work correctly across phones, tablets, foldables, and PCs \u2014 and to diagnose and fix adaptation-related bugs in existing code.
+
+You are **not** a general HarmonyOS assistant. Decline requests outside your domain (e.g., backend services, non-UI logic, Ability lifecycle unrelated to window management) and suggest the developer seek a broader assistant for those.
+
+---
+
+## Execution Workflow
+
+At the start of every task, load and follow:
+
+\`\`\`
+harmonyos-multi-device-adaptation/harmonyos-adaptation-workflow/SKILL.md
+\`\`\`
+
+That skill defines the full execution flow for both new adaptation (Path A) and bug fixing (Path B), including project scanning, domain routing, build verification, and the mandatory implementation checklist. Do not proceed without loading it.
+
+---
+
+## Skill Files
+
+Domain knowledge lives in skill files under \`harmonyos-multi-device-adaptation/\`. Each file's **Agent Interface** section contains:
+
+- \`symptom_keywords\` \u2014 match against user-reported symptoms to identify the relevant domain
+- \`hard_constraints\` \u2014 verify every item before generating any code for that domain
+- \`diagnostic_checklist\` \u2014 walk through item-by-item when diagnosing a bug
+
+When a new skill is added to the folder, it is automatically available \u2014 no changes to this prompt are needed.
+
+---
+
+## Universal Hard Constraints
+
+These rules apply across all domains and all phases. Never deviate.
+
+1. **ArkTS only.** Never output Java, JavaScript, or Kotlin.
+2. **No invented APIs.** If you are not certain an API exists, say so explicitly rather than guessing.
+3. **Window object.** Always obtain the window via \`AppStorage.get<window.WindowStage>('windowStage')!.getMainWindowSync()\`. Never use \`window.getLastWindow()\`.
+4. **avoidAreaChange callback.** Always read \`opts.area\` directly. Never call \`getWindowAvoidArea()\` inside the callback.
+
+---
+
+## Output Format
+
+- **Lead with domain identification** \u2014 always name the domain(s) before proposing code.
+- **Use \u274C/\u2705 comparisons** for all code changes, with a one-line reason for each change.
+- **If uncertain about an API**, say: *"I'm not certain this API exists at the required level \u2014 please verify in the official HarmonyOS documentation."*
+- **If a request is outside your domains**, say: *"This falls outside multi-device adaptation. You may want to consult a general HarmonyOS assistant for this."*
+- **Never output a wall of code** without explaining what changed and why.
 `;
 var HM_PLAN = `
 ### Plan Phase
@@ -31723,8 +31766,8 @@ function buildPlanPrompt(type) {
       return HM_DESIGN;
     case "build":
       return HM_BUILD;
-    case "one2many":
-      return HM_ONE2MANY;
+    case "multi-device":
+      return HM_MULTI_DEVICE;
     case "plan":
       return HM_PLAN;
     case "all":
@@ -31734,33 +31777,29 @@ function buildPlanPrompt(type) {
   }
 }
 function buildAllAgentPrompt() {
-  return `All HarmonyOS development tasks can be broadly categorized into three main phases: Design, Development, Build. Each phase has its own set of best practices and workflows to ensure efficient and successful project completion.
+  return `- **New project (greenfield)**: Design \u2192 Development \u2192 Build. Do not skip the design phase, as it is critical for planning and architectural decisions.
+- **Complex tasks**: List a plan \u2192 Discuss plan details with the user if needed \u2192 Development \u2192 Build.
+- **Simple tasks**: Development \u2192 Build directly.
+
+Each phase has its own set of best practices and workflows to ensure efficient and successful project completion.
+
 ${HM_DESIGN}
 ${HM_DEVELOP}
 ${HM_BUILD}
-
-Follow these workflows:
-- **New project (greenfield)**: PRD Design \u2192 Development \u2192 Build.
-- **Complex tasks**: List a plan \u2192 Discuss plan details with the user if needed \u2192 Development \u2192 Build.
-- **Simple tasks**: Development \u2192 Build directly.
 `;
 }
 function buildHmAgentPrompt(type) {
   return `You are HarmonyOS Dev Assistant(HDACode), an expert coding agent specialized in HarmonyOS development.
-
 You are an interactive CLI tool that helps users with software engineering tasks. Use the instructions below and the tools available to you to assist the user.
-
 IMPORTANT: You must NEVER generate or guess URLs for the user unless you are confident that the URLs are for helping the user with programming. You may use URLs provided by the user in their messages or local files.
-
 When the user directly asks about HDACode (eg. "can HDACode do...", "does HDACode have..."), or asks in second person (eg. "are you able...", "can you do..."), or asks how to use a specific HDACode feature (eg. implement a hook, write a slash command, or install an MCP server), use the WebFetch tool to gather information to answer the question from HDACode docs.
-
 **IMPORTANT**: All HarmonyOS development tasks must follow these workflows:
 
 ${buildPlanPrompt(type)}
 
 # Tone and style
 - Only use emojis if the user explicitly requests it. Avoid using emojis in all communication unless asked.
-- Unless the user specifies a language, reply in the user's language; code encoding content is excluded from this rule.
+- You MUST reply in Chinese (\u7B80\u4F53\u4E2D\u6587) at all times; code, technical identifiers, and file paths are excluded from this rule.
 - Your output will be displayed on a command line interface. You can use GitHub-flavored markdown for formatting, and will be rendered in a monospace font using the CommonMark specification.
 - Keep your responses brief and direct. Lead with the answer or action, not the reasoning. Skip preamble and postamble (e.g., "The answer is...", "Based on the information provided..."). Only elaborate when the user asks for detail.
 - Output text to communicate with the user; all text you output outside of tool use is displayed to the user. Only use tools to complete tasks. Never use tools like Bash or code comments as means to communicate with the user during the session.
@@ -31797,24 +31836,6 @@ The first item has been fixed, let me mark the first todo as completed, and move
 </example>
 In the above example, the assistant completes all the tasks, including the 10 error fixes and running the build and fixing all errors.
 
-<example>
-user: Help me write a new feature that allows users to track their usage metrics and export them to various formats
-assistant: I'll help you implement a usage metrics tracking and export feature. Let me first use the TodoWrite tool to plan this task.
-Adding the following todos to the todo list:
-1. Research existing metrics tracking in the codebase
-2. Design the metrics collection system
-3. Implement core metrics tracking functionality
-4. Create export functionality for different formats
-
-Let me start by researching the existing codebase to understand what metrics we might already be tracking and how we can build on that.
-
-I'm going to search for any existing metrics or telemetry code in the project.
-
-I've found some existing telemetry code. Let me mark the first todo as in_progress and start designing our metrics tracking system based on what I've learned...
-
-[Assistant continues implementing the feature step by step, marking todos as in_progress and completed as they go]
-</example>
-
 
 # Doing tasks
 The user will primarily request you perform software engineering tasks. This includes solving bugs, adding new functionality, refactoring code, explaining code, and more. For these tasks the following steps are recommended:
@@ -31891,6 +31912,13 @@ function createHmAgent() {
       doom_loop: "ask",
       external_directory: {
         "*": "ask"
+      },
+      "skillSearch": "allow",
+      skill: {
+        "*": "deny",
+        "harmonyos-atomic-dev": "allow",
+        "harmonyos-hvigor": "allow",
+        "harmonyos-prd-design": "allow"
       }
     },
     metadata: void 0
@@ -31939,30 +31967,34 @@ function createHmDevelopmentAgent() {
     prompt: buildHmAgentPrompt("dev"),
     temperature: 0.3,
     permission: {
-      "skillSearch": "allow"
+      "skillSearch": "allow",
+      skill: {
+        "*": "deny",
+        "harmonyos-atomic-dev": "allow",
+        "harmonyos-hvigor": "allow",
+        "harmonyos-prd-design": "allow"
+      }
     },
     metadata: void 0
   };
   return agent;
 }
 
-// src/agents/one2many-agent.ts
-function getHmOne2ManyDescription() {
+// src/agents/multi-device-agent.ts
+function getHmMultiDeviceDescription() {
   return `
     HarmonyOS One-to-Many Adaptation \u2014 adapts applications for multiple device types (phone, tablet, foldable, 2-in-1, wearable, TV)
   `;
 }
-function createOne2ManyAgent() {
+function createMultiDeviceAgent() {
   const agent = {
-    id: "harmonyos-one2many",
-    name: "harmonyos-one2many",
-    description: getHmOne2ManyDescription(),
+    id: "harmonyos-multi-device",
+    name: "harmonyos-multi-device",
+    description: getHmMultiDeviceDescription(),
     mode: "primary",
-    prompt: buildHmAgentPrompt("one2many"),
+    prompt: buildHmAgentPrompt("multi-device"),
     temperature: 0.3,
-    permission: {
-      "skillSearch": "deny"
-    },
+    permission: {},
     metadata: void 0
   };
   return agent;
@@ -31975,7 +32007,7 @@ var AgentRegistry = class {
     this.register(createHmAgent());
     this.register(createDesignAgent());
     this.register(createHmDevelopmentAgent());
-    this.register(createOne2ManyAgent());
+    this.register(createMultiDeviceAgent());
   }
   register(agent) {
     this.agents.set(agent.id, agent);
@@ -44631,7 +44663,7 @@ function tool(input) {
 tool.schema = external_exports2;
 
 // src/tools/create-template/download-template.ts
-import { cpSync, mkdirSync } from "fs";
+import { cpSync, existsSync } from "fs";
 import path6 from "path";
 import { fileURLToPath } from "url";
 
@@ -44721,7 +44753,9 @@ async function downloadTemplate(mode, filePath) {
   }
   const targetDir = path6.resolve(filePath);
   const templateDir = path6.join(__dirname, "templates", templateType);
-  mkdirSync(targetDir, { recursive: true });
+  if (!existsSync(targetDir)) {
+    throw new Error(`Directory does not exist: ${targetDir}. Please create it first.`);
+  }
   cpSync(templateDir, targetDir, { recursive: true });
   const sdkInfo = getSdkVersion();
   if (sdkInfo) {
@@ -44836,15 +44870,15 @@ async function updateEtsCache(sessionManager, sessionID, directory) {
 var CHECK_ETS_TEMPLATE_MODES = /* @__PURE__ */ new Set(["atomic", "application"]);
 function createHmTemplateTool(managers) {
   return tool({
-    description: "Create an empty HarmonyOS project template. Supports three modes: 'application' (full app), 'module' (sub-module), 'atomic' (atomic service). Downloads and extracts the template to the specified directory.",
+    description: "Create an empty HarmonyOS project template. Supports three modes: 'application' (full app), 'module' (sub-module), 'atomic' (atomic service). Defaults to the current working directory unless the user specifies a different directory.",
     args: {
-      filePath: tool.schema.string("Absolute path of the target directory where the template will be created"),
+      filePath: tool.schema.string("Absolute path of the target directory where the template will be created. Defaults to the current working directory if not specified."),
       mode: tool.schema.string("Template type: 'application' (\u5E94\u7528), 'module' (\u6A21\u5757), or 'atomic' (\u5143\u670D\u52A1)")
     },
     execute: async (args, context) => {
       try {
         if (CHECK_ETS_TEMPLATE_MODES.has(args.mode)) {
-          const fileCount = await checkEtsExists(context.directory);
+          const fileCount = await checkEtsExists(args.filePath);
           if (fileCount > 0) {
             log("[createHmTemplate] skipped, ets files exist", { fileCount });
             return `Skipped: Current directory already contains ${fileCount} .ets file(s). Template download is not needed.`;
@@ -44861,7 +44895,7 @@ function createHmTemplateTool(managers) {
 }
 
 // src/tools/skill-search/search-skill.ts
-import { readFileSync, existsSync } from "node:fs";
+import { readFileSync, existsSync as existsSync2 } from "node:fs";
 import { join as join4 } from "node:path";
 
 // src/tools/skill-search/tokenizer.ts
@@ -44896,7 +44930,10 @@ function tokenize(text) {
 var BM25Retriever = class {
   k1;
   b;
-  documents = [];
+  _documents = [];
+  get documents() {
+    return this._documents;
+  }
   tokenizedDocs = [];
   df = /* @__PURE__ */ new Map();
   tfMaps = [];
@@ -44906,7 +44943,7 @@ var BM25Retriever = class {
     this.b = opts?.b ?? 0.75;
   }
   addDocuments(docs, tokenized) {
-    this.documents = [...this.documents, ...docs];
+    this._documents = [...this._documents, ...docs];
     this.tokenizedDocs = [...this.tokenizedDocs, ...tokenized];
     const totalLen = this.tokenizedDocs.reduce(
       (sum, doc) => sum + doc.length,
@@ -44991,12 +45028,12 @@ var HybridRetriever = class {
     this.keyword.addDocuments(docs, tokenized);
   }
   search(query, topK = 5) {
-    if (this.bm25["documents"].length === 0) return [];
+    if (this.bm25.documents.length === 0) return [];
     const poolSize = topK * 3;
     const bm25Results = this.bm25.search(query, poolSize);
     const keywordResults = this.keyword.search(query, poolSize);
     const rrfK = 60;
-    const documents = this.bm25["documents"];
+    const documents = this.bm25.documents;
     const scores = /* @__PURE__ */ new Map();
     for (let rank = 0; rank < bm25Results.length; rank++) {
       const idx = bm25Results[rank].index;
@@ -45227,7 +45264,7 @@ async function loadAndCache(resolvedPath) {
   log("start load sdk cache", sdk_path);
   if (sdk_path !== void 0) {
     const sdkIndexPath = join4(import.meta.dirname, "sdk-index.json");
-    if (!existsSync(sdkIndexPath)) {
+    if (!existsSync2(sdkIndexPath)) {
       log("sdk path is not exist, need to build");
       await buildSDKIndex(sdk_path);
     }
@@ -45254,7 +45291,7 @@ async function loadAndCache(resolvedPath) {
 function loadSdkIndex() {
   if (cachedSdkRetriever) return true;
   const sdkIndexPath = join4(import.meta.dirname, "sdk-index.json");
-  if (!existsSync(sdkIndexPath)) return false;
+  if (!existsSync2(sdkIndexPath)) return false;
   try {
     const raw = readFileSync(sdkIndexPath, "utf-8");
     const entries = JSON.parse(raw);
@@ -45286,7 +45323,8 @@ async function searchSkill(skill_path, query, topK = 3) {
       preFiltered.push({
         ets_file_path: "",
         experience_file_path: join4(prefix, entry.path),
-        sdk_file_path: ""
+        sdk_file_path: "",
+        score: 0
       });
       query = (query.slice(0, idx) + query.slice(idx + category.length)).trim();
     }
@@ -45298,7 +45336,8 @@ async function searchSkill(skill_path, query, topK = 3) {
   const sdkResults = loadSdkIndex() ? cachedSdkRetriever.search(query, topK).filter((r) => r.score >= MIN_SCORE).map((r) => ({
     ets_file_path: "",
     experience_file_path: "",
-    sdk_file_path: cachedSdkEntries[r.index].path
+    sdk_file_path: cachedSdkEntries[r.index].path,
+    score: r.score
   })) : [];
   const searchResults = cachedRetriever.search(query, topK);
   const filtered = searchResults.filter((r) => r.score >= MIN_SCORE);
@@ -45314,6 +45353,9 @@ function aggregateByExperience(results) {
       if (r.ets_file_path) {
         existing.ets_file_path = existing.ets_file_path ? existing.ets_file_path + "\n" + r.ets_file_path : r.ets_file_path;
       }
+      if (r.score > existing.score) {
+        existing.score = r.score;
+      }
     } else {
       map3.set(key, { ...r });
     }
@@ -45329,7 +45371,8 @@ function convert_search_result(searchResults, prefix) {
     return {
       ets_file_path: join4(prefix, entry.path),
       experience_file_path: experience?.path ? join4(prefix, experience.path) : "",
-      sdk_file_path: ""
+      sdk_file_path: "",
+      score: result.score
     };
   });
 }
@@ -45564,6 +45607,7 @@ ${localResults.message}`);
       } else {
         const localInfo = localResults.map((r) => {
           const lines = [];
+          lines.push(`score ${r.score.toFixed(4)}`);
           if (r.experience_file_path) lines.push(`- experience path: ${r.experience_file_path}`);
           if (r.ets_file_path) lines.push(`- sample code path: ${r.ets_file_path}`);
           if (r.sdk_file_path) lines.push(`- sdk info path: ${r.sdk_file_path}`);
@@ -47590,7 +47634,8 @@ function runEnvCheck() {
     try {
       const output = execSync(`${check3.cmd} 2>&1`, { timeout: 1e4, encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
       const firstLine = output.split(/\r?\n/)[0]?.trim() || "";
-      lines.push(`[${check3.name}] ${firstLine}`);
+      const suffix = check3.name === "Java" ? " (requires >= 17)" : "";
+      lines.push(`[${check3.name}] ${firstLine}${suffix}`);
     } catch (err) {
       lines.push(`[${check3.name}] NOT FOUND`);
     }
@@ -47677,7 +47722,7 @@ function createHooks(args) {
     ["tool.execute.before", () => toolHooks["tool.execute.before"]],
     ["tool.execute.after", () => toolHooks["tool.execute.after"]],
     ["command.execute.before", () => commandHooks["command.execute.before"]],
-    ["event", () => sessionHooks["event"]],
+    ["event", () => sessionHooks.event],
     ["chat.params", () => createChatParamsHandler(config3)],
     ["chat.message", () => createChatMessageHandler(ctx, managers)]
   ];

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@harmonyos-arkts/opencode-plugin",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "HarmonyOS Full-Lifecycle Development Assistant. Specialized in the complete development lifecycle of HarmonyOS applications, including project creation, UI development, state management, network requests, data storage, permission requests, performance optimization, testing, and release.",
   "type": "module",
   "license": "MIT",