oh-skillhub 0.1.6 → 0.1.8

package/README.md

@@ -29,6 +29,7 @@ printf "1\n3 9\n" | npx oh-skillhub@latest
 
 - List bundled OpenHarmony skills by domain or stage.
 - Resolve profile/domain selections such as `arkui`, `app-dev`, `cicd`, `testing`, and `security`.
+- Download the selected skill directories from the OpenHarmony skills `release` branch and install the full skill contents.
 - Install skills into Codex, Claude Code, and OpenCode target directories.
 - Support `--agent codex|claude|opencode|all`.
 - Support interactive target selection for `Codex`, `Claude`, `OpenCode`, and `All`.
@@ -37,6 +38,8 @@ printf "1\n3 9\n" | npx oh-skillhub@latest
 - Run a TUI matching the `skills/common/*` and `skills/domain/*` repository layout.
 - Keep anonymous telemetry events in a local retry queue.
 
+The installer uses sparse Git checkout so it downloads only the selected skill directories instead of the whole repository.
+
 ## Commands
 
 ```bash

package/package.json

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

package/src/cli.js

@@ -7,6 +7,7 @@ const readlinePromises = require("node:readline/promises");
 const { resolveAgentTargets } = require("./agents");
 const { loadLocalManifest, loadProfiles, selectSkills } = require("./manifest");
 const { applyInstallPlan, planInstall } = require("./planner");
+const { ensureSkillSourceRoot } = require("./source");
 const { buildTelemetryEvent, enqueueTelemetryEvent, telemetryStatus } = require("./telemetry");
 
 const packageJson = require("../package.json");
@@ -139,7 +140,8 @@ function renderInstall(options) {
     return renderInstallPlan("Dry run install plan", plan);
   }
 
-  const applied = applyInstallPlan(plan);
+  const sourceRoot = ensureSkillSourceRoot(manifest, { env: process.env, skills: selection.skills });
+  const applied = applyInstallPlan(plan, { sourceRoot });
   const telemetryEnabled =
     !options.noTelemetry && !options.offline && process.env.OH_SKILLHUB_NO_TELEMETRY !== "1";
   for (const operation of applied) {
@@ -184,7 +186,9 @@ async function runInteractiveInstaller(input = process.stdin, output = process.s
     throw new Error("No skills matched the selected groups.");
   }
   output.write(`\nInstalling ${selectedChoices.map((choice) => choice.path).join(", ")} for ${agent}:user...\n`);
+  output.write(`Preparing skill source from ${manifest.source}#${manifest.ref}...\n`);
   output.write(`${renderInstallForSkills(skills, { agent, scope: "user" })}\n`);
+  output.write(`${renderInteractiveCompletion(skills, { agent, scope: "user" })}\n`);
 }
 
 function readAll(input) {
@@ -526,7 +530,9 @@ function renderInstallForSkills(skills, targetOptions) {
     env: process.env,
   });
   const plan = planInstall(skills, targets);
