create-semaphor-app 0.1.4 → 0.1.6

package/README.md

@@ -7,8 +7,9 @@ npx create-semaphor-app@latest
 ```
 
 The CLI scaffolds the public Semaphor Data App Starter, installs local
-dependencies by default, and can optionally install the Semaphor Agent Plugin
-for detected Codex and Claude Code installations.
+dependencies by default, installs the production Semaphor shadcn registry
+components, and can optionally install the Semaphor Agent Plugin for detected
+Codex and Claude Code installations.
 
 It does not authenticate to Semaphor, write tokens, or choose a project/domain.
 The Semaphor Agent Plugin handles OAuth, project selection, runtime token
@@ -25,7 +26,7 @@ When `app-name` is omitted, the CLI creates `./semaphor-data-app`.
 Options:
 
 ```text
---no-install              Skip dependency installation.
+--no-install              Skip dependency installation. Requires --components none.
 --package-manager <name>  Use npm, pnpm, yarn, or bun. Defaults to detected npm.
 --skip-plugin             Skip Codex/Claude plugin install prompts.
 --install-codex-plugin    Install the Codex plugin without prompting.
@@ -34,8 +35,8 @@ Options:
 --template-ref <ref>      Git branch/tag for the default starter repo. Defaults to main.
 --shadcn-preset <preset>  Apply a shadcn preset before adding Semaphor components.
 --shadcn-base <base>      Pass base or radix to shadcn init when using a preset.
---components <list>       Add Semaphor registry components. Use none, query, metrics,
-                          filters, card, table, matrix, recommended, all, or a comma-separated list.
+--components <list>       Add Semaphor registry components. Defaults to all. Use none, kit, query,
+                          metrics, filters, card, table, matrix, recommended, all, or a comma-separated list.
 --yes                     Use noninteractive defaults; skip optional plugin installs unless explicit.
 --help                    Show help.
 ```
@@ -49,10 +50,14 @@ style, pass a shadcn preset during creation:
 npx create-semaphor-app@latest my-app --shadcn-preset <preset-id>
 ```
 
-Semaphor UI helpers can be added from the public shadcn registry at scaffold
-time:
+Semaphor UI helpers are added from the public shadcn registry at scaffold time.
+By default, `create-semaphor-app` installs all production app-building
+components. Use `--components none` when you want the starter without Semaphor
+registry components:
 
 ```bash
+npx create-semaphor-app@latest my-app
+npx create-semaphor-app@latest my-app --components none
 npx create-semaphor-app@latest my-app --components table
 npx create-semaphor-app@latest my-app --components query-state,view-card,metric-kpis,filter-controls,server-data-table,matrix-table
 ```
@@ -61,7 +66,8 @@ Component presets:
 
 | Value | Installs |
 | --- | --- |
-| `none` | No Semaphor registry components. This is the default. |
+| `none` | No Semaphor registry components. |
+| `kit` | `data-app-kit`, the one-command registry bundle. |
 | `query` | `query-state` |
 | `metrics` | `query-state-boundary`, `metric-kpis` |
 | `filters` | `filter-controls` |
@@ -69,14 +75,20 @@ Component presets:
 | `table` | `query-state`, `server-data-table` |
 | `matrix` | `query-state`, `matrix-table` |
 | `recommended` | `query-state`, `query-state-boundary`, `view-card`, `metric-kpis`, `filter-controls`, `server-data-table` |
-| `all` | `query-state`, `query-state-boundary`, `view-card`, `metric-kpis`, `filter-controls`, `server-data-table`, `matrix-table` |
+| `all` | Full component set, installed through `data-app-kit`. This is the default. |
 
 Registry components install as source into the generated app. They are optional
 UI accelerators and do not replace `react-semaphor/data-app-sdk`.
