@archetypeai/ds-cli 0.3.7 → 0.3.9

package/README.md

@@ -1,123 +1,81 @@
 ## @archetypeai/ds-cli
 
-`@archetypeai/ds-cli` is the CLI for the **Archetype AI Design System**. It provides commands for creating, configuring, and managing projects that use the design system.
+CLI for the **Archetype AI Design System**. Scaffold new projects, add the design system to existing ones, and manage components and agent configurations.
 
 ---
 
-## Commands
-
-### `create` — Scaffold a new project
+Run directly with `npx`:
 
 ```bash
 npx @archetypeai/ds-cli create my-app
 ```
 
-Scaffolds a full SvelteKit + Tailwind v4 + shadcn-svelte project:
+---
+
+## Commands
+
+### `create` → Scaffold a new project
 
-1. Creates a SvelteKit project via `sv create`
-2. Installs design tokens (`@archetypeai/ds-lib-tokens`)
-3. Optionally installs internal fonts (`@archetypeai/ds-lib-fonts-internal`)
-4. Initializes shadcn-svelte (`components.json`, `utils.js`, dependencies)
-5. Configures CSS (`layout.css` with design tokens and optional fonts import)
-6. Installs all components from the design system registry
-7. Optionally installs AI agent configuration (Cursor or Claude Code)
-8. Creates a demo page with Button examples
+```bash
+npx @archetypeai/ds-cli create my-app
+```
 
-#### Create flags
+Sets up a SvelteKit + Tailwind v4 + shadcn-svelte project with design tokens, components, and an optional demo page.
 
 | Flag | Values | Default |
 |------|--------|---------|
 | `--framework` | `svelte` | prompt |
 | `--pm` | `npm`, `pnpm`, `bun`, `yarn` | prompt |
-| `--fonts` / `--no-fonts` | boolean | prompt (default: yes) |
-| `--no-components` | skip component installation | install all |
+| `--no-components` | skip component install | install all |
 | `--codeagent` | `cursor`, `claude`, `none` | prompt |
 
 ```bash
-npx @archetypeai/ds-cli create my-app --framework svelte --pm pnpm --no-fonts --codeagent none
+npx @archetypeai/ds-cli create my-app --framework svelte --pm pnpm --codeagent none
 ```
 
 ---
 
-### `init` — Add DS to an existing project
+### `init` → Add DS to an existing project
 
 ```bash
 cd my-existing-app
 npx @archetypeai/ds-cli init
 ```
 
-Run from an existing SvelteKit project root. Detects your package manager from the lockfile and installs the design system without creating a new project:
-
-1. Detects project (verifies `package.json` and `svelte.config.js`)
-2. Auto-detects package manager from lockfile
-3. Installs Tailwind CSS v4 if not already present
-4. Installs design tokens
-5. Optionally installs internal fonts
-6. Initializes shadcn-svelte
-7. Prepends DS imports to existing `layout.css` (preserves your styles)
-8. Installs all components from the registry
-9. Optionally installs AI agent configuration
-
-#### Init flags
+Run from a SvelteKit project root. Auto-detects your package manager, installs tokens, shadcn-svelte, and components, and prepends DS imports to your `layout.css` (preserving existing styles).
 
 | Flag | Values | Default |
 |------|--------|---------|
-| `--pm` | `npm`, `pnpm`, `bun`, `yarn` | auto-detect from lockfile |
-| `--fonts` / `--no-fonts` | boolean | prompt (default: yes) |
-| `--no-components` | skip component installation | install all |
+| `--pm` | `npm`, `pnpm`, `bun`, `yarn` | auto-detect |
+| `--no-components` | skip component install | install all |
 | `--codeagent` | `cursor`, `claude`, `none` | prompt |
 
 ```bash
-npx @archetypeai/ds-cli init --pm npm --no-fonts --codeagent none
+npx @archetypeai/ds-cli init --pm npm --codeagent none
 ```
 
 ---
 
-### `add` — Add components or agent configurations
+### `add` → Add components or agent config
 
-#### `add ds-ui-svelte` — Install all design system components
+#### `add ds-ui-svelte`
 
 ```bash
 npx @archetypeai/ds-cli add ds-ui-svelte
 ```
 
-Installs all components from the design system registry into your project. Requires shadcn-svelte to be initialized (`components.json` must exist).
+Installs all components from the registry. Requires shadcn-svelte (`components.json` must exist).
 