-  const applied = applyInstallPlan(plan);
+  const manifest = loadLocalManifest();
+  const sourceRoot = ensureSkillSourceRoot(manifest, { env: process.env, skills });
+  const applied = applyInstallPlan(plan, { sourceRoot });
   const telemetryEnabled = process.env.OH_SKILLHUB_NO_TELEMETRY !== "1";
   for (const operation of applied) {
     enqueueTelemetryEvent(
@@ -547,6 +553,14 @@ function renderInstallForSkills(skills, targetOptions) {
   return renderInstallPlan("Install summary", plan);
 }
 
+function renderInteractiveCompletion(skills, targetOptions) {
+  return [
+    "",
+    `Done. Installed ${skills.length} skill(s) for ${targetOptions.agent}:${targetOptions.scope}.`,
+    "You can close this terminal or start using the installed skills.",
+  ].join("\n");
+}
+
 function renderInstallPlan(title, plan) {
   const lines = [title];
   for (const operation of plan.operations) {

package/src/planner.js

@@ -36,33 +36,26 @@ function applyInstallPlan(plan, options = {}) {
       continue;
     }
     fs.mkdirSync(operation.destination, { recursive: true });
-    writeSkillFile(operation.destination, operation.skill);
+    copySkillDirectory(options.sourceRoot, operation.destination, operation.skill);
     writeInstallRecord(operation.target.dir, operation.target, operation.skill);
     applied.push(operation);
   }
   return applied;
 }
 
-function writeSkillFile(destination, skill) {
-  const contents = [
-    "---",
-    `name: ${skill.name}`,
-    `description: ${skill.description}`,
-    "metadata:",
-    "  author: openharmony",
-    `  scope: ${skill.scope}`,
-    `  stage: ${skill.stage}`,
-    `  domain: ${skill.domain}`,
-    `  version: ${skill.version}`,
-    `  status: ${skill.status}`,
-    "---",
-    "",
-    `# ${skill.name}`,
-    "",
-    skill.description,
-    "",
-  ].join("\n");
-  fs.writeFileSync(path.join(destination, "SKILL.md"), contents, "utf8");
+function copySkillDirectory(sourceRoot, destination, skill) {
+  if (!sourceRoot) {
+    throw new Error("Missing skill source root.");
+  }
+  const root = path.resolve(sourceRoot);
+  const source = path.resolve(root, skill.path);
+  if (source !== root && !source.startsWith(`${root}${path.sep}`)) {
+    throw new Error(`Invalid source path for ${skill.name}: ${skill.path}`);
+  }
+  if (!fs.existsSync(source) || !fs.statSync(source).isDirectory()) {
+    throw new Error(`Source skill directory not found for ${skill.name}: ${source}`);
+  }
+  fs.cpSync(source, destination, { recursive: true, force: true });
 }
 
 function writeInstallRecord(targetDir, target, skill) {

package/src/source.js

@@ -0,0 +1,91 @@
+const { spawnSync } = require("node:child_process");
+const crypto = require("node:crypto");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+
+function ensureSkillSourceRoot(manifest, options = {}) {
+  const env = options.env || process.env;
+  if (env.OH_SKILLHUB_SOURCE_DIR) {
+    return requireDirectory(env.OH_SKILLHUB_SOURCE_DIR, "OH_SKILLHUB_SOURCE_DIR");
+  }
+
+  const source = manifest.source;
+  const ref = manifest.ref || "release";
+  if (!source) {
+    throw new Error("Manifest does not define a skill source repository.");
+  }
+
+  const cacheRoot = env.OH_SKILLHUB_CACHE_DIR || path.join(os.homedir(), ".oh-skillhub", "cache");
+  const sparsePaths = selectedSparsePaths(options.skills);
+  const checkout = path.join(cacheRoot, `${repositorySlug(source)}-${sanitize(ref)}-${sparseKey(sparsePaths)}`);
+  if (isUsableCheckout(checkout, sparsePaths)) {
+    return checkout;
+  }
+
+  fs.mkdirSync(cacheRoot, { recursive: true });
+  fs.rmSync(checkout, { recursive: true, force: true });
+  const tempCheckout = path.join(cacheRoot, `.tmp-${Date.now()}-${Math.random().toString(16).slice(2)}`);
+  const clone = runGit(["-c", "core.longpaths=true", "clone", "--depth", "1", "--branch", ref, "--no-checkout", source, tempCheckout]);
+  if (clone.status !== 0) {
+    fs.rmSync(tempCheckout, { recursive: true, force: true });
+    const detail = gitDetail(clone);
+    throw new Error(`Failed to download skill source from ${source}#${ref}.${detail ? ` ${detail}` : ""}`);
+  }
+  const sparseInit = runGit(["-C", tempCheckout, "-c", "core.longpaths=true", "sparse-checkout", "init", "--no-cone"]);
+  const sparseSet = sparseInit.status === 0
+    ? runGit(["-C", tempCheckout, "-c", "core.longpaths=true", "sparse-checkout", "set", ...sparsePaths])
+    : sparseInit;
+  const checkoutResult = sparseSet.status === 0
+    ? runGit(["-C", tempCheckout, "-c", "core.longpaths=true", "checkout"])
+    : sparseSet;
+  if (checkoutResult.status !== 0) {
+    fs.rmSync(tempCheckout, { recursive: true, force: true });
+    const detail = gitDetail(checkoutResult);
+    throw new Error(`Failed to checkout selected skill source from ${source}#${ref}.${detail ? ` ${detail}` : ""}`);
+  }
+  fs.renameSync(tempCheckout, checkout);
+  return checkout;
+}
+
+function requireDirectory(value, label) {
+  const dir = path.resolve(value);
+  if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) {
+    throw new Error(`${label} is not a directory: ${dir}`);
+  }
+  return dir;
+}
+
+function isUsableCheckout(dir, sparsePaths) {
+  return sparsePaths.every((item) => fs.existsSync(path.join(dir, item)));
+}
+
+function repositorySlug(source) {
+  const name = source.replace(/[\\/]+$/, "").split(/[\\/]/).pop() || "skills";
+  return sanitize(name.replace(/\.git$/, ""));
+}
+
+function sanitize(value) {
+  return value.replace(/[^a-zA-Z0-9._-]/g, "-");
+}
+
+function selectedSparsePaths(skills = []) {
+  const paths = skills.map((skill) => skill.path).filter(Boolean).sort();
+  return paths.length ? paths : ["skills"];
+}
+
+function sparseKey(sparsePaths) {
+  return crypto.createHash("sha1").update(sparsePaths.join("\n")).digest("hex").slice(0, 12);
+}
+
+function runGit(args) {
+  return spawnSync("git", args, { encoding: "utf8", shell: false });
+}
+
+function gitDetail(result) {
+  return (result.stderr || result.stdout || "").trim();
+}
+
+module.exports = {
+  ensureSkillSourceRoot,
+};