@rokkit/cli 1.4.0 → 1.4.1

package/dist/src/agents.d.ts

@@ -46,13 +46,13 @@ export function fetchAgents(names: string[], { cwd, force, baseUrl, fetchImpl }?
 export function runAgentsList({ agentsDir, cwd }?: {
     agentsDir?: string;
     cwd?: string;
-}): Promise<void>;
+}): void;
 /**
  * Resolve which agents to install, then copy (or fetch with --remote) and report.
  * @param {string[]} names
  * @param {{ all?: boolean, force?: boolean, remote?: boolean, agentsDir?: string, cwd?: string, fetchImpl?: typeof fetch }} [opts]
  */
-export function runAgentsAdd(names: string[], { all, force, remote, agentsDir, cwd, fetchImpl }?: {
+export function runAgentsAdd(names: string[], opts?: {
     all?: boolean;
     force?: boolean;
     remote?: boolean;

package/dist/src/init.d.ts

@@ -37,22 +37,407 @@ export function generateChartConfig({ chartColors, chartShades }: {
     chartColors: string;
     chartShades: string;
 }): Record<string, unknown>;
-/**
- * Build the Zen-Sumi OKLCH starter (ink-on-paper, dual-palette dark mode).
- * @param {{ themes?: string[], defaultTheme?: string, switcher?: string,
- *   includeChart?: boolean, chartColors?: string, chartShades?: string,
- *   storageKey?: string }} [opts]
- * @returns {Record<string, unknown>}
- */
-export function generateZenSumiConfig(opts?: {
-    themes?: string[];
-    defaultTheme?: string;
-    switcher?: string;
-    includeChart?: boolean;
-    chartColors?: string;
-    chartShades?: string;
-    storageKey?: string;
-}): Record<string, unknown>;
+export function generateZenSumiConfig(opts?: {}): {
+    chart: Record<string, unknown>;
+    storageKey: any;
+    themes: any;
+    defaultTheme: any;
+    switcher: any;
+    palettes: {
+        kami: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        sumi: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        shu: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        hisui: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        kohaku: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+    };
+    colorSpace: string;
+    tokens: string;
+    skin: {
+        surface: {
+            light: string;
+            dark: string;
+        };
+        ink: {
+            light: string;
+            dark: string;
+        };
+        primary: string;
+        accent: string;
+        success: string;
+        warning: string;
+        danger: string;
+        error: string;
+        info: string;
+    };
+    shape: {
+        radius: string;
+    };
+    typography: {
+        display: string;
+        sans: string;
+        mono: string;
+    };
+} | {
+    chart?: undefined;
+    storageKey: any;
+    themes: any;
+    defaultTheme: any;
+    switcher: any;
+    palettes: {
+        kami: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        sumi: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        shu: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        hisui: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        kohaku: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+    };
+    colorSpace: string;
+    tokens: string;
+    skin: {
+        surface: {
+            light: string;
+            dark: string;
+        };
+        ink: {
+            light: string;
+            dark: string;
+        };
+        primary: string;
+        accent: string;
+        success: string;
+        warning: string;
+        danger: string;
+        error: string;
+        info: string;
+    };
+    shape: {
+        radius: string;
+    };
+    typography: {
+        display: string;
+        sans: string;
+        mono: string;
+    };
+} | {
+    chart: Record<string, unknown>;
+    storageKey?: undefined;
+    themes: any;
+    defaultTheme: any;
+    switcher: any;
+    palettes: {
+        kami: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        sumi: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        shu: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        hisui: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        kohaku: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+    };
+    colorSpace: string;
+    tokens: string;
+    skin: {
+        surface: {
+            light: string;
+            dark: string;
+        };
+        ink: {
+            light: string;
+            dark: string;
+        };
+        primary: string;
+        accent: string;
+        success: string;
+        warning: string;
+        danger: string;
+        error: string;
+        info: string;
+    };
+    shape: {
+        radius: string;
+    };
+    typography: {
+        display: string;
+        sans: string;
+        mono: string;
+    };
+} | {
+    chart?: undefined;
+    storageKey?: undefined;
+    themes: any;
+    defaultTheme: any;
+    switcher: any;
+    palettes: {
+        kami: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        sumi: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        shu: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        hisui: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+        kohaku: {
+            50: string;
+            100: string;
+            200: string;
+            300: string;
+            400: string;
+            500: string;
+            600: string;
+            700: string;
+            800: string;
+            900: string;
+            950: string;
+        };
+    };
+    colorSpace: string;
+    tokens: string;
+    skin: {
+        surface: {
+            light: string;
+            dark: string;
+        };
+        ink: {
+            light: string;
+            dark: string;
+        };
+        primary: string;
+        accent: string;
+        success: string;
+        warning: string;
+        danger: string;
+        error: string;
+        info: string;
+    };
+    shape: {
+        radius: string;
+    };
+    typography: {
+        display: string;
+        sans: string;
+        mono: string;
+    };
+};
 /**
  * Build a Rokkit config object from the user's init choices.
  * Emits the named-token `skin` shape (skin + colorSpace + tokens), plus
@@ -63,7 +448,7 @@ export function generateZenSumiConfig(opts?: {
  *   storageKey?: string }} opts
  * @returns {Record<string, unknown>}
  */
-export function generateConfig({ palette, customColors, icons, iconPath, iconStyle, themes, defaultTheme, switcher, includeChart, chartColors, chartShades, storageKey }: {
+export function generateConfig(opts: {
     palette: string;
     customColors?: Record<string, string>;
     icons?: string;

package/dist/src/skills.d.ts

@@ -39,7 +39,7 @@ export function installSkills(names: string[], { cwd, force, skillsDir }?: {
 export function runSkillsList({ skillsDir, cwd }?: {
     skillsDir?: string;
     cwd?: string;
-}): Promise<void>;
+}): void;
 /**
  * Resolve which skills to install, then copy and report.
  * @param {string[]} names

package/dist/src/validate.d.ts

@@ -1,33 +1,14 @@
-/**
- * Advisory validation run by `doctor`: config shape rules for the named-token
- * system, and a scan for surface/border tokens misused as text colour.
- */
-/**
- * Validate a parsed rokkit config for the named-token system. All advisory (warn).
- * @param {Record<string, unknown> | null} config
- * @returns {Array<{ id: string, label: string, status: 'warn', fixable: false, fix: string }>}
- */
-export function validateConfigShape(config: Record<string, unknown> | null): Array<{
+export function validateConfigShape(config: any): {
     id: string;
     label: string;
-    status: "warn";
-    fixable: false;
+    status: string;
+    fixable: boolean;
     fix: string;
-}>;
-/**
- * Advisory lint: scan src/ for surface/border tokens used as text colour.
- * @param {{ list?: (dir: string) => string[], exists: (p: string) => boolean, read: (p: string) => string, resolve: (p: string) => string }} fs
- * @returns {Array<{ id: string, label: string, status: 'warn', fixable: false, fix: string }>}
- */
-export function checkTextTokenUsage(fs: {
-    list?: (dir: string) => string[];
-    exists: (p: string) => boolean;
-    read: (p: string) => string;
-    resolve: (p: string) => string;
-}): Array<{
+}[];
+export function checkTextTokenUsage(fs: any): {
     id: string;
     label: string;
-    status: "warn";
-    fixable: false;
+    status: string;
+    fixable: boolean;
     fix: string;
-}>;
+}[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rokkit/cli",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Command line utilities for icon bundling and conversion.",
   "repository": {
     "type": "git",
@@ -27,7 +27,7 @@
   },
   "dependencies": {
     "@mdi/svg": "^7.4.47",
-    "@rokkit/unocss": "1.4.0",
+    "@rokkit/unocss": "1.4.1",
     "sade": "^1.8.1",
     "@iconify/tools": "5.0.3",
     "@iconify/types": "^2.0.0",

package/src/agents.js

@@ -77,29 +77,36 @@ export async function fetchAgents(
 ) {
 	const targetRoot = resolve(cwd, '.claude', 'agents')
 	const results = []
+	// Sequential on purpose: the outcomes should print in the order the user
+	// listed the agents, and every write targets the same directory anyway.
 	for (const name of names) {
-		const dest = join(targetRoot, `${name}.md`)
-		if (existsSync(dest) && !force) {
-			results.push({ name, status: 'skipped' })
-			continue
-		}
-		const res = await fetchImpl(`${baseUrl}/${name}.md`)
-		if (!res.ok) {
-			results.push({ name, status: 'unknown' })
-			continue
-		}
-		mkdirSync(targetRoot, { recursive: true })
-		writeFileSync(dest, await res.text())
-		results.push({ name, status: 'added' })
+		results.push(await fetchAgent(name, { targetRoot, force, baseUrl, fetchImpl }))
 	}
 	return results
 }
 
+/**
+ * Fetch and write one agent. Reports its outcome rather than throwing, so one
+ * missing name doesn't abandon the rest of the batch.
+ * @param {string} name
+ * @param {{ targetRoot: string, force: boolean, baseUrl: string, fetchImpl: typeof fetch }} ctx
+ * @returns {Promise<{ name: string, status: 'added' | 'skipped' | 'unknown' }>}
+ */
+async function fetchAgent(name, { targetRoot, force, baseUrl, fetchImpl }) {
+	const dest = join(targetRoot, `${name}.md`)
+	if (existsSync(dest) && !force) return { name, status: 'skipped' }
+	const res = await fetchImpl(`${baseUrl}/${name}.md`)
+	if (!res.ok) return { name, status: 'unknown' }
+	mkdirSync(targetRoot, { recursive: true })
+	writeFileSync(dest, await res.text())
+	return { name, status: 'added' }
+}
+
 /**
  * Print the catalog, marking already-installed agents.
  * @param {{ agentsDir?: string, cwd?: string }} [opts]
  */
-export async function runAgentsList({ agentsDir, cwd = process.cwd() } = {}) {
+export function runAgentsList({ agentsDir, cwd = process.cwd() } = {}) {
 	const catalog = listAgents({ agentsDir })
 	if (catalog.length === 0) {
 		console.info('No agents available.')
@@ -120,40 +127,66 @@ export async function runAgentsList({ agentsDir, cwd = process.cwd() } = {}) {
  * @param {string[]} names
  * @param {{ all?: boolean, force?: boolean, remote?: boolean, agentsDir?: string, cwd?: string, fetchImpl?: typeof fetch }} [opts]
  */
-export async function runAgentsAdd(
-	names,
-	{ all = false, force = false, remote = false, agentsDir, cwd = process.cwd(), fetchImpl } = {}
-) {
+export async function runAgentsAdd(names, opts = {}) {
+	const { all = false, agentsDir } = opts
 	const catalog = listAgents({ agentsDir })
-	let selected = names
-	if (all) {
-		selected = catalog.map((a) => a.name)
-	} else if (selected.length === 0) {
-		const res = await prompts({
-			type: 'multiselect',
-			name: 'picked',
-			message: 'Select agents to add',
-			choices: catalog.map((a) => ({ title: a.name, value: a.name, description: a.description }))
-		})
-		selected = res.picked ?? []
-	}
+	const selected = await resolveAgentSelection(names, catalog, all)
 	if (selected.length === 0) {
 		console.info('No agents selected.')
 		return
 	}
+	await installAndReport(selected, catalog, opts)
+}
+
+/**
+ * Install the selection — locally, or from the site with `--remote` — and report
+ * each outcome.
+ *
+ * @param {string[]} selected
+ * @param {Array<{ name: string, description: string }>} catalog
+ * @param {{ force?: boolean, remote?: boolean, agentsDir?: string, cwd?: string, fetchImpl?: typeof fetch }} opts
+ */
+async function installAndReport(
+	selected,
+	catalog,
+	{ force = false, remote = false, agentsDir, cwd = process.cwd(), fetchImpl }
+) {
 	const results = remote
 		? await fetchAgents(selected, { cwd, force, fetchImpl })
 		: installAgents(selected, { cwd, force, agentsDir })
-	for (const r of results) {
-		if (r.status === 'added') console.info(`  added .claude/agents/${r.name}.md`)
-		else if (r.status === 'skipped')
-			console.info(`  skipped ${r.name} (exists — use --force to overwrite)`)
-		else console.error(`  unknown agent: ${r.name}`)
-	}
-	if (results.some((r) => r.status === 'unknown')) {
-		if (!remote) console.error(`\nValid agents: ${catalog.map((a) => a.name).join(', ')}`)
-		process.exitCode = 1
-	}
+	results.forEach(reportAgentResult)
+	if (!results.some((r) => r.status === 'unknown')) return
+	// A remote fetch has no catalog to enumerate, so there are no valid names to suggest.
+	if (!remote) console.error(`\nValid agents: ${catalog.map((a) => a.name).join(', ')}`)
+	process.exitCode = 1
+}
+
+/**
+ * Which agents to install: everything with `--all`, the named ones, or an
+ * interactive pick when neither was given.
+ * @param {string[]} names
+ * @param {Array<{ name: string, description: string }>} catalog
+ * @param {boolean} all
+ * @returns {Promise<string[]>}
+ */
+async function resolveAgentSelection(names, catalog, all) {
+	if (all) return catalog.map((a) => a.name)
+	if (names.length > 0) return names
+	const res = await prompts({
+		type: 'multiselect',
+		name: 'picked',
+		message: 'Select agents to add',
+		choices: catalog.map((a) => ({ title: a.name, value: a.name, description: a.description }))
+	})
+	return res.picked ?? []
+}
+
+/** Report one install outcome. Unknown names go to stderr — they're a user error. */
+function reportAgentResult(r) {
+	if (r.status === 'added') console.info(`  added .claude/agents/${r.name}.md`)
+	else if (r.status === 'skipped')
+		console.info(`  skipped ${r.name} (exists — use --force to overwrite)`)
+	else console.error(`  unknown agent: ${r.name}`)
 }
 
 /**