create-semaphor-app 0.1.6 → 0.1.8

package/README.md

@@ -7,9 +7,10 @@ npx create-semaphor-app@latest
 ```
 
 The CLI scaffolds the public Semaphor Data App Starter, installs local
-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.
+dependencies by default, and can optionally install the Semaphor Agent Plugin
+for detected Codex and Claude Code installations. The starter already includes
+the Semaphor-specific Data App components and local samples used by agents for
+first-run dashboard quality.
 
 It does not authenticate to Semaphor, write tokens, or choose a project/domain.
 The Semaphor Agent Plugin handles OAuth, project selection, runtime token
@@ -26,22 +27,20 @@ When `app-name` is omitted, the CLI creates `./semaphor-data-app`.
 Options:
 
 ```text
---no-install              Skip dependency installation. Requires --components none.
+--no-install              Skip dependency installation.
 --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.
 --install-claude-plugin   Install the Claude Code plugin without prompting.
 --template <source>       Starter source. Defaults to the public starter repo.
 --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-preset <preset>  Apply a shadcn preset after scaffolding.
 --shadcn-base <base>      Pass base or radix to shadcn init when using a preset.
---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.
 ```
 
-## shadcn Presets And Semaphor Components
+## shadcn Presets
 
 The starter ships with a working shadcn setup. For teams that bring their own
 style, pass a shadcn preset during creation:
@@ -50,45 +49,28 @@ style, pass a shadcn preset during creation:
 npx create-semaphor-app@latest my-app --shadcn-preset <preset-id>
 ```
 
-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:
+`--shadcn-preset` runs the shadcn CLI. To skip installs entirely, pass
+`--no-install`, then run dependency and shadcn commands manually later if
+needed.
 
-```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
-```
+## Included Semaphor Components
+
+The generated starter includes Semaphor-specific source components under
+`src/components/semaphor/*` and browsable local samples at `/samples`. The
+components are normal app source files, not a separate runtime package:
+
+- query loading/error/empty/success states;
+- SDK-shaped query state boundaries;
+- view cards with scoped filter affordances;
+- metric KPI and multi-measure KPI helpers;
+- filter controls;
+- server-backed tables;
+- matrix/pivot tables.
 
-Component presets:
-
-| Value | Installs |
-| --- | --- |
-| `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` |
-| `card` | `view-card` |
-| `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` | 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`.
-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.
+This keeps the default scaffold fast and avoids shadcn overwrite prompts for
+Semaphor components. Customers can still customize shadcn primitives or apply a
+preset, but the default path does not require installing a second component
+registry.
 
 ## Local Validation
 

package/bin/create-semaphor-app.mjs

@@ -13,50 +13,6 @@ const DEFAULT_TEMPLATE_REF = 'main';
 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'],
-  table: ['query-state', 'server-data-table'],
-  metrics: ['query-state-boundary', 'metric-kpis'],
-  filters: ['filter-controls'],
-  card: ['view-card'],
-  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',
-  ],
-});
-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',
-  card: 'view-card',
-  'server-data-table': 'server-data-table',
-  table: 'server-data-table',
-  'metric-kpis': 'metric-kpis',
-  kpis: 'metric-kpis',
-  'filter-controls': 'filter-controls',
-  filters: 'filter-controls',
-  'matrix-table': 'matrix-table',
-  matrix: 'matrix-table',
-});
 const canPrompt = Boolean(process.stdin.isTTY && process.stdout.isTTY);
 
 const cwd = process.cwd();
@@ -68,17 +24,15 @@ Usage:
   npx create-semaphor-app@latest [app-name] [options]
 
 Options:
-  --no-install              Skip dependency installation. Requires --components none.
+  --no-install              Skip dependency installation.
   --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.
   --install-claude-plugin   Install the Claude Code plugin without prompting.
   --template <source>       Starter source. Can be a local directory or git URL.
   --template-ref <ref>      Git branch/tag for the default starter repo.
-  --shadcn-preset <preset>  Apply a shadcn preset before adding Semaphor components.
+  --shadcn-preset <preset>  Apply a shadcn preset after scaffolding.
   --shadcn-base <base>      Pass base or radix to shadcn init when using a preset.
-  --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.
 `;
@@ -96,7 +50,6 @@ function parseArgs(argv) {
     templateRef: DEFAULT_TEMPLATE_REF,
     shadcnPreset: null,
     shadcnBase: null,
-    components: 'all',
     yes: false,
     help: false,
   };
