@fluid-app/fluid-cli-theme-dev 0.1.22 → 0.1.24

package/README.md

@@ -84,6 +84,20 @@ Interactively select a route and open it in the browser (requires a running dev
 fluid theme navigate
 ```
 
+### `fluid theme skills install`
+
+Copy the bundled theme AI skills (e.g. `themes-review`) into the current directory so an
+agent can load them. Defaults to `.agents/skills/`, the tool-neutral convention for agent
+skills:
+
+```bash
+fluid theme skills install                      # → .agents/skills/
+fluid theme skills install --dir .claude/skills # custom location
+fluid theme skills install --force              # overwrite existing skills without prompting
+```
+
+Existing skills are left untouched unless you confirm the overwrite (or pass `--force`).
+
 ## Theme Directory Structure
 
 A valid theme directory must contain at least one of: `templates/`, `assets/`, or `config/`.

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { Command } from "commander";
 import { getAuthToken, readConfig, updateConfig } from "@fluid-app/fluid-cli";
-import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { createHash } from "node:crypto";
 import http from "node:http";
@@ -10,6 +10,7 @@ import chalk from "chalk";
 import prompts from "prompts";
 import ora from "ora";
 import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
 //#region ../../platform/api-client-core/src/fetch-client.ts
 /**
 * API Error class compatible with fluid-admin's ApiError
@@ -2369,15 +2370,171 @@ function createNavigateCommand() {
 	});
 }
 //#endregion
+//#region src/skills/install.ts
+function listSkillNames(skillsDir) {
+	if (!existsSync(skillsDir)) return [];
+	return readdirSync(skillsDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter((name) => existsSync(join(skillsDir, name, "SKILL.md"))).sort();
+}
+async function installSkills(options) {
+	const { sourceDir, targetRoot, force, confirmOverwrite, onLeftover } = options;
+	const installed = [];
+	const skipped = [];
+	mkdirSync(targetRoot, { recursive: true });
+	for (const name of listSkillNames(sourceDir)) {
+		const from = join(sourceDir, name);
+		const to = join(targetRoot, name);
+		if (existsSync(to) && !force && !await confirmOverwrite(name)) {
+			skipped.push(name);
+			continue;
+		}
+		const leftover = replaceDirectory(from, to);
+		if (leftover !== null) onLeftover(leftover);
+		installed.push(name);
+	}
+	return {
+		installed,
+		skipped
+	};
+}
+/**
+* Replace `target` with a fresh copy of `source` without ever leaving `target`
+* missing or partially written.
+*
+* Filesystem copies are not atomic, so a naive "delete then copy" loses the
+* original if the copy fails (permissions, no disk space, an interrupted
+* process). This stages the copy in a sibling directory and only swaps it into
+* place once it has fully succeeded; an existing `target` is moved aside to a
+* sibling backup first and restored if the swap fails. Because the whole
+* directory is replaced, files removed or renamed in `source` do not linger.
+*
+* Staging and backup directories live beside `target`, so its parent must
+* already exist and be on the same filesystem — that keeps the swap a cheap,
+* atomic rename rather than a cross-device copy.
+*
+* Not safe against a second process racing on the same `target`; intended for
+* single-process CLI use.
+*
+* @returns the path of a leftover backup directory that could not be removed
+* after an otherwise-successful replace (the previous contents are retained
+* there for manual cleanup), or `null` when nothing was left behind. The caller
+* should surface a non-null result so the leftover isn't silently hidden.
+*/
+function replaceDirectory(source, target) {
+	const staging = reserveSiblingPath(target, "staging");
+	try {
+		cpSync(source, staging, { recursive: true });
+	} catch (error) {
+		removeQuietly(staging);
+		throw error;
+	}
+	if (!existsSync(target)) return swapIntoPlace(staging, target, null);
+	const backup = reserveSiblingPath(target, "backup");
+	try {
+		renameSync(target, backup);
+	} catch (error) {
+		removeQuietly(staging);
+		throw error;
+	}
+	return swapIntoPlace(staging, target, backup);
+}
+function swapIntoPlace(staging, target, backup) {
+	try {
+		renameSync(staging, target);
+	} catch (error) {
+		if (backup !== null) restoreBackup(backup, target, error);
+		removeQuietly(staging);
+		throw error;
+	}
+	return removeQuietly(backup);
+}
+function restoreBackup(backup, target, cause) {
+	try {
+		renameSync(backup, target);
+	} catch {
+		throw new Error(`Failed to replace ${target}; its previous contents are preserved at ${backup}.`, { cause });
+	}
+}
+function removeQuietly(path) {
+	if (path === null) return null;
+	try {
+		rmSync(path, {
+			recursive: true,
+			force: true
+		});
+		return null;
+	} catch {
+		return path;
+	}
+}
+function reserveSiblingPath(basePath, label) {
+	let candidate = `${basePath}.${label}`;
+	for (let n = 1; existsSync(candidate); n += 1) candidate = `${basePath}.${label}.${n}`;
+	return candidate;
+}
+//#endregion
+//#region src/commands/skills.ts
+const DEFAULT_TARGET_DIR = ".agents/skills";
+function resolveBundledSkillsDir() {
+	const here = dirname(fileURLToPath(import.meta.url));
+	const candidates = [
+		join(here, "skills"),
+		join(here, "..", "skills"),
+		join(here, "..", "..", "skills")
+	];
+	for (const dir of candidates) if (listSkillNames(dir).length > 0) return dir;
+	let dir = here;
+	for (let depth = 0; depth < 6; depth++) {
+		const candidate = join(dir, "skills");
+		if (listSkillNames(candidate).length > 0) return candidate;
+		dir = dirname(dir);
+	}
+	throw new Error("Could not locate the bundled theme skills — this is a packaging bug.");
+}
+function createSkillsCommand() {
+	const skills = new Command("skills").description("Manage the bundled Fluid theme AI skills");
+	skills.command("install").description("Copy the bundled theme skills into the current directory (default: .agents/skills/)").option("-d, --dir <path>", "Directory to install into", DEFAULT_TARGET_DIR).option("-f, --force", "Overwrite existing skills without prompting").action(async (opts) => {
+		const sourceDir = resolveBundledSkillsDir();
+		if (listSkillNames(sourceDir).length === 0) {
+			console.error("No bundled skills found to install.");
+			process.exit(1);
+		}
+		const targetRoot = resolve(process.cwd(), opts.dir);
+		const { installed, skipped } = await installSkills({
+			sourceDir,
+			targetRoot,
+			force: Boolean(opts.force),
+			confirmOverwrite: async (name) => {
+				const res = await prompts({
+					type: "confirm",
+					name: "overwrite",
+					message: `${chalk.yellow(name)} already exists in ${opts.dir}. Overwrite?`,
+					initial: false
+				}, { onCancel: () => process.exit(130) });
+				return Boolean(res.overwrite);
+			},
+			onLeftover: (path) => {
+				console.log(`${chalk.yellow("⚠")} kept the previous copy at ${path} (couldn't remove it — delete it manually)`);
+			}
+		});
+		for (const name of installed) console.log(`${chalk.green("✓")} ${name} → ${join(opts.dir, name)}`);
+		for (const name of skipped) console.log(`${chalk.dim(`· skipped ${name} (kept existing)`)}`);
+		const parts = [installed.length > 0 ? `${installed.length} installed` : null, skipped.length > 0 ? `${skipped.length} skipped` : null].filter(Boolean);
+		console.log(`\n${chalk.bold(parts.join(", ") || "Nothing to do")} in ${targetRoot}`);
+		if (installed.length > 0) console.log(chalk.dim("Restart your agent session to pick up the new skills."));
+	});
+	return skills;
+}
+//#endregion
 //#region src/commands/theme.ts
 function registerThemeCommand(ctx) {
-	const cmd = new Command("theme").description("Theme developer workflow — dev server, push, pull, lint, init");
+	const cmd = new Command("theme").description("Theme developer workflow — dev server, push, pull, lint, init, skills");
 	cmd.addCommand(createDevCommand());
 	cmd.addCommand(createPushCommand());
 	cmd.addCommand(createPullCommand());
 	cmd.addCommand(createLintCommand());
 	cmd.addCommand(createInitCommand());
 	cmd.addCommand(createNavigateCommand());
+	cmd.addCommand(createSkillsCommand());
 	ctx.program.addCommand(cmd);
 }
 //#endregion