@hagicode/skillsbase 0.1.1 → 0.1.2

package/dist/cli.mjs

@@ -168,6 +168,21 @@ function validateSource(source) {
 		include: [...source.include]
 	};
 }
+function isRemoteRepositorySource(source) {
+	return source.kind === "github-repository";
+}
+function buildSourcePath(source, originalName) {
+	if (isRemoteRepositorySource(source)) return `${source.root}@${originalName}`;
+	return path.join(source.root, originalName);
+}
+function resolveSourceRoot(repoPath, source) {
+	if (isRemoteRepositorySource(source) || path.isAbsolute(source.root)) return source.root;
+	return path.resolve(repoPath, source.root);
+}
+function resolveSourcePath(repoPath, source, originalName) {
+	if (isRemoteRepositorySource(source)) return buildSourcePath(source, originalName);
+	return path.join(resolveSourceRoot(repoPath, source), originalName);
+}
 function createManifest(repoPath, options = {}) {
 	return {
 		version: 1,
@@ -300,19 +315,25 @@ async function saveManifest(manifest) {
 }
 function buildManifestEntries(manifest, repoPath = manifest.repoPath) {
 	const entries = [];
-	for (const source of manifest.sources) for (const originalName of source.include ?? []) {
-		const targetName = `${source.targetPrefix ?? ""}${originalName}`;
-		entries.push({
-			sourceKey: source.key,
-			sourceLabel: source.label,
-			sourceKind: source.kind,
-			sourceRoot: source.root,
-			sourcePath: path.join(source.root, originalName),
-			originalName,
-			targetName,
-			targetPath: path.join(repoPath, manifest.skillsRoot, targetName),
-			targetPathRelative: toPosix(path.join(manifest.skillsRoot, targetName))
-		});
+	for (const source of manifest.sources) {
+		const resolvedSourceRoot = resolveSourceRoot(repoPath, source);
+		for (const originalName of source.include ?? []) {
+			const targetName = `${source.targetPrefix ?? ""}${originalName}`;
+			entries.push({
+				sourceKey: source.key,
+				sourceLabel: source.label,
+				sourceKind: source.kind,
+				remoteSource: isRemoteRepositorySource(source),
+				sourceRoot: source.root,
+				sourcePath: buildSourcePath(source, originalName),
+				resolvedSourceRoot,
+				resolvedSourcePath: resolveSourcePath(repoPath, source, originalName),
+				originalName,
+				targetName,
+				targetPath: path.join(repoPath, manifest.skillsRoot, targetName),
+				targetPathRelative: toPosix(path.join(manifest.skillsRoot, targetName))
+			});
+		}
 	}
 	const collisions = /* @__PURE__ */ new Map();
 	for (const entry of entries) {
@@ -362,6 +383,11 @@ function buildMetadata(manifest, entry, installRecord) {
 //#endregion
 //#region src/lib/installer.ts
 var execFile$1 = promisify(execFile);
+function toInstallReference(entry) {
+	if (entry.remoteSource) return entry.sourcePath;
+	if (path.isAbsolute(entry.sourcePath) || entry.sourcePath.startsWith(`.${path.sep}`) || entry.sourcePath === ".") return entry.sourcePath;
+	return `.${path.sep}${entry.sourcePath}`;
+}
 function buildNpxArgs(manifest, subcommand, extraArgs) {
 	return [
 		"--yes",
@@ -378,6 +404,7 @@ function renderExecFailure(error) {
 	return String(error);
 }
 async function installIntoCurrentRepository(repoPath, manifest, entry, options = {}) {
+	const installReference = toInstallReference(entry);
 	const installPath = path.join(repoPath, ".agents", "skills", entry.originalName);
 	const lockPath = path.join(repoPath, "skills-lock.json");
 	const snapshot = {
@@ -385,11 +412,11 @@ async function installIntoCurrentRepository(repoPath, manifest, entry, options =
 		lockPath,
 		installTree: await snapshotTree(installPath),
 		lockText: await readFileIfExists(lockPath),
-		installReference: entry.sourcePath
+		installReference
 	};
 	try {
 		await execFile$1("npx", buildNpxArgs(manifest, "add", [
-			entry.sourcePath,
+			installReference,
 			"--agent",
 			manifest.installAgent,
 			"--copy",
@@ -407,7 +434,7 @@ async function installIntoCurrentRepository(repoPath, manifest, entry, options =
 	return {
 		installPath,
 		lockPath,
-		installReference: entry.sourcePath,
+		installReference,
 		snapshot
 	};
 }
@@ -524,14 +551,15 @@ async function convertInstalledSkill(_manifest, entry, installState) {
 //#endregion
 //#region src/lib/sync-engine.ts
 async function assertSourceState(entry, allowMissingSources) {
-	if (!await pathExists(entry.sourceRoot)) {
+	if (entry.remoteSource) return { skip: false };
+	if (!await pathExists(entry.resolvedSourceRoot)) {
 		if (allowMissingSources) return {
 			skip: true,
-			reason: `missing source root: ${entry.sourceRoot}`
+			reason: `missing source root: ${entry.resolvedSourceRoot}`
 		};
-		throw new CliError(`Managed source root does not exist: ${entry.sourceRoot}`, { details: ["Use `skillsbase sync --allow-missing-sources` to skip missing roots."] });
+		throw new CliError(`Managed source root does not exist: ${entry.resolvedSourceRoot}`, { details: ["Use `skillsbase sync --allow-missing-sources` to skip missing roots."] });
 	}
-	if (!await pathExists(entry.sourcePath)) throw new CliError(`Managed skill is missing from source root: ${entry.sourcePath}`, { details: [`source: ${entry.sourceKey}`, `skill: ${entry.originalName}`] });
+	if (!await pathExists(entry.resolvedSourcePath)) throw new CliError(`Managed skill is missing from source root: ${entry.resolvedSourcePath}`, { details: [`source: ${entry.sourceKey}`, `skill: ${entry.originalName}`] });
 	return { skip: false };
 }
 async function assertManagedTargetWritable(manifest, entry) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hagicode/skillsbase",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Managed skills repository CLI",
   "homepage": "https://github.com/HagiCode-org/skillsbase#readme",
   "bugs": {

package/templates/actions/skillsbase-sync/action.yml

@@ -26,6 +26,10 @@ runs:
       shell: bash
       run: npm ci
 
+    - name: Install skillsbase
+      shell: bash
+      run: npm install --global @hagicode/skillsbase
+
     - name: Run tests
       if: ${{ inputs.run-tests == 'true' }}
       shell: bash
@@ -33,4 +37,4 @@ runs:
 
     - name: Run sync check
       shell: bash
-      run: node ./bin/skillsbase.mjs sync --check
+      run: skillsbase sync --check --repo .

package/templates/docs/maintainer-workflow.md

@@ -2,7 +2,7 @@
 
 # Maintainer Workflow
 
-结论是：维护流以 `init -> add -> sync -> github_action` 为主。
+The maintainer flow is `init -> add -> sync -> github_action`.
 
 ## Lifecycle
 
@@ -13,8 +13,8 @@
 
 ## Notes
 
-- `sources.yaml` 是单一真相源。
-- `skills/` 仅保存受管输出。
-- `.skill-source.json` 记录来源与转换元数据。
-- `skillsbase sync --check` 只校验，不改仓库。
-- 缺少来源根目录时，可用 `skillsbase sync --allow-missing-sources` 跳过。
+- `sources.yaml` is the single source of truth.
+- `skills/` stores managed output only.
+- `.skill-source.json` records source and conversion metadata.
+- `skillsbase sync --check` validates drift without writing files.
+- If a source root is unavailable, use `skillsbase sync --allow-missing-sources` to skip it.

package/templates/skills/README.md

@@ -2,8 +2,8 @@
 
 # Managed Skills
 
-此目录只存放受管 skill 输出。
+This directory contains managed skill output only.
 
-- 每个 skill 目录必须包含 `SKILL.md`
-- 每个受管目录必须包含 `.skill-source.json`
-- 不要手改受管文件；变更应回到 `sources.yaml` 与上游来源
+- Every skill directory must include `SKILL.md`
+- Every managed directory must include `.skill-source.json`
+- Do not edit managed files by hand; make changes in `sources.yaml` and the upstream source instead

package/templates/workflows/skills-sync.yml

@@ -32,8 +32,11 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
+      - name: Install skillsbase
+        run: npm install --global @hagicode/skillsbase
+
       - name: Run tests
         run: npm test
 
       - name: Validate managed repository state
-        run: node ./bin/skillsbase.mjs sync --check
+        run: skillsbase sync --check --repo .