agent-skills-standard 2.2.2 → 2.2.4

package/dist/index.js

@@ -675,7 +675,10 @@ var DEFAULT_WORKFLOWS = [
 	"codebase-review",
 	"plan-feature",
 	"skill-benchmark",
-	"pentest"
+	"pentest",
+	"dev-fix",
+	"implement-feature",
+	"verify-bug"
 ];
 var getAgentDefinition = (id) => {
 	switch (id) {
@@ -3552,14 +3555,28 @@ var SkillSyncService = class {
 * - none:    Agent has no verified user-invoked command system — skip.
 */
 var WorkflowTransformer = class {
+	static parse(source) {
+		const { description, body } = this.parseSource(source.content);
+		return {
+			key: source.name.replace(/\.md$/, ""),
+			fileName: source.name,
+			description,
+			body,
+			rawContent: source.content
+		};
+	}
 	static transform(source, format, workflowSourcePath = ".agents/workflows") {
+		const parsed = this.parse(source);
+		return this.transformParsed(parsed, format, workflowSourcePath);
+	}
+	static transformParsed(parsed, format, workflowSourcePath = ".agents/workflows") {
 		if (format === "none") return null;
-		const { description, body } = this.parseSource(source.content);
-		const baseName = source.name.replace(/\.md$/, "");
+		const { description, body } = parsed;
+		const baseName = parsed.key;
 		switch (format) {
 			case "native": return {
-				name: source.name,
-				content: source.content
+				name: parsed.fileName,
+				content: parsed.rawContent
 			};
 			case "command": return {
 				name: `${baseName}.md`,
@@ -3637,7 +3654,7 @@ Follow the exact steps in the workflow file.
 	* Agent Skill (SKILL.md) format.
 	* Used by Cursor, Trae, and Codex.
 	* Lives at <workflowPath>/<name>/SKILL.md
-	* User invokes via /<name> in Agent/Skill interface.
+	* Invoked through each platform's skill mechanism.
 	*/
 	static toSkillMarkdown(name, description, body) {
 		return `# ${name.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ")} Skill
@@ -3684,11 +3701,14 @@ var WorkflowSyncService = class {
 				console.log(picocolors.default.yellow(`✨ Workflows Discovered: Adding [${newWorkflows.join(", ")}] to .skillsrc.`));
 				changed = true;
 			}
-		} else if (config.workflows === void 0 || config.workflows === true) {
+		} else if (config.workflows === void 0) {
 			const defaultWorkflows = availableWorkflows.filter((wf) => DEFAULT_WORKFLOWS.includes(wf));
 			config.workflows = defaultWorkflows;
 			console.log(picocolors.default.yellow(`✨ Workflows Initialized: Adding [${defaultWorkflows.join(", ")}] to .skillsrc.`));
 			changed = true;
+		} else if (config.workflows === true) {
+			const newWorkflows = availableWorkflows.filter((wf) => !DEFAULT_WORKFLOWS.includes(wf));
+			if (newWorkflows.length > 0) console.log(picocolors.default.cyan(`ℹ️  Registry has ${availableWorkflows.length} workflows (including ${newWorkflows.length} non-default). Syncing all because 'workflows: true' is set.`));
 		}
 		return changed;
 	}
@@ -3729,15 +3749,18 @@ var WorkflowSyncService = class {
 					content: f.content
 				}))
 			}];
-		}
+		} else if (workflowFiles.length > 0) console.log(picocolors.default.red(`    ❌ Failed to download ${workflowFiles.length} matched workflows.`));
+		else console.log(picocolors.default.gray(`    ℹ️  No matching workflows found in registry.`));
 		return [];
 	}
 	/**
-	* Writes collected workflows to each active agent's native format.
-	* - Antigravity/Kiro: .agents/workflows/*.md (native)
-	* - Claude/Gemini: .<agent>/agents/workflow-*.md (agent definition)
-	* - Cursor/Windsurf/Trae: .<agent>/rules/workflow-*.mdc (rule)
-	* - Copilot: .github/instructions/workflow-*.instructions.md (instruction)
+	* Writes collected workflows from `.agents/workflows/*.md` to each active
+	* agent's native invocation surface.
+	* - Antigravity/Kiro: keep native markdown workflows
+	* - Claude/Roo/OpenCode: markdown command files
+	* - Gemini: TOML command files
+	* - Copilot: prompt files
+	* - Cursor/Trae/Codex: skill folders with SKILL.md
 	*/
 	async writeWorkflows(workflows, config, agents) {
 		if (workflows.length === 0) return;
@@ -3748,16 +3771,17 @@ var WorkflowSyncService = class {
 			if (!agentDef || agentDef.workflowFormat === "none") continue;
 			const workflowDir = path.default.join(process.cwd(), agentDef.workflowPath);
 			await fs_extra.default.ensureDir(workflowDir);
-			const skillsDir = path.default.join(process.cwd(), agentDef.path);
-			const skillsRelative = path.default.relative(workflowDir, skillsDir);
+			const sourceWorkflowDir = path.default.join(process.cwd(), ".agents/workflows");
+			const workflowSourceRelative = path.default.relative(workflowDir, sourceWorkflowDir);
 			let written = 0;
 			for (const wf of workflows) {
 				if (wf.skill !== "workflows") continue;
 				for (const fileItem of wf.files) {
-					const transformed = WorkflowTransformer.transform({
+					const parsed = WorkflowTransformer.parse({
 						name: fileItem.name,
 						content: fileItem.content
-					}, agentDef.workflowFormat, skillsRelative);
+					});
+					const transformed = WorkflowTransformer.transformParsed(parsed, agentDef.workflowFormat, workflowSourceRelative);
 					if (!transformed) continue;
 					let targetFilePath;
 					if (agentDef.workflowFormat === "skill") {
@@ -3887,6 +3911,97 @@ var SpecialistSyncService = class {
 	}
 };
 //#endregion
+//#region src/services/GitService.ts
+/**
+* Service for handling Git operations within the project.
+* Provides a clean interface for querying changed and untracked files.
+*/
+var GitService = class {
+	/**
+	* Finds the root of the project by looking for .git or pnpm-workspace.yaml.
+	*/
+	findProjectRoot(startDir = process.cwd()) {
+		let currentDir = startDir;
+		while (currentDir !== path.default.parse(currentDir).root) {
+			if (fs_extra.default.existsSync(path.default.join(currentDir, "pnpm-workspace.yaml")) || fs_extra.default.existsSync(path.default.join(currentDir, ".git"))) return currentDir;
+			currentDir = path.default.dirname(currentDir);
+		}
+		return startDir;
+	}
+	/**
+	* Retrieves a list of files that have changed compared to the base branch or HEAD.
+	* Handles both CI (GitHub Actions) and local development environments.
+	* @param rootDir The root directory of the repository
+	* @returns Array of relative file paths
+	*/
+	getChangedFiles(rootDir) {
+		try {
+			if (process.env.GITHUB_BASE_REF) {
+				const baseRef = process.env.GITHUB_BASE_REF;
+				if (!/^[\w./:-]+$/.test(baseRef)) {
+					if (process.env.DEBUG) console.warn("GITHUB_BASE_REF contains unsafe characters; skipping CI diff.");
+					return [];
+				}
+				try {
+					(0, child_process.execFileSync)("git", [
+						"fetch",
+						"origin",
+						baseRef,
+						"--depth=1"
+					], {
+						cwd: rootDir,
+						stdio: "ignore"
+					});
+				} catch {}
+				return (0, child_process.execFileSync)("git", [
+					"diff",
+					"--name-only",
+					`origin/${baseRef}...HEAD`
+				], {
+					cwd: rootDir,
+					encoding: "utf8"
+				}).split("\n").map((f) => f.trim()).filter((f) => f !== "" && fs_extra.default.existsSync(path.default.join(rootDir, f)));
+			} else return (0, child_process.execSync)("git diff --name-only HEAD", {
+				cwd: rootDir,
+				encoding: "utf8"
+			}).split("\n").map((f) => f.trim()).filter((f) => f !== "" && fs_extra.default.existsSync(path.default.join(rootDir, f)));
+		} catch (error) {
+			if (process.env.DEBUG) console.warn("Git failure while getting changed files:", error);
+			return [];
+		}
+	}
+	/**
+	* Retrieves a list of untracked files in the repository.
+	* @param rootDir The root directory of the repository
+	* @returns Array of relative file paths
+	*/
+	getUntrackedFiles(rootDir) {
+		try {
+			return (0, child_process.execSync)("git ls-files --others --exclude-standard", {
+				cwd: rootDir,
+				encoding: "utf8"
+			}).split("\n").map((f) => f.trim()).filter((f) => f !== "" && fs_extra.default.existsSync(path.default.join(rootDir, f)));
+		} catch (error) {
+			if (process.env.DEBUG) console.warn("Git failure while getting untracked files:", error);
+			return [];
+		}
+	}
+	/**
+	* Retrieves the URL of the 'origin' remote.
+	* @param rootDir The root directory of the repository
+	*/
+	getRemoteUrl(rootDir) {
+		try {
+			return (0, child_process.execSync)("git remote get-url origin", {
+				cwd: rootDir,
+				encoding: "utf8"
+			}).trim();
+		} catch {
+			return null;
+		}
+	}
+};
+//#endregion
 //#region src/services/utils/MarkdownUtils.ts
 /**
 * Utility functions for manipulating markdown content
@@ -3933,6 +4048,7 @@ var SyncService = class {
 	skillSyncService = new SkillSyncService(this.githubService);
 	workflowSyncService = new WorkflowSyncService(this.githubService);
 	specialistSyncService = new SpecialistSyncService();
+	gitService = new GitService();
 	async reconcileConfig(config, projectDeps) {
 		const reenabled = this.configService.reconcileDependencies(config, projectDeps);
 		if (reenabled.length > 0) {
@@ -3946,8 +4062,19 @@ var SyncService = class {
 		return this.workflowSyncService.reconcileWorkflows(config);
 	}
 	async assembleSkills(categories, config) {
+		await this.warnIfSyncingFromSameRepo(config);
 		return this.skillSyncService.assembleSkills(categories, config);
 	}
+	async warnIfSyncingFromSameRepo(config) {
+		const remoteUrl = this.gitService.getRemoteUrl(process.cwd());
+		if (!remoteUrl) return;
+		const remoteMatch = GithubService.parseGitHubUrl(remoteUrl);
+		const registryMatch = GithubService.parseGitHubUrl(config.registry);
+		if (remoteMatch && registryMatch && remoteMatch.owner === registryMatch.owner && remoteMatch.repo === registryMatch.repo) {
+			console.log(picocolors.default.yellow(`\n⚠️  Note: You are syncing from the registry repository itself (${remoteMatch.owner}/${remoteMatch.repo}).`));
+			console.log(picocolors.default.gray(`   'ags sync' pulls from GitHub. If you have unpushed local changes, they will be overwritten by the remote versions.`));
+		}
+	}
 	async writeSkills(skills, config) {
 		await this.cleanupOldFolders();
 		const agents = await this.resolveTargetAgents(config);
@@ -4243,7 +4370,7 @@ var SyncCommand = class {
 };
 var package_default = {
 	name: "agent-skills-standard",
-	version: "2.2.2",
+	version: "2.2.4",
 	description: "A CLI to manage and sync AI agent skills standard for Cursor, Claude, Copilot, Windsurf, and more.",
 	main: "dist/index.js",
 	bin: {
@@ -4319,6 +4446,10 @@ var UpgradeCommand = class {
 			console.log(picocolors.default.red("❌ Could not determine latest version."));
 			return;
 		}
+		if (!/^\d+\.\d+\.\d+(-[a-zA-Z0-9.]+)?(\+[a-zA-Z0-9.]+)?$/.test(latestVersion)) {
+			console.log(picocolors.default.red(`❌ Invalid version received from npm: ${latestVersion}`));
+			return;
+		}
 		console.log(picocolors.default.gray(`  Current version: ${currentVersion}`));
 		console.log(picocolors.default.gray(`  Latest version:  ${latestVersion}`));
 		if (currentVersion === latestVersion) {
@@ -4330,16 +4461,27 @@ var UpgradeCommand = class {
 			return;
 		}
 		const pm = this.detectPackageManager();
-		const upgradeCmd = this.getUpgradeCommand(pm);
+		const upgradeCmd = this.getUpgradeCommand(pm, latestVersion);
 		console.log(picocolors.default.yellow(`📦 Upgrading to v${latestVersion} using ${pm}...`));
 		try {
 			console.log(picocolors.default.gray(`  Running: ${upgradeCmd}`));
 			(0, child_process.execSync)(upgradeCmd, { stdio: "inherit" });
-			console.log(picocolors.default.green(`✅ Successfully upgraded to v${latestVersion}!`));
+			try {
+				const lines = (0, child_process.execSync)("ags -V", { encoding: "utf8" }).trim().split("\n");
+				const installedVersion = lines[lines.length - 1].trim();
+				if (installedVersion === latestVersion) console.log(picocolors.default.green(`✅ Successfully upgraded to v${latestVersion}!`));
+				else {
+					console.log("\n" + picocolors.default.yellow(`⚠️  Install finished, but 'ags -V' still reports v${installedVersion}.`));
+					console.log(picocolors.default.gray("   This is likely due to package manager caching or a PATH conflict."));
+					console.log(picocolors.default.cyan(`👉 Recommendation: Run '${picocolors.default.bold(upgradeCmd + " --force")}' manually.`));
+				}
+			} catch {
+				console.log(picocolors.default.green(`✅ Install command completed.`));
+			}
 			console.log(picocolors.default.cyan("Please restart your terminal if the version doesn't update immediately."));
 		} catch {
 			console.log("\n" + picocolors.default.red("❌ Automatic upgrade failed."));
-			this.printManualInstructions(pm);
+			this.printManualInstructions(pm, latestVersion);
 		}
 	}
 	detectPackageManager() {
@@ -4358,104 +4500,27 @@ var UpgradeCommand = class {
 			}
 		}
 	}
-	getUpgradeCommand(pm) {
+	getUpgradeCommand(pm, version) {
 		switch (pm) {
-			case "pnpm": return "pnpm add -g agent-skills-standard@latest";
-			case "yarn": return "yarn global add agent-skills-standard@latest";
-			default: return "npm install -g agent-skills-standard@latest";
+			case "pnpm": return `pnpm add -g agent-skills-standard@${version}`;
+			case "yarn": return `yarn global add agent-skills-standard@${version}`;
+			default: return `npm install -g agent-skills-standard@${version}`;
 		}
 	}
-	printManualInstructions(pm) {
+	printManualInstructions(pm, version) {
 		const sudoPrefix = process.platform === "win32" ? "" : "sudo ";
 		console.log(picocolors.default.yellow("Possible reasons:"));
 		console.log(picocolors.default.gray(" - Permission denied (requires sudo/administrator)"));
 		console.log(picocolors.default.gray(" - Network connectivity issues"));
 		console.log(picocolors.default.gray(` - ${pm} is not configured for global installs`));
 		console.log("\n" + picocolors.default.cyan("👉 Please run the following command manually:"));
-		console.log(picocolors.default.white(picocolors.default.bold(`  ${sudoPrefix}${this.getUpgradeCommand(pm)}`)));
+		console.log(picocolors.default.white(picocolors.default.bold(`  ${sudoPrefix}${this.getUpgradeCommand(pm, version)}`)));
 		if (pm !== "npm") {
 			console.log(picocolors.default.gray("\nAlternative (npm):"));
-			console.log(picocolors.default.gray(`  ${sudoPrefix}npm install -g agent-skills-standard@latest`));
+			console.log(picocolors.default.gray(`  ${sudoPrefix}npm install -g agent-skills-standard@${version}`));
 		}
 		console.log(picocolors.default.gray("\nOr run via npx (no install required):"));
-		console.log(picocolors.default.gray(`  npx agent-skills-standard@latest sync`));
-	}
-};
-//#endregion
-//#region src/services/GitService.ts
-/**
-* Service for handling Git operations within the project.
-* Provides a clean interface for querying changed and untracked files.
-*/
-var GitService = class {
-	/**
-	* Finds the root of the project by looking for .git or pnpm-workspace.yaml.
-	*/
-	findProjectRoot(startDir = process.cwd()) {
-		let currentDir = startDir;
-		while (currentDir !== path.default.parse(currentDir).root) {
-			if (fs_extra.default.existsSync(path.default.join(currentDir, "pnpm-workspace.yaml")) || fs_extra.default.existsSync(path.default.join(currentDir, ".git"))) return currentDir;
-			currentDir = path.default.dirname(currentDir);
-		}
-		return startDir;
-	}
-	/**
-	* Retrieves a list of files that have changed compared to the base branch or HEAD.
-	* Handles both CI (GitHub Actions) and local development environments.
-	* @param rootDir The root directory of the repository
-	* @returns Array of relative file paths
-	*/
-	getChangedFiles(rootDir) {
-		try {
-			if (process.env.GITHUB_BASE_REF) {
-				const baseRef = process.env.GITHUB_BASE_REF;
-				if (!/^[\w./:-]+$/.test(baseRef)) {
-					if (process.env.DEBUG) console.warn("GITHUB_BASE_REF contains unsafe characters; skipping CI diff.");
-					return [];
-				}
-				try {
-					(0, child_process.execFileSync)("git", [
-						"fetch",
-						"origin",
-						baseRef,
-						"--depth=1"
-					], {
-						cwd: rootDir,
-						stdio: "ignore"
-					});
-				} catch {}
-				return (0, child_process.execFileSync)("git", [
-					"diff",
-					"--name-only",
-					`origin/${baseRef}...HEAD`
-				], {
-					cwd: rootDir,
-					encoding: "utf8"
-				}).split("\n").map((f) => f.trim()).filter((f) => f !== "" && fs_extra.default.existsSync(path.default.join(rootDir, f)));
-			} else return (0, child_process.execSync)("git diff --name-only HEAD", {
-				cwd: rootDir,
-				encoding: "utf8"
-			}).split("\n").map((f) => f.trim()).filter((f) => f !== "" && fs_extra.default.existsSync(path.default.join(rootDir, f)));
-		} catch (error) {
-			if (process.env.DEBUG) console.warn("Git failure while getting changed files:", error);
-			return [];
-		}
-	}
-	/**
-	* Retrieves a list of untracked files in the repository.
-	* @param rootDir The root directory of the repository
-	* @returns Array of relative file paths
-	*/
-	getUntrackedFiles(rootDir) {
-		try {
-			return (0, child_process.execSync)("git ls-files --others --exclude-standard", {
-				cwd: rootDir,
-				encoding: "utf8"
-			}).split("\n").map((f) => f.trim()).filter((f) => f !== "" && fs_extra.default.existsSync(path.default.join(rootDir, f)));
-		} catch (error) {
-			if (process.env.DEBUG) console.warn("Git failure while getting untracked files:", error);
-			return [];
-		}
+		console.log(picocolors.default.gray(`  npx agent-skills-standard@${version} sync`));
 	}
 };
 //#endregion
@@ -4787,7 +4852,7 @@ var ValidateCommand = class {
 //#region src/index.ts
 dotenv.default.config();
 var program = new commander.Command();
-program.name("agent-skills-standard").description("A CLI to manage and sync AI agent skills for Cursor, Claude, Copilot, Windsurf, and more.").version("2.2.2");
+program.name("agent-skills-standard").description("A CLI to manage and sync AI agent skills for Cursor, Claude, Copilot, Windsurf, and more.").version("2.2.4");
 program.command("init").description("Initialize a .skillsrc configuration file interactively").action(async () => {
 	await new InitCommand().run();
 });