@@ -133,10 +86,6 @@ function parseArgs(argv) {
       parsed.shadcnBase = readRequiredValue(argv, ++i, arg);
     } else if (arg.startsWith('--shadcn-base=')) {
       parsed.shadcnBase = arg.slice('--shadcn-base='.length);
-    } else if (arg === '--components') {
-      parsed.components = readRequiredValue(argv, ++i, arg);
-    } else if (arg.startsWith('--components=')) {
-      parsed.components = arg.slice('--components='.length);
     } else if (arg === '--yes' || arg === '-y') {
       parsed.yes = true;
     } else if (arg.startsWith('-')) {
@@ -288,10 +237,6 @@ function resolvePackageManager(requested) {
   return 'npm';
 }
 
-function hasOwn(object, key) {
-  return Object.prototype.hasOwnProperty.call(object, key);
-}
-
 function resolveShadcnRunner(packageManager) {
   if (packageManager === 'pnpm') {
     return { command: 'pnpm', args: ['dlx', 'shadcn@latest'] };
@@ -395,30 +340,6 @@ function loadTemplate(template, templateRef) {
   return { tempRoot, templateDir };
 }
 
-function normalizeSemaphorComponents(value) {
-  const raw = String(value || 'none')
-    .split(',')
-    .map((entry) => entry.trim().toLowerCase())
-    .filter(Boolean);
-  if (raw.length === 0) return [];
-
-  const components = [];
-  for (const entry of raw) {
-    if (hasOwn(SEMAPHOR_COMPONENT_PRESETS, entry)) {
-      components.push(...SEMAPHOR_COMPONENT_PRESETS[entry]);
-      continue;
-    }
-    if (!hasOwn(SEMAPHOR_COMPONENT_ALIASES, entry)) {
-      throw new Error(
-        `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]);
-  }
-
-  return Array.from(new Set(components));
-}
-
 function normalizeShadcnBase(value) {
   if (!value) return null;
   const normalized = String(value).trim().toLowerCase();
@@ -429,7 +350,6 @@ function normalizeShadcnBase(value) {
 }
 
 function validateScaffoldOptions(args) {
-  const components = normalizeSemaphorComponents(args.components);
   normalizeShadcnBase(args.shadcnBase);
 
   if (args.shadcnBase && !args.shadcnPreset) {
@@ -440,9 +360,9 @@ function validateScaffoldOptions(args) {
     throw new Error('--shadcn-preset requires a non-empty preset id.');
   }
 
-  if (!args.install && (args.shadcnPreset || components.length > 0)) {
+  if (!args.install && args.shadcnPreset) {
     throw new Error(
-      '--no-install cannot be combined with --shadcn-preset or --components. Run create-semaphor-app with installs enabled, or add shadcn components manually after scaffolding.',
+      '--no-install cannot be combined with --shadcn-preset. Run create-semaphor-app with installs enabled, or apply the shadcn preset manually after scaffolding.',
     );
   }
 }
@@ -456,50 +376,11 @@ 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);
 
-  if (!args.shadcnPreset && components.length === 0) {
-    return { presetApplied: false, components };
+  if (!args.shadcnPreset) {
+    return { presetApplied: false };
   }
 
   if (args.shadcnPreset) {
@@ -520,12 +401,7 @@ function customizeShadcn(args, packageManager, targetDir) {
     console.log('✓ Applied shadcn preset');
   }
 
-  if (components.length > 0) {
-    console.log('\nAdding Semaphor registry components...');
-    installSemaphorRegistryComponents(packageManager, targetDir, components);
-  }
-
-  return { presetApplied: Boolean(args.shadcnPreset), components };
+  return { presetApplied: true };
 }
 
 function detectAgents() {
@@ -630,14 +506,9 @@ function printNextSteps({ targetDir, packageManager, pluginSummary, shadcnSummar
   console.log(`  cd ${relativeTarget}`);
   console.log(`  ${packageManager} run dev`);
 
-  if (shadcnSummary?.presetApplied || shadcnSummary?.components?.length > 0) {
+  if (shadcnSummary?.presetApplied) {
     console.log('\nConfigured shadcn:');
-    if (shadcnSummary.presetApplied) {
-      console.log('  - Applied custom preset');
-    }
-    for (const component of shadcnSummary.components ?? []) {
-      console.log(`  - Added Semaphor ${component}`);
-    }
+    console.log('  - Applied custom preset');
   }
 
   if (pluginSummary?.skipped) {

package/package.json

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

package/scripts/smoke-test.mjs

@@ -98,8 +98,6 @@ async function main() {
         '--template',
         defaultLocalStarterPath,
         '--no-install',
-        '--components',
-        'none',
         '--skip-plugin',
         '--yes',
       ], { cwd: root });
@@ -115,8 +113,6 @@ async function main() {
         '--template',
         defaultLocalStarterPath,
         '--no-install',
-        '--components',
-        'none',
         '--skip-plugin',
         '--yes',
       ], { cwd: root });
@@ -130,8 +126,6 @@ async function main() {
       const result = runCli([
         'github-template-app',
         '--no-install',
-        '--components',
-        'none',
         '--skip-plugin',
         '--yes',
       ], { cwd: root });
@@ -152,8 +146,6 @@ async function main() {
         '--template',
         defaultLocalStarterPath,
         '--no-install',
-        '--components',
-        'none',
         '--install-codex-plugin',
       ], {
         cwd: root,
@@ -176,42 +168,6 @@ 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');
@@ -233,8 +189,6 @@ async function main() {
         'test-preset',
         '--shadcn-base',
         'base',
-        '--components',
-        'recommended,matrix-table',
       ], {
         cwd: root,
         env: {
@@ -242,7 +196,7 @@ async function main() {
           PATH: `${binDir}${path.delimiter}${process.env.PATH || ''}`,
         },
       });
-      assertSuccess(result, 'shadcn preset and component install');
+      assertSuccess(result, 'shadcn preset install');
       assertScaffold(root, 'styled-app');
       const npmInstallLog = fs.readFileSync(npmLog, 'utf8');
       assert(npmInstallLog.includes('npm install'), 'expected npm install command');
@@ -252,89 +206,10 @@ async function main() {
         'expected shadcn preset init command',
       );
       assert(
-        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',
+        !log.includes('npx shadcn@latest add'),
+        'create-semaphor-app should not run shadcn add during scaffold',
       );
-      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/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/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('✓ Semaphor component subset installs in one command');
+      console.log('✓ shadcn preset path');
     }
 
     {
@@ -346,8 +221,8 @@ async function main() {
         '--no-install',
         '--skip-plugin',
         '--yes',
-        '--components',
-        'table',
+        '--shadcn-preset',
+        'test-preset',
       ], { cwd: root });
       assert(result.status !== 0, 'expected shadcn options with --no-install to fail');
       assert(