@keystrokehq/cli 0.1.24 → 0.1.25

package/dist/index.mjs

@@ -4,12 +4,11 @@ import { i as packProjectArtifact, n as withMcpReadClient, r as mergeFilteredArt
 import { a as installPlaygroundDependencies, c as createCliConfig, d as getEffectiveApiTarget, f as getPlatformUrl, g as resolvePlatformUrlForWebUrl, i as installDependencies$1, l as getCliConfigDir, m as DEFAULT_PLATFORM_URL, n as buildPlaygroundWorkspace, o as resolvePackageManager, p as getWebUrl, s as resolveCliRoot, t as readCliVersion, u as getConfigDir } from "./version-DcR3O1UD.mjs";
 import { createRequire } from "node:module";
 import { Command } from "commander";
-import { platform } from "node:os";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { Entry } from "@napi-rs/keyring";
 import { confirm, input, select } from "@inquirer/prompts";
 import { existsSync, lstatSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
-import { access, copyFile, cp, lstat, mkdir, readFile, readdir, rm, stat, symlink, unlink, writeFile } from "node:fs/promises";
+import { access, copyFile, lstat, mkdir, readFile, readdir, rm, stat, symlink, unlink, writeFile } from "node:fs/promises";
 import { spawn, spawnSync } from "node:child_process";
 import { pathToFileURL } from "node:url";
 //#region ../../node_modules/.pnpm/ky@2.0.2/node_modules/ky/distribution/errors/KyError.js
@@ -6864,6 +6863,26 @@ async function applyPlaygroundManifest(targetDir, projectName, monorepoRoot) {
 	await writeFile(tsconfigPath, `${JSON.stringify(tsconfig, null, 2)}\n`);
 }
 //#endregion
+//#region src/skills/agents-guide-version.ts
+const BUNDLE_VERSION_FILENAME = ".bundle-version";
+const LEGACY_BUNDLE_VERSION_RELATIVE_PATH = join("skills", BUNDLE_VERSION_FILENAME);
+function agentsGuideDir(projectRoot) {
+	return join(projectRoot, ".agents");
+}
+function bundleVersionPath(projectRoot) {
+	return join(agentsGuideDir(projectRoot), BUNDLE_VERSION_FILENAME);
+}
+async function readBundleVersion(projectRoot) {
+	for (const path of [bundleVersionPath(projectRoot), join(agentsGuideDir(projectRoot), LEGACY_BUNDLE_VERSION_RELATIVE_PATH)]) try {
+		return (await readFile(path, "utf8")).trim();
+	} catch {}
+	return null;
+}
+async function writeBundleVersion(projectRoot) {
+	await mkdir(agentsGuideDir(projectRoot), { recursive: true });
+	await writeFile(bundleVersionPath(projectRoot), `${readCliVersion()}\n`);
+}
+//#endregion
 //#region src/skills/resolve-skills-bundle-dir.ts
 const SKILLS_BUNDLE = "skills-bundle";
 function resolveSkillsBundleDir(fromModuleUrl = import.meta.url) {
@@ -6875,53 +6894,26 @@ function resolveSkillsBundleDir(fromModuleUrl = import.meta.url) {
 		join(cliRoot, SKILLS_BUNDLE)
 	];
 	for (const candidate of candidates) if (existsSync(join(candidate, "_AGENTS.md"))) return candidate;
-	throw new Error("Bundled keystroke skills not found — run `pnpm --filter @keystrokehq/cli build`");
+	throw new Error("Bundled AGENTS guide not found — run `pnpm --filter @keystrokehq/cli build`");
 }
 //#endregion
-//#region src/skills/sync-bundled-skills.ts
-const BUNDLE_VERSION_FILENAME = ".bundle-version";
-function agentsSkillsDir(projectRoot) {
-	return join(projectRoot, ".agents", "skills");
-}
-function bundleVersionPath(projectRoot) {
-	return join(agentsSkillsDir(projectRoot), BUNDLE_VERSION_FILENAME);
-}
-async function readBundleVersion(projectRoot) {
-	try {
-		return (await readFile(bundleVersionPath(projectRoot), "utf8")).trim();
-	} catch {
-		return null;
-	}
-}
-async function ensureSymlink(target, linkPath, kind) {
+//#region src/skills/scaffold-agents-guide.ts
+async function ensureSymlink(target, linkPath) {
 	await mkdir(dirname(linkPath), { recursive: true });
 	await rm(linkPath, {
 		recursive: true,
 		force: true
 	});
-	await symlink(target, linkPath, platform() === "win32" && kind === "dir" ? "junction" : kind);
+	await symlink(target, linkPath, "file");
 }
-/** Overwrites `.agents/skills/`, AGENTS.md, and recreates `.claude` symlinks from the CLI bundle. */
-async function syncBundledSkills(projectRoot, fromModuleUrl = import.meta.url) {
+/** Writes AGENTS.md from the CLI bundle and recreates the CLAUDE.md symlink. */
+async function scaffoldAgentsGuide(projectRoot, fromModuleUrl = import.meta.url) {
 	const bundleDir = resolveSkillsBundleDir(fromModuleUrl);
-	const skillsDir = agentsSkillsDir(projectRoot);
 	const agentsMdPath = join(projectRoot, "AGENTS.md");
-	await mkdir(join(projectRoot, ".agents"), { recursive: true });
-	if ((await lstat(skillsDir).catch(() => null))?.isSymbolicLink()) {
-		await rm(skillsDir, { force: true });
-		await cp(join(bundleDir, "skills"), skillsDir, { recursive: true });
-	} else {
-		await mkdir(skillsDir, { recursive: true });
-		await cp(join(bundleDir, "skills"), skillsDir, {
-			recursive: true,
-			force: true
-		});
-	}
 	if ((await lstat(agentsMdPath).catch(() => null))?.isSymbolicLink()) await rm(agentsMdPath, { force: true });
 	await writeFile(agentsMdPath, await readFile(join(bundleDir, "_AGENTS.md"), "utf8"));
-	await ensureSymlink(relative(dirname(join(projectRoot, ".claude", "skills")), skillsDir), join(projectRoot, ".claude", "skills"), "dir");
-	await ensureSymlink(relative(dirname(join(projectRoot, "CLAUDE.md")), agentsMdPath), join(projectRoot, "CLAUDE.md"), "file");
-	await writeFile(bundleVersionPath(projectRoot), `${readCliVersion()}\n`);
+	await ensureSymlink(relative(dirname(join(projectRoot, "CLAUDE.md")), agentsMdPath), join(projectRoot, "CLAUDE.md"));
+	await writeBundleVersion(projectRoot);
 }
 //#endregion
 //#region src/init/scaffold-empty-src-dirs.ts
@@ -7022,7 +7014,7 @@ async function runInit(options) {
 	}
 	if (playgroundRoot) await applyPlaygroundManifest(targetDir, projectName, playgroundRoot);
 	else await scaffoldProjectDotfiles(targetDir);
-	await syncBundledSkills(targetDir);
+	await scaffoldAgentsGuide(targetDir);
 	await copyFile(join(targetDir, ".env.example"), join(targetDir, ".env"));
 	if (!options.skipInstall) if (playgroundRoot) {
 		installPlaygroundDependencies(targetDir);
@@ -7523,7 +7515,7 @@ async function runPull(options) {
 	}
 	await writeSourceTree(targetDir, source.files);
 	installDependencies(targetDir, detectProjectPackageManagerFromSnapshot(source.files));
-	await syncBundledSkills(targetDir);
+	await scaffoldAgentsGuide(targetDir);
 	await writePullState({
 		targetDir,
 		projectId: options.projectId,
@@ -8062,20 +8054,20 @@ function registerSkillCommand(program) {
 //#endregion
 //#region src/commands/skills.ts
 function registerSkillsCommand(program) {
-	program.command("skills").description("Manage bundled agent skills").command("sync").description("Overwrite bundled skills and AGENTS.md with the CLI version").option("--dir <path>", "Project directory", process.cwd()).action(async (options) => {
+	program.command("skills").description("Manage the scaffolded AGENTS guide").command("sync").description("Overwrite AGENTS.md with the CLI version").option("--dir <path>", "Project directory", process.cwd()).action(async (options) => {
 		try {
 			const root = resolveProjectRoot(options.dir);
-			await syncBundledSkills(root);
-			process.stdout.write(`Synced bundled skills at ${root}\n`);
+			await scaffoldAgentsGuide(root);
+			process.stdout.write(`Synced AGENTS.md at ${root}\n`);
 		} catch (error) {
-			const message = error instanceof Error ? error.message : "Skills sync failed";
+			const message = error instanceof Error ? error.message : "AGENTS guide sync failed";
 			process.stderr.write(`${message}\n`);
 			process.exitCode = 1;
 		}
 	});
 }
 //#endregion
-//#region src/skills/sync-skills.ts
+//#region src/skills/sync-agents-guide.ts
 function commandPath(command) {
 	const names = [];
 	for (let current = command; current; current = current.parent) {
@@ -8094,18 +8086,20 @@ function shouldSkipAutoSync(command) {
 function resolveAutoSyncRoot(command) {
 	return resolveKeystrokeConfigRoot(command.opts().dir ?? process.cwd());
 }
-/** Sync bundled skills when stale; no-op when not in a project or already up to date. */
-async function syncSkills(command) {
+/** Sync AGENTS.md when stale; no-op when not in a project or already up to date. */
+async function syncAgentsGuide(command) {
 	if (shouldSkipAutoSync(command)) return;
 	const projectRoot = resolveAutoSyncRoot(command);
 	if (!projectRoot) return;
-	const skillsDir = agentsSkillsDir(projectRoot);
-	if (!existsSync(skillsDir)) return;
-	if (lstatSync(skillsDir).isSymbolicLink()) return;
+	const agentsMdPath = join(projectRoot, "AGENTS.md");
+	if (!existsSync(agentsMdPath)) return;
+	if (lstatSync(agentsMdPath).isSymbolicLink()) return;
+	const legacySkillsDir = join(agentsGuideDir(projectRoot), "skills");
+	if (existsSync(legacySkillsDir) && lstatSync(legacySkillsDir).isSymbolicLink()) return;
 	const currentVersion = readCliVersion();
 	if (await readBundleVersion(projectRoot) === currentVersion) return;
-	await syncBundledSkills(projectRoot);
-	process.stderr.write(`Synced bundled skills to ${currentVersion}\n`);
+	await scaffoldAgentsGuide(projectRoot);
+	process.stderr.write(`Synced AGENTS.md to ${currentVersion}\n`);
 }
 //#endregion
 //#region src/program.ts
@@ -8116,7 +8110,7 @@ function createProgram() {
 			projectId: opts.project,
 			local: opts.local
 		});
-		await syncSkills(actionCommand);
+		await syncAgentsGuide(actionCommand);
 	});
 	registerAuthCommand(program);
 	registerConnectCommand(program);