@skild/core 0.10.22 → 0.11.0

package/dist/index.js

@@ -331,6 +331,7 @@ import fs6 from "fs";
 import os2 from "os";
 import path7 from "path";
 import degit from "degit";
+import simpleGit from "simple-git";
 
 // src/source.ts
 import path6 from "path";
@@ -491,6 +492,81 @@ function resetTargetDir(targetPath) {
   removeDir(targetPath);
   fs6.mkdirSync(targetPath, { recursive: true });
 }
+function splitSourceRef(source) {
+  const [base, ref] = source.split("#", 2);
+  return { base, ref: ref?.trim() || void 0 };
+}
+function parseGitCloneSpec(source) {
+  const trimmed = source.trim();
+  if (!trimmed) return null;
+  if (resolveLocalPath(trimmed)) return null;
+  const { base, ref } = splitSourceRef(trimmed);
+  const githubTreeWithPathMatch = base.match(/github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)\/(.+)/);
+  if (githubTreeWithPathMatch) {
+    const [, owner, repo, branch, subpath] = githubTreeWithPathMatch;
+    return { url: `https://github.com/${owner}/${repo}.git`, ref: branch, subpath };
+  }
+  const githubTreeMatch = base.match(/github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)$/);
+  if (githubTreeMatch) {
+    const [, owner, repo, branch] = githubTreeMatch;
+    return { url: `https://github.com/${owner}/${repo}.git`, ref: branch };
+  }
+  const githubRepoMatch = base.match(/github\.com\/([^/]+)\/([^/]+)/);
+  if (githubRepoMatch) {
+    const [, owner, repoRaw] = githubRepoMatch;
+    const repo = repoRaw.replace(/\.git$/, "");
+    return { url: `https://github.com/${owner}/${repo}.git`, ref };
+  }
+  const gitlabTreeWithPathMatch = base.match(/gitlab\.com\/([^/]+)\/([^/]+)\/-\/tree\/([^/]+)\/(.+)/);
+  if (gitlabTreeWithPathMatch) {
+    const [, owner, repo, branch, subpath] = gitlabTreeWithPathMatch;
+    return { url: `https://gitlab.com/${owner}/${repo}.git`, ref: branch, subpath };
+  }
+  const gitlabTreeMatch = base.match(/gitlab\.com\/([^/]+)\/([^/]+)\/-\/tree\/([^/]+)$/);
+  if (gitlabTreeMatch) {
+    const [, owner, repo, branch] = gitlabTreeMatch;
+    return { url: `https://gitlab.com/${owner}/${repo}.git`, ref: branch };
+  }
+  const gitlabRepoMatch = base.match(/gitlab\.com\/([^/]+)\/([^/]+)/);
+  if (gitlabRepoMatch) {
+    const [, owner, repoRaw] = gitlabRepoMatch;
+    const repo = repoRaw.replace(/\.git$/, "");
+    return { url: `https://gitlab.com/${owner}/${repo}.git`, ref };
+  }
+  const shorthandMatch = base.match(/^([^/]+)\/([^/]+)(?:\/(.+))?$/);
+  if (shorthandMatch && !base.includes(":") && !base.startsWith(".") && !base.startsWith("/")) {
+    const [, owner, repo, subpath] = shorthandMatch;
+    return { url: `https://github.com/${owner}/${repo}.git`, ref, subpath };
+  }
+  if (/^(https?:|git@|ssh:)/i.test(base)) {
+    return { url: base, ref };
+  }
+  return null;
+}
+async function cloneWithGit(spec, targetPath) {
+  const cloneOptions = spec.ref ? ["--depth", "1", "--branch", spec.ref] : ["--depth", "1"];
+  const git = simpleGit();
+  if (!spec.subpath) {
+    resetTargetDir(targetPath);
+    await git.clone(spec.url, targetPath, cloneOptions);
+    return spec.url;
+  }
+  const tempRoot = createTempDir(path7.join(os2.tmpdir(), "skild-git"), extractSkillName(spec.url));
+  try {
+    await git.clone(spec.url, tempRoot, cloneOptions);
+    const resolvedSubpath = path7.resolve(tempRoot, spec.subpath);
+    const resolvedRoot = path7.resolve(tempRoot);
+    if (!resolvedSubpath.startsWith(`${resolvedRoot}${path7.sep}`)) {
+      throw new SkildError("INVALID_SOURCE", `Subpath escapes repository root: ${spec.subpath}`, { subpath: spec.subpath });
+    }
+    ensureInstallableDir(resolvedSubpath);
+    resetTargetDir(targetPath);
+    copyDir(resolvedSubpath, targetPath);
+    return spec.url;
+  } finally {
+    removeDir(tempRoot);
+  }
+}
 async function cloneRemote(degitSrc, targetPath, mode) {
   const emitter = degit(degitSrc, { force: true, verbose: false, mode });
   await emitter.clone(targetPath);
@@ -543,6 +619,14 @@ async function materializeSourceToDir(input) {
     copyDir(localPath, targetDir);
     return { sourceType: "local", materializedFrom: localPath };
   }
+  const gitSpec = parseGitCloneSpec(input.source);
+  if (gitSpec) {
+    try {
+      const materializedFrom2 = await cloneWithGit(gitSpec, targetDir);
+      return { sourceType, materializedFrom: materializedFrom2 };
+    } catch {
+    }
+  }
   const degitPath = toDegitPath(input.source);
   const materializedFrom = await cloneRemoteWithFallback(degitPath, targetDir);
   return { sourceType, materializedFrom };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skild/core",
-  "version": "0.10.22",
+  "version": "0.11.0",
   "description": "Skild core library (headless) for installing, validating, and managing Agent Skills locally.",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,6 +20,7 @@
     "degit": "^2.8.4",
     "js-yaml": "^4.1.0",
     "semver": "^7.6.3",
+    "simple-git": "^3.27.0",
     "tar": "^7.4.3"
   },
   "devDependencies": {