-#### `add ds-config-codeagent` — Install agent configuration
+#### `add ds-config-codeagent`
 
 ```bash
 npx @archetypeai/ds-cli add ds-config-codeagent --cursor
 npx @archetypeai/ds-cli add ds-config-codeagent --claude
 ```
 
-Installs agent configuration files (AGENTS.md/CLAUDE.md, skills, and rules) for the specified IDE. If no flag is provided, an interactive prompt will ask which IDE to configure.
-
 | Flag | Effect |
 |------|--------|
-| `--cursor` | Copies AGENTS.md, skills, and rules to `.cursor/` |
-| `--claude` | Copies CLAUDE.md, skills, and rules to `.claude/` |
-
----
-
-## Environment Variables
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `REGISTRY_URL` | `https://design-system.archetypeai.workers.dev` | Override the component registry URL for testing or private registries |
-
----
-
-## Security
-
-The CLI validates all data from external sources before use:
-
-- **Registry URLs** are validated against an HTTPS + `/r/<name>.json` pattern before being passed to any shell command
-- **Shell commands** use `execFileSync` (no shell interpolation) to prevent injection even if validation is bypassed
-- **Package manager** and **framework** flag values are validated against known allowlists
-- **Fetch requests** have a 15-second timeout to prevent hanging on unresponsive registries
-
----
-
-## Fonts
+| `--cursor` | Installs AGENTS.md, skills, and rules to `.cursor/` |
+| `--claude` | Installs CLAUDE.md, skills, and rules to `.claude/` |
 
-The internal fonts package (`@archetypeai/ds-lib-fonts-internal`) is not yet published. When available, it will be on npmjs.org. If omitted, the theme falls back to system fonts.
+Without a flag, an interactive prompt asks which IDE to configure.

package/commands/create.js