-
-`--shadcn-preset` and `--components` run the shadcn CLI, so they cannot be
-combined with `--no-install`. To skip installs, scaffold the app first and run
-the shadcn commands manually later.
+The default starter keeps its shadcn primitives aligned with the public
+registry, so default component installs should not ask overwrite questions.
+`create-semaphor-app` does not pass `--overwrite`; customer-owned base
+components stay intact. During the `data-app-kit` rollout, the CLI falls back
+to one multi-component install if an older registry deployment does not have
+the kit item yet.
+
+`--shadcn-preset` and installed registry components run the shadcn CLI. To skip
+installs, pass `--no-install --components none`, then run the shadcn commands
+manually later if needed.
 
 ## Local Validation
 

package/bin/create-semaphor-app.mjs

@@ -14,6 +14,7 @@ const DEFAULT_APP_NAME = 'semaphor-data-app';
 const MARKETPLACE = 'semaphor-analytics/agent-plugin';
 const PLUGIN_ID = 'semaphor@semaphor-analytics';
 const SEMAPHOR_COMPONENT_REGISTRY = 'semaphor-analytics/semaphor-data-app-components';
+const SEMAPHOR_COMPONENT_KIT = 'data-app-kit';
 const SEMAPHOR_COMPONENT_PRESETS = Object.freeze({
   none: [],
   query: ['query-state'],
@@ -41,6 +42,8 @@ const SEMAPHOR_COMPONENT_PRESETS = Object.freeze({
   ],
 });
 const SEMAPHOR_COMPONENT_ALIASES = Object.freeze({
+  kit: SEMAPHOR_COMPONENT_KIT,
+  'data-app-kit': SEMAPHOR_COMPONENT_KIT,
   'query-state': 'query-state',
   'query-state-boundary': 'query-state-boundary',
   'view-card': 'view-card',
@@ -65,7 +68,7 @@ Usage:
   npx create-semaphor-app@latest [app-name] [options]
 
 Options:
-  --no-install              Skip dependency installation.
+  --no-install              Skip dependency installation. Requires --components none.
   --package-manager <name>  Use npm, pnpm, yarn, or bun.
   --skip-plugin             Skip Codex/Claude plugin install prompts.
   --install-codex-plugin    Install the Codex plugin without prompting.
@@ -74,8 +77,8 @@ Options:
   --template-ref <ref>      Git branch/tag for the default starter repo.
   --shadcn-preset <preset>  Apply a shadcn preset before adding Semaphor components.
   --shadcn-base <base>      Pass base or radix to shadcn init when using a preset.
-  --components <list>       Add Semaphor registry components. Use none, query, metrics,
-                            filters, card, table, matrix, recommended, all, or a comma-separated list.
+  --components <list>       Add Semaphor registry components. Defaults to all. Use none, kit, query,
+                            metrics, filters, card, table, matrix, recommended, all, or a comma-separated list.
   --yes, -y                 Use noninteractive defaults; skip optional plugin installs unless explicit.
   --help, -h                Show this help.
 `;
@@ -93,7 +96,7 @@ function parseArgs(argv) {
     templateRef: DEFAULT_TEMPLATE_REF,
     shadcnPreset: null,
     shadcnBase: null,
-    components: 'none',
+    components: 'all',
     yes: false,
     help: false,
   };
@@ -407,7 +410,7 @@ function normalizeSemaphorComponents(value) {
     }
     if (!hasOwn(SEMAPHOR_COMPONENT_ALIASES, entry)) {
       throw new Error(
-        `Unsupported Semaphor component "${entry}". Use none, query, metrics, filters, card, table, matrix, recommended, all, or one of ${Object.keys(SEMAPHOR_COMPONENT_ALIASES).join(', ')}.`,
+        `Unsupported Semaphor component "${entry}". Use none, kit, query, metrics, filters, card, table, matrix, recommended, all, or one of ${Object.keys(SEMAPHOR_COMPONENT_ALIASES).join(', ')}.`,
       );
     }
     components.push(SEMAPHOR_COMPONENT_ALIASES[entry]);
@@ -453,6 +456,44 @@ function runShadcn(packageManager, targetDir, args) {
   });
 }
 
+function selectedComponentsUseFullKit(components) {
+  const selected = new Set(components);
+  const full = SEMAPHOR_COMPONENT_PRESETS.all;
+  return selected.size === full.length && full.every((component) => selected.has(component));
+}
+
+function componentRegistryAddress(component) {
+  return `${SEMAPHOR_COMPONENT_REGISTRY}/${component}`;
+}
+
+function installSemaphorRegistryComponents(packageManager, targetDir, components) {
+  if (components.length === 0) return [];
+
+  if (selectedComponentsUseFullKit(components)) {
+    try {
+      runShadcn(packageManager, targetDir, [
+        'add',
+        componentRegistryAddress(SEMAPHOR_COMPONENT_KIT),
+      ]);
+      console.log(`✓ Added ${SEMAPHOR_COMPONENT_KIT}`);
+      return [SEMAPHOR_COMPONENT_KIT];
+    } catch {
+      console.log(
+        'data-app-kit was not available from the registry yet; falling back to individual Semaphor components.',
+      );
+    }
+  }
+
+  runShadcn(packageManager, targetDir, [
+    'add',
+    ...components.map(componentRegistryAddress),
+  ]);
+  for (const component of components) {
+    console.log(`✓ Added ${component}`);
+  }
+  return components;
+}
+
 function customizeShadcn(args, packageManager, targetDir) {
   const components = normalizeSemaphorComponents(args.components);
   const shadcnBase = normalizeShadcnBase(args.shadcnBase);
@@ -481,13 +522,7 @@ function customizeShadcn(args, packageManager, targetDir) {
 
   if (components.length > 0) {
     console.log('\nAdding Semaphor registry components...');
-    for (const component of components) {
-      runShadcn(packageManager, targetDir, [
-        'add',
-        `${SEMAPHOR_COMPONENT_REGISTRY}/${component}`,
-      ]);
-      console.log(`✓ Added ${component}`);
-    }
+    installSemaphorRegistryComponents(packageManager, targetDir, components);
   }
 
   return { presetApplied: Boolean(args.shadcnPreset), components };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-semaphor-app",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Create a Semaphor Data App starter project.",
   "type": "module",
   "bin": {

package/scripts/smoke-test.mjs

@@ -98,6 +98,8 @@ async function main() {
         '--template',
         defaultLocalStarterPath,
         '--no-install',
+        '--components',
+        'none',
         '--skip-plugin',
         '--yes',
       ], { cwd: root });
@@ -113,6 +115,8 @@ async function main() {
         '--template',
         defaultLocalStarterPath,
         '--no-install',
+        '--components',
+        'none',
         '--skip-plugin',
         '--yes',
       ], { cwd: root });
@@ -126,6 +130,8 @@ async function main() {
       const result = runCli([
         'github-template-app',
         '--no-install',
+        '--components',
+        'none',
         '--skip-plugin',
         '--yes',
       ], { cwd: root });
@@ -146,6 +152,8 @@ async function main() {
         '--template',
         defaultLocalStarterPath,
         '--no-install',
+        '--components',
+        'none',
         '--install-codex-plugin',
       ], {
         cwd: root,
@@ -168,6 +176,42 @@ async function main() {
       console.log('✓ fake Codex plugin install path');
     }
 
+    {
+      const root = createTempRoot('default-components-');
+      const binDir = path.join(root, 'bin');
+      fs.mkdirSync(binDir, { recursive: true });
+      const shadcnLog = path.join(root, 'shadcn.log');
+      const npmLog = path.join(root, 'npm.log');
+      createFakeCommand(binDir, 'npx', shadcnLog);
+      createFakeCommand(binDir, 'npm', npmLog);
+
+      const result = runCli([
+        'default-components-app',
+        '--template',
+        defaultLocalStarterPath,
+        '--skip-plugin',
+        '--yes',
+        '--package-manager',
+        'npm',
+      ], {
+        cwd: root,
+        env: {
+          ...process.env,
+          PATH: `${binDir}${path.delimiter}${process.env.PATH || ''}`,
+        },
+      });
+      assertSuccess(result, 'default component install');
+      assertScaffold(root, 'default-components-app');
+      const npmInstallLog = fs.readFileSync(npmLog, 'utf8');
+      assert(npmInstallLog.includes('npm install'), 'expected npm install command');
+      const log = fs.readFileSync(shadcnLog, 'utf8');
+      assert(
+        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/data-app-kit'),
+        'expected default data-app-kit registry add command',
+      );
+      console.log('✓ default Semaphor registry component install');
+    }
+
     {
       const root = createTempRoot('shadcn-');
       const binDir = path.join(root, 'bin');
@@ -208,34 +252,89 @@ async function main() {
         'expected shadcn preset init command',
       );
       assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/query-state'),
-        'expected query-state registry add command',
-      );
-      assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/query-state-boundary'),
-        'expected query-state-boundary registry add command',
-      );
-      assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/view-card'),
-        'expected view-card registry add command',
-      );
-      assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/metric-kpis'),
-        'expected metric-kpis registry add command',
-      );
-      assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/filter-controls'),
-        'expected filter-controls registry add command',
+        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/data-app-kit'),
+        'expected full component selection to use data-app-kit registry add command',
       );
+      console.log('✓ shadcn preset and registry component path');
+    }
+
+    {
+      const root = createTempRoot('component-kit-alias-');
+      const binDir = path.join(root, 'bin');
+      fs.mkdirSync(binDir, { recursive: true });
+      const shadcnLog = path.join(root, 'shadcn.log');
+      const npmLog = path.join(root, 'npm.log');
+      createFakeCommand(binDir, 'npx', shadcnLog);
+      createFakeCommand(binDir, 'npm', npmLog);
+
+      const result = runCli([
+        'kit-alias-app',
+        '--template',
+        defaultLocalStarterPath,
+        '--skip-plugin',
+        '--yes',
+        '--package-manager',
+        'npm',
+        '--components',
+        'kit',
+      ], {
+        cwd: root,
+        env: {
+          ...process.env,
+          PATH: `${binDir}${path.delimiter}${process.env.PATH || ''}`,
+        },
+      });
+      assertSuccess(result, 'component kit alias install');
+      assertScaffold(root, 'kit-alias-app');
+      const log = fs.readFileSync(shadcnLog, 'utf8');
       assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/server-data-table'),
-        'expected server-data-table registry add command',
+        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/data-app-kit'),
+        'expected kit alias to use data-app-kit registry add command',
       );
+      console.log('✓ Semaphor data-app-kit component alias');
+    }
+
+    {
+      const root = createTempRoot('component-subset-');
+      const binDir = path.join(root, 'bin');
+      fs.mkdirSync(binDir, { recursive: true });
+      const shadcnLog = path.join(root, 'shadcn.log');
+      const npmLog = path.join(root, 'npm.log');
+      createFakeCommand(binDir, 'npx', shadcnLog);
+      createFakeCommand(binDir, 'npm', npmLog);
+
+      const result = runCli([
+        'subset-app',
+        '--template',
+        defaultLocalStarterPath,
+        '--skip-plugin',
+        '--yes',
+        '--package-manager',
+        'npm',
+        '--components',
+        'table,filters',
+      ], {
+        cwd: root,
+        env: {
+          ...process.env,
+          PATH: `${binDir}${path.delimiter}${process.env.PATH || ''}`,
+        },
+      });
+      assertSuccess(result, 'component subset install');
+      assertScaffold(root, 'subset-app');
+      const log = fs.readFileSync(shadcnLog, 'utf8');
       assert(
-        log.includes('npx shadcn@latest add semaphor-analytics/semaphor-data-app-components/matrix-table'),
-        'expected matrix-table registry add command',
+        log.includes(
+          [
+            'npx shadcn@latest add',
+            'semaphor-analytics/semaphor-data-app-components/query-state',
+            'semaphor-analytics/semaphor-data-app-components/server-data-table',
+            'semaphor-analytics/semaphor-data-app-components/filter-controls',
+          ].join(' '),
+        ),
+        'expected subset components to install in one registry add command',
       );
-      console.log('✓ shadcn preset and registry component path');
+      console.log('✓ Semaphor component subset installs in one command');
     }
 
     {