@sudajs/cli 0.20.0 → 0.21.0

package/dist/index.d.ts

@@ -16,6 +16,16 @@ interface ValidatedTheme {
 interface ThemeRootOptions {
     themeRoot?: string | undefined;
 }
+interface ThemeSkillAddOptions {
+    root?: string | undefined;
+    dryRun?: boolean | undefined;
+    force?: boolean | undefined;
+}
+type ThemeSkillAddStatus = "installed" | "already-installed" | "would-install" | "would-replace";
+interface ThemeSkillAddResult {
+    destination: string;
+    status: ThemeSkillAddStatus;
+}
 interface CliAuthContext {
     baseUrl: string;
     token: string;
@@ -2249,6 +2259,8 @@ declare function validateThemePreviewLocales(root: string, previewLocales: strin
 declare function toViteModuleUrl(root: string, absolutePath: string): string;
 declare function buildTheme(root: string): Promise<ValidatedTheme>;
 declare function finalizeTheme(root: string): Promise<ValidatedTheme>;
+declare function findThemeSkillWorkspaceRoot(startDirectory: string): string;
+declare function addThemeSkill(options?: ThemeSkillAddOptions): Promise<ThemeSkillAddResult>;
 declare function findAnchorTagByHref(html: string, href: string): string | null;
 declare const __testUtils: {
     activateThemeOutputSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
@@ -2709,6 +2721,7 @@ declare const __testUtils: {
     }>]>;
     findAnchorTagByHref: typeof findAnchorTagByHref;
     formatMissingSharpWarning: typeof formatMissingSharpWarning;
+    findThemeSkillWorkspaceRoot: typeof findThemeSkillWorkspaceRoot;
     loadThemeScopedRenderer: typeof loadThemeScopedRenderer;
     normalizePlaywrightModule: typeof normalizePlaywrightModule;
     normalizeSharpModule: typeof normalizeSharpModule;
@@ -4760,4 +4773,4 @@ declare function initThemeWithKey(target: string, key: string): Promise<void>;
 declare function buildProgram(): Command;
 declare function main(): Promise<void>;
 
-export { __testUtils, buildProgram, buildTheme, finalizeTheme, initTheme, main, parseThemeRef, validateTheme, watchTheme };
+export { __testUtils, addThemeSkill, buildProgram, buildTheme, finalizeTheme, initTheme, main, parseThemeRef, validateTheme, watchTheme };

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { createHash } from 'crypto';
 import { existsSync } from 'fs';
-import fs, { readFile, mkdir, writeFile, stat, readdir, copyFile, rm } from 'fs/promises';
+import fs, { readFile, rm, mkdir, writeFile, stat, readdir, copyFile } from 'fs/promises';
 import { createRequire } from 'module';
 import path2 from 'path';
 import { createInterface } from 'readline/promises';
@@ -735,6 +735,7 @@ var createProjectOutputSchema = z.object({
 });
 var packageRoot = path2.resolve(path2.dirname(fileURLToPath(import.meta.url)), "..");
 var themeTemplateRoot = path2.join(packageRoot, "templates", "theme");
+var themeSkillTemplateRoot = path2.join(packageRoot, "templates", "theme-skill");
 function createHostReactShimPlugin() {
   return {
     name: "suda-host-react-shim",
@@ -1608,6 +1609,58 @@ async function copyDirectory(source, destination) {
     await copyFile(sourcePath, destinationPath);
   }
 }
+function findThemeSkillWorkspaceRoot(startDirectory) {
+  let candidate = path2.resolve(startDirectory);
+  while (true) {
+    if (existsSync(path2.join(candidate, ".git"))) {
+      return candidate;
+    }
+    const parent = path2.dirname(candidate);
+    if (parent === candidate) {
+      return path2.resolve(startDirectory);
+    }
+    candidate = parent;
+  }
+}
+function resolveThemeSkillWorkspaceRoot(root) {
+  return root === void 0 ? findThemeSkillWorkspaceRoot(process.cwd()) : path2.resolve(root);
+}
+async function readSkillName(skillDirectory) {
+  const skillPath = path2.join(skillDirectory, "SKILL.md");
+  if (!await pathExists(skillPath)) {
+    return null;
+  }
+  const source = await readFile(skillPath, "utf8");
+  return /^---\s*\nname:\s*([^\n]+)\n/m.exec(source)?.[1]?.trim() ?? null;
+}
+async function addThemeSkill(options = {}) {
+  const workspaceRoot = resolveThemeSkillWorkspaceRoot(options.root);
+  const destination = path2.join(workspaceRoot, ".agents", "skills", "sudacloud-theme");
+  const exists = await pathExists(destination);
+  if (exists) {
+    const installedSkillName = await readSkillName(destination);
+    if (installedSkillName !== "sudacloud-theme" && options.force !== true) {
+      throw new Error(
+        `${destination} already exists and is not a Suda theme skill. Use --force to replace it.`
+      );
+    }
+    if (installedSkillName === "sudacloud-theme" && options.force !== true) {
+      return { destination, status: "already-installed" };
+    }
+    if (options.dryRun === true) {
+      return { destination, status: "would-replace" };
+    }
+    await rm(destination, { recursive: true, force: true });
+  } else if (options.dryRun === true) {
+    return { destination, status: "would-install" };
+  }
+  await copyDirectory(themeSkillTemplateRoot, destination);
+  await copyDirectory(
+    path2.join(themeTemplateRoot, "docs", "agent-guides"),
+    path2.join(destination, "references")
+  );
+  return { destination, status: "installed" };
+}
 var THEME_CHECK_WHITE_LABEL = {
   visible: true,
   text: "Powered by <strong>\u901F\u642D\u4E91</strong>",
@@ -1736,6 +1789,7 @@ var __testUtils = {
   destructivePageOperationOutputSchema,
   findAnchorTagByHref,
   formatMissingSharpWarning,
+  findThemeSkillWorkspaceRoot,
   loadThemeScopedRenderer,
   normalizePlaywrightModule,
   normalizeSharpModule,
@@ -3783,6 +3837,24 @@ function buildProgram() {
     const input = await resolveThemeInitInput(name);
     await initThemeWithKey(path2.resolve(input.name), input.key);
   });
+  const themeSkill = theme.command("skill").description("Install Suda theme development guidance.");
+  themeSkill.command("add").description("Install the Suda theme development skill in a repository.").option("--root <path>", "Repository or monorepo root to install into.").option("--dry-run", "Print the destination without writing files.").option("--force", "Replace an existing skill at the destination.").action(async (options) => {
+    const result = await addThemeSkill(options);
+    const target = style.path(result.destination);
+    if (result.status === "installed") {
+      console.log(success(`installed Suda theme skill in ${target}`));
+      return;
+    }
+    if (result.status === "already-installed") {
+      console.log(info(`Suda theme skill already installed in ${target}`));
+      return;
+    }
+    if (result.status === "would-replace") {
+      console.log(info(`would replace Suda theme skill in ${target}`));
+      return;
+    }
+    console.log(info(`would install Suda theme skill in ${target}`));
+  });
   theme.command("validate").description("Validate a built theme artifact.").option("--theme-root <path>", "Theme source/artifact root.").action(async (options) => {
     const result = await validateTheme(resolveThemeRoot(options));
     console.log(
@@ -3956,6 +4028,6 @@ async function main() {
   await program.parseAsync(argv);
 }
 
-export { __testUtils, buildProgram, buildTheme, finalizeTheme, initTheme, main, parseThemeRef, validateTheme, watchTheme };
+export { __testUtils, addThemeSkill, buildProgram, buildTheme, finalizeTheme, initTheme, main, parseThemeRef, validateTheme, watchTheme };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map