@keystrokehq/cli 0.0.115 → 0.0.116

package/dist/index.mjs

@@ -8,11 +8,11 @@ import Conf from "conf";
 import { homedir, platform, tmpdir } from "node:os";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { confirm, input, select } from "@inquirer/prompts";
-import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { spawn, spawnSync } from "node:child_process";
 import { createHash } from "node:crypto";
 import { pathToFileURL } from "node:url";
-import { access, copyFile, cp, mkdir, readFile, readdir, stat, symlink, unlink, writeFile } from "node:fs/promises";
+import { access, copyFile, cp, lstat, mkdir, readFile, readdir, rm, stat, symlink, unlink, writeFile } from "node:fs/promises";
 //#region ../../node_modules/.pnpm/ky@2.0.2/node_modules/ky/distribution/errors/KyError.js
 /**
 Base class for all Ky-specific errors. `HTTPError`, `NetworkError`, `TimeoutError`, and `ForceRetryError` extend this class.
@@ -9916,7 +9916,7 @@ async function applyPlaygroundManifest(targetDir, projectName, monorepoRoot) {
 	await writeFile(tsconfigPath, `${JSON.stringify(tsconfig, null, 2)}\n`);
 }
 //#endregion
-//#region src/init/resolve-skills-bundle-dir.ts
+//#region src/skills/resolve-skills-bundle-dir.ts
 const SKILLS_BUNDLE = "skills-bundle";
 function resolveSkillsBundleDir(fromModuleUrl = import.meta.url) {
 	const cliRoot = resolveCliRoot(fromModuleUrl);
@@ -9930,23 +9930,50 @@ function resolveSkillsBundleDir(fromModuleUrl = import.meta.url) {
 	throw new Error("Bundled keystroke skills not found — run `pnpm --filter @keystrokehq/cli build`");
 }
 //#endregion
-//#region src/init/scaffold-bundled-skills.ts
-async function linkPath(target, linkPath, kind) {
+//#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) {
 	await mkdir(dirname(linkPath), { recursive: true });
+	await rm(linkPath, {
+		recursive: true,
+		force: true
+	});
 	await symlink(target, linkPath, platform() === "win32" && kind === "dir" ? "junction" : kind);
 }
-/** Copy bundled skills into `.agents/skills/` and scaffold root agent docs. */
-async function scaffoldBundledSkills(targetDir, fromModuleUrl = import.meta.url) {
+/** Overwrites `.agents/skills/`, AGENTS.md, and recreates `.claude` symlinks from the CLI bundle. */
+async function syncBundledSkills(projectRoot, fromModuleUrl = import.meta.url) {
 	const bundleDir = resolveSkillsBundleDir(fromModuleUrl);
-	const agentsSkillsDir = join(targetDir, ".agents", "skills");
-	const agentsMdPath = join(targetDir, "AGENTS.md");
-	await mkdir(agentsSkillsDir, { recursive: true });
-	await cp(join(bundleDir, "skills"), agentsSkillsDir, { recursive: true });
+	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"));
-	const claudeSkillsLink = join(targetDir, ".claude", "skills");
-	await linkPath(relative(dirname(claudeSkillsLink), agentsSkillsDir), claudeSkillsLink, "dir");
-	const claudeMdLink = join(targetDir, "CLAUDE.md");
-	await linkPath(relative(dirname(claudeMdLink), agentsMdPath), claudeMdLink, "file");
+	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`);
 }
 //#endregion
 //#region src/init/scaffold-empty-src-dirs.ts
@@ -10014,7 +10041,7 @@ async function runInit(options) {
 	await scaffoldEmptySrcDirs(targetDir);
 	if (playgroundRoot) await applyPlaygroundManifest(targetDir, projectName, playgroundRoot);
 	else await scaffoldProjectDotfiles(targetDir);
-	await scaffoldBundledSkills(targetDir);
+	await syncBundledSkills(targetDir);
 	await copyFile(join(targetDir, ".env.example"), join(targetDir, ".env"));
 	if (!options.skipInstall) if (playgroundRoot) {
 		installPlaygroundDependencies(targetDir);
@@ -10339,14 +10366,76 @@ function registerConfigCommand(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) => {
+		try {
+			const root = resolveProjectRoot(options.dir);
+			await syncBundledSkills(root);
+			process.stdout.write(`Synced bundled skills at ${root}\n`);
+		} catch (error) {
+			const message = error instanceof Error ? error.message : "Skills sync failed";
+			process.stderr.write(`${message}\n`);
+			process.exitCode = 1;
+		}
+	});
+}
+//#endregion
+//#region src/project/resolve-keystroke-config-root.ts
+const KEYSTROKE_CONFIG = "keystroke.config.ts";
+/** Walk up from `fromDir` and return the directory containing `keystroke.config.ts`, if any. */
+function resolveKeystrokeConfigRoot(fromDir = process.cwd()) {
+	let dir = resolve(fromDir);
+	while (dir !== dirname(dir)) {
+		if (existsSync(join(dir, KEYSTROKE_CONFIG))) return dir;
+		dir = dirname(dir);
+	}
+	if (existsSync(join(dir, KEYSTROKE_CONFIG))) return dir;
+	return null;
+}
+//#endregion
+//#region src/skills/sync-skills.ts
+function commandPath(command) {
+	const names = [];
+	for (let current = command; current; current = current.parent) {
+		const name = current.name();
+		if (name && name !== "keystroke") names.unshift(name);
+	}
+	return names;
+}
+function shouldSkipAutoSync(command) {
+	if (process.env.CI === "true" || process.env.CI === "1") return true;
+	const path = commandPath(command);
+	if (path[0] === "init") return true;
+	if (path[0] === "skills") return true;
+	return false;
+}
+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) {
+	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 currentVersion = readCliVersion();
+	if (await readBundleVersion(projectRoot) === currentVersion) return;
+	await syncBundledSkills(projectRoot);
+	process.stderr.write(`Synced bundled skills to ${currentVersion}\n`);
+}
+//#endregion
 //#region src/program.ts
 function createProgram() {
-	const program = new Command().name("keystroke").description("Build, run, and manage keystroke projects").version(readCliVersion()).option("--project <id>", "Platform project id (deploy target or one-off API target)").option("--local", "Force local keystroke server URL").hook("preAction", (thisCommand) => {
+	const program = new Command().name("keystroke").description("Build, run, and manage keystroke projects").version(readCliVersion()).option("--project <id>", "Platform project id (deploy target or one-off API target)").option("--local", "Force local keystroke server URL").hook("preAction", async (thisCommand, actionCommand) => {
 		const opts = thisCommand.opts();
 		setCliTargetOptions({
 			projectId: opts.project,
 			local: opts.local
 		});
+		await syncSkills(actionCommand);
 	});
 	registerAuthCommand(program);
 	registerConnectCommand(program);
@@ -10355,6 +10444,7 @@ function createProgram() {
 	registerCredentialsCommand(program);
 	registerHealthCommand(program);
 	registerInitCommand(program);
+	registerSkillsCommand(program);
 	registerBuildCommand(program);
 	registerDeployCommand(program);
 	registerDevCommand(program);