@c15t/cli 2.0.0-rc.5 → 2.0.0-rc.8

package/dist-types/auth/base-url.d.ts

@@ -1,5 +1,5 @@
 /**
- * Resolve the control-plane base URL for auth + instance management.
+ * Resolve the control-plane base URL for auth + hosted project management.
  *
  * Default: consent.io
  * Override: CONSENT_URL

package/dist-types/auth/config-store.d.ts

@@ -45,11 +45,11 @@ export declare function isLoggedIn(): Promise<boolean>;
  */
 export declare function getAccessToken(): Promise<string | null>;
 /**
- * Get the selected instance ID
+ * Get the selected project ID
  */
 export declare function getSelectedInstanceId(): Promise<string | null>;
 /**
- * Set the selected instance ID
+ * Set the selected project ID
  */
 export declare function setSelectedInstanceId(instanceId: string): Promise<void>;
 /**

package/dist-types/auth/types.d.ts

@@ -11,7 +11,7 @@ export interface C15tConfig {
     refreshToken?: string;
     /** Token expiration timestamp (unix ms) */
     expiresAt?: number;
-    /** Currently selected instance ID */
+    /** Currently selected project ID */
     selectedInstanceId?: string;
     /** Last login timestamp */
     lastLogin?: number;

package/dist-types/commands/codemods/add-stylesheet-imports.d.ts

@@ -0,0 +1,54 @@
+export interface CodemodRunOptions {
+    /**
+     * Absolute or relative project root to scan for source files.
+     */
+    projectRoot: string;
+    /**
+     * Whether to skip saving transformed files.
+     */
+    dryRun: boolean;
+}
+/**
+ * Result summary for a codemod run.
+ */
+export interface CodemodRunResult {
+    /**
+     * Number of source files scanned.
+     */
+    totalFiles: number;
+    /**
+     * Per-file transformation summaries.
+     */
+    changedFiles: Array<{
+        filePath: string;
+        operations: number;
+        summaries: string[];
+    }>;
+    /**
+     * Non-fatal per-file transform errors.
+     */
+    errors: Array<{
+        filePath: string;
+        error: string;
+    }>;
+}
+/**
+ * Runs the add-stylesheet-imports codemod across project source files.
+ *
+ * Detects whether the project uses styled c15t UI components and adds the
+ * required CSS import(s) to the appropriate root entrypoint file.
+ *
+ * @param options Codemod execution options.
+ * @returns Summary with changed files and non-fatal per-file errors.
+ *
+ * @example
+ * ```ts
+ * const result = await runAddStylesheetImportsCodemod({
+ *   projectRoot: process.cwd(),
+ *   dryRun: true,
+ * });
+ * ```
+ *
+ * @throws Propagates unexpected setup failures such as directory traversal errors.
+ */
+export declare function runAddStylesheetImportsCodemod(options: CodemodRunOptions): Promise<CodemodRunResult>;

package/dist-types/commands/generate/prompts/theme.d.ts

@@ -42,4 +42,4 @@ export declare function generateThemeConfig(theme: ThemeId): string;
 /**
  * Generate CSS import for theme
  */
-export declare function getThemeCssImport(theme: ThemeId): string | null;
+export declare function getThemeCssImport(theme: ThemeId, framework?: 'react' | 'nextjs'): string | null;

package/dist-types/commands/generate/templates/css.d.ts

@@ -1,11 +1,10 @@
-/**
- * Updates the project's CSS file for Tailwind v3 compatibility if needed
- *
- * @param projectRoot - The root directory of the project
- * @param tailwindVersion - The detected Tailwind version
- * @returns Object indicating if the update was successful and the file path
- */
-export declare function updateTailwindCss(projectRoot: string, tailwindVersion: string | null): Promise<{
-    updated: boolean;
-    filePath: string | null;
-}>;
+import { type EnsureGlobalCssStylesheetImportsResult, type StyledPackageName } from '../../shared/stylesheets';
+export interface UpdateAppStylesheetImportsOptions {
+    projectRoot: string;
+    packageName: Exclude<StyledPackageName, '@c15t/ui'>;
+    tailwindVersion: string | null;
+    entrypointPath?: string | null;
+    dryRun?: boolean;
+    includeIab?: boolean;
+}
+export declare function updateAppStylesheetImports(options: UpdateAppStylesheetImportsOptions): Promise<EnsureGlobalCssStylesheetImportsResult>;

