@archetypeai/ds-cli 0.3.10 → 0.3.12

package/bin.js

@@ -31,12 +31,16 @@ Create flags:
   --fonts / --no-fonts              Install internal fonts (default: prompt)
   --no-components                   Skip component installation (default: install all)
   --codeagent <cursor|claude|none>  Agent configuration (default: prompt)
+  --defaults                        Skip prompts, use sensible defaults
 
 Init flags:
   --pm <npm|pnpm|bun|yarn>          Package manager (default: auto-detect)
   --fonts / --no-fonts              Install internal fonts (default: prompt)
   --no-components                   Skip component installation (default: install all)
   --codeagent <cursor|claude|none>  Agent configuration (default: prompt)
+  --defaults                        Skip prompts, use sensible defaults
+
+Non-interactive shells (no TTY) automatically use defaults.
 
 Add targets:
   ds-ui-svelte                      Install all design system components

package/commands/create.js

@@ -8,10 +8,12 @@ import {
   installTokens,
   initShadcn,
   configureCss,
+  installLinting,
   installComponents,
   createDemoPage,
   installAgentConfig
 } from '../lib/scaffold-ds-svelte-project.js';
+import { isInteractive, DEFAULTS, logDefaultsNotice } from '../lib/is-interactive.js';
 
 // parse flags
 export function parseFlags(args) {
@@ -20,7 +22,8 @@ export function parseFlags(args) {
     framework: null,
     pm: null,
     components: true,
-    agent: null
+    agent: null,
+    defaults: false
   };
 
   for (let i = 0; i < args.length; i++) {
@@ -33,6 +36,8 @@ export function parseFlags(args) {
       flags.components = false;
     } else if (arg === '--codeagent' && args[i + 1]) {
       flags.agent = args[++i];
+    } else if (arg === '--defaults') {
+      flags.defaults = true;
     } else if (!arg.startsWith('--') && !flags.name) {
       flags.name = arg;
     }
@@ -44,12 +49,17 @@ export function parseFlags(args) {
 // create a new project
 export async function create(args) {
   const flags = parseFlags(args);
+  const interactive = isInteractive(flags);
 
   p.intro('Create a new project using Archetype AI Design System.');
 
   // specify project name
   let name = flags.name;
   if (!name) {
+    if (!interactive) {
+      p.log.error('Project name is required. Usage: ds create <project-name>');
+      process.exit(1);
+    }
     name = await p.text({
       message: 'What is your project name?',
       placeholder: 'my-app',
@@ -87,26 +97,38 @@ export async function create(args) {
   // specify framework
   let framework = flags.framework;
   if (!framework) {
-    framework = await p.select({
-      message: 'Which framework?',
-      options: [{ value: 'svelte', label: 'SvelteKit', hint: 'Svelte 5 + Tailwind v4' }]
-    });
-    if (p.isCancel(framework)) {
-      p.cancel('Setup cancelled.');
-      process.exit(0);
+    if (!interactive) {
+      framework = DEFAULTS.framework;
+    } else {
+      framework = await p.select({
+        message: 'Which framework?',
+        options: [{ value: 'svelte', label: 'SvelteKit', hint: 'Svelte 5 + Tailwind v4, default' }]
+      });
+      if (p.isCancel(framework)) {
+        p.cancel('Setup cancelled.');
+        process.exit(0);
+      }
     }
   }
 
   // specify package manager
   let pmName = flags.pm;
   if (!pmName) {
-    pmName = await p.select({
-      message: 'Which package manager?',
-      options: pmNames.map((n) => ({ value: n, label: n }))
-    });
-    if (p.isCancel(pmName)) {
-      p.cancel('Setup cancelled.');
-      process.exit(0);
+    if (!interactive) {
+      pmName = DEFAULTS.pm;
+    } else {
+      pmName = await p.select({
+        message: 'Which package manager?',
+        options: pmNames.map((n) => ({
+          value: n,
+          label: n,
+          ...(n === DEFAULTS.pm && { hint: 'default' })
+        }))
+      });
+      if (p.isCancel(pmName)) {
+        p.cancel('Setup cancelled.');
+        process.exit(0);
+      }
     }
   }
   const pm = getPm(pmName);
@@ -122,13 +144,17 @@ export async function create(args) {
   const projectPath = resolve(targetDir, name);
 
   if (existsSync(projectPath)) {
-    const overwrite = await p.confirm({
-      message: `Directory "${name}" already exists. Continue anyway?`,
-      initialValue: false
-    });
-    if (p.isCancel(overwrite) || !overwrite) {
-      p.cancel('Setup cancelled.');
-      process.exit(0);
+    if (!interactive) {
+      p.log.warn(`Directory "${name}" already exists. Proceeding (non-interactive mode).`);
+    } else {
+      const overwrite = await p.confirm({
+        message: `Directory "${name}" already exists. Continue anyway?`,
+        initialValue: false
+      });
+      if (p.isCancel(overwrite) || !overwrite) {
+        p.cancel('Setup cancelled.');
+        process.exit(0);
+      }
     }
   }
 
@@ -151,6 +177,9 @@ export async function create(args) {
   const includeFonts = false;
   configureCss(projectPath, includeFonts);
 
+  // set up linting and formatting
+  await installLinting(pm, projectPath);
+
   // install components
   if (flags.components) {
     try {
@@ -169,20 +198,33 @@ export async function create(args) {
   // specify agent config
   let agent = flags.agent;
   if (!agent) {
-    agent = await p.select({
-      message: 'Install AI agent configuration?',
-      options: [
-        { value: 'none', label: 'None' },
-        { value: 'cursor', label: 'Cursor', hint: 'AGENTS.md + skills + rules' },
-        { value: 'claude', label: 'Claude Code', hint: 'CLAUDE.md + skills + rules' }
-      ]
-    });
-    if (p.isCancel(agent)) {
-      p.cancel('Setup cancelled.');
-      process.exit(0);
+    if (!interactive) {
+      agent = DEFAULTS.agent;
+    } else {
+      agent = await p.select({
+        message: 'Install AI agent configuration?',
+        options: [
+          { value: 'none', label: 'None' },
+          { value: 'cursor', label: 'Cursor', hint: 'AGENTS.md + skills + rules' },
+          { value: 'claude', label: 'Claude Code', hint: 'CLAUDE.md + skills + rules, default' }
+        ]
+      });
+      if (p.isCancel(agent)) {
+        p.cancel('Setup cancelled.');
+        process.exit(0);
+      }
     }
   }
 
+  // log defaults notice
+  if (!interactive) {
+    const applied = {};
+    if (!flags.framework) applied.framework = framework;
+    if (!flags.pm) applied.pm = pmName;
+    if (!flags.agent) applied.codeagent = agent;
+    logDefaultsNotice(applied);
+  }
+
   const validAgents = ['cursor', 'claude', 'none'];
   if (!validAgents.includes(agent)) {
     p.log.error(`Invalid --codeagent value "${agent}". Must be one of: ${validAgents.join(', ')}`);
@@ -203,6 +245,7 @@ export async function create(args) {
     `Framework:       ${framework}`,
     `Package Manager: ${pm.name}`,
     `Fonts:           ${includeFonts ? 'installed' : 'skipped'}`,
+    `Linting:         configured`,
     `Components:      ${flags.components ? 'all' : 'skipped'}`,
     `Agent Configuration:    ${agent}`
   ].join('\n');

package/commands/init.js

@@ -8,16 +8,19 @@ import {
   installTokens,
   initShadcn,
   prependCss,
+  installLinting,
   installComponents,
   installAgentConfig
 } from '../lib/scaffold-ds-svelte-project.js';
+import { isInteractive, DEFAULTS, logDefaultsNotice } from '../lib/is-interactive.js';
 
 // parse flags
 export function parseFlags(args) {
   const flags = {
     pm: null,
     components: true,
-    agent: null
+    agent: null,
+    defaults: false
   };
 
   for (let i = 0; i < args.length; i++) {
@@ -28,6 +31,8 @@ export function parseFlags(args) {
       flags.components = false;
     } else if (arg === '--codeagent' && args[i + 1]) {
       flags.agent = args[++i];
+    } else if (arg === '--defaults') {
+      flags.defaults = true;
     }
   }
 
@@ -48,6 +53,7 @@ function hasTailwind(projectPath) {
 // initialize the design system in an existing project
 export async function init(args) {
   const flags = parseFlags(args);
+  const interactive = isInteractive(flags);
   const projectPath = process.cwd();
 
   // validate --pm flag
@@ -81,17 +87,33 @@ export async function init(args) {
     }
   }
   if (!pmName) {
-    pmName = await p.select({
-      message: 'Which package manager?',
-      options: pmNames.map((n) => ({ value: n, label: n }))
-    });
-    if (p.isCancel(pmName)) {
-      p.cancel('Setup cancelled.');
-      process.exit(0);
+    if (!interactive) {
+      pmName = DEFAULTS.pm;
+    } else {
+      pmName = await p.select({
+        message: 'Which package manager?',
+        options: pmNames.map((n) => ({
+          value: n,
+          label: n,
+          ...(n === DEFAULTS.pm && { hint: 'default' })
+        }))
+      });
+      if (p.isCancel(pmName)) {
+        p.cancel('Setup cancelled.');
+        process.exit(0);
+      }
     }
   }
   const pm = getPm(pmName);
 
+  // log defaults notice
+  if (!interactive) {
+    const applied = {};
+    if (!flags.pm) applied.pm = pmName;
+    if (!flags.agent) applied.codeagent = DEFAULTS.agent;
+    logDefaultsNotice(applied);
+  }
+
   // verify package manager is installed
   if (!isPmInstalled(pmName)) {
     p.log.error(`${pmName} is not installed. Please install it first and try again.`);
@@ -120,6 +142,9 @@ export async function init(args) {
   const includeFonts = false;
   prependCss(projectPath, includeFonts);
 
+  // set up linting and formatting
+  await installLinting(pm, projectPath);
+
   // install components
   if (flags.components) {
     try {
@@ -138,17 +163,21 @@ export async function init(args) {
   // specify agent config
   let agent = flags.agent;
   if (!agent) {
-    agent = await p.select({
-      message: 'Install AI agent configuration?',
-      options: [
-        { value: 'none', label: 'None' },
-        { value: 'cursor', label: 'Cursor', hint: 'AGENTS.md + skills + rules' },
-        { value: 'claude', label: 'Claude Code', hint: 'CLAUDE.md + skills + rules' }
-      ]
-    });
-    if (p.isCancel(agent)) {
-      p.cancel('Setup cancelled.');
-      process.exit(0);
+    if (!interactive) {
+      agent = DEFAULTS.agent;
+    } else {
+      agent = await p.select({
+        message: 'Install AI agent configuration?',
+        options: [
+          { value: 'none', label: 'None' },
+          { value: 'cursor', label: 'Cursor', hint: 'AGENTS.md + skills + rules' },
+          { value: 'claude', label: 'Claude Code', hint: 'CLAUDE.md + skills + rules, default' }
+        ]
+      });
+      if (p.isCancel(agent)) {
+        p.cancel('Setup cancelled.');
+        process.exit(0);
+      }
     }
   }
 
@@ -167,6 +196,7 @@ export async function init(args) {
     `Location:        ${projectPath}`,
     `Package Manager: ${pm.name}`,
     `Fonts:           ${includeFonts ? 'installed' : 'skipped'}`,
+    `Linting:         configured`,
     `Components:      ${flags.components ? 'all' : 'skipped'}`,
     `Agent Config:    ${agent}`
   ].join('\n');

package/files/skills/apply-ds/SKILL.md

@@ -98,17 +98,9 @@ Identify structural opportunities to use DS composition patterns:
 
 Import patterns from `$lib/components/ui/` as needed.
 
-## Step 5: Set Up Linting and Formatting
+## Step 5: Lint and Format
 
-Run the `scripts/setup.sh` script located in this skill's directory from the project root. The script:
-
-- Installs `eslint`, `prettier`, `eslint-plugin-svelte`, `eslint-config-prettier`, `prettier-plugin-svelte`, `prettier-plugin-tailwindcss`, and `globals`
-- Creates `eslint.config.js` (flat config v9+) if it doesn't exist
-- Creates `.prettierrc` with Svelte + Tailwind plugin config if it doesn't exist
-- Creates `.prettierignore` if it doesn't exist
-- Adds `lint`, `lint:fix`, `format`, and `format:check` scripts to `package.json`
-
-After setup, run linting and formatting:
+Run linting and formatting to clean up the migrated code:
 
 ```bash
 npm run lint:fix && npm run format

package/lib/add-ds-config-codeagent.js

@@ -120,12 +120,16 @@ Usage:
   } else if (isClaude) {
     agent = 'claude';
   } else {
+    if (!process.stdin.isTTY) {
+      p.log.error('Specify --cursor or --claude in non-interactive mode.');
+      process.exit(1);
+    }
     // interactive prompt when no flag is passed
     agent = await p.select({
       message: 'Which agent configuration?',
       options: [
         { value: 'cursor', label: 'Cursor', hint: 'AGENTS.md + skills + rules' },
-        { value: 'claude', label: 'Claude Code', hint: 'CLAUDE.md + skills + rules' }
+        { value: 'claude', label: 'Claude Code', hint: 'CLAUDE.md + skills + rules, default' }
       ]
     });
     if (p.isCancel(agent)) {

package/lib/is-interactive.js

@@ -0,0 +1,19 @@
+import * as p from '@clack/prompts';
+
+export const DEFAULTS = {
+  framework: 'svelte',
+  pm: 'npm',
+  agent: 'claude'
+};
+
+export function isInteractive(flags) {
+  if (flags.defaults) return false;
+  return !!process.stdin.isTTY;
+}
+
+export function logDefaultsNotice(applied) {
+  const parts = Object.entries(applied).map(([k, v]) => `${k}=${v}`);
+  if (parts.length > 0) {
+    p.log.info(`Non-interactive mode: using defaults (${parts.join(', ')})`);
+  }
+}

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

@@ -259,6 +259,123 @@ export function createDemoPage(projectPath) {
   p.log.success('Demo page created');
 }
 
+// install linting and formatting
+export async function installLinting(pm, projectPath) {
+  const s = p.spinner();
+  s.start('Setting up linting and formatting');
+  try {
+    // install dev dependencies
+    const [cmd, ...baseArgs] = splitCmd(pm.install);
+    await run(
+      cmd,
+      [
+        ...baseArgs,
+        '-D',
+        '@eslint/js',
+        'eslint',
+        'prettier',
+        'eslint-plugin-svelte',
+        'eslint-config-prettier',
+        'prettier-plugin-svelte',
+        'prettier-plugin-tailwindcss',
+        'globals'
+      ],
+      { cwd: projectPath }
+    );
+
+    // detect CSS file for Prettier Tailwind plugin
+    let cssFile = '';
+    for (const candidate of ['src/app.css', 'src/routes/layout.css', 'src/app.pcss']) {
+      if (existsSync(join(projectPath, candidate))) {
+        cssFile = candidate;
+        break;
+      }
+    }
+
+    // create eslint.config.js
+    const eslintPath = join(projectPath, 'eslint.config.js');
+    if (!existsSync(eslintPath)) {
+      writeFile(
+        eslintPath,
+        `import js from '@eslint/js';
+import svelte from 'eslint-plugin-svelte';
+import globals from 'globals';
+import svelteConfig from './svelte.config.js';
+
+export default [
+\tjs.configs.recommended,
+\t...svelte.configs.recommended,
+\t...svelte.configs['flat/prettier'],
+\t{
+\t\tlanguageOptions: {
+\t\t\tglobals: { ...globals.browser, ...globals.node }
+\t\t}
+\t},
+\t{
+\t\tfiles: ['**/*.svelte', '**/*.svelte.js'],
+\t\tlanguageOptions: {
+\t\t\tparserOptions: { svelteConfig }
+\t\t}
+\t},
+\t{
+\t\tignores: ['.svelte-kit/', 'build/', 'dist/', 'node_modules/']
+\t}
+];
+`
+      );
+    }
+
+    // create .prettierrc
+    const prettierrcPath = join(projectPath, '.prettierrc');
+    if (!existsSync(prettierrcPath)) {
+      const prettierrc = {
+        useTabs: true,
+        singleQuote: true,
+        trailingComma: 'none',
+        printWidth: 100,
+        plugins: ['prettier-plugin-svelte', 'prettier-plugin-tailwindcss']
+      };
+      if (cssFile) {
+        prettierrc.tailwindStylesheet = `./${cssFile}`;
+      }
+      writeFile(prettierrcPath, JSON.stringify(prettierrc, null, '\t') + '\n');
+    }
+
+    // create .prettierignore
+    const prettierignorePath = join(projectPath, '.prettierignore');
+    if (!existsSync(prettierignorePath)) {
+      writeFile(
+        prettierignorePath,
+        `.svelte-kit
+.claude
+.cursor
+build
+dist
+node_modules
+package-lock.json
+`
+      );
+    }
+
+    // add lint/format scripts to package.json
+    const pkgPath = join(projectPath, 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    pkg.scripts = pkg.scripts || {};
+    pkg.scripts.lint = 'eslint .';
+    pkg.scripts['lint:fix'] = 'eslint . --fix';
+    pkg.scripts.format = 'prettier --write .';
+    pkg.scripts['format:check'] = 'prettier --check .';
+    writeFileSync(pkgPath, JSON.stringify(pkg, null, '\t') + '\n');
+
+    s.stop('Linting and formatting configured');
+    return true;
+  } catch (error) {
+    s.stop('Failed to set up linting');
+    p.log.error(error.stderr?.toString() || error.message);
+    return false;
+  }
+}
+
 // install agent configuration
 export function installAgentConfig(projectPath, agentType) {
   const s = p.spinner();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archetypeai/ds-cli",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "description": "Archetype AI Design System CLI Tool",
   "type": "module",
   "bin": {