oh-skillhub 0.1.2 → 0.1.4

package/README.md

@@ -11,7 +11,19 @@ npx oh-skillhub install --domain arkui --agent codex
 npx oh-skillhub install --domain arkui --agent all --scope user
 ```
 
-Running without arguments starts an interactive domain selector and installs the selected skill set to the default Codex user skills directory.
+Running without arguments starts a TUI selector and installs the selected skill set to the default Codex user skills directory.
+
+In an interactive terminal:
+
+- Use `Up` / `Down` or `j` / `k` to move.
+- Press `Space` to select or unselect a group.
+- Press `Enter` to install selected groups.
+
+When input is piped or the terminal does not support raw key input, enter numbers separated by spaces:
+
+```bash
+printf "3 9\n" | npx oh-skillhub@latest
+```
 
 ## Current Capabilities
 
@@ -21,6 +33,7 @@ Running without arguments starts an interactive domain selector and installs the
 - Support `--agent codex|claude|opencode|all`.
 - Support `--scope user|project`.
 - Support `--dry-run` install plans.
+- Run a TUI matching the `skills/common/*` and `skills/domain/*` repository layout.
 - Keep anonymous telemetry events in a local retry queue.
 
 ## Commands

package/docs/superpowers/specs/2026-05-25-npx-skill-installer-design.md

@@ -153,12 +153,18 @@ npx oh-skillhub telemetry status
 npx oh-skillhub doctor
 ```
 
-无参数运行时进入交互式领域选择，默认安装到 Codex user scope：
+无参数运行时进入 TUI 领域选择，默认安装到 Codex user scope：
 
 ```bash
 npx oh-skillhub@latest
 ```
 
+真实交互终端中使用方向键或 `j/k` 移动，按 `Space` 勾选或取消，按 `Enter` 安装。非 TTY 或管道输入时，使用空格分隔编号选择多个分组，例如：
+
+```bash
+printf "3 9\n" | npx oh-skillhub@latest
+```
+
 推荐交互：
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-skillhub",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "OpenHarmony Skills installer for Codex, Claude Code, and OpenCode.",
   "type": "commonjs",
   "bin": {

package/src/cli.js

@@ -1,7 +1,8 @@
 const fs = require("node:fs");
 const os = require("node:os");
 const path = require("node:path");
-const readline = require("node:readline/promises");
+const readline = require("node:readline");
+const readlinePromises = require("node:readline/promises");
 
 const { resolveAgentTargets } = require("./agents");
 const { loadLocalManifest, loadProfiles, selectSkills } = require("./manifest");
@@ -9,6 +10,17 @@ const { applyInstallPlan, planInstall } = require("./planner");
 const { buildTelemetryEvent, enqueueTelemetryEvent, telemetryStatus } = require("./telemetry");
 
 const packageJson = require("../package.json");
+const COMMON_STAGES = ["cicd", "design", "development", "requirements", "testing", "troubleshooting"];
+const DOMAIN_NAMES = [
+  "app-framework",
+  "arkruntime",
+  "arkui",
+  "arkweb",
+  "distributed",
+  "graphics",
+  "kernel",
+  "security",
+];
 
 async function main(argv = []) {
   if (argv.length === 0) {
@@ -135,40 +147,236 @@ function renderInstall(options) {
 }
 
 async function runInteractiveInstaller(input = process.stdin, output = process.stdout) {
-  const choices = [
-    { label: "arkui", preset: "arkui", description: "ArkUI review and common baseline skills" },
-    { label: "app-dev", preset: "app-dev", description: "Application development skills" },
-    { label: "security", preset: "security", description: "Security review skills" },
-    { label: "cicd", preset: "cicd", description: "CI/CD analysis skills" },
-    { label: "testing", preset: "testing", description: "XTS and fuzz generation skills" },
-  ];
+  const manifest = loadLocalManifest();
+  const choices = buildRepositoryChoices(manifest);
+  const selectedIndexes =
+    input.isTTY && output.isTTY
+      ? await runRawTuiSelection(input, output, choices)
+      : await runPromptSelection(input, output, choices);
+  const selectedChoices = selectedIndexes.map((index) => choices[index]);
+  const skills = selectSkillsForChoices(manifest, selectedChoices);
+  if (!skills.length) {
+    throw new Error("No skills matched the selected groups.");
+  }
+  output.write(`\nInstalling ${selectedChoices.map((choice) => choice.path).join(", ")} for codex:user...\n`);
+  output.write(`${renderInstallForSkills(skills, { agent: "codex", scope: "user" })}\n`);
+}
+
+function buildRepositoryChoices(manifest) {
+  const choices = [];
+  for (const stage of COMMON_STAGES) {
+    const skills = manifest.skills.filter((skill) => skill.scope === "common" && skill.stage === stage);
+    choices.push({ scope: "common", stage, path: `common / ${stage}`, count: skills.length, skills });
+  }
+  for (const domain of DOMAIN_NAMES) {
+    const skills = manifest.skills.filter((skill) => skill.scope === "domain" && skill.domain === domain);
+    choices.push({ scope: "domain", domain, path: `domain / ${domain}`, count: skills.length, skills });
+  }
+  return choices;
+}
 
-  output.write("Select a skill domain to install:\n");
+function renderTuiMenu(choices) {
+  const width = 72;
+  const line = `+${"-".repeat(width - 2)}+`;
+  const lines = [
+    line,
+    `| ${padRight("OH SkillHub", width - 4)} |`,
+    `| ${padRight("OpenHarmony Skills Installer", width - 4)} |`,
+    line,
+    "",
+    "Target",
+    "  Agent: codex",
+    "  Scope: user",
+    "",
+    "Choose skill groups",
+    "  Interactive TTY: Up/Down or j/k to move, Space to toggle, Enter to install",
+    "  Piped input: enter numbers separated by spaces, e.g. 3 9",
+    "",
+  ];
   choices.forEach((choice, index) => {
-    output.write(`  ${index + 1}. ${choice.label} - ${choice.description}\n`);
+    const marker = choice.count > 0 ? "[ ]" : "[ ]";
+    lines.push(`  ${String(index + 1).padStart(2, " ")}. ${marker} ${choice.path.padEnd(28, " ")} ${choice.count} skill(s)`);
+    for (const leaf of renderSkillLeaves(choice)) {
+      lines.push(`       - ${leaf}`);
+    }
   });
+  lines.push("");
+  return `${lines.join("\n")}\n`;
+}
 
-  const rl = readline.createInterface({ input, output });
+async function runPromptSelection(input, output, choices) {
+  output.write(renderTuiMenu(choices));
+  const rl = readlinePromises.createInterface({ input, output });
   try {
-    const answer = await rl.question("Enter number [1]: ");
-    const selectedIndex = answer.trim() === "" ? 0 : Number(answer.trim()) - 1;
-    const selected = choices[selectedIndex];
-    if (!selected) {
-      throw new Error(`Invalid selection "${answer}". Choose a number from 1 to ${choices.length}.`);
-    }
-    output.write(`\nInstalling ${selected.label} skills for codex:user...\n`);
-    output.write(
-      `${renderInstall({
-        preset: selected.preset,
-        agent: "codex",
-        scope: "user",
-      })}\n`,
-    );
+    const answer = await rl.question("Select groups [9]: ");
+    return parseSelection(answer, choices.length, 9);
   } finally {
     rl.close();
   }
 }
 
+function runRawTuiSelection(input, output, choices) {
+  return new Promise((resolve, reject) => {
+    let cursor = 8;
+    const selected = new Set([cursor]);
+    const wasRaw = input.isRaw;
+
+    readline.emitKeypressEvents(input);
+    input.setRawMode(true);
+
+    function render() {
+      output.write("\x1b[2J\x1b[H");
+      output.write(renderRawTuiMenu(choices, cursor, selected));
+    }
+
+    function cleanup() {
+      input.removeListener("keypress", onKeypress);
+      input.setRawMode(Boolean(wasRaw));
+      output.write("\x1b[?25h");
+    }
+
+    function onKeypress(_str, key) {
+      if (key && key.ctrl && key.name === "c") {
+        cleanup();
+        reject(new Error("Cancelled."));
+        return;
+      }
+      if (key && (key.name === "down" || key.name === "j")) {
+        cursor = (cursor + 1) % choices.length;
+        render();
+        return;
+      }
+      if (key && (key.name === "up" || key.name === "k")) {
+        cursor = (cursor - 1 + choices.length) % choices.length;
+        render();
+        return;
+      }
+      if (key && key.name === "space") {
+        if (selected.has(cursor)) selected.delete(cursor);
+        else selected.add(cursor);
+        render();
+        return;
+      }
+      if (key && key.name === "return") {
+        cleanup();
+        resolve(selected.size ? Array.from(selected).sort((a, b) => a - b) : [cursor]);
+      }
+    }
+
+    output.write("\x1b[?25l");
+    render();
+    input.on("keypress", onKeypress);
+  });
+}
+
+function renderRawTuiMenu(choices, cursor, selected) {
+  const width = 76;
+  const line = `+${"-".repeat(width - 2)}+`;
+  const lines = [
+    line,
+    `| ${padRight("OH SkillHub", width - 4)} |`,
+    `| ${padRight("OpenHarmony Skills Installer", width - 4)} |`,
+    line,
+    "",
+    "Target",
+    "  Agent: codex",
+    "  Scope: user",
+    "",
+    "Choose skill groups",
+    "  Up/Down or j/k: move    Space: select    Enter: install    Ctrl+C: cancel",
+    "",
+  ];
+  choices.forEach((choice, index) => {
+    const pointer = index === cursor ? ">" : " ";
+    const checkbox = selected.has(index) ? "[✓]" : "[ ]";
+    lines.push(`${pointer} ${checkbox} ${choice.path.padEnd(28, " ")} ${choice.count} skill(s)`);
+    for (const leaf of renderSkillLeaves(choice)) {
+      lines.push(`      - ${leaf}`);
+    }
+  });
+  lines.push("");
+  return `${lines.join("\n")}\n`;
+}
+
+function renderSkillLeaves(choice) {
+  return (choice.skills || []).map((skill) => {
+    if (choice.scope === "common") {
+      return skill.name;
+    }
+    const prefix = `skills/domain/${choice.domain}/`;
+    if (skill.path.startsWith(prefix)) {
+      return skill.path.slice(prefix.length).split("/").join(" / ");
+    }
+    return skill.name;
+  });
+}
+
+function padRight(value, width) {
+  return value.length >= width ? value.slice(0, width) : `${value}${" ".repeat(width - value.length)}`;
+}
+
+function parseSelection(answer, max, defaultNumber) {
+  const text = answer.trim();
+  const tokens = text ? text.split(/\s+/) : [String(defaultNumber)];
+  const indexes = [];
+  for (const token of tokens) {
+    const number = Number(token);
+    if (!Number.isInteger(number) || number < 1 || number > max) {
+      throw new Error(`Invalid selection "${token}". Choose numbers from 1 to ${max}.`);
+    }
+    const index = number - 1;
+    if (!indexes.includes(index)) {
+      indexes.push(index);
+    }
+  }
+  return indexes;
+}
+
+function selectSkillsForChoices(manifest, choices) {
+  const selected = new Map();
+  for (const choice of choices) {
+    for (const skill of manifest.skills) {
+      if (choice.scope === "common" && skill.scope === "common" && skill.stage === choice.stage) {
+        selected.set(skill.name, skill);
+      }
+      if (choice.scope === "domain" && skill.scope === "domain" && skill.domain === choice.domain) {
+        selected.set(skill.name, skill);
+      }
+    }
+  }
+  return Array.from(selected.values()).sort((left, right) => left.name.localeCompare(right.name));
+}
+
+function renderInstallForSkills(skills, targetOptions) {
+  const targets = resolveAgentTargets({
+    agent: targetOptions.agent,
+    scope: targetOptions.scope,
+    cwd: process.cwd(),
+    homeDir: os.homedir(),
+    env: process.env,
+  });
+  const plan = planInstall(skills, targets);
+  const applied = applyInstallPlan(plan);
+  const telemetryEnabled = process.env.OH_SKILLHUB_NO_TELEMETRY !== "1";
+  for (const operation of applied) {
+    enqueueTelemetryEvent(
+      buildTelemetryEvent({
+        event: "skill_installed",
+        skill: operation.skill,
+        target: operation.target,
+        selection: {
+          profile: null,
+          domain: operation.skill.domain,
+          stage: operation.skill.stage,
+        },
+        packageVersion: packageJson.version,
+      }),
+      { enabled: telemetryEnabled },
+    );
+  }
+  return renderInstallPlan("Install summary", plan);
+}
+
 function renderInstallPlan(title, plan) {
   const lines = [title];
   for (const operation of plan.operations) {
@@ -248,4 +456,9 @@ module.exports = {
   renderInstall,
   renderList,
   renderTelemetry,
+  buildRepositoryChoices,
+  parseSelection,
+  renderRawTuiMenu,
+  renderTuiMenu,
+  selectSkillsForChoices,
 };

package/src/data/manifest.json

@@ -144,6 +144,17 @@
       "version": "0.1.0",
       "status": "stable",
       "tags": ["arkui", "review"]
+    },
+    {
+      "name": "ohos-design-graphics-explain-code",
+      "scope": "domain",
+      "domain": "graphics",
+      "stage": "design",
+      "path": "skills/domain/graphics/design/ohos-design-graphics-explain-code",
+      "description": "Use when explaining OpenHarmony graphics design code.",
+      "version": "0.1.0",
+      "status": "stable",
+      "tags": ["graphics", "design"]
     }
   ]
 }

package/src/manifest.js

@@ -66,7 +66,9 @@ function selectSkills(manifest, profiles, options = {}) {
   }
 
   if (options.stage) {
-    for (const skill of manifest.skills.filter((entry) => entry.stage === options.stage)) {
+    for (const skill of manifest.skills.filter(
+      (entry) => entry.stage === options.stage && (!options.scope || entry.scope === options.scope),
+    )) {
       addSkill(skill);
     }
   }