@@ -6,7 +6,6 @@ import { fetchComponents } from '../lib/use-shadcn-svelte-registry.js';
 import {
   runSvCreate,
   installTokens,
-  installFonts,
   initShadcn,
   configureCss,
   installComponents,
@@ -20,7 +19,6 @@ export function parseFlags(args) {
     name: null,
     framework: null,
     pm: null,
-    fonts: null,
     components: true,
     agent: null
   };
@@ -31,10 +29,6 @@ export function parseFlags(args) {
       flags.framework = args[++i];
     } else if (arg === '--pm' && args[i + 1]) {
       flags.pm = args[++i];
-    } else if (arg === '--fonts') {
-      flags.fonts = true;
-    } else if (arg === '--no-fonts') {
-      flags.fonts = false;
     } else if (arg === '--no-components') {
       flags.components = false;
     } else if (arg === '--codeagent' && args[i + 1]) {
@@ -139,38 +133,22 @@ export async function create(args) {
   }
 
   // create SvelteKit project
-  const created = runSvCreate(pm, name, targetDir);
+  const created = await runSvCreate(pm, name, targetDir);
   if (!created) {
     process.exit(1);
   }
 
-  // specify fonts
-  let includeFonts = flags.fonts;
-  if (includeFonts === null) {
-    includeFonts = await p.confirm({
-      message: 'Install internal fonts package?',
-      initialValue: true
-    });
-    if (p.isCancel(includeFonts)) {
-      p.cancel('Setup cancelled.');
-      process.exit(0);
-    }
-  }
-
   // install packages
-  const tokensOk = installTokens(pm, projectPath);
+  const tokensOk = await installTokens(pm, projectPath);
   if (!tokensOk) {
     process.exit(1);
   }
 
-  if (includeFonts) {
-    installFonts(pm, projectPath);
-  }
-
   // init shadcn-svelte
-  initShadcn(pm, projectPath);
+  await initShadcn(pm, projectPath);
 
   // configure CSS
+  const includeFonts = false;
   configureCss(projectPath, includeFonts);
 
   // install components
@@ -180,7 +158,7 @@ export async function create(args) {
       s.start('Fetching component list');
       const components = await fetchComponents();
       s.stop(`Found ${components.length} components`);
-      installComponents(pm, projectPath, components);
+      await installComponents(pm, projectPath, components);
     } catch (error) {
       p.log.warn(`Component installation skipped: ${error.message}`);
     }

package/commands/init.js

@@ -6,7 +6,6 @@ import { fetchComponents } from '../lib/use-shadcn-svelte-registry.js';
 import {
   installTailwind,
   installTokens,
-  installFonts,
   initShadcn,
   prependCss,
   installComponents,
@@ -17,7 +16,6 @@ import {
 export function parseFlags(args) {
   const flags = {
     pm: null,
-    fonts: null,
     components: true,
     agent: null
   };
@@ -26,10 +24,6 @@ export function parseFlags(args) {
     const arg = args[i];
     if (arg === '--pm' && args[i + 1]) {
       flags.pm = args[++i];
-    } else if (arg === '--fonts') {
-      flags.fonts = true;
-    } else if (arg === '--no-fonts') {
-      flags.fonts = false;
     } else if (arg === '--no-components') {
       flags.components = false;
     } else if (arg === '--codeagent' && args[i + 1]) {
@@ -107,39 +101,23 @@ export async function init(args) {
   // detect and install Tailwind if missing
   if (!hasTailwind(projectPath)) {
     p.log.info('Tailwind CSS not found in dependencies.');
-    const tailwindOk = installTailwind(pm, projectPath);
+    const tailwindOk = await installTailwind(pm, projectPath);
     if (!tailwindOk) {
       process.exit(1);
     }
   }
 
-  // specify fonts
-  let includeFonts = flags.fonts;
-  if (includeFonts === null) {
-    includeFonts = await p.confirm({
-      message: 'Install internal fonts package?',
-      initialValue: true
-    });
-    if (p.isCancel(includeFonts)) {
-      p.cancel('Setup cancelled.');
-      process.exit(0);
-    }
-  }
-
   // install packages
-  const tokensOk = installTokens(pm, projectPath);
+  const tokensOk = await installTokens(pm, projectPath);
   if (!tokensOk) {
     process.exit(1);
   }
 
-  if (includeFonts) {
-    installFonts(pm, projectPath);
-  }
-
   // init shadcn-svelte
-  initShadcn(pm, projectPath);
+  await initShadcn(pm, projectPath);
 
   // configure CSS (prepend to existing)
+  const includeFonts = false;
   prependCss(projectPath, includeFonts);
 
   // install components
@@ -149,7 +127,7 @@ export async function init(args) {
       s.start('Fetching component list');
       const components = await fetchComponents();
       s.stop(`Found ${components.length} components`);
-      installComponents(pm, projectPath, components);
+      await installComponents(pm, projectPath, components);
     } catch (error) {
       p.log.warn(`Component installation skipped: ${error.message}`);
     }

package/lib/add-ds-ui-svelte.js

@@ -1,4 +1,5 @@
-import { execFileSync } from 'child_process';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
 import { existsSync, readFileSync, writeFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
@@ -6,6 +7,8 @@ import * as p from '@clack/prompts';
 import { validateRegistryUrl } from './validate-url.js';
 import { detectPm, getPm } from './use-package-manager.js';
 
+const execFileAsync = promisify(execFile);
+
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const REGISTRY_URL = process.env.REGISTRY_URL || 'https://design-system.archetypeai.workers.dev';
 const ALL_COMPONENTS_URL = `${REGISTRY_URL}/r/all.json`;
@@ -53,7 +56,7 @@ export async function addDsUiSvelte() {
     installSpinner.start('Installing components');
 
     const [dlxCmd, ...dlxArgs] = pm.dlx.split(/\s+/);
-    execFileSync(
+    await execFileAsync(
       dlxCmd,
       [...dlxArgs, 'shadcn-svelte@latest', 'add', ...componentUrls, '--yes', '--overwrite'],
       { stdio: 'pipe', cwd: projectDir }

package/lib/scaffold-ds-svelte-project.js

@@ -1,12 +1,15 @@
-import { execFileSync } from 'child_process';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
 import { join } from 'path';
 import * as p from '@clack/prompts';
 import { setupCursor, setupClaude } from './add-ds-config-codeagent.js';
 
+const execFileAsync = promisify(execFile);
+
 // run a command without a shell to prevent injection
-function run(command, args, opts) {
-  execFileSync(command, args, { stdio: 'pipe', ...opts });
+async function run(command, args, opts) {
+  await execFileAsync(command, args, { stdio: 'pipe', ...opts });
 }
 
 // write a file
@@ -24,7 +27,7 @@ function splitCmd(cmdString) {
 }
 
 // run sveltekit create
-export function runSvCreate(pm, name, targetDir) {
+export async function runSvCreate(pm, name, targetDir) {
   const [cmd, ...baseArgs] = splitCmd(pm.dlx);
   const args = [
     ...baseArgs,
@@ -41,7 +44,7 @@ export function runSvCreate(pm, name, targetDir) {
   const s = p.spinner();
   s.start('Creating SvelteKit project');
   try {
-    run(cmd, args, { cwd: targetDir });
+    await run(cmd, args, { cwd: targetDir });
     s.stop('SvelteKit project created');
     return true;
   } catch (error) {
@@ -52,13 +55,13 @@ export function runSvCreate(pm, name, targetDir) {
 }
 
 // install design tokens
-export function installTokens(pm, projectPath) {
+export async function installTokens(pm, projectPath) {
   const [cmd, ...baseArgs] = splitCmd(pm.install);
   const args = [...baseArgs, '@archetypeai/ds-lib-tokens'];
   const s = p.spinner();
   s.start('Installing design tokens');
   try {
-    run(cmd, args, { cwd: projectPath });
+    await run(cmd, args, { cwd: projectPath });
     s.stop('Design tokens installed');
     return true;
   } catch (error) {
@@ -69,13 +72,13 @@ export function installTokens(pm, projectPath) {
 }
 
 // install internal fonts package
-export function installFonts(pm, projectPath) {
+export async function installFonts(pm, projectPath) {
   const [cmd, ...baseArgs] = splitCmd(pm.install);
   const args = [...baseArgs, '@archetypeai/ds-lib-fonts-internal'];
   const s = p.spinner();
   s.start('Installing internal fonts');
   try {
-    run(cmd, args, { cwd: projectPath });
+    await run(cmd, args, { cwd: projectPath });
     s.stop('Internal fonts installed');
     return true;
   } catch {
@@ -86,7 +89,7 @@ export function installFonts(pm, projectPath) {
 }
 
 // init shadcn-svelte
-export function initShadcn(pm, projectPath) {
+export async function initShadcn(pm, projectPath) {
   const s = p.spinner();
   s.start('Setting up shadcn-svelte');
   try {
@@ -131,7 +134,7 @@ export function cn(...inputs) {
     }
 
     const [cmd, ...baseArgs] = splitCmd(pm.install);
-    run(cmd, [...baseArgs, 'clsx', 'tailwind-merge', 'tw-animate-css'], { cwd: projectPath });
+    await run(cmd, [...baseArgs, 'clsx', 'tailwind-merge', 'tw-animate-css'], { cwd: projectPath });
 
     s.stop('shadcn-svelte ready');
     return true;
@@ -158,13 +161,13 @@ export function configureCss(projectPath, includeFonts) {
 }
 
 // install Tailwind CSS v4
-export function installTailwind(pm, projectPath) {
+export async function installTailwind(pm, projectPath) {
   const [cmd, ...baseArgs] = splitCmd(pm.install);
   const args = [...baseArgs, 'tailwindcss@latest'];
   const s = p.spinner();
   s.start('Installing Tailwind CSS v4');
   try {
-    run(cmd, args, { cwd: projectPath });
+    await run(cmd, args, { cwd: projectPath });
     s.stop('Tailwind CSS installed');
     return true;
   } catch (error) {
@@ -206,18 +209,22 @@ export function prependCss(projectPath, includeFonts) {
 }
 
 // install components from shadcn-svelte registry
-export function installComponents(pm, projectPath, componentUrls) {
+export async function installComponents(pm, projectPath, componentUrls) {
   const s = p.spinner();
   s.start(`Installing ${componentUrls.length} components`);
   try {
     const urls = componentUrls.map((c) => c.url);
     const [dlxCmd, ...dlxArgs] = splitCmd(pm.dlx);
-    run(dlxCmd, [...dlxArgs, 'shadcn-svelte@latest', 'add', ...urls, '--yes', '--overwrite'], {
-      cwd: projectPath
-    });
+    await run(
+      dlxCmd,
+      [...dlxArgs, 'shadcn-svelte@latest', 'add', ...urls, '--yes', '--overwrite'],
+      {
+        cwd: projectPath
+      }
+    );
 
     const [installCmd, ...installArgs] = splitCmd(pm.install);
-    run(
+    await run(
       installCmd,
       [...installArgs, 'tailwind-variants', 'bits-ui', '@lucide/svelte', 'layerchart', 'paneforge'],
       { cwd: projectPath }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@archetypeai/ds-cli",
-  "version": "0.3.7",
-  "description": "Archetype AI Design System CLI",
+  "version": "0.3.9",
+  "description": "Archetype AI Design System CLI Tool",
   "type": "module",
   "bin": {
     "ds": "./bin.js"
@@ -30,5 +30,16 @@
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
   },
+  "keywords": [
+    "design-system",
+    "cli",
+    "sveltekit",
+    "tailwindcss",
+    "shadcn-svelte",
+    "scaffolding",
+    "components",
+    "archetypeai",
+    "physicalai"
+  ],
   "license": "MIT"
 }