package/dist-types/commands/generate/templates/shared/components.d.ts

@@ -17,7 +17,7 @@ interface GenerateConsentComponentOptions {
     defaultExport?: boolean;
     /** Whether to add ssrData prop passed inside options object (App Dir client with SSR) */
     ssrDataOption?: boolean;
-    /** Whether to add geo override for development (shows banner in non-EU countries) */
+    /** Whether to add geo override for development */
     includeOverrides?: boolean;
     /** Whether to add c15t DevTools component */
     enableDevTools?: boolean;

package/dist-types/commands/index.d.ts

@@ -4,6 +4,6 @@
 export { authCommands, loginCommand, logoutCommand } from './auth';
 export { codemodsCommand, runCodemods } from './codemods';
 export { generate, generateCommand } from './generate';
-export { instancesCommand } from './instances';
+export { instancesAliasCommand, projectsCommand } from './instances';
 export { selfHost } from './self-host';
 export { installSkills } from './skills';

package/dist-types/commands/instances/index.d.ts

@@ -1,21 +1,26 @@
 /**
- * Instance management commands
+ * Project management commands
  */
-import type { CliCommand, CliContext } from '../../types';
+import type { CliCommand, CliContext } from '../../context/types';
 /**
- * List instances command
+ * List projects command
  */
 declare function listAction(context: CliContext): Promise<void>;
 /**
- * Select instance command
+ * Select project command
  */
 declare function selectAction(context: CliContext): Promise<void>;
 /**
- * Create instance command
+ * Create project command
  */
 declare function createAction(context: CliContext): Promise<void>;
 /**
- * Instances command definition
+ * Main projects command (defaults to list)
  */
-export declare const instancesCommand: CliCommand;
-export { listAction, selectAction, createAction };
+declare function projectsAction(context: CliContext): Promise<void>;
+/**
+ * Projects command definition
+ */
+export declare const projectsCommand: CliCommand;
+export declare const instancesAliasCommand: CliCommand;
+export { createAction, listAction, projectsAction, selectAction };

package/dist-types/commands/self-host/migrate/migrator-result.d.ts

@@ -1,3 +1,3 @@
-import type { MigrationResult } from '../../../../../backend/dist-types/db/migrator';
+import type { MigrationResult } from '@c15t/backend/db/migrator';
 import type { CliContext } from '../../../context/types';
 export declare function handleMigrationResult(context: CliContext, result: MigrationResult): Promise<void>;

package/dist-types/commands/self-host/migrate/orm-result.d.ts

@@ -1,3 +1,3 @@
-import type { ORMResult } from '../../../../../backend/dist-types/db/migrator';
+import type { ORMResult } from '@c15t/backend/db/migrator';
 import type { CliContext } from '../../../context/types';
 export declare function handleORMResult(context: CliContext, result: ORMResult): Promise<void>;

package/dist-types/commands/self-host/migrate/read-config.d.ts

@@ -1,4 +1,4 @@
-import { DB } from '../../../../../backend/dist-types/db/schema';
+import { DB } from '@c15t/backend/db/schema';
 import type { CliContext } from '../../../context/types';
 export declare function readConfigAndGetDb(context: CliContext, absoluteConfigPath: string): Promise<{
     db: ReturnType<typeof DB.client>;

package/dist-types/commands/shared/stylesheets.d.ts

@@ -0,0 +1,19 @@
+export type StyledPackageName = '@c15t/react' | '@c15t/nextjs' | '@c15t/ui';
+export interface EnsureGlobalCssStylesheetImportsOptions {
+    projectRoot: string;
+    packageName: StyledPackageName;
+    tailwindVersion: string | null;
+    entrypointPath?: string | null;
+    includeBase: boolean;
+    includeIab: boolean;
+    dryRun?: boolean;
+}
+export interface EnsureGlobalCssStylesheetImportsResult {
+    updated: boolean;
+    filePath: string | null;
+    searchedPaths: string[];
+    changes: string[];
+}
+export declare function formatSearchedCssPaths(projectRoot: string, searchedPaths: string[]): string;
+export declare function isTailwindV3(version: string | null): boolean;
+export declare function ensureGlobalCssStylesheetImports(options: EnsureGlobalCssStylesheetImportsOptions): Promise<EnsureGlobalCssStylesheetImportsResult>;

package/dist-types/constants.d.ts

@@ -7,6 +7,8 @@
 export declare const URLS: {
     /** Default c15t cloud platform URL */
     readonly CONSENT_IO: "https://consent.io";
+    /** First-party telemetry logs endpoint */
+    readonly TELEMETRY: "https://telemetry.c15t.com/c15t/v1/logs";
     /** Documentation website */
     readonly DOCS: "https://v2.c15t.com/docs";
     /** GitHub repository */
@@ -25,6 +27,10 @@ export declare const PATHS: {
     readonly CONFIG_DIR: ".c15t";
     /** Config file name */
     readonly CONFIG_FILE: "config.json";
+    /** Telemetry state file name */
+    readonly TELEMETRY_STATE_FILE: "telemetry.json";
+    /** Telemetry retry queue file name */
+    readonly TELEMETRY_QUEUE_FILE: "telemetry-queue.json";
     /** Project config file name */
     readonly PROJECT_CONFIG: "c15t.config.ts";
     /** Alternative project config file name */
@@ -71,6 +77,12 @@ export declare const ENV_VARS: {
     readonly V2: "V2";
     /** Disable telemetry */
     readonly TELEMETRY_DISABLED: "C15T_TELEMETRY_DISABLED";
+    /** Override telemetry ingest endpoint */
+    readonly TELEMETRY_ENDPOINT: "C15T_TELEMETRY_ENDPOINT";
+    /** Optional write key for telemetry ingest */
+    readonly TELEMETRY_WRITE_KEY: "C15T_TELEMETRY_WRITE_KEY";
+    /** Optional Axiom org ID for telemetry ingest */
+    readonly TELEMETRY_ORG_ID: "C15T_TELEMETRY_ORG_ID";
     /** Control-plane/dashboard base URL override */
     readonly CONSENT_URL: "CONSENT_URL";
     /** c15t backend URL */

package/dist-types/context/types.d.ts

@@ -1,4 +1,4 @@
-import type { C15TOptions } from '../../../backend/dist-types/core.d.ts';
+import type { C15TOptions } from '@c15t/backend/core';
 import type { CliLogger } from '../utils/logger';
 import type { Telemetry } from '../utils/telemetry';
 import type { FrameworkDetectionResult } from './framework-detection';
@@ -9,6 +9,8 @@ export interface CliCommand {
     hint: string;
     description: string;
     action: (context: CliContext) => Promise<void>;
+    subcommands?: CliCommand[];
+    hidden?: boolean;
 }
 export type FlagType = 'boolean' | 'string' | 'special';
 export interface CliFlag {

package/dist-types/control-plane/client.d.ts

@@ -1,10 +1,10 @@
 /**
- * Control-plane client for c15t instances.
+ * Control-plane client for c15t hosted projects.
  */
 import type { Instance } from '../types';
 import type { ControlPlaneClientConfig, ControlPlaneConnectionState, ControlPlaneOrganization, ControlPlaneRegion, CreateInstanceRequest } from './types';
 /**
- * Client for c15t instances.
+ * Client for c15t hosted projects.
  *
  * Uses direct control-plane HTTP endpoints under /api/v1.
  */
@@ -30,19 +30,19 @@ export declare class ControlPlaneClient {
     listOrganizations(): Promise<ControlPlaneOrganization[]>;
     listRegions(): Promise<ControlPlaneRegion[]>;
     /**
-     * List all instances for the authenticated user.
+     * List all hosted projects for the authenticated user.
      */
     listInstances(): Promise<Instance[]>;
     /**
-     * Get a specific instance by ID.
+     * Get a specific hosted project by ID.
      */
     getInstance(id: string): Promise<Instance>;
     /**
-     * Create a new instance.
+     * Create a new hosted project.
      */
     createInstance(request: CreateInstanceRequest): Promise<Instance>;
     /**
-     * Delete an instance.
+     * Delete a hosted project.
      */
     deleteInstance(id: string): Promise<void>;
 }

package/dist-types/control-plane/types.d.ts

@@ -39,14 +39,14 @@ export interface ControlPlaneCapabilities {
     version?: string;
 }
 /**
- * Create instance request
+ * Create hosted project request
  */
 export interface CreateInstanceRequest {
-    /** Instance name */
+    /** Project slug */
     name: string;
-    /** Instance configuration */
+    /** Project configuration */
     config: {
-        /** Organization slug to create the instance under */
+        /** Organization slug to create the project under */
         organizationSlug: string;
         /** Region ID for provisioning */
         region: string;
@@ -64,7 +64,7 @@ export interface ControlPlaneOrganization {
     role: string;
 }
 /**
- * Provisioning region for control-plane instances
+ * Provisioning region for control-plane projects
  */
 export interface ControlPlaneRegion {
     id: string;

package/dist-types/core/errors.d.ts

@@ -92,17 +92,17 @@ export declare const ERROR_CATALOG: {
     readonly URL_INVALID: {
         readonly code: "URL_INVALID";
         readonly message: "Invalid URL format";
-        readonly hint: "Expected format: https://your-instance.c15t.dev";
+        readonly hint: "Expected format: https://your-project.c15t.dev";
     };
     readonly INSTANCE_NOT_FOUND: {
         readonly code: "INSTANCE_NOT_FOUND";
-        readonly message: "Instance not found";
-        readonly hint: "Run `c15t instances list` to see available instances";
+        readonly message: "Project not found";
+        readonly hint: "Run `c15t projects list` to see available projects";
     };
     readonly INSTANCE_NAME_INVALID: {
         readonly code: "INSTANCE_NAME_INVALID";
-        readonly message: "Invalid instance name";
-        readonly hint: "Instance names must be alphanumeric with hyphens";
+        readonly message: "Invalid project slug";
+        readonly hint: "Project slugs must be alphanumeric with hyphens";
     };
     readonly FILE_NOT_FOUND: {
         readonly code: "FILE_NOT_FOUND";

package/dist-types/core/telemetry.d.ts

@@ -1,77 +1,2 @@
-/**
- * Telemetry module for the c15t CLI
- *
- * Provides anonymous usage tracking to help improve the CLI.
- * Respects user preferences and can be disabled via --no-telemetry flag
- * or C15T_TELEMETRY_DISABLED environment variable.
- */
-import { PostHog } from 'posthog-node';
-import type { CliLogger, Telemetry } from '../types';
-export declare const TelemetryEventName: {
-    readonly CLI_INVOKED: "cli.invoked";
-    readonly CLI_COMPLETED: "cli.completed";
-    readonly CLI_EXITED: "cli.exited";
-    readonly CLI_ENVIRONMENT_DETECTED: "cli.environment_detected";
-    readonly COMMAND_EXECUTED: "command.executed";
-    readonly COMMAND_SUCCEEDED: "command.succeeded";
-    readonly COMMAND_FAILED: "command.failed";
-    readonly COMMAND_UNKNOWN: "command.unknown";
-    readonly INTERACTIVE_MENU_OPENED: "ui.menu.opened";
-    readonly INTERACTIVE_MENU_EXITED: "ui.menu.exited";
-    readonly AUTH_LOGIN_STARTED: "auth.login.started";
-    readonly AUTH_LOGIN_SUCCEEDED: "auth.login.succeeded";
-    readonly AUTH_LOGIN_FAILED: "auth.login.failed";
-    readonly AUTH_LOGOUT: "auth.logout";
-    readonly CONFIG_LOADED: "config.loaded";
-    readonly CONFIG_ERROR: "config.error";
-    readonly CONFIG_UPDATED: "config.updated";
-    readonly HELP_DISPLAYED: "help.displayed";
-    readonly VERSION_DISPLAYED: "version.displayed";
-    readonly ONBOARDING_STARTED: "onboarding.started";
-    readonly ONBOARDING_COMPLETED: "onboarding.completed";
-    readonly ONBOARDING_EXITED: "onboarding.exited";
-    readonly ONBOARDING_STORAGE_MODE_SELECTED: "onboarding.storage_mode_selected";
-    readonly ONBOARDING_C15T_MODE_CONFIGURED: "onboarding.c15t_mode_configured";
-    readonly ONBOARDING_OFFLINE_MODE_CONFIGURED: "onboarding.offline_mode_configured";
-    readonly ONBOARDING_SELF_HOSTED_CONFIGURED: "onboarding.self_hosted_configured";
-    readonly ONBOARDING_CUSTOM_MODE_CONFIGURED: "onboarding.custom_mode_configured";
-    readonly ONBOARDING_DEPENDENCIES_CHOICE: "onboarding.dependencies_choice";
-    readonly ONBOARDING_DEPENDENCIES_INSTALLED: "onboarding.dependencies_installed";
-    readonly ONBOARDING_GITHUB_STAR: "onboarding.github_star";
-    readonly INSTANCES_LISTED: "instances.listed";
-    readonly INSTANCE_SELECTED: "instance.selected";
-    readonly INSTANCE_CREATED: "instance.created";
-    readonly ERROR_OCCURRED: "error.occurred";
-    readonly MIGRATION_STARTED: "migration.started";
-    readonly MIGRATION_PLANNED: "migration.planned";
-    readonly MIGRATION_EXECUTED: "migration.executed";
-    readonly MIGRATION_COMPLETED: "migration.completed";
-    readonly MIGRATION_FAILED: "migration.failed";
-    readonly GENERATE_STARTED: "generate.started";
-    readonly GENERATE_COMPLETED: "generate.completed";
-    readonly GENERATE_FAILED: "generate.failed";
-    readonly SELF_HOST_STARTED: "self-host.started";
-    readonly SELF_HOST_COMPLETED: "self-host.completed";
-    readonly SELF_HOST_FAILED: "self-host.failed";
-};
-export type TelemetryEventNameType = (typeof TelemetryEventName)[keyof typeof TelemetryEventName];
-export interface TelemetryOptions {
-    /** Custom PostHog client instance */
-    client?: PostHog;
-    /** Disable telemetry */
-    disabled?: boolean;
-    /** Enable debug mode */
-    debug?: boolean;
-    /** Default properties for all events */
-    defaultProperties?: Record<string, string | number | boolean>;
-    /** Logger instance */
-    logger?: CliLogger;
-}
-/**
- * Create a telemetry instance
- */
-export declare function createTelemetry(options?: TelemetryOptions): Telemetry;
-/**
- * Create a disabled telemetry instance (for testing)
- */
-export declare function createDisabledTelemetry(): Telemetry;
+export { createTelemetry, Telemetry, TelemetryEventName, type TelemetryEventName as TelemetryEventNameType, type TelemetryOptions, } from '../utils/telemetry';
+export declare function createDisabledTelemetry(): import("./telemetry").Telemetry;

package/dist-types/machines/generate/machine.d.ts

@@ -142,6 +142,12 @@ export declare const generateMachine: import("xstate").StateMachine<GenerateMach
 } | {
     type: "preflightPassed";
     params: unknown;
+} | {
+    type: "installConfirmed";
+    params: unknown;
+} | {
+    type: "installSucceeded";
+    params: unknown;
 } | {
     type: "preflightFailed";
     params: unknown;
@@ -184,12 +190,6 @@ export declare const generateMachine: import("xstate").StateMachine<GenerateMach
 } | {
     type: "isExpandedUIStyle";
     params: unknown;
-} | {
-    type: "installConfirmed";
-    params: unknown;
-} | {
-    type: "installSucceeded";
-    params: unknown;
 } | {
     type: "hasFilesToRollback";
     params: unknown;
@@ -208,7 +208,7 @@ export declare const generateMachine: import("xstate").StateMachine<GenerateMach
 } | {
     type: "shouldPromptUIStyle";
     params: unknown;
-}, never, "error" | "exited" | "complete" | "preflightError" | "idle" | "preflight" | "modeSelection" | "hostedMode" | "offlineMode" | "customMode" | "backendOptions" | "frontendOptions" | "scriptsOptions" | "fileGeneration" | "dependencyInstall" | "summary" | "skillsInstall" | "githubStar" | "cancelling" | "rollback" | "routeToMode" | "dependencyCheck" | "dependencyConfirm", string, {
+}, never, "error" | "exited" | "complete" | "idle" | "preflight" | "preflightError" | "modeSelection" | "hostedMode" | "offlineMode" | "customMode" | "backendOptions" | "frontendOptions" | "scriptsOptions" | "fileGeneration" | "dependencyInstall" | "summary" | "skillsInstall" | "githubStar" | "cancelling" | "dependencyCheck" | "dependencyConfirm" | "rollback" | "routeToMode", string, {
     cliContext: CliContext;
     modeArg?: StorageMode;
 }, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {

package/dist-types/types.d.ts

@@ -2,6 +2,7 @@
  * Shared type definitions for the c15t CLI
  */
 import type { AvailablePackage as AvailablePackageType, StorageMode as StorageModeType } from './constants';
+import type { CliLogger as SharedCliLogger } from './utils/logger';
 export type StorageMode = StorageModeType;
 export type AvailablePackage = AvailablePackageType;
 export interface CliCommand {
@@ -85,18 +86,7 @@ export interface PackageManagerResult {
     /** Execute command (npx, bunx, etc.) */
     execCommand: string;
 }
-export interface CliLogger {
-    debug(message: string, ...args: unknown[]): void;
-    info(message: string, ...args: unknown[]): void;
-    warn(message: string, ...args: unknown[]): void;
-    error(message: string, ...args: unknown[]): void;
-    message(message: string): void;
-    note(content: string, title?: string): void;
-    success(message: string): void;
-    failed(message: string): never;
-    outro(message: string): void;
-    step(current: number, total: number, label: string): void;
-}
+export type CliLogger = SharedCliLogger;
 export interface ErrorHandlers {
     /** Handle an error and exit */
     handleError: (error: unknown, message: string) => never;
@@ -128,7 +118,7 @@ export interface FileSystemUtils {
 }
 export interface Telemetry {
     /** Track an event */
-    trackEvent: (eventName: string, properties?: Record<string, string | number | boolean | undefined>) => void;
+    trackEvent: (eventName: string, properties?: Record<string, unknown>) => void;
     /** Track a command execution */
     trackCommand: (command: string, args?: string[], flags?: Record<string, string | number | boolean | undefined>) => void;
     /** Track an error */
@@ -173,7 +163,7 @@ export interface GenerateOptions {
     mode: StorageMode;
     /** Backend URL (for hosted or self-hosted mode) */
     backendUrl?: string;
-    /** Instance ID (for hosted mode) */
+    /** Project ID (for hosted mode) */
     instanceId?: string;
     /** Selected scripts to configure */
     scripts?: string[];
@@ -215,19 +205,19 @@ export interface PreflightCheck {
     hint?: string;
 }
 export interface Instance {
-    /** Instance ID */
+    /** Project ID */
     id: string;
-    /** Instance name */
+    /** Project name */
     name: string;
     /** Organization slug */
     organizationSlug?: string;
     /** Provisioning region */
     region?: string;
-    /** Instance URL */
+    /** Project backend URL */
     url: string;
     /** Created timestamp */
     createdAt: string;
-    /** Instance status */
+    /** Project status */
     status: 'active' | 'inactive' | 'pending';
 }
 export type RecoveryAction = 'retry' | 'skip' | 'manual' | 'troubleshoot' | 'abort';

package/dist-types/utils/logger.d.ts

@@ -1,13 +1,14 @@
-import { type Logger } from '../../../logger/dist-types/index.d.ts';
+import { type Logger } from '@c15t/logger';
 export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
 export declare const validLogLevels: LogLevel[];
 export type CliLogger = Logger & CliExtensions;
 export interface CliExtensions {
-    message: (message: string, ...args: unknown[]) => void;
-    note: (message: string, ...args: unknown[]) => void;
-    outro: (message: string, ...args: unknown[]) => void;
-    success: (message: string, ...args: unknown[]) => void;
-    failed: (message: string, ...args: unknown[]) => void;
+    message: (message: string) => void;
+    note: (content: string, title?: string) => void;
+    outro: (message: string) => void;
+    success: (message: string) => void;
+    failed: (message: string) => never;
+    step: (current: number, total: number, label: string) => void;
 }
 /**
  * Formats a log message with appropriate styling based on log level